fr.cnes.genopus.nonWidget.events

Class CustomNodeDetector

java.lang.Object

org.orekit.propagation.events.AbstractDetector

org.orekit.propagation.events.NodeDetector

fr.cnes.genopus.nonWidget.events.CustomNodeDetector

All Implemented Interfaces:

CustomEventDetector, CustomTriggeredEventDetector, Serializable, org.orekit.propagation.events.EventDetector

public class CustomNodeDetector
extends org.orekit.propagation.events.NodeDetector
implements CustomTriggeredEventDetector

Sub-class of Orekit's NodeDetector class to be able to change the action to be performed in case of event detection.

Author:

aadt

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CustomNodeDetector.NodeDetectionChoice Choices for node events detection.

Nested classes/interfaces inherited from interface org.orekit.propagation.events.EventDetector

org.orekit.propagation.events.EventDetector.Action

Field Summary

Fields inherited from class org.orekit.propagation.events.NodeDetector

ASCENDING, ASCENDING_DESCENDING, DESCENDING

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

Constructors

Constructor and Description
CustomNodeDetector(org.orekit.frames.Frame frame, CustomNodeDetector.NodeDetectionChoice nodeDetectionChoice, int triggerFrom, Integer triggerStep, Integer triggerTo) Constructor with target node and body shape. maxCheck (600 s), threshold (1.0e-6 s) and action (RESET_STATE) by default.
CustomNodeDetector(org.orekit.frames.Frame frame, CustomNodeDetector.NodeDetectionChoice nodeDetectionChoice, int triggerFrom, Integer triggerStep, Integer triggerTo, double maxCheck, double threshold, org.orekit.propagation.events.EventDetector.Action action) Constructor with complete data.

Method Summary

Methods

Modifier and Type	Method and Description
org.orekit.propagation.events.EventDetector	copy() Returns a new instance of the current type of CustomEventDetector with the same attributes but for the action which is set to Action#CONTINUE.
org.orekit.propagation.events.EventDetector.Action	eventOccurred(org.orekit.propagation.SpacecraftState s, boolean increasing, boolean forward)
org.orekit.propagation.events.EventDetector.Action	getAction() Getter for the action to be performed in case of event detection.
fr.cnes.sirius.patrius.events.CodingEventDetector	getCodingEventDetector(String incEventString, String decEventString) Get the coding event detector for some given increasing and decreasing messages.
CustomNodeDetector.NodeDetectionChoice	getNodeDetectionChoice() Returns the node detection choice as an item of the CustomNodeDetector.NodeDetectionChoice enum.
int	getTriggerFrom() Getter for the count from which the event must be triggered.
Integer	getTriggerStep() Getter for the step every which the event must be triggered.
Integer	getTriggerTo() Getter for the count until which the event must be triggered.
CustomEventDetectorTrigger.TriggeringType	getTriggerType() Getter for the trigger type, that is, the slope of the switching function that must trigger the event.
org.orekit.propagation.SpacecraftState	resetState(org.orekit.propagation.SpacecraftState oldState)
String	toString()

Methods inherited from class org.orekit.propagation.events.NodeDetector

g, getFrame, shouldBeRemoved

Methods inherited from class org.orekit.propagation.events.AbstractDetector

getMaxCheckInterval, getMaxIterationCount, getSlopeSelection, getThreshold, init

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.orekit.propagation.events.EventDetector

g, getMaxCheckInterval, getMaxIterationCount, getSlopeSelection, getThreshold, init, shouldBeRemoved

Constructor Detail

CustomNodeDetector

public CustomNodeDetector(org.orekit.frames.Frame frame,
                  CustomNodeDetector.NodeDetectionChoice nodeDetectionChoice,
                  int triggerFrom,
                  Integer triggerStep,
                  Integer triggerTo)

Constructor with target node and body shape. maxCheck (600 s), threshold (1.0e-6 s) and action (RESET_STATE) by default.

Parameters:

frame - frame in which the equator is defined (typical values are J2000 or ITRF 2005).

nodeDetectionChoice - node detection choice

triggerFrom - count at/from which the single/multiple event must be triggered.

triggerStep - step every which the multiple event must be triggered. If null, the event will be triggered only once at the occurrence given by triggerFrom.

triggerTo - count until which the multiple event must be triggered. If null, the event will be triggered until the end of propagation.

CustomNodeDetector

public CustomNodeDetector(org.orekit.frames.Frame frame,
                  CustomNodeDetector.NodeDetectionChoice nodeDetectionChoice,
                  int triggerFrom,
                  Integer triggerStep,
                  Integer triggerTo,
                  double maxCheck,
                  double threshold,
                  org.orekit.propagation.events.EventDetector.Action action)

Constructor with complete data.

Parameters:

frame - frame in which the equator is defined (typical values are J2000 or ITRF 2005).

nodeDetectionChoice - node detection choice

triggerFrom - count at/from which the single/multiple event must be triggered.

triggerStep - step every which the multiple event must be triggered. If null, the event will be triggered only once at the occurrence given by triggerFrom.

triggerTo - count until which the multiple event must be triggered. If null, the event will be triggered until the end of propagation.

maxCheck - maximum checking interval (s).

threshold - convergence threshold (s).

action - action to be performed in case of event detection.

Method Detail

getNodeDetectionChoice

public CustomNodeDetector.NodeDetectionChoice getNodeDetectionChoice()

Returns the node detection choice as an item of the CustomNodeDetector.NodeDetectionChoice enum.

Returns:

the node detection choice: CustomNodeDetector.NodeDetectionChoice.Ascending, CustomNodeDetector.NodeDetectionChoice.Descending or CustomNodeDetector.NodeDetectionChoice.Both

getTriggerFrom

public int getTriggerFrom()

Getter for the count from which the event must be triggered.

Specified by:

getTriggerFrom in interface CustomTriggeredEventDetector

Returns:

the count from which the event must be triggered.

getTriggerStep

public Integer getTriggerStep()

Getter for the step every which the event must be triggered. If null the event is triggered only once.

Specified by:

getTriggerStep in interface CustomTriggeredEventDetector

Returns:

the step every which the event must be triggered.

getTriggerTo

public Integer getTriggerTo()

Getter for the count until which the event must be triggered. If null, the event is triggered until the end of propagation.

Specified by:

getTriggerTo in interface CustomTriggeredEventDetector

Returns:

the count until which the event must be triggered.

getAction

public org.orekit.propagation.events.EventDetector.Action getAction()

Getter for the action to be performed in case of event detection.

Specified by:

getAction in interface CustomEventDetector

Returns:

the action to be performed in case of event detection.

eventOccurred

public org.orekit.propagation.events.EventDetector.Action eventOccurred(org.orekit.propagation.SpacecraftState s,
                                                               boolean increasing,
                                                               boolean forward)

Specified by:

eventOccurred in interface org.orekit.propagation.events.EventDetector

Overrides:

eventOccurred in class org.orekit.propagation.events.NodeDetector

resetState

public org.orekit.propagation.SpacecraftState resetState(org.orekit.propagation.SpacecraftState oldState)

Specified by:

resetState in interface org.orekit.propagation.events.EventDetector

Overrides:

resetState in class org.orekit.propagation.events.AbstractDetector

toString

public String toString()

Overrides:

toString in class Object

copy

public org.orekit.propagation.events.EventDetector copy()

Description copied from interface: CustomEventDetector

Returns a new instance of the current type of CustomEventDetector with the same attributes but for the action which is set to Action#CONTINUE. It is intended to be used to create the CodingEventDetector.

Specified by:

copy in interface CustomEventDetector

Returns:

a new instance with equal attributes but with Action#CONTINUE

getCodingEventDetector

public fr.cnes.sirius.patrius.events.CodingEventDetector getCodingEventDetector(String incEventString,
                                                                       String decEventString)

Description copied from interface: CustomEventDetector

Get the coding event detector for some given increasing and decreasing messages.

Specified by:

getCodingEventDetector in interface CustomEventDetector

Parameters:

incEventString - message to be included at the beginning of the message log when the detector is triggered with increasing g function

decEventString - message to be included at the beginning of the message log when the detector is triggered with decreasing g function

Returns:

the generic coding event detector with equal attributes as the original event detector.

getTriggerType

public CustomEventDetectorTrigger.TriggeringType getTriggerType()

Getter for the trigger type, that is, the slope of the switching function that must trigger the event. The options are CustomEventDetectorTrigger.TriggeringType.INCREASING for increasing slope, CustomEventDetectorTrigger.TriggeringType.DECREASING for decreasing slope and CustomEventDetectorTrigger.TriggeringType.BOTH for increasing or decreasing slope of the switching function.

Specified by:

getTriggerType in interface CustomTriggeredEventDetector

Returns:

the trigger type.