[u/mrichter/AliRoot.git] / doc / Distributed-Analysis / DistributedAnalysis.tex

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%                                                             %
%        DISTRIBUTED ANALYSIS NOTE                            %
%                                                             %
%       Author: Panos Christakoglou                           %
%               Markus Oldenburg                              %
%                                                             %
%       Last changes                                          %  
%  15.10.06: Summary and abstract by Markus                   %
%  22.12.06: Added the CAF reference                          %
%  22.12.06: Changes in Introduction.tex (Fed - Yves)         %
%  22.12.06: Changes in Flow.tex (Fed - Yves - Panos)         %
%  22.12.06: Changes in Local.tex (Fed - Yves - Panos)        %
%            Changing order (example comes first)             %    
%  23.12.06: Changes in Interactive.tex (Fed - Yves - Panos)  %
%            Changing order (example comes first)             %    
%  23.12.06: Changes in Batch.tex (Fed - Yves - Panos)        %
%                                                             %    
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\documentclass[12pt,a4paper,twoside]{article}
\usepackage{indentfirst}
\usepackage{epsfig}
\usepackage[dvips]{color}
\usepackage{listings}
\lstset{                      % general command to set parameter(s)
  basicstyle=\ttfamily,       % print whole listing small
  keywordstyle=\bfseries,     % bold black keywords
  identifierstyle=,           % identifiers in italic
  commentstyle=\itshape,      % white comments in italic
  stringstyle=\ttfamily,      % typewriter type for strings
  showstringspaces=false,     % no special string spaces
  columns=fullflexible,       % Flexible columns
  xleftmargin=2em,            % Extra margin, left
  xrightmargin=2em,           % Extra margin, right
  numbers=left,               % Line numbers on the left
  numberfirstline=true,       % First line numbered
  firstnumber=1,              % Always start at 1 
  stepnumber=5,               % Every fifth line 
  numberstyle=\footnotesize\itshape, % Style of line numbers
  frame=lines}                % Lines above and below listings

\topmargin=1cm

\newcommand{\tag}{{\ttfamily Event Tag System }}

\begin{document}

\title{Distributed Analysis - Overview of the framework and practical examples}
\author{Editors: P.~Christakoglou\footnote{{\bf email : Panos.Christakoglou@cern.ch}}, M.~Oldenburg\footnote{{\bf email : Markus.Oldenburg@cern.ch}}}
\date{\today}

\maketitle

\begin{abstract}
In order to perform physics analysis in ALICE, a physicist has to use the GRID infrastructure since the data will be distributed in many sites. The machinery though complex due to the nature of the GRID, is totally transparent to the user who is shielded by a friendly user interface. In order to provide some guidelines to successfully utilize the provided functionalities, it was felt that an up-to-date manual was needed. With this document we try to explain the analysis framework as of today by covering all the recent developments.

After a short introduction, the general flow of a GRID based analysis will be outlined. The different steps of how to get your analysis ready and running on the GRID using the newly developed analysis framework will be covered in the subsequent chapters.


\end{abstract}

\newpage
\tableofcontents
%\lstlistoflistings


%________________________________________________________
\include{Introduction}
%________________________________________________________
\include{Flow}
%________________________________________________________
\include{Analysis}
%________________________________________________________
\include{Local}
%________________________________________________________
\include{Interactive}
%________________________________________________________
\include{Batch}
%________________________________________________________
\include{Summary}
%________________________________________________________
\begin{appendix}
\include{ObjectCuts}
\include{StringCuts}
\end{appendix}
%________________________________________________________


%________________________________________________________
\begin{thebibliography}{99}
%________________________________________________________
\bibitem{Note:RefPPR} {"ALICE Physics Performance Report", CERN/LHCC 2003-049.}
\bibitem{Note:RefComputingTDR} {F.\ Carminati \textit{et al.}, ALICE collaboration, CERN/LHCC 2005.}
\bibitem{Note:RefCAF} {CAF web cite.}
\bibitem{Note:RefAnalysisFramework} {http://pcaliweb02.cern.ch/Offline/Analysis/AnalysisFramework/}
\bibitem{Note:RefFileCatalogMetadataNote} {M.\ Oldenburg, ALICE internal note --- to be submitted to EDMS;\\
http://cern.ch/Oldenburg/MetaData/MetaData.doc}
\bibitem{Note:RefEventTagNote} {P.\ Christakoglou and P.\ Hristov, "The Event Tag System", ALICE-INT-2006-023.}
%________________________________________________________
\bibitem{Note:RefFileCatalogMetadataWeb} {http://pcaliweb02.cern.ch/Offline/Analysis/RunEventTagSystem/\\RunTags.html\#Run/File\%20metadata}
\bibitem{Note:RefAlienTutorial} {http://pcaliweb02.cern.ch/Offline/Analysis/Tutorial/\\
http://indico.cern.ch/conferenceDisplay.py?confId=8546}
\bibitem{Note:RefALIEN} {
P.~Saiz \textit{et al.}, Nucl.\,Instrum.\,Meth.\,A\textbf{502} (2003) 437--440;\\ 
http://alien.cern.ch/.}
\bibitem{Note:RefPROOF} {http://pcaliweb02.cern.ch/Offline/Analysis/CAF/}
%________________________________________________________
\bibitem{Note:ROOTManual} {http://root.cern.ch/root/html/TTreeFormula.html}
%________________________________________________________
\bibitem{Note:RefEventTagWeb} {http://pcaliweb02.cern.ch/Offline/Analysis/RunEventTagSystem/\\EventTagsAnalysis.html\#Analysis\%20with\%20tags}
%________________________________________________________
\bibitem{Note:RefGSHELL} {http://project-arda-dev.web.cern.ch/project-arda-dev/alice/apiservice/AA-UserGuide-0.0m.pdf}
%________________________________________________________
\end{thebibliography}
%________________________________________________________


\end{document}
Commit	Line	Data
76bcc7e6	1	%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
	2	% %
	3	% DISTRIBUTED ANALYSIS NOTE %
	4	% %
	5	% Author: Panos Christakoglou %
	6	% Markus Oldenburg %
	7	% %
	8	% Last changes %
	9	% 15.10.06: Summary and abstract by Markus %
	10	% 22.12.06: Added the CAF reference %
	11	% 22.12.06: Changes in Introduction.tex (Fed - Yves) %
	12	% 22.12.06: Changes in Flow.tex (Fed - Yves - Panos) %
	13	% 22.12.06: Changes in Local.tex (Fed - Yves - Panos) %
	14	% Changing order (example comes first) %
	15	% 23.12.06: Changes in Interactive.tex (Fed - Yves - Panos) %
	16	% Changing order (example comes first) %
	17	% 23.12.06: Changes in Batch.tex (Fed - Yves - Panos) %
	18	% %
	19	%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
	20	\documentclass[12pt,a4paper,twoside]{article}
	21	\usepackage{indentfirst}
	22	\usepackage{epsfig}
	23	\usepackage[dvips]{color}
	24	\usepackage{listings}
	25	\lstset{ % general command to set parameter(s)
	26	basicstyle=\ttfamily, % print whole listing small
	27	keywordstyle=\bfseries, % bold black keywords
	28	identifierstyle=, % identifiers in italic
	29	commentstyle=\itshape, % white comments in italic
	30	stringstyle=\ttfamily, % typewriter type for strings
	31	showstringspaces=false, % no special string spaces
	32	columns=fullflexible, % Flexible columns
	33	xleftmargin=2em, % Extra margin, left
	34	xrightmargin=2em, % Extra margin, right
	35	numbers=left, % Line numbers on the left
	36	numberfirstline=true, % First line numbered
	37	firstnumber=1, % Always start at 1
	38	stepnumber=5, % Every fifth line
	39	numberstyle=\footnotesize\itshape, % Style of line numbers
	40	frame=lines} % Lines above and below listings
	41
	42	\topmargin=1cm
	43
	44	\newcommand{\tag}{{\ttfamily Event Tag System }}
	45
	46	\begin{document}
	47
	48	\title{Distributed Analysis - Overview of the framework and practical examples}
	49	\author{Editors: P.~Christakoglou\footnote{{\bf email : Panos.Christakoglou@cern.ch}}, M.~Oldenburg\footnote{{\bf email : Markus.Oldenburg@cern.ch}}}
	50	\date{\today}
	51
	52	\maketitle
	53
	54	\begin{abstract}
	55	In order to perform physics analysis in ALICE, a physicist has to use the GRID infrastructure since the data will be distributed in many sites. The machinery though complex due to the nature of the GRID, is totally transparent to the user who is shielded by a friendly user interface. In order to provide some guidelines to successfully utilize the provided functionalities, it was felt that an up-to-date manual was needed. With this document we try to explain the analysis framework as of today by covering all the recent developments.
	56
	57	After a short introduction, the general flow of a GRID based analysis will be outlined. The different steps of how to get your analysis ready and running on the GRID using the newly developed analysis framework will be covered in the subsequent chapters.
	58
	59
	60	\end{abstract}
	61
	62	\newpage
	63	\tableofcontents
	64	%\lstlistoflistings
65
66
67	%________________________________________________________
68	\include{Introduction}
69	%________________________________________________________
70	\include{Flow}
71	%________________________________________________________
72	\include{Analysis}
73	%________________________________________________________
74	\include{Local}
75	%________________________________________________________
76	\include{Interactive}
77	%________________________________________________________
78	\include{Batch}
79	%________________________________________________________
80	\include{Summary}
81	%________________________________________________________
82	\begin{appendix}
83	\include{ObjectCuts}
84	\include{StringCuts}
85	\end{appendix}
86	%________________________________________________________
87
88
89	%________________________________________________________
90	\begin{thebibliography}{99}
91	%________________________________________________________
92	\bibitem{Note:RefPPR} {"ALICE Physics Performance Report", CERN/LHCC 2003-049.}
93	\bibitem{Note:RefComputingTDR} {F.\ Carminati \textit{et al.}, ALICE collaboration, CERN/LHCC 2005.}
94	\bibitem{Note:RefCAF} {CAF web cite.}
95	\bibitem{Note:RefAnalysisFramework} {http://pcaliweb02.cern.ch/Offline/Analysis/AnalysisFramework/}
96	\bibitem{Note:RefFileCatalogMetadataNote} {M.\ Oldenburg, ALICE internal note --- to be submitted to EDMS;\\
97	http://cern.ch/Oldenburg/MetaData/MetaData.doc}
98	\bibitem{Note:RefEventTagNote} {P.\ Christakoglou and P.\ Hristov, "The Event Tag System", ALICE-INT-2006-023.}
99	%________________________________________________________
100	\bibitem{Note:RefFileCatalogMetadataWeb} {http://pcaliweb02.cern.ch/Offline/Analysis/RunEventTagSystem/\\RunTags.html\#Run/File\%20metadata}
101	\bibitem{Note:RefAlienTutorial} {http://pcaliweb02.cern.ch/Offline/Analysis/Tutorial/\\
102	http://indico.cern.ch/conferenceDisplay.py?confId=8546}
103	\bibitem{Note:RefALIEN} {
104	P.~Saiz \textit{et al.}, Nucl.\,Instrum.\,Meth.\,A\textbf{502} (2003) 437--440;\\
105	http://alien.cern.ch/.}
106	\bibitem{Note:RefPROOF} {http://pcaliweb02.cern.ch/Offline/Analysis/CAF/}
107	%________________________________________________________
108	\bibitem{Note:ROOTManual} {http://root.cern.ch/root/html/TTreeFormula.html}
109	%________________________________________________________
110	\bibitem{Note:RefEventTagWeb} {http://pcaliweb02.cern.ch/Offline/Analysis/RunEventTagSystem/\\EventTagsAnalysis.html\#Analysis\%20with\%20tags}
111	%________________________________________________________
112	\bibitem{Note:RefGSHELL} {http://project-arda-dev.web.cern.ch/project-arda-dev/alice/apiservice/AA-UserGuide-0.0m.pdf}
113	%________________________________________________________
114	\end{thebibliography}
115	%________________________________________________________
116
117
118	\end{document}