For your convenience, we provide sets of common bitmasks for almost all of the PCA event modes**. You should check carefully that you are using the correct bitmask for your data configuration; often, the tools will be perfectly happy to operate with a bitmask which is not what you intended. If you want a different combination of detectors or anodes, you will have to make your own using sefilter following its recipe.
If the bitmask you need has an asterisk next to it, then the data will have to be filtered with fselect before extraction as explained in the selection recipe.
Find your data mode (as shown in the AppId window of XDF or in the keyword DATAMODE of the fits event list) in the first column; x indicates the binning (A,B,C,M, or N), ll is the lower channel boundary, and rr the readout time. The next three columns tell you what you can select from that configuration, and the last column has the link to the correct table for chosing a bitmask:
Event modes |
Mode | Can I select by ... | Bitmask Table |
---|
time marker? | detector? | layer? |
GoodXenon** |
NA |
YES |
YES |
Table 1 |
E_1us_1x_ll_rr
E_2us_2x_ll_rr
E_4us_4x_ll_rr
E_8us_8x_ll_rr
E_16us_16x_ll_rr
E_31us_16x_ll_rr
E_62us_32x_ll_rr
E_62us_64x_ll_rr
E_125us_64x_ll_rr
E_250us_128x_ll_rr
|
YES |
YES |
NO |
Table 2 |
E_1ms_128x_ll_rr |
YES |
YES |
YES |
Table 3 |
E_1us_4x_ll_rr
E_2us_8x_ll_rr
E_4us_16x_ll_rr
E_8us_32x_ll_rr
E_16us_64x_ll_rr
|
YES | NO | NO | bitfile_M |
Notes: the bitmasks in Table 1 are only for GoodXenon mode data where there are no propane events present. If you specifically requested propane events, these bitmasks will not give the correct result; you will have to make your own. (See the recipe and notice the warning at the bottom.) (If you are not sure, simply use fkeyprint to look at the value of DATAMODE; if propane events are included, the keyword will be GoodXenonwithPropane.)
Also, many of these bitmasks will not look like what you would get using sefilter yourself. We have removed the default bitmask which filters out the M[1]{1} token; since GoodXenon data have no time stamps, filtering on this token is unnecessary and will take longer in fselect. Where possible, we have also simplified the expressions produced by sefilter in order to make the selection process as efficient as possible. (Sefilter's algorithm is designed to be correct for every possible case, and so it may not be the most efficient.)
The event mode E_500us_64x_ll_rr is not currently included due to an oddity in the original processing of this event mode. If you have AO1 data of this type, wait for the reprocessed data and do not attempt to use this mode from the originally processed version.
Table 3(Z token, case C[]{7}) |
LAYERS/ DETECTORS |
ALL | 0,1,2 | 0,1,2,3 | 0,1,2,4 |
ALL |
bitfile_M |
bitfile_z_d012 |
bitfile_z_d0123 |
bitfile_z_d0124* |
LR1 |
bitfile_z_lr1* |
bitfile_z_lr1_d012* |
bitfile_z_lr1_d0123* |
bitfile_z_lr1_d0124* |
LR1,LR2 |
bitfile_z_lr12* |
bitfile_z_lr12_d012* |
bitfile_z_lr12_d0123* |
bitfile_z_lr12_d0124* |
LR3 |
bitfile_z_lr3* |
bitfile_z_lr3_d012* |
bitfile_z_lr3_d0123* |
bitfile_z_lr3_d0124* |
|