# beegroup-cimne/hypercadaster_es architecture

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

- Interactive diagram: https://gitdiagram.com/beegroup-cimne/hypercadaster_es
- Repository: https://github.com/beegroup-cimne/hypercadaster_es

## Overview

hypercadaster_ES is a Spanish cadastral-data analysis library. Its principal workflow downloads source datasets, merges them into building-level records, enriches and analyzes those records, and persists results in DuckDB; users can then query results or generate EnergyPlus models and scenario reports. The graph preserves documented socioeconomic, weather, topology, and interoperability capabilities. Some module relationships are supported only by the source index or README, so unsampled implementation details and uncertain call paths are not expanded.

Main entry points: [`hypercadaster_ES/functions.py`](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/functions.py) (Download and merge), [`hypercadaster_ES/mergers.py`](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/mergers.py) (Cadastral integration), [`hypercadaster_ES/energy.py`](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/energy.py) (EnergyPlus model generation), [`hypercadaster_ES/_db.py`](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/_db.py) (Results database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_acquisition["Data acquisition"]
  node_entrypoints["Download and merge<br/>[functions.py]"]
  node_downloaders["Source downloaders<br/>[downloaders.py]"]
  node_interoperability["Data interoperability"]
  node_merge["Cadastral integration<br/>[mergers.py]"]
end

subgraph group_analysis["Building analysis"]
  node_social["Socioeconomic enrichment<br/>[social.py]"]
  node_weather["Weather enrichment<br/>[weather.py]"]
  node_inference["Building inference"]
  node_topology["Space topology<br/>[topology.py]"]
  node_utils["Geometry and analysis utilities<br/>[utils.py]"]
end

subgraph group_simulation["Energy simulation"]
  node_energy["EnergyPlus model generation<br/>[energy.py]"]
  node_reporting["Scenario reporting<br/>[reporting.py]"]
end

subgraph group_storage["Persistence and access"]
  node_database[("Results database<br/>[_db.py]")]
  node_results["Building results"]
  node_pretty["Readable containers<br/>[_pretty.py]"]
end

node_user(("Analyst"))

node_user -->|"selects area"| node_entrypoints
node_entrypoints -->|"downloads sources"| node_downloaders
node_entrypoints -->|"runs merge"| node_merge
node_merge -->|"persists results"| node_database
node_merge -->|"uses inference"| node_inference
node_merge -->|"adds indicators"| node_social
node_entrypoints -->|"enables enrichment"| node_social
node_entrypoints -->|"enables enrichment"| node_weather
node_inference -->|"uses utilities"| node_utils
node_inference -->|"stores inference"| node_database
node_energy -->|"builds adjacency"| node_topology
node_energy -->|"uses weather data"| node_weather
node_energy -->|"uses social data"| node_social
node_reporting -->|"summarizes scenarios"| node_energy
node_user -->|"queries results"| node_database
node_database -->|"persists tables"| node_results
node_user -->|"requests model"| node_energy
node_user -.->|"uses exports"| node_interoperability
node_utils -->|"uses helpers"| node_downloaders
node_merge -->|"uses persistence"| node_database

click node_entrypoints "https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/functions.py"
click node_downloaders "https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/downloaders.py"
click node_interoperability "https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/interoperability.py"
click node_merge "https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/mergers.py"
click node_social "https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/social.py"
click node_weather "https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/weather.py"
click node_inference "https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/building_inference.py"
click node_topology "https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/topology.py"
click node_utils "https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/utils.py"
click node_energy "https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/energy.py"
click node_reporting "https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/reporting.py"
click node_database "https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/_db.py"
click node_pretty "https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/_pretty.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_entrypoints,node_downloaders,node_interoperability,node_merge toneBlue
class node_social,node_weather,node_inference,node_topology,node_utils toneAmber
class node_energy,node_reporting toneMint
class node_database,node_results,node_pretty toneRose
class node_user toneIndigo
```

## Components

### Data acquisition

- [Download and merge](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/functions.py): `hypercadaster_ES/functions.py`
- [Source downloaders](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/downloaders.py): `hypercadaster_ES/downloaders.py`
- [Data interoperability](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/interoperability.py): `hypercadaster_ES/interoperability.py`
- [Cadastral integration](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/mergers.py): `hypercadaster_ES/mergers.py`

### Building analysis

- [Socioeconomic enrichment](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/social.py): `hypercadaster_ES/social.py`
- [Weather enrichment](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/weather.py): `hypercadaster_ES/weather.py`
- [Building inference](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/building_inference.py): `hypercadaster_ES/building_inference.py`
- [Space topology](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/topology.py): `hypercadaster_ES/topology.py`
- [Geometry and analysis utilities](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/utils.py): `hypercadaster_ES/utils.py`

### Energy simulation

- [EnergyPlus model generation](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/energy.py): `hypercadaster_ES/energy.py`
- [Scenario reporting](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/reporting.py): `hypercadaster_ES/reporting.py`

### Persistence and access

- [Results database](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/_db.py): `hypercadaster_ES/_db.py`
- **Building results**
- [Readable containers](https://github.com/beegroup-cimne/hypercadaster_es/blob/main/hypercadaster_ES/_pretty.py): `hypercadaster_ES/_pretty.py`

### Other components

- **Analyst**

## Connections

- Analyst → Download and merge: selects area (evidence: `README.md`)
- Download and merge → Source downloaders: downloads sources (evidence: `hypercadaster_ES/functions.py`)
- Download and merge → Cadastral integration: runs merge (evidence: `README.md`)
- Cadastral integration → Results database: persists results (evidence: `README.md`)
- Cadastral integration → Building inference: uses inference (evidence: `hypercadaster_ES/mergers.py`)
- Cadastral integration → Socioeconomic enrichment: adds indicators (evidence: `hypercadaster_ES/mergers.py`)
- Download and merge → Socioeconomic enrichment: enables enrichment (evidence: `hypercadaster_ES/functions.py`)
- Download and merge → Weather enrichment: enables enrichment (evidence: `hypercadaster_ES/functions.py`)
- Building inference → Geometry and analysis utilities: uses utilities (evidence: `hypercadaster_ES/building_inference.py`)
- Building inference → Results database: stores inference (evidence: `hypercadaster_ES/building_inference.py`)
- EnergyPlus model generation → Space topology: builds adjacency (evidence: `hypercadaster_ES/energy.py`)
- EnergyPlus model generation → Weather enrichment: uses weather data (evidence: `hypercadaster_ES/energy.py`)
- EnergyPlus model generation → Socioeconomic enrichment: uses social data (evidence: `hypercadaster_ES/energy.py`)
- Scenario reporting → EnergyPlus model generation: summarizes scenarios (evidence: `hypercadaster_ES/reporting.py`)
- Analyst → Results database: queries results (evidence: `README.md`)
- Results database → Building results: persists tables (evidence: `README.md`)
- Analyst → EnergyPlus model generation: requests model (evidence: `README.md`)
- Analyst → Data interoperability: uses exports
- Geometry and analysis utilities → Source downloaders: uses helpers (evidence: `hypercadaster_ES/utils.py`)
- Cadastral integration → Results database: uses persistence (evidence: `hypercadaster_ES/mergers.py`)
