HSVDirectionKey edit page

converts crystal or specimen directions to rgb values

The principle idea is to take the fundamental sector, apply white to the center and red, blue and green to the vertices. This works well if all the edges of the fundamental sector are reflections, i.e. for for m, mm2, mmm, 3m, 4mm, 4/mmm, 6mm, -62m, 6/mmm, -43m, m-3m. In almost all other cases the fundamental sector can be divided by an additional reflection into two subsectors which are colored one with white and one with black center. There are three cases, -1, -3, -4, where this does not work. Actually one can show that in this cases it is impossible to have a smooth one to one relation between the color space and the fundamental sector.

Syntax

dM = HSVDirectionKey(cs)
rgb = dM.direction2color(h)

Input

cs symmetry
h Miller or vector3d

Output

dM HSVDirectionKey
rgb list of RGB triplets

Class Properties

whiteCenter vector3d that becomes white
colorStretching saturation exponent, larger means more contrast
grayValue [min max] gray of the two subsectors
grayGradient how fast the gray fades away from the center
maxAngle restrict the key to a ball around whiteCenter
colorPostRotation rotation applied to the color space
sym the symmetry the sector is taken of
sR sphericalRegion the key is defined on

See also

directionColorKey ipfHSVKey TSLDirectionKey

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