Important version notes (updated 16 March 2017)

Then run your new processor with

Marlin -? 
Particularly useful:
Marlin -c SiDReconstruction_v03_160711.xml  (check given  steering file for consistency) 

Running digitization and reconstruction

export LCGRELEASES=/cvmfs/sft.cern.ch/lcg/releases/LCG_84
export PYTHONDIR=$LCGRELEASES/Python/2.7.10/x86_64-slc6-gcc48-opt
export PATH=$PYTHONDIR/bin:$PATH
export LD_LIBRARY_PATH=$PYTHONDIR/lib:$LD_LIBRARY_PATH
export PYTOOLSDIR=$LCGRELEASES/pytools/1.9_python2.7/x86_64-slc6-gcc48-opt
export PYTHONPATH=$PYTOOLSDIR/lib/python2.7/site-packages:$PYTHONPATH
export PATH=$PYTOOLSDIR/bin:$PATH

Troubleshooting

There were problems with libraries from /cvmfs/sft.cern.ch/ that might have been due to a faulty CVMFS repository (see this report).

cd ../
wget https://twiki.ppe.gla.ac.uk/pub/LinearCollider/GlaSiDGettingStarted/TrackAna.tgz
tar -zxvf TrackAna.tgz
ls Tracking/

wget https://twiki.ppe.gla.ac.uk/pub/LinearCollider/GlaSiDGettingStarted/SiDReconstruction_v03_160711.xml
wget https://twiki.ppe.gla.ac.uk/pub/LinearCollider/GlaSiDGettingStarted/gear_sid.xml

Once you've done this, and assuming you are still in the lcgeo directory, and you have initialised your session as above, run

• SiDReconstruction_v03_160711.xml: Tutorial reconstruction XML

Our example analysis code can be found here, and it will contain

CMakeLists.txt
gear_sid.xml  
HitResiduals.xml
include/LinkDef.h  
include/HitResiduals.h
src/HitResiduals.cc

cd Tracking
mkdir build lib
cd build
cmake -DCMAKE_CXX_COMPILER=`which g++` -DCMAKE_C_COMPILER=`which gcc` \
  -DILCUTIL_DIR=/cvmfs/ilc.desy.de/sw/x86_64_gcc48_sl6/v01-17-10/ilcutil/v01-03/ -C $ILCSOFT/ILCSoft.cmake ..
make -j4 install

Now we run processor with

cd ../
export MARLIN_DLL=$MARLIN_DLL:./lib/libTrackAna.so
Marlin HitResiduals.xml

Important version notes

We are running on SL6 machines and haven't tried other architectures. Note that you must have cvmfs installed (ask your local sysadmin). Latest update was on 5 Sept 16, using the latest ilcsoft release v01-17-10 for everything.

Building the detector model (lcgeo)

Download the code and removing some unwanted drivers (these first five steps are to be done one time only):

Setup the environment (these steps will have to be repeated at the beginning of every session):

Prepare the build environment (note the ending double-dots!):

cmake -DCMAKE_CXX_COMPILER=`which g++` -DCMAKE_C_COMPILER=`which gcc` -C /cvmfs/ilc.desy.de/sw/x86_64_gcc48_sl6/v01-17-10/ILCSoft.cmake ..

Build the code with

make -j4
make install

You will now have to update your environment to include the newly created apps

source ../bin/thislcgeo.sh

Modifying the code

If you modify the detector model, lcgeo needs to be rebuilt.

If you add, remove, or move files from the directories, you have to rerun cmake as above (note the doble-dots at the end)

Running simulation and reconstruction

Session initialisation

You must run these commands at the beginning of every session:

Depending on your system, you might have to type the following 7 commands

Running simulation

Assuming you are in the lcgeo directory, and that you have initialised your session as above, do

python example/lcio_particle_gun.py
ddsim --compactFile=SiD/compact/SiD_o1_v01/SiD_o1_v03.xml --runType=batch --inputFile mcparticles.slcio -N=1 --outputFile=testSiD_o1_v03.slcio

dumpevent testSiD_o1_v03.slcio 1

anajob testSiD_o1_v03.slcio

Running reconstruction

Visualizing the output using CED

This needs a few extra parameters that were missing from the SiD_o1_v03.xml in v01-17-10, so put the modified SiD_o1_v03a.xml attached to this page in your local lcgeo/SiD/compact/SiD_o1_v01/ directory. You may need to make the following environment modification, depending on your local machine:

ced2go -d SiD/compact/SiD_o1_v01/SiD_o1_v03.xml <input_file.slcio>

Analysing the output

ddsim --compactFile=SiD/compact/SiD_o1_v01/SiD_o1_v03.xml --runType=batch --inputFile mcparticles.slcio -N=1000 --outputFile=SiD_o1_v03.slcio
Marlin SiDReconstruction_v03_160711.xml

Note that for the event display to wokr I had to ask my local sysadmin to install freeglut (e.g. for SLC6, freeglut-2.6.0-1.el6.x86_64) so that the library libglut.so was available.

source /cvmfs/ilc.desy.de/sw/x86_64_gcc48_sl6/v01-17-10/init_ilcsoft.sh
# point to a CED installation with glced:
export PATH=/cvmfs/ilc.desy.de/sw/x86_64_gcc44_sl6/CED/v01-09-02/bin/:$PATH
# this needs a few extra parameters that were missing from the SiD_o1_v03.xml in v01-17-10
#   so put the modified SiD_o1_v03a.xml attached to this page in your local
#   lcgeo/SiD/compact/SiD_o1_v01/ directory
ced2go -d <path_to_my_local_lcgeo_directory>/SiD/compact/SiD_o1_v01/SiD_o1_v03.xml <input_file.slcio>

Latest update: 5 Sept 16, using the latest ilcsoft release v01-17-10 for everything

Build example:

dumpevent testSiD_o1_v03.slcio 1

anajob testSiD_o1_v03.slcio

# [assuming you are in the lcgeo directory you created above, but these instructions are for a clean login]
source /cvmfs/ilc.desy.de/sw/x86_64_gcc48_sl6/v01-17-10/init_ilcsoft.sh

We are currently using a more recent CLIC release.

#In a fresh login shell:
source /afs/cern.ch/eng/clic/work/ilcsoft/HEAD-2016-02-19/init_ilcsoft.sh
#use the latest SiDReconstruction.xml attached to this twiki page,
# where you have edited the LCIOInputFiles and DD4hepXMLFile parameters for your local area:
Marlin SiDReconstruction_v03_160711.xml

-- Aidan Robson - 2016-07-11

# [first five steps are one-time only]
svn co https://svnsrv.desy.de/basic/ddsim/lcgeo/trunk lcgeo
rm lcgeo/detector/calorimeter/SHcal*
rm lcgeo/detector/calorimeter/SEcal*
rm lcgeo/detector/CaloTB/CaloPrototype*
mkdir lcgeo/build
# [setups you do every time: ]

Getting Started with SiD DD4HEP

At the moment, our code is committed to the DESY SVN repository, where the core DD4hep software and the CLIC and ILD models are stored as well. This is to make it easier to include SiD in the standard tests. The latest/work version is labelled SiD _o1_v01. The XML configuration is located in lcgeo/SiD/compact/SiD_o1_v01 and the C++ drivers are located in lcgeo/detector/

Browse or check out the code via https://svnsrv.desy.de/websvn/wsvn/General.ddsim/lcgeo

If needed for read access, a new basic account can be registered for anyone, by anyone else who has a grid certificate, at:
https://svnsrv.desy.de/admin/svn

Build example:

svn co https://svnsrv.desy.de/basic/ddsim/lcgeo/trunk lcgeo
source /cvmfs/sft.cern.ch/lcg/releases/gcc/4.8.4/x86_64-slc6/setup.sh
source /cvmfs/ilc.desy.de/sw/x86_64_gcc48_sl6/v01-17-09/init_ilcsoft.sh
cd lcgeo/
rm detector/detector/calorimeter/SHcal*
rm detector/detector/calorimeter/SEcal*
rm detector/detector/CaloTB/CaloPrototype*
mkdir build
cd build
cmake -DCMAKE_CXX_COMPILER=`which g++` -DCMAKE_C_COMPILER=`which gcc` -C /cvmfs/ilc.desy.de/sw/x86_64_gcc48_sl6/ILCSoft.cmake ..
make -j4
make install
source ../bin/thislcgeo.sh

Run example for ddsim:

source /cvmfs/sft.cern.ch/lcg/releases/gcc/4.8.4/x86_64-slc6/setup.sh 
source /cvmfs/ilc.desy.de/sw/x86_64_gcc48_sl6/v01-17-09/init_ilcsoft.sh
export LCGRELEASES=/cvmfs/sft.cern.ch/lcg/releases/LCG_84
export PYTHONDIR=/cvmfs/sft.cern.ch/lcg/releases/LCG_84/Python/2.7.10/x86_64-slc6-gcc48-opt
export PATH=/cvmfs/sft.cern.ch/lcg/releases/LCG_84/Python/2.7.10/x86_64-slc6-gcc48-opt/bin:$PATH
export LD_LIBRARY_PATH=$PYTHONDIR/lib:$LD_LIBRARY_PATH 
export PYTOOLSDIR=/cvmfs/sft.cern.ch/lcg/releases/LCG_84/pytools/1.9_python2.7/x86_64-slc6-gcc48-opt
export PYTHONPATH=/cvmfs/sft.cern.ch/lcg/releases/LCG_84/pytools/1.9_python2.7/x86_64-slc6-gcc48-opt/lib/python2.7/site-packages:$PYTHONPATH 
export PATH=$PYTOOLSDIR/bin:$PATH
source bin/thislcgeo.sh
python example/lcio_particle_gun.py
ddsim --compactFile=SiD/compact/SiD_o1_v01.xml --runType=batch --inputFile mcparticles.slcio -N=1 --outputFile=testSiD_o1_v01.slcio

Then to look at the output:

dumpevent testSiD_o1_v01.slcio 1

or

anajob testSiD_o1_v01.slcio

-- Aidan Robson - 2016-06-27

Comments

<--/commentPlugin-->