FieldOfViewModel

Field of view detectability model

Since R2025a

Description

A FieldOfViewModel object contains a detectability model that assumes the sensor can detect targets within its field of view. The field of view is defined by azimuth, elevation, and range limits. You can use this model to define the detectability model for a CustomSensor object.

Creation

To create a FieldOfViewModel object, use the sensorDetectabilityModel function with the "field-of-view" input argument. For example:

detectabilityModel = sensorDetectabilityModel("field-of-view")

Properties

OriginPosition — Position of sensor with respect to target state reference frame

[0;0;0] (default) | 3-by-1 real column vector | 3-by-N real matrix

Position of the sensor with respect to the target state reference frame, specified as a 3-by-1 real column vector or a 3-by-N real matrix. Units are in meters.

• When specified as a 3-by-1 real column vector, OriginPosition takes the form [x;y;z].

• When specified as a 3-by-N real matrix, OriginPosition represents sequential frames. For example, if the sensor is mounted on a tower, and you know both the sensor's mounting position relative to the tower and the tower's position relative to the target frame, you can specify OriginPosition as [sensorMounting towerPosition], where sensorMounting is the sensor's mounting position relative to the tower and towerPosition is the tower's position relative to the target state's reference frame. The number of the frame, N, must be consistent across the OriginPosition and Orientation properties.

Example: [15 20 40]

Orientation — Orientation of sensor with respect to target state reference frame

eye(3) (default) | 3-by-3 real matrix | 3-by-3-by-N real matrix

Orientation of the sensor with respect to the target state reference frame, specified as a 3-by-3 real matrix or a 3-by-3-by-N real matrix. Units are in degrees.

• When specified as a 3-by-3 real matrix, the Orientation represents the sensor's orientation relative to the target state reference frame.

• When specified as a 3-by-3-by-N real matrix, the Orientation represents sequential frames. For example, if the sensor is mounted on a tower, and you know both the sensor's mounting orientation relative to the tower and the tower's orientation relative to the target frame, you can specify Orientation as cat(3,sensorMountingOrientation,towerOrientation), where sensorMountingOrientation is the sensor's orientation relative to the tower and towerOrientation is the tower's orientation relative to the target state's reference frame. The number of the frame, N, must be consistent across the OriginPosition and Orientation properties.

AzimuthLimits — Azimuth limits of field of view

[-30 30] (default) | two-element real row vector

Azimuth limits of the field of view, specified as a two-element real row vector of the form [minAzi maxAzi]. Units are in degrees.

Example: [-45 45]

ElevationLimits — Elevation limits of field of view

[-15 15] (default) | two-element real row vector

Elevation limits of the field of view, specified as a two-element real row vector of the form [minEle maxEle]. Units are in degrees.

Example: [-20 20]

RangeLimits — Range limits of field of view

[0 100] (default) | two-element nonnegative row vector

Range limits of the field of view, specified as a two-element nonnegative row vector of the form [minRng maxRng]. maxRng must be greater than minRng. Units are in meters.

Example: [0 250]

DetectionProbability — Probability of detecting target inside field of view

0.9 (default) | scalar in the range (0,1)

Probability of detecting the target inside the field of view, specified as a scalar in the range (0,1).

Example: 0.88

Version History

Introduced in R2025a