Public Lab Wiki documentation



Spectral Workbench usage

This is a revision from December 16, 2012 16:31. View all revisions
6 | 53 | | #598

Basics

SpectralWorkbench.org is a web-based software suite for collecting spectra, using your Public Lab DIY spectrometer. Once you have an assembled spectrometer connected to your computer or smartphone, go to https://spectralworkbench.org and click Capture.

To use the full functionality, and especially on iOS, you should first log in using your PublicLaboratory.org username.

You'll then be able to connect to your spectrometer (desktop or Opera Mobile) or upload a spectrum. Give it a title, tags, and description.

Calibration

You'll notice that many other spectra on the site have a scale showing "nm" or nanometer units on the horizontal axis. To get scaled data, you must calibrate your spectrometer. There are several kinds of calibration but here we're talking about wavelength calibration, which allows your spectrometer to display a wavelength value for any color of light it sees. Luckily, this is easy.

1) Find a fluorescent light bulb -- preferably a compact fluorescent bulb you can put your spectrometer very close to. Point your spectrometer at the bulb -- if it's too bright, point it at a piece of white paper or wall which is brightly illuminated by the bulb.

example spectrum

2) You'll see an image like the above example; if you're on a computer, it may appear horizontally. The lines you see are from mercury in the bulb, and since we know what wavelengths they should be, we can use this to calibrate your device.

Save this spectrum, and tag it "fluorescent". Now you'll need to use the analysis tool to calibrate; it will walk you through the process.

Analysis

Once your spectrometer is calibrated, what do you do next? This is the central question of our open spectrometry community. People are building and using these spectrometers for many reasons and there are different approaches being actively developed. For the time being, try browsing recent contributed open spectrometry research,

Videos

A brief intro to Spectral Workbench's new web-based capture interface, including absorption spectroscopy:

Calibration

Learn to calibrate your spectrometer with a compact fluorescent light (CFL):

See Spectral Workbench Help if you have trouble.


Note: The above video walks through this process and is more up to date. The following instructions are for the older, deprecated version of Spectral Workbench

Advanced use

Configuring your webcam

Most webcams have auto exposure and color "correction" so that in dim light, you can still see. This will unfortunately change the exposure between readings, so for quantitative work, it must be disabled. On Linux, you can use the "uvcdynctl" utility as outlined here.

On a Mac, you can download this utility: http://www.phoboslab.org/log/2009/07/uvc-camera-control-for-mac-os-x

If you find a comparable utility for Windows, please post it here.

Offline use

The offline-usable Java version of Spectral Workbench is no longer actively developed or supported, but you can read about it here: Spectral Workbench Offline

A new browser-based offline version is in development; ask on the mailing list.