From 72f348aacc3e5094d6dac8beb8e35167225a1ee8 Mon Sep 17 00:00:00 2001 From: Joss Salton <145990319+SaltyJoss@users.noreply.github.com> Date: Thu, 26 Feb 2026 23:30:41 +0000 Subject: [PATCH] Update README with DSFE running instructions Added instructions for running DSFE in batch and GUI modes. --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index e43feb6..df31df6 100644 --- a/README.md +++ b/README.md @@ -39,6 +39,8 @@ As an independant an extensible final year project, DSFE allows users to: * Import external models * Design their own DSL scripts * Build their own experimental regimes + * Run in either batch or GUI mode + * Run parallel instances without file restrictions This open architecture intentionally avoids hidden "Black-Box" abstractions, and instead `favours transparency, reproducibility, and research flexibility`.
@@ -57,6 +59,23 @@ Download the latest release of DSFE from `Release` in the `DSFE GitHub Repositor > **Disclaimer:**
> The DSFE software has been developed, maintained, and released by [@SaltyJoss](https://github.com/SaltyJoss). As it is still under development, if you find any major bugs/issues/errors within the software please submit or issue the relevant information. If you wish to reach out, feel free to comment on the repository, or get in touch with [@SaltyJoss](https://github.com/SaltyJoss). + +## Running DSFE + +### As an executable +Download and extract the files from the [latest release of DSFE](https://github.com/SaltyJoss/RoboticArm_MathModelling/releases) and run the executable (`Engine.exe` on Windows) as you would any other binary! + +### Batch mode (CLI) +Open a terminal in the extracted release folder and run the engine in ```--batch``` mode to execute a DSL script that automates simulation sweeps. + +```bash +# Show help / usage +PS C:\Users\SaltyJoss\dsfe-v0.7.1r-alpha-windows-x64> .\Engine.exe -h + +# Example: one of the commands used to run my tests: +PS C:\Users\SaltyJoss\dsfe-v0.7.1r-alpha-windows-x64> .\Engine.exe --batch -t assets/DSLScripts/vispa_report_test_1.dsl --name vispa_rA_t1 --basedt 1/960 --baseint rk4 --dt 1/30,1/60,1/120,1/240,1/480 --int euler,midpoint,heun,ralston,rk4,rk45 +``` + ## Project Info