Introduction to PIEFACE

Polyhedra Inscribing Ellipsoids For Analysis of Coordination Environments

Polyhedra Inscribing Ellipsoids For Analysis of Coordination Environments (or PIEFACE) is an open source Python project intended for the analysis of distortions of a chemical coordination polyhedron. The analysis is very general, irrespective of polyhedron size or nature of the distortion, and could be applied to any problem where a coordination sphere with known coordinates exists, from extended inorganic solids to organic molecules. Full details of the method can be found in the original research article, James Cumby & J. Paul Attfield, Ellipsoidal Analysis of Coordination Polyhedra, Nature Communications 14235 (2017)., including some interesting examples.

For many crystallographic polyhedra, distortion is difficult to rationalise simply in terms of deviations of bond lengths or bond angles from ideal values. By fitting the smallest volume ellipsoid around the polyhedron, distortions are defined in terms of the three principal axes of the ellipsoid and it’s orientation in space. The distortion of this ellipsoid can then give a simple description of the distortions involved.

Getting Started

Once installed (see Installation) PIEFACE can be accessed either through a command-line interface (CIFellipsoid) or a user-friendly graphical interface (EllipsoidGUI). Both should be available on the system command line/terminal, and also from the start menu (if installed using the Windows installer).

EllipsoidGUI
Should be adequate for most users. This GUI provides a clickable interface to commonly used PIEFACE functions, and allows users to import CIF files for analysis, and examine/save the resulting output.
CIFellipsoid
Gives terminal-based access to a wider range of capabilities, details of which can be found by typing CIFellipsoid --help.

In both cases, the input required is one or more CIF files, and a list of atom types or labels to be used as polyhedron centres and ligands. Once calculated (which can take some time for a large number of files) the resulting ellipsoid parameters are saved as a text file (one per CIF file). The resulting ellipsoids and parameters can also be visualised interactively.

More detailed examples of usage can be found in Tutorials.

License

PIEFACE is distributed under the MIT license. Any use of the software should be cited.

Disclaimer

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!

Authors

James Cumby - james.cumby@ed.ac.uk