Package org.orekit.propagation.events

This package provides interfaces and classes dealing with events occurring during propagation.

See:
Description

Interface Summary

EventDetector

This interface represents space-dynamics aware events detectors.

Class Summary

AbstractDetector	Common parts shared by several orbital events finders.
AdaptedEventDetector	Adapt an EventDetector to commons-math EventHandler interface.
AlignmentDetector	Finder for satellite/body alignment events.
AltitudeDetector	Finder for satellite altitude crossing events.
ApsideDetector	Finder for apside crossing events.
CircularFieldOfViewDetector	Finder for target entry/exit events with respect to a satellite sensor field of view.
CombinedEventsDetectorsManager	This class manages several event detectors during propagation.
DateDetector	Finder for date events.
DihedralFieldOfViewDetector	Finder for body entering/exiting dihedral fov events.
EclipseDetector	Finder for satellite eclipse related events.
ElevationDetector	Finder for satellite raising/setting events.
EventShifter	Wrapper shifting events occurrences times.
NodeDetector	Finder for node crossing events.

Package org.orekit.propagation.events Description

This package provides interfaces and classes dealing with events occurring during propagation. It is used when EventDetector instances are registered to any Propagator. When the event associated with the detector occurs, the propagator interrupts the propagation and calls the eventOccurred method of the event detector, which can do whatever the user want and either stop or resume propagation, optionally resetting the state.

If the registered events detectors are configured to stop propagation when triggered, the propagator can be run with an arbitrary large target date, relying on the events occurrence to stop propagation exactly at the right time.

The package provides some predefined events:

• AltitudeDetector detects altitude crossing (and by default stop at descending)
• ApsideDetector detects apside crossing (and by default stop at perigee)
• DateDetector detect occurrence of a predefine instant (and by default stop there)
• EclipseDetector detects satellite entering/exiting an eclipse (and by default stop on exit)
• ElevationDetector detects satellite raising/setting (and by default stop at setting)
• NodeDetector detects node crossing (and by default stop at ascending node)

The low level interfaces and classes are heavily based on similar classes from the ode.events package from the commons math library. The changes are mainly adaptations of the signatures to space dynamics.

• the type of dependent variable t has been changed from double to AbsoluteDate
• the type of state vector y has been changed from double[] to SpacecraftState

Author:

Luc Maisonobe