mtexLayout.resolve edit page

lay the figure out: measure, solve, apply, until nothing moves

Description

The decoration band depends on the size of the axes - a wider axes gets different tick labels - and a refit changes the space to lay out in, so the layout is a fixed point rather than a single pass. The usual case converges after one pass and stops, and a case that would oscillate stops too.

Re-entrant calls return the plan in hand. Writing an axes Position while laying out can bring the figure resize callback straight back round here, and it must not restart the layout underneath the pass that is running.

Syntax

plan = lay.resolve(mtexFig)
plan = lay.resolve(mtexFig,override)
plan = lay.resolve(mtexFig,override,refit)

Input

override spec fields to force, e.g. a pinned axis size, without writing them onto the mtexFigure and having them outlive this call
refit resize the figure to what the layout needs

See also

mtexLayout.measure mtexLayout.apply mtexLayout.solveLayout

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/mtexLayout.resolve.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.