BAB 1: Satu Tombol untuk Satu Pekerjaan: Plugin dan Alat Kustom

#Bagian A: QGIS

#Bagian A: Plugin Ringkas KPH di QGIS

Berkas lengkap ada di skrip/plugin_ringkas_kph/. Berikut cara kerjanya.

1. Buka berkas metadata.txt. Bagian pentingnya:

[general]
name=Ringkas KPH
qgisMinimumVersion=3.34
qgisMaximumVersion=4.99
description=Menampilkan jumlah objek dan luas total layer aktif.
version=0.1.0
author=Badar Mubarok Yogaswara
email=badarmubarok@gmail.com
repository=https://example.org/ringkas-kph

Alamat example.org adalah alamat contoh, bukan repositori nyata. Bidang about juga wajib dan ada di berkas lengkap. Baris qgisMaximumVersion=4.99 menandai plugin cocok untuk QGIS 4. Penanda lama supportsQt6 sudah tidak dipakai (dokumentasi plugin QGIS tentang migrasi ke QGIS 4).

1. Buka __init__.py. Isinya hanya satu fungsi:

def classFactory(iface):
    from .ringkas_kph import RingkasKPH
    return RingkasKPH(iface)

1. Buka ringkas_kph.py. Pekerjaan hitung dipisah dari urusan tombol supaya mudah diuji:

def ringkas_layer(layer):
    da = QgsDistanceArea()
    da.setSourceCrs(layer.crs(), QgsCoordinateTransformContext())
    da.setEllipsoid("WGS84")
    jumlah = 0
    luas_m2 = 0.0
    for f in layer.getFeatures():
        jumlah += 1
        if layer.geometryType() == QgsWkbTypes.GeometryType.PolygonGeometry:
            luas_m2 += da.measureArea(f.geometry())
    return jumlah, luas_m2 / 10000.0

1. Di kelas yang sama, initGui membuat tombol dan unload membersihkannya:

def initGui(self):
    ikon = os.path.join(os.path.dirname(__file__), "icon.png")
    self.action = QAction(QIcon(ikon), "Ringkas layer aktif", self.iface.mainWindow())
    self.action.triggered.connect(self.run)
    self.iface.addPluginToMenu("&Ringkas KPH", self.action)
    self.iface.addToolBarIcon(self.action)

def unload(self):
    self.iface.removePluginMenu("&Ringkas KPH", self.action)
    self.iface.removeToolBarIcon(self.action)
    self.action = None

1. Pasang plugin: salin folder plugin_ringkas_kph ke folder plugin profil QGIS Anda. Di Windows, jalurnya %APPDATA%\QGIS\QGIS4\profiles\default\python\plugins. Jalur ini dicek penulis di komputer yang memakai QGIS 4.0.2.
2. Buka Plugins ► Manage and Install Plugins, tab Installed, lalu centang Ringkas KPH. [CEK]
3. Muat Petak_KPH.gpkg dari paket-m4, klik layernya, lalu pilih Plugins ► Ringkas KPH ► Ringkas layer aktif. Bilah pesan menampilkan: Petak_KPH: 16 objek, luas 16.00 ha.

Hasilnya: satu klik menggantikan skrip yang dulu ditempel manual.

#Alat bantu pengembang

Dua plugin bantu dikenal luas: Plugin Builder (membuat kerangka plugin) dan Plugin Reloader (memuat ulang plugin tanpa menutup QGIS). Keduanya dipasang dari Plugin Manager. [CEK: tidak dipasang penulis]

#Bagian B: ArcGIS Pro

#Bagian B: ArcGIS Pro

ArcGIS Pro membagi "alat kustom" menjadi dua jalur. Jangan tertukar.

• Alat geoprocessing (muncul di panel Geoprocessing): ditulis dengan Python, lewat Python toolbox (.pyt) atau script tool. Ini padanan terdekat dengan Processing script (Bab 2).
• Menu dan tombol di aplikasi (padanan plugin): hanya lewat add-in yang ditulis dengan ArcGIS Pro SDK untuk .NET dan Visual Studio. Pro tidak punya add-in Python. [CEK: dari dokumentasi pengembang Esri; tidak dicoba]

Untuk pekerjaan "hitung objek dan luas", Python toolbox sudah cukup. Sebuah berkas .pyt memuat kelas Toolbox dan kelas alat. Kelas alat minimal punya __init__ dan execute; getParameterInfo mengatur parameter (dokumentasi Esri tentang templat Python toolbox).

import arcpy


class Toolbox:
    def __init__(self):
        self.label = "Alat KPH"
        self.alias = "alatkph"
        self.tools = [RingkasLayer]


class RingkasLayer:
    def __init__(self):
        self.label = "Ringkas layer"
        self.description = "Jumlah objek dan luas total (hektare)."

    def getParameterInfo(self):
        p = arcpy.Parameter(displayName="Layer poligon", name="layer",
                            datatype="GPFeatureLayer", parameterType="Required", direction="Input")
        return [p]

    def execute(self, parameters, messages):
        jumlah, luas = 0, 0.0
        with arcpy.da.SearchCursor(parameters[0].valueAsText, ["SHAPE@AREA"]) as kursor:
            for baris in kursor:
                jumlah += 1
                luas += baris[0]
        messages.addMessage("%d objek, luas %.2f satuan peta persegi" % (jumlah, luas))

1. Simpan kode di berkas ringkas.pyt. [CEK: cocokkan dengan ArcGIS Pro Anda]
2. Di panel Catalog, sambungkan folder berisi ringkas.pyt, lalu buka alat Ringkas layer.
3. Pilih layer petak, jalankan. Pesan hasil muncul di panel pesan alat.

#Bagian C: ArcMap 10.8

#Bagian C: ArcMap 10.8

ArcMap punya dua jalur yang mirip, dan satu kelebihan: add-in Python.

• Python add-in: dibuat dengan Python Add-In Wizard yang menghasilkan berkas config.xml untuk tombol, menu, dan alat. Ini padanan terdekat dengan plugin QGIS. [CEK: dari dokumentasi Esri]
• Python toolbox dan script tool: sama seperti di Pro, untuk alat geoprocessing. [CEK]

Hati-hati: ArcMap 10.8 memakai Python 2.7, sedangkan QGIS 4 dan ArcGIS Pro memakai Python 3. Kode di Bagian B perlu diperiksa ulang untuk Python 2.7 sebelum dipakai di ArcMap. [CEK]

1. Buka Python Add-In Wizard, pilih produk ArcMap, lalu isi nama dan penulis. [CEK]
2. Tambah satu Button di wizard, lalu simpan.
3. Isi kode tombol di berkas Python yang dihasilkan wizard, lalu bungkus menjadi berkas add-in. [CEK]