arrange measurements on the cells of their spatial lattice.

Syntax

grid = gridify(ebsd)

Description

For an MTEX object, gridify(x, …) calls x.gridify(…). Additional positional and keyword arguments are passed to that method unchanged. Its documentation specifies the accepted inputs, units, symmetry handling and optional outputs. Consult the corresponding method for the behaviour of a particular object type.

Example

Arrange a small list of measurements into a grid, leaving one interior lattice site unmeasured. The index mapping identifies where each original measurement ended up.

import numpy as np
from mtex import EBSD, crystalFrame, phaseList, rotation, vector3d, degree, gridify

x, y = np.meshgrid(np.arange(5), np.arange(4))
keep = ~((x == 2) & (y == 1))
pos = np.c_[x[keep], y[keep]]
rot = rotation.byAxisAngle(vector3d.Z, x[keep]*degree)
ebsd = EBSD(pos, rot, np.ones(len(pos), dtype=int), phaseList(crystalFrame('m-3m')))
grid, newId = gridify(ebsd, return_index=True)
print('List shape:', ebsd.shape, 'Grid shape:', grid.shape)
print('Unmeasured cells:', np.count_nonzero(grid.isPadding))
print('Padding is indexed:', bool(np.any(grid.isIndexed[grid.isPadding])))
print('Positions preserved:', np.allclose(grid.pos.data.reshape(-1, 3)[newId], ebsd.pos.data))

gridify arranges the data; it does not interpolate a measurement into the missing cell. Use isPadding to distinguish that absent lattice site from an acquired but unindexed point.

List shape: (19,) Grid shape: (4, 5)
Unmeasured cells: 1
Padding is indexed: False
Positions preserved: True

Signature

gridify(x, *args, **kwargs)

Methods it calls

EBSD	the same map with its arrays in map shape, the missing cells padding
EBSD3	a list of voxels put back onto the (n1, n2, n3) array of its lattice

Used on

EBSDGrid, EBSDInter, EBSDMapsAndImages

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