102303812-topsis 1.0.0__py3-none-any.whl

102303812-topsis/__init__.py

@@ -0,0 +1 @@
+from .topsis import topsis

102303812-topsis/topsis.py

@@ -0,0 +1,180 @@
+"""
+TOPSIS (Technique for Order of Preference by Similarity to Ideal Solution) Implementation
+
+This module implements the TOPSIS multi-criteria decision analysis method.
+TOPSIS ranks alternatives based on their distance from the ideal positive solution
+and distance from the ideal negative solution.
+
+Author: Harsh Tanwar
+Roll Number: 102303812
+Email: htanwar_be23@thapar.edu
+"""
+
+import sys
+import pandas as pd
+import numpy as np
+import os
+
+
+def check_numeric(df):
+    """
+    Validates that all columns from the 2nd column onwards contain numeric values.
+    
+    Args:
+        df (pd.DataFrame): Input dataframe to validate
+        
+    Returns:
+        bool: True if all columns (from 2nd onwards) are numeric, False otherwise
+    """
+    try:
+        # Check from 2nd column (index 1) to the end
+        df.iloc[:, 1:].astype(float)
+        return True
+    except ValueError:
+        return False
+
+
+def topsis(input_file, weights, impacts, result_file):
+    """
+    Implements the TOPSIS algorithm to rank alternatives based on multiple criteria.
+    
+    The algorithm follows these steps:
+    1. Load and validate input data
+    2. Normalize the decision matrix using vector normalization
+    3. Apply weights to the normalized matrix
+    4. Determine ideal best and ideal worst solutions
+    5. Calculate Euclidean distances from ideal solutions
+    6. Compute performance scores and rank alternatives
+    
+    Args:
+        input_file (str): Path to CSV file containing alternatives and criteria values
+        weights (str): Comma-separated string of weights for each criterion
+        impacts (str): Comma-separated string of impacts ('+' for beneficial, '-' for non-beneficial)
+        result_file (str): Path for output CSV file with TOPSIS scores and ranks
+        
+    Returns:
+        None: Writes results to the specified output file
+    """
+    try:
+        # Step 1: Load Data
+        try:
+            df = pd.read_csv(input_file)
+        except FileNotFoundError:
+            print(f"Error: File '{input_file}' not found.")
+            return
+
+        # Step 2: Input Validation
+        if len(df.columns) < 3:
+            print("Error: Input file must contain three or more columns.")
+            return
+
+        if not check_numeric(df):
+            print("Error: From 2nd to last columns must contain numeric values only.")
+            return
+
+        # Calculate number of criteria (excluding the first column which contains alternative names)
+        cols = len(df.columns) - 1
+        
+        # Parse weights and impacts from comma-separated strings
+        weights = [float(w) for w in weights.split(',')]
+        impacts = impacts.split(',')
+
+        # Validate that weights, impacts, and criteria count match
+        if len(weights) != cols or len(impacts) != cols:
+            print("Error: The number of weights, number of impacts and number of columns (from 2nd to last columns) must be the same.")
+            return
+
+        # Validate impact values are either '+' or '-'
+        if not all(i in ['+', '-'] for i in impacts):
+            print("Error: Impacts must be either +ve or -ve.")
+            return
+
+        # Step 3: TOPSIS Algorithm Implementation
+        
+        # 3.1 Vector Normalization
+        # Create a copy of numeric columns for calculations to preserve original data
+        df_calc = df.iloc[:, 1:].copy().astype(float)
+        
+        # Calculate root sum of squares for each criterion
+        rss = np.sqrt((df_calc**2).sum())
+        
+        # Normalize the decision matrix using vector normalization
+        df_norm = df_calc / rss
+
+        # 3.2 Weighted Normalization
+        # Apply criterion weights to the normalized matrix
+        df_weighted = df_norm * weights
+
+        # 3.3 Determine Ideal Best and Ideal Worst Solutions
+        ideal_best = []
+        ideal_worst = []
+
+        for i in range(cols):
+            if impacts[i] == '+':
+                # For beneficial criteria: maximum is ideal best, minimum is ideal worst
+                ideal_best.append(df_weighted.iloc[:, i].max())
+                ideal_worst.append(df_weighted.iloc[:, i].min())
+            else:
+                # For non-beneficial criteria: minimum is ideal best, maximum is ideal worst
+                ideal_best.append(df_weighted.iloc[:, i].min())
+                ideal_worst.append(df_weighted.iloc[:, i].max())
+
+        # 3.4 Calculate Euclidean Distances
+        # Distance from ideal positive solution (best)
+        s_plus = np.sqrt(((df_weighted - ideal_best) ** 2).sum(axis=1))
+        
+        # Distance from ideal negative solution (worst)
+        s_minus = np.sqrt(((df_weighted - ideal_worst) ** 2).sum(axis=1))
+
+        # 3.5 Calculate Performance Score
+        # Performance score = distance from worst / (distance from best + distance from worst)
+        # Higher score indicates better performance
+        total_dist = s_plus + s_minus
+        performance_score = s_minus / total_dist
+        
+        # Step 4: Generate Output
+        # Add TOPSIS score and rank columns to the original dataframe
+        df['Topsis Score'] = performance_score
+        
+        # Rank alternatives in descending order of TOPSIS score (higher score = better rank)
+        df['Rank'] = df['Topsis Score'].rank(ascending=False).astype(int)
+
+        # Write results to output CSV file
+        df.to_csv(result_file, index=False)
+        print(f"Result file '{result_file}' created successfully.")
+
+    except Exception as e:
+        print(f"An error occurred: {e}")
+
+
+def main():
+    """
+    Main entry point for command-line execution of TOPSIS algorithm.
+    
+    Parses command-line arguments and calls the topsis function.
+    Expected arguments:
+        - InputDataFile: Path to input CSV file
+        - Weights: Comma-separated weights string
+        - Impacts: Comma-separated impacts string
+        - OutputResultFileName: Path to output CSV file
+    """
+    if len(sys.argv) != 5:
+        print("Usage: python <program.py> <InputDataFile> <Weights> <Impacts> <OutputResultFileName>")
+        print('Example: python topsis.py data.csv "1,1,1,2,1" "+,+,+,-,+" result.csv')
+        return
+
+    input_file = sys.argv[1]
+    weights = sys.argv[2]
+    impacts = sys.argv[3]
+    result_file = sys.argv[4]
+
+    # Additional file existence check before processing
+    if not os.path.exists(input_file):
+         print(f"Error: File '{input_file}' not found.")
+         return
+
+    topsis(input_file, weights, impacts, result_file)
+
+
+if __name__ == "__main__":
+    main()

102303812_topsis-1.0.0.dist-info/METADATA

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: 102303812-topsis
+Version: 1.0.0
+Summary: A Python package to implement TOPSIS
+Home-page: https://github.com/htan11/course-materials/tree/main/UCS654/Assignment1-Topsis
+Author: Harsh Tanwar
+Author-email: htanwar_be23@thapar.edu
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: summary
+
+# 102303812-topsis
+
+A Python package to implement **TOPSIS** (Technique for Order of Preference by Similarity to Ideal Solution) for multi-criteria decision analysis.
+
+**Author:** Harsh Tanwar  
+**Roll No:** 102303812  
+**Email:** htanwar_be23@thapar.edu  
+
+**Repository:** [Assignment1-Topsis](https://github.com/htan11/course-materials/tree/main/UCS654/Assignment1-Topsis)
+
+---
+
+## What is TOPSIS?
+
+TOPSIS ranks alternatives by comparing each to an *ideal positive* and *ideal negative* solution. Alternatives closer to the ideal positive and farther from the ideal negative get higher scores and better ranks. The method uses vector normalization, weighted criteria, and Euclidean distances to compute a performance score for each alternative.
+
+---
+
+## Requirements
+
+- Python 3.6+
+- **pandas** – data handling
+- **numpy** – numerical operations
+
+Install dependencies:
+
+```bash
+pip install pandas numpy
+```
+
+---
+
+## Installation
+
+### From PyPI (if published)
+
+```bash
+pip install 102303812-topsis
+```
+
+### From source (clone or download the repo)
+
+```bash
+git clone https://github.com/htan11/course-materials.git
+cd course-materials/UCS654/Assignment1-Topsis
+pip install .
+```
+
+Or, in the folder containing `setup.py`:
+
+```bash
+pip install .
+```
+
+---
+
+## Usage
+
+### Command line
+
+```bash
+topsis <InputDataFile> <Weights> <Impacts> <OutputResultFileName>
+```
+
+**Example (with 5 criteria):**
+
+```bash
+topsis data.csv "1,1,1,1,1" "+,+,-,+,-" result.csv
+```
+
+### As a Python module
+
+(Because the package name contains a hyphen, use `importlib` to import.)
+
+```python
+import importlib
+topsis = getattr(importlib.import_module("102303812-topsis"), "topsis")
+
+topsis("data.csv", "1,1,1,1,1", "+,+,-,+,-", "result.csv")
+```
+
+---
+
+## Parameters
+
+| Parameter | Description |
+|-----------|-------------|
+| **InputDataFile** | Path to a CSV file: first column = alternative names, remaining columns = numeric criterion values. Must have a header row. |
+| **Weights** | Comma-separated weights for each criterion (e.g. `"1,1,1,2,1"`). Number of values must match number of criteria. |
+| **Impacts** | Comma-separated impacts: `+` for beneficial (higher is better), `-` for non-beneficial (lower is better). Same count as criteria. |
+| **OutputResultFileName** | Path for the output CSV. Contains original columns plus **Topsis Score** and **Rank**. |
+
+- Beneficial (`+`): e.g. Quality, Customer Rating — higher value is better.  
+- Non-beneficial (`-`): e.g. Price, Delivery Time — lower value is better.
+
+---
+
+## Input file format
+
+CSV with a header; first column = alternative names, rest = numeric only.
+
+**Example (`data.csv`):**
+
+| Product | Quality | Price | Features | Customer Rating | Delivery Time |
+|---------|---------|-------|----------|-----------------|---------------|
+| A1      | 8.5     | 450   | 7.2      | 4.3             | 3             |
+| A2      | 7.8     | 380   | 8.1      | 4.5             | 5             |
+| ...     | ...     | ...   | ...      | ...             | ...           |
+
+- Column 1: labels (not used in math).  
+- Columns 2–6: criteria. Weights and impacts must be given for each of these in order.
+
+---
+
+## Example with this dataset
+
+For 5 criteria (Quality, Price, Features, Customer Rating, Delivery Time):
+
+- **Weights:** `"1,1,1,1,1"` (equal weight).  
+- **Impacts:** `"+,+,-,+,-"` (Quality +, Price +, Features -, Customer Rating +, Delivery Time -).
+
+Run:
+
+```bash
+topsis data.csv "1,1,1,1,1" "+,+,-,+,-" result.csv
+```
+
+Output CSV will have all input columns plus:
+
+- **Topsis Score** – higher is better.  
+- **Rank** – 1 = best alternative.
+
+---
+
+## Output
+
+The result file contains:
+
+- All original columns.  
+- **Topsis Score** – performance score in [0, 1].  
+- **Rank** – integer rank (1 = best).
+
+Example message: `Result file 'result.csv' created successfully.`
+
+---
+
+## Project structure
+
+```
+assignment1_DS-main/
+├── README.md
+├── setup.py
+├── data.csv              # Sample input
+├── 102303812-topsis/
+│   ├── __init__.py
+│   └── topsis.py         # TOPSIS implementation
+└── LICENSE
+```
+
+---
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.

102303812_topsis-1.0.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+_topsis_entry.py,sha256=PCUM9ICDx5x9_kO0aRPctJrxw4IDcVW_KbHwOZjlCCM,193
+102303812-topsis/__init__.py,sha256=ySjTkNVa20OI1QFkLvToedIHgoOwlWAQvHCbV2Rg1E0,27
+102303812-topsis/topsis.py,sha256=N3RUop503QA2gidqQ7NNMpbzh2zZqtJAebfSmrb5oEI,6521
+102303812_topsis-1.0.0.dist-info/licenses/LICENSE,sha256=6NELaJnBocT4i7N4PC8oB4bJdSSNn_DpzaCJeHTR2fQ,1069
+102303812_topsis-1.0.0.dist-info/METADATA,sha256=ulbRuoWKvKMDR8rVDk-IoYhrHkRPbVoKf2Wx97rH8Zc,5141
+102303812_topsis-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+102303812_topsis-1.0.0.dist-info/entry_points.txt,sha256=QE4af7gZl6iT4r0Ey-LCr1dPJlxyXB0X8hy_AhCynQ8,46
+102303812_topsis-1.0.0.dist-info/top_level.txt,sha256=9vdaHen8jLGH1YjxkEN_zQnyyVJcy7wUXehITda_YCQ,31
+102303812_topsis-1.0.0.dist-info/RECORD,,

102303812_topsis-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

102303812_topsis-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+topsis = _topsis_entry:main

102303812_topsis-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Harsh Tanwar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

102303812_topsis-1.0.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+102303812-topsis
+_topsis_entry

_topsis_entry.py

@@ -0,0 +1,7 @@
+"""Entry point for the topsis console script (package name has a hyphen)."""
+from importlib import import_module
+
+
+def main():
+    mod = import_module("102303812-topsis.topsis")
+    mod.main()