Annotation of /tracker/ground/run-test/WHAT-TO-DO

TEST EXAMPLE

The script "run-test.sh" in this directory provide an example of how to run the
tracker data-reduction software. 

Before going on with this test example, be sure that the three executables 
"level0.exe", "level1.exe" and "level2.exe" have been created 
(follow instruction in the file "README" in the parent directory).

1) create a symbolic link "raw-data" to the raw-data directory:

#ln -s path-of-raw-data/ raw-data

2) be sure that the directory rz-test contains the file "default_calib.rz": 

#ls rz-test/default_calib.rz

3) The first step of reduction is performed by "level0.exe". This program 
processes a list of CONSECUTIVE downlinks (eg. the file "050323.txt" contains
the list of consecutive good downlinks collected on March 23 We). Run the script
as follow:

#./run-test.sh 050323.txt level0 &

At the end of the process a report file "050323.txt-level0" is created in the 
current directory. 
The directory "rz-test" contains the rz files; for each downlink the 
following files are created:

DW_YYMMDD_XXX_01_calib.rz     1^ calibration packet
DW_YYMMDD_XXX_02_calib.rz     2^     "          " 
...
DW_YYMMDD_XXX_NN_calib.rz     N^     "          "
DW_YYMMDD_XXX_calib.txt       list of calibration files related to the downlink
DW_YYMMDD_XXX_level0.rz       =====> LEVEL0 tracker data
DW_YYMMDD_XXX_tof.rz          tof/trigger data (... NOT UP-TO-DATE !!!!)

4)The second step of reduction is performed by "level1.exe". The program
processes a level0 rz file, producing a level1 file. Run the script
as follow:

#./run-test.sh 050323.txt level1 &

At the end of the process a report file "050323.txt-level1" is created in the
current directory. 
The directory "rz-test" contains the level1 rz file:

DW_YYMMDD_XXX_level1.rz       =====> LEVEL1 tracker data


5)The third step of reduction is performed by "level2.exe". The program
processes a level1 rz file, producing a level2 file. Run the script
as follow:

#./run-test.sh 050323.txt level2 &

At the end of the process a report file "050323.txt-level2" is created in the
current directory. 
The directory "rz-test" contains the level2 rz file:

DW_YYMMDD_XXX_level2.rz       =====> LEVEL1 tracker data


You can compare the output of the whole procedure with the content of the 
tar archive "DW_050323.tar.gz" inlcuded in the directory "rz-test"
1	pam-fi	1.1	TEST EXAMPLE
2
3			The script "run-test.sh" in this directory provide an example of how to run the
4			tracker data-reduction software.
5
6			Before going on with this test example, be sure that the three executables
7			"level0.exe", "level1.exe" and "level2.exe" have been created
8			(follow instruction in the file "README" in the parent directory).
9
10			1) create a symbolic link "raw-data" to the raw-data directory:
11
12			#ln -s path-of-raw-data/ raw-data
13
14			2) be sure that the directory rz-test contains the file "default_calib.rz":
15
16			#ls rz-test/default_calib.rz
17
18			3) The first step of reduction is performed by "level0.exe". This program
19			processes a list of CONSECUTIVE downlinks (eg. the file "050323.txt" contains
20			the list of consecutive good downlinks collected on March 23 We). Run the script
21			as follow:
22
23			#./run-test.sh 050323.txt level0 &
24
25			At the end of the process a report file "050323.txt-level0" is created in the
26			current directory.
27			The directory "rz-test" contains the rz files; for each downlink the
28			following files are created:
29
30			DW_YYMMDD_XXX_01_calib.rz 1^ calibration packet
31			DW_YYMMDD_XXX_02_calib.rz 2^ " "
32			...
33			DW_YYMMDD_XXX_NN_calib.rz N^ " "
34			DW_YYMMDD_XXX_calib.txt list of calibration files related to the downlink
35			DW_YYMMDD_XXX_level0.rz =====> LEVEL0 tracker data
36			DW_YYMMDD_XXX_tof.rz tof/trigger data (... NOT UP-TO-DATE !!!!)
37
38			4)The second step of reduction is performed by "level1.exe". The program
39			processes a level0 rz file, producing a level1 file. Run the script
40			as follow:
41
42			#./run-test.sh 050323.txt level1 &
43
44			At the end of the process a report file "050323.txt-level1" is created in the
45			current directory.
46			The directory "rz-test" contains the level1 rz file:
47
48			DW_YYMMDD_XXX_level1.rz =====> LEVEL1 tracker data
49
50
51			5)The third step of reduction is performed by "level2.exe". The program
52			processes a level1 rz file, producing a level2 file. Run the script
53			as follow:
54
55			#./run-test.sh 050323.txt level2 &
56
57			At the end of the process a report file "050323.txt-level2" is created in the
58			current directory.
59			The directory "rz-test" contains the level2 rz file:
60
61			DW_YYMMDD_XXX_level2.rz =====> LEVEL1 tracker data
62
63
64			You can compare the output of the whole procedure with the content of the
65			tar archive "DW_050323.tar.gz" inlcuded in the directory "rz-test"