an ellipse on the spherical plots of a figure, about a direction and turned as a rotation says

Syntax

ellipse(rot, a, b)

Semi-axes a and b about rot * z.

ellipse(rot, a, b, lineColor='b', add2all=False)

Onto the last plot only.

Description

The centre of the ellipse is rot * z, its semi-axes, a and b in radians, lie along rot * x and rot * y; the polar distance from the centre is ab / sqrt((b cos rho)^2 + (a sin rho)^2). A list of rotations, with one a and b or one per rotation, gives several ellipses.

Input

`rot`	rotation, the position and the turn of the ellipse
`a`	the semi-axis along rot * x, in radians
`b`	the semi-axis along rot * y, in radians

Keywords

keyword	default	description
`add2all`	`True`	draw onto every spherical plot of the figure, else onto the last one
`lineColor`	`'k'`	the colour of the line
`lineWidth`	`1.5`	the width of the line
`edgeAlpha`	`1.0`	the opacity of the line
`parent`	`None`	the axes, or a list of them, to draw onto

Output

`h`	the matplotlib lines, one per ellipse and axes

Used on

S2Bingham

MATLAB’s ellipse

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

ellipse