class TGeometry: public TNamed

                    T G E O M E T R Y  description


    The Geometry class describes the geometry of a detector.
    The current implementation supports the GEANT3 style description.
    A special program provided in the ROOT utilities (toroot) can be used
    to automatically translate a GEANT detector geometry into a ROOT geometry.

   a Geometry object is entered into the list of geometries into the
     ROOT main object (see TROOT description) when the TGeometry
     constructor is invoked.
   Several geometries may coexist in memory.

   A Geometry object consist of the following linked lists:
        - the TMaterial list (material definition only).
        - the TRotmatrix list (Rotation matrices definition only).
        - the TShape list (volume definition only).
        - the TNode list assembling all detector elements.

   Only the Build and Draw functions for a geometry are currently supported.


  The conversion program from Geant to Root has been added in the list
  of utilities in utils directory.(see g2root)
  The executable module of g2root can be found in $ROOTSYS/bin/g2root.

  To use this conversion program, type the shell command:
        g2root  geant_rzfile macro_name

  for example
        g2root na49.geom na49.C
  will convert the GEANT RZ file na49.geom into a ROOT macro na49.C

  To generate the Geometry structure within Root, do:
    Root > .x na49.C
    Root > na49.Draw()
    Root > wh.x3d()    (this invokes the 3-d Root viewver)
    Root > TFile gna49("na49.root","NEW")  //open a new root file
    Root > na49.Write()                    //Write the na49 geometry structure
    Root > gna49.Write()                   //Write all keys (in this case only one)
  Note: all keys are also written on closing of the file, gna49.Close or
  when the program exits, Root closes all open files correctly.
  Once this file has been written, in a subsequent session, simply do:
    Root > TFile gna49("na49.root")
    Root > na49.Draw()

  The figure below shows the geometry above using the x3d viewer.
  This x3d viewver is invoked by selecting "View x3d" in the View menu
  of a canvas (See example of this tool bar in TCanvas).
/* */ 







Function Members (Methods)


public:



TGeometry()


TGeometry(const char* name, const char* title)


 virtual~TGeometry()


voidTObject::AbstractMethod(const char* method) const


virtual voidTObject::AppendPad(Option_t* option = "")


virtual voidBrowse(TBrowser* b)


virtual voidcd(const char* path = 0)


static TClass*Class()


virtual const char*TObject::ClassName() const


virtual voidTNamed::Clear(Option_t* option = "")


virtual TObject*TNamed::Clone(const char* newname = "") const


virtual Int_tTNamed::Compare(const TObject* obj) const


virtual voidTNamed::Copy(TObject& named) const


virtual voidTObject::Delete(Option_t* option = "")MENU 


virtual Int_tTObject::DistancetoPrimitive(Int_t px, Int_t py)


virtual voidDraw(Option_t* option = "")


virtual voidTObject::DrawClass() constMENU 


virtual TObject*TObject::DrawClone(Option_t* option = "") constMENU 


virtual voidTObject::Dump() constMENU 


virtual voidTObject::Error(const char* method, const char* msgfmt) const


virtual voidTObject::Execute(const char* method, const char* params, Int_t* error = 0)


virtual voidTObject::Execute(TMethod* method, TObjArray* params, Int_t* error = 0)


virtual voidTObject::ExecuteEvent(Int_t event, Int_t px, Int_t py)


virtual voidTObject::Fatal(const char* method, const char* msgfmt) const


virtual voidTNamed::FillBuffer(char*& buffer)


virtual TObject*FindObject(const char* name) const


virtual TObject*FindObject(const TObject* obj) const


Int_tGeomLevel() const


static TObjArray*Get(const char* name)


Float_tGetBomb() const


TRotMatrix*GetCurrentMatrix() const


TNode*GetCurrentNode() const


TRotMatrix*GetCurrentPosition(Double_t* x, Double_t* y, Double_t* z) const


TRotMatrix*GetCurrentPosition(Float_t* x, Float_t* y, Float_t* z) const


Bool_tGetCurrentReflection() const


virtual Option_t*TObject::GetDrawOption() const


static Long_tTObject::GetDtorOnly()


virtual const char*TObject::GetIconName() const


THashList*GetListOfMaterials() const


THashList*GetListOfMatrices() const


TList*GetListOfNodes() const


THashList*GetListOfShapes() const


TMaterial*GetMaterial(const char* name) const


TMaterial*GetMaterialByNumber(Int_t number) const


virtual const char*TNamed::GetName() const


TNode*GetNode(const char* name) const


virtual char*TObject::GetObjectInfo(Int_t px, Int_t py) const


static Bool_tTObject::GetObjectStat()


virtual Option_t*TObject::GetOption() const


TRotMatrix*GetRotMatrix(const char* name) const


TRotMatrix*GetRotMatrixByNumber(Int_t number) const


TShape*GetShape(const char* name) const


TShape*GetShapeByNumber(Int_t number) const


virtual const char*TNamed::GetTitle() const


virtual UInt_tTObject::GetUniqueID() const


virtual Bool_tTObject::HandleTimer(TTimer* timer)


virtual ULong_tTNamed::Hash() const


virtual voidTObject::Info(const char* method, const char* msgfmt) const


virtual Bool_tTObject::InheritsFrom(const char* classname) const


virtual Bool_tTObject::InheritsFrom(const TClass* cl) const


virtual voidTObject::Inspect() constMENU 


voidTObject::InvertBit(UInt_t f)


virtual TClass*IsA() const


virtual Bool_tTObject::IsEqual(const TObject* obj) const


virtual Bool_tIsFolder() const


Bool_tTObject::IsOnHeap() const


virtual Bool_tTNamed::IsSortable() const


Bool_tTObject::IsZombie() const


virtual voidLocal2Master(Double_t* local, Double_t* master)


virtual voidLocal2Master(Float_t* local, Float_t* master)


virtual voidls(Option_t* option = "rsn2") const


virtual voidMaster2Local(Double_t* master, Double_t* local)


virtual voidMaster2Local(Float_t* master, Float_t* local)


voidTObject::MayNotUse(const char* method) const


virtual voidNode(const char* name, const char* title, const char* shapename, Double_t x = 0, Double_t y = 0, Double_t z = 0, const char* matrixname = "", Option_t* option = "")


virtual Bool_tTObject::Notify()


static voidTObject::operator delete(void* ptr)


static voidTObject::operator delete(void* ptr, void* vp)


static voidTObject::operator delete[](void* ptr)


static voidTObject::operator delete[](void* ptr, void* vp)


void*TObject::operator new(size_t sz)


void*TObject::operator new(size_t sz, void* vp)


void*TObject::operator new[](size_t sz)


void*TObject::operator new[](size_t sz, void* vp)


virtual voidTObject::Paint(Option_t* option = "")


virtual voidTObject::Pop()


virtual Int_tPopLevel()


virtual voidTNamed::Print(Option_t* option = "") const


virtual Int_tPushLevel()


virtual Int_tTObject::Read(const char* name)


virtual voidRecursiveRemove(TObject* obj)


voidTObject::ResetBit(UInt_t f)


virtual voidTObject::SaveAs(const char* filename = "", Option_t* option = "") constMENU 


virtual voidTObject::SavePrimitive(basic_ostream<char,char_traits<char> >& out, Option_t* option = "")


voidTObject::SetBit(UInt_t f)


voidTObject::SetBit(UInt_t f, Bool_t set)


virtual voidSetBomb(Float_t bomb = 1.4)


virtual voidSetCurrentNode(TNode* node)


virtual voidTObject::SetDrawOption(Option_t* option = "")MENU 


static voidTObject::SetDtorOnly(void* obj)


virtual voidSetGeomLevel(Int_t level = 0)


virtual voidSetMatrix(TRotMatrix* matrix = 0)


virtual voidTNamed::SetName(const char* name)MENU 


virtual voidTNamed::SetNameTitle(const char* name, const char* title)


static voidTObject::SetObjectStat(Bool_t stat)


virtual voidSetPosition(Double_t x, Double_t y, Double_t z)


virtual voidSetPosition(Float_t x, Float_t y, Float_t z)


virtual voidSetPosition(TRotMatrix* matrix, Double_t x = 0, Double_t y = 0, Double_t z = 0)


virtual voidSetPosition(TRotMatrix* matrix, Float_t x, Float_t y, Float_t z)


virtual voidTNamed::SetTitle(const char* title = "")MENU 


virtual voidTObject::SetUniqueID(UInt_t uid)


virtual voidShowMembers(TMemberInspector& insp, char* parent)


virtual Int_tTNamed::Sizeof() const


virtual voidStreamer(TBuffer& b)


voidStreamerNVirtual(TBuffer& b)


virtual voidTObject::SysError(const char* method, const char* msgfmt) const


Bool_tTObject::TestBit(UInt_t f) const


Int_tTObject::TestBits(UInt_t f) const


virtual voidUpdateMatrix(TNode* node)


virtual voidUpdateTempMatrix(Double_t x = 0, Double_t y = 0, Double_t z = 0, TRotMatrix* matrix = 0)


virtual voidUpdateTempMatrix(Double_t x, Double_t y, Double_t z, Double_t* matrix, Bool_t isReflection = kFALSE)


static voidUpdateTempMatrix(Double_t* dx1, Double_t* rmat1, Double_t x, Double_t y, Double_t z, Double_t* matrix, Double_t* dxnew, Double_t* rmatnew)


virtual voidTObject::UseCurrentStyle()


virtual voidTObject::Warning(const char* method, const char* msgfmt) const


virtual Int_tTObject::Write(const char* name = 0, Int_t option = 0, Int_t bufsize = 0)


virtual Int_tTObject::Write(const char* name = 0, Int_t option = 0, Int_t bufsize = 0) const





protected:



TGeometry(const TGeometry&)


virtual voidTObject::DoError(int level, const char* location, const char* fmt, va_list va) const


voidTObject::MakeZombie()


TGeometry&operator=(const TGeometry&)










Data Members


public:



enum TObject::EStatusBits { kCanDelete


kMustCleanup


kObjInCanvas


kIsReferenced


kHasUUID


kCannotPick


kNoContextMenu


kInvalidObject


};


enum TObject::[unnamed] { kIsOnHeap


kNotDeleted


kZombie


kBitMask


kSingleKey


kOverwrite


kWriteDelete


};





protected:



TStringTNamed::fNameobject identifier


TStringTNamed::fTitleobject title





private:



Float_tfBombBomb factor for exploded geometry


TNode*fCurrentNode!Pointer to current node


Int_tfGeomLevel!


Bool_tfIsReflection[20]!


TMaterial**fMaterialPointer!Pointers to materials


THashList*fMaterials->Collection of materials


THashList*fMatrices->Collection of rotation matrices


TRotMatrix*fMatrix!Pointers to current rotation matrices


TRotMatrix**fMatrixPointer!Pointers to rotation matrices


TList*fNodes->Collection of nodes


Double_tfRotMatrix[20][9]!


TShape**fShapePointer!Pointers to shapes


THashList*fShapes->Collection of shapes


Double_tfTranslation[20][3]!


Double_tfX!


Double_tfY! The global translation of the current node


Double_tfZ!







Class Charts

























Inheritance
Inherited Members
Includes
Libraries



Class Charts


Function documentation


 TGeometry(const TGeometry& )


 Geometry default constructor.





 TGeometry(const char* name, const char* title)


 Geometry normal constructor.





 TGeometry(const TGeometry& )


copy constructor





TGeometry& operator=(const TGeometry& )


assignement operator





 ~TGeometry()


 Geometry default destructor.





void Browse(TBrowser* b)


 Browse.





void cd(const char* path = 0)


 Change Current Geometry to this.





void Draw(Option_t* option = "")


 Draw this Geometry.





TObject * FindObject(const TObject *)


 Find object in a geometry node, material, etc





TObject * FindObject(const char *name)


 Search object identified by name in the geometry tree





TObjArray * Get(const char* name)


 Static function called by TROOT to search name in the geometry.
 Returns a TObjArray containing a pointer to the found object
 and a pointer to the container where the object was found.





TMaterial * GetMaterial(const char* name) const


 Return pointer to Material with name.





TMaterial * GetMaterialByNumber(Int_t number) const


 Return pointer to Material with number.





TNode * GetNode(const char* name) const


 Return pointer to node with name in the geometry tree.





TRotMatrix * GetRotMatrix(const char* name) const


 Return pointer to RotMatrix with name.





TRotMatrix * GetRotMatrixByNumber(Int_t number) const


 Return pointer to RotMatrix with number.





TShape * GetShape(const char* name) const


 Return pointer to Shape with name.





TShape * GetShapeByNumber(Int_t number) const


 Return pointer to Shape with number.





void Local2Master(Double_t *local, Double_t *master)


 Convert one point from local system to master reference system.

  Note that before invoking this function, the global rotation matrix
  and translation vector for this node must have been computed.
  This is automatically done by the Paint functions.
  Otherwise TNode::UpdateMatrix should be called before.





void Local2Master(Float_t *local, Float_t *master)


 Convert one point from local system to master reference system.

  Note that before invoking this function, the global rotation matrix
  and translation vector for this node must have been computed.
  This is automatically done by the Paint functions.
  Otherwise TNode::UpdateMatrix should be called before.





void ls(Option_t* option = "rsn2") const


 List this geometry.





void Master2Local(Double_t *master, Double_t *local)


 Convert one point from master system to local reference system.

  Note that before invoking this function, the global rotation matrix
  and translation vector for this node must have been computed.
  This is automatically done by the Paint functions.
  Otherwise TNode::UpdateMatrix should be called before.





void Master2Local(Float_t *master, Float_t *local)


 Convert one point from master system to local reference system.

  Note that before invoking this function, the global rotation matrix
  and translation vector for this node must have been computed.
  This is automatically done by the Paint functions.
  Otherwise TNode::UpdateMatrix should be called before.





void Node(const char* name, const char* title, const char* shapename, Double_t x = 0, Double_t y = 0, Double_t z = 0, const char* matrixname = "", Option_t* option = "")


 Add a node to the current node in this geometry.





void RecursiveRemove(TObject* obj)


 Recursively remove object from a Geometry list.





void Streamer(TBuffer& b)


 Stream a class object.





void UpdateMatrix(TNode* node)


 Update global rotation matrix/translation vector for this node
 this function must be called before invoking Local2Master





void UpdateTempMatrix(Double_t x = 0, Double_t y = 0, Double_t z = 0, TRotMatrix* matrix = 0)


 Update temp matrix.





void UpdateTempMatrix(Double_t x, Double_t y, Double_t z, Double_t* matrix, Bool_t isReflection = kFALSE)


 Update temp matrix.





void UpdateTempMatrix(Double_t* dx1, Double_t* rmat1, Double_t x, Double_t y, Double_t z, Double_t* matrix, Double_t* dxnew, Double_t* rmatnew)


 Compute new translation vector and global matrix.

  dx      old translation vector
  rmat    old global matrix
  x,y,z   offset of new local system with respect to mother
  dxnew   new translation vector
  rmatnew new global rotation matrix





TRotMatrix * GetCurrentMatrix()




TRotMatrix * GetCurrentPosition(Double_t *x,Double_t *y,Double_t *z)




TRotMatrix * GetCurrentPosition(Float_t *x,Float_t *y,Float_t *z)




Bool_t GetCurrentReflection()




void SetPosition(Double_t x,Double_t y,Double_t z)




void SetPosition(Float_t x,Float_t y,Float_t z)




void SetPosition(TRotMatrix *matrix, Double_t x,Double_t y,Double_t z)




void SetPosition(TRotMatrix *matrix, Float_t x,Float_t y,Float_t z)




Float_t GetBomb()



{return fBomb;}






Int_t GeomLevel()



{return fGeomLevel;}






THashList        * GetListOfShapes()



{return fShapes;}






TList            * GetListOfNodes()



{return fNodes;}






THashList        * GetListOfMaterials()



{return fMaterials;}






THashList        * GetListOfMatrices()



{return fMatrices;}






TNode            * GetCurrentNode()



{return fCurrentNode;}






Bool_t IsFolder()



{return kTRUE;}






Int_t PushLevel()



{return fGeomLevel++;}






Int_t PopLevel()



{return fGeomLevel>0?fGeomLevel--:0;}






void SetBomb(Float_t bomb = 1.4)



{fBomb = bomb;}






void SetCurrentNode(TNode* node)



{fCurrentNode = node;}






void SetGeomLevel(Int_t level = 0)



{fGeomLevel=level;}






void SetMatrix(TRotMatrix* matrix = 0)



{fMatrix = matrix;}









Author:  Rene Brun   22/09/95

Last change: root/g3d:$Id: TGeometry.h 20882 2007-11-19 11:31:26Z rdm $

Last generated: 2008-06-25 08:46

Copyright   (C) 1995-2000, Rene Brun and Fons Rademakers.               *




This page has been automatically generated. If you have any comments or suggestions about the page layout send a mail to ROOT support, or contact the developers with any questions or problems regarding ROOT.