[python source code]

data

The data commands module.

These commands are used in the following models: TekScopePC

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

Please report an issue if one is found.

Commands and Queries 
- DATa {INIT|SNAp}
- DATa:ENCdg {ASCIi|RIBinary|RPBinary|FPBinary|SRIbinary|SRPbinary|SFPbinary}
- DATa:ENCdg?
- DATa:FRAMESTARt <NR1>
- DATa:FRAMESTARt?
- DATa:FRAMESTOP {<NR1>|MAX}
- DATa:FRAMESTOP?
- DATa:MODe {VECtor|PIXmap}
- DATa:MODe?
- DATa:RESample <NR1>
- DATa:RESample?
- DATa:SOUrce <wfm>[<,><wfm>]
- DATa:SOUrce:AVAILable?
- DATa:SOUrce?
- DATa:STARt <NR1>
- DATa:STARt?
- DATa:STOP <NR1>
- DATa:STOP?
- DATa:WIDth <NR1>
- DATa:WIDth?
- DATa?

Data

Bases: SCPICmdWrite, SCPICmdRead

The DATa command.

Description
  • This command sets or queries the format and location of the waveform data that is transferred with the CURVE command.
Usage
  • Using the .query() method will send the DATa? query.
  • Using the .verify(value) method will send the DATa? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa value command.
SCPI Syntax 
- DATa {INIT|SNAp}
- DATa?
Info
  • INIT initializes the waveform data parameters to their factory defaults except for DATa:STOP, which isset to the current acquisition record length.
  • SNAp Sets DATa:STARt and DATa:STOP to match the current waveform cursor positions of WAVEVIEW1 CURSOR1 if these waveform cursors are currently on. If these waveform cursors are not on when the DATa SNAp command is sent, it is silently ignored and DATa:STARt and :STOP remain unchanged.
Properties
  • .encdg: The DATa:ENCdg command.
  • .framestart: The DATa:FRAMESTARt command.
  • .framestop: The DATa:FRAMESTOP command.
  • .mode: The DATa:MODe command.
  • .resample: The DATa:RESample command.
  • .source: The DATa:SOUrce command.
  • .start: The DATa:STARt command.
  • .stop: The DATa:STOP command.
  • .width: The DATa:WIDth command.

encdg property 

encdg: DataEncdg

Return the DATa:ENCdg command.

Description
  • This command sets or queries the format of outgoing waveform data. This command is equivalent to setting WFMOUTPRE:ENCDG, WFMOUTPRE:BN_FMT, and WFMOUTPRE:BYT_OR. Setting the DATa:ENGdg value causes the corresponding WFMOutpre values to be updated and vice versa.
Usage
  • Using the .query() method will send the DATa:ENCdg? query.
  • Using the .verify(value) method will send the DATa:ENCdg? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:ENCdg value command.
SCPI Syntax 
- DATa:ENCdg {ASCIi|RIBinary|RPBinary|FPBinary|SRIbinary|SRPbinary|SFPbinary}
- DATa:ENCdg?
Info
  • ASCIi specifies the ASCII representation of signed INT, FLOAT. If ASCII is the value, then :BN_Fmt and :BYT_Or are ignored. The following are the DATa and WFMOutpre parameter settings (separated by semicolons): :ENCdg = ASC ; :BN_Fmt = N/A ; :BYT_Or = N/A ; :BYT_NR = 1,2,4.
  • RIBinary specifies signed integer data-point representation, with the most significant byte transferred first. When :BYT_Nr is 1, the range from 0 through 255. When :BYT_Nr is 2,the range is from 0 to 65,535. When :BYT_Nr is 4, then the waveform being queried would return Fast Acquisition Pixmap data (if fast acq is turned on and data mode is set to pixmap). The following are the DATa and WFMOutpre parameter settings (separated by semicolons): :ENCdg = BIN ; :BN_Fmt = RI ; :BYT_Or = MSB ; :BYT_NR = 1,2.
  • RPBinary specifies the positive integer data-point representation, with the most significant byte transferred first. When :BYT_Nr is 1, the range from 0 through 255. When :BYT_Nr is 2, the range is from 0 to 65,535. The following are the DATa and WFMOutpre parameter settings (separated by semicolons): :ENCdg = BIN; :BN_Fmt = RP ; :BYT_Or = MSB ; :BYT_NR = 1,2.
  • FPBinary specifies the floating point (width = 4) data. The range is from -3.4 × 1038 to 3.4 × 1038. The center of the screen is 0. The upper limit is the top of the screen and the lower limit is the bottom of the screen. The FPBinary argument is only applicable to math waveforms or ref waveforms saved from math waveforms. The following are the DATa and WFMOutpre parameter settings (separated by semicolons): :ENCdg = BIN ; :BN_Fmt = FP ; :BYT_Or = MSB ; :BYT_NR = 4.
  • SRIbinary is the same as RIBinary except that the byte order is swapped, meaning that the least significant byte is transferred first. This format is useful when transferring data to IBM compatible PCs. The following are the DATa and WFMOutpre parameter settings (separated by semicolons): :ENCdg = BIN ; :BN_Fmt = RI ; :BYT_Or = LSB ; :BYT_NR = 1,2.
  • SRPbinary is the same as RPBinary except that the byte order is swapped, meaning that the least significant byte is transferred first. This format is useful when transferring data to PCs. The following are the DATa and WFMOutpre parameter settings (separated by semicolons): :ENCdg = BIN ; :BN_Fmt = RP ; :BYT_Or = LSB ; :BYT_NR = 1,2.
  • SFPbinary specifies floating point data in IBM PC format. The SFPbinary argument only works on math waveforms or ref waveforms saved from math waveforms. The following are the DATa and WFMOutpre parameter settings (separated by semicolons): :ENCdg = BIN ; :BN_Fmt = FP ; :BYT_Or = LSB ; :BYT_NR = 4.

framestart property 

framestart: DataFramestart

Return the DATa:FRAMESTARt command.

Description
  • This command sets or queries the starting data frame for waveform transfers. This command allows for transferring a subset of frames of a FastFrame waveform from the instrument (CURVe? query). Any value set by this command is ignored when transferring waveform data to the instrument (CURVe command).
Usage
  • Using the .query() method will send the DATa:FRAMESTARt? query.
  • Using the .verify(value) method will send the DATa:FRAMESTARt? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:FRAMESTARt value command.
SCPI Syntax 
- DATa:FRAMESTARt <NR1>
- DATa:FRAMESTARt?
Info
  • <NR1> is the first data frame that is transferred, which ranges from 1 to the number of acquired frames. Data is transferred from to DATA:FRAMESTOP or the number a acquired frames, whichever is less. If is greater than the number of acquired frames, then you will receive the last acquired frame. If no frames were acquired, then you receive the first frame which contains all nulls.

framestop property 

framestop: DataFramestop

Return the DATa:FRAMESTOP command.

Description
  • This command sets or queries the last acquisition for waveform transfer using the CURVE? query. This is only relevant when History or FastFrame acquisition modes are enabled.
Usage
  • Using the .query() method will send the DATa:FRAMESTOP? query.
  • Using the .verify(value) method will send the DATa:FRAMESTOP? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:FRAMESTOP value command.
SCPI Syntax 
- DATa:FRAMESTOP {<NR1>|MAX}
- DATa:FRAMESTOP?
Info
  • <NR1> is the last acquisition that will be transferred, which ranges from 1 to the number of History or FastFrame acquisitions. Results will be transferred from acquisitions DATa:FRAMESTARt to . If is greater than the number of acquisitions, then data will be transferred up to the last acquisition. If DATa:FRAMESTOP is less than DATa:FRAMESTARt, then only a single acquisition at DATa:FRAMESTARt is transferred.
  • MAX indicates that data is always transferred up to the last acquisition.

mode property 

mode: DataMode

Return the DATa:MODe command.

Description
  • This command sets or queries the mode for waveform data sent to returned by CURVe?. When the data mode is set as VECtor then you get the waveform sampled data. The Data width is reset to 1 or 2 instead of 4.
Usage
  • Using the .query() method will send the DATa:MODe? query.
  • Using the .verify(value) method will send the DATa:MODe? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:MODe value command.
SCPI Syntax 
- DATa:MODe {VECtor|PIXmap}
- DATa:MODe?
Info
  • VECtor sets the mode for waveform data to vector.
  • PIXmap sets the mode for waveform data to pixmap.

resample property 

resample: DataResample

Return the DATa:RESample command.

Description
  • This command sets or queries the resampling of outgoing waveform data. This command is equivalent to setting WFMOutpre:RESample. Setting the DATa:RESample value causes the corresponding WFMOutpre value to be updated and vice versa.
Usage
  • Using the .query() method will send the DATa:RESample? query.
  • Using the .verify(value) method will send the DATa:RESample? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:RESample value command.
SCPI Syntax 
- DATa:RESample <NR1>
- DATa:RESample?
Info
  • <NR1> is the resampling rate. The default value is 1, which means every sample is returned. A value of 2 returns every other sample, while a value of 3 returns every third sample, and so on.

source property 

source: DataSource

Return the DATa:SOUrce command.

Description
  • This command sets or queries the location of waveform data that is transferred from the instrument by the CURVE? Query.
Usage
  • Using the .query() method will send the DATa:SOUrce? query.
  • Using the .verify(value) method will send the DATa:SOUrce? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:SOUrce value command.
SCPI Syntax 
- DATa:SOUrce <wfm>[<,><wfm>]
- DATa:SOUrce?
Info
  • <wfm> is the location of the waveform data that will be transferred from the instrument to the controller. It can consist of CH, MATH, REF, DIGITALALL. Note that digital data is transferred as 16-bit data, with the least-significant bit representing D0, and the most-significant bit representing D15.
  • <wfm> can consist of the following.
  • CH<x> selects the specified analog channel as the source.
  • MATH<x> selects the specified reference waveform as the source. The reference number is specified by x, which ranges from 1 through 4.
  • REF<x> selects the specified reference waveform as the source. The reference number is specified by x, which ranges from 1 through 8.
  • CH<x>_D<x> selects the specified digital channel.
  • CH<x>_DAll selects the specified channel group of digital channels.
  • DIGITALALL selects digital waveforms as the source. The Digital data is transferred as 16-bit data, with the least-significant bit representing D0, and the most-significant bit representing D15. The LSB always contains D0-D7 and MSB always contains D8-D15 data.
  • CH<x>_SV_NORMal , CH<x>_SV_AVErage, CH<x>_SV_MAX_Hold, CH<x>_SV_MIN_Hold selects the specified Spectrum View waveform.
  • CH<x>_MAG_VS_TIME , CH<x>_FREQ_VS_TIME, CH<x>_PHASE_VS_TIME selects the specified RF vs. Time waveform.
  • CH<x>_SV_BASEBAND_IQ selects the specified RF baseband IQ data.
Sub-properties
  • .available: The DATa:SOUrce:AVAILable command.

start property 

start: DataStart

Return the DATa:STARt command.

Description
  • This command sets or queries the starting data point for waveform transfer. This command allows for the transfer of partial waveforms to and from the instrument.
Usage
  • Using the .query() method will send the DATa:STARt? query.
  • Using the .verify(value) method will send the DATa:STARt? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:STARt value command.
SCPI Syntax 
- DATa:STARt <NR1>
- DATa:STARt?
Info
  • <NR1> is the first data point that will be transferred, which ranges from 1 to the record length. Data will be transferred from to DATa:STOP or the record length, whichever is less. If is greater than the record length, the last data point in the record is transferred.
  • DATa:STARt and DATa:STOP are order independent. When DATa:STOP is greater than DATa:STARt, the values will be swapped internally for the CURVE? query.

stop property 

stop: DataStop

Return the DATa:STOP command.

Description
  • This command sets or queries the last data point that will be transferred when using the CURVE? query. This command allows for the transfer of partial waveforms to the controller. Changes to the record length value are not automatically reflected in the data:stop value. As record length is varied, the DATa:STOP value must be explicitly changed to ensure the entire record is transmitted. In other words, curve results will not automatically and correctly reflect increases in record length if the distance from DATa:STARt to DATa:STOP stays smaller than the increased record length.
Usage
  • Using the .query() method will send the DATa:STOP? query.
  • Using the .verify(value) method will send the DATa:STOP? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:STOP value command.
SCPI Syntax 
- DATa:STOP <NR1>
- DATa:STOP?
Info
  • <NR1> is the last data point that will be transferred, which ranges from 1 to the record length. If is greater than the record length, then data will be transferred up to the record length. If both DATa:STARt and DATa:STOP are greater than the record length, the last data point in the record is returned.

width property 

width: DataWidth

Return the DATa:WIDth command.

Description
  • This command specifies the width, in bytes per point, for waveform data transferred from the instrument via the CURVe? query. (This command is synonymous with WFMOutpre:BYT_Nr.)
Usage
  • Using the .query() method will send the DATa:WIDth? query.
  • Using the .verify(value) method will send the DATa:WIDth? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:WIDth value command.
SCPI Syntax 
- DATa:WIDth <NR1>
- DATa:WIDth?
Info
  • <NR1> is an integer that indicates the number of bytes per point for the outgoing waveform data when queried using the CURVe? command. For analog channels, NR1 can be 1 or 2.

DataEncdg

Bases: SCPICmdWrite, SCPICmdRead

The DATa:ENCdg command.

Description
  • This command sets or queries the format of outgoing waveform data. This command is equivalent to setting WFMOUTPRE:ENCDG, WFMOUTPRE:BN_FMT, and WFMOUTPRE:BYT_OR. Setting the DATa:ENGdg value causes the corresponding WFMOutpre values to be updated and vice versa.
Usage
  • Using the .query() method will send the DATa:ENCdg? query.
  • Using the .verify(value) method will send the DATa:ENCdg? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:ENCdg value command.
SCPI Syntax 
- DATa:ENCdg {ASCIi|RIBinary|RPBinary|FPBinary|SRIbinary|SRPbinary|SFPbinary}
- DATa:ENCdg?
Info
  • ASCIi specifies the ASCII representation of signed INT, FLOAT. If ASCII is the value, then :BN_Fmt and :BYT_Or are ignored. The following are the DATa and WFMOutpre parameter settings (separated by semicolons): :ENCdg = ASC ; :BN_Fmt = N/A ; :BYT_Or = N/A ; :BYT_NR = 1,2,4.
  • RIBinary specifies signed integer data-point representation, with the most significant byte transferred first. When :BYT_Nr is 1, the range from 0 through 255. When :BYT_Nr is 2,the range is from 0 to 65,535. When :BYT_Nr is 4, then the waveform being queried would return Fast Acquisition Pixmap data (if fast acq is turned on and data mode is set to pixmap). The following are the DATa and WFMOutpre parameter settings (separated by semicolons): :ENCdg = BIN ; :BN_Fmt = RI ; :BYT_Or = MSB ; :BYT_NR = 1,2.
  • RPBinary specifies the positive integer data-point representation, with the most significant byte transferred first. When :BYT_Nr is 1, the range from 0 through 255. When :BYT_Nr is 2, the range is from 0 to 65,535. The following are the DATa and WFMOutpre parameter settings (separated by semicolons): :ENCdg = BIN; :BN_Fmt = RP ; :BYT_Or = MSB ; :BYT_NR = 1,2.
  • FPBinary specifies the floating point (width = 4) data. The range is from -3.4 × 1038 to 3.4 × 1038. The center of the screen is 0. The upper limit is the top of the screen and the lower limit is the bottom of the screen. The FPBinary argument is only applicable to math waveforms or ref waveforms saved from math waveforms. The following are the DATa and WFMOutpre parameter settings (separated by semicolons): :ENCdg = BIN ; :BN_Fmt = FP ; :BYT_Or = MSB ; :BYT_NR = 4.
  • SRIbinary is the same as RIBinary except that the byte order is swapped, meaning that the least significant byte is transferred first. This format is useful when transferring data to IBM compatible PCs. The following are the DATa and WFMOutpre parameter settings (separated by semicolons): :ENCdg = BIN ; :BN_Fmt = RI ; :BYT_Or = LSB ; :BYT_NR = 1,2.
  • SRPbinary is the same as RPBinary except that the byte order is swapped, meaning that the least significant byte is transferred first. This format is useful when transferring data to PCs. The following are the DATa and WFMOutpre parameter settings (separated by semicolons): :ENCdg = BIN ; :BN_Fmt = RP ; :BYT_Or = LSB ; :BYT_NR = 1,2.
  • SFPbinary specifies floating point data in IBM PC format. The SFPbinary argument only works on math waveforms or ref waveforms saved from math waveforms. The following are the DATa and WFMOutpre parameter settings (separated by semicolons): :ENCdg = BIN ; :BN_Fmt = FP ; :BYT_Or = LSB ; :BYT_NR = 4.

DataFramestart

Bases: SCPICmdWrite, SCPICmdRead

The DATa:FRAMESTARt command.

Description
  • This command sets or queries the starting data frame for waveform transfers. This command allows for transferring a subset of frames of a FastFrame waveform from the instrument (CURVe? query). Any value set by this command is ignored when transferring waveform data to the instrument (CURVe command).
Usage
  • Using the .query() method will send the DATa:FRAMESTARt? query.
  • Using the .verify(value) method will send the DATa:FRAMESTARt? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:FRAMESTARt value command.
SCPI Syntax 
- DATa:FRAMESTARt <NR1>
- DATa:FRAMESTARt?
Info
  • <NR1> is the first data frame that is transferred, which ranges from 1 to the number of acquired frames. Data is transferred from to DATA:FRAMESTOP or the number a acquired frames, whichever is less. If is greater than the number of acquired frames, then you will receive the last acquired frame. If no frames were acquired, then you receive the first frame which contains all nulls.

DataFramestop

Bases: SCPICmdWrite, SCPICmdRead

The DATa:FRAMESTOP command.

Description
  • This command sets or queries the last acquisition for waveform transfer using the CURVE? query. This is only relevant when History or FastFrame acquisition modes are enabled.
Usage
  • Using the .query() method will send the DATa:FRAMESTOP? query.
  • Using the .verify(value) method will send the DATa:FRAMESTOP? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:FRAMESTOP value command.
SCPI Syntax 
- DATa:FRAMESTOP {<NR1>|MAX}
- DATa:FRAMESTOP?
Info
  • <NR1> is the last acquisition that will be transferred, which ranges from 1 to the number of History or FastFrame acquisitions. Results will be transferred from acquisitions DATa:FRAMESTARt to . If is greater than the number of acquisitions, then data will be transferred up to the last acquisition. If DATa:FRAMESTOP is less than DATa:FRAMESTARt, then only a single acquisition at DATa:FRAMESTARt is transferred.
  • MAX indicates that data is always transferred up to the last acquisition.

DataMode

Bases: SCPICmdWrite, SCPICmdRead

The DATa:MODe command.

Description
  • This command sets or queries the mode for waveform data sent to returned by CURVe?. When the data mode is set as VECtor then you get the waveform sampled data. The Data width is reset to 1 or 2 instead of 4.
Usage
  • Using the .query() method will send the DATa:MODe? query.
  • Using the .verify(value) method will send the DATa:MODe? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:MODe value command.
SCPI Syntax 
- DATa:MODe {VECtor|PIXmap}
- DATa:MODe?
Info
  • VECtor sets the mode for waveform data to vector.
  • PIXmap sets the mode for waveform data to pixmap.

DataResample

Bases: SCPICmdWrite, SCPICmdRead

The DATa:RESample command.

Description
  • This command sets or queries the resampling of outgoing waveform data. This command is equivalent to setting WFMOutpre:RESample. Setting the DATa:RESample value causes the corresponding WFMOutpre value to be updated and vice versa.
Usage
  • Using the .query() method will send the DATa:RESample? query.
  • Using the .verify(value) method will send the DATa:RESample? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:RESample value command.
SCPI Syntax 
- DATa:RESample <NR1>
- DATa:RESample?
Info
  • <NR1> is the resampling rate. The default value is 1, which means every sample is returned. A value of 2 returns every other sample, while a value of 3 returns every third sample, and so on.

DataSource

Bases: SCPICmdWrite, SCPICmdRead

The DATa:SOUrce command.

Description
  • This command sets or queries the location of waveform data that is transferred from the instrument by the CURVE? Query.
Usage
  • Using the .query() method will send the DATa:SOUrce? query.
  • Using the .verify(value) method will send the DATa:SOUrce? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:SOUrce value command.
SCPI Syntax 
- DATa:SOUrce <wfm>[<,><wfm>]
- DATa:SOUrce?
Info
  • <wfm> is the location of the waveform data that will be transferred from the instrument to the controller. It can consist of CH, MATH, REF, DIGITALALL. Note that digital data is transferred as 16-bit data, with the least-significant bit representing D0, and the most-significant bit representing D15.
  • <wfm> can consist of the following.
  • CH<x> selects the specified analog channel as the source.
  • MATH<x> selects the specified reference waveform as the source. The reference number is specified by x, which ranges from 1 through 4.
  • REF<x> selects the specified reference waveform as the source. The reference number is specified by x, which ranges from 1 through 8.
  • CH<x>_D<x> selects the specified digital channel.
  • CH<x>_DAll selects the specified channel group of digital channels.
  • DIGITALALL selects digital waveforms as the source. The Digital data is transferred as 16-bit data, with the least-significant bit representing D0, and the most-significant bit representing D15. The LSB always contains D0-D7 and MSB always contains D8-D15 data.
  • CH<x>_SV_NORMal , CH<x>_SV_AVErage, CH<x>_SV_MAX_Hold, CH<x>_SV_MIN_Hold selects the specified Spectrum View waveform.
  • CH<x>_MAG_VS_TIME , CH<x>_FREQ_VS_TIME, CH<x>_PHASE_VS_TIME selects the specified RF vs. Time waveform.
  • CH<x>_SV_BASEBAND_IQ selects the specified RF baseband IQ data.
Properties
  • .available: The DATa:SOUrce:AVAILable command.

available property 

available: DataSourceAvailable

Return the DATa:SOUrce:AVAILable command.

Description
  • This query returns a list of enumerations representing the source waveforms that are currently available for :CURVe? queries. This means that the waveforms have been acquired. If there are none, NONE is returned.
Usage
  • Using the .query() method will send the DATa:SOUrce:AVAILable? query.
  • Using the .verify(value) method will send the DATa:SOUrce:AVAILable? query and raise an AssertionError if the returned value does not match value.
SCPI Syntax 
- DATa:SOUrce:AVAILable?

DataSourceAvailable

Bases: SCPICmdRead

The DATa:SOUrce:AVAILable command.

Description
  • This query returns a list of enumerations representing the source waveforms that are currently available for :CURVe? queries. This means that the waveforms have been acquired. If there are none, NONE is returned.
Usage
  • Using the .query() method will send the DATa:SOUrce:AVAILable? query.
  • Using the .verify(value) method will send the DATa:SOUrce:AVAILable? query and raise an AssertionError if the returned value does not match value.
SCPI Syntax 
- DATa:SOUrce:AVAILable?

DataStart

Bases: SCPICmdWrite, SCPICmdRead

The DATa:STARt command.

Description
  • This command sets or queries the starting data point for waveform transfer. This command allows for the transfer of partial waveforms to and from the instrument.
Usage
  • Using the .query() method will send the DATa:STARt? query.
  • Using the .verify(value) method will send the DATa:STARt? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:STARt value command.
SCPI Syntax 
- DATa:STARt <NR1>
- DATa:STARt?
Info
  • <NR1> is the first data point that will be transferred, which ranges from 1 to the record length. Data will be transferred from to DATa:STOP or the record length, whichever is less. If is greater than the record length, the last data point in the record is transferred.
  • DATa:STARt and DATa:STOP are order independent. When DATa:STOP is greater than DATa:STARt, the values will be swapped internally for the CURVE? query.

DataStop

Bases: SCPICmdWrite, SCPICmdRead

The DATa:STOP command.

Description
  • This command sets or queries the last data point that will be transferred when using the CURVE? query. This command allows for the transfer of partial waveforms to the controller. Changes to the record length value are not automatically reflected in the data:stop value. As record length is varied, the DATa:STOP value must be explicitly changed to ensure the entire record is transmitted. In other words, curve results will not automatically and correctly reflect increases in record length if the distance from DATa:STARt to DATa:STOP stays smaller than the increased record length.
Usage
  • Using the .query() method will send the DATa:STOP? query.
  • Using the .verify(value) method will send the DATa:STOP? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:STOP value command.
SCPI Syntax 
- DATa:STOP <NR1>
- DATa:STOP?
Info
  • <NR1> is the last data point that will be transferred, which ranges from 1 to the record length. If is greater than the record length, then data will be transferred up to the record length. If both DATa:STARt and DATa:STOP are greater than the record length, the last data point in the record is returned.

DataWidth

Bases: SCPICmdWrite, SCPICmdRead

The DATa:WIDth command.

Description
  • This command specifies the width, in bytes per point, for waveform data transferred from the instrument via the CURVe? query. (This command is synonymous with WFMOutpre:BYT_Nr.)
Usage
  • Using the .query() method will send the DATa:WIDth? query.
  • Using the .verify(value) method will send the DATa:WIDth? query and raise an AssertionError if the returned value does not match value.
  • Using the .write(value) method will send the DATa:WIDth value command.
SCPI Syntax 
- DATa:WIDth <NR1>
- DATa:WIDth?
Info
  • <NR1> is an integer that indicates the number of bytes per point for the outgoing waveform data when queried using the CURVe? command. For analog channels, NR1 can be 1 or 2.