Files
tina/help/index.html

167 lines
5.7 KiB
HTML
Executable File

<html><head><title>Time of Flight Measuement for Injector and Ring Cyclotron Turn Number Ascertainment, TINA</title></head>
<body>
<h5 style="color:gray;">Jan Chrin, Pierre-Andr&eacute; Duperrex, Alessandro Facchetti, Daniele Felici, Waldamar Koprek, Jilei Sun<br>April 2025</h5>
<h4> <span style="color: red;">T</span>ime of Flight Measurement for <span style="color: red;">I</span>njector and Ring Cyclotron Turn <span style="color: red;">N</span>umber <span style="color: red;">A</span>scertainment, <span style="color: red;">TINA</span></h4>
<h2 style="color:blue;">About</h2>
<p>The TINA application determines the number of turns in a cyclotron
from a Time of Flight (TOF) measurement technique and a cross-correlation
of fast sampled data from capacitive sensors located at the entrance and exit
of the cycolotron. This is based on a python implementation of a LabVIEW application developed by
Pierre-Andr&eacute; Duperrex: <br>
P.-A. Duperrex and A. Facchetti,
Number of Turn Measurements on the HIPA Cyclotrons at PSI.<br>
doi:10.18429/JACoW-IPAC2018-WEPAL067
</p>
<h3 style="color:#7b68ee;">Changelog</h3>
August 2025: Hilbert transform applied to signals.
<!--a href="page1.html">here</a></p-->
<h2 style="color:blue;">The Repository</h2>
<p>The application comprises two components:
<ul>
<li>
The low-level ADC data acquisition system is detailed in the following repositories:<br>
<span style="color: green;">https://git.psi.ch/GFA/CO/general/CPSI_SCOPE/CPSI_SCOPE</span><br>
<span style="color: green;">https://git.psi.ch/epics_iocboot_hipa/z_di_turn_count</span><br>
</li>
<li>
A High Level Application (HLA) that is able to interact with the IOC, start a low-level data acquistion run,
acquire the raw data, and perform the number of terms analysis.<br>
<span style="color: green;"> https://gitlab.psi.ch/hipa_apps4ops/tina</span><br>
<span style="color: gray;"> /hipa/bd/applications/tina/latest/tina.sh</span>
</li>
</ul>
<h2 style="color:blue;">GUI, Control Tab</h2>
Main panel for use by operators.
<h3 style="color:#7b68ee;">Accelerator Panel</h3>
Input parameters to analysis routine, as configured in tina.json.<br>
The Injector has NOT yet been implemented into the application.
<table width=400>
<tr> <td>
<table>
<caption>
<h4 style="color:#0047ab;">Cyclotron</h4>
</caption>
<thead>
<tr>
<th align=left>Parameter</th>
<th align=center>Value</th>
</tr>
</thead>
<tr><td>Harmonic No.</td> <td align=center>6</td></tr>
<tr><td>dT Cable (ns)</td> <td align=center>44</td></tr>
<tr><td>dN Pickup</td> <td align=center>-1</td></tr>
</table>
</td> <td width=20> &nbsp; </td>
<td> <table>
<caption>
<h4 style="color:#008b8b;">Injector</h4>
</caption>
<thead>
<tr>
<th align=left>Parameter</th>
<th align=center>Value</th>
</tr>
</thead>
<tr><td>Harmonic No.</td> <td align=center>10</td></tr>
<tr><td>dT Cable (ns)</td> <td align=center>6.9</td></tr>
<tr><td>dN Pickup</td> <td align=center>4</td></tr>
<tr><td>Mod. Freq. (GHz) &nbsp;</td> <td align=center>500</td></tr>
<tr><td>Duty Cycle (%)</td> <td align=center>1</td></tr>
</table>
</td>
</tr>
</table>
<h3 style="color:#7b68ee;">Expert Panel</h3>
Input parameters to the peak search analysis, as configured in tina.json.<br>
The Injector has NOT yet been implemented into the application.
<p>
<table width=1400px>
<tr> <td>
<table width=1000px>
<!--caption>
<h4 style="color:#0047ab;">Cyclotron</h4>
</caption-->
<thead>
<tr>
<th align=left>Parameter</th>
<th align=center style="color:#0047ab;">Cyclotron</th>
</tr>
</thead>
<tr><td>Minimum Peak Height:</td> <td align=center>50</td></tr>
<tr><td>Minimum distance between peaks:</td> <td align=center>10</td></tr>
<tr><td width=80%>Minimim difference in correlation between top two peaks:</td> <td valign=bottom align=center>0.01</td></tr>
<tr>
<td>Minimum Current in Injector:</td> <td align=center>1.0</td>
</tr>
</table>
</td> <td width=20> &nbsp; </td>
<td> <table width=200px>
<!--caption>
<h4 style="color:#008b8b;">Injector</h4>
</caption-->
<thead>
<tr>
<th align=center style="color:#008b8b;">Injector</th>
</tr>
</thead>
<tr><td align=center>50</td></tr>
<tr><td align=center>10</td></tr>
<tr><td align=center>&nbsp;</td></tr>
<tr><td align=center>0.01</td></tr>
<tr><td align=center>1.0</td></tr>
</table>
</td>
</tr>
</table>
<p>
The Oscilloscope option disables setting values to epics process variables and is meant for testing code with raw data collected from the oscilloscope and stored in hdf5 files: <br>
/hipa/bd/data/measurements/Tina_2024-09-18_oscilloscope.h5
<p>
<h4 style="color:#7b68ee;">Procedure</h4>
Within the Procedure group, the Start button executes the analysis program
which usually takes less than 10 seconds to complete. 3'010'560 samples are
collected per channel (entry wf/exit wf).
<p>
The SaveAll button:
<ul>
<li>writes the number of turns measured into an epics process variable,
</li>
<li>save the raw data to hdf5,
</li>
<li>opens a dialog window for submission to the selected elog book.
</li>
</ul>
These actions can also be executed individually through icons placed in the menu bar.
<p>
<font color=green>
Data can be recalled from hdf5 and reanalyzed using the HDF analysis functionality
made available through a docked widget in the menu bar (right click on the menu bar
and select the HDF5 option).
</font>
<h3 style="color:#7b68ee;">TINA Image</h3>
<table>
<tr><td>
<img src=":Tina.jpg" width=90 height=90/> &nbsp; </td><td>
Tina Turner</td>
</table>
<p>
</p>
</body></html>