Guide
Controlli prima di consegnare array scientifici
Consegna array netCDF, HDF5 o Zarr con significato, dipendenze e requisiti di lettura. Oltre alla scelta del formato tabulare, verifica dimensioni e valori mancanti.
Quale formato scegliere?
Scegli in base al ruolo di ogni file nel flusso di lavoro.
- Documentare il significato
- Preparare l'unità di distribuzione
- Confrontare i valori a destinazione
Documentare il significato
Registra variabili, tipi, ordine delle dimensioni, coordinate, unità e convenzioni temporali. Non equiparare valori mancanti o di riempimento a zero. Con scale_factor e add_offset, distingui valori memorizzati e decodificati.
Preparare l'unità di distribuzione
Verifica variante netCDF, destinazioni dei collegamenti esterni e filtri HDF5, versione e codec Zarr. Includi metadati e blocchi necessari; distingui blocchi intenzionalmente non memorizzati secondo fill_value dalle omissioni nel trasferimento.
Confrontare i valori a destinazione
Consegna una versione con scrittura completata e leggi sezioni campione con la libreria destinataria. Confronta forma, assi, attributi, maschere e valori decodificati con la fonte. Documenta tolleranze di arrotondamento o perdite.
Formati da considerare
netCDF
Adatto per: Scambiare dimensioni, variabili e attributi con strumenti compatibili
Meno adatto per: Deducere il formato interno dalla sola estensione
HDF5
Adatto per: Organizzare gruppi e array gerarchicamente
Meno adatto per: Omettere destinazioni esterne o filtri necessari
Zarr
Adatto per: Gestire blocchi di array in uno storage
Meno adatto per: Copiare solo metadati e considerare il trasferimento completo
Cosa controllare prima dell’esportazione
- Conserva fonti e parametri. Checksum uguali verificano il trasferimento, non le unità o l'interpretazione scientifica.
- Attributi e coordinate possono contenere informazioni riservate. Non inserire credenziali nei file condivisi; verifica i permessi.