Plane Geometry

The plane geometry here defines the size, position, angle, etc. of the detector planes (i.e. hodoscopes, drift chambers and prop tubes). This page materially explains how to update the channel mapping. The update operation has to be done only by the online software manager at present.

Location of Parameter Sets

All parameter sets are stored as TSV files under /data2/e1039/resource/geom. Each of them is uploaded to MySQL DB when created, and then the one on MySQL DB is usually used by the E1039 software.

We have only one type of the parameter set, which is "plane" under /data2/e1039/resource/geom/plane. We will need "alignment" at least.

Name of Parameter Set

One parameter set must be given a unique name (or ID). It can be any string but is usually a 10-digit number as "[year][month][day][serial]".

Update Procedure

We assume, as an example, the name of the latest parameter set is G9_run5_2 and that of the new one you are creating is 2022022101.

1. Create a directory for the new mapping, by copying the previous one:

   cd /data2/e1039/resource/geom/plane
   cp -a G9_run5_2 2022022101
   

2. Edit 2022022101/param.tsv to introduce the change you want.
3. Edit 2022022101/00readme.txt to explain the change as much as possible.
4. Add a run range for the new mapping by editing run_range.tsv.
5. Upload the new parameter set to MySQL DB, by using a wrapper script:

   /data2/e1039/core/default/macros/packages/geom_svc/upload-param.sh geom plane 2022022101