Contents 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	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"