Positioning a Volume inside its Mother - Case 1

+-------------+                                               +----------##
| Geant 3.10  |               GEANT User's Guide              | GEOM110  ##
+-------------+                                               +----------##
                                   

                                   

Author(s) : R.Brun, A.McPherson                        Submitted: 15.08.83
Origin    : Same                                         Revised: 14.05.86
                                  

    +----------------------------------------------------------------+
    | CALL GSPOS (NAME,NR,MOTHER,X,Y,Z,IROT,KONLY) |
    +----------------------------------------------------------------+
                                  

Places a copy of the volume NAME (previously defined by a call to GSVOLU) with user number NR inside its mother volume MOTHER. GSPOS can be called several times with the same name, to place copies of the same volume (and of its contents) in various positions, either in the same mother volume or in several different ones. The data structure is so designed that, in any case, the substructure of a volume is defined and stored only once. Reference is always made to the first one wherever the volume is encountered.

NAME

4 character volume name (must have been defined by a call to GSVOLU).

NR

Copy number of the volume NAME being placed.

MOTHER

The 4 character mother name of this volume (i.e. the volume within which this volume is to be placed). The master reference system is defined by the top volume which does not need to be positioned at all.

X,Y,Z

Position of the volume in the mother reference system.

IROT

Rotation matrix number describing the orientation of the volume relative to the coordinate system of the mother (see GSROTM).

KONLY

A 4 character flag to indicate, at search time, whether a point found to be in this volume may also be in other volumes which are not direct descendants of it. If it is set to 'ONLY' then the search routines will assume that, when in it, the only further searching required is in its contents and their contents etc. The search will not look at other volumes at the same or higher levels or in separate branches. If it is set to 'MANY' the search will include other volumes which are contents of the same parent and if the parent is also 'MANY' the search will include volumes at that level and so on until an'ONLY' volume is reached. Eventually, a list of 'MANY' type volumes which are descendants of the last (lowest) 'ONLY' type volume will be generated. Of these the lowest level of search will be taken and if there are several at that level the first of them which was found will be taken.