## Synopsis
NASA's [Satellite Situation Center](https://sscweb.gsfc.nasa.gov/)
(SSC) is a system to cast geocentric spacecraft location information
into a framework of (empirical) geophysical regions and mappings of
spacecraft locations along lines of the Earth's magnetic field.
This library implements the client side of the
[SSC RESTful web services](https://sscweb.gsfc.nasa.gov/WebServices/REST/).
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
---
This
["Getting Started"](https://sscweb.gsfc.nasa.gov/WebServices/REST/py/GetStarted.html)
page contains information to help someone begin using the sscws library to
access information from the
[Satellite Situation Center](https://sscweb.gsfc.nasa.gov/) in a Python program.
---
Also, the following [Jupyter notebooks](https://jupyter.org/) demonstrate
different features of the library:
1. [Simple Location Example](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsExample.html) ([ipynb file](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsExample.ipynb))demonstrating a simple 3D plot of orbit information.
2. [Complex Location Example](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsBTraceExample.html) ([ipynb file](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsBTraceExample.ipynb)) requesting many values including magnetic field line tracing. This example also demonstrates how to diagnose a problem with an invalid request.
3. [Radial Conjunction With Ground Location](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsRadialConjunction.html) ([ipynb file](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsRadialConjunction.ipynb)).
4. [Magnetic Field Line Conjunction Example](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsConjunctionExample.html) ([ipynb file](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsConjunctionExample.ipynb)) with related data retrieval/plotting using [cdasws](https://pypi.org/project/cdasws/).
These notebooks are also available on
[Binder](https://binder.opensci.2i2c.cloud/v2/gh/berniegsfc/sscws-notebooks/main).
## 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](https://pypi.org/project/requests/)
2. [numpy](https://pypi.ort/project/numpy/)
3. [matplotlib](https://pypi.org/project/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](https://sscweb.gsfc.nasa.gov/WebServices/REST/py/sscws/index.html)
or use the standard python help mechanism.
from sscws import SscWs
help(SscWs)
## Tests
The tests directory contains
[unittest](https://docs.python.org/3/library/unittest.html)
tests.
## Contributors
Bernie Harris.
[e-mail](mailto:NASA-SPDF-Support@nasa.onmicrosoft.com) for support.
## License
This code is licensed under the
[NASA Open Source Agreement](https://sscweb.gsfc.nasa.gov/WebServices/NASA_Open_Source_Agreement_1.3.txt) (NOSA).
Raw data
{
"_id": null,
"home_page": "https://sscweb.gsfc.nasa.gov/WebServices/REST",
"name": "sscws",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "heliophysics, satellites, trajectories, orbits, location, conjunctions, earth magnetic field, ephemeris, space physics, spdf, ssc",
"author": "Bernie Harris",
"author_email": "NASA-SPDF-Support@nasa.onmicrosoft.com",
"download_url": "https://files.pythonhosted.org/packages/2f/73/13741c287968fbe3f80859b71b7c07471c2f4342d64a206cf7bd51fda4eb/sscws-2.4.2.tar.gz",
"platform": null,
"description": "\n## Synopsis\n\nNASA's [Satellite Situation Center](https://sscweb.gsfc.nasa.gov/)\n(SSC) is a system to cast geocentric spacecraft location information \ninto a framework of (empirical) geophysical regions and mappings of \nspacecraft locations along lines of the Earth's magnetic field. \nThis library implements the client side of the \n[SSC RESTful web services](https://sscweb.gsfc.nasa.gov/WebServices/REST/).\nFor more general details about the SSC web services, see\nhttps://sscweb.gsfc.nasa.gov/WebServices/REST/.\n\n## Code Example\n\nThis package contains example code calling most of the available web services.\nTo run the included example, do the following\n\n python -m sscws\n\n---\n\nThis \n[\"Getting Started\"](https://sscweb.gsfc.nasa.gov/WebServices/REST/py/GetStarted.html) \npage contains information to help someone begin using the sscws library to \naccess information from the \n[Satellite Situation Center](https://sscweb.gsfc.nasa.gov/) in a Python program.\n\n---\n\nAlso, the following [Jupyter notebooks](https://jupyter.org/) demonstrate\ndifferent features of the library:\n1. [Simple Location Example](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsExample.html) ([ipynb file](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsExample.ipynb))demonstrating a simple 3D plot of orbit information.\n2. [Complex Location Example](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsBTraceExample.html) ([ipynb file](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsBTraceExample.ipynb)) requesting many values including magnetic field line tracing. This example also demonstrates how to diagnose a problem with an invalid request.\n3. [Radial Conjunction With Ground Location](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsRadialConjunction.html) ([ipynb file](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsRadialConjunction.ipynb)).\n4. [Magnetic Field Line Conjunction Example](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsConjunctionExample.html) ([ipynb file](https://sscweb.gsfc.nasa.gov/WebServices/REST/jupyter/SscWsConjunctionExample.ipynb)) with related data retrieval/plotting using [cdasws](https://pypi.org/project/cdasws/).\n\nThese notebooks are also available on \n[Binder](https://binder.opensci.2i2c.cloud/v2/gh/berniegsfc/sscws-notebooks/main).\n\n## Motivation\n\nThis library hides the HTTP, JSON/XML, and CDF details of the SSC web \nservices. A python developer only has to deal with python objects and \nmethods.\n\n## Dependencies\n\nAt this time, the only dependency are:\n1. [requests](https://pypi.org/project/requests/)\n2. [numpy](https://pypi.ort/project/numpy/)\n3. [matplotlib](https://pypi.org/project/matplotlib/). This is an optional dependency. If it is not installed, the example will simple skip plotting some data.\n\nThe critical dependencies above will automatically be installed when this \nlibrary is.\n\n## Installation\n\nTo install this package\n\n $ pip install -U sscws\n\nor to include plotting\n\n $ pip install -U sscws[plot]\n\n\n## API Reference\n\nRefer to\n[sscws package API reference](https://sscweb.gsfc.nasa.gov/WebServices/REST/py/sscws/index.html)\n\nor use the standard python help mechanism.\n\n from sscws import SscWs\n help(SscWs)\n\n## Tests\n\nThe tests directory contains \n[unittest](https://docs.python.org/3/library/unittest.html)\ntests.\n\n## Contributors\n\nBernie Harris. \n[e-mail](mailto:NASA-SPDF-Support@nasa.onmicrosoft.com) for support.\n\n## License\n\nThis code is licensed under the \n[NASA Open Source Agreement](https://sscweb.gsfc.nasa.gov/WebServices/NASA_Open_Source_Agreement_1.3.txt) (NOSA).\n\n\n",
"bugtrack_url": null,
"license": "NOSA",
"summary": "NASA's Satellite Situation Center Web Service Client Library",
"version": "2.4.2",
"project_urls": {
"Homepage": "https://sscweb.gsfc.nasa.gov/WebServices/REST"
},
"split_keywords": [
"heliophysics",
" satellites",
" trajectories",
" orbits",
" location",
" conjunctions",
" earth magnetic field",
" ephemeris",
" space physics",
" spdf",
" ssc"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c1988651873fc7a97def57eb2ac87516e1e51ec8808f17c22043082c6cf41c16",
"md5": "17e9b44d3adcdbb829319621ecce9578",
"sha256": "b07e0ec65ff6a18a0e00f0eabd88cee6491630592b14a67eaa144efaac165b4b"
},
"downloads": -1,
"filename": "sscws-2.4.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "17e9b44d3adcdbb829319621ecce9578",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 63009,
"upload_time": "2024-11-26T13:34:12",
"upload_time_iso_8601": "2024-11-26T13:34:12.674739Z",
"url": "https://files.pythonhosted.org/packages/c1/98/8651873fc7a97def57eb2ac87516e1e51ec8808f17c22043082c6cf41c16/sscws-2.4.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2f7313741c287968fbe3f80859b71b7c07471c2f4342d64a206cf7bd51fda4eb",
"md5": "d9313b32a0ae2216d3a484cac6d8d9ca",
"sha256": "13555853d51ce8ca9b065b22f190e17360cd720795b5bfcb4f9679442200a345"
},
"downloads": -1,
"filename": "sscws-2.4.2.tar.gz",
"has_sig": false,
"md5_digest": "d9313b32a0ae2216d3a484cac6d8d9ca",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 48251,
"upload_time": "2024-11-26T13:34:14",
"upload_time_iso_8601": "2024-11-26T13:34:14.686560Z",
"url": "https://files.pythonhosted.org/packages/2f/73/13741c287968fbe3f80859b71b7c07471c2f4342d64a206cf7bd51fda4eb/sscws-2.4.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-26 13:34:14",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "sscws"
}
JSON