findPlotter

Find plotters associated with bird’s-eye plot

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

Examples

Create Bird's-Eye Plot with Coverage Area and Detection Plotters

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

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

Clear data from the plot.

clearPlotterData(bep);

Input Arguments

bep — Bird’s-eye plot

birdsEyePlot object

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'

DisplayName — Display name of plotter to find

character vector | string scalar

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 — Tag of plotter to find

'PlotterN' (default) | character vector | string scalar

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

p — Plotters associated with input bird’s-eye plot

array of plotter objects

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

Version History

Introduced in R2017a