Welcome to the FHI-aims Tutorials Overview Page!
Please use this site to navigate through the available FHI-aims tutorials.
FHI-aims is a general-purpose, efficient electronic structure code that treats all electrons and potentials without shape approximations and with flexible settings allowing for simple, fast as well as high-precision simulations. In additions to the tutorials, the full code manual as well as the FHI-aims gitlab site contain much more and detailed information about the code and its usage. Support for FHI-aims in a graphical interface for materials science, GIMS, is available online.
For the fastest start, check out our six-minute video introduction to FHI-aims.
Fundamentals of FHI-aims
This first section is all about fundamental aspects of running FHI-aims simulations for atoms, molecules, solids, and surfaces.
-
Like it or not, the first step to running FHI-aims is to have a binary executable that is compiled for the computer on which it is supposed to run. If you already have access to a compiled binary of FHI-aims, you can go straight to the next tutorial, Basics of Running FHI-aims.
-
Learn about running FHI-aims for molecules (spin-unpolarized/-polarized) and solids. The syntax of the input files and the structure of the output files is explained. Find out how to request a structure optimization and to request the calculation of band structure and DOS for solids.
-
Beyond the Basics: Complex Simulation Geometries, Efficient SCF Initialization, Charge and Spin
A tutorial that introduces FHI-aims for complex materials with non-trivial atomic and electronic structure. Key concepts include efficient initialization of ionic and spin-polarized solids and how to construct and simulate clusters, here demonstrated for the transition metal oxide Fe\(_2\)O\(_3\).
-
Slab Calculations and Surface Simulations with FHI-aims
The basic techniques for surface simulations with FHI-aims are introduced. Learn how to construct, run a slab simulation, and extract and understand the relevant numbers from the output file.
-
FHI-aims for Heterogeneous Catalysis
This tutorial introduces FHI-aims in the context of surface simulations for heterogeneous catalysis. Learn how to tackle a complex use case relevant for catalysis, namely CO\(_2\) adsorption on a cobalt cluster supported by an amorphous silica slab.
-
Scaling in FHI-aims (Scaling of algorithms used in FHI-aims, strategies for big systems)
Learn about running FHI-aims on a supercomputer and the most important aspects that you should consider when running large-scale systems with many CPUs.
-
A short tutorial about symmetry-use in solids.
-
Theory, usage, and three tutorials showcasing the Exchange-hole Dipole Moment (XDM) dispersion correction in FHI-aims. The tutorials cover the use of XDM for modelling molecular dimers, periodic systems, and show how to fit and use XDM for any functional/basis combination not already included in the defaults.
-
Dispersion-Corrected Hybrid DFT
A tutorial that introduces how to run dispersion-corrected hybrid DFT for the examples of molecular crystals and organic-inorganic perovskites.
-
Crystal Orbital Overlap Population (COOP) Analysis with FHI-aims
A tutorial about Crystal Orbital Overlap Population (COOP) analysis with FHI-aims.
Machine Learning
-
Electronic Structure Machine Learning with SALTED
Symmetry-Adapted Learning of Three-Dimensional Electron Densities (SALTED) method 10.1021/acs.jctc.1c00576 is designed to predict electron densities in periodic systems using a locally and symmetry-adapted representation of the density field.
Beyond DFT methods in FHI-aims
-
RPA, GW, and BSE for Molecules and Solids
This tutorial focuses on many-body perturbation theory methods "beyond DFT" in FHI-aims. In particular, three main approaches are discussed:
- The GW approximation for quasiparticle properties (i.e., charged excitations such as "electrons" and "holes" in semiconductors);
- The random-phase approximation (RPA) to electron correlation energies, for total energies;
- The Bethe-Salpeter equation (BSE) based on GW, for neutral (e.g., optical) excitation energies (in FHI-aims, currently available for non-periodic simulations of molecules).
-
MP2 and Coupled Cluster for Solids (and Molecules) - the Interface
CC-aims
toCC4S
The interface
CC-aims
in FHI-aims allows to use the coupled cluster code CC4S. The tutorial demonstrates the needed steps to get from a FHI-aims calculation to start a calculation with CC4S. CC4S enables the calculation of:- MP2
- CCSD
Motion of atoms
-
Introduction to running molecular dynamics (MD) through the software package i-PI. Following things are covered:
- How to use FHI-aims together with i-PI
- Microcanonical Ensemble and Importance of the step size
- Thermostats
- Vibrational analysis with i-PI
- Thermodynamic integration
- Simulations at constant pressure
-
Phonons with FHI-vibes and More
- How to use FHI-aims through FHI-vibes
- Calculate Phonon properties: Band structure, DOS, Free Energy, ...
- Lattice expansion (uasi-harmonic approximation)
- Calculate Born-Effective Charges and non-analytical term correction for polar materials
- Band gap renormalization
-
Thermal Transport with FHI-vibes
- Showcases the ab initio calculation of thermal transport from a non-perturbative method (Green-Kubo theory) and a perturbative method (Boltzmann transport theory) using FHI-vibes.
- Highlights the need for a non-perturbative method for anharmonic systems, with the strongly anharmonic CuI used as an example.
-
Ab Initio Simulations of Tip-Enhanced Raman Spectroscopy
- Allows ab initio simulations of polarizability tensors including a numerical inhomogeneous local hartree potential originally calculated by TDDFT responses from metallic tip-like structures
- Repository with a how-to example, input files including the local hartree potentials for selected geometries, and a script to create tip-enhanced Raman images with this implementation in FHI-aims can be found in https://github.com/sabia-group/TERS_Tutorial
-
- Shows how to use the MDAnalysis framework with FHI-aims in a few examples
- Shows how to take a classical MD trajectory and generate structures in FHI-aims format
- Shows how to cut out a partial geometry segment from a larger system and write out this reduced system
-
Electron-Phonon Coupling and Electronic Friction Tutorial
- Calculate electronic friction and electron-phonon coupling of molecules adsorbed on metal surfaces for the system CO adsorbed on a Cu(100) surface.
-
Electronic Conductivity and Mobility from First Principles with the Kubo-Greenwood Formula
- Shows how to compute band type conductivites and mobilities using the ab initio Kubo-Greenwood formalism in FHI-aims.
- Illustrates the necessary and optional input tags that allow to run and configure this type of calculation, as well as how to analyze and rationalize the output.
- Examples of conductivity and mobility calculations of Al and SrTiO\(_3\)
-
Finding Transition States and Minimum Energy Paths with aimsChain
- Shows how to use aimsChain together with FHI-aims to find minimum energy paths
- Examples of ammonia inversion and Li diffusion barriers in solid electrolytes
Linear Response Methods
- Electric field response in FHI-aims using DFPT
- Calculate the response of molecules and crystals to an external homogenous electric field using density functional perturbation theory
- Calculate the IR and Raman spectra of a benzene molecule and a benzene crystal.
Ab initio Thermodynamics
-
Introduction of Ab Initio Thermodynamics and REGC
This tutorial introduces the main concepts of ab initio atomistic thermodynamics and the replica-exchange grand-canonical (REGC) scheme using FHI-aims.
Embedding
-
Introduction to QM/MM Embedded-Cluster Calculations
This tutorial introduces a user to the workflow for configuring and running a QM/MM embedded-cluster calculation with ChemShell. The tutorial covers software compilation, building the embedded-cluster model, and performing calculations. Embedded links provide the user with access to further examples and information on the ChemShell package.
FHI-aims in complex workflows
-
This tutorial offers a comprehensive guide on using the FHI-aims code with the ASE (Atomic Simulation Environment) Python package. It covers installation, manipulation of atomic data, setting up and running calculations, and analyzing results. Topics include initializing ASE, reading and writing FHI-aims files, running calculations using ASE calculators, and several examples, including performing nudged elastic band calculations and utilizing the Socket I/O interface. The tutorial is designed for compatibility with FHI-aims version 240507 and ASE version 3.23, noting differences from prior ASE versions.
-
Taskblaster workflows for high-throughput simulations
Taskblaster is a light-weight python framework built on top of ASE for designing and managing high throughput workflows. It allows for executing multiple tasks (e.g. structural relaxation, band structure calculation, postprocessing analysis, etc.) via command-line interface. This is a brief tutorial demonstrating how to perform high-throughput DFT calculations using Taskblaster with FHI-aims.
-
High-Throughput Workflows with FHI-aims and atomate2
Atomate2 is a Python library built on top of Pymatgen that provides a collection of computational workflows automating first principles calculations. This tutorial gives an overview on how to install and use the
atomate2
package to run a set of predefined workflows with FHI-aims. -
Managing Research Data - FHI-aims and AiiDA
This tutorial gives an overview on how to use the aiida-ase package to manage FHI-aims - driven calculations with AiiDA. AiiDA is an open-source "Automated interactive infrastructure and Database for computational science". It enables the creation of Python-based workflows, which can automatically be submitted to local and remote machines. AiiDA also keeps track of the origin and destination of files and conveniently stores all information in a database.
-
Simulation Environment for Atomistic and Molecular Modeling - SEAMM
SEAMM is a user-friendly software for atomistic and material simulation, which currently supports running ground-state and relaxation calculations with FHI-aims through its
FHI-aims-step
plugin. It has a graphical user interface for designing workflows and a web interface to run them and access the results, that helps focus on the science rather than technicalities of using the software. To start using SEAMM, we recommend first go through the Getting Started section for SEAMM itself, following by the tutorial for the FHI-aims plugin.
Other tutorials will appear at this page over time. We also note that further tutorials related to earlier versions of FHI-aims are available from past Hands-On workshop sites, e.g., the Hands-on DFT and Beyond workshop 2019.
Spectroscopy
-
Core Level Spectroscopy with ΔSCF
A comprehensive tutorial on how to perform ΔSCF calculations for simulation of x-ray spectroscopy within FHI-aims using force_occupation_basis and force_occupation_projector for periodic and aperiodic systems.
-
Magnetic Resonance in FHI-aims: Shieldings, Magnetizabilities, J-Couplings, and Spectra
A tutorial focused on magnetic resonance calculations for light-element molecules in FHI-aims.
-
Low-Field NMR Spectra (SLIC and ZULF) from FHI-aims and SPINACH
A tutorial focused on calculating low-field nuclear magnetic resonance spectra with FHI-aims and the SPINACH spin dynamics code.
Real-Time TDDFT
-
Real-Time TDDFT and Ehrenfest Dynamics
A tutorial providing an overview on running RT-TDDFT simulations for both isolated and periodic systems within FHI-aims, including a basic review of the theory and all inputs needed to run the simulations. The tutorial also covers running RT-TDDFT with Ehrenfest dynamics and necessary inputs.
Nuclear Quantum Effects
-
Introduction to modeling Nuclear Quantum effect with the Nuclear-Electronic Orbital (NEO) method with FHI-aims. Following aspects are covered:
- NEO-DFT calculations
- For Molecules
- With Periodic Boundary Conditions
- For Geometry Optimization
- Real-time NEO TDDFT calculations
- NEO-DFT calculations