How stac-iitmandi/xray-burst-detection works
This is a Flask-based solar X-ray burst identifier. The principal workflow is browser upload, server-side file parsing and time-series normalization, burst detection, downloadable result generation, then status/result polling and graph visualization. The graph includes the core parser, model, and output stages plus the documented upload and visualization paths. Source excerpts support the backend calls; page-template internals and unsampled UI wiring are not inspected, so those links are limited to documented or directly shown routes.
Main entry points: app.py Flask routes · __init__.py Analysis orchestration · visualise.js Burst visualization · upload.js File upload UI
Components 14
Web interface
- File upload UI
static/upload.js - Flask routes
app.py - Burst visualization
static/visualise.js - User guide page
templates/guide.html
Analysis pipeline
- Analysis orchestration
fileparsers/__init__.py - Burst detection
model.py
File formats
- Input parsers
fileparsers/read.py - Time conversion
fileparsers/read.py - Timeseries CSV
fileparsers/write.py - JSON results
fileparsers/__init__.py - Download writers
fileparsers/write.py
Upload state
- Upload files
uploads - Upload metadata
fileparsers/__init__.py
Other components
- Browser user
Connections 18
- Browser user → File upload UI: selects file
static/upload.js - File upload UI → Flask routes: submits upload
- Browser user → Flask routes: requests pages
app.py - Flask routes → Upload files: saves raw file
app.py - Flask routes → Upload metadata: records upload
app.py - Flask routes → Analysis orchestration: starts analysis
app.py - Analysis orchestration → Input parsers: parses file
fileparsers/__init__.py - Analysis orchestration → Time conversion: converts times
fileparsers/__init__.py - Analysis orchestration → Timeseries CSV: writes series
fileparsers/__init__.py - Analysis orchestration → Burst detection: evaluates series
fileparsers/__init__.py - Analysis orchestration → JSON results: writes JSON
fileparsers/__init__.py - Analysis orchestration → Download writers: writes exports
fileparsers/__init__.py - Flask routes → Upload metadata: checks status
app.py - Flask routes → Upload files: serves stored files
app.py - Burst visualization → Flask routes: polls endpoints
static/visualise.js - Burst visualization → JSON results: reads burst data
- Burst visualization → Timeseries CSV: plots time series
- Browser user → User guide page: opens guide