Assembly of unstructured 2D spline FE models with immersed boundaries. More...

#include <ASMu2DIB.h>

Inheritance diagram for ASMu2DIB:

[legend]

Collaboration diagram for ASMu2DIB:

[legend]

Public Member Functions
	ASMu2DIB (unsigned char n_s=2, unsigned char n_f=1, int max_depth=5)
	Default constructor.

	ASMu2DIB (const ASMu2DIB &patch, unsigned char n_f=0)
	Copy constructor.

virtual	~ASMu2DIB ()
	The destructor deletes the dynamically allocated geometry object.

virtual void	addHole (double R, double Xc, double Yc)
	Adds a circular hole in the physical geometry. More...

virtual void	addHole (double R, double X1, double Y1, double X2, double Y2)
	Adds an oval hole in the physical geometry. More...

virtual bool	setGeometry (RealFunc *f, double power, double threshold)
	Defines the immersed geometry from a scalar function. More...

virtual ElementBlock *	immersedGeometry (char *name) const
	Returns an additional geometry to visualize (immersed boundaries).

virtual void	getNoIntPoints (size_t &nPt, size_t &nIPt)
	Computes the total number of integration points in this patch.

virtual bool	generateFEMTopology ()
	Generates the finite element topology data for the patch. More...

virtual bool	integrate (Integrand &integrand, GlobalIntegral &glbInt, const TimeDomain &time)
	Evaluates an integral over the interior patch domain. More...

virtual void	filterResults (Matrix &field, const ElementBlock *grid) const
	Filters out result point values that are outside physical domain. More...

virtual bool	integrate (Integrand &integrand, GlobalIntegral &glbInt, const TimeDomain &time)
	Evaluates an integral over the interior patch domain. More...

virtual bool	integrate (Integrand &integrand, int lIndex, 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...

bool	integrate (Integrand &integrand, GlobalIntegral &glbInt, const TimeDomain &time, const Real3DMat &itgPts)
	Evaluates an integral over the interior patch domain. More...

virtual bool	integrate (Integrand &integrand, GlobalIntegral &glbInt, const TimeDomain &time)=0
	Evaluates an integral over the interior patch domain. More...

virtual bool	integrate (Integrand &integrand, int lIndex, GlobalIntegral &glbInt, const TimeDomain &time)=0
	Evaluates a boundary integral over a patch face/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...

Public Member Functions inherited from ASMu2D
	ASMu2D (unsigned char n_s=2, unsigned char n_f=2)
	Default constructor.

	ASMu2D (const ASMu2D &patch, unsigned char n_f=0)
	Copy constructor.

virtual	~ASMu2D ()
	Empty destructor.

virtual const LR::LRSplineSurface *	getBasis (int basis=1) const
	Returns the spline surface representing a basis of this patch.

virtual LR::LRSplineSurface *	getBasis (int basis=1)
	Returns the spline surface representing a basis of this patch.

virtual bool	read (std::istream &)
	Creates an instance by reading the given input stream.

virtual bool	write (std::ostream &, int) const
	Writes the geometry of the SplineSurface object to given stream.

virtual void	clear (bool retainGeometry=false)
	Clears the contents of the patch, making it empty. More...

virtual bool	getElementCoordinates (Matrix &X, int iel, bool forceItg=false) const
	Returns a matrix with nodal coordinates for an element. More...

virtual void	getElmConnectivities (IntMat &neighs, int basis=ASM::INTEGRATION_BASIS) const
	Calculates the matrix of element neighbour connectivities. More...

virtual IntMat	getElmNodes (int basis) const
	Returns the matrix of nodal point correspondance for given basis.

virtual void	getNodalCoordinates (Matrix &X, bool=false) const
	Returns a matrix with all nodal coordinates within the patch. More...

virtual Vec3	getCoord (size_t inod) const
	Returns the global coordinates for the given node. More...

virtual bool	updateCoords (const Vector &displ)
	Updates the nodal coordinates for this patch. More...

virtual void	getBoundaryNodes (int lIndex, IntVec &nodes, int basis, int=1, int orient=0, bool local=false) const
	Finds the global (or patch-local) node numbers on a patch boundary. More...

virtual bool	getOrder (int &p1, int &p2, int &p3) const
	Returns the polynomial order in each parameter direction. More...

virtual size_t	getNoNodes (int basis=0) const
	Returns the total number of nodes in this patch.

virtual size_t	getNoProjectionNodes () const
	Returns the number of projection nodes for this patch.

bool	diagonalRefine (int minBasisfunctions)
	Refines along the diagonal of the LR-spline patch. More...

bool	cornerRefine (int minBasisfunctions)
	Refines the lower-left corner of the LR-spline patch. More...

bool	uniformRefine (int minBasisfunctions)
	Refines the LR-spline patch uniformly. More...

virtual bool	uniformRefine (int dir, int nInsert)
	Refines the parametrization by inserting tensor knots uniformly. More...

virtual bool	refine (int dir, const RealArray &xi, double scale)
	Refines the parametrization by inserting extra tensor knots. More...

virtual bool	refine (const LR::RefineData &prm, Vectors &sol)
	Refines the mesh adaptively. More...

virtual bool	raiseOrder (int ru, int rv)
	Raises the order of the tensor spline object for this patch. More...

virtual bool	createProjectionBasis (bool init)
	Creates a separate projection basis for this patch. More...

virtual void	setMinimumSize (double size)
	Sets the minimum element area for adaptive refinement.

virtual double	getMinimumSize (int nrefinements) const
	Defines the minimum element area for adaptive refinement. More...

virtual bool	checkElementSize (int elmId, bool globalNum=true) const
	Checks if the specified element is larger than the minimum size. More...

virtual void	extractElmRes (const Matrix &globRes, Matrix &elmRes, size_t internalFirst) const
	Extracts element results for this patch from a global vector. More...

void	copyRefinement (LR::LRSplineSurface *basis, int multiplicity=1) const
	Copies the refinement to another surface. More...

virtual void	constrainEdge (int dir, bool open, int dof, int code, char basis)
	Constrains all DOFs on a given boundary edge. More...

virtual size_t	constrainEdgeLocal (int dir, bool open, int dof, int code, bool project=false)
	Constrains all DOFs in local directions on a given boundary edge. More...

virtual void	constrainCorner (int I, int J, int dof, int code=0, char basis=1)
	Constrains a corner node identified by the two parameter indices. More...

virtual void	constrainNode (double xi, double eta, int dof, int code=0)
	Constrains a node identified by two relative parameter values. More...

virtual bool	connectPatch (int edge, ASM2D &neighbor, int nedge, bool revers, int=0, bool coordCheck=true, int thick=1)
	Connects all matching nodes on two adjacent boundary edges. More...

virtual bool	integrate (Integrand &integrand, int lIndex, 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 *param, const Vec3 &pval)
	Integrates a spatial dirac-delta function over a patch. More...

virtual bool	updateDirichlet (const std::map< int, RealFunc * > &func, const std::map< int, VecFunc * > &vfunc, double time, const std::map< int, int > *g2l=nullptr)
	Updates the time-dependent in-homogeneous Dirichlet coefficients. More...

virtual int	getCorner (int I, int J, int basis) const
	Returns the node index for a given corner. More...

virtual int	evalPoint (const double xi, double param, Vec3 &X) const
	Evaluates the geometry at a specified point. More...

virtual int	findElementContaining (const double *param) const
	Returns the element that contains a specified spatial point. More...

virtual double	findPoint (Vec3 &X, double *param) const
	Searches for the specified Cartesian point in the patch. More...

virtual bool	getGridParameters (RealArray &prm, int dir, int nSegSpan) const
	Calculates parameter values for visualization nodal points. More...

virtual bool	tesselate (ElementBlock &grid, const int *npe) const
	Creates a quad element model of this patch for visualization. More...

virtual bool	evalSolution (Matrix &sField, const Vector &locSol, const int *npe, int n_f, bool piola) const
	Evaluates the primary solution field at all visualization points. More...

virtual bool	evalSolution (Matrix &sField, const Vector &locSol, const RealArray *gpar, bool=false, int deriv=0, int=0) const
	Evaluates the primary solution field at the given points. More...

virtual bool	evalProjSolution (Matrix &sField, const Vector &locSol, const int *npe, int n_f) const
	Evaluates the projected solution field at all visualization points. More...

virtual bool	evaluate (const FunctionBase *func, RealArray &vec, int, double time) const
	Evaluates and interpolates a function over a given geometry. More...

virtual bool	evalSolution (Matrix &sField, const IntegrandBase &integrand, const int *npe, char project='\0') const
	Evaluates the secondary solution field at all visualization points. More...

virtual bool	separateProjectionBasis () const
	Checks if a separate projection basis is used for this patch.

virtual Field *	getProjectedField (const Vector &coefs) const
	Returns a field using the projection basis. More...

virtual Fields *	getProjectedFields (const Vector &coefs, size_t=0) const
	Returns a field using the projection basis. More...

virtual void	storeMesh (const std::string &fName, int fType) const
	Stores the mesh basis to encapsulated postscript files. More...

void	setOutputMaster (const ASMu2D *pch)
	Set master patch for VTF output. More...

virtual LR::LRSpline *	evalSolution (const IntegrandBase &integrand) const
	Projects the secondary solution field onto the primary basis. More...

virtual bool	evalSolution (Matrix &sField, const IntegrandBase &integrand, const RealArray *gpar, bool=false) const
	Evaluates the secondary solution field at the given points. More...

bool	edgeL2projection (const DirichletEdge &edge, const FunctionBase &values, Real2DMat &result, double time) const
	Projects inhomogenuous dirichlet conditions by continuous L2-fit. More...

virtual bool	transferGaussPtVars (const LR::LRSpline *old_basis, const RealArray &oldVar, RealArray &newVar, int nGauss) const
	Transfers Gauss point variables from old basis to this patch. More...

virtual bool	transferGaussPtVarsN (const LR::LRSpline *old_basis, const RealArray &oldVar, RealArray &newVar, int nGauss) const
	Transfers Gauss point variables from old basis to this patch. More...

virtual bool	transferCntrlPtVars (const LR::LRSpline *old_basis, RealArray &newVar, int nGauss) const
	Transfers control point variables from old basis to this patch. More...

virtual size_t	getNoBoundaryElms (char lIndex, char ldim) const
	Returns the number of elements on a boundary.

bool	rational () const
	Query whether basis is rational or not.

virtual bool	refine (const LR::RefineData &prm, Vectors &sol)
	Refines the mesh adaptively. More...

virtual bool	integrate (Integrand &integrand, GlobalIntegral &glbInt, const TimeDomain &time)=0
	Evaluates an integral over the interior patch domain. More...

virtual bool	integrate (Integrand &integrand, int lIndex, GlobalIntegral &glbInt, const TimeDomain &time)=0
	Evaluates a boundary integral over a patch face/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	transferCntrlPtVars (const LR::LRSpline *oldBasis, RealArray &newVar, int nGauss) const=0
	Transfers control point variables from old basis to this patch. More...

bool	transferCntrlPtVars (LR::LRSpline *oldBasis, const RealArray &oldVar, RealArray &newVar, int nGauss, int nf=1) const
	Transfers control point variables from old basis to this patch. More...

Public Member Functions inherited from ASMLRSpline
virtual	~ASMLRSpline ()
	Empty destructor.

virtual bool	empty () const
	Checks if the patch is empty.

virtual bool	getParameterDomain (Real2DMat &, IntVec *) const
	Returns parameter values and node numbers of the domain corners.

const LR::LRSpline *	getRefinementBasis () const
	Returns a const pointer to refinement basis.

IntVec	getFunctionsForElements (const IntVec &elements, bool globalId=false) const
	Returns a list of basis functions having support on given elements.

void	getFunctionsForElements (IntSet &functions, const IntVec &elements, bool globalId=true) const
	Returns a list of basis functions having support on given elements.

virtual IntVec	getBoundaryCovered (const IntSet &nodes) const
	Returns all boundary functions that are covered by the given nodes. More...

IntVec	getOverlappingNodes (const IntSet &nodes, int dir=7) const
	Returns all functions whose support overlap with the input nodes. More...

IntVec	getOverlappingNodes (int node, int dir=7) const
	Returns all functions whose support overlap with the input node. More...

bool	transferCntrlPtVars (LR::LRSpline *oldBasis, const RealArray &oldVar, RealArray &newVar, int nGauss, int nf=1) const
	Transfers control point variables from old basis to this patch. More...

virtual std::pair< size_t, double >	findClosestNode (const Vec3 &X) const
	Finds the node that is closest to the given point X.

virtual Vec3	getElementCenter (int iel) const
	Returns the coordinates of the element center.

virtual void	swapProjectionBasis ()
	Swaps between the first and second projection basis.

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

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 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 int	getNodeSetIdx (const std::string &) const
	Returns (1-based) index of a predefined node set in the patch.

virtual const IntVec &	getNodeSet (int) const
	Returns an indexed predefined node set.

virtual bool	isInNodeSet (int, int) const
	Checks if a node is within a predefined node set.

virtual int	parseNodeSet (const std::string &, const char *)
	Defines a node set by parsing a list of node numbers.

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.

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.

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.

size_t	getNoMPCs () const
	Returns the total number of multi-point constraint equations.

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 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	transform (const Matrix &)
	Applies a transformation matrix from local to global system.

virtual void	initMADOF (const int *)
	Initializes the patch level MADOF array for mixed problems.

virtual void	generateThreadGroups (char, bool, bool)
	Generates element groups for multi-threading of boundary integrals.

virtual bool	validateThreadGroups (const SAM *) const
	Validates the threading groups based on the assembly data in SAM.

virtual bool	integrateEdge (Integrand &integrand, int lEdge, GlobalIntegral &glbInt, const TimeDomain &time)
	Evaluates a boundary integral over a patch edge. More...

virtual ElementBlock *	extraGeometry (char *) const
	Returns an additional geometry to visualize (spiders, etc.).

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	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	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	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 void	extractElmRes (const Vector &globRes, Vector &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...

Public Member Functions inherited from ASMunstruct
virtual	~ASMunstruct ()
	Empty destructor.

Public Member Functions inherited from ASM2D
virtual	~ASM2D ()
	Empty destructor.

ASMbase *	clone (const CharVec &nf=CharVec()) const
	Returns a copy of this patch with identical FE discretization. More...

virtual bool	checkRightHandSystem ()
	Checks that the patch is modelled in a right-hand-side system.

virtual bool	refine (int dir, const std::vector< double > &xi, double scale=1.0)=0
	Refines the parametrization by inserting extra knots. More...

virtual bool	getGridParameters (std::vector< double > &prm, int dir, int nSegSpan) const =0
	Calculates parameter values for visualization nodal points. More...

Private Attributes
Immersed::Geometry *	myGeometry
	The physical geometry description.

Real3DMat	quadPoints
	The Gauss quadrature points for this patch.

int	maxDepth
	Maximum depth up to which to refine each element.

Additional Inherited Members
Public Types inherited from ASMbase
using	BCVec = std::vector< BC >
	Nodal boundary condition container.

Public Types inherited from ASM2D
typedef std::vector< unsigned char >	CharVec
	Convenience type.

Static Public Member Functions inherited from ASMu2D
static void	computeBasisNurbs (double u, double v, Go::BasisPtsSf &bas, int iel, const LR::LRSplineSurface &spline)
	Evaluate NURBS basis functions in a point.

static void	computeBasisNurbs (double u, double v, Go::BasisDerivsSf &bas, int iel, const LR::LRSplineSurface &spline)
	Evaluate NURBS basis functions and first derivatives in a point.

static void	computeBasisNurbs (double u, double v, Go::BasisDerivsSf2 &bas, int iel, const LR::LRSplineSurface &spline)
	Evaluate NURBS basis functions and two derivatives in a point.

static void	computeBasisNurbs (double u, double v, Go::BasisDerivsSf3 &bas, int iel, const LR::LRSplineSurface &spline)
	Evaluate NURBS basis functions and three derivatives in a point.

static bool	getCoordinates (Matrix &X, unsigned char nsd, const LR::LRSplineSurface &spline, int iel=-1)
	Returns a matrix with control point coordinates. More...

Static Public Member Functions inherited from ASMLRSpline
static Go::BsplineBasis	getBezierBasis (int p, double start=-1.0, double end=1.0)
	Returns a Bezier basis of order p.

static void	Sort (int u, int v, int orient, std::vector< LR::Basisfunction * > &functions)
	Sort basis functions based on local knot vectors.

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

Static Public Member Functions inherited from ASM2D
static ASMbase *	create (ASM::Discretization type, unsigned char nd, const CharVec &nf, bool mixedFEM=false)
	Creates a two-parametric patch of specified discretization type. More...

static ASMbase *	create (ASM::Discretization type, unsigned char nf=1)
	Creates a two-parametric patch of specified discretization type. 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 ASMu2D
bool	integrate (Integrand &integrand, GlobalIntegral &glbInt, const TimeDomain &time, const Real3DMat &itgPts)
	Evaluates an integral over the interior patch domain. More...

LR::LRSplineSurface *	projectSolution (const IntegrandBase &integrand) const
	Projects the secondary solution field onto the primary basis. More...

LR::LRSplineSurface *	scRecovery (const IntegrandBase &integrand) const
	Projects the secondary solution using a superconvergent approach. More...

LR::LRSplineSurface *	regularInterpolation (const RealArray &upar, const RealArray &vpar, const Matrix &points, int basis) const
	Interpolates an LR spline at a given set of parametric coordinates. More...

virtual void	findBoundaryElms (IntVec &elms, int lIndex, int orient) const
	Finds the patch-local element numbers on a patch boundary. More...

virtual bool	assembleL2matrices (SystemMatrix &A, SystemVector &B, const L2Integrand &integrand, bool continuous) const
	Assembles L2-projection matrices for the secondary solution. More...

bool	connectBasis (int edge, ASMu2D &neighbor, int nedge, bool revers, int basis=1, int slave=0, int master=0, bool coordCheck=true, int thick=1)
	Connects all matching nodes on two adjacent boundary edges. More...

void	getGaussPointParameters (RealArray &uGP, int dir, int nGauss, int iel, const double xi, const LR::LRSplineSurface spline=nullptr) const
	Extracts parameter values of the Gauss points in one direction. More...

bool	getGrevilleParameters (RealArray &prm, int dir, int basisNum=1) const
	Calculates parameter values for the Greville points. More...

double	getParametricLength (int iel, int dir) const
	Returns boundary edge length in the parameter space for an element. More...

double	getElementCorners (int iel, std::vector< Vec3 > &XC, RealArray *uC=nullptr) const
	Computes the element corner coordinates. More...

void	getCornerPoints (int iel, std::vector< utl::Point > &XC) const
	Computes the element corner coordinates and parameters. More...

bool	evaluateBasis (int iel, FiniteElement &fe, int derivs=0) const
	Evaluates the basis functions and derivatives of an element. More...

void	computeBasis (double u, double v, Go::BasisPtsSf &bas, int iel, const LR::LRSplineSurface *spline=nullptr) const
	Evaluate basis functions in a point.

void	computeBasis (double u, double v, Go::BasisDerivsSf &bas, int iel, const LR::LRSplineSurface *spline=nullptr) const
	Evaluate basis functions and first derivatives in a point.

void	computeBasis (double u, double v, Go::BasisDerivsSf2 &bas, int iel, const LR::LRSplineSurface *spline=nullptr) const
	Evaluate basis functions and two derivatives in a point.

void	computeBasis (double u, double v, Go::BasisDerivsSf3 &bas, int iel, const LR::LRSplineSurface *spline=nullptr) const
	Evaluate basis functions and three derivatives in a point.

virtual int	evalPoint (int iel, const double *param, Vec3 &X) const
	Evaluates the geometry at a specified point. More...

void	generateThreadGroups (const Integrand &integrand, bool silence, bool ignoreGlobalLM)
	Generates element groups for multi-threading of interior integrals. More...

virtual void	generateThreadGroupsFromElms (const IntVec &elms)
	Generate element groups from a partition.

virtual void	generateProjThreadGroupsFromElms (const IntVec &elms)
	Generate element groups from a partition.

virtual void	changeNumThreads ()
	Hook for changing number of threads.

virtual void	remapErrors (RealArray &errors, const RealArray &origErr, bool elemErrors) const
	Remap element wise errors to basis functions. More...

virtual void	extendRefinementDomain (IntSet &refineIndices, const IntSet &neighborIndices) const
	Extends the refinement domain with information for neighbors. More...

std::shared_ptr< LR::LRSplineSurface >	createLRfromTensor ()
	Converts current tensor spline object to LR-spline.

void	generateBezierBasis ()
	Generate bezier basis.

void	generateBezierExtraction ()
	Generate bezier extraction operators.

void	writePostscriptElementsNurbs (std::shared_ptr< LR::LRSplineSurface > mesh, std::ostream &out, bool close=true, int nu=2, int nv=2)
	Write NURBS elements as postscript file.

void	writePostscriptMeshWithControlPointsNurbs (std::shared_ptr< LR::LRSplineSurface > mesh, std::ostream &out, int nu=2, int nv=2)
	Write NURBS elements as postscript file.

Protected Member Functions inherited from ASMLRSpline
	ASMLRSpline (unsigned char n_p, unsigned char n_s, unsigned char n_f)
	The constructor sets the space dimensions. More...

	ASMLRSpline (const ASMLRSpline &patch, unsigned char n_f)
	Special copy constructor for sharing of FE data. More...

bool	doRefine (const LR::RefineData &prm, LR::LRSpline *lrspline)
	Refines the mesh adaptively. More...

virtual int	evalPoint (const double xi, double param, Vec3 &X) const=0
	Evaluates the geometry at a specified point. More...

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

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.

Protected Member Functions inherited from ASMunstruct
	ASMunstruct ()
	The constructor is protected to allow objects of sub-classes only.

Protected Member Functions inherited from ASM2D
	ASM2D ()
	The constructor is protected to allow objects of sub-classes only.

Static Protected Member Functions inherited from ASMu2D
static std::shared_ptr< LR::LRSplineSurface >	createLRNurbs (const Go::SplineSurface &srf)
	Converts a rational spline surface to a LR NURBS surface.

Static Protected Member Functions inherited from ASMLRSpline
static bool	checkThreadGroups (const IntMat &groups, const std::vector< const LR::LRSpline * > &bases, const LR::LRSpline *threadBasis)
	Santity check thread groups. More...

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

Static Protected Member Functions inherited from ASM2D
static double	getElementSize (const std::vector< Vec3 > &XC)
	Returns characteristic element size based on corner coordinates.

Protected Attributes inherited from ASMu2D
std::shared_ptr< LR::LRSplineSurface >	lrspline
	The LR-spline surface object.

bool	is_rational = false
	True if basis is rational.

const ASMu2D *	outputMaster = nullptr
	Master patch to use for VTF output.

Go::SplineSurface *	tensorspline
	Pointer to original tensor spline object.

Go::SplineSurface *	tensorPrjBas
	Pointer to tensor spline projection base.

std::vector< DirichletEdge >	dirich
	Inhomogeneous Dirichlet boundary condition data.

const Matrices &	bezierExtract
	Bezier extraction matrices.

Matrices	myBezierExtract
	Bezier extraction matrices.

Go::BsplineBasis	bezier_u
	Bezier basis in the u-direction.

Go::BsplineBasis	bezier_v
	Bezier basis in the v-direction.

std::vector< std::unique_ptr< BasisFunctionCache > >	myCache
	Basis function cache.

Protected Attributes inherited from ASMLRSpline
std::shared_ptr< LR::LRSpline >	geomB
	Pointer to spline object of the geometry basis.

std::shared_ptr< LR::LRSpline >	projB
	Pointer to spline object of the projection basis.

std::shared_ptr< LR::LRSpline >	projB2
	Pointer to spline object of the secondary projection basis.

std::shared_ptr< LR::LRSpline >	refB
	Pointer to spline object of the refinement basis.

ThreadGroups	threadGroups
	Element groups for multi-threaded assembly.

ThreadGroups	projThreadGroups
	Element groups for multi-threaded assembly - projection basis.

ThreadGroups	proj2ThreadGroups
	Element groups for multi-threaded assembly - second projection basis.

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

Assembly of unstructured 2D spline FE models with immersed boundaries.

Member Function Documentation

◆ addHole() [1/2]

void ASMu2DIB::addHole	(	double	R,
		double	X1,
		double	Y1,
		double	X2,
		double	Y2
	)

virtual

Adds an oval hole in the physical geometry.

Parameters

[in]	R	Hole radius
[in]	X1	X-coordinate of the first circle centre
[in]	Y1	Y-coordinate of the first circle centre
[in]	X2	X-coordinate of the second circle centre
[in]	Y2	Y-coordinate of the second circle centre

Reimplemented from ASMbase.

References PerforatedPlate2D::addHole(), and myGeometry.

◆ addHole() [2/2]

void ASMu2DIB::addHole	(	double	R,
		double	Xc,
		double	Yc
	)

virtual

Adds a circular hole in the physical geometry.

Parameters

[in]	R	Hole radius
[in]	Xc	X-coordinate of the hole centre
[in]	Yc	Y-coordinate of the hole centre

Reimplemented from ASMbase.

References PerforatedPlate2D::addHole(), and myGeometry.

◆ filterResults()

void ASMu2DIB::filterResults	(	Matrix &	field,
		const ElementBlock *	grid
	)		const

virtual

Filters out result point values that are outside physical domain.

Parameters

	field	Array of result values
[in]	grid	The visualization grid

Reimplemented from ASMbase.

References Immersed::Geometry::Alpha(), utl::matrix< T >::cols(), ElementBlock::getCoord(), ASMu2D::getNoNodes(), ElementBlock::getParam(), myGeometry, and utl::matrix< T >::rows().

◆ generateFEMTopology()

bool ASMu2DIB::generateFEMTopology ( )

virtual

Generates the finite element topology data for the patch.

This method is overridden in this class, to include the calculation of the quadrature point parameters (and weights) according to the Immersed boundary scheme.

Reimplemented from ASMu2D.

References ASMLRSpline::empty(), ASMbase::fix(), ASMu2D::generateFEMTopology(), ASMu2D::getCornerPoints(), Immersed::getQuadraturePoints(), ASMu2D::lrspline, maxDepth, ASMbase::MLGE, ASMbase::MNPC, myGeometry, ASMbase::nGauss, and quadPoints.

◆ integrate() [1/8]

bool ASMu2D::integrate

Evaluates an integral over the interior patch domain.

Parameters

	integrand	Object with problem-specific data and methods
	glbInt	The integrated quantity
[in]	time	Parameters for nonlinear/time-dependent simulations

Referenced by integrate().

◆ integrate() [2/8]

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

virtual

Evaluates an integral over the interior patch domain.

Parameters

	integrand	Object with problem-specific data and methods
	glbInt	The integrated quantity
[in]	time	Parameters for nonlinear/time-dependent simulations

Reimplemented from ASMu2D.

References integrate(), ASMu2D::integrate(), myGeometry, and quadPoints.

◆ integrate() [3/8]

virtual bool ASMbase::integrate

Evaluates an integral over the interior patch domain.

Parameters

	integrand	Object with problem-specific data and methods
	glbInt	The integrated quantity
[in]	time	Parameters for nonlinear/time-dependent simulations

◆ integrate() [4/8]

virtual bool ASMbase::integrate

inline

Evaluates an integral over element interfaces in the patch.

Parameters

	integrand	Object with problem-specific data and methods
	glbInt	The integrated quantity
[in]	time	Parameters for nonlinear/time-dependent simulations
[in]	iChk	Object checking if an element interface has contributions

◆ integrate() [5/8]

bool ASMu2D::integrate

Evaluates an integral over element interfaces in the patch.

Parameters

	integrand	Object with problem-specific data and methods
	glbInt	The integrated quantity
[in]	time	Parameters for nonlinear/time-dependent simulations
[in]	iChk	Object checking if an element interface has contributions

References ASMu2D::aMin, utl::findIndex(), ASMu2D::lrspline, and ASMbase::MLGE.

◆ integrate() [6/8]

bool ASMu2D::integrate

Evaluates an integral over the interior patch domain.

Parameters

	integrand	Object with problem-specific data and methods
	glbInt	The integrated quantity
[in]	time	Parameters for nonlinear/time-dependent simulations
[in]	itgPts	Parameters and weights of the integration points

References ASMLRSpline::getOverlappingNodes().

◆ integrate() [7/8]

bool ASMu2D::integrate

Evaluates a boundary integral over a patch edge.

Parameters

	integrand	Object with problem-specific data and methods
[in]	lIndex	Local index of the boundary edge
	glbInt	The integrated quantity
[in]	time	Parameters for nonlinear/time-dependent simulations

◆ integrate() [8/8]

virtual bool ASMbase::integrate

Evaluates a boundary integral over a patch face/edge.

Parameters

	integrand	Object with problem-specific data and methods
[in]	lIndex	Local index of the boundary face/edge
	glbInt	The integrated quantity
[in]	time	Parameters for nonlinear/time-dependent simulations

◆ setGeometry()

bool ASMu2DIB::setGeometry	(	RealFunc *	f,
		double	power,
		double	threshold
	)

virtual

Defines the immersed geometry from a scalar function.

Parameters

[in]	f	The function to use
[in]	power	Exponent to apply on the specified function
[in]	threshold	Inside/outside threshold

Reimplemented from ASMbase.

References myGeometry.

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

src/ASM/LR/ASMu2DIB.h
src/ASM/LR/ASMu2DIB.C

Public Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ addHole() [1/2]

◆ addHole() [2/2]

◆ filterResults()

◆ generateFEMTopology()

◆ integrate() [1/8]

◆ integrate() [2/8]

◆ integrate() [3/8]

◆ integrate() [4/8]

◆ integrate() [5/8]

◆ integrate() [6/8]

◆ integrate() [7/8]

◆ integrate() [8/8]

◆ setGeometry()