Name

gf_mesh_im_get — General function extracting information from mesh_im objects.

Calling Sequence

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

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

Examples

 
cvid = gf_mesh_get(mim,'cvid');
[f,c2f] = gf_mesh_im_get(mim, 'integ');
sf = list();
for i=1:size(f), sf(i)=gf_integ_get('char',f(i)); end;
for i=1:size(c2f)
  disp(sprintf('the integration of convex %d is %s', cvid(i),sf(i)));
end
 

See Also

gf_mesh_im_set, gf_mesh_im

Authors

Y. Collette