Commit 19872be9 authored by Dmitry Romanov's avatar Dmitry Romanov
Browse files

Athena index

parent 30e0d33d
spack:
specs:
- assimp +ipo
- acts@8.03.0 +dd4hep +digitization +examples +fatras +identification +json +tgeo +ipo
- cmake
- clhep cxxstd=17
- dd4hep +geant4 +hepmc3 +lcio +ipo
- eigen
- gaudi@34.0 +ipo
- geant4 +ipo -qt -opengl -python +vecgeom cxxstd=17
- genfit +ipo
- hepmc3 +interfaces +python +rootio
- lcio +ipo
- nano
- opencascade +ipo +tbb -vtk
- podio +ipo
- pythia8 +fastjet
- root cxxstd=17 +fftw +fortran +gdml +mlp +pythia8 +root7 +tmva +vc +xrootd +ssl
- singularity +suid
- xrootd cxxstd=17 +python
- eicd
- npdet@master
concretization: together
config:
install_missing_compilers: true
# install_tree: /opt/software
view: false
\ No newline at end of file
......@@ -47,15 +47,38 @@ Using npsim (wrapper around ddsim) command line:
Geometry visualization
----------------------
There are many ways to see the geometry and tracks:
1. Through Geant4 event display
2. geoDisplay (root geoViewer)
3. ddeve (root EVE based event display...)
4. dd_web_display (using browser and jsroot library)
Geometry conversion
-------------------
Convert to GDML
---------------
~~~~~~~~~~~~~~~
There is a convert_to_gdml.py script in the detector repository
(https://eicweb.phy.anl.gov/EIC/detectors/athena/-/blob/master/scripts/convert_to_gdml.py).
That can be used to export ALL of ATHENA to gdml, but not individual detector systems.
This is actually [done](https://eicweb.phy.anl.gov/EIC/detectors/athena/-/blob/master/.gitlab-ci.yml#L168) on every commit
This is actually `done <https://eicweb.phy.anl.gov/EIC/detectors/athena/-/blob/master/.gitlab-ci.yml#L168>`_ on every commit
and the results are saved as job artifacts.
`The latest athena.gdml from the master branch <https://eicweb.phy.anl.gov/api/v4/projects/473/jobs/artifacts/master/raw/geo/athena.gdml?job=report&item=default>`_
Convert to root
~~~~~~~~~~~~~~~
One can use dd_web_display to actually just save root geometry
.. code:: bash
dd_web_display --export athena.xml # will create a .root file with the geometry
\ No newline at end of file
Local installation
==================
***(!)Warning(!)*** - local installation is for expert users only!
There are many possible pitfalls why some parts of the software might not be installed, give compilation errors, etc.
Then it require some spack-kung-foo to debug and recover the installation. Finally you may end up with different
options compiled (like QT support for Geant4) so your installation (or even simulation results!) are different than in production.
We release container images exactly to avoid all the problems above. So if you don't want to struggle use them. But if you want...
Spack
-----
Install spack
.............
Spack is a package management tool designed to support multiple versions
and configurations of software on a wide variety of platforms and
environments. Spack allows to automatically build target packages with
all needed dependencies. `Sapck
documentation <https://spack.readthedocs.io/en/latest/getting_started.html#installation>`__
The installation consist of 3 steps then: 1. Install spack itself 2.
Install `eic-spack repository <https://github.com/eic/eic-spack>`__ (with EIC
packages) 3. Run spack command to install athena packages (like npdet)
To install spack and EIC repository:
.. code:: bash
git clone https://github.com/spack/spack.git
#Source environment
# For bash/zsh users
$ . spack/share/spack/setup-env.sh
# For tcsh/csh users
$ source spack/share/spack/setup-env.csh
You should be able now to use spack:
.. code:: bash
spack info root
(!) By default, all packages will be downloaded, built and installed in this spack directory
`More documentation on spack installation <https://spack.readthedocs.io/en/latest/getting_started.html#installation>`_
Clone and add `eic-spack repository <https://github.com/eic/eic-spack>`_:
.. code:: bash
# Adding the EIC Spack Repository
git clone https://github.com/eic/eic-spack.git
# Add this repository to your Spack configuration
spack repo add eic-spack
Then you should be able to install ATHENA packages. The full spack environment for the stack:
.. code:: yaml
spack:
specs:
- assimp +ipo
- acts@8.03.0 +dd4hep +digitization +examples +fatras +identification +json +tgeo
+ipo
- cmake
- clhep cxxstd=17
- dd4hep +geant4 +hepmc3 +lcio +ipo
- eigen
- gaudi@34.0 +ipo
- geant4 +ipo -qt -opengl -python +vecgeom cxxstd=17
- genfit +ipo
- hepmc3 +interfaces +python +rootio
- lcio +ipo
- nano
- opencascade +ipo +tbb -vtk
- podio +ipo
- pythia8 +fastjet
- root cxxstd=17 +fftw +fortran +gdml +mlp +pythia8 +root7 +tmva +vc +xrootd +ssl
- singularity +suid
- xrootd cxxstd=17 +python
- eicd
- npdet@master
concretization: together
config:
install_missing_compilers: true
# install_tree: /opt/software
view: false
Copy this or download `athena.yaml <athena.yaml>`_
.. code:: bash
spack env create athena athena.yaml
spack env activate athena
spack install
\ No newline at end of file
Run simulation
==============
This page provides information and tips about running the simulation, geometry visualization and
data processing.
......@@ -26,11 +26,12 @@ ATHENA Software
:caption: HOWTOs:
howto/run_fast_simulation
howto/full_simulation_tutorial
howto/full_simulation
howto/use_singularity
howto/s3_file_storage
howto/beagle_generator
howto/geometry_viewer
howto/local_install
.. toctree::
:maxdepth: 1
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment