# marinlmsr/sncf_project architecture

> Architecture diagram of the GitHub repository marinlmsr/sncf_project, 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/marinlmsr/sncf_project
- Repository: https://github.com/marinlmsr/sncf_project

## Overview

This repository aims to analyze TGV punctuality and delays to inform commercial investment opportunities at stations. The visible runtime is currently a Streamlit placeholder: users can open network overview, route detail, and delay-cause tabs, but each describes planned analysis rather than showing results. The README documents planned data cleaning, calculations, and visualizations, plus a monthly TGV regularity CSV. Those analysis modules are empty in the supplied excerpts, so their data flow and integration with the app cannot be verified.

Main entry points: [`src/app.py`](https://github.com/marinlmsr/sncf_project/blob/main/src/app.py) (Streamlit app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_app["Streamlit app<br/>[app.py]"]
  node_overview["Network overview<br/>[app.py]"]
  node_routes["Route detail<br/>[app.py]"]
  node_causes["Delay causes<br/>[app.py]"]
end

subgraph group_analysis["Analysis capabilities"]
  node_cleaning["Data cleaning<br/>[module1.py]"]
  node_calculations["Statistical calculations<br/>[core.py]"]
  node_visualizations["Data visualizations<br/>[module2.py]"]
end

subgraph group_data["Data"]
  node_regularity[("Monthly regularity data")]
end

node_user(("Analyst"))

node_user -->|"opens"| node_app
node_app -->|"renders tab"| node_overview
node_app -->|"renders tab"| node_routes
node_app -->|"renders tab"| node_causes

click node_app "https://github.com/marinlmsr/sncf_project/blob/main/src/app.py"
click node_overview "https://github.com/marinlmsr/sncf_project/blob/main/src/app.py"
click node_routes "https://github.com/marinlmsr/sncf_project/blob/main/src/app.py"
click node_causes "https://github.com/marinlmsr/sncf_project/blob/main/src/app.py"
click node_cleaning "https://github.com/marinlmsr/sncf_project/blob/main/src/my_package/module1.py"
click node_calculations "https://github.com/marinlmsr/sncf_project/blob/main/src/core.py"
click node_visualizations "https://github.com/marinlmsr/sncf_project/blob/main/src/my_package/module2.py"
click node_regularity "https://github.com/marinlmsr/sncf_project/blob/main/data/regularite-mensuelle-tgv-aqst.csv"

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_overview,node_routes,node_causes toneBlue
class node_cleaning,node_calculations,node_visualizations toneAmber
class node_regularity toneMint
class node_user toneIndigo
```

## Components

### User interface

- [Streamlit app](https://github.com/marinlmsr/sncf_project/blob/main/src/app.py): `src/app.py`
- [Network overview](https://github.com/marinlmsr/sncf_project/blob/main/src/app.py): `src/app.py`
- [Route detail](https://github.com/marinlmsr/sncf_project/blob/main/src/app.py): `src/app.py`
- [Delay causes](https://github.com/marinlmsr/sncf_project/blob/main/src/app.py): `src/app.py`

### Analysis capabilities

- [Data cleaning](https://github.com/marinlmsr/sncf_project/blob/main/src/my_package/module1.py): `src/my_package/module1.py`
- [Statistical calculations](https://github.com/marinlmsr/sncf_project/blob/main/src/core.py): `src/core.py`
- [Data visualizations](https://github.com/marinlmsr/sncf_project/blob/main/src/my_package/module2.py): `src/my_package/module2.py`

### Data

- [Monthly regularity data](https://github.com/marinlmsr/sncf_project/blob/main/data/regularite-mensuelle-tgv-aqst.csv): `data/regularite-mensuelle-tgv-aqst.csv`

### Other components

- **Analyst**

## Connections

- Analyst → Streamlit app: opens (evidence: `src/app.py`)
- Streamlit app → Network overview: renders tab (evidence: `src/app.py`)
- Streamlit app → Route detail: renders tab (evidence: `src/app.py`)
- Streamlit app → Delay causes: renders tab (evidence: `src/app.py`)
