Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/simonrw/k2catalogue
Simple interactive query api for the K2 proposals list
https://github.com/simonrw/k2catalogue
Last synced: 19 days ago
JSON representation
Simple interactive query api for the K2 proposals list
- Host: GitHub
- URL: https://github.com/simonrw/k2catalogue
- Owner: simonrw
- License: mit
- Created: 2015-01-23T14:34:18.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2021-04-20T17:04:07.000Z (over 3 years ago)
- Last Synced: 2024-10-11T01:29:31.614Z (about 1 month ago)
- Language: Python
- Homepage: http://k2catalogue.rtfd.org/
- Size: 1.13 MB
- Stars: 1
- Watchers: 3
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# k2catalogue
[](https://travis-ci.org/mindriot101/k2catalogue)[](https://landscape.io/github/mindriot101/k2catalogue/master)[](https://readthedocs.org/projects/k2catalogue/?badge=latest)[](https://pypi.python.org/pypi/k2catalogue/)
Simple interactive query api for the K2 proposals list, based on the IPython console.
## Features
* Open a simbad search around the EPIC object
* Get the proposals for an EPIC object
* Get the objects contained in a single proposal
* Get the objects observed during a campaign
* Visit the proposals page for a campaign
* View the proposal title and PI
* View the proposal pdf for a proposal
* Get the EPIC object magnitude, ra and dec if available
## Installation
`pip install git+https://github.com/mindriot101/k2catalogue`
### Requirements:
*all from pip*
* requests
* sqlalchemy
* ipython
* vcrpy
* beautifulsoup4
The first run may fail with "table missing" type errors. In this case the initial database must be created, with the `-s` flag: `k2cat-search -s`. This will create `database.sqlite` in the current directory. Subsequent runs do not need the `-s` flag unless you want to rebuild the database.
## Examples
Fire up the interpreter with `k2cat-search` and try these:
```python
# Get an object by epic id (using WASP-85 b as an example)
e = get_by_epicid(201862715)
print(e) # =>
# Open the simbad page for a radius of 5 arcmin around the target
e.simbad_query(radius=5.0)
# ... default browser opens, showing the SIMBAD details
# Show the proposals containing that object
print(e.proposals)
# => [, , , , ]
# Let's look at proposal GO1041_SC
p = e.proposals[0] # This may have a different index for you
print(p) # =>
# Where is the proposal pdf?
print(p.pdf_url) # => http://keplerscience.arc.nasa.gov/K2/docs/Campaigns/C1/GO1041_Hellier.pdf
# Let's open that pdf in a web browser
p.open_proposal()
# ... default browser opens, showing the proposal pdf
# Where are the proposal pdfs kept?
p.open_proposals_page()
# ... default browser opens, showing the list of proposals
# Let's look at the proposal details
print('Proposal PI: {pi} and title: {title}'.format(
pi=p.pi, title=p.title))
# => Proposal PI: Hellier and title: Kepler K2 observations of the hot Jupiter WASP-85b
# What other objects are in the same proposal?
print(p.objects)
# => [] Ah just the one then.
# Which campaign is the proposal (or object) in?
print('Object campaign: {}, proposal campaign: {}'.format(e.campaign, p.campaign))
# => Object campaign: , proposal campaign:
# What about the object magnitude and coordinates?
print('WASP-85 b is located here: {ra} {dec} and is magnitude {mag}'.format(
ra=e.ra, dec=e.dec, mag=e.mag))
# => WASP-85 b is located here: 175.90838 6.563726 and is magnitude 10.247
```
## Advanced usage
The package uses SQLAlchemy for all of the database interactions, and the `session` object along with the database models `Campaign`, `EPIC` and `Proposal` are available to the user for more advanced queries.
For example the first example above (`get_by_epicid`) can be performed with the SQLAlchemy api:
```python
epicid = 201862715
e = session.query(EPIC).filter(EPIC.epic_id == epicid).first()
```