You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 49 Next »

Directory Structure

Variable Format

Variables have the following conventions:

Strings start with 's'.

Numbers which can be integers or decimals start with 'n'.

Timestamps start with 't'.

Engineering Run Variables

Convention is that any metadata assigned to the raw EVIO files is then also inherited by reconstructed files. This list is the variables that are to be assigned for raw data and pass0. ("*" means will be set on the next pass)

General

These come from the raw EVIO file (either parsed from its name, or directly from bank contents).
nRun
nFileNumber
nEvents* (for the whole run)
tRunStart*
tRunEnd*
nEventMin* (for one file only)
nEventMax* (for one file only)
These come only from the run spreadsheet or logbook. In case no values were recorded, nothing is assigned (e.g. beam current/positions, which we may want to get from EPICS database later anyway.).
sDescription (all available comments)
sTarget ("none" if no target)
nBeamCurrent (nA)
nBeamX (mm)
nBeamY (mm)
nBeamEnergy* (GeV)
nChicaneOffset (% relative to nominal)

DAQ

These are quantities that could be extracted from a DAQ configuration bank in the EVIO file. If not available (e.g. before the bank was implemented or overlooked variables were added), they come from the run spreadsheet or logbooks. Naming conventions match that used by the DAQ (unless there was a usability reason to do otherwise).

SSP

nSSP_W_OFFSET (ns)
nSSP_W_WIDTH (samples)
nSSP_BLOCK_LEVEL (1,40)=(non-blocking/blocking)
nSSP_HPS_LATENCY (?)

GTP

Clustering algorithm parameters.
nGTP_CLUSTER_PULSE_THRESHOLD (MeV, seed)
sGTP_CLUSTER_PULSE_COIN ('N M')=(# 4ns samples before/after seed')

ECal FADC

nECALFADC_MODE (1,3,7)=(raw,pulse,high-res)
nECALFADC_NPEAK (1,2,3)
nECALFADC_NSA (ns)
nECALFADC_NSB (ns)
nECALFADC_THRESH (ADC)
nECALFADC_W_OFFSET (ns)
nECALFADC_W_WIDTH (ns)
nECALFADC_MASK (0,1,2)=(none,medium-angle,large-angle) (trigger mask implemeneted via zeroing gains)

Trigger

Variables suffixed with "EN" represent whether that trigger or cut was enabled: (0,1)=(no,yes)

Cosmic, LED, Pulser

nSSP_HPS_COSMIC_EN
nSSP_HPS_COSMIC_TIMECOINCIDENCE (ns)
nSSP_HPS_LED_EN
nSSP_HPS_PULSER (Hz)
nSSP_HPS_PULSER_EN

Physics

There are 2 SINGLES and 2 PAIRS triggers, labelled 0 and 1 (represent by "#" below).
Prescaling
Actual prescale factor is 2^N.
nTI_INPUT_PRESCALE_SINGLES_# N
nTI_INPUT_PRESCALE_PAIRS_# N
Singles
nSSP_HPS_SINGLES_#_EN
nSSP_HPS_SINGLES_EMAX_#_EN
nSSP_HPS_SINGLES_EMIN_#_EN
nSSP_HPS_SINGLES_NMIN_#_EN
nSSP_HPS_SINGLES_NMIN_# (minimum number of hits)
nSSP_HPS_SINGLES_EMAX_# (MeV)
nSSP_HPS_SINGLES_EMIN_# (MeV)
Pairs
nSSP_HPS_PAIRS_#_EN
nSSP_HPS_PAIRS_NMIN_# (minimum number of hits per cluster)
nSSP_HPS_PAIRS_EMAX_# (MeV)
nSSP_HPS_PAIRS_EMIN_# (MeV)
nSSP_HPS_PAIRS_SUMMAX_MIN_#_EN
nSSP_HPS_PAIRS_DIFFMAX_#_EN
nSSP_HPS_PAIRS_ENERGYDIST_#_EN
nSSP_HPS_PAIRS_COPLANARITY_#_EN 
nSSP_HPS_PAIRS_TIMECOINCIDENCE_# (ns)
nSSP_HPS_PAIRS_DIFFMAX_# (MeV)
nSSP_HPS_PAIRS_SUMMAX_MIN_#_HI (MeV)
nSSP_HPS_PAIRS_SUMMAX_MIN_#_LO (MeV)
nSSP_HPS_PAIRS_ENERGYDIST_#_OFFSET (MeV)
nSSP_HPS_PAIRS_ENERGYDIST_#_SLOPE (MeV/mm)
nSSP_HPS_PAIRS_COPLANARITY_# (deg)
nSSP_HPS_PAIRS_CLUSTERDELAY_# (ns)

Offline

sRelease
sSteering
sDetector
nPass
sCollections

OLD List of Metadata Variables

Run and Event Meta Data

tRunStart - run start time

tRunEnd - run end time

tEventStart - earliest event time

tEventEnd - latest event time

nRun - single run number which can be set on all individual files (except for StdHep events)

nEventMin - minimum event number

nEventMax - maximum event number

sRunStatus - run status which could be GOOD, BAD or UNKNOWN (for instance)

nEvents - number of events in the run

 

Physics Event Information

sCollections - list of data collections separated by commas

sDetectorName - name of the lcsim detector model

Beam and Conditions

nBeamEnergy - beam energy in GeV

nBeamCurrent - beam current in nA

nBeamSpotSizeA - major axis

nBeamSpotSizeB - minor axis

nBeamSpotSizePhi - major axis angle w.r.t. x-axis

nMagnetCurrent - (multiple?)

System Status

sSvtOpen - SVT was open or closed

sSvtStatus - status of the SVT (GOOD/BAD/OFF/UNKNOWN)

sEcalStatus - status of the ECAL

sTriggerStatus - status/configuration of the trigger

sTargetStatus - IN/OUT

Raw EVIO Data

sFileNumber - sequential number of the file in the run

LCIO Recon

sReconPass - the recon pass OR the catalog's built-in Version on each file could be used for this

sReconVersion - the Maven tag of HPS Java used to generate the file e.g. "1.2.3"

sRawDataPath - the path to the corresponding raw EVIO data file in the catalog used to generate this file

ROOT DST

sDstMakerVersion - the version of the DST Maker used to create the file; can be read from TClass->GetClassVersion() in ROOT which corresponds to a git tag

sReconDataset - dataset path in the catalog of the corresponding LCIO recon file used to generated this DST file

sCuts - list of cuts used to produce the DST (if any)

StdHep

sEventType - trident, A-prime, backgrounds, etc.

nEventMass - mass of event

nCoupling - A-prime coupling strength

nBeamEnergy - energy of beam

LCIO Simulated Output

sPhysicsLists - name of Geant4 physics list used to generate

sSlicVersion - the SLIC version

sGeantVersion - the Geant4 version

sRandomSeed - random seed used to generate events or 0 if none was explicitly given

  • No labels