pybliometrics

Python-based API-Wrapper to access Scopus

https://github.com/pybliometrics-dev/pybliometrics

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

✓
CITATION.cff file
Found CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
✓
DOI references
Found 1 DOI reference(s) in README
○
Academic publication links
✓
Committers with academic emails
3 of 35 committers (8.6%) from academic institutions
○
Institutional organization owner
○
JOSS paper metadata
○
Scientific vocabulary similarity
Low similarity (8.5%) to scientific vocabulary

Keywords

api-wrapper bibliometrics scopus scopus-api

Last synced: 6 months ago · JSON representation ·

Repository

Python-based API-Wrapper to access Scopus

Basic Info

Host: GitHub
Owner: pybliometrics-dev
License: other
Language: Python
Default Branch: master
Homepage: https://pybliometrics.readthedocs.io/en/stable/
Size: 2.6 MB

Statistics

Stars: 460
Watchers: 16
Forks: 136
Open Issues: 13
Releases: 0

Topics

api-wrapper bibliometrics scopus scopus-api

Created about 10 years ago · Last pushed 6 months ago

Metadata Files

Readme Contributing Funding License Citation

README.rst

pybliometrics
=============

Enables large-scale access to Elsevier's Scopus and ScienceDirect APIs from Python.

Documentation: https://pybliometrics.readthedocs.io

Development: https://github.com/pybliometrics-dev/pybliometrics

.. image:: https://badge.fury.io/py/pybliometrics.svg
    :target: https://badge.fury.io/py/pybliometrics

.. image:: https://img.shields.io/pypi/pyversions/pybliometrics.svg
    :target: https://img.shields.io/pypi/pyversions/pybliometrics.svg

.. image:: https://readthedocs.org/projects/pybliometrics/badge/?version=stable
    :target: https://readthedocs.org/projects/pybliometrics/badge/?version=stable

.. image:: https://img.shields.io/pypi/dm/pybliometrics.svg
    :target: https://img.shields.io/pypi/dm/pybliometrics.svg

.. image:: https://img.shields.io/pypi/l/pybliometrics.svg
    :target: https://img.shields.io/pypi/l/pybliometrics.svg

.. image:: https://api.codeclimate.com/v1/badges/a4d7edd206a1252dfcfe/maintainability
   :target: https://codeclimate.com/github/pybliometrics-dev/pybliometrics/maintainability

Example (for Scopus)
====================
.. example-begin
.. code:: python

    >>> import pybliometrics
    >>> pybliometrics.init()  # read API keys
    >>> # Document-specific information
    >>> from pybliometrics.scopus import AbstractRetrieval
    >>> ab = AbstractRetrieval("10.1016/j.softx.2019.100263")
    >>> ab.title
    'pybliometrics: Scriptable bibliometrics using a Python interface to Scopus'
    >>> ab.publicationName
    'SoftwareX'
    >>> ab.authors
    [Author(auid=57209617104, indexed_name='Rose M.E.', surname='Rose',
     given_name='Michael E.', affiliation='60105007'),
     Author(auid=7004212771, indexed_name='Kitchin J.R.', surname='Kitchin',
     given_name='John R.', affiliation='60027950')]
    >>> 
    >>> # Author-specific information
    >>> from pybliometrics.scopus import AuthorRetrieval
    >>> au2 = AuthorRetrieval(ab.authors[1].auid)
    >>> au2.h_index
    34
    >>> au1 = AuthorRetrieval(ab.authors[0].auid)
    >>> au1.affiliation_current
    [Affiliation(id=60105007, parent=None, type='parent', relationship='author',
     afdispname=None, preferred_name='Max Planck Institute for Innovation and Competition',
     parent_preferred_name=None, country_code='deu', country='Germany',
     address_part='Marstallplatz 1', city='Munich', state='Bayern',
     postal_code='80539', org_domain='ip.mpg.de', org_URL='http://www.ip.mpg.de/')]
    >>> 
    >>> # Affiliation information
    >>> from pybliometrics.scopus import AffiliationRetrieval
    >>> aff1 = AffiliationRetrieval(au1.affiliation_current[0].id)
    >>> aff1.author_count
    98

.. example-end

Installation
============

.. installation-begin

Install the stable version from PyPI:

.. code-block:: bash

    pip install pybliometrics

or the development version from the GitHub repository (requires git on your system):

.. code-block:: bash

    pip install git+https://github.com/pybliometrics-dev/pybliometrics

.. installation-end

Citation
========

If pybliometrics helped you getting data for research, please cite our corresponding paper:

* Rose, Michael E. and John R. Kitchin: "`pybliometrics: Scriptable bibliometrics using a Python interface to Scopus <./meta/1-s2.0-S2352711019300573-main.pdf>`_", SoftwareX 10 (2019) 100263.

Citing the paper helps the development of pybliometrics, because it justifies funneling resources into the development.  It also signals that you obtained data from Scopus in a transparent and replicable way.

Change log
==========

Please see `CHANGES.rst <./meta/CHANGES.rst>`_.

Contributing
============

Please see `CONTRIBUTING.rst `_. For a list of contributors see
`AUTHORS.rst <./meta/AUTHORS.rst>`_.

License
=======

MIT License; see `LICENSE `_.

Owner

Name: pybliometrics-dev
Login: pybliometrics-dev
Kind: organization

Repositories: 1
Profile: https://github.com/pybliometrics-dev

Developers of pybliometrics: Michael E. Rose and John R. Kitchin

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If pybliometrics helped you getting data for research, please cite our corresponding paper:"
title: "pybliometrics: Scriptable bibliometrics using a Python interface to Scopus"
doi: 10.1016/j.softx.2019.100263
authors:
  - family-names: Rose
    given-names: Michael E.
    orcid: 0000-0002-4128-4236
  - family-names: Kitchin
    given-names: John R.
    orcid: 0000-0003-2625-9232
preferred-citation:
  type: article
  authors:
    - family-names: Rose
      given-names: Michael E.
      orcid: 0000-0002-4128-4236
    - family-names: Kitchin
      given-names: John R.
      orcid: 0000-0003-2625-9232
  title: "pybliometrics: Scriptable bibliometrics using a Python interface to Scopus"
  journal: SoftwareX
  volume: 10
  year: 2019
  issue: 100263
  doi: 10.1016/j.softx.2019.100263

GitHub Events

Total

Issues event: 48
Watch event: 43
Delete event: 2
Issue comment event: 79
Push event: 61
Pull request event: 39
Pull request review event: 98
Pull request review comment event: 128
Fork event: 6
Create event: 4

Last Year

Issues event: 48
Watch event: 43
Delete event: 2
Issue comment event: 79
Push event: 61
Pull request event: 39
Pull request review event: 98
Pull request review comment event: 128
Fork event: 6
Create event: 4

Committers

Last synced: over 2 years ago

All Time

Total Commits: 741
Total Committers: 35
Avg Commits per committer: 21.171
Development Distribution Score (DDS): 0.148

Past Year

Commits: 39
Committers: 5
Avg Commits per committer: 7.8
Development Distribution Score (DDS): 0.154

Top Committers

Name	Email	Commits
Michael E. Rose	M**e@g**m	631
John Kitchin	j**n@a**u	52
raffaem	5****m	10
Nurzhan Sapargali	4****e	4
Katrin Leinweber	9****r	4
Andrea Ieri	a****i	3
Chun Ly	a**n@g**m	3
João Pedro	j****o	2
KOLANICH	K****H	2
Gilad Bar Levav	3****l	2
SilasK	s**r@g**m	2
Chris Baker	c**r@g**m	2
Fabio	f**o@g**m	2
Jakob Hoffmann	j**5@p**e	1
juanfcocontreras	j**s@h**m	1
Aythami Estévez Olivas	a**e@g**m	1
Logan McNichols	l**s@g**m	1
herreio	4****o	1
Marcello G. Magaldi	5****7	1
SilasK	S****K	1
Luca Di Gaspero	l**o@g**m	1
ale-de-vries	a****s	1
bz-dev	3****v	1
Nils Herrmann	8****n	1
JLoDoesIt	5****t	1
John Dagdelen	j****n	1
Michael E. Rose	M**e@i**e	1
MindlessJoker	s**v@g**m	1
Moe Kayali	m**e@k**o	1
Konstantin Travin	4****d	1
and 5 more...

Committer Domains (Top 20 + Academic)

uni-due.de: 1 brndnstn.de: 1 kayali.io: 1 ip.mpg.de: 1 posteo.de: 1 andrew.cmu.edu: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time

Total issues: 149
Total pull requests: 100
Average time to close issues: 3 months
Average time to close pull requests: 14 days
Total issue authors: 70
Total pull request authors: 15
Average comments per issue: 3.31
Average comments per pull request: 1.58
Merged pull requests: 77
Bot issues: 0
Bot pull requests: 1

Past Year

Issues: 28
Pull requests: 42
Average time to close issues: 10 days
Average time to close pull requests: 12 days
Issue authors: 13
Pull request authors: 4
Average comments per issue: 1.79
Average comments per pull request: 0.86
Merged pull requests: 33
Bot issues: 0
Bot pull requests: 0

View more stats

Top Authors

Issue Authors

raffaem (27)
nils-herrmann (20)
Michael-E-Rose (12)
astrochun (11)
mark-todd (4)
claell (3)
kosh-jp (2)
SS159 (2)
lewisjiang (2)
ezgikurt (2)
IvanSterligov (2)
egonzales2000 (2)
marijane (2)
langongjin (2)
10b14224cc (1)

Pull Request Authors

nils-herrmann (70)
raffaem (11)
astrochun (7)
kosh-jp (2)
jpcaveiro (2)
montypanday (2)
lewisjiang (2)
KOLANICH (2)
saulfield (1)
JLoDoesIt (1)
claell (1)
JakobHoffmann (1)
dependabot[bot] (1)
bz-dev (1)
james-geiger (1)

Top Labels

Issue Labels

Backend (56) Effort: Low (45) question (29) Bug (27) Enhancement (26) Update (18) Effort: High (16) Documentation (15) wontfix (12) Duplicate (4) Refactor (1)

Pull Request Labels

dependencies (1)

Packages

Total packages: 1
Total downloads:
- pypi 3,028 last-month

Total dependent packages: 4
Total dependent repositories: 17
Total versions: 37
Total maintainers: 1

pypi.org: pybliometrics

Python-based API-Wrapper to access Scopus and ScienceDirect

Homepage: https://github.com/pybliometrics-dev/pybliometrics
Documentation: https://pybliometrics.readthedocs.io/
License: MIT
Latest release: 4.2.1
published 11 months ago

Versions: 37
Dependent Packages: 4
Dependent Repositories: 17
Downloads: 3,028 Last month

Rankings

Dependent packages count: 1.9%

Stargazers count: 3.4%

Dependent repos count: 3.5%

Average: 3.9%

Forks count: 4.3%

Downloads: 6.5%

Maintainers (1)

MERose

Last synced: 6 months ago

Dependencies

docs/requirements.txt pypi

sphinx ==3.4.3
sphinx_autodoc_defaultargs ==0.1.2
sphinx_autodoc_typehints ==1.12.0

pyproject.toml pypi

requests *
tqdm *
urllib3 *

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Source Science

pybliometrics

Science Score: 67.0%

Keywords

Repository

Basic Info

Statistics

Topics

Metadata Files

README.rst

Owner

Citation (CITATION.cff)

GitHub Events

Total

Last Year

Committers

All Time

Past Year

Top Committers

Committer Domains (Top 20 + Academic)

Issues and Pull Requests

All Time

Past Year

Top Authors

Issue Authors

Pull Request Authors

Top Labels

Issue Labels

Pull Request Labels

Packages

pypi.org: pybliometrics

Rankings

Maintainers (1)

Dependencies