The Labyrinth

What is the labyrinth

The major components are:

gminos:

is the framework for the GEANT3 based simulation of MINOS (and any other sandwich active-passive plane neutrino detector). It supplies a means of configuring the geometry via data cards, selecting neutrino flux from a variety of methods, calling event generators (neutrino and cosmic muons), passing the events to GEANT3 for tracking, recording hits/digits and the initial event into ADAMO data structures/files, MINOS specific digitizing routines for simulating the two electronics configurations.

generator/neugen:

is the code supplied by the Soudan2 collaboration that provides total cross sections and individual event generation based on a neutrino + nucleon.

bfield:

a variety of MINOS steel maps.

mixing:

David Petyt's neutrino oscillation library.

analysis/reco_minos:

a framework for analyzing GMINOS generated events. This is mostly I/O and user hooks, but includes some basic reconstruction algorithms. It also include the maw program which combines paw with tip (ADAMO) and RECO_MINOS code.

utilities:

various subroutines/functions used by GMINOS and/or RECO_MINOS. Also supplies source for fsplit.

For the most part there are three executables that one will run.

The gminos_batch executable is the standard GMINOS program. This is highly configurable using FFREAD data cards and for many uses the user does not need a private (modified) copy of the executable -- though one can further extend GMINOS with some minimal effort.

The second executable is maw which provides useful quick access to the output of a GMINOS run; as this incorporates paw,one can access the data structures using COMIS (interpreted pseudo-FORTRAN). This is useful for many quick-and-dirty tests including histogramming of variables and the development of algorithms.

Finally there are reconstruction/analysis programs that are built by the user (the default name is theseus.exe). In these programs the user supplys additional code that is called by predefined hooks in the RECO_MINOS framework.

Both GMINOS and RECO_MINOS are generally driven by FFREAD data card files; they share some card definitions, used mostly for controlling the scintillation hit digitization, but in general their card files are quite different.

general GMINOS &RECO_MINOS info

• Getting started with the Labyrinth. Older HyperNews entry concerning installation instructions (read all the followups before beginning) for the Labyrinth (and ADAMO).

• ADAMO tutorial (reference) NuMI-L-243.

• GMINOS Simulation a FORTRAN based active-passive plane sandwich detector simulation.
  • GMINOS geometry cards is FFREAD data card definitions for specifying geometry configuration.

  • GMINOS program flow cards is FFREAD data card defintions for controlling GMINOS event generation.

  • NEUGEN3 cards is FFREAD data card defintions for controlling NEUGEN3 generation.
    (Also see GMINOS program flow cards).

• RECO_MINOS framework is a FORTRAN based reconstruction framework for analyzing GMINOS output. Also see this older page.

• MAW: MINOS Analysis Workstation is a hybrid of PAW and TIP (ADAMO) and MINOS-specific routines.

MINOS specific and/or specialized info

• MINOS Entity Sets

• About weighted events in GMINOS

• About FLSDigit attribute: hitbits

• About INTRANUKE

• About muon reconstruction

• New event files

• DST Ntuples