History: GEnDocChannelMap

The neutron arm database is a database of scintillators. In the database there are tags which tell the analyzer where to find the information. In later databases there are 11 sections: 7 for the neutron planes, 2 for the veto planes, 1 for the neutron sums and 1 for the marking signals. These are all laid out in the global section, which is denoted by the tags:
[ na.global ] and [ na.global.done ]
In this section, the variable name is followed by a descriptive name of
the detectors. This variable name follows the neutron detector identifier, so that for the marking signals (m1) we have na.nd.m1.*

Every variable section has some required tags. These are the cratemap.tdc, cratemap.adc, calib, and pedestal (left/right) tags. These tags are just added after the variabe name. For example, na.nd.s1.left_pedestal gives the section that gives the values for the summing signals left pedestal while na.nd.n7.cratemap.tdc gives the information of what detector is associated with which TDC channel. Other tags are the time offsets (left_toff and right_toff) and the gain factors (left_gain and right_gain).

In GEn we used only one type of ADC. This was in crate 24, and was model number 1881. For a given tag (like [ na.nd.n6.cratemap.adc ]) an entry would look like:
24 21 4 4 1881
Here the 21 is the slot, and the two 4s give the beginning channel and ending channel respectively. Each additionally entry provides the information for the next detector, beginning with 0 and going until every detector has an associated channel. For a blank spot the entry:
24 0 0 0 1881
should be used. The left detectors are done first, when they are done, an entry beginning with -1 is used to denote that the right detectors are being done. For the marking signals, left is up and right is down. An example of the entry used for the ADCs is:
-1 0 0 0 1881

We used two types of TDCs in this experiment. For the F1 TDCs (crate 25) there is a reference channel initially. This was (for the experiment):
25 13 32 32 6401 -1
Where the -1 at the end denotes reference channel, and the 6401 denotes the model name. Here once more the 13 is the slot, and the two 32s are the beginning channel and ending channel (respectively). After the reference channel, the left side is done first (like for ADCs). The entry used to denote a change in the type of entry being done (reference, left, right) is (it also occurs at the end)
-1 0 0 0 0 0
Only the neutron detectors used this TDC. An example 0 entry is
25 1 0 0 6401 0
The other type of TDC was fastbus. It was model 1877, and was in crate 24.
An example entry for this is
24 14 16 29 1877 0
These TDCs also must begin with an initializing entry (and end with it, and use it to denote the switch from left to right), this entry is
-1 0 0 0 1881
The Sums, Vetos, and Marking signals used this type of TDC.

The tags that end in right_???? or left_???? all behave the same way. The line following the tag, such as
0 44
denotes the range of detectors. Following this are lines which contain the proper values for the detector starting from the first detector in range (0) and ending at the last detector in range (44). These are in sections of 5, and are seperated by a space. An example:
-8.2 -7.6 -9.2 -8.2 -16.8
The last tag is the calib one. In example of this tag is [ na.nd.n6.calib ]. For the Neutron detectors the first two lines are
0 0
0.1183
Where the 0.1183 is the multiplicative factor to get nanoseconds from
channels. For all detectors the next section (which is the first section for the Veto, Marking and Summing Signals and can repeat as needed) is similiar. In this section it begans by detailing the number of detectors which is being calibrated in the second, for example (for [ na.nd.n7.calib ])
0 39
followed by a line like
2.302 0.0 0.840 -0.095 0. 0.
where the vales are the x, y, z and dx, dy, and dz. The next line is
0.095 1.60 0.10
which denotes the xw, yw, and zw. Then the line
0.147 1.e8
which are the variables c (speed of light for the type of bar) and att
(attenuation). Finally there are two lines which denote information about the two sides (left and than right) (for example)
1. 0 0.1183 0.0 0.0 -500 100 65526
Here the values are a calib for gain, pedestal, resolution (multiplicative factor), time offsets (toff), time walk (walk), low tdc limit (for example llowtdclim), up tdc limit(for example luptdclim), and wrap point (for example lwrapa). This can be repeated for a different sort of detector. For example, the next line for plane 7 of the neutron arm is
40 44