a spatial EBSD map, coloured by phase, by a value, by orientation or by colours given

Syntax

plot(ebsd)

Colours by phase, with a legend.

plot(ebsd, ebsd.mad)

Colours by a value, here MAD.

plot(ebsd, ebsd.mad, colorbar=True, colorRange=(0, 1))

With a colour bar of a fixed range.

plot(ebsd['Forsterite'], ebsd['Forsterite'].orientations)

Colours by orientation.

plot(ebsd, ipfDirection=xvector)

Every phase by its inverse pole figure key along x.

plot(ebsd['Forsterite'], key)

By an orientation colour key.

plot(ebsd['Forsterite'], rgb)

By colours of one’s own, n x 3.

plot(ebsd[ebsd.mad > 1], faceColor='black', displayName='bad values')

One colour, in the legend.

plot(ebsd, region=(0, 400, 0, 200))

A part of the map.

plot(ebsd, backend='scatter', markerSize=2)

The measurements as dots.

Description

The map is drawn in the plotting convention of its frame (ebsd.how2plot), with a scale bar and the axes of the specimen frame in one corner. The colouring follows mapValues: the phases by default, a value per measurement through a colour map, orientations through the inverse pole figure key of their phase, an orientation colour key, an RGB colour per measurement, or one colour for all. Measurements without an orientation are drawn as nothing.

A map on a rigid lattice is drawn as an image of at most maxPixels pixels, twice the resolution of the axes by default, so that a large map draws fast; a smaller one, or one whose cells are outlined, as one polygon per cell; a map without a lattice as dots. backend chooses: ‘imagesc’ the image, ‘patch’ the cells, ‘scatter’ the dots. MATLAB’s flag ‘points’ is backend=’scatter’, its ‘exact’ a larger maxPixels or backend=’patch’.

region=(xmin, xmax, ymin, ymax) shows a part of the map, title= names the axes, coordinates=True labels the axes with the map coordinates, how2plot= a plottingConvention other than the map’s, parent= the axes to draw into and figSize= the size of a new figure; every other keyword goes to the matplotlib artist.

Input

ebsd EBSD, a map of the plane
color the colouring: an array of values or of RGB colours, orientations, an orientationColorKey, a crystalShape drawn at every measurement, a property name, ‘phase’, ‘orientation’ or one colour

Keywords

keyword default description
faceColor None one colour for every measurement; ‘none’ outlines the cells
backend None ‘imagesc’, ‘patch’ or ‘scatter’, as above
colormap 'viridis' the colour map of values, a name of MTEX’s or matplotlib’s
colorRange None (lo, hi), the values the colour map spans
colorbar False add a colour bar for values
micronbar None draw the scale bar; by default the preference showMicronBar
refFrame True draw the axes of the specimen frame in the scale bar box
location None the corner of the scale bar, ‘sw’, ‘se’, ‘nw’ or ‘ne’
ipfDirection None vector3d, colour by orientation through the inverse pole figure key along this specimen direction
maxPixels None the most pixels of the image drawn of a map on a rigid lattice
edgeColor None outline every cell in this colour
lineWidth 0.5 the width of the cell outlines
alpha 1.0 the opacity, one for all or one per measurement
legend None draw the legend of the phases or the inverse pole figure keys; by default for a phase map
displayName None the name in a legend
markerSize 4 the size of the dots of backend=’scatter’

Output

h the matplotlib image, collection or scatter drawn; MATLAB’s second output, the map plot, is h.axes’ mapPlot

See also

EBSDPlotting, EBSDIPFMap, EBSDAdvancedMaps, grain2d.plot, grainBoundary.plot, mapValues, ipfColorKey

MATLAB’s EBSD.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/EBSD.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.