A method of grain3d.

the 3D grains drawn by their faces, coloured by phase, by a value or an orientation per grain, or in one colour; MATLAB’s grain3d.plot

Syntax

plot(grains)

Coloured by phase.

plot(grains, grains.volume)

Coloured by a value per grain.

plot(grains, grains.meanOrientation, lineStyle='none')

By the orientation, no edges.

plot(grains, faceColor='r', faceAlpha=0.5)

One translucent colour.

Description

Only the outer faces of the set are drawn, each in the colour of the grain it bounds; a face between two grains of the set is inside and is drawn grey only where the faces are translucent. Values are mapped by the colour map, parula as MATLAB’s patches, and orientations by an ipfColorKey of their phase.

The options of the drawing are keywords too: faceColor, faceAlpha, edgeColor, edgeAlpha, lineWidth, colormap, colorRange and ipfDirection; lineStyle=’none’ draws no edges. The plot is a scene3d held by the mtexFigure, shown as the picture PyVista renders offscreen (matplotlib’s 3D axes without PyVista), so hold, setCamera and mtexColorbar act on it as on any MTEX figure; show3d opens it in a window and exportHTML writes it as an interactive page.

Input

grains grain3d
color a value, an orientation or an RGB colour per grain; by default the phase colours

Keywords

keyword default description
how2plot None the plottingConvention of the view, by default plottingConvention.default3D
figSize None the size of a new figure, ‘small’, ‘normal’, ‘large’, …, or (width, height) in inches

Output

fig mtexFigure

See also

grain3Boundary.plot, EBSD3.plot, grain2d.plot, plotEllipsoid, Grains3DOperations

MATLAB’s grain3d.plot

source

Citing this page. This page is part of the documentation of MTEX, a free and open source MATLAB toolbox for analyzing and modeling crystallographic textures. It was written by The MTEX Developers and is published at https://mtex-toolbox.github.io/grain3d.plot_py.html. If you use MTEX, or reuse text or figures from this page, in your research, please cite

F. Bachmann, R. Hielscher, H. Schaeben: Texture Analysis with MTEX - Free and Open Source Software Toolbox, Solid State Phenomena 160 (2010), 63-68. 10.4028/www.scientific.net/SSP.160.63

BibTeX 
@article{bachmann2010mtex,
  author  = {F. Bachmann and R. Hielscher and H. Schaeben},
  title   = {Texture Analysis with MTEX - Free and Open Source Software Toolbox},
  journal = {Solid State Phenomena},
  volume  = {160},
  pages   = {63-68},
  year    = {2010},
  doi     = {10.4028/www.scientific.net/SSP.160.63},
  url     = {https://doi.org/10.4028/www.scientific.net/SSP.160.63}
}

Other papers describing specific MTEX methods are listed under Publications — please cite the one that best fits your application. The MTEX source code is licensed under the GNU General Public License v2.0; the text and figures of this documentation are licensed under CC BY 4.0, which permits reuse — including by automated systems — provided The MTEX Developers and this page are credited.