History

SCPI Commands :

ACQuire:HISTory:STARt
ACQuire:HISTory:STOP
ACQuire:HISTory:CURRent
ACQuire:HISTory:TPACq
ACQuire:HISTory[:STATe]
ACQuire:HISTory:REPLay
ACQuire:HISTory:TSDate
ACQuire:HISTory:TSABsolute
ACQuire:HISTory:TSRelative
ACQuire:HISTory:TSRReference
ACQuire:HISTory:ISODate
Commands in total: 12
Subgroups: 1
Direct child commands: 11
get_current() int[source]
# ACQuire:HISTory:CURRent
value: int = driver.acquire.history.get_current()

Accesses a particular acquisition in the memory to display it, or to save it. The newest acquisition always has the index ‘0’. Older acquisitions have a negative index.

get_iso_date() str[source]
# ACQuire:HISTory:ISODate
value: str = driver.acquire.history.get_iso_date()

Returns the absolute date and time of the acquisition that is selected in history view in ISO 8601 format. The same format is used in the header of exported waveform data files. See also: method RsMxo.acquire.history.current() ) .

Returns:

date_time_abs_string: String with absolute date and time in this order: year, month, day, hour, minutes, seconds, and milliseconds.

get_replay() bool[source]
# ACQuire:HISTory:REPLay
value: bool = driver.acquire.history.get_replay()

If enabled, the replay of the history waveform sequence repeats automatically. Otherwise, the replay stops at the stop index set with method RsMxo.acquire.history.stop() .

Returns:

auto_repeat: OFF | ON

get_start() int[source]
# ACQuire:HISTory:STARt
value: int = driver.acquire.history.get_start()

Sets the index of the first (oldest) acquisition to be displayed or exported. The index is always negative.

get_state() bool[source]
# ACQuire:HISTory[:STATe]
value: bool = driver.acquire.history.get_state()

Enables the history mode and allows you to save history waveforms to file.

Returns:

state: OFF | ON

get_stop() int[source]
# ACQuire:HISTory:STOP
value: int = driver.acquire.history.get_stop()

Sets the index of the last (newest) acquisition to be displayed or exported. The newest acquisition of the complete acquisition series always has the index ‘0’.

get_tpacq() float[source]
# ACQuire:HISTory:TPACq
value: float = driver.acquire.history.get_tpacq()

Sets the display time for one acquisition. The shorter the time, the faster the replay is.

Returns:

time_per_acq: 4E-05 to 10

get_ts_absolute() str[source]
# ACQuire:HISTory:TSABsolute
value: str = driver.acquire.history.get_ts_absolute()

Returns the absolute daytime of the selected acquisition (method RsMxo.acquire.history.current() ) . For automatic parsing of the time, use method RsMxo.acquire.history.iso_date() .

Returns:

time_abs_string: String containing the time and unit

get_ts_date() str[source]
# ACQuire:HISTory:TSDate
value: str = driver.acquire.history.get_ts_date()

Returns the date of the selected acquisition (method RsMxo.acquire.history.current() ) . For automatic parsing of the time, use method RsMxo.acquire.history.iso_date() .

Returns:

date_abs_string: String parameter with acquisition date

get_ts_relative() float[source]
# ACQuire:HISTory:TSRelative
value: float = driver.acquire.history.get_ts_relative()

Returns the relative time of the current acquisition - the time difference to the newest acquisition (index = 0) . See also: method RsMxo.acquire.history.current() .

Returns:

time_relativ: -1E+26 to 1E+26

get_tsr_reference() float[source]
# ACQuire:HISTory:TSRReference
value: float = driver.acquire.history.get_tsr_reference()

Returns the relative time of the currently selected acquisition and the internal reference time (horizontal alignment) in history view in relation to the acquisition with index 0.

Returns:

time_rel_int_ref: -1E+26 to 1E+26

set_current(curr_acq_idx: int) None[source]
# ACQuire:HISTory:CURRent
driver.acquire.history.set_current(curr_acq_idx = 1)

Accesses a particular acquisition in the memory to display it, or to save it. The newest acquisition always has the index ‘0’. Older acquisitions have a negative index.

Parameters:

curr_acq_idx – -2147483648 to 0

set_replay(auto_repeat: bool) None[source]
# ACQuire:HISTory:REPLay
driver.acquire.history.set_replay(auto_repeat = False)

If enabled, the replay of the history waveform sequence repeats automatically. Otherwise, the replay stops at the stop index set with method RsMxo.acquire.history.stop() .

Parameters:

auto_repeat – OFF | ON

set_start(strt_acq_idx: int) None[source]
# ACQuire:HISTory:STARt
driver.acquire.history.set_start(strt_acq_idx = 1)

Sets the index of the first (oldest) acquisition to be displayed or exported. The index is always negative.

Parameters:

strt_acq_idx – -2147483648 to 0

set_state(state: bool) None[source]
# ACQuire:HISTory[:STATe]
driver.acquire.history.set_state(state = False)

Enables the history mode and allows you to save history waveforms to file.

Parameters:

state – OFF | ON

set_stop(stp_acq_idx: int) None[source]
# ACQuire:HISTory:STOP
driver.acquire.history.set_stop(stp_acq_idx = 1)

Sets the index of the last (newest) acquisition to be displayed or exported. The newest acquisition of the complete acquisition series always has the index ‘0’.

Parameters:

stp_acq_idx – -2147483648 to 0

set_tpacq(time_per_acq: float) None[source]
# ACQuire:HISTory:TPACq
driver.acquire.history.set_tpacq(time_per_acq = 1.0)

Sets the display time for one acquisition. The shorter the time, the faster the replay is.

Parameters:

time_per_acq – 4E-05 to 10

Cloning the Group

# Create a copy of the original group, that exists independently
history_copy = driver.acquire.history.clone()

Subgroups