Index: trunk/MagicSoft/Simulation/Detector/Camera/creadparam.cxx
===================================================================
--- trunk/MagicSoft/Simulation/Detector/Camera/creadparam.cxx	(revision 366)
+++ trunk/MagicSoft/Simulation/Detector/Camera/creadparam.cxx	(revision 367)
@@ -19,7 +19,7 @@
 //=
 //= $RCSfile: creadparam.cxx,v $
-//= $Revision: 1.1.1.1 $
-//= $Author: harald $ 
-//= $Date: 1999-11-05 11:59:34 $
+//= $Revision: 1.2 $
+//= $Author: petry $ 
+//= $Date: 2000-02-18 17:45:43 $
 //=
 //=//////////////////////////////////////////////////////////////////////
@@ -69,5 +69,5 @@
 
 static char Input_filename[PATH_MAX_LENGTH];  //@< input filename
-static char Output_filename[PATH_MAX_LENGTH]; //@< output filename
+static char Starfield_filename[PATH_MAX_LENGTH]; //@< starfield input filename
 static char Data_filename[PATH_MAX_LENGTH];   //@< data filename
 static char DIAG_filename[PATH_MAX_LENGTH];  //@< data filename
@@ -180,8 +180,8 @@
       break;
 
-    case output_file:         //@< name of the output file
+    case starfield_file:         //@< name of the output file
           
       // get the name of the output_file from the line
-      sscanf(line, "%s %s", token, Output_filename);
+      sscanf(line, "%s %s", token, Starfield_filename);
 
       break;
@@ -398,11 +398,11 @@
 
 //!-----------------------------------------------------------
-// @name get_output_filename
-//                                                
-// @desc get name of the output file
-//
-// @return   Name of the Output file
-//
-// @date Mon Sep 14 13:27:56 MET DST 1998
+// @name get_starfield_filename
+//                                                
+// @desc get name of the starfield input file
+//
+// @return   Name of the starfield file
+//
+// @date Tue Feb 15 16:02:18 CET 2000
 //------------------------------------------------------------
 // @function 
@@ -410,7 +410,7 @@
 //!@{
 char *
-get_output_filename(void)
-{
-  return (Output_filename);
+get_starfield_filename(void)
+{
+  return (Starfield_filename);
 }
 //!@}
@@ -837,4 +837,227 @@
 //
 // $Log: not supported by cvs2svn $
+// Revision 1.1.1.1  1999/11/05 11:59:34  harald
+// This the starting point for CVS controlled further developments of the
+// camera program. The program was originally written by Jose Carlos. 
+// But here you can find a "rootified" version to the program. This means 
+// that there is no hbook stuff in it now. Also the output of the
+// program changed to the MagicRawDataFormat. 
+//
+// The "rootification" was done by Dirk Petry and Harald Kornmayer. 
+//
+// In the following you can see the README file of that version:
+//
+// ==================================================
+//
+// Fri Oct 22  1999   D.P.
+//
+// The MAGIC Monte Carlo System
+//
+// Camera Simulation Programme
+// ---------------------------
+//
+// 1) Description
+//
+// This version is the result of the fusion of H.K.'s
+// root_camera which is described below (section 2)
+// and another version by D.P. which had a few additional
+// useful features.
+//
+// The version compiles under Linux with ROOT 2.22 installed
+// (variable ROOTSYS has to be set).
+//
+// Compile as before simply using "make" in the root_camera
+// directory.
+//
+// All features of H.K.'s root_camera were retained.
+//
+// Additional features of this version are:
+//
+//   a) HBOOK is no longer used and all references are removed.
+//
+//   b) Instead of HBOOK, the user is given now the possibility of 
+//      having Diagnostic data in ROOT format as a complement
+//      to the ROOT Raw data.
+//
+//      This data is written to the file which is determined by
+//      the new input parameter "diag_file" in the camera parameter
+//      file.
+//
+//      All source code file belonging to this part have filenames
+//      starting with "MDiag".
+//
+//      The user can read the output file using the following commands
+//      in an interactive ROOT session:
+//
+//        	root [0] .L MDiag.so
+// 	root [1] new TFile("diag.root");
+// 	root [2] new TTreeViewer("T");
+// 	
+//      This brings up a viewer from which all variables of the
+//      TTree can be accessed and histogrammed. This example
+//      assumes that you have named the file "diag.root", that
+//      you are using ROOT version 2.22 or later and that you have
+//      the shared object library "MDiag.so" which is produced
+//      by the Makefile along with the executable "camera".
+//        
+//  !   The contents of the so-called diag file is not yet fixed.
+//  !   At the moment it is what J.C.G. used to put into the HBOOK
+//  !   ntuple. In future versions the moments calculation can be
+//  !   removed and the parameter list be modified correspondingly.
+//
+//   c) Now concatenated reflector files can be read. This is useful
+//      if you have run the reflector with different parameters but
+//      you want to continue the analysis with all reflector data
+//      going into ONE ROOT outputfile.
+//
+//      The previous camera version contained a bug which made reading 
+//      of two or more concatenated reflector files impossible.
+//
+//   d) The reflector output format was changed. It is now version
+//      0.4 .
+//      The change solely consists in a shortening of the flag
+//      definition in the file 
+//
+//            include-MC/MCCphoton.hxx  
+//
+//  !   IF YOU WANT TO READ REFLECTOR FORMAT 0.3, you can easily
+//  !   do so by recompiling camera with the previous version of
+//  !   include-MC/MCCphoton.hxx.
+//
+//      The change was necessary for saving space and better
+//      debugging. From now on, this format can be frozen.
+//
+//  !   For producing reflector output in the new format, you
+//  !   of course have to recompile your reflector with the
+//  !   new include-MC/MCCphoton.hxx .
+//
+//   e) A first version of the pixelization with the larger
+//      outer pixels is implemented. THIS IS NOT YET FULLY
+//      TESTED, but first rough tests show that it works
+//      at least to a good approximation.
+//
+//      The present version implements the camera outline
+//      with 18 "gap-pixels" and 595 pixels in total as
+//      shown in 
+//
+//         http://sarastro.ifae.es/internal/home/hardware/camera/numbering.ps
+//
+//      This change involved 
+//
+// 	(i) The file pixels.dat is no longer needed. Instead
+//           the coordinates are generated by the program itself
+//           (takes maybe 1 second). In the file 
+//
+// 		pixel-coords.txt
+//
+// 	  in the same directory as this README, you find a list
+//           of the coordinates generated by this new routine. It
+//           has the format
+//
+//               number   i   j   x  y  size-factor
+//
+//           where i and j are J.C.G.'s so called biaxis hexagonal
+//           coordinates (for internal use) and x and y are the
+//           coordinates of the pixel centers in the standard camera
+//           coordinate system in units of centimeters. The value
+//           of "size-factor" determines the linear size of the pixel
+//           relative to the central pixels. 
+//
+//         (ii) The magic.def file has two additional parameters
+//           which give the number of central pixels and the
+//           number of gap pixels
+//
+//         (iii) In camera.h and camera.cxx several changes were 
+//           necessary, among them the introduction of several
+//           new functions 
+//
+//      The newly suggested outline with asymmetric Winston cones
+//      will be implemented in a later version.
+//
+//   f) phe files can no longer be read since this contradicts
+//      our philosophy that the analysis should be done with other
+//      programs like e.g. EVITA and not with "camera" itself.
+//      This possibility was removed. 
+//
+//   g) ROOT is no longer invoked with an interactive interface.
+//      In this way, camera can better be run as a batch program and
+//      it uses less memory.
+//
+//   h) small changes concerning the variable "t_chan" were necessary in
+//      order to avoid segmentation faults: The variable is used as an
+//      index and it went sometimes outside the limits when camera
+//      was reading proton data. This is because the reflector files
+//      don't contain the photons in a chronological order and also
+//      the timespread can be considerably longer that the foreseen
+//      digitisation timespan. Please see the source code of camera.cxx
+//      round about line 1090.
+//
+//   j) several unused variables were removed, a few warning messages
+//      occur when you compile camera.cxx but these can be ignored at
+//      the moment.
+//
+// In general the program is of course not finished. It still needs
+// debugging, proper trigger simulation, simulation of the asymmetric
+// version of the outer pixels, proper NSB simulation, adaption of
+// the diag "ntuple" contents to our need and others small improvements.
+//
+// In the directory rfl-files there is now a file in reflector format 0.4
+// containing a single event produced by the starfiled adder. It has
+// a duration of 30 ns and represents the region around the Crab Nebula.
+// Using the enclosed input parameter file, camera should process this
+// file without problems.
+//
+// 2) The README for the previous version of root_camera
+//
+// README for a preliminary version of the 
+// root_camera program. 
+//
+// root_camera is based on the program "camera"of Jose Carlos
+// Gonzalez. It was changed in the way that only the pixelisation 
+// and the distibution of the phe to the FADCs works in a 
+// first version. 
+//
+// Using the #undef command most possibilities of the orignal 
+// program are switched of. 
+//
+// The new parts are signed by 
+//
+// - ROOT or __ROOT__ 
+//   nearly all  important codelines for ROOT output are enclosed 
+//   in structures like 
+//   #ifdef __ROOT__ 
+//   
+//     code 
+//
+//   #endif __ROOT__ 
+//
+//   In same case the new lines are signed by a comment with the word 
+//   ROOT in it. 
+//
+//   For timing of the pulse some variable names are changed. 
+//   (t0, t1, t  -->  t_ini, t_fin, t_1st, t_chan,...) 
+//   Look also for this changes. 
+//
+//   For the new root-file is also a change in readparm-files
+//
+//
+// - __DETAIL_TRIGGER__
+//
+//   This is for the implementation of the current work on trigger 
+//   studies. Because the class MTrigger is not well documented it 
+//   isn´t a part of this tar file. Only a dummy File exists. 
+//
+//
+//
+// With all files in the archive, the root_camera program should run. 
+//
+// A reflector file is in the directory rfl-files
+//
+// ==================================================
+//
+// From now on, use CVS for development!!!!
+//
+//
+//
 // Revision 1.2  1999/10/22 15:01:28  petry
 // version sent to H.K. and N.M. on Fri Oct 22 1999
