Interactive Jupyter notebook tutorials with VirtualBox
Nektar++ has a series of interactive Jupyter notebook tutorials using VirtualBox covering basic to relatively advanced topics. These tutorials are intended for new users and do not need an installed version of Nektar++ on your own system but instead use VirtualBox to run a Virtual Machine with the necessary installation. These interactive tutorials will help you understand the Nektar++ terminologies, file types and settings. You will learn how to set up a simulation and associated boundary conditions, run the simulation in serial or parallel and do simple post-processing of the results.
Setup
- To start download a copy of VirtualBox for your system.
- Download a virtual image suitable for your system:
- Intel/AMD processor virtual image (2GB): nek-tutorial-x86_64.tar.bz2
- Mac/Arm processor virtual image (2GB): nek-tutorial-arm64.tar.bz2
- Follow these setup instructions
Available Tutorials
Currently we have the following tutorials available within a JupyterLab environment:
- ADR (Advection-Diffusion-Reaction) Solver
- Incompressible flow solver
- Compressible flow solver
- Pre and post-processing
As outline in the installation instructions the JupyterLab tutorials are downloaded into the VirtualBox environment and so will can be updated at any time by deleting (or moving) the nek-tutorial directory in a terminal shell and typing “get-nek-tutorial” to get the latest version.
Tutorials using a compiled version of Nektar++
The following tutorials require a compiled version of Nektar++ details of how to install Nektar++ on your local system can be found under the installation page.
Basics
In the following tutorial we introduce some of the basic concepts of the Nektar++ framework by demonstrating how to run the advection diffusion reaction solver that contains a number of different scalar solvers.
Fundamentals
These tutorials introduce the fundamental mathematical aspects of the spectral/hp method and how to implement them using components from Nektar++.
Incompressible Navier-Stokes
These tutorials introduce the incompressible Navier-Stokes solver, which is built on top of the core Nektar++ libraries.
Global Flow Stability Computation
In these tutorials we demonstrate how to solve the biglobal stability equations of the incompressible Navier-Stokes equations to obtain the direct, adjoint and singular value modes. As part of setting up the biglobal equations we also have to solve the incompressible Navier-Stokes problem and so this is also covered in these tutorials.