Skip to content

legend-exp/remage

Repository files navigation

remage logo

remage

Simulation framework for germanium detector experiments

GitHub tag (latest by date) GitHub Workflow Status pre-commit GitHub issues GitHub pull requests Read the Docs Docker Hub License DOI


The remage project aims to deliver a modern Geant4-based C++ library designed for efficient simulation of particle physics processes in typical germanium detector experiments. The library is setup-agnostic, requiring users only to define the experimental setup's geometry. Supported specification languages include C++, GDML, and others. Once the geometry is provided, users can access a comprehensive suite of tools for common tasks, such as physics generation and standard output handling.

Get started with our documentation pages!

Main features

  • Low entry barrier: Most simulations can be executed directly using the remage executable and a macro file, eliminating the need to write or compile C++ code.
  • Various pre-compiled remage versions available on Docker Hub
  • Support for modern Geant4, including:
    • Multithreading
    • GDML support
    • Multiple output file formats (ROOT, HDF5...)
  • LEGEND HDF5 (LH5) output format
  • Fast third-party cosmic muon generator (through EcoMug)
  • Support for external generators:
  • Third-party double-beta decay generator (through bxdecay0)
  • Advanced vertex confinement on physical volumes, geometrical solids, surfaces and intersections
  • Sensible output schemes for HPGe and optical detectors