the file of a sample data set, or its files, fetched on first use

Syntax

fname = mtexdatafile('forsterite')

The file of a map.

tess, oris = mtexdatafile('my100grains')

A data set of several files.

fname = mtexdatafile('forsterite', root=mtexDataPath(), download=False)

Only a file already there.

fnames = mtexdatafile('dubna', verbose=False)

Fetched without saying so.

Description

Besides the data sets mtexdata reads, every data set of the data repository has its files here, the Neper tessellation ‘my100grains’ for instance. A data set of one file gives its path, one of several the list of paths. A missing file is downloaded from the data repository into the folder root.

Input

name the name of a data set, as mtexdata() lists them, or of a data set of the repository

Keywords

keyword	default	description
`root`	`None`	the folder the files are kept in, mtexDataPath() by default
`download`	`True`	fetch a missing file; False raises for it instead
`verbose`	`True`	say when a file is fetched

Output

fname the path of the file, or a list of paths

Used on

SymmetryAlignment, OrientationImport, Grains3D, Grains3DBoundaries, Grains3DOperations, Grains3DProperties, Grains3DReconstruction, Grains3DSmoothing, NeperInterface, EBSDGrid, EBSDImport, EBSDInterfaceHDF5

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

mtexdatafile