nc_varput_missing¶
nc_varput_missing schreibt Daten in eine
netCDF-Variable in eine geöffnete netCDF-Datei, die sich im
Daten-Modus befinden muss. Fehlende Werte müssen den Wert
MISSING_VALUE enthalten.
-
r = nc_varput_missing(ncid, varid, rvStart, rvCount, values) -
r = nc_varput_missing(ncid, varid, rvStart, rvCount, values, bCharAsByte)
Returnwert
r hat den Wert -1, falls ein Fehler beim Schreiben auftritt.
Parameter
-
ncid ncid ist die Zugriffsnummer, die von einem erfolgreichen Aufruf der Funktionen nc_create oder nc_open geliefert wurde.
-
varid varid ist die Identifikations-Nummer einer Variablen.
-
rvStart rvStart ist ein Vektor mit Werten, der die Startpositionen für das Schreiben der Daten festlegt. Die Vektor-Elemente müssen den Dimensionen der Variablen in Reihenfolge und Anzahl entsprechen. Die Startpositionen beginnen bei 0.
-
rvCount rvCount ist ein Vektor, der die Anzahl zu schreibender Werte definiert. Der Vektor-Elemente müssen den Dimensionen der Variablen in Reihenfolge und Anzahl entsprechen. Die Anzahl muss mindestens 1 betragen.
-
values values ist ein Vektor oder eine Matrix von Zahlen oder eine Zeichenkette.
-
bCharAsByte Falls bCharAsByte TRUE (1) ist, werden die Buchstaben (Datentyp = NC_CHAR) als byte-Werte übergeben. Für andere Datentypen hat der Parameter keine Bedeutung. Default Wert ist FALSE (0).
Kommentar
Die Funktion entspricht der Funktion nc_varput. Beim Schreiben der Daten werden
jedoch Zahlenwerte, die den Wert MISSING_VALUE enthalten, in missing values
umgesetzt, wie in der Datei durch das Attribut missing_value vorgegeben.
Falls das Attribut nicht in der NC-Datei vorhanden ist, wird für Daten im Format
NC_FLOAT der Wert MISSING_FLOAT und für
NC_DOUBLE der Wert MISSING_DOUBLE verwendet.
Beispiel
ncid = nc_create("d:/test.nc");
dimid = nc_dimdef(ncid, "n", 8);
varid = nc_vardef(ncid, "channel", NC_FLOAT, dimid);
nc_attput(ncid, varid, "missing_value", NC_FLOAT, -99);
nc_endef(ncid);
// translate MISSING_VALUE (10e10) to -99
nc_varput_missing(ncid, varid, 3, 4, [3,MISSING_VALUE,5,6]);
nc_close(ncid);
Siehe auch
Überblick UniPlot-Datendateien, nc_create, nc_dimdef, nc_vardef, nc_endef, nc_redef, nc_close, nc_varget, nc_varget_missing, nc_varput, strcode
id-1253990