How-to guide

Your First Case

A guided tutorial: from an empty workspace to a published engineering report, with every approval and evidence trail explained.

2 min read

Prerequisites

  • A SimPilot account in a tenant with the OpenFOAM solver pack enabled.
  • Compute credits or a connected compute plane (the platform also runs a free demo plane for tutorials).
  • A browser. No local setup required.

1. Open a new chat

From the workspace, click New chat or visit /chat. You will see an empty thread with the chat input focused. The right-hand context drawer shows the Cases Dock (empty for now) and the suggested skills derived from the platform's signed skill registry.

2. Describe the case

Paste:

Evaluate airflow through an electronics enclosure using the attached CAD. Estimate pressure drop and outlet temperature rise, keep the temperature rise under 12 K, and include residual and heat-balance evidence in the final report.

The agent inspects the relevant solver resource packs, may load matching skills, and emits a typed plan with the proposed CaseSpec, the controls it intends to use, and an estimated cost envelope.

3. Review the typed plan

The plan card surfaces:

  • Physics — airflow, heat transfer, material assumptions, and whether turbulence modeling is needed.
  • Geometry & mesh — attached CAD, named patches, mesh strategy, and mesh-quality targets.
  • Boundary conditions — inlet, outlet, wall, and heat-source records tied to typed patch names.
  • Validation — acceptance criteria, comparison sources if available, and documented gaps if not.

If anything looks wrong, ask the agent to change it. The CaseSpec patches in place — no need to start over.

4. Approve the launch

The agent surfaces an approval envelope for the first file-writing tool call. Inspect the operation, the case workspace path, the patch digest, the blast radius (workspace-local), and the reuse scope (this case only). Click Approve once, or Approve for this case to authorize subsequent same-shape commands.

5. Run and monitor

The agent invokes blockMesh, then icoFoam, through the governed shell. The live-monitor sidecar tails the solver log and emits typed residual records. The case view shows residuals dropping; the Cases Dock keeps the run visible if you switch to other work.

6. Extract the QoI

Once converged, the agent runs the typed post-processing recipe: extract pressure drop, outlet temperature rise, heat balance, and residual records from solver artifacts. The QoI card shows each verdict against its stated tolerance and links to the raw artifact path.

7. Publish the report

The report builder projects case state, validation records, figures, residual plots, cited assumptions, and a replay manifest. Hit Publish to freeze a content-addressed bundle. Share the public link or download the PDF.

What you learned

  • Chat is the primary surface; cases and reports are typed artifacts.
  • Nothing runs without an approval envelope.
  • Every figure and QoI points at a file you can inspect.
  • The report you publish is replayable, not a screenshot.

Was this page helpful?

Edit this page on GitHub

Search docs

Find pages across the SimPilot docs.