FhSim  3.1.0
Marine systems simulation
Loading...
Searching...
No Matches
Running a compiled SimObject

After building your SimObject library, run it by launching one of the FhSim executables from the playpen bin directory with an XML input file.

Assume:

  • <PROJECT_ROOT> is your SimObject project directory.
  • <PLAYPEN_BIN> is your runtime directory (typically <PROJECT_ROOT>/build/<config>/playpen/bin).
  • <INPUT_FILE> is your scenario XML file.

From terminal (recommended)

Windows (PowerShell / cmd)

cd <PLAYPEN_BIN>
FhSim <INPUT_FILE>

Linux/macOS

cd <PLAYPEN_BIN>
./FhSim <INPUT_FILE>

Use FhVis (or FhSimUI) instead of FhSim when you want visualization. There is no separate real-time executable: pace a run against wall-clock time with FhVis <INPUT_FILE> -s 1.0, or with FhSimUI <INPUT_FILE> --rt. See FhSim executables for the full list of installed programs.

From Visual Studio (Windows)

  1. Set your startup project to the executable you want to run (for example FhVis).
  2. Open project Properties → Debugging.
  3. Set:
    • Command: full path to executable in <PLAYPEN_BIN>
    • Command Arguments: <INPUT_FILE>
    • Working Directory: <PLAYPEN_BIN>
  4. Press F5.

Quick checks

  • Run FhSim --help (or FhVis --help) to verify executable discovery.
  • Ensure your license is available (for example through SFH_LICENSE_FILE or license.lic in working directory).
  • If a library fails to load, verify LibName in XML and build type compatibility.

See Running simulations for full run/configuration details.