Quickstart#
Eager to get started? This page gives a good introduction to zhinst-deviceutils. Follow Installation to install zhinst-deviceutils first.
Preparation#
Before you can spin up zhinst-deviceutils LabOneĀ® needs to installed and running. For a complete reference see the dedicated user manual page for your instrument(s).
Before you continue make sure a LabOneĀ® data server is running in your network and all of your devices are visible.
Session To The Data Server#
The device utils provide a set of helper functions to ease the use of commonly
used device functionallities. It can not be used as a standalone package but
rather is an addition to the LabOne python API (ziPython
).
Each function is stateless/static. This requires every device utils function
to have an argument for the data server session from ziPython
and the serial
of the device the function should be applied to.
The follwoing example shows how a call to the device utils function
shfqa.max_qubits_per_channel
could look like for the device DEVXXXX
connected to the dataserver running on localhost
.
>>> from zhinst.ziPython import ziDAQServer
>>> import zhinst.deviceutils.shfqa as shfqa_utils
>>> daq = ziDAQServer("localhost", 8004, 6)
>>> daq.connectDevice("DEVXXXX", "1GbE")
>>> shfqa_utils.max_qubits_per_channel(daq, "DEVXXXX")
16
For a complete list of all helper function provided by zhinst-deviceutils take a look at the Package Documentation