Search/Navigation:
Related:
SLAC/EPP/HPS Public
Jefferson Lab/Hall B/HPS Run Wiki
S30XL-LESA/LDMX
EVIO (Event IO) is the raw data format used by the DAQ event builder. The structure of an EVIO file is a tree of banks, each of which has a header and a data payload.
Each EVIO bank has a data type a tag and a num. The type corresponds to the contents of the bank.
data_type | Size | content | notes |
---|---|---|---|
0x0c,0x0d,0x0e,0x10,0x20,0x40 | N | container | this is a bank that contains other banks |
0x00, 0x01 | 4 | uint32_t | unsigned integers |
0x02 | 4 | float | |
0x0b | 4 | int | signed integers |
0x0f | N | compound type | FADC (or other!) compound format. |
0x03 | 1 | char | char |
0x06 | 1 | int8_t = char | char |
0x07 | 1 | uint8_t | unsigned char |
0x04 | 2 | int16_t | short |
0x05 | 2 | uint16_t | unsigned short |
0x08 | 8 | double | |
0x09 | 8 | int64_t | long |
0x0a | 8 | uint64_t | unsigned long |
Source: EVIO C++ code data parser.
Note: The 0x0f compound type data contains a string that tells you what the layout of the data is. See EVIO documentation.
On the CLON machines, in the directory pointed to by $CLON_PARMS, is the file "clonbanks.xml", which contains the "dictionary" for the EVIO contents of various bank tags used in the data.
The very top bank in an event tree is usually a container bank (0x10). The "tag" of this bank indicates the event type. The event types used for the 2015 data set of HPS are listed below. Note that this is set by the DAQ configuration and is thus subject to change. Currently 16 - 32 are special event types, all others are "Physics" events. For physics events, the number is a bit encoded state of the trigger, with the high bit, bit 7, set. Thus physics events start at 128 and go up. The bit 6 encodes a "sync" event, which will contain scalers.
Event type # | Name | Notes |
---|---|---|
17 | Pre Start | Indicates the "pre-start" transition in the DAQ |
18 | Go | Indicates the user pressed "Go" on DAQ |
19 | Pause | Indicates the user pressed "Pause" on DAQ |
20 | End | End of run marker event. |
31 | Epics | Epics event - Slow controls data that is injected into the data stream. |
Bit 7 | Physics | Physics events should have bit 7 set |
Bit 6 | Sync | Sync events (containing scalers and trigger config) should have bit 6 set. (Note: The 1st event in the run will be a sync event, but does not always have the sync bit set.) |
Bit 5 | Pulser | The pulser triggered the event. |
Bit 4 | LED/Cosmic | LED or Cosmic trigger. |
Bit 3 | Pairs 1 | Indicates a Pair1 trigger. |
Bit 2 | Pairs 0 | Indicates a Pair0 trigger. |
Bit 1 | Single 1 | Indicates a Single1 trigger. |
Bit 0 | Single 0 | Indicates a Single0 trigger. |
Below is a list of the banks and tags used in the 2015 Engineering Run for HPS. Note that the bank numbers and tags used are chosen by the DAQ configuration, and are thus subject to change.
Parent bank | tag | tag hex | Name | Notes |
---|---|---|---|---|
event type 17 | 17 | 0x11 | Prestart | Only bank in pre-start event |
event type 18 | 18 | 0x12 | Go | Only bank in go event |
event type 31 | 129 | 0x81 | Epics | Epics mother bank |
|- | 57618 | 0xe112 | Epics header | Epics header bank |
|- | 57620 | 0xe114 | Epics string | Epics string bank - contains the epics data in one long string of value-key pairs. |
57621 | 0xe115 | Scalers | Scaler banks | |
0xe101 | ||||
Physics event | >128 | bit 7 set | Physics | |
|- | 49152 | 0xc000 | Event ID | |
|- | 37,39,46,58 | 0x25,0x27,0x2e,0x3a |
|
Crate Name | Contents | Tag | Tag Hex |
---|---|---|---|
hps11 | SSP, ECal Bottom Disc/TDCs/Scalers, RF FADC | 46 | 0x2e |
hps12 | ECal Top & RF Disc/TDCs/Scalers | 58 | 0x3a |
hps1 | ECal Top FADC | 37 | 0x25 |
hps2 | ECal Bottom FADC, Faraday Cup Disc/Scalers | 39 | 0x27 |
Index | Prestart bank | 0x11 (17) |
---|---|---|
0 | start time | unix timestamp |
1 | run number | |
2 | file number |
Index | GO bank | 0x12 (18) |
---|---|---|
0 | start time | unix timestamp |
1 | 0 |
|
1 | 0 |
Head Bank
index | HEAD bank | 0xe10F (57615) |
---|---|---|
0 | version number | |
1 | run number | |
2 | event number | |
3 | event unix_time | |
4 | event type | |
5 | roc pattern | |
6 | event classification | 17,18,20,etc |
7 | Trigger bits |
index | EVENT ID bank | 0xc000 (49152) |
---|---|---|
0 | Event number | |
1 | TI trigger bits? | |
2 | Readout Status | should be 0 |
index | Scaler bank | 0xe115 (57621) |
---|---|---|
0-2 | header? | |
3 | gated faraday cup with "TDC" threshold | |
19 | gated faraday cup with "TRG" threshold | |
35 | ungated faraday cup with "TDC" threshold | |
51 | ungated faraday cup with "TRG" threshold | |
67 | gated clock | |
68 | ungated clock |
index | Epics Header Bank | 0xe112 (57618) |
---|---|---|
0 | 0 | ? |
1 | Run number | |
2 | Sequence # | |
3 | Time Stamp | |
4 | 0x1f | ? |
index | Epics Sting Bank | 0xe114 (57620) |
---|---|---|
0 | Epics String | See details below |
Epics name | Meaning | Notes |
---|---|---|
MBSY2C_energy | Beam energy according to Hall B BSY dipole "bus" | |
ARCx:p | Beam energy measured in Arc "x" ; e.g. ARC2:p | x=12...9A |
PSPECIRBCK | Pair Spectrometer Current Readback | |
HPS:LS450_2:FIELD | Frascati probe field | |
HPS:LS450_1:FIELD | Pair Spectrometer probe field | |
MTIRBCK | Frascati Current Readback | |
VCG2C21 | 2C21 Vacuum gauge pressure | |
VCG2C21A | 2C21A Vacuum gauge pressure | |
VCG2C24A | 2C24A Vacuum gauge pressure | |
VCG2H00A | 2H00 Vacuum gauge pressure | |
VCG2H01A | 2H01 Vacuum gauge pressure | |
VCG2H02A | 2H02 Vacuum gauge pressure | |
scaler_calc1 | Faraday cup current | |
scalerS12b | HPS-Left beam halo count | |
scalerS13b | HPS-Right beam halo count | |
scalerS14b | HPS-Top beam halo count | |
scalerS15b | HPS-SC beam halo count | |
hallb_IPM2C21A_XPOS | Beam position X at 2C21 | |
hallb_IPM2C21A_YPOS | Beam position Y at 2C21 | |
hallb_IPM2C21A_CUR | Current at 2C21 | |
hallb_IPM2C24A_XPOS | Beam position X at 2C24 | |
hallb_IPM2C24A_YPOS | Beam position Y at 2C24 | |
hallb_IPM2C24A_CUR | Current at 2C24 | |
hallb_IPM2H00_XPOS | Beam position X at 2H00 | |
hallb_IPM2H00_YPOS | Beam position Y at 2H00 | |
hallb_IPM2H00_CUR | Current at 2H00 | |
hallb_IPM2H02_YPOS | Beam position X at 2H02 | |
hallb_IPM2H02_XPOS | Beam position Y at 2H02 |