%------------------------------------------
% Copyright (C) 2001-2003, CompHEP Collaboration
%------------------------------------------
% $Id: manual.tex,v 1.1 2003/06/25 12:29:26 kryukov Exp $
%
% $Log: manual.tex,v $
% Revision 1.1  2003/06/25 12:29:26  kryukov
% New directory for manual
%
% Revision 1.5  2003/06/25 11:25:56  kryukov
% Update for 4.2 Installation section
%
% Revision 1.4  2003/06/24 19:48:42  kryukov
% Some minor changes
%
% Revision 1.3  2003/06/19 09:08:51  kryukov
% Initil import under CVS
%
%-------------------------------------------
%\documentclass[12pt,a4]{article}
%\usepackage[koi8-r]{inputenc}
%\usepackage[english,russian]{babel}
%\begin{document}

%,draftstamp
\documentstyle[12pt,axodraw,epsfig]{article}
\begin{document}

%------------------------- D E F I N I T I O N S ---- BEGIN -------

%\def\CompHEP{C\kern-.3em\lower.17ex\hbox{o}\kern-.135emm\kern-.145emp\kern-.165emH\kern-.125emE\kern-.1emP\ }

\def\CompHEP{{CompHEP}}
\def\VERSION{{4.2}}
\def\VEGAS{{\it Vegas}}
\newcommand{\C}{{{\it C}}}
\def\FORTRAN{{\it Fortran}}
\def\fortran{{\it Fortran}}
\def\Fortran{{\it Fortran}}
\def\REDUCE{{\it Reduce}}


\def\GRACE{{\it GRACE}}
\def\FeynArt{{\it FeynArts/FeynCalc}}
\def\HELAS{{\it HELAS}}
\def\MADGRAPH{{\it MADGRAPH}}
%\def\FORM{{\it Form}}
\def\CTEq{{\it CTEQ4m}}
\def\CTEQ{{\it CTEQ}}
\def\MRS{{\it MRS}}
\def\MATHEMATICA{{\it Mathematica}}
\def\Esc{{\it Esc}}
\def\PgUp{{\it PgUp}}
\def\PgDn{{\it PgDn}}
\def\Enter{{\it Enter}}

\def\Home{{\it Home}}
\def\End{{\it End}}
\def\Insert{{\it Insert}}
\def\Delete{{\it Delete}}
\def\Backspace{{\it Backspace}}
\def\Arrows{{\it Arrows}}

\def\itemm{\item[\bf --]}
%------------------------- D E F I N I T I O N S ------ END -------

\language=0

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\title{\CompHEP -  a package for evaluation of  Feynman diagrams   
and integration over  multi-particle phase space}
\author{A.Pukhov\thanks{contact persons: Alexander Pukhov:
pukhov@theory.npi.msu.su  and Viacheslav Ilyin: ilyin@theory.npi.msu.su} 
\and{E.Boos}\and{M.Dubinin}\and{V.Edneral}\and{V.Ilyin}
\and{D.Kovalenko}\and{A.Kryukov}\and{V.Savrin}\\
\it Skobeltsyn Institute of Nuclear Physics, Moscow State University
\and{S.Shichanin} \\
\it Institute for High Energy Physics, Protvino, Russia
\and{A.Semenov}\\
\it Joint Institute for Nuclear  Research, Dubna, Russia \\ }
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


 
\date{{\bf User's manual for version \VERSION}\\ ~~ \\ 
            Preprint INP-MSU 2003-XX/XXX}


\maketitle

\newpage

\tableofcontents

\newpage

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section {Preface}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\subsection{Introduction}			\label{introduction} 
\input{preface/introduction.tex}

\subsection{History and contributions}     
\input{preface/history.tex}

\subsection{Acknowledgments }     
\input{preface/acknowled.tex}
         
\newpage

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Installation procedure}             \label{install}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
\subsection{\CompHEP~ Web page}    	     \label{Web}
\input{install/web.tex}   

\subsection{License}		             \label{license}
\input{install/licence.tex}

\subsection{Requirements}                    \label{req-code}
\input{install/requirements.tex}

\subsection{How to get the codes}             \label{get-code}
\input{install/codes.tex}

\subsection{Compilation procedure}            \label{compilation}
\input{install/compile.tex}

\subsection{User installation and start of the \CompHEP~ session} \label{u-install}
\input{install/install.tex}

\subsection{MS Windows9x/NT}                  \label{w-install}
\input{install/insW95.tex}

\newpage

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section {User guide}  \label{guide}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\subsection{Elements of the user interface }   \label{interface}
\input{guide/service.tex}

\subsection{Menu system for symbolic calculation} \label{symb-menu}
\input{guide/symbolic.tex}

\subsection{Numerical calculation by \CompHEP}  \label{num-menu}
\input{guide/numerical.tex}

\subsection{\CompHEP~ event generator}          \label{events}
\input{guide/events.tex}

\subsection{\CompHEP~ files  and commands}      \label{file-commands}
\input{guide/commands.tex}


\subsection{User programs in \CompHEP}  	\label{user-prg}
\input{guide/userprog.tex} 

\newpage

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Implementation of models of particle interactions}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\subsection{Definition of a model in \CompHEP}  \label{models}

Description of  particle interaction model  in \CompHEP~ 
consists of four parts. They are  {\it parameters}, {\it constrains}, {\it
particles}, and {\it vertices}.  

\subsubsection{Independent parameters of the model}   \label{parameters}
\input{models/s_mdl_1.tex}

\subsubsection{Constraints between the parameters}    \label{constraints}
\input{models/s_mdl_2.tex}

\subsubsection{Description of particles}              \label{particles}
\input{models/s_mdl_3.tex}

\subsubsection{Ghost fields in \CompHEP} 
\input{models/s_mdl_ghosts.tex}
             \label{ghostFields}

\subsubsection{Interaction  vertices}                \label{lagrangian}
\input{models/s_mdl_4.tex}


\subsection{Examples}  				     \label{examples}
\input{models/examples.tex}

\subsection{LanHEP and SUSY models}                  \label{LanHEP}
\input{models/lanhep.tex}

\newpage

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{\CompHEP~ output files}                     \label{output}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\subsection{\LaTeX~ output}   		             \label{out-latex}
\input{output/latex.tex}

\subsection{Symbolic answer  in \REDUCE~ and \MATHEMATICA~ formats}
					             \label{s-output}
\input{output/red-math.tex}

%\subsection{\FORM~  output }
%\input{output/form.tex}

\subsection {\REDUCE~ program}		             \label{r-code}
\input{output/red_prg.tex}

\subsection{\Fortran~ output files}                  \label{out-fort}
\input{output/fortran.tex}

\subsection{\C~ output files}                        \label{out-c}
\input{output/c-output.tex}


\newpage

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\appendix
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\addcontentsline{toc}{section}{Appendix}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section*{Appendix}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Self-check of the \CompHEP~ package}         \label{symb-calc-check}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\input{appendix/self-check.tex}


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Ghost fields and the squared diagram technique for the
t'Hooft-Feynman gauge}                               \label{squaring}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\input{appendix/ghosts.tex} 

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Distribution functions and beam spectra}    \label{str-fun}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\input{appendix/n_strfun.tex}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Monte Carlo phase space integration}        \label{Monte-Carlo}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\subsection{Adaptive Monte Carlo integration package \VEGAS}
					             \label{vegas}
\input{appendix/integration/vegas.tex}

\subsection{Parameterization of multi-particle phase space} 
             					     \label{kinematics}
\input{appendix/integration/kinematics.tex}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Lagrangian of the Standard Model}           \label{theory}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\input{appendix/std_model.tex} 

\newpage

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\addcontentsline{toc}{section}{References}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\input{bibref.tex}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\addcontentsline{toc}{section}{Pictures and figures}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\newpage

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section*{Pictures and figures}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\input{pictures/pictures.tex}

\end{document}
