HƯỚNG DẪN SỬ DỤNG

TopoFix

Plugin kiểm tra & sửa lỗi topology cho QGIS

Lộc Vũ Trung tổng hợp từ đam mê

1. Cài đặt và Khởi động

Yêu cầu hệ thống

QGIS >= 3.0 (khuyến nghị 3.28+)
Python 3.12 (đi kèm QGIS)
Kết nối Internet (lần đầu cài đặt dependencies)
Hệ điều hành: Windows / Linux / macOS

Cài đặt plugin

Copy thư mục 'TopoFix' vào: %APPDATA%\QGIS\QGIS3\profiles\default\python\plugins\
Khởi động QGIS
Vào Plugins > Manage and Install Plugins > Installed
Tích chọn 'TopoFix'
Icon sẽ xuất hiện trên toolbar

2. Giao diện chính

PolyFix sử dụng giao diện tiết lộ dần (progressive disclosure) — chỉ hiện thông tin cần thiết.

Trạng thái 1: Khởi động

Chỉ hiện: Chọn layer (dropdown) + nút 🔍 Scan All Errors
Bảng lỗi và tham số ẩn hoàn toàn

Trạng thái 2: Kết quả

Sau khi scan xong, chỉ hiện các loại lỗi có count > 0. Những loại = 0 được ẩn.

Cột	Widget	Chức năng
Loại lỗi	QLabel	Tên lỗi, mã màu riêng
Số lượng	QLabel	Số lỗi (đỏ, đậm)
Highlight	QPushButton	Tô sáng lỗi trên bản đồ (memory layer)
Sửa	QCheckBox	Tích để sửa loại lỗi này

Trạng thái 3: Tham số nâng cao

Panel ⚙ Advanced Parameters chỉ hiện khi có lỗi liên quan, và chỉ hiện tham số tương ứng.

Tham số	Mặc định	Ý nghĩa
Gap tolerance	0.001 ha	Gap nhỏ hơn bị bỏ qua
Sliver max area	1.0 ha	Lớn hơn không phải sliver
Sliver ratio P/√A	20.0	Ngưỡng compactness
MNO min area	0.001 m²	Chỉ cắt giao lớn hơn
Missing node tol	0.001	VN-2000: 0.001m, WGS84: 1e-8
Tiny polygon min	(tùy dữ liệu)	Nhỏ hơn thì gộp
Max vertices	500	Vượt quá là dư thừa

3. Quy trình sử dụng

Bước 1: Chuẩn bị

Mở project QGIS chứa polygon layer cần kiểm tra
Đảm bảo CRS đúng (VN-2000 hoặc WGS84)
KHUYẾN NGHỊ: Backup dữ liệu trước khi sửa

Bước 2: Scan lỗi

Mở PolyFix từ menu LVT4U → PolyFix hoặc toolbar
Chọn layer từ dropdown (click Refresh nếu cần)
Click 🔍 Scan All Errors — tự động quét 11 thuật toán
Chờ progress bar hoàn thành

Bước 3: Xem kết quả

Chỉ các loại lỗi có count > 0 được hiện ra
Nếu ✅ No errors found — layer sạch!
Click Show để tô sáng lỗi trên bản đồ (memory layer tạm)
QGIS tự zoom đến vùng lỗi, dùng Identify tool để xem chi tiết

Bước 4: Sửa lỗi

Tick checkbox Fix cho các loại lỗi muốn sửa (mặc định: tất cả)
Điều chỉnh tham số trong panel ⚙ Advanced Parameters nếu cần
Click 🔧 Fix Errors → Xác nhận
Layer ảo *_PolyFixed được tạo để review

Bước 5: Kiểm tra lại

Click 🔄 Re-Scan để quét lại (layer PolyFixed tự nạp vào dropdown)
Lặp lại cho đến khi sạch lỗi
Khi hài lòng: chuột phải layer → Export → Save Features As...

⚠ Một số lỗi có thể xuất hiện mới sau khi sửa (cascade effect).

4. Thứ tự ưu tiên sửa lỗi

Plugin tự động thực hiện đúng thứ tự này:

#	Loại lỗi	Hành động
1	Multipart	Tách trước, tăng số features
2	Invalid	Sửa cấu trúc geometry
3	Duplicate	Xóa bản trùng
4	Overlap	Cắt phần chồng đè
5	Must Not Overlap	Cắt thông minh theo diện tích
6	Gap	Lấp khoảng hở
7	Redundant	Giảm số đỉnh
8	Sliver	Loại mảnh vụn
9	Missing Node	Chèn nút thiếu
10	Tiny Polygon	Gộp polygon nhỏ

⚠ Nên sửa TẤT CẢ cùng lúc, không sửa riêng lẻ từng loại.

5. Lưu ý thực tế

Dữ liệu VN-2000

CRS: VN-2000 3-degree zone (EPSG tùy tỉnh)
Đơn vị: mét → tham số nhập trực tiếp
Missing node tolerance: 0.001 → 0.01 mét

Hiệu suất

Kích thước layer	Thời gian ước tính
< 1,000 features	Vài giây
1,000 – 10,000 features	Vài phút
> 10,000 features	10-30 phút (Missing Nodes O(n²))

6. Xử lý lỗi thường gặp

Vấn đề	Nguyên nhân	Giải pháp
Progress bar đứng 0%	Layer quá lớn	Chờ thêm hoặc chia nhỏ layer
Fix xong nhưng còn lỗi	Cascade effect	Chạy lại kiểm tra + sửa lần 2
Highlight không hiện	Layer bị ẩn	Bật visibility trong Layers panel
Missing Nodes rất chậm	O(n²) complexity	Chia layer thành vùng nhỏ hơn
Kết quả không mở được	File bị lock	Đóng file trong ứng dụng khác