org.orekit.propagation.conversion

Class TLEPropagatorBuilder

java.lang.Object

org.orekit.propagation.conversion.AbstractPropagatorBuilder

org.orekit.propagation.conversion.TLEPropagatorBuilder

All Implemented Interfaces:

OrbitDeterminationPropagatorBuilder, PropagatorBuilder

public class TLEPropagatorBuilder
extends AbstractPropagatorBuilder
implements OrbitDeterminationPropagatorBuilder

Builder for TLEPropagator.

Since:

6.0

Author:

Pascal Parraud, Thomas Paulet

Constructor Summary

Constructors

Constructor and Description
TLEPropagatorBuilder(TLE templateTLE, PositionAngle positionAngle, double positionScale) Build a new instance.
TLEPropagatorBuilder(TLE templateTLE, PositionAngle positionAngle, double positionScale, DataContext dataContext) Build a new instance.
TLEPropagatorBuilder(TLE templateTLE, PositionAngle positionAngle, double positionScale, DataContext dataContext, double epsilon, int maxIterations) Build a new instance.
TLEPropagatorBuilder(TLE templateTLE, PositionAngle positionAngle, double positionScale, double epsilon, int maxIterations) Build a new instance.

Method Summary

Modifier and Type	Method and Description
AbstractKalmanModel	buildKalmanModel(List<OrbitDeterminationPropagatorBuilder> propagatorBuilders, List<CovarianceMatrixProvider> covarianceMatricesProviders, ParameterDriversList estimatedMeasurementsParameters, CovarianceMatrixProvider measurementProcessNoiseMatrix) Build a new Kalman model.
AbstractBatchLSModel	buildLSModel(OrbitDeterminationPropagatorBuilder[] builders, List<ObservedMeasurement<?>> measurements, ParameterDriversList estimatedMeasurementsParameters, ModelObserver observer) Build a new batch least squares model.
TLEPropagator	buildPropagator(double[] normalizedParameters) Build a propagator.
TLE	getTemplateTLE() Getter for the template TLE.

Methods inherited from class org.orekit.propagation.conversion.AbstractPropagatorBuilder

addAdditionalDerivativesProvider, addAdditionalEquations, addSupportedParameter, createInitialOrbit, deselectDynamicParameters, getAdditionalDerivativesProviders, getAdditionalEquations, getAttitudeProvider, getFrame, getInitialOrbitDate, getMu, getOrbitalParametersDrivers, getOrbitType, getPositionAngle, getPositionScale, getPropagationParametersDrivers, getSelectedNormalizedParameters, resetOrbit, setAttitudeProvider, setParameters

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.orekit.propagation.conversion.OrbitDeterminationPropagatorBuilder

resetOrbit

Methods inherited from interface org.orekit.propagation.conversion.PropagatorBuilder

getFrame, getInitialOrbitDate, getOrbitalParametersDrivers, getOrbitType, getPositionAngle, getPropagationParametersDrivers, getSelectedNormalizedParameters

Constructor Detail

TLEPropagatorBuilder

@DefaultDataContext
public TLEPropagatorBuilder(TLE templateTLE,
                                                PositionAngle positionAngle,
                                                double positionScale)

Build a new instance. This constructor uses the default data context.

The template TLE is used as a model to create initial orbit. It defines the inertial frame, the central attraction coefficient, orbit type, satellite number, classification, .... and is also used together with the positionScale to convert from the normalized parameters used by the callers of this builder to the real orbital parameters.

Using this constructor, EPSILON_DEFAULT and MAX_ITERATIONS_DEFAULT are used for spacecraft's state to TLE transformation

Parameters:

templateTLE - reference TLE from which real orbits will be built

positionAngle - position angle type to use

positionScale - scaling factor used for orbital parameters normalization (typically set to the expected standard deviation of the position)

Since:

7.1

See Also:

TLEPropagatorBuilder(TLE, PositionAngle, double, DataContext)

TLEPropagatorBuilder

public TLEPropagatorBuilder(TLE templateTLE,
                            PositionAngle positionAngle,
                            double positionScale,
                            DataContext dataContext)

Build a new instance.

The template TLE is used as a model to create initial orbit. It defines the inertial frame, the central attraction coefficient, orbit type, satellite number, classification, .... and is also used together with the positionScale to convert from the normalized parameters used by the callers of this builder to the real orbital parameters.

Using this constructor, EPSILON_DEFAULT and MAX_ITERATIONS_DEFAULT are used for spacecraft's state to TLE transformation

Parameters:

templateTLE - reference TLE from which real orbits will be built

positionAngle - position angle type to use

positionScale - scaling factor used for orbital parameters normalization (typically set to the expected standard deviation of the position)

dataContext - used to access frames and time scales.

Since:

10.1

See Also:

TLEPropagatorBuilder(TLE, PositionAngle, double, DataContext, double, int)

TLEPropagatorBuilder

@DefaultDataContext
public TLEPropagatorBuilder(TLE templateTLE,
                                                PositionAngle positionAngle,
                                                double positionScale,
                                                double epsilon,
                                                int maxIterations)

Build a new instance. This constructor uses the default data context.

The template TLE is used as a model to create initial orbit. It defines the inertial frame, the central attraction coefficient, orbit type, satellite number, classification, .... and is also used together with the positionScale to convert from the normalized parameters used by the callers of this builder to the real orbital parameters.

Parameters:

templateTLE - reference TLE from which real orbits will be built

positionAngle - position angle type to use

positionScale - scaling factor used for orbital parameters normalization (typically set to the expected standard deviation of the position)

epsilon - used to compute threshold for convergence check

maxIterations - maximum number of iterations for convergence

Since:

11.0.2

See Also:

TLEPropagatorBuilder(TLE, PositionAngle, double, DataContext, double, int)

TLEPropagatorBuilder

public TLEPropagatorBuilder(TLE templateTLE,
                            PositionAngle positionAngle,
                            double positionScale,
                            DataContext dataContext,
                            double epsilon,
                            int maxIterations)

Build a new instance.

The template TLE is used as a model to create initial orbit. It defines the inertial frame, the central attraction coefficient, orbit type, satellite number, classification, .... and is also used together with the positionScale to convert from the normalized parameters used by the callers of this builder to the real orbital parameters.

Parameters:

templateTLE - reference TLE from which real orbits will be built

positionAngle - position angle type to use

positionScale - scaling factor used for orbital parameters normalization (typically set to the expected standard deviation of the position)

dataContext - used to access frames and time scales.

epsilon - used to compute threshold for convergence check

maxIterations - maximum number of iterations for convergence

Since:

11.0.2

Method Detail

buildPropagator

public TLEPropagator buildPropagator(double[] normalizedParameters)

Build a propagator.

Specified by:

buildPropagator in interface PropagatorBuilder

Parameters:

normalizedParameters - normalized values for the selected parameters

Returns:

an initialized propagator

getTemplateTLE

public TLE getTemplateTLE()

Getter for the template TLE.

Returns:

the template TLE

buildLSModel

public AbstractBatchLSModel buildLSModel(OrbitDeterminationPropagatorBuilder[] builders,
                                         List<ObservedMeasurement<?>> measurements,
                                         ParameterDriversList estimatedMeasurementsParameters,
                                         ModelObserver observer)

Build a new batch least squares model.

Specified by:

buildLSModel in interface OrbitDeterminationPropagatorBuilder

Parameters:

builders - builders to use for propagation

measurements - measurements

estimatedMeasurementsParameters - estimated measurements parameters

observer - observer to be notified at model calls

Returns:

a new model for the Batch Least Squares orbit determination

buildKalmanModel

public AbstractKalmanModel buildKalmanModel(List<OrbitDeterminationPropagatorBuilder> propagatorBuilders,
                                            List<CovarianceMatrixProvider> covarianceMatricesProviders,
                                            ParameterDriversList estimatedMeasurementsParameters,
                                            CovarianceMatrixProvider measurementProcessNoiseMatrix)

Description copied from interface: OrbitDeterminationPropagatorBuilder

Build a new Kalman model.

Specified by:

buildKalmanModel in interface OrbitDeterminationPropagatorBuilder

Parameters:

propagatorBuilders - propagators builders used to evaluate the orbits.

covarianceMatricesProviders - providers for covariance matrices

estimatedMeasurementsParameters - measurement parameters to estimate

measurementProcessNoiseMatrix - provider for measurement process noise matrix

Returns:

a new model for Kalman Filter orbit determination