Skip to content

Commit 1f67eab

Browse files
committed
docu
1 parent 029438f commit 1f67eab

File tree

95 files changed

+265
-231
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

95 files changed

+265
-231
lines changed

index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ scientists, geologists and mathematicians.
1313

1414
### News
1515
* MTEX Online Workshop 2021: ・ [Announcement](https://github.com/mtex-toolbox/mtex/discussions/519#discussioncomment-139964)[Homepage](http://www-user.tu-chemnitz.de/~rahi/mtexWorkshop21)
16-
* MTEX 5.5.0 released: ・ [Download](https://github.com/mtex-toolbox/mtex/releases/download/mtex-5.5.0/mtex-5.5.0.zip)[Release Notes](changelog.html)[Installation](download)
16+
* MTEX 5.5.1 released: ・ [Download](https://github.com/mtex-toolbox/mtex/releases/download/mtex-5.5.1/mtex-5.5.1.zip)[Release Notes](changelog.html)[Installation](download)
1717
* MTEX GUI 2.4 by J. Hiscocks released: ・ [Download](https://www.researchgate.net/profile/Jessica_Hiscocks/publication/341722714_MTEX_GUI_3pt4-_An_updated_graphical_interface_for_MTEX/data/5ed1b00e299bf1c67d274ede/MTEX-GUI-3pt4.zip)[Announcment](https://www.researchgate.net/publication/341722714_MTEX_GUI_3pt4-_An_updated_graphical_interface_for_MTEX)
1818
* New paper: [Gazing at crystal balls - electron backscatter diffraction indexing and cross correlation on the sphere](https://www-user.tu-chemnitz.de/~rahi/paper/gazingAtCrystalBalls.pdf)
1919
* New paper: [Denoising of Crystal Orientation Maps](https://www-user.tu-chemnitz.de/~rahi/paper/denoising.pdf)

pages/documentation_matlab/CrystalDirections.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Miller Indices
3-
last_updated: 20-Nov-2020
3+
last_updated: 08-Dec-2020
44
sidebar: documentation_sidebar
55
permalink: CrystalDirections.html
66
folder: documentation
@@ -11,7 +11,7 @@
1111
<!--
1212
This HTML was auto-generated from MATLAB code.
1313
To make changes, update the MATLAB code and republish this document.
14-
--><title>Miller Indices</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-11-20"><meta name="DC.source" content="script_CrystalDirections.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/CrystalGeometry/CrystalDirections.m">
14+
--><title>Miller Indices</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-12-08"><meta name="DC.source" content="script_CrystalDirections.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/CrystalGeometry/CrystalDirections.m">
1515
edit page</a></font><div><!--introduction--><p>Miller indices are used to describe directions with respect to the crystal reference system.</p><!--/introduction--><h2 id="1">Crystal Lattice Directions</h2><p>Since lattice directions are always subject to a certain crystal reference frame, the starting point for any crystal direction is the definition of a variable of type <a href="crystalSymmetry.crystalSymmetry.html">crystalSymmetry</a>.</p>
1616
{% highlight matlab %}
1717
cs = crystalSymmetry('triclinic',[5.29,9.18,9.42],[90.4,98.9,90.1]*degree,...

pages/documentation_matlab/EBSDReferenceFrame.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Reference Frame Alignment
3-
last_updated: 20-Nov-2020
3+
last_updated: 08-Dec-2020
44
sidebar: documentation_sidebar
55
permalink: EBSDReferenceFrame.html
66
folder: documentation
@@ -11,7 +11,7 @@
1111
<!--
1212
This HTML was auto-generated from MATLAB code.
1313
To make changes, update the MATLAB code and republish this document.
14-
--><title>Reference Frame Alignment</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-11-20"><meta name="DC.source" content="script_EBSDReferenceFrame.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/EBSDAnalysis/EBSDReferenceFrame.m">
14+
--><title>Reference Frame Alignment</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-12-08"><meta name="DC.source" content="script_EBSDReferenceFrame.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/EBSDAnalysis/EBSDReferenceFrame.m">
1515
edit page</a></font><div><!--introduction--><!--/introduction--><p>The most important difference between MTEX and many other EBSD software is that in MTEX the Euler angle reference is always the map reference frame. This mean the \(x\) and \(z\) axes of the map are exactly the rotation axes of the Euler angles.</p><p>In case the map coordinates and the Euler angles in your data are with respect to different reference frames it is highly recommendet to correct for this while importing the data into MTEX. This section explains in detail how to do this.</p><h2 id="2">On Sreen Orientation of the EBSD Map</h2><p>Many peoply are concerned when the images produced by MTEX are not aligned exactly as they are in their commercial software. It is indeed very important to understand exactly the alignment of you data. However, the important point is not whether a map is upside down on you screen or not. The important point is how your map alignes with the specimen, as we want to use the map to describe properties of the specimen.</p><p>There are basicaly two components in an EBSD data set that refers to the specimen reference frame: the spatial coordinates \(x\), \(y\) and the Euler angles \(\phi_1\), \(\Phi\), \(\phi_2\). To explain the difference have a look at the EDAX export dialog</p><p><center>
1616
{% include inline_image.html file="edax_coordinate_systems.png" %}
1717
</center></p><p>Here we have the axes \(x\) and \(y\) which describe how the map coordinates needs to be interpreted and the axes \(A_1\), \(A_2\), \(A_3\) which describe how the Euler angles, and in consequence, the pole figures needs to be interpreted. We see that in non of these settings the map reference system coincides with the Euler angle reference frame.</p><p>This situation is not specific to EDAX but occurs as well with EBSD data from Oxford or Bruker, all of them using different reference system alignments. For that reason MTEX stronly recommends to transform the data such that both map coordinates and Euler angles refer to the same coordinate system.</p><p>Doing this we have two choices:</p><div><ol><li>transfrom everything to the reference system \(x\), \(y\) using the option <code class="language-plaintext highlighter-rouge">'convertEuler2SpatialReferenceFrame'</code>. This will keep the map coordinates while changing the Euler angles</li><li>transfrom everything to the reference system \(A_1\), \(A_2\), \(A_3\) using the option <code class="language-plaintext highlighter-rouge">'convertSpatial2EulerReferenceFrame'</code>. This will keep the Euler angles while changing the map coordinates.</li></ol></div><p>In the case of EDAX data imported from an <code class="language-plaintext highlighter-rouge">*.ang</code> file we still need to specify the export option used by the EDAX software. This is done by the options <code class="language-plaintext highlighter-rouge">'setting 1'</code>, <code class="language-plaintext highlighter-rouge">'setting 2'</code>, <code class="language-plaintext highlighter-rouge">'setting 3'</code> or <code class="language-plaintext highlighter-rouge">'setting 4'</code>.</p><p>Since setting 2 is default for most EDAX exports a typical command for importing data from an ang file would look like this</p>

pages/documentation_matlab/GrainSmoothing.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Grain Boundary Smoothing
3-
last_updated: 20-Nov-2020
3+
last_updated: 08-Dec-2020
44
sidebar: documentation_sidebar
55
permalink: GrainSmoothing.html
66
folder: documentation
@@ -11,7 +11,7 @@
1111
<!--
1212
This HTML was auto-generated from MATLAB code.
1313
To make changes, update the MATLAB code and republish this document.
14-
--><title>Grain Boundary Smoothing</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-11-20"><meta name="DC.source" content="script_GrainSmoothing.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/GrainBoundaries/GrainSmoothing.m">
14+
--><title>Grain Boundary Smoothing</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-12-08"><meta name="DC.source" content="script_GrainSmoothing.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/GrainBoundaries/GrainSmoothing.m">
1515
edit page</a></font><div><!--introduction--><!--/introduction--><p>EBSD data is usually acquired on a regular grid. Hence, even over a finite number of grid points, all possible grain boundary directions can not be uniquely represented. One way of overcoming this problem - and also allowing to compute grid-independent curvatures and grain boundary directions - is the interpolation of grain boundary coordinates using <a href="grain2d.smooth.html"><code class="language-plaintext highlighter-rouge">grains.smooth</code></a>.</p><p>Proper smoothing has an influence on measures such as total grain boundary length, grain boundary curvature, triple point angles or grain boundary directions among others.</p><p>While we used <a href="grain2d.smooth.html"><code class="language-plaintext highlighter-rouge">grains.smooth</code></a> before, here we will illustrate the different options.</p>
1616
{% highlight matlab %}
1717
mtexdata csl

pages/documentation_matlab/OrientationFibre.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Fibres of Orientations
3-
last_updated: 20-Nov-2020
3+
last_updated: 08-Dec-2020
44
sidebar: documentation_sidebar
55
permalink: OrientationFibre.html
66
folder: documentation
@@ -11,7 +11,7 @@
1111
<!--
1212
This HTML was auto-generated from MATLAB code.
1313
To make changes, update the MATLAB code and republish this document.
14-
--><title>Fibres of Orientations</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-11-20"><meta name="DC.source" content="script_OrientationFibre.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/CrystalOrientations/OrientationFibre.m">
14+
--><title>Fibres of Orientations</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-12-08"><meta name="DC.source" content="script_OrientationFibre.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/CrystalOrientations/OrientationFibre.m">
1515
edit page</a></font><div><!--introduction--><!--/introduction--><p>A fibre in orientation space is essentially a line connecting two orientations and can be represented in MTEX by a single variable of type <a href="fibre.fibre.html">fibre</a>. To illustrate the definition of a fibre we first define <a href="orientation.cube.html"><code class="language-plaintext highlighter-rouge">cube</code></a> and <a href="orientation.goss.html"><code class="language-plaintext highlighter-rouge">goss</code></a> orientation</p>
1616
{% highlight matlab %}
1717
% define crystal and specimen symmetry

pages/documentation_matlab/PiezoElectricity.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: The Piezoelectricity Tensor
3-
last_updated: 20-Nov-2020
3+
last_updated: 08-Dec-2020
44
sidebar: documentation_sidebar
55
permalink: PiezoElectricity.html
66
folder: documentation
@@ -11,7 +11,7 @@
1111
<!--
1212
This HTML was auto-generated from MATLAB code.
1313
To make changes, update the MATLAB code and republish this document.
14-
--><title>The Piezoelectricity Tensor</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-11-20"><meta name="DC.source" content="script_PiezoElectricity.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/Tensors/PiezoElectricity.m">
14+
--><title>The Piezoelectricity Tensor</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-12-08"><meta name="DC.source" content="script_PiezoElectricity.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/Tensors/PiezoElectricity.m">
1515
edit page</a></font><div><!--introduction--><!--/introduction--><p>In this chapter we discuss how to compute and visualize piezoellectirc properties. At first, let us import some piezoelectric contents for a quartz specimen.</p>
1616
{% highlight matlab %}
1717
CS = crystalSymmetry('32', [4.916 4.916 5.4054], 'X||a*', 'Z||c', 'mineral', 'Quartz');

pages/documentation_matlab/S2FunApproximationInterpolation.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Spherical Approximation and Interpolation
3-
last_updated: 20-Nov-2020
3+
last_updated: 08-Dec-2020
44
sidebar: documentation_sidebar
55
permalink: S2FunApproximationInterpolation.html
66
folder: documentation
@@ -11,7 +11,7 @@
1111
<!--
1212
This HTML was auto-generated from MATLAB code.
1313
To make changes, update the MATLAB code and republish this document.
14-
--><title>Spherical Approximation and Interpolation</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-11-20"><meta name="DC.source" content="script_S2FunApproximationInterpolation.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/SphericalFunctions/S2FunApproximationInterpolation.m">
14+
--><title>Spherical Approximation and Interpolation</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-12-08"><meta name="DC.source" content="script_S2FunApproximationInterpolation.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/SphericalFunctions/S2FunApproximationInterpolation.m">
1515
edit page</a></font><div><!--introduction--><!--/introduction--><p>On this page, we want to cover the topic of function approximation from discrete values on the sphere. To simulate this, we have stored some nodes and corresponding function values which we can load. The csv-file contains the \(x\)-, \(y\)-, and \(z\)-component of the nodes and the function value in the fourth column. Lets import these data using the function <a href="vector3d.load.html"><code class="language-plaintext highlighter-rouge">load</code></a></p>
1616
{% highlight matlab %}
1717
fname = fullfile(mtexDataPath, 'vector3d', 'smiley.csv');

pages/documentation_matlab/SigmaSections.html

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Sigma Sections
3-
last_updated: 20-Nov-2020
3+
last_updated: 08-Dec-2020
44
sidebar: documentation_sidebar
55
permalink: SigmaSections.html
66
folder: documentation
@@ -11,7 +11,7 @@
1111
<!--
1212
This HTML was auto-generated from MATLAB code.
1313
To make changes, update the MATLAB code and republish this document.
14-
--><title>Sigma Sections</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-11-20"><meta name="DC.source" content="script_SigmaSections.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/ODFAnalysis/SigmaSections.m">
14+
--><title>Sigma Sections</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-12-08"><meta name="DC.source" content="script_SigmaSections.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/ODFAnalysis/SigmaSections.m">
1515
edit page</a></font><div><!--introduction--><!--/introduction--><p>Although \(\varphi_2\) sections are most common to represent orientation distribution functions they heavily suffer from geometrical distortions of the orientation space. Lets illustrate this at a simple example. The following \(\varphi_2\) sections represent a hexagonal ODF composod from several unimodal components</p>
1616
{% highlight matlab %}
1717
% the ODF is defined at the bottom of this script to be secret during the first read :)
@@ -39,9 +39,7 @@
3939

4040
{% highlight plaintext %}
4141
ori1 = orientation
42-
size: 1 x 1
4342
crystal symmetry : Titanium (6/mmm, X||a*, Y||b, Z||c*)
44-
specimen symmetry: 1
4543

4644
Bunge Euler angles in degree
4745
phi1 Phi phi2 Inv.
@@ -54,9 +52,7 @@
5452

5553
{% highlight plaintext %}
5654
ori2 = orientation
57-
size: 1 x 1
5855
crystal symmetry : Titanium (6/mmm, X||a*, Y||b, Z||c*)
59-
specimen symmetry: 1
6056

6157
Bunge Euler angles in degree
6258
phi1 Phi phi2 Inv.

pages/documentation_matlab/TiBetaReconstruction.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Parent Beta Phase Reconstruction in Titanium Alloys
3-
last_updated: 20-Nov-2020
3+
last_updated: 08-Dec-2020
44
sidebar: documentation_sidebar
55
permalink: TiBetaReconstruction.html
66
folder: documentation
@@ -11,7 +11,7 @@
1111
<!--
1212
This HTML was auto-generated from MATLAB code.
1313
To make changes, update the MATLAB code and republish this document.
14-
--><title>Parent Beta Phase Reconstruction in Titanium Alloys</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-11-20"><meta name="DC.source" content="script_TiBetaReconstruction.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/PhaseTransistions/TiBetaReconstruction.m">
14+
--><title>Parent Beta Phase Reconstruction in Titanium Alloys</title><meta name="generator" content="MATLAB 9.9"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-12-08"><meta name="DC.source" content="script_TiBetaReconstruction.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/PhaseTransistions/TiBetaReconstruction.m">
1515
edit page</a></font><div><!--introduction--><!--/introduction--><p>In this section we discuss parent grain reconstruction at the example of a titanium alloy. Lets start by importing a sample data set</p>
1616
{% highlight matlab %}
1717
mtexdata alphaBetaTitanium
@@ -51,10 +51,10 @@
5151
% reconstruct grains
5252
[grains,ebsd.grainId] = calcGrains(ebsd('indexed'),'threshold',1.5*degree,...
5353
'removeQuadruplePoints');
54-
grains = smooth(grains);
54+
grains = smooth(grains,1,'moveTriplePoints');
5555

5656
% plot all alpha pixels
57-
region = [300 400 -500 -440];
57+
region = [299 401 -500 -440];
5858
plot(ebsd(alphaName),ebsd(alphaName).orientations,...
5959
'region',region,'micronbar','off','figSize','large');
6060

0 commit comments

Comments
 (0)