Main Content

coverageConfig

Sensor and emitter coverage configuration

Description

example

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

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

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

Examples

collapse all

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

collapse all

Tracking scenario, specified as a trackingScenario 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 monostaticRadarSensor, radarSensor, radarEmitter, sonarSensor, sonarEmitter, irSensor, and monostaticLidarSensor.

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.

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

collapse all

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

FieldDescription
Index A unique integer to distinguish sensors or emitters. In practice, you can use SensorIndex or EmitterIndex of the sensor or emitter objects, respectively.
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.

FieldOfViewThe 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.

RangeThe range of the beam and coverage area of the sensor or emitter in meters.
PositionThe origin position of the sensor or emitter, specified as a three-element vector [X, Y, Z] on the theater plot's axes.
OrientationThe 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.

Introduced in R2020a