public class LongitudeCrossingDetector extends AbstractDetector<LongitudeCrossingDetector>
This detector identifies when a spacecraft crosses a fixed longitude with respect to a central body.
DEFAULT_MAX_ITER, DEFAULT_MAXCHECK, DEFAULT_THRESHOLD| Modifier | Constructor and Description |
|---|---|
protected |
LongitudeCrossingDetector(AdaptableInterval maxCheck,
double threshold,
int maxIter,
EventHandler handler,
OneAxisEllipsoid body,
double longitude)
Protected constructor with full parameters.
|
|
LongitudeCrossingDetector(double maxCheck,
double threshold,
OneAxisEllipsoid body,
double longitude)
Build a detector.
|
|
LongitudeCrossingDetector(OneAxisEllipsoid body,
double longitude)
Build a new detector.
|
| Modifier and Type | Method and Description |
|---|---|
protected LongitudeCrossingDetector |
create(AdaptableInterval newMaxCheck,
double newThreshold,
int newMaxIter,
EventHandler newHandler)
Build a new instance.
|
double |
g(SpacecraftState s)
Compute the value of the detection function.
|
OneAxisEllipsoid |
getBody()
Get the body on which the geographic zone is defined.
|
double |
getLongitude()
Get the fixed longitude to be crossed (radians).
|
void |
init(SpacecraftState s0,
AbsoluteDate t)
Initialize event handler at the start of a propagation.
|
getHandler, getMaxCheckInterval, getMaxIterationCount, getThreshold, isForward, withHandler, withMaxCheck, withMaxCheck, withMaxIter, withThresholdpublic LongitudeCrossingDetector(OneAxisEllipsoid body, double longitude)
The new instance uses default values for maximal checking interval
(AbstractDetector.DEFAULT_MAXCHECK) and convergence threshold (AbstractDetector.DEFAULT_THRESHOLD).
body - body on which the longitude is definedlongitude - longitude to be crossedpublic LongitudeCrossingDetector(double maxCheck,
double threshold,
OneAxisEllipsoid body,
double longitude)
maxCheck - maximal checking interval (s)threshold - convergence threshold (s)body - body on which the longitude is definedlongitude - longitude to be crossedprotected LongitudeCrossingDetector(AdaptableInterval maxCheck, double threshold, int maxIter, EventHandler handler, OneAxisEllipsoid body, double longitude)
This constructor is not public as users are expected to use the builder
API with the various withXxx() methods to set up the instance
in a readable manner without using a huge amount of parameters.
maxCheck - maximum checking intervalthreshold - convergence threshold (s)maxIter - maximum number of iterations in the event time searchhandler - event handler to call at event occurrencesbody - body on which the longitude is definedlongitude - longitude to be crossedprotected LongitudeCrossingDetector create(AdaptableInterval newMaxCheck, double newThreshold, int newMaxIter, EventHandler newHandler)
create in class AbstractDetector<LongitudeCrossingDetector>newMaxCheck - maximum checking interval (s)newThreshold - convergence threshold (s)newMaxIter - maximum number of iterations in the event time searchnewHandler - event handler to call at event occurrencespublic OneAxisEllipsoid getBody()
public double getLongitude()
public void init(SpacecraftState s0, AbsoluteDate t)
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.
The default implementation does nothing
This implementation sets the direction of propagation and initializes the event
handler. If a subclass overrides this method it should call super.init(s0, t).
init in interface EventDetectorinit in class AbstractDetector<LongitudeCrossingDetector>s0 - initial statet - target time for the integrationpublic double g(SpacecraftState s)
The value is the longitude difference between the spacecraft and the fixed
longitude to be crossed, with some sign tweaks to ensure continuity.
These tweaks imply the increasing flag in events detection becomes
irrelevant here! As an example, the longitude of a prograde spacecraft
will always increase, but this g function will increase and decrease so it
will cross the zero value once per orbit, in increasing and decreasing
directions on alternate orbits. If eastwards and westwards crossing have to
be distinguished, the velocity direction has to be checked instead of looking
at the increasing flag.
g in interface EventDetectorg in class AbstractDetector<LongitudeCrossingDetector>s - the current state information: date, kinematics, attitudeCopyright © 2002-2023 CS GROUP. All rights reserved.