Scopes and Data Logging

Display and record data

DSP Scopes visualize your streaming real-time data using hardware-inspired interfaces. Use measurements, cursors, triggers, and masks to visually inspect and analyze streaming data. In MATLAB^®, you can visualize streaming data using scope System objects. In Simulink^®, you can visualize signals using scope blocks or apps, or you can save data to MATLAB with the Time Scope or To Workspace blocks.

Blocks

expand all

Scopes

Array Plot	Display vectors or arrays
Display	Show value of input
Spectrum Analyzer	Display frequency spectrum
Time Scope	Display and analyze signals generated during simulation and log signal data to MATLAB
Filter Visualizer	Display magnitude and phase response of time-varying digital filters (Since R2023a)

Data Logging

To Workspace	Log data to workspace from Simulink model
Triggered To Workspace	Write input sample to MATLAB workspace when triggered
Spectrum Analyzer	Display frequency spectrum
Time Scope	Display and analyze signals generated during simulation and log signal data to MATLAB

Functions

expand all

Scopes

`timescope`	Display time-domain signals (Since R2020a)
`spectrumAnalyzer`	Display frequency spectrum of time-domain signals (Since R2022a)
`dsp.ArrayPlot`	Display vectors or arrays
`dsp.LogicAnalyzer`	Visualize, measure, and analyze transitions and states over time
`dsp.DynamicFilterVisualizer`	Display time-varying magnitude and phase response of digital filters
`dsp.MatrixViewer`	Visualize matrix data

Time Scope

`timescope`	Display time-domain signals (Since R2020a)
`TimeScopeConfiguration`	Control Scope block appearance and behavior
`generateScript`	Generate MATLAB script to create scope with current settings
`printToFigure`	Print scope window to MATLAB figure (Since R2023b)

Spectrum Analyzer

`spectrumAnalyzer`	Display frequency spectrum of time-domain signals (Since R2022a)
`SpectrumAnalyzerBlockConfiguration`	Configure Spectrum Analyzer block
`isNewDataReady`	Check spectrum analyzer for new data
`generateScript`	Generate MATLAB script to create scope with current settings
`getSpectrumData`	Save spectrum data shown in spectrum analyzer
`getSpectralMaskStatus`	Get test results of current spectral mask
`getMeasurementsData`	Get the current measurement data displayed on the spectrum analyzer
`printToFigure`	Print scope window to MATLAB figure (Since R2023b)

Logic Analyzer

`dsp.LogicAnalyzer`	Visualize, measure, and analyze transitions and states over time
`addCursor`	Add cursor to Logic Analyzer
`addDivider`	Add divider to Logic Analyzer
`addWave`	Add wave to Logic Analyzer
`deleteCursor`	Delete Logic Analyzer cursor
`deleteDisplayChannel`	Delete Logic Analyzer channel
`getCursorInfo`	Return settings for Logic Analyzer cursor
`getCursorTags`	Return all Logic Analyzer cursor tags
`getDisplayChannelInfo`	Return settings for Logic Analyzer display channel
`getDisplayChannelTags`	Return all Logic Analyzer display channel tags
`modifyCursor`	Modify properties of Logic Analyzer cursor
`modifyDisplayChannel`	Modify properties of Logic Analyzer display channel
`moveDisplayChannel`	Move position of Logic Analyzer display channel

Array Plot

`dsp.ArrayPlot`	Display vectors or arrays
`generateScript`	Generate MATLAB script to create scope with current settings
`printToFigure`	Print scope window to MATLAB figure (Since R2023b)

Matrix Viewer

`dsp.MatrixViewer`	Visualize matrix data
`setCursorDataLabels`	Customize data labels for cursor measurements

Dynamic Filter Visualizer

`dsp.DynamicFilterVisualizer`	Display time-varying magnitude and phase response of digital filters
`step`	Display time-varying magnitude response
`printToFigure`	Print scope window to MATLAB figure (Since R2023b)

Logging

dsp.SignalSink Log simulation data in buffer

Apps

Logic Analyzer

Visualize, measure, and analyze transitions and states over time

Topics

Scope Configuration

Control Scope Blocks Programmatically (Simulink)
This example shows how to control scopes with programming scripts.
Common Scope Block Tasks
Step-by-step procedures of common scope tasks, including logging data, sharing scope images, and display manipulation.
Configure Spectrum Analyzer
Customize Spectrum Analyzer properties, set up spectral masks, and use measurement tools.
Configure Array Plot
Customize Array Plot properties and use measurement tools.
Configure Filter Visualizer
Customize Filter Visualizer properties and use measurement tools.
Configure Time Scope Block
Customize scope properties and use measurement tools.
Configure Time Scope MATLAB Object
Customize timescope properties and use measurement tools.
Configure Logic Analyzer
Adjust setting in the Logic Analyzer.

Scope Workflows

Display Time-Domain Data
Display signals in the time domain.
Display Frequency-Domain Data in Spectrum Analyzer
This example shows how you can use a Spectrum Analyzer block to display the frequency content of two frame-based signals simultaneously.
Visualize Central Limit Theorem in Array Plot
This example shows how to use and configure the dsp.ArrayPlot System object™ to visualize the Central Limit Theorem.
Inspect and Measure Transitions Using the Logic Analyzer
Learn the basics of the Logic Analyzer.
Time Scope Measurements
This example shows how to measure performance characteristics of a pulse width modulated sinusoid.
Spectrum Analyzer Measurements
This example shows you how to use the Spectrum Analyzer block for harmonic distortion measurements (such as THD, SNR, SINAD, and SFDR), third-order intermodulation (TOI) distortion measurements, and adjacent channel power ratio (ACPR) measurements.
Use Peak Finder to Find Heart Rate from ECG Input
This example shows how to use the Time Scope Peak Finder panel to measure the heart rate from an ECG.
Obtain Measurements Data Programmatically for spectrumAnalyzer object
Obtain measurements data from spectrumAnalyzer object.
Obtain Measurements Data Programmatically for Spectrum Analyzer Block
Obtain measurements data from Spectrum Analyzer block.

Data Logging

Sample- and Frame-Based Concepts
Explore basic signal concepts in the context of a Simulink model. Learn more about sample-based processing and frame-based processing.
Save Signal Data Using Signal Logging (Simulink)
Capture signal data from a simulation by marking signals you want to log in the model.
Common Scope Block Tasks
Step-by-step procedures of common scope tasks, including logging data, sharing scope images, and display manipulation.
Import and Export Signals for Sample-Based Processing
Import signals from the MATLAB workspace into your DSP model and export signals from your signal processing model to the MATLAB workspace. The signals are configured for sample-based processing.
Import and Export Signals for Frame-Based Processing
Import signals from the MATLAB workspace into your signal processing model and export signals from your signal processing model to the MATLAB workspace. The signals are created for frame-based processing.

Related Information

Plot Array on Android Device

Featured Examples

Time Scope Measurements

Measure performance characteristics of a pulse width modulated sinusoid. The example contains a model, which you can modify to view the effects of parameter changes on rise time, fall time, overshoot, undershoot, pulse width, pulse period, and duty cycle measurements. The example also models a rising edge trigger and you can perform basic statistical operations (mean, median, RMS, maximum, minimum) and measure the frequency and period of the pulse period via cursors and peak finding.

Open Model

Spectrum Analyzer Measurements

Use the Spectrum Analyzer block for harmonic distortion measurements (such as THD, SNR, SINAD, and SFDR), third-order intermodulation (TOI) distortion measurements, and adjacent channel power ratio (ACPR) measurements. The example also shows you how to view time-varying spectra by using a spectrogram and automatic peak detection. The example includes five amplifier models, with each model representing a typical setup to perform one of the measurements.

Open Model