gf_plot_mesh

General mesh plotting function.

# Calling Sequence

    [hmesh,hbound,hfill,hvert,hconv,hdof]=gf_plot_mesh(M, [,properties] [,'cvlst',CVLST] ['boundaries'[BLST]])

## Description

H=gf_plot_mesh(M) displays a mesh.

Properties are:

- 'vertices', {'off'|'on'} displays also vertices numbers.

- 'convexes', {'off'|'on'} displays also convexes numbers.

- 'dof',{'off'|'on'} displays also finite element nodes.

- 'regions',BLST displays the boundaries listed in BLST.

- 'cvlst',CVLST display only the listed convexes. If CVLST has two rows, display only the faces listed in the second row.

- 'edges', {'on' | 'off'} display edges ?

- 'faces', {'off'|'on'} fills each 2D-face of the mesh

- 'curved', {'off'|'on'} displays curved edges

- 'refine',N refine curved edges and filled faces N times

- 'deformation', Udef optionnal deformation applied to the mesh (M must be a mesh_fem object)

- 'edges_color',[.6 .6 1] RGB values for the color of edges

- 'edges_width',1

- 'faces_color',[.75 .75 .75]) RGB values for the color of faces

- 'quality',{ 'off' | 'on' } Display the quality of the mesh.

CAUTION: For 'dof', M should be a mesh_fem identifier, not a simple mesh object.

This function can be used with any mesh in any dimension (except if the 'faces' options is turned on).

On output, this function returns the handles to the various graphical objects created: hmesh is the handles to the mesh lines, hbound is the handles to the edges of the boundaries, hfill is the handle of the patch objects of faces, hvert (resp hconv,hdof) is the handles of the vertices (resp. convexes, dof) labels.

## Examples

Displaying a donut (meshed with quadratic tetrahedrons) created with GiD:

    // the mesh is in the demos directory of the distribution
    m = gf_mesh('import','gid','donut_with_quadratic_tetra_1100_elements.msh');
    gf_plot_mesh(m,'refine',15,'cvlst',gf_mesh_get(m,'outer faces'),'faces','on',...
    'faces_color',[1. .9 .2],'curved','on','edges_width',2);

You can notice that the mesh has a small default on some elements.

## See Also

- gf_plot