helpers#

Helpers for Zurich Instruments.

Module Contents#

Functions#

`get_value`(→ numpy.ndarray)	Gets the value of a ZI node.
`set_value`(→ None)	Sets the value of a ZI node.
`set_values`(→ None)	Sets the value of a ZI node.
`set_vector`(→ None)	Sets the vector value of a ZI node.
`set_awg_value`(→ None)	Sets the value of a AWG module node.
`set_and_compile_awg_seqc`(→ None)	Uploads and compiles the AWG sequencer program.
`set_wave_vector`(→ None)	Sets the command table wave vector for an awg of an instrument.
`set_commandtable_data`(→ None)	Sets the commandtable JSON for an AWG.
`get_directory`(→ pathlib.Path)	Returns the LabOne directory of an AWG.
`get_src_directory`(→ pathlib.Path)	Returns the source directory of an AWG.
`get_waves_directory`(→ pathlib.Path)	Returns the waves directory of an AWG.
`write_seqc_file`(→ pathlib.Path)	Writes the contents of to the source directory
`get_waveform_table`(→ dict[int, int])	Returns a dictionary that contains the locations of
`get_readout_channel_bitmask`(→ str)	Returns a bitmask to enable readout channels.
`get_sampling_rates`(→ dict[int, int])	Returns the allowed sampling rate values.

Attributes#

logger

logger[source]#

get_value(instrument: zhinst.qcodes.base.ZIBaseInstrument, node: str) → numpy.ndarray[source]#

Gets the value of a ZI node.

Parameters:

instrument
node

Returns:

The node value.

set_value(instrument: zhinst.qcodes.base.ZIBaseInstrument, node: str, value: object) → None[source]#

Sets the value of a ZI node.

Parameters:

instrument – The instrument.
path – The node path.
value – The new node value.

set_values(instrument: zhinst.qcodes.base.ZIBaseInstrument, value: list[tuple[str, Any]]) → None[source]#

Sets the value of a ZI node.

Parameters:

instrument – The instrument.
value – The dictionary with nodes and values.

set_vector(instrument: zhinst.qcodes.base.ZIBaseInstrument, node: str, value: list | str) → None[source]#

Sets the vector value of a ZI node.

Parameters:

instrument – The instrument.
awg_index – The awg to configure.
node – The node path.
value – The new node vector value.

set_awg_value(instrument: zhinst.qcodes.base.ZIBaseInstrument, awg_index: int, node: str, value: int | str) → None[source]#

Sets the value of a AWG module node.

Parameters:

instrument – The instrument.
awg_index – The awg to configure.
node – The node path.
value – The new node value.

set_and_compile_awg_seqc(instrument: zhinst.qcodes.base.ZIBaseInstrument, awg_index: int, node: str, value: str) → None[source]#

Uploads and compiles the AWG sequencer program.

Parameters:

instrument – The ZI instrument object.
awg_index – The awg to configure.
node – The node path.
value – The seqc program.
waveforms_dict – The new waveforms for comparison.

set_wave_vector(instrument: zhinst.qcodes.base.ZIBaseInstrument, awg_index: int, wave_index: int, vector: list | str) → None[source]#

Sets the command table wave vector for an awg of an instrument.

Parameters:

instrument – The instrument.
awg_index – The index of an AWG
wave_index – The wave index.
vector – The vector value.

set_commandtable_data(instrument: zhinst.qcodes.base.ZIBaseInstrument, awg_index: int, json_data: dict[str, Any] | str) → None[source]#

Sets the commandtable JSON for an AWG.

Parameters:

instrument – The instrument
awg_index – The awg index.
json_data – The json data.

get_directory(awg: zhinst.qcodes.hdawg.AWG) → pathlib.Path[source]#

Returns the LabOne directory of an AWG.

Parameters:: awg – The HDAWG AWG object.
Returns:: The path of this directory.

get_src_directory(awg: zhinst.qcodes.hdawg.AWG) → pathlib.Path[source]#

Returns the source directory of an AWG.

Parameters:: awg – The HDAWG AWG object.
Returns:: The path to the source directory.

get_waves_directory(awg: zhinst.qcodes.hdawg.AWG) → pathlib.Path[source]#

Returns the waves directory of an AWG.

Parameters:: awg – The HDAWG AWG object.
Returns:: The path to the waves directory.

write_seqc_file(awg: zhinst.qcodes.hdawg.AWG, contents: str, filename: str) → pathlib.Path[source]#

Writes the contents of to the source directory of LabOne.

Parameters:

awg – The HDAWG AWG instance.
contents – The content to write.
filename – The name of the file.

Returns:

Returns the path which was written.

get_waveform_table(pulse_ids: list[int], pulseid_pulseinfo_dict: dict[int, dict[str, Any]]) → dict[int, int][source]#

Returns a dictionary that contains the locations of pulses in the AWG waveform table.

Parameters:

pulse_ids – The list of pulse ids.
pulseid_pulseinfo_dict – The info lookup dictionary.

Returns:

The waveform table dictionary.

get_readout_channel_bitmask(readout_channels_count: int) → str[source]#

Returns a bitmask to enable readout channels. The bitmask can be used to turn on QA for induvidual channels in startQAResult.

Parameters:: readout_channels_count – The amount of readout channels to enable. Maximum readout channels for UHFQA is 10.
Returns:: The channel bitmask.

get_sampling_rates(base_sampling_rate: float) → dict[int, int][source]#

Returns the allowed sampling rate values. See zhinst User manuals, section /DEV…./AWGS/n/TIME.

Parameters:: base_sampling_rate – The Instruments base sampling rate.
Returns:: The node value and corresponding sampling rate. e.g. {0: 2400000, 1:1200000, …} for the HDAWG.
Return type:: dict[int, int]