Skip to content
CameronDevinePublic

About

This is a set of tools to symbolically determine the differential equation of a dynamic system given its elemental and constraint equations.

Resources

Code of conduct

Contributing

Stars

5 stars

Watchers

3 watching

Forks

Repository files navigation

StateMint

Python package PyPI License Code of Conduct status DOI

StateMint is a set of tools to symbolically determine the differential equation describing the dynamics of a system. As inputs these tools take the elemental and constraint equations of a system, in the forms of Rowell and Wormley's System Dynamics: An Introduction, chapter 5, and they return the state and output equations, their matrices, and the transfer function. A tutorial is available which covers how to prepare equations for use with these tools. See the changelog for what is new in version 3.

Web Interface

The web interface needs no installation: it runs the Python package in the browser with Pyodide. Systems can be saved in the browser, downloaded as .rnd files, or shared as links. The web directory holds its source.

Python

The Python package is the reference implementation, built on SymPy. Install it with pip install StateMint; an example notebook shows how to use it.

import StateMint

sys = StateMint.Solve(
    ['Fs'],                                       # input variables
    ["vm' = Fm/m", "FK' = K*vK"],                 # state-variable elemental equations
    ['FB = B*vB'],                                # other elemental equations
    ['Fm = Fs - FK - FB', 'vK = vm', 'vB = vm'],  # constraint equations
    ['vm', 'FK + FB'])                            # outputs
sys.A, sys.B, sys.C, sys.D

Mathematica

The Mathematica package was the original implementation of this tool. An example of how to use the Mathematica package is provided. It is no longer maintained; the Python package and the web interface are.

Contributors

  • Cameron Devine, Dept. of Mechanical Engineering, University of Washington: Python Package and Web Interface
  • Rico Picone, Dept. of Mechanical Engineering, Saint Martin's University: Mathematica Package Maintenance, 3.0 Revival
  • Joseph Garbini, Dept. of Mechanical Engineering, University of Washington: Original Mathematica Package and Web Interface Terminology
  • Gavin Basuel, 1G Media & Design: Web Interface User Experience Design

About

This is a set of tools to symbolically determine the differential equation of a dynamic system given its elemental and constraint equations.

Resources

Code of conduct

Contributing

Stars

5 stars

Watchers

3 watching

Forks

Releases

Packages

Used by

Contributors

Languages