Skip to main content

Satcat SDK

The Satcat SDK is a Python client library for automating interactions with Satcat's spaceflight safety services. It allows users to fetch conjunction event data, upload and manage ephemerides, trigger catalog screenings, and manage operational state without using the web interface.

It is suitable for operators integrating Satcat functionality into flight dynamics systems or building custom SSA automation pipelines.

View Full SDK Reference Docs

Key Capabilities​

  • Fetch and filter conjunction events
  • Upload and manage ephemerides
  • Trigger catalog screenings and retrieve results
  • Manage ephemeris operational state
  • Initiate and retrieve propagation jobs
  • Access screening output from propagated or uploaded orbits

Satcat CLI​

The SDK includes satcat, a command-line interface (CLI) for power users. It supports common operations such as fetching CDMs, uploading ephemeris files, and initiating screenings directly from the terminal.

Use the CLI for rapid tasking or scripting without writing Python. See Satcat CLI for the command surface.

Installation​

The SDK is distributed on PyPI and can be installed with:

pip install satcat

Authentication and connection settings are covered in Configuration. Query syntax is covered in Filters and Sorting, and runnable starting points in Sample Projects.

API Keys​

API keys allow users to authenticate securely with Satcat Operations. Once generated, they can be used with the Satcat SDK or CLI for actions such as:

  • Uploading ephemeris
  • Launching screening jobs
  • Triggering maneuver generation
  • Accessing CDMs and analytics products

Keys are created and managed in Account, where the name, Client ID, and rotation and deletion actions live.

Resources and File Types​

  • Events: Access and filter conjunction events linked to your RSOs
  • Ephemerides: Upload, download, and designate ephemeris files as OPERATIONAL
  • Screenings: Run catalog screenings using uploaded or propagated ephemerides
  • Propagations: Submit OPMs for forward propagation and analysis

Supported file types:

  • CCSDS Orbit Parameter Messages (OPM)
  • CCSDS Orbit Ephemeris Messages (OEM)
  • Conjunction Data Messages (CDM)

Source and License​

The Satcat SDK is open source under the Apache 2.0 license.