plotClutterRegion

R2026b

Plot clutter region in theater plot

Since R2022b

Syntax

plotClutterRegion(plotter,plotterData)

Description

plotClutterRegion(plotter,plotterData) uses the clutter region plotter to display clutter regions specified by the data plotterData.

Examples

Create Rectangular Clutter Region

Create a clutterRegionPlotter object from a theaterPlot object. Fill a clutter region data structure plotdata and then plot the region.

tp = theaterPlot;
clutrregion = clutterRegionPlotter(tp,'DisplayName','Clutter Regions');
plotdata = struct('X',[0 1 1 0],'Y',[0 0 1.5 1.5],'RegionPlotHeight',25)

plotdata = struct with fields:
                   X: [0 1 1 0]
                   Y: [0 0 1.5000 1.5000]
    RegionPlotHeight: 25

plotClutterRegion(clutrregion,plotdata);

Create Irregular Clutter Region

Create a quadrilateral clutterRegionPlotter object from a theaterPlot object. Set the clutter region data structure plotdata and then plot the region. Set an edge color and a face color.

Choose the four vertices of the quadrilateral. Set the region plot height to 25 m.

p1 = [1 4];
p2 = [5 3.5];
p3 = [3 1];
p4 = [0.9 1];
X = [p1(1) p2(1) p3(1) p4(1)];
Y = [p1(2) p2(2) p3(2) p4(2)];
tp = theaterPlot;
clutrregion = clutterRegionPlotter(tp,'DisplayName', ...
    'Clutter Region','RegionFaceColor','y', ...
    'RegionEdgeColor',[.6 .2 .3]);
plotdata = struct('X',X,'Y',Y,'RegionPlotHeight',25)

plotdata = struct with fields:
                   X: [1 5 3 0.9000]
                   Y: [4 3.5000 1 1]
    RegionPlotHeight: 25

plotClutterRegion(clutrregion,plotdata);

Create Two Adjacent Clutter Regions

Create two clutter adjacent regions.

tp = theaterPlot;
clutp = clutterRegionPlotter(tp,'DisplayName','Clutter Regions');
pd = struct('X',[0 1.1; 1 2.1; 1 2.1; 0 1.1],'Y', ...
    [-1 -1; -1 -1;1 1; 1 1],'RegionPlotHeight',20);
plotClutterRegion(clutp,pd);
view(45,30)

Input Arguments

plotter — Clutter region plotter object

ClutterRegionPlotter object

ClutterRegionPlotter object, created by the clutterRegionPlotter function.

plotterData — Plot data

N-element array of structures

Plot data, specified as a structure. You can directly create this argument by using the clutterRegionData function. To create this argument manually, specify each structure with these fields.

Field Name	Description
X	x-coordinates of region specified as a M-by-N matrix. Each column contains the x-coordinates of a different clutter region. N is the number of clutter regions.
Y	y-coordinates of region specified as a M-by-N matrix. Each column contains the y-coordinates of a different clutter region. N is the number of clutter regions.
RegionPlotHeight	Height of the clutter region, specified as a scalar. The same height applies to all regions.
PatchCenters	Patch centers, specified as a 3-by-N matrix where each column is a patch center position in scenario coordinates.

Version History

Introduced in R2022b