# APhRICA school (Nairobi)

This page provides an overview, instructions and tutorials for the APhRICA school on computation Many-Body theory dedicated to Yambo.

## Short intro to APhRICA

APhRICA is an initiative, put in place by an international network, with the active participation of African academic institutions and research centers: 
[the East African Center for Theoretical Physics](https://eaifr.ictp.it/) in Rwanda and the
[Technical University of Kenya](https://tukenya.ac.ke/). 

The ultimate APhRICA goal is to build a bridge between young African scholars, Europe and some of its excellent institutions.
The mid-long term mission is to train and enhance the skills of a generation of young scientists, enabling them to contribute to the development of the African
continent, which increasingly represents a strategic player in global progress, applying and spending the high level of scientific knowledge acquired.

%Webpage of the event: [ACM Second Asian School on High-Performance Computing and Artificial Intelligence](https://europe.acm.org/seasonal-schools/asean/2026).

```{card}
:class-card: aphrica-card
:margin: 5 5 auto auto
:width: 50%
:img-background: ../media/APhRICA.png
:img-alt: APhRICA computation Many-Body theory school
```

## Tentative Program 

Legend is:

- T: Theoretical lecture
- HoP: Hands-on preparatory presentation
- Ho: Hands-on

### Day 1 (Tue. July 7<sup>th</sup>)
| | |
|-|-|
| afternoon | - The Periodic Lattice Representation\,(PLR) (T) <br>- The Hamiltonian ($\hat{H}$) in the PLR (T) <br> - Review of the real--space MBPT: HF, Linear-Response, GW (T) | 

### Day 2 (Wed. July 8<sup>th</sup>)
| | |
|-|-|
| morning | - HF in the PRL (T) |
| afternoon | - Yambo intro (HoP) <br> - Code(s) installation (Ho) <br> - DFT preparatory runs (Ho) <br> - Hartree-Fock (Ho) |

#### Hands-on

1. [Create the SAVE folder](#database-generation-tutorial-target)
2. [Initialize the SAVE folder](#database-initialization-tutorial-target)
3. [Generate input files using Yambo's command-line interface](#input-file-generation-tutorial-target)
4. [Quasiparticle corrections within the Hartree-Fock approximation](#hf-on-hbn-tutorial-target)

### Day 3 (Thurs. July 9<sup>th</sup>)
| | |
|-|-|
| morning | - Bethe-Salpeter equation (BSE) (T) <br> - Linear-Response in the PLR (T) |
| afternoon | - Linear-Response convergenve (HoP) <br> - Linear Response (Ho) |

#### Hands-on

1. [Optics at the independent particle level](#optics-ipa-tutorial-target)
2. [RPA and local field effects](#local-fields-tutorial-target)

### Day 4 (Fri. July 10<sup>th</sup>)
| | |
|-|-|
| morning | - GW in the PLR (T) |
| afternoon | - GW convergenve (HoP) <br> - GW (Ho) |

#### Hands-on

[A full GW calculation with Yambo](#gw-on-hbn-tutorial-target)

### Day 5 (Sat. July 11<sup>th</sup>)
| | |
|-|-|
| morning | - BSE in the PLR (T) |
| afternoon | - BSE convergenve (HoP) <br> - BSE (Ho) |

#### Hands-on

[BSE on MoS<sub>2</sub>](#BSE-on-MoS2-hpc-tutorial-target)

### Get the files for the tutorial

Let us now create a directory where we will do the tutorial:

```{code-block} none
$ mkdir yambo
$ cd yambo
```

At this point, download the files used in the tutorial via `wget`:

```{code-block} none
$ wget https://media.yambo-code.eu/educational/tutorials/files/hBN.tar.gz 
$ wget https://media.yambo-code.eu/educational/tutorials/files/hBN-2D.tar.gz 
$ wget https://media.yambo-code.eu/educational/tutorials/files/MoS2_HPC_BSE_tutorial.tar.gz
```

and extract (unzip) them

```{code-block} none
$ tar -xvf hBN.tar.gz
$ tar -xvf hBN-2D.tar.gz
$ tar -xvf MoS2_HPC_BSE_tutorial.tar.gz
```

You are now all set for the tutorial. Just for safety, check that the executable works by typing

```{code-block} none
$ yambo -h
```

This should print the help of the Yambo command-line interface.