Merge branch 'main' of https://www.ict.inaf.it/gitlab/icsc_g4_hpc/BoGEMMS-HPC

# Getting started

BoGEMMS-HPC uses a configuration file to set-up the physics, geometry and the I/O interface, while the input can be set with the Geant4 GPS macro file, or from a list of particle , in ASCII, FITS, or ROOT format. 

BoGEMMS-HPC uses a configuration file to set-up the physics, geometry and the I/O interface, while the input can be set with the Geant4 GPS macro file, or from a list of particles in ASCII, FITS, or ROOT format. 

## Configuration keywords

### Activating simulation from particle list

The primary particles in Geant4 can be randomly generated from a distribution defined in GPS by means of the macro file, or can be defined from a list, that describes for each row the particle type, energy, direction cosines and position from where the particle is generated.

- `EVENT.PRIMARY.LIST.ACTIVATE` = 0/1 to activate the use of lists (default = 0)

- `EVENT.PRIMARY.FORMAT` = 0 (ASCII), 1 (ROOT), 2 (FITS) (default = 0)

- `EVENT.PRIMARY.LIST.FILENAME` = path to the file

## Primary input definition

## Geometry

## Physics