(swplot-icomesh)=

# swplot.icomesh

## Syntax
  
`TR = swplot.icomesh(nMesh)`
  
## Description
  
`TR = swplot.icomesh(nMesh)` outputs a triangulation that is generated by
subdividing icosahedron faces. The triangulation will contain $20\cdot 4^n$
(where $n=n_{mesh}$) triangular faces. The output can be plotted using the
[trimesh](https://www.mathworks.com/help/matlab/ref/trimesh.html) function.
  
## Examples
 
This example shows how to create and plot the icosahedron.
 
```matlab
TR = swplot.icomesh
trimesh(TR)
```
 
```{image} /_static/img/generated/swplot_ic_1.png
:alt: axis(
```
 
## Input Arguments
  
`nMesh`
: Number of subdivisions. Default value is 0, when the function returns
  the icosahedron.
  
## Output Arguments
  
`TR`
: Triangulation class object for plotting with [trimesh](https://www.mathworks.com/help/matlab/ref/trimesh.html).
 
## See Also
 
[triangulation](https://www.mathworks.com/help/matlab/ref/triangulation.html)