[python source code]

recall

The recall commands module.

These commands are used in the following models: DPO4K, DPO4KB, MDO3K, MDO4K, MDO4KB, MDO4KC, MSO4K, MSO4KB

THIS FILE IS AUTO-GENERATED, IT SHOULD NOT BE MANUALLY MODIFIED.

Please report an issue if one is found.

Commands and Queries 
- RECAll:MASK <QString>
- RECAll:SETUp {FACtory|<NR1>|<file path>}
- RECAll:SETUp:DEMO<x>
- RECAll:WAVEform <Source>, <Destination>

Recall

Bases: SCPICmdRead

The RECAll command tree.

Usage
  • Using the .query() method will send the RECAll? query.
  • Using the .verify(value) method will send the RECAll? query and raise an AssertionError if the returned value does not match value.
Properties
  • .mask: The RECAll:MASK command.
  • .setup: The RECAll:SETUp command.
  • .waveform: The RECAll:WAVEform command.

mask property 

mask: RecallMask

Return the RECAll:MASK command.

Description
  • This command recalls the mask from a specified file that was saved to the current working directory using the SAVE:MASK command. A series of examples showing how to use mask commands for typical tasks is included in an appendix.
Usage
  • Using the .write(value) method will send the RECAll:MASK value command.
SCPI Syntax 
- RECAll:MASK <QString>
Info
  • QString is a quoted string that is the name of the mask definition being recalled from the current working directory.

setup property 

setup: RecallSetup

Return the RECAll:SETUp command.

Description
  • Restores the state of the oscilloscope from a copy of the settings stored in memory. The settings are stored using the *SAV command.
Usage
  • Using the .write(value) method will send the RECAll:SETUp value command.
SCPI Syntax 
- RECAll:SETUp {FACtory|<NR1>|<file path>}
Info
  • FACtory restores the factory setup.
  • <NR1> is a value in the range from 1 to 10, which specifies a saved setup storage location.
  • <file path> specifies a location for an oscilloscope setup file. is a quoted string that defines the file name and path. Input the file path using the form ://. and one or s are optional. If you do not specify them, the oscilloscope will read the file from the default directory (see FILESYSTEM:CWD). stands for a filename; the use of wildcard characters in filenames is not supported. Filename extensions are not required, but highly recommended.
Sub-properties
  • .demo: The RECAll:SETUp:DEMO<x> command.

waveform property 

waveform: RecallWaveform

Return the RECAll:WAVEform command.

Description
  • This command (no query form) recalls a stored waveform to a reference memory location, and, for instruments with the arbitrary waveform feature, to arbitrary waveform edit memory (EMEM). Only the first waveform in a .CSV file is recalled for multiple waveform .CSV files. Recall of digital waveforms (D0 through D15) is not supported.
Usage
  • Using the .write(value) method will send the RECAll:WAVEform value command.
SCPI Syntax 
- RECAll:WAVEform <Source>, <Destination>
Info
  • <file path>
  • ARB<x> - x has a minimum of 1 and a maximum of 4.
  • <QString> is a quoted string that specifies a location for an oscilloscope file. The file name and path should be input using the form ://..
  • REF<x> - Specifies a reference memory location to receive the saved ISF or CSV data. ARB1-ARB4 cannot be recalled to reference memory locations and attempting to do so on an instrument with the arbitrary waveform feature results in an error event. x has a minimum of 1 and a maximum of 4.
  • EMEM - For instruments with the arbitrary waveform feature, specifies arbitrary waveform edit memory (EMEM). If the source is a file, the file can be either an ISF or CSV file with the following restrictions.

RecallMask

Bases: SCPICmdWrite

The RECAll:MASK command.

Description
  • This command recalls the mask from a specified file that was saved to the current working directory using the SAVE:MASK command. A series of examples showing how to use mask commands for typical tasks is included in an appendix.
Usage
  • Using the .write(value) method will send the RECAll:MASK value command.
SCPI Syntax 
- RECAll:MASK <QString>
Info
  • QString is a quoted string that is the name of the mask definition being recalled from the current working directory.

RecallSetup

Bases: SCPICmdWrite, SCPICmdRead

The RECAll:SETUp command.

Description
  • Restores the state of the oscilloscope from a copy of the settings stored in memory. The settings are stored using the *SAV command.
Usage
  • Using the .write(value) method will send the RECAll:SETUp value command.
SCPI Syntax 
- RECAll:SETUp {FACtory|<NR1>|<file path>}
Info
  • FACtory restores the factory setup.
  • <NR1> is a value in the range from 1 to 10, which specifies a saved setup storage location.
  • <file path> specifies a location for an oscilloscope setup file. is a quoted string that defines the file name and path. Input the file path using the form ://. and one or s are optional. If you do not specify them, the oscilloscope will read the file from the default directory (see FILESYSTEM:CWD). stands for a filename; the use of wildcard characters in filenames is not supported. Filename extensions are not required, but highly recommended.
Properties
  • .demo: The RECAll:SETUp:DEMO<x> command.

demo property 

demo: dict[int, RecallSetupDemoItem]

Return the RECAll:SETUp:DEMO<x> command.

Description
  • This command recalls one of up to 22 built-in demonstration setups of oscilloscope functionality. varies by model.
Usage
  • Using the .write() method will send the RECAll:SETUp:DEMO<x> command.
SCPI Syntax 
- RECAll:SETUp:DEMO<x>

RecallSetupDemoItem

Bases: ValidatedDynamicNumberCmd, SCPICmdWriteNoArguments

The RECAll:SETUp:DEMO<x> command.

Description
  • This command recalls one of up to 22 built-in demonstration setups of oscilloscope functionality. varies by model.
Usage
  • Using the .write() method will send the RECAll:SETUp:DEMO<x> command.
SCPI Syntax 
- RECAll:SETUp:DEMO<x>

RecallWaveform

Bases: SCPICmdWrite

The RECAll:WAVEform command.

Description
  • This command (no query form) recalls a stored waveform to a reference memory location, and, for instruments with the arbitrary waveform feature, to arbitrary waveform edit memory (EMEM). Only the first waveform in a .CSV file is recalled for multiple waveform .CSV files. Recall of digital waveforms (D0 through D15) is not supported.
Usage
  • Using the .write(value) method will send the RECAll:WAVEform value command.
SCPI Syntax 
- RECAll:WAVEform <Source>, <Destination>
Info
  • <file path>
  • ARB<x> - x has a minimum of 1 and a maximum of 4.
  • <QString> is a quoted string that specifies a location for an oscilloscope file. The file name and path should be input using the form ://..
  • REF<x> - Specifies a reference memory location to receive the saved ISF or CSV data. ARB1-ARB4 cannot be recalled to reference memory locations and attempting to do so on an instrument with the arbitrary waveform feature results in an error event. x has a minimum of 1 and a maximum of 4.
  • EMEM - For instruments with the arbitrary waveform feature, specifies arbitrary waveform edit memory (EMEM). If the source is a file, the file can be either an ISF or CSV file with the following restrictions.