README.md

Author: blokhin

README.md

@@ -2,11 +2,11 @@ Tilde
 ==========
 [![DOI](https://zenodo.org/badge/18811/tilde-lab/tilde.svg)](https://zenodo.org/badge/latestdoi/18811/tilde-lab/tilde)
 
-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](http://www.vasp.at), [CRYSTAL](http://www.crystal.unito.it) and [Quantum ESPRESSO](http://www.quantum-espresso.org) packages. The folders with the log files can be scanned and the results added into a repository. Web-based repository GUI is [available](https://github.com/tilde-lab/berlinium).
+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](http://www.vasp.at), [CRYSTAL](http://www.crystal.unito.it) and [Quantum ESPRESSO](http://www.quantum-espresso.org) packages. The folders with the log files can be scanned and the results added into a repository. Web-based repository GUI is [separately available](https://github.com/tilde-lab/berlinium).
 
 ## Installation
 
-System packages ```build-essential python-dev libffi-dev``` (-dev or -devel) must be present. Also, Python package ```python-numpy``` should be present. [Set up Python virtualenv](https://virtualenv.readthedocs.org) inside the Tilde folder (note ```--system-site-packages``` option to access ```python-numpy```):
+System packages ```build-essential python-dev python-numpy libffi-dev``` (**-dev** or **-devel**) must be present. [Set up Python virtualenv](https://virtualenv.readthedocs.org) inside the Tilde folder (mind ```--system-site-packages``` option to access ```python-numpy```):
 
 ```shell
 virtualenv --system-site-packages tilde
@@ -27,21 +27,19 @@ Then test if the framework is ready:
 ./utils/tilde.sh -x
 ```
 
-Additionally, installation is covered in [this blog post](https://blog.tilde.pro/simple-ab-initio-materials-data-mining-tutorial-6127c777dabc).
-
 ## Usage
 
 ```shell
 ./utils/tilde.sh --help
 ```
 
-For example, to scan folder(s) recursively (-r), with terse print (-t), showing information on calculation convergence (-v) and adding results to a database (-a):
+For example, to scan folder(s) recursively (**-r**), with terse print (**-t**), showing information on calculation convergence (**-v**) and adding results to a database (**-a**):
 
 ```shell
 ./utils/tilde.sh /home/user/work1 /home/work2 -r -t -v -a
 ```
 
-Other example: for the perovskite structures (shipped with Tilde), extract the distortion of the MO6-octahedra wrt cubic phase (in Euler angles) and detailed calculation info:
+Other example: for the perovskite structures (shipped with Tilde), extract the distortion of the MO6-octahedra wrt cubic phase (in Euler angles) and detailed calculation info. Here the **-i** switch shows additional details and the **-m** switch invokes **perovskite_tilting** module (see **apps** folder):
 
 ```shell
 ./utils/tilde.sh tilde/tests/apps/perovskite_tilting/outputs -m perovskite_tilting -i
@@ -109,6 +107,8 @@ Other known similar initiatives are listed below:
 
 Tilde adopts the principle of open data, open source code and open standards declared by an initiative group with a symbolic name [Blue Obelisk](http://www.jcheminf.com/content/3/1/37).
 
+![Blue Obelisk](https://raw.githubusercontent.com/tilde-lab/tilde/master/blue_obelisk.gif "Blue Obelisk")
+
 ## Contact
 
 Please, send your feedback, bugreports and feature requests via [email](mailto:eb@tilde.pro), [Twitter](http://twitter.com/tildepro) or [GitHub](http://github.com/tilde-lab/tilde/issues).