Skip to main content

Sismic Interactive State Machine Interpreter and Checker

Project description

Sismic Interactive State Machine Interpreter and Checker

Statecharts are a well-known visual language for modeling the executable behavior of complex reactive event-based systems. The Sismic library for Python >= 3.4 provides a set of tools to define, validate, simulate, execute and debug statecharts. More specifically, Sismic provides:

  • An easy way to define and to import statecharts, based on the human-friendly YAML markup language
  • A statechart interpreter offering a discrete, step-by-step, and fully observable simulation engine
  • Synchronous and asynchronous simulation, in real time or simulated time
  • Support for communication between statecharts and co-simulation
  • Built-in support for expressing actions and guards using regular Python code
  • A design-by-contract approach for statecharts
  • A unit testing framework for statecharts, including generation of test scenarios

Sismic provides full support for the majority of the UML 2 statechart concepts:

  • simple states, composite states, orthogonal (parallel) states, initial and final states, shallow and deep history states
  • state transitions, guarded transitions, automatic (eventless) transitions, internal transitions
  • statechart variables and their initialisation
  • state entry and exit actions, transition actions
  • internal and external events, parametrized events, timed events

In addition to this, contracts can be specified to express invariants, pre- and postconditions on states, transitions and the statechart itself.

The Sismic library is written in a modular way:

  • The semantics of the statechart interpreter is based on the specification of the SCXML semantics (with a few exceptions), and can be easily tuned to other semantics.
  • While currently, contracts, guards and actions are expressed in Python, this support can be easily extended to other languages.


Sismic can be installed using pip as usual: pip install sismic. This will install the latest stable version.

You can also install Sismic from this repository by cloning it. The development occurs in the master branch, the latest stable distributed version is in the stable branch.

Sismic requires Python >=3.4 but should also work with Python 3.3.


The latest version of the documentation is available at .

It can also be directly built from the docs/ directory using Sphinx.


Developed by Alexandre Decan at the University of Mons (Belgium).

GNU Lesser General Public License, version 3.

Project details

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for sismic, version 0.12.1
Filename, size File type Python version Upload date Hashes
Filename, size sismic-0.12.1-py3-none-any.whl (23.3 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size sismic-0.12.1.tar.gz (47.4 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page