pybliometrics


Namepybliometrics JSON
Version 4.4 PyPI version JSON
download
home_pageNone
SummaryPython-based API-Wrapper to access Scopus and ScienceDirect
upload_time2025-10-28 19:25:21
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseNone
keywords scopus
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            pybliometrics
=============

Enables large-scale access to Elsevier's Scopus, ScienceDirect and SciVal APIs in 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 <CONTRIBUTING.rst>`_. For a list of contributors see
`AUTHORS.rst <./meta/AUTHORS.rst>`_.

License
=======

MIT License; see `LICENSE <LICENSE>`_.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "pybliometrics",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "\"Michael E. Rose\" <Michael.Ernst.Rose@gmail.com>",
    "keywords": "scopus",
    "author": null,
    "author_email": "\"'John Kitchin and Michael E. Rose\" <Michael.Ernst.Rose@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/59/fc/a66a3724eda430b0ce1145118c085d88137e3be466793b540ecfb19c6549/pybliometrics-4.4.tar.gz",
    "platform": null,
    "description": "pybliometrics\r\n=============\r\n\r\nEnables large-scale access to Elsevier's Scopus, ScienceDirect and SciVal APIs in Python.\r\n\r\nDocumentation: https://pybliometrics.readthedocs.io\r\n\r\nDevelopment: https://github.com/pybliometrics-dev/pybliometrics\r\n\r\n.. image:: https://badge.fury.io/py/pybliometrics.svg\r\n    :target: https://badge.fury.io/py/pybliometrics\r\n\r\n.. image:: https://img.shields.io/pypi/pyversions/pybliometrics.svg\r\n    :target: https://img.shields.io/pypi/pyversions/pybliometrics.svg\r\n\r\n.. image:: https://readthedocs.org/projects/pybliometrics/badge/?version=stable\r\n    :target: https://readthedocs.org/projects/pybliometrics/badge/?version=stable\r\n\r\n.. image:: https://img.shields.io/pypi/dm/pybliometrics.svg\r\n    :target: https://img.shields.io/pypi/dm/pybliometrics.svg\r\n\r\n.. image:: https://img.shields.io/pypi/l/pybliometrics.svg\r\n    :target: https://img.shields.io/pypi/l/pybliometrics.svg\r\n\r\n.. image:: https://api.codeclimate.com/v1/badges/a4d7edd206a1252dfcfe/maintainability\r\n   :target: https://codeclimate.com/github/pybliometrics-dev/pybliometrics/maintainability\r\n\r\nExample (for Scopus)\r\n====================\r\n.. example-begin\r\n.. code:: python\r\n\r\n    >>> import pybliometrics\r\n    >>> pybliometrics.init()  # read API keys\r\n    >>> # Document-specific information\r\n    >>> from pybliometrics.scopus import AbstractRetrieval\r\n    >>> ab = AbstractRetrieval(\"10.1016/j.softx.2019.100263\")\r\n    >>> ab.title\r\n    'pybliometrics: Scriptable bibliometrics using a Python interface to Scopus'\r\n    >>> ab.publicationName\r\n    'SoftwareX'\r\n    >>> ab.authors\r\n    [Author(auid=57209617104, indexed_name='Rose M.E.', surname='Rose',\r\n     given_name='Michael E.', affiliation='60105007'),\r\n     Author(auid=7004212771, indexed_name='Kitchin J.R.', surname='Kitchin',\r\n     given_name='John R.', affiliation='60027950')]\r\n    >>> \r\n    >>> # Author-specific information\r\n    >>> from pybliometrics.scopus import AuthorRetrieval\r\n    >>> au2 = AuthorRetrieval(ab.authors[1].auid)\r\n    >>> au2.h_index\r\n    34\r\n    >>> au1 = AuthorRetrieval(ab.authors[0].auid)\r\n    >>> au1.affiliation_current\r\n    [Affiliation(id=60105007, parent=None, type='parent', relationship='author',\r\n     afdispname=None, preferred_name='Max Planck Institute for Innovation and Competition',\r\n     parent_preferred_name=None, country_code='deu', country='Germany',\r\n     address_part='Marstallplatz 1', city='Munich', state='Bayern',\r\n     postal_code='80539', org_domain='ip.mpg.de', org_URL='http://www.ip.mpg.de/')]\r\n    >>> \r\n    >>> # Affiliation information\r\n    >>> from pybliometrics.scopus import AffiliationRetrieval\r\n    >>> aff1 = AffiliationRetrieval(au1.affiliation_current[0].id)\r\n    >>> aff1.author_count\r\n    98\r\n\r\n.. example-end\r\n\r\nInstallation\r\n============\r\n\r\n.. installation-begin\r\n\r\nInstall the stable version from PyPI:\r\n\r\n.. code-block:: bash\r\n\r\n    pip install pybliometrics\r\n\r\nor the development version from the GitHub repository (requires git on your system):\r\n\r\n.. code-block:: bash\r\n\r\n    pip install git+https://github.com/pybliometrics-dev/pybliometrics\r\n\r\n.. installation-end\r\n\r\nCitation\r\n========\r\n\r\nIf pybliometrics helped you getting data for research, please cite our corresponding paper:\r\n\r\n* 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.\r\n\r\nCiting 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.\r\n\r\nChange log\r\n==========\r\n\r\nPlease see `CHANGES.rst <./meta/CHANGES.rst>`_.\r\n\r\nContributing\r\n============\r\n\r\nPlease see `CONTRIBUTING.rst <CONTRIBUTING.rst>`_. For a list of contributors see\r\n`AUTHORS.rst <./meta/AUTHORS.rst>`_.\r\n\r\nLicense\r\n=======\r\n\r\nMIT License; see `LICENSE <LICENSE>`_.\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Python-based API-Wrapper to access Scopus and ScienceDirect",
    "version": "4.4",
    "project_urls": {
        "Bug Tracker": "https://github.com/pybliometrics-dev/pybliometrics/issues",
        "Documentation (latest)": "https://pybliometrics.readthedocs.io/en/latest/",
        "Documentation (stable)": "https://pybliometrics.readthedocs.io/en/stable/",
        "Homepage": "https://github.com/pybliometrics-dev/pybliometrics"
    },
    "split_keywords": [
        "scopus"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "477384d4ed609173ed2d0a42e5111114ef411cbd5a3c418d780cb6e89fc47564",
                "md5": "53255009a79637636a8e89d821177e4b",
                "sha256": "9ed220aba07e380a16dc96171ab5568a2a38e1b9070cfe797394df78c376411c"
            },
            "downloads": -1,
            "filename": "pybliometrics-4.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "53255009a79637636a8e89d821177e4b",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 126300,
            "upload_time": "2025-10-28T19:25:18",
            "upload_time_iso_8601": "2025-10-28T19:25:18.375580Z",
            "url": "https://files.pythonhosted.org/packages/47/73/84d4ed609173ed2d0a42e5111114ef411cbd5a3c418d780cb6e89fc47564/pybliometrics-4.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "59fca66a3724eda430b0ce1145118c085d88137e3be466793b540ecfb19c6549",
                "md5": "2e4d5d1f7279ed53a9458a59750c05cc",
                "sha256": "669c35ded36626022e1f5e52a31f29e2b3c7af993a3afed078246f1c217bbd53"
            },
            "downloads": -1,
            "filename": "pybliometrics-4.4.tar.gz",
            "has_sig": false,
            "md5_digest": "2e4d5d1f7279ed53a9458a59750c05cc",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 1008131,
            "upload_time": "2025-10-28T19:25:21",
            "upload_time_iso_8601": "2025-10-28T19:25:21.542439Z",
            "url": "https://files.pythonhosted.org/packages/59/fc/a66a3724eda430b0ce1145118c085d88137e3be466793b540ecfb19c6549/pybliometrics-4.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-28 19:25:21",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "pybliometrics-dev",
    "github_project": "pybliometrics",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "pybliometrics"
}
        
Elapsed time: 3.30279s