# gf_mesh_im¶

**Synopsis**

```
MIM = gf_mesh_im('load', string fname[, mesh m])
MIM = gf_mesh_im('from string', string s[, mesh m])
MIM = gf_mesh_im('clone', mesh_im mim)
MIM = gf_mesh_im('levelset', mesh_levelset mls, string where, integ im[, integ im_tip[, integ im_set]])
MIM = gf_mesh_im(mesh m, [{integ im|int im_degree}])
```

**Description :**

General constructor for mesh_im objects.

This object represents an integration method defined on a whole mesh (an potentially on its boundaries).

**Command list :**

`MIM = gf_mesh_im('load', string fname[, mesh m])`

Load a mesh_im from a file.

If the mesh m is not supplied (this kind of file does not store the mesh), then it is read from the file and its descriptor is returned as the second output argument.

`MIM = gf_mesh_im('from string', string s[, mesh m])`

Create a mesh_im object from its string description.

See also

`gf_mesh_im_get(mesh_im MI, 'char')`

`MIM = gf_mesh_im('clone', mesh_im mim)`

Create a copy of a mesh_im.

`MIM = gf_mesh_im('levelset', mesh_levelset mls, string where, integ im[, integ im_tip[, integ im_set]])`

Build an integration method conformal to a partition defined implicitly by a levelset.

The where argument define the domain of integration with respect to the levelset, it has to be chosen among ‘ALL’, ‘INSIDE’, ‘OUTSIDE’ and ‘BOUNDARY’.

it can be completed by a string defining the boolean operation to define the integration domain when there is more than one levelset.

the syntax is very simple, for example if there are 3 different levelset,

“a*b*c” is the intersection of the domains defined by each levelset (this is the default behaviour if this function is not called).

“a+b+c” is the union of their domains.

“c-(a+b)” is the domain of the third levelset minus the union of the domains of the two others.

“!a” is the complementary of the domain of a (i.e. it is the domain where a(x)>0)

The first levelset is always referred to with “a”, the second with “b”, and so on.

for intance INSIDE(a*b*c)

CAUTION: this integration method will be defined only on the element cut by the level-set. For the ‘ALL’, ‘INSIDE’ and ‘OUTSIDE’ options it is mandatory to use the method

`gf_mesh_im_set(mesh_im MI, 'integ')`

to define the integration method on the remaining elements.

`MIM = gf_mesh_im(mesh m, [{integ im|int im_degree}])`

Build a new mesh_im object.

For convenience, optional arguments (im or im_degree) can be provided, in that case a call to

`gf_mesh_im_get(mesh_im MI, 'integ')`

is issued with these arguments.