March 2027 · Freiberg Workshop on Quantitative Microstructure Analysis, new this year: AI-assisted analysis and MTEX for Python Programme →
MTEX
Get started

Install MTEX and run your first analysis

MTEX runs in MATLAB and in Python, with the same analysis workflow in both. Install it, load one of the example data sets, import your own file, and follow a tutorial for your kind of data.

This page shows MTEX for MATLAB.

This page shows MTEX for Python.

MTEX for MATLAB 7.2.0 · Oct 2026

  1. Download and unzip mtex-7.2.0.zip
  2. In MATLAB, change to that folder and run startup_mtex
  3. Try mtexdata titanium, then plot(ebsd)
  4. Import your own file with import_wizard

MATLAB R2022b or newer, no further toolboxes needed. GND and Taylor computations use the Optimization Toolbox.

New to MATLAB? Step by step →
TroubleshootingAll releasesRelease notes

MTEX for Python 1.0.0 · Python 3.12+

  1. pip install "mtex[all]"
  2. from mtex import *
  3. Try ebsd = mtexdata('titanium'), then plot(ebsd)
  4. Import your own file with ebsd = importWizard()

Linux, macOS and Windows. The Python version needs no MATLAB licence.

New to Python? Step by step →
Coming from MATLABSpeed against MATLAB

Import your own data

The MTEX import wizard in MATLAB: a file browser on the left, the phase table across the top, the two coordinate systems at the top right and an orientation map below

Type this in the MATLAB command window:

import_wizard
  1. Double-click your file in the tree on the left. The wizard reads it and draws the map.
  2. Check the phase table: mineral names, symmetries and lattice parameters.
  3. Check the two coordinate systems against your specimen.
  4. Click Generate import script. The script loads the file without the wizard and becomes the first step of your analysis.

EBSD, pole figure and ODF files of all common vendors. MATLAB R2022b or newer.

The MTEX import wizard in Python: a file browser on the left, the phase table across the top, the two coordinate systems at the top left and an orientation map below

Type this in the interactive window of VS Code or in any Python session:

from mtex import *
ebsd = importWizard()

or, from a terminal, mtex-wizard.

  1. Click your file in the browser on the left. The wizard reads it and draws the map.
  2. Check the phase table: mineral names, symmetries and lattice parameters.
  3. Check the two coordinate systems, map and Euler, against your specimen.
  4. Click write script. The script loads the file without the wizard and becomes the first step of your analysis.

EBSD files of all common vendors. Installed with pip install "mtex[all]".

Your first analysis

Each tutorial follows one analysis from the data file to a result.

EBSD mapsImport a map, reconstruct grains, and look at boundaries and texture. Pole figuresFrom X-ray or neutron intensities to the ODF and its components. How MTEX worksScripts, lists, options and properties: the few ideas every analysis uses.

When you get stuck