pyobjcryst documentation

pyobjcryst - Python bindings to the ObjCryst++ Object-Oriented Crystallographic Library

Software version 2.2.2.post22.
Last updated December 07, 2022.


pyobjcryst was written as part of the DANSE open-source project by Christopher Farrow, Pavol Juhás, and Simon J.L. Billinge. The sources are now maintained as a part of the DiffPy-CMI complex modeling initiative at the Brookhaven National Laboratory.

Further developments including the ability to index and refine powder patterns, solve and display crystal structures, using the global optimisation and least squares algorithms (see the Example notebooks) are provided by Vincent Favre-Nicolin (ESRF).

For a complete list of contributors, see and


pyobjcryst and libobjcryst conda packages can be easily installed under Linux and macOS using channel conda-forge or diffpy channels, e.g.:

  • conda install -c diffpy libobjcryst pyobjcryst

  • conda install -c conda-forge libobjcryst pyobjcryst

See the README file included with the distribution for more details.


pyobjcryst can be used in different ways:

Table of contents