Skip to content

oguzhanlt/anomaly-explorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📊 Anomaly Explorer – Full-Stack CSV Anomaly Detection

Anomaly Explorer is an entry level full-stack web application that allows users to upload CSV files and automatically detect statistical anomalies in numeric signals.
The application features a FastAPI backend for data processing and a lightweight JavaScript frontend for visualization.

Anomaly Explorer


✨ Features

  • Upload CSV files directly from the browser
  • Automatic detection of anomalies using statistical thresholds
  • Interactive line plot with anomaly markers
  • Feature selection for multi-column datasets
  • Tabular overview of detected anomalies
  • Clean, responsive dashboard-style UI

🧠 How It Works

  1. The user uploads a CSV file via the frontend.
  2. The frontend sends the file to the backend using a REST API.
  3. The FastAPI backend:
    • parses the CSV
    • extracts numeric columns
    • detects anomalies using a statistical model
  4. The backend returns structured JSON data.
  5. The frontend visualizes:
    • the signal as a line plot
    • anomalies as highlighted points
    • a detailed anomaly table per feature

🏗️ Tech Stack

Backend

  • Python
  • FastAPI
  • Pandas / NumPy
  • REST API (POST /analyze)

Frontend

  • HTML5
  • Vanilla JavaScript
  • Chart.js for plotting
  • Custom CSS (no frameworks)

🗂️ Project Structure

full-stack-project-1/
├── backend/
│   ├── main.py
│   ├── logic.py
│   └── requirements.txt
├── frontend/
│   ├── index.html
│   └── app.js
├── screenshots/
│   └── dashboard.png
├── README.md
└── .gitignore

⚙️ Running Locally

cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload

The backend will be available at http://127.0.0.1:8000


🔮 Future Work

  1. The current version serves as a lightweight pipeline to quickly validate experimental data and verify whether measurements were successful, particularly in materials and signal-based experiments.
  2. The scope of this project extends beyond this initial use case. Planned improvements include modular analysis components and additional visualization and processing capabilities to support a wider range of data analysis tasks.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors