Unit Cell Extraction

Unsupervised and Accurate extraction of Unit Cells from Crystal Images

View the Project on GitHub nmevenkamp/UnitCellExtraction

Primitive Unit Cell Extraction

Version 2.0

The main purpose of this code is unsupervised and accurate primitive unit cell extraction from crystal images. The method and code was developed for crystallographers and material scientists. However, it is designed to find the symmetry axes and corresponding periods in generic periodic images and could therefore be of use in other applications as well.


The program is intended to be executed in a terminal using a text file to specify the input file and output directory.

Please refer to the README for instructions on how to compile and run.


LICENSE: This code is distributed under the terms of the Common Development and Distribution License.
Particularly, you can download and use this software free of cost.

We appreciate any feedback on your experience with this program. In case you encounter any problems, please don't hesitate to contact us: mevenkamp@aices.rwth-aachen.de


If you use our code in the context of a publication, please refer to our related work:

[1] N. Mevenkamp, and B. Berkels: Unsupervised and Accurate Extraction of Primitive Unit Cells from Crystal Images, in J. Gall, P. Gehler, and B. Leibe (Eds.), GCPR 2015, Springer International Publishing, 9358, pp. 105-116, 2015. [ PDF | DOI | BIB ]