You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
(*zhinst-toolkit*), an extension of our Python API *ziPython* for high-level
15
+
instrument control.
16
+
16
17
17
-
18
18
# Status
19
19
20
-
The Zurich Instruments Labber Drivers are well tested and considered stable
21
-
enough for general usage. The interfaces may have some incompatible changes
20
+
The Zurich Instruments Labber Drivers are well tested and considered stable
21
+
enough for general usage. The interfaces may have some incompatible changes
22
22
between releases. Please check the changelog if you are upgrading.
23
23
24
24
@@ -27,56 +27,59 @@ between releases. Please check the changelog if you are upgrading.
27
27
## LabOne
28
28
29
29
As prerequisite, the LabOne software version 20.01 or later must be installed.
30
-
It can be downloaded for free at https://www.zhinst.com/labone. Follow the
31
-
installation instructions specific to your platform. Verify that you can connect
32
-
to your instrument(s) using the web interface of LabOne. If you are upgrading
33
-
from an older version, be sure to update the firmware of al your devices using
34
-
the web interface before continuing. In principle LabOne can be installed in a
35
-
remote machine, but we highly recommend to install on the local machine where
30
+
It can be downloaded for free at https://www.zhinst.com/labone. Follow the
31
+
installation instructions specific to your platform. Verify that you can connect
32
+
to your instrument(s) using the web interface of LabOne. If you are upgrading
33
+
from an older version, be sure to update the firmware of al your devices using
34
+
the web interface before continuing. In principle LabOne can be installed in a
35
+
remote machine, but we highly recommend to install on the local machine where
36
36
you intend to run the experiment.
37
37
38
38
39
39
## Labber Drivers
40
40
41
-
Download this repository as ZIP folder and unpack its content. It contains four
42
-
folders with the names *'Zurich_Instruments_XXXX'* that define the instrument
43
-
drivers. In order to make the drivers available in Labber, the folders
44
-
*'Zurich_Instruments_XXXX'* need to be copied to your *local* Labber Drivers
45
-
folder. It is located in *'C:\Users\USERNAME\Labber\Drivers'* or similar. Once
46
-
the driver folders are copied to your local Labber Drivers folder, they are
41
+
Download this repository as ZIP folder and unpack its content. It contains a set of
42
+
folders with the names *'Zurich_Instruments_XXXX'* that define the instrument
43
+
drivers. In order to make the drivers available in Labber, the folders
44
+
*'Zurich_Instruments_XXXX'* need to be copied to your *local* Labber Drivers
45
+
folder. It is located in *'C:\Users\USERNAME\Labber\Drivers'* or similar. Once
46
+
the driver folders are copied to your local Labber Drivers folder, they are
47
47
available to be selected in the *Labber Instrument Server*.
48
48
49
-
## Install `zhinst-toolkit`
49
+
## Install dependencies (e.g. `zhinst-toolkit`)
50
50
51
-
The Zurich Instruments Labber Drivers are based on the
52
-
[Zurich Instruments Toolkit](https://github.com/zhinst/zhinst-toolkit). The `zhinst-toolkit` Python package needs to be installed and available for Labber
53
-
to use. There are two ways to do this:
51
+
The Zurich Instruments Labber Drivers are based on the
52
+
[Zurich Instruments Toolkit](https://github.com/zhinst/zhinst-toolkit) and a small set of third party packages.
53
+
A complete list can be found inside the [requirements.txt](requirements.txt)[]().
54
+
There are two ways to install these dependencies:
54
55
55
56
### Using Labber's Python distribution
56
57
57
-
Labber comes with its own Python distribution that is used by default. The `zhinst-toolkit` package needs to be installed with to this Python distribution,
58
-
which is done using Labber's own `pip` package manager. It is located
59
-
(on Windows) under C:\Program Files
60
-
*'(x86)\Labber\python-labber\Scripts\pip.exe'* or similar. Use it to install `zhinst-toolkit`.
58
+
Labber comes with its own Python distribution that is used by default. The required packages needs to be installed with to this Python distribution,
59
+
which is done using Labber's own `pip` package manager. It is located
60
+
(on Windows) under C:\Program Files
61
+
*'(x86)\Labber\python-labber\Scripts\pip.exe'* or similar.
61
62
63
+
From within the unpacked project folder run:
62
64
```bash
63
-
<path to Labber Scripts folder>\pip install zhinst-toolkit
65
+
<path to Labber Scripts folder>\pip install -r requirements.txt
64
66
```
65
67
66
68
### Use your own Anaconda distribution
67
69
68
-
Alternatively, Labber can also configured to use your own Python distribution. Under *Instrument Server -> Preferences -> Advanced -> Python Distribution* you can
69
-
point Labber to a different Python distribution, for example your *Anaconda*
70
-
environment. If you chose for example you *base* Anaconda environment, install `zhinst-toolkit` like this:
70
+
Alternatively, Labber can also configured to use your own Python distribution. Under *Instrument Server -> Preferences -> Advanced -> Python Distribution* you can
71
+
point Labber to a different Python distribution, for example your *Anaconda*
72
+
environment. If you chose for example you *base* Anaconda environment, install the required packages as followed.
71
73
74
+
From within the unpacked project folder run:
72
75
```
73
76
conda activate base
74
-
pip install zhinst-toolkit
77
+
pip install -r requirements.txt
75
78
```
76
79
77
80
## Try It Out
78
81
79
-
To see if your installation was successful, try to connect to your device. Add
80
-
the instrument driver of your model to the *Instrument Server* with the serial
81
-
number (e.g. *'dev1234'*) in the *Address* field and start the instrument. If
82
-
the window turns green and no error emssage appears, you are ready to go!
82
+
To see if your installation was successful, try to connect to your device. Add
83
+
the instrument driver of your model to the *Instrument Server* with the serial
84
+
number (e.g. *'dev1234'*) in the *Address* field and start the instrument. If
85
+
the window turns green and no error emssage appears, you are ready to go!
0 commit comments