a circle on a spherical plot: the small circle of the opening angle about a direction, the great circle by default

Syntax

circle(n)

The great circle perpendicular to n.

circle(n, 30*degree)

The small circle 30 degree about n.

circle(n, 20*degree, add2all=True, lineColor='r')

Onto every spherical plot of the figure.

Description

The circle annotates the spherical plot drawn last, or the one nextAxis chose; draw the plot first. A circle leaving the chart is broken where it does. Several directions give several circles.

Input

v vector3d, the centre, one or several
radius the opening angle about v in radians, pi/2 for the great circle

Keywords

keyword default description
add2all False draw onto every spherical plot of the figure
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 circle and axes

See also

ellipse, plot, scatter, text, Annotations

Used on

CrystalOperations, EBSDAdvancedMaps, EBSDOrientationAnalysis, Legends

MATLAB’s vector3d.circle

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/vector3d.circle_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.