library: libVMC #include "TGeoMCGeometry.h"

# TGeoMCGeometry

class description - source file - inheritance tree (.pdf)

## class TGeoMCGeometry : public TVirtualMCGeometry

| Inheritance Chart:
`TObject`
| <- | `TNamed`
| <- | `TVirtualMCGeometry`
| <- | `TGeoMCGeometry` |

        private:

                          TGeoMCGeometry(const TGeoMCGeometry& rhs)
                Double_t* CreateDoubleArray(Float_t* array, Int_t size) const
          TGeoMCGeometry& operator=(const TGeoMCGeometry&)
                     void Vname(const char* name, char* vname) const

        public:

                              TGeoMCGeometry(const char* name, const char* title, Bool_t g3CompatibleVolumeNames = false)
                              TGeoMCGeometry()
                      virtual ~TGeoMCGeometry()
               static TClass* Class()
                 virtual void Gsbool(const char*, const char*)
                 virtual void Gsdvn(const char* name, const char* mother, Int_t ndiv, Int_t iaxis)
                 virtual void Gsdvn2(const char* name, const char* mother, Int_t ndiv, Int_t iaxis, Double_t c0i, Int_t numed)
                 virtual void Gsdvt(const char* name, const char* mother, Double_t step, Int_t iaxis, Int_t numed, Int_t ndvmx)
                 virtual void Gsdvt2(const char* name, const char* mother, Double_t step, Int_t iaxis, Double_t c0, Int_t numed, Int_t ndvmx)
                 virtual void Gsord(const char* name, Int_t iax)
                 virtual void Gspos(const char* name, Int_t nr, const char* mother, Double_t x, Double_t y, Double_t z, Int_t irot, const char* konly)
                 virtual void Gsposp(const char* name, Int_t nr, const char* mother, Double_t x, Double_t y, Double_t z, Int_t irot, const char* konly, Float_t* upar, Int_t np)
                 virtual void Gsposp(const char* name, Int_t nr, const char* mother, Double_t x, Double_t y, Double_t z, Int_t irot, const char* konly, Double_t* upar, Int_t np)
                virtual Int_t Gsvolu(const char* name, const char* shape, Int_t nmed, Float_t* upar, Int_t np)
                virtual Int_t Gsvolu(const char* name, const char* shape, Int_t nmed, Double_t* upar, Int_t np)
              virtual TClass* IsA() const
                 virtual void Material(Int_t& kmat, const char* name, Double_t a, Double_t z, Double_t dens, Double_t radl, Double_t absl, Float_t* buf, Int_t nwbuf)
                 virtual void Material(Int_t& kmat, const char* name, Double_t a, Double_t z, Double_t dens, Double_t radl, Double_t absl, Double_t* buf, Int_t nwbuf)
                 virtual void Matrix(Int_t& krot, Double_t thetaX, Double_t phiX, Double_t thetaY, Double_t phiY, Double_t thetaZ, Double_t phiZ)
                 virtual void Medium(Int_t& kmed, const char* name, Int_t nmat, Int_t isvol, Int_t ifield, Double_t fieldm, Double_t tmaxfd, Double_t stemax, Double_t deemax, Double_t epsil, Double_t stmin, Float_t* ubuf, Int_t nbuf)
                 virtual void Medium(Int_t& kmed, const char* name, Int_t nmat, Int_t isvol, Int_t ifield, Double_t fieldm, Double_t tmaxfd, Double_t stemax, Double_t deemax, Double_t epsil, Double_t stmin, Double_t* ubuf, Int_t nbuf)
                 virtual void Mixture(Int_t& kmat, const char* name, Float_t* a, Float_t* z, Double_t dens, Int_t nlmat, Float_t* wmat)
                 virtual void Mixture(Int_t& kmat, const char* name, Double_t* a, Double_t* z, Double_t dens, Int_t nlmat, Double_t* wmat)
                virtual Int_t NofVolDaughters(const char* volName) const
                virtual Int_t NofVolumes() const
                 virtual void ShowMembers(TMemberInspector& insp, char* parent)
                 virtual void Streamer(TBuffer& b)
                         void StreamerNVirtual(TBuffer& b)
                virtual Int_t VolDaughterCopyNo(const char* volName, Int_t i) const
          virtual const char* VolDaughterName(const char* volName, Int_t i) const
                virtual Int_t VolId(const Text_t* volName) const
                virtual Int_t VolId2Mate(Int_t id) const
          virtual const char* VolName(Int_t id) const

### Data Members

        private:

                          Bool_t fG3CompatibleVolumeNames  option to convert volumes names to
          static TGeoMCGeometry* fgInstance                singleton instance

## Class Description

     Implementation of the TVirtualMCGeometry interface
     for building TGeo geometry.
    ______________________________________________________________________________

TGeoMCGeometry(const char *name, const char *title, Bool_t g3CompatibleVolumeNames) : TVirtualMCGeometry(name, title), fG3CompatibleVolumeNames(g3CompatibleVolumeNames)

     Standard constructor

TGeoMCGeometry() : TVirtualMCGeometry(), fG3CompatibleVolumeNames(kFALSE)

     Default constructor

~TGeoMCGeometry()

     Destructor

TGeoMCGeometry(const TGeoMCGeometry &geom) : TVirtualMCGeometry(geom)

     Copy constructor

Double_t* CreateDoubleArray(Float_t* array, Int_t size) const

     Converts Float_t* array to Double_t*,
     !! The new array has to be deleted by user.
     ---

void Vname(const char *name, char *vname) const

      convert name to upper case. Make vname at least 4 chars

void Material(Int_t& kmat, const char* name, Double_t a, Double_t z, Double_t dens, Double_t radl, Double_t absl, Float_t* buf, Int_t nwbuf)

     Defines a Material

      kmat               number assigned to the material
      name               material name
      a                  atomic mass in au
      z                  atomic number
      dens               density in g/cm3
      absl               absorbtion length in cm
                         if >=0 it is ignored and the program
                         calculates it, if <0. -absl is taken
      radl               radiation length in cm
                         if >=0 it is ignored and the program
                         calculates it, if <0. -radl is taken
      buf                pointer to an array of user words
      nbuf               number of user words

void Material(Int_t& kmat, const char* name, Double_t a, Double_t z, Double_t dens, Double_t radl, Double_t absl, Double_t* /*buf*/, Int_t /*nwbuf*/)

     Defines a Material

      kmat               number assigned to the material
      name               material name
      a                  atomic mass in au
      z                  atomic number
      dens               density in g/cm3
      absl               absorbtion length in cm
                         if >=0 it is ignored and the program
                         calculates it, if <0. -absl is taken
      radl               radiation length in cm
                         if >=0 it is ignored and the program
                         calculates it, if <0. -radl is taken
      buf                pointer to an array of user words
      nbuf               number of user words

void Mixture(Int_t& kmat, const char* name, Float_t* a, Float_t* z, Double_t dens, Int_t nlmat, Float_t* wmat)

     Defines mixture OR COMPOUND IMAT as composed by
     THE BASIC NLMAT materials defined by arrays A,Z and WMAT

     If NLMAT > 0 then wmat contains the proportion by
     weights of each basic material in the mixture.

     If nlmat < 0 then WMAT contains the number of atoms
     of a given kind into the molecule of the COMPOUND
     In this case, WMAT in output is changed to relative
     weigths.

void Mixture(Int_t& kmat, const char* name, Double_t* a, Double_t* z, Double_t dens, Int_t nlmat, Double_t* wmat)

     Defines mixture OR COMPOUND IMAT as composed by
     THE BASIC NLMAT materials defined by arrays A,Z and WMAT

     If NLMAT > 0 then wmat contains the proportion by
     weights of each basic material in the mixture.

     If nlmat < 0 then WMAT contains the number of atoms
     of a given kind into the molecule of the COMPOUND
     In this case, WMAT in output is changed to relative
     weigths.

void Medium(Int_t& kmed, const char* name, Int_t nmat, Int_t isvol, Int_t ifield, Double_t fieldm, Double_t tmaxfd, Double_t stemax, Double_t deemax, Double_t epsil, Double_t stmin, Float_t* ubuf, Int_t nbuf)

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

void Medium(Int_t& kmed, const char* name, Int_t nmat, Int_t isvol, Int_t ifield, Double_t fieldm, Double_t tmaxfd, Double_t stemax, Double_t deemax, Double_t epsil, Double_t stmin, Double_t* /*ubuf*/, Int_t /*nbuf*/)

      kmed      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 continuos 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.

void Matrix(Int_t& krot, Double_t thex, Double_t phix, Double_t they, Double_t phiy, Double_t thez, Double_t phiz)

      krot     rotation matrix number assigned
      theta1   polar angle for axis i
      phi1     azimuthal angle for axis i
      theta2   polar angle for axis ii
      phi2     azimuthal angle for axis ii
      theta3   polar angle for axis iii
      phi3     azimuthal angle for axis iii

      it defines the rotation matrix number irot.

Int_t Gsvolu(const char *name, const char *shape, Int_t nmed, Float_t *upar, Int_t npar)

      NAME   Volume name
      SHAPE  Volume type
      NUMED  Tracking medium number
      NPAR   Number of shape parameters
      UPAR   Vector containing shape parameters

      It creates a new volume in the JVOLUM data structure.

Int_t Gsvolu(const char *name, const char *shape, Int_t nmed, Double_t *upar, Int_t npar)

      NAME   Volume name
      SHAPE  Volume type
      NUMED  Tracking medium number
      NPAR   Number of shape parameters
      UPAR   Vector containing shape parameters

      It creates a new volume in the JVOLUM data structure.

void Gsdvn(const char *name, const char *mother, Int_t ndiv, Int_t iaxis)

     Create a new volume by dividing an existing one

      NAME   Volume name
      MOTHER Mother volume name
      NDIV   Number of divisions
      IAXIS  Axis value

      X,Y,Z of CAXIS will be translated to 1,2,3 for IAXIS.
      It divides a previously defined volume.

void Gsdvn2(const char *name, const char *mother, Int_t ndiv, Int_t iaxis, Double_t c0i, Int_t numed)

     Create a new volume by dividing an existing one

     Divides mother into ndiv divisions called name
     along axis iaxis starting at coordinate value c0.
     the new volume created will be medium number numed.

void Gsdvt(const char *name, const char *mother, Double_t step, Int_t iaxis, Int_t numed, Int_t /*ndvmx*/)

     Create a new volume by dividing an existing one

           Divides MOTHER into divisions called NAME along
           axis IAXIS in steps of STEP. If not exactly divisible
           will make as many as possible and will centre them
           with respect to the mother. Divisions will have medium
           number NUMED. If NUMED is 0, NUMED of MOTHER is taken.
           NDVMX is the expected maximum number of divisions
              (If 0, no protection tests are performed)

void Gsdvt2(const char *name, const char *mother, Double_t step, Int_t iaxis, Double_t c0, Int_t numed, Int_t /*ndvmx*/)

     Create a new volume by dividing an existing one

               Divides MOTHER into divisions called NAME along
                axis IAXIS starting at coordinate value C0 with step
                size STEP.
               The new volume created will have medium number NUMED.
               If NUMED is 0, NUMED of mother is taken.
               NDVMX is the expected maximum number of divisions
                 (If 0, no protection tests are performed)

void Gsord(const char * /*name*/, Int_t /*iax*/)

        Flags volume CHNAME whose contents will have to be ordered
        along axis IAX, by setting the search flag to -IAX
               IAX = 1    X axis
               IAX = 2    Y axis
               IAX = 3    Z axis
               IAX = 4    Rxy (static ordering only  -> GTMEDI)
               IAX = 14   Rxy (also dynamic ordering -> GTNEXT)
               IAX = 5    Rxyz (static ordering only -> GTMEDI)
               IAX = 15   Rxyz (also dynamic ordering -> GTNEXT)
               IAX = 6    PHI   (PHI=0 => X axis)
               IAX = 7    THETA (THETA=0 => Z axis)

void Gspos(const char *name, Int_t nr, const char *mother, Double_t x, Double_t y, Double_t z, Int_t irot, const char *konly)

     Position a volume into an existing one

      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.
      ONLY   ONLY/MANY flag

      It positions a previously defined volume in the mother.

void Gsposp(const char *name, Int_t nr, const char *mother, Double_t x, Double_t y, Double_t z, Int_t irot, const char *konly, Float_t *upar, Int_t np )

          Place a copy of generic volume NAME with user number
          NR inside MOTHER, with its parameters UPAR(1..NP)

void Gsposp(const char *name, Int_t nr, const char *mother, Double_t x, Double_t y, Double_t z, Int_t irot, const char *konly, Double_t *upar, Int_t np )

          Place a copy of generic volume NAME with user number
          NR inside MOTHER, with its parameters UPAR(1..NP)

Int_t VolId(const Text_t *name) const

     Return the unique numeric identifier for volume name

const char* VolName(Int_t id) const

     Return the volume name given the volume identifier

Int_t NofVolumes() const

     Return total number of volumes in the geometry

Int_t NofVolDaughters(const char* volName) const

     Return number of daughters of the volume specified by volName
     According to A. Morsch' G3toRoot class (by A. Morsch)
     ---

const char* VolDaughterName(const char* volName, Int_t i) const

     Return the name of i-th daughters of the volume specified by volName
     According to A. Morsch' G3toRoot class.
     ---

Int_t VolDaughterCopyNo(const char* volName, Int_t i) const

     Return the copyNo of i-th daughters of the volume specified by volName
     According to A. Morsch' G3toRoot class.
     ---

Int_t VolId2Mate(Int_t id) const

     Return material number for a given volume id

### Inline Functions

                       void Gsbool(const char*, const char*)
            TGeoMCGeometry& operator=(const TGeoMCGeometry&)
                    TClass* Class()
                    TClass* IsA() const
                       void ShowMembers(TMemberInspector& insp, char* parent)
                       void Streamer(TBuffer& b)
                       void StreamerNVirtual(TBuffer& b)

Last update: root/mc:$Name: $:$Id: TGeoMCGeometry.cxx,v 1.5 2004/10/12 07:45:54 brun Exp $