T
- type of the field elementpublic class FieldElevationExtremumDetector<T extends org.hipparchus.CalculusFieldElement<T>> extends FieldAbstractDetector<FieldElevationExtremumDetector<T>,T>
This detector identifies when a spacecraft reaches its extremum elevation with respect to a ground point.
As in most cases only the elevation maximum is needed and the
minimum is often irrelevant, this detector is often wrapped into
an event slope filter
configured with
FilterType.TRIGGER_ONLY_DECREASING_EVENTS
(i.e. when the
elevation derivative decreases from positive values to negative values,
which correspond to a maximum). Setting up this filter saves some computation
time as the elevation minimum occurrences are not even looked at. It is
however still often necessary to do an additional filtering
DEFAULT_MAX_ITER, DEFAULT_MAXCHECK, DEFAULT_THRESHOLD
Modifier | Constructor and Description |
---|---|
|
FieldElevationExtremumDetector(org.hipparchus.Field<T> field,
TopocentricFrame topo)
Build a new detector.
|
protected |
FieldElevationExtremumDetector(FieldAdaptableInterval<T> maxCheck,
T threshold,
int maxIter,
FieldEventHandler<T> handler,
TopocentricFrame topo)
Protected constructor with full parameters.
|
|
FieldElevationExtremumDetector(T maxCheck,
T threshold,
TopocentricFrame topo)
Build a detector.
|
Modifier and Type | Method and Description |
---|---|
protected FieldElevationExtremumDetector<T> |
create(FieldAdaptableInterval<T> newMaxCheck,
T newThreshold,
int newMaxIter,
FieldEventHandler<T> newHandler)
Build a new instance.
|
T |
g(FieldSpacecraftState<T> s)
Compute the value of the detection function.
|
T |
getElevation(FieldSpacecraftState<T> s)
Get the elevation value.
|
TopocentricFrame |
getTopocentricFrame()
Returns the topocentric frame centered on ground point.
|
getHandler, getMaxCheckInterval, getMaxIterationCount, getThreshold, init, isForward, withHandler, withMaxCheck, withMaxCheck, withMaxIter, withThreshold
public FieldElevationExtremumDetector(org.hipparchus.Field<T> field, TopocentricFrame topo)
The new instance uses default values for maximal checking interval
(FieldAbstractDetector.DEFAULT_MAXCHECK
) and convergence threshold (FieldAbstractDetector.DEFAULT_THRESHOLD
).
field
- field to which elements belongtopo
- topocentric frame centered on ground pointpublic FieldElevationExtremumDetector(T maxCheck, T threshold, TopocentricFrame topo)
maxCheck
- maximal checking interval (s)threshold
- convergence threshold (s)topo
- topocentric frame centered on ground pointprotected FieldElevationExtremumDetector(FieldAdaptableInterval<T> maxCheck, T threshold, int maxIter, FieldEventHandler<T> handler, TopocentricFrame topo)
This constructor is not public as users are expected to use the builder
API with the various withXxx()
methods to set up the instance
in a readable manner without using a huge amount of parameters.
maxCheck
- maximum checking intervalthreshold
- convergence threshold (s)maxIter
- maximum number of iterations in the event time searchhandler
- event handler to call at event occurrencestopo
- topocentric frame centered on ground pointprotected FieldElevationExtremumDetector<T> create(FieldAdaptableInterval<T> newMaxCheck, T newThreshold, int newMaxIter, FieldEventHandler<T> newHandler)
create
in class FieldAbstractDetector<FieldElevationExtremumDetector<T extends org.hipparchus.CalculusFieldElement<T>>,T extends org.hipparchus.CalculusFieldElement<T>>
newMaxCheck
- maximum checking intervalnewThreshold
- convergence threshold (s)newMaxIter
- maximum number of iterations in the event time searchnewHandler
- event handler to call at event occurrencespublic TopocentricFrame getTopocentricFrame()
public T getElevation(FieldSpacecraftState<T> s)
s
- the current state information: date, kinematics, attitudepublic T g(FieldSpacecraftState<T> s)
The value is the spacecraft elevation first time derivative.
g
in interface FieldEventDetector<T extends org.hipparchus.CalculusFieldElement<T>>
g
in class FieldAbstractDetector<FieldElevationExtremumDetector<T extends org.hipparchus.CalculusFieldElement<T>>,T extends org.hipparchus.CalculusFieldElement<T>>
s
- the current state information: date, kinematics, attitudeCopyright © 2002-2023 CS GROUP. All rights reserved.