MUSIC unknown
Analysis for the MUSIC active-target ionization chamber
Loading...
Searching...
No Matches
StripSumScatterConfig Struct Reference

Everything governing the reaction search in the strip-sum scatters. More...

#include <Constants.hpp>

Public Types

enum  PureBeamGate { PURE_BEAM_GATE_S0_S1 , PURE_BEAM_GATE_S1_S2 }
enum  AnRegionMode { AN_REGION_MIXTURE , AN_REGION_RIDGE_BAND }
 How compute-regions defines the (a,n) region. More...

Public Member Functions

void SetDefaults ()

Public Attributes

PureBeamGate PURE_BEAM_GATE
Int_t POST_TRIGGER_SUM_STRIPS
 Strips summed onto the scatter y-axis after the trigger strip: y spans reac+1 .
Int_t POST_WINDOW_LAST_STRIP
std::map< Int_t, Int_t > POST_WINDOW_STRIPS
Int_t MAX_STRIP_SUM_WORKERS
 Cap on worker threads for the scatter fill.
Int_t REACTION_STRIP_MIN
Int_t REACTION_STRIP_MAX
Int_t REQUIRE_SMOOTHNESS_END_STRIP
Double_t REQUIRE_SMOOTHNESS_MAX_STEP
Double_t REAC_JUMP_NSIGMA
 Minimum jump at the reaction strip for a tag, in sigma of the measured strip-to-strip beam noise (StripSumScatter::JumpSigma).
Double_t REAC_JUMP_MAX
Double_t END_STRIP_MAX
Double_t PILEUP_THRESHOLD
Double_t NOISE_THRESHOLD
Bool_t REJECT_NOISE
Double_t NOISE_THRESH_PY
Int_t NOISE_MIN_STRIPS
Bool_t REJECT_PILEUP
Double_t PILEUP_THRESH_PY
Int_t PILEUP_MIN_STRIPS
Bool_t REGION_CUT_REDRAW
 Redraw the regions for this reaction strip even if saved ones exist, and overwrite only that strip's entry.
Double_t AN_REGION_NSIGMA
 compute-regions: the (a,n) region is the reaction component's AN_REGION_NSIGMA Mahalanobis ellipse from the bivariate Gaussian mixture fitted to each strip's scatter; the (a,a') region is the beam-like component's AA_REGION_NSIGMA ellipse.
Double_t AA_REGION_NSIGMA
AnRegionMode AN_REGION_MODE
Double_t AN_RIDGE_NSIGMA_LO
Double_t AN_RIDGE_NSIGMA_HI
Bool_t REQUIRE_BEAM_UPSTREAM_OF_REAC
 Tolerance in sigma of each strip's measured beam spread (StripSumScatter::StripSigma).
Double_t BEAM_UPSTREAM_NSIGMA
Int_t BOTH_MULT_MAX
 Both-ends multiplicity cut: reject an event when more than MAX strips in 1..COUNT_TO had BOTH ends fire.
Int_t BOTH_MULT_COUNT_TO
Bool_t REJECT_OFFBEAM
Double_t OFFBEAM_DIST
Int_t OFFBEAM_MIN_STRIPS
Double_t PARITY_ASYM_MAX
 Reject events whose even strips and odd strips disagree by more than this fraction, |mean(even 2..16) / mean(odd 1..16) - 1|, before the tag.
Bool_t PLOT_PARITY_REJECTED_GRID
 Diagnostic only: when set, run an extra pass over the events (gated by PARITY_ASYM_MAX > 0) that fills a histogram of the Grid #DeltaE of events that pass the cheap pre-tag cuts (all strips fired, pileup, noise, offbeam) and are then rejected by the parity cut, and save BOTH a decoded a.u.
Double_t TRIGGER_NSIGMA
Double_t TRIGGER_CFD_FRAC
Int_t PLATEAU_POST
Int_t CLUSTER_SMOOTH_WINDOW
Int_t SEED_HALF_BINS
Int_t SAVGOL_HALF
Int_t TRACES_PER_CLASS
Int_t X_LO
Int_t X_HI
Int_t GATE_STRIP_X
Int_t GATE_STRIP_Y
Double_t GATE_NSIGMA_X
Double_t GATE_NSIGMA_Y
Double_t GATE_MIN
Double_t GATE_MAX
Int_t GATE_BINS
Double_t X_DISPLAY_MIN
 Display-only windows for the strip-sum scatters (a.u.): the histograms are built over the fixed ScatterBuildRange, so these only zoom the drawn plot via SetRangeUser (no rebuild); XBINS/YBINS do require a rebuild.
Double_t X_DISPLAY_MAX
Int_t XBINS
Double_t Y_DISPLAY_MIN
Double_t Y_DISPLAY_MAX
Int_t YBINS
std::map< Int_t, std::pair< Double_t, Double_t > > Y_DISPLAY_RANGE
 Per-reaction-strip y-axis display windows, overriding Y_DISPLAY_MIN/MAX for individual strips (display-only, same as the X_DISPLAY_* windows).
Long64_t SAMPLE_MAX_POINTS
Bool_t RERUN_SIM
Int_t CANDIDATE_REAC_STRIP
Bool_t REQUIRE_SMOOTHNESS
Bool_t REQUIRE_GATE_S3_S4
Bool_t REQUIRE_GATE_S5_S6
Bool_t SKIP_SAVGOL_PLOTS
Bool_t REQUIRE_STRIP_16_BELOW_BEAM
Bool_t ALT_DECODE_REGION_TRACES
 Also render the selected region traces under the OTHER decode (long-side-only <-> L+R sum) from the same calibration and the same selected events, into a separate plot plus a text dump.

Detailed Description

Everything governing the reaction search in the strip-sum scatters.

Two kinds of knob live here, and the distinction decides what a change costs: those that are part of the built quantity, where a change reprojects the cache, and those that are part of the tagging, where a change refills it. Each field says which it is. The cache fingerprints them all, so either happens automatically.

Definition at line 53 of file Constants.hpp.

Member Enumeration Documentation

◆ AnRegionMode

How compute-regions defines the (a,n) region.

MIXTURE: the ellipse of the mixture's reaction component, for a compact island beyond the beam (87Rb). RIDGE_BAND: everything between AN_RIDGE_NSIGMA_LO and _HI conditional sigma above the beam ridge, free in x across the window, for a reaction cloud that spreads along x and sits below the beam in total energy (37Cl, where the neutron carries energy out). The (a,a') region is the beam ellipse in both.

Enumerator
AN_REGION_MIXTURE 
AN_REGION_RIDGE_BAND 

Definition at line 114 of file Constants.hpp.

◆ PureBeamGate

Enumerator
PURE_BEAM_GATE_S0_S1 
PURE_BEAM_GATE_S1_S2 

Definition at line 54 of file Constants.hpp.

Member Function Documentation

◆ SetDefaults()

void StripSumScatterConfig::SetDefaults ( )

Definition at line 42 of file Constants.cpp.

Member Data Documentation

◆ AA_REGION_NSIGMA

Double_t StripSumScatterConfig::AA_REGION_NSIGMA

Definition at line 106 of file Constants.hpp.

Referenced by main(), and SetDefaults().

◆ ALT_DECODE_REGION_TRACES

Bool_t StripSumScatterConfig::ALT_DECODE_REGION_TRACES

Also render the selected region traces under the OTHER decode (long-side-only <-> L+R sum) from the same calibration and the same selected events, into a separate plot plus a text dump.

Definition at line 208 of file Constants.hpp.

Referenced by SetDefaults().

◆ AN_REGION_MODE

AnRegionMode StripSumScatterConfig::AN_REGION_MODE

Definition at line 115 of file Constants.hpp.

Referenced by main(), and SetDefaults().

◆ AN_REGION_NSIGMA

Double_t StripSumScatterConfig::AN_REGION_NSIGMA

compute-regions: the (a,n) region is the reaction component's AN_REGION_NSIGMA Mahalanobis ellipse from the bivariate Gaussian mixture fitted to each strip's scatter; the (a,a') region is the beam-like component's AA_REGION_NSIGMA ellipse.

Saved like drawn cuts, so nothing downstream knows the difference.

Definition at line 105 of file Constants.hpp.

Referenced by main(), CrossSection::Run(), and SetDefaults().

◆ AN_RIDGE_NSIGMA_HI

Double_t StripSumScatterConfig::AN_RIDGE_NSIGMA_HI

Definition at line 117 of file Constants.hpp.

Referenced by main(), and SetDefaults().

◆ AN_RIDGE_NSIGMA_LO

Double_t StripSumScatterConfig::AN_RIDGE_NSIGMA_LO

Definition at line 116 of file Constants.hpp.

Referenced by main(), and SetDefaults().

◆ BEAM_UPSTREAM_NSIGMA

Double_t StripSumScatterConfig::BEAM_UPSTREAM_NSIGMA

Definition at line 122 of file Constants.hpp.

Referenced by SetDefaults().

◆ BOTH_MULT_COUNT_TO

Int_t StripSumScatterConfig::BOTH_MULT_COUNT_TO

Definition at line 133 of file Constants.hpp.

Referenced by SetDefaults().

◆ BOTH_MULT_MAX

Int_t StripSumScatterConfig::BOTH_MULT_MAX

Both-ends multiplicity cut: reject an event when more than MAX strips in 1..COUNT_TO had BOTH ends fire.

Read off raw ADC, so it is independent of IGNORE_SHORT_STRIPS. Charge sharing means a displaced track lights the short end on every strip of one parity at once, and tagging on a summed trace then enriches for those – this removes them. MAX < 0 disables it. COUNT_TO < 16 restricts the count to strips upstream of the reaction, where the sim has no sharing at all, without penalising products downstream.

Definition at line 132 of file Constants.hpp.

Referenced by SetDefaults().

◆ CANDIDATE_REAC_STRIP

Int_t StripSumScatterConfig::CANDIDATE_REAC_STRIP

Definition at line 197 of file Constants.hpp.

Referenced by SetDefaults().

◆ CLUSTER_SMOOTH_WINDOW

Int_t StripSumScatterConfig::CLUSTER_SMOOTH_WINDOW

Definition at line 162 of file Constants.hpp.

Referenced by SetDefaults().

◆ END_STRIP_MAX

Double_t StripSumScatterConfig::END_STRIP_MAX

Definition at line 82 of file Constants.hpp.

Referenced by SetDefaults().

◆ GATE_BINS

Int_t StripSumScatterConfig::GATE_BINS

Definition at line 178 of file Constants.hpp.

Referenced by SetDefaults().

◆ GATE_MAX

Double_t StripSumScatterConfig::GATE_MAX

Definition at line 177 of file Constants.hpp.

Referenced by SetDefaults().

◆ GATE_MIN

Double_t StripSumScatterConfig::GATE_MIN

Definition at line 176 of file Constants.hpp.

Referenced by SetDefaults().

◆ GATE_NSIGMA_X

Double_t StripSumScatterConfig::GATE_NSIGMA_X

Definition at line 174 of file Constants.hpp.

Referenced by SetDefaults().

◆ GATE_NSIGMA_Y

Double_t StripSumScatterConfig::GATE_NSIGMA_Y

Definition at line 175 of file Constants.hpp.

Referenced by SetDefaults().

◆ GATE_STRIP_X

Int_t StripSumScatterConfig::GATE_STRIP_X

Definition at line 172 of file Constants.hpp.

Referenced by SetDefaults().

◆ GATE_STRIP_Y

Int_t StripSumScatterConfig::GATE_STRIP_Y

Definition at line 173 of file Constants.hpp.

Referenced by SetDefaults().

◆ MAX_STRIP_SUM_WORKERS

Int_t StripSumScatterConfig::MAX_STRIP_SUM_WORKERS

Cap on worker threads for the scatter fill.

Definition at line 69 of file Constants.hpp.

Referenced by SetDefaults().

◆ NOISE_MIN_STRIPS

Int_t StripSumScatterConfig::NOISE_MIN_STRIPS

Definition at line 89 of file Constants.hpp.

Referenced by SetDefaults().

◆ NOISE_THRESH_PY

Double_t StripSumScatterConfig::NOISE_THRESH_PY

Definition at line 88 of file Constants.hpp.

Referenced by SetDefaults().

◆ NOISE_THRESHOLD

Double_t StripSumScatterConfig::NOISE_THRESHOLD

Definition at line 85 of file Constants.hpp.

Referenced by SetDefaults().

◆ OFFBEAM_DIST

Double_t StripSumScatterConfig::OFFBEAM_DIST

Definition at line 136 of file Constants.hpp.

Referenced by SetDefaults().

◆ OFFBEAM_MIN_STRIPS

Int_t StripSumScatterConfig::OFFBEAM_MIN_STRIPS

Definition at line 137 of file Constants.hpp.

Referenced by SetDefaults().

◆ PARITY_ASYM_MAX

Double_t StripSumScatterConfig::PARITY_ASYM_MAX

Reject events whose even strips and odd strips disagree by more than this fraction, |mean(even 2..16) / mean(odd 1..16) - 1|, before the tag.

A beam particle or a residue reads the same on both parities to within the noise; an event that arrives on the pole-zero undershoot of the previous pulse reads low on every channel of the group with the wrong pole-zero (the R channels in the SOLARIS 37Cl runs), a sawtooth at 0.65 on even strips and 1.0 on odd. Applied to the beam denominator too, so it cancels. 0 or less: off.

Definition at line 146 of file Constants.hpp.

Referenced by SetDefaults().

◆ PILEUP_MIN_STRIPS

Int_t StripSumScatterConfig::PILEUP_MIN_STRIPS

Definition at line 93 of file Constants.hpp.

Referenced by SetDefaults().

◆ PILEUP_THRESH_PY

Double_t StripSumScatterConfig::PILEUP_THRESH_PY

Definition at line 92 of file Constants.hpp.

Referenced by SetDefaults().

◆ PILEUP_THRESHOLD

Double_t StripSumScatterConfig::PILEUP_THRESHOLD

Definition at line 84 of file Constants.hpp.

Referenced by SetDefaults().

◆ PLATEAU_POST

Int_t StripSumScatterConfig::PLATEAU_POST

Definition at line 161 of file Constants.hpp.

Referenced by SetDefaults().

◆ PLOT_PARITY_REJECTED_GRID

Bool_t StripSumScatterConfig::PLOT_PARITY_REJECTED_GRID

Diagnostic only: when set, run an extra pass over the events (gated by PARITY_ASYM_MAX > 0) that fills a histogram of the Grid #DeltaE of events that pass the cheap pre-tag cuts (all strips fired, pileup, noise, offbeam) and are then rejected by the parity cut, and save BOTH a decoded a.u.

view (grid_adc / 16384, [0,1]) and a raw ADC view ([0, GRID_MAX_ADC]), each with a log-y axis. Purely visual; does not change what is tagged and is NOT part of the cache fingerprint (the reservoir keeps only tagged + beam events, so it cannot be rebuilt from cache anyway). Requires the Grid branch to be enabled. Off by default.

Definition at line 157 of file Constants.hpp.

Referenced by SetDefaults().

◆ POST_TRIGGER_SUM_STRIPS

Int_t StripSumScatterConfig::POST_TRIGGER_SUM_STRIPS

Strips summed onto the scatter y-axis after the trigger strip: y spans reac+1 .

. min(reac+POST_TRIGGER_SUM_STRIPS, POST_WINDOW_LAST_STRIP), so the window shrinks at deep strips instead of running into the region where the recoil slows and its excess turns into a deficit. ApJ 983:142 did this by hand (five strips at 3-8, two at 9-12, one at 13); POST_WINDOW_STRIPS sets a strip's window length outright, to reproduce such a table. Part of the built quantity, so a change re-projects the cache rather than refilling.

Definition at line 65 of file Constants.hpp.

Referenced by SetDefaults(), and StripSumScatter::YHiOf().

◆ POST_WINDOW_LAST_STRIP

Int_t StripSumScatterConfig::POST_WINDOW_LAST_STRIP

Definition at line 66 of file Constants.hpp.

Referenced by SetDefaults(), and StripSumScatter::YHiOf().

◆ POST_WINDOW_STRIPS

std::map<Int_t, Int_t> StripSumScatterConfig::POST_WINDOW_STRIPS

Definition at line 67 of file Constants.hpp.

Referenced by SetDefaults(), and StripSumScatter::YHiOf().

◆ PURE_BEAM_GATE

PureBeamGate StripSumScatterConfig::PURE_BEAM_GATE

Definition at line 55 of file Constants.hpp.

Referenced by SetDefaults().

◆ REAC_JUMP_MAX

Double_t StripSumScatterConfig::REAC_JUMP_MAX

Definition at line 81 of file Constants.hpp.

Referenced by SetDefaults().

◆ REAC_JUMP_NSIGMA

Double_t StripSumScatterConfig::REAC_JUMP_NSIGMA

Minimum jump at the reaction strip for a tag, in sigma of the measured strip-to-strip beam noise (StripSumScatter::JumpSigma).

Part of the tagging, so a change refills.

Definition at line 80 of file Constants.hpp.

Referenced by SetDefaults().

◆ REACTION_STRIP_MAX

Int_t StripSumScatterConfig::REACTION_STRIP_MAX

Definition at line 72 of file Constants.hpp.

Referenced by main(), and SetDefaults().

◆ REACTION_STRIP_MIN

Int_t StripSumScatterConfig::REACTION_STRIP_MIN

Definition at line 71 of file Constants.hpp.

Referenced by main(), and SetDefaults().

◆ REGION_CUT_REDRAW

Bool_t StripSumScatterConfig::REGION_CUT_REDRAW

Redraw the regions for this reaction strip even if saved ones exist, and overwrite only that strip's entry.

Without it the only way to redraw was to delete the whole cut file, which discarded every other strip's work.

Definition at line 98 of file Constants.hpp.

Referenced by SetDefaults().

◆ REJECT_NOISE

Bool_t StripSumScatterConfig::REJECT_NOISE

Definition at line 87 of file Constants.hpp.

Referenced by SetDefaults().

◆ REJECT_OFFBEAM

Bool_t StripSumScatterConfig::REJECT_OFFBEAM

Definition at line 135 of file Constants.hpp.

Referenced by SetDefaults().

◆ REJECT_PILEUP

Bool_t StripSumScatterConfig::REJECT_PILEUP

Definition at line 91 of file Constants.hpp.

Referenced by SetDefaults().

◆ REQUIRE_BEAM_UPSTREAM_OF_REAC

Bool_t StripSumScatterConfig::REQUIRE_BEAM_UPSTREAM_OF_REAC

Tolerance in sigma of each strip's measured beam spread (StripSumScatter::StripSigma).

Part of the tagging, so a change refills.

Definition at line 121 of file Constants.hpp.

Referenced by SetDefaults().

◆ REQUIRE_GATE_S3_S4

Bool_t StripSumScatterConfig::REQUIRE_GATE_S3_S4

Definition at line 200 of file Constants.hpp.

Referenced by SetDefaults().

◆ REQUIRE_GATE_S5_S6

Bool_t StripSumScatterConfig::REQUIRE_GATE_S5_S6

Definition at line 201 of file Constants.hpp.

Referenced by SetDefaults().

◆ REQUIRE_SMOOTHNESS

Bool_t StripSumScatterConfig::REQUIRE_SMOOTHNESS

Definition at line 199 of file Constants.hpp.

Referenced by SetDefaults().

◆ REQUIRE_SMOOTHNESS_END_STRIP

Int_t StripSumScatterConfig::REQUIRE_SMOOTHNESS_END_STRIP

Definition at line 74 of file Constants.hpp.

Referenced by SetDefaults().

◆ REQUIRE_SMOOTHNESS_MAX_STEP

Double_t StripSumScatterConfig::REQUIRE_SMOOTHNESS_MAX_STEP

Definition at line 75 of file Constants.hpp.

Referenced by SetDefaults().

◆ REQUIRE_STRIP_16_BELOW_BEAM

Bool_t StripSumScatterConfig::REQUIRE_STRIP_16_BELOW_BEAM

Definition at line 203 of file Constants.hpp.

Referenced by SetDefaults().

◆ RERUN_SIM

Bool_t StripSumScatterConfig::RERUN_SIM

Definition at line 196 of file Constants.hpp.

Referenced by SetDefaults().

◆ SAMPLE_MAX_POINTS

Long64_t StripSumScatterConfig::SAMPLE_MAX_POINTS

Definition at line 194 of file Constants.hpp.

Referenced by SetDefaults().

◆ SAVGOL_HALF

Int_t StripSumScatterConfig::SAVGOL_HALF

Definition at line 165 of file Constants.hpp.

Referenced by SetDefaults().

◆ SEED_HALF_BINS

Int_t StripSumScatterConfig::SEED_HALF_BINS

Definition at line 163 of file Constants.hpp.

Referenced by SetDefaults().

◆ SKIP_SAVGOL_PLOTS

Bool_t StripSumScatterConfig::SKIP_SAVGOL_PLOTS

Definition at line 202 of file Constants.hpp.

Referenced by SetDefaults().

◆ TRACES_PER_CLASS

Int_t StripSumScatterConfig::TRACES_PER_CLASS

Definition at line 167 of file Constants.hpp.

Referenced by SetDefaults().

◆ TRIGGER_CFD_FRAC

Double_t StripSumScatterConfig::TRIGGER_CFD_FRAC

Definition at line 160 of file Constants.hpp.

Referenced by SetDefaults().

◆ TRIGGER_NSIGMA

Double_t StripSumScatterConfig::TRIGGER_NSIGMA

Definition at line 159 of file Constants.hpp.

Referenced by SetDefaults().

◆ X_DISPLAY_MAX

Double_t StripSumScatterConfig::X_DISPLAY_MAX

Definition at line 184 of file Constants.hpp.

Referenced by main(), and SetDefaults().

◆ X_DISPLAY_MIN

Double_t StripSumScatterConfig::X_DISPLAY_MIN

Display-only windows for the strip-sum scatters (a.u.): the histograms are built over the fixed ScatterBuildRange, so these only zoom the drawn plot via SetRangeUser (no rebuild); XBINS/YBINS do require a rebuild.

Definition at line 183 of file Constants.hpp.

Referenced by main(), and SetDefaults().

◆ X_HI

Int_t StripSumScatterConfig::X_HI

Definition at line 170 of file Constants.hpp.

Referenced by SetDefaults().

◆ X_LO

Int_t StripSumScatterConfig::X_LO

Definition at line 169 of file Constants.hpp.

Referenced by SetDefaults().

◆ XBINS

Int_t StripSumScatterConfig::XBINS

Definition at line 185 of file Constants.hpp.

Referenced by SetDefaults().

◆ Y_DISPLAY_MAX

Double_t StripSumScatterConfig::Y_DISPLAY_MAX

Definition at line 187 of file Constants.hpp.

Referenced by main(), and SetDefaults().

◆ Y_DISPLAY_MIN

Double_t StripSumScatterConfig::Y_DISPLAY_MIN

Definition at line 186 of file Constants.hpp.

Referenced by main(), and SetDefaults().

◆ Y_DISPLAY_RANGE

std::map<Int_t, std::pair<Double_t, Double_t> > StripSumScatterConfig::Y_DISPLAY_RANGE

Per-reaction-strip y-axis display windows, overriding Y_DISPLAY_MIN/MAX for individual strips (display-only, same as the X_DISPLAY_* windows).

Definition at line 192 of file Constants.hpp.

Referenced by main().

◆ YBINS

Int_t StripSumScatterConfig::YBINS

Definition at line 188 of file Constants.hpp.

Referenced by SetDefaults().


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