Skip to main content

A command line tool for querying and modeling citation networks from the Astrophysical Data System (ADS) in a format compatible with Gephi

Project description

PyPI version CI License: MIT


is a command line tool for querying and modeling citation networks from the Astrophysical Data System (ADS) in a format compatible with Gephi, a popular network visualization tool. ads2gephi has been developed at the history of science department of TU Berlin as part of a research project on the history of extragalactic astronomy financed by the German Research Foundation DFG (PI Karin Pelte).

You can install ads2gephi from PyPI:

pip install ads2gephi


When using the tool for the first time to model a network, you will be prompted to enter your ADS API key. Your key will then be stored in a configuration file under ~/.ads2gephi.

In order to sample an initial citation network, you need to provide ads2gephi with a plain text file with bibcodes (ADS unique identifiers), one per line, as input. The queried network will be output in a SQLite database stored in the current directory:

ads2gephi -c bibcodes_example.txt -d my_fancy_netzwerk.db

Afterwards you can extend the queried network by providing the existing database file and using the additional sampling options. For example, you can extend the network by querying all the items cited in every publication previously queried:

ads2gephi -s ref -d my_fancy_netzwerk.db

Finally you might want to also generate the edges of the network. There are several options for generating edges. For example you can use a semantic similarity measure like bibliographic coupling or co-citation:

ads2gephi -e bibcp -d my_fancy_netzwerk.db

You can also do everything at once:

ads2gephi -c bibcodes_example.txt -s ref -e bibcp -d my_fancy_netzwerk.db

All other querying and modelling options are described in the help page:

ads2gephi --help

Once you've finished querying and modeling, the database file can be directly imported in Gephi for network visualization and analysis.

Special thanks to

  • Edwin Henneken

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

ads2gephi-0.3.7.tar.gz (9.7 kB view hashes)

Uploaded Source

Built Distribution

ads2gephi-0.3.7-py3-none-any.whl (9.7 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