gf_mesh_im_get

Purpose

General inquiry function for mesh_im objects.

Synopsis

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')

Description

IMLST[,CV2IM]=gf_mesh_im_get(MIM, 'integ' [, ivec CVLST]) : return a list of integ objects: IMLST is an array of all integ objects found in the convexes given in CVLST. If CV2IM was supplied as an output argument, it contains, for each convex listed in CVLST, the index of its corresponding integ in IMLST.

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.

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.

gf_mesh_im_get(MIM, 'eltm', MET, CV [,F]) : return the elementary matrix (or tensor) integrated on the convex CV for the elementary matrix type MET (created with gf_eltm). If F is given, the elementary matrix is integrated on the face F of convex CV.

gf_mesh_im_get(MIM, 'save', filename [,'with mesh']) : save the mesh_im in a text file (which can be loaded later with gf_mesh_im(m, 'load', filename). Please note that the associated mesh is not saved, except if you use the 'with mesh' option! gf_mesh_im_get(M, 'char' [,'with mesh']) is similar, but saves the content of the mesh_im in a string.

gf_mesh_im_get(MIM, 'linked mesh') : return an handle to the mesh object linked to MIM.

gf_mesh_im_get(MIM, 'memsize') : return the amount of memory (in bytes) used by the mesh_im object (the linked mesh is not counted).