public class InterSatDirectViewDetector extends AbstractDetector<InterSatDirectViewDetector>
As this detector needs two satellites, it embeds one coordinates provider for the secondary satellite
and is registered as an event detector in the propagator of the primary
satellite. The secondary satellite provider will therefore be driven by this
detector (and hence by the propagator in which this detector is registered).
In order to avoid infinite recursion, care must be taken to have the secondary
satellite provider being completely independent from anything else.
In particular, if the provider is a propagator, it should not be run
together in a propagators parallelizer with
the propagator this detector is registered in. It is fine however to configure
two separate propagators PsA and PsB with similar settings for the secondary satellite
and one propagator Pm for the primary satellite and then use Psa in this detector
registered within Pm while Pm and Psb are run in the context of a propagators parallelizer.
For efficiency reason during the event search loop, it is recommended to have the secondary provider be an analytical propagator or an ephemeris. A numerical propagator as a secondary propagator works but is expected to be computationally costly.
The g function of this detector is positive when satellites can see
each other directly and negative when the central body limb is in between and
blocks the direct view.
This detector only checks masking by central body limb, it does not take into
account satellites antenna patterns. If these patterns must be considered, then
this detector can be and combined
with the logical not of
field of view detectors.
DEFAULT_MAX_ITER, DEFAULT_MAXCHECK, DEFAULT_THRESHOLD| Constructor and Description |
|---|
InterSatDirectViewDetector(OneAxisEllipsoid body,
PVCoordinatesProvider secondary)
simple constructor.
|
| Modifier and Type | Method and Description |
|---|---|
protected InterSatDirectViewDetector |
create(double newMaxCheck,
double newThreshold,
int newMaxIter,
EventHandler<? super InterSatDirectViewDetector> newHandler)
Build a new instance.
|
double |
g(SpacecraftState state)
Compute the value of the switching function.
|
OneAxisEllipsoid |
getCentralBody()
Get the central body.
|
PVCoordinatesProvider |
getSecondary()
Get the provider for the secondary satellite.
|
eventOccurred, getHandler, getMaxCheckInterval, getMaxIterationCount, getThreshold, init, isForward, resetState, withHandler, withMaxCheck, withMaxIter, withThresholdpublic InterSatDirectViewDetector(OneAxisEllipsoid body, PVCoordinatesProvider secondary)
body - central bodysecondary - provider for the secondary satellitepublic OneAxisEllipsoid getCentralBody()
public PVCoordinatesProvider getSecondary()
protected InterSatDirectViewDetector create(double newMaxCheck, double newThreshold, int newMaxIter, EventHandler<? super InterSatDirectViewDetector> newHandler)
create in class AbstractDetector<InterSatDirectViewDetector>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 state)
The g function of this detector is positive when satellites can see
each other directly and negative when the central body limb is in between and
blocks the direct view.
g in interface EventDetectorg in class AbstractDetector<InterSatDirectViewDetector>state - the current state information: date, kinematics, attitudeCopyright © 2002-2022 CS GROUP. All rights reserved.