spe-tools

Last modification: 7^th September 2010

                      _              _
 ___ _ __   ___      | |_ ___   ___ | |___
/ __| '_ \ / _ \_____| __/ _ \ / _ \| / __|
\__ \ |_) |  __/_____| || (_) | (_) | \__ \
|___/ .__/ \___|      \__\___/ \___/|_|___/
    |_|

v 0.6 by Vladimir Jary

This project is being developped for the OSQAR experiment. spe-tools is a command-line program that converts spectrum files (*.spe) produced by CCD cameras by Princeton Instruments into one of the following formats:

plain text (*.txt)
single column plain text files (*.asc)
comma-separated values spreadsheet (*.csv)
ROOT files (*.root) - new in version 0.5
portable graymap (*.pgm) - removed in version 0.6

spe-tools is written in C++ language using the Qt framework. It should work on all platforms supported by Qt, including Windows and Linux.

Download:

spe-tools 0.6 (current version) (md5sum: 64a0174f18d1af46908530019a048ffd)

spe-tools 0.5 (md5sum: 1f8ad47a59247206188a1a16d0b53378)

spe-tools 0.4 (md5sum: ae662b91a3382f16dcb3e458a912ba45)

spe-tools 0.3 (md5sum: c69eeed43a4414ca798e7c75d19e6497)

spe-tools 0.2 (md5sum: bbbec01148e4b3d23f16baaf02717ea3)

spe-tools 0.1 (md5sum: 1a1f7db53081588b4568056e221c3477)

Usage:

on Windows: spe-tools.exe input.spe format [newline]
on Linux: ./spe-tools input.spe format [newline]
Format is one of the following: asc, csv, pgm, txt Newline is either empty or one of the following: unix, dos, mac This parameter specifies the format of new line sequence (Unix LF, DOS CR+LF, Mac CR), see Wikipedia article for more details.
You can also run spe-tools in a batch mode - this mode will convert all spectrum files in given directory and in its subdirectories. For examples, the command
spe-tools.exe C:\Data\ txt
will convert all spe files under the C:\Data into plain text files.

How to build spe-tools from sources

This quick howto assumes you are using some modern distribution of GNU/Linux. You will need Qt4 developement package (and for version 0.5 also ROOT).

mkdir spe-tools
cd spe-tools
wget http://kmlinux.fjfi.cvut.cz/~jaryvlad/download/spe-tools-0.6.zip
unzip spe-tools-0.6.zip
cd src
qmake spe-tools.pro -o Makefile
make
have fun!

How to plot txt file produced by spe-tools using gnuplot?

plot 'file.txt' with lines
set grid
set xlabel 'Pixel No.'
set ylabel 'Intensity'
set label 'Spectrum'
replot

Known limitations:

Since version 0.6, the program supports all data formats of SPE file. However, data format 2 (signed 16-bit integer) has not been tested.

Changelog

version 0.6 (released on 7^th September 2010
- added support for data format 0 (float) and experimental support for data format 2 (signed 16bit integer)
- Windows version is back but it does not support conversion into root files (due to unresolved linking issues)
- rewrite part of code to use C++ templates
- removed support for PGM format
version 0.5 (released on 6^th August 2010): Windows version is currently not provided due to build issues
- now, it is possible to convert data into ROOT file: each frame is saved as a TGraph instance
- for Windows users, added Python script spe2root.py that converts SPE file into ROOT file, script requires ROOT, Python 2.6, and Numpy to be installed
  Usage: C:\Python26\python.exe spe2root.py file.spe
version 0.4 (released on 4^th July 2010): this is recommended update
- added support for SPE format 3 (signed 32b integer), requested by Karolina
- change the separator in CSV file to semicolon (;)
- warning is now printed in case unsupported data format is used
- upgrade to the current version of QT toolkit
version 0.3 (released on 3^rd March 2010)
- added support for saving each scans into separate plain-text files (*.asc format), requested by Pavel
- added optional "newline" parameter
version 0.2 (released on 25^th February 2010)
- added support for spectrum files with multiple scans
- added batch support as requested by Tomas
version 0.1 (released on 21^st February 2010)
- initial release

<< Go back