CORSIKA 8 Framework for Particle Cascades in Astroparticle Physics**

Documentation and reference guide for the CORSIKA 8 software framework for air shower simulations. We aim that CORSIKA remains the most comprehensive framework for simulating particle cascades with stochastic and continuous processes. The purpose of CORSIKA is to simulate any particle cascades in astroparticle physics or astrophysical context. A lot of emphasis is put on modularity, completeness, validation and correctness. To boost computational efficiency different techniques are provided, like thinning or cascade equations.

The software makes extensive use of static design patterns and compiler optimization. Thus, the most fundamental configuration decision of the user must be performed at compile time. At run time only specific model parameters can still be changed.

CORSIKA 8 is released under the GPLv3 license. See license file which is part of every release and the source code.

When you contribute to CORSIKA check the guidelines outlined here: coding guidelines. Code that fail the review by the CORSIKA author group must be improved before it can be merged in the official code base. After your code has been accepted and merged you become a contributor of the CORSIKA project and you should include yourself in the AUTHORS file.

You need to read and agree to the collaboration agreement. The agreement can be discussed, and eventually improved.

We also want to point you to the MCnet guidelines, which are very useful also for us.

Prerequisites

On a fresh ubuntu 18.04 system you would need the following extra packages:

apt-get install cmake libboost-dev libeigen3-dev python3 gfortran

If you work with FreeBSD, run: pkg install git cmake python3 flang boost-libs eigen

Installation

Follow these steps to download and build CORSIKA 8 milestone2

git clone git@gitlab.ikp.kit.edu:AirShowerPhysics/corsika.git
cd corsika
git checkout milestone2
mkdir ../corsika-build
cd ../corsika-build
cmake ../corsika -DCMAKE_INSTALL_PREFIX=../corsika-install
make -j8
make install
make test

and if you want to see how the Heitler model works and is implemented, see Framework/Cascade/testCascade.cc for a starting point.