sscws 0.2.4

NASA's Satellite Situation Center Web Service Client Library

Synopsis

This library provides a simple python interface to NASA's Satellite Situation Center (SSC). This library implements the client side of the SSC RESTful web services. For more general details about the SSC web services, see https://sscweb.gsfc.nasa.gov/WebServices/REST/.

Code Example

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

python -m sscws

---

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

1. Simple Location Example (ipynb file)demonstrating a simple 3D plot of orbit information.
2. Complex Location Example (ipynb file) requesting many values including magnetic field line tracing. This example also demonstrates how to diagnose a problem with an invalid request.
3. Magnetic Field Line Conjunction Example (ipynb file) with related data retrieval/plotting using cdasws.

Motivation

This library hides the HTTP, JSON/XML, and CDF details of the SSC web services. A python developer only has to deal with python objects and methods.

Dependencies

At this time, the only dependency are:

1. requests
2. numpy
3. matplotlib. This is an optional dependency. If it is not installed, the example will simple skip plotting some data.

The critical dependencies above will automatically be installed when this library is.

Installation

To install this package

$ pip install -U sscws

or to include plotting $ pip install -U sscws[plot]

API Reference

Refer to sscws package API reference

or use the standard python help mechanism.

from sscws import SscWs
help(SscWs)

Tests

The tests directory contains unittest tests.

Contributors

Bernie Harris.
e-mail for support.

License

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