fr.cnes.sirius.patrius.assembly.models

Class SensorModel

java.lang.Object

fr.cnes.sirius.patrius.assembly.models.SensorModel

All Implemented Interfaces:

PVCoordinatesProvider, Serializable

public final class SensorModel
extends Object
implements PVCoordinatesProvider

Since:

1.2

Version:

$Id$

Author:

Thomas Trapier

See Also:

SensorProperty, Serialized Form

Description :

This class is a model for a generic sensor of the assembly : it uses a SensorProperty object. It provides computations using the tree of frames and some measures are available.

Concurrency :

not thread-safe

Concurrency comment :

the direct use of a not thread-safe Assembly makes this class not thread-safe itself

Constructor Summary

Constructors

Constructor and Description
SensorModel(Assembly assembly, String partName) Constructor for a sensor model.

Method Summary

Modifier and Type	Method and Description
void	addMaskingCelestialBody(BodyShape body) Adds a celestial body shape to consider in maskings.
void	addOwnMaskingParts(String[] partsNames) Enables the masking by the considered spacecraft's own parts, by giving the names of the parts that can cause maskings.
void	addSecondaryMaskingSpacecraft(SecondarySpacecraft spacecraft, String[] partsNames) Enables the masking by a secondary spacecraft's parts, by giving the names of the parts that can cause maskings.
double	celestialBodiesMaskingDistance(AbsoluteDate spacecraftDate, AbsoluteDate targetDate, AbstractDetector.PropagationDelayType propagationDelayType, VisibilityFromStationDetector.LinkType linkType) Computes the minimal euclidian distance to the celestial body shapes.
Assembly	getAssembly()
int	getInhibitionFieldsNumber()
PVCoordinatesProvider	getInhibitionTarget(int inhibitionFieldNumber) Returns inhibition field number #i.
double	getInhibitionTargetAngularRadius(AbsoluteDate inhibitionDate, AbsoluteDate sensorDate, int inhibitionFieldNumber, AbstractDetector.PropagationDelayType propagationDelayType) Computes the angular radius from the sensor of the main target at a date.
double	getInhibitTargetCenterToFieldAngle(AbsoluteDate date, int inhibitionFieldNumber) Computes the angular distance of the CENTER of an inhibition target to the border of the associated inhibition field at a date.
PVCoordinatesProvider	getMainTarget() Returns the main target.
double	getMainTargetAngularRadius(AbsoluteDate targetDate) Computes the angular radius from the sensor of the main target at a date.
PVCoordinatesProvider	getMaskingBody() Returns the last masking body.
String	getMaskingBodyName()
PVCoordinatesProvider	getMaskingSpacecraft() Returns the last masking spacecraft.
String	getMaskingSpacecraftName()
String	getMaskingSpacecraftPartName()
Frame	getNativeFrame(AbsoluteDate date, Frame frame) Get the native frame, i.e.
Vector3D	getNormalisedTargetVectorInSensorFrame(AbsoluteDate date) Computes the target vector at a date in the sensor's frame.
PVCoordinates	getPVCoordinates(AbsoluteDate date, Frame frame) Get the PVCoordinates of the sensor part in the selected frame.
Vector3D[]	getReferenceAxis(Frame frame, AbsoluteDate date) Computes the reference axis of the sensor in a given frame at a date
Vector3D	getSightAxis(Frame frame, AbsoluteDate date) Computes the sight axis of the sensor in a given frame at a date
double	getTargetCenterFOVAngle(AbsoluteDate targetDate) Computes the angular distance of the CENTER of the main target to the border of the main field of view at a date.
double	getTargetCenterFOVAngle(AbsoluteDate targetDate, AbsoluteDate sensorDate) Computes the angular distance of the CENTER of the main target to the border of the main field of view at sensor's reception date.
double[]	getTargetDihedralAngles(AbsoluteDate date) Computes the dihedral angles of the target at a date in the sensor's frame.
double	getTargetRefAxisAngle(AbsoluteDate date, int axisNumber)
double	getTargetRefAxisElevation(AbsoluteDate date, int axisNumber)
double	getTargetSightAxisAngle(AbsoluteDate date)
double	getTargetSightAxisElevation(AbsoluteDate date)
Vector3D	getTargetVectorInSensorFrame(AbsoluteDate targetDate) Computes the target vector at a date in the sensor's frame.
Vector3D	getTargetVectorInSensorFrame(AbsoluteDate targetDate, AbsoluteDate sensorDate) Computes the target vector in the sensor's frame.
boolean	isMainTargetInField(AbsoluteDate date) Checks if the main target at least partially is in the field of view at a date
boolean	noInhibition(AbsoluteDate date) Checks if at least an inhibition target is at least partially in its associated inhibition field at a date
void	resetProperty() Resets the sensor property features.
void	setEpsilonSignalPropagation(double epsilon) Set the epsilon for signal propagation used in #spacecraftsMaskingDistance(AbsoluteDate, PropagationDelayType, LinkType)) and #celestialBodiesMaskingDistance(AbsoluteDate) methods.
void	setMainTarget(PVCoordinatesProvider target, ApparentRadiusProvider radius) Sets the main target of the sensor property.
double	spacecraftsMaskingDistance(AbsoluteDate spacecraftDate, AbsoluteDate targetDate, AbstractDetector.PropagationDelayType propagationDelayType, VisibilityFromStationDetector.LinkType linkType) Computes the minimal euclidian distance to the spacecraft's shapes (GEOMERTY properties).
boolean	visibilityOk(AbsoluteDate date) Checks if the main target is in the field of view and no inhibition target in its inhibition field at a given date.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SensorModel

public SensorModel(Assembly assembly,
                   String partName)

Constructor for a sensor model.

Parameters:

assembly - the considered vehicle

partName - the name of the part supporting the sensor

Method Detail

resetProperty

public void resetProperty()

Resets the sensor property features. Shall be used each time the associated sensor property has been modified.

isMainTargetInField

public boolean isMainTargetInField(AbsoluteDate date)
                            throws PatriusException

Checks if the main target at least partially is in the field of view at a date

Parameters:

date - the date of the computation

Returns:

true if the main target is in the field of view at this date

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

noInhibition

public boolean noInhibition(AbsoluteDate date)
                     throws PatriusException

Checks if at least an inhibition target is at least partially in its associated inhibition field at a date

Parameters:

date - the date of the computation

Returns:

false if one of the targets is in its field

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

visibilityOk

public boolean visibilityOk(AbsoluteDate date)
                     throws PatriusException

Checks if the main target is in the field of view and no inhibition target in its inhibition field at a given date.

Parameters:

date - the date of the computation

Returns:

true if the main target is in the field of view and no inhibition target in its inhibition field.

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getTargetCenterFOVAngle

public double getTargetCenterFOVAngle(AbsoluteDate targetDate)
                               throws PatriusException

Computes the angular distance of the CENTER of the main target to the border of the main field of view at a date. The result is positive if the center of the target is in the field. Please refer the specific used field's javadoc for details.

Parameters:

targetDate - the target date of the computation (important in case of PropagationDelayType.LIGHT_SPEED!)

Returns:

the angular distance

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getTargetCenterFOVAngle

public double getTargetCenterFOVAngle(AbsoluteDate targetDate,
                                      AbsoluteDate sensorDate)
                               throws PatriusException

Computes the angular distance of the CENTER of the main target to the border of the main field of view at sensor's reception date. The result is positive if the center of the target is in the field. Please refer the specific used field's javadoc for details.

Parameters:

targetDate - target's date

sensorDate - sensor's date

Returns:

the angular distance

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getInhibitTargetCenterToFieldAngle

public double getInhibitTargetCenterToFieldAngle(AbsoluteDate date,
                                                 int inhibitionFieldNumber)
                                          throws PatriusException

Computes the angular distance of the CENTER of an inhibition target to the border of the associated inhibition field at a date. The result is positive if the center of the target is in the field. Please refer the specific used field's javadoc for details.

Parameters:

date - the date of the computation

inhibitionFieldNumber - number of the inhibition field to consider (first is 1)

Returns:

the angular distance

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getSightAxis

public Vector3D getSightAxis(Frame frame,
                             AbsoluteDate date)
                      throws PatriusException

Computes the sight axis of the sensor in a given frame at a date

Parameters:

frame - the frame of expression

date - the date of the computation

Returns:

the sight axis vector

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getReferenceAxis

public Vector3D[] getReferenceAxis(Frame frame,
                                   AbsoluteDate date)
                            throws PatriusException

Computes the reference axis of the sensor in a given frame at a date

Parameters:

frame - the frame of expression

date - the date of the computation

Returns:

the reference axis vectors

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getTargetVectorInSensorFrame

public Vector3D getTargetVectorInSensorFrame(AbsoluteDate targetDate)
                                      throws PatriusException

Computes the target vector at a date in the sensor's frame.

Parameters:

targetDate - the target computation date

Returns:

the target vector

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getTargetVectorInSensorFrame

public Vector3D getTargetVectorInSensorFrame(AbsoluteDate targetDate,
                                             AbsoluteDate sensorDate)
                                      throws PatriusException

Computes the target vector in the sensor's frame. The target position (used as source) is computed at targetDate, and the sensor position (used as receiver) is computed at sensor date. The computed vector therefore links two points that are computed at two different dates.

Parameters:

targetDate - the target date

sensorDate - the sensor date

Returns:

the target vector that links the target (at target date) and the sensor (at sensor date)

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getNormalisedTargetVectorInSensorFrame

public Vector3D getNormalisedTargetVectorInSensorFrame(AbsoluteDate date)
                                                throws PatriusException

Computes the target vector at a date in the sensor's frame. The vector is then normalised (the X, Y and Z coefficients of this vector are so the directing cosine).

Parameters:

date - the computation date

Returns:

the target vector

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getTargetDihedralAngles

public double[] getTargetDihedralAngles(AbsoluteDate date)
                                 throws PatriusException

Computes the dihedral angles of the target at a date in the sensor's frame. The array is filled with {AX, AY, AZ}.

Parameters:

date - the computation date

Returns:

the dihedral angles

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getTargetSightAxisAngle

public double getTargetSightAxisAngle(AbsoluteDate date)
                               throws PatriusException

Parameters:

date - the date of computation

Returns:

the vector angle (target - sight axis) at this date.

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getTargetRefAxisAngle

public double getTargetRefAxisAngle(AbsoluteDate date,
                                    int axisNumber)
                             throws PatriusException

Parameters:

date - the date of computation

axisNumber - the number of the reference axis for this computation (first is 1)

Returns:

the vector angle (target - reference axis) at this date.

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getTargetSightAxisElevation

public double getTargetSightAxisElevation(AbsoluteDate date)
                                   throws PatriusException

Parameters:

date - the date of computation

Returns:

the elevation angle (target - normal plane to the sight axis) at this date.

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getTargetRefAxisElevation

public double getTargetRefAxisElevation(AbsoluteDate date,
                                        int axisNumber)
                                 throws PatriusException

Parameters:

date - the date of computation

axisNumber - the number of the reference axis for this computation (first is 1)

Returns:

the elevation angle (target - normal plane to the reference axis) at this date.

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getAssembly

public Assembly getAssembly()

Returns:

the assembly of this sensor

getInhibitionFieldsNumber

public int getInhibitionFieldsNumber()

Returns:

the number of couples inhibition field / inhibition target

setMainTarget

public void setMainTarget(PVCoordinatesProvider target,
                          ApparentRadiusProvider radius)

Sets the main target of the sensor property.

Parameters:

target - the new main target center

radius - the target's radius

getMainTargetAngularRadius

public double getMainTargetAngularRadius(AbsoluteDate targetDate)
                                  throws PatriusException

Computes the angular radius from the sensor of the main target at a date.

Parameters:

targetDate - the target date of the computation (important in case of PropagationDelayType.LIGHT_SPEED!)

Returns:

the angular radius

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getInhibitionTargetAngularRadius

public double getInhibitionTargetAngularRadius(AbsoluteDate inhibitionDate,
                                               AbsoluteDate sensorDate,
                                               int inhibitionFieldNumber,
                                               AbstractDetector.PropagationDelayType propagationDelayType)
                                        throws PatriusException

Computes the angular radius from the sensor of the main target at a date.

Parameters:

inhibitionDate - the date at which the signal passes at the inhibition target

sensorDate - the date at which the sensor receives the signal

inhibitionFieldNumber - number of the inhibition field to consider (first is 1)

propagationDelayType - propagation delay type

Returns:

the angular radius

Throws:

PatriusException - if some frame transformation problem occurs (if the assembly is not linked to the tree of frame in witch the target is defined)

getPVCoordinates

public PVCoordinates getPVCoordinates(AbsoluteDate date,
                                      Frame frame)
                               throws PatriusException

Get the PVCoordinates of the sensor part in the selected frame.

Specified by:

getPVCoordinates in interface PVCoordinatesProvider

Parameters:

date - current date

frame - the frame where to define the position

Returns:

position/velocity of the body (m and m/s)

Throws:

PatriusException - if position cannot be computed in given frame : occurs if the assembly is not correctly linked to the main tree of frames.

getNativeFrame

public Frame getNativeFrame(AbsoluteDate date,
                            Frame frame)
                     throws PatriusException

Get the native frame, i.e. the raw frame in which PVCoordinates are expressed before transformation to user output frame. This native frame can be dependent on date and frame.

Specified by:

getNativeFrame in interface PVCoordinatesProvider

Parameters:

date - a date

frame - a frame

Returns:

the native frame

Throws:

PatriusException - thrown if native frame is undefined or unknown

spacecraftsMaskingDistance

public double spacecraftsMaskingDistance(AbsoluteDate spacecraftDate,
                                         AbsoluteDate targetDate,
                                         AbstractDetector.PropagationDelayType propagationDelayType,
                                         VisibilityFromStationDetector.LinkType linkType)
                                  throws PatriusException

Computes the minimal euclidian distance to the spacecraft's shapes (GEOMERTY properties). If the line between the sensor and the target intersects the shape, a negative value is returned in order to compute events detections.

Parameters:

spacecraftDate - spacecraft date

targetDate - the current target date (currently unused)

propagationDelayType - propagation delay type

linkType - link type (uplink or downlink)

Returns:

the minimal distance to the spacecraft's shapes

Throws:

PatriusException - if a problem occurs in frames transformations

celestialBodiesMaskingDistance

public double celestialBodiesMaskingDistance(AbsoluteDate spacecraftDate,
                                             AbsoluteDate targetDate,
                                             AbstractDetector.PropagationDelayType propagationDelayType,
                                             VisibilityFromStationDetector.LinkType linkType)
                                      throws PatriusException

Computes the minimal euclidian distance to the celestial body shapes. If the line between the sensor and the target intersects the shape, a negative value is returned in order to compute events detections.

Parameters:

spacecraftDate - spacecraft date

targetDate - the current target date (currently unused)

propagationDelayType - propagation delay type

linkType - link type (uplink or downlink)

Returns:

the minimal distance to the body shapes

Throws:

PatriusException - if a problem occurs in frames transformations

getMaskingSpacecraftName

public String getMaskingSpacecraftName()

Returns:

the last masking spacecraft name

getMaskingSpacecraftPartName

public String getMaskingSpacecraftPartName()

Returns:

the last masking spacecraft's part name

getMaskingBodyName

public String getMaskingBodyName()

Returns:

the last masking body number

getMaskingSpacecraft

public PVCoordinatesProvider getMaskingSpacecraft()

Returns the last masking spacecraft.

Returns:

the last masking spacecraft

getMaskingBody

public PVCoordinatesProvider getMaskingBody()

Returns the last masking body.

Returns:

the last masking body

addOwnMaskingParts

public void addOwnMaskingParts(String[] partsNames)

Enables the masking by the considered spacecraft's own parts, by giving the names of the parts that can cause maskings.

Parameters:

partsNames - the names of the considered parts

addSecondaryMaskingSpacecraft

public void addSecondaryMaskingSpacecraft(SecondarySpacecraft spacecraft,
                                          String[] partsNames)

Enables the masking by a secondary spacecraft's parts, by giving the names of the parts that can cause maskings.

Parameters:

spacecraft - the secondary masking spacecraft

partsNames - partsNames the names of the considered parts

addMaskingCelestialBody

public void addMaskingCelestialBody(BodyShape body)

Adds a celestial body shape to consider in maskings.

Parameters:

body - the celestial body shape to consider

getMainTarget

public PVCoordinatesProvider getMainTarget()

Returns the main target.

Returns:

the main target

getInhibitionTarget

public PVCoordinatesProvider getInhibitionTarget(int inhibitionFieldNumber)

Returns inhibition field number #i. Warning: no check is performed if provided number is beyond limits.

Parameters:

inhibitionFieldNumber - number of the inhibition field to consider (first is 1)

Returns:

inhibition field number #i

setEpsilonSignalPropagation

public void setEpsilonSignalPropagation(double epsilon)

Set the epsilon for signal propagation used in #spacecraftsMaskingDistance(AbsoluteDate, PropagationDelayType, LinkType)) and #celestialBodiesMaskingDistance(AbsoluteDate) methods. This epsilon (in s) directly reflect the accuracy of signal propagation (1s of accuracy = 3E8m of accuracy on distance between emitter and receiver)

Parameters:

epsilon - epsilon for signal propagation