Create automatic workflows for yambo and quantum espresso using python. Work directly with netCDF databases. Do pre/post-processing, data analysis and plotting for yambo and quantum espresso.
- Yambo official website: http://www.yambo-code.eu/
- Yambo wiki: http://wiki.yambo-code.eu/
- Yambo Github page [download yambo & yambopy]: https://github.com/yambo-code/
The main usage of yambopy is by importing its modules in the user's own scripts, such as:
from yambopy import *
from qepy import *
There is also a command line interface feature. Just type
yambopy
on terminal to see the options. Typing yambopy [option] will show the related help message.
You can find explained tutorials and a partial documentation on the Yambo wiki page: https://wiki.yambo-code.eu/index.php/First_steps_in_Yambopy
The tutorials contain examples scripts illustrating how to use some of the features: they are intended to be copied, modified and adapted to other use cases and to your ideas and needs.
Additional information about capabilities and usage are available inside the tutorial folder and by reading the docstrings of the various classes. Keep in mind that a basic knowledge of python (numpy and matplotlib packages) will greatly help while using yambopy.
- Create Yambo and Quantum Espresso input files from python
- Collect and manipulate the human-readable output data for analysis
- Automatic submissions of calculations (e.g., custom workflows for convergence or multi-executable runs)
- Access Yambo netCDF databases and Quantum Espresso xml files
- Analyse, interpolate and plot the results in various ways using matplotlib
- Visualize advanced quantities such as:
- dielectric function, exciton weights in k and q-space, electron-phonon matrix elements...
- Aiida plugin for Yambo-Aiida workflows
- Tutorials
Make sure that you have a suitable python environment (created for example with conda or venv).
Use python version >=3.10.
If you never used an environment just type
python -m venv MYPATH/yamboenv/ (you can replace MYPATH with any path you prefer, e.g. ~/)
source MYPATH/yamboenv/bin/activate (for bash users, you can add to your .bashrt the line . MYPATH/yamboenv/bin/activate)
Type pip install yambopy
Clone this repository in your local machine or cluster, enter the directory and type pip install .
Follow the installation steps on the Yambo wiki.
- numpy: http://www.numpy.org/
- scipy: https://www.scipy.org/
- matplotlib: http://matplotlib.org/
- netCDF4: http://unidata.github.io/netcdf4-python/
- lxml: https://lxml.de/
- pyyaml: https://pyyaml.org/
- monty: https://pypi.org/project/monty/
- scikit-learn: https://pypi.org/project/scikit-learn/
Yambopy works for the following DFT/MBPT codes:
- yambo (>5.0.0): https://www.yambo-code.eu/
- Quantum Espresso (optional): http://www.quantum-espresso.org/
Please write a post in the yambopy subsection of the yambo forum.
- General review and update of all features
- Brillouin zone paths patch
- Full support for finite-momentum BSE postprocessing
- Full documentation & tutorials
- Increase efficiency of I/O for large database sizes and numbers
- Test suite
- Make it easier to add new features
Original author:
Current developers and maintainers:
- Fulvio Paleari (CNR - Nanoscience institute, Modena)
- Alejandro Molina Sanchez (University of Valencia)
- José Castelo (University of Valencia)
Active contributors:
- Claudio Attaccalite
- Miki Bonacci
- Jorge Cervantes-Villanueva
- Riccardo Reho
- Michele Re Fiorentin
- You if you want to share your scripts!
Past contributors:
- Matteo Zanfrognini
- Alexandre Morlet
- Davide Romanin
- Daniel Murphy
The code is at an ongoing stage of development, help us by sending bug reports, patches and suggestions!
If you want to contribute, we suggest the following steps:
- Fork this repository
- Implement and test your new feature(s) in the forked repo
- Create a pull request in order to include your development in the official code
- The Abipy library developed for the Abinit code was the original inspiration for Yambopy. In particular, abipy's
SkwInterpolatormodule for band structure interpolations has been directly imported into yambopy. - Yambopy logos by Claudia Cardoso
- University of Luxembourg
- University of Valencia
- Nanoscience Institute of the Italian National Research Council
- MaX: Materials at the eXascale EU center of excellence
