the colour of every measurement of a map, or of every grain, each phase by its own inverse pole figure key
Syntax
rgb = ipfColors(ebsd)
Colours along the z direction.
rgb = ipfColors(grains, ipfDirection=xvector)
Colours of grains along x.
rgb = ipfColors(ebsd, unindexed=(0, 0, 0))
Black where nothing is indexed.
rgb = ipfColors(ebsd, exact=True)
Through the key itself, no colour grid.
rgb = ipfColors(ebsd, at=ind)
The measurements ind alone.
Description
Every indexed phase is coloured by the HSV inverse pole figure key (ipfHSVKey) of its own crystal frame: the specimen direction ipfDirection is taken into crystal coordinates, folded into the fundamental sector, and coloured by its place there. What is not indexed takes the colour unindexed. By default the colours are read off a grid of the key, one compiled loop over the quaternions where numba is installed, which is many times faster on a large map than colouring every direction through the key; exact=True does the latter.
Input
x |
EBSD or grain2d, a map or its grains |
Keywords
| keyword | default | description |
|---|---|---|
ipfDirection |
None |
vector3d, the specimen direction of the inverse pole figure, zvector by default |
unindexed |
(1.0, 1.0, 1.0) |
the RGB colour of the measurements not indexed |
exact |
False |
colour every measurement through the key instead of the colour grid |
resolution |
0.5*degree |
the spacing of the colour grid, in radians |
at |
None |
the indices of the measurements to colour, the others left out |
Output
rgb |
array of shape x.shape + (3,), or (len(at), 3), RGB values in [0, 1] |
See also
ipfHSVKey, ipfColorKey, orientation2color, EBSD.plot, colorGrid, EBSDIPFMap
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/ipfColors_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.