fr.cnes.sirius.patrius.signalpropagation

Class VacuumSignalPropagationModel

java.lang.Object

fr.cnes.sirius.patrius.signalpropagation.VacuumSignalPropagationModel

public class VacuumSignalPropagationModel
extends Object

Model for the computation of a signal propagation vector and toolbox for the different corrections to be applied to it.

Since:

1.2

Version:

$Id$

Author:

Thomas Trapier

Concurrency comment :

concurrency depends of the PVCoordinatesProvider implementations

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	VacuumSignalPropagationModel.ConvergenceAlgorithm Convergence algorithm to compute the geometric signal propagation duration.
static class	VacuumSignalPropagationModel.FixedDate the fixed date of computation

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_MAX_ITER Default max number of iterations for signal propagation computation.
static double	DEFAULT_THRESHOLD Default threshold (s) for signal propagation computation.

Constructor Summary

Constructors

Constructor and Description
VacuumSignalPropagationModel(Frame frameIn) Constructor of the signal propagation model.
VacuumSignalPropagationModel(Frame frameIn, double thresholdIn) Constructor of the signal propagation model.
VacuumSignalPropagationModel(Frame frameIn, double thresholdIn, int maxIterIn) Constructor of the signal propagation model.
VacuumSignalPropagationModel(Frame frameIn, double thresholdIn, VacuumSignalPropagationModel.ConvergenceAlgorithm convAlgo) Constructor of the signal propagation model.
VacuumSignalPropagationModel(Frame frameIn, double thresholdIn, VacuumSignalPropagationModel.ConvergenceAlgorithm convAlgo, int maxIterIn) Constructor of the signal propagation model.
VacuumSignalPropagationModel(Frame frameIn, VacuumSignalPropagationModel.ConvergenceAlgorithm convAlgo) Constructor of the signal propagation model.

Method Summary

Modifier and Type	Method and Description
VacuumSignalPropagation	computeSignalPropagation(PVCoordinatesProvider emitter, PVCoordinatesProvider receiver, AbsoluteDate date, VacuumSignalPropagationModel.FixedDate fixedDateType) Computes the signal propagation object in the void at a particular date
static AbsoluteDate	getSignalEmissionDate(PVCoordinatesProvider emitter, PVCoordinatesProvider orbit, AbsoluteDate date, double epsilon, AbstractSignalPropagationDetector.PropagationDelayType propagationDelayType, Frame inertialFrame) Compute signal emission date which is the date at which the signal received by the spacecraft (receiver) has been emitted by the emitter depending on AbstractSignalPropagationDetector.PropagationDelayType.
static AbsoluteDate	getSignalEmissionDate(PVCoordinatesProvider emitter, PVCoordinatesProvider orbit, AbsoluteDate date, double epsilon, AbstractSignalPropagationDetector.PropagationDelayType propagationDelayType, Frame inertialFrame, int maxIterSignalPropagation) Compute signal emission date which is the date at which the signal received by the spacecraft (receiver) has been emitted by the emitter depending on AbstractSignalPropagationDetector.PropagationDelayType.
static AbsoluteDate	getSignalReceptionDate(PVCoordinatesProvider receiver, PVCoordinatesProvider orbit, AbsoluteDate date, double epsilon, AbstractSignalPropagationDetector.PropagationDelayType propagationDelayType, Frame inertialFrame) Compute signal reception date which is the date at which the signal emitted by the spacecraft (emitter) has been received by the receiver depending on AbstractSignalPropagationDetector.PropagationDelayType.
static AbsoluteDate	getSignalReceptionDate(PVCoordinatesProvider receiver, PVCoordinatesProvider orbit, AbsoluteDate date, double epsilon, AbstractSignalPropagationDetector.PropagationDelayType propagationDelayType, Frame inertialFrame, int maxIterSignalPropagation) Compute signal reception date which is the date at which the signal emitted by the spacecraft (emitter) has been received by the receiver depending on AbstractSignalPropagationDetector.PropagationDelayType.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MAX_ITER

public static final int DEFAULT_MAX_ITER

Default max number of iterations for signal propagation computation.

See Also:

Constant Field Values

DEFAULT_THRESHOLD

public static final double DEFAULT_THRESHOLD

Default threshold (s) for signal propagation computation.

This value guarantees that the propagation time is computed with a light travel distance precision below 0.3 mm.

See Also:

Constant Field Values

Constructor Detail

VacuumSignalPropagationModel

public VacuumSignalPropagationModel(Frame frameIn)

Constructor of the signal propagation model.

By default, this model will use the NEWTON convergence algorithm.

Parameters:

frameIn - the work frame : must be inertial

Throws:

IllegalArgumentException - if the provided frame is not pseudo-inertial

VacuumSignalPropagationModel

public VacuumSignalPropagationModel(Frame frameIn,
                                    double thresholdIn)

Constructor of the signal propagation model.

By default, this model will use the NEWTON convergence algorithm.

Parameters:

frameIn - the work frame : must be inertial

thresholdIn - the iterative computation algorithm convergence threshold: propagation time precision required

Throws:

IllegalArgumentException - if the provided frame is not pseudo-inertial

VacuumSignalPropagationModel

public VacuumSignalPropagationModel(Frame frameIn,
                                    VacuumSignalPropagationModel.ConvergenceAlgorithm convAlgo)

Constructor of the signal propagation model.

Parameters:

frameIn - the work frame : must be inertial and invariant over time

convAlgo - the convergence algorithm

Throws:

IllegalArgumentException - if the provided frame is not pseudo-inertial

VacuumSignalPropagationModel

public VacuumSignalPropagationModel(Frame frameIn,
                                    double thresholdIn,
                                    int maxIterIn)

Constructor of the signal propagation model.

By default, this model will use the NEWTON convergence algorithm.

Parameters:

frameIn - the work frame : must be inertial

thresholdIn - the iterative computation algorithm convergence threshold: propagation time precision required

maxIterIn - the maximum number of iterations for signal propagation computation

Throws:

IllegalArgumentException - if the provided frame is not pseudo-inertial

VacuumSignalPropagationModel

public VacuumSignalPropagationModel(Frame frameIn,
                                    double thresholdIn,
                                    VacuumSignalPropagationModel.ConvergenceAlgorithm convAlgo)

Constructor of the signal propagation model.

Parameters:

frameIn - the work frame : must be inertial and invariant over time

thresholdIn - the iterative computation algorithm convergence threshold: propagation time precision required

convAlgo - the convergence algorithm

Throws:

IllegalArgumentException - if the provided frame is not pseudo-inertial

VacuumSignalPropagationModel

public VacuumSignalPropagationModel(Frame frameIn,
                                    double thresholdIn,
                                    VacuumSignalPropagationModel.ConvergenceAlgorithm convAlgo,
                                    int maxIterIn)

Constructor of the signal propagation model.

Parameters:

frameIn - the work frame : must be inertial and invariant over time

thresholdIn - the iterative computation algorithm convergence threshold: propagation time precision required

convAlgo - the convergence algorithm

maxIterIn - the maximum number of iterations for signal propagation computation

Throws:

IllegalArgumentException - if the provided frame is not pseudo-inertial

Method Detail

computeSignalPropagation

public final VacuumSignalPropagation computeSignalPropagation(PVCoordinatesProvider emitter,
                                                              PVCoordinatesProvider receiver,
                                                              AbsoluteDate date,
                                                              VacuumSignalPropagationModel.FixedDate fixedDateType)
                                                       throws PatriusException

Computes the signal propagation object in the void at a particular date

Parameters:

emitter - the PVCoordinatesProvider of the emitter object

receiver - the PVCoordinatesProvider of the receiver object

date - the emission or reception date

fixedDateType - type of the previous given date : emission or reception

Returns:

the signal propagation object

Throws:

PatriusException - if a problem occurs during PVCoodinates providers manipulations

getSignalEmissionDate

public static AbsoluteDate getSignalEmissionDate(PVCoordinatesProvider emitter,
                                                 PVCoordinatesProvider orbit,
                                                 AbsoluteDate date,
                                                 double epsilon,
                                                 AbstractSignalPropagationDetector.PropagationDelayType propagationDelayType,
                                                 Frame inertialFrame)
                                          throws PatriusException

Compute signal emission date which is the date at which the signal received by the spacecraft (receiver) has been emitted by the emitter depending on AbstractSignalPropagationDetector.PropagationDelayType.

Parameters:

emitter - emitter

orbit - orbit of the spacecraft (receiver)

date - date at which the spacecraft orbit is defined

epsilon - absolute duration threshold used for convergence of signal propagation computation. The epsilon is a time absolute error (ex: 1E-14s, in this case, the signal distance accuracy is 1E-14s x 3E8m/s = 3E-6m).

propagationDelayType - propagation delay type

inertialFrame - inertial frame

Returns:

signal emission date

Throws:

PatriusException - thrown if computation failed

getSignalEmissionDate

public static AbsoluteDate getSignalEmissionDate(PVCoordinatesProvider emitter,
                                                 PVCoordinatesProvider orbit,
                                                 AbsoluteDate date,
                                                 double epsilon,
                                                 AbstractSignalPropagationDetector.PropagationDelayType propagationDelayType,
                                                 Frame inertialFrame,
                                                 int maxIterSignalPropagation)
                                          throws PatriusException

Compute signal emission date which is the date at which the signal received by the spacecraft (receiver) has been emitted by the emitter depending on AbstractSignalPropagationDetector.PropagationDelayType.

Parameters:

emitter - emitter

orbit - orbit of the spacecraft (receiver)

date - date at which the spacecraft orbit is defined

epsilon - absolute duration threshold used for convergence of signal propagation computation. The epsilon is a time absolute error (ex: 1E-14s, in this case, the signal distance accuracy is 1E-14s x 3E8m/s = 3E-6m).

propagationDelayType - propagation delay type

inertialFrame - inertial frame

maxIterSignalPropagation - maximum number of iterations for signal propagation computation

Returns:

signal emission date

Throws:

PatriusException - thrown if computation failed

getSignalReceptionDate

public static AbsoluteDate getSignalReceptionDate(PVCoordinatesProvider receiver,
                                                  PVCoordinatesProvider orbit,
                                                  AbsoluteDate date,
                                                  double epsilon,
                                                  AbstractSignalPropagationDetector.PropagationDelayType propagationDelayType,
                                                  Frame inertialFrame)
                                           throws PatriusException

Compute signal reception date which is the date at which the signal emitted by the spacecraft (emitter) has been received by the receiver depending on AbstractSignalPropagationDetector.PropagationDelayType.

Parameters:

receiver - receiver

orbit - orbit of the spacecraft (emitter)

date - date at which the spacecraft orbit is defined

epsilon - absolute duration threshold used for convergence of signal propagation computation. The epsilon is a time absolute error (ex: 1E-14s, in this case, the signal distance accuracy is 1E-14s x 3E8m/s = 3E-6m).

propagationDelayType - propagation delay type

inertialFrame - inertial frame

Returns:

signal reception date

Throws:

PatriusException - thrown if computation failed

getSignalReceptionDate

public static AbsoluteDate getSignalReceptionDate(PVCoordinatesProvider receiver,
                                                  PVCoordinatesProvider orbit,
                                                  AbsoluteDate date,
                                                  double epsilon,
                                                  AbstractSignalPropagationDetector.PropagationDelayType propagationDelayType,
                                                  Frame inertialFrame,
                                                  int maxIterSignalPropagation)
                                           throws PatriusException

Compute signal reception date which is the date at which the signal emitted by the spacecraft (emitter) has been received by the receiver depending on AbstractSignalPropagationDetector.PropagationDelayType.

Parameters:

receiver - receiver

orbit - orbit of the spacecraft (emitter)

date - date at which the spacecraft orbit is defined

epsilon - absolute duration threshold used for convergence of signal propagation computation. The epsilon is a time absolute error (ex: 1E-14s, in this case, the signal distance accuracy is 1E-14s x 3E8m/s = 3E-6m).

propagationDelayType - propagation delay type

inertialFrame - inertial frame

maxIterSignalPropagation - maximum number of iterations for signal propagation computation

Returns:

signal reception date

Throws:

PatriusException - thrown if computation failed