ramanalysis

This repository contains a Python package called ramanalysis, the main purpose of which is to facilitate reading Raman spectroscopy data from a variety of instruments by unifying the way the spectral data is loaded. This package currently supports loading spectral data from four different Raman spectrometer manufacturers: - Horiba (tested on the MacroRAM and LabRAM HR Evolution) - OpenRAMAN - Renishaw (tested on the inVia Qontor) - Wasatch (tested on the WP785X)

This package also facilitates the calibration of spectral data output by the OpenRAMAN. The calibration procedure consists of two steps: 1. A rough calibration based on a broadband excitation light source (e.g. Neon lamp) 2. A fine calibration based on Raman-scattered light from a standard sample (e.g. acetonitrile)

Both calibration steps can be run automatically when spectra of neon and acetonitrile are provided (see Usage). This automated procedure builds upon the calibration protocol created by Sunanda Sharma and Ben Braverman. The pub associated with this protocol can be here.

For more information on the calibration procedure, see this blog post by the creator of the OpenRAMAN.

Installation

The package can be installed directly from the GitHub repository via pip: bash pip install git+https://github.com/Arcadia-Science/ramanalysis.git

Usage

Read and calibrate spectral data from an OpenRAMAN CSV file. ```python from pathlib import Path from ramanalysis import RamanSpectrum

Set file paths to the CSV files for your sample and calibration data

exampledatadirectory = Path("./ramanalysis/tests/exampledata/OpenRAMAN/") csvfilepathsample = next(exampledatadirectory.glob("CC-125.csv")) csvfilepathexcitationcalibration = next(exampledatadirectory.glob("neon.csv")) csvfilepathemissioncalibration = next(exampledata_directory.glob("aceto.csv"))

Read and calibrate the spectral data from your sample

spectrum = RamanSpectrum.fromopenramancsvfiles( csvfilepathsample, csvfilepathexcitationcalibration, csvfilepathemissioncalibration, ) ```

See examples for more example usage.

Cited by

Essock-Burns T, Kolb I, Lane R, Mets DG, Sharma S. (2025). "Comparison of spontaneous Raman spectrometers." https://arcadia-science.github.io/2025-raman-spectrometer-comparison/

Roadmap

1. Add a reader for CRS data from Leica LIF files using readlif.
2. Integrate with RamanSPy to easily convert RamanSpectrum instances to ramanspy Spectrum or SpectralImage instances and vice versa. Would look something like this: ```python spectrum = RamanSpectrum.fromopenramancsvfiles( csvfilepathsample, csvfilepathexcitationcalibration, csvfilepathemissioncalibration, )

ramanspyspectrum = spectrum.toramanspyspectrum() ramanalysisspectrum = RamanSpectrum.fromramanspyspectrum(ramanspy_spectrum) ```

Contributing

If you are interested in contributing to this package, please check out the developer notes. See how we recognize feedback and contributions to our code.