sscws Conjunction Example Jupyter Notebook

This Jupyter notebook demonstrates using the sscws Python package to find radial traced satellite conjunctions with a ground location. This notebook contains the following sections:

1. Prerequisites
2. Setup
3. Define Conjunction Query
4. Run Conjunction Query
5. Display the results
6. Additional Documentation

Prerequisites

Install the prerequisite software from the Python Package Index if it is not already installed.

#%pip install sscws

Setup

Execute some preliminary code that is necessary before the code that follows.

import numpy as np
from sscws.sscws import SscWs
from sscws.conjunctions import BoxConjunctionArea, ConditionOperator,\
    GroundStationCondition, GroundStationConjunction,\
    Satellite, SatelliteCondition, TraceCoordinateSystem
from sscws.coordinates import CoordinateComponent, CoordinateSystem,\
    SurfaceGeographicCoordinates
from sscws.request import DataRequest, QueryRequest, SatelliteSpecification
from sscws.timeinterval import TimeInterval
from sscws.tracing import BFieldTraceDirection, TraceType
ssc = SscWs()

Define Conjunction Query

The following code defines a query to find radial traced conjuctions of a satellite and a ground location.

sats = [
    Satellite('iss')
]
satellite_condition = SatelliteCondition(sats, 1)

box_conjunction_area = BoxConjunctionArea(TraceCoordinateSystem.GEO,
                                          3.00, 10.00)

ground_stations = [
    GroundStationConjunction('GSFC', 'GSFC',\
        SurfaceGeographicCoordinates(39.99, -76.84),\
        box_conjunction_area)
]
ground_station_condition = \
    GroundStationCondition(ground_stations,
                            TraceCoordinateSystem.GEO,
                            TraceType.RADIAL)
conditions = [
    satellite_condition,
    ground_station_condition
]
query_request = \
    QueryRequest('ISS radial trace conjunction with ground location.',
                 TimeInterval('2018-07-12T00:00:00Z',
                              '2018-07-15T23:59:59Z'),
                 ConditionOperator.ALL,
                 conditions)

Run Conjunction Query

The following code submits the conjunction query defined above to SSC for evaluation.

result = ssc.get_conjunctions(query_request)

Display the results

The following code displays the results of the query.

SscWs.print_conjunction_result(result)

StatusCode: ResultStatusCode.SUCCESS StatusSubCode: ResultStatusSubCode.SUCCESS
2018-07-12T05:23:00+00:00 to 2018-07-12T05:23:00+00:00
  Satellite      Lat     Lon    Radius Ground Station           Lat     Lon    ArcLen
  iss          39.30  283.52   6777.00 GSFC                   39.30  283.52      0.00
2018-07-12T11:52:00+00:00 to 2018-07-12T11:52:00+00:00
  Satellite      Lat     Lon    Radius Ground Station           Lat     Lon    ArcLen
  iss          39.80  282.96   6780.00 GSFC                   39.80  282.96      0.00
2018-07-15T04:23:00+00:00 to 2018-07-15T04:24:00+00:00
  Satellite      Lat     Lon    Radius Ground Station           Lat     Lon    ArcLen
  iss          39.18  280.64   6778.00 GSFC                   39.18  280.64      0.00
  iss          41.44  284.55   6778.00 GSFC                   41.44  284.55      0.00
2018-07-15T10:52:00+00:00 to 2018-07-15T10:52:00+00:00
  Satellite      Lat     Lon    Radius Ground Station           Lat     Lon    ArcLen
  iss          39.35  281.08   6781.00 GSFC                   39.35  281.08      0.00

Additional Documentation

View the sscws API for additional features. Additional notebook examples are also available.