ABINIT: the tutorials

These tutorials are aimed at teaching the use of ABINIT, in the UNIX/Linux OS and its variants (OSF, HP-UX, AIX ...). They might be used for other operating systems, but the commands have to be adapted.

Note that they can be accessed from the ABINIT web site as well as from your local ~abinit/doc/tutorial/welcome.html file. The latter solution is of course preferable, as the response time will not depend on the network traffic.

At present, more than thirty lessons are available. Each of them is at most two hours of student work. Lessons 1-4 cover the basics, other lectures are more specialized.

Copyright (C) 2000-2014 ABINIT group (XG,RC)
This file is distributed under the terms of the GNU General Public License, see ~abinit/COPYING or http://www.gnu.org/copyleft/gpl.txt .
For the initials of contributors, see ~abinit/doc/developers/contributors.txt .

Before following the tutorials, you should have read the "new user's guide", as well as the pages 1045-1058 of the paper "Iterative minimization techniques for ab initio total-energy calculations: molecular dynamics and conjugate gradients", by M.C. Payne, M.P. Teter, D.C. Allan, T.A. Arias and J.D. Joannopoulos, Rev. Mod. Phys. 64, 1045 (1992) or, if you have more time, you should browse through the Chaps. 1 to 13 , and appendices L and M of the book Electronic Structure. Basic Theory and Practical Methods. R. M. Martin. Cambridge University Press (2004) ISBN 0 521 78285 6. The latter reference is a must if you have not yet used another electronic structure code or a Quantum Chemistry package.

After the tutorial, you might find it useful to learn about the test cases contained in the subdirectories of ~abinit/tests/, e.g. the directories fast, v1, v2, ... v6, that provide many example input files. You should have a look at the README files of these directories.

Additional information can be found in the ~abinit/doc directory, including the description of the ABINIT project, guide lines for developpers, more on the use of the code (tuning) ...

Some lessons depends on other lessons. The following schema should help you to understand these dependencies.

Schema 1

Brief description of each lesson's content

The lessons 1-4 present the basic concepts, and form a global entity: you should not skip any of these.

Other lessons present more specialized topics.

There is a group of lessons that can be started without any other prerequisite than the lessons 1 to 4, and that you can do in any order:

There is an additional group of lessons on response functions (phonons, optics, dielectric constant, electron-phonon interaction, elastic response, non-linear optics, Raman coefficients, piezoelectricity ...), for which some common additional information are needed:

Concerning parallelism, there is another set of specialized lessons. For each of these lessons, you are suposed to be familiarized with the corresponding tutorial for the sequential calculation.

The following topics should be covered later:

NOTE that not all features of ABINIT are covered by these tutorials. For a complete feature list, please see the ~abinit/doc/features/ directory. For examples on how to use these features, please see the ~abinit/tests/* directories and their accompanying README files.