Sistem Kata kunci

Dokumentasi ini menjelaskan tujuan dan penggunaan sistem kata kunci InaSAFE

Tujuan

Sistem kata kunci digunakan oleh impact_functions untuk menentukan sifat input layer yang telah diberikan untuk mereka.

Setiap pemasukan set data SIG yang digunakan InaSAFE memerlukan sebuah file kata kunci yang terlampir. Tujuan dari file kata kunci ini adalah untuk menyediakan metadata tambahan yang dibutuhkan oleh fungsi dampak. Sebagai contoh, file kata kunci akan mengindikasikan apakah sebuah dataset harus diperlakukan sebagai sebuah ancaman atau sebuah layer dampak. File kata kunci ini juga digunakan untuk mengindikasikan konteks dari layer (misalnya “ini adalah layer banjir, ini adalah layer gempa bumi”).

Berdasarkan konvensi dan ekspektasi, file kata kunci ini harus dinamakan dengan nama dasar yang sama sesuai dengan sumber data SIG yang menyertainya. Sebagai contoh sebuah dataset banjir disimpan sebagai:

C:\gisdata\flood.tif

Akan membutuhkan sebuah file kata kunci yang disimpan sebagai:

C:\gisdata\flood.keywords

Note

Kami merekomendasikan untuk menghindari menggunakan spasi pada nama file dan lokasi file Anda!

Plugin InaSAFE di QGIS menyediakan sebuah editor untuk kata kunci ini. Tujuan dari dokumen ini adalah untuk mendeskripsikan editor kata kunci dan untuk menyediakan panduan penggunaan kata kunci tersebut.

Note

Saat ini kata kunci tidak tervalidasi oleh pustaka. Ini artinya sebagai contoh jika Anda salah mengeja sebuah kata kunci, menggunakan jenis huruf yang salah (misal huruf besar daripada huruf kecil) atau memberikan kata kunci yang salah untuk konteks (misalnya memberikan sub-kategori banjir pada sebuah kategori keterpaparan), sistem tidak dapat menerjemahkan apa yang akan dilakukan oleh file tersebut. Karena alasan inilah Anda diharuskan mengikuti panduan di bawah ini secara cermat untuk meyakinkan bahwa Anda telah memasukan kata kunci secara benar.

Pedoman

Pada bagian ini kami menyusun panduan untuk penggunaan kata kunci.

Kategori

Setiap dataset seharusnya memiliki sebuah kategori yang telah ditentukan. Kategori ini harus tertulis dalam huruf kecil.

Kunci Nilai yang diperbolehkan
kategori ancaman
kategori keterpaparan

Contoh pemasukan file kata kunci:

category: hazard

Subkategori

Pemilihan dari sebuah nilai subkategori tergantung dari kategori:

Subkategori yang berlaku untuk kategori ‘ancaman’:

Kunci Nilai yang diperbolehkan
Subkategori tsunami
Subkategori banjir
Subkategori tephra (abu vulkanik)

Dimana tephra merupakan bentuk lontaran dari abu vulkanik.

Subkategori yang berlaku untuk kategori ‘keterpaparan’:

Kunci Nilai yang diperbolehkan
keterpaparan populasi
keterpaparan bangunan

Contoh pemasukan file kata kunci:

category: hazard
subcategory: flood

unit/ satuan

Kata kunci untuk unit/ satuan hanya berlaku pada konteks layer ‘ancaman’, dan digunakan untuk mengindikasikan satuan metrik atau imperial yang digambarkan oleh sentitas setiap data (satu sel kotak atau satu fitur vektor) pada layer ancaman. Contoh pemasukan file kata kunci:

category: hazard
subcategory: flood
units: m

Pada kasus di atas terdapat kendala halus untuk menggunakan nilai satuan m, kaki atau basah/kering sebagaimana yang didefinisikan oleh tabel di bawah ini karena subkategori ‘banjir’. Berikut ini adalah satuan yang diperbolehkan tergantung pada subkategori yang telah ditetapkan.

Subkategori yang berlaku untuk subkategori ‘tsunami’ atau subkategori ‘banjir’:

Kunci Nilai yang diperbolehkan
unit/ satuan m
unit/ satuan basah/ kering
unit/ satuan kaki

Pada kasus dimana dalam satuan m (meter) atau kaki, pemasukan dataset diharuskan berupa sebuah layer raster dimana setiap sel menggambarkan satu nilai kedalaman berdasarkan satuan yang telah ditentukan.

Pada kasus basah/ kering, pemasukan dataset diharuskan berupa sebuah layer vektor poligon. Area apa pun yang terdapat dalam poligon ini dianggap ‘basah’ dan area diluar poligon dianggap ‘kering’.

Subkategori yang berlaku untuk subkategori ‘gunung berapi’

Kunci Nilai yang diperbolehkan
unit/ satuan kg2/m2

Pada kasus ini, dataset diharuskan berupa sebuah layer raster dimana setiap sel menggambarkan sebuah nilai dalam kilogram per meter persegi dari abu yang berada pada sel tersebut.

Note

‘satuan’ dan ‘tipe data’ (dideskripsikan di bawah) harus dianggap saling eksklusif - misalnya keduanya tidak harus ada pada setiap file kata kunci yang diberikan.

jenis data

Kata kunci untuk jenis data ditentukan untuk layer keterpaparan dan menggambarkan jenis data penduduk, infrastruktur, dan sebagainya dalam lingkup area yang diberikan.

Kepadatan yang berlaku untuk sub-kategori yang berbeda

Subkategori Kunci Nilai yang diperbolehkan
populasi jenis data jumlah
populasi jenis data kepadatan
bangunan jenis data osm
bangunan jenis data sigab
bangunan jenis data lainnya

Anggapan

Berikut ini asumsi yang dibuat mengenai kata kunci, yang mungkin atau tidak mungkin untuk pemrograman yang diterapkan oleh InaSAFE library dan GUI:

  • Seharusnya hanya ada satu kata kunci untuk kunci tertentu dalam file kata kunci
  • Beralih dari ancaman ke keterpaparan akan menghapus bagian dari GUI karena pada umumnya sebagian besar kata kunci tergantung pada kategorinya. Secara khusus, pemilihan ‘ancaman’ akan menghapus ‘datatype’ pasangan kunci/ nilai, dan pemilihan ‘keterpaparan’ akan menghapus ‘unit’ pasangan kunci nilai.
  • Kata kunci untuk kategori yang ditegakkan menjadi salah satu ‘hazard’ atau ‘exposure’ oleh GUI.
  • Semua kata kunci harus dalam huruf kecil, tanpa spasi dengan pengecualian ‘Judul’ yang nilainya mungkin mengandung spasi dan huruf campuran.
  • Nilai-nilai untuk kata kunci harus pada umunya ditulis menggunakan huruf kecil dengan pengecualian untuk tipe data, nilai-nilainya mungkin huruf besar (contoh : MMI)
  • Kunci dan nilai harus tidak mengandung tanda titik dua. Di dalam editor kata kunci, setiap tanda titik dua akan diganti dengan karakter berhenti penuh.
  • Semua kata kunci dan nilai yang tidak sesuai dengan daftar domain di atas dapat digunakan, tetapi mereka dapat menghasilkan hasil yang tidak diinginkan.

Translations

Although InaSAFE is available in different languages, the ‘key’ in the keywords files should always be written in english.

Editor kata kunci (keyword) di layar pengguna

User interface grafis untuk mengedit kata kunci (keyword) dibagi menjadi dua bagian:

  1. Mode Minimum: Pada mode ini, hanya mengikuti pengaturan yang disediakan:
    • Judul - nama ‘friendly’ untuk dataset yang akan ditampilkan dalam laporan, di layar pengguna, dan sebagainya.
    • Kategori - Pilihan wajib antara ‘hazard’ dan ‘exposure’.
    • Subkategori - Subkategori/ unit picklist gabungan (dalam kasus ancaman bencana) atau subkategori/ jenis data gabungan (dalam kasus keterpaparan). Dalam kasus ini, karakteristik sekunder (unit atau jenis data) akan ditampilkan dalam tanda kurung siku setelah nama subkategori misalnya: flood [m] digunakan untuk subkategori ‘flood’, satuan ‘m’.

Contoh mengedit kata kunci dalam mode minimal ditunjukkan di bawah ini.

Opened keyword editor window

Jendela editor kata kunci yang dibuka

  1. Mode lanjutan: Dalam mode ini disediakan beberapa pilihan sebagai tambahan untuk pilihan mode minimal. Tidak seperti mode minimal, pada mode lanjutan hanya validasi dasar yang dilakukan dan pengguna diberikan lebih banyak fleksibilitas untuk mendefinisikan dan menghapus pasangan kunci/ nilai secara manual. Tiga bagian yang disediakan untuk ini:
  • Predefined - Pada bagian ini, pengguna memilih dari daftar terkendala kata kunci, memasukkan nilai bentuk bebas dan kemudian menambahkan kunci/nilai pasangan ke daftar kata kunci (lihat dibawah).
  • User defined - Pada bagian ini, tidak ada kendala pada kata kunci yang dimasukkan - setiap kata dalam huruf kecil akan diterima untuk kedua komponen baik kunci dan nilai.
  • Current keywords - Di tempat ini telah ditampilkan daftar semua kata kunci lengkap untuk dataset. Daftar kata kunci di sini telah diperbarui seketika setiap terjadi perubahan yang dibuat dalam mode editor sederhana dan canggih. Juga sangat memungkinkan pada tempat ini untuk menghapus kata kunci yang tidak diinginkan dengan menggunakan tombol ‘remove selected’. Beberapa kata kunci dapat dihapus dalam satu operasi dengan Control-clicking pada kata kunci yang telah dimasukkan dalam daftar kata kunci saat ini dan kemudian klik Remove selected
Advanced mode of keyword editor

Mode Editor kata kunci tingkat lanjut

Membuka editor kata kunci (keyword editor)

Editor kata kunci (keyword) dapat dengan mudah dipanggil dengan memilih setiap layer di daftar layer QGIS, dan kemudian menggunakan menu plugin untuk memulai mengedit (Plugins ‣ InaSAFE ‣ Keyword Editor). Atau Anda mungkin menggunakan simbol editor kata kunci (keyword) di dalam toolbar plugin seperti diilustrasikan di bawah.

Keyword editor icon

Ikon editor kata kunci

Note

Jika anda belum memilih layer di legenda QGIS, ikon editor kata kunci di toolbar dan menu akan dimatikan dan bewarna abu-abu.

Menyimpan hasil editan Anda

Untuk menyimpan hasil pengeditan kata kunci (keyword) yang Anda buat, tekan tombol OK dan file kata kunci akan ditulis ke tempat penyimpanan yang tersedia.

Membatalkan hasil editan Anda

Anda dapat membatalkan perubahan Anda kapan saja dengan menekan tombol Cancel . Tidak ada perubahan yang akan ditulis ke tempat penyimpanan dan file *.keywords kata kunci Anda akan tetap dalam keadaan semula.

Kata kunci (keyword) untuk mengontrol dan non-file didasarkan pada layer

Jika Anda menggunakan PostgreSQL, WFS, Spatialite atau non-file lain berbasis sumber daya, Anda tetap dapat mengisi kotak dialog kata kunci (keyword). Dalam keadaan ini kata kunci akan ditulis ke basis data sqlite - secara standar basis data ini disimpan sebagai keywords.db di dalam InaSAFE direktori utama pugin.

Anda mungkin berharap untuk menggunakan lokasi yang berbeda untuk keywords.db kata kunci basis data - Anda dapat mengkonfigurasi ini dengan menggunakan InaSAFE dialog pilihan. Dialog pilihan dapat dimunculkan dengan mengklik pada InaSAFE simbol plugin toolbar pilihan (seperti terlihat di bawah) atau dengan melakukan Plugins ‣ InaSAFE ‣ InaSAFE Options.

Options Icon

Memilih ikon pilihan

Ketika kotak dialog Option (Pilihan) terbuka, path basis data kata kunci (keyword) dapat ditentukan menggunakan pilihan keyword cache for remote datasources seperti yang terlihat dibawah.

Path to options database

Jalur ke pilihan database

Note

  1. Layanan untuk remote dan layer berbasis non-file telah ditambahkan di InaSAFE versi 0.3.
  2. Database dapat dibuka menggunakan editor sqlite seperti sqliteman, tapi data di tabel kata kunci tidak dapat dibaca atau diedit. Kolom tabel memiliki sebuah MD5 berdasarkan pada URI untuk sumber data (biasanya detail koneksi database) dan kumpulan yang memiliki kata kunci sebagai kamus python.

Lihat dokumen Pilihan untuk informasi lebih lengkap mengenai dialog pilihan|project_name|

Berbagi cache kata kunci Anda

Dalam teorinya Anda dapat menempatkan file kata kunci pada jaringan berbagi dan membuat repositori kata kunci bersama dalam lingkungan banyak pengguna, tetapi Anda harus mencatat bahwa hash layer URI perlu untuk diidentifikasi agar kata kunci layer dapat ditemukan. Ini bermaksud, untuk (dibuat), contoh:

connection=postgresql,user=joe,password=secret,resource=osm_buildings

Tidak akan dianggap sama seperti:

connection=postgresql,user=anne,password=secret,resource=osm_buildings

karena kredensial pengguna berbeda, menghasilkan URI yang berbeda. Untuk mengatasi ini Anda dapat membuat akun umum sehingga setiap pengguna efektif akan menggunakan URI yang sama untuk memuat layer tersebut misalnya:

connection=postgresql,user=public,password=secret,resource=osm_buildings

Untuk sumber daya tertentu (misalnya cakupan Arcinfo, basis data Spatialite) dimana cache juga digunakan, Anda harus berhati-hati menggunakan titik tingkat umum atau jaringan berbagi untuk mengakses data jika Anda berharap menekan cache dengan layer URI secara sukses. Contohnya Anda dapat memiliki semua pengguna menjaga data pada tempat yang sama. Di bawah Unix sebagai sistem pengoperasian ini dapat terlihat seperti ini:

/mnt/gisdata/jk.sqlite

Pada windows anda dapat selalu drive surat yang sama dan alur untuk berbagai, contohnya:

Z:\gisdata\jk.sqlite

Mendapatkan bantuan

Jika Anda membutuhkan bantuan untuk menggunakan editor kata kunci, Anda dapat klik pada tombol Help di tombol dialog dan halaman ini akan ditampilkan.


Contact info@inasafe.org for more information. Source code available on GitHub! Please file a ticket if you have discovered an issue.
This document is licensed under a Creative Commons Attribution 3.0 Australia License.
CCByA, Copyright 2013, BNPB/AusAID/World Bank.