A simple, universal analysis/plotting tool to better capture the 3D nature of annealing twins in FCC and FCC-containing materials.
Twin Tree expands beyond the standard misorientation threshold dependent twin identification and analysis metrics to help better represent the 3D nature of annealing twins. By manipulating how the FCC twinning relationship is identified among neighboring/near-neighboring grains, various n-th order twin connections/generations can be extracted from and mapped across EBSD datasets using graphs. In turn, a user is not only able to calculate their grains and mergedGrains, but also a third grains-based variable, connectedGrains, which contains unique sets of n-th order twin connections and highlights the extensitive interconnectivity of annealing twins after microstructural evolution.
Twin Tree can handle both standard grain reconstruction and parent grain reconstructed EBSD datasets. Three example scripts have been built around a nickel, a dual-phase SS304, and a reconstructed austenite EBSD dataset, which are available for download from: https://doi.org/10.5281/zenodo.19685092. Regardless of using these example datasets, the example scripts can be easily adjusted to fit the user's needs. The workflow for Twin Tree also creates sample-specific folders for saving all generated plots and a final .mat file, which contains relevant variables and a struct of grain-, twin- and graph-based metrics for convenient later analysis.
A pre-print manuscript describing the Twin Tree framework and its integrated features in more details can be requested via email.
Twin Tree was developed in MATLAB R2022a using MTEX version 5.10.2. It can function with other versions before MTEX 6.0.0. For improved plot quality and easy saving, export_fig is used and can be downloaded here: https://www.mathworks.com/matlabcentral/fileexchange/23629-export_fig. ORTools functions were implimented in the reconstructed austenite example script for parent grain reconstruction to provide more comprehensive OR information. These additional elements can be removed/replaced by those listed in the MTEX documentation, but if desired, ORTools can be found here: https://github.com/ORTools4MTEX/ORTools.