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