DANSE logo diffpy logo DiffPy NSF logo
Python Libraries for Diffraction

Download

Unix, Linux, Mac - Windows - Updates - Subversion - Releases

License

By downloading and using this software you are agreeing to the following conditions.

This program is part of the DiffPy and DANSE open-source projects
and is available subject to the conditions and terms laid out below.

If you use this program to do productive scientific research that leads
to publication, we ask that you acknowledge use of the program by citing
the following paper in your publication:

    C. L. Farrow, P. Juhas, J. W. Liu, D. Bryndin, E. S. Bozin,
    J. Bloch, Th. Proffen and S. J. L. Billinge, PDFfit2 and
    PDFgui: computer programs for studying nanostructure in
    crystals, J. Phys.: Condens.  Matter 19, 335219 (2007)

Copyright 2006-2007, Board of Trustees of Michigan State University,
Copyright 2008-2009, Board of Trustees of Columbia University in the
city of New York.  (Copyright holder indicated in each source file).

For more information please visit the project web-page:
    http://www.diffpy.org/
or email Prof. Simon Billinge at sb2896@columbia.edu

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

  * Redistributions of source code must retain the above copyright
    notice, this list of conditions and the following disclaimer.

  * Redistributions in binary form must reproduce the above copyright
    notice, this list of conditions and the following disclaimer in the
    documentation and/or other materials provided with the distribution.

  * Neither the name of the copyright holder nor the names of its
    contributors may be used to endorse or promote products derived from
    this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY COPYRIGHT HOLDER "AS IS".  COPYRIGHT HOLDER
EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES AND CONDITIONS, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY, TITLE, FITNESS, ADEQUACY OR SUITABILITY
FOR A PARTICULAR PURPOSE, AND ANY WARRANTIES OF FREEDOM FROM
INFRINGEMENT OF ANY DOMESTIC OR FOREIGN PATENT, COPYRIGHTS, TRADE
SECRETS OR OTHER PROPRIETARY RIGHTS OF ANY PARTY.  IN NO EVENT SHALL
COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE OR RELATING TO THIS AGREEMENT, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.

Unix, Linux, Mac

The installation of DiffPy requires several external libraries and applications. Consult the README.txt file included with the distribution and make sure these requirements are all in place.

The DiffPy components are registered at the Python Package Index (PyPI), therefore the most straightforward way to install is to execute easy_install MODULE_NAME. The easy_install command downloads, unzips and installs the required package together with its requirements, for example

    easy_install diffpy.pdfgui

would install diffpy.pdfgui together with diffpy.pdffit2 and diffpy.Structure that are required for its function. The programs can be then started as pdfgui or pdffit2.

The easy_install command is a part of the Python setuptools library. If it is not available, install the "python-setuptools" package with the system package manager or use the ".tgz" archive below, which comes with easy_install included.

If you prefer to install from local files, download the latest diffpy-VERSION.tgz archive list below, unpack and run the enclosed easy_install script

    tar -xzf diffpy-VERSION.tgz
    cd diffpy-VERSION
    ./easy_install diffpy.pdfgui

For more detailed installation instructions see PDFgui manual.

Windows

DiffPy is provided as self-installing archive for Windows systems. Download the latest diffpy-VERSION.exe file below, run it and follow the prompts.

The self-installing archive includes a complete installation of Python that is used to run PDFgui and PDFfit2. Nevertheless, PDFgui (and other DiffPy components) can be also installed under existing Python tree. This requires Python 2.5 with several external Python packages, namely setuptools, numpy, wxPython and matplotlib. To add PDFgui to an existing Python tree, start Windows command prompt and run the easy_install script from the Python25/Scripts directory

    cd c:\Python25\Scripts
    ..\python.exe easy_install-script.py diffpy.pdfgui

This installs library files under Python25/Lib/site-packages and executable scripts for pdfgui and pdffit2 under Python25/Scripts.

DiffPy updates

Both Unix and Windows platforms can use the easy_install command to obtain the latest updates to the code. For example, to upgrade PDFgui, run

    easy_install -U diffpy.pdfgui

This installs only the changed DiffPy components as they become available at the DiffPy package repository. These packages are smaller and will be updated more frequently than the complete installation archives.

Subversion repository

The latest development sources of DiffPy packages are available in a public subversion code repository. To install the latest development version of a DiffPy component called MODULE_NAME, run

    easy_install -U \
	svn://svn@danse.us/diffraction/diffraction/MODULE_NAME/trunk

Another option is to install in a development mode, which is more convenient for debugging and experimenting with the code. This can be done as

    svn checkout \
	svn://svn@danse.us/diffraction/diffraction/MODULE_NAME
    cd MODULE_NAME/trunk
    python setup.py develop

The DiffPy subversion repository can be browsed online here.

DiffPy Releases

Please, join in the community forum for tips and tricks and feedback.

Name                    Date                Size    Downloads
diffpy-1.0-r3067.exe 2010-02-12 13:24 21.5M 423 diffpy-1.0b.1368.exe 2010-02-12 13:24 20.8M 361 diffpy-1.0b.1792.exe 2010-02-12 13:24 20.4M 560 diffpy-1.0-r3067.tgz 2010-02-12 13:24 6.4M 153 diffpy-1.0b.1368.tgz 2010-02-12 13:24 7.4M 184 diffpy-1.0b.1792.tgz 2010-02-12 13:24 7.7M 270
Older releases are available in the downloads archive.
If you have questions or remarks about this site, please contact Simon J. Billinge.