locate map measurements or grains at specified spatial positions.

Syntax

measurements = findByLocation(ebsd, pos)

Description

For an MTEX object, findByLocation(x, …) calls x.findByLocation(…). 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

Find the nearest measurement to a position and every measurement within a specified radius. The small sample is downloaded and cached on first use.

import numpy as np
from mtex import mtexdata, findByLocation

ebsd = mtexdata('small', verbose=False)['Forsterite']
query = np.array([np.mean(ebsd.x), np.mean(ebsd.y)])
nearest = findByLocation(ebsd, query)
nearby = findByLocation(ebsd, query, radius=30)
print('Query (um):', np.round(query, 2))
print('Nearest position (um):', np.round(nearest.pos.data.reshape(-1, 3)[0, :2], 2))
print('Measurements within 30 um:', nearby.size)

The result is an EBSD selection. Without radius the nearest measurement is returned even when the query is outside the scan; specify a radius when distance should limit the selection.

Query (um): [34329.76  5797.87]
Nearest position (um): [34350.  5800.]
Measurements within 30 um: 2

Signature

findByLocation(x, *args, **kwargs)

Methods it calls

EBSD the measurements closest to positions, or within a radius of them
EBSD3 the measurements closest to positions, or within a radius of them
grain2d the positions of the outlines a point lies in the position of the outline holding each point, -1 for a point in none
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/findByLocation_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.