Skip to content

RJ-Hossan/PerfSpectra

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

18 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

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

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages