Layar besar
Layar kecil
Gunakan Bundel catatan untuk mengemas data proyek bersama metadata dan medianya guna publikasi, pengarsipan, atau analisis terulang. Sebelum menulis apa pun, Isi paket menampilkan setiap berkas, jumlah catatan, kolom, dan peringatan.
Memilih format bundel
Section titled “Memilih format bundel ”| Format | Pilih bila | Isinya | Dapat diimpor NAHPU |
|---|---|---|---|
Darwin Core Archive (.dwca.zip) | Basis data museum atau portal biodiversitas (seperti GBIF) meminta DwC-A | Spesimen dalam satu tabel inti datar, dengan bagian, pengukuran, dan media di tabel ekstensi | Tidak |
Darwin Core Data Package (.dwc-dp.tar.gz) | Penerima mendukung standar relasional Darwin Core terbaru | Spesimen, peristiwa, identifikasi, bagian, dan personel dalam tabel Darwin Core yang saling tertaut | Tidak |
NAHPU Data Package (.nahpu-dp.tar.gz) | Anda memerlukan seluruh data untuk analisis R/Python, arsip jangka panjang, atau salinan proyek penuh | Proyek lengkap, setiap tabel NAHPU yang terisi, konfigurasi pengguna, dan berkas | Ya, melalui Impor proyek atau Gabungkan proyek |
Bundel Darwin Core hanya menyertakan nilai yang memiliki istilah resmi terdaftar di Darwin Core, Dublin Core, atau Audubon Core. Pilih NAHPU Data Package jika tidak boleh ada data yang terlewat, termasuk bidang kustom. Paket ini dapat dibaca alat Frictionless; lihat Tutorial 3.
Membuat bundel
Section titled “Membuat bundel”- Buka menu dasbor proyek lalu pilih
Bundel catatan. - Pilih format bundel B.
- Pilih format arsip C bila format mendukung lebih dari satu wadah:
TAR.GZadalah bawaan untuk Data Package.ZIPtersedia untuk alat dan sistem yang lebih memilih arsip ZIP standar.- Darwin Core Archive selalu memakai
ZIP.
- Untuk bundel Darwin Core, pilih
Semua taksonA atauTakson terpilih. Memilih Mamalia otomatis menyertakan kelelawar. - Masukkan nama berkas D (opsional aktifkan
Tambahkan tanggal) dan pilih folder tujuan di desktop. - Periksa
Isi paketE (di tab isi pada ponsel). Buka sumber daya CSV F untuk melihat kolomnya. - Tinjau peringatan, seperti media hilang atau catatan kompatibilitas ZIP untuk DwC-DP.
- Pilih
Buat bundelG. Anda dapat membatalkan saat proses berjalan. Setelah selesai, bagikan, buka folder, simpan salinan, atau pilihBundel lainnya.
Memilih wadah arsip
Section titled “Memilih wadah arsip”| Wadah | Ekstensi umum | Catatan |
|---|---|---|
TAR.GZ | .dwc-dp.tar.gz, .nahpu-dp.tar.gz | Bawaan untuk Data Package dan pilihan sesuai standar DwC-DP. Setelah diekstrak, datapackage.json dan metadata berada di direktori akar. |
ZIP | .dwca.zip, .dwc-dp.zip, .nahpu-dp.zip | Wajib untuk Darwin Core Archive; opsi normal untuk NAHPU Data Package; opsi kompatibilitas untuk DwC-DP (menampilkan peringatan karena panduan DwC-DP mengutamakan gzip). |
Penjelasan mendalam
Section titled “Penjelasan mendalam”Bagian berikut menjelaskan berkas yang ditulis setiap paket dan cara NAHPU memetakan catatan. Gunakan saat penerima menanyakan struktur paket atau saat Anda memprosesnya lewat skrip.
Darwin Core Archive
Section titled “Darwin Core Archive ”Darwin Core Archive (DwC-A) adalah paket pertukaran berpusat pada spesimen berdasarkan Darwin Core Text Guidelines.
Cakupan dan bidang
Section titled “Cakupan dan bidang”Kelompok takson terpilih menentukan spesimen yang diekspor. NAHPU mengikuti relasinya untuk menyertakan peristiwa koleksi, bagian spesimen dan entitas material, pengukuran, media, serta personel (kolektor, pengkatalog, preparator, dan pembuat media). Bidang opsional kosong dan tabel ekstensi kosong diabaikan.
Kolom hanya ditulis jika memiliki istilah terdaftar tepat di Darwin Core, Dublin Core, atau Audubon Core; bidang lain diabaikan dan ditampilkan pada Isi paket sebelum ekspor. Gunakan NAHPU Data Package bila setiap nilai harus dipertahankan.
Berkas akar dan relasi
Section titled “Berkas akar dan relasi”- meta.xml
- eml.xml
- occurrence.csv
- material.csv
- measurement_or_fact.csv
- multimedia.csv
Directorymedia/
- …
Hanya berkas yang memiliki data yang ditulis:
meta.xmlmenjelaskan tabel inti, tabel ekstensi, posisi kolom, dan URI istilah Darwin Core.eml.xmlberisi metadata tingkat himpunan data.occurrence.csvselalu menjadi tabel inti.- Baris ekstensi merujuk ke inti: bagian spesimen masuk ke
material.csv, pengukuran kemeasurement_or_fact.csv, danmultimedia.csvmenautkan spesimen ke berkas di bawahmedia/.
Keluaran: <nama-berkas>.dwca.zip.
Darwin Core Data Package
Section titled “Darwin Core Data Package”Darwin Core Data Package (DwC-DP) menyajikan data Darwin Core sebagai tabel relasional ternormalisasi sesuai spesifikasi Darwin Core Data Package dan model Frictionless Data Package.
Berkas akar
Section titled “Berkas akar”- datapackage.json
- eml.xml
- occurrence.csv
- identification.csv
- event.csv
- material.csv
- occurrence-assertion.csv
- media.csv
- agent.csv
- occurrence-agent-role.csv
- event-agent-role.csv
- material-agent-role.csv
- media-agent-role.csv
- occurrence-media.csv
Directorymedia/
- …
Tabel opsional hanya muncul jika ada datanya. datapackage.json menyatakan profil DwC-DP, setiap sumber daya CSV, urutan bidang, kunci primer, kunci asing, dan predikat relasi. Kolom struktural _pk dan _fk menjaga tautan relasional bersama pengenal yang terbaca manusia.
Pemetaan data
Section titled “Pemetaan data”NAHPU memetakan data ke kelas standar alih-alih mengulanginya di occurrence.csv:
occurrence: kemunculan spesimen;identification: determinasi dan peringkat taksonomi;event: aktivitas koleksi dan konteks lokasi;material: bagian spesimen, katalog, dan preparasi;occurrence-assertion: pengukuran dan asersi non-kelas (seperti asosiasi inang);agentdan*-agent-role: personel dan perannya (mengutamakan URL ORCID kanonis, dengan UUID NAHPU sebagai cadangan);mediadanoccurrence-media: metadata dan tautan media.
Aturan cakupan istilah ketat yang sama berlaku seperti DwC-A. Teks asli DDM, DMS, atau UTM dipertahankan pada istilah koordinat verbatim, luas tangkapan positif ditambahkan ke ketidakpastian koordinat, dan satuan berat pilihan dipertahankan.
Untuk invertebrata, jenis kelamin, tahap hidup, kasta, asosiasi inang, dan catatan spesimen merupakan istilah occurrence; bagian inang dan morfometrik opsional (lebar kepala, panjang tubuh, bentang sayap atas dan bawah) diekspor sebagai asersi MeasurementOrFact dalam milimeter. Tutupan tajuk dan parameter lingkungan menempel pada peristiwa koleksi dengan satuan terdefinisi (°C, %, mg/L, m/s, mm, okta).
Keluaran: <nama-berkas>.dwc-dp.tar.gz (bawaan) atau <nama-berkas>.dwc-dp.zip (opsi kompatibilitas, dengan peringatan).
NAHPU Data Package
Section titled “NAHPU Data Package ”NAHPU Data Package adalah format pertukaran lengkap dan reprodusibel milik NAHPU—sebuah Frictionless Data Package dengan metadata NAHPU. Tidak seperti bundel Darwin Core, paket ini tidak disaring menurut takson: isinya mencakup JSON transfer proyek aktif yang lengkap, tabel CSV bertipe yang selaras, pemetaan enum, potret kosakata terkontrol, konfigurasi pengguna, dan berkas terkait.
Inilah satu-satunya bundel yang mempertahankan bidang kustom tanpa istilah Darwin Core. Hanya tabel yang terisi dalam proyek yang diekspor (proyek khusus mamalia tidak memuat tabel burung, herpetofauna, invertebrata, maupun ikan), dan mappings/sqlite_enums.csv hanya mencantumkan kolom enum dari tabel yang hadir.
Tata letak akar
Section titled “Tata letak akar”- datapackage.json
- nahpu.toml
- nahpu-project.json
Directorytables/
- project.csv
- ...
Directoryconfigs/
- user_configs.json
Directorymappings/
- sqlite_enums.csv
Directoryvocabularies/
- site.csv
- events.csv
- specimens.csv
- symbionts.csv
Directoryfiles/
- ...
Directorymedia/
- ...
Tabel proyek yang kosong dihilangkan dari tables/ dan datapackage.json, sedangkan sumber daya metadata (mappings/sqlite_enums.csv dan vocabularies/*.csv) selalu disertakan (hanya baris tajuk jika kosong).
JSON proyek dan tabel CSV
Section titled “JSON proyek dan tabel CSV”nahpu-project.json adalah muatan berversi yang sama dengan hasil Ekspor proyek (proyek aktif, catatan terkait, manifes media, metadata, dan peringatan), mempertahankan perbedaan seperti null versus string kosong tanpa memerlukan SQLite. Berkas CSV di tables/ dibangkitkan dari muatan yang sama agar tetap konsisten; koleksi kosong tetap berada di nahpu-project.json untuk transfer proyek meskipun tidak ditulis sebagai CSV.
Pemetaan enum SQLite
Section titled “Pemetaan enum SQLite”mappings/sqlite_enums.csv menerjemahkan indeks bilangan bulat yang disimpan di tabel ekspor. Setiap baris memuat tabel SQLite, kolom, tipe enum, indeks mulai dari nol, nama kode stabil, dan label terbaca NAHPU.
Pemetaan yang disertakan (disaring sesuai tabel yang hadir dalam paket) mencakup:
- jenis kelamin spesimen (
mammalAttribute,birdAttribute,herpAttribute,invertebrateAttribute,fishAttribute, danspecimenIndividual) dengan kode stabil di mana0,1, dan2mempertahankan makna historisnya; - tingkat keyakinan identifikasi (
specimen.iDConfidence); - jenis spesimen ikan (
Individual/Lot) dan kasta invertebrata; - bidang reproduksi mamalia dan kategori ekolokasi;
- bidang reproduksi dan ganti bulu burung.
Bilangan bulat boolean dan pengukuran numerik bukan indeks enum sehingga tidak dicantumkan.
Kosakata terkontrol
Section titled “Kosakata terkontrol”Empat sumber daya CSV memotret kosakata terkontrol aktif dari Pengaturan NAHPU (atau bawaan NAHPU jika belum diubah):
vocabularies/site.csv: jenis lokasi dan jenis habitat;vocabularies/events.csv: metode koleksi dan peran personel koleksi;vocabularies/specimens.csv: jenis spesimen, perlakuan, kondisi, opsi jenis kelamin yang diaktifkan, metode identifikasi, dan tahap hidup;vocabularies/symbionts.csv: jenis interaksi simbion, kategori, metode deteksi, metode preparasi, lokasi anatomi, penyimpanan, dan perlakuan.
Setiap baris mencatat kunci konfigurasi, nama kosakata, posisi berbasis nol, dan nilainya, sehingga alat analisis dapat membacanya langsung tanpa mengurai configs/user_configs.json.
Deskriptor Frictionless dan analisis
Section titled “Deskriptor Frictionless dan analisis”datapackage.json memakai profil standar data-package, mendeklarasikan setiap tabel terisi sebagai sumber daya tabular UTF-8 lengkap dengan urutan kolom, tipe data, batasan wajib, kunci primer, dan kunci asing, beserta skema pemetaan enum, kosakata terkontrol, dan sumber daya nontabular.
Ekstrak arsip terlebih dahulu sebelum memuat datapackage.json karena jalur berkas bersifat relatif terhadap akar paket. Periksa keberadaan tabel opsional sebelum membacanya:
from collections import Counter
from frictionless import Package
package = Package("/path/to/extracted-package/datapackage.json")print(package.resource_names)
if package.has_resource("specimen"): specimens = package.get_resource("specimen").read_rows() counts = Counter(row["taxonGroup"] or "Unspecified" for row in specimens) print(counts)library(frictionless)
package <- read_package("/path/to/extracted-package/datapackage.json")resource_names(package)
if ("specimen" %in% resource_names(package)) { specimens <- read_resource(package, "specimen") print(table(specimens$taxonGroup, useNA = "ifany"))}Manifes reprodusibilitas, konfigurasi, dan berkas
Section titled “Manifes reprodusibilitas, konfigurasi, dan berkas”nahpu.tomlmencatat nama dan versi format, cap waktu ekspor, versi dan nomor build aplikasi, versi skema basis data dan konfigurasi pengguna, jumlah tabel/enum/kosakata, serta versi cratenahpu_api(nahpu_dp,nahpu_dwc,nahpu_db,nahpu_configs, dan lainnya).configs/user_configs.jsonmenyimpan ekspor konfigurasi pengguna berversi (pengaturan umum, prasetel ekspor catatan, templat dokumen, dan prasetel tata letak cetak).media/danfiles/memuat media proyek yang dirujuk, foto personel yang dirujuk (di bawahmedia/dengan jalur kompatibel transfer), dan fon kustom pengguna (di bawahfiles/). Berkas yang hilang dilaporkan sebagai peringatan.
Keluaran: <nama-berkas>.nahpu-dp.tar.gz (bawaan) atau <nama-berkas>.nahpu-dp.zip, dengan isi internal yang sama persis.
Bundel versus cadangan
Section titled “Bundel versus cadangan”| Bundel Darwin Core | NAHPU Data Package | Cadangan basis data | |
|---|---|---|---|
| Memulihkan proyek NAHPU | Tidak | Ya (Impor proyek atau Gabungkan proyek) | Ya (seluruh instalasi) |
| Tujuan utama | Pertukaran dengan sistem eksternal | Salinan terdokumentasi dan dapat dipakai ulang untuk satu proyek | Pemulihan penuh perangkat |
NAHPU Data Package hanya mencakup satu proyek, jadi tetap buat cadangan basis data rutin untuk pemulihan seluruh perangkat.
Kontributor yang memperluas bidang bundel atau kelompok takson dapat membaca Alur kerja ekspor dan Menambahkan kelompok takson.
Validasi paket dan peringatan
Section titled “Validasi paket dan peringatan”Sebelum menulis, NAHPU memvalidasi bidang wajib dan relasi; setelah selesai, arsip dibuka kembali untuk memastikan metadata akar tersedia. Peringatan—seperti media tertaut yang hilang atau mode kompatibilitas ZIP untuk DwC-DP—tidak selalu menghentikan ekspor, jadi periksa sebelum membagikan atau menyetorkan paket.


