Index: trunk/MagicSoft/CvsDoku/welcome.html =================================================================== --- trunk/MagicSoft/CvsDoku/welcome.html (revision 309) +++ trunk/MagicSoft/CvsDoku/welcome.html (revision 314) @@ -3,5 +3,5 @@ - + CVS for Magic Software Development @@ -47,5 +47,92 @@ for tcsh (use the syntax of your shell)

The access from other computers is still under construction and tests. -Wait for the green light, very soon. +If you want access please inform +Harald Kornmayer  in Munich. For more details about the structure +of the repository see here. +
  +

+

+
Just for Beginners +

All developers should use CVS commands for further development. I set +up different projects of software development. Please take only the source +file from the repository which are necessary for the project you want to +work on. Please don't work on to much projects in parallel. If you are +planning to do bigger changes create your own development branch. But don't +wait to long with committing. +
+

+
Projects +

The software is separated in different software projects. This projects +are: +
  +

 Mmcs (Magic Monte +Carlo Simulation ) +
This is the adapted CORSIKA code for calculating air showers. +

Reflector +
With this program you can track the cerenkov photons generated by Mmcs +to the camera plane. So all the geometry of the telescope is inside this +program. +

Camera +
To change the information of the cerenkov photons to FADC counts you +have to use the camera program. This program contains a lot of different +other sources that are also used by the reflector or the Evita project. +

Evita (EVent Imaging Tool for Analysis) +
To display one event use this nice Gui package. +

....... +
 

+It is obvious that some source code of a given directory is part of different +projects. I.e. the directory include-MC is a part of the reflector and +the camera project. +

+

+
Commands +
  +
    +
  1. +Continue with development of existing projects
    2. + +
    command: cvs checkout project +
    Then you will get all the directories that are necessary for compiling +the given project. So go first in the directory with the Makefile and try +to compile it. Then you can start with working on the source files. At +the end of your work you will have modified source files. +
      +
  2. +Check the status of the files in your directory
    3. + +
    command: cvs status +
    Then you will get a long list with information of all files in this +directory and all sub directory. +
    If you want to see only the names of the modified files use the +
    command:cvs status | grep odi +
      +
  3. +See differences of your files and the repository
    4. + +
    command: cvs diff [filename] +
    This will show you the changed you did. +
      +
  4. +Commit your changes to the repository
    5. + +
    command: cvs commit [filename] +
    The changes you made will then be in the repository and are available +for all other developers. +
      +
  5. +Remove all your files
    6. + +
    command: cvs release -d [filename] +
    Do this in the most upper directory (There you can see i.e. MagicSoft.). +If CVS find some altered files it will not deleted all immediately. But +if you have no altered files say yes and delete all the files and directory +you worked on. So you are always sure that there is no old or changed version +of a project. +
      +
     
+ +
+

Structure +of the Repository

All the Software is inside the directory. The structure of the sub directories is following one: @@ -76,5 +163,5 @@ Corsika -mmcs +Mmcs @@ -173,4 +260,36 @@ include-MTrigger + + + + + + + + + + + + + + + +Data + + + + + + + + + + + + + + + +lib  @@ -249,5 +368,5 @@
 

-Detail of subdirectories in the repository

+Detail of sub directories in the repository


MagicSoft @@ -268,21 +387,21 @@
 

Corsika -
All things needed for the simulation of AirShowers. All this simulation +
All things needed for the simulation of Air Showers. All this simulation are based on the CORSIKA program of the KASCADE group in Karlsruhe.
 

Detector
 Every thing that is needed to transfer the simulated events to -the common raw data forrmat. There are a lot of different tools inside -this directory, mainly based on the work of Jose Carlos Gonzales. +the common raw data format. There are a lot of different tools inside this +directory, mainly based on the work of Jose Carlos Gonzales.
 

Reflector
 Here you find the source code of the reflector program. This -is written to read the CORSIKA (mmcs) output. With this data you can simulate -the behaviour of the MAGIC mirrors. But to compile and run the program -some other subdirectories are needed. +is written to read the CORSIKA (Mmcs) output. With this data you can simulate +the behavior of the MAGIC mirrors. But to compile and run the program some +other sub directories are needed.

Camera

 In this directory are all the files of the camera program. The camera program is calculating the response of each -photomultiplier of the camera. At the end we get the number of ADC count +photo multiplier of the camera. At the end we get the number of ADC count for each time slice of each pixel. In the previous there were also some smaller calculations of the camera pixels in it. @@ -299,8 +418,13 @@
 

include-MTrigger -
Studies of the trigger behaviour are very fundamental things. The simulation +
Studies of the trigger behavior are very fundamental things. The simulation of the trigger is a part of the camera program. All the methods are put in the Classes (called MTRigger ) in this directory. -
 

+

Data +
All the different data files for the simulation tools reflector and +camera are in this directory. For example the geometry of the MAGIC telescope +is stored in magic.def or the data of the focal points is stored in focal.dat. +

lib +
Here you find the ranlib that is used by reflector and camera.

include-Classes