Overview
The SLIC simulation package produces simulated physics events in the LCIO data format. This tutorial shows how to read these events into the Pandora PFA New project to create output Particle Flow Objects (PFOs).
Setup
Preliminaries
A Linux or Unix platform is assumed and the bash shell is used for all command-line instructions. These procedures should also work on an emulation platform like Cygwin. (untested!)
Two external packages must be installed onto your machine before setting up the SLIC to Pandora interface package. The LCIO package provides the data interchange format. The Pandora PFA New project is the C++ implementation of the Pandora Particle Flow Algorithm (PFA).
LCIO Installation
Checkout the LCIO project from cvs.
cd /workdir cvs -d :pserver:anonymous@cvs.freehep.org:/cvs/lcd co lcio
Building this project requires the CMake tool, the installation of which is not covered here. It additionally requires command-line GNU Make.
cd lcio cmake . make
Pandora PFA New Installation
Now download the Pandora project from the internet and build it. This project also requires CMake to build it.
Follow this link to download the SVN trunk of the Pandora project. Save it to your local computer.
cd /workdir tar -zxvf PandoraPFANew-trunk.tar.gz cd trunk cmake . make
Now we're ready to setup the project that interfaces SLIC to Pandora.
slicPandora Installation
Checkout the slicPandora project from cvs.
cd /workdir cvs -d :pserver:anonymous@cvs.freehep.org:/cvs/lcd co slicPandora cd slicPandora
Copy the example setup script.
cp example_setup.sh my_setup.sh
Edit my_setup.sh so that the PANDORAPFA and LCIO variables point to the correct locations of these packages on your computer (from the installation above).
Source the new setup script.
. my_setup.sh
Build the slicPandora project.
make
The slicPandora project should now build successfully. If compilation or linking errors occur, then check that LCIO and Pandora were installed successfully and that the setup script is pointing to the correct locations of these packages.
Running Events
JobManagerTest
The JobManagerTest runs an example of slicPandora using sample input files. To use this event, you need to provide a symlink to an LCIO file in the slicPandora root directory and call it input.slcio.
cd /workdir/slicPandora ln -s /path/to/myinput.slcio input.slcio