dune/duneanaobj

Purpose and entry points

duneanaobj defines the C++ object schema for DUNE CAF (Common Analysis File) ROOT TTrees. Each TTree entry contains one caf::StandardRecord; this repository provides the headers, compiled library, ROOT dictionary metadata, and navigation/proxy interfaces needed to read that schema. It does not write CAFs; external FD/ND CAFMaker applications do.

Primary consumer entry point: duneanaobj/StandardRecord/StandardRecord.h. Library implementation and aggregate record behavior live in duneanaobj/StandardRecord/StandardRecord.cxx.

Build, packaging, and runtime boundary

The project is a CMake-built C++ library, rooted at CMakeLists.txt, with the schema target organized under duneanaobj/StandardRecord/CMakeLists.txt. It is distributed both as a normal linked library and a Fermilab UPS product via ups/product_deps and ups/setup_for_development.

Runtime dependencies are ROOT (CAF serialization, dictionaries, and interactive reading) and the Fermilab CET/UPS environment for the documented development build. Consumers need the library available at dynamic-link time and headers when compiling C++ readers.

Root record and schema composition

caf::StandardRecord is the top-level persisted event object. It aggregates global event data and detector-/domain-specific branches, rather than exposing low-level detector hit data.

Key schema surfaces:

• Root aggregate: duneanaobj/StandardRecord/StandardRecord.h, duneanaobj/StandardRecord/StandardRecord.cxx

• Global/shared event content: duneanaobj/StandardRecord/SRGlobal.h, duneanaobj/StandardRecord/SRMeta.h

• Common reconstruction branch types: duneanaobj/StandardRecord/SRCommonRecoBranch.h, duneanaobj/StandardRecord/SRRecoParticlesBranch.h

• Enumerated stable values: duneanaobj/StandardRecord/SREnums.h

The main compatibility boundary is the persisted object layout: changing record or branch fields affects CAF readers and writers across the DUNE software ecosystem.

Detector and experiment-domain branches

The schema partitions event content by source/detector while retaining a single event-level record. Far detector content is represented by SRFD and its branch; near-detector data has dedicated LAr and association structures; gas-argon and MINERvA data are independent domains.

Representative components:

• FD: duneanaobj/StandardRecord/SRFD.h, duneanaobj/StandardRecord/SRFDBranch.h

• ND LAr and cross-object associations: duneanaobj/StandardRecord/SRNDLAr.h, duneanaobj/StandardRecord/SRNDTrackAssn.h, duneanaobj/StandardRecord/SRNDShowerAssn.h

• GAr: duneanaobj/StandardRecord/SRGAr.h, duneanaobj/StandardRecord/SRGArTrack.h

• Beam and external detector summaries: duneanaobj/StandardRecord/SRBeamBranch.h, duneanaobj/StandardRecord/SRMINERvA.h

Reconstruction, truth, and links

CAF data flow is: upstream simulation/reconstruction systems populate high-level reconstructed objects and summary truth; CAFMaker serializes the populated StandardRecord into ROOT; analysis clients deserialize it and traverse object collections and associations.

Reconstructed entities include tracks, showers, PFParticles, and generic reco-particle abstractions:

duneanaobj/StandardRecord/SRTrack.h, duneanaobj/StandardRecord/SRShower.h, duneanaobj/StandardRecord/SRPFP.h.

Truth data represents interactions and particles, with event-level truth grouping:

duneanaobj/StandardRecord/SRTruthBranch.h, duneanaobj/StandardRecord/SRTrueInteraction.h, duneanaobj/StandardRecord/SRTrueParticle.h.

Associations and overlap collections are structural links between these collections, not external database references; readers must respect nested variable-length collection limits in ROOT TTreeFormula.

Math, weights, and systematic metadata

Portable schema-owned vector types avoid making consumers depend on an upstream physics framework:

duneanaobj/StandardRecord/SRVector3D.h, duneanaobj/StandardRecord/SRLorentzVector.h.

Event weighting and systematic parameter headers are modeled in-record:

duneanaobj/StandardRecord/SRWeightGlobal.h, duneanaobj/StandardRecord/SRSystParamHeader.h.

ROOT integration, navigation, and flattened access

ROOT dictionary generation is declared by duneanaobj/StandardRecord/classes.h and duneanaobj/StandardRecord/classes_def.xml; these are essential for object streaming and interactive ROOT access.

For traversal convenience, the project supplies navigation and generated proxy layers:

duneanaobj/StandardRecord/Navigate.h, duneanaobj/StandardRecord/Proxy/Instantiations.cxx.

A separate flat representation boundary exists under duneanaobj/StandardRecord/Flat/Prolog.h; flat CAF production is performed by external CAFMakers, enabling simpler branch-oriented analysis where deeply nested standard-record collections are inconvenient.