eic / epic

DD4hep Geometry Description of the ePIC Experiment

Home Page:https://eic.github.io/epic

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

CI status

Overview

craterlake

Detector geometry:

Detector parameters:

Getting Started

Get a copy of the latest version from this repository:

git clone https://github.com/eic/epic.git

Compilation

To configure, build, and install the geometry (to the install directory), use the following commands:

cmake -B build -S . -DCMAKE_INSTALL_PREFIX=install
cmake --build build
cmake --install build

To load the geometry, you can use the scripts in the install directory:

source install/setup.sh

Adding/changing detector geometry

Hint: Use the CI/CD pipelines.

To avoid dealing with setting up all the dependencies, we recommend using the continuous integration/continuous deployment (CI/CD) pipelines to make changes and assess their effects. Any feedback to help this process is appreciated.

Here is how to begin:

  1. Look at existing detector constructions and reuse if possible. Note that "compact detector descriptions" -> xml files, and "detector construction" -> cpp file.
  2. Modify xml file or detector construction.
  3. Create a WIP (or draft) merge request or pull request and look at the CI output for debugging. Then go to back to 2 if changes are needed.
  4. Remove the WIP/Draft part of the merge request if you would like to see your changes merged into the main.

See:

Compiling (avoid it)

First, see if the use case above is best for you. It most likely is and can save a lot of time for newcomers. To run the simulation locally, we suggest using the singularity image. More details can be found at the links below:

Related useful links

About

DD4hep Geometry Description of the ePIC Experiment

https://eic.github.io/epic

License:GNU Lesser General Public License v3.0


Languages

Language:C++ 81.3%Language:Python 8.4%Language:Shell 7.6%Language:Jinja 2.0%Language:CMake 0.6%Language:HTML 0.1%Language:Ruby 0.0%