Ekspor¶

Halaman ini memberi tahu Anda cara mengeluarkan data dan laporan dari LUC Analytics (LUCA), dan kapan setiap ekspor tidak tersedia.

Di halaman ini, kontrol atau label aplikasi ditulis dengan huruf tebal. Pesan aplikasi ditulis di dalam "tanda petik ganda".

Ringkasan ekspor¶

Ekspor	Lokasi kontrol	Format	Nama file
Hasil daftar, pasca-2020	Menu ⋯ daftar di halaman daftar, item Ekspor	CSV	`<list name> - post2020.csv`
Hasil daftar, pasca-2020	Tab PENILAIAN RISIKO PASCA-2020 suatu daftar, tombol ⬇ Unduh CSV	CSV	`<list name> - post2020.csv`
Hasil daftar, peringatan	Tab PERINGATAN GANGGUAN TERBARU suatu daftar, tombol ⬇ Unduh CSV	CSV	`<list name> - alerts.csv`
Satu lokasi	Panel Detail lokasi, tombol ⬇ Unduh CSV	CSV	`<list name> - location <id> detail.csv`
Laporan satu lokasi	Panel Detail lokasi, tombol Unduh PDF	PDF	`location-<id>-report.pdf`
Data yang digunakan	Disertakan dengan setiap ekspor CSV, sebagai file kedua	CSV	`<CSV name>.data-used.csv`
Templat legenda peta	Legenda peta, Templat peta tersimpan, tombol Simpan	`.mpky` (JSON)	`mapkey_0001.mpky` atau nama yang Anda ketik

Jika nama daftar tidak menghasilkan nama file yang dapat digunakan, aplikasi menggunakan ID daftar, misalnya list-<list id>-post2020.csv atau location-<id>-detail.csv. Aplikasi mengganti karakter yang tidak diizinkan Windows, macOS, atau Linux dalam nama file.

Saat ekspor tersedia¶

Browser dan server masing-masing melakukan pemeriksaan sebelum ekspor. Kedua pemeriksaan menggunakan aturan yang sama:

Ekspor seluruh daftar hanya tersedia saat analisis daftar lengkap.
Ekspor satu lokasi hanya tersedia saat analisis lokasi tersebut selesai.

Ekspor	Kondisi yang diperlukan
CSV daftar dan file data yang digunakan (Ekspor dan kedua tombol ⬇ Unduh CSV)	Status daftar lengkap. Sebelum itu, keterangan alat menunjukkan "Ekspor CSV tersedia setelah analisis daftar ini selesai."
CSV lokasi dan file data yang digunakan	Setiap analisis daftar selesai untuk lokasi tersebut.
PDF lokasi	Analisis pasca-2020 lokasi tersebut selesai. Peta juga harus siap untuk ditangkap.

Berikut adalah hasil pemeriksaan:

Anda tidak dapat mengekspor CSV daftar yang tidak lengkap. Daftar dengan label Tidak lengkap (misalnya, setelah Hentikan & simpan) tetap dalam kondisi ini. Untuk daftar seperti itu, ekspor setiap lokasi yang sudah selesai.
Anda dapat mengunduh CSV atau PDF lokasi yang sudah selesai. Lokasi lain dalam daftar tidak harus selesai.
PDF lokasi dalam daftar yang tidak lengkap memiliki catatan, misalnya "Laporan dibuat dari daftar yang dianalisis sebagian — 40/50 lokasi dianalisis (80%)". Jika aplikasi tidak dapat menghitung lokasi, catatannya adalah "Laporan dibuat dari daftar yang dianalisis sebagian — jumlah lokasi yang dianalisis tidak dapat dikonfirmasi".
Aplikasi tidak menulis nol sebagai pengganti nilai yang tidak dihitungnya. Tidak ada cara untuk melewati pemeriksaan ini.

Jika server menolak ekspor, aplikasi menunjukkan salah satu dari pesan berikut:

"Ekspor tidak tersedia — belum ada lokasi pada daftar ini yang dianalisis, jadi tidak ada yang bisa diekspor."
"Ekspor CSV tersedia setelah analisis daftar ini selesai."
"Ekspor tidak tersedia — analisis untuk lokasi ini belum selesai. Ekspor akan tersedia setelah semua analisisnya selesai."
"Ekspor PDF tidak tersedia — belum ada lokasi yang dianalisis untuk daftar ini."

Untuk informasi lebih lanjut tentang status analisis, lihat 03-analysis-and-results.md.

Mengekspor hasil daftar sebagai CSV¶

Anda dapat memulai ekspor pasca-2020 dari halaman daftar atau dari daftar. Kedua kontrol memberikan file yang sama.

Dari halaman daftar:

Pergi ke halaman daftar (Daftar).
Di baris daftar, tekan ⋯.
Pilih Ekspor.

Dari daftar:

Buka daftar.
Pilih tab PENILAIAN RISIKO PASCA-2020 atau tab PERINGATAN GANGGUAN TERBARU.
Jika Anda menggunakan tab peringatan, atur tanggal peringatan pada chip tanggal Peringatan. CSV menggunakan tanggal yang sama.
Tekan ⬇ Unduh CSV.

Browser mengunduh dua file: CSV dan file data yang digunakan. Untuk file data yang digunakan, lihat "File data yang digunakan" di bawah.

Isi CSV pasca-2020¶

CSV memiliki satu baris untuk setiap lokasi. Kolomnya adalah:

Identitas lokasi: location_id, location_name, load_order, status, centroid_lat, centroid_lon.
Tanggal analisis dan versi set data: post2020_analysis_date, post2020_dataset_version.
Luas dalam hektare: total_area_ha, sbtn_area_ha, jrc_area_ha, dan penanda sbtn_flag dan jrc_flag.
Kehilangan setelah 2020 untuk setiap peta hutan: sbtn_loss_ha_post2020, jrc_loss_ha_post2020. Ada juga satu kolom untuk setiap tahun kehilangan, misalnya sbtn_loss_ha_2021.
Pemicu kehilangan tutupan pohon: satu kolom driver_<name>_ha untuk setiap pemicu. Kemudian dominant_driver, dominant_share, dominant_is_mixed dan dominant_is_none.
Kesalahan: error_code dan explanation.
Status: finished_state, list_status, list_locations_computed, list_locations_total.

Isi CSV peringatan¶

CSV peringatan memiliki satu baris untuk setiap lokasi. CSV ini memiliki kolom identitas, luas, kesalahan, dan status yang sama dengan CSV pasca-2020. CSV ini juga memiliki kolom berikut: alerts_analysis_date, alerts_dataset_version, alert_area_ha, alert_sbtn_area_ha, alert_jrc_area_ha, window_start dan window_end. Kedua kolom jendela menunjukkan tanggal peringatan yang dihitung file.

Mengekspor satu lokasi sebagai CSV¶

Buka daftar.
Di baris lokasi, tekan DETAIL. Panel Detail lokasi terbuka.
Tekan ⬇ Unduh CSV.

CSV memiliki satu baris. CSV ini berisi kolom identitas, luas, kehilangan, dan pemicu dari CSV pasca-2020, dan kolom peringatan dari CSV peringatan. CSV ini juga berisi kolom annotation, yaitu catatan Anda tentang lokasi tersebut. Browser juga mengunduh file data yang digunakan untuk lokasi tersebut.

Mengunduh laporan PDF satu lokasi¶

Buka daftar.
Di baris lokasi, tekan DETAIL.
Tunggu sampai peta di panel Detail lokasi selesai digambar.
Tekan Unduh PDF.

Sebelum aplikasi membuat PDF, aplikasi menunggu ubin peta dasar dan lapisan analisis. Jika keduanya belum siap, aplikasi tidak membuat file. Aplikasi menunjukkan pesan yang memberi tahu Anda penyebabnya. Misalnya: "Ekspor PDF tidak tersedia — masih menunggu: ubin peta dasar selesai dimuat (6 dari 9 dimuat). Harap tunggu dan coba lagi."

PDF berorientasi lanskap. PDF berisi item berikut:

Judul: nama dan ID lokasi.
Catatan, hanya jika daftar tidak lengkap. Catatan memberikan jumlah lokasi yang sudah selesai. Lihat "Saat ekspor tersedia" di atas.
Dua gambar peta: "Batas pada peta dasar" dan "Batas + lapisan analisis aktif pada peta dasar".
"Pengaturan lapisan yang digunakan untuk gambar ini". Bagian ini memberikan warna dan opasitas setiap lapisan, tahun kehilangan, tanggal peringatan, dan resolusi peta.
Detail lokasi: nama, luas, dan catatan Anda.
Tabel kehilangan hutan untuk setiap tahun, untuk peta hutan SBTN dan peta hutan JRC.
Peringatan, jika daftar memiliki analisis peringatan.
Pemicu kehilangan tutupan pohon, sebagai diagram lingkaran dengan legenda. Jika tidak ada data pemicu, PDF menyatakannya.
"Data yang digunakan": set data dan versinya.
"Cara mengutip data": teks atribusi.

CATATAN: Gambar peta dapat lebih besar daripada di layar. Kemudian PDF memberi tahu Anda skalanya, misalnya "Panel peta diskalakan ×2.00 dari resolusi layar untuk laporan ini."

Untuk kontrol peta yang mengubah gambar, lihat 04-maps.md.

File data yang digunakan¶

Setiap ekspor CSV disertai file kedua. Namanya adalah nama CSV dengan .data-used.csv sebagai pengganti .csv. File ini berisi satu baris untuk setiap set data sumber, dengan kolom berikut: dataset, version_id, date, date_kind, local_or_s3, profile, currency_at_run, hash, location.

Jika analisis berjalan sebelum aplikasi mencatat tanggal set data, file memiliki satu baris dengan teks vintase tidak tercatat.

CSV dapat terunduh sementara file data yang digunakan tidak terunduh. Kemudian aplikasi menunjukkan "CSV berhasil diunduh, tetapi berkas pendamping "Data yang digunakan" (tanggal set data sumber) tidak dapat diunduh." Tekan tombol lagi untuk mendapatkan kedua file.

Format file CSV¶

Teksnya UTF-8 dengan tanda urutan byte (BOM). Baris-baris diakhiri dengan CR LF.
Baris-baris pertama adalah teks atribusi. Setiap baris ini dimulai dengan #. Baris judul tabel ada setelahnya.
Angka tidak memiliki pemisah ribuan. Luas memiliki paling banyak 4 tempat desimal.
Sel kosong saat aplikasi tidak memiliki nilai untuknya, misalnya lokasi dengan kesalahan. Aplikasi tidak menulis nol sebagai pengganti nilai yang tidak dihitungnya.

CATATAN: Jika sel teks dimulai dengan =, +, -, @ atau tab, aplikasi meletakkan ' sebelum teks. Dengan demikian, program lembar kerja tidak membaca teks tersebut sebagai rumus.

Untuk membaca tabel di sebuah program, beri tahu program untuk melewati baris yang dimulai dengan #. Misalnya, di pandas, gunakan read_csv(..., comment="#").

Atribusi dan lisensi¶

"Ketentuan Penggunaan Khusus WRI untuk GNW Self-Hosted Monitoring" berlaku untuk data. Anda harus memberikan atribusi data saat Anda membagikan hasil. Anda tidak boleh menyiratkan bahwa WRI mendukung, mensponsori, mengesahkan, atau menyetujui Anda atau penggunaan data oleh Anda.

Aplikasi menambahkan teks atribusi ke setiap ekspor CSV dan ke setiap laporan PDF. Teks atribusi ditulis dalam bahasa yang Anda pilih di aplikasi. Teks ini memiliki bagian berikut:

Kutipan GNW, dengan tanggal akses: "Global Nature Watch. [tahun]. World Resources Institute. Diakses pada [tanggal]." Tanggal akses adalah tanggal proses terakhir daftar selesai.
Kutipan setiap set data yang digunakan ekspor, dengan lisensinya.
"Dihitung dengan LUC Analytics, sebuah proyek independen, menggunakan metode yang diadaptasi dari skrip yang dipublikasikan WRI (post2020.py, GNW Self-Hosted Monitoring). WRI tidak mendukung proyek ini maupun hasilnya."
"Penggunaan data ini tunduk pada Ketentuan Penggunaan Khusus WRI untuk GNW Self-Hosted Monitoring: https://www.wri.org/about/legal/gnw-shm-tos"

Set data di setiap ekspor adalah:

Ekspor	Set data
CSV pasca-2020	Kehilangan tutupan pohon, Hutan alam SBTN, Tutupan hutan global JRC 2020, Pemicu dominan hilangnya hutan
CSV peringatan	Peringatan gangguan terpadu global, Hutan alam SBTN, Tutupan hutan global JRC 2020
CSV lokasi dan PDF lokasi	Kelima set data di atas

Lisensinya adalah:

Lisensi	Set data
CC BY 4.0	Kehilangan tutupan pohon, Hutan alam SBTN, Pemicu dominan hilangnya hutan, Peringatan gangguan terpadu global
Gratis, tanpa batasan penggunaan (Regulasi Copernicus dari Komisi Eropa)	Tutupan hutan global JRC 2020

Untuk daftar dengan data demo sintetis, teks atribusinya berbeda. Teks tersebut menyatakan "Data demo sintetis yang dibuat oleh LUC Analytics. Tidak ada set data WRI yang dibaca untuk angka-angka ini."

Untuk membaca teks atribusi di aplikasi, tekan Sumber data dan lisensi di bagian bawah halaman. Teks lengkapnya ada di file DATA-ATTRIBUTION.md di repositori proyek.

PERHATIAN: Pertahankan baris-baris atribusi saat Anda menyalin data dari CSV ke file lain. Jika Anda menghapusnya, file baru tidak memberi tahu pembaca sumber dan lisensi data.

Menyimpan templat legenda peta¶

Templat legenda peta menyimpan pengaturan lapisan peta dalam sebuah file, sehingga Anda dapat menggunakannya lagi. Templat ini bukan ekspor hasil.

Di legenda peta, temukan Templat peta tersimpan.
Ketik nama di Nama berkas, atau pertahankan nama bawaan.
Tekan Simpan.

File ini adalah dokumen JSON dengan ekstensi .mpky. Untuk menggunakan file lagi, tekan Muat…. Untuk informasi lebih lanjut, lihat 04-maps.md.

Ekspor melalui baris perintah¶

Program juga memiliki perintah luc-analytics export untuk administrator. Perintah ini menulis CSV suatu daftar (--analysis post2020 atau --analysis alerts) atau satu lokasi (--analysis detail --location-id <id>). Argumen --start dan --end mengatur tanggal peringatan. Argumen --output mengatur file. Tanpa --output, perintah menulis ke keluaran standar.

Perintah menggunakan pemeriksaan yang sama dengan aplikasi. Untuk seluruh daftar, daftar harus lengkap. Untuk satu lokasi, lokasi tersebut harus selesai. Jika pemeriksaan gagal, perintah tidak menulis file. Perintah menunjukkan pesan yang dimulai dengan export_refused: dan berhenti dengan kode keluar 1. Perintah tidak menulis file data yang digunakan.