Tutorials#

Welcome to the FELiCS Tutorials!

These step-by-step guides are designed to help you get started with FELiCS, from basic case setup and mesh generation to running modal and resolvent analyses. Each tutorial builds on the previous one, introducing new concepts and tools.

Below you will find an overview of the available tutorials, with links and a short description for each.

Prerequisites

Before starting these tutorials, ensure that FELiCS is installed on your system.
If you haven’t done so yet, see the Installation Guide for step-by-step instructions.

Tutorial 1: Cylinder Wake – Solve the Base Flow#

Learn how to set up your first FELiCS case by computing the 2D base flow around a cylinder.

You will:

  • Define a case in FELiCS.

  • Create a case folder with a mesh and base flow files.

  • Run the base flow solver and visualize results in Paraview.


Tutorial 2: Modal Analysis#

Perform a linear stability (eigenvalue) analysis of the base flow computed in Tutorial 1.

You will:

  • Define and apply boundary conditions.

  • Set up and run a modal analysis case.

  • Postprocess and visualize eigenmodes and spectra.


Tutorial 3: Resolvent Analysis#

Explore frequency response and amplification mechanisms in a constricted pipe (stenosis) using resolvent analysis.

You will:

  • Generate a mesh with GMSH.

  • Import and process mean flow data.

  • Set up and run resolvent analysis for different frequencies.

  • Load the results on python.

  • Plot gains and mode shapes.


Tutorial 4: Input-Output Analysis#

Perform input/output analysis for a reacting flow.

You will:

  • Load the reacting flame base flow.

  • Set up the linearized equations for momentum, mass, species, and energy.

  • Apply a harmonic forcing at the specified boundary.

  • Solve for the system response and compute transfer functions.

  • Export results to the output directory.


Additional Resources#

  • GMSH Quick Reference: Handy guide to the most important GMSH Python API commands for mesh generation.


Each tutorial folder contains all necessary scripts, input files, and example outputs.
For further details on settings and file formats, see the FELiCS settings documentation.