class TGeoManager: public TNamed

 Default constructor.

 Constructor.

 Initialize manager class.

copy constructor

assignment operator

   Destructor

 Add a material to the list. Returns index of the material in list.

 Add an illegal overlap/extrusion to the list.

 Add a matrix to the list. Returns index of the matrix in list.

 Add a shape to the list. Returns index of the shape in list.

 Add a track to the list of tracks. Use this for primaries only. For secondaries,
 add them to the parent track. The method create objects that are registered
 to the analysis manager but have to be cleaned-up by the user via ClearTracks().

 Add a track to the list of tracks

 Makes a primary track but do not attach it to the list of tracks. The track
 can be attached as daughter to another one with TVirtualGeoTrack::AddTrack

 Add a volume to the list. Returns index of the volume in list.

 Add a navigator in the list of navigators. If it is the first one make it
 current navigator.

 Switch to another navigator.

 Describe how to browse this object.

 Append a pad for this geometry.

 Set visibility for a volume.

 Get the new 'bombed' translation vector according current exploded view mode.

 Get the new 'unbombed' translation vector according current exploded view mode.

 Backup the current state without affecting the cache stack.

 Restore a backed-up state without affecting the cache stack.

 Register a matrix to the list of matrices. It will be cleaned-up at the
 destruction TGeoManager.

 Replaces all occurences of VORIG with VNEW in the geometry tree. The volume VORIG
 is not replaced from the list of volumes, but all node referencing it will reference
 VNEW instead. Returns number of occurences changed.

 Transform all volumes named VNAME to assemblies. The volumes must be virtual.

 Create a new volume by dividing an existing one (GEANT3 like)

 Divides MOTHER into NDIV divisions called NAME
 along axis IAXIS starting at coordinate value START
 and having size STEP. The created volumes will have tracking
 media ID=NUMED (if NUMED=0 -> same media as MOTHER)
    The behavior of the division operation can be triggered using OPTION :
 OPTION (case insensitive) :
  N  - divide all range in NDIV cells (same effect as STEP<=0) (GSDVN in G3)
  NX - divide range starting with START in NDIV cells          (GSDVN2 in G3)
  S  - divide all range with given STEP. NDIV is computed and divisions will be centered
         in full range (same effect as NDIV<=0)                (GSDVS, GSDVT in G3)
  SX - same as DVS, but from START position.                   (GSDVS2, GSDVT2 in G3)

 Create rotation matrix named 'mat<index>'.

  index    rotation matrix number
  theta1   polar angle for axis X
  phi1     azimuthal angle for axis X
  theta2   polar angle for axis Y
  phi2     azimuthal angle for axis Y
  theta3   polar angle for axis Z
  phi3     azimuthal angle for axis Z

 Create material with given A, Z and density, having an unique id.

 Create mixture OR COMPOUND IMAT as composed by THE BASIC nelem
 materials defined by arrays A,Z and WMAT, having an unique id.

 Create mixture OR COMPOUND IMAT as composed by THE BASIC nelem
 materials defined by arrays A,Z and WMAT, having an unique id.

 Create tracking medium

  numed      tracking medium number assigned
  name      tracking medium name
  nmat      material number
  isvol     sensitive volume flag
  ifield    magnetic field
  fieldm    max. field value (kilogauss)
  tmaxfd    max. angle due to field (deg/step)
  stemax    max. step allowed
  deemax    max. fraction of energy lost in a step
  epsil     tracking precision (cm)
  stmin     min. step due to continuous processes (cm)

  ifield = 0 if no magnetic field; ifield = -1 if user decision in guswim;
  ifield = 1 if tracking performed with g3rkuta; ifield = 2 if tracking
  performed with g3helix; ifield = 3 if tracking performed with g3helx3.

 Create a node called <name_nr> pointing to the volume called <name>
 as daughter of the volume called <mother> (gspos). The relative matrix is
 made of : a translation (x,y,z) and a rotation matrix named <matIROT>.
 In case npar>0, create the volume to be positioned in mother, according
 its actual parameters (gsposp).
  NAME   Volume name
  NUMBER Copy number of the volume
  MOTHER Mother volume name
  X      X coord. of the volume in mother ref. sys.
  Y      Y coord. of the volume in mother ref. sys.
  Z      Z coord. of the volume in mother ref. sys.
  IROT   Rotation matrix number w.r.t. mother ref. sys.
  ISONLY ONLY/MANY flag

 Create a node called <name_nr> pointing to the volume called <name>
 as daughter of the volume called <mother> (gspos). The relative matrix is
 made of : a translation (x,y,z) and a rotation matrix named <matIROT>.
 In case npar>0, create the volume to be positioned in mother, according
 its actual parameters (gsposp).
  NAME   Volume name
  NUMBER Copy number of the volume
  MOTHER Mother volume name
  X      X coord. of the volume in mother ref. sys.
  Y      Y coord. of the volume in mother ref. sys.
  Z      Z coord. of the volume in mother ref. sys.
  IROT   Rotation matrix number w.r.t. mother ref. sys.
  ISONLY ONLY/MANY flag

 Create a volume in GEANT3 style.
  NAME   Volume name
  SHAPE  Volume type
  NMED   Tracking medium number
  NPAR   Number of shape parameters
  UPAR   Vector containing shape parameters

 Create a volume in GEANT3 style.
  NAME   Volume name
  SHAPE  Volume type
  NMED   Tracking medium number
  NPAR   Number of shape parameters
  UPAR   Vector containing shape parameters

 Assigns uid's for all materials,media and matrices.

 Reset all attributes to default ones. Default attributes for visualization
 are those defined before closing the geometry.

 Closing geometry implies checking the geometry validity, fixing shapes
 with negative parameters (run-time shapes)building the cache manager,
 voxelizing all volumes, counting the total number of physical nodes and
 registring the manager class to the browser.

 Clear the list of overlaps.

 Remove a shape from the list of shapes.

 Clean temporary volumes and shapes from garbage collection.

 Change current path to point to the node having this id.
 Node id has to be in range : 0 to fNNodes-1 (no check for performance reasons)

 Get the unique ID of the current node.

 Make top level node the current node. Updates the cache accordingly.
 Determine the overlapping state of current node.

 Go one level up in geometry. Updates cache accordingly.
 Determine the overlapping state of current node.

 Make a daughter of current node current. Can be called only with a valid
 daughter index (no check). Updates cache accordingly.

 Do a cd to the node found next by FindNextBoundary

 Browse the tree of nodes starting from fTopNode according to pathname.
 Changes the path accordingly.

 Check if a geometry path is valid without changing the state of the current navigator.

 Convert all reflections in geometry to normal rotations + reflected shapes.

 Count the total number of nodes starting from a volume, nlevels down.

 Set default angles for a given view.

 Draw current point in the same view.

 Draw animation of tracks

 Draw tracks over the geometry, according to option. By default, only
 primaries are drawn. See TGeoTrack::Draw() for additional options.

 Draw current path

 Draw random points in the bounding box of a volume.

 Check time of finding "Where am I" for n points.

 Geometry overlap checker based on sampling.

 Fill volume names of current branch into an array.

 Get name for given pdg code;

 Set a name for a particle having a given pdg.

 Fill node copy numbers of current branch into an array.

 Fill node copy numbers of current branch into an array.

 Retrieve cartesian and radial bomb factors.

 Return stored current matrix (global matrix of the next touched node).

 Returns current depth to which geometry is drawn.

 Returns current depth to which geometry is drawn.

 Find level of virtuality of current overlapping node (number of levels
 up having the same tracking media.

 Search the track hierarchy to find the track with the
 given id

 if 'primsFirst' is true, then:
 first tries TGeoManager::GetTrackOfId, then does a
 recursive search if that fails. this would be faster
 if the track is somehow known to be a primary

 Get track with a given ID.

 Get parent track with a given ID.

 Get index for track id, -1 if not found.

 Go upwards the tree until a non-overlaping node

 Go upwards the tree until a non-overlaping node

 Set default volume colors according to A of material

 Compute safe distance from the current point. This represent the distance
 from POINT to the closest boundary.

 Set volume attributes in G3 style.

 Set factors that will "bomb" all translations in cartesian and cylindrical coordinates.

 Set a user-defined shape as clipping for ray tracing.

 set the maximum number of visible nodes.

 make top volume visible on screen

 Assign a given node to be checked for ovelaps. Any other overlaps will be ignored.

 Set the number of points to be generated on the shape outline when checking
 for overlaps.

 set drawing mode :
 option=0 (default) all nodes drawn down to vislevel
 option=1           leaves and nodes at vislevel drawn
 option=2           path is drawn
 option=4           visibility changed

 Set visualization option (leaves only OR all volumes)

 Set density threshold. Volumes with densities lower than this become
 transparent.

 set default level down to which visualization is performed

 Sort overlaps by decreasing overlap distance. Extrusions comes first.

 Optimize voxelization type for all volumes. Save best choice in a macro.

 Parse a string boolean expression and do a syntax check. Find top
 level boolean operator and returns its type. Fill the two
 substrings to which this operator applies. The returned integer is :
 -1 : parse error
  0 : no boolean operator
  1 : union - represented as '+' in expression
  2 : difference (subtraction) - represented as '-' in expression
  3 : intersection - represented as '*' in expression.
 Paranthesys should be used to avoid ambiguites. For instance :
    A+B-C will be interpreted as (A+B)-C which is not the same as A+(B-C)
 eliminate not needed paranthesys

 Save current attributes in a macro

 Returns the deepest node containing fPoint, which must be set a priori.

 Cross next boundary and locate within current node
 The current point must be on the boundary of fCurrentNode.

 Compute distance to next boundary within STEPMAX. If no boundary is found,
 propagate current point along current direction with fStep=STEPMAX. Otherwise
 propagate with fStep=SNEXT (distance to boundary) and locate/return the next
 node.

 Find distance to next boundary and store it in fStep. Returns node to which this
 boundary belongs. If PATH is specified, compute only distance to the node to which
 PATH points. If STEPMAX is specified, compute distance only in case fSafety is smaller
 than this value. STEPMAX represent the step to be made imposed by other reasons than
 geometry (usually physics processes). Therefore in this case this method provides the
 answer to the question : "Is STEPMAX a safe step ?" returning a NULL node and filling
 fStep with a big number.
 In case frombdr=kTRUE, the isotropic safety is set to zero.
 Note : safety distance for the current point is computed ONLY in case STEPMAX is
        specified, otherwise users have to call explicitly TGeoManager::Safety() if
        they want this computed for the current point.

 Computes as fStep the distance to next daughter of the current volume.
 The point and direction must be converted in the coordinate system of the current volume.
 The proposed step limit is fStep.

 Reset current state flags.

 Returns deepest node containing current point.

 Returns deepest node containing current point.

 Computes fast normal to next crossed boundary, assuming that the current point
 is close enough to the boundary. Works only after calling FindNextBoundary.

 Computes normal vector to the next surface that will be or was already
 crossed when propagating on a straight line from a given point/direction.
 Returns the normal vector cosines in the MASTER coordinate system. The dot
 product of the normal and the current direction is positive defined.

 Checks if point (x,y,z) is still in the current node.

 Check if a new point with given coordinates is the same as the last located one.

 True if current node is in phi range

 Initialize current point and current direction vector (normalized)
 in MARS. Return corresponding node.

 Initialize current point and current direction vector (normalized)
 in MARS. Return corresponding node.

 Inspects path and all flags for the current state.

 Get path to the current node in the form /node0/node1/...

 Get total size of geometry in bytes.

 Make a default painter if none present. Returns pointer to it.

 Search for a named volume. All trailing blanks stripped.

 Fast search for a named volume. All trailing blanks stripped.

 Retreive unique id for a volume name. Return -1 if name not found.

 Find if a given material duplicates an existing one.

 Search for a named material. All trailing blanks stripped.

 Search for a named tracking medium. All trailing blanks stripped.

 Search for a tracking medium with a given ID.

 Return material at position id.

 Return index of named material.

 Randomly shoot nrays and plot intersections with surfaces for current
 top node.

 Remove material at given index.

 Sets all pointers TGeoVolume::fField to NULL. User data becomes decoupled
 from geometry. Deletion has to be managed by users.

 Restore the master volume of the geometry.

 Voxelize all non-divided volumes.

 Send "Modified" signal to painter.

 Make an TGeoArb8 volume.

 Make in one step a volume pointing to a box shape with given medium.

 Make in one step a volume pointing to a paralelipiped shape with given medium.

 Make in one step a volume pointing to a sphere shape with given medium

 Make in one step a volume pointing to a torus shape with given medium.

 Make in one step a volume pointing to a tube shape with given medium.

 Make in one step a volume pointing to a tube segment shape with given medium.

 Make in one step a volume pointing to a tube shape with given medium

 Make in one step a volume pointing to a tube shape with given medium

 Make in one step a volume pointing to a tube shape with given medium

 Make in one step a volume pointing to a tube segment shape with given medium

 Make in one step a volume pointing to a cone shape with given medium.

 Make in one step a volume pointing to a cone segment shape with given medium

 Make in one step a volume pointing to a polycone shape with given medium.

 Make in one step a volume pointing to a polygone shape with given medium.

 Make in one step a volume pointing to a TGeoTrd1 shape with given medium.

 Make in one step a volume pointing to a TGeoTrd2 shape with given medium.

 Make in one step a volume pointing to a trapezoid shape with given medium.

 Make in one step a volume pointing to a twisted trapezoid shape with given medium.

 Make a TGeoXtru-shaped volume with nz planes

 Creates an aligneable object with unique name corresponding to a path
 and adds it to the list of alignables. An optional unique ID can be
 provided, in which case PN entries can be searched fast by uid.

 Retreives an existing alignable object.

 Retreives an existing alignable object at a given index.

 Retreives an existing alignable object having a preset UID.

 Retreives number of PN entries with or without UID.

 Insert a PN entry in the sorted array of indexes.

 Make a physical node from the path pointed by an alignable object with a given name.

 Make a physical node from the path pointed by a given alignable object.

 Makes a physical node corresponding to a path. If PATH is not specified,
 makes physical node matching current modeller state.

 Refresh physical nodes to reflect the actual geometry paths after alignment
 was applied. Optionally locks physical nodes (default).

 Clear the current list of physical nodes, so that we can start over with a new list.
 If MUSTDELETE is true, delete previous nodes.

 Make an assembly of volumes.

 Make a TGeoVolumeMulti handling a list of volumes.

 Set type of exploding view (see TGeoPainter::SetExplodedView())

 Set cut phi range

 Set number of segments for approximating circles in drawing.

 Get number of segments approximating circles

 Now just a shortcut for GetElementTable.

 Returns material table. Creates it if not existing.

 Make a rectiliniar step of length fStep from current point (fPoint) on current
 direction (fDirection). If the step is imposed by geometry, is_geom flag
 must be true (default). The cross flag specifies if the boundary should be
 crossed in case of a geometry step (default true). Returns new node after step.
 Set also on boundary condition.

 shoot npoints randomly in a box of 1E-5 arround current point.
 return minimum distance to points outside

 Set the top volume and corresponding node as starting point of the geometry.

 Define different tracking media.
   printf("List of materials :\n");

   Int_t nmat = fMaterials->GetSize();
   if (!nmat) {printf(" No materials !\n"); return;}
   Int_t *media = new Int_t[nmat];
   memset(media, 0, nmat*sizeof(Int_t));
   Int_t imedia = 1;
   TGeoMaterial *mat, *matref;
   mat = (TGeoMaterial*)fMaterials->At(0);
   if (mat->GetMedia()) {
      for (Int_t i=0; i<nmat; i++) {
         mat = (TGeoMaterial*)fMaterials->At(i);
         mat->Print();
      }
      return;
   }
   mat->SetMedia(imedia);
   media[0] = imedia++;
   mat->Print();
   for (Int_t i=0; i<nmat; i++) {
      mat = (TGeoMaterial*)fMaterials->At(i);
      for (Int_t j=0; j<i; j++) {
         matref = (TGeoMaterial*)fMaterials->At(j);
         if (mat->IsEq(matref)) {
            mat->SetMedia(media[j]);
            break;
         }
         if (j==(i-1)) {
         // different material
            mat->SetMedia(imedia);
            media[i] = imedia++;
            mat->Print();
         }
      }
   }

 Check pushes and pulls needed to cross the next boundary with respect to the
 position given by FindNextBoundary. If radius is not mentioned the full bounding
 box will be sampled.

 Check the boundary errors reference file created by CheckBoundaryErrors method.
 The shape for which the crossing failed is drawn with the starting point in red
 and the extrapolated point to boundary (+/- failing push/pull) in yellow.

 Classify a given point. See TGeoChecker::CheckPoint().

 Test for shape navigation methods. Summary for test numbers:
  1: DistFromInside/Outside. Sample points inside the shape. Generate
    directions randomly in cos(theta). Compute DistFromInside and move the
    point with bigger distance. Compute DistFromOutside back from new point.
    Plot d-(d1+d2)

 Geometry checking.
 - if option contains 'o': Optional overlap checkings (by sampling and by mesh).
 - if option contains 'b': Optional boundary crossing check + timing per volume.

 STAGE 1: extensive overlap checking by sampling per volume. Stdout need to be
  checked by user to get report, then TGeoVolume::CheckOverlaps(0.01, "s") can
  be called for the suspicious volumes.
 STAGE2 : normal overlap checking using the shapes mesh - fills the list of
  overlaps.
 STAGE3 : shooting NRAYS rays from VERTEX and counting the total number of
  crossings per volume (rays propagated from boundary to boundary until
  geometry exit). Timing computed and results stored in a histo.
 STAGE4 : shooting 1 mil. random rays inside EACH volume and calling
  FindNextBoundary() + Safety() for each call. The timing is normalized by the
  number of crossings computed at stage 2 and presented as percentage.
  One can get a picture on which are the most "burned" volumes during
  transportation from geometry point of view. Another plot of the timing per
  volume vs. number of daughters is produced.

 Instanciate a TGeoChecker object and investigates the geometry according to
 option. Not implemented yet.
 check shapes first

 Check all geometry for illegal overlaps within a limit OVLP.

 Prints the current list of overlaps.

 Estimate weight of volume VOL with a precision SIGMA(W)/W better than PRECISION.
 Option can be "v" - verbose (default)

 computes the total size in bytes of the branch starting with node.
 The option can specify if all the branch has to be parsed or only the node

 Stream an object of class TGeoManager.

 Execute mouse actions on this manager.

 Export this geometry to a file

 -Case 1: root file or root/xml file
  if filename end with ".root". The key will be named name
  By default the geometry is saved without the voxelisation info.
  Use option 'v" to save the voxelisation info.
  if filename end with ".xml" a root/xml file is produced.

 -Case 2: C++ script
  if filename end with ".C"

 -Case 3: gdml file
  if filename end with ".gdml"
  NOTE that to use this option, the PYTHONPATH must be defined like
      export PYTHONPATH=$ROOTSYS/lib:$ROOTSYS/geom/gdml

 Lock current geometry so that no other geometry can be imported.

 Unlock current geometry.

 Check lock state.

 Set verbosity level (static function).
 0 - suppress messages related to geom-painter visibility level
 1 - default value

 Return current verbosity level (static function).

static function
Import a geometry from a gdml or ROOT file

 -Case 1: gdml
  if filename ends with ".gdml" the foreign geometry described with gdml
  is imported executing some python scripts in $ROOTSYS/gdml.
  NOTE that to use this option, the PYTHONPATH must be defined like
      export PYTHONPATH=$ROOTSYS/lib:$ROOTSYS/gdml

 -Case 2: root file (.root) or root/xml file (.xml)
  Import in memory from filename the geometry with key=name.
  if name="" (default), the first TGeoManager object in the file is returned.

Note that this function deletes the current gGeoManager (if one)
before importing the new object.

 Update element flags when geometry is loaded from a file.

 Initialize PNE array for fast access via index and unique-id.

 Get a temporary buffer of Int_t*

 Get a temporary buffer of Double_t*

 Get time cut for drawing tracks.

 Set time cut interval for drawing tracks. If called with no arguments, time
 cut will be disabled.

 Convert coordinates from master volume frame to top.

 Convert coordinates from top volume frame to master.

--- private methods

--- visualization settings

--- list getters

--- point/vector reference frame conversion

   TGeoShape             *GetShape(const char *name) const;

   void                   SetCache(const TGeoNodeCache *cache) {fCache = (TGeoNodeCache*)cache;}

--- stack manipulation