Class managing the GeomShapes of a mesh. More...

#include <arcane/geometry/GeomShapeMng.h>

Collaboration diagram for Arcane::geometric::GeomShapeMng:

Public Member Functions
	GeomShapeMng (IMesh *mesh, const String &name)
	Initializes for the mesh mesh with the name name.
	GeomShapeMng (IMesh *mesh)
	Initializes for the mesh mesh with the default name GenericElement.
	GeomShapeMng (const GeomShapeMng &rhs)
	Copy constructor.
bool	isInitialized () const
	Indicates if the instance is initialized.
void	initialize ()
	Initializes the instance.
void	initShape (GeomShapeView &ge, Cell cell) const
	Initializes the view ge with the information of the cell cell.
GeomShapeMutableView	mutableShapeView (Cell cell)
	Returns a mutable view on the GeomShape of the cell cell.
const String &	name () const
	Manager name.

Private Attributes
String	m_name
VariableCellArrayReal3	m_cell_shape_nodes
	Generic elements nodes.
VariableCellArrayReal3	m_cell_shape_faces
	Generic elements face.
VariableCellReal3	m_cell_shape_centers
	Generic elements center.

Detailed Description

Class managing the GeomShapes of a mesh.

This class stores the information of the geometric shapes (GeomShape) associated to the mesh cells. For a cell, retrieving a view is done via the initShape() method:

GeomShapeMng shape_mng;
Cell cell;
GeomShapeView shape_view;
// Initializes the view \a shape_view on the cell \a cell
shape_mng.initShape(shape_view,cell);

A view can be used multiple times. For example, if you want to iterate over multiple cells:

GeomShapeMng shape_mng;
GeomShapeView shape_view;
ENUMERATE_CELL(icell,allCells()){
  Cell cell = *icell;
  // Initializes the view \a shape_view on the cell \a cell
  shape_mng.initShape(shape_view,cell);
  info() << "Node0=" << shape_view.node(0);
}

The view retrieved by GeomShapeView is constant. To retrieve a mutable view, you must use mutableShapeView(). The mutable view is only used to update the different coordinates (nodes, face centers, ...).

Before being able to use one of the initShape() or mutableShapeView() methods, you must initialize one of the instances by calling initialize(). Initialization only performs memory allocation but does not update the coordinates.

Warning: The initialize() method must also be called when the topology of the mesh changes, for example after adding or deleting a cell.

This class only manages the data on the geometric shapes and these are independent of other variables. This means that if the coordinates of a cell node change, you must explicitly update the geometric shape information. Arcane provides the BarycentricGeomShapeComputer class for this, but the user can calculate this information in another way than using the barycenter.

All instances of this class whose name name() is identical are implicitly shared and therefore provide the same GeomShapeView. For example:

IMesh* mesh;
GeomShapeMng shape_mng(mesh,"GenericElement");
GeomShapeMng shape_mng2(shape_mng);
// shape_mng and shape_mng2 share the same GeomShapeView
 
GeomShapeMng shape_mng3(mesh,"AleGenericElement");
// shape_mng and shape_mng3 use different values.