Skip to content

About

An Interactive Classification Model Evaluator

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

18 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

PerfSpectra

PerfSpectra is an interactive Streamlit-based tool for evaluating classification models. It helps researchers, data scientists, and ML practitioners analyze model performance with confusion matrices, classification reports, and mismatch analysis.

This tool is especially useful for writing shared task papers, as it automates error analysis and provides downloadable reports in multiple formats (CSV, PDF, TXT).


🚀 Features

✅ Confusion Matrix 📊 – Visualizes model performance
✅ Classification Report 📝 – Precision, Recall, F1-score
✅ Mismatch Analysis 🔍 – Highlights misclassified samples
✅ Downloadable Reports 📥 – Get insights in CSV, PDF, and TXT
✅ Multi-file Support 📂 – Compare multiple prediction files
✅ Interactive UI 🎨 – Built with Streamlit for ease of use


🛠️ Installation

1️⃣ Clone the repository:

git clone https://github.com/RJ-Hossan/PerfSpectra.git
cd PerfSpectra

2️⃣ Install dependencies:

pip install -r requirements.txt

3️⃣ Run the app:

streamlit run app.py

📤 How to Use

1️⃣ Upload True Labels (CSV) with columns:

  • Id (Unique identifier)
  • Label (True class labels)

2️⃣ Upload Prediction Files (CSV) with columns:

  • Id (Matching unique identifier)
  • Label (Predicted class labels)

3️⃣ Get accuracy, confusion matrix, classification report, and mismatches

4️⃣ Download reports in CSV, PDF, or TXT format


⚠️ Limitations

⚠️ File Format: CSV only
⚠️ Column Names: Must contain Id and Label (case-insensitive)
⚠️ Task Support: Currently for classification models only


🤝 Contribute

This project is open-source, and contributions are welcome!

Steps to contribute:

1️⃣ Fork the repo 🍴
2️⃣ Create a new branch 🔀
3️⃣ Make your changes ✨
4️⃣ Submit a pull request 📩


📜 License

MIT License – Feel free to use and modify!


🔗 Connect

💬 Have suggestions? Want to contribute? Drop an issue or connect with me on LinkedIn

⭐ If you find this useful, don't forget to star the repo! 🌟


About

An Interactive Classification Model Evaluator

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages