# latriateomerch/outils-cs architecture

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

- Interactive diagram: https://gitdiagram.com/latriateomerch/outils-cs
- Repository: https://github.com/latriateomerch/outils-cs

## Overview

This repository is a collection of scientific-computing course materials and teaching examples, not a single integrated application. Its most complete product-like workflow is the weather-data project: load and preprocess weather data, manipulate it, then visualize configured results. Other substantial branches demonstrate station observations, land-surface model analysis, and guitar-sound synthesis. Relationships are limited to those visible in excerpts or stated in the README; several project imports do not match the sampled filenames, so no unsupported wiring is inferred.

Main entry points: [`projet/cli.py`](https://github.com/latriateomerch/outils-cs/blob/main/projet/cli.py) (Analysis CLI), [`stage_git/scripts/utils/data_getter.py`](https://github.com/latriateomerch/outils-cs/blob/main/stage_git/scripts/utils/data_getter.py) (Remote data retrieval), [`projet/manipulator.py`](https://github.com/latriateomerch/outils-cs/blob/main/projet/manipulator.py) (Data manipulation), [`2025/Class_station.py`](https://github.com/latriateomerch/outils-cs/blob/main/2025/Class_station.py) (Station network)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_weather["Weather analysis"]
  node_config["Analysis config<br/>[config.yaml]"]
  node_cli["Analysis CLI<br/>[cli.py]"]
  node_loader["Dataset loader<br/>[reader.py]"]
  node_dataset[("Weather dataset")]
  node_manipulator["Data manipulation<br/>[manipulator.py]"]
  node_visualizer["Weather visualization<br/>[plotting.py]"]
end

subgraph group_stations["Station analysis"]
  node_station_reader["Station reader<br/>[Class_station.py]"]
  node_station_data[("Station observations")]
  node_station_analysis["Station statistics<br/>[Class_station.py]"]
  node_network["Station network<br/>[Class_station.py]"]
end

subgraph group_land["Land model exercises"]
  node_radiation["Radiation budget"]
  node_soil_moisture["Soil moisture profiles"]
  node_ftp_getter["Remote data retrieval<br/>[data_getter.py]"]
  node_ftp_checker["FTP file check<br/>[ftp_checker.py]"]
end

subgraph group_audio["Audio synthesis"]
  node_synthesis["Guitar synthesis<br/>[guitar.py]"]
end

node_user(("Course user"))
node_station_user(("Station analyst"))
node_land_user(("Model analyst"))
node_ftp["Hendrix FTP"]
node_audio_user(("Audio example user"))
node_sound_device["Audio playback"]

node_user -->|"runs"| node_cli
node_cli -->|"loads"| node_config
node_cli -->|"constructs"| node_loader
node_loader -->|"loads data"| node_dataset
node_cli -->|"constructs"| node_manipulator
node_cli -->|"constructs"| node_visualizer
node_manipulator -->|"filters and analyzes"| node_dataset
node_cli -->|"requests analysis"| node_manipulator
node_cli -->|"plots results"| node_visualizer
node_station_user -->|"uses"| node_station_reader
node_station_reader -->|"reads CSV"| node_station_data
node_station_analysis -->|"filters and aggregates"| node_station_data
node_network -->|"loads CSV"| node_station_data
node_network -->|"creates stations"| node_station_analysis
node_land_user -->|"runs"| node_radiation
node_land_user -->|"runs"| node_soil_moisture
node_land_user -->|"runs"| node_ftp_getter
node_ftp_getter -->|"checks file"| node_ftp_checker
node_ftp_checker -->|"checks remote file"| node_ftp
node_ftp_getter -->|"retrieves file"| node_ftp
node_audio_user -->|"runs"| node_synthesis
node_synthesis -->|"plays samples"| node_sound_device

click node_config "https://github.com/latriateomerch/outils-cs/blob/main/projet/config.yaml"
click node_cli "https://github.com/latriateomerch/outils-cs/blob/main/projet/cli.py"
click node_loader "https://github.com/latriateomerch/outils-cs/blob/main/projet/reader.py"
click node_manipulator "https://github.com/latriateomerch/outils-cs/blob/main/projet/manipulator.py"
click node_visualizer "https://github.com/latriateomerch/outils-cs/blob/main/projet/plotting.py"
click node_station_reader "https://github.com/latriateomerch/outils-cs/blob/main/2025/Class_station.py"
click node_station_analysis "https://github.com/latriateomerch/outils-cs/blob/main/2025/Class_station.py"
click node_network "https://github.com/latriateomerch/outils-cs/blob/main/2025/Class_station.py"
click node_radiation "https://github.com/latriateomerch/outils-cs/blob/main/stage_git/scripts/Q2.1_Q2.2_bilan_radiatif.py"
click node_soil_moisture "https://github.com/latriateomerch/outils-cs/blob/main/stage_git/scripts/Q3.3_coupe_humidite_sol.py"
click node_ftp_getter "https://github.com/latriateomerch/outils-cs/blob/main/stage_git/scripts/utils/data_getter.py"
click node_ftp_checker "https://github.com/latriateomerch/outils-cs/blob/main/stage_git/scripts/utils/ftp_checker.py"
click node_synthesis "https://github.com/latriateomerch/outils-cs/blob/main/guitar.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_config,node_cli,node_loader,node_dataset,node_manipulator,node_visualizer,node_user,node_audio_user toneBlue
class node_station_reader,node_station_data,node_station_analysis,node_network toneAmber
class node_radiation,node_soil_moisture,node_ftp_getter,node_ftp_checker toneMint
class node_synthesis toneRose
class node_station_user,node_land_user,node_ftp,node_sound_device toneIndigo
```

## Components

### Weather analysis

- [Analysis config](https://github.com/latriateomerch/outils-cs/blob/main/projet/config.yaml): `projet/config.yaml`
- [Analysis CLI](https://github.com/latriateomerch/outils-cs/blob/main/projet/cli.py): `projet/cli.py`
- [Dataset loader](https://github.com/latriateomerch/outils-cs/blob/main/projet/reader.py): `projet/reader.py`
- **Weather dataset**
- [Data manipulation](https://github.com/latriateomerch/outils-cs/blob/main/projet/manipulator.py): `projet/manipulator.py`
- [Weather visualization](https://github.com/latriateomerch/outils-cs/blob/main/projet/plotting.py): `projet/plotting.py`

### Station analysis

- [Station reader](https://github.com/latriateomerch/outils-cs/blob/main/2025/Class_station.py): `2025/Class_station.py`
- **Station observations**
- [Station statistics](https://github.com/latriateomerch/outils-cs/blob/main/2025/Class_station.py): `2025/Class_station.py`
- [Station network](https://github.com/latriateomerch/outils-cs/blob/main/2025/Class_station.py): `2025/Class_station.py`

### Land model exercises

- [Radiation budget](https://github.com/latriateomerch/outils-cs/blob/main/stage_git/scripts/Q2.1_Q2.2_bilan_radiatif.py): `stage_git/scripts/Q2.1_Q2.2_bilan_radiatif.py`
- [Soil moisture profiles](https://github.com/latriateomerch/outils-cs/blob/main/stage_git/scripts/Q3.3_coupe_humidite_sol.py): `stage_git/scripts/Q3.3_coupe_humidite_sol.py`
- [Remote data retrieval](https://github.com/latriateomerch/outils-cs/blob/main/stage_git/scripts/utils/data_getter.py): `stage_git/scripts/utils/data_getter.py`
- [FTP file check](https://github.com/latriateomerch/outils-cs/blob/main/stage_git/scripts/utils/ftp_checker.py): `stage_git/scripts/utils/ftp_checker.py`

### Audio synthesis

- [Guitar synthesis](https://github.com/latriateomerch/outils-cs/blob/main/guitar.py): `guitar.py`

### Other components

- **Course user**
- **Station analyst**
- **Model analyst**
- **Hendrix FTP**
- **Audio example user**
- **Audio playback**

## Connections

- Course user → Analysis CLI: runs (evidence: `projet/cli.py`)
- Analysis CLI → Analysis config: loads (evidence: `projet/cli.py`)
- Analysis CLI → Dataset loader: constructs (evidence: `projet/cli.py`)
- Dataset loader → Weather dataset: loads data (evidence: `projet/reader.py`)
- Analysis CLI → Data manipulation: constructs (evidence: `projet/cli.py`)
- Analysis CLI → Weather visualization: constructs (evidence: `projet/cli.py`)
- Data manipulation → Weather dataset: filters and analyzes (evidence: `projet/manipulator.py`)
- Analysis CLI → Data manipulation: requests analysis (evidence: `projet/cli.py`)
- Analysis CLI → Weather visualization: plots results (evidence: `projet/cli.py`)
- Station analyst → Station reader: uses (evidence: `2025/Class_station.py`)
- Station reader → Station observations: reads CSV (evidence: `2025/Class_station.py`)
- Station statistics → Station observations: filters and aggregates (evidence: `2025/Class_station.py`)
- Station network → Station observations: loads CSV (evidence: `2025/Class_station.py`)
- Station network → Station statistics: creates stations (evidence: `2025/Class_station.py`)
- Model analyst → Radiation budget: runs (evidence: `stage_git/scripts/Q2.1_Q2.2_bilan_radiatif.py`)
- Model analyst → Soil moisture profiles: runs (evidence: `stage_git/scripts/Q3.3_coupe_humidite_sol.py`)
- Model analyst → Remote data retrieval: runs (evidence: `stage_git/scripts/utils/data_getter.py`)
- Remote data retrieval → FTP file check: checks file (evidence: `stage_git/scripts/utils/data_getter.py`)
- FTP file check → Hendrix FTP: checks remote file (evidence: `stage_git/scripts/utils/ftp_checker.py`)
- Remote data retrieval → Hendrix FTP: retrieves file (evidence: `stage_git/scripts/utils/data_getter.py`)
- Audio example user → Guitar synthesis: runs (evidence: `guitar.py`)
- Guitar synthesis → Audio playback: plays samples (evidence: `guitar.py`)
