If you have made it this far, congratulations, you now know how to setup a basic EventLoop/Athena job and run it. It doesn’t do anything yet (that’s what we will teach next), but this is already an important milestone. Also, if in the future you need to set up a new EventLoop/Athena job or algorithm you can go back to this part of the tutorial, repeat it and then fill in the code specific to your use case.
From this point on we will only tell you to build and run your job, but no longer give you the actual commands. For your reference we have outlined them once more below, so you can go back to this page if you feel unsure. There are several reasons for doing things like this:
Compiling and running your job is a very basic task that should become second nature to you. We feel that from a training perspective it is better if you don’t just copy and paste the commands from a web page all the time. Once you start working on your own analysis there will no longer be a web page to copy from, so you may as well start now.
Most of the sections that follow apply equally to EventLoop and Athena, but the instructions for running the code are very different between the two. As such not including those instructions makes the documentation both more generic and simple.
If you follow some of the advanced sections they will slightly modify these instructions. Again it is easier to leave out the instructions than to add a lot of caveats to them.
On a more practical level, repeating these instructions everywhere is tedious cut-and-paste that we can do without.
Normally to recompile your job call:
cd ../build/
make
If you have added/removed any files or packages call instead:
cd ../build/
cmake ../source
make
Don’t forget to run source x86_64-*/setup.sh
It is always safe to call cmake, but it can be quite slow, so omitting
it when it is not needed is often a reasonable choice. Note that if
you followed the instructions for placing source
and build
directories on different disks you may have to modify the cmake
command accordingly.
Some users prefer instead of changing directories all the time to log
in a second time and then have one window just for compilation. Other
users relies on shell scripts or IDEs (integrated development
environment) to call the commands automatically in the right
directory, or they rely on the --build
option of cmake:
cmake --build ../build/
Sometimes we tell you to run cmake
explicitly (typically because we
added files or packages). In that case you really have to go to the
build
directory and call cmake
. Calling cmake --build
will
often not be sufficient.
To run your job call:
cd ../run
ATestRun_eljob.py --submission-dir=submitDir
To run your job call:
cd ../run
athena.py MyAnalysis/ATestRun_jobOptions.py
There are multiple paths through this tutorial, be sure that now that you have finished AnaAlgorithm introduction you continue to Basic Tools.