Skip to main content

Introduction – CHAMPS+ Documentation

Welcome to the CHAMPS+ documentation site.

Quick start

If you’re eager to try a run before reading further, see Quickstart to get your first simulation started.

CHAMPS+ is a computational fluid dynamics (CFD) framework designed to combine the power of a fully-featured command-line solver with the convenience of a modern graphical user interface (GUI).
It is structured as two tightly integrated components:

  • Engine (Solver Core)
    The engine is a standalone CFD solver that can be run entirely from the command line.
    It reads a single input file describing the case setup—mesh, physics models, numerics, and output controls—and provides a rich set of command-line options for controlling execution, parallelism, and diagnostics.
    The engine can be used independently for scripted runs, automated studies, or HPC workflows.

  • GUI
    The GUI provides an intuitive interface to configure cases, validate input files, launch simulations, and monitor results in real time.
    Under the hood, the GUI prepares the input file and invokes the engine, so all simulations remain reproducible and engine-compatible. The GUI is currently under active development and will expand in future releases.

How to Read These Docs​

The documentation is organized to help both new and advanced users:

  • Engine – This contains all information about the CHAMPS+ backend.
  • User Interface – Information for the graphical user interface.
  • Tutorials – Basic validation cases to verify installation and to get started with learning CHAMPS+.