Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
5.5.1 - English

Change language to:
Français - 日本語 - Português - Русский

Please note that the recommended version of Scilab is 2024.1.0. This page might be outdated.
See the recommended documentation of this function

Scilab Help >> Graphics > 3d_plot > mesh


3D mesh plot

Calling Sequence




a real matrix defining the surface height. It can not be omitted. The Z data is a m-by-n matrix.

X, Y

two real matrices : always set together, these data defines a new standard grid. This new X and Y components of the grid must match Z dimensions (see description below).


an optional real matrix defining a color value for each (X(j),Y(i)) point of the grid (see description below).


this optional argument represents a sequence of couple statements {PropertyName,PropertyValue} that defines global objects' properties applied to all the curves created by this plot. For a complete view of the available properties (see GlobalProperty).


this optional argument forces the plot to appear inside the selected axes given by axes_handle rather than the current axes (see gca).


mesh draws a parametric surface using a rectangular grid defined by X and Y coordinates (if {X,Y} are not specified, this grid is determined using the dimensions of the Z matrix); at each point of this grid, a z coordinate is given using the Z matrix. mesh is based on the surf command with default option color_mode = white index (inside the current colormap) and color_flag = 0.

Data entry specification :

In this paragraph and to be more clear, we won't mention GlobalProperty optional arguments as they do not interfer with entry data (except for "Xdata", "Ydata" and "Zdata" property, see GlobalProperty). It is assumed that all those optional arguments could be present too.

If Z is the only matrix specified, mesh(Z) plots the matrix Z versus the grid defined by 1:size(Z,2) along the x axis and 1:size(Z,1) along the y axis.


To enable the tranparency mode you should set the color_mode option to 0.


xtitle('$\huge z=x^2-y^2$');

See Also

  • surf — 3D surface plot
  • meshgrid — create matrices or 3-D arrays
  • plot2d — 2D plot
  • LineSpec — to quickly customize the lines appearance in a plot
  • GlobalProperty — to customize the objects appearance (curves, surfaces...) in a plot or surf command
Report an issue
<< hist3d 3d_plot milk_drop >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Thu Oct 02 13:46:51 CEST 2014