trimesh
Triangular mesh plot
Syntax
Description
trimesh( plots the mesh defined by a 2-D or
3-D TO)triangulation or delaunayTriangulation
object.
trimesh(___, specifies
one or more properties of the mesh plot using name-value pairs. For example,
Name,Value)'LineWidth',2 sets the edge width to 2 points.
h = trimesh(___) returns a
patch object used to create the mesh plot.
Use h to query and modify properties of the plot. For more information,
see Patch Properties.
Examples
3-D Triangular Mesh
Create a set of 3-D points. Compute a Delaunay triangulation connectivity matrix using the delaunay function, and plot the mesh.
[x,y] = meshgrid(1:15,1:15); z = peaks(15); T = delaunay(x,y); trimesh(T,x,y,z)
Alternatively, you can create a triangulation object to plot the mesh.
TO = triangulation(T,x(:),y(:),z(:)); trimesh(TO)
Input Arguments
T — Triangle connectivity
matrix
Triangle connectivity, specified as a 3-column matrix where each row contains the point vertices defining a triangle.
x — x-coordinates
column vector
x-coordinates, specified as a column vector.
y — y-coordinates
column vector
y-coordinates, specified as a column vector.
z — z-coordinates
column vector
z-coordinates, specified as a column vector.
c — Edge color
matrix
Edge color, specified as a matrix of colormap indices the same size as
z. For more information, see How Surface Plot Data Relates to a Colormap. For additional control over the surface coloring, use the
'EdgeColor' and 'FaceColor' name-value
pairs.
TO — Triangulation object
triangulation | delaunayTriangulation
Triangulation object, specified as a triangulation or
delaunayTriangulation object.
Name-Value Pair Arguments
Specify optional
comma-separated pairs of Name,Value arguments. Name is
the argument name and Value is the corresponding value.
Name must appear inside quotes. You can specify several name and value
pair arguments in any order as
Name1,Value1,...,NameN,ValueN.
trimesh(TO,'LineStyle','--')The properties listed here are only a subset. For a complete list, see Patch Properties.
'FaceColor' — Face color
[0.85 0.85 0.85] (default) | color name | RGB triplet | 'none'
Face color, specified as the comma-separated pair consisting of
'FaceColor' and a color name, an RGB triplet, or
'none'.
An RGB triplet is a three-element row vector whose elements specify the intensities
of the red, green, and blue components of the color. The intensities must be in the
range [0,1]; for example, [0.4 0.6 0.7]. This
table lists the long and short color name options and the equivalent RGB triplet
values.
| Long Name | Short Name | RGB Triplet |
|---|---|---|
'yellow' | 'y' | [1 1 0] |
'magenta' | 'm' | [1 0 1] |
'cyan' | 'c' | [0 1 1] |
'red' | 'r' | [1 0 0] |
'green' | 'g' | [0 1 0] |
'blue' | 'b' | [0 0 1] |
'white' | 'w' | [1 1 1] |
'black' | 'k' | [0 0 0] |
'FaceAlpha' — Face transparency
1 (default) | scalar in range [0,1]
Face transparency, specified as the comma-separated pair consisting of
'FaceAlpha' and a scalar in the range [0,1]. A
value of 1 is opaque and 0 is completely transparent. Values between 0 and 1 are
semitransparent.
'EdgeColor' — Edge color
[0 0 0]
(default) | color name | RGB triplet | 'none'
Edge color, specified as the comma-separated pair consisting of
'EdgeColor' and a color name, an RGB triplet, or
'none'. The default color of [0 0 0]
corresponds to black boundaries.
An RGB triplet is a three-element row vector whose elements specify the
intensities of the red, green, and blue components of the color. The intensities must
be in the range [0,1]; for example, [0.4 0.6
0.7]. This table lists the long and short color name options and the
equivalent RGB triplet values.
| Long Name | Short Name | RGB Triplet |
|---|---|---|
'yellow' | 'y' | [1 1 0] |
'magenta' | 'm' | [1 0 1] |
'cyan' | 'c' | [0 1 1] |
'red' | 'r' | [1 0 0] |
'green' | 'g' | [0 1 0] |
'blue' | 'b' | [0 0 1] |
'white' | 'w' | [1 1 1] |
'black' | 'k' | [0 0 0] |
'LineWidth' — Line width
0.5 (default) | positive numeric value
Line width, specified as the comma-separated pair consisting of
'LineWidth' and a positive numeric value in points.
Line style, specified as one of the options listed in this table.
| Line Style | Description | Resulting Line |
|---|---|---|
'-' | Solid line |
|
'--' | Dashed line |
|
':' | Dotted line |
|
'-.' | Dash-dotted line |
|
'none' | No line | No line |
Extended Capabilities
See Also
delaunay | delaunayTriangulation | patch | triangulation | trisurf