fr.cnes.sirius.patrius.events
Interface CodingEventDetector

All Superinterfaces:

EventDetector, Serializable

All Known Implementing Classes:

GenericCodingEventDetector

public interface CodingEventDetector
extends EventDetector

This interface represents an event detector that is able to build a CodedEvent object.

A CodingEventDetector can be used during propagation when we want to log the occurred events.
These events are detected by the EventDetector that has been specified when creating the CodingEventDetector

Since:

1.1

Version:

$Id: CodingEventDetector.java 6322 2012-09-20 15:51:39Z CardosoP $

Author:

Tiziana Sabatini

See Also:

EventDetector

Nested Class Summary

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

EventDetector.Action

Field Summary

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

DECREASING, INCREASING, INCREASING_DECREASING

Method Summary

CodedEvent	buildCodedEvent(SpacecraftState s, boolean increasing) Build a CodedEvent instance appropriate for the provided SpacecraftState.
CodedEvent	buildDelayedCodedEvent(SpacecraftState s, boolean increasing) Build a delayed CodedEvent instance appropriate for the provided SpacecraftState.
CodedEvent	buildOccurrenceCodedEvent(SpacecraftState s, boolean increasing) Build a CodedEvent instance appropriate for the provided SpacecraftState.
String	getEventType() Gets a code indicating the type of event we want to log: DELAY when a delay is associated to the logged events with respect to the detected events, N_OCCURRENCE when we want to log the nth occurrence of the detected events, STANDARD when no delays and no occurrence numbers are taken into consideration.
String	getPhenomenonCode() If the implementation supports a Phenomenon, provides a code for the phenomenon associated to the event.
boolean	positiveSignMeansActive() Get the sign of the g method that means "the phenomenon associated to the event is active". This method has been implemented because of the inconsistency of the sign of the g functions in the EventDetector classes in Orekit: for some events, g is positive when its associated phenomenon is active, and for others, g is positive when its phenomenon is not active. WARNING : If Phenomena are not supported, the behavior of this method is undefined.

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

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

Method Detail

buildCodedEvent

CodedEvent buildCodedEvent(SpacecraftState s,
                           boolean increasing)

Build a CodedEvent instance appropriate for the provided SpacecraftState.

Parameters:

s - the current state information : date, kinematics, attitude

increasing - if true, g function increases around event date.

Returns:

the CodedEvent

buildDelayedCodedEvent

CodedEvent buildDelayedCodedEvent(SpacecraftState s,
                                  boolean increasing)

Build a delayed CodedEvent instance appropriate for the provided SpacecraftState. This instance will have a delay with respect to the associated detected event.

Parameters:

s - the current state information : date, kinematics, attitude

increasing - if true, g function increases around event date.

Returns:

the CodedEvent

buildOccurrenceCodedEvent

CodedEvent buildOccurrenceCodedEvent(SpacecraftState s,
                                     boolean increasing)

Build a CodedEvent instance appropriate for the provided SpacecraftState. This method will return an instance only if it is be the nth occurrence of the corresponding event, otherwise it will return null. A delay can be applied to the event.

Parameters:

s - the current state information : date, kinematics, attitude

increasing - if true, g function increases around event date.

Returns:

the CodedEvent

positiveSignMeansActive

boolean positiveSignMeansActive()

Get the sign of the g method that means "the phenomenon associated to the event is active".
This method has been implemented because of the inconsistency of the sign of the g functions in the EventDetector classes in Orekit: for some events, g is positive when its associated phenomenon is active, and for others, g is positive when its phenomenon is not active.
WARNING : If Phenomena are not supported, the behavior of this method is undefined.

Returns:

true for positive, false for negative.

getPhenomenonCode

String getPhenomenonCode()

If the implementation supports a Phenomenon, provides a code for the phenomenon associated to the event. If not, returns null.

Returns:

either a code, or null if Phenomena are not supported.

getEventType

String getEventType()

Gets a code indicating the type of event we want to log: DELAY when a delay is associated to the logged events with respect to the detected events, N_OCCURRENCE when we want to log the nth occurrence of the detected events, STANDARD when no delays and no occurrence numbers are taken into consideration.

Returns:

the type of event to log