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.

Each tutorial is fairly standalone, although some require that you have completed previous ones.

The tutorials are meant to give some introductive background to the key concepts connected to the use of the Yambo code. Basic concepts like convergence of the calculations are also discussed. Still, the users are invited to read and study the pertinent documentation in order to get used to the most fundamental Physical quantities.

Some of the tutorials are provided with the yambo input files. Also the output of the calculations are given to be used as a reference. For all systems the ground state input files (Abinit and/or PWscf) and pseudopotentials are provided.

Getting started

For each TUTORIAL (Solid_LiF, Solid_Al, ...) , therefore, you can download the ground state files (zip archive named TUTORIAL_ground_state.zip) and generate the Yambo databases from your own by running abinit/PWscf and a2y/p2y. In this case the Yambo input and reference files are contained in the zip file (TUTORIAL_reference_files.zip). Alternatively, if (and only if) you have compiled yambo with the NetCDF support you can directly download the zip files containing the Yambo core databases (TUTORIAL_NETCDF_databases_and_reference_files.zip). These are generated using the NetCDF interface in order to be readable in any platform.

After you have downloaded the tutorial zip files and unziped them you should have now a tutorial tree:

localhost:> ls YAMBO_TUTORIALS/

localhost:> ls YAMBO_TUTORIALS/ COPYING Fantastic_Dimensions/ Hydrogen_Chain/ README Solid_LiF/ Solid_Al/ SiH4/ ... In each folder you will find an Abinit or Pwscf subfolder in case you have downloaded the ground state zip files and the YAMBO subfolder. The tutorials start by entering the YAMBO subfolder and followinf the informations provided in the tutorial documentation.

Tutorial files

To follow the tutorials, you must first download or copy data files for each system. Files are distributed as gzipped tarballs. Always extract the tarballs in the same place.
Available systems are: hBN.tar.gz, hBN-2D.tar.gz. You will need both hBN and hBN-2D tarballs.

Files can be found here:

Stand alone tutorials

Hydrogen chain

Modules

An alternative way to learn Yambo is through a more detailed look at our documentation modules. These provide a focus on the input parameters, run time behaviour, and underlying physics behind each yambo task or runlevel. Although they can be followed separately, they are better followed as part of the more structured tutorials given above.