1 | README.test1 DCW Oct 8, 1998 |
---|
2 | |
---|
3 | The first test involves the use of a particle generator called "SprayGun", |
---|
4 | controlled interactively, and an event display. |
---|
5 | |
---|
6 | I have found the VRML display to be particularly useful for this. |
---|
7 | A VRML display can be selected by executing the script "draw3d.script". |
---|
8 | See GEANT4 documentation for more information on setting up a VRML display. |
---|
9 | |
---|
10 | For this test, the spray gun as a particle generator should be selected |
---|
11 | (this is by default): |
---|
12 | |
---|
13 | /fred/gun SPRAY |
---|
14 | |
---|
15 | In addition, the "NORMAL" drawing mode should be selected (this is by default): |
---|
16 | |
---|
17 | /fred/draw NORMAL |
---|
18 | |
---|
19 | Before run initialize, a volume should be specified. See README.volumes |
---|
20 | for details. |
---|
21 | |
---|
22 | Fred displays the event at the end of each event (as activated by command |
---|
23 | /run/beamOn). Drawn in red is the test volume and in green are trajectories |
---|
24 | of geantinos. For every exit intersection of the trajectory with the |
---|
25 | test volume, a white sphere is drawn. For every entry intersection, a |
---|
26 | blue sphere is drawn. |
---|
27 | |
---|
28 | The spray gun creates geantinos emitted from a central point along |
---|
29 | x, y, and z angles in increments of 45 degrees. The position of the central |
---|
30 | point is controlled by the command: |
---|
31 | |
---|
32 | /sprayGun/position <x> <y> <z> [<units>] |
---|
33 | |
---|
34 | The angles are controlled by the commands: |
---|
35 | |
---|
36 | /sprayGun/xSpray <xmask> |
---|
37 | /sprayGun/ySpray <ymask> |
---|
38 | /sprayGun/zSpray <zmask> |
---|
39 | |
---|
40 | Each mask has the following meaning: |
---|
41 | Bit 0: add tracks with a positive momentum with respect to this axis |
---|
42 | Bit 1: add tracks with zero momentum with respect to this axis |
---|
43 | Bit 2: add tracks with a negative momentum with respect to this axis |
---|
44 | By default, xmask=7, ymask=7, and zmask=2, which produces 8 geantinos |
---|
45 | in the x/y plane at angles of 45 degree increments with respect to the x |
---|
46 | or y axes. |
---|
47 | |
---|
48 | To test a volume: interactively place the sprayGun central point along |
---|
49 | difficult positions around or in the volume, and visually inspect the |
---|
50 | results for errors. A knowledge of the difficulties of correctly |
---|
51 | implementing volumes is important to select challenging positions for |
---|
52 | tests. |
---|
53 | |
---|
54 | If an error is found, the xmask, ymask, and zmask values can be specified |
---|
55 | to produce only the one track that causes the error. This can greatly |
---|
56 | simplify the task of debugging. |
---|
57 | |
---|
58 | A example debugging session is included below: |
---|
59 | |
---|
60 | /vis/open VRML1 |
---|
61 | /vis~/create_view/new_graphics_system VRML1 |
---|
62 | /vis~/camera/zoom 16 |
---|
63 | /tracking/storeTrajectory 1 |
---|
64 | /vis/draw/current |
---|
65 | # select test volume BOX |
---|
66 | /fred/volume BOX |
---|
67 | # initialize |
---|
68 | /run/initialize |
---|
69 | # select VRML display |
---|
70 | /control/execute draw3d.script |
---|
71 | # display an event |
---|
72 | /run/beamOn 1 |
---|
73 | # change spray gun to send trajectories at +/- z |
---|
74 | /sprayGun/zSpray 7 |
---|
75 | # change position of particle sources |
---|
76 | /sprayGun/position 1.0 1.0 0.0 m |
---|
77 | # display results |
---|
78 | /run/beamOn 1 |
---|