The Athena Startup Kit

A gentle dive into Atlas offline software

Wim Lavrijsen

Lawrence Berkeley National Laboratory
National Energy Research Scientific Computing Center


1, Cyclotron Road
94720:8147
Berkeley
California
USA

Revision History
Revision 2.0December 2005 - March 2006wlav
Consolidated, formalized, reordered, removed a lot of "history."
Revision 1.9p6June 2005wlav
General maintenance and updates.
Revision 1.9p5March 2005wlav
Finalize for Rome release 10.0.1.
Revision 0.2 -- 1.9p4September 2002 -- December 2004wlav
Details removed ... refer to repository if needed.

Abstract

The Athena Startup Kit (ASK) integrates the ATHENA framework, and the software based on it, with the official releases and the various supporting tools in order to provide an easier, more consistent, and more robust user interface to Atlas offline software. ASK operates completely in user-space: it performs only those tasks that are otherwise left to the end-user by the "standard" Atlas tools.

There are two main aspects to ASK. First, there is the "Startup" part, which gives the end-user a safe playground to begin using Atlas software and to learn the supporting tools within a working setup. To further facilitate this, a graphical user interface is provided for the most high-level tasks. Second, there is the "Kit" part that allows for the use of ASK's layered interface, utilities, and modules in batch scripts and test environments.

This document consists of three parts: an Atlas full-chain tutorial; the ASK manual; and background information, including an extensive glossary. The best way to use this text is by skimming quickly through the manual and then start with a tutorial of your choice, referring back to the manual if needed, while using the background information and glossary to delve deeper in the subjects that you'll use on a daily basis.


To time lost, and to more productive times ahead.

Table of Contents

I. Tutorials
1. Creating a workspace
2. Basic Athena tutorial
2.1. A package with some code
2.2. Transient data store
2.3. Tools and services
3. Generators tutorial
3.1. Testing your setup
3.2. Customize your physics events
3.3. Storing output
3.4. Event filtering
3.5. Access to Monte Carlo truth
3.6. Small production
4. Simulation tutorial
4.1. Working example
4.2. Connecting the chain
4.3. Small production
5. Digitization tutorial
5.1. Working example
5.2. Connecting the chain
5.3. Small production
6. Reconstruction tutorial
6.1. Installation
6.2. Connecting the chain
7. Interactive Athena tutorial
7.1. Getting started
7.2. Histogramming
7.3. A python algorithm
II. Manual
A. ASK basics
A.1. Installation and setup
A.2. Running
B. ASK reference guide
B.1. Graphical user interface
B.2. Command line interface
C. Use of CERN LSF
C.1. lxbatch
C.2. Simple jobs
III. Reference
Resources
Explanation of terms
Bibliography

List of Figures

3.1. Overview of generators in Athena
3.2. Execution flow of generator event filters in Athena