ostk.astrodynamics.estimator.TLESolver¶

class TLESolver( self: ostk.astrodynamics.estimator.TLESolver, solver: ostk.astrodynamics.solver.LeastSquaresSolver = LeastSquaresSolver.default(), satellite_number: ostk.core.type.Integer = 0, international_designator: ostk.core.type.String = '00001A', revolution_number: ostk.core.type.Integer = 0, estimate_b_star: bool = True, estimation_frame: ostk.physics.coordinate.Frame = Frame.GCRF(), )¶

Bases: pybind11_object

Solver for estimating TLE elements.

Construct a new TLESolver object.

Parameters:

solver (LeastSquaresSolver, optional) -- The solver to use. Defaults to LeastSquaresSolver.default().
satellite_number (int, optional) -- Satellite number for TLE. Defaults to 0.
international_designator (str, optional) -- International designator for TLE. Defaults to "00001A".
revolution_number (int, optional) -- Revolution number. Defaults to 0.
estimate_b_star (bool, optional) -- Whether to also estimate the B* parameter. Defaults to True.
estimation_frame (Frame, optional) -- Frame for estimation. Defaults to GCRF.

Methods

`access_default_b_star`	Access the default B* value.
`access_element_set_number`	Access the element set number.
`access_ephemeris_type`	Access the ephemeris type.
`access_estimate_b_star`	Access whether to estimate B*.
`access_first_derivative_mean_motion_divided_by_2`	Access the first derivative of mean motion divided by 2.
`access_international_designator`	Access the international designator.
`access_revolution_number`	Access the revolution number.
`access_satellite_number`	Access the satellite number.
`access_second_derivative_mean_motion_divided_by_6`	Access the second derivative of mean motion divided by 6.
`access_solver`	Access the solver.
`access_tle_state_builder`	Access the TLE state builder.
`estimate`	Estimate TLE from observations.
`estimate_orbit`	Estimate an SGP4-based orbit from observations.

class Analysis( self: ostk.astrodynamics.estimator.TLESolver.Analysis, estimated_tle: ostk.astrodynamics.trajectory.orbit.model.sgp4.TLE, solver_analysis: ostk.astrodynamics.solver.LeastSquaresSolver.Analysis, )¶

Bases: pybind11_object

Analysis results from the TLE estimation solver.

Construct a new TLESolver::Analysis object.

Parameters:

estimated_tle (TLE) -- The estimated TLE.
solver_analysis (LeastSquaresSolver.Analysis) -- The solver analysis.

property estimated_tle¶

The estimated TLE.

Type:: TLE

property solver_analysis¶

The solver analysis.

Type:: LeastSquaresSolver.Analysis

access_default_b_star( self: ostk.astrodynamics.estimator.TLESolver, ) → ostk.core.type.Real¶

Access the default B* value.

Returns:: The default B* value.
Return type:: float

access_element_set_number( self: ostk.astrodynamics.estimator.TLESolver, ) → ostk.core.type.Integer¶

Access the element set number.

Returns:: The element set number.
Return type:: int

access_ephemeris_type( self: ostk.astrodynamics.estimator.TLESolver, ) → ostk.core.type.Integer¶

Access the ephemeris type.

Returns:: The ephemeris type.
Return type:: int

access_estimate_b_star(self: ostk.astrodynamics.estimator.TLESolver) → bool¶

Access whether to estimate B*.

Returns:: whether to estimate B*.
Return type:: bool

access_first_derivative_mean_motion_divided_by_2( self: ostk.astrodynamics.estimator.TLESolver, ) → ostk.core.type.Real¶

Access the first derivative of mean motion divided by 2.

Returns:: The first derivative of mean motion divided by 2.
Return type:: float

access_international_designator( self: ostk.astrodynamics.estimator.TLESolver, ) → ostk.core.type.String¶

Access the international designator.

Returns:: The international designator.
Return type:: str

access_revolution_number( self: ostk.astrodynamics.estimator.TLESolver, ) → ostk.core.type.Integer¶

Access the revolution number.

Returns:: The revolution number.
Return type:: int

access_satellite_number( self: ostk.astrodynamics.estimator.TLESolver, ) → ostk.core.type.Integer¶

Access the satellite number.

Returns:: The satellite number.
Return type:: int

access_second_derivative_mean_motion_divided_by_6( self: ostk.astrodynamics.estimator.TLESolver, ) → ostk.core.type.Real¶

Access the second derivative of mean motion divided by 6.

Returns:: The second derivative of mean motion divided by 6.
Return type:: float

access_solver( self: ostk.astrodynamics.estimator.TLESolver, ) → ostk.astrodynamics.solver.LeastSquaresSolver¶

Access the solver.

Returns:: The Least Squares solver.
Return type:: LeastSquaresSolver

access_tle_state_builder( self: ostk.astrodynamics.estimator.TLESolver, ) → ostk.astrodynamics.trajectory.StateBuilder¶

Access the TLE state builder.

Returns:: The TLE state builder.
Return type:: StateBuilder

estimate( self: ostk.astrodynamics.estimator.TLESolver, initial_guess: object, observations: list[ostk.astrodynamics.trajectory.State], initial_guess_sigmas: dict[ostk.astrodynamics.trajectory.state.CoordinateSubset, numpy.ndarray[numpy.float64[m, 1]]] = {}, observation_sigmas: dict[ostk.astrodynamics.trajectory.state.CoordinateSubset, numpy.ndarray[numpy.float64[m, 1]]] = {}, ) → ostk.astrodynamics.estimator.TLESolver.Analysis¶

Estimate TLE from observations.

Parameters:

initial_guess (TLE | tuple[State, float] | State) -- Initial guess - can be a TLE, (cartesian State, B*) tuple, or cartesian State.
observations (list[State]) -- State observations to fit against.
initial_guess_sigmas (dict[CoordinateSubset, ndarray], optional) -- Initial guess sigmas.
observation_sigmas (dict[CoordinateSubset, ndarray], optional) -- Observation sigmas.

Returns:

Analysis results containing the estimated TLE and solver analysis.

Return type:

TLESolver.Analysis

estimate_orbit( self: ostk.astrodynamics.estimator.TLESolver, initial_guess: object, observations: list[ostk.astrodynamics.trajectory.State], initial_guess_sigmas: dict[ostk.astrodynamics.trajectory.state.CoordinateSubset, numpy.ndarray[numpy.float64[m, 1]]] = {}, observation_sigmas: dict[ostk.astrodynamics.trajectory.state.CoordinateSubset, numpy.ndarray[numpy.float64[m, 1]]] = {}, ) → ostk.astrodynamics.trajectory.Orbit¶

Estimate an SGP4-based orbit from observations.

Parameters:

initial_guess (TLE | tuple[State, float] | State) -- Initial guess - can be a TLE, (cartesian State, B*) tuple, or cartesian State.
observations (list[State]) -- State observations to fit against.
initial_guess_sigmas (dict[CoordinateSubset, ndarray], optional) -- Initial guess sigmas.
observation_sigmas (dict[CoordinateSubset, ndarray], optional) -- Observation sigmas.

Returns:

The estimated SGP4 orbit.

Return type:

Orbit