...
- Download and unzip
- Navigate on the landing page above to the executable package links, e.g.
EMsoft-4.2.0-Win64.zip
- Download and extract the contents to a convenient directory (folder), like
C:\Users\YOUR_USERNAME\Documents\EMsoft
- Navigate on the landing page above to the executable package links, e.g.
- Tell Windows where the executables are located by adding the path to the executables,
C:\Users\YOUR_USERNAME\Documents\EMsoft\bin
, to environment variables (https://docs.microsoft.com/nb-no/windows/win32/shell/user-environment-variables) - A command line and text editor is needed to interact with EMsoft. On Windows, using Visual Studio Code (https://code.visualstudio.com/) is recommended by Prof. Marc DeGraef, the main developer of EMsoft.
- Make sure EMsoft is setup correctly by opening a terminal in Visual Studio Code and executing the program
EMOpenCLinfo
(typeEMOpenCLinfo
and press enter) - Setup the configuration by going to EMsoft's wiki pages on GitHub (https://github.com/EMsoft-org/EMsoft/wiki/Package-Configuration) and following the instructions there. (If you are unfamiliar with the Windows Command Prompt, here is a basic tutorial: https://www.makeuseof.com/tag/a-beginners-guide-to-the-windows-command-line/).
- All files produced by EMsoft are in the HDF5 format (Hierarchical Data Format version 5). To open these files, install an HDF file viewer like HDFView from the HDF Group: https://www.hdfgroup.org/downloads/hdfview. (They request that you register (for free) to download the viewer.)
Perform dictionary indexing
See the recently published, pedagogical, hands-on tutorial on how to do this: https://link.springer.com/article/10.1007%2Fs40192-019-00137-4.
To be able to index patterns stored in NORDIF's binary format, we need to address two issues:
- EMsoft cannot read the patterns stored in NORDIF's format, so, read the Pattern.dat file into KikuchiPy and write them to a .h5 file (HDF5), which can be read by EMsoft.
- EMsoft has no static background correction, so, before writing the patterns to the .h5 file, use the
static_background_correction()
method in KikuchiPy.