CSGUniverse creates an internal representation of a Constructive Solid Geometry (CSG) universe, which represents a collection of cells that can be defined repeatedly within a separate container of cells. More...

#include <CSGUniverse.h>

Inheritance diagram for CSG::CSGUniverse:

[legend]

Public Member Functions
	CSGUniverse (const std::string &name, bool is_root=false)
	Construct a new CSGUniverse object.

	CSGUniverse (const std::string &name, std::vector< CSGCell * > &cells, bool is_root=false)
	Construct a new CSGUniverse object from list of cells.

virtual	~CSGUniverse ()=default
	Destructor.

const CSGCell &	getCell (const std::string &name)
	Get the CSGCell object by name.

bool	hasCell (const std::string &name) const
	check if cell of provided name is present in universe

const std::vector< std::reference_wrapper< const CSGCell > > &	getAllCells () const
	Get list of the all cells in the universe.

const std::string &	getName () const
	Get the name of the universe.

bool	isRoot () const
	return true if the universe is the root universe

virtual bool	isEngUnit () const
	Whether this universe is an engineering unit.

bool	operator== (const CSGUniverse &other) const
	Operator overload for checking if two CSGUniverse objects are equal.

bool	operator!= (const CSGUniverse &other) const
	Operator overload for checking if two CSGUniverse objects are not equal.

const std::vector< std::pair< TransformationType, std::tuple< Real, Real, Real > > > &	getTransformations () const
	Get the list of transformations.

std::vector< std::pair< std::string, std::tuple< Real, Real, Real > > >	getTransformationsAsStrings () const
	Get the transformations of this object with string representations for types.

Static Public Member Functions
static bool	isValidTransformationValue (TransformationType type, const std::tuple< Real, Real, Real > &values)
	Check if the transformation value is valid for the given type.

static std::string	getTransformationTypeString (TransformationType type)
	Get the string representation of the transformation type.

Protected Member Functions
void	addCell (const CSGCell &cell)
	add cell to universe

void	removeCell (const std::string &name)
	remove a cell of the specified name from the universe

void	removeAllCells ()
	remove all cells from the universe

void	setName (const std::string &name)

void	addTransformation (TransformationType type, const std::tuple< Real, Real, Real > &values)
	Add a transformation to the list of transformations.

Point	applyReverseTransformsToPoint (Point p) const
	update the value of point p by applying the inverse of the list of transformations to the point


	FRIEND_TEST (CSGUniverseTest, testGetCell)
	Friends for unit testing.

	FRIEND_TEST (CSGUniverseTest, testAddCell)

	FRIEND_TEST (CSGUniverseTest, testRemoveCell)

	FRIEND_TEST (CSGUniverseTest, testRemoveAllCells)

	FRIEND_TEST (CSGUniverseTest, testSetName)

	FRIEND_TEST (CSGUniverseTest, testUniverseEquality)


	FRIEND_TEST (CSGSurfaceTest, testHalfspaceWithTransform)
	Friends for unit testing.

	FRIEND_TEST (CSGSurfaceTest, testHalfspaceWithNullTransform)

	FRIEND_TEST (CSGEngUnitTest, testEngUnitEqual)

Protected Attributes
std::string	_name
	Name of universe.

std::vector< std::reference_wrapper< const CSGCell > >	_cells
	list of references to cells in universe

bool	_is_root
	whether or not this universe is the root universe

std::vector< std::pair< TransformationType, std::tuple< Real, Real, Real > > >	_transformations
	List of transformations applied to this object.

Friends
class	CSGUniverseList

class	CSGBase

Detailed Description

CSGUniverse creates an internal representation of a Constructive Solid Geometry (CSG) universe, which represents a collection of cells that can be defined repeatedly within a separate container of cells.

Definition at line 27 of file CSGUniverse.h.

Constructor & Destructor Documentation

◆ CSGUniverse() [1/2]

CSG::CSGUniverse::CSGUniverse	(	const std::string &	name,
		bool	is_root = `false`
	)

Construct a new CSGUniverse object.

Parameters

name	unique name of universe
is_root	true to set universe as the root universe (default false)

Definition at line 18 of file CSGUniverse.C.

18: _name(name), _is_root(is_root) {}

CSG::CSGUniverse::_is_root

bool _is_root

whether or not this universe is the root universe

Definition CSGUniverse.h:137

CSG::CSGUniverse::_name

std::string _name

Name of universe.

Definition CSGUniverse.h:131

◆ CSGUniverse() [2/2]

CSG::CSGUniverse::CSGUniverse	(	const std::string &	name,
		std::vector< CSGCell * > &	cells,
		bool	is_root = `false`
	)

Construct a new CSGUniverse object from list of cells.

Parameters

name	unique name of universe
cells	list of cells to add to universe
is_root	true to set universe as the root universe (default false)

Definition at line 20 of file CSGUniverse.C.

  : _name(name), _is_root(is_root)
{
  CSGUtils::checkValidCSGName(name);
  for (auto cell : cells)
    addCell(*cell);
}

◆ ~CSGUniverse()

virtual CSG::CSGUniverse::~CSGUniverse ( )

virtualdefault

Destructor.

Member Function Documentation

◆ addCell()

void CSG::CSGUniverse::addCell ( const CSGCell & cell )

protected

add cell to universe

Parameters

reference to cell to add

Definition at line 29 of file CSGUniverse.C.

{
  auto cell_name = cell.getName();
  if (!hasCell(cell_name))
    _cells.push_back(cell);
  else
    mooseWarning("Universe " + getName() + " already contains a cell by name " + cell_name + ". " +
                 "Skipping cell insertion for cell with duplicate name.");
}

Referenced by CSG::CSGBase::addCellToUniverse(), and CSGUniverse().

◆ addTransformation()

void CSG::CSGTransformationHelper::addTransformation	(	TransformationType	type,
		const std::tuple< Real, Real, Real > &	values
	)

protectedinherited

Add a transformation to the list of transformations.

Parameters

type	The type of transformation
values	The values for the transformation

Definition at line 16 of file CSGTransformationHelper.C.

{
  if (!isValidTransformationValue(type, values))
    mooseError("Invalid transformation values provided for transformation type " +
               getTransformationTypeString(type));
  _transformations.emplace_back(type, values);
}

Referenced by CSG::CSGBase::addTransformation(), CSG::CSGBase::expandEngUnit(), CSG::CSGBase::expandEngUnit(), and CSG::CSGBase::expandEngUnit().

◆ applyReverseTransformsToPoint()

Point CSG::CSGTransformationHelper::applyReverseTransformsToPoint ( Point p ) const

protectedinherited

update the value of point p by applying the inverse of the list of transformations to the point

Parameters

p	point to transform

Returns: transformed point

Definition at line 74 of file CSGTransformationHelper.C.

{
  // iterate list of transformations in reverse and apply the inverse operation
  for (auto it = _transformations.rbegin(); it != _transformations.rend(); ++it)
  {
    auto trans_type = it->first;
    auto val = it->second;
 
    if (trans_type == TransformationType::TRANSLATION)
    {
      Point offset(std::get<0>(val), std::get<1>(val), std::get<2>(val));
      p -= offset;
    }
    else if (trans_type == TransformationType::SCALE)
    {
      Point scale(std::get<0>(val), std::get<1>(val), std::get<2>(val));
      for (int i = 0; i < 3; ++i)
        p(i) /= scale(i);
    }
    else if (trans_type == TransformationType::ROTATION)
    {
      // get the transpose of the original rotation matrix and apply to point p
      const auto rot_matrix = RealTensorValue::intrinsic_rotation_matrix(
          std::get<0>(val), std::get<1>(val), std::get<2>(val));
      const auto rot_transpose = rot_matrix.transpose();
      p = rot_transpose * p;
    }
    else
      mooseError("Transformation type is not recognized.");
  }
  return p;
}

Referenced by CSG::CSGSurface::getHalfspaceFromPoint().

◆ FRIEND_TEST() [1/9]

CSG::CSGTransformationHelper::FRIEND_TEST	(	CSGEngUnitTest	,
		testEngUnitEqual
	)

protectedinherited

◆ FRIEND_TEST() [2/9]

CSG::CSGTransformationHelper::FRIEND_TEST	(	CSGSurfaceTest	,
		testHalfspaceWithNullTransform
	)

protectedinherited

◆ FRIEND_TEST() [3/9]

CSG::CSGTransformationHelper::FRIEND_TEST	(	CSGSurfaceTest	,
		testHalfspaceWithTransform
	)

protectedinherited

Friends for unit testing.

◆ FRIEND_TEST() [4/9]

CSG::CSGUniverse::FRIEND_TEST	(	CSGUniverseTest	,
		testAddCell
	)

protected

◆ FRIEND_TEST() [5/9]

CSG::CSGUniverse::FRIEND_TEST	(	CSGUniverseTest	,
		testGetCell
	)

protected

Friends for unit testing.

◆ FRIEND_TEST() [6/9]

CSG::CSGUniverse::FRIEND_TEST	(	CSGUniverseTest	,
		testRemoveAllCells
	)

protected

◆ FRIEND_TEST() [7/9]

CSG::CSGUniverse::FRIEND_TEST	(	CSGUniverseTest	,
		testRemoveCell
	)

protected

◆ FRIEND_TEST() [8/9]

CSG::CSGUniverse::FRIEND_TEST	(	CSGUniverseTest	,
		testSetName
	)

protected

◆ FRIEND_TEST() [9/9]

CSG::CSGUniverse::FRIEND_TEST	(	CSGUniverseTest	,
		testUniverseEquality
	)

protected

◆ getAllCells()

const std::vector< std::reference_wrapper< const CSGCell > > & CSG::CSGUniverse::getAllCells ( ) const

inline

Get list of the all cells in the universe.

Returns: list of pointers to cells in universe

Definition at line 73 of file CSGUniverse.h.

73{ return _cells; }

Referenced by CSG::CSGBase::addUniverseToList(), CSG::CSGBase::CSGBase(), CSG::CSGBase::getLinkedUniverses(), operator==(), and CSG::CSGBase::replaceCellRefs().

◆ getCell()

const CSGCell & CSG::CSGUniverse::getCell ( const std::string & name )

Get the CSGCell object by name.

Parameters

name	name of cell

Returns: reference to the cell of the specified name in this universe

Definition at line 40 of file CSGUniverse.C.

{
  if (!hasCell(name))
    mooseError("Cell with name " + name + " does not exist in universe " + _name + ".");
  for (const CSGCell & cell : _cells)
    if (cell.getName() == name)
      return cell;
  mooseError("Should not reach here.");
}

◆ getName()

const std::string & CSG::CSGUniverse::getName ( ) const

inline

Get the name of the universe.

Returns: name of universe

Definition at line 80 of file CSGUniverse.h.

80{ return _name; }

Referenced by addCell(), CSG::CSGBase::addCellToUniverse(), CSG::CSGBase::addLattice(), CSG::CSGBase::addTransformation(), CSG::CSGUniverseList::addUniverse(), CSG::CSGBase::addUniverseToList(), CSG::CSGBase::checkUniverseInBase(), CSG::CSGBase::deleteUniverse(), CSG::CSGBase::expandEngUnit(), CSG::CSGCell::getFillName(), CSG::CSGBase::getLinkedUniverses(), CSG::CSGUniverseEngUnit::getName(), CSG::CSGLattice::getUniverseIndices(), operator==(), CSG::CSGBase::prepareUniverseDeletion(), CSG::CSGBase::removeCellFromUniverse(), CSG::CSGBase::renameUniverse(), CSG::CSGUniverseList::renameUniverse(), CSG::CSGBase::setLatticeOuter(), CSG::CSGBase::setUniverseAtLatticeIndex(), and CSG::CSGBase::updateCellFill().

◆ getTransformations()

const std::vector< std::pair< TransformationType, std::tuple< Real, Real, Real > > > & CSG::CSGTransformationHelper::getTransformations ( ) const

inlineinherited

Get the list of transformations.

Returns: The list of transformations

Definition at line 51 of file CSGTransformationHelper.h.

  {
    return _transformations;
  }

Referenced by CSG::CSGSurface::getHalfspaceFromPoint(), CSG::CSGCellEngUnit::getTransformations(), CSG::CSGSurfaceEngUnit::getTransformations(), CSG::CSGUniverseEngUnit::getTransformations(), CSG::CSGCell::operator==(), CSG::CSGLattice::operator==(), CSG::CSGSurface::operator==(), and operator==().

◆ getTransformationsAsStrings()

std::vector< std::pair< std::string, std::tuple< Real, Real, Real > > > CSG::CSGTransformationHelper::getTransformationsAsStrings ( ) const

inherited

Get the transformations of this object with string representations for types.

Returns: Vector of transformation pairs with string representations for types

Definition at line 65 of file CSGTransformationHelper.C.

{
  std::vector<std::pair<std::string, std::tuple<Real, Real, Real>>> result;
  for (const auto & transform_pair : _transformations)
    result.emplace_back(getTransformationTypeString(transform_pair.first), transform_pair.second);
  return result;
}

Referenced by CSG::CSGCellEngUnit::getTransformationsAsStrings(), CSG::CSGSurfaceEngUnit::getTransformationsAsStrings(), and CSG::CSGUniverseEngUnit::getTransformationsAsStrings().

◆ getTransformationTypeString()

std::string CSG::CSGTransformationHelper::getTransformationTypeString ( TransformationType type )

staticinherited

Get the string representation of the transformation type.

Parameters

type	The transformation type

Returns: String name of the transformation type

Definition at line 56 of file CSGTransformationHelper.C.

{
  // Set the enum to the value and convert it to string
  MooseEnum enum_copy = transformation_type_enum;
  enum_copy = static_cast<int>(type);
  return std::string(enum_copy);
}

Referenced by CSG::CSGTransformationHelper::addTransformation(), and CSG::CSGTransformationHelper::getTransformationsAsStrings().

◆ hasCell()

bool CSG::CSGUniverse::hasCell ( const std::string & name ) const

check if cell of provided name is present in universe

Parameters

name	name of cell

Returns: true if cell of name is in universe, otherwise false

Definition at line 51 of file CSGUniverse.C.

{
  for (const CSGCell & cell : _cells)
    if (cell.getName() == name)
      return true;
  return false;
}

Referenced by addCell(), getCell(), and removeCell().

◆ isEngUnit()

virtual bool CSG::CSGUniverse::isEngUnit ( ) const

inlinevirtual

Whether this universe is an engineering unit.

Returns false for a plain CSGUniverse; overridden to return true by the engineering unit types. Used to avoid a dynamic_cast on the common plain-universe comparison path (see operator==).

Returns: true if this object is a CSGEngUnit, otherwise false

Reimplemented in CSG::CSGUniverseEngUnit.

Definition at line 98 of file CSGUniverse.h.

98{ return false; }

Referenced by operator==().

◆ isRoot()

bool CSG::CSGUniverse::isRoot ( ) const

inline

return true if the universe is the root universe

Returns: true / false

Definition at line 87 of file CSGUniverse.h.

87{ return _is_root; }

◆ isValidTransformationValue()

bool CSG::CSGTransformationHelper::isValidTransformationValue	(	TransformationType	type,
		const std::tuple< Real, Real, Real > &	values
	)

staticinherited

Check if the transformation value is valid for the given type.

Parameters

type	The type of transformation
values	The values for the transformation

Returns: True if the values are valid for the type

Definition at line 26 of file CSGTransformationHelper.C.

{
  // Additional validation specific to each transformation type could be added here
  switch (type)
  {
    case TransformationType::TRANSLATION:
      // All translation values are inherently valid
      return true;
 
    case TransformationType::ROTATION:
      // Rotation uses euler notation; values are angles in degrees (phi, theta, psi)
      // For consistency with TransformGenerator, there are no restrictions on the angles
      // phi: rotation around Z-axis
      // theta: rotation around new X-axis
      // psi: rotation around new Z-axis
      return true;
 
    case TransformationType::SCALE:
      // Scaling factors should be non-zero
      if (std::get<0>(values) == 0.0 || std::get<1>(values) == 0.0 || std::get<2>(values) == 0.0)
        return false;
      return true;
 
    default:
      mooseError("Unknown transformation type");
  }
}

Referenced by CSG::CSGTransformationHelper::addTransformation().

◆ operator!=()

bool CSG::CSGUniverse::operator!= ( const CSGUniverse & other ) const

Operator overload for checking if two CSGUniverse objects are not equal.

Definition at line 104 of file CSGUniverse.C.

{
  return !(*this == other);
}

◆ operator==()

bool CSG::CSGUniverse::operator== ( const CSGUniverse & other ) const

Operator overload for checking if two CSGUniverse objects are equal.

Definition at line 74 of file CSGUniverse.C.

{
  // If both objects are engineering units, delegate to CSGEngUnit::operator==. The
  // isEngUnit() check keeps the common plain-universe path free of any dynamic_cast;
  // the casts below only run once we know the objects are engineering units.
  if (isEngUnit())
  {
    if (other.isEngUnit())
      return *dynamic_cast<const CSGEngUnit *>(this) == *dynamic_cast<const CSGEngUnit *>(&other);
    return false; // an engineering unit cannot equal a plain universe
  }
 
  if ((this->getName() != other.getName()) ||
      (this->getTransformations() != other.getTransformations()))
    return false;
  const auto & all_cells = getAllCells();
  const auto & other_cells = other.getAllCells();
  const bool num_cells_eq = all_cells.size() == other_cells.size();
  if (num_cells_eq)
  {
    for (unsigned int i = 0; i < all_cells.size(); ++i)
      if (all_cells[i].get() != other_cells[i].get())
        return false;
    return true;
  }
  else
    return false;
}

◆ removeAllCells()

void CSG::CSGUniverse::removeAllCells ( )

inlineprotected

remove all cells from the universe

Definition at line 124 of file CSGUniverse.h.

124{ _cells.clear(); }

◆ removeCell()

void CSG::CSGUniverse::removeCell ( const std::string & name )

protected

remove a cell of the specified name from the universe

Parameters

name	name of cell to remove

Definition at line 60 of file CSGUniverse.C.

{
  if (!hasCell(name))
    mooseError("Cannot remove cell. Cell with name " + name + " does not exist in universe " +
               _name + ".");
  for (auto it = _cells.begin(); it != _cells.end(); ++it)
    if (it->get().getName() == name)
    {
      _cells.erase(it);
      break;
    }
}

Referenced by CSG::CSGBase::removeCellFromUniverse().

◆ setName()

void CSG::CSGUniverse::setName ( const std::string & name )

inlineprotected

Definition at line 128 of file CSGUniverse.h.

128{ _name = name; }

Friends And Related Symbol Documentation

◆ CSGBase

friend class CSGBase

friend

Definition at line 143 of file CSGUniverse.h.

◆ CSGUniverseList

friend class CSGUniverseList

friend

Definition at line 140 of file CSGUniverse.h.

Member Data Documentation

◆ _cells

std::vector<std::reference_wrapper<const CSGCell> > CSG::CSGUniverse::_cells

protected

list of references to cells in universe

Definition at line 134 of file CSGUniverse.h.

Referenced by addCell(), getAllCells(), getCell(), hasCell(), removeAllCells(), and removeCell().

◆ _is_root

bool CSG::CSGUniverse::_is_root

protected

whether or not this universe is the root universe

Definition at line 137 of file CSGUniverse.h.

Referenced by isRoot().

◆ _name

std::string CSG::CSGUniverse::_name

protected

Name of universe.

Definition at line 131 of file CSGUniverse.h.

Referenced by getCell(), getName(), removeCell(), and setName().

◆ _transformations

std::vector<std::pair<TransformationType, std::tuple<Real, Real, Real> > > CSG::CSGTransformationHelper::_transformations

protectedinherited

List of transformations applied to this object.

Definition at line 96 of file CSGTransformationHelper.h.

Referenced by CSG::CSGTransformationHelper::addTransformation(), CSG::CSGTransformationHelper::applyReverseTransformsToPoint(), CSG::CSGTransformationHelper::getTransformations(), and CSG::CSGTransformationHelper::getTransformationsAsStrings().

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

include/csg/CSGUniverse.h
src/csg/CSGUniverse.C

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ CSGUniverse() [1/2]

◆ CSGUniverse() [2/2]

◆ ~CSGUniverse()

Member Function Documentation

◆ addCell()

◆ addTransformation()

◆ applyReverseTransformsToPoint()

◆ FRIEND_TEST() [1/9]

◆ FRIEND_TEST() [2/9]

◆ FRIEND_TEST() [3/9]

◆ FRIEND_TEST() [4/9]

◆ FRIEND_TEST() [5/9]

◆ FRIEND_TEST() [6/9]

◆ FRIEND_TEST() [7/9]

◆ FRIEND_TEST() [8/9]

◆ FRIEND_TEST() [9/9]

◆ getAllCells()

◆ getCell()

◆ getName()

◆ getTransformations()

◆ getTransformationsAsStrings()

◆ getTransformationTypeString()

◆ hasCell()

◆ isEngUnit()

◆ isRoot()

◆ isValidTransformationValue()

◆ operator!=()

◆ operator==()

◆ removeAllCells()

◆ removeCell()

◆ setName()

Friends And Related Symbol Documentation

◆ CSGBase

◆ CSGUniverseList

Member Data Documentation

◆ _cells

◆ _is_root

◆ _name

◆ _transformations