====About Pythia8====

PYTHIA [[https://https://pythia.org/]] is a program for the generation of high-energy physics collision events, i.e. for the description of collisions at high energies between electrons, protons, photons and heavy nuclei. It contains theory and models for a number of physics aspects, including hard and soft interactions, parton distributions, initial- and final-state parton showers, multiparton interactions, fragmentation and decay. It is largely based on original research, but also borrows many formulae and other knowledge from the literature. As such it is categorized as a general-purpose Monte Carlo event generator.

On LENGAU, Pythia8 has been built from source and a module file has been created for the application. Users can simply load the Pythia8 module into their shell environment: 
  module avail 2>&1 | grep -i pythia
  module load chpc/phys/pythia8/8.309-gcc13
  # Run Pythia
  ./mypythia
  
=====Batch Script Example=====
This is just a simple example which will be improved as testing commences: 
<file bash pythia8.qsub>
#!/bin/bash 
#PBS -P projectid
#PBS -l select=3:ncpus=24:mpiprocs=24:nodetype=haswell_reg
#PBS -q normal
#PBS -l walltime=01:00:00
#PBS -o /mnt/lustre/users/username/rootJobs/job01/stdout
#PBS -e /mnt/lustre/users/username/rootJobs/job01/stderr
#PBS -m abe
#PBS -M username@email.co.za
### Load the Pythia8 environment:
module load chpc/phys/pythia8/8.309-gcc13
##### Running commands
# Set this environment variable explicitly.
export PBS_JOBDIR=/mnt/lustre/users/username/rootJobs/job01
# Explicitly change to the job directory
cd $PBS_JOBDIR
nproc=`cat $PBS_NODEFILE | wc -l`
exe=pythia8
mpirun -np $nproc ./exe > pythia.out
</file>
  
Instructions on how to create and submit a batch job will follow as collaborative testing commences...