\documentclass{chowto}

\title{Instructions for online replay}
\howtotype{user} % ``expert'', ``user'', ``reference''
%\experiment{Name of experiment} % Optional
\author{G. Huber}
\category{daq} % Subject area of this document
%\maintainer{Name of person maintaining document} % Optional
\date{April, 7 2003} % Can use \today as the argument

\begin{document}

\begin{abstract}
Simple instructions for online replay.
\end{abstract}

\section{Online Replay Instructions}
\begin{enumerate}

\item{
cdaq account, password XXXXXXXXX.\\
Working directory is /home/cdaq/DAQROOT/replay where DAQROOT is the
directory containing the replay and data acquisition code for the current
experiment.  For spring 2003, DAQROOT is ``daq03''.}

\item{To replay data, type:\\
{\tt replay grun=44780 gstop=10000}\\
inserting your favorite run number and number of events to analyze.  When
completed, two files are created in the paw directory.  For this example:\\
paw/44780.hbook -- containing the histograms.\\
paw/paw44780.kumac -- containing the histogram name aliases.
}

\item{ONLINE HISTOGRAMS:\\
Start paw from the working directory, and then look at the two following
kumacs:

\begin{enumerate}

\item{For every run, type:\\
{\tt exec kumacs/pscan 44780}\\
This will open the hbook file, read in the aliases, and then execute
kumacs/0macroscan.kumac.

\clearpage
Alternately, you could do these steps manually:
\begin{itemize}
\item{open hbook file:          paw/44780.hbook}
\item{execute aliases macro:    paw/paw44780.kumac}
\item{execute histogram viewing macro: kumacs/0macroscan.kumac}
\end{itemize}
}

\item{A few times per shift, type:\\
{\tt exec kumacs/shiftscan 44780}\\
This will open the hbook file, read in the aliases, and then execute
kumacs/1extrascan.kumac.  Or if you prefer, just execute 1extrascan.kumac 
manually.
}

\item{Finally, there is a set of histograms which Henk requested for optics
commissioning, which are viewed via the macro\\
kumacs/henk\_request.kumac.
}

\end{enumerate}

Reference printouts for these histograms are in the thin black binder.
}

\item{NTUPLES:\\
If you want ntuples created, uncomment the appropriate lines in\\
REPLAY.PARM.  There are separate ntuples for HMS and SOS singles, 
HMS and SOS sieve slit runs, as well as coincidences.
}

\item{To add histograms:
\begin{itemize}
\item{histograms are defined in files in the HIST subdirectory.}
\item{the list of which files to read in for analysis is defined in\\
standard.hist.}
\end{itemize}
}

\item{To set the replay kinematics:
\begin{itemize}
\item{add the beam and spectrometer settings for your run to\\
DBASE/standard.kinematics.}
\item{target numbers are defined in PARAM/gtarget.param.}
\end{itemize}
}

\end{enumerate}

\end{document}

% Revision history:
% $Log: online_histos.tex,v $
% Revision 1.2  2003/04/07 20:50:43  saw
% Initial Checkin
%
% Revision 1.1  2003/04/07 18:10:10  saw
% Initial Checkin
%
%
