Tutorials

From The Yambo Project
Jump to navigation Jump to search


If you are starting out with Yambo, or even an experienced user, we recommend that you complete the following tutorials before trying to use Yambo for your system.

The tutorials are meant to give some introductory background to the key concepts behind Yambo. Practical topics such as convergence are also discussed. Nonetheless, users are invited to first read and study the background material in order to get familiar with the fundamental physical quantities.

Two kinds of tutorials are provided: stand-alone and modular.

Tutorial files

The tutorial CORE databases can be downloaded

  • via the Yambo Virtual Machine
  • one by one directly from the Yambo web-page
  • obtained by using the yambo GIT tutorial repository

Yambo Virtual Machine

Tutorial files are already included in the VM if you using it. Just check the |Update instructions.

Tutorial Repository (advanced users)

The tutorials repository contains the most updated tutorials CORE databases. To use it

$ git clone https://github.com/yambo-code/tutorials.git YAMBO_TUTORIALS
$ cd YAMBO_TUTORIALS
$ ./setup.pl -install

Direct Download (all users)

The tutorials can be also downloaded together with the DFT input files. After downloading the tar.gz files just unpack them in the YAMBO_TUTORIALS folder. For example

$ mkdir YAMBO_TUTORIALS
$ mv hBN.tar.gz YAMBO_TUTORIALS
$ cd YAMBO_TUTORIALS
$ tar -xvfz hBN.tar.gz
$ ls YAMBO_TUTORIALS
  hBN

Files needed for modular tutorials

All of the following should be downloaded prior to following the modular tutorials:
hBN.tar.gz [15 MB], hBN-convergence-kpoints.tar.gz [254 MB], hBN-2D.tar.gz [8.6 MB], hBN-2D-para.tar.gz [143 MB]

Files needed for stand-alone tutorials

At the start of each tutorial you will be told which specific file needs to be downloaded:
Silicon.tar.gz [<1 MB], LiF.tar.gz [1.4 MB], Aluminum.tar.gz [<1 MB], Hydrogen_Chain.tar.gz [14 MB]

Stand-alone tutorials

These tutorials are self-contained and cover a variety of mixed topics, both physical and methodological. They are designed to be followed from start to finish in one page and do not require previous knowledge of yambo. Each tutorial requires download of a specific core database, and typically they cover a specific physical system (like bulk GaSb or a hydrogen chain). Ground state input files and pseudopotentials are provided. Output files are also provided for reference.

These tutorials can be accessed directly from this page of from the side bar. They include different kind of subjects:

Basic

Advanced

GW and Quasi-particles

Electron phonon coupling

Non linear response


Modular tutorials

These tutorials are designed to provide a deeper understanding of specific yambo tasks and runlevels. They are designed to avoid repetition of common procedures and physical concepts. As such, they make use of the same physical systems: bulk hexagonal boron nitride hBN and a hBN sheet hBN-2D.

Introduction

Quasiparticles in the GW approximation

Using Yambo in Parallel

This modules contains very general discussions of the parallel environment of Yambo. Still the actual run of the code is specific to the CECAM cluster. If you want to run these modules just replace the parallel queue instructions with simple MPI commands.

GW_parallel_strategies_CECAM

Excitons and the Bethe-Salpeter Equation

Yambo-python driver


Modules

Alternatively, users can learn more about a specific runlevel or task by looking at the individual documentation modules. These provide a focus on the input parameters, run time behaviour, and underlying physics. Although they can be followed separately, non-experts are urged to follow them as part of the more structured tutorials given above.

Schools