pith. sign in

arxiv: 2605.25722 · v1 · pith:OAPKQWKLnew · submitted 2026-05-25 · ❄️ cond-mat.mtrl-sci

kikuchipy: an open-source toolbox for analysis of EBSD patterns

H{\aa}kon W. {\AA}nes , Phillip Crout , Lars Andreas Lervik , Ole Natlandsmyr , Tina Bergh , Jarle Hjelen , Antonius T. J. van Helvoort , Knut Marthinsen This is my paper

Pith reviewed 2026-06-29 21:39 UTC · model grok-4.3

classification ❄️ cond-mat.mtrl-sci
keywords EBSDelectron backscatter diffractiondictionary indexingHough indexingorientation mappingopen-source softwarePythonphase identification
0
0 comments X

The pith

kikuchipy supplies an open-source Python toolbox for Hough and dictionary indexing of electron backscatter diffraction patterns from all major vendors together with orientation refinement and validation tools.

A machine-rendered reading of the paper's core claim, the machinery that carries it, and where it could break.

The paper presents kikuchipy as a Python package that performs both Hough transform and dictionary indexing on electron backscatter diffraction patterns. It reads files from every major commercial vendor, refines orientations and projection centers, and validates results by generating independent maps or by direct visual comparison of measured and simulated patterns. The design uses existing scientific Python libraries to keep the workflow flexible so users can iterate quickly on indexing parameters. Three worked examples on real alloy data show the package handling orientation relationships in stainless steel and distinguishing phases in aluminium alloys. All pattern files and analysis scripts are released publicly so others can reproduce or extend the work.

Core claim

kikuchipy implements Hough and dictionary indexing, orientation and projection-center refinement, and pattern simulation inside one Python package that accepts file formats from all major EBSD vendors. Indexing results are validated both by maps calculated independently of the indexing step and by side-by-side comparison of experimental and simulated patterns. The authors demonstrate the complete workflow on three experimental datasets: orientation relationships in a super duplex stainless steel, phase separation of aluminium and silicon in a cast Al-Si alloy, and identification of Al6Mn versus alpha-AlMnSi particles in an Al-Mn alloy.

What carries the argument

The kikuchipy toolbox, which combines Hough and dictionary indexing with built-in pattern simulation and cross-validation routines inside the Python scientific stack.

If this is right

  • Users can run both indexing methods on the same dataset and compare outputs without switching software.
  • Orientation and projection-center refinement can be applied after initial indexing in the same environment.
  • Validation maps and simulated-pattern overlays become routine checks rather than separate post-processing steps.
  • Analysis pipelines written in Python can incorporate EBSD data alongside other scientific libraries without format conversion.
  • All raw patterns and analysis code are available so any researcher can repeat or modify the published workflows.

Where Pith is reading between the lines

These are editorial extensions of the paper, not claims the author makes directly.

  • Community contributions could add new indexing algorithms or vendor formats without requiring changes to commercial packages.
  • The public release of both patterns and scripts lowers the effort needed to benchmark new indexing methods against the same data.
  • Integration with machine-learning libraries already present in Python could allow hybrid indexing approaches that the paper does not explore.
  • Wider adoption might encourage standard file-format readers across different EBSD analysis tools.

Load-bearing premise

The indexing, refinement, and validation steps inside the software produce results accurate enough to be usable on experimental patterns collected from different alloys.

What would settle it

Execution of the released example scripts on the shared diffraction pattern files yields indexed orientations or phase maps that disagree with independent measurements or with known crystallographic relationships in the three alloys.

read the original abstract

We present kikuchipy, an open-source toolbox for analysis of electron backscatter diffraction patterns, written in Python. The software is capable of both Hough and dictionary indexing and orientation and/or projection center refinement of patterns stored in file formats from all major vendors. Indexing results can be validated using maps independent of indexing and by visually comparing experimental and simulated patterns. By leveraging scientific packages in the Python ecosystem, emphasis is put on making the indexing workflow flexible and improve results through fast iteration. The software's capabilities are demonstrated on three application examples: analysis of orientation relationships in a super duplex stainless steel, phase differentiation of aluminium and silicon in a cast modified Al-Si alloy, and phase differentiation of particles in an Al-Mn alloy as Al6Mn or alpha-AlMnSi. The diffraction patterns and analysis workflows are made publicly available. kikuchipy was created and is developed as a resource for the electron microscopy community, allowing anyone to improve the software or include it into their own analysis workflows or softwares.

Editorial analysis

A structured set of objections, weighed in public.

Desk editor's note, referee report, simulated authors' rebuttal, and a circularity audit. Tearing a paper down is the easy half of reading it; the pith above is the substance, this is the friction.

Referee Report

0 major / 2 minor

Summary. The manuscript presents kikuchipy, an open-source Python toolbox for EBSD pattern analysis. It implements Hough and dictionary indexing, orientation and projection center refinement, and supports file formats from all major vendors. Indexing results can be validated via independent maps and simulated pattern comparison. Capabilities are demonstrated on three experimental datasets (super duplex stainless steel for orientation relationships, cast Al-Si alloy for phase differentiation, and Al-Mn alloy for particle phase identification), with public release of the diffraction patterns and analysis workflows/scripts. The work positions the package as a flexible, community resource leveraging the Python scientific ecosystem.

Significance. If the described functionality holds, the paper provides a useful open-source contribution to the EBSD community by offering reproducible workflows and public data release. The emphasis on iteration speed, format support, and validation steps addresses practical needs in materials characterization. Public availability of patterns and scripts directly supports reproducibility claims and enables community extension or integration.

minor comments (2)
  1. [Abstract] The abstract states that patterns from 'all major vendors' are supported; a table or explicit list of supported formats (with version notes) in §2 or §3 would strengthen this claim for readers.
  2. [Abstract] The three application examples are described qualitatively; adding brief quantitative metrics (e.g., indexing success rate or angular resolution) in the final paragraph would help readers assess the 'usable results' claim without requiring code inspection.

Simulated Author's Rebuttal

0 responses · 0 unresolved

We thank the referee for their positive review and recommendation to accept the manuscript. No major comments were raised.

Circularity Check

0 steps flagged

No significant circularity identified

full rationale

The manuscript is a software description paper presenting the kikuchipy toolbox and its implementation of established EBSD indexing methods (Hough, dictionary indexing, refinement) with support for vendor formats. No mathematical derivations, first-principles predictions, fitted parameters presented as outputs, or self-referential uniqueness theorems appear in the text. The three application examples are workflow demonstrations on released experimental datasets rather than predictions that reduce to inputs by construction. The central claim is one of implemented functionality and public reproducibility, which is externally verifiable via the released code and data. No load-bearing steps reduce to self-citation chains or ansatzes smuggled via prior work by the same authors.

Axiom & Free-Parameter Ledger

0 free parameters · 0 axioms · 0 invented entities

This is a software description paper; no free parameters, mathematical axioms, or invented physical entities are present.

pith-pipeline@v0.9.1-grok · 5746 in / 1087 out tokens · 28497 ms · 2026-06-29T21:39:58.934444+00:00 · methodology

discussion (0)

Sign in with ORCID, Apple, or X to comment. Anyone can read and Pith papers without signing in.

Reference graph

Works this paper leans on

9 extracted references · 9 canonical work pages

  1. [1]

    doi:10.3390/met11122045. O. M. Akselsen, R. Bjørge, H. W. ˚Anes, X. Ren, and B. Ny- hus. Microstructure and Properties of Wire Arc Additive Manufacturing of Inconel 625.Metals, 12(11):1867, 2022. doi:10.3390/met12111867. H. W. ˚Anes, J. Hjelen, B. E. Sørensen, A. T. J. van Helvoort, and K. Marthinsen. Processing and indexing of elec- tron backscatter patt...

    work page doi:10.3390/met11122045 2022

  2. [2]

    doi:10.1016/j.matchar.2022.112228. H. W. ˚Anes, B. Martineau, P. Harrison, P. Crout, D. John- stone, N. Cautaerts, A. Gerlt, A. C. Mathisen, S. Høg˚ as, and A. Clausen. orix.https://doi.org/10.5281/zenodo. 3459662, 2023a. Zenodo. H. W. ˚Anes, A. T. J. van Helvoort, and K. Marthin- sen. Orientation dependent pinning of (sub)grains by dispersoids during rec...

    work page doi:10.1016/j.matchar.2022.112228 2022

  3. [3]

    doi:10.2320/matertrans.MT-LA2022046. S. F. Bord´ ın, S. Limandri, J. Ranalli, and G. Castel- lano. EBSD spatial resolution for detecting sigma phase in steels.Ultramicroscopy, 171:177–185, 2016. doi: 10.1016/j.ultramic.2016.09.010. T. B. Britton, J. Jiang, Y. Guo, A. Vilalta-Clemente, D. Wal- lis, L. N. Hansen, A. Winkelmann, and A. J. Wilkinson. Tutorial...

    work page doi:10.2320/matertrans.mt-la2022046 2016

  4. [4]

    doi:10.1007/s11661-023-07014-y. P. G. Callahan and M. De Graef. Dynamical Electron Backscatter Diffraction Patterns. Part I: Pattern Simula- tions.Microscopy and Microanalysis, 19:1255–1265, 2013. doi:10.1017/S1431927613001840. T. Chen and J. Yang. Effects of solution treatment and con- tinuous cooling onσ-phase precipitation in a 2205 duplex stainless st...

    work page doi:10.1007/s11661-023-07014-y 2013

  5. [5]

    doi:10.1017/S1431927617001751. F. de la Pe˜ na, E. Prestat, V. T. Fauske, P. Burdet, J. L¨ ahnemann, P. Jokubauskas, T. Furnival, M. Nord, T. Ostasevicius, K. E. MacArthur, D. N. Johnstone, M. Sarahan, J. Taillon, T. Aarholt, pquinn dls, V. Mi- gunov, A. Eljarrat, J. Caron, C. Francis, T. Nemoto, T. Poon, S. Mazzucco, actions user, N. Tappy, N. Cau- taert...

    work page doi:10.1017/s1431927617001751 2023

  6. [6]

    doi:10.1080/09500839408240993. R. C. Gonzalez and R. E. Woods.Digital Image Processing. Pearson Education Limited, 4th edition, 2017. ISBN 978- 0133356724. M. A. Groeber and M. A. Jackson. DREAM.3D: a digital rep- resentation environment for the analysis of microstructure in 3D.Integrating Materials and Manufacturing Innova- tion, 3(1):5, 2014. doi:10.118...

    work page doi:10.1080/09500839408240993 2017

  7. [7]

    doi:10.1016/j.actamat.2015.06.041. M. M. Makhlouf and H. V. Guthy. The aluminum-silicon eu- tectic reaction: Mechanisms and crystallography.Journal of Light Metals, 1(4):199–218, 2001. doi:10.1016/S1471- 5317(02)00003-2. K. Marquardt, M. De Graef, S. Singh, H. Marquardt, A. Rosenthal, and S. Koizuimi. Quantitative electron backscatter diffraction (EBSD) d...

    work page doi:10.1016/j.actamat.2015.06.041 2015

  8. [8]

    doi:10.1016/j.ultramic.2015.10.010. G. Nolze, R. Hielscher, and A. Winkelmann. Electron backscatter diffraction beyond the mainstream.Crys- tal Research and Technology, 52(1):1–24, 2017. doi: 10.1002/crat.201600252. M. M. Nowell and S. I. Wright. Phase differentiation via combined EBSD and XEDS.Journal of microscopy, 213 (3):296–305, 2004. doi:10.1111/j.0...

    work page doi:10.1016/j.ultramic.2015.10.010 2015

  9. [9]

    doi:10.1016/j.ultramic.2017.04.016. A. Ramirez, J. Lippold, and S. Brandi. The Relation- ship between Chromium Nitride and Secondary Austen- ite Precipitation in Duplex Stainless Steels.Metallurgical and materials transactions A, 34(8):1575–1597, 2003. doi: 10.1007/s11661-003-0304-9. A. Redja¨ ımia, A. Proult, P. Donnadieu, and J. Morniroli. Morphology, c...

    work page doi:10.1016/j.ultramic.2017.04.016 2017