# Sistem Kata kunci

Dokumentasi ini menjelaskan tujuan dan penggunaan sistem kata kunci InaSAFE

lihat juga

Please also refer to the documentation on the keywords Wizards and the keywords editor which are tools to help you to create keywords files.

## Tujuan

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

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 dalam konteks yang keliru (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 dengan 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
kategori | aggregation

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 | volcano
Subkategori | earthquake

Dimana tephra merupakan bentuk lontaran dari abu vulkanik.

Subkategori yang berlaku untuk kategori ‘keterpaparan’:

Kunci | Nilai yang diperbolehkan
--- | ---
keterpaparan | populasi
keterpaparan | structure
keterpaparan | road

Contoh pemasukan file kata kunci

    category: hazard
    subcategory: flood

### unit/ satuan

The units keyword is used to indicate the metric or imperial units represented by each data entity (a grid cell or a vector feature) in a layer.

Example keywords file entry:

> > Kunci | Allowed Values (pre InaSAFE 2.1) | Allowed Values (>= 2.1)
> > --- | --- | ---
> > unit/ satuan | m | metres_depth
> > unit/ satuan |  |
> > keterpaparan | road |
> > ancaman |  |

> 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.

Catatan

‘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

The data type keyword indicate what kind of geospatial data is represented (Numeric, Polygon, Line, Point).

## 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 kini tersedia dalam berbagai bahasa, tapi ‘key’ dalam file kata kunci harus 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 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.

Memilih ikon pilihan

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

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

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 akan mendapatkan huruf drive dan jalur yang sama 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.