generateScript

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, enable both Spectrum and Spectrogram to be shown in the Analyzer tab of the Spectrum Analyzer toolstrip.

   

   In addition, enable Max-Hold Trace and Min-Hold Trace in the Spectrum tab.

   

   

3. Generate a script to recreate the spectrumAnalyzer with the modified settings. Either click Generate Script from the Analyzer 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) 9.12 (R2022a) and DSP System Toolbox 9.14 (R2022a).
   % Generated on 15-Nov-2021 15:24:16 -0500.
   
   % Construct a spectrumAnalyzer object
   specScope = spectrumAnalyzer(ViewType="spectrum-and-spectrogram", ...
       PlotMaxHoldTrace=true, ...
       PlotMinHoldTrace=true, ...
       Position=[184 190 742 563]);

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 Plot tab, turn on Legend and Magnitude and Phase. Click Settings and give the plot an XLabel and Title.

   

3. Generate a script to recreate the dsp.ArrayPlot with the same modified settings. Either select Generate Script from the Plot 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) 9.12 (R2022a) and DSP System Toolbox 9.14 (R2022a).
   % Generated on 8-Dec-2021 15:37:21 -0500.
   
   % Construct a dsp.ArrayPlot object
   arrayPlot = dsp.ArrayPlot(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) 9.12 (R2022a) and DSP System Toolbox 9.14 (R2022a).
   % Generated on 8-Dec-2021 15:39:35 -0500.
   
   % Construct a timescope object
   timeScope = timescope(PlotAsMagnitudePhase=true, ...
       Title="My Time Scope", ...
       ShowLegend=true);

Input Arguments

scope — Scope object

spectrumAnalyzer object | dsp.ArrayPlot object | timescope 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

Version History

Introduced in R2019a

R2022a: Support for dsp.SpectrumAnalyzer object will be removed

Not recommended starting in R2022a

The generateScript function will stop supporting the dsp.SpectrumAnalyzer object in a future release. 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);