markov-solver 2.0.0

Generate modern CLIs from OpenAPI specifications

MARKOV SOLVER

Solve Markov Chains in a glance.

Table of Contents

• Features
• Installation
• Usage
• References
• Issues
• License

Features

• Solve Markov Chains: Compute steady-state probabilities for discrete-time Markov chains.
• Symbolic Transition Rates: Define transition rates using symbolic expressions with named parameters.
• YAML Chain Definitions: Define Markov chains in simple, human-readable YAML files.
• Graph Visualization: Automatically render Markov chain diagrams in SVG and PNG formats using Graphviz.
• CLI and Library: Use as a command-line tool or integrate directly into your Python projects.
• Export Results: Save solutions to TXT and CSV files for further analysis.
• High Precision: Calculations with 12 decimal places of floating-point precision.

Installation

pip install markov-solver

Usage

You can use markov-solver as a CLI or as a library in your project.

To use it as a CLI, check the recorded demo:

To use it as a library, you can check the examples.

In both cases you need to define the Markov Chain to solve. See the instructions below to know how to do it.

Chain with constant transition rates

Let us image that we want to solve the following Markov chain:

We should create a YAML file that defines the chain:

chain:
  - from: "Sunny"
    to: "Sunny"
    value: "0.9"

  - from: "Sunny"
    to: "Rainy"
    value: "0.1"

  - from: "Rainy"
    to: "Rainy"
    value: "0.5"

  - from: "Rainy"
    to: "Sunny"
    value: "0.5"

Then, running the following command:

markov-solver solve --definition [PATH_TO_DEFINITION_FILE]

We obtain the following result:

===============================================================
                     MARKOV CHAIN SOLUTION
===============================================================

                      states probability
Rainy.........................................0.166666666666667
Sunny.........................................0.833333333333333

Chain with symbolic transition rates

Let us image that we want to solve the following Markov chain:

We should create a YAML file that defines the chain:

symbols:
  lambda: 1.5
  mu: 2.0

chain:
  - from: "0"
    to: "1"
    value: "lambda"

  - from: "1"
    to: "2"
    value: "lambda"

  - from: "2"
    to: "3"
    value: "lambda"

  - from: "3"
    to: "2"
    value: "3*mu"

  - from: "2"
    to: "1"
    value: "2*mu"

  - from: "1"
    to: "0"
    value: "mu"

Then, running the following command:

markov-solver solve --definition [PATH_TO_DEFINITION_FILE]

We obtain the following result:

===============================================================
                     MARKOV CHAIN SOLUTION
===============================================================

                      states probability
0.............................................0.475836431226766
1.............................................0.356877323420074
2.............................................0.133828996282528
3............................................0.0334572490706320

References

• "Discrete-Event Simulation", 2006, L.M. Leemis, S.K. Park
• "Performance Modeling and Design of Computer Systems, 2013, M. Harchol-Balter

Issues

Please report any issues or feature requests on the GitHub Issues page.

License

This project is licensed under the MIT License. See the LICENSE file for details.