Main Content

clutterRegionPlotter

Create clutter region plotter

Description

plotter = clutterRegionPlotter(tp) creates a ClutterRegionPlotter object for use with the theaterPlot object tp. Use the plotClutterRegion function with ClutterRegionPlotter object to plot clutter.

example

plotter = clutterRegionPlotter(tp,Name=Value) creates a ClutterRegionPlotter object with additional options specified by one or more name-value arguments. For example, clutterRegionPlotter(DisplayName="SurfaceClutter") specifies "SurfaceClutter" as the name displayed in the legend.

Examples

collapse all

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);

Figure contains an axes object. The axes object contains an object of type patch. This object represents Clutter Regions.

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);

Figure contains an axes object. The axes object contains an object of type patch. This object represents Clutter Region.

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)

Figure contains an axes object. The axes object contains an object of type patch. This object represents Clutter Regions.

Input Arguments

collapse all

Theater plot, specified as a theaterPlot object.

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.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: DisplayName="ClutterSurface"

Plot name to display in legend, specified as a character vector or string. If you do not specify this argument, the function does not display a plot name.

Tag associated with the plotter, specified as a character vector or string. You can use the findPlotter function to identify plotters based on their tag. The default value is 'PlotterN', where N is an integer that corresponds to the Nth plotter associated with the theaterPlot.

Face alpha value for plotted regions, specified as a scalar in the range [0 1]. The same value is applied to all regions.

Face color value for all plotted regions, specified as a color string or [R,G,B] vector .

The edge alpha value of the region edges, specified as a scalar. The same alpha value is used for all regions.

Edge color for all regions, specified as a character vector of a valid color, a string scalar of a valid color, an RGB triplet, or a hexadecimal color code.

Marker symbol for patches, specified as a char.

ocirclessquare^triangle (up)
xx-markddiamondvtriangle (down)
+plusppentagram<triangle (left)
*starhhexagram>triangle (right)
.dot    

Patch marker fill color, specified as a color string or an [R, G, B] vector defining a color.

Example: [.1,.1,.1]

Patch marker edge color, specified as a color string or an [R, G, B] vector defining a color.

Example: [.1,.5,.4]

Size of patch marker, specified as a positive integer.

Show patch centers, specified as false or true.

Maximum number of clutter patches to plot, specified as a scalar.

Example: 3

Output Arguments

collapse all

Clutter regions plotter, returned as a ClutterRegionPlotter object. You can modify this object by changing its property values. The property names correspond to the name-value arguments of the clutterRegionPlotter function.

To plot clutter regions, use the plotClutterRegion function.

Version History

Introduced in R2022b