Subversion Repositories f9daq

SOFTWARE FOR SIPM CHARACTERIZATION WITH CAMAC, SCOPE, BIAS VOLTAGE AND TABLE POSITION SUPPORT

=============================================================================================

By Gasper Kukec Mezek, April 2015.

________________

1. Installation:

Installation is done through the usual "./configure" and "make" commands to enable the use of this software with 32 bit and 64 bit systems.

Configure takes two arguments:

- First argument is the configure option (help, nomake, all, clean, compress).

- Second argument is the online/offline configure setting (only used when first argument is nomake or all), that enables the software to work with a connected CAMAC and scope (I), only a connected scope (S) or with no connected devices (O).

Running "./configure" or "./configure help" will give more information on specific uses.

Example:

   ./configure all I

Makefile:

Once configuration is done, a Makefile will be generated and further installation is done by running "make". Running "make relib" will only recreate the libraries in case something has been edited in them.

Example:

   make

________________________

2. Running the software:

The software requires an installation of ROOT with set environment variable $ROOTSYS and $LD_LIBRARY_PATH. Once installation is performed, use

   ./start.sh

to start the software. Once the software starts it will let you know (in the terminal) if the CAMAC connection was correctly established.

_______________

3. Short guide:

The main window is divided into 5 subwindows:

a) Settings window:

   - ON/OFF switches for voltage and surface scans.

   - a voltage limiter -> sets the maximum output voltage for safety reasons

   - clean plots toggle switch -> when ON, no additional stats will be displayed on plots/histograms

   - scope IP -> sets the oscilloscope IP address

   - LASER settings info panel -> this will be written to the output file and is used for supplying additional information

   - chamber temperature -> the chamber temperature to be written to the output file

b) Main measurement window:

   - settings for table position and bias voltage

   - when scans are enabled, additional settings for scans

   - number of events -> setting for the number of events to gather in a measurement

   - time stamp -> informational time (start time of measurement is written to output file)

   - file selector (for scans, the filenames will be appended sequential numbers to distinguish them)

   - start acquisition button -> starts the measurement based on selected settings

   - waveform analysis settings (channel, measurement type)

   - possibility to send custom one-line commands

c) Histogram file selection window:

   - open past measurements for analysis

   - if using multiple files, use multiple file select or select all listed files

   - files will be used in order displayed on the list

   - to clear the complete list, use the clear list button

d) Histogram window:

   - displays the currently selected histogram in the histogram file selection window

e) Histogram controls window:

   - directly linked to the histogram window, it enables plotting options

   - can set ranges on histogram plots

   - can change between different histogram types (ADC, TDC, ADC vs. TDC, 2D surface plot)

   - for the 2D surface plot, the relevant files need to be selected in the histogram file selection window

   - toggle for logarithmic Y scale

   - the currently selected histogram can be manually exported with the export button

   - fit settings used when running "Fit spectrum" and "Fit all selected" options in the Analysis menu

On the top, there are 4 menus:

a) File:

   - New Measurement -> not working

   - Exit -> exit the software (shortkey x)

b) Analysis:

   - Histogram type -> change between histogram types (same as in histogram controls window)

   - Fit spectrum -> fit the currently open spectrum for peaks

   - Fit all selected -> fit all the selected ADC spectra selected in the histogram file selection window for peaks and display the breakdown voltage plots

   - Integrate spectrum (X, Y) -> integrate the ADC spectrum for multiple files with an X or Y scan (used for edge scans)

c) Windows:

   - Specific tiling

   - Switch between active windows

d) Help information

Important!

When using any analysis method (surface 2D plot, fitting, integration, ADC spectra display) only events inside the selected TDC window will be used so set the TDC range accordingly.

______________

4. Change log:

9.4.2015:

a) Added communications panel for connecting to a Tektronix scope.

b) Added limited support for waveform analysis with a Tektronix scope. For now it only works when linking it to CAMAC acquisition.

c) Added a manual chamber temperature entry field.

16.3.2015:

a) First version of sipmscan.

b) Added support for CAMAC, bias voltage settings and table position settings.

c) Added support for opening measured histograms.

d) Added support for analysis:

   - making surface plots

   - fitting the ADC spectrum

   - creating breakdown voltage plots

   - integrating the ADC spectrum with changing X or Y direction (edge scans)