# jadesoanes/climate_ai_summer_school architecture

> Architecture diagram of the GitHub repository jadesoanes/climate_ai_summer_school, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jadesoanes/climate_ai_summer_school
- Repository: https://github.com/jadesoanes/climate_ai_summer_school

## Overview

##### Project type and purpose
- This is not a monolithic application but a “learning‐materials” repository: a collection of Jupyter notebooks structured by session for the Climate Change AI Summer School.
- Purpose: Organize tutorials and user‐added notes on applying AI/ML to various climate‐related domains (land use, bioacoustics, NLP policy analysis, climate forecasting, building controls, power systems, transport modeling).

##### File structure
- Top level:
- README.md
- Session_X folders (Session_2 through Session_12, some with lowercase session_11)
- Each Session_X folder contains:
– A “.temp” subfolder (likely intermediate artifacts)
– One or more .ipynb tutorial notebooks
- No src/ or bin/—the code lives in notebooks.
- No Dockerfile or CI configs—assumes execution in Google Colab or local Jupyter.

##### Key insights from README
- Each session maps to a domain‐specific tutorial
- Notebooks run in Google Colab, use Python ML/AI libraries (PyTorch, scikit‐learn, GEE Python API, CityLearn, BOPTEST, PyTorch Geometric, etc.)
- Data sources and external frameworks vary by session (satellite imagery, audio recordings, text corpora, power‐grid simulation, transport datasets).

##### Main components
a. Repository & Directory Structure
- GitHub Repo “Climate Change AI Summer School”
- Session_X folders
- .temp artifacts
- README.md
b. Execution Environment
- Google Colab / Jupyter Notebook runtime
- Python runtime container (local/Colab)
c. Notebooks (per session)
- Data Ingestion & Preprocessing steps
- Model Training & Evaluation
- Post‐processing & Visualization
d. External Services & Data Sources
- Google Earth Engine for geospatial data
- Satellite imagery repositories (Session 6)
- Audio datasets (Session 3)
- Text corpora/APIs (Session 4)
- CityLearn simulator & BOPTEST environment (Session 9)
- Power‐grid simulators or data (Session 11)
- Transport/POI and bike‐share datasets (Session 12)
e. ML Frameworks & Libraries
- PyTorch (deep learning)
- scikit‐learn (classical ML)
- PyTorch Geometric (GNNs)
- Hugging Face Transformers (NLP)
- Custom Python scripts (data utils)

##### Relationships & data flows
- User (Engineer/Student) pulls the GitHub repo → opens a Session_X notebook in Colab/local Jupyter
- Notebook code fetches data from external sources or .temp cache → preprocesses data → feeds into ML frameworks → trains/evaluates models → outputs charts/tables back into notebook UI.
- Intermediate artifacts (model checkpoints, feature caches) can be written to .temp.

##### Architectural patterns & principles
- Modular organization by session (separation of concerns per domain)
- Notebook‐centric “pipeline” pattern: each notebook is a self‐contained ETL + modeling pipeline
- Reuse of common Python data‐utils across sessions (implied .temp caches)
- Execution environment abstraction (Colab vs. local)—notebooks do not assume specific underlying infra.

##### Detailed but not overthought
- Don’t try to break every cell into a block—treat each notebook as one component.
- Common elements (Python runtime + ML frameworks) under a “Compute Environment” container.
- Session_X folder as a repeatable pipeline block, optionally annotating domain specifics beside it.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Repository
    GitHub["GitHub Repository"]:::code
    README["README.md"]:::code
    GitHub --> README

    %% Sessions Directories
    Dir2["Session_2/"]:::code
    Dir3["Session_3/"]:::code
    Dir4["Session_4/"]:::code
    Dir5["Session_5/"]:::code
    Dir6["Session_6/"]:::code
    Dir9["Session_9/"]:::code
    Dir11["session_11/"]:::code
    Dir12["Session_12/"]:::code

    README --> Dir2
    README --> Dir3
    README --> Dir4
    README --> Dir5
    README --> Dir6
    README --> Dir9
    README --> Dir11
    README --> Dir12

    %% Jupyter UI
    Jupyter["Jupyter/Colab UI"]:::ui
    README --> Jupyter

    %% Compute Environment
    subgraph "Compute Environment"
        Python["Python Runtime"]:::compute
        ML["ML Frameworks\n(PyTorch, scikit-learn,\nPyTorch Geometric,\nHugging Face)"]:::compute
    end

    Jupyter --> Python
    Python --> ML

    %% External Data Sources
    subgraph "External Data Sources"
        GEE["Google Earth Engine"]:::data
        Satellite["Satellite Imagery Repos"]:::data
        AudioDS["Audio Datasets"]:::data
        TextAPI["Text Corpora/APIs"]:::data
        CityLearnSim["CityLearn & BOPTEST"]:::data
        PowerGridDS["Power Grid Simulators/Data"]:::data
        TransportDS["Transport/POI & Bike-share Datasets"]:::data
    end

    %% Session 2
    Session2NB1["land_use_land_cover_part1_ClimateAI.ipynb"]:::code
    Session2NB2["land_use_land_cover_part2_ClimateAI.ipynb"]:::code
    Cache2["Session_2/.temp"]:::cache

    Dir2 --> Session2NB1
    Dir2 --> Session2NB2
    Dir2 --> Cache2

    Jupyter --> Session2NB1
    Jupyter --> Session2NB2
    Session2NB1 --> ML
    Session2NB2 --> ML
    Session2NB1 --> GEE
    Session2NB2 --> GEE
    Session2NB1 --> Cache2
    Session2NB2 --> Cache2

    %% Session 3
    Session3NB["Agile_Modeling_for_Bioacoustic_Monitoring_Tutorial_ClimateAI.ipynb"]:::code
    Cache3["Session_3/.temp"]:::cache

    Dir3 --> Session3NB
    Dir3 --> Cache3

    Jupyter --> Session3NB
    Session3NB --> ML
    Session3NB --> AudioDS
    Session3NB --> Cache3

    %% Session 4
    Session4NB["NLPModelsForClimatePolicyAnalysisP1ClimateAI.ipynb"]:::code
    Cache4["Session_4/.temp"]:::cache

    Dir4 --> Session4NB
    Dir4 --> Cache4

    Jupyter --> Session4NB
    Session4NB --> ML
    Session4NB --> TextAPI
    Session4NB --> Cache4

    %% Session 5
    Session5NB["CCAI_Seasonal_Forecasting_with_Exercises_ClimateAI (1).ipynb"]:::code
    Cache5["Session_5/.temp"]:::cache

    Dir5 --> Session5NB
    Dir5 --> Cache5

    Jupyter --> Session5NB
    Session5NB --> ML
    Session5NB --> Cache5

    %% Session 6
    Session6NB["CCAI_Summer_School_Tutorial___MRV_ClimateAI.ipynb"]:::code
    Cache6["Session_6/.temp"]:::cache

    Dir6 --> Session6NB
    Dir6 --> Cache6

    Jupyter --> Session6NB
    Session6NB --> ML
    Session6NB --> GEE
    Session6NB --> Cache6

    %% Session 9
    Session9NB1["Building_Control_with_RL_using_BOPTEST_ClimateAI.ipynb"]:::code
    Session9NB2["Building_Load_Forecasting_with_ML_ClimateAI.ipynb"]:::code
    Session9NB3["citylearn_ccai_tutorial_ClimateAI.ipynb"]:::code
    Cache9["Session_9/.temp"]:::cache

    Dir9 --> Session9NB1
    Dir9 --> Session9NB2
    Dir9 --> Session9NB3
    Dir9 --> Cache9

    Jupyter --> Session9NB1
    Jupyter --> Session9NB2
    Jupyter --> Session9NB3
    Session9NB1 --> ML
    Session9NB2 --> ML
    Session9NB3 --> ML
    Session9NB1 --> CityLearnSim
    Session9NB2 --> CityLearnSim
    Session9NB3 --> CityLearnSim
    Session9NB1 --> Cache9
    Session9NB2 --> Cache9
    Session9NB3 --> Cache9

    %% Session 11
    Session11NB["AI_for_Optimal_Power_Flow_ClimateAI.ipynb"]:::code
    Cache11["session_11/.temp"]:::cache

    Dir11 --> Session11NB
    Dir11 --> Cache11

    Jupyter --> Session11NB
    Session11NB --> ML
    Session11NB --> PowerGridDS
    Session11NB --> Cache11

    %% Session 12
    Session12NB["Predicting_Mobility_Demand_From_Urban_Features_ClimateAI.ipynb"]:::code
    Cache12["Session_12/.temp"]:::cache

    Dir12 --> Session12NB
    Dir12 --> Cache12

    Jupyter --> Session12NB
    Session12NB --> ML
    Session12NB --> TransportDS
    Session12NB --> Cache12

    %% Click Events
    click README "https://github.com/jadesoanes/climate_ai_summer_school/blob/main/README.md"
    click Dir2 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/Session_2/"
    click Session2NB1 "https://github.com/jadesoanes/climate_ai_summer_school/blob/main/Session_2/land_use_land_cover_part1_ClimateAI.ipynb"
    click Session2NB2 "https://github.com/jadesoanes/climate_ai_summer_school/blob/main/Session_2/land_use_land_cover_part2_ClimateAI.ipynb"
    click Cache2 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/Session_2/.temp/"
    click Dir3 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/Session_3/"
    click Session3NB "https://github.com/jadesoanes/climate_ai_summer_school/blob/main/Session_3/Agile_Modeling_for_Bioacoustic_Monitoring_Tutorial_ClimateAI.ipynb"
    click Cache3 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/Session_3/.temp/"
    click Dir4 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/Session_4/"
    click Session4NB "https://github.com/jadesoanes/climate_ai_summer_school/blob/main/Session_4/NLPModelsForClimatePolicyAnalysisP1ClimateAI.ipynb"
    click Cache4 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/Session_4/.temp/"
    click Dir5 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/Session_5/"
    click Session5NB "https://github.com/jadesoanes/climate_ai_summer_school/blob/main/Session_5/CCAI_Seasonal_Forecasting_with_Exercises_ClimateAI (1).ipynb"
    click Cache5 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/Session_5/.temp/"
    click Dir6 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/Session_6/"
    click Session6NB "https://github.com/jadesoanes/climate_ai_summer_school/blob/main/Session_6/CCAI_Summer_School_Tutorial___MRV_ClimateAI.ipynb"
    click Cache6 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/Session_6/.temp/"
    click Dir9 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/Session_9/"
    click Session9NB1 "https://github.com/jadesoanes/climate_ai_summer_school/blob/main/Session_9/Building_Control_with_RL_using_BOPTEST_ClimateAI.ipynb"
    click Session9NB2 "https://github.com/jadesoanes/climate_ai_summer_school/blob/main/Session_9/Building_Load_Forecasting_with_ML_ClimateAI.ipynb"
    click Session9NB3 "https://github.com/jadesoanes/climate_ai_summer_school/blob/main/Session_9/citylearn_ccai_tutorial_ClimateAI.ipynb"
    click Cache9 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/Session_9/.temp/"
    click Dir11 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/session_11/"
    click Session11NB "https://github.com/jadesoanes/climate_ai_summer_school/blob/main/session_11/AI_for_Optimal_Power_Flow_ClimateAI.ipynb"
    click Cache11 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/session_11/.temp/"
    click Dir12 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/Session_12/"
    click Session12NB "https://github.com/jadesoanes/climate_ai_summer_school/blob/main/Session_12/Predicting_Mobility_Demand_From_Urban_Features_ClimateAI.ipynb"
    click Cache12 "https://github.com/jadesoanes/climate_ai_summer_school/tree/main/Session_12/.temp/"

    %% Styles
    classDef code fill:#ADE8F4,stroke:#023047,color:#000000;
    classDef compute fill:#FFB703,stroke:#FB8500,color:#000000;
    classDef data fill:#95D5B2,stroke:#2D6A4F,color:#000000;
    classDef cache fill:#E0E0E0,stroke:#6C757D,color:#000000;
    classDef ui fill:#FFCAD4,stroke:#E76F51,color:#000000;
```
