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.ActionDEFAULT_MAXCHECK, DEFAULT_THRESHOLDDECREASING, 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.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, resetStatepublic 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 EventDetectoreventOccurred in class AbstractDetectors - 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
continuePatriusException - 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 EventDetectorshouldBeRemoved in class AbstractDetectorpublic double g(SpacecraftState s) throws PatriusException
g in interface EventDetectorg in class AbstractDetectors - the current state information: date, kinematics, attitudePatriusException - if some specific error occursCopyright © 2017 CNES. All rights reserved.