Tools etc.

GRETINA Tools, Resources, etc.

Over the time of the GRETINA project and subsequent physics campaigns, a wide range of tools have been developed for attacking various aspects of data analysis etc., and a significant amount of more technically-oriented information compiled. You'll find here the tools and information compiled as much as possible; if you know of a GRETINA-related resource that should be included here and is not, please let us know! Similarly, if there is something you think is missing and would like to see, please let us know!

We've also uploaded a standard data set for new users to look at, to check analysis codes, etc., and get use to this type of data. For more information, check out the details here.

(Physics) Data Analysis

We can break data analysis resources into a few different areas; there is information that is of general use to understand the GRETINA data structures, geometries, etc., there are a fair number of "complete" data analysis packages with varying levels of support and completeness, and there are stand-alone packages to perform one particular aspect of analysis, such as tracking. We group the resources into these categories below.

General-Purpose Analysis Resources

'Complete' Data Analysis Packages

  • LBNL Analysis package

    • A ROOT based analysis package initially written by Stefanos Paschalis, this is now a complete package appropriate for analysis of GRETINA + S800, CHICO-2 and Phoswich Wall. It also includes multiple tools for base-level GRETINA analysis, related to R&D of the array.

    • The package incorporates tracking based on the ANL tracking codes.

    • At present this code is free available on a github repository -- for more information or questions on this analysis package, contact Heather Crawford.

  • GRUTinizer

    • The primary ROOT-based analysis package used in the second NSCL GRETINA campaign. GRUTinizer was written by Peter Bender (UMass Lowell), and collaborators at NSCL. It is maintained by Peter Bender and his collaborators.

    • GRUTinizer is available freely on a github repository. For more information or questions, contact Peter Bender.

  • GTSort

    • The ANL produced analysis software for GRETINA; this will look very familiar to those familiar with GSSort for Gammasphere.

    • Maintained primarily by Torben Lauritsen at ANL, this code interfaces naturally with his tracking code.

  • GrROOT

    • The main ROOT analysis package used in the first NSCL GRETINA+S800 experimental campaign, GrROOT was written initially by Kathrin Wimmer (University of Tokyo). It is not actively supported.

    • Distribution of GrROOT is under the control of Kathrin and Eric; with permission it can be downloaded online.

Targeted Analysis Resources

  • GRETINA official tracking code

    • The online tracking code used with GRETINA is maintained by Torben Lauritsen at ANL; he also maintains an offline version accessible from his website at ANL.

    • Tracking has been incorporated into some of the "complete" analysis packages; the LBNL code incorporates the tracking from Torben; GrROOT has it's own tracking/clustering incorporated.


The simulation effort for GRETINA has largely converged to a GEANT4 based simulation package maintained by Lew Riley (Ursinus College); however there is a historic original (bare-bones) GRETINA simulation which can still be used if needed for specific tasks.

GEANT4 Simulation Packages

  • UCGretina

    • Developed by Lew Riley and his students at Ursinus College, this simulation is tailored to the simulation/analysis of GRETINA+S800 experiments, and is the current benchmark simulation for GRETINA. The geometry from the original GretinaSim was transplanted into an existing simulation framework previously used to analyze inelastic scattering and nucleon knockout reactions at NSCL.

    • The UCGretina analysis package is hosted using a Git repository on Bitbucket. Please contact Lew Riley for information if you would like to work on the GRETINA/GRETA simulation efforts, or would like access to this code.

  • GretinaSim

    • This code is essentially the AGATA simulation framework with geometry files modified to reproduce the GRETINA module and mounting frame geometries, including dead materials. With the improvements being made to customize the simulation for GRETINA and its associated detector systems under the framework of UCGretina, this package has been largely phased out.

    • Those who are interested however can download the original code here. To install this package:

      1. Download and unpack into your $G4WORKDIR

      2. cd to the unpacked directory

      3. Make

  • GEANT4

    • GEANT4 is available for download at CERN.

    • Please note that UCGretina package has versions compatible with Geant4 version 4.9.6.p03 and Geant4.10.

Offline Software (decomposition / basis creation)

There are a number of offline software packages which do not relate to physics data analysis, but are critical to GRETINA, and the development of GRETA nonetheless. Some of these are openly available, as described here.

Signal Decomposition

  • Offline signal decomposition (PetCat)

    • In order to facilitate the continued development of the basis creation and signal decomposition codes, an offline version of the signal decomposition code has been developed. This is a code which is algorithmically identical to the decomposition being run on the GRETINA cluster, but can run on a personal computer to perform signal decomposition for a single GRETINA crystal based on raw data (mode3) in a file.

    • PetCat (the origin of the name is a Mario and offer to help out our efforts on signal decomposition if you want to know) is available online through a Mercurial Bitbucket-hosted software repository. Please contact Mario Cromaz to get details and an invitation to access the repository.