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