Skip to main content

Materials informatics framework for ab initio data repositories

Project description


Tilde is an intelligent data organizer and Python framework for computational ab initio materials science. Tilde creates systemized data repositories from the simulation logs of VASP, CRYSTAL and Quantum ESPRESSO packages. Other data formats can be added relatively easily. The folders with the log files can be scanned and the results added into a repository. A simple usecase is described in this blog post. Web-based repository GUI is separately available.


System packages build-essential python-dev python-numpy libffi-dev (-dev or -devel) must be present. Please, set up Python virtualenv inside the Tilde folder (and mind --system-site-packages option to access python-numpy):

virtualenv --system-site-packages tilde

Then activate virtualenv:

. bin/activate

Virtualenv should be always used while working with the codebase. Run pip install -r requirements.txt to install Python dependencies. Finally, ensure if the framework is ready:

./utils/ -x

Additionally, installation is covered in this blog post.


./utils/ --help

For example, to scan folder(s) recursively (-r), with terse print (-t), showing information on calculation metadata (-i) and convergence (-v) and adding results to a database (-a):

./utils/ /home/user/work1 /home/work2 -r -t -v -a -i

Other example: for the perovskite structures (shipped with Tilde), extract the distortion of the MO6-octahedra wrt cubic phase (in Euler angles). Here the -m switch invokes perovskite_tilting module (see apps folder):

./utils/ tilde/tests/apps/perovskite_tilting/outputs -m perovskite_tilting


Experimental GUI server is started as follows:

python utils/

GUI client is the separate project called Berlinium.


sh tests/



Similar projects

Other known similar initiatives are listed below:

Openness principle

Tilde adopts the principle of open data, open source code and open standards declared by an initiative group with a symbolic name Blue Obelisk.

Blue Obelisk

Blue Obelisk


Please, send your feedback, bugreports and feature requests via email, Twitter or GitHub.

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 tilde, version 0.8.1
Filename, size File type Python version Upload date Hashes
Filename, size tilde-0.8.1.tar.gz (89.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page