|
||||||||||
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.ExtremaDistanceDetector
public class ExtremaDistanceDetector
Detects when the distance from the spacecraft to a given body reaches either a local minimum or a local maximum.
The local minimum or maximum is chosen through a constructor parameter,
with values MIN
, MAX
and MIN_MAX
for both.
The default implementation behavior is to stop
propagation
at minimum or/and maximum distance depending on extremum type defined.
This can be changed by using one of the following constructors :
ExtremaDistanceDetector
: the
defined action is performed at local minimum OR/AND maximum depending on slope selection defined.
ExtremaDistanceDetector
: the defined actions are performed at local minimum AND maximum.
EventDetector
,
Serialized FormNested Class Summary |
---|
Nested classes/interfaces inherited from interface org.orekit.propagation.events.EventDetector |
---|
EventDetector.Action |
Field Summary | |
---|---|
static int |
MAX
Flag for local maximum distance detection (g decreasing). |
static int |
MIN
Flag for local minimum distance detection (g increasing). |
static int |
MIN_MAX
Flag for both local minimum and maximum distance detection. |
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 | |
---|---|
ExtremaDistanceDetector(PVCoordinatesProvider dBody,
double maxCheck,
double threshold,
EventDetector.Action actionMin,
EventDetector.Action actionMax)
Constructor for both minimum and maximum distance . |
|
ExtremaDistanceDetector(PVCoordinatesProvider dBody,
double maxCheck,
double threshold,
EventDetector.Action actionMin,
EventDetector.Action actionMax,
boolean removeMin,
boolean removeMax)
Constructor for both minimum and maximum distance . |
|
ExtremaDistanceDetector(PVCoordinatesProvider dBody,
int extremumType)
Constructor for a ExtremaDistanceDetector instance. |
|
ExtremaDistanceDetector(PVCoordinatesProvider dBody,
int extremumType,
double maxCheck,
double threshold)
Constructor for a ExtremaDistanceDetector instance with complimentary parameters. |
|
ExtremaDistanceDetector(PVCoordinatesProvider dBody,
int extremumType,
double maxCheck,
double threshold,
EventDetector.Action action)
Constructor for a ExtremaDistanceDetector instance with specified action when extrema is detected. |
|
ExtremaDistanceDetector(PVCoordinatesProvider dBody,
int extremumType,
double maxCheck,
double threshold,
EventDetector.Action action,
boolean remove)
Constructor for a ExtremaDistanceDetector instance with specified action when extrema is detected. |
Method Summary | |
---|---|
EventDetector.Action |
eventOccurred(SpacecraftState s,
boolean increasing,
boolean forward)
Handle an extrema distance event and choose what to do next. |
double |
g(SpacecraftState s)
Compute the value of the switching function. |
PVCoordinatesProvider |
getBody()
|
void |
init(SpacecraftState s0,
AbsoluteDate t)
Initialize event handler at the start of a propagation. |
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, resetState |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final int MIN
public static final int MAX
public static final int MIN_MAX
Constructor Detail |
---|
public ExtremaDistanceDetector(PVCoordinatesProvider dBody, int extremumType)
The default implementation behavior is to stop
propagation when the expected
extrema is reached.
dBody
- the body whose distance is watched.extremumType
- MIN
for shortest distance detection,
MAX
for farthest distance detection
or MIN_MAX
for both shortest and
farthest distance detectionpublic ExtremaDistanceDetector(PVCoordinatesProvider dBody, int extremumType, double maxCheck, double threshold)
The default implementation behavior is to stop
propagation when the expected
extrema is reached.
dBody
- the body whose distance is watched.extremumType
- MIN
for shortest distance detection,
MAX
for farthest distance detection
or MIN_MAX
for both shortest and
farthest distance detectionmaxCheck
- maximum check (see AbstractDetector
)threshold
- threshold (see AbstractDetector
)public ExtremaDistanceDetector(PVCoordinatesProvider dBody, double maxCheck, double threshold, EventDetector.Action actionMin, EventDetector.Action actionMax)
dBody
- the body whose distance is watched.maxCheck
- maximum check (see AbstractDetector
)threshold
- threshold (see AbstractDetector
)actionMin
- action to be perform when the expected local minimum is reachedactionMax
- action to be perform when the expected local maximum is reachedpublic ExtremaDistanceDetector(PVCoordinatesProvider dBody, double maxCheck, double threshold, EventDetector.Action actionMin, EventDetector.Action actionMax, boolean removeMin, boolean removeMax)
dBody
- the body whose distance is watched.maxCheck
- maximum check (see AbstractDetector
)threshold
- threshold (see AbstractDetector
)actionMin
- action to be perform when the expected local minimum is reachedactionMax
- action to be perform when the expected local maximum is reachedremoveMin
- true if detector should be removed when the expected local minimum is reachedremoveMax
- true if detector should be removed when the expected local maximum is reachedpublic ExtremaDistanceDetector(PVCoordinatesProvider dBody, int extremumType, double maxCheck, double threshold, EventDetector.Action action)
dBody
- the body whose distance is watched.extremumType
- MIN
for shortest distance detection,
MAX
for farthest distance detection
or MIN_MAX
for both shortest and
farthest distance detectionmaxCheck
- maximum check (see AbstractDetector
)threshold
- threshold (see AbstractDetector
)action
- action to be performed when the expected extrema is reachedpublic ExtremaDistanceDetector(PVCoordinatesProvider dBody, int extremumType, double maxCheck, double threshold, EventDetector.Action action, boolean remove)
dBody
- the body whose distance is watched.extremumType
- MIN
for shortest distance detection,
MAX
for farthest distance detection
or MIN_MAX
for both shortest and
farthest distance detectionmaxCheck
- maximum check (see AbstractDetector
)threshold
- threshold (see AbstractDetector
)action
- action to be performed when the expected extrema is reachedremove
- true if detector should be removed
NB : If remove is true, it means detector should be removed at detection, so the
value of attributes removeMIN and removeMAX must be decided according
extremumType.
Doing it, we ensure that detector will be removed well at propagation when calling
method eventOccured (in which the value of attribute shouldBeRemoved is decided).
In this case, users should better create an ExtremaDistanceDectector with constructor
ExtremaDistanceDetector(PVCoordinatesProvider, double,
double, EventDetector.Action, EventDetector.Action, boolean, boolean)
.Method Detail |
---|
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 occurs.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 double g(SpacecraftState s) throws OrekitException
AbstractDetector
g
in interface EventDetector
g
in class AbstractDetector
s
- the current state information: date, kinematics, attitude for forces
and events computation, mass provider, and additional states
OrekitException
- if some specific error occurspublic void init(SpacecraftState s0, AbsoluteDate t)
AbstractDetector
This method is called once at the start of the propagation. It may be used by the event handler to initialize some internal data if needed.
init
in interface EventDetector
init
in class AbstractDetector
s0
- initial statet
- target time for the integrationpublic PVCoordinatesProvider getBody()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |