gf_mesh_im

Purpose

General constructor for mesh_im object. Return a getfem++ handle to the newly created mesh_im object.

Synopsis

mesh_im MIM = gf_mesh_im(mesh M [, { integ | int }])
mesh_im MIM[,M] = gf_mesh_im('load', string filename[,mesh M])
mesh_im MIM[,M] = gf_mesh_im('from string', string S [,mesh M])
mesh_im MIM = gf_mesh_im('clone', mesh_im MIM0)

Description

This function creates a mesh_im object. These objects hold integration methods defined over a mesh: an mesh_im object is required for each operation with needs integration of something over the mesh (assembly functions, etc.).

gf_mesh_im(M [, integ IM | int IM_DEGREE]) creates a new mesh_im object linked to the mesh M. mesh_im objects can be used everywhere a const_mesh object is required (its linked mesh is automatically used).

As a convenience, an integration method can be applied immediately to all convexes of the mesh if the optional argument IM or IM_DEGREE is used (IM_DEGREE let getfem choose a suitable integration method that is able to exactly integrate polynomials of degree less or equal to IM_DEGREE. The load command can restore a previously saved mesh_im object. If you don't specify the mesh argument, it is assumed that the mesh was saved in the same file that the mesh_im (with gf_mesh_im_get(mf, 'save with mesh')). The 'from string' command is very similar, but loads the object from a string instead of a file. gf_mesh_im('clone', MIM0) return a copy of MIM0.

See Also