coverageConfig

Sensor and emitter coverage configuration

Syntax

configs = coverageConfig(sc)

configs = coverageConfig(sensors)

configs = coverageConfig(sensors,positions,orientations)

Description

configs = coverageConfig(sc) returns sensor coverage configuration structures in a tracking scenario sc.

configs = coverageConfig(sensors) returns sensor coverage configuration structures from a list of sensors and emitters.

configs = coverageConfig(sensors,positions,orientations) allows you to specify the position and orientation of the platform on which each sensor or emitter is mounted.

Examples

Obtain Coverage Configuration

Create a radar sensor and a radar emitter.

radar = monostaticRadarSensor(1,'Rotator');
emitter = radarEmitter(2);

Obtain coverage configurations based on sensor's position information.

cfg = coverageConfig({radar, emitter})

cfg=2×1 struct array with fields:
    Index
    LookAngle
    FieldOfView
    ScanLimits
    Range
    Position
    Orientation

cfg2 = coverageConfig({radar, emitter},[1000 0 0 ; 0 1000 0])

cfg2=2×1 struct array with fields:
    Index
    LookAngle
    FieldOfView
    ScanLimits
    Range
    Position
    Orientation

Input Arguments

sc — Tracking scenario

trakcingScenario object

Tracking scenario, specified as a trackingScenario object.

sensors — Sensors or emitters

sensor or emitter object | N-element cell array of sensor or emitter object

Sensors or emitters, specified as a sensor or emitter object, or an N-element cell array of sensor or emitter objects, where N is the number of sensor or emitter objects. The applicable sensor or emitter objects include fusionRadarSensor, radarEmitter, sonarSensor, sonarEmitter, irSensor, and monostaticLidarSensor.

positions — Position of sensor or emitter's platform

N-by-3 matrix of scalar

Position of sensor or emitter's platform, specified as an N-by-3 matrix of scalars. The ith row of the matrix is the [x, y, z] Cartesian coordinates of the ith sensor or emitter's platform.

orientations — Orientation of sensor or emitter's platform

N-by-1 vector of quaternion

Orientation of sensor or emitter's platform, specified as an N-by-1 vector of quaternions. The ith quaternion in the vector represents the rotation from the global or scenario frame to the ith sensor or emitter's platform frame.

Output Arguments

configs — Sensor or emitter coverage configurations

N-element array of configuration structure

Sensor or emitter coverage configurations, returned as an N-element array of configuration structures. N is the number of sensor or emitter objects specified in the sensors input. Each configuration structure contains seven fields:

Fields of configurations

Field	Description
Index	A unique integer to distinguish sensors or emitters.
LookAngle	The current boresight angles of the sensor or emitter, specified as: A scalar in degrees if scanning only in the azimuth direction. A two-element vector [azimuth; elevation] in degrees if scanning both in the azimuth and elevation directions.
FieldOfView	The field of view of the sensor or emitter, specified as a two-element vector [azimuth; elevation] in degrees.
ScanLimits	The minimum and maximum angles the sensor or emitter can scan from its Orientation. If the sensor or emitter can only scan in the azimuth direction, specify the limits as a 1-by-2 row vector [minAz, maxAz] in degrees. If the sensor or emitter can also scan in the elevation direction, specify the limits as a 2-by-2 matrix [minAz, maxAz; minEl, maxEl] in degrees.
Range	The range of the beam and coverage area of the sensor or emitter in meters.
Position	The origin position of the sensor or emitter, specified as a three-element vector [X, Y, Z] on the theater plot's axes.
Orientation	The rotation transformation from the scenario or global frame to the sensor or emitter mounting frame, specified as a rotation matrix, a quaternion, or three Euler angles in ZYX sequence.

You can use configs to plot the sensor coverage in a theaterPlot using its plotCoverage (Radar Toolbox) object function.

Note

The Index field is returned as a positive integer if the input is a sensor object, such as a fusionRadarSensor object. The Index field is returned as negative integer if the input is an emitter object, such as a radarEmitter object.