pybliometrics


Namepybliometrics JSON
Version 4.1 PyPI version JSON
download
home_pageNone
SummaryPython-based API-Wrapper to access Scopus
upload_time2024-07-27 16:39:03
maintainerNone
docs_urlNone
authorNone
requires_pythonNone
licenseMIT
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 API 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
=======
.. example-begin
.. code:: python

    >>> import pybliometrics
    >>> pybliometrics.scopus.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": null,
    "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/3f/48/396dfdb2347669485a3752dfabe1d2aa0dc50dea16387d3adb8685dc00a1/pybliometrics-4.1.tar.gz",
    "platform": null,
    "description": "pybliometrics\r\n=============\r\n\r\nEnables large-scale access to Elsevier's Scopus API from 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\r\n=======\r\n.. example-begin\r\n.. code:: python\r\n\r\n    >>> import pybliometrics\r\n    >>> pybliometrics.scopus.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": "MIT",
    "summary": "Python-based API-Wrapper to access Scopus",
    "version": "4.1",
    "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": "",
            "digests": {
                "blake2b_256": "9952e005f3557f14d78d61d459b5f5ecb9c9b328abc7d9f5e1933c2f6fc6d91a",
                "md5": "b06affefe5603b69ca30def4ac608c13",
                "sha256": "80d03b107b90408fc15dea217b3aa10b9ee94d8f9c45002bddf60a08f67cc3ef"
            },
            "downloads": -1,
            "filename": "pybliometrics-4.1-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "b06affefe5603b69ca30def4ac608c13",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": null,
            "size": 77348,
            "upload_time": "2024-07-27T16:39:01",
            "upload_time_iso_8601": "2024-07-27T16:39:01.126174Z",
            "url": "https://files.pythonhosted.org/packages/99/52/e005f3557f14d78d61d459b5f5ecb9c9b328abc7d9f5e1933c2f6fc6d91a/pybliometrics-4.1-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "3f48396dfdb2347669485a3752dfabe1d2aa0dc50dea16387d3adb8685dc00a1",
                "md5": "e32a66bd41d399c3b51fd9d2ec3fdce2",
                "sha256": "4af9b7584b2caae3a53d4c8e2a7d4395c26189352440356744b57660ed0348e4"
            },
            "downloads": -1,
            "filename": "pybliometrics-4.1.tar.gz",
            "has_sig": false,
            "md5_digest": "e32a66bd41d399c3b51fd9d2ec3fdce2",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 929992,
            "upload_time": "2024-07-27T16:39:03",
            "upload_time_iso_8601": "2024-07-27T16:39:03.786670Z",
            "url": "https://files.pythonhosted.org/packages/3f/48/396dfdb2347669485a3752dfabe1d2aa0dc50dea16387d3adb8685dc00a1/pybliometrics-4.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-07-27 16:39:03",
    "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: 0.27166s