Metadata-Version: 2.1
Name: topsis-jamesfallon
Version: 0.1.3
Summary: Implementation of TOPSIS decision making
Home-page: https://gitlab.com/jamesfallon/topsis-python
Author: James Fallon
Author-email: j.fallon@pgr.reading.ac.uk
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown

# TOPSIS-Python

Inspired by [TOPSIS-Python](https://github.com/Glitchfix/TOPSIS-Python)
(python2).

Our python 3 code follows the same strucutre, definign a topsis class, 
but uses numpy linear algebra in order to modernise, optimise, and remove
redundant code.

pypi: <https://pypi.org/project/topsis-jamesfallon>
git: <https://gitlab.com/jamesfallon/topsis-python.git>

## What is TOPSIS

**T**echnique for **O**rder **P**reference by **S**imilarity to **I**deal
**S**olution (TOPSIS) originated in the 1980s as a multi-criteria decision
making method. TOPSIS chooses the altenrative of shortest Euclidean distance
from the idael solution, and fartherst distance from the negative-ideal
solution. More details at [wikipedia](https://en.wikipedia.org/wiki/TOPSIS). The
TOPSIS algorithm is succintly explained in this [paper comparing TOPSIS and
VIKOR methods
](https://www.sciencedirect.com/science/article/pii/S0377221703000201)

## Using TOPSIS-Python

TOPSIS-Python can be run as in the following example:

```
>>> import numpy as np
>>> from topsis import topsis
>>> a = [[7, 9, 9, 8], [8, 7, 8, 7], [9, 6, 8, 9], [6, 7, 8, 6]]
>>> w = [0.1, 0.4, 0.3, 0.2]
>>> I = np.array([1, 1, 1, 0]
>>> decision = topsis.topsis(a, w, I)
```

The decision matrix (`a`) should be constructed with each row representing
an alternative, and each column representing a criterion. We have used an
example given in [TOPSIS Method in MADM (Dr. Farhad Faez)](
http://www.faez.ir/CourseFile/TOPSIS.pdf)

Weights (`w`) is not already normalised will be normalised upon
initialisation. Information on benefit (1) cost (0) criteria should be provided
in `I`. 

By default, the optimisation (TOPSIS calculation) does not take place. No values
are stored in `decision.C` or `decision.optimum_choice`.

These can be calculated, either by calling `decision.calc()`, or by calling a
representation of the decision (which will itself call `decision.calc()`):

```
>>> decision

Alternatives ranking C:
[0.74269409 0.40359933 0.17586999 0.44142927]

Best alternative
a[0]: [7. 9. 9. 8.]

```

The rankings are saved in `decision.C`, with the highest ranking $`0.74269409`$
offering us the best decision, and lowest ranking $`0.17586999`$ offering the
worst decision making, according to TOPSIS method.

We are also then shown the best alternative index (which happens to be index 0
in this example), and the associated criteria coefficients of this alternative.


