load_zicontrol_zibin(filename: str, column_names: List[str] = ('t', 'x', 'y', 'freq', 'dio', 'auxin0', 'auxin1')) ndarray[source]#

Load a ziBin file containing demodulator samples.

Load a ziBin file containing demodulator samples as saved by the ziControl User Interface into a numpy structured array. This is for data saved by ziControl in binary format.


Specifying a fewer names in column_names will not result in a speed-up as all data is loaded from the binary file by default.

  • filename (str) – The filename of the .ziBin file to load.

  • column_names (List[str]) – A list (or tuple) of column names to load from the CSV file. Default is to load all columns.


A numpy structured array of shape (num_points,) whose field names correspond to the field names of a ziControl demodulator sample. num_points is the number of sample points saved in the file.

Return type:



>>> import zhinst.utils
>>> sample = zhinst.utils.load_zicontrol_zibin('Freq1.ziBin')
>>> import matplotlib.plt as plt
>>> import numpy as np
>>> plt.plot(sample['t'], np.abs(sample['x'] + 1j*sample['y']))