Format Atlas

Panduan

Pemeriksaan sebelum menyerahkan array ilmiah

Serahkan array netCDF, HDF5, atau Zarr beserta makna, dependensi, dan kebutuhan pembacanya. Berbeda dari memilih format tabel, dimensi dan nilai hilang perlu diperiksa.

Format mana yang sebaiknya dipilih?

Pilih berdasarkan peran setiap berkas dalam alur kerja.

  • Mendokumentasikan makna array
  • Melengkapi unit distribusi
  • Membandingkan nilai di tujuan

Mendokumentasikan makna array

Catat variabel, tipe, urutan dimensi, koordinat, satuan, dan aturan waktu. Jangan samakan nilai hilang atau nilai pengisi dengan nol. Untuk scale_factor dan add_offset, bedakan nilai tersimpan dan nilai hasil dekode.

Melengkapi unit distribusi

Periksa varian netCDF, tujuan tautan eksternal dan filter HDF5, versi serta codec Zarr. Sertakan metadata dan chunk yang diperlukan; bedakan chunk yang sengaja tidak disimpan menurut fill_value dari kelalaian transfer.

Membandingkan nilai di tujuan

Serahkan versi yang selesai ditulis dan baca irisan contoh dengan pustaka penerima. Bandingkan bentuk, sumbu, atribut, mask nilai hilang, dan nilai hasil dekode dengan sumber. Catat toleransi pembulatan atau kehilangan.

Format yang disarankan

netCDF

Cocok untuk: Menukar dimensi, variabel, dan atribut dengan alat yang kompatibel

Kurang cocok untuk: Menebak format internal hanya dari ekstensi

HDF5

Cocok untuk: Mengelola grup dan array secara hierarkis

Kurang cocok untuk: Mengabaikan tujuan tautan eksternal atau filter wajib

Zarr

Cocok untuk: Mengelola chunk array dalam penyimpanan

Kurang cocok untuk: Menyalin metadata saja dan menganggap transfer selesai

Periksa sebelum mengekspor

  • Simpan sumber dan parameter. Checksum yang sama memverifikasi transfer, bukan satuan atau interpretasi ilmiah.
  • Atribut dan koordinat dapat memuat informasi rahasia. Jangan masukkan kredensial penyimpanan ke berkas bersama; periksa izin.

Perbandingan terkait

Panduan

Referensi dan spesifikasi