Main Content

coverageConfig

Sensor and emitter coverage configuration

Since R2021a

Description

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

example

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

example

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

example

Examples

collapse all

Create a radar sensor and a radar emitter.

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

Obtain coverage configurations based on the sensor's position information.

cfgs = coverageConfig({radar,emitter})
cfgs=2×1 struct array with fields:
    Index
    LookAngle
    FieldOfView
    ScanLimits
    Range
    Position
    Orientation

cfgs2 = coverageConfig({radar, emitter},[1000 0 0 ; 0 1000 0])
cfgs2=2×1 struct array with fields:
    Index
    LookAngle
    FieldOfView
    ScanLimits
    Range
    Position
    Orientation

Create a radar scenario and add the radar sensor and the radar emitter to the scenario.

sc = radarScenario;
plat = platform(sc);
plat.Sensors = {radar};
plat.Emitters = {emitter};

Obtain all coverage configurations in the scenario.

cfgScenario = coverageConfig(sc)
cfgScenario=2×1 struct array with fields:
    Index
    LookAngle
    FieldOfView
    ScanLimits
    Range
    Position
    Orientation

Input Arguments

collapse all

Radar scenario, specified as a radarScenario 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 radarDataGenerator and radarEmitter.

Position of sensor or emitter's platform, specified as an N-by-3 matrix of scalars in meters. 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 or the number of sensors or emitters contained in the radarScenario object sc. Each configuration structure contains seven fields:

Fields of configurations

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

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.

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

Note

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

Version History

Introduced in R2021a