# heimdallr-rig/mp_isro_t8 architecture

> Architecture diagram of the GitHub repository heimdallr-rig/mp_isro_t8, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/heimdallr-rig/mp_isro_t8
- Repository: https://github.com/heimdallr-rig/mp_isro_t8

## Overview

Heimdall is a Streamlit application for identifying and classifying X-ray bursts from uploaded light-curve files. A user uploads a supported file; the app temporarily saves it, extracts time and rate data, and orchestrates noise reduction, peak detection and segregation, wavelet measurements, and flare classification before displaying interactive charts and tables. The README documents these analysis stages; the sampled source shows their calls in app.py and implementations in utils.py. The data/ and cacheDir/ paths are present, but the bundled data files are not shown being read by the app.

Main entry points: [`app.py`](https://github.com/heimdallr-rig/mp_isro_t8/blob/main/app.py) (Streamlit workflow), [`utils.py`](https://github.com/heimdallr-rig/mp_isro_t8/blob/main/utils.py) (Light-curve parsing), [`cacheDir`](https://github.com/heimdallr-rig/mp_isro_t8/tree/main/cacheDir) (Temporary uploads)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Application interface"]
  node_app["Streamlit workflow<br/>[app.py]"]
  node_upload["File upload<br/>[app.py]"]
  node_views["Charts and results<br/>[app.py]"]
end

subgraph group_analysis["Light-curve analysis"]
  node_parse["Light-curve parsing<br/>[utils.py]"]
  node_noise["Noise reduction<br/>[utils.py]"]
  node_peaks["Peak detection<br/>[utils.py]"]
  node_wavelets["Wavelet analysis<br/>[utils.py]"]
  node_classify["Flare classification<br/>[utils.py]"]
end

subgraph group_files["Input files"]
  node_cache[("Temporary uploads")]
  node_bundled[("Sample light curves")]
end

node_user(("User"))

node_user -->|"selects file"| node_upload
node_upload -->|"submits file"| node_app
node_app -->|"writes, removes"| node_cache
node_app -->|"calls"| node_parse
node_app -->|"calls"| node_noise
node_app -->|"calls"| node_peaks
node_app -->|"calls"| node_wavelets
node_app -->|"calls"| node_classify
node_app -->|"renders"| node_views
node_user -->|"views results"| node_views

click node_app "https://github.com/heimdallr-rig/mp_isro_t8/blob/main/app.py"
click node_upload "https://github.com/heimdallr-rig/mp_isro_t8/blob/main/app.py"
click node_views "https://github.com/heimdallr-rig/mp_isro_t8/blob/main/app.py"
click node_cache "https://github.com/heimdallr-rig/mp_isro_t8/tree/main/cacheDir"
click node_bundled "https://github.com/heimdallr-rig/mp_isro_t8/tree/main/data"
click node_parse "https://github.com/heimdallr-rig/mp_isro_t8/blob/main/utils.py"
click node_noise "https://github.com/heimdallr-rig/mp_isro_t8/blob/main/utils.py"
click node_peaks "https://github.com/heimdallr-rig/mp_isro_t8/blob/main/utils.py"
click node_wavelets "https://github.com/heimdallr-rig/mp_isro_t8/blob/main/utils.py"
click node_classify "https://github.com/heimdallr-rig/mp_isro_t8/blob/main/utils.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_upload,node_views,node_user toneBlue
class node_parse,node_noise,node_peaks,node_wavelets,node_classify toneAmber
class node_cache,node_bundled toneMint
```

## Components

### Application interface

- [Streamlit workflow](https://github.com/heimdallr-rig/mp_isro_t8/blob/main/app.py): `app.py`
- [File upload](https://github.com/heimdallr-rig/mp_isro_t8/blob/main/app.py): `app.py`
- [Charts and results](https://github.com/heimdallr-rig/mp_isro_t8/blob/main/app.py): `app.py`

### Light-curve analysis

- [Light-curve parsing](https://github.com/heimdallr-rig/mp_isro_t8/blob/main/utils.py): `utils.py`
- [Noise reduction](https://github.com/heimdallr-rig/mp_isro_t8/blob/main/utils.py): `utils.py`
- [Peak detection](https://github.com/heimdallr-rig/mp_isro_t8/blob/main/utils.py): `utils.py`
- [Wavelet analysis](https://github.com/heimdallr-rig/mp_isro_t8/blob/main/utils.py): `utils.py`
- [Flare classification](https://github.com/heimdallr-rig/mp_isro_t8/blob/main/utils.py): `utils.py`

### Input files

- [Temporary uploads](https://github.com/heimdallr-rig/mp_isro_t8/tree/main/cacheDir): `cacheDir`
- [Sample light curves](https://github.com/heimdallr-rig/mp_isro_t8/tree/main/data): `data`

### Other components

- **User**

## Connections

- User → File upload: selects file (evidence: `README.md`)
- File upload → Streamlit workflow: submits file (evidence: `app.py`)
- Streamlit workflow → Temporary uploads: writes, removes (evidence: `app.py`)
- Streamlit workflow → Light-curve parsing: calls (evidence: `app.py`)
- Streamlit workflow → Noise reduction: calls (evidence: `app.py`)
- Streamlit workflow → Peak detection: calls (evidence: `app.py`)
- Streamlit workflow → Wavelet analysis: calls (evidence: `app.py`)
- Streamlit workflow → Flare classification: calls (evidence: `app.py`)
- Streamlit workflow → Charts and results: renders (evidence: `app.py`)
- User → Charts and results: views results (evidence: `README.md`)
