| Geant4 Cross Reference |
1 1
2 G4RayTracer version 1.0 (29/Jan/00) 2 G4RayTracer version 1.0 (29/Jan/00)
3 3
4 1. Introduction 4 1. Introduction
5 5
6 G4RayTracer is a "ray tracing" package which 6 G4RayTracer is a "ray tracing" package which uses Geant4 kernel mechanism
7 of tracking/navigation. It visualizes any kind 7 of tracking/navigation. It visualizes any kinds of solids that Geant4
8 kernel can navigate. 8 kernel can navigate.
9 9
10 2. Building a library 10 2. Building a library
11 11
12 G4RayTracer is one of visualization driver wh 12 G4RayTracer is one of visualization driver which Geant4 supports. To build
13 a library of G4RayTracer (library name G4RayTr 13 a library of G4RayTracer (library name G4RayTracer), set an environment
14 variable G4VIS_BUILD_RAYTRACER_DRIVER. 14 variable G4VIS_BUILD_RAYTRACER_DRIVER.
15 15
16 $ setenv G4VIS_BUILD_RAYTRACER_DRIVER 1 16 $ setenv G4VIS_BUILD_RAYTRACER_DRIVER 1
17 17
18 3. Using G4RayTracer 18 3. Using G4RayTracer
19 19
20 To use G4RayTracer, set an environment variab 20 To use G4RayTracer, set an environment variable G4VIS_USE_RAYTRACER.
21 21
22 $ setenv G4VIS_USE_RAYTRACER 1 22 $ setenv G4VIS_USE_RAYTRACER 1
23 23
24 Also, G4RayTracer has to be registored to the 24 Also, G4RayTracer has to be registored to the user's concrete VisManager.
25 Refer an example given in 25 Refer an example given in
26 geant4/source/visualization/management/inclu 26 geant4/source/visualization/management/include/MyVisManager.cc.
27 27
28 4. Notes 28 4. Notes
29 29
30 a) G4RayTracer generates JPEG file(s). To visu 30 a) G4RayTracer generates JPEG file(s). To visualize these files, use your
31 local program such as NetScape or xview, etc. 31 local program such as NetScape or xview, etc.
32 32
33 b) The eye position must be inside of the defi 33 b) The eye position must be inside of the defined world volume. If you want
34 to draw your detector setup from very far posi 34 to draw your detector setup from very far position, you need to enlarge
35 your world volume. 35 your world volume.
36 36
37 c) G4RayTracer ignores volumes without G4VisAt 37 c) G4RayTracer ignores volumes without G4VisAttributes, volumes which are
38 set as "forced wire frame", and volumes which 38 set as "forced wire frame", and volumes which are set as "invisible".
39 39
40 d) In case you get unexpected figure, check 40 d) In case you get unexpected figure, check
41 d.1) eye position and target position are pro 41 d.1) eye position and target position are properly set,
42 d.2) light direction is properly set (note li 42 d.2) light direction is properly set (note light direction is from
43 illumination light source to the objects) 43 illumination light source to the objects),
44 d.3) span angle (given by angle for 100 pixel 44 d.3) span angle (given by angle for 100 pixels) is reasonable,
45 d.4) there is no surrounding volume(s) withou 45 d.4) there is no surrounding volume(s) without transparency.
46 46
47 e) G4RayTracer can be executed ONLY AT "Idle" 47 e) G4RayTracer can be executed ONLY AT "Idle" state.
48 48
49 5. Basic UI commands 49 5. Basic UI commands
50 50
51 a) /vis/rayTracer/eyePosition x y z unit 51 a) /vis/rayTracer/eyePosition x y z unit
52 eye position 52 eye position
53 53
54 b) /vis/rayTracer/target x y z unit 54 b) /vis/rayTracer/target x y z unit
55 target position 55 target position
56 in default it is set to the origine 56 in default it is set to the origine
57 57
58 c) /vis/rayTracer/lightDirection ex ey ez 58 c) /vis/rayTracer/lightDirection ex ey ez
59 vector of the illuminating light (need not 59 vector of the illuminating light (need not to be a unit vector)
60 note light direction is from illumination 60 note light direction is from illumination light source to the objects
61 61
62 d) /vis/rayTracer/column nColumn 62 d) /vis/rayTracer/column nColumn
63 number of holizontal pixels 63 number of holizontal pixels
64 in default 640 pixels 64 in default 640 pixels
65 65
66 e) /vis/rayTracer/row nRow 66 e) /vis/rayTracer/row nRow
67 number of virtical pixels 67 number of virtical pixels
68 in default 640 pixels 68 in default 640 pixels
69 69
70 f) /vis/rayTracer/span angle unit 70 f) /vis/rayTracer/span angle unit
71 angle for 100 pixels 71 angle for 100 pixels
72 in default 5 degree 72 in default 5 degree
73 73
74 g) /vis/rayTracer/trace fileName 74 g) /vis/rayTracer/trace fileName
75 execution of G4RayTracer 75 execution of G4RayTracer
76 "fileName" is the out put JPEG file name 76 "fileName" is the out put JPEG file name
77 in default "g4RayTracer.jpeg" 77 in default "g4RayTracer.jpeg"
78 NOTE THAT THIS COMMAND IS AVAILABLE ONLY A 78 NOTE THAT THIS COMMAND IS AVAILABLE ONLY AT IDLE STATE
79 79
80 80
81 81
82 82