commscope.ScatterPlot

Create Scatter Plot scope

Syntax

h = commscope.ScatterPlot
h = commscope.ScatterPlot('PropertyName',PropertyValue,...)

Description

commscope.ScatterPlot collects data and displays results in a Figure window. You can create a scatter plot using a default configuration or by defining properties.

h = commscope.ScatterPlot returns a scatter plot scope, h.

h = commscope.ScatterPlot('PropertyName',PropertyValue,...) returns a scatter plot scope, h, with property values set to PropertyValues. See the Properties section of this help page for valid PropertyNames.

Properties

A ScatterPlot object has the properties shown on the following table. All properties are writable except for the ones explicitly noted otherwise.

PropertyDescription
Type'Scatter Plot'. This is a read-only property.
SamplingFrequencySampling frequency of the input signal in Hz.
SamplesPerSymbolNumber of samples used to represent a symbol.
SymbolRateThe symbol rate of the input signal. This property is read-only and is automatically computed based on SamplingFrequency and SamplesPerSymbol.
MeasurementDelayThe time in seconds the scope will wait before starting to collect data.
SamplingOffsetThe number of samples skipped at each sampling point relative to the MeasurementDelay.
ConstellationExpected constellation of the input signal.
RefreshPlotThe switch that controls the plot refresh style. The choices are:
  • 'on' - The scatter plot refreshes every time the update method is called.

  • 'off' - The scatter plot does not refresh when the update method is called.

SamplesProcessedThe number of samples processed by the scope. This value does not include the discarded samples during the MeasurementDelay period. This property is read-only.
PlotSettingsPlot settings control the scatter plot figure.
  • SymbolStyle - Line style of symbols

  • SignalTrajectory - The switch to control the visibility of the signal trajectory. The choices are 'on' or 'off".

  • SignalTrajectoryStyle - Line style of signal trajectory

  • Constellation - The switch to control the visibility of the constellation points. The choices are 'on' or 'off".

  • ConstellationStyle - Line style of signal trajectory

  • Grid - The switch to control the visibility of the grid. The choices are 'on' or 'off".

Methods

A Scatter Plot has the following methods.

autoscale

This method automatically scales the plot figure so its entire contents displays.

close

This method closes the scatter plot figure.

disp

This method displays the scatter plot properties.

plot

This method creates a scatter plot figure. If a figure exists, this method updates the figure's contents.

plot(h) plots a scatter plot figure using default settings.

reset

This method resets the collected data of the scatter plot object.

reset(h) resets the collected data of the scatter plot object h. Resetting h also clears the plot and NumberOfSymbols.

update

This method updates the collected data of the scatter plot.

update(h, r) updates the collected data of the scatter plot, where h is the handle of the scatter plot object and r is the complex input data under test. This method updates the collected data and the plot (if RefreshPlot is true).

Was this topic helpful?