[[TOC]]
This page is far from being complete. While I give an introduction to my students, I try to write down a few notes, hoping that it can serve as a small introduction and help future students. 

== Analysis Steps ==

=== callisto === 
 what is done?:: 
   calculation of calibration constants, extraction of signal, calibration of data
 macro::
   Mars/fact/analysis/callisto.C
 input:: 
  sequence file, rawdata (files found with information in sequence file
 output:: 
  YYYYMMDD_SSS-calibration.root (plots), YYYYMMDD_FFF_C.root (one per run)

=== star ===
 what is done?::
  image cleaning, calculation of image parameter
 macro::
  Mars/fact/analysis/star.C
 input::
  sequence file, callisto output
 output:: 
  YYYYMMDD_SSS-images.root (plots), YYYYMMDD_FFF_I.root (one per run)

=== star ===
 what is done?::
  merge auxiliary information to data 
 macro::
  Mars/fact/analysis/merpp.C
 input::
  sequence file, YYYYMMDD_FFF_I.root
 output:: 
  YYYYMMDD_FFF_I.root (one per run)

=== ganymed === 
 what is done?::
   background suppression, calculation of excess(, energy reconstruction)
 macro::
   Mars/fact/analysis/ganymed.C
 input::
  dataset file, star output (_I.root files)
 output::
  name-analysis.root (result, eventlist after cuts, plots), name-summary.root (event list before cuts)

=== lightcurve === 
 what is done?::
   calculation of excess rate 
 macro::
   Mars/fact/analysis/lightcurve.C
 input::
   several datasets or information from DB


=== additional information ===

 sequence::
  a sequence of runs, consisting of: pedestal run, light pulser run, one or more data runs
 dataset::
  a collection of data runs
 YYYYMMDD:: night (date of sunset is used)
 FFF:: file number (starts with 0 every night
 SSS:: sequence number (number of first run in sequence)

=== dataset file === 
a dataset file contains one or more lines as e.g. 

/path_to_imageparameter_file YYYYMMDD_FFF_I.root

be aware that there is a space between the path and the file name

in the filename wildcards can be used

=== technical information === 
 how to start a macro::
   go to Mars directory[[BR]]
   start root[[BR]]
   .x path/macro.C ("with maybe some variable", 2) 
 set root environment::
   source /pathtoroot/bin/thisroot.sh
 rawdata in wü:: /fact/raw/YYYY/MM/DD/YYYYMMDD_FFF.fits.fz
 callisto in Wü:: /scratch/local/dorner/data.2013.05.11/callisto/YYYY/MM/DD/ (temporary path, will be changed)
 star in Wü:: /scratch/local/dorner/data.2013.05.11/star/YYYY/MM/DD/ (temporary path, will be changed)
 sequences in Wü:: /scratch/local/dorner/sequences/YYYY/MM/DD/ (temporary path, will be changed)

=== exercises === 

1. run callisto for a sequence (check the macro to find out how to call the macro)
2. run star for the same sequence
3. run merpp for the same sequence
4. write a dataset file
5. run ganymed for this dataset file