#acl TopGroup:read,write,admin,revert,rename EditorsGroup:read,write All:read
#language en
= TopCommonSelection =
=== Introduction ===

In order to get everything running you have to check out your desired packages from a number of repositories as they are develeloped by different persons.

Have a look at the [[Projects/TopPhysicsInternal/AnalysisFramework/AvailablePackages|AvailablePackages]] to see which ones are available. On that page you should also find instructions on how to check-out the trunk of each package.

=== Quickstart with recommended packages ===

Pasting the following lines to your terminal should get you the recommended packages.
{{{
kinit cwasicki@CERN.CH #please put in your name here
mkdir -p CommonAnalysis/Release
cd CommonAnalysis/Release
}}}

Then check out a release: 
 * the trunk: {{{
svn co svn+ssh://svn.cern.ch/reps/desyatfw/CommonAnalysis/Release/TopCommonSelection/trunk TopCommonSelection
}}}
 * a tag (this tag is obsolete!): {{{
svn co svn+ssh://svn.cern.ch/reps/desyatfw/CommonAnalysis/Release/TopCommonSelection/tags/TopCommonSelection-00-00-03 TopCommonSelection-00-00-03
}}}
 * a branch (e.g. ongoing 2011 analysis): {{{
svn co svn+ssh://svn.cern.ch/reps/desyatfw/CommonAnalysis/Release/TopCommonSelection/branches/TopCommonSelection-2011/ TopCommonSelection-2011 
}}}


and change directory
{{{
cd TopCommonSelection
}}}

After checking-out you have to setup ROOT (recommended 5.26+) and SFrame:

 * at DESY {{{
ini atlasfw
}}}

 * on NAF (maybe problem with python version later) {{{
ini root528
}}}
 
 * at CERN: in {{{External/GoodRunsList/Makefile}}} comment out {{{
#INCLUDES += -I/usr/include/libxml2 -D__WITHLIBXML__}}} and {{{
. /afs/cern.ch/sw/lcg/external/gcc/4.3.2/x86_64-slc5/setup.sh
. /afs/cern.ch/sw/lcg/app/releases/ROOT/5.28.00c/x86_64-slc5-gcc43-opt/root/bin/thisroot.sh
export PATH=/afs/cern.ch/sw/lcg/external/Python/2.6.5/x86_64-slc5-gcc43-opt/bin:$PATH
export LD_LIBRARY_PATH=/afs/cern.ch/sw/lcg/external/Python/2.6.5/x86_64-slc5-gcc43-opt/lib:$LD_LIBRARY_PATH
}}} 


Set up the SFrame environment (except for TopCommonSelection-00-00-01):{{{
source setup.sh }}} This has to be done in every new shell one uses the framework.


Make sure you compile everything afterwards:

{{{
source make-all.sh
}}}

To run the example (gives you a few histograms with cutflow and selection plots):
{{{
cd Top/CommonSelection/config
sframe_main TopCommonSelection_config.xml #or
}}}
Usually this reproduces the one file cutflows given [[https://docs.google.com/spreadsheet/ccc?key=0Aq1U2FKBToZ4dEg1T25FTld6aTB2dk5sY0JFX1NQcEE&hl=en_US#gid=15|here]] (otherwise make sure that the file you run on is mc. The extended cut flow on this page can be reproduced by sending one of the jobOptions from the {{{share}}} folder to the batch system (Please make sure to adjust all path in the jobOption), e.g.:
{{{
cd ..
mkdir run
cd run
mkdir tmp/out
python -u ../scripts/submitSFrame.py -j ../share/jobOptions_mc_cf.py  
}}}

= TopResoAnalysis =
To read the TTree in the output root file from TopCommonSelection one can use (besides simple root macros) the TopResoAnalysis package:
{{{
svn co svn+ssh://svn.cern.ch/reps/desyatfw/CommonAnalysis/Release/TopResoAnalysis/trunk TopResoAnalysis
cd TopResoAnalysis
source setup.sh
source make-all.sh
cd Top/ResoAnalysis/config
#edit TopResoAnalysis.xml to read your input file
sframe_main TopResoAnalysis.xml
}}}
There is also a python macro in the {{{plots}}} directory to create histogram comparison plots.


= Former Analysis =
== Cut flow ==
 * [[https://espace.cern.ch/topxsec/Lists/Updated%20Ljets%20AtlasPhysics166551/AllItems.aspx?View={E8F4840A-D907-4798-A4C6-57C57E66AB4D}&FilterField1=Group_x002f_University&FilterValue1=DESY|here]] 
 * [[https://twiki.cern.ch/twiki/bin/view/AtlasProtected/Summer2011TopResonances|here]]

== Tags ==
Analysis 1035.25 pb-1, check out TopCommonSelection-00-00-03
{{{
svn co svn+ssh://svn.cern.ch/reps/desyatfw/CommonAnalysis/Release/TopCommonSelection/tags/TopCommonSelection-00-00-03 TopCommonSelection
}}}