public class ApsideDetector extends AbstractDetector<ApsideDetector>
This class finds apside crossing events (i.e. apogee or perigee crossing).
The default implementation behavior is to continue
propagation at apogee crossing and to stop
propagation
at perigee crossing. This can be changed by calling
AbstractDetector.withHandler(EventHandler)
after construction.
Beware that apside detection will fail for almost circular orbits. If
for example an apside detector is used to trigger an ImpulseManeuver
and the maneuver
change the orbit shape to circular, then the detector may completely fail just
after the maneuver has been performed!
Propagator.addEventDetector(EventDetector)
DEFAULT_MAX_ITER, DEFAULT_MAXCHECK, DEFAULT_THRESHOLD
Modifier | Constructor and Description |
---|---|
protected |
ApsideDetector(AdaptableInterval maxCheck,
double threshold,
int maxIter,
EventHandler handler)
Protected constructor with full parameters.
|
|
ApsideDetector(double threshold,
Orbit orbit)
Build a new instance.
|
|
ApsideDetector(Orbit orbit)
Build a new instance.
|
Modifier and Type | Method and Description |
---|---|
protected ApsideDetector |
create(AdaptableInterval newMaxCheck,
double newThreshold,
int newMaxIter,
EventHandler newHandler)
Build a new instance.
|
double |
g(SpacecraftState s)
Compute the value of the switching function.
|
getHandler, getMaxCheckInterval, getMaxIterationCount, getThreshold, init, isForward, withHandler, withMaxCheck, withMaxCheck, withMaxIter, withThreshold
public ApsideDetector(Orbit orbit)
The orbit is used only to set an upper bound for the max check interval to period/3 and to set the convergence threshold according to orbit size
orbit
- initial orbitpublic ApsideDetector(double threshold, Orbit orbit)
The orbit is used only to set an upper bound for the max check interval to period/3
threshold
- convergence threshold (s)orbit
- initial orbitprotected ApsideDetector(AdaptableInterval maxCheck, double threshold, int maxIter, EventHandler handler)
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 occurrencesprotected ApsideDetector create(AdaptableInterval newMaxCheck, double newThreshold, int newMaxIter, EventHandler newHandler)
create
in class AbstractDetector<ApsideDetector>
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 double g(SpacecraftState s)
g
in interface EventDetector
g
in class AbstractDetector<ApsideDetector>
s
- the current state information: date, kinematics, attitudeCopyright © 2002-2023 CS GROUP. All rights reserved.