Skip to content

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.

  • Building the FHI-aims Code

    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.

  • 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.

  • Symmetry for Solids

    A short tutorial about symmetry-use in solids.

  • The XDM Dispersion Correction

    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:

    1. The GW approximation for quasiparticle properties (i.e., charged excitations such as "electrons" and "holes" in semiconductors);
    2. The random-phase approximation (RPA) to electron correlation energies, for total energies;
    3. 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 to CC4S

    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

  • Molecular Dynamics with i-PI

    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
  • FHI-aims and MDAnalysis

    • 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

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

  • FHI-aims with ASE

    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

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

  • Nuclear-Electronic Orbitals

    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