Serializable
, EventDetector
public class InterSatDirectViewDetector extends AbstractDetector<InterSatDirectViewDetector>
As this detector needs two satellites, it embeds one coordinates provider
for the slave satellite
and is registered as an event detector in the propagator of the master
satellite. The slave 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 slave
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 slave satellite
and one propagator Pm for the master 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 slave provider be an analytical propagator or an ephemeris. A numerical propagator as a slave 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 | Description |
---|---|
InterSatDirectViewDetector(OneAxisEllipsoid body,
PVCoordinatesProvider slave) |
simple constructor.
|
Modifier and Type | Method | 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 |
getSlave() |
Get the provider for the slave satellite.
|
eventOccurred, getHandler, getMaxCheckInterval, getMaxIterationCount, getThreshold, init, isForward, resetState, withHandler, withMaxCheck, withMaxIter, withThreshold
public InterSatDirectViewDetector(OneAxisEllipsoid body, PVCoordinatesProvider slave)
body
- central bodyslave
- provider for the slave satellitepublic OneAxisEllipsoid getCentralBody()
public PVCoordinatesProvider getSlave()
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 EventDetector
g
in class AbstractDetector<InterSatDirectViewDetector>
state
- the current state information: date, kinematics, attitudeCopyright © 2002-2019 CS Systèmes d'information. All rights reserved.