org.orekit.propagation.conversion

Class DSSTPropagatorBuilder

java.lang.Object

org.orekit.propagation.conversion.AbstractPropagatorBuilder

org.orekit.propagation.conversion.DSSTPropagatorBuilder

All Implemented Interfaces:

OrbitDeterminationPropagatorBuilder, PropagatorBuilder

public class DSSTPropagatorBuilder
extends AbstractPropagatorBuilder
implements OrbitDeterminationPropagatorBuilder

Builder for DSST propagator.

Since:

10.0

Author:

Bryan Cazabonne

Constructor Summary

Constructors

Constructor and Description
DSSTPropagatorBuilder(Orbit referenceOrbit, ODEIntegratorBuilder builder, double positionScale, PropagationType propagationType, PropagationType stateType) Build a new instance.
DSSTPropagatorBuilder(Orbit referenceOrbit, ODEIntegratorBuilder builder, double positionScale, PropagationType propagationType, PropagationType stateType, AttitudeProvider attitudeProvider) Build a new instance.

Method Summary

Modifier and Type	Method and Description
void	addForceModel(DSSTForceModel model) Add a force model to the global perturbation model.
AbstractKalmanModel	buildKalmanModel(List<OrbitDeterminationPropagatorBuilder> propagatorBuilders, List<CovarianceMatrixProvider> covarianceMatricesProviders, ParameterDriversList estimatedMeasurementsParameters, CovarianceMatrixProvider measurementProcessNoiseMatrix) Build a new Kalman model.
DSSTBatchLSModel	buildLSModel(OrbitDeterminationPropagatorBuilder[] builders, List<ObservedMeasurement<?>> measurements, ParameterDriversList estimatedMeasurementsParameters, ModelObserver observer) Build a new batch least squares model.
DSSTPropagator	buildPropagator(double[] normalizedParameters) Build a propagator.
DSSTPropagatorBuilder	copy() Create a copy of a DSSTPropagatorBuilder object.
List<DSSTForceModel>	getAllForceModels() Get the list of all force models.
ODEIntegratorBuilder	getIntegratorBuilder() Get the integrator builder.
double	getMass() Get the mass.
PropagationType	getPropagationType() Get the type of the orbit used for the propagation (mean or osculating).
PropagationType	getStateType() Get the type of the elements used to define the orbital state (mean or osculating).
void	resetOrbit(Orbit newOrbit, PropagationType orbitType) Reset the orbit in the propagator builder.
void	setMass(double mass) Set the initial mass.

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

DSSTPropagatorBuilder

public DSSTPropagatorBuilder(Orbit referenceOrbit,
                             ODEIntegratorBuilder builder,
                             double positionScale,
                             PropagationType propagationType,
                             PropagationType stateType)

Build a new instance.

The reference orbit is used as a model to create initial orbit. It defines the inertial frame, the central attraction coefficient, 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:

referenceOrbit - reference orbit from which real orbits will be built

builder - first order integrator builder

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

propagationType - type of the orbit used for the propagation (mean or osculating)

stateType - type of the elements used to define the orbital state (mean or osculating)

See Also:

DSSTPropagatorBuilder(Orbit, ODEIntegratorBuilder, double, PropagationType, PropagationType, AttitudeProvider)

DSSTPropagatorBuilder

public DSSTPropagatorBuilder(Orbit referenceOrbit,
                             ODEIntegratorBuilder builder,
                             double positionScale,
                             PropagationType propagationType,
                             PropagationType stateType,
                             AttitudeProvider attitudeProvider)

Build a new instance.

The reference orbit is used as a model to create initial orbit. It defines the inertial frame, the central attraction coefficient, 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:

referenceOrbit - reference orbit from which real orbits will be built

builder - first order integrator builder

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

propagationType - type of the orbit used for the propagation (mean or osculating)

stateType - type of the elements used to define the orbital state (mean or osculating)

attitudeProvider - attitude law.

Since:

10.1

Method Detail

getPropagationType

public PropagationType getPropagationType()

Get the type of the orbit used for the propagation (mean or osculating).

Returns:

the type of the orbit used for the propagation

getStateType

public PropagationType getStateType()

Get the type of the elements used to define the orbital state (mean or osculating).

Returns:

the type of the elements used to define the orbital state

copy

public DSSTPropagatorBuilder copy()

Create a copy of a DSSTPropagatorBuilder object.

Returns:

Copied version of the DSSTPropagatorBuilder

getIntegratorBuilder

public ODEIntegratorBuilder getIntegratorBuilder()

Get the integrator builder.

Returns:

the integrator builder

getAllForceModels

public List<DSSTForceModel> getAllForceModels()

Get the list of all force models.

Returns:

the list of all force models

getMass

public double getMass()

Get the mass.

Returns:

the mass

setMass

public void setMass(double mass)

Set the initial mass.

Parameters:

mass - the mass (kg)

addForceModel

public void addForceModel(DSSTForceModel model)

Add a force model to the global perturbation model.

If this method is not called at all, the integrated orbit will follow a Keplerian evolution only.

Parameters:

model - perturbing DSSTForceModel to add

resetOrbit

public void resetOrbit(Orbit newOrbit,
                       PropagationType orbitType)

Reset the orbit in the propagator builder.

Parameters:

newOrbit - newOrbit New orbit to set in the propagator builder

orbitType - orbit type (MEAN or OSCULATING)

buildPropagator

public DSSTPropagator buildPropagator(double[] normalizedParameters)

Build a propagator.

Specified by:

buildPropagator in interface PropagatorBuilder

Parameters:

normalizedParameters - normalized values for the selected parameters

Returns:

an initialized propagator

buildLSModel

public DSSTBatchLSModel 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)

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