sampling result and convergence diagnostics from optimalSample

Syntax

result = optimalSample(f, 100, diagnostics=True)
nodes = result.nodes

Description

This immutable named tuple records the optimised discrete representation of a density. Request it with diagnostics=True instead of receiving only the sample nodes.

Properties

nodes sampled vector3d directions or orientations
weights nonnegative node weights, normalised to sum to one
discrepancy final value of the weighted squared coefficient discrepancy objective
history objective values recorded during the iteration
iterations number of completed iterations
converged whether the stationarity or small-step stopping criterion was reached
reason stopping reason, including convergence, iteration limit or line-search failure
bandwidth harmonic bandwidth used for the optimisation

See also

optimalSample, discrepancy

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