teraflash-ctrl 1.4.0

This Python package allows the configuration and readout of the TeraFlash Pro THz spectrometer.

TeraFlash Pro Python Package

This code is developed by the University of Bern and is no official product of Toptica Photonics AG.
This Python Package allows the configuration and readout of the TeraFlash Pro THz spectrometer.
The TCP communication protocol is probably incomplete and features may be missing as it was reverse engineered using wireshark. The scanning stage is not supported but a list of other features is.

This is a simple library with no persistence settings (the configurations of the previous run will not be stored when the python session is closed). A complete GUI written in Rust is also available here.

Features:

• Select begin time for the time window
• Select range
• Select average
• Start/Stop Laser
• Start/Stop Emitters
• Start/Stop Acquisition
• Set transmission
• Set motion mode
• Set channel
• Get status
• Get data (time domain and frequency domain)
• auto pulse detection function
• Set antenna range
• ...

I. Installation

Download the latest release or the current state as a zip archive, move it into your working directory and then run:

pip install teraflash-ctrl-python-v1.4.0.zip

for the latest version or

pip install teraflash-ctrl-python-main.zip

for the current state of the main branch to install the package for your virtual python environment or system-wide.

II. Taking a measurement

When connected to the device, you can turn on the laser and then the emitter. After starting the acquisition, new data should be continuously updated and the most recent dataset can be obtained using device.get_data():

from teraflash import TeraFlash

if __name__ == "__main__":
    ip = "169.254.84.101"
    with TeraFlash(ip) as device:
        print(device.get_status())
        device.set_laser(True)
        device.set_emitter(1, True)
        device.set_acq_start()
        print(device.get_data())

Always use the context manager to ensure that the connection is properly closed upon exiting!
Consult the example.py for usage.

Disclaimer: This package is provided on a best effort basis with no guarantee as to the functionality and correctness. Use at your own risk. Users are encouraged to contribute by submitting issues and/or pull requests for bug reporting or feature requests.

Copyright (c) 2026 University of Bern, Space Research & Planetary Sciences, Linus Leo Stöckli.

This work is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License. To view a copy of this license, visit https://creativecommons.org/licenses/by-nc/4.0/