heyoka.model.sgp4_propagator

heyoka.model.sgp4_propagator#

heyoka.model.sgp4_propagator(sat_list: list, diff_order: int = 0, **kwargs)#

Construct an SGP4 propagator.

Added in version 5.1.0.

Note

A tutorial explaining the use of this function is available.

This function will construct an SGP4 propagator from the input arguments.

The only mandatory argument is sat_list, which must be a list of TLEs represented as Satrec objects from the sgp4 Python module.

The diff_order argument indicates the desired differentiation order. If equal to 0, then derivatives are disabled.

The fp_type keyword argument can be passed in kwargs to select the precision of the propagator (double-precision is the default, single-precision is also supported).

kwargs can also optionally contain keyword arguments from the LLVM kwargs set and the cfunc kwargs set.

Parameters:
  • sat_list – the list of TLEs.

  • diff_order – the derivatives order.

Raises:

TypeError – if an unsupported fp_type is specified.

Raises:

any exception raised by the construction of the propagator.

Returns:

an SGP4 propagator object.

Return type:

sgp4_propagator_dbl | sgp4_propagator_flt