3S version 2.0 (2007)

Please refer to the manuscript "3S: A novel program for field spectroscopy", Computers & Geosciences, for detailed operating instructions.




1 Installation
2 Installation Troubleshooting
3 First use
4 Connecting two spectrometers to the same computer
5 Binary data structure

1. Installation

Run the setup.exe and follow the instruction.

2. Installation Troubleshooting

Failure of the program has been reported after a correct installation on some computers. The problem seems dependent on a Windows XP and OOWinIP driver conflict.
The bug is fixed by installing and running once the genuine and free OceanOptics software which can be downloaded from http://www.oceanoptics.com or can be found in the 3S installation directory (OOIbase_websetup.exe).

3. First use

3.1 Preparation of spectrometer configuration file
The spectrometer configuration file is a text file. The name of the file is the spectrometer serial number and the extension is ‘.spec’ (e.g. the spectrometer with serial USB2G8481 will have a ‘USB2G8481.spec’ configuration file). The file must contain 5 rows (other rows are ignored by 3S) with the following information: the ADC converter type, the spectrometer serial number, the four coefficients for wavelength calibration).
The following rows are an example for an USB2000 spectrometer with serial USB2G8481:

Description of the fields:
ADCType:It is the spectrometer type , possible values are: USB2000, HR2000, HR4000
SerialNumber: It is the serial number of your spectrometer (this number can be found in the OceanOptics documentation and it is printed on the spectrometer case)
WLFirst:First coefficient of wl calibration 3rd degree polynomial (provided by OceanOptics or home made with a proper calibration source)
WLSecond:Second coefficient of wl calibration
WLThird:Third coefficient of wl calibration
WLIntercept:Intercept coefficient of wl calibration

Copy your specification into an existing file:
Three example configuration files are copied into the installation directory: HR2A0706.spec, HR4C1078.spec, USB2G8481.spec (for use with an HR2000, HR4000 and USB2000 spectrometers, respectively). In order to enter your specific values, copy the one with your spectrometer type and insert only your own wavelength coefficients.

3.2 Running 3S
Attach spectrometer to the computer and run 3S. Execute the 3S and you will be prompted to select the spectrometer type (e.g. USB2000) and the AD converter type (e.g.
USB2000), then select the serial number of the connected spectrometer. This operation is done once at the first use.
Afterwards the main GUI appears. Click on the Setup button. Select the spectrometer type (e.g. USB2000) and select the proper spectrometer file (modify
the one provided with 3S according to your own spectrometer specification, see above). Type ‘none’ in the spectrometer unit serial field if you want to remove a
spectrometer. Select your data directory (files will be stored there).
Fill the local host field with the computer name only if more than one spectrometer will be attached to the computer (see 4 Connecting two spectrometers to the same computer below)

4. Connecting two spectrometers to the same computer

The basic idea for this operation mode is that two 3S executable are issued one after another (MASTER and SLAVE). Communication between the running programs (settings changes and user commands) is achieved by exploiting the NI DataSocket protocol.
At first use, follow these instruction to establish the communication:
- Once 3S is installed, launch (Start Menu, National Instruments) DataSocket Server Manager. Set Permissions Groups-DefaultWriters-everyhost, Creators-everyhost, save now!
- Launch 3S, in the setup GUI specify the name of the computer (which can be found in: Windows Control Panel, System, Computer Name.
These operations are only needed at the first use.

5. Binary data structure

Dummy variables are reserved to development, skip them or read them into dummy variables. (please see the text file enclosed to 3S.zip file)


Contacts Michele Meroni for further assistance

Michele Meroni, PhD
Remote Sensing Laboratory, DISAT, University of Milan – Bicocca
P.zza della Scienza 1, 20126, Milan, Italy
Ph. +39 02 64482848
Fax +39 02 64482895
Email michele.meroni@unimib.it