Subversion Repositories f9daq

Rev

Rev 167 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed

  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>
  514.    <p>5.10.2016 (Current Rev):</p>
  515.    <ol type="a">
  516.       <li>Fixed a couple of bugs and layout positions.</li>
  517.       <li>Added settings files for measurement and analysis settings. With this, everytime a new measurement or a new analysis is ran, the selected settings are saved to a file. This way, if the program crashes, all settings will be automatically filled in.</li>
  518.    </ol><br/>
  519.  
  520.    <p>30.9.2016 (Rev 172):</p>
  521.    <ol type="a">
  522.       <li>Fixed the time estimation for surface and Z-axis scans (TimeEstimateNew).</li>
  523.       <li>Did the same as c) in the previous revision, but separately for opening histogram files and for selecting the measurement output file.</li>
  524.       <li>Added an Emergency stop button to the movement of the table - just in case a wrong value is inserted and there is something in the way.</li>
  525.       <li>Added a way to integrate the surface scan, when using the "Start and Edit" option. This can be useful for determining the angular dependence of the light passing onto a complete camera pixel.</li>
  526.    </ol><br/>
  527.  
  528.    <p>11.8.2016 (Rev 167):</p>
  529.    <ol type="a">
  530.       <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>
  531.       <li>Added the possibility to export plots created through analysis ("Start and edit" option).</li>
  532.       <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>
  533.       <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>
  534.       <li>Normalization to a maximum of 1 now works for surface scans.</li>
  535.    </ol><br/>
  536.  
  537.    <p>4.4.2016 (Rev 146):</p>
  538.    <ol type="a">
  539.       <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>
  540.       <li>Added support for relative PDE measurements with included sample rotation table.</li>
  541.       <li>Improvement of analysis part of the program (includes ADC spectrum integration, breakdown voltage characterization, surface scans, relative PDE characterization,...).</li>
  542.       <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>
  543.       <li>Connection to temperature data and oscilloscope currently under development.</li>
  544.       <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>
  545.    </ol><br/>
  546.  
  547.    <p>17.7.2015 (Rev 129):</p>
  548.    <ol type="a">
  549.       <li>Fixed a problem with ADC peak fitting (peak fitting returning a segmentation fault).</li>
  550.       <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>
  551.       <li>Temperature data can only be retrieved when connected to the IJS network (IP = 178.172.43.xxx) and is disabled otherwise.</li>
  552.       <li>The relative PDE measurement now takes the incidence angle value directly from input files.</li>
  553.       <li>Currently, data acquisition only works on 32bit computers.</li>
  554.       <li>Fixed issue with program not correctly writting multiple channels.</li>
  555.    </ol><br/>
  556.  
  557.    <p>5.5.2015 (Rev 128):</p>
  558.    <ol type="a">
  559.       <li>Added a header display for opened files in the histogram file selection window. This enables a quicker view of the measurement information.</li>
  560.       <li>Added an incidence angle input to be able to save sample rotation angle to headers of files.</li>
  561.       <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>
  562.       <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>
  563.    </ol><br/>
  564.  
  565.    <p>9.4.2015 (Rev 127):</p>
  566.    <ol type="a">
  567.       <li>Added communications panel for connecting to a Tektronix scope.</li>
  568.       <li>Added limited support for waveform analysis with a Tektronix scope. For now, it only works when linking it to CAMAC acquisition.</li>
  569.       <li>Added a manual chamber temperature entry field.</li>
  570.    </ol><br/>
  571.  
  572.    <p>16.3.2015 (Rev 117):</p>
  573.    <ol type="a">
  574.       <li>First version of sipmscan.</li>
  575.       <li>Added support for CAMAC, bias voltage settings and table position settings.</li>
  576.       <li>Added support for opening measured histograms.</li>
  577.       <li>Added support for analysis:</li>
  578.       <ul>
  579.          <li>making surface plots</li>
  580.          <li>fitting the ADC spectrum</li>
  581.          <li>creating breakdown voltage plots</li>
  582.          <li>integrating the ADC spectrum with changing X or Y direction (edge scans)</li>
  583.       </ul>
  584.    </ol><br/>
  585.  
  586.    <div class="backtop"><a href="#top">Back to top</a></div>
  587.  
  588. </div>
  589.  
  590. </body>
  591. </html>
  592.