NCCSV -

ΑNetCDF-Συμβατή προδιαγραφή αρχείων ASCII CSV, Έκδοση 1.00

Μπομπ Σάιμονς και Στιβ Χάνκιν "NCCSV" από Bob Simons και Steve Hankin είναι αδειοδοτημένος απόCC με 4.0

Εισαγωγή

Αυτό το έγγραφο ορίζει μια μορφή αρχείου κειμένου ASCII CSV που μπορεί να περιέχει όλες τις πληροφορίες (μεταδεδομένα και δεδομένα) που μπορεί να βρεθεί σεNetCDF .ncαρχείο που περιέχει έναν πίνακα δεδομένων τύπου αρχείου CSV. Η επέκταση αρχείου για ένα αρχείο κειμένου ASCII CSV μετά από αυτή την προδιαγραφή πρέπει να είναι .csv έτσι ώστε να μπορεί να διαβαστεί εύκολα και σωστά σε προγράμματα υπολογιστικών φύλλων όπως το Excel και τα Φύλλα Google. Bob Simons θα γράψει το λογισμικό για να μετατρέψει ένα αρχείο NCCSV σε έναNetCDF-3 (και ίσως επίσηςNetCDF-4) .ncαρχείο, και το αντίστροφο, χωρίς απώλεια πληροφοριών. Ο Μπομπ Σάιμονς έχει αλλάξει.ERDDAP™για την υποστήριξη ανάγνωσης και εγγραφής αυτού του τύπου αρχείου.

Η μορφή NCCSV έχει σχεδιαστεί έτσι ώστε λογισμικό υπολογιστικών φύλλων όπως το Excel και τα Φύλλα Google να μπορούν να εισάγουν ένα αρχείο NCCSV ως αρχείο csv, με όλες τις πληροφορίες στα κύτταρα του υπολογιστικού φύλλου έτοιμα για επεξεργασία. Ή, ένα λογιστικό φύλλο μπορεί να δημιουργηθεί από το μηδέν μετά τις συμβάσεις NCCSV. Ανεξάρτητα από την πηγή του υπολογιστικού φύλλου, αν στη συνέχεια εξαχθεί ως αρχείο .csv, θα συμμορφωθεί με τις προδιαγραφές NCCSV και δεν θα χαθούν πληροφορίες. Οι μόνες διαφορές μεταξύ των αρχείων NCCSV και των αναλογικών αρχείων υπολογιστικών φύλλων που ακολουθούν αυτές τις συμβάσεις είναι:

• Τα αρχεία NCCSV έχουν τιμές σε μια γραμμή που χωρίζεται με κόμματα. Τα λογιστικά φύλλα έχουν τιμές σε μια γραμμή σε παρακείμενα κελιά.
• Οι συμβολοσειρές στα αρχεία NCCSV συχνά περιβάλλονται από διπλά εισαγωγικά. Οι συμβολοσειρές στα λογιστικά φύλλα δεν περιβάλλονται ποτέ από διπλά εισαγωγικά.
• Εσωτερικά διπλά εισαγωγικά (") Στις συμβολοσειρές στα αρχεία NCCSV εμφανίζονται ως 2 διπλά εισαγωγικά. Τα εσωτερικά διπλά εισαγωγικά σε λογιστικά φύλλα εμφανίζονται ως 1 διπλό απόσπασμα.

Δείτε τοΛογιστικό φύλλοενότητα παρακάτω για περισσότερες πληροφορίες.

Ροή

Όπως τα αρχεία CSV γενικά, τα αρχεία NCCSV είναι διαθέσιμα. Έτσι, εάν ένα NCSV παράγεται on-the-fly από έναν εξυπηρετητή δεδομένων όπωςERDDAP™, ο διακομιστής μπορεί να αρχίσει να μεταδίδει δεδομένα στον αιτούντα πριν από τη συγκέντρωση όλων των δεδομένων. Αυτό είναι ένα χρήσιμο και επιθυμητό χαρακτηριστικό.NetCDFτα αρχεία, αντίθετα, δεν μπορούν να κυκλοφορήσουν.

ERDDAP™

Αυτή η προδιαγραφή έχει σχεδιαστεί έτσι ώστε NCCSV αρχεία και το.ncαρχεία που μπορούν να δημιουργηθούν από αυτά μπορούν να χρησιμοποιηθούν από έναERDDAP™Διακομιστής δεδομένων (μέσω τηςΠίνακας EDDFromNccsvFilesκαιΠίνακας EDD από αρχείαNcΤύποι συνόλου δεδομένων) , αλλά αυτή η προδιαγραφή είναι εξωτερικήERDDAP.ERDDAP™έχει αρκετά απαιτούμενα παγκόσμια χαρακτηριστικά και πολλά συνιστώμενα παγκόσμια και μεταβλητά χαρακτηριστικά, κυρίως με βάση τα χαρακτηριστικά CF και ACDD (βλέπε /docs/server-admin/datasets#global-attributes).

Υπόλοιπο

Ο σχεδιασμός της μορφής NCCSV είναι μια ισορροπία πολλών απαιτήσεων:

• Τα αρχεία πρέπει να περιέχουν όλα τα δεδομένα και τα μεταδεδομένα που θα ήταν σε μια καρτέλαNetCDFαρχείο, συμπεριλαμβανομένων συγκεκριμένων τύπων δεδομένων.
• Τα αρχεία πρέπει να είναι σε θέση να διαβαστούν και στη συνέχεια να γράφονται από ένα λογιστικό φύλλο χωρίς απώλεια πληροφοριών.
• Τα αρχεία πρέπει να είναι εύκολο για τους ανθρώπους να δημιουργήσουν, να επεξεργαστούν, να διαβάσουν και να κατανοήσουν.
• Τα αρχεία πρέπει να είναι σε θέση να αναλυθούν σαφώς από τα προγράμματα υπολογιστών.

Εάν κάποια απαίτηση σε αυτό το έγγραφο φαίνεται περίεργη ή επιλεκτική, είναι πιθανόν να χρειαστεί να ικανοποιηθεί μία από αυτές τις απαιτήσεις.

Άλλες προδιαγραφές

Αυτή η προδιαγραφή αναφέρεται σε αρκετές άλλες προδιαγραφές και βιβλιοθήκες με τις οποίες έχει σχεδιαστεί για να λειτουργεί, αλλά αυτή η προδιαγραφή δεν αποτελεί μέρος κάποιας από αυτές τις άλλες προδιαγραφές, ούτε χρειάζεται καμία αλλαγή σε αυτές, ούτε έρχεται σε σύγκρουση με αυτές. Εάν μια λεπτομέρεια που σχετίζεται με ένα από αυτά τα πρότυπα δεν προσδιορίζεται εδώ, δείτε τις σχετικές προδιαγραφές. Αυτό περιλαμβάνει κυρίως:

• Η σύμβαση χαρακτηριστικών για την ανακάλυψη του συνόλου δεδομένων (ACDD) Πρότυπο μεταδεδομένων: https://wiki.esipfed.org/Attribute\_Convention\_for\_Data\_Discovery\_1-3 .
• Κλίμα και Πρόβλεψη (ΚΦ) Πρότυπο μεταδεδομένων: https://cfconventions.org/Data/cf-conventions/cf-conventions-1.8/cf-conventions.html .
• ΗNetCDFΟδηγός χρήστη (NUG) : https://docs.unidata.ucar.edu/netcdf-java/current/userguide/index.html .
• ΗNetCDFβιβλιοθήκες λογισμικού όπωςNetCDF- Ιάβα καιNetCDF-Γ: https://www.unidata.ucar.edu/software/netcdf/ . Αυτές οι βιβλιοθήκες δεν μπορούν να διαβάσουν αρχεία NCCSV, αλλά μπορούν να διαβάσουν.ncαρχεία που δημιουργήθηκαν από αρχεία NCCSV.
• ΤΖΣΟΝ: https://www.json.org/

Σημείωση

Στην παρούσα προδιαγραφή, παρενθέσεις,\[ \], δηλώνουν τα προαιρετικά στοιχεία.

Δομή αρχείου

Ένα πλήρες αρχείο NCCSV αποτελείται από δύο τμήματα: το τμήμα μεταδεδομένων, ακολουθούμενο από το τμήμα δεδομένων.

Τα αρχεία NCCSV πρέπει να περιέχουν μόνο 7-bit χαρακτήρες ASCII. Εξαιτίας αυτού, το σύνολο χαρακτήρων ή η κωδικοποίηση που χρησιμοποιείται για την εγγραφή και ανάγνωση του αρχείου μπορεί να είναι οποιοδήποτε σύνολο χαρακτήρων ή κωδικοποίηση που είναι συμβατό με το σύνολο χαρακτήρων 7-bit ASCII, π.χ., ISO-889-1.ERDDAP™διαβάζει και γράφει αρχεία NCCSV με το σύνολο χαρακτήρων ISO-8859-1.

Τα αρχεία NCCSV μπορούν να χρησιμοποιούν είτε νέα γραμμή (\n) (που είναι κοινό στους υπολογιστές Linux και Mac OS X) ή μεταφοράΕπιστροφή συν νέα γραμμή (\r\n) (που είναι κοινό στους υπολογιστές των Windows) ως δείκτες τέλους γραμμής, αλλά όχι και τα δύο.

.nccsvΜεταδεδομένα

Όταν τόσο ο δημιουργός όσο και ο αναγνώστης το περιμένουν, είναι επίσης δυνατό και μερικές φορές χρήσιμο να γίνει μια παραλλαγή ενός αρχείου NCCSV το οποίο περιέχει μόνο το τμήμα μεταδεδομένων (συμπεριλαμβανομένων των\*ΤΕΛΟΣ\_ΜΕΤΑΔΑΤΑ\*γραμμή) . Το αποτέλεσμα παρέχει πλήρη περιγραφή των χαρακτηριστικών του αρχείου, των μεταβλητών ονομάτων και των τύπων δεδομένων, εξυπηρετώντας έτσι τον ίδιο σκοπό με το .das plus .dds απαντήσεις από έναOPeNDAPΔιακομιστής.ERDDAP™θα επιστρέψει αυτή την παραλλαγή αν ζητήσετε το αρχείο Τύπος =.nccsvΜεταδεδομένα από έναERDDAP™Σύστημα δεδομένων.

Το τμήμα μεταδεδομένων

Σε ένα αρχείο NCCSV, κάθε γραμμή του τμήματος μεταδεδομένων χρησιμοποιεί τη μορφή μεταβλητή Όνομα,χαρακτηριστικό Όνομα,τιμή1\[, αξία2\]\[, αξία3\]\[, αξία4\]\[...\]
Χώροι πριν ή μετά τα αντικείμενα δεν επιτρέπονται επειδή προκαλούν προβλήματα κατά την εισαγωγή του αρχείου σε προγράμματα υπολογιστικών φύλλων.

Συμβάσεις

Η πρώτη γραμμή ενός αρχείου NCCSV είναι η πρώτη γραμμή του τμήματος μεταδεδομένων και πρέπει να έχει ένα\ΠΑΓΚΟΣΜΙΑ\Οι συμβάσεις αποδίδουν τον κατάλογο όλων των συμβάσεων που χρησιμοποιούνται στο αρχείο ως συμβολοσειρές που περιέχουν κατάλογο CSV, για παράδειγμα: \ΠΑΓΚΟΣΜΙΑ\,συμβάσεις,"COARDS, CF-1,6, ACDD-1,3, NCCSV-1,0" Μία από τις συμβάσεις που απαριθμούνται πρέπει να είναι η NCCSV-1.0, η οποία αναφέρεται στην τρέχουσα έκδοση της παρούσας προδιαγραφής.

ΤΕΛΟΣ_ΜΕΤΑΔΑΤΑ

Το τέλος του τμήματος μεταδεδομένων ενός αρχείου NCCSV πρέπει να υποδεικνύεται από μια γραμμή με μόνο \ΤΕΛΟΣ\_ΜΕΤΑΔΑΤΑ\

Συνιστάται αλλά δεν απαιτείται όλα τα χαρακτηριστικά για μια δεδομένη μεταβλητή να εμφανίζονται σε παρακείμενες γραμμές του τμήματος μεταδεδομένων. Εάν ένα αρχείο NCCSV μετατραπεί σε έναNetCDFαρχείο, η σειρά που η μεταβλητήNames πρωτοεμφανίζεται στην ενότητα μεταδεδομένων θα είναι η σειρά των μεταβλητών στηνNetCDFΑρχείο.

Προαιρετικές κενές γραμμές επιτρέπονται στην ενότητα μεταδεδομένων μετά την απαιτούμενη πρώτη γραμμή με\ΠΑΓΚΟΣΜΙΑ\ ΣυμβάσειςΠληροφορίες (Βλέπε παρακάτω) και πριν από την απαιτούμενη τελευταία γραμμή με\ΤΕΛΟΣ\_ΜΕΤΑΔΑΤΑ\.

Εάν ένα λογιστικό φύλλο δημιουργηθεί από ένα αρχείο NCCSV, το τμήμα δεδομένων μεταδεδομένων θα εμφανιστεί με μεταβλητά ονόματα στη στήλη Α, να αποδοθούν ονόματα στη στήλη Β, και τιμές στη στήλη Γ.

Εάν ένα λογιστικό φύλλο που ακολουθεί αυτές τις συμβάσεις αποθηκεύεται ως αρχείο CSV, συχνά θα υπάρχουν επιπλέον κόμματα στο τέλος των γραμμών στο τμήμα μεταδεδομένων. Το λογισμικό που μετατρέπει τα αρχεία NCCSV σε.ncαρχεία θα αγνοήσουν τα επιπλέον κόμματα.

μεταβλητή Όνομα

μεταβλητή Όνομα είναι το όνομα μιας μεταβλητής στο αρχείο δεδομένων. Όλες οι μεταβλητές ονομασίες πρέπει να ξεκινούν με ένα γράμμα ASCII 7-bit ή υπογράμμιση και να αποτελούνται από γράμματα ASCII 7-bit, υποδείκτες και ψηφία ASCII 7-bit.

ΠΑΓΚΟΣΜΙΑ

Η ειδική μεταβλητήName\ΠΑΓΚΟΣΜΙΑ\χρησιμοποιείται για να υποδηλώσει τα παγκόσμια μεταδεδομένα.

χαρακτηριστικό Όνομα

χαρακτηριστικό Όνομα είναι το ευαίσθητο στην περίπτωση όνομα ενός χαρακτηριστικού που συνδέεται με μια μεταβλητή ή\ΠΑΓΚΟΣΜΙΑ\. Όλες οι ονομασίες χαρακτηριστικών πρέπει να αρχίζουν με ένα γράμμα ASCII 7-bit ή υπογράμμιση και να αποτελούνται από γράμματα ASCII 7-bit, υποδείκτες και ψηφία ASCII 7-bit.

ΣΚΑΛΑΡΙ

Το ειδικό χαρακτηριστικό Όνομα\*ΣΚΑΛΑΡΙ\*μπορεί να χρησιμοποιηθεί για τη δημιουργία μιας κυμαινόμενης μεταβλητής δεδομένων και τον ορισμό της τιμής της. Ο τύπος των δεδομένων\*ΣΚΑΛΑΡΙ\*ορίζει τον τύπο δεδομένων για τη μεταβλητή, οπότε μην ορίζετε ένα\*ΔΕΔΟΜΕΝΑ\_ΤΥΠΟ\*χαρακτηριστικό για τις κλιμακωτές μεταβλητές. Σημειώστε ότι δεν πρέπει να υπάρχουν δεδομένα για τη κλιμακωτή μεταβλητή στο τμήμα δεδομένων του αρχείου NCCSV.

Για παράδειγμα, για να δημιουργήσετε μια κλιμακωτή μεταβλητή που ονομάζεται "πλοίο" με την τιμή "Okeanos Explorer" και ένα χαρακτηριστικό cf\_role, χρησιμοποιήστε: πλοίο,\ΣΚΑΛΑΡΙ\,"Οκεανός Explorer" πλοίο,cf\_role,trajectory\_id Όταν μια κλιμακωτή μεταβλητή δεδομένων διαβάζεται σεERDDAP™, η κλιμακωτή τιμή μετατρέπεται σε στήλη στον πίνακα δεδομένων με την ίδια τιμή σε κάθε γραμμή.

τιμή

τιμή είναι η τιμή του χαρακτηριστικού μεταδεδομένων και πρέπει να είναι μια σειρά με ένα ή περισσότερα είτε byte, σύντομο, int, μακρύ, πλωτήρα, διπλό, String, ή char. Δεν υποστηρίζονται άλλοι τύποι δεδομένων. Χαρακτηριστικά χωρίς αξία θα αγνοηθούν. Εάν υπάρχουν περισσότερες από μία υπο-τιμές, οι υπο-τιμές πρέπει να είναι όλες του ίδιου τύπου δεδομένων και να διαχωρίζονται με κόμματα, για παράδειγμα: sst,actual\_range,0.17στ,23.58στ Εάν υπάρχουν πολλαπλές τιμές συμβολοσειράς, χρησιμοποιήστε μια μόνο συμβολοσειρά με\n (νέα γραμμή) χαρακτήρες που χωρίζουν τις υποχορδώσεις.

Οι ορισμοί των τύπων στοιχείων χαρακτηριστικών γνωρίσματα είναι:

byte (αντίγραφο)

• τιμές χαρακτηριστικού byte (8-bit, υπογεγραμμένο) πρέπει να είναι γραμμένο με το επίθημα 'β', π.χ., -7β, 0β, 7β. Το εύρος των έγκυρων τιμών byte είναι -128 έως 127. Ένας αριθμός που μοιάζει με byte αλλά δεν είναι έγκυρος (π.χ. 128b) θα δημιουργήσει ένα μήνυμα σφάλματος.  

σύντομο

• βραχείες τιμές χαρακτηριστικού (16-bit, υπογεγραμμένο) πρέπει να είναι γραμμένο με το επίθημα 's', π.χ. -30000s, 0s, 30000s. Το εύρος των έγκυρων βραχέων τιμών είναι -32768 έως 32767. Ένας αριθμός που μοιάζει με σύντομο αλλά είναι άκυρος (π.χ., 32768s) θα δημιουργήσει ένα μήνυμα σφάλματος.  

int

• τιμές χαρακτηριστικού int (32-bit, υπογεγραμμένο) πρέπει να γράφονται ως ints JSON χωρίς δεκαδικό ψηφίο ή εκθέτη, αλλά με το επίθημα 'i', π.χ., -12067978i, 0i, 12067978i. Το εύρος των έγκυρων τιμών int είναι -2147483648 έως 2147483647. Ένας αριθμός που μοιάζει με int αλλά είναι άκυρος (π.χ., 2147483648i) θα δημιουργήσει ένα μήνυμα σφάλματος.  

μακρύ

• μεγάλες τιμές ιδιοτήτων (64-bit, υπογεγραμμένο, υποστηρίζεται σήμερα από NUG καιERDDAP™αλλά δεν υποστηρίζεται ακόμη από την ΚΙ) πρέπει να γράφεται χωρίς δεκαδικό ψηφίο και με το επίθημα 'L', π.χ., -12345678787654321L, 0L, 12345678987654321L. Εάν χρησιμοποιείτε το λογισμικό μετατροπής για να μετατρέψετε ένα αρχείο NCCSV με μεγάλες τιμές σε έναNetCDF-3 αρχείο, τυχόν μεγάλες τιμές θα μετατραπεί σε διπλές τιμές. Το εύρος των έγκυρων μεγάλων τιμών είναι -9223372036854775808 έως 9223372036854775807. Ένας αριθμός που μοιάζει με μακρύ αλλά είναι άκυρος (π.χ., 9223372036854775808L) θα δημιουργήσει ένα μήνυμα σφάλματος.  

πλωτήρας

• τιμές ιδιοτήτων επίπλευσης (32-bit) πρέπει να γράφεται με το επίθημα «f» και μπορεί να έχει δεκαδικό ή/και εκθέτη, π.χ., 0f, 1f, 12.34f, 1e12f, 1.23e+12f, 1.23e12f, 1.87E-7f. Χρήση NaNf για πλωτήρα NaN (λείπει) αξία. Το εύρος των πλωτήρων είναι περίπου +/- 3.40282347E+38f (~7 σημαντικά δεκαδικά ψηφία) . Ένας αριθμός που μοιάζει με άρμα αλλά δεν είναι έγκυρος (π.χ. 1,0e39f) θα δημιουργήσει ένα μήνυμα σφάλματος.  

διπλό

• διπλάσιες τιμές ιδιοτήτων (64-bit) πρέπει να γράφεται με το επίθημα 'd' και μπορεί να έχει δεκαδικό ή/και εκθέτη, π.χ., 0d, 1d, 12.34d, 1e12d, 1.23e+12d, 1.23e12d, 1.87E-7d. Χρήση του NaNd για διπλό NaN (λείπει) αξία. Το εύρος των διπλών είναι περίπου +/-1.79769313486231570E+308d (~15 σημαντικά δεκαδικά ψηφία) . Ένας αριθμός που μοιάζει με διπλό αλλά είναι άκυρος. (π.χ., 1.0e309d) θα δημιουργήσει ένα μήνυμα σφάλματος.  

Στρινγκ

• Οι τιμές χαρακτηριστικού συμβολοσειράς είναι μια ακολουθία χαρακτήρων UCS-2 (Δηλαδή, χαρακτήρες Unicode 2-byte, όπως στηνJava) , η οποία πρέπει να γραφτεί ως 7-bit ASCII, JSON-όπως συμβολοσειρές, έτσι ώστε να μπορούν να προσδιοριστούν οι μη-ASCII χαρακτήρες.
  • Διπλά εισαγωγικά (") πρέπει να κωδικοποιηθεί ως δύο διπλά εισαγωγικά (~) . Αυτό απαιτούν τα προγράμματα υπολογιστικών φύλλων κατά την ανάγνωση αρχείων .csv. Αυτό γράφουν τα προγράμματα υπολογιστικών φύλλων όταν αποθηκεύετε ένα υπολογιστικό φύλλο ως αρχείο .csv.
  • Οι ειδικοί χαρακτήρες JSON πρέπει να κωδικοποιούνται όπως στο JSON (κυρίως\n(νεογραμμή), αλλά και \\ ( (επιστροφή πλάτης), \ff (ανατροφοδότηση), \ t (ταμπ), \r (επιστροφή φορτίου) ή με το\ - Ναι. σύνταξη. Σε ένα λογιστικό φύλλο, μην χρησιμοποιείτε το Alt Enter για να καθορίσετε μια νέα γραμμή μέσα σε ένα κελί κειμένου.\n (2 χαρακτήρες: backslash και 'n ") για να δείξει μια νέα γραμμή.

\uhhhη

• Όλοι οι χαρακτήρες λιγότεροι από τον χαρακτήρα #32 ή μεγαλύτεροι από τον χαρακτήρα #126, και όχι αλλιώς κωδικοποιημένοι, πρέπει να κωδικοποιούνται με το συντακτικό \u - Ναι. , όπου hhhhh είναι ο τετραψήφιος δεκαεξαδικός αριθμός του χαρακτήρα, π.χ., το σύμβολο Euro είναι \u20AC. Βλέπε τις σελίδες κωδικών που αναφέρονται στο https://en.wikipedia.org/wiki/Unicode να βρείτε τους δεκαεξαδικούς αριθμούς που σχετίζονται με συγκεκριμένους χαρακτήρες Unicode, ή να χρησιμοποιήσετε μια βιβλιοθήκη λογισμικού.
• Εάν η συμβολοσειρά έχει χώρο στην αρχή ή στο τέλος, ή περιλαμβάνει " (διπλή προσφορά) ή ένα κόμμα, ή περιέχει τιμές που διαφορετικά θα ερμηνευόταν ως κάποιος άλλος τύπος δεδομένων (π.χ. ένα int) , ή είναι η λέξη "null", ολόκληρη η συμβολοσειρά πρέπει να περικλείεται σε δύο εισαγωγικά; διαφορετικά, σε αντίθεση με JSON, το περικλείοντας δύο εισαγωγικά είναι προαιρετική. Σας συνιστούμε: όταν έχετε αμφιβολίες, να περικλείσετε ολόκληρο το String σε διπλά εισαγωγικά. Οι χώροι στην αρχή ή στο τέλος ενός String αποθαρρύνονται έντονα.
• Προς το παρόν, η χρήση χαρακτήρων μεγαλύτερων από το #255 αποθαρρύνεται. Το NCCSV τους υποστηρίζει.ERDDAP™τους υποστηρίζει εσωτερικά. Μερικοί τύποι αρχείων εξόδου τους υποστηρίζουν (π.χ.,.jsonκαι.nccsv) . Αλλά πολλοί τύποι αρχείων εξόδου δεν τους υποστηρίζουν. Για παράδειγμα,NetCDF-3 αρχεία δεν υποστηρίζουν τέτοιους χαρακτήρες επειδήNetCDFαρχεία χρησιμοποιούν χαρακτήρες 1-byte και CF επί του παρόντος δεν έχει ένα σύστημα για τον προσδιορισμό του πώς Unicode χαρακτήρες κωδικοποιούνται στοNetCDFΕνώσεις (π.χ., UTF-8) . Αυτό πιθανότατα θα βελτιωθεί με την πάροδο του χρόνου.  

Χαρ

• char τιμές ιδιοτήτων είναι ένας ενιαίος χαρακτήρας UCS-2 (Δηλαδή, χαρακτήρες Unicode 2-byte, όπως στηνJava) , η οποία πρέπει να γραφτεί ως 7-bit ASCII, JSON-όπως χαρακτήρες έτσι ώστε άλλοι χαρακτήρες μπορούν να προσδιοριστούν (δείτε τον ορισμό συμβολοσειρών παραπάνω για την κωδικοποίηση των ειδικών χαρακτήρων, με την προσθήκη της κωδικοποίησης ένα ενιαίο απόσπασμα ως \ ") . Οι τιμές χαρακτηριστικών Char πρέπει να περικλείονται σε μεμονωμένες εισαγωγικές τιμές (τα εσωτερικά εισαγωγικά) και διπλά εισαγωγικά (τα εξωτερικά αποσπάσματα) , π.χ., "'' """"""""""""",· (χαρακτήρας διπλής φράσης) , "'\"""""""""· (ένας μοναδικός χαρακτήρας φράσης) , "'\t"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""") (καρτέλα) , "'\u20AC'" (ένας χαρακτήρας ευρώ) . Αυτό το σύστημα χρήσης μονών και διπλών εισαγωγικών είναι περίεργο και δυσκίνητο, αλλά είναι ένας τρόπος να διακρίνουμε τις αξίες χαρακτήρων από τις συμβολοσειρές με τρόπο που λειτουργεί με υπολογιστικά φύλλα. Μια τιμή που μοιάζει με ένα char αλλά είναι άκυρη θα δημιουργήσει ένα μήνυμα σφάλματος. Όπως και με τα Strings, η χρήση χαρακτήρων μεγαλύτερων από το #255 αποθαρρύνεται σήμερα.

Επίθημα

Σημειώστε ότι στο τμήμα ιδιοτήτων ενός αρχείου NCCSV, όλες οι αριθμητικές τιμές χαρακτηριστικών πρέπει να έχουν ένα γράμμα επιθήματος (π.χ., «β») για τον προσδιορισμό του αριθμητικού τύπου δεδομένων (π.χ. byte) . Αλλά στο τμήμα δεδομένων ενός αρχείου NCCSV, οι αριθμητικές τιμές δεδομένων δεν πρέπει ποτέ να έχουν αυτά τα επιθήματα γράμματα (με εξαίρεση το «L» για ακεραίους μεγάλης διάρκειας) — ο τύπος των δεδομένων καθορίζεται από το\*ΔΕΔΟΜΕΝΑ\_ΤΥΠΟ\*χαρακτηριστικό για τη μεταβλητή.

DATA_TYPE

Ο τύπος δεδομένων για κάθε μη-φολίδεςη μεταβλητή πρέπει να προσδιορίζεται από ένα\*ΔΕΔΟΜΕΝΑ\_ΤΥΠΟ\*χαρακτηριστικό που μπορεί να έχει τιμή byte, σύντομη, int, long, float, double, String, ή char (περίπτωση αναίσθητη) . Για παράδειγμα, qc\_flag,\ΔΕΔΟΜΕΝΑ\_ΤΥΠΟ\,byte ΠΡΟΕΙΔΟΠΟΙΗΣΗ: Προσδιορίζοντας το σωστό\*ΔΕΔΟΜΕΝΑ\_ΤΥΠΟ\*είναι δική σου ευθύνη. Καθορισμός λανθασμένου τύπου δεδομένων (π.χ., int όταν θα έπρεπε να έχετε ορίσει πλωτήρα) δεν θα δημιουργήσει ένα μήνυμα σφάλματος και μπορεί να προκαλέσει απώλεια πληροφοριών (π.χ., οι τιμές επίπλευσης θα στρογγυλοποιούνται σε μονάδες) όταν το αρχείο NCCSV διαβάζεται απόERDDAP™ή να μετατραπεί σε αNetCDFΑρχείο.

Η Χαρ Αποθαρρυμένη

Η χρήση των τιμών δεδομένων χαρακτήρων αποθαρρύνεται επειδή δεν υποστηρίζονται ευρέως σε άλλους τύπους αρχείων. τιμές χαρακτήρων μπορούν να γραφούν στην ενότητα δεδομένων ως ενιαίοι χαρακτήρες ή ως συμβολοσειρές (Ειδικότερα, αν χρειάζεται να γράψετε έναν ιδιαίτερο χαρακτήρα) . Αν βρεθεί μια συμβολοσειρά, ο πρώτος χαρακτήρας της συμβολοσειράς θα χρησιμοποιηθεί ως τιμή του char. Μηδέν μήκος συμβολοσειρές και ελλείπουσες τιμές θα μετατραπεί σε χαρακτήρα \uFFFF. Σημειώστε ότιNetCDFαρχεία υποστηρίζουν μόνο ένα byte chars, έτσι ώστε οποιαδήποτε chars μεγαλύτερο από το # 255 char θα μετατραπεί σε '?' όταν γράφετεNetCDFαρχεία. Αν δεν χρησιμοποιηθεί ένα χαρακτηριστικό χαρακτήρων για τον προσδιορισμό ενός διαφορετικού συνόλου χαρακτήρων για μια μεταβλητή χαρακτήρων, θα χρησιμοποιηθεί το σύνολο χαρακτήρων ISO-8859-1.

Μακροχρόνια Αποθαρρυμένη

Αν και πολλοί τύποι αρχείων (π.χ.,NetCDF-4 και Json) καιERDDAP™υποστήριξη των μεγάλων τιμών δεδομένων, η χρήση των τιμών των μακρών δεδομένων στα αρχεία NCCSV είναι προς το παρόν αποθαρρυνθεί, επειδή δεν υποστηρίζονται σήμερα από το Excel, CF καιNetCDF-3 αρχεία. Αν θέλετε να καθορίσετε μεγάλες τιμές δεδομένων σε ένα αρχείο NCCSV (ή στο αντίστοιχο λογιστικό φύλλο Excel) , θα πρέπει να χρησιμοποιήσετε το επίθημα 'L' έτσι ώστε το Excel δεν αντιμετωπίζει τους αριθμούς ως αριθμούς κινητής υποδιαστολής με χαμηλότερη ακρίβεια. Επί του παρόντος, αν ένα αρχείο NCCSV μετατρέπεται σε έναNetCDF-3.ncαρχείο, μεγάλες τιμές δεδομένων θα μετατραπεί σε διπλές τιμές, προκαλώντας απώλεια ακρίβειας για πολύ μεγάλες τιμές (Ίσης ή ανώτερης του -2^53) .

CF, ACDD, καιERDDAP™Μεταδεδομένα

Δεδομένου ότι προβλέπεται ότι τα περισσότερα αρχεία NCCSV, ή.ncαρχεία που δημιουργήθηκαν από αυτούς, θα διαβαστούν στοERDDAP, συνιστάται έντονα ότι τα αρχεία NCCSV περιλαμβάνουν τα χαρακτηριστικά μεταδεδομένων που απαιτούνται ή συνιστώνται απόERDDAP™(βλέπε /docs/server-admin/datasets#global-attributes). Τα χαρακτηριστικά είναι σχεδόν όλα από τα πρότυπα μεταδεδομένων CF και ACDD και χρησιμεύουν για την ορθή περιγραφή του συνόλου δεδομένων (Ποιος, τι, πότε, πού, γιατί, πώς) σε κάποιον που διαφορετικά δεν ξέρει τίποτα για το σύνολο δεδομένων. Ιδιαίτερης σημασίας, σχεδόν όλες οι αριθμητικές μεταβλητές θα πρέπει να έχουν ένα χαρακτηριστικό μονάδων μεUDUNITS-συμβατή τιμή, π.χ., sst, μονάδες, βαθμός\_C

Είναι καλό να περιλαμβάνονται πρόσθετα χαρακτηριστικά που δεν προέρχονται από τα πρότυπα CF ή ACDD ή απόERDDAP.

Το τμήμα δεδομένων

Δομή

Η πρώτη γραμμή του τμήματος δεδομένων πρέπει να έχει έναν κατάλογο μεταβλητών ονομάτων ευαίσθητο στην περίπτωση, χωρισμένο με κόμματα. Όλες οι μεταβλητές του παρόντος καταλόγου πρέπει να περιγράφονται στο τμήμα μεταδεδομένων, και αντίστροφα (εκτός\ΠΑΓΚΟΣΜΙΑ\χαρακτηριστικά και\ΣΚΑΛΑΡΙ\μεταβλητές) .

Η δεύτερη μέσω των προτελευταίων γραμμών του τμήματος δεδομένων πρέπει να έχει έναν κατά κόμμα χωρισμένο κατάλογο τιμών. Κάθε σειρά δεδομένων πρέπει να έχει τον ίδιο αριθμό τιμών με τον κατά κόμμα χωρισμένο κατάλογο ονομάτων μεταβλητών. Οι χώροι πριν ή μετά τις τιμές δεν επιτρέπονται επειδή προκαλούν προβλήματα κατά την εισαγωγή του αρχείου σε προγράμματα υπολογιστικών φύλλων. Κάθε στήλη του παρόντος τμήματος πρέπει να περιέχει μόνο τις τιμές του\*ΔΕΔΟΜΕΝΑ\_ΤΥΠΟ\*που καθορίζονται για τη μεταβλητή αυτή από το\*ΔΕΔΟΜΕΝΑ\_ΤΥΠΟ\*χαρακτηριστικό για τη μεταβλητή αυτή. Σε αντίθεση με την ενότητα ιδιοτήτων, οι αριθμητικές τιμές στην ενότητα δεδομένων δεν πρέπει να έχουν γράμματα επιθήματος για να υποδηλώσουν τον τύπο δεδομένων. Σε αντίθεση με την ενότητα ιδιοτήτων, οι τιμές char στην ενότητα δεδομένων μπορεί να παραλείψουν τα περικλείοντας μονά εισαγωγικά αν δεν είναι απαραίτητα για την αποπροσανατολισμό (Συνεπώς, τα «,» και «\» πρέπει να αναφέρονται όπως φαίνεται εδώ) . Μπορεί να υπάρχει οποιοσδήποτε αριθμός αυτών των γραμμών δεδομένων σε ένα αρχείο NCCSV, αλλά προς το παρόνERDDAP™μπορεί να διαβάσει μόνο αρχεία NCCSV με έως περίπου 2 δισεκατομμύρια σειρές. Γενικά, συνιστάται να διαχωρίσετε μεγάλα σύνολα δεδομένων σε πολλαπλά αρχεία δεδομένων NCCSV με λιγότερες από 1 εκατομμύριο σειρές το καθένα.

Τέλος δεδομένων

Το τέλος του τμήματος δεδομένων πρέπει να υποδεικνύεται από γραμμή με μόνο \ΤΕΛΟΣ\_DATA\

Εάν υπάρχει πρόσθετο περιεχόμενο στο αρχείο NCCSV μετά την\*ΤΕΛΟΣ\_DATA\*γραμμή, θα αγνοηθεί όταν το αρχείο NCCSV μετατραπεί σε ένα.ncΑρχείο. Συνεπώς, το περιεχόμενο αυτό αποθαρρύνεται.

Σε ένα λογιστικό φύλλο που ακολουθεί αυτές τις συμβάσεις, οι μεταβλητές ονομασίες και τιμές δεδομένων θα είναι σε πολλαπλές στήλες. Δείτε το παράδειγμα παρακάτω.

Αγνοούμενες τιμές

Οι αριθμητικές τιμές που λείπουν μπορούν να γράφονται ως αριθμητική τιμή που προσδιορίζεται από έναmissing\_valueή \_FillValue χαρακτηριστικό για τη μεταβλητή αυτή. Για παράδειγμα, δείτε τη δεύτερη τιμή σε αυτή τη γραμμή δεδομένων: Μπελ Μ. Σιμάντα, 99,123,4 Αυτός είναι ο συνιστώμενος τρόπος χειρισμού των τιμών που λείπουν για byte, σύντομο, int, και μακρές μεταβλητές.

Οι τιμές επίπλευσης ή διπλής NaN μπορούν να γράφονται ως NaN. Για παράδειγμα, δείτε τη δεύτερη τιμή σε αυτή τη γραμμή δεδομένων: Μπελ Μ. Σιμάντα, Νάν.123.4

Οι τιμές συμβολοσειράς και αριθμητικών ελλειπουσών τιμών μπορούν να υποδεικνύονται από ένα κενό πεδίο. Για παράδειγμα, δείτε τη δεύτερη τιμή σε αυτή τη γραμμή δεδομένων: Μπελ Μ. Σιμάντα, 123,4

Για τις μεταβλητές byte, short, int και long, η χρησιμότητα μετατροπέα NCCSV καιERDDAP™θα μετατρέψει ένα κενό πεδίο στη μέγιστη επιτρεπόμενη τιμή για αυτόν τον τύπο δεδομένων (π.χ., 127 για bytes) . Εάν το κάνετε αυτό, βεβαιωθείτε ότι προσθέσετε amissing\_valueή \_FillValue χαρακτηριστικό για τη μεταβλητή αυτή για τον προσδιορισμό αυτής της τιμής, π.χ. μεταβλητή Όνομα ,\_FillValue,127β Για πλωτήρες και διπλές μεταβλητές, ένα κενό πεδίο θα μετατραπεί σε NaN.

Τιμές ημερομηνίας ώρας

Τιμές ημερομηνίας (συμπεριλαμβανομένων των τιμών ημερομηνίας που δεν έχουν χρονική συνιστώσα) μπορούν να εκπροσωπούνται ως αριθμοί ή ως συμβολοσειρές σε αρχεία NCCSV. Μια δοσμένη μεταβλητή χρόνου ημερομηνίας μπορεί να έχει μόνο τιμές συμβολοσειρών ή μόνο αριθμητικές τιμές, όχι και οι δύο. Το λογισμικό NCCSV θα μετατρέψει τις τιμές του χρόνου συμβολοσειρών σε αριθμητική ημερομηνία Τιμές χρόνου κατά τη δημιουργία.ncαρχεία (όπως απαιτείται από την ΚΙ) . Οι τιμές του χρόνου συμβολοσειράς έχουν το πλεονέκτημα ότι είναι εύκολα αναγνώσιμες από τους ανθρώπους.

Οι τιμές DateTime που αντιπροσωπεύονται ως αριθμητικές τιμές πρέπει να έχουν ένα χαρακτηριστικό μονάδων που καθορίζει το " μονάδες από ημερομηνία Χρόνος " όπως απαιτείται από την ΚΙ και καθορίζεται απόUDUNITS, π.χ., Χρόνος, μονάδες, δευτερόλεπτα από 1970-01-01T00:00:00Z

Οι τιμές DateTime που αντιπροσωπεύονται ως τιμές συμβολοσειράς πρέπει να έχουν συμβολοσειρά\*ΔΕΔΟΜΕΝΑ\_ΤΥΠΟ\*χαρακτηριστικό γνώρισμα και χαρακτηριστικό μονάδων που προσδιορίζει ημερομηνία Χρονικό πρότυπο όπως καθορίζεται από τοJavaΗμερομηνίαTimeFormatter class ( https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html ) . Για παράδειγμα, Χρόνος, μονάδες,yyyy-MM-dd"T'HH:mm:ssZ" Όλες οι τιμές χρόνου ημερομηνίας για μια δεδομένη μεταβλητή δεδομένων πρέπει να χρησιμοποιούν την ίδια μορφή. Στις περισσότερες περιπτώσεις, το μοτίβο ημερομηνίαςTime που χρειάζεστε για το χαρακτηριστικό μονάδων θα είναι μια παραλλαγή ενός από αυτούς τους τύπους:

• yyyy-MM-dd"T'HH:mm:ss. SSSZ — που είναι το ISO 8601:2004 (E) ημερομηνία Μορφή χρόνου. Μπορεί να χρειαστείτε μια συντομευμένη έκδοση αυτού, π.χ.,yyyy-MM-dd"T'HH:mm:ssZ" (η μόνη συνιστώμενη μορφή) ήyyyy-MM-dd. Εάν αλλάζετε τη μορφή των τιμών σας dateTime, το NCCSV συνιστά έντονα την αλλαγή σε αυτή τη μορφή (Ίσως να συντομευτεί.) . Αυτή είναι η μορφή πουERDDAP™θα χρησιμοποιηθεί όταν γράφει αρχεία NCCSV.
• EYMMddHmmss.SSS — που είναι η συμπαγής έκδοση της ημερομηνίας ISO 8601:2004 Μορφή χρόνου. Μπορεί να χρειαστείτε μια συντομευμένη έκδοση αυτού, π.χ., eYMMdd.
• M/η/εεεεε Χ:χμμ:σσ. SSS — η οποία χειρίζεται US-style ημερομηνίες και ημερομηνίες όπως "3/23/2017 16:22:03.000". Μπορεί να χρειαστείτε μια συντομευμένη έκδοση αυτού, π.χ., M/d/yyyy.
• yyyuddDHhmmssSS — το οποίο είναι το έτος συν την ημέρα μηδενικής προσθήκης του έτους (π.χ., 001 = 1 Ιαν. 365 = 31 Δεκ. σε μη διαθέσιμο έτος· αυτό μερικές φορές λανθασμένα ονομάζεται Ιουλιανή ημερομηνία.) . Μπορεί να χρειαστείτε μια συντομευμένη έκδοση αυτού, π.χ. yyyuddD .

Ακρίβεια

Όταν μια βιβλιοθήκη λογισμικού μετατρέπει ένα.ncαρχείο σε αρχείο NCCSV, όλη την ημερομηνία Οι τιμές χρόνου θα γραφτούν ως συμβολοσειρές με το ISO 8601:2004 (E) ημερομηνία Μορφή χρόνου, χ.χ., 1970-01-01T00:00:00Z . Μπορείτε να ελέγξετε την ακρίβεια με τοERDDAP-ειδικό χαρακτηριστικόtime\_precision. Βλέπεις; /docs/server-admin/datasets#time\_precision.

Ζώνη ώρας

Η προκαθορισμένη ζώνη ώρας για την ημερομηνία Τιμές χρόνου είναι ηZulu (ή GMT) ζώνη ώρας, η οποία δεν έχει περίοδο θερινής ώρας. Εάν μια μεταβλητή dateTime έχει τιμές dateTime από μια διαφορετική ζώνη ώρας, θα πρέπει να διευκρινίσετε αυτό με τοERDDAP-ειδικό χαρακτηριστικόtime\_zone. Αυτό είναι μια απαίτηση γιαERDDAP™(βλέπε /docs/server-admin/datasets#time\_zone).

Τιμές Βαθμού

Όπως απαιτείται από την ΚΙ, όλες οι τιμές βαθμού (π.χ. για το γεωγραφικό μήκος και το γεωγραφικό πλάτος) πρέπει να προσδιορίζονται ως διπλάσιες τιμές δεκαδικού βαθμού, όχι ως συμβολοσειρές ή ως ξεχωριστές μεταβλητές για μοίρες, λεπτά, δευτερόλεπτα. Οι σχεδιαστές κατεύθυνσης N, S, E και W δεν επιτρέπονται. Χρήση αρνητικών τιμών για τα δυτικά γεωγραφικά πλάτη και για τα νότια γεωγραφικά πλάτη.

DSG Τύποι χαρακτηριστικών

Ένα αρχείο NCCSV μπορεί να περιέχει CF Διακριτή Γεωμετρία δειγματοληψίας ( https://cfconventions.org/Data/cf-conventions/cf-conventions-1.8/cf-conventions.html#discrete-sampling-geometries ) δεδομένα. Είναι τα χαρακτηριστικά που κάνουν αυτό το έργο:

1. Όπως απαιτείται από το CF, το αρχείο NCCSV πρέπει να περιλαμβάνει μια γραμμή στο τμήμα μεταδεδομένων που προσδιορίζει το\ΠΑΓΚΟΣΜΙΑ\ featureTypeχαρακτηριστικό γνώρισμα, π.χ. \ΠΑΓΚΟΣΜΙΑ\,featureType,εκδοτική
2. Για χρήση σεERDDAP™, το αρχείο NCCSV πρέπει να περιλαμβάνει μια γραμμή ή γραμμές στο τμήμα μεταδεδομένων που προσδιορίζουν τις μεταβλητές cf\_role=...\_id, π.χ., πλοίο,cf\_role,trajectory\_id Αυτό είναι προαιρετικό για την ΚΙ, αλλά απαιτείται στο NCCSV.
3. Για χρήση σεERDDAP™, το αρχείο NCCSV πρέπει να περιλαμβάνει μια γραμμή ή γραμμές στο τμήμα μεταδεδομένων που προσδιορίζουν ποιες μεταβλητές συνδέονται με κάθε χρονοσειρά, τροχιά ή προφίλ, όπως απαιτείται απόERDDAP™(βλέπε /docs/server-admin/datasets#cdm\_data\_type), π.χ., \ΠΑΓΚΟΣΜΙΑ\,cdm\_trajectory\_variables,"ship" ή \ΠΑΓΚΟΣΜΙΑ\,cdm\_timeseries\_Variables,"station\_id,lat,lon"

Αρχείο δειγμάτων

Εδώ είναι ένα αρχείο δειγμάτων που δείχνει πολλά από τα χαρακτηριστικά ενός αρχείου NCCSV:

\\*GLOBAL\\*,Conventions,"COARDS, CF-1.6, ACDD-1.3, NCCSV-1.0"
\\*GLOBAL\\*,cdm\\_trajectory\\_variables,"ship"
\\*GLOBAL\\*,creator\\_email,erd.data@noaa.gov
\\*GLOBAL\\*,creator\\_name,Bob Simons
\\*GLOBAL\\*,creator\\_type,person
\\*GLOBAL\\*,creator\\_url,https://www.pfeg.noaa.gov
\\*GLOBAL\\*,featureType,trajectory
\\*GLOBAL\\*,infoUrl,https://erddap.github.io/docs/user/nccsv-1.00
\\*GLOBAL\\*,institution,"NOAA NMFS SWFSC ERD, NOAA PMEL"
\\*GLOBAL\\*,license,"""NCCSV Demonstration"" by Bob Simons and Steve Hankin is
    licensed under CC BY 4.0, https://creativecommons.org/licenses/by/4.0/ ."
\\*GLOBAL\\*,keywords,"NOAA, sea, ship, sst, surface, temperature, trajectory"
\\*GLOBAL\\*,standard\\_name\\_vocabulary,CF Standard Name Table v55
\\*GLOBAL\\*,subsetVariables,"ship"
\\*GLOBAL\\*,summary,"This is a paragraph or two describing the dataset."
\\*GLOBAL\\*,title,"NCCSV Demonstration"
ship,\\*DATA\\_TYPE\\*,String
ship,cf\\_role,trajectory\\_id
time,\\*DATA\\_TYPE\\*,String
time,standard\\_name,time
time,units,"yyyy-MM-dd'T'HH:mm:ssZ"
lat,\\*DATA\\_TYPE\\*,double
lat,units,degrees\\_north
lon,\\*DATA\\_TYPE\\*,double
"lon","units","degrees\\_east"
status,\\*DATA\\_TYPE\\*,char
status,comment,"From http://some.url.gov/someProjectDocument , Table C"
testLong,\\*DATA\\_TYPE\\*,long
testLong,units,1
sst,\\*DATA\\_TYPE\\*,float
sst,standard\\_name,sea\\_surface\\_temperature
sst,actual\\_range,0.17f,23.58f
sst,units,degree\\_C
sst,missing\\_value,99f
sst,testBytes,-128b,0b,127b
sst,testShorts,-32768s,0s,32767s
sst,testInts,-2147483648i,0i,2147483647i
sst,testLongs,-9223372036854775808L,0L,9223372036854775807L
sst,testFloats,-3.40282347e38f,0f,3.40282347E+38f
sst,testDoubles,-1.79769313486231570e308d,0d,1.79769313486231570E+308d
sst,testChars,"','","'""'","'\\u20AC'"
sst,testStrings," a~,\\n'z""\\u20AC"

\\*END\\_METADATA\\*
ship,time,lat,lon,status,testLong,sst
Bell M. Shimada,2017-03-23T00:45:00Z,28.0002,-130.2576,A,-9223372036854775808L,10.9
Bell M. Shimada,2017-03-23T01:45:00Z,28.0003,-130.3472,\\u20AC,-1234567890123456L,
"Bell M. Shimada","2017-03-23T02:45:00Z",28.0001,-130.4305,"'\\t'",0L,10.7
Bell M. Shimada,2017-03-23T12:45:00Z,27.9998,-131.5578,"'""'",1234567890123456L,99
Bell M. Shimada,2017-03-23T21:45:00Z,28.0003,-132.0014,\\u00fc,9223372036854775806L,10.0
Bell M. Shimada,2017-03-23T23:45:00Z,28.0002,-132.1591,,NaN

Σημειώσεις:

• Αυτό το αρχείο δειγμάτων περιλαμβάνει πολλές δύσκολες περιπτώσεις (π.χ., char και μεγάλες μεταβλητές και δύσκολες τιμές συμβολοσειρών) . Τα περισσότερα αρχεία NCCSV θα είναι πολύ απλούστερα.
• Η γραμμή της άδειας είναι σπασμένη σε δύο γραμμές εδώ, αλλά είναι μόνο μια γραμμή στο αρχείο του δείγματος.
• \ u20AC είναι η κωδικοποίηση του χαρακτήρα του ευρώ και u00FC είναι η κωδικοποίηση του ü.
• Πολλά Οι συμβολοσειρές στο παράδειγμα περικλείονται από διπλά εισαγωγικά παρόλο που δεν χρειάζεται να είναι, π. χ. πολλά καθολικά χαρακτηριστικά συμπεριλαμβανομένου του τίτλου, των μονάδων lon χαρακτηριστικό, και η 3η γραμμή δεδομένων.)
• Θα ήταν σαφέστερο και καλύτερο αν οι μονάδες χαρακτηριστικό για τη μεταβλητή testLong γραφόταν σε διπλά εισαγωγικά που δείχνουν ότι είναι μια τιμή συμβολοσειρών. Αλλά η τρέχουσα αναπαράσταση (1, χωρίς εισαγωγικά) θα ερμηνευθεί σωστά ως String, όχι ακέραιος, επειδή δεν υπάρχει "i" επίθημα.
• Σε αντίθεση με άλλους τύπους αριθμητικών δεδομένων, οι μεγάλες τιμές στην ενότητα δεδομένων έχουν το επίθημα ("L") που προσδιορίζει τον αριθμητικό τους τύπο δεδομένων. Αυτό απαιτείται για να αποτραπεί η ερμηνεία των υπολογιστικών φύλλων ως αριθμών κινητής υποδιαστολής και έτσι να χαθεί η ακρίβεια.

Λογιστικά φύλλα

Σε ένα λογιστικό φύλλο, όπως σε ένα αρχείο NCCSV:

• Γράψτε αριθμητικές τιμές ιδιοτήτων όπως ορίζονται για τα αρχεία NCCSV (π.χ., με επίθητο γράμμα, π.χ., «f», για τον προσδιορισμό του τύπου δεδομένων του χαρακτηριστικού) .
• Σε συμβολοσειρές, γράψτε όλους τους χαρακτήρες λιγότερους από τον χαρακτήρα ASCII #32 ή μεγαλύτερους από τον χαρακτήρα #126 είτε ως χαρακτήρας που μοιάζει με JSON (π.χ.,\nγια νέα γραμμή) ή ως δεκαεξαδικός αριθμός χαρακτήρων Unicode (περίπτωση αναίσθητη) με τη σύνταξη\ - Ναι. (π.χ. \u20AC για το σήμα ευρώ) . Χρήση\n (2 χαρακτήρες: backslash και 'n ") για να δείξει μια νέα γραμμή, όχι Alt Enter.

Οι μόνες διαφορές μεταξύ των αρχείων NCCSV και του αναλογικού λογιστικού φύλλου που ακολουθούν αυτές τις συμβάσεις είναι:

• Τα αρχεία NCCSV έχουν τιμές σε μια γραμμή που χωρίζεται με κόμματα. Τα λογιστικά φύλλα έχουν τιμές σε μια γραμμή σε παρακείμενα κελιά.
• Οι συμβολοσειρές στα αρχεία NCCSV συχνά περιβάλλονται από διπλά εισαγωγικά. Οι συμβολοσειρές στα λογιστικά φύλλα δεν περιβάλλονται ποτέ από διπλά εισαγωγικά.
• Εσωτερικά διπλά εισαγωγικά (") Στις συμβολοσειρές στα αρχεία NCCSV εμφανίζονται ως 2 διπλά εισαγωγικά. Τα εσωτερικά διπλά εισαγωγικά σε λογιστικά φύλλα εμφανίζονται ως 1 διπλό απόσπασμα.

Εάν ένα λογιστικό φύλλο που ακολουθεί αυτές τις συμβάσεις αποθηκεύεται ως αρχείο CSV, θα υπάρχουν συχνά επιπλέον κόμματα στο τέλος πολλών από τις γραμμές. Το λογισμικό που μετατρέπει τα αρχεία NCCSV σε.ncαρχεία θα αγνοήσουν τα επιπλέον κόμματα.

Excel

Για την εισαγωγή ενός αρχείου NCCSV στο Excel:

1. Επιλογή αρχείου : Άνοιγμα .
2. Αλλαγή του τύπου αρχείου σε αρχεία κειμένου (\.πρν.\.txt; \*.csv) .
3. Αναζήτηση των καταλόγων και κάντε κλικ στο αρχείο NCCSV .csv.
4. Κάντε κλικ στο Άνοιγμα .

Για να δημιουργήσετε ένα αρχείο NCCSV από ένα υπολογιστικό φύλλο Excel:

1. Επιλογή αρχείου : Αποθήκευση ως .
2. Αλλαγή της αποθήκευσης ως τύπου: να είναι CSV (Οριοθετημένα κόμματα) (\*.csv) .
3. Σε απάντηση της προειδοποίησης συμβατότητας, πατήστε Ναι .
4. Το αρχείο .csv που προκύπτει θα έχει επιπλέον κόμματα στο τέλος όλων των γραμμών εκτός των γραμμών CSV. Μπορείς να τους αγνοήσεις.

Στο Excel, το δείγμα NCCSV αρχείο παραπάνω εμφανίζεται ως

Φύλλα Google

Για την εισαγωγή ενός αρχείου NCCSV στα Φύλλα Google:

1. Επιλογή αρχείου : Άνοιγμα .
2. Επιλέξτε να φορτώσετε ένα αρχείο και κάντε κλικ στο Αποστολή ενός αρχείου από τον υπολογιστή σας . Επιλέξτε το αρχείο και κάντε κλικ στο Open .

Ή, επιλέξτε My Drive και να αλλάξετε τον τύπο αρχείου πτώση προς τα κάτω επιλογή σε όλους τους τύπους αρχείων . Επιλέξτε το αρχείο και κάντε κλικ στο Open .

Για να δημιουργήσετε ένα αρχείο NCCSV από ένα υπολογιστικό φύλλο φύλλων Google:

1. Επιλογή αρχείου : Αποθήκευση ως .
2. Αλλαγή της αποθήκευσης ως τύπου: να είναι CSV (Οριοθετημένα κόμματα) (\*.csv) .
3. Σε απάντηση της προειδοποίησης συμβατότητας, πατήστε Ναι .
4. Το αρχείο .csv που προκύπτει θα έχει επιπλέον κόμματα στο τέλος όλων των γραμμών εκτός των γραμμών CSV. Αγνόησέ τους.

Προβλήματα/Προειδοποιήσεις

• Αν δημιουργήσετε ένα αρχείο NCCSV με έναν επεξεργαστή κειμένου ή αν δημιουργήσετε ένα ανάλογο λογιστικό φύλλο σε ένα πρόγραμμα υπολογιστικού φύλλου, ο επεξεργαστής κειμένου ή το πρόγραμμα υπολογιστικού φύλλου δεν θα ελέγξει ότι ακολουθήσατε σωστά αυτές τις συμβάσεις. Εναπόκειται σε εσάς να ακολουθήσετε σωστά αυτές τις συνελεύσεις.
• Η μετατροπή ενός λογιστικού φύλλου μετά την παρούσα σύμβαση σε αρχείο csv (Συνεπώς, ένας φάκελος NCCSV) θα οδηγήσει σε επιπλέον κόμματα στο τέλος όλων των γραμμών εκτός των γραμμών δεδομένων CSV. Αγνόησέ τους. Το λογισμικό στη συνέχεια μετατρέπει τα αρχεία NCCSV σε.ncΤα αρχεία θα τα αγνοήσουν.
• Εάν ένα αρχείο NCCSV έχει περίσσεια κόμματα στο τέλος των γραμμών, μπορείτε να τα αφαιρέσετε με τη μετατροπή του αρχείου NCCSV σε έναNetCDFαρχείο και στη συνέχεια τη μετατροπή τουNetCDFαρχείο πίσω σε ένα αρχείο NCCSV.
• Όταν προσπαθείτε να μετατρέψετε ένα αρχείο NCCSV σε έναNetCDFαρχείο, κάποια λάθη θα ανιχνευθούν από το λογισμικό και θα δημιουργήσουν μηνύματα σφάλματος, προκαλώντας την αποτυχία της μετατροπής. Άλλα προβλήματα είναι δύσκολο ή αδύνατο να πιαστούν και δεν θα δημιουργήσουν μηνύματα σφάλματος ή προειδοποιήσεις. Άλλα προβλήματα (π.χ., πλεονάζοντα κόμματα στο τέλος των γραμμών) Θα αγνοηθεί. Ο μετατροπέας αρχείων θα κάνει μόνο ελάχιστο έλεγχο της ορθότητας του προκύπτοντοςNetCDFαρχείο, π.χ. όσον αφορά τη συμμόρφωση με το ΚΙ. Είναι ευθύνη του δημιουργού αρχείων και του χρήστη αρχείων να ελέγχει ότι τα αποτελέσματα της μετατροπής είναι το ίδιο επιθυμητά και σωστά. Δύο τρόποι ελέγχου είναι:
  • Εκτύπωση των περιεχομένων του.ncαρχείο με ncdump ( https://linux.die.net/man/1/ncdump ) .
  • Προβολή των περιεχομένων των δεδομένωνERDDAP.