Skip to main content

A TCP server to host the `python-seabreeze.cseabreeze` backend

Project description


A python TCP-Server which allows a OceanOptics Spectrometer to be connected to over a network

The purpose of this library is to allow OceanOptics spectrometers to be effectively wifi-enabled, so that data-aquisition can be handled by multiple computers (some potentially offsite), without having to fiddle with usb cords. Additionally, this opens up the possibility for open-source, web-based user interfaces to be developed for OceanOptics devices.

This package uses the seabreeze.cseabreeze backend to handle communications between the server and the spectrometer, by exposing the backend API functions to the seabreeze_server.server.SpectrometerManager object. (Alternatively, a physical spectrometer can also be emulated in software with the seatease package, but setting SpectrometerManager(emulate=True)). The TCP server is handled by the seabreeze_server.server.SeaBreezeServer class (based on the remote-object package), which exposes the SpectrometerManager object's methods and attributes to seabreeze_server.client.SeaBreezeClient instances.

Security Note

ONLY INTERACT WITH SERVERS THAT YOU TRUST. The seabreeze_server.client.Client object uses pickle.load to deserialize data and objects from the server. This process is able to execute arbitrary code on your machine. This can easily be exploited by malicious agents to compromise your system. The pickle library, and by extension python-seabreeze-server, leave it to the user to make wise decisions about what they chose to unpickle. Be smart.

Basic Use

On the server-side, connect and configure your spectrometer hardware for whatever kind of measurement you desire, then run something like:

HOST, PORT = 'your-ip', 9999
with seabreeze_server.server.SeaBreezeServer(
    (HOST, PORT),
    emulate = False
) as server:

See the socketserver.TCPServer documentation for more ideas about how to manage this server.

Then on the client-side, run something like the following:

HOST, PORT = 'your-ip', 9999
client = seabreeze_server.client.Client(HOST, PORT)

# Prints out currently plugged-in devices
    "Available Devices:\n",
    "\n".join(["%d : %s" % (i,dev)\
                for i,dev in enumerate(client.list_devices())

# Select the first spectrometer

# Set integration time to 10 ms

# Get wavelengths and intensities
wls = client.get_wavelengths()
i = client.get_intensities()

Installing (pip)

seabreeze-server is available via pip:

 $ pip install seabreeze-server

If you haven't previously installed seabreeze, you might need to do a bit of work, see 'SeaBreeze Setup' below for more details.

SeaBreeze Setup

Installing seabreeze can take some trial an error, especially on linux, make sure that after pip installing (or conda installing, whatever, you do you) you are also run the os setup script:

 $ pip install seabreeze
 $ seabreeze_os_setup

If you are still having trouble, check out the main seabreeze documentation.


For development, clone this directory, then have fun! Pro-tip: setup a python virtual environment in the main directory:

 $ python3 -m venv venv
 $ source venv/bin/activate


 (venv) $ python3 install
 (venv) $ seabreeze_os_setup

Creating source packages

 (venv) $ python3 sdist bdist_wheel

Uploading to PyPI

 (venv) $ python3 -m twine upload dist/*

See: []


The authors would like to thank Andreas Poehlmann and collaborators for creating the original python-seabreeze package, which this library depends heavily upon. His package has been indispensable to our research.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seabreeze-server-0.2.1.tar.gz (6.1 kB view hashes)

Uploaded source

Built Distributions

seabreeze_server-0.2.1-py3.7.egg (12.4 kB view hashes)

Uploaded 3 7

seabreeze_server-0.2.1-py3-none-any.whl (7.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page