Propagation

Create Propagation

Changed on

Submit propagation parameters to Kayhan's system and create propagation job.<br/> Define: Propagation Duration, and Time Step.

post/propagations

Request

  • Base URL: https://api.satcat.com/api/satcat
  • URL: https://api.satcat.com/api/satcat/propagations
  • Auth: OAuth 2 (client credentials, token URL oauth/token; password, token URL login)

Query parameters

norad_idstring nullable

NORAD ID to associate with propagation.

group_idstring uuid nullable

Optional group ID to use for the request

Request body

start_timestring date-time nullable

OPTIONAL: Propagation Start Time in ISOT Format: (Year-Month-DayTHour:Minute:Seconds). Include if start time is different than state vector epoch.

end_timestring date-time nullable

OPTIONAL: Propagation Target Time in ISOT Format: (Year-Month-DayTHour:Minute:Seconds). NOTE: Must include either target_time or target_duration.

target_durationnumber nullable

OPTIONAL: Propagation Target Duration in Seconds. NOTE: Must include either end_time or target_duration.

timestepnumber nullable

Propagation Time Step between each reported epoch, in seconds.

purposestring nullable

Purpose of propagation (MANUAL or SCREENING)

infer_interval_from_screeningboolean

Whether to allow the time interval of the Propagation to be inferred based on counterpart data assigned to a Screening, if the Propagation is assigned to a Screening. If unsure, leave this enabled.

enable_discontinuitiesboolean

Whether maneuver discontinuities are included in the propagated ephemeris. This is only relevant when exporting to an ephemeris format supporting multiple blocks such as CCSDS OEM/OCM.

Response

Successful Response

idstring uuid required
created_atstring date-time nullable
status'CREATED' | 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILURE' | 'CANCELED' required
ephemeris_idstring uuid nullable
start_timestring date-time nullable
end_timestring date-time nullable
started_atstring date-time nullable
completed_atstring date-time nullable
target_durationnumber nullable
timestepnumber nullable
enable_discontinuitiesboolean
maneuver_countinteger
tle_idstring uuid nullable
state_vector_idstring uuid nullable

Changes

  • afeec2546de3Revision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status