.. highlightlang:: us

.. index:: nc_create

.. _nc_create:

nc_create
=========

.. us.tag  nc_create GERMAN NC_open Changed560 Changed5400 Changed5509

:ref:`nc_create` erzeugt eine neue UniPlot-Datendatei oder eine netCDF-Datei.

.. function::  ncid = nc_create(ssFileName)
               ncid = nc_create(ssFileName, nCreateMode)

.. us.return

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

.. us.params

**Parameter**

.. uparam:: ssFileName

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

.. uparam:: nCreateMode

   *nCreateMode* ist entweder ``NC_CLOBBER`` oder ``NC_NOCLOBBER``:

   .. list-table::
      :header-rows: 1

      * - 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:

   .. list-table::
      :header-rows: 1

      * - 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:

   .. list-table::
      :header-rows: 1

      * - 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``.

.. us.example

**Beispiel**

.. highlightlang:: us

::

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

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - 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 :ref:`uberblick-netcdf-dateien`).

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`nc_open`,
   :ref:`nc_close`

:sub:`id-1641987`