coverageConfig

R2026b

Coverage configuration for radar scan controller object

Since R2026b

Syntax

cfg = coverageConfig(scanner)

cfg = coverageConfig(scanner,Name=Value)

Description

cfg = coverageConfig(scanner) returns a configuration struct cfg that describes the current scan coverage of scanner (you can use this configuration structure to plot the scan coverage).

cfg = coverageConfig(scanner,Name=Value) returns a configuration struct cfg that describes the current scan coverage of scanner, with additional options specified using one or more name-value arguments.

Examples

Create Electronic Sector Scanner and Plot Coverage

Create an electronic sector scan controller that scans the azimuth sector from -30 to 30 degrees for a bistatic transmitter that has a fan beam with a 10-degree azimuth beamwidth and a 30-degree elevation beamwidth.

Define the bistatic transmitter.

freq = 300e6;
txAnt = phased.SincAntennaElement(Beamwidth=[10 30]);
txRdr = bistaticTransmitter(TransmitAntenna=phased.Radiator(Sensor=txAnt,OperatingFrequency=freq));

Create a radar scenario and position a moving platform for the bistatic transmitter.

scnro = radarScenario;
traj = kinematicTrajectory(Position=[0 10e3 0],Orientation=quaternion([-90 0 0],"eulerd","ZYX","frame"));
txPlat = platform(scnro,Trajectory=traj);

Set the scan duration to 31 pulse repetition intervals (PRIs) so the beam sweeps slowly enough to capture the full transmit antenna pattern as it traverses the receive antenna's location.

pri = 1/txRdr.Waveform.PRF;
txScnr = radarScanController("Electronic","Sector",AzimuthLimits=[-30 30],ScanDuration=31*pri)

txScnr = 
  ElectronicSectorScanner with properties:

      AzimuthLimits: [-30 30]
       ScanDuration: 0.0031
          StepAngle: 1
    DwellTimeSource: "Auto"
          ScanAngle: -30
           ScanTime: 0

Create a default coverage configuration structure using coverageConfig.

txCovCfg = coverageConfig(txScnr)

txCovCfg = struct with fields:
          Index: 1
      LookAngle: [-30 0]
    FieldOfView: [0 0]
     ScanLimits: [-30 30]
          Range: 1
       Position: [0 0 0]
    Orientation: [1×1 quaternion]

Update the default coverage configuration to include information about the bistatic transmitter and platform.

txCovCfg.Index = txPlat.PlatformID;
txCovCfg.Range = 20e3;
txCovCfg.FieldOfView = txRdr.TransmitAntenna.Sensor.Beamwidth;
txCovCfg.Position = txPlat.Position;
txCovCfg.Orientation = quaternion(txPlat.Orientation,"eulerd","ZYX","frame")

txCovCfg = struct with fields:
          Index: 1
      LookAngle: [-30 0]
    FieldOfView: [10 30]
     ScanLimits: [-30 30]
          Range: 20000
       Position: [0 10000 0]
    Orientation: [1×1 quaternion]

Plot the scan coverage using theaterPlot, coveragePlotter, and plotCoverage.

fig = figure(Name="Scan Coverage");
clf(fig);
ax = axes(fig);
tp = theaterPlot(Parent=ax,AxesUnits=["km" "km" "km"], ...
    XLimits=25e3*[-1 1],YLimits=25e3*[-1 1],ZLimits=25e3*[-1 1]);
title(ax,"Tx Scan Coverage");
view(ax,20,20);

txCovPltr = coveragePlotter(tp,DisplayName="Tx Coverage");
plotCoverage(txCovPltr,txCovCfg);

Input Arguments

scanner — Scan controller object

scan controller object

Scan controller object (MechanicalRasterScanner, MechanicalSectorScanner, ElectronicRasterScanner, or ElectronicSectorScanner) generated by radarScanController.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: cfg = coverageConfig(scanner,FieldOfView=[60,30],Range=2000)

Index — Configuration index

1 (default) | positive integer

Configuration index corresponding to the cfg "Index" field, specified as a positive integer. The default value is 1.

Data Types: double

FieldOfView — Field of view (deg)

[0 0] (default) | 2-element row vector

Field of view corresponding to the cfg "FieldOfView" field, such as the field of view of the surveillance radar, specified as a 2-element row vector, where the first element is the azimuth field of view and the second element is the elevation field of view. Units are in degrees (deg). The default value is [0 0].

Data Types: double

Range — Range (m)

1 (default) | positive scalar

Range corresponding to the cfg "Range" field, such as the maximum range of the surveillance radar, specified as a positive scalar. Units are in meters (m). The default value is 1.

Data Types: double

Output Arguments

cfg — Coverage configuration struct

struct

Coverage configuration, returned as a struct. Fields in the struct include Index, LookAngle, FieldOfView, ScanLimits, Range, Position, and Orientation.

Field	Description
Index	Configuration index, returned as an integer. The default value is 1.
LookAngle	Current scan angle (ScanAngle) of the scan controller object scanner, in units of degrees, returned as a scalar or 2-element row vector depending on the type of scan controller object.
FieldOfView	Field of view, returned as a 2-element row vector, where the MechanicalRasterScanner or ElectronicRasterScanner – 2-element row vector, where the first element is the azimuth angle and the second element is the elevation angle. MechanicalSectorScanner or ElectronicSectorScanner – Scalar azimuth angle. first element is the azimuth field of view and the second element is the elevation field of view. Units are in degrees. The default value is [0 0].
ScanLimits	Scan limits, returned as a 1-by-2 vector or 2-by-2 matrix. MechanicalRasterScanner or ElectronicRasterScanner – 2-by-2 matrix, where the first row is the azimuth limits (AzimuthLimits) and the second row is the elevation limits (ElevationLimits). MechanicalSectorScanner or ElectronicSectorScanner – 1-by-2 vector containing the azimuth limits (AzimuthLimits).
Range	Range, returned as a positive scalar. Units are in meters. The default value is 1.
Position	Origin position with respect to the global coordinate frame, returned as a 3-element row vector in the form of [x y z]. Units are in meters. The default value is [0 0 0].
Orientation	Orientation with respect to the global coordinate frame, returned as a unitless scalar quaternion. A rotation matrix, a quaternion, or three Euler angles in ZYX sequence can describe this rotation transformation. The default value is quaternion(1,0,0,0).

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

Version History

Introduced in R2026b