Polyhedra Inscribing Ellipsoids For Analysis of Coordination Environments (or PIEFACE) is an open source Python project for the analysis of distortions in chemical coordination polyhedra. The analysis is achieved using a minimum bounding ellipsoid (MBE) method; the smallest volume ellipsoid that can enclose all of the polyhedral vertices. The result is very general, and is irrespective of polyhedron size or nature of the distortion. As such, the method has been applied to a range of crystallographic situations.
For more details, see the online documentation.
For detailed instructions, see installation. On Windows, the easiest way is to download and run the most recent PIEFACE Windows Installer release.
PIEFACE is open-source, distributed under an MIT license.
Use of the software should cite the article:
J. Cumby and J. P. Attfield, Ellipsoidal Analysis of Coordination Polyhedra, Nature Communications 14235 (2017).
PIEFACE is supplied with two utilities for easy use; a command-line program (CIFellipsoid) and a graphical interface (EllipsoidGUI).
These allow one or more CIF files to be read, coordination polyhedra to be determined, and ellipsoids to be fitted. The resulting ellipsoid
parameters can be saved to text file(s) and viewed interactively.
Once installed, the graphical interface can be started by typing EllipsoidGUI on the command line, or clicking the start menu icon (if installed using the Windows Installer).
The command line application can be run by typing CIFellipsoid with appropriate arguments:
CIFellipsoid CIF1 [CIF2 CIF3...] -m <polyhedron centre> -r <max bond length> -l <ligand types>
This will produce an output file of ellipsoid parameters (CIF.TXT) and a 3D plot of the ellipsoid with a summary of useful ellipsoid parameters.
Many other options are also available; type CIFellipsoid --help for details, open help from within EllipsoidGUI or see Script Help.
For more complex use cases, the package can be imported and used as a python package:
import pieface
phases, plots = pieface.calcellipsoid.calcfromcif([list of CIFs], [list of centres], **kwargs)
which will (by default) process all CIF files in parallel (as for the scripts). kwargs are many of the options available to CIFellipsoid; most important are
- ligtypes or lignames (to specify correct ligands for centres)
- radius (for bond searching)
- tolerance (for fit tolerance)
Individual modules from the package can also be imported (ie. pieface.ellipsoid) for perform specific functions: read the documentation in the
source code for more details or see the API reference.
See Tutorials.
Help can be accessed through:
- Online documentation
EllipsoidGUIfrom the help menuCIFellipsoid --help
The package contains some basic unit tests, which can be run with:
python setup.py test
All tests should pass without exceptions - if not please send me a bug report.
This software is provided as-is, on a best-effort basis. The authors accept no liabilities associated with the use of this software. It has been tested for accuracy of results for a number of cases, but only for uses that the authors can think of. We would be interested to hear of any suggestions for new uses, or potential additions to the software.
We will attempt to correct any bugs as they are found on a best-effort basis!
James Cumby - james.cumby@ed.ac.uk