.. highlightlang:: us

.. _griddata:

griddata
========

.. index:: griddata

.. us.tag  griddata GERMAN interpol-2d New5200

:ref:`griddata` erzeugt ein reguläres Netz aus beliebig verteilten Daten.

.. function::  rmZi = griddata(rvX, rvY, rvZ, rvXi, rvYi)
    rmZi = griddata(rvX, rvY, rvZ, rvXi, rvYi, nOption)
    rmZi = griddata(rvX, rvY, rvZ, rvXi, rvYi, ssOption)

.. us.return

**Returnwert**

*rmZi* sind die zu *rvXi*, *rvYi* gehörenden interpolierten Werte. Falls
ein Fehler  aufgetreten ist, enthält die Variable *rmZi* ein Error-Objekt
(siehe Beispiel).

.. us.params

**Parameter**

.. uparam:: rvX
   
   *rvX* ist ein reeller Vektor mit mindestens 4 Werten mit x-Koordinaten .
   

.. uparam:: rvY
   
   *rvY* ist ein reeller Vektor  mit mindestens 4 Werten mit y-Koordinaten 
   und der gleichen Länge wie *rvX*.
   

.. uparam:: rvZ
   
   *rvY* ist ein reeller Vektor mit z-Koordinaten und der gleichen Länge wie
   *rvX*.
   

.. uparam:: rvXi
   
   *rvXi* ist ein reeller Vektor mit mindestens einer Koordinate. 
   

.. uparam:: rvYi
   
   *rvYi* ist ein reeller Vektor mit mindestens einer Koordinate. 
   

.. uparam:: nOption
   
   Siehe *ssOption*.
   

.. uparam:: ssOption
   
   Ist eine der folgenden Zeichenketten:

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

      * - ssOption
        - nOption
        - 
      * - "linear"
        - 1
        - Lineare Interpolation. (Default)
      * - "cubic"
        - 2
        - Kubische Spline-Interpolation.
      * - "tps" oder "thin-plate-spline"
        - 3
        - Thin-Plate-Spline-Interpolation.
      * - "poly1" oder "plane"
        - 4
        - Ebene.
      * - "poly2"
        - 5
        - Polynom 2. Ordnung.
      * - "poly3"
        - 6
        - Polynom 3. Ordnung.
      * - "interp1d-bilinear"
        - 7
        - Bilineare 1D-Interpolation.

.. us.example

**Beispiel**

Falls ein Fehler auftritt, gibt :ref:`griddata` ein Error-Objekt zurück (siehe
auch :ref:`error_create`). 

::

   def test_griddata()
   {
       srand(1);
       x = rand(100, 1)*15-7.5;
       y = rand(100, 1)*15-7.5;
       r = sqrt(x.*x + y.*y);
       z = sin(r)./r;
       xi = linspace(-7.5, 7.5, 40)
       yi = xi;
       zi = griddata(x, y, z, xi, yi, "thin-plate-spline");
       if (type(zi) == "error") {
           MessageBoxError(zi.message);
           return FALSE;
       }
       plotxyz(xi, yi, zi);
       return TRUE;
   }

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.20
     - Neu.

.. seealso::
   :ref:`uberblick-mathematik`,
   :ref:`fspline2`, :ref:`smooth2`, :ref:`XYZGetInterpolationType`

:sub:`id-1546570`