5.5.2

mtex-toolbox · Dec 15, 2020 · 48dbbe4 · 48dbbe4
1 parent be7f6cb
commit 48dbbe4
Show file tree

Hide file tree

Showing 117 changed files with 1,067 additions and 258 deletions.
diff --git a/images/MaParentGrainReconstruction_15.png b/images/MaParentGrainReconstruction_15.png
diff --git a/images/SelectingGrains_16.png b/images/SelectingGrains_16.png
diff --git a/index.md b/index.md
@@ -13,7 +13,7 @@ scientists, geologists and mathematicians.
 
 ### News
 * MTEX Online Workshop 2021: ・ [Announcement](https://github.com/mtex-toolbox/mtex/discussions/519#discussioncomment-139964) ・ [Homepage](http://www-user.tu-chemnitz.de/~rahi/mtexWorkshop21) ・
-* 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) ・
+* MTEX 5.5.2 released: ・ [Download](https://github.com/mtex-toolbox/mtex/releases/download/mtex-5.5.2/mtex-5.5.2.zip) ・ [Release Notes](changelog.html) ・ [Installation](download) ・
 * 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) ・
 * 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)
 * New paper: [Denoising of Crystal Orientation Maps](https://www-user.tu-chemnitz.de/~rahi/paper/denoising.pdf)

diff --git a/pages/companies/Infineon.png b/pages/companies/Infineon.png
diff --git a/pages/companies/dillinger.png b/pages/companies/dillinger.png
diff --git a/pages/companies/mtu.png b/pages/companies/mtu.png
diff --git a/pages/companies/pic/Infineon.png b/pages/companies/pic/Infineon.png
diff --git a/pages/companies/pic/dillinger.png b/pages/companies/pic/dillinger.png
diff --git a/pages/companies/pic/mtu.png b/pages/companies/pic/mtu.png
diff --git a/pages/companies/pic/salzgitter.png b/pages/companies/pic/salzgitter.png
diff --git a/pages/companies/pic/vw.png b/pages/companies/pic/vw.png
diff --git a/pages/companies/salzgitter.png b/pages/companies/salzgitter.png
diff --git a/pages/companies/vw.png b/pages/companies/vw.png
diff --git a/pages/documentation_matlab/ClusterDemo.html b/pages/documentation_matlab/ClusterDemo.html
@@ -0,0 +1,138 @@
+---
+title: Cluster demo
+last_updated: 11-Dec-2020
+sidebar: documentation_sidebar
+permalink: ClusterDemo.html
+folder: documentation
+toc: false
+---
+    <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+   <!--
+This HTML was auto-generated from MATLAB code.
+To make changes, update the MATLAB code and republish this document.
+      --><title>Cluster demo</title><meta name="generator" content="MATLAB 9.10"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-12-11"><meta name="DC.source" content="script_ClusterDemo.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/GeneralConcepts/ClusterDemo.m">
+    edit page</a></font><div><!--introduction--><!--/introduction-->
+{% highlight matlab %}
+cs  = crystalSymmetry('432');
+odf = unimodalODF(orientation.rand(2,cs),'halfwidth',5*degree)
+
+
+ori = odf.discreteSample(10000)
+
+r = ori * Miller(1,0,0,odf.CS)
+
+%scatter(r)
+{% endhighlight %}
+
+{% highlight plaintext %}
+odf = ODF  
+  crystal symmetry : 432
+
+  Radially symmetric portion:
+    kernel: de la Vallee Poussin, halfwidth 5°
+    center: Rotations: 2 x 1
+    weight: 1
+
+
+ori = orientation  
+  size: 10000 x 1
+  crystal symmetry : 432
+
+r = vector3d  
+ size: 10000 x 1
+{% endhighlight %}
+
+{% highlight matlab %}
+[cId,center] = calcCluster(r,'numCluster',12);
+
+plotCluster(r,cId)
+
+annotate(center,'add2all')
+{% endhighlight %}
+<center>
+{% include inline_image.html file="ClusterDemo_01.png" %}
+</center>
+{% highlight matlab %}
+r.antipodal = true
+
+[cId,center] = calcCluster(r,'numCluster',6);
+
+plotCluster(r,cId)
+
+annotate(center,'add2all')
+{% endhighlight %}
+
+{% highlight plaintext %}
+r = vector3d  
+ size: 10000 x 1
+ antipodal: true
+{% endhighlight %}
+<center>
+{% include inline_image.html file="ClusterDemo_02.png" %}
+</center>
+{% highlight matlab %}
+h = ori \ vector3d(1,2,0);
+
+[cId,center] = calcCluster(h,'numCluster',2);
+
+plotCluster(h.project2FundamentalRegion,cId,'fundamentalSector')
+
+annotate(center,'add2all')
+{% endhighlight %}
+<center>
+{% include inline_image.html file="ClusterDemo_03.png" %}
+</center>
+{% highlight matlab %}
+[cId,center] = calcCluster(ori,'numCluster',2,'method','hierarchical');
+
+plotCluster(r,cId)
+
+annotate(center * Miller(1,0,0,ori.CS),'add2all')
+{% endhighlight %}
+<center>
+{% include inline_image.html file="ClusterDemo_04.png" %}
+</center>
+{% highlight matlab %}
+[cId,center] = calcCluster(ori,'numCluster',2,'method','odf');
+
+plotCluster(r,cId)
+
+annotate(center * Miller(1,0,0,ori.CS),'add2all')
+{% endhighlight %}
+
+{% highlight plaintext %}
+...
+{% endhighlight %}
+<center>
+{% include inline_image.html file="ClusterDemo_05.png" %}
+</center>
+{% highlight matlab %}
+% compute the full distance matrix
+d = angle_outer(r,r);
+d(d<0.01) = 0;
+%d = d(triu(true(size(d)),1));
+d = squareform(d);
+
+
+% use the statistic toolbox
+z = linkage(d,'single');
+
+%cId = cluster(z,'cutoff',30*degree);
+cId = cluster(z,'maxclust',12);
+
+plotCluster(r,cId)
+{% endhighlight %}
+
+{% highlight matlab %}
+function plotCluster(r,cId,varargin)
+
+scatter(r(cId==1),'MarkerFaceColor',ind2color(1),varargin{:})
+hold on
+for i = 2:max(cId)
+  scatter(r(cId==i),'add2all','MarkerFaceColor',ind2color(i),varargin{:})
+end
+hold off
+end
+{% endhighlight %}
+</div></body></html>
diff --git a/pages/documentation_matlab/CrystalDirections.html b/pages/documentation_matlab/CrystalDirections.html
@@ -1,6 +1,6 @@
 ---
 title: Miller Indices
-last_updated: 08-Dec-2020
+last_updated: 11-Dec-2020
 sidebar: documentation_sidebar
 permalink: CrystalDirections.html
 folder: documentation
@@ -11,7 +11,7 @@
    <!--
 This HTML was auto-generated from MATLAB code.
 To make changes, update the MATLAB code and republish this document.
-      --><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">
+      --><title>Miller Indices</title><meta name="generator" content="MATLAB 9.10"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-12-11"><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">
     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>
 {% highlight matlab %}
 cs = crystalSymmetry('triclinic',[5.29,9.18,9.42],[90.4,98.9,90.1]*degree,...

diff --git a/pages/documentation_matlab/EBSDReferenceFrame.html b/pages/documentation_matlab/EBSDReferenceFrame.html
@@ -1,6 +1,6 @@
 ---
 title: Reference Frame Alignment
-last_updated: 08-Dec-2020
+last_updated: 11-Dec-2020
 sidebar: documentation_sidebar
 permalink: EBSDReferenceFrame.html
 folder: documentation
@@ -11,7 +11,7 @@
    <!--
 This HTML was auto-generated from MATLAB code.
 To make changes, update the MATLAB code and republish this document.
-      --><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">
+      --><title>Reference Frame Alignment</title><meta name="generator" content="MATLAB 9.10"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-12-11"><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">
     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>
 {% include inline_image.html file="edax_coordinate_systems.png" %}
 </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>

diff --git a/pages/documentation_matlab/EBSDSelect.html b/pages/documentation_matlab/EBSDSelect.html
@@ -1,6 +1,6 @@
 ---
 title: Select EBSD data
-last_updated: 20-Nov-2020
+last_updated: 15-Dec-2020
 sidebar: documentation_sidebar
 permalink: EBSDSelect.html
 folder: documentation
@@ -11,8 +11,8 @@
    <!--
 This HTML was auto-generated from MATLAB code.
 To make changes, update the MATLAB code and republish this document.
-      --><title>Select EBSD data</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_EBSDSelect.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/EBSDAnalysis/EBSDSelect.m">
-    edit page</a></font><div><!--introduction--><!--/introduction--><p>In this section we discuss how to select specific EBSD data by certain properties. Let us first import some example <a href="mtexdata.html">EBSD data</a>. and plot the raw data</p>
+      --><title>Select EBSD data</title><meta name="generator" content="MATLAB 9.10"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-12-15"><meta name="DC.source" content="script_EBSDSelect.m"></head><body><font size="2"><a href="https://github.com/mtex-toolbox/mtex/blob/develop/doc/EBSDAnalysis/EBSDSelect.m">
+    edit page</a></font><div><!--introduction--><!--/introduction--><p>In this section we discuss how to select specific EBSD data by certain properties. Let us first import some example EBSD data using the command <a href="mtexdata.html"><code class="language-plaintext highlighter-rouge">mtexdata</code></a>.</p>
 {% highlight matlab %}
 mtexdata forsterite
 {% endhighlight %}

diff --git a/pages/documentation_matlab/GrainSmoothing.html b/pages/documentation_matlab/GrainSmoothing.html
@@ -1,6 +1,6 @@
 ---
 title: Grain Boundary Smoothing
-last_updated: 08-Dec-2020
+last_updated: 11-Dec-2020
 sidebar: documentation_sidebar
 permalink: GrainSmoothing.html
 folder: documentation
@@ -11,7 +11,7 @@
    <!--
 This HTML was auto-generated from MATLAB code.
 To make changes, update the MATLAB code and republish this document.
-      --><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">
+      --><title>Grain Boundary Smoothing</title><meta name="generator" content="MATLAB 9.10"><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"><meta name="DC.date" content="2020-12-11"><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">
     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>
 {% highlight matlab %}
 mtexdata csl