README.rst

sosia

Match authors automatically in Scopus on-line

Documentation: https://sosia.readthedocs.io

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

Installation

Install stable version from PyPI:

pip install sosia

or development version from GitHub repository:

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

Functioning

sosia performs a series of queries in the Scopus database using the pybliometrics package. After configuring your local pybliometrics (providing access credentials and eventually setting cache directories), you are ready to use sosia:

>>> import sosia
>>>
>>> # You need the Scopus ID and the year, optionally set a database path
>>> stefano = sosia.Original(55208373700, 2019)
>>> # Sources similiar to those stefano publishes in
>>> stefano.define_search_sources()
>>> # Authors publishing in search sources every 2 years
>>> stefano.identify_candidates_from_sources(first_year_margin=1, chunk_size=2)
>>> # Find candidates whose characteristics fall within margins
>>> stefano.filter_candidates(same_discipline=True, first_year_margin=1,
>>>                           pub_margin=0.2, cits_margin=0.2,
>>>                           coauth_margin=0.15)
>>> print(stefano.matches)
>>> [55227190800, 55880939500]
>>> # Optional step to provide additional information
>>> stefano.inform_matches()
>>> print(stefano.matches[0])
Match(ID=55227190800, name='Behrens, Judith', first_name='Judith',
      surname='Behrens', first_year=2012, last_year=2020, num_coauthors=10,
      num_publications=14, num_citations=106, subjects=['BUSI', 'ECON', 'COMP'],
      affiliation_country='Belgium', affiliation_id='60211750',
      affiliation_name='Solvay Brussels School of Economics and Management',
      affiliation_type='univ', language='eng', num_cited_refs=10)

Change log

Please see CHANGES.rst.

Contributing

Please see CONTRIBUTING.rst. For the list of contributors see AUTHORS.rst.

License

MIT License; see LICENSE.