mapImage.plot edit page

plot one image, or a whole sequence, on its specimen coordinates

Draws each image where it sits on the specimen, in micrometres rather than pixels, with the screen orientation taken from its frame. So an image and the map it is aligned to plot on top of each other without either being permuted first - MTEX moves the camera, not the data.

Given an array, one axis per image, named by mg(k).name. That is the quick check that a sequence covers the same area and is stored the same way up.

Description

One channel is drawn as a scalar field through the current colormap; three are drawn as RGB. Any other channel count has no single meaning as a picture, so name a channel.

Syntax

plot(mg)
plot(imgList)                      % one axis per image
plot(imgList,'edge')               % the edge transform of each
plot(mg,'channel',2)
plot(mg,'micronbar','off')

plot(ebsd,ebsd.bc); hold on; plot(mg,'AlphaData',0.5)

Input

`mg`	`mapImage, one or an array`

Output

`h`	`handle to the graphics object, one per image`
`mP`	`mapPlot of the last axis`

Options

`channel`	`which channel to draw, default all of them`
`micronbar`	`'on'/'off'`
`figSize`	`'huge' (the default here), 'large', 'normal', 'small', 'tiny' or a fraction of the screen. A new figure is made full screen, because a sequence tiles one axis per image and the usual default leaves each too small to read`

Flags

edge draw edgeMap(mg) instead of the values, which is what a registration actually matches on. Contrast is stretched over the 2nd to 98th percentile rather than the full range, because an edge transform's bright tail would otherwise crush the picture to black

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/mapImage.plot.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.

mapImage.plot