TOPSIS ranking and interpretation using WMSD-space

This repository hosts the code for MSDTransformer - a scikit-learn compatible python library, that lets you create TOPSIS rankings of alternatives, visualize rankings in WMSD space, and get suggestions for improvement actions.

Requirements

MSDTransformer uses PySCIPOpt to determine exact WMSD boundaries quickly. If you use conda, you should be fine performing the follwoing command (easier option):

conda install --channel conda-forge pyscipopt

If you use PyPI, then you will need a working installation of the SCIP Optimization Suite (harder option, but might run faster). Please, make sure that your SCIP installation works, before installing MSDTransformer. For more details on how to install SCIP, please refer to the PySCIPOpt documentation.

After installing PySCIPOpt (or if you already have SCIP installed), you can install the other dependencies by running:

pip install -r requirements.txt

Installation

Once you have all the dependencies, you can install MSDTransformer from source. To do so, clone the repository and run the following command in the root directory of the repository:

pip install .

Quickstart

import pandas as pd
from MSDTransformer import MSDTransformer

df = pd.read_csv("../data/students.csv", sep=';', index_col= 0)
students_transformer = MSDTransformer("R") # Relative distance
students_transformer.fit(df, expert_range=[[0,100],[1,6],[1,6]])
students_transformer.transform(df)

students_transformer.show_ranking()

students_transformer.plot()

Citation

If you use this project in your research, please consider citing the following papers:

• Susmaga, R. et al. (2023) MSD-space: Visualizing the inner-workings of TOPSIS aggregations. European Journal of Operational Research, 308(1), 229-242.
• Susmaga, R. et al. (2023) Towards Explainable TOPSIS: Visual Insights into the Effects of Weights and Aggregations on Rankings. Arxiv preprint.