.. highlightlang:: us

.. _nc_mapinterpolation:

NC_MapInterpolation
===================

.. index:: NC_MapInterpolation

.. us.tag  NC_MapInterpolation GERMAN nc.tools New590

:ref:`NC_MapInterpolation` berechnet durch Interpolation aus Kennfeldern
zusätzliche Kanäle in einer netCDF Datei (NC-Datei). 

.. function::  bool = NC_MapInterpolation(ssNCMap, ssXMap, ssYMap, svZMap, ssNCFile, ssXChanName, ssYChanName)

.. us.return

**Returnwert**

bool

.. us.params

**Parameter**

.. uparam:: ssNCMap

   *ssNCMap* ist der Name einer netCDF Datei mit den Kennfeldern. Die Datei 
   wird zum Lesen geöffnet.

.. uparam:: ssXMap

   *ssXMap* ist der Name des Kanals, der die x-Koordinaten 
   in der Kennfeld-Datei enthält.

.. uparam:: ssYMap

   *ssYMap* ist der Name des Kanals, der die y-Koordinaten 
   in der Kennfeld-Datei enthält.

.. uparam:: svZMap

   *ssYMap* ist ein Vektor mit den Namen der Kanäle, die die z-Koordinaten 
   in der Kennfeld-Datei enthalten. 

.. uparam:: ssNCFile

   *ssNCFile* ist der Name einer netCDF Datei in die die aus den Kennfeldern
   interpolierten Kanaäle geschrieben werden. Die Datei wird zum Schreiben geöffnet.

.. uparam:: ssXChanName

   *ssXChanName* ist der Name des Kanals, der die x-Koordinaten für die Interpolation
   im der Kennfeld enthält.

.. uparam:: ssYChanName

   *ssYChanName* ist der Name des Kanals, der die y-Koordinaten für die Interpolation
   im Kennfeld enthält. Die Kanäle *ssXChanName* und *ssYChanName*  müssen 
   die gleiche Anzahl an Punkten enthalten.

.. us.comment

**Kommentar**

Die Funktion berechnet aus den Kanälen *ssXMap*, *ssYMap*, *svZMap* 
Kennfelder mit dem Interpolationsverfahren Thin-Plate-Spline.

Aus der Datei *ssNCFile* werden die Kanäle *ssXChanName* und *ssYChanName*
geladen. Die Kanäle müssen die gleiche physikalische Einheit und in etwa den
gleichen Wertebereich wie die Kanäle *ssXMap* und *ssYMap* enthalten. 
Falls die Koordinaten außerhalb des Kennfeldes liegen, werden die z-Koordinaten
über eine Extrapolation berechnet.

Der berechnete Vektor mit den z-Koordianten hat die gleiche Länge wie
der Kanal *ssXChanName*. Die Daten werden in der Datei *ssNCFile* 
gespeichert. Als Kanalname und Einheit wird der entsprechende
Name aus dem Parameter *svZMap* verwendet.

Falls das Kennfeld nicht berechnet werden kann, wird der entsprechende
Kanal in der Datei *ssNCFile* mit missing_values aufgefüllt.

.. us.example

**Beispiel**

::

   ssNCMap = "c:/programme/uniplot/samples/kennfeld.nc";
   ssXMap = "N"
   ssYMap = "EWGMOM"
   svZMap = ["BEEWG", "Pans"]
   ssNCFile = "c:/programme/uniplot/samples/vollast.nc";
   ssXChanName = "N"
   ssYChanName = "MEFF"

   NC_MapInterpolation(ssNCMap, ssXMap, ssYMap, svZMap, ssNCFile, ssXChanName, ssYChanName)

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.9.0
     - Neue Funktion.

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`nc_create`,
   :ref:`DialogBox`,
   :ref:`CreateListBoxText`

:sub:`id-301498`