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);
ncid3 = nc_create("test3.nc", NC_CLOBBER);

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).

id-1641987