gf_mesh_im_get — General function extracting information from mesh_im objects.
string IMLST[, ivec CV2IM] = gf_mesh_im_get(MIM, 'integ' [, ivec CVLST]) ivec CVLST = gf_mesh_im_get(MIM, 'convex_index') mat M = gf_mesh_fem_get(MIM, 'eltm', eltm MET, int CV [, int FACE]) gf_mesh_im_get(MIM, 'save', string filename, ['with mesh']) string S=gf_mesh_im_get(M, 'char' [,'with mesh']) mesh M=gf_mesh_im_get(MIM, 'linked mesh') M=gf_mesh_im_get(MIM, 'memsize')
list(I, CV2I) = gf_mesh_im_get(mim,'integ'[, mat CVids]) Return
a list of integration methods used by the MeshIm. I
is an array of all Integ objects found in the convexes given in
CVids
. If CV2I
was supplied as
an output argument, it contains, for each convex listed in
CVids
, the index of its correspounding integration
method in I
. Convexes which are not part of the
mesh, or convexes which do not have any integration method have their
correspounding entry in CV2I
set to -1.
CVids = gf_mesh_im_get(mim,'convex_index') Return the list of convexes who have a integration method. Convexes who have the dummy IM_NONE method are not listed.
M = gf_mesh_im_get(mim,'eltm',Eltm em, int cv [int f]) Return
the elementary matrix (or tensor) integrated on the convex
cv
.
**WARNING** Be sure that the fem used for the construction of
em
is compatible with the fem assigned to element
cv
! This is not checked by the function ! If the
argument f
is given, then the elementary tensor is
integrated on the face f
of cv
instead of the whole convex.
Ip = gf_mesh_im_get(mim,'im_nodes'[, mat CVids]) Return the
coordinates of the integration points, with their weights.
CVids
may be a list of convexes, or a list of
convex faces, such as returned by gf_mesh_get(M,'region')
gf_mesh_im_get(mim,'save',string filename[, 'with mesh']) Saves a MeshIm in a text file (and optionaly its linked mesh object).
gf_mesh_im_get(mim,'char'[,'with mesh']) Output a string description of the MeshIm. By default, it does not include the description of the linked Mesh object.
m = gf_mesh_im_get(mim,'linked mesh') Returns a reference to the
Mesh object linked to mim
.
z = gf_mesh_im_get(mim,'memsize') Return the amount of memory (in bytes) used by the MeshIm object. The result does not take into account the linked Mesh object.