ebsdlab

ALPHA-VERSION: TRY AT OWN RISK

Electron Backscatter Diffraction (EBSD) is a microanalytical technique used in scanning electron microscopes to determine the crystallographic orientation of metals at the micrometer scale. This software package provides tools to import, analyze, and visualize the spatially resolved orientation data obtained from EBSD experiments, facilitating microstructural characterization.

Features:

• File formats accepted .ang | .osc | .crc | .txt
• can write .ang for FCC. Others could be added
• fast plotting interaction using virtual mask (only used for plotting)
  • increases speed in intermediate test plots
  • can be removed just before final plotting
• verified with the OIM software and mTex
• heavily tested for cubic
• separate crystal orientation and plotting of it
• some educational plotting
• examples and lots of documentation

Example

EBSD-Inverse Pole Figure (IPF) of polycrystalline Copper with corresponding Pole Figure

Documentation

Documentation on github pages

Installation

You can install ebsdlab using Conda or pip.

$ git clone https://github.com/micromechanics/ebsdlab.git ./ebsdlab
$ cd ebsdlab

$ conda env create -f environment.yml

$ conda activate ebsdlab_env

$ python -m pip install .

$ python -m venv venv_python_ebsd  # Create a virtual environment
$ For Linux/macOS: source venv_python_ebsd/bin/activate
$ For Windows: venv_python_ebsd\Scripts\activate

$ pip install git+https://github.com/micromechanics/ebsdlab

After that, the package can be imported and used in Python codes as

>>> from ebsdlab import EBSD
>>> emap = EBSD("Examples/EBSD.ang")
>>> emap.plot(e.CI)

FAQ

What features I do not envision:

• include all crystal symmetries (materials science can mostly live with few)
• other Euler angle definitions than Bunge; materials science does not use those

Future features

• improve cleaning
• grain identification methods
• speed up simulation
• add different symmetries than cubic, and test

Help wanted

• sample files other than copper OIM files
• feedback on tutorials
• any feedback on functionality
• help with cleaning and grain identification