configure_scope#

configure_scope(daq: ziDAQServer, device_id: str, *, input_select: dict, num_samples: int, trigger_input: str, num_segments: int = 1, num_averages: int = 1, trigger_delay: float = 0.0) → None[source]#

Configures the scope for a measurement.

Parameters:

  • daq (ziDAQServer) – Instance of a Zurich Instruments API session connected to a Data Server. The device with identifier device_id is assumed to already be connected to this instance.

  • device_id (str) – SHFQA device identifier, e.g. dev12004 or ‘shf-dev12004’.

  • input_select (dict) – Keys (int) map a specific scope channel with a signal source (str), e.g. “channel0_signal_input”. For a list of available values use daq.help(f”/{device_id}/scopes/0/channels/0/inputselect”).

  • num_samples (int) – Number of samples in the scope shot.

  • trigger_input (str) – Specifies the trigger source of the scope acquisition - if set to None, the self-triggering mode of the scope becomes active, which is useful e.g. for the GUI. For a list of available trigger values use daq.help(f”/{device_id}/scopes/0/trigger/channel”).

  • num_segments (int) – Number of distinct scope shots to be returned after ending the acquisition.

  • num_averages (int) – Specifies how many times each segment should be averaged on hardware; to finish a scope acquisition, the number of issued triggers must be equal to num_segments * num_averages.

  • trigger_delay (float) – Delay in samples specifying the time between the start of data acquisition and reception of a trigger.

Return type:

None