One acquisition period of a dataset. More...

#include <RunEpoch.hpp>

Collaboration diagram for RunEpoch:

Public Member Functions
	RunEpoch ()
	Construct with SOLARIS-era defaults; override per epoch.

Public Attributes
TString	name
	Epoch name, used in logs and plot paths.
RunSource	source
	Acquisition system for this era.
Bool_t	enabled
	Whether this epoch participates in the analysis.
TString	file_tag
	Prefix for this epoch's output files and plot directories.
std::vector< Int_t >	runs
	Run numbers belonging to this epoch.
Int_t	max_files
	Cap on subfiles processed per run; -1 for all of them.
Bool_t	has_cathode
	Whether this era instrumented the cathode.
Digitiser layout
Int_t	n_boards
	Boards in this era's setup.
Int_t	n_channels
	Channels per board.
std::map< std::pair< Int_t, Int_t >, TString >	channel_map
	Board and channel to detector-element name, e.g. "Grid", "de_l_03".
Timing and event building
UShort_t	timing_ref_board
std::vector< UShort_t >	timing_ref_board_channels
	Channels on the reference board used to align the others against it.
Bool_t	do_board_sync
	Run the multi-board timing alignment.
Bool_t	do_sort
	Time-sort hits before event building.
Double_t	event_time_window_us
	Coincidence window, in microseconds, for grouping hits into one event.
Double_t	seed_holdoff_us
	Seed holdoff and the pre-trigger size ratio; see SEED_HOLDOFF_US.
Double_t	seed_holdoff_max_ratio
TString	reference_channel
	Channel whose hits seed events, e.g. "Grid".
Double_t	reference_channel_min_adc
	Lower energy gate on the seed channel.
Double_t	reference_channel_max_adc
	Upper energy gate on the seed channel.
DedupStrategy	dedup_strategy
	How repeated hits on a slot resolve.
Preprocessing
MakeEpoch() copies the flat SOL_SPLIT_CHUNK_SECONDS and PULSE_HISTORY_GROUPS; override per epoch where the electronics differed, e.g. late.pulse_history.long_left.tau_us = 25 for an era whose preamp decay is known, or every group off for one whose chains carry no undershoot. Length of the time chunks this epoch's .sol files are split into, in seconds; non-positive = whole files, no splitting. SOLARIS only.
Double_t	split_chunk_seconds
PulseHistoryGroups	pulse_history
	The pulse-history groups in force for this epoch's hits: which chains are corrected, with which kernel and which given tau.
Bool_t	ignore_short_strips
	Decode the long end only (L on odd strips, R on even), dropping the short end from every strip total.
ADC scale
The CoMPASS era digitised to a different full scale than SOLARIS, so the per-end ceilings and the strip range differ between epochs.
Double_t	strip_e_min_adc
	Lower bound of the per-strip energy range.
Double_t	strip_e_max_adc
	Upper bound of the per-strip energy range.
Double_t	cathode_max_adc
	Cathode full scale.
Double_t	grid_max_adc
	Grid full scale.
Double_t	strip0_max_adc
	Strip 0 full scale.
Double_t	strip17_max_adc
	Strip 17 full scale.
Double_t	left_even_max_adc
	Left-side ceiling, even strips.
Double_t	left_odd_max_adc
	Left-side ceiling, odd strips.
Double_t	right_even_max_adc
	Right-side ceiling, even strips.
Double_t	right_odd_max_adc

Detailed Description

One acquisition period of a dataset.

Used if there are multiple acquisitions with different configurations, using different DAQ software, etc.

Warning: Every epoch must declare every field. Constants::Active*() reads the active epoch when one is set and the flat DatasetConfig otherwise, with no "declared / inherit" heuristic in between. A half-populated epoch is a configuration error, not a silent fallback to another era's value — and it will not announce itself.

Definition at line 34 of file RunEpoch.hpp.

Constructor & Destructor Documentation

◆ RunEpoch()

RunEpoch::RunEpoch ( )

inline

Construct with SOLARIS-era defaults; override per epoch.

Definition at line 122 of file RunEpoch.hpp.

Member Data Documentation

◆ cathode_max_adc

Double_t RunEpoch::cathode_max_adc

Cathode full scale.

Definition at line 111 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ channel_map

std::map<std::pair<Int_t, Int_t>, TString> RunEpoch::channel_map

Board and channel to detector-element name, e.g. "Grid", "de_l_03".

Definition at line 57 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch().

◆ dedup_strategy

DedupStrategy RunEpoch::dedup_strategy

How repeated hits on a slot resolve.

Definition at line 77 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ do_board_sync

Bool_t RunEpoch::do_board_sync

Run the multi-board timing alignment.

Definition at line 65 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ do_sort

Bool_t RunEpoch::do_sort

Time-sort hits before event building.

Definition at line 66 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ enabled

Bool_t RunEpoch::enabled

Whether this epoch participates in the analysis.

Definition at line 37 of file RunEpoch.hpp.

Referenced by main(), Pipeline::Run(), and RunEpoch().

◆ event_time_window_us

Double_t RunEpoch::event_time_window_us

Coincidence window, in microseconds, for grouping hits into one event.

Definition at line 68 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ file_tag

TString RunEpoch::file_tag

Prefix for this epoch's output files and plot directories.

Run numbers are only unique within an acquisition system: CoMPASS run 37 and SOLARIS run 37 are unrelated experiments years apart that happen to share a number, and without a tag both would write Events_Run37_*.root over each other. Leave empty for the era whose filenames are already on disk (the SOLARIS runs); set it on any era that would otherwise collide.

Definition at line 46 of file RunEpoch.hpp.

Referenced by Constants::ActivateAnalysisEpoch(), Constants::EpochForRun(), and RunEpoch().

◆ grid_max_adc

Double_t RunEpoch::grid_max_adc

Grid full scale.

Definition at line 112 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ has_cathode

Bool_t RunEpoch::has_cathode

Whether this era instrumented the cathode.

Definition at line 80 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ ignore_short_strips

Bool_t RunEpoch::ignore_short_strips

Decode the long end only (L on odd strips, R on even), dropping the short end from every strip total.

For an era whose short ends sit below the DAQ trigger (CoMPASS 37Cl: 0.1-5 percent of events, rising with strip number), where the little that registers would only add a strip-dependent bias.

Definition at line 102 of file RunEpoch.hpp.

Referenced by Constants::ActiveIgnoreShortStrips(), Constants::MakeEpoch(), and RunEpoch().

◆ left_even_max_adc

Double_t RunEpoch::left_even_max_adc

Left-side ceiling, even strips.

Definition at line 115 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ left_odd_max_adc

Double_t RunEpoch::left_odd_max_adc

Left-side ceiling, odd strips.

Definition at line 116 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ max_files

Int_t RunEpoch::max_files

Cap on subfiles processed per run; -1 for all of them.

Definition at line 50 of file RunEpoch.hpp.

Referenced by RunEpoch().

◆ n_boards

Int_t RunEpoch::n_boards

Boards in this era's setup.

Definition at line 54 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), Pipeline::Run(), and RunEpoch().

◆ n_channels

Int_t RunEpoch::n_channels

Channels per board.

Definition at line 55 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), Pipeline::Run(), and RunEpoch().

◆ name

TString RunEpoch::name

Epoch name, used in logs and plot paths.

Definition at line 35 of file RunEpoch.hpp.

Referenced by Constants::ActivateAnalysisEpoch(), main(), Constants::MakeEpoch(), Pipeline::Run(), and RunEpoch().

◆ pulse_history

PulseHistoryGroups RunEpoch::pulse_history

The pulse-history groups in force for this epoch's hits: which chains are corrected, with which kernel and which given tau.

With PULSE_HISTORY_CORRECTION on, an epoch with no group enabled skips the stage.

Definition at line 96 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ reference_channel

TString RunEpoch::reference_channel

Channel whose hits seed events, e.g. "Grid".

Definition at line 72 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ reference_channel_max_adc

Double_t RunEpoch::reference_channel_max_adc

Upper energy gate on the seed channel.

Definition at line 76 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ reference_channel_min_adc

Double_t RunEpoch::reference_channel_min_adc

Lower energy gate on the seed channel.

Definition at line 74 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ right_even_max_adc

Double_t RunEpoch::right_even_max_adc

Right-side ceiling, even strips.

Definition at line 117 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ right_odd_max_adc

Double_t RunEpoch::right_odd_max_adc

Definition at line 118 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ runs

std::vector<Int_t> RunEpoch::runs

Run numbers belonging to this epoch.

Definition at line 48 of file RunEpoch.hpp.

Referenced by Constants::ActivateAnalysisEpoch(), Constants::EpochForRun(), main(), Constants::MakeEpoch(), and Pipeline::Run().

◆ seed_holdoff_max_ratio

Double_t RunEpoch::seed_holdoff_max_ratio

Definition at line 71 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ seed_holdoff_us

Double_t RunEpoch::seed_holdoff_us

Seed holdoff and the pre-trigger size ratio; see SEED_HOLDOFF_US.

Definition at line 70 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ source

RunSource RunEpoch::source

Acquisition system for this era.

Definition at line 36 of file RunEpoch.hpp.

Referenced by Constants::ActivateAnalysisEpoch(), main(), Constants::MakeEpoch(), Pipeline::Run(), and RunEpoch().

◆ split_chunk_seconds

Double_t RunEpoch::split_chunk_seconds

Definition at line 91 of file RunEpoch.hpp.

Referenced by main(), Constants::MakeEpoch(), and RunEpoch().

◆ strip0_max_adc

Double_t RunEpoch::strip0_max_adc

Strip 0 full scale.

Definition at line 113 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ strip17_max_adc

Double_t RunEpoch::strip17_max_adc

Strip 17 full scale.

Definition at line 114 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ strip_e_max_adc

Double_t RunEpoch::strip_e_max_adc

Upper bound of the per-strip energy range.

Definition at line 110 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ strip_e_min_adc

Double_t RunEpoch::strip_e_min_adc

Lower bound of the per-strip energy range.

Definition at line 109 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ timing_ref_board

UShort_t RunEpoch::timing_ref_board

Definition at line 62 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch(), and RunEpoch().

◆ timing_ref_board_channels

std::vector<UShort_t> RunEpoch::timing_ref_board_channels

Channels on the reference board used to align the others against it.

Definition at line 64 of file RunEpoch.hpp.

Referenced by Constants::MakeEpoch().

The documentation for this struct was generated from the following file:

tooling/include/RunEpoch.hpp

Public Member Functions

Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ RunEpoch()

Member Data Documentation

◆ cathode_max_adc

◆ channel_map

◆ dedup_strategy

◆ do_board_sync

◆ do_sort

◆ enabled

◆ event_time_window_us

◆ file_tag

◆ grid_max_adc

◆ has_cathode

◆ ignore_short_strips

◆ left_even_max_adc

◆ left_odd_max_adc

◆ max_files

◆ n_boards

◆ n_channels

◆ name

◆ pulse_history

◆ reference_channel

◆ reference_channel_max_adc

◆ reference_channel_min_adc

◆ right_even_max_adc

◆ right_odd_max_adc

◆ runs

◆ seed_holdoff_max_ratio

◆ seed_holdoff_us

◆ source

◆ split_chunk_seconds

◆ strip0_max_adc

◆ strip17_max_adc

◆ strip_e_max_adc

◆ strip_e_min_adc

◆ timing_ref_board

◆ timing_ref_board_channels