fr.cnes.genopus.nonWidget.events

Class CustomVisibilityFromStationDetector

java.lang.Object

org.orekit.propagation.events.AbstractDetector

fr.cnes.sirius.patrius.events.sensor.AbstractDetectorWithTropoCorrection

fr.cnes.sirius.patrius.events.sensor.VisibilityFromStationDetector

fr.cnes.genopus.nonWidget.events.CustomVisibilityFromStationDetector

All Implemented Interfaces:

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

public class CustomVisibilityFromStationDetector
extends fr.cnes.sirius.patrius.events.sensor.VisibilityFromStationDetector
implements CustomTriggeredEventDetector

Sub-class of Orekit's VisibilityFromStationDetector 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	CustomVisibilityFromStationDetector.VisibilityDetectionChoice Choices for visibility from station 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.AbstractDetector

DEFAULT_MAXCHECK, DEFAULT_THRESHOLD

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

DECREASING, INCREASING, INCREASING_DECREASING

Constructor Summary

Constructors

Constructor and Description
CustomVisibilityFromStationDetector(CustomGeodeticPoint stationGeodeticPoint, org.orekit.bodies.ExtendedOneAxisEllipsoid earthShape, CustomVisibilityFromStationDetector.VisibilityDetectionChoice visibilityDetectorChoice, int triggerFrom, Integer triggerStep, Integer triggerTo) Constructor with reduced data. maxCheck (600 s), threshold (1.0e-6 s) and action (RESET_STATE) by default.
CustomVisibilityFromStationDetector(CustomGeodeticPoint stationGeodeticPoint, org.orekit.bodies.ExtendedOneAxisEllipsoid earthShape, CustomVisibilityFromStationDetector.VisibilityDetectionChoice visibilityDetectorChoice, 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.
org.orekit.bodies.ExtendedOneAxisEllipsoid	getBodyShape() Getter for the Earth shape.
fr.cnes.sirius.patrius.events.CodingEventDetector	getCodingEventDetector(String incEventString, String decEventString) Get the coding event detector for some given increasing and decreasing messages.
CustomGeodeticPoint	getStationGeodeticPoint() Getter for the station geodetic point.
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.
CustomVisibilityFromStationDetector.VisibilityDetectionChoice	getVisibilityDetectionChoice() Getter for the visibility detector choice.
org.orekit.propagation.SpacecraftState	resetState(org.orekit.propagation.SpacecraftState oldState)
String	toString()

Methods inherited from class fr.cnes.sirius.patrius.events.sensor.VisibilityFromStationDetector

g, init, shouldBeRemoved

Methods inherited from class fr.cnes.sirius.patrius.events.sensor.AbstractDetectorWithTropoCorrection

getCorrectedVector, getCorrection, getStation

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

getMaxCheckInterval, getMaxIterationCount, getSlopeSelection, getThreshold

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

CustomVisibilityFromStationDetector

public CustomVisibilityFromStationDetector(CustomGeodeticPoint stationGeodeticPoint,
                                   org.orekit.bodies.ExtendedOneAxisEllipsoid earthShape,
                                   CustomVisibilityFromStationDetector.VisibilityDetectionChoice visibilityDetectorChoice,
                                   int triggerFrom,
                                   Integer triggerStep,
                                   Integer triggerTo)
                                    throws org.orekit.errors.OrekitException,
                                           ArithmeticException

Constructor with reduced data. maxCheck (600 s), threshold (1.0e-6 s) and action (RESET_STATE) by default.

Parameters:

stationGeodeticPoint - antenna station name and geodetic coordinates

earthShape - Earth body shape (ellipsoid)

visibilityDetectorChoice - visibility 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.

Throws:

org.orekit.errors.OrekitException - error when loading the ephemeris files

ArithmeticException - if stationGeodeticPoint latitude or longitude are NaN.

CustomVisibilityFromStationDetector

public CustomVisibilityFromStationDetector(CustomGeodeticPoint stationGeodeticPoint,
                                   org.orekit.bodies.ExtendedOneAxisEllipsoid earthShape,
                                   CustomVisibilityFromStationDetector.VisibilityDetectionChoice visibilityDetectorChoice,
                                   int triggerFrom,
                                   Integer triggerStep,
                                   Integer triggerTo,
                                   double maxCheck,
                                   double threshold,
                                   org.orekit.propagation.events.EventDetector.Action action)
                                    throws ArithmeticException

Constructor with complete data.

Parameters:

stationGeodeticPoint - antenna station name and geodetic coordinates

earthShape - Earth body shape (ellipsoid)

visibilityDetectorChoice - visibility 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.

Throws:

ArithmeticException - if stationGeodeticPoint latitude or longitude are NaN.

Method Detail

getStationGeodeticPoint

public CustomGeodeticPoint getStationGeodeticPoint()

Getter for the station geodetic point.

Returns:

the station geodetic point.

getBodyShape

public org.orekit.bodies.ExtendedOneAxisEllipsoid getBodyShape()

Getter for the Earth shape.

Returns:

the Earth shape.

getVisibilityDetectionChoice

public CustomVisibilityFromStationDetector.VisibilityDetectionChoice getVisibilityDetectionChoice()

Getter for the visibility detector choice.

Returns:

the visibility detector choice.

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)
                                                                 throws org.orekit.errors.OrekitException

Specified by:

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

Overrides:

eventOccurred in class fr.cnes.sirius.patrius.events.sensor.VisibilityFromStationDetector

Throws:

org.orekit.errors.OrekitException

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.