User Guide

This User Guide explains how to install, run, configure, and extend AdditiveFOAM. It documents the governing equations, numerical methods, input files, heat-source models and calibration, boundary conditions, mesh refinement, solver controls, outputs, and utilities provided by AdditiveFOAM.

Getting started

  1. Install AdditiveFOAM.
  2. Run the quick start.
  3. Select the closest tutorial and copy it as the starting point for your case.
  4. Use the sections below to configure the physical models, numerical methods, and outputs required by the case.

Table of contents

  1. Installation

    Install AdditiveFOAM with OpenFOAM 14 and configure its environment variables.

  2. Quick Start

    Copy, run, monitor, and visualize the AMB2018-02-B baseline case.

  3. Governing Equations

    Review the momentum, temperature, phase, and thermodynamic coupling equations solved by AdditiveFOAM.

  4. Heat Source Models

    Define scan paths, absorption models, volumetric heat distributions, and spatial and temporal source integration.

  5. Projected Heat-source Calibration

    Infer the projected-source depth coefficients from measured melt-pool depths and CFD response curves.

  6. Boundary Conditions

    Configure the Marangoni velocity and mixed convection-radiation temperature conditions.

  7. Adaptive Mesh Refinement

    Refine the mesh around thermal regions and moving heat sources and redistribute it between MPI processes.

  8. Case Files and Materials

    Define initial fields, material properties, phase paths, scan paths, and the required case dictionaries.

  9. Solver and Time Controls

    Select temperature-phase coupling, time discretization, fluid-flow coupling, linear solvers, and adaptive time stepping.

  10. Function Objects

Write melt-pool dimensions, solidification conditions, and ExaCA temperature histories during a simulation.

  1. Utilities

    Generate scan paths, run multi-layer cases, reconstruct parallel output, convert beam profiles, and plot results.