# mizuki011124/txt_2_tif_dem_builder architecture

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

- Interactive diagram: https://gitdiagram.com/mizuki011124/txt_2_tif_dem_builder
- Repository: https://github.com/mizuki011124/txt_2_tif_dem_builder

## Overview

This QGIS plugin turns user-selected TXT/CSV elevation data into GeoTIFF rasters. The principal workflow starts at the toolbar, opens a parameter dialog, then converts either one file or a folder of files; folder processing can also merge outputs, and generated rasters may be added to the QGIS project. The dialog excerpt shows these calls and output actions, but not all conversion and merge internals, so those are represented only at the supported subsystem level.

Main entry points: [`txt_2_tif_dem_builder_dialog.py`](https://github.com/mizuki011124/txt_2_tif_dem_builder/blob/main/txt_2_tif_dem_builder_dialog.py) (Parameter Dialog), [`txt_2_tif_dem_builder.py`](https://github.com/mizuki011124/txt_2_tif_dem_builder/blob/main/txt_2_tif_dem_builder.py) (Plugin Entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["Plugin Interface"]
  node_plugin_entry["Plugin Entry"]
  node_dialog["Parameter Dialog"]
end

subgraph group_processing["DEM Processing"]
  node_input_data["TXT/CSV Input"]
  node_single_convert["Single Conversion"]
  node_folder_process["Folder Processing"]
  node_raster_write["Raster Creation"]
  node_merge["TIFF Merge"]
end

subgraph group_outputs["Raster Outputs"]
  node_geotiff["GeoTIFF Output"]
  node_qgis_project["QGIS Project"]
end

node_user(("QGIS User"))

node_user -->|"launches toolbar"| node_plugin_entry
node_plugin_entry -->|"opens dialog"| node_dialog
node_dialog -->|"runs single input"| node_single_convert
node_dialog -->|"runs folder input"| node_folder_process
node_folder_process -->|"scans folder"| node_input_data
node_single_convert -->|"reads selected file"| node_input_data
node_single_convert -->|"calls conversion"| node_raster_write
node_folder_process -->|"converts each file"| node_raster_write
node_raster_write -->|"writes raster"| node_geotiff
node_folder_process -->|"calls merge"| node_merge
node_merge -->|"writes merged raster"| node_geotiff
node_dialog -->|"adds raster layers"| node_qgis_project

click node_plugin_entry "https://github.com/mizuki011124/txt_2_tif_dem_builder/blob/main/txt_2_tif_dem_builder.py"
click node_dialog "https://github.com/mizuki011124/txt_2_tif_dem_builder/blob/main/txt_2_tif_dem_builder_dialog.py"
click node_single_convert "https://github.com/mizuki011124/txt_2_tif_dem_builder/blob/main/txt_2_tif_dem_builder_dialog.py"
click node_folder_process "https://github.com/mizuki011124/txt_2_tif_dem_builder/blob/main/txt_2_tif_dem_builder_dialog.py"
click node_raster_write "https://github.com/mizuki011124/txt_2_tif_dem_builder/blob/main/txt_2_tif_dem_builder_dialog.py"
click node_merge "https://github.com/mizuki011124/txt_2_tif_dem_builder/blob/main/txt_2_tif_dem_builder_dialog.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_plugin_entry,node_dialog,node_user toneBlue
class node_input_data,node_single_convert,node_folder_process,node_raster_write,node_merge toneAmber
class node_geotiff,node_qgis_project toneMint
```

## Components

### Plugin Interface

- [Plugin Entry](https://github.com/mizuki011124/txt_2_tif_dem_builder/blob/main/txt_2_tif_dem_builder.py): `txt_2_tif_dem_builder.py`
- [Parameter Dialog](https://github.com/mizuki011124/txt_2_tif_dem_builder/blob/main/txt_2_tif_dem_builder_dialog.py): `txt_2_tif_dem_builder_dialog.py`

### DEM Processing

- **TXT/CSV Input**
- [Single Conversion](https://github.com/mizuki011124/txt_2_tif_dem_builder/blob/main/txt_2_tif_dem_builder_dialog.py): `txt_2_tif_dem_builder_dialog.py`
- [Folder Processing](https://github.com/mizuki011124/txt_2_tif_dem_builder/blob/main/txt_2_tif_dem_builder_dialog.py): `txt_2_tif_dem_builder_dialog.py`
- [Raster Creation](https://github.com/mizuki011124/txt_2_tif_dem_builder/blob/main/txt_2_tif_dem_builder_dialog.py): `txt_2_tif_dem_builder_dialog.py`
- [TIFF Merge](https://github.com/mizuki011124/txt_2_tif_dem_builder/blob/main/txt_2_tif_dem_builder_dialog.py): `txt_2_tif_dem_builder_dialog.py`

### Raster Outputs

- **GeoTIFF Output**
- **QGIS Project**

### Other components

- **QGIS User**

## Connections

- QGIS User → Plugin Entry: launches toolbar (evidence: `README.md`)
- Plugin Entry → Parameter Dialog: opens dialog (evidence: `txt_2_tif_dem_builder.py`)
- Parameter Dialog → Single Conversion: runs single input (evidence: `txt_2_tif_dem_builder_dialog.py`)
- Parameter Dialog → Folder Processing: runs folder input (evidence: `txt_2_tif_dem_builder_dialog.py`)
- Folder Processing → TXT/CSV Input: scans folder (evidence: `txt_2_tif_dem_builder_dialog.py`)
- Single Conversion → TXT/CSV Input: reads selected file (evidence: `txt_2_tif_dem_builder_dialog.py`)
- Single Conversion → Raster Creation: calls conversion (evidence: `txt_2_tif_dem_builder_dialog.py`)
- Folder Processing → Raster Creation: converts each file (evidence: `txt_2_tif_dem_builder_dialog.py`)
- Raster Creation → GeoTIFF Output: writes raster (evidence: `txt_2_tif_dem_builder_dialog.py`)
- Folder Processing → TIFF Merge: calls merge (evidence: `txt_2_tif_dem_builder_dialog.py`)
- TIFF Merge → GeoTIFF Output: writes merged raster (evidence: `txt_2_tif_dem_builder_dialog.py`)
- Parameter Dialog → QGIS Project: adds raster layers (evidence: `txt_2_tif_dem_builder_dialog.py`)
