|
MUSIC unknown
Analysis for the MUSIC active-target ionization chamber
|
#include <Constants.hpp>
Public Member Functions | |
| DatasetConfig () | |
Public Attributes | |
| Bool_t | USE_SOLARIS_DATA |
| Data source. | |
| TString | SOL_BASE_DIR |
| TString | SOL_SPLIT_DIR |
| Double_t | SOL_SPLIT_CHUNK_SECONDS |
| Length of the time chunks the SOLARIS .sol files are split into by the preprocess step, in seconds; each chunk becomes one subfile. | |
| Int_t | SOL_N_SPLIT_WORKERS |
| TString | COMPASS_BASE_DIR |
| std::vector< Int_t > | RUN_NUMBERS |
| Flat run list, used when EPOCHS is empty. | |
| std::vector< RunEpoch > | EPOCHS |
| Int_t | N_CHUNKS |
| TString | SIM_BEAM_FILE |
| Int_t | N_BOARDS |
| Hardware layout. | |
| Int_t | N_CHANNELS |
| UShort_t | TIMING_REF_BOARD |
| std::vector< UShort_t > | TIMING_REF_BOARD_CHANNELS |
| Double_t | TIMING_MIN_ENERGY |
| Timing. | |
| Double_t | TIMING_MAX_ENERGY |
| Double_t | TIMING_OVERLAP_MARGIN_S |
| Double_t | TIMING_THRESH_DT_US |
| Double_t | TIMING_MAX_ABS_SHIFT_S |
| Double_t | TIMING_SHIFT_COARSE_STEP_US |
| Double_t | TIMING_SHIFT_FINE_STEP_US |
| Double_t | TIMING_SHIFT_FINE_HALF_WIDTH_US |
| Int_t | TIMING_SHIFT_MIN_NPTS |
| Int_t | TIMING_SHIFT_MAX_SCAN_CANDIDATES |
| Bool_t | TIMING_DO_BOARD_SYNC |
| Bool_t | TIMING_DO_SORT |
| Bool_t | REJECT_FLAGGED_EVENTS |
| Bool_t | PULSE_HISTORY_CORRECTION |
| Pole-zero pulse-history correction on the raw hits, before event building (see PulseHistory.hpp). | |
| Long64_t | PULSE_HISTORY_MIN_EVENTS |
| Double_t | PULSE_HISTORY_BEAM_LO |
| Double_t | PULSE_HISTORY_BEAM_HI |
| Double_t | PULSE_HISTORY_OWN_LO |
| Looser window for the long ends of the chain whose kernel is being fit; the one above is used on strips that are not actively being fit in order to find actual beam-like events. | |
| Double_t | PULSE_HISTORY_OWN_HI |
| Double_t | PULSE_HISTORY_APPLY_MAX_US |
| few hundred microseconds, so pulses beyond 100 us still move it. | |
| Int_t | PULSE_HISTORY_AMP_BINS |
| Kernel bands in the previous pulse's amplitude, in units of the channel's beam peak: 1 is one kernel linear in the amplitude; N > 1 fits one kernel per band [0, 0.5), [0.5, 1.5), ..., [N-1.5, inf), i.e. | |
| PulseHistoryGroups | PULSE_HISTORY_GROUPS |
| Which channel groups are corrected and with which kernel shape; all off by default, so a dataset that turns PULSE_HISTORY_CORRECTION on must also pick its groups, e.g. | |
| Double_t | PULSE_HISTORY_TRAP_RISE_US |
| Trapezoid filter settings of the DPP-PHA, in microseconds, which fix the two times in the pole-zero kernel form: the energy is read at t_m = rise + peaking after a pulse, and the baseline stays frozen for t_f = 2 rise + flat after a trigger. | |
| Double_t | PULSE_HISTORY_TRAP_FLAT_US |
| Double_t | PULSE_HISTORY_PEAKING_US |
| Bool_t | IGNORE_SHORT_STRIPS |
| Decode the long end only, dropping every short end. | |
| Bool_t | IGNORE_STRIP_0 |
| Drop strip 0 / strip 17 from the analysis altogether: not required for a complete event, not in the all-strips cut, left off the trace figures. | |
| Bool_t | IGNORE_STRIP_17 |
| Bool_t | REQUIRE_STRIP_0 |
| Whether a complete event must carry a strip 0 hit (EventBuilder's CheckEventComplete at build time, and the analysis' all-strips cut). | |
| Bool_t | HAS_CATHODE |
| Bool_t | HAS_GRID |
| Bool_t | HAS_STRIP0 |
| Bool_t | HAS_STRIP17 |
| Bool_t | SKIP_EXISTING |
| Bool_t | SAVE_FULL_PLOTS |
| Per-subfile output: the events summaries, timing, beam calibration and pulse-history figure folders of the pipeline, the per-group beam-gate folders of strip-sum-scatter, and the full per-file report in the log. | |
| Int_t | PLOT_SAMPLE_FILES |
| Int_t | SAVE_SAMPLE_TRACES |
| Number of sample traces to save during event build and normed summary passes (0 = disabled). | |
| Int_t | MAX_FUSED_WORKERS |
| TString | REFERENCE_CHANNEL |
| Double_t | EVENT_TIME_WINDOW_US |
| Double_t | SEED_HOLDOFF_US |
| Seed holdoff: a reference hit arriving within SEED_HOLDOFF_US after the current seed, when that seed is under SEED_HOLDOFF_MAX_RATIO times the new hit, is the pulse behind a pre-trigger – the grid's slow rise trips the trigger early at a small energy, then the real pulse trips it again a few microseconds later – and re-seeds the open event (the larger of the two energies is kept, SeedTs becomes the later hit's, the window is extended from it, the anodes already collected stay) instead of opening a second event that splits the anodes between the two and leaves both incomplete. | |
| Double_t | SEED_HOLDOFF_MAX_RATIO |
| DedupStrategy | DEDUP_STRATEGY |
| Bool_t | USE_GPU_ACCELERATION |
| Int_t | MAX_GPU_CONCURRENT_SORTS |
| Double_t | BEAM_GATE_NSIGMA |
| n-sigma of the per-strip beam gate in the beam calibration: strip s is gated by the ellipse on the (strip s-1, strip s) raw totals, which is what defines that strip's beam sample. | |
| Double_t | STRIP_DE_MIN_NORMED |
| Double_t | STRIP_DE_MAX_NORMED |
| StripSumScatterConfig | STRIP_SUM_SCATTER_CONFIG |
| CrossSectionConfig | CROSS_SECTION_CONFIG |
| Double_t | STRIP_E_MIN_ADC |
| Double_t | STRIP_E_MAX_ADC |
| Double_t | GRID_MAX_ADC |
| Double_t | REFERENCE_CHANNEL_MIN_ADC |
| Double_t | REFERENCE_CHANNEL_MAX_ADC |
| Double_t | STRIP0_MAX_ADC |
| Double_t | STRIP17_MAX_ADC |
| Double_t | CATHODE_MAX_ADC |
| Double_t | LEFT_EVEN_MAX_ADC |
| Double_t | LEFT_ODD_MAX_ADC |
| Double_t | RIGHT_EVEN_MAX_ADC |
| Double_t | RIGHT_ODD_MAX_ADC |
| std::map< std::pair< Int_t, Int_t >, TString > | channelMap |
| std::map< std::pair< Int_t, Int_t >, TString > | channelMap64 |
Definition at line 445 of file Constants.hpp.
| DatasetConfig::DatasetConfig | ( | ) |
Definition at line 142 of file Constants.cpp.
| Double_t DatasetConfig::BEAM_GATE_NSIGMA |
n-sigma of the per-strip beam gate in the beam calibration: strip s is gated by the ellipse on the (strip s-1, strip s) raw totals, which is what defines that strip's beam sample.
One level, in the fitted sigma: the two axes are the same kind of quantity and the ridge between them is tilted, so the correlation-aware contour is the gate and separate x and y levels would mean nothing.
Definition at line 623 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::CATHODE_MAX_ADC |
Definition at line 641 of file Constants.hpp.
Referenced by DatasetConfig().
| std::map<std::pair<Int_t, Int_t>, TString> DatasetConfig::channelMap |
Definition at line 648 of file Constants.hpp.
| std::map<std::pair<Int_t, Int_t>, TString> DatasetConfig::channelMap64 |
Definition at line 649 of file Constants.hpp.
| TString DatasetConfig::COMPASS_BASE_DIR |
Definition at line 461 of file Constants.hpp.
| CrossSectionConfig DatasetConfig::CROSS_SECTION_CONFIG |
Definition at line 629 of file Constants.hpp.
Referenced by DatasetConfig().
| DedupStrategy DatasetConfig::DEDUP_STRATEGY |
Definition at line 612 of file Constants.hpp.
Referenced by DatasetConfig().
| std::vector<RunEpoch> DatasetConfig::EPOCHS |
Definition at line 468 of file Constants.hpp.
| Double_t DatasetConfig::EVENT_TIME_WINDOW_US |
Definition at line 590 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::GRID_MAX_ADC |
Definition at line 634 of file Constants.hpp.
Referenced by DatasetConfig().
| Bool_t DatasetConfig::HAS_CATHODE |
Definition at line 563 of file Constants.hpp.
Referenced by DatasetConfig().
| Bool_t DatasetConfig::HAS_GRID |
Definition at line 564 of file Constants.hpp.
Referenced by DatasetConfig().
| Bool_t DatasetConfig::HAS_STRIP0 |
Definition at line 565 of file Constants.hpp.
Referenced by DatasetConfig().
| Bool_t DatasetConfig::HAS_STRIP17 |
Definition at line 566 of file Constants.hpp.
Referenced by DatasetConfig().
| Bool_t DatasetConfig::IGNORE_SHORT_STRIPS |
Decode the long end only, dropping every short end.
With epochs declared, MakeEpoch() copies this into RunEpoch::ignore_short_strips, which an epoch may override; the decode reads Constants::ActiveIgnoreShortStrips().
Definition at line 549 of file Constants.hpp.
Referenced by DatasetConfig().
| Bool_t DatasetConfig::IGNORE_STRIP_0 |
Drop strip 0 / strip 17 from the analysis altogether: not required for a complete event, not in the all-strips cut, left off the trace figures.
Definition at line 552 of file Constants.hpp.
Referenced by DatasetConfig().
| Bool_t DatasetConfig::IGNORE_STRIP_17 |
Definition at line 553 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::LEFT_EVEN_MAX_ADC |
Definition at line 643 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::LEFT_ODD_MAX_ADC |
Definition at line 644 of file Constants.hpp.
Referenced by DatasetConfig().
| Int_t DatasetConfig::MAX_FUSED_WORKERS |
Definition at line 587 of file Constants.hpp.
Referenced by DatasetConfig().
| Int_t DatasetConfig::MAX_GPU_CONCURRENT_SORTS |
Definition at line 615 of file Constants.hpp.
Referenced by DatasetConfig().
| Int_t DatasetConfig::N_BOARDS |
| Int_t DatasetConfig::N_CHANNELS |
Definition at line 475 of file Constants.hpp.
Referenced by DatasetConfig().
| Int_t DatasetConfig::N_CHUNKS |
Definition at line 469 of file Constants.hpp.
Referenced by DatasetConfig().
| Int_t DatasetConfig::PLOT_SAMPLE_FILES |
Definition at line 580 of file Constants.hpp.
Referenced by DatasetConfig().
| Int_t DatasetConfig::PULSE_HISTORY_AMP_BINS |
Kernel bands in the previous pulse's amplitude, in units of the channel's beam peak: 1 is one kernel linear in the amplitude; N > 1 fits one kernel per band [0, 0.5), [0.5, 1.5), ..., [N-1.5, inf), i.e.
single beam, twice, three times the beam pulse, so a nonlinear undershoot can be followed.
Definition at line 522 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::PULSE_HISTORY_APPLY_MAX_US |
few hundred microseconds, so pulses beyond 100 us still move it.
Definition at line 516 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::PULSE_HISTORY_BEAM_HI |
Definition at line 505 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::PULSE_HISTORY_BEAM_LO |
Definition at line 504 of file Constants.hpp.
Referenced by DatasetConfig().
| Bool_t DatasetConfig::PULSE_HISTORY_CORRECTION |
Pole-zero pulse-history correction on the raw hits, before event building (see PulseHistory.hpp).
The kernel is measured per subfile on its own beam-like events; MIN_EVENTS is the smallest sample that is trusted, BEAM_LO/HI the window (x the channel's beam peak) every long end must sit in for an event to count as beam, and APPLY_MAX_US how far back the correction looks. CORRECTION is the global switch; the groups are per epoch (see PULSE_HISTORY_GROUPS).
Definition at line 502 of file Constants.hpp.
Referenced by DatasetConfig().
| PulseHistoryGroups DatasetConfig::PULSE_HISTORY_GROUPS |
Which channel groups are corrected and with which kernel shape; all off by default, so a dataset that turns PULSE_HISTORY_CORRECTION on must also pick its groups, e.g.
gInstance.PULSE_HISTORY_GROUPS.long_left.enabled = kTRUE; and gInstance.PULSE_HISTORY_GROUPS.long_left.kernel = kPulseHistoryForm;. With epochs declared, MakeEpoch() copies this set into RunEpoch::pulse_history, which an epoch may override group by group (a known tau for one era, a group off for another); the correction reads Constants::ActivePulseHistoryGroups().
Definition at line 533 of file Constants.hpp.
| Long64_t DatasetConfig::PULSE_HISTORY_MIN_EVENTS |
Definition at line 503 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::PULSE_HISTORY_OWN_HI |
Definition at line 511 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::PULSE_HISTORY_OWN_LO |
Looser window for the long ends of the chain whose kernel is being fit; the one above is used on strips that are not actively being fit in order to find actual beam-like events.
Definition at line 510 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::PULSE_HISTORY_PEAKING_US |
Definition at line 543 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::PULSE_HISTORY_TRAP_FLAT_US |
Definition at line 542 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::PULSE_HISTORY_TRAP_RISE_US |
Trapezoid filter settings of the DPP-PHA, in microseconds, which fix the two times in the pole-zero kernel form: the energy is read at t_m = rise + peaking after a pulse, and the baseline stays frozen for t_f = 2 rise + flat after a trigger.
The form holds for gaps of at least (2 rise + flat) - t_m, when the previous trapezoid has passed under the read point. Defaults are board 66222's (2 / 3 / 1.5 us).
Definition at line 541 of file Constants.hpp.
Referenced by DatasetConfig().
| TString DatasetConfig::REFERENCE_CHANNEL |
Definition at line 589 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::REFERENCE_CHANNEL_MAX_ADC |
Definition at line 637 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::REFERENCE_CHANNEL_MIN_ADC |
Definition at line 636 of file Constants.hpp.
Referenced by DatasetConfig().
| Bool_t DatasetConfig::REJECT_FLAGGED_EVENTS |
Definition at line 493 of file Constants.hpp.
Referenced by DatasetConfig().
| Bool_t DatasetConfig::REQUIRE_STRIP_0 |
Whether a complete event must carry a strip 0 hit (EventBuilder's CheckEventComplete at build time, and the analysis' all-strips cut).
Off, an event without one is kept; strip 0 is still stored, drawn and gated on where it fired. On 37Cl the strip 0 deposit sits at the DAQ threshold and fires in a third of the beam events, so requiring it costs two thirds of the statistics for a strip no tag condition reads. Moot when IGNORE_STRIP_0 is set.
Definition at line 561 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::RIGHT_EVEN_MAX_ADC |
Definition at line 645 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::RIGHT_ODD_MAX_ADC |
Definition at line 646 of file Constants.hpp.
Referenced by DatasetConfig().
| std::vector<Int_t> DatasetConfig::RUN_NUMBERS |
Flat run list, used when EPOCHS is empty.
When EPOCHS is populated the pipeline walks the epochs instead and this is ignored; binaries that run with no active epoch then take the runs of the epochs named in CROSS_SECTION_CONFIG.EPOCHS (all enabled ones when that is empty).
Definition at line 467 of file Constants.hpp.
| Bool_t DatasetConfig::SAVE_FULL_PLOTS |
Per-subfile output: the events summaries, timing, beam calibration and pulse-history figure folders of the pipeline, the per-group beam-gate folders of strip-sum-scatter, and the full per-file report in the log.
Every subfile when SAVE_FULL_PLOTS; otherwise only the first PLOT_SAMPLE_FILES subfiles (chunks, or gate groups) of each epoch, in file order, enough to check every stage without a plots directory the size of the data; the other files write one summary line per stage. Off by default. Dataset-level figures are always drawn. Read through Constants::FileInSample() and Constants::SavePlots().
Definition at line 579 of file Constants.hpp.
Referenced by DatasetConfig().
| Int_t DatasetConfig::SAVE_SAMPLE_TRACES |
Number of sample traces to save during event build and normed summary passes (0 = disabled).
Saved as overlays in events_summary and events_summary_normed alongside the histograms.
Definition at line 585 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::SEED_HOLDOFF_MAX_RATIO |
Definition at line 611 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::SEED_HOLDOFF_US |
Seed holdoff: a reference hit arriving within SEED_HOLDOFF_US after the current seed, when that seed is under SEED_HOLDOFF_MAX_RATIO times the new hit, is the pulse behind a pre-trigger – the grid's slow rise trips the trigger early at a small energy, then the real pulse trips it again a few microseconds later – and re-seeds the open event (the larger of the two energies is kept, SeedTs becomes the later hit's, the window is extended from it, the anodes already collected stay) instead of opening a second event that splits the anodes between the two and leaves both incomplete.
On 37Cl run 97 the pre-triggers sit 3.5-8 us early and about 6 percent of grid seeds come out with no anodes at all. A pre-trigger is recognised by the open event holding no anode hits when the new reference hit arrives – the particle's strips fire after the real grid trigger – with the size ratio only as a guard: on its own the ratio cannot tell a pre-trigger from a first particle read low by its follower, which lands at the same ratios (run 97: no gap between the pre-trigger pile at 0.0-0.2 and the follower-deficit floor from 0.3). 0 = off; the build summary counts the candidates either way, split by anodes pending, so the setting can be judged before it is on.
Definition at line 610 of file Constants.hpp.
Referenced by DatasetConfig().
| TString DatasetConfig::SIM_BEAM_FILE |
Definition at line 471 of file Constants.hpp.
| Bool_t DatasetConfig::SKIP_EXISTING |
Definition at line 568 of file Constants.hpp.
Referenced by DatasetConfig().
| TString DatasetConfig::SOL_BASE_DIR |
Definition at line 449 of file Constants.hpp.
| Int_t DatasetConfig::SOL_N_SPLIT_WORKERS |
Definition at line 459 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::SOL_SPLIT_CHUNK_SECONDS |
Length of the time chunks the SOLARIS .sol files are split into by the preprocess step, in seconds; each chunk becomes one subfile.
Non-positive (e.g. -1) turns splitting off: the preprocess step does nothing and the pipeline reads each whole file from SOL_BASE_DIR as one subfile, ignoring anything in SOL_SPLIT_DIR. With epochs declared, MakeEpoch() copies this into RunEpoch::split_chunk_seconds, which an epoch may override; the tools read Constants::ActiveSplitChunkSeconds().
Definition at line 458 of file Constants.hpp.
Referenced by DatasetConfig().
| TString DatasetConfig::SOL_SPLIT_DIR |
Definition at line 450 of file Constants.hpp.
| Double_t DatasetConfig::STRIP0_MAX_ADC |
Definition at line 639 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::STRIP17_MAX_ADC |
Definition at line 640 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::STRIP_DE_MAX_NORMED |
Definition at line 626 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::STRIP_DE_MIN_NORMED |
Definition at line 625 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::STRIP_E_MAX_ADC |
Definition at line 632 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::STRIP_E_MIN_ADC |
Definition at line 631 of file Constants.hpp.
Referenced by DatasetConfig().
| StripSumScatterConfig DatasetConfig::STRIP_SUM_SCATTER_CONFIG |
Definition at line 628 of file Constants.hpp.
Referenced by DatasetConfig().
| Bool_t DatasetConfig::TIMING_DO_BOARD_SYNC |
Definition at line 490 of file Constants.hpp.
Referenced by DatasetConfig().
| Bool_t DatasetConfig::TIMING_DO_SORT |
Definition at line 491 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::TIMING_MAX_ABS_SHIFT_S |
Definition at line 484 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::TIMING_MAX_ENERGY |
Definition at line 481 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::TIMING_MIN_ENERGY |
| Double_t DatasetConfig::TIMING_OVERLAP_MARGIN_S |
Definition at line 482 of file Constants.hpp.
Referenced by DatasetConfig().
| UShort_t DatasetConfig::TIMING_REF_BOARD |
Definition at line 476 of file Constants.hpp.
Referenced by DatasetConfig().
| std::vector<UShort_t> DatasetConfig::TIMING_REF_BOARD_CHANNELS |
Definition at line 477 of file Constants.hpp.
| Double_t DatasetConfig::TIMING_SHIFT_COARSE_STEP_US |
Definition at line 485 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::TIMING_SHIFT_FINE_HALF_WIDTH_US |
Definition at line 487 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::TIMING_SHIFT_FINE_STEP_US |
Definition at line 486 of file Constants.hpp.
Referenced by DatasetConfig().
| Int_t DatasetConfig::TIMING_SHIFT_MAX_SCAN_CANDIDATES |
Definition at line 489 of file Constants.hpp.
Referenced by DatasetConfig().
| Int_t DatasetConfig::TIMING_SHIFT_MIN_NPTS |
Definition at line 488 of file Constants.hpp.
Referenced by DatasetConfig().
| Double_t DatasetConfig::TIMING_THRESH_DT_US |
Definition at line 483 of file Constants.hpp.
Referenced by DatasetConfig().
| Bool_t DatasetConfig::USE_GPU_ACCELERATION |
Definition at line 614 of file Constants.hpp.
Referenced by DatasetConfig().
| Bool_t DatasetConfig::USE_SOLARIS_DATA |