BNMR: Histograms and Scalers: Difference between revisions

From DaqWiki
Jump to navigation Jump to search
en>Suz
mNo edit summary
No edit summary
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
  {{Pagelinks}}
  {{Pagelinks}}
== Links ==
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* [[BNMR]]
* [[BNMR: Getting Started]]
</div>


== Introduction ==
== Introduction ==
In the [[BNMR: frontend|frontend]], data is read from the VME scaler(s) (SIS3801 or SIS3820) and saved in histograms. The number of histograms is greater than the number of active scaler channels. For example, some scaler data are saved in separate histograms according to the helicity.  In the case of Type 1 runs, the histograms are sent every cycle, whereas for Type 2 the histograms are accumulated in the frontend memory, and sent every few minutes.  A data logger running on the host computer saves the data onto disk. The data is handled differently for Type 1 and Type 2 runs. For Type 1 runs, the data are saved in a MIDAS file by mlogger, and converted to MUD format by mdarc. For Type 2 runs, mdarc saved the data directly in a MUD file, and no MIDAS file is produced.
The data from the {{bnmqr|join=or}} experiments largely consists of histogrammed scaler data.  The scaler data are read from the Multichannel Scaler(s) SIS3801 ({{bnmr}}) or SIS3820 ({{bnqr}}). The scaler data is histogrammed and saved differently depending on whether the run is Type 1 or Type 2.
 
The histograms and data logging will therefore be described separately for Type 1 and Type 2 runs.  


== Front-end histograms and Cycle Scalers ==
== Hardware ==
Currently,
* experiment  <span style="color:#7b68ee; font-style=italic">bnmr</span> has two SIS3801 scalers known as ''Scaler A'' and ''Scaler B''
* experiment <span style="color:#20b2aa; font-style=italic">bnqr</span> has one SIS3820 scaler, ''Scaler B''


=== Scaler Channels : Hardware Connections ===
<div id="sis3820_note"></div>
==== BNMR ====
; NOTE
: The sis3820 scaler is needed for <span style="color:#20b2aa; font-style=italic">bnqr</span> alpha mode as it has a larger buffer and greater resolution.
=== BNMR ===
BNQR has two scalers (SIS3801E), Scaler A and Scaler B.
==== Scaler A ====
{|  style="text-align: left; width: 80%; background-color: #e6e6ff;" border="3" cellpadding="2" cellspacing="2"
{|  style="text-align: left; width: 80%; background-color: #e6e6ff;" border="3" cellpadding="2" cellspacing="2"
|+  Table 1 : BNMR Scaler A Channels
|+  Table 1 : BNMR Scaler A Channels
! Scaler !! Module!!Experiment !! Channel !! Contents
! Scaler !! Module !! Channel !! Contents
|-   
|-   
| colspan="1" rowspan="2" style="width:10%; text-align:center" | A  
| colspan="1" rowspan="2" style="width:10%; text-align:center" | A  
| colspan="1" rowspan="2" style="width:20%; text-align:center" | SIS3801  
| colspan="1" rowspan="2" style="width:20%; text-align:center" | SIS3801  
| colspan="1" rowspan="2" style="width:10%; text-align:center" | BNMR
| 1 || Front scalers (16 segments summed in hardware)
| 1 || Front scalers (16 segments summed in hardware)
|-
|-
| 2 || Front scalers (16 segments summed in hardware)
| 2 || Front scalers (16 segments summed in hardware)
|-
|-
| colspan="5" style="background-color:#ccccff; font-weight:bold; text-align:center;"| Total number of real scaler inputs : 2
| colspan="4" style="background-color:#ccccff; font-weight:bold; text-align:center;"| Total number of real scaler inputs : 2
|}
|}


==== Scaler B ====
Input signals are not usually attached to the lowest two channels in Scaler B (Scaler Internal Clock and Fluorescence Monitor).
The data from the first input (Scaler Internal Clock) is used for testing as it should have a constant value in all bins. An external signal (e.g. pulser) is sometimes input to the Fluorescence Monitor input for testing.  The data from these inputs is read out and histogrammed.


{|  style="text-align: left; width: 80%; background-color: #e6e6ff" border="3" cellpadding="2" cellspacing="2"
{|  style="text-align: left; width: 80%; background-color: #e6e6ff" border="3" cellpadding="2" cellspacing="2"
|+  Table 2 : BNMR Scaler B Channels
|+  Table 2 : BNMR Scaler B Channels
! Scaler !! Module!!Experiment !! Channel !! Contents
! Scaler !! Module !! Channel !! Contents
|-   
|-   
| colspan="1" rowspan="5" style="width:10%; text-align:center" | B  
| colspan="1" rowspan="5" style="width:10%; text-align:center" | B  
| colspan="1" rowspan="5" style="width:20%; text-align:center" | SIS3801  
| colspan="1" rowspan="5" style="width:20%; text-align:center" | SIS3801  
| colspan="1" rowspan="5" style="width:10%; text-align:center" | BNMR
| 1 || Scaler Internal Clock (not connected)
| 1 || Scaler Internal Clock (not connected)
|-
|-
Line 49: Line 51:
| 9,10,11,12 || Neutral Beam Backwards counters (4)
| 9,10,11,12 || Neutral Beam Backwards counters (4)
|-
|-
| colspan="5" style="background-color:#ccccff; font-weight:bold; text-align:center;"| Total number of real scaler inputs : 12
| colspan="4" style="background-color:#ccccff; font-weight:bold; text-align:center;"| Total number of real scaler inputs : 12
|}
|}




==== BNQR ====
=== BNQR ===
==== Scaler B ====
BNQR has only one scaler (SIS3820), Scaler B.
 
Input signals are not usually attached to the lowest two channels (Scaler Internal Clock and Flueorescence Monitor).
The data from the first input (Scaler Internal Clock) is used for monitoring, as it should have a constant value in all bins. An external signal (e.g. pulser) is sometimes input to the Fluorescence Monitor input for testing.  The data from these inputs is read out and histogrammed in all experimental modes '''except Mode 2h (Alpha mode)'''.
 
 
{|  style="text-align: left; width: 80%; background-color: #b3ffff;" border="3" cellpadding="2" cellspacing="2"
{|  style="text-align: left; width: 80%; background-color: #b3ffff;" border="3" cellpadding="2" cellspacing="2"
|+  Table 3 : BNQR Scaler B Channels   
|+  Table 3 : BNQR Scaler B Channels   
! Scaler !! Module!!Experiment !! Channel !! Contents
!rowspan="2"| Scaler !! rowspan="2"| Module !! rowspan="2"| Channel !! rowspan="2"|Contents !! colspan="3"| Scaler Channel Active
|-
! Non-alpha Modes !! <span style=color:blue;font-weight:bold>*</span> 1h !! <span style=color:blue;font-weight:bold>**</span> 2h
|-   
|-   
| colspan="1" rowspan="6" style="width:10%; text-align:center" | B  
| colspan="1" rowspan="10" style="width:10%; text-align:center" | B  
| colspan="1" rowspan="6" style="width:20%; text-align:center" | SIS3820 <span style=color:red>**</span>
| colspan="1" rowspan="10" style="width:20%; text-align:center" | SIS3820 <span style=color:red>*</span>
| colspan="1" rowspan="6" style="width:10%; text-align:center" | BNQR
| 1 || Scaler Internal Clock (not connected) || Y || Y || '''N'''  <span style=color:red;font-weight:bold>*</span>
| 1 || Scaler Internal Clock (not connected)
|-
| 17 || Fluorescence Monitor (not used)
|-
| 18,19 || Polarimeter counters (2)
|-
|-
| 20 || Neutral Beam Forwards counter (summed in hardware)
| 17 || Fluorescence Monitor (not used)|| Y || Y || '''N'''  <span style=color:red;font-weight:bold>*</span>
|-
|-
| 21 || Neutral Beam Backwards counter (summed in hardware)
| 18,19 || Polarimeter counters (2)|| Y || Y || Y
|-
|-
| 22,23,24,25 || Alpha Counters
| 20 || Neutral Beam Forwards counter (summed in hardware)|| Y || Y || Y
|-
|-
| colspan="5" style=" background-color: #e6ffff; font-weight:bold; text-align:center;"| Total number of real scaler inputs : 10
| 21 || Neutral Beam Backwards counter (summed in hardware)|| Y || Y || Y
|- style="background-color:#94b8b8"
| 22  || Left.Alpha (ALPHA1) || N || Y || Y
|- style="background-color:#94b8b8"
| 23 || Right.Alpha (ALPHA2) || N || Y || Y
|- style="background-color:#94b8b8"
| 24 || Left.AlphaBar (ALPHA3) || N || Y || Y
|- style="background-color:#94b8b8"
| 25 || Right.AlphaBar (ALPHA4) || N || Y || Y
|- style=" background-color: #e6ffff; font-weight:bold; text-align:center;"
| colspan="2" style=" background-color: #e6ffff; font-weight:bold; text-align:center;"| Total number of real scaler inputs || 6 || 10 || 8
|}
|}


;NOTE
;NOTES
: <span style=color:red>**</span> SIS3820 module has ECL inputs 1-16, NIM 17-32. Therefore BNQR's input channel start at 17 (NIM).
The highest four Scaler inputs are used for the '''Alpha Counters'''.
 
These are ignored in all experimental modes except for
 
* '''1h''' <span style=color:blue;font-weight:bold>*</span> (i.e. experimental mode "1f" where the Alpha counters have been selected)
 
'''2h''' <span style=color:blue;font-weight:bold>**</span> (Alpha mode)
 
== Midas histograms built in the frontend ==
 
=== Type 1 ===
<span style= "color:#FF0000">Only includes data from last cycle.</span>
 
 
'''Table 4: Scaler A histograms ''' ({{bnmr}} only)
<table BORDER WIDTH="50%" NOSAVE  style="background-color: #e6e6ff;">
<tr>
<td><b>Scaler A</b></td>
<td><b>Channel</b></td>
<td>
<center><b>Histogram no.</b></center>
</td>
 
<td>
<center><b>Midas Bankname</b></center>
</td>
</tr>
 
<tr>
<td>sum Back scalers</td>
<td>0</td>
<td>
<center>h0</center>
</td>
 
<td>
<center>HIBP</center>
</td>
</tr>
 
<tr>
<td>sum Front scalers 16-31</td>
<td>1</td>
<td>
<center>h1</center>
</td>
 
<td>
<center>HIFP</center>
</td>
</tr>


<tr>
<span style=color:red;font-weight:bold>**</span> In Alpha mode the two lowest scaler channels (see above) are ignored in order to save memory.
<td>userbits</td>


<td>
<span style=color:red;font-weight:bold>*</span> SIS3820 module has ECL inputs 1-16, NIM 17-32. Therefore BNQR's input channel start at 17 (NIM).
<center>h2</center>
</td>


<td>
== Software ==
<center>UBIT</center>
</td>


<tr><td colspan=4 style="font-weight:bold; text-align:center; background-color:#ccccff;"> Total number of histograms: 3</td></tr>
=== Scaler readout ===
</table>


<p>6 histograms from Scaler B:
The Scaler Modules contain a buffer (FIFO) for the data. This FIFO is larger in the SIS3820 module than the SIS3801, so the SIS3820 can buffer more data. During the PPG cycle, the scaler time bins collect data in turn as the PPG steps through the time bins (via PPG MCS Next output signal connected to Scaler LNE input).
'''Table 5 : Scaler B histograms'''  ({{bnmr}})
This data is stored in the Scaler FIFO. During the PPG cycle, the scaler data is read out periodically, ensuring that the FIFO does not become full.
<table BORDER WIDTH="50%" NOSAVE style="background-color: #e6e6ff;">
<tr>
<td><b>Scaler B </b></td>
<td><b>Channel</b></td>


<td>
The selected format of the scaler data is "24-bit", where the channel and user-bits are encoded in the top 8 bits of the 32-bit data word, and the data is in bits 0-23. See Manual for details. 
<center><b>Histogram no.</b></center>
</td>


<td>
=== Histograms ===
<center><b>Midas Bankname</b></center>
Histograms are built by a combination of the [[BNMR:_frontend|frontend]] and the [[BNMR:_Data_Logging#Histograms|data logger]]. Various manipulations can be performed on the data read from the scalers, with different manipulations for Type 1 (TI/integral) and Type 2 (TD/time-differential) modes.
</td>
</tr>


<tr>
==== Type 1 histograms ====
<td>sum scaler B (scaler clock)</td>
The final output of Type 1 (integral) runs are histograms with one bin per cycle/super-cycle. I.e. if the MCS has 100 bins per PPG cycle and we run for 20 cycles, the final histogram will be 20 bins long. In general all 100 time bins are summed together to create the final output bin. The final histogram is effectively an array of counts per cycle as the run progresses.
<td>1</td>
<td>
<center>h3</center>
</td>


<td>
The '''frontend''' does very little manipulation to the data, and just sends the full data for each cycle to the MUD logger.
<center>HM00</center>
</td>
</tr>


<tr>
The '''logger''' can perform a few manipulations on the data:
<td>sum scaler B (fluorescence mon)</td>
* Create separate histograms based on the helicity polarity, with <code>+</code> or <code>-</code> appended to the histogram title. If the helicity is <code>+</code> and the data for a cycle looks like <code>1,2,3,4</code>, <code>10</code> would be appended to <code>histo_name+</code> and 0 appended to <code>histo_name-</code>.
<td>2</td>
* Create separate histograms based on the user bits. This is currently quite specific, with hard-coded suffixes like <code>_frq0</code> and <code>_ref0</code> appended to the histogram titles. If the data for a cycle looks like <code>1,2,3,4</code> with corresponding user bits <code>0,2,0,2</code>, <code>4</code> would be appended to <code>histo_name_frq0</code> and 6 appended to <code>histo_name_ref0</code>
<td>
* Create separate histograms based on bin ranges. Some modes state that certain ranges of bins should be summed separately (e.g. a signal region and a background region). The configuration is generally set up by the RF calculator, which can set both the bin ranges and the suffixes to add to the histogram ranges.
<center>h4</center>
</td>


<td>
==== Type 2 histograms ====
<center>HM01</center>
The final output of Type 2 (differential) runs are histograms with one bin per time bin. I.e. if the MCS has 100 bins per PPG cycle and we run for 20 cycles, the final histogram will be 100 bins long.
</td>
</tr>


<tr>
The '''frontend''' can perform a few manipulations on the data:
<td>sum scaler B  (pol monitor 1)</td>
* Create separate histograms based on the helicity polarity.
<td>3</td>
* Create separate histograms based on the microwave sample/reference state (for some {{bnqr}} modes).
<td>
<center>h5</center>
</td>


<td>
The '''logger''' does very little manipulation to the data, and just writes the banks it receives from the frontend as MUD histograms.
<center>HM02</center>
</td>
</tr>


<tr>
=== Software scalers ===
<td>sum scaler B 3 (pol monitor 2)</td>
The frontend can compute various numerical values based on the data read from the MCS. The values can be:
<td>4</td>
* Per-run or per-cycle
<td>
* Sums of one or more channels
<center>h6</center>
* Ratios/asymmetries of two channels
</td>
* Specific or agnostic to a helicity polarity, microwave sample/reference state, user bit value


<td>
These values can be recorded in EPICS, in the ODB, and as a bank sent to the logger (called <code>HSCL</code>). Many of these values are shown on the status page of the experiment. The MUD logger only writes the values to file for type 2 runs (historical reasoning unknown).
<center>HM03</center>
</td>
</tr>


<tr>
=== Configuration ===
<td>sum scaler B (Backwards&nbsp; neutral beam monitors)</td>
<td>5-8</td>
<td>
<center>h7</center>
</td>


<td>
The frontend configuration is rather complex, but doesn't change often, so is done in the frontend code itself. This includes defining the midas bank names that will be used to send data to the logger.
<center>HM04</center>
</td>
</tr>


<tr>
The MUD logging configuration is done via the ODB at {{Odbpath|path=/MUD Logging/Histos/Settings}}. This includes specifying what to do with each midas bank that the logger receives from the frontend. It is most easily edited using the [[BNMR:_Custom_Logging_page|logging webpage]].
<td>sum scaler B  (Forwards&nbsp; neutral beam monitors)</td>
<td>9-12</td>
<td>
<center>h8</center>
</td>


<td>
[[Category:BNMR]]
<center>HM05</center>
</td>
</tr>
<tr><td colspan=4 style="font-weight:bold; text-align:center; background-color:#ccccff;"> Total number of histograms: 6</td></tr>
</table>

Latest revision as of 16:54, 29 April 2022

Introduction

The data from the bnmr or bnqr experiments largely consists of histogrammed scaler data. The scaler data are read from the Multichannel Scaler(s) SIS3801 (bnmr) or SIS3820 (bnqr). The scaler data is histogrammed and saved differently depending on whether the run is Type 1 or Type 2.

Hardware

Currently,

  • experiment bnmr has two SIS3801 scalers known as Scaler A and Scaler B
  • experiment bnqr has one SIS3820 scaler, Scaler B
NOTE
The sis3820 scaler is needed for bnqr alpha mode as it has a larger buffer and greater resolution.

BNMR

BNQR has two scalers (SIS3801E), Scaler A and Scaler B.

Scaler A

Table 1 : BNMR Scaler A Channels
Scaler Module Channel Contents
A SIS3801 1 Front scalers (16 segments summed in hardware)
2 Front scalers (16 segments summed in hardware)
Total number of real scaler inputs : 2

Scaler B

Input signals are not usually attached to the lowest two channels in Scaler B (Scaler Internal Clock and Fluorescence Monitor).

The data from the first input (Scaler Internal Clock) is used for testing as it should have a constant value in all bins. An external signal (e.g. pulser) is sometimes input to the Fluorescence Monitor input for testing. The data from these inputs is read out and histogrammed.

Table 2 : BNMR Scaler B Channels
Scaler Module Channel Contents
B SIS3801 1 Scaler Internal Clock (not connected)
2 Fluorescence Monitor (not used)
3,4 Polarimeter counters (2)
5,6,7,8 Neutral Beam Forwards counters (4)
9,10,11,12 Neutral Beam Backwards counters (4)
Total number of real scaler inputs : 12


BNQR

Scaler B

BNQR has only one scaler (SIS3820), Scaler B.

Input signals are not usually attached to the lowest two channels (Scaler Internal Clock and Flueorescence Monitor). The data from the first input (Scaler Internal Clock) is used for monitoring, as it should have a constant value in all bins. An external signal (e.g. pulser) is sometimes input to the Fluorescence Monitor input for testing. The data from these inputs is read out and histogrammed in all experimental modes except Mode 2h (Alpha mode).


Table 3 : BNQR Scaler B Channels
Scaler Module Channel Contents Scaler Channel Active
Non-alpha Modes * 1h ** 2h
B SIS3820 * 1 Scaler Internal Clock (not connected) Y Y N *
17 Fluorescence Monitor (not used) Y Y N *
18,19 Polarimeter counters (2) Y Y Y
20 Neutral Beam Forwards counter (summed in hardware) Y Y Y
21 Neutral Beam Backwards counter (summed in hardware) Y Y Y
22 Left.Alpha (ALPHA1) N Y Y
23 Right.Alpha (ALPHA2) N Y Y
24 Left.AlphaBar (ALPHA3) N Y Y
25 Right.AlphaBar (ALPHA4) N Y Y
Total number of real scaler inputs 6 10 8
NOTES

The highest four Scaler inputs are used for the Alpha Counters. These are ignored in all experimental modes except for

  • 1h * (i.e. experimental mode "1f" where the Alpha counters have been selected)
  • 2h ** (Alpha mode)

** In Alpha mode the two lowest scaler channels (see above) are ignored in order to save memory.

* SIS3820 module has ECL inputs 1-16, NIM 17-32. Therefore BNQR's input channel start at 17 (NIM).

Software

Scaler readout

The Scaler Modules contain a buffer (FIFO) for the data. This FIFO is larger in the SIS3820 module than the SIS3801, so the SIS3820 can buffer more data. During the PPG cycle, the scaler time bins collect data in turn as the PPG steps through the time bins (via PPG MCS Next output signal connected to Scaler LNE input). This data is stored in the Scaler FIFO. During the PPG cycle, the scaler data is read out periodically, ensuring that the FIFO does not become full.

The selected format of the scaler data is "24-bit", where the channel and user-bits are encoded in the top 8 bits of the 32-bit data word, and the data is in bits 0-23. See Manual for details.

Histograms

Histograms are built by a combination of the frontend and the data logger. Various manipulations can be performed on the data read from the scalers, with different manipulations for Type 1 (TI/integral) and Type 2 (TD/time-differential) modes.

Type 1 histograms

The final output of Type 1 (integral) runs are histograms with one bin per cycle/super-cycle. I.e. if the MCS has 100 bins per PPG cycle and we run for 20 cycles, the final histogram will be 20 bins long. In general all 100 time bins are summed together to create the final output bin. The final histogram is effectively an array of counts per cycle as the run progresses.

The frontend does very little manipulation to the data, and just sends the full data for each cycle to the MUD logger.

The logger can perform a few manipulations on the data:

  • Create separate histograms based on the helicity polarity, with + or - appended to the histogram title. If the helicity is + and the data for a cycle looks like 1,2,3,4, 10 would be appended to histo_name+ and 0 appended to histo_name-.
  • Create separate histograms based on the user bits. This is currently quite specific, with hard-coded suffixes like _frq0 and _ref0 appended to the histogram titles. If the data for a cycle looks like 1,2,3,4 with corresponding user bits 0,2,0,2, 4 would be appended to histo_name_frq0 and 6 appended to histo_name_ref0
  • Create separate histograms based on bin ranges. Some modes state that certain ranges of bins should be summed separately (e.g. a signal region and a background region). The configuration is generally set up by the RF calculator, which can set both the bin ranges and the suffixes to add to the histogram ranges.

Type 2 histograms

The final output of Type 2 (differential) runs are histograms with one bin per time bin. I.e. if the MCS has 100 bins per PPG cycle and we run for 20 cycles, the final histogram will be 100 bins long.

The frontend can perform a few manipulations on the data:

  • Create separate histograms based on the helicity polarity.
  • Create separate histograms based on the microwave sample/reference state (for some bnqr modes).

The logger does very little manipulation to the data, and just writes the banks it receives from the frontend as MUD histograms.

Software scalers

The frontend can compute various numerical values based on the data read from the MCS. The values can be:

  • Per-run or per-cycle
  • Sums of one or more channels
  • Ratios/asymmetries of two channels
  • Specific or agnostic to a helicity polarity, microwave sample/reference state, user bit value

These values can be recorded in EPICS, in the ODB, and as a bank sent to the logger (called HSCL). Many of these values are shown on the status page of the experiment. The MUD logger only writes the values to file for type 2 runs (historical reasoning unknown).

Configuration

The frontend configuration is rather complex, but doesn't change often, so is done in the frontend code itself. This includes defining the midas bank names that will be used to send data to the logger.

The MUD logging configuration is done via the ODB at /MUD Logging/Histos/Settings. This includes specifying what to do with each midas bank that the logger receives from the frontend. It is most easily edited using the logging webpage.