README

h-index-reader是一个模块，允许您从包括Google Scholar在内的不同来源检索作者的h-index信息。

• 目录

什么是h-index？

根据维基百科，“h-index是一个作者级别的指标，用于衡量科学家的出版物生产率和引用影响。h-index与明显的成功指标相关，如获得诺贝尔奖、获得研究奖学金和在顶级大学任职。”

问题

由于没有API可以从学术数据库（如Google Scholar和SCOPUS）获取作者h-index信息，因此以编程方式访问作者的h-index信息并不方便。有人尝试通过抓取作者的网页资料（例如Google Scholar资料）来解决这个问题。然而，这并不总是获得指标（例如h-index、h-index5y、i-10index等）的可靠方式，因为Google和其他提供商阻止了网络爬虫的访问。

解决方案

h-index-reader通过使用多个不同的信息来源和库，提供了一种可靠的方式来访问作者的h-index信息。

入门

h-index-reader既提供API又提供CLI来获取作者（们）的指标。

要求

h-index-reader需要Python 3或更高版本和系统中的pip3。

安装

您可以使用composer require和composer create-project安装h-index-reader，但第一种选项的要求不同。

h-index-reader为其Python包创建了一个隔离的环境，因此不会与其他系统中的包混淆。当您使用以下选项创建项目时，脚本会自动创建隔离的虚拟环境

    composer require proximify/h-index-reader

但是，如果您将h-index-reader作为项目的要求添加（即使用composer require），则必须在包内部手动创建虚拟环境、激活它然后安装所有必需的Python包

• 创建虚拟环境

python3 -m venv src/python3/_scholarly

• 激活它

source src/python3/_scholarly/bin/activate

• 安装包

pip3 install scholarly

• 停用venv

deactivate

API

h-index-reader提供了一个API，可以从不同的来源获取作者的指标。默认情况下，该读取器使用Google Scholar作为数据源。

    $hindexReader = new HIndexReader();

可以通过提供人名和/或所属机构以及Google Scholar资料URL来获取作者的h-index。名称字段是必填的，而所属机构和资料URL是可选的。

$people = [
    [
        'name' => 'Diego Macrini',
        'affiliation' => 'Research Fellow, Proximify',
        'profile_url' => 'https://scholar.google.com/citations?user=avUYKIgAAAAJ'
    ],
    [
        'name' => 'Sven Dickinson',
        'affiliation' => 'University of Toronto'
    ]
];

$result = $hindexReader->queryHIndex($people);

输出

[
  {
    "id": "avUYKIgAAAAJ",
    "name": "Diego Macrini",
    "affiliation": "Research Fellow, Proximify",
    "hindex": 11,
    "hindex5y": 9,
    "i10index": 12,
    "i10index5y": 9
  },
  {
    "id": "6TGwETYAAAAJ",
    "name": "Sven Dickinson",
    "affiliation": "Professor of Computer Science, University of Toronto",
    "hindex": 43,
    "hindex5y": 23,
    "i10index": 91,
    "i10index5y": 44
  }
]

设置

h-index-reader提供了一个设置文件，您可以在其中配置高级选项。以下是当前版本支持的设置列表

测试

h-index-reader既提供CLI又提供Web界面进行测试。

CLI

composer query-h-index

您还可以在dev文件夹下使用Web界面进行测试

cd h-index-reader/dev/www && php -S localhost:8000

注意：请设置dev/www/api/index.php下autoloader.php的正确路径。否则，测试脚本将失败。

未来工作

我们计划在不久的将来添加更多来源（Scopus、WebofScience）来获取h-index。

贡献

本项目欢迎贡献和建议。大多数贡献都需要您同意一份贡献者许可协议（CLA），声明您有权利并且实际上已经授予我们使用您贡献的权利。有关详细信息，请访问我们的贡献者许可协议。

当您提交拉取请求时，我们将确定您是否需要提供CLA，并适当装饰PR（例如，标签、评论）。只需遵循提供的说明。您只需要在整个使用我们CLA的仓库中做一次。

本项目已采用Proximify开源行为准则。有关更多信息，请参阅行为准则常见问题解答或通过support@proximify.com联系我们，提出任何额外的问题或评论。

许可证

版权所有 (c) Proximify Inc. 保留所有权利。

在MIT许可证下授权。

h-index-reader由Proximify制作。我们邀请社区参与。