A simple Python package to deal with main Space Physics WebServices (CDA, CSA, AMDA and SSC).
Space Physics made EASY
Speasy is an open source Python client for Space Physics web services such as CDAWEB or AMDA. Most space physics data analysis starts with finding which server provides which dataset then figuring out how to download them. This can be difficult specially for students or newcomers, Speasy try to remove all difficulties by providing an unique and simple API to access them all. Speasy aims to support as much as possible web services and also cover a maximum of features they propose.
Installing Speasy with pip (more details here):
$ python -m pip install speasy # or $ python -m pip install --user speasy
Getting data is as simple as:
import speasy as spz ace_mag = spz.get_data('amda/imf', "2016-6-2", "2016-6-5")
Where amda is the webservice and imf is the product id you will get with this request.
Using the dynamic inventory this can be even simpler:
import speasy as spz amda_tree = spz.inventory.data_tree.amda ace_mag = spz.get_data(amda_tree.Parameters.ACE.MFI.ace_imf_all.imf, "2016-6-2", "2016-6-5")
Will produce the exact same result than previous example but has the advantage to be easier to manipulate since you can discover available data from your favourite Python environment completion such as IPython or notebooks (might not work from IDEs).
This also works with SSCWEB, you can easily download trajectories:
import speasy as spz sscweb_tree = spz.inventories.data_tree.ssc solo = spz.get_data(sscweb_tree.Trajectories.solarorbiter, "2021-01-01", "2021-02-01")
More complex requests like this one are supported:
import speasy as spz products = [ spz.inventories.tree.amda.Parameters.Wind.SWE.wnd_swe_kp.wnd_swe_vth, spz.inventories.tree.amda.Parameters.Wind.SWE.wnd_swe_kp.wnd_swe_pdyn, spz.inventories.tree.amda.Parameters.Wind.SWE.wnd_swe_kp.wnd_swe_n, spz.inventories.tree.cda.Wind.WIND.MFI.WI_H2_MFI.BGSE, spz.inventories.tree.ssc.Trajectories.wind, ] intervals = [["2010-01-02", "2010-01-02T10"], ["2009-08-02", "2009-08-02T10"]] data = spz.get_data(products, intervals)
Check out the documentation and examples at speasy documentation.
- Simple and intuitive API (spz.get_data to get them all)
- Pandas DataFrame like interface for variables
- Quick functions to convert a variable to a Pandas DataFrame
- Local cache to avoid repeating twice the same request
- Can take advantage of SciQLop dedicated proxy as a community backed ultra fast cache
- Full support of AMDA API
- Can retrieve time-series from AMDA, CDAWeb, CSA, SSCWeb
See here for a complete list of examples.
- installing speasy on both python 3.7 or less and python 3.8 or plus at the same time doesn't work since entries stored in cache by python 3.8+ are not readable by python 3.7-.
- Speasy is not a plotting package, while it provides basic plot features, it is not meant to produce publication ready figures.
The development of speasy is supported by the CDPP.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.