Changeset 314 for trunk/MagicSoft


Ignore:
Timestamp:
11/09/99 19:24:18 (25 years ago)
Author:
magiccvs
Message:
Some more changes for better dokumentation. It grows and grows...
File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/MagicSoft/CvsDoku/welcome.html

    r309 r314  
    33<head>
    44   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    5    <meta name="GENERATOR" content="Mozilla/4.5 [en] (X11; I; Linux 2.0.36 i686) [Netscape]">
     5   <meta name="GENERATOR" content="Mozilla/4.51 [en] (X11; I; Linux 2.2.5 i586) [Netscape]">
    66   <title> CVS for Magic Software Development </title>
    77</head>
    … …  
    4747for tcsh (use the syntax of your shell)
    4848<p>The access from other computers is still under construction and tests.
    49 Wait for the green light, very soon.
     49If you want access please inform<a href="mailto:harald@hegra1.mppmu.mpg.de">
     50Harald Kornmayer&nbsp;</a> in Munich. For more details about the structure
     51of the repository see <a href="#Anchor_StructureRepository">here.</a>
     52<br>&nbsp;
     53<p>
     54<hr WIDTH="100%">
     55<br><font color="#FF0000"><font size=+2>Just for Beginners</font></font>
     56<p>All developers should use CVS commands for further development. I set
     57up different projects of software development. Please take only the source
     58file from the repository which are necessary for the project you want to
     59work on. Please don't work on to much projects in parallel. If you are
     60planning to do bigger changes create your own development branch. But don't
     61wait to long with committing.
     62<br>
     63<hr WIDTH="100%">
     64<br><font color="#FF0000"><font size=+2>Projects</font></font>
     65<p>The software is separated in different software projects. This projects
     66are:
     67<br>&nbsp;
     68<blockquote><font color="#CC6600"><font size=+1>&nbsp;Mmcs (Magic Monte
     69Carlo Simulation )</font></font>
     70<br>This is the adapted CORSIKA code for calculating air showers.
     71<p><font color="#CC6600"><font size=+1>Reflector</font></font>
     72<br>With this program you can track the cerenkov photons generated by Mmcs
     73to the camera plane. So all the geometry of the telescope is inside this
     74program.
     75<p><font color="#CC6600"><font size=+1>Camera</font></font>
     76<br>To change the information of the cerenkov photons to FADC counts you
     77have to use the camera program. This program contains a lot of different
     78other sources that are also used by the reflector or the Evita project.
     79<p><font color="#CC6600"><font size=+1>Evita (EVent Imaging Tool for Analysis)</font></font>
     80<br>To display one event use this nice Gui package.
     81<p>.......
     82<br>&nbsp;</blockquote>
     83It is obvious that some source code of a given directory is part of different
     84projects. I.e. the directory include-MC is a part of the reflector and
     85the camera project.
     86<p>
     87<hr WIDTH="100%">
     88<br><font color="#FF0000"><font size=+2>Commands</font></font>
     89<br>&nbsp;
     90<ol>
     91<li>
     92Continue with development of existing projects</li>
     93
     94<br>command: cvs checkout <i>project</i>
     95<br>Then you will get all the directories that are necessary for compiling
     96the given project. So go first in the directory with the Makefile and try
     97to compile it. Then you can start with working on the source files. At
     98the end of your work you will have modified source files.
     99<br>&nbsp;
     100<li>
     101Check the status of the files in your directory</li>
     102
     103<br>command: cvs status
     104<br>Then you will get a long list with information of all files in this
     105directory and all sub directory.
     106<br>If you want to see only the names of the modified files use the
     107<br>command:cvs status | grep odi
     108<br>&nbsp;
     109<li>
     110See differences of your files and the repository</li>
     111
     112<br>command: cvs diff <i>[filename]</i>
     113<br>This will show you the changed you did.
     114<br>&nbsp;
     115<li>
     116Commit your changes to the repository</li>
     117
     118<br>command: cvs commit [<i>filename]</i>
     119<br>The changes you made will then be in the repository and are available
     120for all other developers.
     121<br>&nbsp;
     122<li>
     123Remove all your files</li>
     124
     125<br>command: cvs release -d [filename]
     126<br>Do this in the most upper directory (There you can see i.e. MagicSoft.).
     127If CVS find some altered files it will not deleted all immediately. But
     128if you have no altered files say yes and delete all the files and directory
     129you worked on. So you are always sure that there is no old or changed version
     130of a project.
     131<br>&nbsp;
     132<br>&nbsp;</ol>
     133
     134<hr WIDTH="100%">
     135<p><a NAME="Anchor_StructureRepository"></a><font color="#FF0000"><font size=+2>Structure
     136of the Repository</font></font>
    50137<p>All the Software is inside the directory. The structure of the sub directories
    51138is following one:
    … …  
    76163<td><font size=+1><a href="#Anchor_Corsika">Corsika</a></font></td>
    77164
    78 <td><font size=+1>mmcs</font></td>
     165<td><font size=+1>Mmcs</font></td>
    79166
    80167<td></td>
    … …  
    173260
    174261<td><font size=+1><a href="#Anchor_include-MTrigger">include-MTrigger</a></font></td>
     262
     263<td></td>
     264
     265<td></td>
     266
     267<td></td>
     268</tr>
     269
     270<tr>
     271<td></td>
     272
     273<td></td>
     274
     275<td><font size=+1><a href="Anchor_DetData"></a></font></td>
     276
     277<td><font size=+1><a href="#Anchor_DetData">Data</a></font></td>
     278
     279<td></td>
     280
     281<td></td>
     282
     283<td></td>
     284</tr>
     285
     286<tr>
     287<td></td>
     288
     289<td></td>
     290
     291<td><font size=+1><a href="#Anchor_lib"></a></font></td>
     292
     293<td><font size=+1><a href="#Anchor_lib">lib&nbsp;</a></font></td>
    175294
    176295<td></td>
    … …  
    249368<br>&nbsp;
    250369<h3>
    251 <font color="#FF0000"><font size=+2>Detail of subdirectories in the repository</font></font></h3>
     370<font color="#FF0000"><font size=+2>Detail of sub directories in the repository</font></font></h3>
    252371
    253372<p><br><a NAME="Anchor_MagicSoft"></a><font color="#CC33CC"><font size=+2>MagicSoft</font></font>
    … …  
    268387<br>&nbsp;
    269388<blockquote><a NAME="Anchor_Corsika"></a><font color="#CC33CC"><font size=+2>Corsika</font></font>
    270 <br>All things needed for the simulation of AirShowers. All this simulation
     389<br>All things needed for the simulation of Air Showers. All this simulation
    271390are based on the CORSIKA program of the KASCADE group in Karlsruhe.
    272391<br>&nbsp;
    273392<p><a NAME="Anchor_Detector"></a><font color="#CC33CC"><font size=+2>Detector</font></font>
    274393<br>&nbsp;Every thing that is needed to transfer the simulated events to
    275 the common raw data forrmat. There are a lot of different tools inside
    276 this directory, mainly based on the work of Jose Carlos Gonzales.
     394the common raw data format. There are a lot of different tools inside this
     395directory, mainly based on the work of Jose Carlos Gonzales.
    277396<br>&nbsp;
    278397<blockquote><a NAME="Anchor_Reflector"></a><font color="#CC33CC"><font size=+2>Reflector</font></font>
    279398<br>&nbsp;Here you find the source code of the reflector program. This
    280 is written to read the CORSIKA (mmcs) output. With this data you can simulate
    281 the behaviour of the MAGIC mirrors. But to compile and run the program
    282 some other subdirectories are needed.
     399is written to read the CORSIKA (Mmcs) output. With this data you can simulate
     400the behavior of the MAGIC mirrors. But to compile and run the program some
     401other sub directories are needed.
    283402<p><a NAME="anchor_Camera"></a><font color="#CC66CC"><font size=+2>Camera</font></font>
    284403<p><font color="#330000">&nbsp;In this directory are all the files of the
    285404camera program. The camera program is calculating the response of each
    286 photomultiplier of the camera. At the end we get the number of ADC count
     405photo multiplier of the camera. At the end we get the number of ADC count
    287406for each time slice of each pixel. In the previous there were also some
    288407smaller calculations of the camera pixels in it.</font>
    … …  
    299418<br>&nbsp;
    300419<p><a NAME="Anchor_include-MTrigger"></a><font color="#CC66CC"><font size=+2>include-MTrigger</font></font>
    301 <br>Studies of the trigger behaviour are very fundamental things. The simulation
     420<br>Studies of the trigger behavior are very fundamental things. The simulation
    302421of the trigger is a part of the camera program. All the methods are put
    303422in the Classes (called MTRigger ) in this directory.
    304 <br>&nbsp;</blockquote>
     423<p><a NAME="Anchor_DetData"></a><font color="#CC33CC"><font size=+2>Data</font></font>
     424<br>All the different data files for the simulation tools reflector and
     425camera are in this directory. For example the geometry of the MAGIC&nbsp;telescope
     426is stored in magic.def or the data of the focal points is stored in focal.dat.
     427<p><a NAME="Anchor_lib"></a><font color="#CC33CC"><font size=+2>lib</font></font>
     428<br>Here you find the ranlib that is used by reflector and camera.</blockquote>
    305429</blockquote>
    306430<a NAME="Anchor_include-Classes"></a><font color="#CC66CC"><font size=+2>include-Classes</font></font>
Note: See TracChangeset for help on using the changeset viewer.