the charts a spherical plot is drawn on, the projection of the region its data cover; MATLAB’s makeSphericalProjection

Syntax

proj = makeSphericalProjection(v, upper=True)

The upper hemisphere of v.

proj = makeSphericalProjection(sR, projection='eangle')

A region, equal angle.

proj = makeSphericalProjection(None, complete=True, antipodal=True)

The whole sphere of axes.

proj = makeSphericalProjection(cs)

The fundamental sector of a frame.

Description

The region is what the data cover, unless a sphericalRegion is given: the whole sphere for directions, the fundamental sector for a frame, and for a function of a frame with symmetry the sector of its group. A region reaching into both hemispheres takes two charts, the upper and the lower one; an antipodal region needs the upper one only. The plain projection shows everything in one chart. The hemispheres are those of the plotting convention, whose out of screen direction is up.

Where MATLAB returns the projection, Python returns a list of one or two charts.

Input

v vector3d, sphericalRegion, a reference frame, a function on the sphere, or None for the whole sphere

Keywords

keyword default description
projection 'earea' ‘earea’ (equal area), ‘eangle’ or ‘stereo’ (equal angle), ‘edist’, ‘orthographic’, ‘gnomonic’, ‘plain’, or a sphericalProjection class
upper False the upper hemisphere only
lower False the lower hemisphere only; with upper both
complete False the whole sphere, not the fundamental sector
antipodal None treat the directions as axes; by default as v says
how2plot None the plottingConvention, or its name such as ‘x↑→y’; by default that of the frame
fundamentalRegion False restrict to the fundamental sector of the frame of v
symmetric None whether the charts draw a function of the symmetry of its frame; by default true for a function of a frame with symmetry, false for directions and regions

Output

proj list of sphericalProjection, one chart or the upper and the lower one

See also

sphericalProjection, plotS2Grid, sphericalRegion, plottingConvention, SphericalProjections

MATLAB’s makeSphericalProjection

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