Sistem Kata kunci¶
Dokumentasi ini menjelaskan tujuan dan penggunaan sistem kata kunci InaSAFE.
lihat juga
Silakan juga merujuk ke dokumentasi di the kata kunci Wizards dan editor kata kunci, merupakan sebuah alat yang digunakan untuk membantu Anda untuk membuat file kata kunci.
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”).
Dengan konvensi dan ekspektasi, berkas keyword harus diberi nama sama dengan nama dasar dari sumber data GIS yang menyertai. Sebagai contoh sebuah set data banjir disimpan sebagai
C:\gisdata\flood.tif
akan membutuhkan berkas keyword yang menyertai disimpan sebagai:
C:\gisdata\flood.keywords
Catatan
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.
Catatan
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 |
keterpaparan |
kategori |
ancaman |
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 |
gempa bumi |
Subkategori |
banjir |
Subkategori |
umum |
Subkategori |
tephra (abu vulkanik)* |
Subkategori |
tsunami |
Subkategori |
gunung berapi |
tephra merupakan bentuk lontaran abu vulkanik
Subkategori yang berlaku untuk kategori ‘keterpaparan’:
Kunci |
Nilai yang diperbolehkan |
|---|---|
Subkategori |
penduduk |
Subkategori |
jalan |
Subkategori |
struktur |
Contoh pemasukan file kata kunci:
category: hazard
subcategory: flood
Satuan¶
Unit kata kunci yang digunakan menunjukkan satuan metrik atau imperial diwakili oleh masing-masing entitas data (sel jaringan atau fitur vektor) dalam sebuah layer.
Unit-unit yang berlaku untuk subkategori ancaman¶
Unit-unit yang berlaku untuk subkategori ‘banjir’ atau subkategori ‘tsunami’:¶
Kunci |
Nilai yang diperbolehkan |
|---|---|
unit/ satuan |
meter |
unit/ satuan |
kaki |
unit/ satuan |
basah / kering |
unit/ satuan |
ternormalisasi |
meter: Meter merupakan sebuah unit pengukuran metrik. 100 sentimeter sama dengan 1 meter. Pada kasus ini meter digunakan untuk mendeksripsikan kedalaman air.
kaki: Kaki merupakan salah satu unit pengukuran imperial. 1 kaki sama dengan 12 inci dan 3 kaki sama dengan 1 yard. Dalam kasus ini kaki digunakan untuk mendeskripsikan kedalaman air.
basah / kering: Ini adalah deskripsi biner untuk wilayah. Wilayah bisa berupa basah (terdampak oleh air banjir) atau kering (tidak terdampak oleh air banjir). Unit ini tidak mendeskripsikan seberapa basah atau kering wilayah tersebut.
ternomalisasi: Data ternormalisasi dapat berupa data ancaman atau keterpaparan dimana nilainya telah diklasifikasikan atau dikodekan.
Unit-unit yang berlaku untuk subkategori ‘gunung berapi’ atau subkategori ‘material letusan’:¶
Kunci |
Nilai yang diperbolehkan |
|---|---|
unit/ satuan |
ternormalisasi |
unit/ satuan |
kategori gunung berapi |
ternomalisasi: Data ternormalisasi dapat berupa data ancaman atau keterpaparan dimana nilainya telah diklasifikasikan atau dikodekan.
Kategori gunung api: Ini adalah deskripsi ternari untuk sebuah wilayah. Wilayah memiliki dampak rendah, sedang, atau tinggi dari gunung berapi.
Unit-unit yang berlaku untuk subkategori ‘gempa bumi’:¶
Kunci |
Nilai yang diperbolehkan |
|---|---|
unit/ satuan |
MMI |
unit/ satuan |
ternormalisasi |
MMI: Skala Modified Mercalli Intensity (MMI) mendeskripsikan intensitas getaran tanah dari sebuah kejadian gempa bumi berdasarkan efek yang diamati oleh orang-orang di permukaan.
ternomalisasi: Data ternormalisasi dapat berupa data ancaman atau keterpaparan dimana nilainya telah diklasifikasikan atau dikodekan.
Unit-unit yang berlaku untuk subkategori terdampak¶
Unit-unit yang berlaku untuk subkategori ‘populasi’:¶
Kunci |
Nilai yang diperbolehkan |
|---|---|
unit/ satuan |
orang per piksel |
penduduk per pixel: banyak penduduk tiap sel. Sebagai contoh jumlah penduduk bisa dihitung sebagai banyak penduduk per pixel pada data raster. Unit ini cocok untuk raster penduduk di koordinat geografis.
Unit-unit yang berlaku untuk subkategori ‘bangunan’:¶
Kunci |
Nilai yang diperbolehkan |
|---|---|
unit/ satuan |
jenis bangunan |
unit/ satuan |
bangunan umum |
jenis bangunan: Jenis bangunan adalah unit yang merepresentasikan jenis dari bangunan. Pada kasus ini, jenis bangunan akan digunakan untuk mengelompokan hasil dari fungsi dampak.
bangunan umum: Bangunan umum berarti bahwa tidak ada atribut jenis bangunan pada data terdampak.
Unit-unit yang berlaku untuk subkategori ‘jalan’:¶
Kunci |
Nilai yang diperbolehkan |
|---|---|
unit/ satuan |
Jenis Jalan |
Jenis jalan: Jenis jalan adalah unit yang merepresentasikan jenis dari jalan. Pada kasus ini, jenis jalan akan digunakan untuk mengelompokan hasil dari fungsi dampak.
Jenis data¶
Tipe data kunci menunjukkan jenis data geospasial diwakili (Numerik, Poligon, Garis, Poin).
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 satu keyword untuk sebuah key yang diberikan pada berkas keyword.
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.
Terjemahan¶
Walaupun InaSAFE tersedia dalam berbagai bahasa, tapi ‘key’ dalam file kata kunci seharusnya selalu dituliskan dalam bahasa inggris.
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 membuat kata kunci. 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.
Tombol Opsi
Ketika kotak dialog Pilihan/ Option terbuka, path database kata kunci dapat ditentukan di bawah tab Advanced menggunakan pilihan Keyword cache for remote datasources seperti yang terlihat dibawah.
Jalur ke pilihan database
Catatan
Layanan untuk remote dan layer berbasis non-file telah ditambahkan di InaSAFE versi 0.3.
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 Pilihan dokumen untuk informasi lebih lengkap mengenai InaSAFE pilihan dialog.
Berbagi cache kata kunci Anda¶
Secara teori anda dapat menempatkan file kata kunci pada sebuah jaringan berbagi dan membuat sebuah repositori kata kunci bersama dalam lingkungan banyak pengguna, tetapi anda harus perhatikan bahwa hash layer URI perlu untuk diidentifikasi supaya kata kunci layer dapat ditemukan. Ini dimaksudkan untuk (dibuat sebagai), 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, sehingga menghasilkan URI yang berbeda. Untuk mengatasi ini, Anda bisa membuat akun umum sehingga setiap pengguna secara efektif akan menggunakan URI yang sama untuk memuat layer 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 menggunakan kode huruf drive anda yang sama dan destinasi untuk berbagi, 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.
Catatan
Dokumen ini dibuat secara otomatis. Dokumen ini dapat dibuat ulang dengan menjalankan script python /inasafe-doc/scripts/generate_keywords.py.
Dokumen ini dibuat berdasarkan InaSAFE 2.1.0b0.