Subversion Repositories f9daq

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
145 f9daq 1
SOFTWARE FOR SIPM CHARACTERIZATION WITH CAMAC, SCOPE, BIAS VOLTAGE AND TABLE POSITION SUPPORT
2
=============================================================================================
3
By Gasper Kukec Mezek, April 2015.
4
 
5
________________
6
1. Installation:
7
 
8
Pre-requisites for offline and online modes:
9
a) Offline mode (support for histogramming and analysis):
10
   - A newer (5.34 or higher) pro version of ROOT (https://root.cern.ch).
11
b) Online mode (support for histogramming, analysis and data acquisition):
12
   - Perl developer package libperl-dev for installation of net-snmp (sudo apt-get install libperl-dev).
13
   - Current version of net-snmp (http://www.net-snmp.org).
14
   - A newer (5.34 or higher) pro version of ROOT (https://root.cern.ch).
15
   - USB developer package libusb-dev (sudo apt-get install libusb-dev).
16
 
17
Installation is done through the usual "./configure" and "make" commands to enable the use of this software with 32 bit or 64 bit systems.
18
 
19
Configure takes the following arguments:
20
- First argument is the configure option (help, nomake, all, clean, compress):
21
    help = shows configure help
22
    all = prepares OS dependent files and makes the needed usb daq libraries
23
    nomake = only prepares OS dependent files
24
    clean = cleans the installation to the base file structure (keeps the results directory)
25
    compress = compresses the base installation into a tar-ball
26
- Second argument is the online/offline configure setting (only used when first argument is nomake or all), that enables the software to work with:
27
    a connected CAMAC and scope (I)
28
    only a connected scope (S)
29
    with no connected devices (O)
30
- The following arguments set specific computer details and can be entered in any order:
31
    a) --root-install=/path/to/root/directory -> The ROOT install directory, if it is not installed in a standard location (especially needed when running the program with superuser, since it usually does not have the required environment variables).
32
    b) --snmp-install=/path/to/snmp/directory -> The NET-SNMP install directory, if it is not installed in a standard location.
33
    c) --ostype=YYYY -> Optional argument to specifically set the OS type to either 32bit (YYYY = i686) or 64bit (YYYY = x86_64). If argument not supplied, the configure script will try to get this information automatically through uname.
34
 
35
Running "./configure" or "./configure help" will give more information on specific uses.
36
Example:
37
   ./configure all I --root-install=/opt/root --snmp-install=/opt/net-snmp --ostype=i686
38
 
39
Makefile:
40
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.
41
Example:
42
   make
43
 
44
On first run of the program, make sure to copy the ./mpod/WIENER-CRATE-MIB.txt to the MIB directory in your installation of net-snmp. This can be in:
45
   ~/.snmp/mibs
46
or
47
   [/snmp/install/directory]/share/snmp/mibs
48
 
49
________________________
50
2. Running the software:
51
 
52
Once installation is performed, use
53
   ./start.sh
54
to start the software in offline mode or
55
   sudo ./start.sh
56
to start the software in online mode. Once the software starts, it will let you know (in the terminal) if connection to CAMAC was correctly established.
57
 
58
____________________
59
3. Feature overview:
60
 
61
The main window is divided into 5 subwindows:
62
a) Settings window:
63
   - ON/OFF switches for voltage and surface scans.
64
   - a voltage limiter -> sets the maximum output voltage for safety reasons
65
   - clean plots toggle switch -> when ON, no additional stats will be displayed on plots/histograms
66
   - scope IP -> sets the oscilloscope IP address
67
   - LASER settings info panel -> this will be written to the output file and is used for supplying additional information
68
   - chamber temperature -> the chamber temperature to be written to the output file
69
   - incidence angle -> the angle at which the sample is rotated around its axis, relative to the LASER beam (0 degrees is perpendicular to LASER beam)
70
 
71
b) Main measurement window:
72
   - settings for table position and bias voltage
73
   - when scans are enabled, additional settings for scans
74
   - number of events -> setting for the number of events to gather in a measurement
75
   - time stamp -> informational time (start time of measurement is written to output file)
76
   - file selector (for scans, the filenames will be appended sequential numbers to distinguish them)
77
   - start acquisition button -> starts the measurement based on selected settings
78
   - waveform analysis settings (channel, measurement type)
79
   - possibility to send custom one-line commands
80
 
81
c) Histogram file selection window:
82
   - open past measurements for analysis
83
   - if using multiple files, use multiple file select or select all listed files
84
   - files will be used in order displayed on the list
85
   - to clear the complete list, use the clear list button
86
   - to edit the header information of currently selected files, use the edit header button
87
   - any opened measurement has an info display of its header at the bottom for easier navigation
88
 
89
d) Histogram window:
90
   - displays the currently selected histogram in the histogram file selection window
91
 
92
e) Histogram controls window:
93
   - directly linked to the histogram window, it enables plotting options
94
   - can set ranges on histogram plots
95
   - can change between different histogram types (ADC, TDC, ADC vs. TDC, 2D surface plot)
96
   - for the 2D surface plot, the relevant files need to be selected in the histogram file selection window
97
   - toggle for logarithmic Y scale
98
   - the currently selected histogram can be manually exported with the export button
99
   - fit settings used when running "Fit spectrum" and "Fit all selected" options in the Analysis menu
100
 
101
On the top, there are 4 menus:
102
a) File:
103
   - New Measurement -> not working
104
   - Exit -> exit the software (shortkey x)
105
 
106
b) Analysis:
107
   - Histogram type -> change between histogram types (same as in histogram controls window)
108
   - Fit spectrum -> fit the currently open spectrum for peaks
109
   - Fit all selected -> fit all the selected ADC spectra selected in the histogram file selection window for peaks and display the breakdown voltage plots
110
   - Integrate spectrum (X, Y) -> integrate the ADC spectrum for multiple files with an X or Y scan (used for edge scans)
111
   - Relative PDE -> calculation of the relative PDE for the currently selected files
112
 
113
c) Tools:
114
   - Fieldpoint temperature sensor -> direct graphing of the fieldpoint temperature sensor (with settings for fieldpoint channel, start time and end time), output is a graph (if exporting) and a comma separated list saved to folder ./fieldpoint. Updating the graph can cause unstable behavior. If possible, use ~/sipmscan/fieldpoint_standalone instead.
115
 
116
d) Windows:
117
   - Specific window tiling
118
   - Switch between active windows
119
 
120
e) Help information
121
 
122
Important!
123
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.
124
 
125
______________
126
4. Change log:
127
 
128
17.7.2015 (Current Rev):
129
a) Fixed a problem with ADC peak fitting (peak fitting returning a segmentation fault).
130
b) Added support to edit file headers (in case, some were created at an older date and did not include some header information or there was a mistake in writing them).
131
c) Temperature data can only be retrieved when connected to the IJS network (IP = 178.172.43.xxx) and is disabled otherwise.
132
d) The relative PDE measurement now takes the incidence angle value directly from input files.
133
e) Currently, data acquisition only works on 32bit computers.
134
f) Fixed issue with program not correctly writting multiple channels.
135
 
136
5.5.2015 (Rev 128):
137
a) Added a header display for opened files in the histogram file selection window. This enables a quicker view of the measurement information.
138
b) Added an incidence angle input to be able to save sample rotation angle to headers of files.
139
c) Added support for the fieldpoint temperature sensor (FP RTD 122). Can now plot and export data from the sensor for a specific channel and specific time range. For now, this option only works if the PC you are using this program on is connected to an internet/ethernet connection at IJS.
140
d) Added a limited relative PDE analysis option. At this time, it takes the selected files and calculates the PDE, relative to the first selected file. The first file should be measured at incidence angle 0, with others having an incidence angle shift of +15 (1st file -> 0, 2nd file -> 15, 3rd file -> 30,...).
141
 
142
9.4.2015 (Rev 127):
143
a) Added communications panel for connecting to a Tektronix scope.
144
b) Added limited support for waveform analysis with a Tektronix scope. For now, it only works when linking it to CAMAC acquisition.
145
c) Added a manual chamber temperature entry field.
146
 
147
16.3.2015 (Rev 117):
148
a) First version of sipmscan.
149
b) Added support for CAMAC, bias voltage settings and table position settings.
150
c) Added support for opening measured histograms.
151
d) Added support for analysis:
152
   - making surface plots
153
   - fitting the ADC spectrum
154
   - creating breakdown voltage plots
155
   - integrating the ADC spectrum with changing X or Y direction (edge scans)