|
| 1 | +######### |
| 2 | +xINTERPDF |
| 3 | +######### |
| 4 | + |
| 5 | +xINTERPDF is a Python GUI program for analyzing X-ray pair distribution |
| 6 | +function (PDF) data of organic compounds collected at synchrotron and/or |
| 7 | +laboratory X-ray sources. It uses DiffPy-CMI as a backend for simulation |
| 8 | +of PDFs. |
| 9 | + |
| 10 | +Currently it supports: |
| 11 | + |
| 12 | +* The study of intermolecular interaction (e.g. hydrogen bonds) by |
| 13 | + subtracting out the scattering signal(s) of single molecule(s) in real |
| 14 | + space. |
| 15 | +* The PDF model fit of the crystalline organic compound using the method |
| 16 | + proposed by Prill *et al*. (`J. Appl. Crystallogr., 48, 171-178, 2015 |
| 17 | + <http://scripts.iucr.org/cgi-bin/paper?S1600576714026454>`__). |
| 18 | +* The phase quantification of physical mixtures of organics. |
| 19 | +* Generate Score/Scree plots based on Principle Component Analysis (PCA). |
| 20 | + |
| 21 | +A video demo about installation and usage is available at |
| 22 | +https://www.youtube.com/watch?v=lAFZ5VYEH1g. The code for xINTERPDF |
| 23 | +is hosted on `GitHub <https://github.com/curieshicy/xINTERPDF>`__. |
| 24 | + |
| 25 | +.. figure:: ../images/xinterpdf.png |
| 26 | + :align: center |
| 27 | + |
| 28 | +This is a first release of the program (v.0.1.0). Comments and |
| 29 | +suggestions are welcome. Please send an email to Chenyang Shi at |
| 30 | +cs3000@columbia.edu or post your questions to `diffpy-users`_ |
| 31 | +Google Group. |
| 32 | + |
| 33 | +Getting Started |
| 34 | +=============== |
| 35 | + |
| 36 | +The xINTERPDF package requires Python 2.7 and the following dependency packages: |
| 37 | + |
| 38 | +* ``NumPy`` - Numerical mathematics and fast array operations for Python |
| 39 | +* ``SciPy`` - Scientific libraries for Python |
| 40 | +* ``matplotlib`` - Python plotting library |
| 41 | +* ``Scikit-Learn`` - Python machine learning library; its PCA module is called. |
| 42 | +* ``diffpy-cmi`` - Versatile Python packages for simulation of atomic pair distribution functions |
| 43 | +* ``Tkinter`` - Python default library for creation of graphical user interface |
| 44 | + |
| 45 | +See the :doc:`xINTERPDF license <xinterpdflicense>` for terms and conditions of use. |
| 46 | + |
| 47 | +Installation |
| 48 | +------------ |
| 49 | + |
| 50 | +xINTERPDF can be installed on Linux and Mac OS machines. The recommended |
| 51 | +way to install this package is through conda. Please visit |
| 52 | +https://www.continuum.io/downloads, and select Python 2.7 version |
| 53 | +to download and install. Once conda is installed, you can follow the |
| 54 | +steps below to install xINTERPDF. |
| 55 | + |
| 56 | +*Step 1: Add the diffpy conda channel to your conda configuration.* :: |
| 57 | + |
| 58 | + conda config --add channels diffpy |
| 59 | + |
| 60 | +*Step 2: Create a virtural environment and install the program there.* :: |
| 61 | + |
| 62 | + conda create –c curieshicy –n xinterpdf xinterpdf |
| 63 | + |
| 64 | +This command first adds a *curieshicy* channel, then creates a virtual |
| 65 | +environment *xinterpdf*, before finally install the *xinterpdf* program. |
| 66 | +Note that you can name the environment anything you choose by passing it |
| 67 | +a different name after the *-n* flag in the command. |
| 68 | + |
| 69 | +*Step 3: Activate the virtual environment and start the program.* :: |
| 70 | + |
| 71 | + source activate xinterpdf |
| 72 | + xinterpdf |
| 73 | + |
| 74 | +The first command starts the virtual environment and the second invokes |
| 75 | +the main GUI window of the xINTERPDF program. |
| 76 | + |
| 77 | +User Guide |
| 78 | +---------- |
| 79 | + |
| 80 | +Please see `user manual <../doc/xinterpdf/xINTERPDF_User_Guide_20180615.pdf>`__ |
| 81 | +for more details. |
| 82 | + |
| 83 | +References |
| 84 | +---------- |
| 85 | + |
| 86 | +If you use this software in a research work which leads to publication, |
| 87 | +we ask you to acknowledge the use of xINTERPDF by citing the following |
| 88 | +papers: |
| 89 | + |
| 90 | +* |citeShiJac18| |
| 91 | +* |citeJuhasAca15| |
| 92 | + |
| 93 | + |
| 94 | +.. include:: ../abbreviations.txt |
| 95 | + |
| 96 | +.. toctree:: |
| 97 | + :hidden: |
| 98 | + |
| 99 | + xinterpdflicense |
0 commit comments