Measurement

SCPI Commands :

EXPort:MEASurement:SELect
EXPort:MEASurement:TYPE
EXPort:MEASurement:SAVE
EXPort:MEASurement:DATA
EXPort:MEASurement:NAME

Commands in total: 5

Subgroups: 0

Direct child commands: 5

get_data() → float

# EXPort:MEASurement:DATA
value: float = driver.export.measurement.get_data()

Transfers the long term measurement data to the controlling computer. The data can be used in MATLAB, for example. The transferred data are the same as the data written to files. To set the export data format, use method RsRtx.formatPy.data.set() .

Returns:

data: List of values according to the format settings Long term data: If statistics are disabled, the current value of each long term point is returned. If statistics are enabled (method RsRtx.measurement.statistics.enable.set()) , seven values for each long term point are returned: upper peak, lower peak, RMS, standard deviation, average, number of measured results per long term point, number of waveforms per long term point. For measurement histograms, absolute values are returned. See also: ‘Result plots analysis’.

get_name() → str

# EXPort:MEASurement:NAME
value: str = driver.export.measurement.get_name()

Sets the file name and path to save the long term or measurement histogram data to.

Returns:

path: String with path and file name. The file extension defines the file format: XML, CSV, or BIN.

get_select() → ArithmeticMeasGroup

# EXPort:MEASurement:SELect
value: enums.ArithmeticMeasGroup = driver.export.measurement.get_select()

Selects the measurement for export of long term or measurement histogram data.

Returns:

select_meas: MEAS1 | MEAS2 | MEAS3 | MEAS4 | MEAS5 | MEAS6 | MEAS7 | MEAS8

get_type_py() → ExportType

# EXPort:MEASurement:TYPE
value: enums.ExportType = driver.export.measurement.get_type_py()

You can export the result data of the long term measurement, or the measurement histogram, or the track data. To export the measurement histogram, it must be enabled using method RsRtx.measurement.statistics.histogram.set() . To export the long term results, the long term measurement must be enabled using method RsRtx.measurement.ltMeas.state.set() . To export a track, the track must be enabled before. Track measurements require an option, see ‘Enable (Track) ‘.

Returns:

export_type: LONGTERM = LONGterm, HISTOGRAM = HISTogram

save() → None

# EXPort:MEASurement:SAVE
driver.export.measurement.save()

Saves the long term or measurement histogram results to the file specified using method RsRtx.export.measurement.name() . The measurement data can be exported as absolute or relative values, which is defined using method RsRtx.export.histogram.incidence() .

save_and_wait(opc_timeout_ms: int = -1) → None

# EXPort:MEASurement:SAVE
driver.export.measurement.save_and_wait()

Saves the long term or measurement histogram results to the file specified using method RsRtx.export.measurement.name() . The measurement data can be exported as absolute or relative values, which is defined using method RsRtx.export.histogram.incidence() .

Same as save, but waits for the operation to complete before continuing further. Use the RsRtx.utilities.opc_timeout_set() to set the timeout value.

Parameters:

opc_timeout_ms – Maximum time to wait in milliseconds, valid only for this call.

set_name(path: str) → None

# EXPort:MEASurement:NAME
driver.export.measurement.set_name(path = 'abc')

Sets the file name and path to save the long term or measurement histogram data to.

Parameters:

path – String with path and file name. The file extension defines the file format: XML, CSV, or BIN.

set_select(select_meas: ArithmeticMeasGroup) → None

# EXPort:MEASurement:SELect
driver.export.measurement.set_select(select_meas = enums.ArithmeticMeasGroup.IMEAS)

Selects the measurement for export of long term or measurement histogram data.

Parameters:

select_meas – MEAS1 | MEAS2 | MEAS3 | MEAS4 | MEAS5 | MEAS6 | MEAS7 | MEAS8

set_type_py(export_type: ExportType) → None

# EXPort:MEASurement:TYPE
driver.export.measurement.set_type_py(export_type = enums.ExportType.HISTogram)

You can export the result data of the long term measurement, or the measurement histogram, or the track data. To export the measurement histogram, it must be enabled using method RsRtx.measurement.statistics.histogram.set() . To export the long term results, the long term measurement must be enabled using method RsRtx.measurement.ltMeas.state.set() . To export a track, the track must be enabled before. Track measurements require an option, see ‘Enable (Track) ‘.

Parameters:

export_type – LONGTERM = LONGterm, HISTOGRAM = HISTogram