## Fleur documentation

The Fleur code implements the all-electron full-potential linearized augmented-plane-wave (FLAPW) approach to density functional theory (DFT). It allows the calculation of properties obtainable by DFT for crystals and thin films composed of arbitrary chemical elements. For this it treats all electrons on the basis of DFT and does not rely on the pseudopotential approximation. There are also no shape approximations to the potential required. However, this comes at the cost of complex parametrizations of the calculations. The Fleur approach to this complex parametrization is the usage of an input generator that itself only requires basic structural input. Using this it generates a completely parametrized Fleur input file with material adapted default parameters. The advanced user should understand the Fleur input file and be able to modify it if needed. For this the first part of the documentation introduces the FLAPW method and connects it to its implementation in Fleur and the parameter names used in the input file.

The second part of the documentation focuses on specific calculations for the computation of different target quantities. This can be understood as a How-To.

In detail the documentation is organized as follows:

- Overview
- Quick start
- The FLAPW method and its implementation in Fleur
- Theory Overview
- Partitioning of the unit cell and energy ranges
- Representation of valence electrons
- The LAPW basis for thin film systems
- Details on the Hamiltonian and Overlap matrix setup
- Treatment of core electrons
- Usage of symmetries
- Construction of the charge density
- Construction of the potential
- Treatment of collinear magnetism
- Spin-orbit coupling in 2nd variation
- Treatment of noncollinear magnetism
- Description of spin spirals
- Construction of the exchange matrix (missing)

- Specific calculations
- Calculations overview
- Using the input generator
- The standard self-consistent field (SCF) calculation
- Obtaining the band structure
- Obtaining a density of states (DOS)
- Performing structural relaxations
- Usage of the LDA+U approach
- Plotting densities
- Band unfolding
- Usage of the magnetic force theorem
- Applying external fields
- Core spectrum calculations for EELS
- Magnetic circular dichroism (missing)
- Employing Wannier functions
- Vacuum DOS (TODO)
- Performing hybrid functionals calculations (missing)

- Expert knowledge and Troubleshooting
- Expert knowledge and Troubleshooting overview
- Choosing good parallelization schemes
- Ghost bands
- Parameter convergence
- Describing semicore states with local orbitals
- Error messages
- Extracting data from the banddos.hdf file
- Maybe something about the art of converging a density?!

- Reference
- Reference overview
- The Fleur input generator
- The Fleur input file
- The XML-Schema for the inp.xml file
- References (can be extended when required)