org.orekit.propagation.conversion

Class EcksteinHechlerPropagatorBuilder

java.lang.Object

org.orekit.propagation.conversion.AbstractPropagatorBuilder

org.orekit.propagation.conversion.EcksteinHechlerPropagatorBuilder

All Implemented Interfaces:

PropagatorBuilder

public class EcksteinHechlerPropagatorBuilder
extends AbstractPropagatorBuilder

Builder for Eckstein-Hechler propagator.

Since:

6.0

Author:

Pascal Parraud

Constructor Summary

Constructors

Constructor and Description
EcksteinHechlerPropagatorBuilder(Orbit templateOrbit, double referenceRadius, double mu, TideSystem tideSystem, double c20, double c30, double c40, double c50, double c60, OrbitType orbitType, PositionAngle positionAngle, double positionScale) Build a new instance.
EcksteinHechlerPropagatorBuilder(Orbit templateOrbit, UnnormalizedSphericalHarmonicsProvider provider, PositionAngle positionAngle, double positionScale) Build a new instance.

Method Summary

Modifier and Type	Method and Description
Propagator	buildPropagator(double[] normalizedParameters) Build a propagator.

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

addSupportedParameter, createInitialOrbit, getFrame, getInitialOrbitDate, getOrbitalParametersDrivers, getOrbitType, getPositionAngle, getPropagationParametersDrivers, getSelectedNormalizedParameters, setParameters

Methods inherited from class java.lang.Object

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

Constructor Detail

EcksteinHechlerPropagatorBuilder

public EcksteinHechlerPropagatorBuilder(Orbit templateOrbit,
                                        UnnormalizedSphericalHarmonicsProvider provider,
                                        PositionAngle positionAngle,
                                        double positionScale)
                                 throws OrekitException

Build a new instance.

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

templateOrbit - reference orbit from which real orbits will be built (note that the mu from this orbit will be overridden with the mu from the provider)

provider - for un-normalized zonal coefficients

positionAngle - position angle type to use

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

Throws:

OrekitException - if parameters drivers cannot be scaled

Since:

8.0

EcksteinHechlerPropagatorBuilder

public EcksteinHechlerPropagatorBuilder(Orbit templateOrbit,
                                        double referenceRadius,
                                        double mu,
                                        TideSystem tideSystem,
                                        double c20,
                                        double c30,
                                        double c40,
                                        double c50,
                                        double c60,
                                        OrbitType orbitType,
                                        PositionAngle positionAngle,
                                        double positionScale)
                                 throws OrekitException

Build a new instance.

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

templateOrbit - reference orbit from which real orbits will be built (note that the mu from this orbit will be overridden with the mu from the provider)

referenceRadius - reference radius of the Earth for the potential model (m)

mu - central attraction coefficient (m³/s²)

tideSystem - tide system

c20 - un-normalized zonal coefficient (about -1.08e-3 for Earth)

c30 - un-normalized zonal coefficient (about +2.53e-6 for Earth)

c40 - un-normalized zonal coefficient (about +1.62e-6 for Earth)

c50 - un-normalized zonal coefficient (about +2.28e-7 for Earth)

c60 - un-normalized zonal coefficient (about -5.41e-7 for Earth)

orbitType - orbit type to use

positionAngle - position angle type to use

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

Throws:

OrekitException - if parameters drivers cannot be scaled

Since:

8.0

Method Detail

buildPropagator

public Propagator buildPropagator(double[] normalizedParameters)
                           throws OrekitException

Build a propagator.

Parameters:

normalizedParameters - normalized values for the selected parameters

Returns:

an initialized propagator

Throws:

OrekitException - if propagator cannot be build