.. highlightlang:: us

.. index:: NC_MergeFiles

.. _NC_MergeFiles:

NC_MergeFiles
=============

.. us.tag  NC_MergeFiles GERMAN nc.tools New5708

:ref:`NC_MergeFiles` erzeugt eine neue NC-Datei aus den Kanälen mehrerer 
Dateien. Die Kanäle werden der Datei zugefügt.

.. function::  oError = NC_MergeFiles(svNCAdd, ssNCDest)

.. us.return

**Returnwert**

Der Returnwert ist 0 oder enthält ein Error-Objekt, siehe :ref:`error_create`.

.. us.params

**Parameter**

.. uparam:: svNCAdd

   *svNCAdd* ist ein Vektor mit den Namen der NC-Dateien.

.. uparam:: ssNCDest

   *ssNCDest* ist der Name unter dem die neue Datei gespeichert wird.

.. us.comment

**Kommentar**

Die globalen Attribute werden von der ersten angegebenen Datei übernommen.
Falls eine Matrix die gleiche Anzahl an Datenrecords enthält, werden die 
Daten in die gleiche Matrix geschrieben.

.. us.example

**Beispiel**

::

   svNCAdd = "C:\\nc-daten\\" +  ...
    ["Test1.xls.nc2",
     "Test2.xls.nc2",
     "Test3.xls.nc2",
     "Test4.xls.nc2"];

   ssNewName = "d:/a.nc";

   oError = NC_MergeFiles(svNCAdd, ssNewName);
   if (type(oError) == "error") {
      MessageBoxError(oError.message);
   } else {
      NC_Edit(ssNewName);
   }

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2018.8
     - Neu

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`nc_create`,
   :ref:`NC_AddFiles`

:sub:`id-1712210`