SimJulia.jl

A discrete event process oriented simulation framework written in Julia
Popularity
147 Stars
Updated Last
11 Months Ago
Started In
March 2013

SimJulia

A discrete event process oriented simulation framework written in Julia inspired by the Python library SimPy.

Build Status & Coverage

Build Status codecov

Installation

SimJulia.jl is a registered package, and is installed by running

julia> Pkg.add("SimJulia")

Documentation

License

License

Authors

  • Ben Lauwens, Royal Military Academy, Brussels, Belgium.

Contributing

  • To discuss problems or feature requests, file an issue. For bugs, please include as much information as possible, including operating system, julia version, and version of the dependencies: DataStructures and ResumableFunctions.
  • To contribute, make a pull request. Contributions should include tests for any new features/bug fixes.

Release Notes

  • v0.8.2 (2021)
    • implementation of Store based on a Dict
  • v0.8.1 (2021)
    • some minor bug fixes
    • uses ResumableFunctions v0.6 or higher
  • v0.8 (2019)
    • adds support for Julia v1.2.
  • v0.7 (2018)
    • adds support for Julia v1.0
  • v0.6 (2018)
    • adds support for Julia v0.7.
    • the @oldprocess macro and the produce / consume functions are removed because they are no longer supported.
  • v0.5 (2018)
    • The old way of making processes is deprecated in favor of the semi-coroutine approach as implemented in ResumableFunctions. The @process macro replaces the @coroutine macro. The old @process macro is temporarily renamed @oldprocess and will be removed when the infrastructure supporting the produce and the consume functions is no longer available in Julia. (DONE)
    • This version no longer integrates a continuous time solver. A continuous simulation framework based on DISCO and inspired by the standalone QSS solver using SimJulia as its discrete-event engine can be found in the repository QuantizedStateSystems (WIP):
    • Documentation is automated with Documenter.jl (WIP: Overview and Tutorial OK).
  • v0.4.1 (2017)
    • the @resumable and @yield macros are put in a seperate package ResumableFunctions:
    • Users have to take into account the following syntax change: @yield return arg is replaced by @yield arg.
  • v0.4 (2017) only supports Julia v0.6 and above. It is a complete rewrite: more julian and less pythonic. The discrete event features are on par with v0.3 (SimPy v3) and following features are added:
    • Scheduling of events can be done with Base.Dates.Datetime and Base.Dates.Period
    • Two ways of making Processes are provided:
      • using the existing concept of Tasks
      • using a novel finite-statemachine approach
    • A continuous time solver based on the standalone QSS solver is implemented. Only non-stiff systems can be solved efficiently.
  • v0.3 (2015) synchronizes the API with SimPy v3 and is Julia v0.3, v0.4 and v0.5 compatible:
    • Documentation is available at readthedocs.
    • The continuous time solver is not implemented.
  • v0.2 (2014) introduces a continuous time solver inspired by the Simula library DISCO and is Julia v0.2 and v0.3 compatible.
  • v0.1 (2013) is a Julia clone of SimPy v2 and is Julia v0.2 compatible.

Todo

  • Transparent statistics gathering for resources.
  • Update of documentation.

Used By Packages