Topsis-Suwan-102317217 0.0.1

A Python implementation of TOPSIS method

Topsis-Suwan-102317217

A Python implementation of the TOPSIS (Technique for Order Preference by Similarity to Ideal Solution) method with full command-line support and PyPI packaging.

This project demonstrates:

• Implementation of the TOPSIS algorithm
• Command-line interface using sys.argv
• Input validation and error handling
• Packaging using modern pyproject.toml
• Building distribution files
• Publishing to PyPI

---

1. Project Overview

TOPSIS is a multi-criteria decision-making (MCDM) technique used to rank alternatives based on their distance from an ideal best and ideal worst solution.

The implemented workflow:

1. Normalize the decision matrix
2. Multiply by weights
3. Determine ideal best and worst
4. Compute Euclidean distance from ideal solutions
5. Calculate performance score
6. Rank alternatives

---

2. Command Line Usage

After installation:

topsis <input.csv> "<weights>" "<impacts>" <output.csv>

Example:

topsis input.csv "0.2,0.2,0.2,0.2,0.2" "+,-,+,-,-" output.csv

Input Requirements

• First column must contain alternative names
• Remaining columns must be numeric
• At least 3 columns required
• Weights must be comma-separated
• Impacts must be + or -
• Number of weights and impacts must match criteria columns

---

3. Example Input File

Fund Name,P1,P2,P3,P4,P5
M1,0.84,0.71,6.7,42.1,12.59
M2,0.91,0.83,7,31.7,10.11
M3,0.79,0.62,4.8,46.7,13.23
M4,0.78,0.61,6.4,42.4,12.55
M5,0.94,0.88,3.6,62.2,16.91
M6,0.88,0.77,6.5,51.5,14.91
M7,0.66,0.44,5.3,48.9,13.83
M8,0.93,0.86,3.4,37,10.55

---

4. Example Output

Fund Name	P1	P2	P3	P4	P5	Topsis Score	Rank
M6	0.88	0.77	6.5	51.5	14.91	0.738148132	1
M5	0.94	0.88	3.6	62.2	16.91	0.641885815	2
M1	0.84	0.71	6.7	42.1	12.59	0.56369233	3
M2	0.91	0.83	7	31.7	10.11	0.513032103	4
M4	0.78	0.61	6.4	42.4	12.55	0.491956082	5
M3	0.79	0.62	4.8	46.7	13.23	0.439177283	6
M8	0.93	0.86	3.4	37	10.55	0.408498677	7
M7	0.66	0.44	5.3	48.9	13.83	0.407389532	8

---

5. Project Structure

Topsis-Suwan-102317217/
│
├── src/
│   └── TopsisSuwan102317217/
│       ├── __init__.py
│       └── topsis.py
│
├── README.md
├── LICENSE
├── pyproject.toml
├── setup.cfg

---

6. Packaging Configuration

pyproject.toml

Key configuration:

• Uses setuptools
• Defines dependencies: pandas, numpy
• Registers CLI entry point
• Uses src layout

Important section:

[project.scripts]
topsis = "TopsisSuwan102317217.topsis:main"

[tool.setuptools.packages.find]
where = ["src"]

---

7. Development Pipeline

7.1 Algorithm Flow

flowchart TD
    A[Read CSV File] --> B[Validate Inputs]
    B --> C[Normalize Matrix]
    C --> D[Apply Weights]
    D --> E[Determine Ideal Best/Worst]
    E --> F[Compute Distances]
    F --> G[Calculate Score]
    G --> H[Rank Alternatives]
    H --> I[Write Output CSV]

---

7.2 Packaging and Distribution Flow

flowchart TD
    A[Write topsis.py] --> B[Create src Layout]
    B --> C[Add pyproject.toml]
    C --> D[Add setup.cfg]
    D --> E[Build Package]
    E --> F[Generate dist Files]
    F --> G[Install Locally]
    G --> H[Test CLI Command]
    H --> I[Upload to PyPI]

---

8. Building the Package Locally

Install build tool:

pip install build

Build:

python -m build

This generates:

dist/
    topsis_suwan_102317217-0.0.1.tar.gz
    topsis_suwan_102317217-0.0.1-py3-none-any.whl

---

9. Installing Locally

pip install dist/topsis_suwan_102317217-0.0.1-py3-none-any.whl

---

10. Uploading to PyPI

Install twine:

pip install twine

Upload:

twine upload dist/*

---

11. Installing from PyPI

After publication:

pip install Topsis-Suwan-102317217

Then run:

topsis input.csv "0.2,0.2,0.2,0.2,0.2" "+,-,+,-,-" output.csv

---

12. Dependencies

• pandas
• numpy
• Python >= 3.8

---

13. License

MIT License

---

14. Conclusion

This project demonstrates the complete lifecycle of:

• Algorithm implementation
• CLI development
• Modern Python packaging
• Local build testing
• Distribution through PyPI
• Reproducible installation

The repository serves as both an academic submission and a reproducible packaging reference.