.. highlightlang:: us

.. _xysetfilterfunctions:

XYSetFilterFunctions
====================

.. index:: XYSetFilterFunctions

.. us.tag  XYSetFilterFunctions xy.data New400

:ref:`XYSetFilterFunctions` setzt eine oder mehrere Filterfunktionen für den Datensatz.

.. function::  bool = XYSetFilterFunctions(hData, ssFilterFunctions)
    bool = XYSetFilterFunctions(hData, ssFilterFunctions, bUpdate)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer (Handle) des Datensatzes, der mit :ref:`XYCreate`
   oder :ref:`TYCreate` erzeugt wurde.

.. uparam:: ssFilterFunctions

   *ssFilterFunctions* ist ein String mit Filterfunktionen. Die einzelnen
   Filterfunktionen müssen durch das ";"-Zeichen getrennt sein (siehe Beispiel).

.. uparam:: bUpdate

   Wenn *bUpdate* = TRUE (1) ist, wird der Filter ausgewertet und die gefilterten
   Daten werden angezeigt. Ansonsten wird nur der Filter gesetzt, die Filerfunktionen
   aber nicht ausgewertet. Dazu müssen dann noch die Funktion :ref:`XYUseFilter` und 
   :ref:`XYUpdate` aufgerufen werden. Defaultwert ist TRUE (1).

.. us.example

**Beispiel**

Filtert eine durch Rauschen gestörte sinus-Kurve.

::

   def test_XYSetFilterFunctions()
   {
       x = linspace(0, 2*PI, 1000);
       srand(1);
       h = plot(x , sin(x + rand(1,1000)*0.2));
       hData = h[3];
       XYSetFilterFunctions(hData, "smooth(10);fitspline(1.0);simplify(5)");
   }
   test_XYSetFilterFunctions();

::

   auto_AddToUI("Examples", "Example", "RS_Example3");
   def RS_Example3()
   {
       auto_SetFileNameDialogInit("*.asc; *.nc", GetRootDirectory() + "samples/");
       svFile = auto_GetFileNameDialog(3);
       if (svFile[1] == "DLG_CANCEL") {
           return;
       }
       NumberOfFiles = len(svFile);
       hPage = auto_LoadTemplate("example");
       for (i in 1:NumberOfFiles) {
           svFile[i] = auto_ImportData(svFile[i]);
           hData = auto_LoadDataset("Diagramm 1", "N", "MEFF");
           XYSetFilterFunctions(hData, "akimaspline()");
           hData = auto_LoadDataset("Diagramm 2", "N", "EWGLST");
           XYSetFilterFunctions(hData, "akimaspline()");
       }
       auto_ScaleAxes();
       auto_ReplaceTextDialog(svFile[1]);
       auto_UpdatePage(); 
   }

.. us.comment

**Kommentar**

Eine Liste der Filterfunktionen finden Sie unter
:ref:`filterfunktionen-fur-xy-datensatze`.

.. seealso::
   :ref:`uberblick-xy-datensatze`,
   :ref:`XYGetFilterFunctions`,
   :ref:`XYUpdate`,
   :ref:`XYUseFilter`

:sub:`id-1132714`