Skip to content

NRCan/TRNRun

Repository files navigation

TRNRun

TRNRun is a tool for running TRNSYS simulations, built to make batch runs easy to automate, monitor, and orchestrate.

Components

Component Description
trnrun-tracker Type3830, custom TRNSYS component that periodically writes simulation TIME, START, STOP, and STEP to a ***.tmp file.
trnrun-runner trnrun.exe launches a single deck, serializes TRNSYS startup machine-wide, monitors the run, and emits STATUS / CONFIG / PROGRESS / LOG events as JSON Lines on stdout.
trnrun-manager trnrun Python package runs many decks at once (up to a set limit), with a thread-safe API and a live terminal display.

Requirements

  • Windows
  • Python >= 3.12
  • TRNSYS v17 or v18
  • Optional: Progress Tracker (Type3830)

Installation (TODO)

pip install trnrun

Usage

from trnrun import SimulationConfig, SimulationManager

config = SimulationConfig(watch_tmp=True)

with SimulationManager() as manager:
    manager.add("path/to/deck.dck", config)
    manager.wait()

Demo

demo.mp4

License

MIT License - see LICENSE file for details.

About

TRNRun is a tool for running TRNSYS simulations, built to make batch runs easy to automate, monitor, and orchestrate.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Contributors

Languages