public class PerigeeAltitudeDetector extends AbstractDetector
This class finds altitude events (i.e. satellite crossing a predefined altitude level above ground). The altitude computed here is the one of the osculating perigee
The default implementation behavior is to
continue
propagation when ascending
and to stop
propagation when descending.
This can be changed by overriding the eventOccurred
method
in a derived class.
Propagator.addEventDetector(EventDetector)
,
AltitudeDetector
,
Serialized FormEventDetector.Action
DEFAULT_MAXCHECK, DEFAULT_THRESHOLD
DECREASING, INCREASING, INCREASING_DECREASING
Constructor and Description |
---|
PerigeeAltitudeDetector(double altitudeIn,
double earthRadiusIn)
Build a new altitude detector.
|
PerigeeAltitudeDetector(double maxCheck,
double altitudeIn,
double earthRadiusIn)
Build a new altitude detector.
|
PerigeeAltitudeDetector(double maxCheck,
double threshold,
double altitudeIn,
double earthRadiusIn)
Build a new altitude detector.
|
PerigeeAltitudeDetector(double maxCheck,
double threshold,
double altitudeIn,
double earthRadiusIn,
EventDetector.Action ascending,
EventDetector.Action descending)
Build a new altitude detector.
|
PerigeeAltitudeDetector(double maxCheck,
double threshold,
double altitudeIn,
double earthRadiusIn,
EventDetector.Action ascending,
EventDetector.Action descending,
boolean removeAscending,
boolean removeDescending)
Build a new altitude detector.
|
PerigeeAltitudeDetector(double maxCheck,
double threshold,
double altitudeIn,
double earthRadiusIn,
OrbitNatureConverter orbitConverterIn)
Build a new altitude detector, with osculating perigee.
|
PerigeeAltitudeDetector(double maxCheck,
double threshold,
double altitudeIn,
double earthRadiusIn,
OrbitNatureConverter orbitConverterIn,
EventDetector.Action ascending,
EventDetector.Action descending)
Build a new altitude detector, with osculating perigee.
|
PerigeeAltitudeDetector(double maxCheck,
double threshold,
double altitudeIn,
double earthRadiusIn,
OrbitNatureConverter orbitConverterIn,
EventDetector.Action ascending,
EventDetector.Action descending,
boolean removeAscending,
boolean removeDescending)
Build a new altitude detector, with osculating perigee.
|
Modifier and Type | Method and Description |
---|---|
EventDetector |
copy()
A copy of the detector.
|
EventDetector.Action |
eventOccurred(SpacecraftState s,
boolean increasing,
boolean forward)
Handle an altitude event and choose what to do next.
|
double |
g(SpacecraftState s)
Compute the value of the switching function.
|
double |
getAltitude()
Get the threshold altitude value.
|
double |
getEarthRadius()
Get the earth radius.
|
boolean |
shouldBeRemoved()
This method is called after
EventDetector.eventOccurred(fr.cnes.sirius.patrius.propagation.SpacecraftState, boolean, boolean) has been triggered. |
getMaxCheckInterval, getMaxIterationCount, getSlopeSelection, getThreshold, init, resetState
public PerigeeAltitudeDetector(double altitudeIn, double earthRadiusIn)
This simple constructor takes default values for maximal checking interval ( AbstractDetector.DEFAULT_MAXCHECK
) and
convergence threshold (AbstractDetector.DEFAULT_THRESHOLD
).
altitudeIn
- threshold altitude valueearthRadiusIn
- earth Radius (m) with respect to which altitude should be evaluatedpublic PerigeeAltitudeDetector(double maxCheck, double altitudeIn, double earthRadiusIn)
This simple constructor takes default value for convergence threshold ( AbstractDetector.DEFAULT_THRESHOLD
).
The maximal interval between altitude checks should be smaller than the half duration of the minimal pass to handle, otherwise some short passes could be missed.
maxCheck
- maximal checking interval (s)altitudeIn
- threshold altitude value (m)earthRadiusIn
- earth Radius (m) with respect to which altitude should be evaluatedpublic PerigeeAltitudeDetector(double maxCheck, double threshold, double altitudeIn, double earthRadiusIn)
The maximal interval between altitude checks should be smaller than the half duration of the minimal pass to handle, otherwise some short passes could be missed.
The default implementation behavior is to
continue
propagation when
ascending and to stop
propagation
when descending.
maxCheck
- maximal checking interval (s)threshold
- convergence threshold (s)altitudeIn
- threshold altitude value (m)earthRadiusIn
- earth Radius (m) with respect to which altitude should be evaluatedpublic PerigeeAltitudeDetector(double maxCheck, double threshold, double altitudeIn, double earthRadiusIn, EventDetector.Action ascending, EventDetector.Action descending)
The maximal interval between altitude checks should be smaller than the half duration of the minimal pass to handle, otherwise some short passes could be missed.
maxCheck
- maximal checking interval (s)threshold
- convergence threshold (s)altitudeIn
- threshold altitude value (m)earthRadiusIn
- earth Radius (m) with respect to which altitude should be evaluatedascending
- action performed when ascendingdescending
- action performed when descendingpublic PerigeeAltitudeDetector(double maxCheck, double threshold, double altitudeIn, double earthRadiusIn, EventDetector.Action ascending, EventDetector.Action descending, boolean removeAscending, boolean removeDescending)
The maximal interval between altitude checks should be smaller than the half duration of the minimal pass to handle, otherwise some short passes could be missed.
maxCheck
- maximal checking interval (s)threshold
- convergence threshold (s)altitudeIn
- threshold altitude value (m)earthRadiusIn
- earth Radius (m) with respect to which altitude should be evaluatedascending
- action performed when ascendingdescending
- action performed when descendingremoveAscending
- true if detector should be removed when ascendingremoveDescending
- true if detector should be removed when descendingpublic PerigeeAltitudeDetector(double maxCheck, double threshold, double altitudeIn, double earthRadiusIn, OrbitNatureConverter orbitConverterIn)
The maximal interval between altitude checks should be smaller than the half duration of the minimal pass to handle, otherwise some short passes could be missed.
The default implementation behavior is to
continue
propagation when
ascending and to stop
propagation
when descending.
maxCheck
- maximal checking interval (s)threshold
- convergence threshold (s)altitudeIn
- threshold altitude value (m)earthRadiusIn
- earth Radius (m) with respect to which altitude should be evaluatedorbitConverterIn
- orbit convertor to be used when computing perigee altitudepublic PerigeeAltitudeDetector(double maxCheck, double threshold, double altitudeIn, double earthRadiusIn, OrbitNatureConverter orbitConverterIn, EventDetector.Action ascending, EventDetector.Action descending)
The maximal interval between altitude checks should be smaller than the half duration of the minimal pass to handle, otherwise some short passes could be missed.
maxCheck
- maximal checking interval (s)threshold
- convergence threshold (s)altitudeIn
- threshold altitude value (m)earthRadiusIn
- Earth Radius (m) with respect to which altitude should be evaluatedorbitConverterIn
- orbit convertor to be used when computing perigee altitudeascending
- action performed when ascendingdescending
- action performed when descendingpublic PerigeeAltitudeDetector(double maxCheck, double threshold, double altitudeIn, double earthRadiusIn, OrbitNatureConverter orbitConverterIn, EventDetector.Action ascending, EventDetector.Action descending, boolean removeAscending, boolean removeDescending)
The maximal interval between altitude checks should be smaller than the half duration of the minimal pass to handle, otherwise some short passes could be missed.
maxCheck
- maximal checking interval (s)threshold
- convergence threshold (s)altitudeIn
- threshold altitude value (m)earthRadiusIn
- earth Radius (m) with respect to which altitude should be evaluatedorbitConverterIn
- orbit convertor to be used when computing perigee altitudeascending
- action performed when ascendingdescending
- action performed when descendingremoveAscending
- true if detector should be removed when ascendingremoveDescending
- true if detector should be removed when descendingpublic double getAltitude()
public double getEarthRadius()
public EventDetector.Action eventOccurred(SpacecraftState s, boolean increasing, boolean forward) throws PatriusException
The perigee Altitude is computed using IERS92 value for Earth Equatorial Radius.
eventOccurred
in interface EventDetector
eventOccurred
in class AbstractDetector
s
- the current state information : date, kinematics, attitudeincreasing
- if true, the value of the switching function increases when times increases
around eventforward
- if true, the integration variable (time) increases during integration.stop
or
continue
PatriusException
- if some specific error occurspublic boolean shouldBeRemoved()
EventDetector.eventOccurred(fr.cnes.sirius.patrius.propagation.SpacecraftState, boolean, boolean)
has been triggered. It returns true if the
current detector should be removed after first event detection. WARNING: this method
can be called only once a event has been triggered. Before, the value is not available.shouldBeRemoved
in interface EventDetector
shouldBeRemoved
in class AbstractDetector
public double g(SpacecraftState s) throws PatriusException
g
in interface EventDetector
g
in class AbstractDetector
s
- the current state information: date, kinematics, attitudePatriusException
- if some specific error occurspublic EventDetector copy()
The following attributes are not deeply copied:
OrbitNatureConverter
Copyright © 2019 CNES. All rights reserved.