COMSOL 6.4 - XmeshInfo

clears out the Xmesh object created by the call to xmeshInfo. After the required information has been obtained from the XmeshInfo object, this function should be called to release memory. When xmeshInfo is called on a solver sequence, an already existing Xmesh object is used, so there is no need to call clearXmesh.

General Information

String[] mcases = xmi.meshCases() returns a string vector containing tags of all mesh cases.

int nDofs = xmi.nDofs() returns the total number of DOFs.

String[] fieldNames = xmi.fieldNames() returns the field names, or the field names solved for.

int[] fieldNDofs = xmi.fieldNDofs() returns the number of DOFs for each field.

String[] geomTags = xmi.geoms() returns the tags of all geometries that exist in the xmesh.

String[] meshTypes = xmi.meshTypes() returns all mesh types.

String[] meshTypes = xmi.meshTypes(geomTag) returns all mesh types in geometry geomTag (a string). Possible mesh types are vtx, edg, tri, quad, tet, hex, prism, and pyr.

Information About Each DOF

XmeshInfoDofs dofs = xmi.dofs() returns information about each DOF.

The class XmeshInfoDofs has the following methods:

Table 6-83: XmeshInfoDofs methods.
field	Contents
int[] geomNums()	1-based geometry numbers for all DOFs
int[] nodes()	0-based node numbers for all DOFs.
double[][] coords()	Global coordinates for all DOFs in the model length unit. The kth column of this matrix contains the coordinates of DOF number k.
double[][] coords(xdGeomTag)	For DOFs in an extra dimension product, return the coordinates of each DOF in the extra dimension geometry xdGeomTag. For DOFs that are not located in an extra dimension product containing xdGeomTag, the value NaN is returned.
double[][] gCoords()	Same as coords() except that coordinates are given in the geometry length unit. If there is more than one geometry, the coordinates of each DOF are given in the length unit of the geometry of that DOF.
String[] dofNames()	DOF names
int[] nameInds()	0-based indices into dofNames() for all DOFs.
int[] solVectorInds()	0-based indices into solution vector for all DOFs.

Information About Each Node Point

XmeshInfoNodes nodes = xmi.nodes() returns information about nodes. This method issues an error if there is more than one geometry.

XmeshInfoNodes nodes = xmi.nodes(geomTag) returns information about nodes in geometry geomTag (a string).

The class XmeshInfoNodes has the following methods:

Table 6-84: XmeshInfoNodes class methods.
field	Contents
double[][] coords()	Global coordinates for all nodes. The nth column of the matrix coords contains the coordinates of node point number n
double[][] gCoords()	Same as coords() except that coordinates are given in the geometry length unit.
String[] dofNames()	DOF names in this geometry
int[][] dofs()	0-based DOF numbers for all nodes in this geometry. dofs()[k][n] is the DOF number for DOF name dofNames()[k] at node point n. A value of -1 means that there is no DOF with this name at the node. Note: If there is a slit, only one of the DOFs is given for each node point.

Information About Each Mesh Element

XmeshInfoElements[] elems = xmi.elements(meshType) returns information about mesh elements of type meshType (a string). This method issues an error if there is more than one geometry.

XmeshInfoElements[] elems = xmi.elements(meshType,geomTag) returns information about mesh elements of type meshType in geometry geomTag.

The XmeshInfoElements class has the following methods:

Table 6-85: XmeshInfoElements class Methods.
field	Contents
double[][] localCoords()	Local coordinates of nodes. The kth column of the matrix localCoords() contains the coordinates of local node point number k.
int[][] nodes()	0-based node point indices for all mesh elements of type type(). nodes()[k][el] is the node point number within geometry geomNum() (see the output xmi.nodes()) for local node point k within mesh element el. A value -1 means that there is no node point at this location.
String[] localDofNames()	The name for each local DOF.
double[][] localDofCoords()	The local coordinates for each local DOF (one column for each local DOF).
int[][] dofs()	0-based DOF numbers for all mesh elements of type type(). dofs()[k][el] is the DOF number for local DOF k within mesh element el. A value -1 means that there is no DOF at this location.