Main Content

findPlotter

Find plotters associated with bird’s-eye plot

Description

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

example

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

collapse all

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

collapse all

Bird’s-eye plot, specified as a birdsEyePlot object.

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

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.

Introduced in R2017a