highlight selected orientations with colours that fade to white with disorientation

Syntax

key = spotColorKey(center, color=(0, 0, 1))
key = spotColorKey(cs, center=ori, color=rgb)
colors = key.orientation2color(ori)

Description

Each centre gets one RGB colour. Its contribution fades according to the chosen SO(3) kernel, normalised to its peak value. Several centre contributions are multiplied channel by channel. Comparisons use the crystal and specimen symmetry of the orientations.

Input

`x`	centre orientation or orientations, or a crystalFrame or single-phase map supplying the frames when centres will be set separately
`center`	centre orientation or orientations; default x when x is an orientation
`color`	one RGB triplet per centre; default red for one centre
`psi`	SO3Kernel controlling angular spread; default de la Vallee Poussin kernel with halfwidth 10*degree

Output

key spotColorKey

Properties

`center`	orientations to highlight; must be set before colouring
`color`	array of RGB triplets, one row per centre
`psi`	angular colour kernel

Members

orientation2color

the colours of orientations: white, multiplied for every centre by its colour faded with the kernel of the disorientation to it

Used on

EBSDAdvancedMaps

MATLAB’s spotColorKey

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/spotColorKey_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.

The class spotColorKey