In this section, we briefly introduce GW and GW-BSE theory and their relation to components of the BerkeleyGW code. Then, we guide you through several example GW and GW-BSE calculation designed to teach BerkeleyGW to beginners. The tutorial is organized following the workflow shown above. The BerkeleyGW code consists of four executables: epsilon, sigma, kernel, and absorption. A typical GW calculation involves performing a mean field calculation, then running epsilon followed by sigma. A GW-BSE calculation involves performing a GW calculation and then running kernel followed by absorption. Details of each step are described below:

- Mean Field: BerkeleyGW supports a large number of mean field codes, including Abinit, Octopus, PARATEC, PARSEC, Quantum ESPRESSO, RMGDFT, SIESTA, and TBPW. The tutorials are designed to demonstrate how to start from a number of different mean field codes.
- Epsilon : Computes the RPA deielectric matrix. It takes the mean field wavefunctions as input and outputs the RPA dielectric matrix, which we call epsmat.
- Sigma : Computes the electron self-energy within the GW approximation. Takes the RPA dielectric matrix and the mean field wavefunctions, exchange correlation, and charge density as input. The output is the GW quasiparticle (QP) energies and related information, such as the QP bandstructure and QP lifetimes.
- Bethe-Salpeter Equation : Computes the optical properties in two executables:
- Kernel: Computes the kernel of the Bethe-Salpeter equation on a coarse k-point grid. Takes the RPA dielectric matrix and mean field wavefunctions as input.
- Absorption: Constructs the BSE Hamiltonian from the Kernel matrix elements, optionally interpolates to a finer k-grid, and diagonalizes the Hamiltonian to obtain electron-hole (exciton) excitation energies, wavefunctions, and optical spectra. Takes the kernel matrix, QP energies (optionally), and mean field wavefunctions as input.

The examples below are adapted from our annual workshop, which we encourage you to attend. BerkeleyGW supports a large number of operating systems and compilers. Precompiled modules are available on NERSC machines. The examples are designed to be run without modification on the Edison supercomputer at NERSC. If you do not have access to Edison, you will need to slightly modify the batch scripts to run on your preferred machine. Places where modification is required are noted in each example.

A full description of the input variables can be found here.

## Examples

Please go to our past BerkeleyGW Workshop to download the examples:

1. Basic examples designed to be run on the Cori supercomputer at NERSC can be found in the tar file BGW-2018-examples-small.tar.gz. Detailed instructions for the Silicon examples can be found below. Other instructions may be found in README file in the tarball.

2. Read the slides to understand the BerkeleyGW code and workflow

3. In the Silicon example, the Paratec code is used to generate the mean field. An alternative example, which uses Quantum ESPRESSO can be found in the tar file silicon_example_QE_port.tar.gz.