ORTools
— a companion toolbox for
Orientation relationship tools (ORTools) is a function library for OR discovery, advanced OR analysis and the plotting of visually stunning and informative publication-ready figures particular to microstructures undergone partial/full martensitic transformation or OR-related phase transition.
The ORTools function library is written in MATLAB and is used as an add-on to the basic phase transformation functionalities within the MATLAB-based crystallographic toolbox MTEX. Due to their specific nature, the scripts contained in the ORTools library have not been included in MTEX. You may want to watch this talk by Frank Niessen at the 2021 MTEX Workshop for an introduction to the phase transformation features in MTEX and ORTools.
The advanced OR discovery, analysis and plotting functionalities of the ORTools library are highlighted in a series of example scripts that showcase how the functions work and what their output comprises.
To help maintain the ORTools library, please report any bugs you encounter in the discussions board. If you would like to contribute additional functionalities or wish to suggest new features that help improve it, please submit an issue or open a discussion.
A short introduction to ORTools
How to use ORTools
- The ORTools library only works after the prior installation of MATLAB and MTEX.
- Follow the instructions for installing MATLAB. ORTools is tested for compatibility from MATLAB 2016b onwards.
- With each release of ORTools, please check exactly which version of MTEX it is compatible with.
- Click on the weblinks to download either one of the following two combinations:
- Latest STABLE releases of:
- MTEX v7.1 and ORTools v3.0.1.
- DEVELOPER versions of:
- For instructions on installing MTEX and ORTools within MATLAB, please refer to the video given below.
- The peak fitting functionality within the function defineORs requires the prior installation of the MATLAB Signal Processing Toolbox.
- Open MATLAB and run one of the example files. Please refer to the Example 1 instruction video to learn how to run the examples. Alternatively, if you do not wish to run the example files and want to use the function library instead, please ensure that the ORTools root directory and all of its sub-directories are added to the MATLAB path.
- If you encounter any problems, please submit an issue or open a discussion.
- If you would like to contribute additional functionalities or wish to suggest new features, please submit a contribution or request a feature in the discussion.
How to cite ORTools
If you have applied the OR discovery, OR and variant analyses, parent grain reconstruction, and correlated plotting features of MTEX and ORTools to your research, please cite this open-access paper as your reference:
Authors and contributors
ORTools has been created by Dr Azdiar Gazder and Dr Frank Niessen.
Collaborators
Dr Tuomo Nyyssönen - Lath martensite block width calculator