|
| 1 | +# Calibrations |
| 2 | + |
| 3 | +## Events per BC Calibration |
| 4 | +### Description |
| 5 | +Generates histograms of **TVX per Bunch Crossing (BC)**. Events can be filtered by applying amplitude thresholds to the **A-side** and **C-side**. |
| 6 | + |
| 7 | +### Command-Line Options |
| 8 | +| Option | Default | Description | |
| 9 | +| :--- | :--- | :--- | |
| 10 | +| `--slot-len-sec` | `3600` | Duration of each slot in seconds. | |
| 11 | +| `--slot-len-tf` | `0` | Slot length in Time Frames (TFs). | |
| 12 | +| `--one-object-per-run` | — | If set, the workflow creates only one calibration object per run. | |
| 13 | +| `--min-entries-number` | `0` | Minimum number of entries required for a slot to be valid. | |
| 14 | +| `--min-ampl-side-a` | `-2147483648` | Amplitude threshold for Side A events. | |
| 15 | +| `--min-ampl-side-c` | `-2147483648` | Amplitude threshold for Side C events. | |
| 16 | + |
| 17 | +--- |
| 18 | + |
| 19 | +## How to Run |
| 20 | + |
| 21 | +### Simulation Data |
| 22 | +To process simulation data, digits must first be converted to RAW format. The `o2-ft0-digi2raw` tool performs this conversion and generates the required configuration file. |
| 23 | + |
| 24 | +Once converted, you can run the calibration either as a single integrated workflow or by spawning as the sender and receiver components separately. |
| 25 | + |
| 26 | +#### Single Workflow Example |
| 27 | +Execute the following command within the simulation directory: |
| 28 | +``` |
| 29 | +o2-raw-file-reader-workflow --input-conf FT0raw.cfg --loop -1 \ |
| 30 | +| o2-ft0-flp-dpl-workflow --condition-backend=http://localhost:8080 \ |
| 31 | +| o2-calibration-ft0-events-per-bc-processor --FT0EventsPerBcProcessor "--slot-len-sec=10" \ |
| 32 | +| o2-calibration-ccdb-populator-workflow --ccdb-path=http://localhost:8080 |
| 33 | +``` |
| 34 | + |
| 35 | +Sender example (in simulation directory): |
| 36 | +``` |
| 37 | +o2-raw-file-reader-workflow --input-conf FT0raw.cfg --loop -1 \ |
| 38 | +| o2-ft0-flp-dpl-workflow --condition-backend=http://localhost:8080 \ |
| 39 | +| o2-dpl-output-proxy --channel-config "name=downstream,method=connect,address=tcp://localhost:30453,type=push,transport=zeromq" --dataspec "downstream:FT0/DIGITSBC" |
| 40 | +``` |
| 41 | + |
| 42 | +Receiver example: |
| 43 | +``` |
| 44 | +o2-dpl-raw-proxy --channel-config "name=readout-proxy,type=pull,method=bind,address=tcp://localhost:30453,rateLogging=1,transport=zeromq" --dataspec "A:FT0/DIGITSBC/0" \ |
| 45 | +| o2-calibration-ft0-events-per-bc-processor --FT0EventsPerBcProcessor "--slot-len-sec=10 --min-ampl-side-a=0" \ |
| 46 | +| o2-calibration-ccdb-populator-workflow --ccdb-path=http://localhost:8080/ |
| 47 | +``` |
| 48 | + |
| 49 | +### CTF Data |
| 50 | +Example: |
| 51 | +``` |
| 52 | +o2-ctf-reader-workflow --ctf-input ctf.root --onlyDet FT0 \ |
| 53 | +| o2-calibration-ft0-events-per-bc-processor --FT0EventsPerBcProcessor "--slot-len-sec=10" \ |
| 54 | +| o2-calibration-ccdb-populator-workflow --ccdb-path=http://localhost:8080/ |
| 55 | +``` |
0 commit comments