DaME/README.txt at main · Blessingk-code/DaME · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
# Data-Aware Metadata Enricher — QGIS Plugin

**Data-Aware Metadata Enricher** is a QGIS plugin that automatically extracts, analyzes, and enriches geospatial metadata from vector and raster datasets. It generates structured metadata outputs (JSON / XML) suitable for data catalogs, FAIR data pipelines, spatial data infrastructures (SDIs), and STAC-based workflows.

The plugin combines geospatial intelligence with optional large language model (LLM) support to produce high-quality, human-readable dataset descriptions.

---

## Key Features

-  Automated extraction of spatial, attribute, and raster metadata
-  Accurate reprojection of spatial extents to WGS84 (EPSG:4326)
- Intelligent summarization of attribute distributions
- Optional LLM-powered field translation and description enhancement
- JSON and XML metadata export
- Fully integrated into the QGIS Processing framework
- One-click execution from the QGIS toolbar

---

## Installation

### Option 1 — From ZIP (Recommended for Development)

1. Download the plugin ZIP archive from GitHub.
2. Open QGIS → **Plugins → Manage and Install Plugins → Install from ZIP**
3. Select the downloaded ZIP file.
4. Enable **Data-Aware Metadata Enricher** from the plugin list.

---

### Option 2 — From QGIS Plugin Repository *(Coming Soon)*

Once published:


## How to Use

### Toolbar Access

Click the **Data-Aware Metadata Enricher** icon in the QGIS toolbar.

This opens the native Processing interface.

---

### Inputs

- **Vector Layer** *(optional)*
- **Raster Layer** *(optional)*
- **Metadata File** *(optional JSON or XML input)*
- **Output Metadata File** *(JSON or XML)*
- **Fields to Scan** *(vector only)*
- **Sample Size** *(default: 500)*
- **Use LLM Enhancement** *(optional)*

---

### Output

The plugin produces structured metadata including:

- Spatial extent (WGS84)
- CRS information
- Geometry type
- Feature count
- Attribute summaries
- Raster statistics (min, max, mean, stddev)
- Human-readable dataset overview
- Provenance information

---

## Example Output (JSON)

```json
{
  "layer_name": "Landcover_2020",
  "crs": "EPSG:4326",
  "spatial": {
    "xmin": 11.42,
    "ymin": 48.02,
    "xmax": 11.71,
    "ymax": 48.23
  },
  "feature_count": 124392,
  "fields_summary": {
    "class": {
      "type": "categorical",
      "unique_values": 12
    }
  },
  "descriptive_overview": "This dataset represents land cover classes derived from remote sensing imagery..."
}


##License

This project is licensed under the MIT License — see the LICENSE file for details.


##Citation

If you use this plugin in academic work, please cite:

Kavhu, B. (2026). Data-Aware Metadata Enricher: Intelligent Metadata Generation for Geospatial Data in QGIS.


##Contributing

Pull requests, feature suggestions, and collaborations are very welcome.


##Contact

Author: Blessing Kavhu
Affiliation: Senior Researcher / MML
GitHub: https://github.com/yourusername