findPlotter

Return array of plotters associated with theater plot

Description

p = findPlotter(tp) returns the array of plotters associated with the theater plot, tp.

Note

In general, it is faster to use the plotters directly from the plotter creation methods of theaterPlot. Use findPlotter when it is otherwise inconvenient to use the plotter handles directly.

example

p = findPlotter(tp,Name,Value) specifies one or more Name,Value pair arguments required to match for the theater plot.

Examples

collapse all

Create a theater plot and generate detection and platform plotters. Set the value of the Tag property of the detection plotter to 'radPlot'.

tp = theaterPlot('XLim',[0, 90],'YLim',[-35, 35]);
detectionPlotter(tp,'DisplayName','Radar Detections','Tag','radPlot');
platformPlotter(tp, 'DisplayName', 'Platforms');

Use findPlotter to locate the detection plotter based on its Tag property.

radarPlotter = findPlotter(tp,'Tag','radPlot')
radarPlotter = 
  DetectionPlotter with properties:

       HistoryDepth: 0
             Marker: 'o'
         MarkerSize: 6
    MarkerEdgeColor: [0 0 0]
    MarkerFaceColor: 'none'
           FontSize: 10
        LabelOffset: [0 0 0]
    VelocityScaling: 1
                Tag: 'radPlot'
        DisplayName: 'Radar Detections'

Use the detection plotter to display the located objects.

plotDetection(radarPlotter, [30, 5, 0; 30, -20, 0; 30, 15, 0]);

Input Arguments

collapse all

Theater plot, specified as a theaterPlot 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: 'Tag','thisPlotter'

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. To match missing legend entries, specify DisplayName as ''.

Tag of plotter to find, specified as the comma-separated pair consisting of 'Tag'a character vector or string scalar. By default, plotters have a Tag property with a default value of 'PlotterN', where N is an integer that corresponds to the Nth plotter associated with the theater plot tp.

Introduced in R2018b