ASMsupel Class Reference

Driver for assembly of general superelements. More...

#include <ASMsupel.h>

Inheritance diagram for ASMsupel:

Collaboration diagram for ASMsupel:

Public Member Functions
	ASMsupel (unsigned char n_f=6)
	Default constructor.
	ASMsupel (const ASMsupel &patch, unsigned char n_f)
	Special copy constructor for sharing of FE data.
	ASMsupel (const ASMsupel &patch)
	Default copy constructor copying everything.
virtual	~ASMsupel ()
	Empty destructor.
virtual bool	read (std::istream &is)
	Creates an instance by reading the given input stream.
virtual bool	write (std::ostream &, int) const
	Writes the geometry of the patch to the given stream.
virtual bool	generateFEMTopology ()
	Generates the finite element topology data for this patch.
virtual bool	empty () const
	Checks if this patch is empty.
virtual int	getNodeSetIdx (const std::string &setName) const
	Returns (1-based) index of a predefined node set in the patch.
virtual const IntVec &	getNodeSet (int iset) const
	Returns an indexed pre-defined node set.
virtual int	parseNodeSet (const std::string &setName, const char *cset)
	Defines a node set by parsing a list of node numbers.
virtual Vec3	getCoord (size_t inod) const
	Returns the global coordinates for the given node. More...
virtual void	getNodalCoordinates (Matrix &X, bool=false) const
	Returns a matrix with all nodal coordinates within the patch. More...
virtual bool	getElementCoordinates (Matrix &X, int iel, bool=false) const
	Returns a matrix with nodal coordinates for an element. More...
virtual void	getBoundaryNodes (int lIndex, IntVec &nodes, int, int, int, bool local) const
	Finds the global (or patch-local) node numbers on a patch boundary. More...
virtual void	findBoundaryElms (IntVec &, int, int) const
	Dummy method doing nothing.
virtual bool	getParameterDomain (Real2DMat &, IntVec *) const
	Dummy method doing nothing.
virtual void	getElmConnectivities (IntMat &, int) const
	Dummy method doing nothing.
virtual bool	updateCoords (const Vector &)
	Dummy method doing nothing.
virtual Vec3	getElementCenter (int) const
	Dummy method doing nothing.
virtual bool	integrate (Integrand &integrand, GlobalIntegral &glbInt, const TimeDomain &)
	Evaluates an integral over the interior patch domain. More...
virtual bool	integrate (Integrand &, int, GlobalIntegral &, const TimeDomain &)
	Dummy method (patch patch boundaries are not defined).
virtual int	evalPoint (const double *, double *, Vec3 &) const
	Dummy method doing nothing.
virtual int	findElementContaining (const double *) const
	Dummy method doing nothing.
virtual double	findPoint (Vec3 &, double *) const
	Dummy method doing nothing.
virtual bool	tesselate (ElementBlock &grid, const int *) const
	Creates a standard FE model of this patch for visualization. More...
virtual bool	evalSolution (Matrix &sField, const Vector &locSol, const int *, int, bool) const
	Evaluates the primary solution field at all visualization points. More...
virtual bool	transform (const Matrix &Tlg)
	Applies a transformation matrix from local to global system.
virtual bool	evalSolution (Matrix &sField, const Vector &locSol, const int *npe, int n_f=0, bool piola=false) const
	Evaluates the primary solution field at all visualization points. More...
virtual bool	evalSolution (Matrix &sField, const Vector &locSol, const RealArray *gpar, bool regular=true, int deriv=0, int n_f=0) const
	Evaluates the primary solution field at the given points. More...
virtual bool	evalSolution (Matrix &sField, const IntegrandBase &integrand, const int *npe=nullptr, char project=0) const
	Evaluates the secondary solution field at all visualization points. More...
virtual bool	evalSolution (Matrix &sField, const IntegrandBase &integrand, const RealArray *gpar, bool regular=true) const
	Evaluates the secondary solution field at the given points. More...
virtual bool	evalSolution (Matrix &sField, const IntegrandBase &integrand, const IntVec &elements) const
	Evaluates the secondary solution field at element centers. More...
Public Member Functions inherited from ASMbase
virtual	~ASMbase ()
	The destructor frees the dynamically allocated data objects.
ASMbase *	cloneUnShared () const
	Returns a copy of this patch with identical FE discretization. More...
virtual bool	readBasis (std::istream &, size_t)
	Reads a basis from the given input stream.
virtual void	addHole (double, double, double)
	Adds a circular immersed boundary in the physical geometry.
virtual void	addHole (double, double, double, double, double)
	Adds an oval immersed boundary in the physical geometry.
virtual bool	setGeometry (RealFunc *, double, double)
	Defines the immersed geometry from a scalar function.
virtual void	clear (bool retainGeometry=false)
	Clears the contents of this patch, making it empty. More...
virtual bool	addXElms (short int dim, short int item, size_t nXn, IntVec &nodes)
	Adds extraordinary elements associated with a patch boundary. More...
bool	addLagrangeMultipliers (size_t iel, const IntVec &mGLag, unsigned char nnLag=1)
	Adds a set of Lagrange multipliers to the specified element. More...
bool	addGlobalLagrangeMultipliers (const IntVec &mGLag, unsigned char nnLag=1)
	Adds global Lagrange multipliers to the system. More...
virtual void	setGauss (int ng)
	Defines the numerical integration scheme nGauss in the patch.
void	setNoFields (unsigned char n)
	Defines the number of solution fields in the patch. More...
void	setElementActivator (IntFunc *efunc)
	Sets the element activation function.
const IntFunc *	getElementActivator () const
	Returns a pointer to the element activation function.
virtual void	setMinimumSize (double)
	Sets the minimum element size for adaptive refinement.
virtual double	getMinimumSize (int=0) const
	Defines the minimum element size for adaptive refinement.
virtual bool	checkElementSize (int, bool=true) const
	Checks if the specified element is larger than the minimum size.
unsigned char	getNoSpaceDim () const
	Returns the number of spatial dimensions.
unsigned char	getNoParamDim () const
	Returns the number of parameter dimensions.
virtual unsigned char	getNoFields (int b=0) const
	Returns the number of solution fields.
unsigned char	getNoLagPerNode () const
	Returns the number of Lagrange multipliers per node.
virtual bool	getOrder (int &, int &, int &) const
	Returns the polynomial order in each parameter direction.
virtual size_t	getNodeIndex (int globalNum, bool=false) const
	Returns local 1-based index of the node with given global number. More...
virtual int	getNodeID (size_t inod, bool=false) const
	Returns the global node number for the given node. More...
size_t	getElmIndex (int globalNum) const
	Returns local 1-based index of element with given global number. More...
int	getElmID (size_t iel) const
	Returns the global element number for the given element. More...
virtual unsigned char	getNodalDOFs (size_t inod) const
	Returns the number of DOFs per node. More...
virtual char	getNodeType (size_t inod) const
	Returns the classification of a node. More...
bool	isLMn (size_t n) const
	Returns true if node n is a Lagrange multiplier node.
bool	isRMn (size_t n) const
	Returns true if node n is a master node of a rigid coupling.
char	getLMType (size_t inod) const
	Returns the type of a Lagrange multiplier node. More...
virtual void	getBoundary1Nodes (int lIndex, IntVec &nodes, int basis=0, int orient=-1, bool local=false, bool open=false) const
	Finds the global (or patch-local) node numbers on a patch boundary. More...
void	getBoundaryElms (int lIndex, IntVec &elms, int orient=-1, bool local=false) const
	Finds the global (or patch-local) element numbers on a boundary. More...
virtual bool	isInNodeSet (int, int) const
	Checks if a node is within a predefined node set.
virtual int	parseNodeBox (const std::string &, const char *)
	Defines a node set by parsing a 3D bounding box.
virtual int	getElementSetIdx (const std::string &) const
	Returns (1-based) index of a predefined element set in the patch.
virtual const IntVec &	getElementSet (int) const
	Returns an indexed predefined element set.
virtual bool	getElementSet (int, std::string &) const
	Returns the name of an indexed predefined element set.
virtual bool	isInElementSet (int, int) const
	Checks if an element is within a predefined element set.
virtual int	parseElemSet (const std::string &, const char *)
	Defines an element set by parsing a list of element numbers.
virtual int	parseElemBox (const std::string &, const std::string &, const char *)
	Defines an element set by parsing a 3D bounding box.
virtual std::pair< size_t, double >	findClosestNode (const Vec3 &) const
	Finds the node that is closest to the given point.
void	printNodes (std::ostream &os) const
	Prints out the nodal coordinates of this patch to the given stream.
void	printElements (std::ostream &os) const
	Prints out element connections of this patch to the given stream.
virtual void	printElmInfo (int, const IntegrandBase *) const
	Prints out additional app-dependent element information.
virtual void	shiftGlobalNodeNums (int nshift)
	Increase all global node numbers by nshift.
void	setGlobalNodeNums (const IntVec &nodes)
	Sets the global node numbers for this patch.
const IntVec &	getMyNodeNums () const
	Returns the actual global node numbers of this patch.
const IntVec &	getGlobalNodeNums () const
	Returns the global node numbers of this patch.
virtual void	shiftGlobalElmNums (int eshift)
	Increase all global element numbers by eshift.
const IntVec &	getGlobalElementNums () const
	Returns the global element numbers of this patch.
void	setActiveElements (IntVec *active)
	Sets the list of active elements during assembly.
bool	isElementActive (int iel, double time=-1.0) const
	Returns true if element with 0-based index iel is active.
bool	inActive (double time) const
	Returns true if none of the elements in the patch are active.
double	getAge (int iel, double time) const
	Returns the age of the element with 0-based index iel.
bool	isElementInPartition (int iel) const
	Returns true if element is in process partition. More...
const IntVec &	getElementNodes (int iel) const
	Returns the nodal point correspondance array for an element. More...
virtual size_t	getNoBasis () const
	Returns number of bases of this patch.
virtual size_t	getNoNodes (int basis=0) const
	Returns the total number of nodes in this patch.
size_t	getNoElms (bool includeZeroVolElms=false, bool includeXElms=false) const
	Returns the total number of elements in this patch. More...
int	getMaxElmNo () const
	Returns the highest external element number in this patch.
virtual size_t	getNoBoundaryElms (char, char) const
	Returns the number of elements on a boundary.
size_t	getNoMPCs () const
	Returns the total number of multi-point constraint equations.
virtual void	getNoIntPoints (size_t &nPt, size_t &nIPt)
	Computes the total number of integration points in this patch.
virtual void	getNoBouPoints (size_t &nPt, char ldim, char lindx)
	Computes the number of boundary integration points in this patch.
BCVec::const_iterator	begin_BC () const
	Returns the beginning of the BCode array.
BCVec::const_iterator	end_BC () const
	Returns the end of the BCode array.
IntMat::const_iterator	begin_elm () const
	Returns the beginning of the MNPC array.
IntMat::const_iterator	end_elm () const
	Returns the end of the MNPC array.
MPCIter	begin_MPC () const
	Returns the beginning of the mpcs set.
MPCIter	end_MPC () const
	Returns the end of the mpcs set.
MPC *	findMPC (int node, int dof) const
	Returns a pointer to the MPC object for a specified slave, if any. More...
bool	isShared () const
	Returns true if this patch shares FE data with another patch.
bool	hasXNodes () const
	Returns true if this patch has additional (extraordinary) nodes.
virtual IntMat	getElmNodes (int) const
	Returns the matrix of nodal point correspondance for given basis.
virtual void	copyParameterDomain (const ASMbase *)
	Copies the parameter domain from another patch.
virtual void	closeBoundaries (int dir=1, int basis=0, int master=1)
	Makes two opposite boundaries periodic. More...
bool	mergeNodes (size_t inod, int globalNum, bool verbose=true)
	Merges a given node in this patch with a given global node. More...
int	renumberNodes (std::map< int, int > &old2new, int &nNod)
	Renumbers the global node numbers in this patch. More...
bool	renumberNodes (const std::map< int, int > &old2new, const std::vector< int > &new2old={}, int renumGN=0, std::map< int, int > *degenElm=nullptr)
	Renumbers the global node numbers referred by this patch. More...
virtual bool	initConstraints ()
	Initializes the multi-point constraint coefficients.
virtual void	setNodeNumbers (const IntVec &nodes)
	Sets the global node numbers for this patch. More...
bool	hasTimeDependentDirichlet (const std::map< int, RealFunc * > &func, const std::map< int, VecFunc * > &vfunc)
	Checks for time-dependent in-homogeneous Dirichlet conditions. More...
virtual bool	updateDirichlet (const std::map< int, RealFunc * > &func, const std::map< int, VecFunc * > &vfunc, double time=0.0, const std::map< int, int > *g2l=nullptr)
	Updates the time-dependent in-homogeneous Dirichlet coefficients. More...
virtual void	initMADOF (const int *)
	Initializes the patch level MADOF array for mixed problems.
virtual void	generateThreadGroups (const Integrand &, bool, bool)
	Generates element groups for multi-threading of interior integrals.
virtual void	generateThreadGroups (char, bool, bool)
	Generates element groups for multi-threading of boundary integrals.
virtual void	generateThreadGroupsFromElms (const IntVec &)
	Generates element groups for multi-threading based on a partition.
virtual void	generateProjThreadGroupsFromElms (const IntVec &)
	Generates element groups for multi-threading based on a partition.
virtual bool	validateThreadGroups (const SAM *) const
	Validates the threading groups based on the assembly data in SAM.
virtual void	changeNumThreads ()
	Hook for changing number of threads.
virtual bool	integrateEdge (Integrand &integrand, int lEdge, GlobalIntegral &glbInt, const TimeDomain &time)
	Evaluates a boundary integral over a patch edge. More...
virtual bool	integrate (Integrand &integrand, GlobalIntegral &glbInt, const TimeDomain &time, const ASM::InterfaceChecker &iChk)
	Evaluates an integral over element interfaces in the patch. More...
virtual bool	diracPoint (Integrand &integrand, GlobalIntegral &glbInt, const double *u, const Vec3 &p)
	Integrates a spatial dirac-delta function over a patch. More...
virtual ElementBlock *	immersedGeometry (char *) const
	Returns an additional geometry to visualize (immersed boundaries).
virtual ElementBlock *	extraGeometry (char *) const
	Returns an additional geometry to visualize (spiders, etc.).
virtual void	filterResults (Matrix &, const ElementBlock *) const
	Filters out result point values that are outside physical domain.
virtual bool	getSolution (Matrix &sField, const Vector &locSol, const IntVec &nodes) const
	Extract the primary solution field at the specified nodes. More...
virtual bool	immersedSolution (Matrix &, const Vector &) const
	Evaluates the primary solution at the immersed geometry points.
virtual bool	extraSolution (Matrix &, const Vector &) const
	Evaluates the primary solution at the extra geometry points.
virtual bool	evalProjSolution (Matrix &sField, const Vector &locSol, const int *npe, int n_f=0) const
	Evaluates the projected solution field at all visualization points. More...
virtual bool	evalSolution (Matrix &sField, const Vector &locSol, const RealArray *gpar, bool regular=true, int deriv=0, int n_f=0) const
	Evaluates the primary solution field at the given points. More...
virtual bool	evalSolutionPiola (Matrix &sField, const Vector &locSol, const RealArray *gpar, bool regular) const
	Evaluates the primary solution field with Piola mapping. More...
virtual bool	evaluate (const ASMbase *basis, const Vector &locVec, RealArray &vec, int basisNum=1) const
	Evaluates and interpolates a field over a given geometry. More...
virtual bool	evaluate (const Field *f, RealArray &vec, int basisNum=1) const
	Evaluates and interpolates a scalar field over a given geometry. More...
virtual bool	evaluate (const FunctionBase *f, RealArray &vec, int basisNum=1, double time=0.0) const
	Evaluates and interpolates a scalar function over a given geometry. More...
virtual bool	evalSolution (Matrix &sField, const IntegrandBase &integrand, const int *npe=nullptr, char project=0) const
	Evaluates the secondary solution field at all visualization points. More...
virtual bool	evalSolution (Matrix &sField, const IntegrandBase &integrand, const RealArray *gpar, bool regular=true) const
	Evaluates the secondary solution field at the given points. More...
virtual bool	evalSolution (Matrix &sField, const IntegrandBase &integrand, const IntVec &elements) const
	Evaluates the secondary solution field at element centers. More...
bool	globalL2projection (Matrix &sField, const L2Integrand &integrand, bool continuous=false, bool enforceEnds=false) const
	Projects the secondary solution using a (discrete) global L2-fit. More...
bool	L2projection (Matrix &sField, IntegrandBase *integrand, const TimeDomain &time)
	Projects the secondary solution using a continuous global L2-fit. More...
bool	L2projection (Matrix &fVals, FunctionBase *function, double t=0.0)
	Projects an explicit function using a continuous global L2-fit. More...
bool	L2projection (const std::vector< Matrix * > &fVals, const std::vector< FunctionBase * > &function, double t=0.0)
	Projects explicit functions using a continuous global L2-fit. More...
virtual size_t	getNoProjectionNodes () const
	Returns the number of projection nodes for this patch.
virtual size_t	getNoRefineNodes () const
	Returns the number of nodes on refinement basis for this patch.
virtual size_t	getNoRefineElms () const
	Returns the number of elements on refinement basis for this patch.
virtual Field *	getProjectedField (const Vector &) const
	Returns a field using the projection basis.
virtual Fields *	getProjectedFields (const Vector &, size_t) const
	Returns a field using the projection basis.
virtual bool	createProjectionBasis (bool)
	Creates a separate projection basis for this patch.
virtual bool	separateProjectionBasis () const
	Checks if a separate projection basis is used for this patch.
virtual void	swapProjectionBasis ()
	Swap between main and alternative projection basis.
virtual void	extractElmRes (const Vector &globRes, Vector &elmRes, size_t internalFirst=0) const
	Extracts element results for this patch from a global vector. More...
virtual void	extractElmRes (const Matrix &globRes, Matrix &elmRes, size_t internalFirst=0) const
	Extracts element results for this patch from a global vector. More...
bool	extractNodalVec (const RealArray &globVec, RealArray &nodeVec, const int *madof, int ngnod=-1) const
	Extracts nodal results for this patch from the global vector. More...
virtual void	extractNodeVec (const RealArray &globVec, RealArray &nodeVec, unsigned char nndof=0, int basis=0) const
	Extracts nodal results for this patch from the global vector. More...
virtual bool	injectNodeVec (const RealArray &nodeVec, RealArray &globVec, unsigned char nndof=0, int basis=0) const
	Injects nodal results for this patch into the global vector. More...
bool	injectNodalVec (const RealArray &nodeVec, RealArray &globVec, const IntVec &madof, int basis=0) const
	Injects nodal results for this patch into the global vector. More...
bool	add2PC (int slave, int dir, int master, int code=0)
	Creates and adds a two-point constraint to this patch. More...
bool	addMPC (MPC *&mpc, int code=0, bool verbose=false, bool overrideD=false)
	Adds a general multi-point-constraint (MPC) equation to this patch. More...
virtual bool	addRigidCpl (int lindx, int ldim, int basis, int &gMaster, const Vec3 &Xmaster, bool extraPt=true)
	Adds MPC-equations representing a rigid coupling to this patch. More...
void	addRigidCouplings (int gMaster, const Vec3 &Xmaster, const IntVec &slaveNodes)
	Adds MPC-equations representing a rigid coupling to this patch. More...
void	constrainPatch (int dof, int code=0)
	Constrains all nodes in the patch. More...
void	constrainNodes (const IntVec &nodes, int dof, int code=0, bool overrideD=false)
	Constrains a list of nodes in the patch. More...
bool	constrainXnode (int node, int dof, int code=0)
	Constrains an extraordinary node in the patch. More...
int	prescribe (size_t inod, int dirs, int code, bool overrideD=false)
	Constrains DOFs in the given node to the given value. More...
int	fix (size_t inod, int dirs=123)
	Constrains DOFs in the given node to zero. More...
bool	isFixed (int node, int dof, bool all=false) const
	Checks if the given DOFs are fixed. More...

Private Attributes
Vec3Vec	myNodes
	Supernode coordinates.
ElmMats	myElmMat
	Duperelement matrices.
std::vector< ASM::NodeSet >	nodeSets
	Node sets for Dirichlet BCs.

Additional Inherited Members
Public Types inherited from ASMbase
using	BCVec = std::vector< BC >
	Nodal boundary condition container.
Static Public Member Functions inherited from ASMbase
static void	resetNumbering (int n=0)
	Resets the global element and node counters.
static int	renumberNodes (const ASMVec &model, std::map< int, int > &old2new)
	Renumbers all global node numbers in the entire model. More...
static void	mergeAndGetAllMPCs (const ASMVec &model, MPCSet &allMPCs)
	Computes the set of all MPC-equations over the whole model. More...
static void	resolveMPCchains (const MPCSet &allMPCs, const ASMVec &model, bool setPtrOnly=false)
	Resolves (possibly multi-level) chaining in MPC-equations. More...
Public Attributes inherited from ASMbase
size_t	idx
	Index of this patch in the multi-patch model.
Static Public Attributes inherited from ASMbase
static bool	fixHomogeneousDirichlet = true
	If true, pre-eliminate fixed DOFs.
static int	dbgElm = 0
	One-based element index to print debugging info for.
static double	modelSize = 1.0
	Characteristic model size. More...
Protected Types inherited from ASMbase
using	XYZ = std::array< double, 3 >
	Convenience type definition.
Protected Member Functions inherited from ASMbase
	ASMbase (unsigned char n_p, unsigned char n_s, unsigned char n_f)
	The constructor sets the number of space dimensions and fields. More...
	ASMbase (const ASMbase &patch, unsigned char n_f)
	Special copy constructor for sharing of FE data. More...
	ASMbase (const ASMbase &patch)
	Default copy constructor, copying everything except neighbors. More...
void	addLocal2GlobalCpl (int iSlave, int master, const Tensor &Tlg)
	Creates constraint equations coupling global DOFs to local DOFs. More...
bool	add3PC (int slave, int dir, int master1, int master2, int code=0)
	Creates and adds a three-point constraint to this patch. More...
bool	addPeriodicity (size_t master, size_t slave, int dir)
	Creates and adds a periodicity constraint to this patch. More...
void	makePeriodic (size_t master, size_t slave, int dirs=123)
	Creates periodicity constraints between two nodes in this patch. More...
void	addNeighbor (ASMbase *pch)
	Adds a patch to the list of neighbors of this patch. More...
bool	createRgdMasterNode (int &gMaster, const Vec3 &Xmaster)
	Creates an additional master node for a rigid coupling. More...
void	addRigidMPC (int gSlave, int gMaster, const Vec3 &dX)
	Adds MPC-equations representing a rigid arm to a 6-DOF node. More...
int	getNoGaussPt (int p, bool neumann=false) const
	Returns the number of Gauss points to use in one direction. More...
int	searchCtrlPt (RealArray::const_iterator cit, RealArray::const_iterator end, const Vec3 &X, int dimension, double tol=0.001) const
	Helper method used by evalPoint to search for a control point. More...
virtual bool	assembleL2matrices (SystemMatrix &A, SystemVector &B, const L2Integrand &obj, bool continuous) const
	Assembles L2-projection matrices for the secondary solution. More...
bool	allDofs (int dirs) const
	Returns true if dirs constains all local DOFs in the patch.
bool	writeLagBasis (std::ostream &os, const char *type) const
	Writes a Lagrangian basis to the given stream.
Static Protected Member Functions inherited from ASMbase
static bool	deformedConfig (const Matrix &Xnod, Vectors &eVec, bool force2nd=false)
	Calculates the deformed configuration for current element. More...
static bool	collapseNodes (ASMbase &pch1, int node1, ASMbase &pch2, int node2)
	Collapses the given two nodes into one. More...
Protected Attributes inherited from ASMbase
unsigned char	ndim
	Number of parametric dimensions (1, 2 or 3)
unsigned char	nsd
	Number of space dimensions (ndim <= nsd <= 3)
unsigned char	nf
	Number of primary solution fields (1 or larger)
unsigned char	nLag
	Number of Lagrange multipliers per node.
size_t	nel
	Number of regular elements in this patch.
size_t	nnod
	Number of regular nodes in this patch.
const IntVec &	MLGE
	Matrix of Local to Global Element numbers.
const IntVec &	MLGN
	Matrix of Local to Global Node numbers.
const IntMat &	MNPC
	Matrix of Nodal Point Correspondance.
const char	shareFE
	Flag telling whether this patch shares its data with another patch. More...
BCVec	BCode
	Array of Boundary Condition codes.
MPCMap	dCode
	Inhomogeneous Dirichlet condition codes for the MPCs.
MPCSet	mpcs
	All multi-point constraints with the slave in this patch.
IntVec	myMLGE
	The actual Matrix of Local to Global Element numbers.
IntVec	myMLGN
	The actual Matrix of Local to Global Node numbers.
IntMat	myMNPC
	The actual Matrix of Nodal Point Correspondance.
IntVec	myElms
	Elements on patch - used with partitioning.
int	nGauss
	Numerical integration scheme for this patch. More...
size_t	firstEl
	Global index to first element within this patch.
size_t	firstIp
	Global index to first interior integration point.
std::map< char, size_t >	firstBp
	Global indices to first integration point for the Neumann boundaries.
ASMVec	neighbors
	Patches having nodes in common with this one.
std::map< size_t, XYZ >	myRmaster
	Rigid master nodal points.
Static Protected Attributes inherited from ASMbase
static std::map< int, int >	xNode
	Auxilliary node number map used when establishing Dirichlet constraints.
static int	gEl = 0
	Global element counter.
static int	gNod = 0
	Global node counter.

Detailed Description

Driver for assembly of general superelements.

This class contains methods for assembly of superelements resulting from static condensation or reduced order modeling.

Member Function Documentation

evalSolution() [1/6]

bool ASMbase::evalSolution

Evaluates the secondary solution field at all visualization points.

Parameters

[out]	sField	Solution field
[in]	integrand	Object with problem-specific data and methods
[in]	npe	Number of visualization nodes over each knot span
[in]	project	Flag indicating result recovery method

The secondary solution is derived from the primary solution, which is assumed to be stored within the integrand for current patch. If npe is null, the solution is recovered or evaluated at the Greville points and then projected onto the spline basis to obtain the control point values, which then are returned through sField. If npe is not null and project is defined, the solution is also projected onto the spline basis, and then evaluated at the npe points.

evalSolution() [2/6]

bool ASMbase::evalSolution

Evaluates the secondary solution field at element centers.

Parameters

[out]	sField	Solution field
[in]	integrand	Object with problem-specific data and methods
[in]	elements	List of elements to evaluate for (all if empty)

The secondary solution is derived from the primary solution, which is assumed to be stored within the integrand for current patch. This method evaluates the secondary solution at the center of the provided list of elements, or for all if the list is empty.

evalSolution() [3/6]

bool ASMbase::evalSolution

Evaluates the secondary solution field at the given points.

Parameters

[out]	sField	Solution field
[in]	integrand	Object with problem-specific data and methods
[in]	gpar	Parameter values of the result sampling points
[in]	regular	Flag indicating how the sampling points are defined

The secondary solution is derived from the primary solution, which is assumed to be stored within the integrand for current patch. When regular is true, it is assumed that the parameter value array gpar forms a regular tensor-product point grid of dimension gpar[0].size() X gpar[1].size() X gpar[2].size(). Otherwise, we assume that it contains the u, v and w parameters directly for each sampling point.

evalSolution() [4/6]

bool ASMsupel::evalSolution ( Matrix &  sField, const Vector &  locSol, const int *  , int  , bool    ) const

virtual

Evaluates the primary solution field at all visualization points.

Parameters

[out]	sField	Solution field
[in]	locSol	Solution vector local to current patch

Reimplemented from ASMbase.

References ASMbase::nnod, utl::matrix< T >::resize(), and utl::vector< T >::size().

evalSolution() [5/6]

bool ASMbase::evalSolution

Evaluates the primary solution field at all visualization points.

Parameters

[out]	sField	Solution field
[in]	locSol	Solution vector local to current patch
[in]	npe	Number of visualization nodes over each knot span
[in]	n_f	If nonzero, mixed evaluates n_f fields on first basis
[in]	piola	If true, use piola mapping

evalSolution() [6/6]

bool ASMbase::evalSolution

Evaluates the primary solution field at the given points.

Parameters

[out]	sField	Solution field
[in]	locSol	Solution vector local to current patch
[in]	gpar	Parameter values of the result sampling points
[in]	regular	Flag indicating how the sampling points are defined
[in]	deriv	Derivative order to return
[in]	n_f	If nonzero, mixed evaluates n_f fields on first basis

When regular is true, it is assumed that the parameter value array gpar forms a regular tensor-product point grid of dimension gpar[0].size() X gpar[1].size() X gpar[2].size(). Otherwise, we assume that it contains the u, v and w parameters directly for each sampling point.

getBoundaryNodes()

void ASMsupel::getBoundaryNodes ( int  lIndex, IntVec &  nodes, int  , int  , int  , bool  local  ) const

virtual

Finds the global (or patch-local) node numbers on a patch boundary.

Parameters

[in]	lIndex	Local index of the boundary face/edge
	nodes	Array of node numbers
[in]	local	If true, return patch-local numbers

Implements ASMbase.

References ASMbase::getNodeID(), and getNodeSet().

getCoord()

Vec3 ASMsupel::getCoord ( size_t  inod ) const

virtual

Returns the global coordinates for the given node.

Parameters

[in]

inod

1-based node index local to current patch. If inod is 0, the centroid of the patch is returned.

Implements ASMbase.

References myNodes, and ASMbase::nnod.

Referenced by tesselate(), and write().

getElementCoordinates()

bool ASMsupel::getElementCoordinates ( Matrix &  X, int  iel, bool  = false  ) const

virtual

Returns a matrix with nodal coordinates for an element.

Parameters

[in]	iel	1-based element index local to current patch
[out]	X	3 \(\times\)n-matrix, where n is the number of nodes in one element

Implements ASMbase.

References getNodalCoordinates().

getNodalCoordinates()

void ASMsupel::getNodalCoordinates ( Matrix &  X, bool  = false  ) const

virtual

Returns a matrix with all nodal coordinates within the patch.

Parameters

[out]

X

nsd \(\times\)n-matrix, where n is the number of nodes in the patch

Implements ASMbase.

References myNodes, ASMbase::nnod, and utl::matrix< T >::resize().

Referenced by getElementCoordinates().

integrate()

bool ASMsupel::integrate ( Integrand &  integrand, GlobalIntegral &  glbInt, const TimeDomain &    )

virtual

Evaluates an integral over the interior patch domain.

Parameters

integrand	Object with problem-specific data and methods
glbInt	The integrated quantity

Implements ASMbase.

References GlobalIntegral::assemble(), Integrand::getMode(), ASMbase::MLGE, myElmMat, and ElmMats::rhsOnly.

tesselate()

bool ASMsupel::tesselate ( ElementBlock &  grid, const int *    ) const

virtual

Creates a standard FE model of this patch for visualization.

Parameters

[out]

grid

The generated finite element grid

This method creates a simplified visualization of the superelement as lines extending from the centroid to each of the supernodes.

Implements ASMbase.

References getCoord(), myNodes, ASMbase::nnod, ElementBlock::setCoor(), ElementBlock::setElmId(), ElementBlock::setNode(), and ElementBlock::unStructResize().

---

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

• src/ASM/ASMsupel.h
• src/ASM/ASMsupel.C