Lewati ke konten

Paket Catatan

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.

FormatPilih bilaIsinyaDapat diimpor NAHPU
Darwin Core Archive (.dwca.zip)Basis data museum atau portal biodiversitas (seperti GBIF) meminta DwC-ASpesimen dalam satu tabel inti datar, dengan bagian, pengukuran, dan media di tabel ekstensiTidak
Darwin Core Data Package (.dwc-dp.tar.gz)Penerima mendukung standar relasional Darwin Core terbaruSpesimen, peristiwa, identifikasi, bagian, dan personel dalam tabel Darwin Core yang saling tertautTidak
NAHPU Data Package (.nahpu-dp.tar.gz)Anda memerlukan seluruh data untuk analisis R/Python, arsip jangka panjang, atau salinan proyek penuhProyek lengkap, setiap tabel NAHPU yang terisi, konfigurasi pengguna, dan berkasYa, 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.

  1. Buka menu dasbor proyek lalu pilih Bundel catatan.
  2. Pilih format bundel B.
  3. Pilih format arsip C bila format mendukung lebih dari satu wadah:
    • TAR.GZ adalah bawaan untuk Data Package.
    • ZIP tersedia untuk alat dan sistem yang lebih memilih arsip ZIP standar.
    • Darwin Core Archive selalu memakai ZIP.
  4. Untuk bundel Darwin Core, pilih Semua takson A atau Takson terpilih. Memilih Mamalia otomatis menyertakan kelelawar.
  5. Masukkan nama berkas D (opsional aktifkan Tambahkan tanggal) dan pilih folder tujuan di desktop.
  6. Periksa Isi paket E (di tab isi pada ponsel). Buka sumber daya CSV F untuk melihat kolomnya.
  7. Tinjau peringatan, seperti media hilang atau catatan kompatibilitas ZIP untuk DwC-DP.
  8. Pilih Buat bundel G. Anda dapat membatalkan saat proses berjalan. Setelah selesai, bagikan, buka folder, simpan salinan, atau pilih Bundel lainnya.
WadahEkstensi umumCatatan
TAR.GZ.dwc-dp.tar.gz, .nahpu-dp.tar.gzBawaan 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.zipWajib untuk Darwin Core Archive; opsi normal untuk NAHPU Data Package; opsi kompatibilitas untuk DwC-DP (menampilkan peringatan karena panduan DwC-DP mengutamakan gzip).

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 (DwC-A) adalah paket pertukaran berpusat pada spesimen berdasarkan Darwin Core Text Guidelines.

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.

  • meta.xml
  • eml.xml
  • occurrence.csv
  • material.csv
  • measurement_or_fact.csv
  • multimedia.csv
  • Directorymedia/
    • …

Hanya berkas yang memiliki data yang ditulis:

  • meta.xml menjelaskan tabel inti, tabel ekstensi, posisi kolom, dan URI istilah Darwin Core.
  • eml.xml berisi metadata tingkat himpunan data.
  • occurrence.csv selalu menjadi tabel inti.
  • Baris ekstensi merujuk ke inti: bagian spesimen masuk ke material.csv, pengukuran ke measurement_or_fact.csv, dan multimedia.csv menautkan spesimen ke berkas di bawah media/.

Keluaran: <nama-berkas>.dwca.zip.

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.

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

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);
  • agent dan *-agent-role: personel dan perannya (mengutamakan URL ORCID kanonis, dengan UUID NAHPU sebagai cadangan);
  • media dan occurrence-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 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.

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

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.

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, dan specimenIndividual) dengan kode stabil di mana 0, 1, dan 2 mempertahankan 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.

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.

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.toml mencatat 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 crate nahpu_api (nahpu_dp, nahpu_dwc, nahpu_db, nahpu_configs, dan lainnya).
  • configs/user_configs.json menyimpan ekspor konfigurasi pengguna berversi (pengaturan umum, prasetel ekspor catatan, templat dokumen, dan prasetel tata letak cetak).
  • media/ dan files/ memuat media proyek yang dirujuk, foto personel yang dirujuk (di bawah media/ dengan jalur kompatibel transfer), dan fon kustom pengguna (di bawah files/). 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 Darwin CoreNAHPU Data PackageCadangan basis data
Memulihkan proyek NAHPUTidakYa (Impor proyek atau Gabungkan proyek)Ya (seluruh instalasi)
Tujuan utamaPertukaran dengan sistem eksternalSalinan terdokumentasi dan dapat dipakai ulang untuk satu proyekPemulihan 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.

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.