# heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar architecture

> Architecture diagram of the GitHub repository heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar
- Repository: https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar

## Overview

This repository is a research-and-design contribution archive, not one runtime application. Its main analytical workflows collect environmental or soil-sensor data, compare and validate measurements, and publish aggregate tables and summaries; a separate branch contains 3D model assets and a sonar-enclosure generator. The README establishes these areas, while sampled scripts show several acquisition, orchestration, and export steps. R-analysis internals and most model files were not sampled, so their detailed dependencies are not inferred.

Main entry points: [`02_umidade_solo/codigo/scripts/baixar_dados_pc03_azul.py`](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/codigo/scripts/baixar_dados_pc03_azul.py) (Fetch PC03), [`02_umidade_solo/codigo/analises_raiz`](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/02_umidade_solo/codigo/analises_raiz) (R analyses), [`02_umidade_solo/dados`](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/02_umidade_solo/dados) (Sensor inputs), [`01_estacao_et/codigo/scripts/baixar_dados_simepar.py`](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/01_estacao_et/codigo/scripts/baixar_dados_simepar.py) (Fetch SIMEPAR)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_environmental["Environmental station"]
  node_et_fetch["Fetch SIMEPAR"]
  node_et_data[("Station data")]
  node_et_analyses["ET analyses"]
  node_et_results[("ET results")]
end

subgraph group_soil["Soil moisture"]
  node_soil_update["Update PC01"]
  node_soil_pc03["Fetch PC03"]
  node_soil_inputs[("Sensor inputs")]
  node_soil_runner["Analysis runner"]
  node_soil_pc03_runner["PC03 runner"]
  node_soil_joint_runner["Joint runner"]
  node_soil_r_analyses["R analyses"]
  node_soil_programs["Sensor programs"]
  node_side_by_side["Sensor alignment"]
  node_soil_results[("Soil results")]
  node_contribution_analysis["October analysis"]
end

subgraph group_models["3D designs"]
  node_design_assets["3D model assets"]
  node_sonar_generator["Sonar generator"]
  node_sonar_exports["Sonar exports"]
end

node_researcher(("Researcher"))
node_simepar{{"SIMEPAR API"}}

node_researcher -->|"runs"| node_et_fetch
node_et_fetch -->|"requests data"| node_simepar
node_et_fetch -->|"writes CSV"| node_et_data
node_researcher -->|"runs"| node_soil_update
node_soil_update -->|"requests data"| node_simepar
node_soil_update -->|"updates inputs"| node_soil_inputs
node_researcher -->|"runs"| node_soil_pc03
node_soil_pc03 -->|"requests data"| node_simepar
node_soil_pc03 -->|"writes inputs"| node_soil_inputs
node_researcher -->|"runs"| node_soil_runner
node_soil_runner -->|"executes R"| node_soil_r_analyses
node_researcher -->|"runs"| node_soil_pc03_runner
node_soil_pc03_runner -->|"runs downloader"| node_soil_pc03
node_soil_pc03_runner -->|"executes R"| node_soil_r_analyses
node_researcher -->|"runs"| node_soil_joint_runner
node_soil_joint_runner -->|"executes R"| node_soil_r_analyses
node_researcher -->|"runs"| node_side_by_side
node_side_by_side -->|"reads sources"| node_soil_inputs
node_side_by_side -->|"writes aligned CSV"| node_soil_results
node_researcher -->|"runs"| node_sonar_generator
node_sonar_generator -->|"exports geometry"| node_sonar_exports
node_et_analyses -.->|"produces analyses"| node_et_results
node_soil_r_analyses -.->|"publishes aggregates"| node_soil_results
node_contribution_analysis -.->|"contributes results"| node_soil_results
node_soil_programs -.->|"provides sensor data"| node_soil_inputs
node_design_assets -.->|"provides models"| node_researcher

click node_et_fetch "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/01_estacao_et/codigo/scripts/baixar_dados_simepar.py"
click node_et_data "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/01_estacao_et"
click node_et_analyses "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/01_estacao_et/codigo"
click node_et_results "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/01_estacao_et/resultados"
click node_soil_update "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/codigo/scripts/atualizar_dados_umidade.py"
click node_soil_pc03 "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/codigo/scripts/baixar_dados_pc03_azul.py"
click node_soil_inputs "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/02_umidade_solo/dados"
click node_soil_runner "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/codigo/scripts/executar_analises_umidade.py"
click node_soil_pc03_runner "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/codigo/scripts/executar_analises_umidade_pc03_azul.py"
click node_soil_joint_runner "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/codigo/scripts/executar_analise_conjunta_tres_sensores.py"
click node_soil_r_analyses "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/02_umidade_solo/codigo/analises_raiz"
click node_soil_programs "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/02_umidade_solo/codigo/programas"
click node_side_by_side "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/codigo/scripts/gerar_csv_sensores_lado_a_lado.py"
click node_soil_results "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/02_umidade_solo/resultados"
click node_contribution_analysis "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/contribuicoes/validacao_pc01_pc03_cs_20261002_a_20261007/codigo/analise_conjunta_tres_sensores.R"
click node_design_assets "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/03_modelos_3d"
click node_sonar_generator "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/03_modelos_3d/04_caixa_sonar_18650/scripts/generate_caixa_sonar.py"
click node_sonar_exports "https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/03_modelos_3d/04_caixa_sonar_18650/cad_e_exportacoes"

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_et_fetch,node_et_data,node_et_analyses,node_et_results toneBlue
class node_soil_update,node_soil_pc03,node_soil_inputs,node_soil_runner,node_soil_pc03_runner,node_soil_joint_runner,node_soil_r_analyses,node_soil_programs,node_side_by_side,node_soil_results,node_contribution_analysis toneAmber
class node_design_assets,node_sonar_generator,node_sonar_exports,node_simepar toneMint
class node_researcher toneIndigo
```

## Components

### Environmental station

- [Fetch SIMEPAR](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/01_estacao_et/codigo/scripts/baixar_dados_simepar.py): `01_estacao_et/codigo/scripts/baixar_dados_simepar.py`
- [Station data](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/01_estacao_et): `01_estacao_et`
- [ET analyses](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/01_estacao_et/codigo): `01_estacao_et/codigo`
- [ET results](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/01_estacao_et/resultados): `01_estacao_et/resultados`

### Soil moisture

- [Update PC01](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/codigo/scripts/atualizar_dados_umidade.py): `02_umidade_solo/codigo/scripts/atualizar_dados_umidade.py`
- [Fetch PC03](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/codigo/scripts/baixar_dados_pc03_azul.py): `02_umidade_solo/codigo/scripts/baixar_dados_pc03_azul.py`
- [Sensor inputs](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/02_umidade_solo/dados): `02_umidade_solo/dados`
- [Analysis runner](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/codigo/scripts/executar_analises_umidade.py): `02_umidade_solo/codigo/scripts/executar_analises_umidade.py`
- [PC03 runner](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/codigo/scripts/executar_analises_umidade_pc03_azul.py): `02_umidade_solo/codigo/scripts/executar_analises_umidade_pc03_azul.py`
- [Joint runner](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/codigo/scripts/executar_analise_conjunta_tres_sensores.py): `02_umidade_solo/codigo/scripts/executar_analise_conjunta_tres_sensores.py`
- [R analyses](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/02_umidade_solo/codigo/analises_raiz): `02_umidade_solo/codigo/analises_raiz`
- [Sensor programs](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/02_umidade_solo/codigo/programas): `02_umidade_solo/codigo/programas`
- [Sensor alignment](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/codigo/scripts/gerar_csv_sensores_lado_a_lado.py): `02_umidade_solo/codigo/scripts/gerar_csv_sensores_lado_a_lado.py`
- [Soil results](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/02_umidade_solo/resultados): `02_umidade_solo/resultados`
- [October analysis](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/02_umidade_solo/contribuicoes/validacao_pc01_pc03_cs_20261002_a_20261007/codigo/analise_conjunta_tres_sensores.R): `02_umidade_solo/contribuicoes/validacao_pc01_pc03_cs_20261002_a_20261007/codigo/analise_conjunta_tres_sensores.R`

### 3D designs

- [3D model assets](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/03_modelos_3d): `03_modelos_3d`
- [Sonar generator](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/blob/main/03_modelos_3d/04_caixa_sonar_18650/scripts/generate_caixa_sonar.py): `03_modelos_3d/04_caixa_sonar_18650/scripts/generate_caixa_sonar.py`
- [Sonar exports](https://github.com/heitorxr/acervo-de-contribuicoes-heitor-fernandes-simepar/tree/main/03_modelos_3d/04_caixa_sonar_18650/cad_e_exportacoes): `03_modelos_3d/04_caixa_sonar_18650/cad_e_exportacoes`

### Other components

- **Researcher**
- **SIMEPAR API**

## Connections

- Researcher → Fetch SIMEPAR: runs (evidence: `01_estacao_et/codigo/scripts/baixar_dados_simepar.py`)
- Fetch SIMEPAR → SIMEPAR API: requests data (evidence: `01_estacao_et/codigo/scripts/baixar_dados_simepar.py`)
- Fetch SIMEPAR → Station data: writes CSV (evidence: `01_estacao_et/codigo/scripts/baixar_dados_simepar.py`)
- Researcher → Update PC01: runs (evidence: `02_umidade_solo/codigo/scripts/atualizar_dados_umidade.py`)
- Update PC01 → SIMEPAR API: requests data (evidence: `02_umidade_solo/codigo/scripts/atualizar_dados_umidade.py`)
- Update PC01 → Sensor inputs: updates inputs (evidence: `02_umidade_solo/codigo/scripts/atualizar_dados_umidade.py`)
- Researcher → Fetch PC03: runs (evidence: `02_umidade_solo/codigo/scripts/baixar_dados_pc03_azul.py`)
- Fetch PC03 → SIMEPAR API: requests data (evidence: `02_umidade_solo/codigo/scripts/baixar_dados_pc03_azul.py`)
- Fetch PC03 → Sensor inputs: writes inputs (evidence: `02_umidade_solo/codigo/scripts/baixar_dados_pc03_azul.py`)
- Researcher → Analysis runner: runs (evidence: `02_umidade_solo/codigo/scripts/executar_analises_umidade.py`)
- Analysis runner → R analyses: executes R (evidence: `02_umidade_solo/codigo/scripts/executar_analises_umidade.py`)
- Researcher → PC03 runner: runs (evidence: `02_umidade_solo/codigo/scripts/executar_analises_umidade_pc03_azul.py`)
- PC03 runner → Fetch PC03: runs downloader (evidence: `02_umidade_solo/codigo/scripts/executar_analises_umidade_pc03_azul.py`)
- PC03 runner → R analyses: executes R (evidence: `02_umidade_solo/codigo/scripts/executar_analises_umidade_pc03_azul.py`)
- Researcher → Joint runner: runs (evidence: `02_umidade_solo/codigo/scripts/executar_analise_conjunta_tres_sensores.py`)
- Joint runner → R analyses: executes R (evidence: `02_umidade_solo/codigo/scripts/executar_analise_conjunta_tres_sensores.py`)
- Researcher → Sensor alignment: runs (evidence: `02_umidade_solo/codigo/scripts/gerar_csv_sensores_lado_a_lado.py`)
- Sensor alignment → Sensor inputs: reads sources (evidence: `02_umidade_solo/codigo/scripts/gerar_csv_sensores_lado_a_lado.py`)
- Sensor alignment → Soil results: writes aligned CSV (evidence: `02_umidade_solo/codigo/scripts/gerar_csv_sensores_lado_a_lado.py`)
- Researcher → Sonar generator: runs (evidence: `03_modelos_3d/04_caixa_sonar_18650/scripts/generate_caixa_sonar.py`)
- Sonar generator → Sonar exports: exports geometry (evidence: `03_modelos_3d/04_caixa_sonar_18650/scripts/generate_caixa_sonar.py`)
- ET analyses → ET results: produces analyses (evidence: `README.md`)
- R analyses → Soil results: publishes aggregates (evidence: `README.md`)
- October analysis → Soil results: contributes results (evidence: `README.md`)
- Sensor programs → Sensor inputs: provides sensor data
- 3D model assets → Researcher: provides models
