.. highlightlang:: us

.. _rspline:

rspline
=======

.. index:: rspline

.. us.tag  rspline GERMAN Interpolation New550

Die Funktion :ref:`rspline` berechnet einen rationalen Spline unter Spannung 
für eine Kurve, deren x-Koordinaten austeigend sortiert sein müssen.

.. function::  rmXY = rspline(rvX, rvY, p)
    rmXY = rspline(rvX, rvY, p, rsTensionFactor)
    rmXY = rspline(rvX, rvY, p, rsTensionFactor, flag)

.. us.return

**Returnwert**

*rmXY* ist eine reelle Matrix mit zwei Spalten. In der ersten Spalte der Matrix
befinden sich die x-Koordinaten des Splines und in der zweiten Spalte die
y-Koordinaten. Im Fehlerfall ist ``len(rmXY) == 1`` . ``rmXY[1]`` enthält dann
einen der folgenden Fehlerwerte: 

.. list-table::
   :header-rows: 0

   * - 1
     - Nicht genug Speicher.
   * - 2
     - x-Koordinaten nicht streng monoton.
   * - 3
     - Weniger als 3 Datenpunkte in *rvX*.

.. us.params

**Parameter**

.. uparam:: rvX

   *rvX* ist ein reeller Vektor mit mindestens 3 x-Koordinaten.

.. uparam:: rvY

   *rvY* ist ein reeller Vektor mit mindestens 3 y-Koordinaten.

.. uparam:: p

   Die Bedeutung des Parameters *p* hängt vom Parameter *flag* ab.

.. uparam:: rsTensionFactor

   *rsTensionFactor* ist eine Zahl zwischen 0 und 100. Bei 0 wird ein kubischer
   Spline berechnet, bei großen Werten (bis 100) ergibt sich ein Polygon.
   Default value is 1.

.. uparam:: flag

   *flag* kann einen der folgenden Werte annehmen:

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

      * - Wert
        - Bedeutung
      * - 1
        - p ist die Anzahl der x-,y-Koordinaten zwischen x-Minimum und x-Maximum.
      * - 2
        - p ist die Anzahl der x-,y-Koordinaten zwischen x-Minimum und x-Maximum. Die Original x-Koordinaten sind im Ergebnis enthalten.
      * - 3
        - p ist ein Vektor mit x-Koordinaten in aufsteigender Folge.

   Defaultwert is 1.

.. us.example

**Beispiel**

.. image:: S:/uniplot-obj/images/rspline.*

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.5.0
     - Neu.

.. seealso::
   :ref:`uberblick-mathematik`,
   :ref:`pspline`,
   :ref:`fspline`,
   :ref:`akimaspline`,
   :ref:`interpol`

:sub:`id-1612071`