A method of rotation.

uniformly distributed rotations, the Haar measure; with maxAngle restricted to the ball of that rotational angle about the identity, the angle by inverting its distribution (w - sin w) / pi, the axis uniform; rng= a NumPy random generator

Syntax

rot = rotation.rand()

One.

rot = rotation.rand(100)

A list of 100.

rot = rotation.rand(10, 3)

A 10 x 3 array.

rot = rotation.rand(100, maxAngle=10*degree)

Within 10 degree of the identity.

rot = rotation.rand(100, rng=np.random.default_rng(0))

Reproducible.

Input

shape the sizes of the array, one tuple or several integers

Keywords

keyword default description
rng None the NumPy random generator, a fresh one by default
maxAngle None the largest rotational angle about the identity

Output

rot quaternions of the class it is called on, rotation or quaternion

See also

orientation.rand, vector3d.rand, rotation.id

MATLAB’s rotation.rand

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/rotation.rand_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.