Keysight Technologies InfiniiVision 4000 X Series

1600 Keysight InfiniiVision 4000 X-Series Oscilloscopes Programmer's Guide
42 Synchronizing Acquisitions
#
# How it works:
#
# - The :DIGitize command is a blocking command, and thus, all
# other SCPI commands are blocked until :DIGitize is completely
# done. This includes any subsequent processing that is already
# set up, such as math and measurements.
#
# KEY POINT: However, :DIGitize does not prevent additional
# commands from being sent to the queue or cause the remote
# program to wait. For example, if your program does something
# like:
#
# KsInfiniiVisionX.write(":DIGitize")
# print("Signal acquired.\n")
#
# The "Signal acquired" message will be written immediately
# after the :DIGitize is sent, not after the acquisition and
# processing is complete.
#
# To pause the program until the :DIGitize is complete, you must
# wait for a query result after the :DIGitize. For example, in
# this case:
#
# query_result = KsInfiniiVisionX.query(":DIGitize;*OPC?")
# print("Signal acquired.\n")
#
# The "Signal acquired" message will be written after the
# acquisition and processing is complete. The *OPC? query is
# appended to :DIGitize with a semi-colon (;), which
# essentially ties it to the same thread in the parser. It is
# immediately dealt with once :DIGitize finishes and gives a "1"
# back to the program (whether the program uses it or not),
# allowing the program to move on.
#
# Other Notes:
#
# - If you DO NOT know when a trigger will occur, you should set a
# very long timeout.
#
# - The timeout should be adjusted before and after the :DIGitize
# operation, though this is not absolutely required.
#
# - A :DIGitize can be aborted with a device clear, which also
# stops the oscilloscope:
# KsInfiniiVisionX.clear()
#
# - :DIGItize disables the anti-aliasing feature (sample rate
# dither) on all InfiniiVision and InfiniiVision X-Series
# oscilloscopes.
#
# - :DIGitize temporarily blocks the front panel, and all front
# panel presses are queued until :DIGitize is done. So if you
# change the vertical scale, it will not happen until the
# acquisition is done.
#
# The exception is that the Run/Stop button on the front panel