gf_plot

This function plots a 2D or 3D finite elements field.

# Calling Sequence

    [hsurf, hcontour, hquiver, hmesh, hdefmesh]=gf_plot(mf,U[, options...])

## Description

This function plots a 2D or 3D finite elements field.

The options are specified as pairs of 'option name'/'option value':

- 'zplot',{'off'|'on'} : only for qdim=1, mdim=2

- 'norm', {'off'|'on'} : if qdim >= 2, color-plot the norm of the field

- 'dir',[] : or the scalar product of the field with 'dir' (can be a vector, or 'x', 'y' etc..)

- 'refine',8 : nb of refinments for curved edges and surface plots

- 'interpolated',{'off'|'on'} : if triangular patch are interpolated

- 'pcolor',{'on'|'off'} : if the field is scalar, a color plot of its values is plotted

- 'quiver',{'on'|'off'} : if the field is vector, represent arrows

- 'quiver_density',50 : density of arrows in quiver plot

- 'quiver_scale',1 : scaling of arrows (0=>no scaling)

- 'mesh',{'off'|'on'} : show the mesh ?

- 'meshopts',{listl(0)} : list of options passed to gf_plot_slice for the mesh

- 'deformed_mesh', {'off'|'on'} : shows the deformed mesh (only when qdim == mdim)

- 'deformed_meshopts', {list(0)} : cell array of options passed to gf_plot_slice for the deformed mesh

- 'deformation',[] : plots on the deformed object (only when qdim == mdim)

- 'deformation_mf',[] : plots on the deformed object (only when qdim == mdim)

- 'deformation_scale',0.1' : indicate the amplitude of the deformation. Can be an absolute value if given as a number

- 'cvlst',[] : list of convexes to plot (empty=>all convexes)

- 'title',[] : set the title

- 'contour',[] : list of contour values

## Examples

For example, plotting a scalar field on the border of a 3D mesh can be done with

    // load the 'strange.mesh_fem' (found in the getfem_scilab/demos directory)
    mf = gf_mesh_fem('load', '../../../contrib/aposteriori/aposteriori.meshfem')
    U = rand(1, gf_mesh_fem_get(mf, 'nbdof')); // random field that will be drawn
    gf_plot(mf, U, 'refine', 25, 'cvlst', gf_mesh_get(mf,'outer faces'), 'mesh','on');

## See Also

- gf_plot_mesh
- gf_plot_slice