nc_varget_missing

nc_varget_missing liest Daten einer Variablen aus einer netCDF-Datei. Fehlende Werte werden auf den Wert MISSING_VALUE gesetzt. Die Datei muss sich im Daten-Modus befinden.

values = nc_varget_missing(ncid, varid)

values = nc_varget_missing(ncid, varid, rvStart, rvCount)

values = nc_varget_missing(ncid, varid, rvStart, rvCount, bCharAsByte)

Returnwert

values ist ein Vektor oder eine Matrix von Zahlen oder eine Zeichenkette.

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.

bCharAsByte

Falls bCharAsByte TRUE (1) ist, werden die Buchstaben (Datentype = NC_CHAR) als Byte-Werte zurückgegeben. Für andere Datentypen hat der Parameter keine Bedeutung. Default Wert ist FALSE (0).

Kommentar

Falls die Dimension 1 ist, wird ein Zeilen-Vektor zurückgegeben.

Falls die Dimension 2 ist, wird eine Matrix zurückgegeben, und falls die Dimension größer als 2 ist, wird ein Spalten-Vektor zurückgegeben. Beim Datentyp NC_CHAR wird ein skalare Zeichenkette zurück gegeben.

Die Funktion entspricht der Funktion nc_varget. Beim Lesen 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.

Siehe auch

Überblick UniPlot-Datendateien, nc_create, nc_open, nc_endef, nc_redef, nc_varput_missing, nc_varput, strchar

_id-1255526