nc_create

nc_create erzeugt eine neue UniPlot-Datendatei oder eine netCDF-Datei.

ncid = nc_create(ssFileName)

ncid = nc_create(ssFileName, nCreateMode)

Returnwert

ncid ist eine Zugriffsnummer, die auf die erzeugte Datei verweist. Falls bei der Erzeugung der Datei ein Fehler auftritt, erhält ncid den Wert -1.

Parameter

ssFileName

ssFileName ist der Name der UniPlot-Datendatei die erzeugt werden soll. Dateinamenserweiterung sollte .nc2 bei UniPlot-Datendateien sein. Bei der Erzeugung von netCDF-Dateien sollte die Endung .nc verwendet werden.

nCreateMode

nCreateMode ist entweder NC_CLOBBER oder NC_NOCLOBBER:

Wert	Bedeutung
NC_CLOBBER	(Default) Falls eine Datei mit dem Namen ssFileName bereits existiert, wird sie gelöscht und neu erzeugt.
NC_NOCLOBBER	Falls eine Datei mit dem Namen ssFileName bereits existiert, wird sie nicht überschrieben. ncid erhält in diesem Fall den Wert -1.

Zusätzlich kann das Dateiformat angegeben werden:

Name	Wert	Bedeutung
NC_FORMAT_CLASSIC	0x0	netCDF-Datei erzeugen.
NC_FORMAT_PC	0x10000	Beim Schreiben wird die Byte-Reihenfolge vom Intel 80x86-Prozessor (little endian byte order) verwendet. Die erzeugten Dateien sind nicht mehr kompatibel zu netCDF-Dateien. Die Option ist veraltet und sollte nicht mehr verwendet werden.
NC_FORMAT_UP	0x20000	(Default) UniPlot-Datendatei erzeugen. Die Dateien sind komprimiert.

Falls UniPlot-Datendateien (NC_FORMAT_UP) erzeugt werden, können noch die folgenden Optionen verwendet werden:

Name	Wert	Bedeutung
NC_ZLIB_COMPRESSION	0x40000	Es wird eine verbesserte Kompression verwendet. Das Schreiben/Lesen ist deutlich langsamer, aber die Dateien sind etwa 30% kleiner.
NC_LZ4_COMPRESSION	0x100000	Sehr schnelle Kompression, siehe https://code.google.com/p/lz4/. Wird zur Zeit noch nicht verwendet, da die Dateien zu älteren UniPlots nicht kompatibel wären.
NC_REPACKING	0x80000	Falls Attribute oder Kanäle gelöscht werden, wird die Datei direkt verkleinert. Falls dieses Flag nicht angegeben wird, wird der freie Platz für später erzeugte Attribute und Kanäle verwendet.

Das Flag NC_COMPRESSION (veraltet) entspricht NC_ZLIB_COMPRESSION.

Beispiel

ncid = nc_create("test.nc2");
ncid2 = nc_create("test2.nc2", NC_CLOBBER | NC_FORMAT_UP);

History

Version	Beschreibung
R2013.9	NC_LZ4_COMPRESSION.
R2012.0	Aufruf mit einem Parameter. Für nCreateMode wird dann NC_CLOBBER | NC_FORMAT_UP verwendet.
5.6.0	Neues Datei-Format mit neuen Flags NC_FORMAT_UP, NC_COMPRESSION und NC_REPACKING (siehe Überblick UniPlot-Datendateien).

Siehe auch

Überblick UniPlot-Datendateien, nc_open, nc_close

_id-1641987