Warning!
This is an archived version of the documentation.
It is strongly advised to use the latest version available at
https://docs.zhinst.com/zhinst-qcodes/en/latest/index.html
UHFLI¶
- class zhinst.qcodes.UHFLI(name: str, serial: str, interface: str = '1gbe', host: str = 'localhost', port: int = 8004, api: int = 6, **kwargs)¶
Bases:
zhinst.qcodes.base.ZIBaseInstrument
QCoDeS driver for the Zurich Instruments UHFLI.
Inherits from
ZIBaseInstrument
. Initializes some submodules from the device’s nodetree, a Sweeper Module Sweeper and a Data Acquisition Module DAQ.- Parameters
name (str) – The internal QCoDeS name of the instrument.
serial (str) – The device serial number, e.g. ‘dev1234’.
- Keyword Arguments
interface (str) – The interface used to connect to the device. (default: ‘1gbe’)
host (str) – Address of the data server. (default: ‘localhost’)
port (int) – Port used to connect to the data server. (default: 8004)
api (int) – Api level used for the data server. (default: 6)
- daq¶
A UHFLI-specific Data Acquisition Module.
- Type
DAQ
- sweeper¶
A UHFLI-specific Sweeper Module.
- Type
Sweeper
- awg¶
AWG Core for the UHFLI, taken from the UHFQA.
Data Acquisition Module for UHFLI¶
- class zhinst.qcodes.uhfli.DAQ(name: str, parent_instr, parent_contr)¶
Bases:
qcodes.instrument.channel.InstrumentChannel
Data Acquisition Module for the UHFLI driver.
Inherits from
InstrumentChannel
and wraps around theDAQModule
class of a from thezhinst-toolkit
.- Parameters
name (str) – The name of the DAQ submodule.
parent_instr (
qcodes.instrument.base.Instrument
) – The QCoDeS parent instrument of the InstrumentChannel.parent_contr (
zhinst.toolkit.BaseInstrument
) – The _controller of the parent instrument that is used for getting and setting parameters.
- signals¶
A list of node strings of signals that are added to the measurement and will be subscribed to before data acquisition.
- Type
list
- results¶
A dictionary with signal strings as keys and
zhinst.toolkit.control.drivers.base.daq.DAQResult
objects as values that hold all the data of the measurement result.- Type
dict
- measure(verbose: bool = True, timeout: float = 20) None ¶
Performs the measurement.
Starts a measurement and stores the result in daq.results. This method subscribes to all the paths previously added to daq.signals, then starts the measurement, waits until the measurement in finished and eventually reads the result.
- Keyword Arguments
verbose (bool) – A flag to enable or disable console output during the measurement. (default: True)
timeout (int) – The measurement will be stopped after the timeout. The valiue is given in seconds. (default: 20)
- signals_add(signal_source: str, signal_type: str = '', operation: str = 'avg', fft: bool = False, complex_selector: str = 'abs') str ¶
Add a signal to the signals list to be subscribed to during measurement.
The specified signal is added to the property signals list. On measure(), the DAQ Module subscribes to all the signal nodes in the list.
- Parameters
signal_source (str) – The source of the signal, e.g. ‘demod0’. See signals_list() for available signals.
- Keyword Arguments
signal_type (str) – The type of the signal. Depends on the given source, e.g. for demod signals the types’X’, ‘Y’, ‘R’, ‘Theta’, … are available. See signals_list({signal source}) for available signal types. (default: “”)
operation (str) – The operation that is performed on the acquired signal, e.g. the average of data points (‘avg’), the standard deviation of the signal (‘std’) or single points (‘replace’). (default: “avg”)
fft (bool) – A flag to enable the fourier transform (FFT) of the acquired signal. (default: False)
complex_selector (str) – If the FFT is enabled, this selects the complex value of the result, e.g. ‘abs’, ‘phase’, ‘real’, ‘imag’. (default: “abs”)
- Returns
A string with the exact node that will be subscribed to. Can be used as a key in the ‘results’ dict to retrieve the measurement result corresponding to this signal, e.g.
>>> signal = uhfli.daq.signal_add("demod0", "r") /dev3337/demods/0/sample.r.avg >>> uhfli.daq.measure() >>> ... >>> result = uhfli.daq.results[signal]
- signals_clear() None ¶
Resets the signal list attribute to an empty list.
- signals_list(source=None) List ¶
Returns a list of all the available signal sources for data acquisition.
- Keyword Arguments
source (str) – specifies the signal source to return signal types (default: None)
- Returns
Returns all available signal sources by default. If the keyword is specified with one of the signal sources, all the available signal types for the signal source are returned.
- trigger(trigger_source: str, trigger_type: str) None ¶
Sets the trigger signal of the DAQ Module.
This method can be used to specify the signal used to trigger the data acquisition. Use the method trigger_list() to see the available trigger signal sources and types.The trigger node can also be set directly using the module Parameter triggernode.
- Parameters
trigger_source (str) – A string that specifies the source of the trigger signal, e.g. “demod0”.
trigger_trype (str) – A string that specifies the type of the trigger signal, e.g. “trigin1”.
- trigger_list(source=None) List ¶
Returns a list of all the available signal sources for data acquisition.
- Keyword Arguments
source (str) – specifies the signal source to return signal types (default: None)
- Returns
Returns all available signal sources by default. If the keyword is specified with one of the signal sources, all the available signal types for the signal source are returned.
Sweeper Module for UHFLI¶
- class zhinst.qcodes.uhfli.Sweeper(name: str, parent_instr, parent_contr)¶
Bases:
qcodes.instrument.channel.InstrumentChannel
Sweeper Module for the UHFLI driver.
Inherits from
InstrumentChannel
and wraps around theSweeperModule
class of a from thezhinst-toolkit
.- Parameters
name (str) – The name of the Sweeper submodule.
parent_instr (
qcodes.instrument.base.Instrument
) – The QCoDeS parent instrument of the InstrumentChannel.parent_contr (
zhinst.toolkit.BaseInstrument
) – The _controller of the parent instrument that is used for getting and setting parameters.
- signals¶
A list of node strings of signals that are added to the measurement and will be subscribed to before data acquisition.
- Type
list
- results¶
A dictionary with signal strings as keys and
zhinst.toolkit.control.drivers.base.sweeper.SweeperResult
objects as values that hold all the data of the measurement result.- Type
dict
- application(application: str)¶
Sets one of the available application rpesets.
The applications are defined in the
zhinst-toolkit
. They include parameter_sweep, noise_amplitude_sweep, frequency_response_analyzer and more.- Parameters
application (str) – The keyword for the application. See available applications with application_list().
- application_list() List ¶
Lists the availbale application presets.
- Returns
A list of keywprd strings with the available applications.
- measure(verbose: bool = True, timeout: float = 20) None ¶
Performs the measurement.
Starts a measurement and stores the result in sweeper.results. This method subscribes to all the paths previously added to sweeper.signals, then starts the measurement, waits until the measurement in finished and eventually reads the result.
- Keyword Arguments
verbose (bool) – A flag to enable or disable output on the console. (default: True)
timeout (int) – The measurement will stopped after timeout. The value is given in seconds. (default: 20)
- signals_add(signal_source: str) str ¶
Adds a signal to the measurement.
The according signal node path will be generated and added to the module’s signal list attribute. The signal node will be subscribed to before measurement and the
SweeperResult
for this signal will be added as an item in the results attribute after measurement. Available signal sources can be listed using signals_list().- Parameters
signal_source (str) – A keyword string that specifies the source of the signal, e.g. “demod0”.
- Returns
The exact node string that will be subscribed to, can be used as a key in the results dict to get the measurement result to this signal.
>>> signal = uhfli.sweeper.signal_add("demod0") /dev3337/demods/0/sample.r.avg >>> uhfli.sweeper.measure() >>> ... >>> result = uhfli.sweeper.results[signal]
- signals_clear() None ¶
Resets the signal list attribute to an empty list.
- signals_list() List ¶
Lists the keywords for available signals that can be added to the measurement.
- Returns
A list of the available signals.
- sweep_parameter(param) None ¶
Sets the sweep parameter.
The parameter to sweep should be given by a keyword string. The available parameters can be listed with sweep_parameter_list().
- Parameters
param (str) – The string corresponding to the parameter to sweep during measurement.
- sweep_parameter_list() List ¶
Lists the keywords for available parameters that can be swept during the measurement.
- Returns
A list with keywords of the available sweep parameters.