Atrecon on srt/cvs

Atrecon is being ported to the official Atlas Software release scheme using CVS to manage the code repository and SRT as software release tool.
Depending on your needs you would need to modify existing code or just add your own analysis code.
You will find here some guide lines how to proceed :

setting up the Atlas cvs/srt environment
how to create the atrecon archive library
how to create a main_atrecon executable
how to find an existing executable from a release
WARNING some modifications occured on August 5th 1999

ATLAS applications are part of the Applications domain.

Creating atrecon archive library

You can build on your private working area (work) the atrecon libraries libatrecon.a & libatreconAgeStructures.a. This is normally needed only for developers.

base your working area on an existing release, identified by the release number (e.g.. 0.0.22 ), or by current for the 'current one' :

srt new work current :

checkout atrecon , configure and build the libraries.

you have the possibility either to check-out the 'head version' (no guarantee that it works) or the version corresponding to an 'official release'.
For the 'head-version' :

cd work
cvs checkout -d atrecon offline/atrecon (1) (2)

For the official current released version you need first to know which one it is :

cd work
cvs status $SRT_DIST/current/PACKAGE

you get the current version : Sticky Tag : offline-00-00-22 (for example) to be used in the next command

cvs checkout -d atrecon -r offline-00-00-22 offline/atrecon (1) (2)

build the libraries

mkdir -p .srt/$SRT_TARGET
cd .srt/$SRT_TARGET
../../../configure --with-option-sets=optimise
gmake --no-p

Similar procedure can be used for other packages.

The libraries are built first on a directory below the checked out package:

work/atrecon/.srt/$SRT_TARGET/lib/libatrecon.a
work/atrecon/.srt/$SRT_TARGET/lib/libatreconAgeStructures.a

work/installed/$SRT_TARGET/lib/libatrecon.a
work/installed/$SRT_TARGET/lib/libatreconAgeStructures.a

Notes :

If you prefer to get another version of the code you look for the tags of atrecon using the CVS web browser. You can also get access to the full ATLAS CVS Tree .
The tag offline-00-00-22 refers to the released version, while the atrecon tag refers to the atrecon version

Creating atrecon applications (1)
All Applications are now part of the Applications domain.

WARNING (some modifications occured as of August 5th)

The 'atrecon executables' are built from the Applications/AtreconMain package :

base your working area on an existing release identified by the release number (e.g. 0.0.22 ), or by current for the 'current one' :

srt new work current (2)

checkout AtreconMain , configure and build the executable

cd work
cvs checkout -d AtreconMain offline/Applications/AtreconMain (3)

build the executable

mkdir -p .srt/$SRT_TARGET
cd .srt/$SRT_TARGET
../../../configure --with-option-sets=optimise
gmake --no-p

Several executables will be built on a directory below the checked out package :

work/AtreconMain/.srt/$SRT_TARGET/main_atrecon
work/AtreconMain/.srt/$SRT_TARGET/atrecon_

with an extension using the following convention

It is also possible to build only one executable. In this case gmake should be not be run as proposed above but

from the directory work/AtreconMain/.srt/$SRT_TARGET
use gmake atrecon_CIXM (for example)

Notes :

Valid on hp only. Work in progress for other platforms.
Only once. If you have check-out the atrecon package you don't need to redo that step.
Previously 'main_atrecon' was built from a a sub-package of atrecon called 'main_atrecon. This is not anymore the case.
On the ... AtreconMain/.srt/$SRT_TARGET directory you will also find the GNUmakefile built at the configuration time. This file contains the pre-processor flags used to compile the routine ARECON.F allowing to activate the calls to the wanted reconstruction packages

ATLAS_CALO Calorimetry
ATLAS_JETF Jet Finder algorithms
ATLAS_IPAT iPatRec
ATLAS_PIXL PixlRec
ATLAS_XKAL xKalMan
ATLAS_MUON Muonbox
ATLAS_CBNT Combined Ntuple

It is possible to edit this GNUmakefile and re-build the executable directly from that directory (deleting first all arecon.* files).

WARNING (as of August 5th)

In the preparation of release 0.0.31 the name of the library 'libatreconAgeStructures.a' used by the application has been changed to 'libatreconAS.a' (for technical reasons). As a consequence if you check out the HEAD version and wants to use the libraries from a previous release (<= 0.0.30) in GNUmakefile.in you should change '-latreconAS' by '-latreconAgeStructures'.

Using existing applications from a release (1)
For each release (eg . 0.0.22 or current) standard executables are built on the 'installed' subdirectory tree :

$SRT_DIST/current/installed/$SRT_TARGET/bin

Executable modules are :

built from the Applications/AtreconMain package
built by linking to the official Atlas libraries
identified by the packages which are included with the following convention (2) :

atrecon_

main_atrecon includes all existing packages (3) .

Notes :

Valid on hp only. Work in progress for other platforms.
The pre-processor flags needed to build the executables are defined in the file 'GNUmakefile.in' of the package AtreconMain. They are used to activate the calls to the wanted reconstruction packages in the routine ARECON.F .

ATLAS_CALO Calorimetry
ATLAS_JETF Jet Finder algorithms
ATLAS_IPAT iPatRec
ATLAS_PIXL PixlRec
ATLAS_XKAL xKalMan
ATLAS_MUON Muonbox
ATLAS_CBNT Combined Ntuple

This executable is quite big and does not run on all platforms and/or machines.

Last update : 30th March 1999

Gilbert Poulard [GP]