Skip to main content

Python interface module for Ocean Optics spectrometers. This software is not associated with Ocean Optics. Use it at your own risk.

Project description

Python module for Ocean Optics spectrometers

Conda (channel only) PyPI AppVeyor Travis Github All Releases PyPI - Downloads MIT license GitHub issues Github Sponsors

Python-seabreeze is the easy way to access your Ocean Optics spectrometers from python. It wraps the SeaBreeze library provided by Ocean Optics to communicate with the spectrometer. It also provides a pyUSB based reimplementation of SeaBreeze for easy extension. This software is not associated with Ocean Optics. Use it at your own risk.

DOCUMENTATION ON RTD

You'll find the documentation and more detailed information here https://python-seabreeze.readthedocs.io/en/latest/

Changes

The changelog can be found here CHANGELOG.md

Install

# via pypi
pip install seabreeze
seabreeze_os_setup

or

# via conda
conda install -c conda-forge seabreeze
seabreeze_os_setup

Usage

The following example shows how simple it is to acquire a spectrum with python-seabreeze through the model independent Spectrometer class. For a more detailed description read the documentation:

>>> from seabreeze.spectrometers import Spectrometer
>>> spec = Spectrometer.from_first_available()
>>> spec.integration_time_micros(20000)
>>> spec.wavelengths()
array([  340.32581   ,   340.70321186,   341.08058305, ...,  1024.84940994,
        1025.1300678 ,  1025.4106617 ])
>>> spec.intensities()
array([  1.58187931e+01,   2.66704852e+04,   6.80208103e+02, ...,
         6.53090172e+02,   6.35011552e+02,   6.71168793e+02])

To use the pyseabreeze backend (requires pyusb) simply run this before importing seabreeze.spectrometers.

>>> import seabreeze
>>> seabreeze.use('pyseabreeze')
>>> import seabreeze.spectrometers as sb

Supported Devices

Spectrometer cseabreeze pyseabreeze
HR2000 x x
HR2000PLUS x x
HR4000 x x
JAZ x x
MAYA2000 x x
MAYA2000PRO x x
MAYALSL x x
NIRQUEST256 x x
NIRQUEST512 x x
QE65000 x x
QE-PRO x x
STS x x
TORUS x x
USB2000 x x
USB2000PLUS x x
USB4000 x x
USB650 Issue #47
SPARK x x

Known Issues

  • USB2000 spectrometers cause Data transfer error due to old firmware Issue #48
  • USB650 not supported Issue #47
  • No conda packages for armv6 (RPI version 1) Issue #46

Contributing Guidelines

If you run into any problems, file an issue and be sure to include the following in your report:

  • Operating system (Linux distribution, Windows version, OSX version) and archictecture (32bit, 64bit, arm)
  • Python version and arch (i.e. Python 2.7.10 64bit)
  • python-seabreeze version

If you want a feature implemented, please file an issue, or create a pull request when you implement it yourself. And if you would like to support me via paypal, click on the paypal donate button on top of this README.

License

Files in this repository are released under the MIT license.

Related Repositories

If you want me to add your project here, let me know. Happy to add it.

Project details


Download files

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

Files for seabreeze, version 1.3.0
Filename, size File type Python version Upload date Hashes
Filename, size seabreeze-1.3.0-cp27-cp27m-macosx_10_6_intel.whl (1.8 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp27-cp27m-manylinux1_i686.whl (7.2 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp27-cp27m-manylinux1_x86_64.whl (7.5 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp27-cp27mu-manylinux1_i686.whl (7.2 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp27-cp27mu-manylinux1_x86_64.whl (7.5 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp27-cp27m-win32.whl (376.3 kB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp27-cp27m-win_amd64.whl (477.4 kB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp35-cp35m-macosx_10_6_intel.whl (1.8 MB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp35-cp35m-manylinux1_i686.whl (7.3 MB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp35-cp35m-manylinux1_x86_64.whl (7.6 MB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp35-cp35m-win32.whl (412.2 kB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp35-cp35m-win_amd64.whl (507.0 kB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp36-cp36m-macosx_10_6_intel.whl (1.8 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp36-cp36m-manylinux1_i686.whl (7.4 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp36-cp36m-manylinux1_x86_64.whl (7.7 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp36-cp36m-win32.whl (420.9 kB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp36-cp36m-win_amd64.whl (515.1 kB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp37-cp37m-macosx_10_6_intel.whl (1.8 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp37-cp37m-manylinux1_i686.whl (7.4 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp37-cp37m-manylinux1_x86_64.whl (7.7 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp37-cp37m-win32.whl (420.4 kB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp37-cp37m-win_amd64.whl (515.1 kB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp38-cp38-macosx_10_9_x86_64.whl (899.8 kB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp38-cp38-manylinux1_i686.whl (7.3 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp38-cp38-manylinux1_x86_64.whl (7.7 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp38-cp38-win32.whl (427.2 kB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp38-cp38-win_amd64.whl (528.7 kB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp39-cp39-manylinux1_i686.whl (7.1 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size seabreeze-1.3.0-cp39-cp39-manylinux1_x86_64.whl (7.4 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size seabreeze-1.3.0.tar.gz (7.7 MB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page