These are instructions for building EICrecon and all of its dependencies manually.
These are a last resort. Please see instructions for eic-shell.
Start by setting the EICTOPDIR environment variable. This makes it easier to reference directories in the instructions below. Set this to a directory where you want to build and keep the software. If you wish to use your current directory then just do this:
export EICTOPDIR=${PWD}
PODIO requires that the python packages pyyaml and jinja2 be installed. If these are not already installed on your system then you can do so either at a system level (requires sudo privilege) or just create a virtual environment:
mkdir -p ${EICTOPDIR}/python/virtual_environments
python3 -m venv ${EICTOPDIR}/python/virtual_environments/venv
source ${EICTOPDIR}/python/virtual_environments/venv/bin/activate
pip install pyyaml jinja2
Make sure boost is installed (needed for DD4hep). On macosx 12.4 I did this with:
brew install boost
On RHEL7.9 the version installed via yum was too old so I did it from source like this.
export BOOST_VERSION=boost-1.79.0
mkdir -p ${EICTOPDIR}/BOOST
cd ${EICTOPDIR}/BOOST
export Boost_ROOT=${EICTOPDIR}/BOOST/${BOOST_VERSION}/installed
git clone --recursive https://github.com/boostorg/boost.git -b ${BOOST_VERSION} ${BOOST_VERSION}
cmake -S ${BOOST_VERSION} -B build -DCMAKE_INSTALL_PREFIX=${Boost_ROOT} -DCMAKE_CXX_STANDARD=17
cmake --build build --target install -- -j8
We need a modern root version built using the C++17 standard. You may obtain this in a number of ways for your system, but here is how it may be built from source. Be aware that this is the longest step in the whole produce since it may take several minutes (maybe much more). Adjust the number of threads in the make command to match what is available on your system to speed it up.
mkdir ${EICTOPDIR}/root
cd ${EICTOPDIR}/root
wget https://root.cern/download/root_v6.26.04.source.tar.gz
tar xzf root_v6.26.04.source.tar.gz
mv root-6.26.04 root-6.26.04.src
cmake -S root-6.26.04.src -B root-6.26.04.build -DCMAKE_CXX_STANDARD=17 -DCMAKE_INSTALL_PREFIX=root-6.26.04 -Dbuiltin_glew=ON
cmake --build root-6.26.04.build --target install -- -j8
source ${EICTOPDIR}/root/root-6.26.04/bin/thisroot.sh
export JANA_VERSION=v2.0.7
export JANA_HOME=${EICTOPDIR}/JANA/${JANA_VERSION}
git clone https://github.com/JeffersonLab/JANA2 -b ${JANA_VERSION} ${JANA_HOME}
cd ${JANA_HOME}
cmake -S . -B build -DCMAKE_CXX_STANDARD=17 -DCMAKE_INSTALL_PREFIX=${JANA_HOME} -DUSE_ROOT=1 # -DUSE_ZEROMQ=1 -DUSE_PYTHON=1
cmake --build build --target install -- -j8
source ${JANA_HOME}/bin/jana-this.sh # Set environment to use this
export FMT_VERSION=8.1.1
mkdir -p ${EICTOPDIR}/detectors/fmt
cd ${EICTOPDIR}/detectors/fmt
export fmt_ROOT=${EICTOPDIR}/detectors/fmt/${FMT_VERSION}/install
export LD_LIBRARY_PATH=${EICTOPDIR}/detectors/fmt/${FMT_VERSION}/install/lib64:${EICTOPDIR}/detectors/fmt/${FMT_VERSION}/install/lib:${LD_LIBRARY_PATH}
git clone https://github.com/fmtlib/fmt -b ${FMT_VERSION} ${FMT_VERSION}
cmake -S ${FMT_VERSION} -B build -DCMAKE_INSTALL_PREFIX=${fmt_ROOT} -DCMAKE_CXX_STANDARD=17 -DBUILD_SHARED_LIBS=ON
cmake --build build --target install -- -j8
export SPDLOG_VERSION=v1.9.2
export SPDLOG_HOME=${EICTOPDIR}/spdlog/${SPDLOG_VERSION}
export spdlog_ROOT=${SPDLOG_HOME}/install
git clone https://github.com/gabime/spdlog -b ${SPDLOG_VERSION} ${SPDLOG_HOME}
cd ${SPDLOG_HOME}
cmake -S . -B build -DCMAKE_POLICY_DEFAULT_CMP0074=NEW -DCMAKE_CXX_STANDARD=17 -DCMAKE_INSTALL_PREFIX=${spdlog_ROOT} -DSPDLOG_BUILD_SHARED=ON -DSPDLOG_FMT_EXTERNAL_HO=ON
cmake --build build --target install -- -j8
export PODIO_VERSION=v00-15
export PODIO_HOME=${EICTOPDIR}/PODIO/${PODIO_VERSION}
export PODIO=${PODIO_HOME}/install
export podio_ROOT=${PODIO}
git clone https://github.com/AIDASoft/podio -b ${PODIO_VERSION} ${PODIO_HOME}
cd ${PODIO_HOME}
cmake -S . -B build -DCMAKE_INSTALL_PREFIX=${PODIO} -DCMAKE_CXX_STANDARD=17 -DUSE_EXTERNAL_CATCH2=OFF
cmake --build build --target install -- -j8
source ${PODIO_HOME}/env.sh
export EDM4HEP_VERSION=v00-06
export EDM4HEP_HOME=${EICTOPDIR}/EDM4hep/${EDM4HEP_VERSION}
export EDM4HEP=${EDM4HEP_HOME}/install
export EDM4HEP_ROOT=${EDM4HEP}
git clone https://github.com/key4hep/EDM4hep -b ${EDM4HEP_VERSION} ${EDM4HEP_HOME}
cd ${EDM4HEP_HOME}
cmake -S . -B build -DCMAKE_INSTALL_PREFIX=${EDM4HEP} -DCMAKE_CXX_STANDARD=17 -DUSE_EXTERNAL_CATCH2=OFF
cmake --build build --target install -- -j8
export EDM4EIC_VERSION=v1.0.1
export EDM4EIC_HOME=${EICTOPDIR}/edm4eic/${EDM4EIC_VERSION}
export EDM4EIC_ROOT=${EDM4EIC_HOME}/install
git clone https://github.com/eic/edm4eic -b ${EDM4EIC_VERSION} ${EDM4EIC_HOME}
cd ${EDM4EIC_HOME}
cmake -S . -B build -DCMAKE_INSTALL_PREFIX=${EDM4EIC_ROOT} -DCMAKE_CXX_STANDARD=17
cmake --build build --target install -- -j8
export LCIO_VERSION=v02-17-01
export LCIO_HOME=${EICTOPDIR}/LCIO/${LCIO_VERSION}
export LCIO_ROOT=${LCIO_HOME}/install
git clone https://github.com/iLCSoft/LCIO -b ${LCIO_VERSION} ${LCIO_HOME}
cmake -S ${LCIO_HOME} -B ${LCIO_HOME}/build -DCMAKE_INSTALL_PREFIX=${LCIO_ROOT} -DCMAKE_CXX_STANDARD=17
cmake --build ${LCIO_HOME}/build --target install -- -j8
These instructions build DD4hep without Geant4 support. The reconstruction framework does not otherwise require Geant4 so we avoid including support for it for now.
export DD4HEP_VERSION=v01-23
export DD4HEP_HOME=${EICTOPDIR}/DD4hep/${DD4HEP_VERSION}
git clone https://github.com/AIDASoft/DD4hep -b ${DD4HEP_VERSION} ${DD4HEP_HOME}
cd ${DD4HEP_HOME}
cmake -S . -B build -DCMAKE_INSTALL_PREFIX=${DD4HEP_HOME}/install -DCMAKE_CXX_STANDARD=17 -DBUILD_DOCS=OFF -DBoost_NO_BOOST_CMAKE=ON -DROOT_DIR=$ROOTSYS -DDD4HEP_USE_LCIO=ON -DDD4HEP_USE_EDM4HEP=ON
cmake --build build --target install -- -j8
source ${DD4HEP_HOME}/install/bin/thisdd4hep.sh
export EIGEN_VERSION=3.4.0
export EIGEN_HOME=${EICTOPDIR}/EIGEN/${EIGEN_VERSION}
git clone https://gitlab.com/libeigen/eigen.git -b ${EIGEN_VERSION} ${EIGEN_HOME}
cd ${EIGEN_HOME}
cmake -S . -B build -DCMAKE_INSTALL_PREFIX=${EIGEN_HOME} -DCMAKE_CXX_STANDARD=17
cmake --build build --target install -- -j8
export Eigen3_ROOT=${EIGEN_HOME}
export ACTS_VERSION=v19.9.0
export ACTS_HOME=${EICTOPDIR}/ACTS/${ACTS_VERSION}
git clone https://github.com/acts-project/acts -b ${ACTS_VERSION} ${ACTS_HOME}
cd ${ACTS_HOME}
cmake -S . -B build -DCMAKE_INSTALL_PREFIX=${ACTS_HOME}/install -DCMAKE_CXX_STANDARD=17 -DACTS_BUILD_PLUGIN_DD4HEP=on -DACTS_BUILD_PLUGIN_TGEO=on -DACTS_BUILD_PLUGIN_JSON=ON -DACTS_BUILD_PLUGIN_DIGITIZATION=ON
cmake --build build --target install -- -j8
source ${ACTS_HOME}/install/bin/this_acts.sh
export IRT_HOME=${EICTOPDIR}/irt
export IRT_ROOT=${IRT_HOME}/install
git clone https://github.com/eic/irt ${IRT_HOME}
cmake -S ${IRT_HOME} -B ${IRT_HOME}/build -DCMAKE_INSTALL_PREFIX=${IRT_ROOT}
cmake --build ${IRT_HOME}/build -j8
cmake --install ${IRT_HOME}/build
The detector geometry itself is contained in separate repositories. The EPIC reference detector design is in a repository located here. This requires at least ACTS and the {fmt} package the latter of which is built in the instructions here.
Note: These instructions turn off the requirement of the DDG4 component in the epic geometry since it requires GEANT4 which is not needed here.
mkdir -p ${EICTOPDIR}/detectors
cd ${EICTOPDIR}/detectors
export DETECTOR_PATH=${EICTOPDIR}/detectors/epic
git clone https://github.com/eic/epic.git ${DETECTOR_PATH}
cmake -S ${DETECTOR_PATH} -B ${DETECTOR_PATH}/build -DCMAKE_INSTALL_PREFIX=${DETECTOR_PATH} -DCMAKE_CXX_STANDARD=17 -DUSE_DDG4=OFF
cmake --build ${DETECTOR_PATH}/build --target install -- -j8
The EICrecon repository is where the reconstruction code will be kept. There is a top-level CMakeLists.txt file here that can sort-of build everything. Well, OK. The BarrelEMCal plugin requires a header from the jana_edm4hep and tries to get it from its JANA install location. Thus, it is only available after jana_edm4hep has been installed. So when you build EICrecon, you should do each part individually as shown below. The system needs to be updated to be less dependent on the install locations of the plugins, but that will wait until an official build system is established.
git clone https://github.com/eic/EICrecon ${EICTOPDIR}/EICrecon
cd ${EICTOPDIR}/EICrecon
cmake -S . -B build -DCMAKE_CXX_STANDARD=17 -DCMAKE_BUILD_TYPE=Debug
cmake --build build --target install -- -j8
Check that each of the plugins at least load correctly without crashing by running them without arguments:
jana -PPLUGINS=podio,dd4hep