https://mooseframework.inl.gov
Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | Friends | List of all members
CSG::CSGCartesianLattice Class Reference

CSGCartesianLattice is the class for constructing regular Cartesian lattices of CSGUniverses. More...

#include <CSGCartesianLattice.h>

Inheritance diagram for CSG::CSGCartesianLattice:
[legend]

Public Member Functions

 CSGCartesianLattice (const std::string &name, const Real pitch, std::vector< std::vector< std::reference_wrapper< const CSGUniverse >>> universes, const std::optional< OuterVariant > &outer=std::nullopt)
 Construct a new CSGCartesianLattice object from the map of universes provided. More...
 
 CSGCartesianLattice (const std::string &name, const Real pitch, const std::optional< OuterVariant > &outer=std::nullopt)
 Construct a new empty CSGCartesianLattice object with specified pitch. More...
 
virtual ~CSGCartesianLattice ()=default
 Destructor. More...
 
std::unique_ptr< CSGLatticeclone () const override
 clone this Cartesian lattice More...
 
virtual std::unordered_map< std::string, AttributeVariantgetAttributes () const override
 Get attributes that define the lattice (excluding the universe map). More...
 
virtual bool isValidIndex (const std::pair< int, int > index) const override
 Checks if the given index location (row, column) is a valid index for the lattice. More...
 
virtual bool isValidUniverseMap (std::vector< std::vector< std::reference_wrapper< const CSGUniverse >>> universes) const override
 check that any provided list of list of CSGUniverses are the correct dimensions. More...
 
unsigned int getNRows () const
 get the number of rows More...
 
unsigned int getNCols () const
 get number of columns More...
 
Real getPitch () const
 get lattice pitch More...
 
void setPitch (Real pitch)
 set the pitch of the lattice More...
 
const std::string & getName () const
 Get the name of lattice. More...
 
const std::string & getType () const
 Get the lattice type. More...
 
const std::string getOuterType () const
 Get the type of outer that fills the space around the lattice elements. More...
 
const CSGUniversegetOuterUniverse () const
 Get the outer universe if outer type is UNIVERSE. More...
 
const std::string & getOuterMaterial () const
 Get the outer material name if outer fype is CSG_MATERIAL. More...
 
std::vector< std::vector< std::reference_wrapper< const CSGUniverse > > > getUniverses () const
 Get the arrangement of CSGUniverses in the lattice. More...
 
const std::vector< std::vector< std::string > > getUniverseNameMap () const
 Get the arrangement of CSGUniverses in the lattice as their names. More...
 
bool hasUniverse (const std::string &name) const
 whether or not the universe of the specified name exists in the lattice More...
 
const CSGUniversegetUniverseAtIndex (const std::pair< int, int > index)
 Get the universe located at the given index. More...
 
const std::vector< std::pair< unsigned int, unsigned int > > getUniverseIndices (const std::string &univ_name) const
 get all locations in lattice where universe of the specified name exists More...
 
void resetOuter ()
 reset the outer fill around the lattice elements to be VOID More...
 
const std::vector< std::reference_wrapper< const CSGUniverse > > getUniqueUniverses () const
 Get the list of unique universe objects in the lattice. More...
 
bool operator== (const CSGLattice &other) const
 Operator overload for checking if two CSGLattice objects are equal. More...
 
bool operator!= (const CSGLattice &other) const
 Operator overload for checking if two CSGLattice objects are not equal. More...
 
const std::vector< std::pair< TransformationType, std::tuple< Real, Real, Real > > > & getTransformations () const
 Get the list of transformations. More...
 
std::vector< std::pair< std::string, std::tuple< Real, Real, Real > > > getTransformationsAsStrings () const
 Get the transformations of this object with string representations for types. More...
 

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. More...
 
static std::string getTransformationTypeString (TransformationType type)
 Get the string representation of the transformation type. More...
 

Protected Member Functions

virtual bool compareAttributes (const CSGLattice &other) const override
 compare the attributes returned in getAttributes of this lattice to another lattice More...
 
virtual void setUniverses (std::vector< std::vector< std::reference_wrapper< const CSGUniverse >>> universes) override
 set the universes that define the lattice layout More...
 
void setName (const std::string &name)
 
void setUniverseAtIndex (const CSGUniverse &universe, const std::pair< int, int > index)
 replace the element at specified index in the lattice with the provided CSGUniverse. More...
 
void updateOuter (const std::string &outer_name)
 Update the outer of the lattice to be the provided material name. More...
 
void updateOuter (const CSGUniverse &outer_universe)
 Update the outer of the lattice to be the provided universe. More...
 
void addTransformation (TransformationType type, const std::tuple< Real, Real, Real > &values)
 Add a transformation to the list of transformations. More...
 
Point applyReverseTransformsToPoint (Point p) const
 update the value of point p by applying the inverse of the list of transformations to the point More...
 
 FRIEND_TEST (CSGLatticeTest, testCartSetUniverses)
 Friends for unit testing. More...
 
 FRIEND_TEST (CSGLatticeTest, testCartSetUniverseAtIndex)
 
 FRIEND_TEST (CSGLatticeTest, testEmptyToFilled)
 
 FRIEND_TEST (CSGLatticeTest, testCartLatticeEquality)
 
 FRIEND_TEST (CSGLatticeTest, testSetName)
 Friends for unit testing. More...
 
 FRIEND_TEST (CSGLatticeTest, testUpdateOuter)
 
 FRIEND_TEST (CSGBaseTest, testAddLattice)
 
 FRIEND_TEST (CSGSurfaceTest, testHalfspaceWithTransform)
 Friends for unit testing. More...
 
 FRIEND_TEST (CSGSurfaceTest, testHalfspaceWithNullTransform)
 

Protected Attributes

Real _pitch
 pitch More...
 
unsigned int _nrow
 number of elements in the first dimension (rows) More...
 
unsigned int _ncol
 number of elements in the second direction (columns) More...
 
std::string _name
 Name of lattice. More...
 
const std::string _lattice_type
 Type of lattice. More...
 
std::vector< std::vector< std::reference_wrapper< const CSGUniverse > > > _universe_map
 Universes in the arrangement of how they appear in the lattice; dimensions depends on lattice type. More...
 
std::string _outer_type
 An enum for type of outer fill for lattice. More...
 
std::string _outer_material
 name of the outer material More...
 
const CSGUniverse_outer_universe
 outer object if fill is CSGUniverse More...
 
std::vector< std::pair< TransformationType, std::tuple< Real, Real, Real > > > _transformations
 List of transformations applied to this object. More...
 

Friends

class CSGBase
 

Detailed Description

CSGCartesianLattice is the class for constructing regular Cartesian lattices of CSGUniverses.

Definition at line 24 of file CSGCartesianLattice.h.

Constructor & Destructor Documentation

◆ CSGCartesianLattice() [1/2]

CSG::CSGCartesianLattice::CSGCartesianLattice ( const std::string &  name,
const Real  pitch,
std::vector< std::vector< std::reference_wrapper< const CSGUniverse >>>  universes,
const std::optional< OuterVariant > &  outer = std::nullopt 
)

Construct a new CSGCartesianLattice object from the map of universes provided.

Parameters
nameunique identifying name of lattice
pitchpitch of lattice elements
universeslist of list of universes to set as the lattice map
outeroptional outer universe or material name that fills space around lattice elements. If not provided, outer is assumed to be VOID.

Definition at line 15 of file CSGCartesianLattice.C.

20  : CSGLattice(name, MooseUtils::prettyCppType<CSGCartesianLattice>(), outer), _pitch(pitch)
21 {
22  setUniverses(universes); // this will set _nrow and _ncol
23  if (_pitch < 0)
24  mooseError("Lattice " + getName() + " must have pitch greater than 0.");
25 }
void mooseError(Args &&... args)
Emit an error message with the given stringified, concatenated args and terminate the application...
Definition: MooseError.h:311
CSGLattice(const std::string &name, const std::string &lattice_type, const std::optional< OuterVariant > &outer=std::nullopt)
Construct a new CSGLattice of specific type.
Definition: CSGLattice.C:16
const std::string & getName() const
Get the name of lattice.
Definition: CSGLattice.h:62
virtual void setUniverses(std::vector< std::vector< std::reference_wrapper< const CSGUniverse >>> universes) override
set the universes that define the lattice layout

◆ CSGCartesianLattice() [2/2]

CSG::CSGCartesianLattice::CSGCartesianLattice ( const std::string &  name,
const Real  pitch,
const std::optional< OuterVariant > &  outer = std::nullopt 
)

Construct a new empty CSGCartesianLattice object with specified pitch.

NOTE: must call setLatticeUniverses to populate the universe map.

Parameters
nameunique identifying name of lattice
pitchpitch of lattice elements
outeroptional outer universe or material name that fills space around lattice elements. If not provided, outer is assumed to be VOID.

Definition at line 27 of file CSGCartesianLattice.C.

30  : CSGLattice(name, MooseUtils::prettyCppType<CSGCartesianLattice>(), outer),
31  _pitch(pitch),
32  _nrow(0),
33  _ncol(0)
34 {
35  if (_pitch < 0)
36  mooseError("Lattice " + getName() + " must have pitch greater than 0.");
37 }
void mooseError(Args &&... args)
Emit an error message with the given stringified, concatenated args and terminate the application...
Definition: MooseError.h:311
CSGLattice(const std::string &name, const std::string &lattice_type, const std::optional< OuterVariant > &outer=std::nullopt)
Construct a new CSGLattice of specific type.
Definition: CSGLattice.C:16
unsigned int _ncol
number of elements in the second direction (columns)
const std::string & getName() const
Get the name of lattice.
Definition: CSGLattice.h:62
unsigned int _nrow
number of elements in the first dimension (rows)

◆ ~CSGCartesianLattice()

virtual CSG::CSGCartesianLattice::~CSGCartesianLattice ( )
virtualdefault

Destructor.

Member Function Documentation

◆ addTransformation()

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

Add a transformation to the list of transformations.

Parameters
typeThe type of transformation
valuesThe values for the transformation

Definition at line 16 of file CSGTransformationHelper.C.

18 {
19  if (!isValidTransformationValue(type, values))
20  mooseError("Invalid transformation values provided for transformation type " +
22  _transformations.emplace_back(type, values);
23 }
static bool isValidTransformationValue(TransformationType type, const std::tuple< Real, Real, Real > &values)
Check if the transformation value is valid for the given type.
void mooseError(Args &&... args)
Emit an error message with the given stringified, concatenated args and terminate the application...
Definition: MooseError.h:311
static std::string getTransformationTypeString(TransformationType type)
Get the string representation of the transformation type.
std::vector< std::pair< TransformationType, std::tuple< Real, Real, Real > > > _transformations
List of transformations applied to this object.

◆ 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
ppoint to transform
Returns
transformed point

Definition at line 74 of file CSGTransformationHelper.C.

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

75 {
76  // iterate list of transformations in reverse and apply the inverse operation
77  for (auto it = _transformations.rbegin(); it != _transformations.rend(); ++it)
78  {
79  auto trans_type = it->first;
80  auto val = it->second;
81 
82  if (trans_type == TransformationType::TRANSLATION)
83  {
84  Point offset(std::get<0>(val), std::get<1>(val), std::get<2>(val));
85  p -= offset;
86  }
87  else if (trans_type == TransformationType::SCALE)
88  {
89  Point scale(std::get<0>(val), std::get<1>(val), std::get<2>(val));
90  for (int i = 0; i < 3; ++i)
91  p(i) /= scale(i);
92  }
93  else if (trans_type == TransformationType::ROTATION)
94  {
95  // get the transpose of the original rotation matrix and apply to point p
96  const auto rot_matrix = RealTensorValue::intrinsic_rotation_matrix(
97  std::get<0>(val), std::get<1>(val), std::get<2>(val));
98  const auto rot_transpose = rot_matrix.transpose();
99  p = rot_transpose * p;
100  }
101  else
102  mooseError("Transformation type is not recognized.");
103  }
104  return p;
105 }
void mooseError(Args &&... args)
Emit an error message with the given stringified, concatenated args and terminate the application...
Definition: MooseError.h:311
void scale(MeshBase &mesh, const Real xs, const Real ys=0., const Real zs=0.)
std::vector< std::pair< TransformationType, std::tuple< Real, Real, Real > > > _transformations
List of transformations applied to this object.
static TensorValue< Real > intrinsic_rotation_matrix(Real phi, Real theta, Real psi)

◆ clone()

std::unique_ptr<CSGLattice> CSG::CSGCartesianLattice::clone ( ) const
inlineoverridevirtual

clone this Cartesian lattice

Returns
std::unique_ptr<CSGLattice> unique pointer to cloned Cartesian lattice

Implements CSG::CSGLattice.

Definition at line 64 of file CSGCartesianLattice.h.

65  {
66  return std::make_unique<CSGCartesianLattice>(*this);
67  }

◆ compareAttributes()

bool CSG::CSGCartesianLattice::compareAttributes ( const CSGLattice other) const
overrideprotectedvirtual

compare the attributes returned in getAttributes of this lattice to another lattice

Implements CSG::CSGLattice.

Definition at line 96 of file CSGCartesianLattice.C.

97 {
98  if (other.getType() != this->getType())
99  return false;
100 
101  auto this_dims = this->getAttributes();
102  auto other_dims = other.getAttributes();
103  if (std::get<unsigned int>(this_dims["nrow"]) != std::get<unsigned int>(other_dims["nrow"]))
104  return false;
105  if (std::get<unsigned int>(this_dims["ncol"]) != std::get<unsigned int>(other_dims["ncol"]))
106  return false;
107  if (std::get<Real>(this_dims["pitch"]) != std::get<Real>(other_dims["pitch"]))
108  return false;
109  return true;
110 }
const std::string & getType() const
Get the lattice type.
Definition: CSGLattice.h:69
virtual std::unordered_map< std::string, AttributeVariant > getAttributes() const override
Get attributes that define the lattice (excluding the universe map).

◆ FRIEND_TEST() [1/9]

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

Friends for unit testing.

◆ FRIEND_TEST() [2/9]

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

◆ FRIEND_TEST() [3/9]

CSG::CSGCartesianLattice::FRIEND_TEST ( CSGLatticeTest  ,
testCartSetUniverses   
)
protected

Friends for unit testing.

◆ FRIEND_TEST() [4/9]

CSG::CSGCartesianLattice::FRIEND_TEST ( CSGLatticeTest  ,
testCartSetUniverseAtIndex   
)
protected

◆ FRIEND_TEST() [5/9]

CSG::CSGCartesianLattice::FRIEND_TEST ( CSGLatticeTest  ,
testEmptyToFilled   
)
protected

◆ FRIEND_TEST() [6/9]

CSG::CSGCartesianLattice::FRIEND_TEST ( CSGLatticeTest  ,
testCartLatticeEquality   
)
protected

◆ FRIEND_TEST() [7/9]

CSG::CSGLattice::FRIEND_TEST ( CSGLatticeTest  ,
testSetName   
)
protectedinherited

Friends for unit testing.

◆ FRIEND_TEST() [8/9]

CSG::CSGLattice::FRIEND_TEST ( CSGLatticeTest  ,
testUpdateOuter   
)
protectedinherited

◆ FRIEND_TEST() [9/9]

CSG::CSGLattice::FRIEND_TEST ( CSGBaseTest  ,
testAddLattice   
)
protectedinherited

◆ getAttributes()

std::unordered_map< std::string, AttributeVariant > CSG::CSGCartesianLattice::getAttributes ( ) const
overridevirtual

Get attributes that define the lattice (excluding the universe map).

  • nrow: number of rows (int)
  • ncol: number of columns (int)
  • pitch: pitch of the lattice element (Real)
Returns
map of string dimension name to value of that dimension

Implements CSG::CSGLattice.

Definition at line 48 of file CSGCartesianLattice.C.

Referenced by compareAttributes().

49 {
50  return {{"nrow", static_cast<unsigned int>(_nrow)},
51  {"ncol", static_cast<unsigned int>(_ncol)},
52  {"pitch", _pitch}};
53 }
unsigned int _ncol
number of elements in the second direction (columns)
unsigned int _nrow
number of elements in the first dimension (rows)

◆ getName()

const std::string& CSG::CSGLattice::getName ( ) const
inlineinherited

◆ getNCols()

unsigned int CSG::CSGCartesianLattice::getNCols ( ) const
inline

get number of columns

Returns
number of columns

Definition at line 110 of file CSGCartesianLattice.h.

110 { return _ncol; }
unsigned int _ncol
number of elements in the second direction (columns)

◆ getNRows()

unsigned int CSG::CSGCartesianLattice::getNRows ( ) const
inline

get the number of rows

Returns
number of rows

Definition at line 103 of file CSGCartesianLattice.h.

103 { return _nrow; }
unsigned int _nrow
number of elements in the first dimension (rows)

◆ getOuterMaterial()

const std::string & CSG::CSGLattice::getOuterMaterial ( ) const
inherited

Get the outer material name if outer fype is CSG_MATERIAL.

Returns
name of the CSG material fill

Definition at line 120 of file CSGLattice.C.

Referenced by CSG::CSGLattice::operator==().

121 {
122  if (getOuterType() != "CSG_MATERIAL")
123  mooseError("Lattice '" + getName() + "' has " + getOuterType() + " outer, not CSG_MATERIAL.");
124  else
125  return _outer_material;
126 }
std::string _outer_material
name of the outer material
Definition: CSGLattice.h:231
void mooseError(Args &&... args)
Emit an error message with the given stringified, concatenated args and terminate the application...
Definition: MooseError.h:311
const std::string & getName() const
Get the name of lattice.
Definition: CSGLattice.h:62
const std::string getOuterType() const
Get the type of outer that fills the space around the lattice elements.
Definition: CSGLattice.h:76

◆ getOuterType()

const std::string CSG::CSGLattice::getOuterType ( ) const
inlineinherited

Get the type of outer that fills the space around the lattice elements.

Returns
string of outer type: CSG_MATERIAL, UNIVERSE, or VOID

Definition at line 76 of file CSGLattice.h.

Referenced by CSG::CSGBase::addLatticeToList(), CSG::CSGLattice::getOuterMaterial(), CSG::CSGLattice::getOuterUniverse(), and CSG::CSGLattice::operator==().

76 { return _outer_type; }
std::string _outer_type
An enum for type of outer fill for lattice.
Definition: CSGLattice.h:228

◆ getOuterUniverse()

const CSGUniverse & CSG::CSGLattice::getOuterUniverse ( ) const
inherited

Get the outer universe if outer type is UNIVERSE.

Returns
Reference to CSGUniverse

Definition at line 111 of file CSGLattice.C.

Referenced by CSG::CSGBase::addLatticeToList(), and CSG::CSGLattice::operator==().

112 {
113  if (getOuterType() != "UNIVERSE")
114  mooseError("Lattice '" + getName() + "' has " + getOuterType() + " outer, not UNIVERSE.");
115  else
116  return *_outer_universe;
117 }
void mooseError(Args &&... args)
Emit an error message with the given stringified, concatenated args and terminate the application...
Definition: MooseError.h:311
const std::string & getName() const
Get the name of lattice.
Definition: CSGLattice.h:62
const CSGUniverse * _outer_universe
outer object if fill is CSGUniverse
Definition: CSGLattice.h:234
const std::string getOuterType() const
Get the type of outer that fills the space around the lattice elements.
Definition: CSGLattice.h:76

◆ getPitch()

Real CSG::CSGCartesianLattice::getPitch ( ) const
inline

get lattice pitch

Returns
pitch

Definition at line 117 of file CSGCartesianLattice.h.

117 { return _pitch; }

◆ 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 47 of file CSGTransformationHelper.h.

Referenced by CSG::CSGSurface::getHalfspaceFromPoint(), CSG::CSGUniverse::operator==(), CSG::CSGSurface::operator==(), CSG::CSGCell::operator==(), and CSG::CSGLattice::operator==().

48  {
49  return _transformations;
50  }
std::vector< std::pair< TransformationType, std::tuple< Real, Real, Real > > > _transformations
List of transformations applied to this object.

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

66 {
67  std::vector<std::pair<std::string, std::tuple<Real, Real, Real>>> result;
68  for (const auto & transform_pair : _transformations)
69  result.emplace_back(getTransformationTypeString(transform_pair.first), transform_pair.second);
70  return result;
71 }
static std::string getTransformationTypeString(TransformationType type)
Get the string representation of the transformation type.
std::vector< std::pair< TransformationType, std::tuple< Real, Real, Real > > > _transformations
List of transformations applied to this object.

◆ getTransformationTypeString()

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

Get the string representation of the transformation type.

Parameters
typeThe transformation type
Returns
String name of the transformation type

Definition at line 56 of file CSGTransformationHelper.C.

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

57 {
58  // Set the enum to the value and convert it to string
60  enum_copy = static_cast<int>(type);
61  return std::string(enum_copy);
62 }
This is a "smart" enum class intended to replace many of the shortcomings in the C++ enum type It sho...
Definition: MooseEnum.h:54
static const MooseEnum transformation_type_enum
MooseEnum for transformation types, matching the TransformationType enum values.

◆ getType()

const std::string& CSG::CSGLattice::getType ( ) const
inlineinherited

Get the lattice type.

Returns
std::string type of lattice

Definition at line 69 of file CSGLattice.h.

Referenced by compareAttributes(), CSG::CSGHexagonalLattice::compareAttributes(), CSG::CSGLattice::operator==(), setUniverses(), and CSG::CSGHexagonalLattice::setUniverses().

69 { return _lattice_type; }
const std::string _lattice_type
Type of lattice.
Definition: CSGLattice.h:222

◆ getUniqueUniverses()

const std::vector< std::reference_wrapper< const CSGUniverse > > CSG::CSGLattice::getUniqueUniverses ( ) const
inherited

Get the list of unique universe objects in the lattice.

Returns
list of references to unique CSGUniverse objects

Definition at line 93 of file CSGLattice.C.

94 {
95  std::vector<std::reference_wrapper<const CSGUniverse>> unique_univs;
96  auto all_univs = getUniverses();
97 
98  for (const auto & ulist : all_univs)
99  for (const auto & u : ulist)
100  {
101  auto it = std::find_if(unique_univs.begin(),
102  unique_univs.end(),
103  [&u](const auto & ref) { return &ref.get() == &u.get(); });
104  if (it == unique_univs.end())
105  unique_univs.push_back(u);
106  }
107  return unique_univs;
108 }
std::vector< std::vector< std::reference_wrapper< const CSGUniverse > > > getUniverses() const
Get the arrangement of CSGUniverses in the lattice.
Definition: CSGLattice.h:97

◆ getUniverseAtIndex()

const CSGUniverse & CSG::CSGLattice::getUniverseAtIndex ( const std::pair< int, int index)
inherited

Get the universe located at the given index.

Parameters
indexpair of ints that specify the location in lattice
Returns
universe at the specified location

Definition at line 66 of file CSGLattice.C.

67 {
68  if (!isValidIndex(index))
69  mooseError("Index (" + std::to_string(index.first) + ", " + std::to_string(index.second) +
70  ") is not a valid index for lattice " + getName());
71  else
72  return _universe_map[index.first][index.second];
73 }
void mooseError(Args &&... args)
Emit an error message with the given stringified, concatenated args and terminate the application...
Definition: MooseError.h:311
virtual bool isValidIndex(const std::pair< int, int > index) const =0
Checks if the given index location is a valid index for the lattice.
const std::string & getName() const
Get the name of lattice.
Definition: CSGLattice.h:62
std::vector< std::vector< std::reference_wrapper< const CSGUniverse > > > _universe_map
Universes in the arrangement of how they appear in the lattice; dimensions depends on lattice type...
Definition: CSGLattice.h:225

◆ getUniverseIndices()

const std::vector< std::pair< unsigned int, unsigned int > > CSG::CSGLattice::getUniverseIndices ( const std::string &  univ_name) const
inherited

get all locations in lattice where universe of the specified name exists

Parameters
univ_namename of universe
Returns
vector of locations (pairs of ints)

Definition at line 76 of file CSGLattice.C.

77 {
78  if (!hasUniverse(univ_name))
79  mooseError("Universe " + univ_name + " does not exist in lattice " + getName());
80 
81  std::vector<std::pair<unsigned int, unsigned int>> indices;
82  for (auto i : index_range(_universe_map))
83  for (auto j : index_range(_universe_map[i]))
84  {
85  const CSGUniverse & univ = _universe_map[i][j];
86  if (univ.getName() == univ_name)
87  indices.push_back(std::make_pair(i, j));
88  }
89  return indices;
90 }
void mooseError(Args &&... args)
Emit an error message with the given stringified, concatenated args and terminate the application...
Definition: MooseError.h:311
const std::string & getName() const
Get the name of lattice.
Definition: CSGLattice.h:62
std::vector< std::vector< std::reference_wrapper< const CSGUniverse > > > _universe_map
Universes in the arrangement of how they appear in the lattice; dimensions depends on lattice type...
Definition: CSGLattice.h:225
bool hasUniverse(const std::string &name) const
whether or not the universe of the specified name exists in the lattice
Definition: CSGLattice.C:42
auto index_range(const T &sizable)

◆ getUniverseNameMap()

const std::vector< std::vector< std::string > > CSG::CSGLattice::getUniverseNameMap ( ) const
inherited

Get the arrangement of CSGUniverses in the lattice as their names.

Returns
list of list of universe names

Definition at line 52 of file CSGLattice.C.

53 {
54  std::vector<std::vector<std::string>> name_map;
55  for (auto & univ_list : _universe_map)
56  {
57  std::vector<std::string> name_list;
58  for (const CSGUniverse & univ : univ_list)
59  name_list.push_back(univ.getName());
60  name_map.push_back(name_list);
61  }
62  return name_map;
63 }
std::vector< std::vector< std::reference_wrapper< const CSGUniverse > > > _universe_map
Universes in the arrangement of how they appear in the lattice; dimensions depends on lattice type...
Definition: CSGLattice.h:225

◆ getUniverses()

std::vector<std::vector<std::reference_wrapper<const CSGUniverse> > > CSG::CSGLattice::getUniverses ( ) const
inlineinherited

Get the arrangement of CSGUniverses in the lattice.

Returns
list of list of universes in their lattice arrangement

Definition at line 97 of file CSGLattice.h.

Referenced by CSG::CSGBase::addLatticeToList(), CSG::CSGBase::createCell(), CSG::CSGLattice::getUniqueUniverses(), and CSG::CSGLattice::operator==().

98  {
99  return _universe_map;
100  }
std::vector< std::vector< std::reference_wrapper< const CSGUniverse > > > _universe_map
Universes in the arrangement of how they appear in the lattice; dimensions depends on lattice type...
Definition: CSGLattice.h:225

◆ hasUniverse()

bool CSG::CSGLattice::hasUniverse ( const std::string &  name) const
inherited

whether or not the universe of the specified name exists in the lattice

Parameters
nameof universe to search for
Returns
true if universe of that name exists in lattice

Definition at line 42 of file CSGLattice.C.

Referenced by CSG::CSGLattice::getUniverseIndices().

43 {
44  for (auto list_univ : _universe_map)
45  for (const CSGUniverse & univ : list_univ)
46  if (univ.getName() == name)
47  return true;
48  return false; // no universe with matching name was found
49 }
std::string name(const ElemQuality q)
std::vector< std::vector< std::reference_wrapper< const CSGUniverse > > > _universe_map
Universes in the arrangement of how they appear in the lattice; dimensions depends on lattice type...
Definition: CSGLattice.h:225

◆ isValidIndex()

bool CSG::CSGCartesianLattice::isValidIndex ( const std::pair< int, int index) const
overridevirtual

Checks if the given index location (row, column) is a valid index for the lattice.

Allowable indices are: 0 <= row < _nrow and 0 <= column < _ncol.

Parameters
indexlocation in (row, column) form
Returns
true if index is valid for the lattice

Implements CSG::CSGLattice.

Definition at line 88 of file CSGCartesianLattice.C.

89 {
90  auto row = index.first; // must be (0 <= row < _nrow); rows
91  auto col = index.second; // must be (0 <= col < _ncol); cols
92  return ((0 <= row && row < (int)_nrow) && (0 <= col && col < (int)_ncol));
93 }
unsigned int _ncol
number of elements in the second direction (columns)
unsigned int _nrow
number of elements in the first dimension (rows)

◆ 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
typeThe type of transformation
valuesThe values for the transformation
Returns
True if the values are valid for the type

Definition at line 26 of file CSGTransformationHelper.C.

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

28 {
29  // Additional validation specific to each transformation type could be added here
30  switch (type)
31  {
33  // All translation values are inherently valid
34  return true;
35 
37  // Rotation uses euler notation; values are angles in degrees (phi, theta, psi)
38  // For consistency with TransformGenerator, there are no restrictions on the angles
39  // phi: rotation around Z-axis
40  // theta: rotation around new X-axis
41  // psi: rotation around new Z-axis
42  return true;
43 
45  // Scaling factors should be non-zero
46  if (std::get<0>(values) == 0.0 || std::get<1>(values) == 0.0 || std::get<2>(values) == 0.0)
47  return false;
48  return true;
49 
50  default:
51  mooseError("Unknown transformation type");
52  }
53 }
void mooseError(Args &&... args)
Emit an error message with the given stringified, concatenated args and terminate the application...
Definition: MooseError.h:311

◆ isValidUniverseMap()

bool CSG::CSGCartesianLattice::isValidUniverseMap ( std::vector< std::vector< std::reference_wrapper< const CSGUniverse >>>  universes) const
overridevirtual

check that any provided list of list of CSGUniverses are the correct dimensions.

Must have number of lists within universes equal to _nrow. And each sublist must be size _ncol.

Parameters
universeslist of list of universes to be used to define the lattice structure
Returns
true if universe dimensions are valid

Implements CSG::CSGLattice.

Definition at line 56 of file CSGCartesianLattice.C.

Referenced by setUniverses().

58 {
59  // need at least one row
60  if (universes.size() < 1)
61  return false;
62 
63  // check that each row is same size
64  auto row_size = universes[0].size();
65  for (auto univ_list : universes)
66  {
67  if (univ_list.size() != row_size)
68  return false;
69  }
70  return true;
71 }

◆ operator!=()

bool CSG::CSGLattice::operator!= ( const CSGLattice other) const
inherited

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

Definition at line 189 of file CSGLattice.C.

190 {
191  return !(*this == other);
192 }

◆ operator==()

bool CSG::CSGLattice::operator== ( const CSGLattice other) const
inherited

Operator overload for checking if two CSGLattice objects are equal.

Definition at line 153 of file CSGLattice.C.

154 {
155  if (this->getName() != other.getName())
156  return false;
157  if (this->getType() != other.getType())
158  return false;
159  if (this->getTransformations() != other.getTransformations())
160  return false;
161  if (this->getOuterType() != other.getOuterType())
162  return false;
163  if ((this->getOuterType() == "CSG_MATERIAL") &&
164  (this->getOuterMaterial() != other.getOuterMaterial()))
165  return false;
166  if ((this->getOuterType() == "UNIVERSE") &&
167  (this->getOuterUniverse() != other.getOuterUniverse()))
168  return false;
169  if (!this->compareAttributes(other))
170  return false;
171 
172  const auto & this_univs = this->getUniverses();
173  const auto & other_univs = other.getUniverses();
174  if (this_univs.size() != other_univs.size())
175  return false;
176  for (unsigned int i = 0; i < this_univs.size(); ++i)
177  {
178  if (this_univs[i].size() != other_univs[i].size())
179  return false;
180  for (unsigned int j = 0; j < this_univs[i].size(); j++)
181  if (this_univs[i][j].get() != other_univs[i][j].get())
182  return false;
183  }
184 
185  return true;
186 }
const CSGUniverse & getOuterUniverse() const
Get the outer universe if outer type is UNIVERSE.
Definition: CSGLattice.C:111
const std::string & getType() const
Get the lattice type.
Definition: CSGLattice.h:69
const std::string & getName() const
Get the name of lattice.
Definition: CSGLattice.h:62
const std::string & getOuterMaterial() const
Get the outer material name if outer fype is CSG_MATERIAL.
Definition: CSGLattice.C:120
virtual bool compareAttributes(const CSGLattice &other) const =0
helper function to compare the attributes of the lattice type
std::vector< std::vector< std::reference_wrapper< const CSGUniverse > > > getUniverses() const
Get the arrangement of CSGUniverses in the lattice.
Definition: CSGLattice.h:97
const std::string getOuterType() const
Get the type of outer that fills the space around the lattice elements.
Definition: CSGLattice.h:76
const std::vector< std::pair< TransformationType, std::tuple< Real, Real, Real > > > & getTransformations() const
Get the list of transformations.

◆ resetOuter()

void CSG::CSGLattice::resetOuter ( )
inherited

reset the outer fill around the lattice elements to be VOID

Definition at line 145 of file CSGLattice.C.

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

146 {
147  _outer_type = "VOID";
148  _outer_material = "";
149  _outer_universe = nullptr;
150 }
std::string _outer_material
name of the outer material
Definition: CSGLattice.h:231
std::string _outer_type
An enum for type of outer fill for lattice.
Definition: CSGLattice.h:228
const CSGUniverse * _outer_universe
outer object if fill is CSGUniverse
Definition: CSGLattice.h:234

◆ setName()

void CSG::CSGLattice::setName ( const std::string &  name)
inlineprotectedinherited

Definition at line 183 of file CSGLattice.h.

183 { _name = name; }
std::string name(const ElemQuality q)
std::string _name
Name of lattice.
Definition: CSGLattice.h:219

◆ setPitch()

void CSG::CSGCartesianLattice::setPitch ( Real  pitch)

set the pitch of the lattice

Parameters
pitchnew pitch value

Definition at line 40 of file CSGCartesianLattice.C.

41 {
42  if (pitch < 0)
43  mooseError("Lattice " + getName() + " must have pitch greater than 0.");
44  _pitch = pitch;
45 }
void mooseError(Args &&... args)
Emit an error message with the given stringified, concatenated args and terminate the application...
Definition: MooseError.h:311
const std::string & getName() const
Get the name of lattice.
Definition: CSGLattice.h:62

◆ setUniverseAtIndex()

void CSG::CSGLattice::setUniverseAtIndex ( const CSGUniverse universe,
const std::pair< int, int index 
)
protectedinherited

replace the element at specified index in the lattice with the provided CSGUniverse.

This will check that the _universe_map has been initialized and that the index is valid.

Parameters
universeuniverse to add to the lattice at the location index
indexlocation in lattice replace with provided universe

Definition at line 30 of file CSGLattice.C.

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

31 {
32  std::string base_msg = "Cannot set universe at location (" + std::to_string(index.first) + ", " +
33  std::to_string(index.second) + ") for lattice " + getName() + ". ";
34  if (_universe_map.size() == 0)
35  mooseError(base_msg + "Universe map has not been initialized.");
36  if (!isValidIndex(index))
37  mooseError(base_msg + "Not a valid location.");
38  _universe_map[index.first][index.second] = universe;
39 }
void mooseError(Args &&... args)
Emit an error message with the given stringified, concatenated args and terminate the application...
Definition: MooseError.h:311
virtual bool isValidIndex(const std::pair< int, int > index) const =0
Checks if the given index location is a valid index for the lattice.
const std::string & getName() const
Get the name of lattice.
Definition: CSGLattice.h:62
std::vector< std::vector< std::reference_wrapper< const CSGUniverse > > > _universe_map
Universes in the arrangement of how they appear in the lattice; dimensions depends on lattice type...
Definition: CSGLattice.h:225

◆ setUniverses()

void CSG::CSGCartesianLattice::setUniverses ( std::vector< std::vector< std::reference_wrapper< const CSGUniverse >>>  universes)
overrideprotectedvirtual

set the universes that define the lattice layout

Parameters
universeslist of list of universes to set as the lattice map

Implements CSG::CSGLattice.

Definition at line 74 of file CSGCartesianLattice.C.

Referenced by CSGCartesianLattice().

76 {
77  // check for valid map arrangment
78  if (!isValidUniverseMap(universes))
79  mooseError("Cannot set lattice " + getName() +
80  " with universes. Does not have valid dimensions for lattice type " + getType());
81  // set attributes based on universe map
82  _nrow = universes.size();
83  _ncol = universes[0].size();
84  _universe_map = universes;
85 }
void mooseError(Args &&... args)
Emit an error message with the given stringified, concatenated args and terminate the application...
Definition: MooseError.h:311
const std::string & getType() const
Get the lattice type.
Definition: CSGLattice.h:69
unsigned int _ncol
number of elements in the second direction (columns)
const std::string & getName() const
Get the name of lattice.
Definition: CSGLattice.h:62
std::vector< std::vector< std::reference_wrapper< const CSGUniverse > > > _universe_map
Universes in the arrangement of how they appear in the lattice; dimensions depends on lattice type...
Definition: CSGLattice.h:225
virtual bool isValidUniverseMap(std::vector< std::vector< std::reference_wrapper< const CSGUniverse >>> universes) const override
check that any provided list of list of CSGUniverses are the correct dimensions.
unsigned int _nrow
number of elements in the first dimension (rows)

◆ updateOuter() [1/2]

void CSG::CSGLattice::updateOuter ( const std::string &  outer_name)
protectedinherited

Update the outer of the lattice to be the provided material name.

This will change outer type to CSG_MATERIAL even if it was a different type previously.

Parameters
outer_namename of CSG material that will fill space around lattice elements

Definition at line 137 of file CSGLattice.C.

Referenced by CSG::CSGLattice::CSGLattice(), and CSG::CSGBase::setLatticeOuter().

138 {
139  _outer_type = "CSG_MATERIAL";
140  _outer_material = outer_name;
141  _outer_universe = nullptr;
142 }
std::string _outer_material
name of the outer material
Definition: CSGLattice.h:231
std::string _outer_type
An enum for type of outer fill for lattice.
Definition: CSGLattice.h:228
const CSGUniverse * _outer_universe
outer object if fill is CSGUniverse
Definition: CSGLattice.h:234

◆ updateOuter() [2/2]

void CSG::CSGLattice::updateOuter ( const CSGUniverse outer_universe)
protectedinherited

Update the outer of the lattice to be the provided universe.

This will change outer type to UNIVERSE even if it was a different type previously.

Parameters
outer_universepointer to outer universe that will fill space around lattice elements

Definition at line 129 of file CSGLattice.C.

130 {
131  _outer_type = "UNIVERSE";
132  _outer_universe = &outer_universe;
133  _outer_material = "";
134 }
std::string _outer_material
name of the outer material
Definition: CSGLattice.h:231
std::string _outer_type
An enum for type of outer fill for lattice.
Definition: CSGLattice.h:228
const CSGUniverse * _outer_universe
outer object if fill is CSGUniverse
Definition: CSGLattice.h:234

Friends And Related Function Documentation

◆ CSGBase

friend class CSGBase
friend

Definition at line 147 of file CSGCartesianLattice.h.

Member Data Documentation

◆ _lattice_type

const std::string CSG::CSGLattice::_lattice_type
protectedinherited

Type of lattice.

Definition at line 222 of file CSGLattice.h.

Referenced by CSG::CSGLattice::getType().

◆ _name

std::string CSG::CSGLattice::_name
protectedinherited

Name of lattice.

Definition at line 219 of file CSGLattice.h.

Referenced by CSG::CSGLattice::getName(), and CSG::CSGLattice::setName().

◆ _ncol

unsigned int CSG::CSGCartesianLattice::_ncol
protected

number of elements in the second direction (columns)

Definition at line 145 of file CSGCartesianLattice.h.

Referenced by getAttributes(), getNCols(), isValidIndex(), and setUniverses().

◆ _nrow

unsigned int CSG::CSGCartesianLattice::_nrow
protected

number of elements in the first dimension (rows)

Definition at line 142 of file CSGCartesianLattice.h.

Referenced by getAttributes(), getNRows(), isValidIndex(), and setUniverses().

◆ _outer_material

std::string CSG::CSGLattice::_outer_material
mutableprotectedinherited

name of the outer material

Definition at line 231 of file CSGLattice.h.

Referenced by CSG::CSGLattice::getOuterMaterial(), CSG::CSGLattice::resetOuter(), and CSG::CSGLattice::updateOuter().

◆ _outer_type

std::string CSG::CSGLattice::_outer_type
mutableprotectedinherited

An enum for type of outer fill for lattice.

Definition at line 228 of file CSGLattice.h.

Referenced by CSG::CSGLattice::getOuterType(), CSG::CSGLattice::resetOuter(), and CSG::CSGLattice::updateOuter().

◆ _outer_universe

const CSGUniverse* CSG::CSGLattice::_outer_universe
protectedinherited

outer object if fill is CSGUniverse

Definition at line 234 of file CSGLattice.h.

Referenced by CSG::CSGLattice::getOuterUniverse(), CSG::CSGLattice::resetOuter(), and CSG::CSGLattice::updateOuter().

◆ _pitch

Real CSG::CSGCartesianLattice::_pitch
protected

pitch

Definition at line 139 of file CSGCartesianLattice.h.

Referenced by CSGCartesianLattice(), getAttributes(), getPitch(), and setPitch().

◆ _transformations

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

◆ _universe_map

std::vector<std::vector<std::reference_wrapper<const CSGUniverse> > > CSG::CSGLattice::_universe_map
protectedinherited

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