Subversion Repositories f9daq

Rev

Rev 146 | Rev 173 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
146 f9daq 1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<html>
3
<head>
4
   <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
5
   <title>Software for SiPM characterization</title>
6
   <link rel="stylesheet" type="text/css" href="style_sheet.css">
7
</head>
8
 
9
<body>
10
 
11
<h1 id="#top">Software for SiPM characterization with CAMAC, scope, bias voltage and table position support</h1>
12
 
13
<div>
14
   <h2>Contents</h2>
15
   <ol>
16
      <li><a href="#install">Installation</a></li>
17
      <li><a href="#softrun">Running the software</a></li>
18
      <li><a href="#featall">Program feature overview</a></li>
19
      <ol type="a">
20
         <li><a href="#featnew">Current program version (trunk)</a></li>
21
         <li><a href="#featold">Old program version (trunk_v0.9)</a></li>
22
      </ol>
23
      <li><a href="#prepmeasure">Preparing for measurements</a></li>
24
      <ol type="a">
25
         <li><a href="#presoft">Pre-software checks</a></li>
26
         <li><a href="#exppremeasure">Experimental setup pre-measurement checks</a></li>
27
         <li><a href="#softpremeasure">Software pre-measurement checks</a></li>
28
      </ol>
29
      <li><a href="#measures">Measurements</a></li>
30
      <ol type="a">
31
         <li><a href="#meassettings">Measurement settings</a></li>
32
         <li><a href="#tempchamber">Temperature chamber considerations</a></li>
33
         <li><a href="#movement">Movement table</a></li>
34
         <li><a href="#biasvolt">Bias voltage supply</a></li>
35
      </ol>
36
      <li><a href="#measfiles">Measurement files</a></li>
37
      <ol type="a">
38
         <li><a href="#rootfile">ROOT file structure</a></li>
39
         <li><a href="#fileopen">Opening measurement files</a></li>
40
      </ol>
41
      <li><a href="#analysis">Analysis</a></li>
42
      <li><a href="#changelog">Change log</a></li>
43
   </ol>
44
 
45
   <h2 id="install">1. Installation</h2>
46
   <p>Pre-requisites for offline and online modes:</p>
47
   <ol type="a">
48
      <li>Offline mode (support for histogramming and analysis):</li>
49
      <ul>
50
         <li>A newer (5.34 or higher, support for version 6 not added yet) pro version of ROOT (<a href="https://root.cern.ch" target="_blank">https://root.cern.ch</a>).</li>
51
      </ul>
52
      <li>Online mode (support for histogramming, analysis and data acquisition):</li>
53
      <ul>
54
         <li>Perl developer package libperl-dev for installation of net-snmp (<tt>sudo apt-get install libperl-dev</tt>).</li>
55
         <li>Current version of net-snmp (<a href="http://www.net-snmp.org" target="_blank">http://www.net-snmp.org</a>).</li>
56
         <li>A newer (5.34 or higher, support for version 6 not added yet) pro version of ROOT (<a href="https://root.cern.ch" target="_blank">https://root.cern.ch</a>).</li>
57
         <li>USB developer package libusb-dev (<tt>sudo apt-get install libusb-dev</tt>).</li>
58
      </ul>
59
   </ol>
60
 
61
   <p>Installation is done through the usual <tt>./configure</tt> and <tt>make</tt> commands to enable the use of this software with 32 bit or 64 bit systems.</p>
62
 
63
   <p>Configure takes the following arguments:</p>
64
   <ul>
65
     <li>First argument is the configure option (help, nomake, all, clean, compress):</li>
66
     <ul style="list-style-type:none">
67
        <li><tt>help</tt> = shows configure help</li>
68
        <li><tt>all</tt> = prepares OS dependent files and makes the needed usb daq libraries</li>
69
        <li><tt>nomake</tt> = only prepares OS dependent files</li>
70
        <li><tt>clean</tt> = cleans the installation to the base file structure (keeps the results directory)</li>
71
        <li><tt>compress</tt> = compresses the base installation into a tar-ball</li>
72
     </ul>
73
     <li>Second argument is the online/offline configure setting (only used when first argument is nomake or all), that enables the software to work with:</li>
74
     <ul style="list-style-type:none">
75
        <li><tt>I</tt> = a connected CAMAC and scope (Online mode)</li>
76
        <li><tt>S</tt> = only a connected scope (Offline mode with oscilloscope connection)</li>
77
        <li><tt>O</tt> = with no connected devices (Offline mode)</li>
78
     </ul>
79
     <li>The following arguments set specific computer details and can be entered in any order:</li>
80
     <ol type="a">
81
        <li><tt>--root-install=/path/to/root/directory</tt> = 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).</li>
82
        <li><tt>--snmp-install=/path/to/snmp/directory</tt> = The NET-SNMP install directory, if it is not installed in a standard location.</li>
83
        <li><tt>--ostype=YYYY</tt> = Optional argument to specifically set the OS type to either 32bit (<tt>YYYY = i686</tt>) or 64bit (<tt>YYYY = x86_64</tt>). If argument not supplied, the configure script will try to get this information automatically through uname.</li>
84
     </ol>
85
   </ul>
86
 
87
   <p>Running <tt>./configure</tt> or <tt>./configure help</tt> will give more information on specific uses.</p>
88
   <p>Example:</p>
89
   <div class="codeback"><pre><code>./configure all I --root-install=/opt/root --snmp-install=/opt/net-snmp --ostype=i686</code></pre></div>
90
 
91
   <p>Once configuration is done, a Makefile will be generated and further installation is done by running <tt>make</tt>. Running <tt>make relib</tt> will only recreate the libraries in case something has been edited in them.</p>
92
   <p>Example:</p>
93
   <div class="codeback"><pre><code>make</code></pre></div>
94
 
95
   <p>On first run of the program, make sure to copy the <tt>./mpod/WIENER-CRATE-MIB.txt</tt> to the MIB directory in your installation of net-snmp. This can be in <tt>~/.snmp/mibs</tt> or <tt>[/snmp/install/directory]/share/snmp/mibs</tt>.</p>
96
   <div class="backtop"><a href="#top">Back to top</a></div>
97
 
98
   <h2 id="softrun">2. Running the software</h2>
99
   <p>Once installation is performed, use</p>
100
   <div class="codeback"><pre><code>./start.sh</code></pre></div>
101
   <p>to start the software in offline mode or</p>
102
   <div class="codeback"><pre><code>sudo ./start.sh</code></pre></div>
103
   <p>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.</p>
104
   <div class="backtop"><a href="#top">Back to top</a></div>
105
 
106
   <h2 id="featall">3. Program feature overview</h2>
107
   <p>This part describes the different parts of the software and a short description on what they do.</p>
108
 
109
   <h3 id="featnew">3a. Current program version (trunk)</h3>
110
   <p>The main window is divided into 4 tabs and then further into subwindows:</p>
111
   <ol>
112
      <li>Measurement tab:</li>
113
      <ol type="a">
114
         <li>Settings pane:</li>
115
         <ul>
116
            <li>ON/OFF switches for voltage, surface, Z axis and rotation scans (ON when checked).</li>
117
            <li>A voltage limiter: Sets the maximum output voltage that can be set under Output voltage (sample safety reasons).</li>
118
            <li>Nr. of channels: The number of channels to measure. Each channel corresponds to an ADC/TDC pair.</li>
119
            <li>Position units: For display, use either movement table native units or micrometers (table units default).</li>
120
            <li>Rotation units: For display, use either rotation table native units or degrees (degrees default).</li>
121
            <li>Scope IP: Sets the oscilloscope IP address for connections to a device.</li>
122
            <li>LASER settings info panel: Additional information to be written to the output file header (most generally used for laser information).</li>
123
            <li>Chamber temperature: Chamber temperature to be written to the output file (temperature not directly taken from the fieldpoint sensor).</li>
124
            <li>Live histogram ON/OFF: ON/OFF switch for live histogram update. Offers quick overview of the current measurement. Should be avoided for scans.</li>
125
         </ul>
126
         <li>Display: Display of the live histogram, when it is turned on.</li>
127
         <li>Main measurement window:</li>
128
         <ul>
129
            <li>Settings for bias voltage, table position and incidence angle measurements.</li>
130
            <li>Additional settings enabled, when scans are enabled.</li>
131
            <li>If only one directional scan in X or Y direction is needed, set measurement to a surface scan and leave the other step size to 0.</li>
132
            <li>Number of events: Number of events gathered in one measurement.</li>
133
            <li>Time stamp: Date and time of measurement that is written to the header of the output file.</li>
134
            <li>Save to file: Selecting of output file filename. For scans, sequential numbers are appended to the end of the selected filename (i.e. <tt>/path/to/test.root</tt> will in a scan have <tt>/path/to/test_001.root</tt>, <tt>/path/to/test_002.root</tt>,...).</li>
135
            <li>Start acquisition: Starts the measurement based on currently selected settings.</li>
136
            <li>Current measurement progress bar: Determines the status of the current measurement.</li>
137
         </ul>
138
      </ol><br/>
139
 
140
      <li>Analysis tab:</li>
141
      <ol type="a">
142
         <li>Histogram file selection:</li>
143
         <ul>
144
            <li>Open past measurements for analysis. Additional display of header information for quicker reference.</li>
145
            <li>If using multiple files for the analysis, use multiple file select or select all listed files. They will be used in order displayed on the list.</li>
146
            <li>Use the Clear list button to clear all entries in from the list.</li>
147
            <li>Use the edit header button to update any information inside the headers of entries selected on the list.</li>
148
         </ul>
149
         <li>Histogram: Displays the currently selected histogram from the histogram file selection subwindow.</li>
150
         <li>Histogram controls:</li>
151
         <ul>
152
            <li>Enables plotting options for the currently selected histogram and to setup spectral options for analysis.</li>
153
            <li>ADC range: Sets the range of the ADC spectrum. Ranges are automatic, when set to (0,0).</li>
154
            <li>TDC range: Sets the range of the TDC spectrum. TDC spectrum determines the events used for plotting the ADC spectrum.</li>
155
            <li>Y range: Sets the range of the Y axis on the spectrum. Ranges are automatic, when set to (0,0).</li>
156
            <li>Display channel: Selects the channel to plot, when opening a multichannel measurement file.</li>
157
            <li>Plot type buttons: Buttons to change between ADC, TDC or ADC/TDC type of plot.</li>
158
            <li>Logarithmic scale ON/OFF: Toggle for logarithmic Y axis scale.</li>
159
            <li>Clean plots ON/OFF: Toggle for hiding plot information or not (such as plot title, fitting information, statistics information).</li>
160
            <li>Export: Exports the currently selected histograms (ADC, TDC or ADC/TDC form selected files) into the .pdf format.</li>
161
            <li>Edit: UNDER DEVELOPMENT! Opens the currently visible plot in the Histogram subwindow in a new tab to enable editing.</li>
162
         </ul>
163
         <li>Analysis:</li>
164
            <li>Options for specific analysis types (integrate spectrum, relative PDE, breakdown voltage, surface scan, timing). When using Start button, analysis starts, saves results and quits. When using Start and edit button, analysis starts and gives options to further edit the results.</li>
165
            <li>General fit settings (Peak sigma, S/N ratio, background interpolation, ADC spectrum offset, Maximum acceptable peak fit error, pedestal lower limit, background subtraction, export fits). Settings for analysis based on fitting of peaks on the ADC spectra (breakdown voltage and relative PDE). The current progress of the analysis is displayed on the progress bar.</li>
166
      </ol><br/>
167
 
168
      <li>Monitoring tab: UNDER DEVELOPMENT! Fieldpoint temperature sensor data view.</li><br/>
169
      <li>Help tab: Displays the contents of this help file.</li><br/>
170
   </ol>
171
 
172
   <p>On the top, there are 3 menus:</p>
173
   <ol>
174
      <li>File:</li>
175
      <ul>
176
         <li>Set user layout: Set a user saved layout of the program subwindows or use the default.</li>
177
         <li>Save current layout: Save the program subwindow layout to be used later. This will remember the sizes of each subwindow (Settings pane, Main measurement window, Display, Histogram file selection,...) and the overall size of the program window.</li>
178
         <li>Save current measurement settings: UNDER DEVELOPMENT! Will evantually save the entered values from the Measurement tab.</li>
179
         <li>Save current analysis settings: UNDER DEVELOPMENT! Will eventually save the entered values from the Analysis tab.</li>
180
         <li>Exit: Exit the software (shortkey x)</li>
181
      </ul>
182
      <li>Analysis (each takes you to the appropriate options for the analysis):</li>
183
      <ul>
184
         <li>Histogram type: Change between histogram types (same as in histogram controls window).</li>
185
         <li>Fit spectrum: UNDER DEVELOPMENT! Will produce a fit of ADC spectrum peak structure of the current file/files.</li>
186
         <li>Integrate spectrum: Integrate the ADC spectrum of the current file/files inside the selected ADC range.</li>
187
         <li>Integrate spectrum (X direction): Same as Integrate spectrum, but the selected files were produced as X axis scans. Makes the determination of an X directional edge scan and produces a 2D plot if Z axis scan was also enabled.</li>
188
         <li>Integrate spectrum (Y direction): Same as Integrate spectrum (X direction), but the selected files were produced as Y axis scans.</li>
189
         <li>Relative PDE: Produce a relative PDE plot, where selected files were produced as incidence angle scans.</li>
190
         <li>Surface 2D scan: Produce an integral of the ADC spectrum, where selected files were produced as surface scans (in X and Y directions).</li>
191
         <li>Timing analysis: UNDER DEVELOPMENT! Will make an analysis on the TDC spectrum of measurements.</li>
192
      </ul>
193
 
194
      <li>Help information</li>
195
   </ol>
196
 
197
   <p><span>Important!</span> When using any analysis method, only events inside the selected TDC window will be used (set the TDC range accordingly).</p>
198
 
199
   <h3 id="featold">3b. Old program version (trunk_v0.9)</h3>
200
   <p>The main window is divided into 5 subwindows:</p>
201
   <ol>
202
      <li>Settings window:</li>
203
      <ul>
204
         <li>ON/OFF switches for voltage and surface scans</li>
205
         <li>a voltage limiter: sets the maximum output voltage for safety reasons</li>
206
         <li>clean plots toggle switch: when ON, no additional stats will be displayed on plots/histograms</li>
207
         <li>scope IP: sets the oscilloscope IP address</li>
208
         <li>LASER settings info panel: this will be written to the output file and is used for supplying additional information</li>
209
         <li>chamber temperature: the chamber temperature to be written to the output file</li>
210
         <li>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)</li>
211
      </ul></br>
212
 
213
      <li>Main measurement window:</li>
214
      <ul>
215
         <li>settings for table position and bias voltage</li>
216
         <li>when scans are enabled, additional settings for scans</li>
217
         <li>number of events: setting for the number of events to gather in a measurement</li>
218
         <li>time stamp: informational time (start time of measurement is written to output file)</li>
219
         <li>file selector (for scans, the filenames will be appended sequential numbers to distinguish them)</li>
220
         <li>start acquisition button: starts the measurement based on selected settings</li>
221
         <li>waveform analysis settings (channel, measurement type)</li>
222
         <li>possibility to send custom one-line commands</li>
223
      </ul><br/>
224
 
225
      <li>Histogram file selection window:</li>
226
      <ul>
227
         <li>open past measurements for analysis</li>
228
         <li>if using multiple files, use multiple file select or select all listed files</li>
229
         <li>files will be used in order displayed on the list</li>
230
         <li>to clear the complete list, use the clear list button</li>
231
         <li>to edit the header information of currently selected files, use the edit header button</li>
232
         <li>any opened measurement has an info display of its header at the bottom for easier navigation</li>
233
      </ul><br/>
234
      <li>Histogram window: displays the currently selected histogram in the histogram file selection window</li><br/>
235
 
236
      <li>Histogram controls window:</li>
237
      <ul>
238
         <li>directly linked to the histogram window, it enables plotting options</li>
239
         <li>can set ranges on histogram plots</li>
240
         <li>can change between different histogram types (ADC, TDC, ADC vs. TDC, 2D surface plot)</li>
241
         <li>for the 2D surface plot, the relevant files need to be selected in the histogram file selection window</li>
242
         <li>toggle for logarithmic Y scale</li>
243
         <li>the currently selected histogram can be manually exported with the export button</li>
244
         <li>fit settings used when running "Fit spectrum" and "Fit all selected" options in the Analysis menu</li>
245
      </ul><br/>
246
   </ol>
247
 
248
   <p>On the top, there are 4 menus:</p>
249
   <ol>
250
      <li>File:</li>
251
      <ul>
252
         <li>New Measurement: not working</li>
253
         <li>Exit: exit the software (shortkey x)</li>
254
      </ul>
255
 
256
      <li>Analysis:</li>
257
      <ul>
258
         <li>Histogram type: change between histogram types (same as in histogram controls window)</li>
259
         <li>Fit spectrum: fit the currently open spectrum for peaks</li>
260
         <li>Fit all selected: fit all the selected ADC spectra selected in the histogram file selection window for peaks and display the breakdown voltage plots</li>
261
         <li>Integrate spectrum (X, Y): integrate the ADC spectrum for multiple files with an X or Y scan (used for edge scans)</li>
262
         <li>Relative PDE: calculation of the relative PDE for the currently selected files</li>
263
      </ul>
264
 
265
      <li>Tools:</li>
266
      <ul>
267
         <li>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 <tt>./fieldpoint</tt>. Updating the graph can cause unstable behavior. If possible, use <tt>~/sipmscan/fieldpoint_standalone</tt> instead.</li>
268
      </ul>
269
 
270
      <li>Windows:</li>
271
      <ul>
272
         <li>Specific window tiling</li>
273
         <li>Switch between active windows</li>
274
      </ul>
275
 
276
      <li>Help information</li>
277
   </ol>
278
 
279
   <p><span>Important!</span> 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.</p>
280
   <div class="backtop"><a href="#top">Back to top</a></div>
281
 
282
   <h2 id="prepmeasure">4. Preparing for measurements</h2>
283
   <p>General information for preparing the experimental setup and software for measurements.</p>
284
 
285
   <h3 id="presoft">4a. Pre-software checks</h3>
286
   <p>Before running the Online version of the program, make sure that CAMAC (Computer Automated Measurement And Control) is turned on and is connected to the computer via a USB cable. If upon starting, the program gives the following message:</p>
287
   <div class="codeback"><pre><code>daq::connect() - No devices were detected!</code></pre></div>
288
   <p>then CAMAC was not started or the program did not properly register it.</p>
289
   <p>In addition, for the Online version of the program, make sure that all movement table controllers are turned on and are connected to the computer via a USB cable.</p>
290
   <p>For the connection with the oscilloscope (Online and Offline with scope control versions of the program), make sure it is connected to the same network with a UTP cable and that the VXI software is started on it.</p>
291
 
292
   <h3 id="exppremeasure">4b. Experimental setup pre-measurement checks</h3>
293
   <p>When making changes inside the setup, make sure that no cables are hindering the movement of any of the movement tables. For the X, Y and Z axis table, the most critical are motor control cables (white, flat, multiwire cables) and the optical cable for laser optics (yellow or orange optical fibre). For the rotation table, the most critical are voltage supply cable (marked with BIAS) and signal cables (the same as bias cable, but unmarked or marked with SIGNAL).</p>
294
   <p>Additionally, whenever putting the experimental setup back together, note the distance between the laser optics and the sample. The sample should be placed out of harms way from the collimator of the optics (check it by setting Z axis position to 0).</p>
295
 
296
   <h3 id="softpremeasure">4c. Software pre-measurement checks</h3>
297
   <p>Before starting any measurement, it is suggested to set the Voltage limit (Settings pane, Measurement tab) in order to avoid any unwanted mistakes in bias voltage settings (to avoid any irreparable damage to the sample). Also, make sure to note the output channel for bias voltage supply and not change any other channels (since they could be connected to other experimental setups).</p>
298
 
299
   <div class="backtop"><a href="#top">Back to top</a></div>
300
 
301
   <h2 id="measures">5. Measurements</h2>
302
   <p>Information on the settings for performing measurements available in this program and information on the movement tables.</p>
303
 
304
   <h3 id="meassettings">5a. Measurement settings</h3>
305
   <p>On the Settings pane in the Measurement tab, the type of measurement can be selected:</p>
306
   <ul>
307
      <li>None is checked: The program will perform a single measurement (useful for quickly determining the state of the setup).</li><br/>
308
      <li>Voltage scan is checked: The program will enable <tt>V(min)</tt>, <tt>V(max)</tt> and <tt>V(step)</tt> settings and perform multiple measurements at different bias voltages. The number of measurements is equal to:
309
      <div class="codeback"><pre><code>Floor( [V(max) - V(min)]/V(step) )</code></pre></div>
310
      The last measurement is at a voltage always lower or equal to <tt>V(max)</tt> for safety reasons. Whenever <tt>V(step)</tt> is 0, only one measurement will be performed at <tt>V(min).</tt></li><br/>
311
      <li>Surface scan is checked: The program will enable <tt>X(min)</tt>, <tt>X(max)</tt> and <tt>X(step)</tt>, and <tt>Y(min)</tt>, <tt>Y(max)</tt> and <tt>Y(step)</tt> settings and perform multiple measurements at different table positions (surface scan). The number of measurements is equal to:
312
      <div class="codeback"><pre><code>Floor( [X(max) - X(min)]/X(step) )
313
Floor( [Y(max) - Y(min)]/Y(step) )</code></pre></div>
314
      The last measurement is at a position always smaller or equal to <tt>X(max)</tt> or <tt>Y(max)</tt>. Whenever <tt>X(step)</tt> is 0, only one measurement will be performed at <tt>X(min)</tt> and equally in the Y axis direction. By setting one axis step size to 0, only scans along one axis are performed (for example for edge scans).</li><br/>
315
      <li>Z-axis scan is checked: The program will enable <tt>Z(min)</tt>, <tt>Z(max)</tt> and <tt>Z(step)</tt> settings and perform multiple measurements at different distances between laser optics and the sample (Z axis). The number of measurements is equal to:
316
      <div class="codeback"><pre><code>Floor( [Z(max) - Z(min)]/Z(step) )</code></pre></div>
317
      The last measurement is at a position always smaller or equal to <tt>Z(max)</tt>. Whenever <tt>Z(step)</tt> is 0, only one measurement will be performed at <tt>Z(min)</tt>.</li><br/>
318
      <li>Rotation scan is checked: The program will enable <tt>Angle(min)</tt>, <tt>Angle(max)</tt> and <tt>Angle(step)</tt> settings and perform multiple measurements at different incidence angles (angle away from perpendicular incidence of laser light on the sample). The number of measurements is equal to:
319
      <div class="codeback"><pre><code>Floor( [Angle(max) - Angle(min)]/Angle(step) )</code></pre></div>
320
      The last measurement is at an angle always smaller or equal to <tt>Angle(max)</tt>. Whenever <tt>Angle(step)</tt> is 0, only one measurement will be performed at <tt>Angle(min)</tt>.</li>
321
  </ul>
322
 
323
  <p>Surface scan and Z axis scan can be combined to perform edge scans at different distances between optics and sample (useful for finding the focal point of the laser).</p>
324
 
325
   <h3 id="tempchamber">5b. Temperature chamber considerations</h3>
326
   <p>Whenever using the temperature chamber, be careful about the set temperature. SiPM samples have a specific operational and storage temperatures that should not be exceeded. The temperature chamber, however, has slight overshoots when increasing the temperature, thus heating slightly above the set temperature (sometimes as much as 5 degrees) and then cooling back down.</p>
327
   <p>The chamber also has some problems cooling after previous heating (ex. coming from 0 degrees to 25 degrees and then again cooling the chamber). In this case, it will seem to remain around some temperature, although it is supposed to be cooling down. Sometimes this can be solved by turning off the chamber and waiting for some time or by making a large temperature jump from higher to lower temperature (taking into consideration the sample temperature range).</p>
328
   <p>Opening the chamber after measurements at low temperatures should be very short, since condensation forms very quickly that can then lead to the water droplets freezing at low temperatures. Ideally, the chamber should be warmed close to room temperature before opening, but any very short changes to the setup can still be performed when at lower temperatures.</p>
329
 
330
   <h3 id="movement">5c. Movement table</h3>
331
   <p>The movement tables are controlled by National Aperture MicroMini controllers through a subprogram found in <tt>$sipmscan/trunk/src/MIKRO</tt>. Sometimes special measures are needed (in case of problems) that are not available inside the sipmscan software, but can be achieved by going directly to the subprogram. The subprogram can be run, by going directly to its directory and running:</p>
332
   <div class="codeback"><pre><code>./mikro_ctrl [arguments]</code></pre></div>
333
   <p>The arguments can be (only running <tt>./mikro_ctrl</tt> will bring up help information):</p>
334
   <ul>
335
      <li>Node select: <tt>-n [node nr]</tt>. The <tt>[nodenr]</tt> is the address number of the controller as set on the front of the MicroMini controller.</li>
336
      <li>Initialize node: <tt>-i [init type]</tt>. The <tt>[inittype]</tt> is the initialization type that can be 3M Linear (1), 3M Rotational (2), 4M Linear (3) or 4M Rotational (4). 3M are the smaller/shorter versions, while 4M are the larger/longer versions (all three axis are 4M Linear and the angle is 3M Rotational). Always needs the node select argument (<tt>-n</tt>).</li>
337
      <li>Node homing: <tt>-h</tt>. Sets the node to a predetermined 0 value (home). Always needs the node select argument (<tt>-n</tt>). <span>IMPORTANT:</span> The rotational table must never be set to home! It does not have a predetemined zero, so the table will infinitely spin and can cause harm to the sample or attached cables.</li>
338
      <li>Reset node: <tt>-r</tt>. Does a complete reset of the controller. Always needs the node select argument (<tt>-n</tt>). After reset, the controller needs to be initialized in order to work properly.</li>
339
      <li>Node status: <tt>-a</tt>. Returns the current status of the controller. Can be used with node select argument (<tt>-n</tt>) to target specific controller or without to display status from all.</li>
340
      <li>Node position: <tt>-p</tt>. Returns the current position of the controller. Always needs the node select argument (<tt>-n</tt>).</li>
341
      <li>Node get command: <tt>-g [command]</tt>. Get return value from the issued command. Always needs the node select argument (<tt>-n</tt>). For possible commands, see the MicroMini user manual.</li>
342
      <li>Node set command: <tt>-v [value] -s [command]</tt>. Set a value with an issued command. Always needs the node select argument (<tt>-n</tt>). For possible commands and values, see the MicroMini user manual.</li>
343
      <li>Custom node command: <tt>-c [command]</tt>. Run one of the node commands without setting a value. Always needs the node select argument (<tt>-n</tt>). For possible commands and values, see the MicroMini user manual.</li>
344
   </ul>
345
 
346
   <p>Example commands:</p>
347
   <ul>
348
      <li>Reset node 1:</li>
349
      <div class="codeback"><pre><code>./mikro_ctrl -n 1 -r</code></pre></div>
350
      <li>Initialize node 2 as a 4M Linear type:</li>
351
      <div class="codeback"><pre><code>./mikro_ctrl -n 2 -i 3</code></pre></div>
352
      <li>Home node 3:</li>
353
      <div class="codeback"><pre><code>./mikro_ctrl -n 3 -h</code></pre></div>
354
      <li>Determine node 1 position:</li>
355
      <div class="codeback"><pre><code>./mikro_ctrl -n 1 -p</code></pre></div>
356
      <li>Prepare to move node 2 to an absolute position of 1000 and move it:</li>
357
      <div class="codeback"><pre><code>./mikro_ctrl -n 2 -v 500 -s la
358
./mikro_ctrl -c m</code></pre></div>
359
      <li>Prepare to move node 3 relative to current position for -500 and move it:</li>
360
      <div class="codeback"><pre><code>./mikro_ctrl -n 2 -v -500 -s lr
361
./mikro_ctrl -c m</code></pre></div>
362
      <li>Abort the current movement of node 4:</li>
363
      <div class="codeback"><pre><code>./mikro_ctrl -n 4 -c ab</code></pre></div>
364
  </ul>
365
 
366
  <p>Documentation:</p>
367
  <ul>
368
     <li><a href="http://www-f9.ijs.si/~rok/detectors/oprema/national_aperture_stages/MicroMini_Manual.pdf" target="_blank">MicroMini controller manual</a></li>
369
     <li><a href="http://www.naimotion.com/mm4mex.htm" target="_blank">4M Linear table information</a></li>
370
     <li><a href="http://www.naimotion.com/mm3mr.htm" target="_blank">3M Rotational table information</a></li>
371
  </ul>
372
 
373
   <h3 id="biasvolt">5d. Bias voltage supply</h3>
374
   <p>The bias voltage is supplied by the MPOD HV & LV power supply system through a subscript found in <tt>$sipmscan/trunk/src/mpod</tt> (using the snmp software). Sometimes special measures are needed (in case of problems) that are not available inside the sipmscan software, but can be achieved by going directly to the subprogram. The subprogram can be run, by going directly to its directory and running:</p>
375
   <div class="codeback"><pre><code>./mpod_voltage.sh [arguments]</code></pre></div>
376
   <p>The arguments can be:</p>
377
   <ul>
378
      <li>Reset all output channels: <tt>--resetall</tt></li>
379
      <li>Reset a selected output channel: <tt>-r [channel]</tt></li>
380
      <li>Selects an output channel: <tt>-o [channel]</tt></li>
381
      <li>Sets the output channel voltage: <tt>-v [voltage]</tt></li>
382
      <li>Turns the output on/off: <tt>-s [0/1]</tt></li>
383
      <li>Get the current output channel voltage: <tt>-g</tt></li>
384
   </ul>
385
 
386
   <p>Example commands:</p>
387
   <ul>
388
      <li>Get the set bias voltage on channel 1 (U0):</li>
389
      <div class="codeback"><pre><code>./mpod_voltage.sh -o 1 -g</code></pre></div>
390
      <li>Turn the bias voltage off on channel 2 (U1):</li>
391
      <div class="codeback"><pre><code>./mpod_voltage.sh -o 2 -s 0</code></pre></div>
392
      <li>Turn the bias voltage on and set it to 24.5V on channel 1 (U0):</li>
393
      <div class="codeback"><pre><code>./mpod_voltage.sh -o 1 -v 24.5 -s 1</code></pre></div>
394
      <li>Reset channel 2 (U1):</li>
395
      <div class="codeback"><pre><code>./mpod_voltage.sh -o 2 -r</code></pre></div>
396
   </ul>
397
 
398
   <p>In its complete state, the command used in the script mpod_voltage.sh for setting for example an output voltage of 24.5 to channel 1 (U0):</p>
399
   <div class="codeback"><pre><code>snmpset -v 2c -M +. -m +WIENER-CRATE-MIB -c guru [IP address] outputVoltage.1 F 24.5</code></pre></div>
400
 
401
  <p>Documentation:</p>
402
  <ul>
403
     <li><a href="http://www.net-snmp.org/docs/man/" target="_blank">Net-SNMP</a></li>
404
     <li><a href="http://file.wiener-d.com/documentation/MPOD/Manual_MPOD_LV-HV_2.9.pdf" target="_blank">MPOD documentation</a></li>
405
  </ul>
406
 
407
   <div class="backtop"><a href="#top">Back to top</a></div>
408
 
409
   <h2 id="measfiles">6. Measurement files</h2>
410
   <p>The measurement files, used for saving results, are constructed in native ROOT format to increase the read/write speeds while reading and saving data.</p>
411
 
412
   <h3 id="rootfile">6a. ROOT file structure</h3>
413
   <p>The output ROOT files are structured in this way:</p>
414
   <div class="codeback"><div class="codename">ROOT file structure</div>
415
   <pre><code>ROOT file (TFile)
416
 |
417
 |== header_data (TTree): Header information (same for all events)
418
 |    |
419
 |    |== nrch (TBranch): Number of channels (ADC + TDC channels)
420
 |    |== timestamp (TBranch): Unix timestamp for start of measurement
421
 |    |== biasvolt (TBranch): Measurement bias voltage
422
 |    |== xpos (TBranch): X axis position in table units
423
 |    |== ypos (TBranch): Y axis position in table units
424
 |    |== zpos (TBranch): Z axis position in table units
425
 |    |== temperature (TBranch): Chamber temperature
426
 |    |== angle (TBranch): Incidence angle of measurement
427
 |    |== laserinfo (TBranch): Additional info for measurement
428
 |
429
 |== meas_data (TTree): Measured values from ADC and TDC (all events)
430
 |    |
431
 |    |== ADC0 (TBranch): All events from ADC channel 0 saved in order
432
 |    |== TDC0 (TBranch): All events from TDC channel 0 saved in order
433
 |    |== ADC1 (TBranch): All events from ADC channel 1 saved in order
434
 |    |== TDC1 (TBranch): All events from TDC channel 1 saved in order
435
 |    |== ... (TBranch): Additional channels up to 8 (0-7) in total
436
 |
437
 |== scope_data (TTree, optional): Measured values from the oscilloscope
438
      |
439
      |== measdata (TBranch): Currently in development
440
   </code></pre></div>
441
 
442
   <p>The easiest way to get the data is to create structures:</p>
443
   <div class="codeback"><div class="codename">Output file structure</div>
444
   <pre><code>struct EventHeader {
445
  int nrch;
446
  int timestamp;
447
  double biasvolt;
448
  int xpos;
449
  int ypos;
450
  int zpos;
451
  double temperature;
452
  double angle;
453
  char laserinfo[256];
454
} evtheader;
455
 
456
struct EventData {
457
  int adcdata[8];
458
  int tdcdata[8];
459
} evtdata;
460
 
461
struct EventMeas {
462
  double measdata;
463
} evtmeas;
464
   </code></pre></div>
465
 
466
   <p>Then opening the file:</p>
467
   <div class="codeback"><pre><code>TFile* inputfile = TFile::Open("filename.root","READ");</code></pre></div>
468
 
469
   <p>And getting separate information:</p>
470
   <ul>
471
      <li>for instance for reading the bias voltage from header:</li>
472
      <div class="codeback"><pre><code>TTree* sometree;
473
inputfile->GetObject("header_data", sometree);
474
sometree->SetBranchAddress("biasvolt", &evtheader.biasvolt);
475
sometree->GetEntry(0);</code></pre></div>
476
 
477
      <li>for instance for reading all ADC and TDC events in a file from channel 1 (ADC0):</li>
478
      <div class="codeback"><pre><code>TTree* sometree;
479
inputfile->GetObject("meas_data", sometree);
480
char selectedCh[256];
481
for(int i = 0; i < sometree->GetEntries(); i++)
482
{
483
  sprintf(selectedCh, "ADC%d", 0);
484
  sometree->SetBranchAddress(selectedCh, &evtdata.adcdata[i]);
485
  sometree->GetEntry(i);
486
 
487
  sprintf(selectedCh, "TDC%d", 0);
488
  sometree->SetBranchAddress(selectedCh, &evtdata.tdcdata[i]);
489
  sometree->GetEntry(i);
490
}</code></pre></div>
491
   </ul>
492
 
493
   <h3 id="fileopen">6b. Opening measurement files</h3>
494
   <p>The sipmscan software has internal handling for saving and opening measurement files. To open these files for an analysis, use the File selection button in the Histogram file selection window (Analysis tab). Once the file or files are opened, it is possible to double click a file on the list to display its histogram. The histogram can then be manipulated by changing ADC or TDC ranges, or changing the type of displayed histogram (ADC, TDC ADC versus TDC).</p>
495
   <p>Each of the selected files has a display of its header below the file list in order to quickly determine at what conditions and when this measurement was taken. If there are any problems with the header, modifications can be performed with the Edit header button.</p>
496
   <p>After that analysis on the measurements can be performed, based on the selected ranges for ADC and TDC (note that each measured event has a ADC and TDC channel value saved to the file).</p>
497
 
498
   <div class="backtop"><a href="#top">Back to top</a></div>
499
 
500
   <h2 id="analysis">7. Analysis</h2>
501
   <p>The sipmscan software already includes a number of analysis options:</p>
502
   <ul>
503
      <li>Plotting ADC (Analog-to-Digital Converter) spectrum, TDC (Time-to-Digital Converter) spectrum and ADC versus TDC 2D plots.</li>
504
      <li>Fitting of ADC spectrum photon equivalent peaks.</li>
505
      <li>ADC spectrum integration: Single or along X or Y directions (for edge scans).</li>
506
      <li>Relative Photon Detection Efficiency: Efficiency of sample relative to incidence angle.</li>
507
      <li>Breakdown voltage: Determination of silicon detector breakdown voltage through ADC spectrum photon peak separation (gain).</li>
508
      <li>Surface scan: Production of a 2D plot by integrating the ADC spectrum in each laser position.</li>
509
   </ul>
510
   <p>Still to come...</p>
511
   <div class="backtop"><a href="#top">Back to top</a></div>
512
 
513
   <h2 id="changelog">8. Change log</h2>
167 f9daq 514
   <p>11.8.2016 (Current Rev):</p>
146 f9daq 515
   <ol type="a">
167 f9daq 516
      <li>When using breakdown voltage or relative PDE analysis and with only one file selected, the analysis is stopped and the fit is displayed on the graph. This makes it easier to setup fitting settings.</li>
517
      <li>Added the possibility to export plots created through analysis ("Start and edit" option).</li>
518
      <li>Everytime, when opening a histogram file, the following open and save dialog windows automatically open up in that directory. This makes it easier to find the directory that was used last.</li>
519
      <li>Added a dropdown list to the Analysis tab, so that it is possible to set position units for plots (table units or microns).</li>
520
      <li>Normalization to a maximum of 1 now works for surface scans.</li>
521
   </ol><br/>
522
 
523
   <p>4.4.2016 (Rev 146):</p>
524
   <ol type="a">
146 f9daq 525
      <li>Complete restructure of the program, so that it now runs seperately, not through ROOT (libraries are constructed pre-run). Program is now split into multiple tabs for easier use, three of which are Measurement, Analysis and Help.</li>
526
      <li>Added support for relative PDE measurements with included sample rotation table.</li>
527
      <li>Improvement of analysis part of the program (includes ADC spectrum integration, breakdown voltage characterization, surface scans, relative PDE characterization,...).</li>
528
      <li>Added tooltips for different parts of the program for quick reference. Use them by hovering over any text entries, number entries, check boxes or buttons.</li>
529
      <li>Connection to temperature data and oscilloscope currently under development.</li>
530
      <li>Older version of program moved to <a href="https://f9pc00.ijs.si/svn/f9daq/lab/sipmscan/trunk_v0.9">https://f9pc00.ijs.si/svn/f9daq/lab/sipmscan/trunk_v0.9</a> and will no longer be in development.</li>
531
   </ol><br/>
532
 
533
   <p>17.7.2015 (Rev 129):</p>
534
   <ol type="a">
535
      <li>Fixed a problem with ADC peak fitting (peak fitting returning a segmentation fault).</li>
536
      <li>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).</li>
537
      <li>Temperature data can only be retrieved when connected to the IJS network (IP = 178.172.43.xxx) and is disabled otherwise.</li>
538
      <li>The relative PDE measurement now takes the incidence angle value directly from input files.</li>
539
      <li>Currently, data acquisition only works on 32bit computers.</li>
540
      <li>Fixed issue with program not correctly writting multiple channels.</li>
541
   </ol><br/>
542
 
543
   <p>5.5.2015 (Rev 128):</p>
544
   <ol type="a">
545
      <li>Added a header display for opened files in the histogram file selection window. This enables a quicker view of the measurement information.</li>
546
      <li>Added an incidence angle input to be able to save sample rotation angle to headers of files.</li>
547
      <li>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.</li>
548
      <li>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,...).</li>
549
   </ol><br/>
550
 
551
   <p>9.4.2015 (Rev 127):</p>
552
   <ol type="a">
553
      <li>Added communications panel for connecting to a Tektronix scope.</li>
554
      <li>Added limited support for waveform analysis with a Tektronix scope. For now, it only works when linking it to CAMAC acquisition.</li>
555
      <li>Added a manual chamber temperature entry field.</li>
556
   </ol><br/>
557
 
558
   <p>16.3.2015 (Rev 117):</p>
559
   <ol type="a">
560
      <li>First version of sipmscan.</li>
561
      <li>Added support for CAMAC, bias voltage settings and table position settings.</li>
562
      <li>Added support for opening measured histograms.</li>
563
      <li>Added support for analysis:</li>
564
      <ul>
565
         <li>making surface plots</li>
566
         <li>fitting the ADC spectrum</li>
567
         <li>creating breakdown voltage plots</li>
568
         <li>integrating the ADC spectrum with changing X or Y direction (edge scans)</li>
569
      </ul>
570
   </ol><br/>
571
 
572
   <div class="backtop"><a href="#top">Back to top</a></div>
573
 
574
</div>
575
 
576
</body>
577
</html>