Recipe: run 05_simulator (MPI)

Goal: verify OpenPFC + HeFFTe + MPI with a small, standard example (examples/05_simulator).

Prerequisites

  • Built OpenPFC with OpenPFC_BUILD_EXAMPLES=ON (default). Binary path: <build>/examples/05_simulator.

  • Same MPI for configure and run as in INSTALL.md.

Steps

  1. Configure and build from the repo root (see start_here_15_minutes.md or quickstart.md).

  2. Run from the checkout root, using one rank for the first check:

    mpirun -n 1 ./builds/release/examples/05_simulator

    Adjust -n to your machine; use at least 1 rank.

Expected result

  • Process exits with code 0.

  • Rank 0 typically emits INFO logs (world size, simulation stepping).

  • The driver-hooks example also writes its event ledger and field samples under results/. Use the driver-hooks lesson to inspect the saved states; exit zero alone is only a launch check.

Next steps