source: trunk/MagicSoft/CvsDoku/welcome.html@ 296

Last change on this file since 296 was 296, checked in by harald, 26 years ago
small changes of some formats
File size: 9.2 KB
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<HTML>
3<HEAD>
4 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
5 <META NAME="GENERATOR" CONTENT="Mozilla/4.08 [en] (X11; I; OSF1 V4.0 alpha) [Netscape]">
6 <TITLE> CVS for Magic Software Development </TITLE>
7</HEAD>
8<BODY>
9<! This is my first attempt at my personal WWW home page. ><! It has become necessary to create this mainly because my ><! hotlist has grown into something so extremely large that it ><! is impossible to find a way through it any longer... >
10<CENTER>
11<H1>
12CVS for Magic Software Development</H1></CENTER>
13
14<HR>
15<H3>
16<FONT COLOR="#FF0000"><FONT SIZE=+2>Introduction</FONT></FONT></H3>
17More than one software developer are involved in the progress of Software
18for the MAGIC telescope. Because the developers are distributed all over
19Europe, a version control system is needed. There exists more than one
20possibility of such version control systems, but for the beginning we take
21CVS ( Concurrent Versions System ).
22<P>CVS is a version control system, which allows you to keep old versions
23of files (usually source code), keep a log of who, when, and why changes
24occurred, etc., like RCS or SCCS. Unlike the simpler systems, CVS does
25not just operate on one file at a time or one directory at a time, but
26operates on hierarchical collections of directories consisting of version
27controlled files. CVS helps to manage releases and to control the concurrent
28editing of source files among multiple authors. CVS allows triggers to
29enable/log/control various operations and works well over a wide area network.
30<P>CVS keeps a single copy of the master sources. This copy is called the
31source ``repository''; it contains all the information to permit extracting
32previous software releases at any time based on either a symbolic revision
33tag, or a date in the past.
34<P>For CVS updates, more information on documentation,&nbsp; software related
35to CVS, development of CVS, and more, see:
36<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
37
38<A HREF="http://www.cyclic.com">http://www.cyclic.com</A>
39<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
40
41<A HREF="http://www.loria.fr/~molli/cvs-index.html">http://www.loria.fr/~molli/cvs-index.html</A>
42<BR>&nbsp;
43<P>
44<HR WIDTH="100%">
45<BR><FONT COLOR="#FF0000"><FONT SIZE=+2>Repository</FONT></FONT>
46<P>The single copy of the master source for all MAGIC software is held
47in the repository on the alpha cluster in Max-Planck-Institut f&uuml;r
48Physik in Munich. As a developer you must declare the
49<BR>environment variable
50<P>setenv&nbsp;&nbsp; CVSROOT&nbsp; /hd60/CvsRepository/&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
51for tcsh (use the syntax of your shell)
52<BR>&nbsp;
53<P>All the Software is inside the directory. The structure of the sub directories
54is following one:
55<BR><FONT SIZE=+1></FONT>&nbsp;
56<BR><FONT SIZE=+1></FONT>&nbsp;
57<TABLE BORDER=0 CELLPADDING=10 COLS=7 WIDTH="100%" NOSAVE >
58<TR>
59<TD><FONT SIZE=+1><A HREF="#Anchor_MagicSoft">MagicSoft</A></FONT></TD>
60
61<TD><FONT SIZE=+1><A HREF="#Anchor_CvsDoku">CvsDoku</A></FONT></TD>
62
63<TD><FONT SIZE=+1></FONT></TD>
64
65<TD><FONT SIZE=+1></FONT></TD>
66
67<TD><FONT SIZE=+1></FONT></TD>
68
69<TD><FONT SIZE=+1></FONT></TD>
70
71<TD><FONT SIZE=+1></FONT></TD>
72</TR>
73
74<TR>
75<TD><FONT SIZE=+1></FONT></TD>
76
77<TD><FONT SIZE=+1><A HREF="#Anchor_Simulation">Simulation</A></FONT></TD>
78
79<TD><FONT SIZE=+1><A HREF="#Anchor_Corsika">Corsika</A></FONT></TD>
80
81<TD><FONT SIZE=+1>mmcs</FONT></TD>
82
83<TD><FONT SIZE=+1></FONT></TD>
84
85<TD><FONT SIZE=+1></FONT></TD>
86
87<TD><FONT SIZE=+1></FONT></TD>
88</TR>
89
90<TR>
91<TD><FONT SIZE=+1></FONT></TD>
92
93<TD><FONT SIZE=+1></FONT></TD>
94
95<TD><FONT SIZE=+1><A HREF="#Anchor_Detector">Detector</A></FONT></TD>
96
97<TD><FONT SIZE=+1><A HREF="#Anchor_Reflector">Reflector</A></FONT></TD>
98
99<TD><FONT SIZE=+1></FONT></TD>
100
101<TD><FONT SIZE=+1></FONT></TD>
102
103<TD><FONT SIZE=+1></FONT></TD>
104</TR>
105
106<TR>
107<TD><FONT SIZE=+1></FONT></TD>
108
109<TD><FONT SIZE=+1></FONT></TD>
110
111<TD><FONT SIZE=+1></FONT></TD>
112
113<TD><FONT SIZE=+1><A HREF="#Anchor_include-GENERAL">include-GENERAL</A></FONT></TD>
114
115<TD><FONT SIZE=+1></FONT></TD>
116
117<TD><FONT SIZE=+1></FONT></TD>
118
119<TD><FONT SIZE=+1></FONT></TD>
120</TR>
121
122<TR>
123<TD><FONT SIZE=+1></FONT></TD>
124
125<TD><FONT SIZE=+1></FONT></TD>
126
127<TD><FONT SIZE=+1></FONT></TD>
128
129<TD><FONT SIZE=+1><A HREF="#Anchor_include-CORSIKA">include-CORSIKA</A></FONT></TD>
130
131<TD><FONT SIZE=+1></FONT></TD>
132
133<TD><FONT SIZE=+1></FONT></TD>
134
135<TD><FONT SIZE=+1></FONT></TD>
136</TR>
137
138<TR>
139<TD><FONT SIZE=+1></FONT></TD>
140
141<TD><FONT SIZE=+1></FONT></TD>
142
143<TD><FONT SIZE=+1></FONT></TD>
144
145<TD><FONT SIZE=+1><A HREF="#Anchor_include-MC">include-MC</A></FONT></TD>
146
147<TD><FONT SIZE=+1></FONT></TD>
148
149<TD><FONT SIZE=+1></FONT></TD>
150
151<TD><FONT SIZE=+1></FONT></TD>
152</TR>
153
154<TR>
155<TD><FONT SIZE=+1></FONT></TD>
156
157<TD><FONT SIZE=+1><A HREF="#Anchor_include-Classes">include-Classes</A></FONT></TD>
158
159<TD><FONT SIZE=+1></FONT></TD>
160
161<TD><FONT SIZE=+1></FONT></TD>
162
163<TD><FONT SIZE=+1></FONT></TD>
164
165<TD><FONT SIZE=+1></FONT></TD>
166
167<TD><FONT SIZE=+1></FONT></TD>
168</TR>
169
170<TR>
171<TD><FONT SIZE=+1></FONT></TD>
172
173<TD><FONT SIZE=+1></FONT></TD>
174
175<TD><FONT SIZE=+1></FONT></TD>
176
177<TD><FONT SIZE=+1></FONT></TD>
178
179<TD><FONT SIZE=+1></FONT></TD>
180
181<TD><FONT SIZE=+1></FONT></TD>
182
183<TD><FONT SIZE=+1></FONT></TD>
184</TR>
185
186<TR>
187<TD><FONT SIZE=+1></FONT></TD>
188
189<TD><FONT SIZE=+1><A HREF="#Anchor_Analysis">Analysis</A></FONT></TD>
190
191<TD><FONT SIZE=+1></FONT></TD>
192
193<TD><FONT SIZE=+1></FONT></TD>
194
195<TD><FONT SIZE=+1></FONT></TD>
196
197<TD><FONT SIZE=+1></FONT></TD>
198
199<TD><FONT SIZE=+1></FONT></TD>
200</TR>
201
202<TR>
203<TD><FONT SIZE=+1></FONT></TD>
204
205<TD><FONT SIZE=+1></FONT></TD>
206
207<TD><FONT SIZE=+1></FONT></TD>
208
209<TD><FONT SIZE=+1></FONT></TD>
210
211<TD><FONT SIZE=+1></FONT></TD>
212
213<TD><FONT SIZE=+1></FONT></TD>
214
215<TD><FONT SIZE=+1></FONT></TD>
216</TR>
217</TABLE>
218
219<HR WIDTH="100%">
220<BR>&nbsp;
221<H3>
222<FONT COLOR="#FF0000"><FONT SIZE=+2>Detail of subdirectories in the repository</FONT></FONT></H3>
223
224<P><BR><A NAME="Anchor_MagicSoft"></A><FONT COLOR="#CC33CC"><FONT SIZE=+2>MagicSoft</FONT></FONT>
225<P>In this directory of the cvs-repository you find all software that is
226developed for MAGIC using CVS.
227<BR>This directory contain four sub directories, CvsDoku, Simulation, Analysis
228and include-Classes.
229<BR>&nbsp;
230<BLOCKQUOTE><A NAME="Anchor_CvsDoku"></A><FONT COLOR="#CC33CC"><FONT SIZE=+2>CvsDoku</FONT></FONT>
231<P>In this directory of the cvs-repository you find some html pages like
232the one you are looking at the moment. This documentation is written as
233a guideline for MAGIC developers using the CVS tool. Also the documentation
234for CVS usage is using CVS!!
235<P><A NAME="Anchor_Simulation"></A><FONT COLOR="#CC66CC"><FONT SIZE=+2>Simulation</FONT></FONT>
236<BR>For MAGIC a lot of programs were developed to simulate the behavior
237of Air Showers, the Mirrors and the Camera. All this things you need for
238simulation is inside this directory.
239<BR>&nbsp;
240<BLOCKQUOTE><A NAME="Anchor_Corsika"></A><FONT COLOR="#CC33CC"><FONT SIZE=+2>Corsika</FONT></FONT>
241<BR>All things needed for the simulation of AirShowers. All this simulation
242are based on the CORSIKA program of the KASCADE group in Karlsruhe.
243<BR>&nbsp;
244<P><A NAME="Anchor_Detector"></A><FONT COLOR="#CC33CC"><FONT SIZE=+2>Detector</FONT></FONT>
245<BR>&nbsp;Every thing that is needed to transfer the simulated events to
246the common raw data forrmat. There are a lot of different tools inside
247this directory, mainly based on the work of Jose Carlos Gonzales.
248<BR>&nbsp;
249<BLOCKQUOTE><A NAME="Anchor_Reflector"></A><FONT COLOR="#CC33CC"><FONT SIZE=+2>Reflector</FONT></FONT>
250<BR>&nbsp;Here you find the source code of the reflector program. This
251is written to read the CORSIKA (mmcs) output. With this data you can simulate
252the behaviour of the MAGIC mirrors. But to compile and run the program
253some other subdirectories are needed.
254<P><A NAME="Anchor_include-CORSIKA"></A><FONT COLOR="#CC33CC"><FONT SIZE=+2>include-CORSIKA</FONT></FONT>
255<BR>Here you can find a implementation to read the CORSIKA output. This
256classes are needed by the reflector program.
257<P><A NAME="Anchor_include-MC"></A><FONT COLOR="#CC33CC"><FONT SIZE=+2>include-MC</FONT></FONT>
258<BR>Here you can find a implementation to write and read the output of
259the reflector program. This classes are needed by the reflector and the
260camera program.
261<P><A NAME="Anchor_include-GENERAL"></A><FONT COLOR="#CC33CC"><FONT SIZE=+2>include-GENERAL</FONT></FONT>
262<BR>Here you can find some header file that are needed by reflector and
263camera. For example the declaration of the runlib is found here.
264<BR>&nbsp;</BLOCKQUOTE>
265</BLOCKQUOTE>
266<A NAME="Anchor_include-Classes"></A><FONT COLOR="#CC66CC"><FONT SIZE=+2>include-Classes</FONT></FONT>
267<P>In this directory you can find all Classes (C++ and hopefully OOP )
268that are used for simulation and for analysis. An example is the RawDataFormat
269used in the Analysis and the Camera programs.
270<P><A NAME="Anchor_Analysis"></A><FONT COLOR="#CC66CC"><FONT SIZE=+2>Analysis</FONT></FONT>
271<P>In this directory you can find all Programs to analyze data of MAGIC.
272Here you will find tools to look on single Events, to calculate the Hillas
273parameters and to find the periodicity of one special source. (But all
274this is still under construction!!!! Here the must development is needed
275in the future!!!)
276<BR>&nbsp;</BLOCKQUOTE>
277
278<BR>&nbsp;
279</BODY>
280</HTML>
Note: See TracBrowser for help on using the repository browser.