Skip to main content

Simple ADS API query package and citation tracker

Project description

PyPI version PyPI - Python Version

myADS

myADS is a simple package to keep track of citations to your (and other authors) papers.

It both reports your current papers citation metrics, and checks for any new cites to your papers since the last time of checking.

Once installed you can always run myads --help to see a list of available commands.

Installation

The easiest method is to install directly from PyPi via:

pip install myads

From source

To install from source:

  • Clone the repository using git clone https://github.com/stuartmcalpine/myADS.git
  • Navigate to the myADS folder
  • Install using pip install .

Getting set up

myADS can keep track of the citations for multiple users. Two steps before you get started:

  • Add your users to the database
  • Add your ADS API token to the database

Adding a user to the database

Once myADS is installed you can add users to the tracking database using:

myads --add_user

You will be prompted to enter a first and last name, and an optional ORCID (however it is recommended you add this for each user when possible).

Removing a user from the database

You can remove users from the tracking database using:

myads --remove_user

where you will be prompted to enter the users unique tracking ID.

You can get a list of tracking IDs by typing:

myads --list_users

Adding your ADS API token

You must add your ADS API token so the package can query on your behalf.

To add it run:

--set_ads_token <YOUR-API-TOKEN-HERE>

Usage

Citation reporter

If you run myads --report you will get a report of all your registered users current citations, e.g.,

Reporting cites for Stuart McAlpine...
+----------------------------------------------------+--------------+---------------+---------------------+
| Title                                              | Citations    | Publication   | Bibcode             |
|                                                    | (per year)   | Date          |                     |
+====================================================+==============+===============+=====================+
| Galaxy mergers in EAGLE do not induce a            | 34 (12.0)    | 2020-06-00    | 2020MNRAS.494.5713M |
| significant amount of black hole growth yet do     |              |               |                     |
| increase the rate of luminous AGN                  |              |               |                     |
+----------------------------------------------------+--------------+---------------+---------------------+

Citation tracker

If you run myads --check it will tell you any papers that have cited your users papers since the last call.

The first time you run this it will create a local database of your citations. From then on it will update the local database with your new cites and report the changes, e.g.,

 1 new cite(s) for Galaxy mergers in EAGLE do not induce a significant amount of black hole growth yet do increase the rate of luminous AGN
+----------------------------------------+--------------------------------------+------------+---------------------+
| Title                                  | Authors                              | Date       | Bibcode             |
+========================================+======================================+============+=====================+
| The breakBRD Breakdown: Using          | ['Kopenhafer, Claire', 'Starkenburg, | 2020-11-01 | 2020ApJ...903..143K |
| IllustrisTNG to Track the Quenching of | Tjitske K.', 'Tonnesen, Stephanie',  |            |                     |
| an Observationally Motivated Sample of | 'Tuttle, Sarah']                     |            |                     |
| Centrally Star-forming Galaxies        |                                      |            |                     |
+----------------------------------------+--------------------------------------+------------+---------------------+

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

myads-1.0.1.tar.gz (11.4 kB view hashes)

Uploaded Source

Built Distribution

myads-1.0.1-py3-none-any.whl (11.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page