===========
About
bowshock is an all-in-one wrapper for NASA API’s. Here is a list of currently supported API’s :
- NASA Earth API
- NASA APOD (Astronomy Picture of the Day) API
- NASA Patents API
- NASA Earth Temperature Anomalies API
- Asterank API
- HelioViewer API
- MAAS (Mars Weather) API
- MODIS (Land, Atmosphere and Ocean Data) API
- Skymorph API
- Star API
- Techport API
- PredictTheSky API
Install
Standart Procedure
pip install bowshock
Important Note: The only requirement is the ‘requests’ package BUT if you want to use MODIS there is an external requirement which is ‘suds’ package
Do i need an API Key ?
| YES | NO |
|---|---|
| Earth | The rest |
| APOD | |
| Patents | |
| Earth Temperature Anomalies |
The rest does not require an API key for usage. Get your NASA API KEY from : https://data.nasa.gov/developer/external/planetary/#apply-for-an-api-key
Setting up the API Key
=================== set an environment varible NASA_API_KEY which is equal to your key string
Usage
Apod
from bowshock import apod
# with specific date and tags - For apod all args are optional
apod.apod(date="2015-02-02", concept_tags=True)
Asterank
from bowshock import asterank
# all args mandatory
asterank.asterank(
query={"e": {"$lt": 0.1},
"i": {"$lt": 4},
"a": {"$lt": 1.5}},
limit=1)
Earth
from bowshock import earth
# imagery endpoint lon & lat mandatory, rest optional
earth.imagery(lon=100.75,
lat=1.6,
dim=0.0025,
date="2015-02-02",
cloud_score=True)
# assets endpoint lon & lat & begin mandatory, end optional
earth.assets(lon=100.75, lat=1.6, begin="2015-02-02", end="2015-02-10")
HelioViewer
from bowshock import helioviewer
# args are mandatory
helioviewer.getjp2image(date='2014-01-01T23:59:59', sourceId=14)
#args are mandatory
helioviewer.getjp2header(Id=7654321)
MAAS
from bowshock import maas
# mandatory date begin / end
maas.maas_archive('2012-10-01', '2012-10-31')
maas.maas_latest()
Patents
from bowshock import patents
# only query is mandatory, rest is optional
patents.patents(query="temperature", concept_tags=True, limit=5)
PredictTheSky
from bowshock import predictthesky
#args are mandatory
predictthesky.space_events(lon=100.75, lat=1.5)
Star API
from bowshock import star
star.stars()
star.search_star("Sun")
star.exoplanets()
star.search_exoplanet("11 Com")
star.local_group_of_galaxies()
star.search_local_galaxies("IC 10")
star.star_clusters()
star.search_star_cluster("Berkeley 59")
Skymorph
from bowshock import skymorph
# mandatory obj id
skymorph.search_target_obj("J99TS7A")
#TODO : add search_position() , search_target_obj()
temperature anomalies
from bowshock import temperature_anomalies
# end arg is optional, rest is mandatory
temperature_anomalies.coordinate(lon=100.3, lat=1.6, begin="1990", end="2005")
techport
from bowshock import techport
techport.techport(Id="4795")
Contributors
TODO
- Lance-Modis API – http://lance-modis.eosdis.nasa.gov/user_services/api-lance.html
BTW What is “bowshock”?
