Main Content

findPlotter

Find plotters associated with bird’s-eye plot

collapse all in page

Syntax

p = findPlotter(bep)
p = findPlotter(bep,Name,Value)

Description

p = findPlotter(bep) returns an array of plotters associated with a bird’s-eye plot.

p = findPlotter(bep,Name,Value) specifies options using one or more Name,Value pair arguments. For example, findPlotter(bep,'Tag','Plotter1') returns the plotter object whose Tag property value is 'Plotter1'.

example

Examples

collapse all

Open Live Script

Create a bird's-eye plot with an x-axis range of 0 to 90 meters and a y-axis range from –35 to 35 meters. Configure the plot to include a radar coverage area plotter and a detection plotter. Set the display names of these plotters.

bep = birdsEyePlot('XLim',[0 90],'YLim',[-35 35]);
coverageAreaPlotter(bep,'DisplayName','Radar coverage area');
detectionPlotter(bep,'DisplayName','Radar detections');

Figure contains an axes object. The axes object with xlabel X (m), ylabel Y (m) contains 2 objects of type patch, line. One or more of the lines displays its values using only markers These objects represent Radar coverage area, Radar detections.

Use findPlotter to locate the plotters by their display names.

caPlotter = findPlotter(bep,'DisplayName','Radar coverage area');
radarPlotter = findPlotter(bep,'DisplayName','Radar detections');

Plot the coverage area and detected objects.

plotCoverageArea(caPlotter,[1 0],30,0,35);
plotDetection(radarPlotter,[30 5; 30 -10; 30 15]);

Figure contains an axes object. The axes object with xlabel X (m), ylabel Y (m) contains 2 objects of type patch, line. One or more of the lines displays its values using only markers These objects represent Radar coverage area, Radar detections.

Clear data from the plot.

clearPlotterData(bep);

Figure contains an axes object. The axes object with xlabel X (m), ylabel Y (m) contains 2 objects of type patch, line. One or more of the lines displays its values using only markers These objects represent Radar coverage area, Radar detections.

Input Arguments

collapse all

Bird’s-eye plot, specified as a birdsEyePlot 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','MyBirdsEyePlots'

Display name of the plotter to find, specified as the comma-separated pair consisting of 'DisplayName' and a character vector or string scalar. DisplayName is the plotter name that appears in the legend of the bird's-eye plot. To match missing legend entries, specify DisplayName as ''.

Tag of plotter to find, specified as the comma-separated pair consisting of 'Tag' and a character vector or string scalar. By default, plotter objects have a Tag property with a default value of 'PlotterN'. N is an integer that corresponds to the Nth plotter associated with the specified birdsEyePlot object, bep.

Output Arguments

collapse all

Plotters associated with the input bird’s-eye plot, returned as an array of plotter objects.

Version History

Introduced in R2017a

See Also

Functions