Main Content


Return array of plotters associated with theater plot


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


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.


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


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.1294 0.1294 0.1294]
    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 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: '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.

Version History

Introduced in R2018b