BayesMCDM 0.1.1.54

Bayesian Multi-Criteria Decision-Making Toolkit

BayesMCDM: Bayesian Multi-Criteria Decision-Making Toolkit

BayesMCDM is a Python library for Bayesian modeling of various multi-criteria decision-making (MCDM) methods. This toolkit enables robust, probabilistic analysis of decision problems by incorporating uncertainty in preferences and criteria weights. The project is under active development—expect more models and functionalities to be added over time.

You can solve your decision problems directly in your browser—no software installation needed.

Supported Preference Types

Each method currently supports the standard preference type (e.g., 1-9 scale), which is fully implemented, tested, and ready for use. Additionally, BayesMCDM is being extended to handle a variety of preference formats for each method (these features are under active testing):

• Interval preferences
• Triangular fuzzy preferences
• Gaussian (normal) preferences

Support for group aggregation of preferences is also being developed, enabling analysis of collective decisions from multiple decision-makers. Additionally, a decision-maker clustering feature is under construction, which will identify groups of decision-makers with homogeneous preferences.

Supported Methods

The following methods are supported, each with an interactive Google Colab link. These links open ready-to-run notebooks containing example scripts for each method. You can enter your own data and solve your MCDM problem directly in your browser—no installation required.

1. Analytic Hierarchy Process (AHP)

AHP is a structured technique for organizing and analyzing complex decisions, based on pairwise comparisons among all criteria.

• Standard AHP Solver
  Includes a simple example using standard crisp 1-9 preferences.

2. Best-Worst Method (BWM)

BWM uses the best and worst criteria to derive optimal weights through pairwise comparisons.

• Standard BWM Solver
  Includes a simple example using standard crisp 1-9 preferences.

3. SWING Method

The SWING method elicits weights by asking decision-makers to "swing" criteria from worst to best, reflecting their relative importance.

• Standard SWING Solver
  Includes a simple example using standard crisp preferences.

4. Point Allocation

Point Allocation allows decision-makers to distribute a fixed number of points among criteria to indicate their importance.

• Standard Point Allocation Solver
  Includes a simple example using standard crisp preferences.

5. Weight Analyzer

The Weight Analyzer provides tools for analyzing the computed weights (and not preferences).

• Standard Weight Analyzer
  Includes a simple example on how to aggregate weights in a probabilistic manner.

Visualization

BayesMCDM offers several visualization tools to help interpret Bayesian results:

Credal Ranking

*Figure: Example of a credal ranking plot showing the probability of each criterion being more important than another.*

Credal ranking visualizes the probabilistic ranking of criteria, showing the likelihood of each criterion occupying each rank based on the posterior weight distributions. This helps in understanding the robustness and uncertainty of the ranking outcomes.

Weight Distributions

* Figure: Example of weight distributions *

Weight distributions plots display the full posterior distributions of criteria weights, allowing users to assess uncertainty, variability, and the impact of preference types on the final weights.

PyPI Package & Installation

BayesMCDM is available as a PyPI package. You can install it directly using pip:

pip install bayesmcdm

After installation, you can use BayesMCDM in your Python scripts or Jupyter notebooks. Here is a minimal example (from the AHP Aggregation notebook) to get you started:

import numpy as np
from BayesMCDM import AHP

# Define the PCM array (example for 5 criteria, 5 decision makers)
PCM = [
    [
        [1,   3,   5,     4, 7],
        [1/3, 1,   3,     2, 5],
        [1/5, 1/3, 1,   1/2, 3],
        [1/4, 1/2,   2,   1, 3],
        [1/7, 1/5, 1/3, 1/3, 1],
    ],
        [
        [1,     4,   3,    5,  8],
        [1/4,   1,   4,    3,  6],
        [1/3, 1/4,   1,    1,  5],
        [1/5, 1/3,   1,    1,  7],
        [1/8, 1/6, 1/5,  1/7,  1],
    ],
    # ... (other decision makers' PCMs) ...
]
criteria_names = ["C1", "C2", "C3", "C4", "C5"]

# Initialize and run the Bayesian AHP model
ahp = AHP.StandardAHP(PCM=PCM)
ahp.sampling()

See the example notebooks for more advanced usage, visualization, and group decision-making features.

License

This project is licensed under the MIT License.

---

Built by Majid Mohammadi