README

此扩展简化了BIP! Scholar研究级影响力指标的计算。

在Yii2项目中安装

安装此扩展的首选方式是通过composer。

运行以下命令

composer require "schatzopoulos/yii2-scholar-indicators"

或者在您的composer.json文件的所需部分中添加

"schatzopoulos/yii2-scholar-indicators": "*"

并在您的main项目的根目录中执行composer update。

基本用法

<?php

use schatzopoulos\scholarindicators\ScholarIndicators;

# mapping of impact fields
$impact_fields = [
  'popularity' => 'attrank',
  'influence' => 'pagerank',
  'impulse' => '3y_cc',
  'citations' => 'citation_count',
  'year' => 'year'
 ];

# different work types
$work_types = [
  'publication' => '',
  'dataset' => 1,
];

# provide impact data 
$impact_data = [
  0 => [
    'doi' => '10.1093/nar/gkx1141',
    'is_oa' => '1',
    'type' => NULL,
    'attrank' => '0.0000006354301544051926',
    'pagerank' => '0.000000028758916907015535',
    '3y_cc' => '229',
    'citation_count' => '406',
    'year' => '2017',
  ],
  1 => [
    'doi' => '10.1093/nar/gkw455',
    'is_oa' => '1',
    'type' => NULL,
    'attrank' => '0.000000029483090596793',
    'pagerank' => '0.0000000074224020960741795',
    '3y_cc' => '23',
    'citation_count' => '34',
    'year' => '2016',
  ]
];

# academic leaves 
$rag_data = [
  0 => [
    'id' => '159',
    'orcid' => '0000-0003-1714-5225',
    'start_date' => '2022-05-01',
    'end_date' => '2022-05-25',
    'description' => 'Parental Leave',
  ]
];

$indicators = new ScholarIndicators($impact_fields, $work_types, $impact_data);

$work_types_num = $indicators->work_types_num();
$citations_num = $indicators->citations_num();
$h_index = $indicators->h_index();
$i10_index = $indicators->i10_index();
$popularity = $indicators->popularity_sum();
$influence = $indicators->influence_sum();
$impulse = $indicators->impulse_sum();
$openness = $indicators->open_papers_percentage();
$paper_min_year = $indicators->get_paper_min_year();
$academic_age = $indicators->get_academic_age($paper_min_year);

$responsible_academic_age = ScholarIndicators::get_responsible_academic_age($academic_age, $rag_data, $paper_min_year);

?>

本地开发

• 将此仓库克隆到目录中
• 将以下代码添加到此扩展的composer.json文件中

    "minimum-stability": "dev",

• 在您的main项目的composer.json文件中添加以下代码

    "require-dev": {
        "schatzopoulos/yii2-scholar-indicators": "@dev"
    },
    "repositories": [
        {
            "type": "path",
            "url": "[absolute-path-to-cloned-directory]"
        }
    ]

• 在您的main项目的根目录中运行： composer update。
• 现在，您的main项目应从扩展代码的更改中获取实时更新。