public class FieldOfViewDetector extends AbstractDetector<FieldOfViewDetector>
Field Of View.
Beware that this detector is unaware of any bodies occluding line-of-sight to
the target. It can be therefore used for many contexts from Earth Observation to
interplanetary mission design. For instance, in an Earth Observation context,
it can be easily combined to an ElevationDetector using
BooleanDetector.andCombine(java.util.Collection) to calculate station
visibility opportunities within the satellite's field of view.
The default implementation behavior is to continue
propagation at FOV entry and to stop propagation
at FOV exit. This can be changed by calling
AbstractDetector.withHandler(EventHandler) after construction.
Propagator.addEventDetector(EventDetector),
FootprintOverlapDetector,
VisibilityTriggerDEFAULT_MAX_ITER, DEFAULT_MAXCHECK, DEFAULT_THRESHOLD| Constructor and Description |
|---|
FieldOfViewDetector(PVCoordinatesProvider pvTarget,
double radiusTarget,
VisibilityTrigger trigger,
FieldOfView fov)
Build a new instance.
|
FieldOfViewDetector(PVCoordinatesProvider pvTarget,
FieldOfView fov)
Build a new instance.
|
| Modifier and Type | Method and Description |
|---|---|
protected FieldOfViewDetector |
create(double newMaxCheck,
double newThreshold,
int newMaxIter,
EventHandler<? super FieldOfViewDetector> newHandler)
Build a new instance.
|
double |
g(SpacecraftState s)
Compute the value of the switching function.
|
FieldOfView |
getFOV()
Get the Field Of View.
|
PVCoordinatesProvider |
getPVTarget()
Get the position/velocity provider of the target .
|
eventOccurred, getHandler, getMaxCheckInterval, getMaxIterationCount, getThreshold, init, isForward, resetState, withHandler, withMaxCheck, withMaxIter, withThresholdpublic FieldOfViewDetector(PVCoordinatesProvider pvTarget, FieldOfView fov)
The maximal interval between distance to FOV boundary checks should be smaller than the half duration of the minimal pass to handle, otherwise some short passes could be missed.
pvTarget - Position/velocity provider of the considered targetfov - Field Of Viewpublic FieldOfViewDetector(PVCoordinatesProvider pvTarget, double radiusTarget, VisibilityTrigger trigger, FieldOfView fov)
The maximal interval between distance to FOV boundary checks should be smaller than the half duration of the minimal pass to handle, otherwise some short passes could be missed.
pvTarget - Position/velocity provider of the considered targetradiusTarget - radius of the target, considered to be a spherical body (m)trigger - visibility trigger for spherical bodiesfov - Field Of Viewprotected FieldOfViewDetector create(double newMaxCheck, double newThreshold, int newMaxIter, EventHandler<? super FieldOfViewDetector> newHandler)
create in class AbstractDetector<FieldOfViewDetector>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 PVCoordinatesProvider getPVTarget()
public FieldOfView getFOV()
public double g(SpacecraftState s)
The g function value is the angular offset between the
target center and the Field Of View boundary, plus or minus the
target angular radius depending on the VisibilityTrigger, minus
the Field Of View margin. It is therefore
negative if the target is visible within the Field Of View and positive
if it is outside of the Field Of View.
As per the previous definition, when the target enters the Field Of View, a decreasing event is generated, and when the target leaves the Field Of View, an increasing event is generated.
g in interface EventDetectorg in class AbstractDetector<FieldOfViewDetector>s - the current state information: date, kinematics, attitudeCopyright © 2002-2022 CS GROUP. All rights reserved.