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| Modifier | Constructor and Description |
|---|---|
protected |
FieldOfViewDetector(AdaptableInterval maxCheck,
double threshold,
int maxIter,
EventHandler handler,
PVCoordinatesProvider pvTarget,
double radiusTarget,
VisibilityTrigger trigger,
FieldOfView fov)
Protected constructor with full parameters.
|
|
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(AdaptableInterval newMaxCheck,
double newThreshold,
int newMaxIter,
EventHandler 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 .
|
getHandler, getMaxCheckInterval, getMaxIterationCount, getThreshold, init, isForward, withHandler, withMaxCheck, 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(AdaptableInterval maxCheck, double threshold, int maxIter, EventHandler handler, PVCoordinatesProvider pvTarget, double radiusTarget, VisibilityTrigger trigger, FieldOfView fov)
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 occurrencespvTarget - 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(AdaptableInterval newMaxCheck, double newThreshold, int newMaxIter, EventHandler 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-2023 CS GROUP. All rights reserved.