Data Management#

Ephemeris Data#

The Satcat SDK exposes ephemeris management operations on the client. Most common calls are documented below as short examples.

Ephemeris Management Methods#
`create_ephemeris`	Upload an ephemeris file to your organization. Returns an `Ephemeris` model.
`get_ephemeris`	Retrieve metadata for a specific ephemeris by its `id`.
`download_ephemeris`	Download the serialized ephemeris file contents (e.g. `OEM` or `NASA`). Returns a file-like object in text mode.
`list_ephemerides`	List ephemerides you have access to; supports filters, sorting and pagination.
`list_ephemeris_formats`	List supported ephemeris file formats accepted by the API.
`operationalize_ephemeris`	Mark an uploaded ephemeris as `OPERATIONAL`.

Examples#

Upload an ephemeris file#

# Upload a local ephemeris file (provide a path or an open binary file-like)
ephemeris = client.create_ephemeris(
        "/path/to/ephemeris.oem",
        file_format="automatic",
        norad_id=25544,  # Required, RSO must be owned by your organization to succeed
        designation='OPERATIONAL',
        context='ROUTINE',
)

List ephemerides available to the authenticated user#

ephem_list = client.list_ephemerides(filters=[{"field": "norad_id", "value": 25544}])

Download the ephemeris contents in a given format#

# download as OEM (returns a text-mode file-like object)
content = client.download_ephemeris(ephemeris.id, file_format="oem")
with open("downloaded_ephemeris.oem", "w") as f:
    f.write(content.read())

Get ephemeris metadata by id#

ephem = client.get_ephemeris(ephemeris.id)

Designate an ephemeris as OPERATIONAL#

ephemeris = client.operationalize_ephemeris(ephemeris.id)

Notes#

When passing an open file-like object to create_ephemeris, open it in binary mode.