sscws 2.4.2__tar.gz → 2.4.3__tar.gz

sscws-2.4.3/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.1
+Name: sscws
+Version: 2.4.3
+Summary: NASA's Satellite Situation Center Web Service Client Library
+Home-page: https://sscweb.gsfc.nasa.gov/WebServices/REST
+Author: Bernie Harris
+Author-email: NASA-SPDF-Support@nasa.onmicrosoft.com
+License: NOSA
+Description: 
+        ## 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/)
+        and can return data for any of 
+        [these spacecraft](https://sscweb.gsfc.nasa.gov/scansat.shtml).
+        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).
+        
+Keywords: heliophysics,satellites,trajectories,orbits,location,conjunctions,earth magnetic field,ephemeris,space physics,spdf,ssc
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: NASA Open Source Agreement v1.3 (NASA-1.3)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Description-Content-Type: text/markdown
+Provides-Extra: plot
+Provides-Extra: cdf

{sscws-2.4.2 → sscws-2.4.3}/README.md

@@ -6,7 +6,9 @@ NASA's [Satellite Situation Center](https://sscweb.gsfc.nasa.gov/)
 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/).
+[SSC RESTful web services](https://sscweb.gsfc.nasa.gov/WebServices/REST/)
+and can return data for any of 
+[these spacecraft](https://sscweb.gsfc.nasa.gov/scansat.shtml).
 For more general details about the SSC web services, see
 https://sscweb.gsfc.nasa.gov/WebServices/REST/.
 

{sscws-2.4.2 → sscws-2.4.3}/setup.py

@@ -10,7 +10,7 @@ README = (HERE / "README.md").read_text()
 # This call to setup() does all the work
 setup(
     name="sscws",
-    version="2.4.2",
+    version="2.4.3",
     description="NASA's Satellite Situation Center Web Service Client Library",
     long_description=README,
     long_description_content_type="text/markdown",

{sscws-2.4.2 → sscws-2.4.3}/sscws/__init__.py

@@ -24,7 +24,7 @@
 #
 # NOSA HEADER END
 #
-# Copyright (c) 2020-2024 United States Government as represented by
+# Copyright (c) 2020-2025 United States Government as represented by
 # the National Aeronautics and Space Administration. No copyright is
 # claimed in the United States under Title 17, U.S.Code. All Other
 # Rights Reserved.
@@ -34,7 +34,7 @@
 Package for accessing the NASA's Satellite Situation Center (SSC) web
 services https://sscweb.gsfc.nasa.gov/WebServices/REST/.
 
-Copyright © 2020-2024 United States Government as represented by the
+Copyright © 2020-2025 United States Government as represented by the
 National Aeronautics and Space Administration. No copyright is claimed in
 the United States under Title 17, U.S.Code. All Other Rights Reserved.
 
@@ -55,7 +55,7 @@ Notes
 """
 
 
-__version__ = "2.4.2"
+__version__ = "2.4.3"
 
 
 #

{sscws-2.4.2 → sscws-2.4.3}/sscws/cdf.py

@@ -24,7 +24,7 @@
 #
 # NOSA HEADER END
 #
-# Copyright (c) 2023-2024 United States Government as represented by
+# Copyright (c) 2023-2025 United States Government as represented by
 # the National Aeronautics and Space Administration. No copyright is
 # claimed in the United States under Title 17, U.S.Code. All Other
 # Rights Reserved.
@@ -38,7 +38,7 @@ Center (SSC) <https://sscweb.gsfc.nasa.gov>.  This module is specialized
 for SSC CDF files.  It should not be used for more general CDF files.
 <br>
 
-Copyright &copy; 2023-2024 United States Government as represented by the
+Copyright &copy; 2023-2025 United States Government as represented by the
 National Aeronautics and Space Administration. No copyright is claimed in
 the United States under Title 17, U.S.Code. All Other Rights Reserved.
 """
@@ -473,10 +473,13 @@ class Cdf:
             Spacecraft region information.
         """
 
-        region_codes = self.get_value('SPACECRAFT_REGIONS')
-
         regions = []
 
+        try:
+            region_codes = self.get_value('SPACECRAFT_REGIONS')
+        except ValueError:
+            return regions
+
         for region_code in region_codes:
             regions.append(SpaceRegion.from_code(region_code))
 
@@ -496,10 +499,13 @@ class Cdf:
             Trace footpoint region information.
         """
 
-        region_codes = self.get_value(name + 'TRACED_REGIONS')
-
         regions = []
 
+        try:
+            region_codes = self.get_value(name + 'TRACED_REGIONS')
+        except ValueError:
+            return regions
+
         for region_code in region_codes:
             regions.append(FootpointRegion.from_code(region_code))
 
@@ -537,29 +543,47 @@ class Cdf:
         Dict
             The SatelliteData from this CDF.
         """
+        var_names = self.get_variable_names()
         data = {}
         data['Id'] = self.get_satellite_name().lower()
         data['Coordinates'] = self.get_coordinate_data()
         data['Time'] = self.get_time()
-        data['BTraceData'] = self.get_b_trace_data()
-
-        data['RadialLength'] = self.get_value('RADIUS')
-        data['MagneticStrength'] = self.get_value('MAG_STRTH')
-        data['NeutralSheetDistance'] = self.get_value('DNEUTS')
-
-        data['BowShockDistance'] = self.get_value('BOW_SHOCK')
-        data['MagnetoPauseDistance'] = self.get_value('MAG_PAUSE')
-        data['DipoleLValue'] = self.get_value('L_VALUE')
-        data['DipoleInvariantLatitude'] = self.get_value('INVAR_LAT')
-        data['SpacecraftRegion'] = self.get_spacecraft_region()
-        data['RadialTracedFootpointRegions'] = \
-            self.get_footpoint_regions('RADIAL_')
-        data['BGseX'] = self.get_b_gse_component('X')
-        data['BGseY'] = self.get_b_gse_component('Y')
-        data['BGseZ'] = self.get_b_gse_component('Z')
-        data['NorthBTracedFootpointRegions'] = \
-            self.get_footpoint_regions('NORTH_B')
-        data['SouthBTracedFootpointRegions'] = \
-            self.get_footpoint_regions('SOUTH_B')
+        b_trace_data = self.get_b_trace_data()
+        if len(b_trace_data) > 0:
+            data['BTraceData'] = b_trace_data
+
+        if 'RADIUS' in var_names:
+            data['RadialLength'] = self.get_value('RADIUS')
+        if 'MAG_STRTH' in var_names:
+            data['MagneticStrength'] = self.get_value('MAG_STRTH')
+        if 'DNEUTS' in var_names:
+            data['NeutralSheetDistance'] = self.get_value('DNEUTS')
+
+        if 'BOW_SHOCK' in var_names:
+            data['BowShockDistance'] = self.get_value('BOW_SHOCK')
+        if 'MAG_PAUSE' in var_names:
+            data['MagnetoPauseDistance'] = self.get_value('MAG_PAUSE')
+        if 'L_VALUE' in var_names:
+            data['DipoleLValue'] = self.get_value('L_VALUE')
+        if 'INVAR_LAT' in var_names:
+            data['DipoleInvariantLatitude'] = self.get_value('INVAR_LAT')
+        sc_region = self.get_spacecraft_region()
+        if len(sc_region) > 0:
+            data['SpacecraftRegion'] = sc_region
+        if 'RADIAL_TRACED_REGIONS' in var_names:
+            data['RadialTracedFootpointRegions'] = \
+                self.get_footpoint_regions('RADIAL_')
+        if 'MAG_X' in var_names:
+            data['BGseX'] = self.get_b_gse_component('X')
+        if 'MAG_Y' in var_names:
+            data['BGseY'] = self.get_b_gse_component('Y')
+        if 'MAG_Z' in var_names:
+            data['BGseZ'] = self.get_b_gse_component('Z')
+        if 'NORTH_B_TRACED_REGIONS' in var_names:
+            data['NorthBTracedFootpointRegions'] = \
+                self.get_footpoint_regions('NORTH_B')
+        if 'SOUTH_B_TRACED_REGIONS' in var_names:
+            data['SouthBTracedFootpointRegions'] = \
+                self.get_footpoint_regions('SOUTH_B')
 
         return data

sscws-2.4.3/sscws.egg-info/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.1
+Name: sscws
+Version: 2.4.3
+Summary: NASA's Satellite Situation Center Web Service Client Library
+Home-page: https://sscweb.gsfc.nasa.gov/WebServices/REST
+Author: Bernie Harris
+Author-email: NASA-SPDF-Support@nasa.onmicrosoft.com
+License: NOSA
+Description: 
+        ## 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/)
+        and can return data for any of 
+        [these spacecraft](https://sscweb.gsfc.nasa.gov/scansat.shtml).
+        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).
+        
+Keywords: heliophysics,satellites,trajectories,orbits,location,conjunctions,earth magnetic field,ephemeris,space physics,spdf,ssc
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: NASA Open Source Agreement v1.3 (NASA-1.3)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Description-Content-Type: text/markdown
+Provides-Extra: plot
+Provides-Extra: cdf

sscws-2.4.2/PKG-INFO

@@ -1,119 +0,0 @@
-Metadata-Version: 2.1
-Name: sscws
-Version: 2.4.2
-Summary: NASA's Satellite Situation Center Web Service Client Library
-Home-page: https://sscweb.gsfc.nasa.gov/WebServices/REST
-Author: Bernie Harris
-Author-email: NASA-SPDF-Support@nasa.onmicrosoft.com
-License: NOSA
-Keywords: heliophysics,satellites,trajectories,orbits,location,conjunctions,earth magnetic field,ephemeris,space physics,spdf,ssc
-Platform: UNKNOWN
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Environment :: Console
-Classifier: Environment :: Web Environment
-Classifier: Intended Audience :: End Users/Desktop
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: System Administrators
-Classifier: License :: OSI Approved :: NASA Open Source Agreement v1.3 (NASA-1.3)
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Topic :: Scientific/Engineering :: Physics
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Description-Content-Type: text/markdown
-Provides-Extra: plot
-Provides-Extra: cdf
-License-File: LICENSE
-
-
-## 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).
-
-

sscws-2.4.2/sscws.egg-info/PKG-INFO

@@ -1,119 +0,0 @@
-Metadata-Version: 2.1
-Name: sscws
-Version: 2.4.2
-Summary: NASA's Satellite Situation Center Web Service Client Library
-Home-page: https://sscweb.gsfc.nasa.gov/WebServices/REST
-Author: Bernie Harris
-Author-email: NASA-SPDF-Support@nasa.onmicrosoft.com
-License: NOSA
-Keywords: heliophysics,satellites,trajectories,orbits,location,conjunctions,earth magnetic field,ephemeris,space physics,spdf,ssc
-Platform: UNKNOWN
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Environment :: Console
-Classifier: Environment :: Web Environment
-Classifier: Intended Audience :: End Users/Desktop
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: System Administrators
-Classifier: License :: OSI Approved :: NASA Open Source Agreement v1.3 (NASA-1.3)
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Topic :: Scientific/Engineering :: Physics
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Description-Content-Type: text/markdown
-Provides-Extra: plot
-Provides-Extra: cdf
-License-File: LICENSE
-
-
-## 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).
-
-