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

Figure contains an axes object. The axes object contains 2 objects of type line. These objects represent Radar Detections, Platforms.

Input Arguments

collapse all

Theater plot, specified as a theaterPlot object.

Name-Value 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 R2021a