Skip to content

Latest commit

 

History

History
executable file
·
116 lines (85 loc) · 5.48 KB

README.md

File metadata and controls

executable file
·
116 lines (85 loc) · 5.48 KB

Tilde

Build Status DOI

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.

Installation

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/tilde.sh -x

Additionally, installation is covered in this blog post.

Usage

./utils/tilde.sh --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/tilde.sh /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.sh tilde/tests/apps/perovskite_tilting/outputs -m perovskite_tilting

GUI

Experimental GUI server is started as follows:

python utils/gui_server.py

GUI client is the separate project called Berlinium.

Testing

sh tests/run_tests.sh

Licensing

MIT

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

Contact

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