Index: /trunk/MagicSoft/Mars/Changelog
===================================================================
--- /trunk/MagicSoft/Mars/Changelog	(revision 2813)
+++ /trunk/MagicSoft/Mars/Changelog	(revision 2814)
@@ -15,8 +15,16 @@
 
 
+
  2004/01/15: Thomas Bretz
 
    * manalysis/AnalysisLinkDef.h:
      - removed MCurrents
+
+   * mhist/MHCamera.[h,cc]:
+     - added member function Projection
+
+   * mreport/MReport*.*:
+     - added more comments
+
 
 
Index: /trunk/MagicSoft/Mars/mreport/MReportCC.cc
===================================================================
--- /trunk/MagicSoft/Mars/mreport/MReportCC.cc	(revision 2813)
+++ /trunk/MagicSoft/Mars/mreport/MReportCC.cc	(revision 2814)
@@ -43,4 +43,9 @@
 using namespace std;
 
+// --------------------------------------------------------------------------
+//
+// Default construtor. Initialize identifier to "CC-REPORT" Report
+// is expected to have no 'subsystem' time.
+//
 MReportCC::MReportCC() : MReport("CC-REPORT", kFALSE)
 {
@@ -49,4 +54,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the body of the CC-REPORT string
+//
 Bool_t MReportCC::InterpreteBody(TString &str)
 {
Index: /trunk/MagicSoft/Mars/mreport/MReportCamera.cc
===================================================================
--- /trunk/MagicSoft/Mars/mreport/MReportCamera.cc	(revision 2813)
+++ /trunk/MagicSoft/Mars/mreport/MReportCamera.cc	(revision 2814)
@@ -51,4 +51,8 @@
 using namespace std;
 
+// --------------------------------------------------------------------------
+//
+// Default construtor. Initialize identifier to "CAMERA-REPORT"
+//
 MReportCamera::MReportCamera() : MReport("CAMERA-REPORT")
 {
@@ -57,4 +61,14 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// FindCreate the following objects:
+//  - MCameraCooling
+//  - MCameraLids
+//  - MCameraAUX
+//  - MCameraHV
+//  - MCameraLV
+//  - MCameraCalibration
+//
 Bool_t MReportCamera::SetupReading(MParList &plist)
 {
@@ -86,4 +100,9 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Check whether the given TString begins with the given tag. Remove
+// the tag from the string.
+//
 Bool_t MReportCamera::CheckTag(TString &str, const char *tag) const
 {
@@ -97,4 +116,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the DC* part of the report
+//
 Bool_t MReportCamera::InterpreteDC(TString &str)
 {
@@ -107,4 +130,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the HV* part of the report
+//
 Bool_t MReportCamera::InterpreteHV(TString &str)
 {
@@ -134,4 +161,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the COOL* part of the report
+//
 Bool_t MReportCamera::InterpreteCOOL(TString &str)
 {
@@ -171,4 +202,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the LID* part of the report
+//
 Bool_t MReportCamera::InterpreteLID(TString &str)
 {
@@ -210,4 +245,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the HVPS* part of the report
+//
 Bool_t MReportCamera::InterpreteHVPS(TString &str)
 {
@@ -233,4 +272,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the LV* part of the report
+//
 Bool_t MReportCamera::InterpreteLV(TString &str)
 {
@@ -279,4 +322,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the AUX* part of the report
+//
 Bool_t MReportCamera::InterpreteAUX(TString &str)
 {
@@ -301,4 +348,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the CAL* part of the report
+//
 Bool_t MReportCamera::InterpreteCAL(TString &str)
 {
@@ -326,4 +377,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the CAMERA-REPORT part
+//
 Bool_t MReportCamera::InterpreteCamera(TString &str)
 {
@@ -361,4 +416,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the body of the CAMERA-REPORT string
+//
 Bool_t MReportCamera::InterpreteBody(TString &str)
 {
Index: /trunk/MagicSoft/Mars/mreport/MReportCurrents.cc
===================================================================
--- /trunk/MagicSoft/Mars/mreport/MReportCurrents.cc	(revision 2813)
+++ /trunk/MagicSoft/Mars/mreport/MReportCurrents.cc	(revision 2814)
@@ -29,6 +29,4 @@
 // This is the class interpreting and storing the DC-REPORT information.
 //
-// --> Not yet finished...
-//
 //////////////////////////////////////////////////////////////////////////////
 #include "MReportCurrents.h"
@@ -43,4 +41,9 @@
 using namespace std;
 
+// --------------------------------------------------------------------------
+//
+// Default construtor. Initialize identifier to "DC-REPORT" Reports
+// are expected to have no 'subsystem' time.
+//
 MReportCurrents::MReportCurrents() : MReport("DC-REPORT", kFALSE)
 {
@@ -49,4 +52,9 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// FindCreate the following objects:
+//  - MCameraDC
+//
 Bool_t MReportCurrents::SetupReading(MParList &plist)
 {
@@ -58,4 +66,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the body of the DC-REPORT string
+//
 Bool_t MReportCurrents::InterpreteBody(TString &str)
 {
Index: /trunk/MagicSoft/Mars/mreport/MReportDrive.cc
===================================================================
--- /trunk/MagicSoft/Mars/mreport/MReportDrive.cc	(revision 2813)
+++ /trunk/MagicSoft/Mars/mreport/MReportDrive.cc	(revision 2814)
@@ -33,4 +33,34 @@
 // correct pointing position from.
 //
+//
+// Double_t fMjd;        // Modified Julian Date send by the drive system
+//  This is the MJD as it was calculated by the drive system when the report
+//  was send.
+//
+// Double_t fRa;         // [h]   Right ascension
+// Double_t fDec;        // [deg] Declination
+// Double_t fHa;         // [h]   Hour angle
+//  Currently this descries the nominal source position
+//
+// Double_t fNominalZd;  // [deg] Nominal zenith distance
+// Double_t fNominalAz;  // [deg] Nominal azimuth
+//  The nominal local position like it was calculated in the last
+//  control loop for time at which the last shaftencoder value has changed
+//
+// Double_t fCurrentZd;  // [deg] current zenith distance
+// Double_t fCurrentAz;  // [deg] current azimuth
+//  The current local position like it was calculated in the last
+//  control loop from interpolated shaftencoder values for time at which
+//  the last shaftencoder value has changed
+//
+// Double_t fErrorZd;    // [?] system error in the zenith angle axis
+// Double_t fErrorAz;    // [?] sistem error in the azimuth angle axis
+//  The system error on both axis derived from the two values above. Be
+//  carefull, eg near the zenith we a huge deviation in azimuth
+//  while having a small deviation in zenith angle might be meaingless.
+//  Please use GetAbsError to get the absolute distance between the
+//  twopositions.
+//
+//
 //////////////////////////////////////////////////////////////////////////////
 #include "MReportDrive.h"
@@ -44,4 +74,8 @@
 using namespace std;
 
+// --------------------------------------------------------------------------
+//
+// Default construtor. Initialize identifier to "DRIVE-REPORT"
+//
 MReportDrive::MReportDrive() : MReport("DRIVE-REPORT")
 {
@@ -50,4 +84,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the body of the DRIVE-REPORT string
+//
 Bool_t MReportDrive::InterpreteBody(TString &str)
 {
@@ -79,4 +117,9 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Returns the absolute deviation from the nominal position calculated
+// from the system error.
+//
 Double_t MReportDrive::GetAbsError() const
 {
Index: /trunk/MagicSoft/Mars/mreport/MReportDrive.h
===================================================================
--- /trunk/MagicSoft/Mars/mreport/MReportDrive.h	(revision 2813)
+++ /trunk/MagicSoft/Mars/mreport/MReportDrive.h	(revision 2814)
@@ -9,17 +9,17 @@
 {
 private:
-    Double_t fMjd;
+    Double_t fMjd;        // Modified Julian Date send by the drive system
 
-    Double_t fRa;         // [h]
-    Double_t fDec;        // [deg]
-    Double_t fHa;         // [h]
+    Double_t fRa;         // [h]   Right ascension
+    Double_t fDec;        // [deg] Declination
+    Double_t fHa;         // [h]   Hour angle
 
-    Double_t fNominalZd;  // [deg]
-    Double_t fNominalAz;  // [deg]
-    Double_t fCurrentZd;  // [deg]
-    Double_t fCurrentAz;  // [deg]
+    Double_t fNominalZd;  // [deg] Nominal zenith distance
+    Double_t fNominalAz;  // [deg] Nominal azimuth
+    Double_t fCurrentZd;  // [deg] current zenith distance
+    Double_t fCurrentAz;  // [deg] current azimuth
 
-    Double_t fErrorZd;    // [?]
-    Double_t fErrorAz;    // [?]
+    Double_t fErrorZd;    // [?] system error in the zenith angle axis
+    Double_t fErrorAz;    // [?] sistem error in the azimuth angle axis
 
     Bool_t InterpreteBody(TString &str);
Index: /trunk/MagicSoft/Mars/mreport/MReportFileRead.cc
===================================================================
--- /trunk/MagicSoft/Mars/mreport/MReportFileRead.cc	(revision 2813)
+++ /trunk/MagicSoft/Mars/mreport/MReportFileRead.cc	(revision 2814)
@@ -84,4 +84,9 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Wrapper. Returns the MReportHelp with the given identifier from the
+// hash table.
+//
 MReportHelp *MReportFileRead::GetReportHelp(const TString &str) const
 {
@@ -89,4 +94,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Wrapper. Returns the MReport stored in the given MReportHelp
+//
 MReport *MReportFileRead::GetReport(MReportHelp *help) const
 {
@@ -94,4 +103,9 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Wrapper. Returns the MReport stored in the MReportHelp given by its
+// identifier.
+//
 MReport *MReportFileRead::GetReport(const TString &str) const
 {
Index: /trunk/MagicSoft/Mars/mreport/MReportRun.cc
===================================================================
--- /trunk/MagicSoft/Mars/mreport/MReportRun.cc	(revision 2813)
+++ /trunk/MagicSoft/Mars/mreport/MReportRun.cc	(revision 2814)
@@ -42,4 +42,9 @@
 using namespace std;
 
+// --------------------------------------------------------------------------
+//
+// Default construtor. Initialize identifier to "RUN-REPORT" No subsystem
+// is expected.
+//
 MReportRun::MReportRun() : MReport("RUN-REPORT", kFALSE), fRunNumber(0)
 {
@@ -48,4 +53,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the body of the RUN-REPORT string
+//
 Bool_t MReportRun::InterpreteBody(TString &str)
 {
Index: /trunk/MagicSoft/Mars/mreport/MReportTrigger.cc
===================================================================
--- /trunk/MagicSoft/Mars/mreport/MReportTrigger.cc	(revision 2813)
+++ /trunk/MagicSoft/Mars/mreport/MReportTrigger.cc	(revision 2814)
@@ -38,4 +38,8 @@
 using namespace std;
 
+// --------------------------------------------------------------------------
+//
+// Default construtor. Initialize identifier to "TRIGGER-REPORT"
+//
 MReportTrigger::MReportTrigger() : MReport("TRIGGER-REPORT"), fPrescalerRates(19)
 {
@@ -44,4 +48,8 @@
 }
 
+// --------------------------------------------------------------------------
+//
+// Interprete the body of the TRIGGER-REPORT string
+//
 Bool_t MReportTrigger::InterpreteBody(TString &str)
 {
