https://github.com/andycasey/ads
Python tool for ADS
https://github.com/andycasey/ads
Last synced: 25 days ago
JSON representation
Python tool for ADS
- Host: GitHub
- URL: https://github.com/andycasey/ads
- Owner: andycasey
- License: mit
- Created: 2013-08-08T02:46:06.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2025-09-28T00:57:00.000Z (about 2 months ago)
- Last Synced: 2025-10-21T20:57:01.771Z (25 days ago)
- Language: Python
- Size: 1.14 MB
- Stars: 183
- Watchers: 18
- Forks: 71
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - andycasey/ads - Python tool for ADS (Python)
- awesome-astronomy - Andy Casey's ads - Python tool for ADS (Uncategorized / Uncategorized)
README
# A Python Module to Interact with NASA's ADS that Doesn't Suck™
If you're in astro research, then you pretty much *need* NASA's ADS. It's tried, true, and people go crazy on the rare occasions when it goes down.
* Docs: https://ads.readthedocs.io/
* Repo: https://github.com/andycasey/ads
* PyPI: https://pypi.python.org/pypi/ads
[](https://travis-ci.org/andycasey/ads)
[](https://coveralls.io/github/andycasey/ads?branch=master)
## Quickstart
```python
import ads
ads.config.token = 'secret token'
papers = ads.SearchQuery(q="supernova", sort="citation_count")
for paper in papers:
print(paper.title[0])
```
You can expect to see some titles like this:
```
Maps of Dust Infrared Emission for Use in Estimation of Reddening and Cosmic Microwave Background Radiation Foregrounds
Measurements of Omega and Lambda from 42 High-Redshift Supernovae
Observational Evidence from Supernovae for an Accelerating Universe and a Cosmological Constant
First-Year Wilkinson Microwave Anisotropy Probe (WMAP) Observations: Determination of Cosmological Parameters
Abundances of the elements: Meteoritic and solar
```
## Running tests
```bash
cd /path/to/ads
pip install -e . "ads[tests]"
python -m unittest discover
```