|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.orekit.propagation.events.AbstractDetector
org.orekit.propagation.events.AltitudeDetector
public class AltitudeDetector
Finder for satellite altitude crossing events.
This class finds altitude events (i.e. satellite crossing a predefined altitude level above ground).
The default implementation behavior is to continue
propagation when ascending and to
stop
propagation
when descending. This can be changed by using provided constructors.
Propagator.addEventDetector(EventDetector)
,
Serialized FormNested Class Summary |
---|
Nested classes/interfaces inherited from interface org.orekit.propagation.events.EventDetector |
---|
EventDetector.Action |
Field Summary |
---|
Fields inherited from class org.orekit.propagation.events.AbstractDetector |
---|
DEFAULT_MAXCHECK, DEFAULT_THRESHOLD |
Fields inherited from interface org.orekit.propagation.events.EventDetector |
---|
DECREASING, INCREASING, INCREASING_DECREASING |
Constructor Summary | |
---|---|
AltitudeDetector(double altitude,
BodyShape bodyShape)
Build a new altitude detector. |
|
AltitudeDetector(double altitude,
BodyShape bodyShape,
double maxCheck)
Build a new altitude detector. |
|
AltitudeDetector(double altitude,
BodyShape bodyShape,
double maxCheck,
double threshold)
Build a new altitude detector. |
|
AltitudeDetector(double altitude,
BodyShape bodyShape,
double maxCheck,
double threshold,
EventDetector.Action ascending,
EventDetector.Action descending)
Build a new altitude detector. |
|
AltitudeDetector(double altitude,
BodyShape bodyShape,
double maxCheck,
double threshold,
EventDetector.Action ascending,
EventDetector.Action descending,
boolean removeAscending,
boolean removeDescending)
Build a new altitude detector. |
Method Summary | |
---|---|
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. |
BodyShape |
getBodyShape()
Get the body shape. |
boolean |
shouldBeRemoved()
This method is called after EventDetector.eventOccurred(org.orekit.propagation.SpacecraftState, boolean, boolean) has been triggered. |
Methods inherited from class org.orekit.propagation.events.AbstractDetector |
---|
getMaxCheckInterval, getMaxIterationCount, getSlopeSelection, getThreshold, init, resetState |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public AltitudeDetector(double altitude, BodyShape bodyShape)
This simple constructor takes default values for maximal checking
interval (AbstractDetector.DEFAULT_MAXCHECK
) and convergence threshold
(AbstractDetector.DEFAULT_THRESHOLD
).
The default implementation behavior is to continue
propagation when ascending and to
stop
propagation when descending.
altitude
- threshold altitude valuebodyShape
- body shape with respect to which altitude should be evaluatedpublic AltitudeDetector(double altitude, BodyShape bodyShape, double maxCheck)
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.
The default implementation behavior is to continue
propagation when ascending and to
stop
propagation when descending.
altitude
- threshold altitude value (m)bodyShape
- body shape with respect to which altitude should be evaluatedmaxCheck
- maximal checking interval (s)public AltitudeDetector(double altitude, BodyShape bodyShape, double maxCheck, double 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.
The default implementation behavior is to continue
propagation when ascending and to
stop
propagation when descending.
altitude
- threshold altitude value (m)bodyShape
- body shape with respect to which altitude should be evaluatedmaxCheck
- maximal checking interval (s)threshold
- convergence threshold (s)public AltitudeDetector(double altitude, BodyShape bodyShape, double maxCheck, double threshold, 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.
altitude
- threshold altitude value (m)bodyShape
- body shape with respect to which altitude should be evaluatedmaxCheck
- maximal checking interval (s)threshold
- convergence threshold (s)ascending
- action performed when ascendingdescending
- action performed when descendingpublic AltitudeDetector(double altitude, BodyShape bodyShape, double maxCheck, double threshold, 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.
altitude
- threshold altitude value (m)bodyShape
- body shape with respect to which altitude should be evaluatedmaxCheck
- maximal checking interval (s)threshold
- convergence threshold (s)ascending
- action performed when ascendingdescending
- action performed when descendingremoveAscending
- true if detector should be removed at ascending altitude detectionremoveDescending
- true if detector should be removed at descending altitude detectionMethod Detail |
---|
public double getAltitude()
public BodyShape getBodyShape()
public boolean shouldBeRemoved()
EventDetector.eventOccurred(org.orekit.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 EventDetector.Action eventOccurred(SpacecraftState s, boolean increasing, boolean forward) throws OrekitException
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.
OrekitException
- if some specific error occurspublic double g(SpacecraftState s) throws OrekitException
g
in interface EventDetector
g
in class AbstractDetector
s
- the current state information: date, kinematics, attitude
OrekitException
- if some specific error occurs
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |