G4Ttree_item Class Reference

Lightweight per-volume record used by GTree to populate the UI. More...

#include <gtree.h>

Public Member Functions
	G4Ttree_item (G4Volume *g4volume, const GVolume *gvolume=nullptr)
	Construct a cached record for a single geometry volume.
std::string	get_mother () const
	Return the cached mother name.
QColor	get_color () const
	Return the cached RGB color.
bool	get_visibility () const
	Return the cached visibility state.
int	get_representation () const
	Return the cached representation mode.
double	get_opacity () const
	Return the cached opacity (alpha) in [0,1].
double	get_mass () const
	Return the cached mass.
double	get_volume () const
	Return the cached volume.
double	get_density () const
	Return the cached density.
std::string	get_material () const
	Return the cached material name.
bool	get_recursive () const
	Return the cached recursive flag.
std::string	get_solidType () const
	Return the solid type string (e.g. "G4Box").
std::string	get_parameters () const
	Return the solid parameters string with units.
std::string	get_position () const
	Return the placement position string with units.
std::string	get_rotation () const
	Return the placement rotation string with units.
std::string	get_motherVolume () const
	Return the mother volume name.
std::string	get_volDescription () const
	Return the volume description.
void	set_recursive (bool recursive)
	Set the recursive flag.
void	set_color (const QColor &c)
	Update the cached color.
void	set_opacity (double opacity)
	Update the cached opacity.

Static Public Member Functions
static std::string	vname_from_v4name (std::string v4name)
	Extract the "leaf" volume name from a full volume name.
static std::string	system_from_v4name (std::string v4name)
	Extract the system name from a full volume name.

Detailed Description

This class extracts and caches a subset of geometry and visualization information from a G4Volume wrapper and the corresponding GVolume descriptor:

• hierarchy (mother logical volume name)
• material name
• computed mass/volume/density (scaled to common units)
• visualization attributes (visibility, color, opacity)
• pygemc descriptor fields (solid type, parameters, position, rotation, description)

It is intentionally small and UI-oriented: it acts as the "model" part of the widget, decoupled from Qt item instances.

Definition at line 42 of file gtree.h.

Constructor & Destructor Documentation

G4Ttree_item()

G4Ttree_item::G4Ttree_item ( G4Volume * g4volume, const GVolume * gvolume = nullptr )

explicit

Parameters

g4volume	Pointer to the volume wrapper (Geant4 solid/logical/physical).
gvolume	Optional pointer to the GEMC volume descriptor (pygemc fields). May be nullptr for volumes without a descriptor (e.g., world volume).

The constructor reads:

• The mother logical volume name (or a sentinel value for the world/root).
• The material name.
• Mass, volume, and density derived from the underlying geometry.
• Visualization color and alpha (opacity), and the visibility flag.
• Solid type, parameters, position, rotation, and description from the descriptor.

The stored "mother" name is used by GTree to reconstruct parent-child relationships when building the Qt tree.

Definition at line 182 of file gtree.cc.

Member Function Documentation

get_color()

QColor G4Ttree_item::get_color ( ) const

inline

Definition at line 149 of file gtree.h.

get_density()

double G4Ttree_item::get_density ( ) const

inline

Definition at line 167 of file gtree.h.

get_mass()

double G4Ttree_item::get_mass ( ) const

inline

Definition at line 161 of file gtree.h.

get_material()

std::string G4Ttree_item::get_material ( ) const

inline

Definition at line 170 of file gtree.h.

get_mother()

std::string G4Ttree_item::get_mother ( ) const

inline

Definition at line 146 of file gtree.h.

get_motherVolume()

std::string G4Ttree_item::get_motherVolume ( ) const

inline

Definition at line 184 of file gtree.h.

get_opacity()

double G4Ttree_item::get_opacity ( ) const

inline

Definition at line 158 of file gtree.h.

get_parameters()

std::string G4Ttree_item::get_parameters ( ) const

inline

Definition at line 178 of file gtree.h.

get_position()

std::string G4Ttree_item::get_position ( ) const

inline

Definition at line 180 of file gtree.h.

get_recursive()

bool G4Ttree_item::get_recursive ( ) const

inline

Definition at line 173 of file gtree.h.

get_representation()

int G4Ttree_item::get_representation ( ) const

inline

Definition at line 155 of file gtree.h.

get_rotation()

std::string G4Ttree_item::get_rotation ( ) const

inline

Definition at line 182 of file gtree.h.

get_solidType()

std::string G4Ttree_item::get_solidType ( ) const

inline

Definition at line 176 of file gtree.h.

get_visibility()

bool G4Ttree_item::get_visibility ( ) const

inline

Definition at line 152 of file gtree.h.

get_volDescription()

std::string G4Ttree_item::get_volDescription ( ) const

inline

Definition at line 186 of file gtree.h.

get_volume()

double G4Ttree_item::get_volume ( ) const

inline

Definition at line 164 of file gtree.h.

set_color()

void G4Ttree_item::set_color ( const QColor & c )

inline

Parameters

c	New RGB color.

This is used after a color or opacity change so that subsequent opacity changes can preserve RGB and update only alpha.

Definition at line 202 of file gtree.h.

set_opacity()

void G4Ttree_item::set_opacity ( double opacity )

inline

Parameters

opacity

New opacity (alpha) in [0,1].

Definition at line 208 of file gtree.h.

set_recursive()

void G4Ttree_item::set_recursive ( bool recursive )

inline

Parameters

recursive

New recursive state.

Definition at line 192 of file gtree.h.

system_from_v4name()

std::string G4Ttree_item::system_from_v4name ( std::string v4name )

static

Parameters

v4name

Full volume name including a system prefix separated by /.

Returns

The substring before the last /.

The returned system name is used as the top-level grouping node in the tree widget.

Definition at line 236 of file gtree.cc.

vname_from_v4name()

std::string G4Ttree_item::vname_from_v4name ( std::string v4name )

static

Parameters

v4name

Full volume name including a system prefix separated by /.

Returns

The substring after the last /.

This helper is used for display in the Qt tree so the user sees a compact name, while the full name remains stored as item metadata.

Definition at line 230 of file gtree.cc.

---

The documentation for this class was generated from the following files:

• gtree.h
• gtree.cc