26.6.2012 Kamil Sedlak

1) New (GPS and others) examples added.
2) The documentation updated accordingly.

doc/musrSim.tex

@@ -1542,6 +1542,30 @@ then activated in the macro file using the command \\[2ex]
 %
 The results of this GPD simulation are described in the \emph{musrSimAna} manual~\cite{musrSimAna}.
 
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Example 5 -- GPS instrument}
+For the details about the GPS simulation see the documents 
+``Simulation of the GPS μSR instrument 1--4'' (currently saved as
+/afs/psi.ch/project/lmu/Facility/musr\_simulations/documentation/GPS/*.pdf).
+\begin{itemize}
+  \item {\tt 50121.mac} -- GPS as installed in reality in 2011.
+  \item {\tt 50131.mac} -- GPS planned upgrade; bottle-shaped forward veto.
+  \item {\tt 50161.mac, 50171.mac, 50181.mac} -- GPS planned upgrade; pyramidal forward veto.
+\end{itemize}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Other Examples}
+During the years a lot of ``*.mac'' files were created and used.
+Most of these files are stored in the file ``run\_many\_files.tar.gz''.
+It is not guaranteed that all the ``*.mac'' files stored there are
+compatible with the newest version of musrSim/Geant4.  However,
+they can be still useful, at least as a source of inspiration.
+See the file ``README.TXT'' for a short description of what the purpose
+of the different files was.
+
+Sometimes the runs need additional input files (e.g.\ a field map
+,TURTLE file, ...).  These files are too large to be stored in the svn repository,
+and typically can be found in subdirectories of the high field project:
+/afs/psi.ch/project/HighFieldMuSR/.
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \clearpage

doc/musrSimAna.tex

@@ -772,7 +772,28 @@ The purpose of the example analysis of the GPD simulation was to illustrate
 the potential of \musrSim\ and \musrSimAna\ programs to investigate features
 like time-independent background, sample muon fraction, prompt peak, \ldots
 This information can be used in design and optimisation of \musr\ instruments.
-
+%========================================================================================================
+\section{GPS instrument}
+%
+It is foreseen that GPS instrument could be arranged in two geometries
+after the upgrade (depending from which side the calorimeter would be
+inserted). 
+\begin{itemize}
+  \item {\tt 50130hb.v1190} -- Calorimeter inserted from one side.
+  \item {\tt 50130hl.v1190} -- Calorimeter inserted from the other side.
+  \item {\tt 50130hb1.v1190 -- 50130hb6.v1190} -- All positron counters 
+    analysed individually.
+\end{itemize}
+See the document about the GPS simulations saved in the directory: \\
+/afs/psi.ch/project/lmu/Facility/musr\_simulations/documentation/GPS/ \\
+for more details.
+%========================================================================================================
+\section{Other Examples}
+Many different ``*.v1190'' files are stored in the file:
+``run\_musrSimAna\_many\_files.tar.gz''.  They could serve as additional examples.
+Note that the syntax of the ``fit'' command was changed
+at some point, and therefore the ``fit'' command might cause problems
+(the {\tt ``option''} has to be added in the old ``*.v1190'' files).
 %========================================================================================================
 \begin{thebibliography}{0}