Skip to content

zhinst/zhinst-labber

Repository files navigation

CI Coverage PyPI version License: MIT Code style: black Twitter URL

Zurich Instruments Labber Drivers

END OF LIFE

LabOne 24.10 will be the last LabOne version officially supported by the Zurich Instruments Labber drivers. After LabOne 24.10 we do no longer test and maintain the drivers.

Zurich Instruments continues to support the existing users of Labber drivers until the end of 2025.

The Zurich Instruments Labber Drivers is a python package that is able to automatically generate and update instrument drivers for all Zurich Instruments devices for the scientific measurement software Labber.

The Labber drivers are based on the Zurich Instruments Toolkit (zhinst-toolkit), a high level driver of our Python core API.

WARNING

Upgrading from zhinst-labber versions lower than 0.3 needs some special attention since version 0.3 breaks the API in many ways and measurements need to be adapted. If you need more Information on the upgrading process or need assistance feel free to contact the Zurich Instruments support at any time. ([email protected])

Status

The Zurich Instruments Labber Drivers are well tested and considered stable enough for general usage. The interfaces may have some incompatible changes between releases. Please check the changelog if you are upgrading to the latest version.

LabOne software

As a prerequisite, the LabOne software version 22.02 or later must be installed. It can be downloaded for free at https://www.zhinst.com/labone. Follow the installation instructions specific to your platform. Verify that you can connect to your instrument(s) using the web interface of LabOne. If you are upgrading from an older version, be sure to update the firmware of all Zurich Instruments devices in use by using the web interface.

In principle LabOne can be installed in a remote machine, but we highly recommend to install it on a local machine where you intend to run the experiment.

Getting Started

Labber comes with its own Python distribution that is used by default. If not specified otherwise (Preferences -> Advanced -> Python distribution) the following command needs to be executed within this distribution. (C:\Program Files\Labber\python-labber\Scripts\pip.exe or similar).

pip install zhinst-labber

The drivers for an device can now be generated using the command line interface.

For example the following command generated the driver for the Device DEV1234 inside the Labber driver folder of the ZI user.

zhinst-labber setup "C:\Users\ZI\Labber\Drivers" DEV1234 localhost

Documentation

For a full documentation see here.

Contributing

We welcome contributions by the community, either as bug reports, fixes and new code. Please use the GitHub issue tracker to report bugs or submit patches. Before developing something new, please get in contact with us.

License

This software is licensed under the terms of the MIT license. See LICENSE for more detail.