# gmd-repository/gemma-plugin architecture

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

- Interactive diagram: https://gitdiagram.com/gmd-repository/gemma-plugin
- Repository: https://github.com/gmd-repository/gemma-plugin

## Overview

GEMMA is a QGIS plugin for PSA geospatial management and analysis. A user launches tools from the plugin menus or Processing provider; those tools check and repair boundaries, analyze and compare spatial data, manage metadata, delineate enumeration areas, or package projects for field collection. The graph emphasizes these documented workflows and the modules named by the source index. Some implementation detail is unsampled, so uncertain internal sequencing and external service links are omitted.

Main entry points: [`gmd_pipeline.py`](https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_pipeline.py) (Plugin menus), [`gmd_pipeline_provider.py`](https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_pipeline_provider.py) (Processing provider), [`references/package_qfield/gui/package_dialog.py`](https://github.com/gmd-repository/gemma-plugin/blob/dev/references/package_qfield/gui/package_dialog.py) (QField package UI), [`references/create_enumeration_area/dialog.py`](https://github.com/gmd-repository/gemma-plugin/blob/dev/references/create_enumeration_area/dialog.py) (EA workflow UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Plugin entry"]
  node_plugin["Plugin menus<br/>[gmd_pipeline.py]"]
  node_processing["Processing provider"]
end

subgraph group_gis["GIS tools"]
  node_boundary["Boundary review"]
  node_geometry["Geometry repair"]
  node_mbi["MBI analysis"]
  node_comparison["PSA-LGU review"]
  node_mapcomparison["Map comparison"]
  node_projection["Projection finder"]
  node_metadata["Metadata management<br/>[update_metadata.py]"]
  node_packcity["City/municipality export"]
end

subgraph group_ea["Enumeration areas"]
  node_ea_dialog["EA workflow UI<br/>[dialog.py]"]
  node_ea_algorithm["EA processing algorithm<br/>[algorithm.py]"]
  node_ea_preview["EA preview<br/>[preview_widget.py]"]
  node_ea_preprocess["Pre-EA processing"]
  node_ea_delineate["EA delineation"]
  node_ea_output["EA output<br/>[phase8_output.py]"]
end

subgraph group_field["Field packaging"]
  node_qfield_ui["QField package UI<br/>[package_dialog.py]"]
  node_qfield_layer["Layer packaging<br/>[layer.py]"]
  node_qfield_converter["Offline converter"]
  node_qfield_project["Project packaging<br/>[project.py]"]
  node_qfield_offliners["Offline data handlers<br/>[offliners.py]"]
  node_preferences["Packaging preferences<br/>[preferences.py]"]
end

node_user(("GIS user"))

node_user -->|"opens tools"| node_plugin
node_plugin -->|"registers provider"| node_processing
node_plugin -->|"opens review"| node_boundary
node_plugin -->|"opens panel"| node_comparison
node_plugin -->|"opens finder"| node_projection
node_plugin -->|"opens exporter"| node_packcity
node_plugin -->|"opens workflow"| node_ea_dialog
node_plugin -->|"opens packager"| node_qfield_ui
node_processing -->|"registers algorithm"| node_metadata
node_processing -->|"registers analysis"| node_mbi
node_processing -->|"registers comparison"| node_mapcomparison
node_processing -->|"registers exporter"| node_packcity
node_processing -->|"registers algorithm"| node_ea_algorithm
node_ea_dialog -->|"uses algorithm"| node_ea_algorithm
node_ea_dialog -->|"uses processor"| node_ea_preprocess
node_ea_dialog -.->|"renders preview"| node_ea_preview
node_ea_delineate -.->|"produces output"| node_ea_output
node_qfield_ui -->|"configures layers"| node_qfield_layer
node_qfield_ui -->|"runs conversion"| node_qfield_converter
node_qfield_ui -->|"uses project model"| node_qfield_project
node_qfield_ui -->|"uses offline handlers"| node_qfield_offliners
node_qfield_ui -->|"reads preferences"| node_preferences
node_qfield_converter -->|"converts layers"| node_qfield_layer
node_qfield_converter -->|"uses handlers"| node_qfield_offliners

click node_plugin "https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_pipeline.py"
click node_processing "https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_pipeline_provider.py"
click node_boundary "https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/check_and_update_dialog.py"
click node_geometry "https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/deprecated/geom_repair_toolkit.py"
click node_mbi "https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/mbi_run_analysis.py"
click node_comparison "https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/psa_lgu_comparison_panel.py"
click node_mapcomparison "https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/psa_lgu_map_comparison.py"
click node_projection "https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/projection_finder.py"
click node_metadata "https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/update_metadata.py"
click node_packcity "https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/package_layers_by_citymun.py"
click node_ea_dialog "https://github.com/gmd-repository/gemma-plugin/blob/dev/references/create_enumeration_area/dialog.py"
click node_ea_algorithm "https://github.com/gmd-repository/gemma-plugin/blob/dev/references/create_enumeration_area/algorithm.py"
click node_ea_preview "https://github.com/gmd-repository/gemma-plugin/blob/dev/references/create_enumeration_area/preview_widget.py"
click node_ea_preprocess "https://github.com/gmd-repository/gemma-plugin/blob/dev/references/create_enumeration_area/pre_ea_processor.py"
click node_ea_delineate "https://github.com/gmd-repository/gemma-plugin/blob/dev/references/create_enumeration_area/phases/phase5_delineate.py"
click node_ea_output "https://github.com/gmd-repository/gemma-plugin/blob/dev/references/create_enumeration_area/phases/phase8_output.py"
click node_qfield_ui "https://github.com/gmd-repository/gemma-plugin/blob/dev/references/package_qfield/gui/package_dialog.py"
click node_qfield_layer "https://github.com/gmd-repository/gemma-plugin/blob/dev/references/package_qfield/unzipped_whl/gemma_sync/layer.py"
click node_qfield_converter "https://github.com/gmd-repository/gemma-plugin/blob/dev/references/package_qfield/unzipped_whl/gemma_sync/offline_converter.py"
click node_qfield_project "https://github.com/gmd-repository/gemma-plugin/blob/dev/references/package_qfield/unzipped_whl/gemma_sync/project.py"
click node_qfield_offliners "https://github.com/gmd-repository/gemma-plugin/blob/dev/references/package_qfield/unzipped_whl/gemma_sync/offliners.py"
click node_preferences "https://github.com/gmd-repository/gemma-plugin/blob/dev/references/package_qfield/core/preferences.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,node_processing,node_user toneBlue
class node_boundary,node_geometry,node_mbi,node_comparison,node_mapcomparison,node_projection,node_metadata,node_packcity toneAmber
class node_ea_dialog,node_ea_algorithm,node_ea_preview,node_ea_preprocess,node_ea_delineate,node_ea_output toneMint
class node_qfield_ui,node_qfield_layer,node_qfield_converter,node_qfield_project,node_qfield_offliners,node_preferences toneRose
```

## Components

### Plugin entry

- [Plugin menus](https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_pipeline.py): `gmd_pipeline.py`
- [Processing provider](https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_pipeline_provider.py): `gmd_pipeline_provider.py`

### GIS tools

- [Boundary review](https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/check_and_update_dialog.py): `gmd_scripts/check_and_update_dialog.py`
- [Geometry repair](https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/deprecated/geom_repair_toolkit.py): `gmd_scripts/deprecated/geom_repair_toolkit.py`
- [MBI analysis](https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/mbi_run_analysis.py): `gmd_scripts/mbi_run_analysis.py`
- [PSA-LGU review](https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/psa_lgu_comparison_panel.py): `gmd_scripts/psa_lgu_comparison_panel.py`
- [Map comparison](https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/psa_lgu_map_comparison.py): `gmd_scripts/psa_lgu_map_comparison.py`
- [Projection finder](https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/projection_finder.py): `gmd_scripts/projection_finder.py`
- [Metadata management](https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/update_metadata.py): `gmd_scripts/update_metadata.py`
- [City/municipality export](https://github.com/gmd-repository/gemma-plugin/blob/dev/gmd_scripts/package_layers_by_citymun.py): `gmd_scripts/package_layers_by_citymun.py`

### Enumeration areas

- [EA workflow UI](https://github.com/gmd-repository/gemma-plugin/blob/dev/references/create_enumeration_area/dialog.py): `references/create_enumeration_area/dialog.py`
- [EA processing algorithm](https://github.com/gmd-repository/gemma-plugin/blob/dev/references/create_enumeration_area/algorithm.py): `references/create_enumeration_area/algorithm.py`
- [EA preview](https://github.com/gmd-repository/gemma-plugin/blob/dev/references/create_enumeration_area/preview_widget.py): `references/create_enumeration_area/preview_widget.py`
- [Pre-EA processing](https://github.com/gmd-repository/gemma-plugin/blob/dev/references/create_enumeration_area/pre_ea_processor.py): `references/create_enumeration_area/pre_ea_processor.py`
- [EA delineation](https://github.com/gmd-repository/gemma-plugin/blob/dev/references/create_enumeration_area/phases/phase5_delineate.py): `references/create_enumeration_area/phases/phase5_delineate.py`
- [EA output](https://github.com/gmd-repository/gemma-plugin/blob/dev/references/create_enumeration_area/phases/phase8_output.py): `references/create_enumeration_area/phases/phase8_output.py`

### Field packaging

- [QField package UI](https://github.com/gmd-repository/gemma-plugin/blob/dev/references/package_qfield/gui/package_dialog.py): `references/package_qfield/gui/package_dialog.py`
- [Layer packaging](https://github.com/gmd-repository/gemma-plugin/blob/dev/references/package_qfield/unzipped_whl/gemma_sync/layer.py): `references/package_qfield/unzipped_whl/gemma_sync/layer.py`
- [Offline converter](https://github.com/gmd-repository/gemma-plugin/blob/dev/references/package_qfield/unzipped_whl/gemma_sync/offline_converter.py): `references/package_qfield/unzipped_whl/gemma_sync/offline_converter.py`
- [Project packaging](https://github.com/gmd-repository/gemma-plugin/blob/dev/references/package_qfield/unzipped_whl/gemma_sync/project.py): `references/package_qfield/unzipped_whl/gemma_sync/project.py`
- [Offline data handlers](https://github.com/gmd-repository/gemma-plugin/blob/dev/references/package_qfield/unzipped_whl/gemma_sync/offliners.py): `references/package_qfield/unzipped_whl/gemma_sync/offliners.py`
- [Packaging preferences](https://github.com/gmd-repository/gemma-plugin/blob/dev/references/package_qfield/core/preferences.py): `references/package_qfield/core/preferences.py`

### Other components

- **GIS user**

## Connections

- GIS user → Plugin menus: opens tools (evidence: `gmd_pipeline.py`)
- Plugin menus → Processing provider: registers provider (evidence: `gmd_pipeline.py`)
- Plugin menus → Boundary review: opens review (evidence: `gmd_pipeline.py`)
- Plugin menus → PSA-LGU review: opens panel (evidence: `gmd_pipeline.py`)
- Plugin menus → Projection finder: opens finder (evidence: `gmd_pipeline.py`)
- Plugin menus → City/municipality export: opens exporter (evidence: `gmd_pipeline.py`)
- Plugin menus → EA workflow UI: opens workflow (evidence: `gmd_pipeline.py`)
- Plugin menus → QField package UI: opens packager (evidence: `gmd_pipeline.py`)
- Processing provider → Metadata management: registers algorithm (evidence: `gmd_pipeline_provider.py`)
- Processing provider → MBI analysis: registers analysis (evidence: `gmd_pipeline_provider.py`)
- Processing provider → Map comparison: registers comparison (evidence: `gmd_pipeline_provider.py`)
- Processing provider → City/municipality export: registers exporter (evidence: `gmd_pipeline_provider.py`)
- Processing provider → EA processing algorithm: registers algorithm (evidence: `gmd_pipeline_provider.py`)
- EA workflow UI → EA processing algorithm: uses algorithm (evidence: `references/create_enumeration_area/dialog.py`)
- EA workflow UI → Pre-EA processing: uses processor (evidence: `references/create_enumeration_area/dialog.py`)
- EA workflow UI → EA preview: renders preview
- EA delineation → EA output: produces output
- QField package UI → Layer packaging: configures layers (evidence: `references/package_qfield/gui/package_dialog.py`)
- QField package UI → Offline converter: runs conversion (evidence: `references/package_qfield/gui/package_dialog.py`)
- QField package UI → Project packaging: uses project model (evidence: `references/package_qfield/gui/package_dialog.py`)
- QField package UI → Offline data handlers: uses offline handlers (evidence: `references/package_qfield/gui/package_dialog.py`)
- QField package UI → Packaging preferences: reads preferences (evidence: `references/package_qfield/gui/package_dialog.py`)
- Offline converter → Layer packaging: converts layers (evidence: `references/package_qfield/unzipped_whl/gemma_sync/offline_converter.py`)
- Offline converter → Offline data handlers: uses handlers (evidence: `references/package_qfield/unzipped_whl/gemma_sync/offline_converter.py`)
