speasy


Namespeasy JSON
Version 1.3.2 PyPI version JSON
download
home_pageNone
SummaryA simple Python package to deal with main Space Physics WebServices (CDA, CSA, AMDA and SSC).
upload_time2024-06-18 09:49:00
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords satellite plasma-physics nasa-data amda cdpp cdf
VCS
bugtrack_url
requirements pandas appdirs diskcache requests urllib3 packaging numpy python_dateutil astropy pyistp astroquery tqdm matplotlib PyYAML scipy
Travis-CI
coveralls test coverage
            <h1 align="center">
<img src="https://raw.githubusercontent.com/SciQLop/speasy/main/logo/logo_speasy.svg" width="300">
</h1><br>

# Space Physics made EASY

[![Chat on Matrix](https://img.shields.io/matrix/speasy:matrix.org)](https://matrix.to/#/#speasy:matrix.org)
[![image](https://img.shields.io/pypi/v/speasy.svg)](https://pypi.python.org/pypi/speasy)
[![image](https://github.com/SciQLop/speasy/workflows/Tests/badge.svg)](https://github.com/SciQLop/speasy/actions?query=workflow%3A%22Tests%22)
[![Documentation Status](https://readthedocs.org/projects/speasy/badge/?version=latest)](https://speasy.readthedocs.io/en/latest/?badge=latest)
[![Coverage Status](https://codecov.io/gh/SciQLop/speasy/coverage.svg?branch=main)](https://codecov.io/gh/SciQLop/speasy/branch/main)
[![CodeQL](https://github.com/SciQLop/speasy/actions/workflows/codeql.yml/badge.svg)](https://github.com/SciQLop/speasy/actions/workflows/codeql.yml)
[![Zendoo DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.4118780.svg)](https://doi.org/10.5281/zenodo.4118780)
[![Discover on MyBinder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/SciQLop/speasy/main?labpath=docs/examples)
[![Discover on Google Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/SciQLop/speasy)
[![Speasy proxy uptime (30 days)](https://img.shields.io/uptimerobot/ratio/m792771930-24b7f89c03d5090a13462b70)](http://sciqlop.lpp.polytechnique.fr/cache)

Speasy is a free and open-source Python package that makes it easy to find and load space physics data from a variety of
data sources, whether it is online and public such as [CDAWEB](https://cdaweb.gsfc.nasa.gov/index.html/) and [AMDA](http://amda.irap.omp.eu/),
or any described archive, local or remote.
This task, where any science project starts, would seem easy a priori but, considering the very
diverse array of missions and instrument nowaday available, proves to be one of the major bottleneck,
especially for students and newcomers.
Speasy solves this problem by providing a **single, easy-to-use interface to over 70 space missions and 65,000 products**.

Don't want to write code? See our graphical interface [SciQLop](https://github.com/SciQLop/SciQLop).

## Main features

-   Simple and intuitive API (`spz.get_data(...)` to get them all)
-   Speasy variables are like Pandas DataFrame with seemless conversion to/from it (as long as the shape is compatible)
-   Speasy variables support numpy operations, [see numpy operations example below](#numpy-operations)
-   Speasy variables filtering and resampling capabilities, [see resampling example below](#resampling)
-   Local cache to avoid redundant downloads
-   Uses the SciQLOP ultra fast community cache server
-   Full support of [AMDA](http://amda.irap.omp.eu/) API
-   Can retrieve time-series from [AMDA](http://amda.irap.omp.eu/),
    [CDAWeb](https://cdaweb.gsfc.nasa.gov/),
    [CSA](https://csa.esac.esa.int/csa-web/),
    [SSCWeb](https://sscweb.gsfc.nasa.gov/)
-   Support data access from any local or remote archives described by YAML file.
  
## Help us improve Speasy!

We want Speasy to be the best possible tool for space physics research. You can help us by:

- Answering our user survey [here](https://docs.google.com/forms/d/e/1FAIpQLScV12kvETk8jc4Zc4sIsHiteMHRVo5I8DiSAE8RyVdVkUaxJA/viewform?usp=sf_link).
- Reporting bugs or requesting features [here](https://github.com/SciQLop/speasy/issues/new).
- Creating or participating in discussions [here](https://github.com/SciQLop/speasy/discussions).

Your feedback is essential to making Speasy a better tool for everyone.

## Quickstart
### Installation

Installing Speasy with pip ([more details here](https://speasy.readthedocs.io/en/stable/installation.html)):

``` console
$ python -m pip install speasy
# or
$ python -m pip install --user speasy
```

### Examples
#### Simple request

This simple code example shows how easy it is to get data using Speasy. The code imports the Speasy package and defines a variable named ace_mag. This variable stores the data for the ACE IMF product, for the time period from June 2, 2016 to June 5, 2016. The code then uses the Speasy plot() function to plot the data.


```python
import numpy.linalg
import speasy as spz
ace_mag = spz.get_data('amda/imf', "2016-6-2", "2016-6-5")
ace_mag.plot();
```


    
![png](README_files/README_2_0.png)
    


#### Using the dynamic inventory

Where amda is the webservice and imf is the product id you will get with
this request.

Using the dynamic inventory will produce the same result as the previous example, but it has the advantage of being easier to manipulate, since you can discover available data from your favorite Python environment completion tool, such as IPython or notebooks.


```python
import speasy as spz
amda_tree = spz.inventories.data_tree.amda
ace_mag = spz.get_data(amda_tree.Parameters.ACE.MFI.ace_imf_all.imf, "2016-6-2", "2016-6-5")
ace_mag.plot();
```


    
![png](README_files/README_4_0.png)
    


#### Plotting multiple time series on a single figure

This code example shows how to use Speasy to plot multiple time series of space physics data from the **MMS1** spacecraft on a single figure, with a shared x-axis. The code imports the Speasy package and the [Matplotlib](https://matplotlib.org/stable/) plotting library. It then creates a figure with six subplots, arranged in a single column. Next, it defines a list of products and axes to plot. Finally, it iterates over the list of products and axes, plotting each product on the corresponding axis. The code uses the Speasy [get_data()](https://speasy.readthedocs.io/en/latest/dev/speasy.html#speasy.get_data) function to load the data for each product, and the [replace_fillval_by_nan()](https://speasy.readthedocs.io/en/latest/dev/speasy.html#speasy.SpeasyVariable.replace_fillval_by_nan) function to replace any fill values with NaNs. 


```python
import speasy as spz
import matplotlib.pyplot as plt

fig = plt.figure(figsize=(8, 16), layout="constrained")
gs = fig.add_gridspec(6, hspace=0, wspace=0)
axes = gs.subplots(sharex=True)

plots = [
    (spz.inventories.tree.cda.MMS.MMS1.FGM.MMS1_FGM_SRVY_L2.mms1_fgm_b_gse_srvy_l2_clean, axes[0]),
    (spz.inventories.tree.cda.MMS.MMS1.SCM.MMS1_SCM_SRVY_L2_SCSRVY.mms1_scm_acb_gse_scsrvy_srvy_l2 , axes[1]),
    (spz.inventories.tree.cda.MMS.MMS1.DES.MMS1_FPI_FAST_L2_DES_MOMS.mms1_des_bulkv_gse_fast, axes[2]),
    (spz.inventories.tree.cda.MMS.MMS1.DES.MMS1_FPI_FAST_L2_DES_MOMS.mms1_des_temppara_fast, axes[3]),
    (spz.inventories.tree.cda.MMS.MMS1.DES.MMS1_FPI_FAST_L2_DES_MOMS.mms1_des_tempperp_fast, axes[3]),
    (spz.inventories.tree.cda.MMS.MMS1.DES.MMS1_FPI_FAST_L2_DES_MOMS.mms1_des_energyspectr_omni_fast, axes[4]),
    (spz.inventories.tree.cda.MMS.MMS1.DIS.MMS1_FPI_FAST_L2_DIS_MOMS.mms1_dis_energyspectr_omni_fast, axes[5])
]

def plot_product(product, ax):
    values = spz.get_data(product, "2019-01-02T15", "2019-01-02T22")
    values.replace_fillval_by_nan().plot(ax=ax)

for p in plots:
    plot_product(p[0], p[1])

plt.show()
```


    
![png](README_files/README_6_0.png)
    


#### Requesting multiple products and intervals at once

More complex requests like this one are supported:


```python
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)
data
```




    [[<speasy.products.variable.SpeasyVariable at 0x7f14662feb80>,
      <speasy.products.variable.SpeasyVariable at 0x7f146688a7c0>],
     [<speasy.products.variable.SpeasyVariable at 0x7f14660b0f40>,
      <speasy.products.variable.SpeasyVariable at 0x7f14660d1180>],
     [<speasy.products.variable.SpeasyVariable at 0x7f1465f6da80>,
      <speasy.products.variable.SpeasyVariable at 0x7f14660f43c0>],
     [<speasy.products.variable.SpeasyVariable at 0x7f14664d8dc0>,
      <speasy.products.variable.SpeasyVariable at 0x7f146619fd40>],
     [<speasy.products.variable.SpeasyVariable at 0x7f14660e63c0>,
      <speasy.products.variable.SpeasyVariable at 0x7f1465f0ba40>]]



#### Numpy operations

Speasy variables support numpy operations, as shown in this example. The code imports the Speasy package and the NumPy library, and uses the Speasy [get_data()](https://speasy.readthedocs.io/en/latest/dev/speasy.html#speasy.get_data) function to load the magnetic field data for the MMS1 spacecraft for the time period from January 1, 2017 to January 1, 2017. The code then uses the NumPy [sqrt()](https://numpy.org/doc/stable/reference/generated/numpy.sqrt.html) and [sum()](https://numpy.org/doc/stable/reference/generated/numpy.sum.html) functions to compute the norm of the magnetic field vector. Finally, the code uses the NumPy [allclose()](https://numpy.org/doc/stable/reference/generated/numpy.allclose.html) function to check if the computed norm is close to the provided total magnetic field norm (Bt) values.


```python
import speasy as spz
import numpy as np
mms1_products = spz.inventories.tree.cda.MMS.MMS1
b = spz.get_data(mms1_products.FGM.MMS1_FGM_SRVY_L2.mms1_fgm_b_gsm_srvy_l2, '2017-01-01T02:00:00', '2017-01-01T02:00:15')
b.replace_fillval_by_nan(inplace=True)  # replace fill values by NaN
bt = b["Bt"]
b = b["Bx GSM", "By GSM", "Bz GSM"]
computed_norm = np.sqrt(np.sum(b ** 2, axis=1))
print(f"Type of b: {type(b)}\nType of computed_norm: {type(computed_norm)}\nType of bt: {type(bt)}")
print(f"Is the computed norm close to the provided total magnetic field norm? {np.allclose(computed_norm, bt)}")
```

    Type of b: <class 'speasy.products.variable.SpeasyVariable'>
    Type of computed_norm: <class 'speasy.products.variable.SpeasyVariable'>
    Type of bt: <class 'speasy.products.variable.SpeasyVariable'>
    Is the computed norm close to the provided total magnetic field norm? True


#### Resampling

Speasy provides a simple way to filter and resample data. In this example, the code imports the Speasy package and the [Matplotlib](https://matplotlib.org/stable/) plotting library. It then uses the Speasy [get_data()](https://speasy.readthedocs.io/en/latest/dev/speasy.html#speasy.get_data) function to load the magnetic field and temperature data for the MMS1 spacecraft for the time period from January 1, 2017 to January 1, 2017. The code then uses the Speasy [interpolate()](https://speasy.readthedocs.io/en/latest/dev/speasy.signal.resampling.html#speasy.signal.resampling.interpolate) function to interpolate the temperature data to match the magnetic field data sampling rate. Finally, the code plots the magnetic field and temperature data on the same figure.


```python
import speasy as spz
from speasy.signal.resampling import interpolate
import matplotlib.pyplot as plt
mms1_products = spz.inventories.tree.cda.MMS.MMS1

b, Tperp, Tpara = spz.get_data(
        [
            mms1_products.FGM.MMS1_FGM_SRVY_L2.mms1_fgm_b_gsm_srvy_l2,
            mms1_products.DIS.MMS1_FPI_FAST_L2_DIS_MOMS.mms1_dis_tempperp_fast,
            mms1_products.DIS.MMS1_FPI_FAST_L2_DIS_MOMS.mms1_dis_temppara_fast
        ],
        '2017-01-01T02:00:00',
        '2017-01-01T02:00:15'
    )


Tperp_interp, Tpara_interp = interpolate(b, [Tperp, Tpara])

plt.figure()
ax = b.plot()
plt.plot(Tperp_interp.time, Tperp_interp.values, marker='+')
plt.plot(Tpara_interp.time, Tpara_interp.values, marker='+')
plt.tight_layout()
```


    
![png](README_files/README_12_0.png)
    


### Documentation and examples

Check out [Speasy documentation](https://speasy.readthedocs.io/en/stable/) and [examples](https://speasy.readthedocs.io/en/latest/examples/index.html).

### Caveats

-   Speasy is not a plotting package.
    basic plotting capabilities are here for illustration purposes and making quick-and-dirty plots.
    It is not meant to produce publication ready figures, prefer using Matplotlib directly for example.
    
### Credits

The development of Speasy is supported by the [CDPP](http://www.cdpp.eu/).

This package was created with
[Cookiecutter](https://github.com/audreyr/cookiecutter) and the
[audreyr/cookiecutter-pypackage](https://github.com/audreyr/cookiecutter-pypackage)
project template.



            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "speasy",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "Alexis Jeandet <alexis.jeandet@member.fsf.org>",
    "keywords": "satellite, plasma-physics, nasa-data, amda, cdpp, CDF",
    "author": null,
    "author_email": "Alexis Jeandet <alexis.jeandet@member.fsf.org>",
    "download_url": "https://files.pythonhosted.org/packages/70/3f/54bc1c61135a84312e1745965f9c68938bf400e2638932cc70b08ba0710c/speasy-1.3.2.tar.gz",
    "platform": null,
    "description": "<h1 align=\"center\">\n<img src=\"https://raw.githubusercontent.com/SciQLop/speasy/main/logo/logo_speasy.svg\" width=\"300\">\n</h1><br>\n\n# Space Physics made EASY\n\n[![Chat on Matrix](https://img.shields.io/matrix/speasy:matrix.org)](https://matrix.to/#/#speasy:matrix.org)\n[![image](https://img.shields.io/pypi/v/speasy.svg)](https://pypi.python.org/pypi/speasy)\n[![image](https://github.com/SciQLop/speasy/workflows/Tests/badge.svg)](https://github.com/SciQLop/speasy/actions?query=workflow%3A%22Tests%22)\n[![Documentation Status](https://readthedocs.org/projects/speasy/badge/?version=latest)](https://speasy.readthedocs.io/en/latest/?badge=latest)\n[![Coverage Status](https://codecov.io/gh/SciQLop/speasy/coverage.svg?branch=main)](https://codecov.io/gh/SciQLop/speasy/branch/main)\n[![CodeQL](https://github.com/SciQLop/speasy/actions/workflows/codeql.yml/badge.svg)](https://github.com/SciQLop/speasy/actions/workflows/codeql.yml)\n[![Zendoo DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.4118780.svg)](https://doi.org/10.5281/zenodo.4118780)\n[![Discover on MyBinder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/SciQLop/speasy/main?labpath=docs/examples)\n[![Discover on Google Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/SciQLop/speasy)\n[![Speasy proxy uptime (30 days)](https://img.shields.io/uptimerobot/ratio/m792771930-24b7f89c03d5090a13462b70)](http://sciqlop.lpp.polytechnique.fr/cache)\n\nSpeasy is a free and open-source Python package that makes it easy to find and load space physics data from a variety of\ndata sources, whether it is online and public such as [CDAWEB](https://cdaweb.gsfc.nasa.gov/index.html/) and [AMDA](http://amda.irap.omp.eu/),\nor any described archive, local or remote.\nThis task, where any science project starts, would seem easy a priori but, considering the very\ndiverse array of missions and instrument nowaday available, proves to be one of the major bottleneck,\nespecially for students and newcomers.\nSpeasy solves this problem by providing a **single, easy-to-use interface to over 70 space missions and 65,000 products**.\n\nDon't want to write code? See our graphical interface [SciQLop](https://github.com/SciQLop/SciQLop).\n\n## Main features\n\n-   Simple and intuitive API (`spz.get_data(...)` to get them all)\n-   Speasy variables are like Pandas DataFrame with seemless conversion to/from it (as long as the shape is compatible)\n-   Speasy variables support numpy operations, [see numpy operations example below](#numpy-operations)\n-   Speasy variables filtering and resampling capabilities, [see resampling example below](#resampling)\n-   Local cache to avoid redundant downloads\n-   Uses the SciQLOP ultra fast community cache server\n-   Full support of [AMDA](http://amda.irap.omp.eu/) API\n-   Can retrieve time-series from [AMDA](http://amda.irap.omp.eu/),\n    [CDAWeb](https://cdaweb.gsfc.nasa.gov/),\n    [CSA](https://csa.esac.esa.int/csa-web/),\n    [SSCWeb](https://sscweb.gsfc.nasa.gov/)\n-   Support data access from any local or remote archives described by YAML file.\n  \n## Help us improve Speasy!\n\nWe want Speasy to be the best possible tool for space physics research. You can help us by:\n\n- Answering our user survey [here](https://docs.google.com/forms/d/e/1FAIpQLScV12kvETk8jc4Zc4sIsHiteMHRVo5I8DiSAE8RyVdVkUaxJA/viewform?usp=sf_link).\n- Reporting bugs or requesting features [here](https://github.com/SciQLop/speasy/issues/new).\n- Creating or participating in discussions [here](https://github.com/SciQLop/speasy/discussions).\n\nYour feedback is essential to making Speasy a better tool for everyone.\n\n## Quickstart\n### Installation\n\nInstalling Speasy with pip ([more details here](https://speasy.readthedocs.io/en/stable/installation.html)):\n\n``` console\n$ python -m pip install speasy\n# or\n$ python -m pip install --user speasy\n```\n\n### Examples\n#### Simple request\n\nThis simple code example shows how easy it is to get data using Speasy. The code imports the Speasy package and defines a variable named ace_mag. This variable stores the data for the ACE IMF product, for the time period from June 2, 2016 to June 5, 2016. The code then uses the Speasy plot() function to plot the data.\n\n\n```python\nimport numpy.linalg\nimport speasy as spz\nace_mag = spz.get_data('amda/imf', \"2016-6-2\", \"2016-6-5\")\nace_mag.plot();\n```\n\n\n    \n![png](README_files/README_2_0.png)\n    \n\n\n#### Using the dynamic inventory\n\nWhere amda is the webservice and imf is the product id you will get with\nthis request.\n\nUsing the dynamic inventory will produce the same result as the previous example, but it has the advantage of being easier to manipulate, since you can discover available data from your favorite Python environment completion tool, such as IPython or notebooks.\n\n\n```python\nimport speasy as spz\namda_tree = spz.inventories.data_tree.amda\nace_mag = spz.get_data(amda_tree.Parameters.ACE.MFI.ace_imf_all.imf, \"2016-6-2\", \"2016-6-5\")\nace_mag.plot();\n```\n\n\n    \n![png](README_files/README_4_0.png)\n    \n\n\n#### Plotting multiple time series on a single figure\n\nThis code example shows how to use Speasy to plot multiple time series of space physics data from the **MMS1** spacecraft on a single figure, with a shared x-axis. The code imports the Speasy package and the [Matplotlib](https://matplotlib.org/stable/) plotting library. It then creates a figure with six subplots, arranged in a single column. Next, it defines a list of products and axes to plot. Finally, it iterates over the list of products and axes, plotting each product on the corresponding axis. The code uses the Speasy [get_data()](https://speasy.readthedocs.io/en/latest/dev/speasy.html#speasy.get_data) function to load the data for each product, and the [replace_fillval_by_nan()](https://speasy.readthedocs.io/en/latest/dev/speasy.html#speasy.SpeasyVariable.replace_fillval_by_nan) function to replace any fill values with NaNs. \n\n\n```python\nimport speasy as spz\nimport matplotlib.pyplot as plt\n\nfig = plt.figure(figsize=(8, 16), layout=\"constrained\")\ngs = fig.add_gridspec(6, hspace=0, wspace=0)\naxes = gs.subplots(sharex=True)\n\nplots = [\n    (spz.inventories.tree.cda.MMS.MMS1.FGM.MMS1_FGM_SRVY_L2.mms1_fgm_b_gse_srvy_l2_clean, axes[0]),\n    (spz.inventories.tree.cda.MMS.MMS1.SCM.MMS1_SCM_SRVY_L2_SCSRVY.mms1_scm_acb_gse_scsrvy_srvy_l2 , axes[1]),\n    (spz.inventories.tree.cda.MMS.MMS1.DES.MMS1_FPI_FAST_L2_DES_MOMS.mms1_des_bulkv_gse_fast, axes[2]),\n    (spz.inventories.tree.cda.MMS.MMS1.DES.MMS1_FPI_FAST_L2_DES_MOMS.mms1_des_temppara_fast, axes[3]),\n    (spz.inventories.tree.cda.MMS.MMS1.DES.MMS1_FPI_FAST_L2_DES_MOMS.mms1_des_tempperp_fast, axes[3]),\n    (spz.inventories.tree.cda.MMS.MMS1.DES.MMS1_FPI_FAST_L2_DES_MOMS.mms1_des_energyspectr_omni_fast, axes[4]),\n    (spz.inventories.tree.cda.MMS.MMS1.DIS.MMS1_FPI_FAST_L2_DIS_MOMS.mms1_dis_energyspectr_omni_fast, axes[5])\n]\n\ndef plot_product(product, ax):\n    values = spz.get_data(product, \"2019-01-02T15\", \"2019-01-02T22\")\n    values.replace_fillval_by_nan().plot(ax=ax)\n\nfor p in plots:\n    plot_product(p[0], p[1])\n\nplt.show()\n```\n\n\n    \n![png](README_files/README_6_0.png)\n    \n\n\n#### Requesting multiple products and intervals at once\n\nMore complex requests like this one are supported:\n\n\n```python\nimport speasy as spz\nproducts = [\n    spz.inventories.tree.amda.Parameters.Wind.SWE.wnd_swe_kp.wnd_swe_vth,\n    spz.inventories.tree.amda.Parameters.Wind.SWE.wnd_swe_kp.wnd_swe_pdyn,\n    spz.inventories.tree.amda.Parameters.Wind.SWE.wnd_swe_kp.wnd_swe_n,\n    spz.inventories.tree.cda.Wind.WIND.MFI.WI_H2_MFI.BGSE,\n    spz.inventories.tree.ssc.Trajectories.wind,\n]\nintervals = [[\"2010-01-02\", \"2010-01-02T10\"], [\"2009-08-02\", \"2009-08-02T10\"]]\ndata = spz.get_data(products, intervals)\ndata\n```\n\n\n\n\n    [[<speasy.products.variable.SpeasyVariable at 0x7f14662feb80>,\n      <speasy.products.variable.SpeasyVariable at 0x7f146688a7c0>],\n     [<speasy.products.variable.SpeasyVariable at 0x7f14660b0f40>,\n      <speasy.products.variable.SpeasyVariable at 0x7f14660d1180>],\n     [<speasy.products.variable.SpeasyVariable at 0x7f1465f6da80>,\n      <speasy.products.variable.SpeasyVariable at 0x7f14660f43c0>],\n     [<speasy.products.variable.SpeasyVariable at 0x7f14664d8dc0>,\n      <speasy.products.variable.SpeasyVariable at 0x7f146619fd40>],\n     [<speasy.products.variable.SpeasyVariable at 0x7f14660e63c0>,\n      <speasy.products.variable.SpeasyVariable at 0x7f1465f0ba40>]]\n\n\n\n#### Numpy operations\n\nSpeasy variables support numpy operations, as shown in this example. The code imports the Speasy package and the NumPy library, and uses the Speasy [get_data()](https://speasy.readthedocs.io/en/latest/dev/speasy.html#speasy.get_data) function to load the magnetic field data for the MMS1 spacecraft for the time period from January 1, 2017 to January 1, 2017. The code then uses the NumPy [sqrt()](https://numpy.org/doc/stable/reference/generated/numpy.sqrt.html) and [sum()](https://numpy.org/doc/stable/reference/generated/numpy.sum.html) functions to compute the norm of the magnetic field vector. Finally, the code uses the NumPy [allclose()](https://numpy.org/doc/stable/reference/generated/numpy.allclose.html) function to check if the computed norm is close to the provided total magnetic field norm (Bt) values.\n\n\n```python\nimport speasy as spz\nimport numpy as np\nmms1_products = spz.inventories.tree.cda.MMS.MMS1\nb = spz.get_data(mms1_products.FGM.MMS1_FGM_SRVY_L2.mms1_fgm_b_gsm_srvy_l2, '2017-01-01T02:00:00', '2017-01-01T02:00:15')\nb.replace_fillval_by_nan(inplace=True)  # replace fill values by NaN\nbt = b[\"Bt\"]\nb = b[\"Bx GSM\", \"By GSM\", \"Bz GSM\"]\ncomputed_norm = np.sqrt(np.sum(b ** 2, axis=1))\nprint(f\"Type of b: {type(b)}\\nType of computed_norm: {type(computed_norm)}\\nType of bt: {type(bt)}\")\nprint(f\"Is the computed norm close to the provided total magnetic field norm? {np.allclose(computed_norm, bt)}\")\n```\n\n    Type of b: <class 'speasy.products.variable.SpeasyVariable'>\n    Type of computed_norm: <class 'speasy.products.variable.SpeasyVariable'>\n    Type of bt: <class 'speasy.products.variable.SpeasyVariable'>\n    Is the computed norm close to the provided total magnetic field norm? True\n\n\n#### Resampling\n\nSpeasy provides a simple way to filter and resample data. In this example, the code imports the Speasy package and the [Matplotlib](https://matplotlib.org/stable/) plotting library. It then uses the Speasy [get_data()](https://speasy.readthedocs.io/en/latest/dev/speasy.html#speasy.get_data) function to load the magnetic field and temperature data for the MMS1 spacecraft for the time period from January 1, 2017 to January 1, 2017. The code then uses the Speasy [interpolate()](https://speasy.readthedocs.io/en/latest/dev/speasy.signal.resampling.html#speasy.signal.resampling.interpolate) function to interpolate the temperature data to match the magnetic field data sampling rate. Finally, the code plots the magnetic field and temperature data on the same figure.\n\n\n```python\nimport speasy as spz\nfrom speasy.signal.resampling import interpolate\nimport matplotlib.pyplot as plt\nmms1_products = spz.inventories.tree.cda.MMS.MMS1\n\nb, Tperp, Tpara = spz.get_data(\n        [\n            mms1_products.FGM.MMS1_FGM_SRVY_L2.mms1_fgm_b_gsm_srvy_l2,\n            mms1_products.DIS.MMS1_FPI_FAST_L2_DIS_MOMS.mms1_dis_tempperp_fast,\n            mms1_products.DIS.MMS1_FPI_FAST_L2_DIS_MOMS.mms1_dis_temppara_fast\n        ],\n        '2017-01-01T02:00:00',\n        '2017-01-01T02:00:15'\n    )\n\n\nTperp_interp, Tpara_interp = interpolate(b, [Tperp, Tpara])\n\nplt.figure()\nax = b.plot()\nplt.plot(Tperp_interp.time, Tperp_interp.values, marker='+')\nplt.plot(Tpara_interp.time, Tpara_interp.values, marker='+')\nplt.tight_layout()\n```\n\n\n    \n![png](README_files/README_12_0.png)\n    \n\n\n### Documentation and examples\n\nCheck out [Speasy documentation](https://speasy.readthedocs.io/en/stable/) and [examples](https://speasy.readthedocs.io/en/latest/examples/index.html).\n\n### Caveats\n\n-   Speasy is not a plotting package.\n    basic plotting capabilities are here for illustration purposes and making quick-and-dirty plots.\n    It is not meant to produce publication ready figures, prefer using Matplotlib directly for example.\n    \n### Credits\n\nThe development of Speasy is supported by the [CDPP](http://www.cdpp.eu/).\n\nThis package was created with\n[Cookiecutter](https://github.com/audreyr/cookiecutter) and the\n[audreyr/cookiecutter-pypackage](https://github.com/audreyr/cookiecutter-pypackage)\nproject template.\n\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A simple Python package to deal with main Space Physics WebServices (CDA, CSA, AMDA and SSC).",
    "version": "1.3.2",
    "project_urls": {
        "homepage": "https://github.com/SciQLop/speasy"
    },
    "split_keywords": [
        "satellite",
        " plasma-physics",
        " nasa-data",
        " amda",
        " cdpp",
        " cdf"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "11e014031271b0d4766a156c5368bee1491f4192d331c0d9853f70d44484bf78",
                "md5": "83dbf2b2f39919d59fea08f8212da665",
                "sha256": "8aecd21ed8ea342fdbb82c49a864c0ca1c882a595002547884d5fafbc17ee8d8"
            },
            "downloads": -1,
            "filename": "speasy-1.3.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "83dbf2b2f39919d59fea08f8212da665",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 88296,
            "upload_time": "2024-06-18T09:48:58",
            "upload_time_iso_8601": "2024-06-18T09:48:58.271776Z",
            "url": "https://files.pythonhosted.org/packages/11/e0/14031271b0d4766a156c5368bee1491f4192d331c0d9853f70d44484bf78/speasy-1.3.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "703f54bc1c61135a84312e1745965f9c68938bf400e2638932cc70b08ba0710c",
                "md5": "f7235cb4e63e99ac806037c7dd21f7b3",
                "sha256": "8a603477f0fdc0d208b73b3b65e965e9b55414d357bccf22f1123318f2b71223"
            },
            "downloads": -1,
            "filename": "speasy-1.3.2.tar.gz",
            "has_sig": false,
            "md5_digest": "f7235cb4e63e99ac806037c7dd21f7b3",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 71252,
            "upload_time": "2024-06-18T09:49:00",
            "upload_time_iso_8601": "2024-06-18T09:49:00.292804Z",
            "url": "https://files.pythonhosted.org/packages/70/3f/54bc1c61135a84312e1745965f9c68938bf400e2638932cc70b08ba0710c/speasy-1.3.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-06-18 09:49:00",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "SciQLop",
    "github_project": "speasy",
    "travis_ci": true,
    "coveralls": true,
    "github_actions": true,
    "requirements": [
        {
            "name": "pandas",
            "specs": []
        },
        {
            "name": "appdirs",
            "specs": []
        },
        {
            "name": "diskcache",
            "specs": []
        },
        {
            "name": "requests",
            "specs": []
        },
        {
            "name": "urllib3",
            "specs": [
                [
                    ">=",
                    "1.26.0"
                ]
            ]
        },
        {
            "name": "packaging",
            "specs": []
        },
        {
            "name": "numpy",
            "specs": []
        },
        {
            "name": "python_dateutil",
            "specs": []
        },
        {
            "name": "astropy",
            "specs": []
        },
        {
            "name": "pyistp",
            "specs": [
                [
                    ">=",
                    "0.5.0"
                ]
            ]
        },
        {
            "name": "astroquery",
            "specs": []
        },
        {
            "name": "tqdm",
            "specs": []
        },
        {
            "name": "matplotlib",
            "specs": []
        },
        {
            "name": "PyYAML",
            "specs": []
        },
        {
            "name": "scipy",
            "specs": []
        }
    ],
    "tox": true,
    "lcname": "speasy"
}
        
Elapsed time: 0.30008s