DiffPy-CMI is our complex modeling framework. It is a highly flexible library of Python modules for robust modeling of nanostructures in crystals, nanomaterials, and amorphous materials.

The software provides functionality for storage and manipulation of structure data and calculation of structure-based quantities, such as PDF, SAS, bond valence sums, atom overlaps, bond lengths, and coordinations. Most importantly the DiffPy-CMI package contains a fitting framework for combining multiple experimental inputs in a single optimization problem.

This is an early release of code that is under intense development, with support for installation on Unix, Linux, and Macintosh machines. The scope and documentation of the project will evolve rapidly, but we want to make the code available at the earliest possible date. Please make use of the software and provide feedback and suggestions for improvement, but please be patient and check back frequently for updates.



Use of this software is subject to the conditions in software LICENSE.

As of version 3.0 DiffPy-CMI is available for Linux and Mac as a collection of packages for Anaconda Python. As a first step download and install Anaconda for Python 3.7 from https://www.anaconda.com/distribution.


DiffPy-CMI is available from the “diffpy” channel of Anaconda packages. It requires Python 3.5 or later or 2.7. It is recommended to install it in a separate Anaconda environment, for example py37 or other preferred python versions. Make sure that py37 environment is activated when working with DiffPy-CMI.

conda create --name=py37 python=3.7
conda activate py37

Once Anaconda is ready, DiffPy-CMI can be installed from the “diffpy” channel of Anaconda packages as follows

conda config --add channels diffpy
conda install diffpy-cmi

The software distribution over Anaconda makes it easy to publish frequent software updates. To update your installation later use

conda update diffpy-cmi

If you don’t want to use Anaconda you can install DiffPy-CMI from sources. Note that this method takes more time and requires more experience with the operating system.

What next?



Documentation for packages developed by the DiffPy team is available at the links below.

  • diffpy.srfit – configuration and control of data-fitting problems

  • diffpy.srreal – calculators for pair distribution function, bond valence sums, etc.

  • diffpy.structure – light-weight representation of crystal structures

  • pyobjcryst – Python interface to ObjCryst++ crystallographic library

  • diffpy.utils – general purpose utilities for the diffpy libraries

  • libdiffpy – C++ library for calculation of PDF and other real-space quantities

See DiffPy-CMI contents for a complete list of open-source libraries that are included in DiffPy-CMI and their respective project pages.


If you use this software in a research work which leads to publication, we ask you to acknowledge the use of DiffPy-CMI by citing the following paper: