Skip to main content

OctaDist: A tool for calculating distortion parameters in coordination complexes.

Project description

Python version PyPI-Server Python Wheel Code size Repo size

Github Download All releases Github Download Latest version


Octahedral distortion calculator: A tool for calculating distortion parameters in coordination complexes.


Standard abilities

OctaDist is computer software for inorganic chemistry and crystallography program. OctaDist can be used for studying the structural distortion in coordination complexes. With the abilities of OctaDist, you can:

  • analyze the structure and conformation of coordination complexes.
  • compute the octahedral distortion parameters.
  • explore tilting distortion in perovskite and metal-organic framework.
  • display 3D molecule and graphical analysis.
  • implement OctaDist's module into your or other program.
  • access the program core directly via an interactive scripting language.

Development and Release

OctaDist is written entirely in Python 3 binding to Tkinter GUI toolkit. It is cross-platform program which can work on multiple operating systems. The stable version and development build of OctaDist are released at here. A standalone executable for graphical user interface (GUI) and source code for command line interface (CLI) are available for as follows:

Platform Description Status
Windows Standalone executable Travis-CI Test
Linux Support for GUI and CLI Travis-CI Test
macOS Support for GUI and CLI Travis-CI Test
PyPI library PyPI-Server Travis-CI Test
Anaconda cloud Conda-Server Travis-CI Test
Nightly build Development build Travis-CI Test


  1. master
  2. nightly-build

Git Clone

git clone
git checkout nightly-build
git pull origin nightly-build


User manual :

Reference manual :

Version Status Docs
Stable Doc-Latest-Badge HTML / PDF / Epub
Dev Build Doc-Nightly-Badge HTML / PDF / Epub

Download and Install

For Windows users, we strongly suggest a standalone executable:

Click Here to Download OctaDist-2.6.1-Win-x86-64.exe

For Linux or macOS users and already have Python 3 installed on the system, the easiest way to install OctaDist is to use pip.

pip install octadist

or use conda for those who have Anaconda:

conda install -c rangsiman octadist

Starting OctaDist

Graphical User Interface (GUI)

To start GUI program:


Screenshots of program:

OctaDist GUI XYZ coordinates Computed distortion parameters

Command Line Interface (CLI)

To start program command line:


To calculate distortion parameters:

octadist_cli --inp

To calculate distortion parameters and show formatted output:

octadist_cli --inp --out

Supporting input format

Running the tests

Example 1: OctaDist as a package

import octadist as oc

# Prepare list of atomic coordinates of octahedral structure:

atom = ['Fe', 'O', 'O', 'N', 'N', 'N', 'N']

coord = [[2.298354000, 5.161785000, 7.971898000],  # <- Metal atom
         [1.885657000, 4.804777000, 6.183726000],
         [1.747515000, 6.960963000, 7.932784000],
         [4.094380000, 5.807257000, 7.588689000],
         [0.539005000, 4.482809000, 8.460004000],
         [2.812425000, 3.266553000, 8.131637000],
         [2.886404000, 5.392925000, 9.848966000]]

dist = oc.CalcDistortion(coord)
zeta = dist.zeta             # 0.228072561
delta =           # 0.000476251
sigma = dist.sigma           # 47.92652837
theta = dist.theta           # 122.6889727

Example 2: Display 3D structure of molecule

import octadist as oc

file = r"../example-input/"

atom_full, coord_full = oc.molecule.extract_coord(file)

my_plot = oc.draw.DrawComplex(atom=atom_full, coord=coord_full)

# Figure will be saved as Complex_saved_by_OctaDist.png by default.


Other example scripts and octahedral complexes are available at example-py and example-input, respectively.


Please cite this project when you use OctaDist for scientific publication.

OctaDist - A tool for calculating distortion parameters in coordination complexes.

Bug report

If you found issues in OctaDist, please report it to us at here.

Project team

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for octadist, version 2.6.1
Filename, size File type Python version Upload date Hashes
Filename, size octadist-2.6.1-py3-none-any.whl (84.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size octadist-2.6.1.tar.gz (60.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page