generateScript

R2026b

Generate MATLAB script to create scope with current settings

Syntax

generateScript(scope)

Description

generateScript(scope) generates a MATLAB^® script that can recreate a scope object with the current settings in the scope.

Examples

Generate Script from spectrumAnalyzer

1. Create a spectrumAnalyzer object.

   scope = spectrumAnalyzer();
   show(scope);

2. Set options in the Spectrum Analyzer. For this example, select both Spectrum and Spectrogram in the Home tab of the Spectrum Analyzer toolstrip.

   In addition, click the Spectrum drop-down arrow, and select the Max-Hold Trace and Min-Hold Trace parameters.

3. Generate a script to recreate the spectrumAnalyzer with the modified settings. Either click Generate Script from the Export drop-down in the Home tab, or enter this command in the MATLAB command prompt.

   generateScript(scope);

   A new editor window opens with code to regenerate the same scope.

   % Generated by MATLAB(R) 26.2 (R2026b) and DSP System Toolbox 26.2 (R2026b).
   % Generated on 16-Mar-2026 17:24:04 -0400.
   
   % Construct a spectrumAnalyzer object
   specScope=spectrumAnalyzer(ViewType="spectrum-and-spectrogram", ...
       PlotMaxHoldTrace=true, ...
       PlotMinHoldTrace=true, ...
       Position=[282 150 800 500]);

Generate Script from dsp.ArrayPlot

1. Create a dsp.ArrayPlot object.

   scope = dsp.ArrayPlot();
   show(scope);

2. Set options in the Array Plot. For this example, from the Measurements tab, turn on the Data Cursors. From the Scope tab, turn on Legend. Click Settings. Select Magnitude Phase Plot, and specify an x-axis label and a title.

   

3. Generate a script to recreate the dsp.ArrayPlot with the same modified settings. Either select Generate Script from the Scope tab, or enter the following in the MATLAB command prompt:

   generateScript(scope);

   A new editor window opens with code to regenerate the same scope.

   % Generated by MATLAB(R) 24.2 (R2024b) and DSP System Toolbox 24.2 (R2024b).
   % Generated on 24-Apr-2024 14:37:28 -0400.
   
   % Construct a dsp.ArrayPlot object
   arrayPlot=dsp.ArrayPlot(AxesScaling="Manual", ...
       Position=[2260 393 800 500], ...
       PlotAsMagnitudePhase=true, ...
       Title="My Array Plot", ...
       XLabel="Frequency", ...
       ShowLegend=true);
   % Cursor Measurements Configuration
   arrayPlot.CursorMeasurements.Enabled=true;
   

Generate Script from timescope

1. Create a timescope object.

   scope = timescope;
   show(scope)

2. Set options in the Time Scope. For this example, on the Scope tab, click Settings. Under Display and Labels, select Show Legend and Magnitude Phase Plot. Set the Title as well.

   

3. Generate a script to recreate the timescope with the same modified settings. Either select Generate Script from the Scope tab, or enter the following in the MATLAB command prompt:

   generateScript(scope);

   A new editor window opens with code to regenerate the same scope.

   % Generated by MATLAB(R) 26.2 (R2026b) and DSP System Toolbox 26.2 (R2026b).
   % Generated on 18-Jun-2026 14:47:07 -0400.
   
   % Construct a timescope object
   timeScope=timescope(Position=[2224 151 800 500], ...
       PlotAsMagnitudePhase=true, ...
       Title="My Time Scope", ...
       ShowLegend=true);
   

Input Arguments

scope — Scope object

scope object

Scope object whose settings you want to recreate with a script, specified as one of the following:

• spectrumAnalyzer object

• dsp.ArrayPlot object

• timescope object

• dsp.DynamicFilterVisualizer object

Version History

Introduced in R2019a

R2026b: New streamlined user interface in spectrum analyzer

The spectrum analyzer toolstrip has been reorganized into these three tabs to give you an easy and streamlined access to the scope settings.

• Home tab contains all the general settings for the spectrum and spectrogram display.

• Estimation tab contains settings that control the frequency resolution and spectral averaging.

• Measurements tab contains settings to control the various measurements supported by the scope.

R2024a: dsp.SpectrumAnalyzer System object warns

The dsp.SpectrumAnalyzer System object™ warns in R2024a. Use the spectrumAnalyzer object instead.

Update Code

No updates to your code are required except replacing instances of dsp.SpectrumAnalyzer with spectrumAnalyzer.

This table shows how the generateScript function typically uses the dsp.SpectrumAnalyzer System object and explains how to update existing code to use the spectrumAnalyzer object.

Discouraged Usage

Recommended Replacement

scope = dsp.SpectrumAnalyzer; show(scope) Make changes in the UI. Generate script. generateScript(scope); A new editor window opens with code to regenerate the same scope. % Creation Code for 'dsp.SpectrumAnalyzer'. % Generated by Spectrum Analyzer on 16-Nov-2021 11:35:13 -0500. specScope = dsp.SpectrumAnalyzer('ViewType','Spectrum and spectrogram', ... 'PlotMaxHoldTrace',true, ... 'PlotMinHoldTrace',true);

scope = spectrumAnalyzer; show(scope) Make changes in the UI. Generate script. generateScript(scope); A new editor window opens with code to regenerate the same scope. % Generated by MATLAB(R) 9.12 (R2022a) and DSP System Toolbox 9.14 (R2022a). % Generated on 16-Nov-2021 11:36:19 -0500. % Construct a spectrumAnalyzer object specScope = spectrumAnalyzer(ViewType="spectrum-and-spectrogram", ... PlotMaxHoldTrace=true, ... PlotMinHoldTrace=true);

R2022b: New support for dsp.DynamicFilterVisualizer object

Starting in R2022b, the generateScript function supports the dsp.DynamicFilterVisualizer object.

R2022a: Support for dsp.SpectrumAnalyzer object will be removed

The generateScript function will stop supporting the dsp.SpectrumAnalyzer object in a future release. Use the spectrumAnalyzer object instead.