Skip to main content

NASA's Coordinated Data Analysis System Web Service Client Library

Project description


This library provides a simple python interface to the data and services of NASA's Coordinated Data Analysis System (CDAS). This library implements the client side of the CDAS RESTful web services and can return data in the SpacePy data model or an xarray.Dataset with all the original ISTP/SPDF metadata. Frequently asked questions concerning this library are at FAQ. For more general details about the CDAS web services, see

Code Example

This package contains example code calling most of the available web services. To run the included example, do the following

python -m cdasws

Also, the following Jupyter notebooks demonstrate different features of the library:

  1. Basic Example (ipynb file) demonstrating use of library with results returned in SpacePy data model.
  2. Basic Example (ipynb file) demonstrating use of library with results returned in an xarray.Dataset. Launch on Binder.
  3. Magnetic Field Line Conjunction Example (ipynb file) with related data retrieval/plotting using cdasws. Launch on Binder.

And at the bottom of each CDAWeb dataset description is a "Data Access Code Examples" link that contains dataset-specific code utilizing this package to access the data.


This library hides the HTTP, JSON/XML, and CDF details of the CDAS web services. A python developer only has to deal with python objects and methods (primarily the SpacePy data model or xarray.Dataset object with full ISTP/SPDF metadata).


The only required dependencies are python-dateutil and requests. If you call the get_data method then one of the following two sets of additional dependencies are required:

  1. To have get_data return the data in the SpacePy data model.
    • SpacePy. Refer to the SpacePy documentation for the details of SpacePy's dependencies.
    • CDF which is not (at the time of this writing) automatically installed with SpacePy.
  2. To have get_data return the data in an xarray dataset.


As noted in the dependencies above, if you intend to call the get_data method, you must install either

  1. SpacePy and the CDF library (following the procedures at the SpacePy and CDF web sites).

  2. cdflib and xarray .

    $ pip install -U cdflib $ pip install -U xarray

Then, to install this package

$ pip install -U cdasws

API Reference

Refer to cdasws package API reference

or use the standard python help mechanism.

from cdasws import CdasWs


The tests directory contains unittest tests.


Bernie Harris.
e-mail for support.


This code is licensed under the NASA Open Source Agreement (NOSA).

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cdasws-1.7.43.tar.gz (21.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page