# LVT4U — All-in-One QGIS Plugin for Vietnamese GIS

[![License: GPL-3.0](https://img.shields.io/badge/license-GPL--3.0-brightgreen)](LICENSE)
[![QGIS](https://img.shields.io/badge/QGIS-3.16%2B-green)](https://qgis.org)
[![Version](https://img.shields.io/badge/version-2.7.54-blue)](https://plugins.qgis.org)
[![Non-Commercial](https://img.shields.io/badge/use-non--commercial%20only-red)](https://lvtfield.lvtcenter.it.com/terms.html)

> **Purpose:** Educational, knowledge-sharing, and non-commercial GIS research.
> **Languages:** Vietnamese / English / Lao / Indonesian
> **Full Terms:** https://lvtfield.lvtcenter.it.com/terms.html

---

## Modules / Features

| # | Module | Description |
|---|--------|-------------|
| 1 | Thematic Map | Categorized/graduated forest maps by LDLR codes (TT16/TT33) |
| 2 | Lot Labels | Parcel labels for cadastral maps with TT16 symbology |
| 3 | MBTiles | Multi-layer offline tile export + Canvas-to-MBTiles |
| 4 | KML/KMZ Export | SHP to Google Earth with styled popups + scale visibility |
| 5 | KML to SHP | Reverse KML/KMZ to Shapefile with geometry type splitting |
| 6 | Excel to GIS | Import Excel/CSV spreadsheets as GIS point/polygon layers |
| 7 | Basemap | One-click Google Maps, Satellite, Hybrid, OpenStreetMap tiles |
| 8 | Font Converter | Unicode - TCVN3 - VNI conversion for MapInfo data |
| 9 | CRS Tools | VN-2000 (34 zones) coordinate transformation + batch set CRS |
| 10 | Map Layout | A5-A0 template-driven print/slide layouts with TT16 legend |
| 11 | EUDR Export | EU Deforestation Regulation 2023/1115 compliant GeoJSON |
| 12 | TopoFix | 11 topology algorithms: gaps, overlaps, duplicates, slivers |
| 13 | CAD Converter | DWG/DXF/DGN to Shapefile with VN-2000 support |
| 14 | Satellite Downloader | Sentinel-2, Landsat 8/9, SAR, MODIS imagery (free, no auth) |
| 15 | Flycam Photos | Geotagged drone photos import with EXIF/DJI XMP extraction |
| 16 | Layer Editor | Manage, rename, group, and style layers |
| 17 | Legal Documents | 26+ Vietnamese forestry and GIS regulations (offline HTML) |
| 18 | Coordinate Table | Export TT16/2025 coordinate tables (Mau 03, 04, 05) |
| 19 | Sync | LVTField mobile app to QGIS data synchronization |

---

## Installation

### Method 1: QGIS Plugin Manager (Recommended)
1. Open QGIS > Plugins > Manage and Install Plugins
2. Search for "LVT4U"
3. Click Install Plugin

### Method 2: Install from ZIP
1. Download the latest ZIP from GitHub Releases
2. Plugins > Install from ZIP > select the downloaded file

---

## Requirements

| Requirement | Version |
|-------------|---------|
| QGIS | 3.16+ (compatible up to 4.x) |
| Python | 3.9+ |
| OS | Windows / macOS / Linux |

Optional dependencies (auto-installed when needed):
- openpyxl - Excel export features
- Pillow - Photo thumbnail generation
- exifread - DJI RAW photo EXIF extraction

---

## Accuracy Notice

Each module has known accuracy limitations:

| Module | Accuracy Limit |
|--------|---------------|
| KML/KMZ Export | +/-0.1-3m depending on NTv2 datum grid |
| KML to SHP | Up to +/-1-5m without datum grid |
| Area Calculation | Reference only - use appropriate CRS |
| CRS / Coord Convert | +/-0.5-2m depending on datum and Helmert |
| CAD Converter | May lose topology, labels, blocks |

Coordinate differences between projections (VN-2000, WGS-84...) are a normal technical phenomenon.

---

## Terms of Use

NON-COMMERCIAL USE ONLY

EN: LVT4U is built for EDUCATIONAL, KNOWLEDGE-SHARING AND NON-COMMERCIAL RESEARCH purposes only.
Do NOT use outputs in paid projects, commercial contracts, or land registry dossiers.
The author disclaims all liability for commercial or out-of-scope use.

VI: Plugin LVT4U duoc xay dung voi muc dich HOC TAP, TRAO DOI KINH NGHIEM VA NGHIEN CUU PHI THUONG MAI.
Khong su dung ket qua trong du an thu phi, hop dong kinh te, hoac ho so phap ly dat dai.

Full Terms: https://lvtfield.lvtcenter.it.com/terms.html

---

## Vietnamese Standards Compliance

The author strives to follow:
- BTNMT - Ministry of Natural Resources and Environment technical standards
- Circular 25/2014/TT-BTNMT - Cadastral map standards
- Circular 16/2021/TT-BTNMT (TT16) - Large-scale topographic map symbols
- TCVN - National standards for GIS and geodesy
- VN-2000 - Vietnamese coordinate system (Decision 83/2000/QD-TTg)

Results require confirmation by competent state authorities to have legal validity.

---

## Changelog

```
2.7.54 - Fix: double-encoded UTF-8 mojibake in metadata.txt about/changelog
       - icon.png resized to 128x128 for plugin repository
       - homepage updated to lvtfield.lvtcenter.it.com

2.7.53 - Disclaimer: Full bilingual Terms of Use (VI/EN) on every version install
       - About dialog: Added Terms of Use tab with per-module accuracy table
       - Menu: Added "Terms of Use" item in Reference group

2.7.52 - KML Scale Visibility: filter features by QGIS map scale denominator
       - KML Accuracy: switched to native:reprojectlayer (eliminates 1-5m drift)

2.7.4  - CAD Converter: DWG + DXF + DGN to Shapefile with VN-2000 support
       - Supports R2000, AutoCAD 2010+, Microstation DGN v7/v8

2.7.0  - Compatibility: Full QGIS 3.16 to 4.x support (Python 3.9+)
       - WkbCompat shim for QgsWkbTypes removed in QGIS 4.x
```

---

## Companion App

LVTField - Mobile field data collection app (Android):
- Collect GIS data in the field (polygons, points, lines)
- Forest survey: OTC sample plots, tree measurement
- Sync with QGIS via LVT4U plugin
- Download: https://lvtfield.lvtcenter.it.com

---

## Author and Contact

- Author: Loc Vu Trung (Lo Vu Trung)
- Organization: LVTCenter
- Email: locvutrung@gmail.com
- Website: https://lvtfield.lvtcenter.it.com
- GitHub: https://github.com/locvutrunglvt
- YouTube: https://www.youtube.com/@locvutrung
- Issues: https://github.com/locvutrunglvt/LVT-QGIS/issues

---

## License

This project is licensed under the GNU General Public License v3.0.
See the LICENSE file for details.

Copyright (C) 2024-2025 Loc Vu Trung (LVTCenter)

NON-COMMERCIAL USE ONLY - see Terms of Use for details.

---

Built with love for the Vietnamese GIS community.
