.. highlightlang:: us

.. _rainflow_batch:

Rainflow_Batch
==============

.. index:: Rainflow_Batch

.. us.tag  Rainflow_Batch GERMAN New5101

Führt eine Rainflow-Analyse durch. Die Ergebnisdaten werden in einer Vorlage
graphisch dargestellt.

.. function::  hPage = Rainflow_Batch(obj)

.. us.return

**Returnwert**

*hPage* ist die Zugriffsnummer einer Seite. Falls ein Fehler aufgetreten ist,
liefert die Funktion den Wert 0.

.. us.params

**Parameter**

.. uparam:: obj

   *obj* ist ein Objekt mit de folgenden Elementen:

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

      * - Element
        - Bedeutung
        - Beispiel
      * - obj.rmXY
        - Datenmatrix mit zwei Spalten
        - [x,y]
      * - obj.ssTemplate
        - Name der Vorlage
        - GetRootDirectory() + "addin\\rs_rainflow\\rainflow1.ipw"
      * - obj.ssUseThreshold
        - Schwellwert benutzen
        - ``"0"`` oder ``"1"``
      * - obj.ssThreshold
        - Schwellwert
        - ``"0.0"``;
      * - obj.ssCols
        - Anzahl der Rainflow Matrixspalten
        - ``"20"``
      * - obj.ssRows
        - Anzahl der Rainflow Matrixzeilen
        - ``"20"``
      * - obj.ssSaveData
        - Speichern der Rainflowdaten
        - ``"0"`` oder ``"1"``
      * - obj.ssAddZeros
        - Null am Anfang und Ende
        - ``"0"`` oder ``"1"``
      * - obj.ssUseNormalize
        - Daten normalisieren
        - ``"0"`` oder ``"1"``
      * - obj.ssNormalizeValue
        - Wert auf den Normalisiert werden soll
        - ``"100"``
      * - obj.ssCombineCycles
        - Halb-Zyklen kombinieren
        - ``"0"`` oder ``"1"``

::

   def Rainflow_Test()
   {
       obj = obj_create();
       x = [1:1000]'; // column vector
       y = rand(1000, 1) // column vector
       obj.rmXY = [x,y];
       obj.ssTemplate = GetRootDirectory() + "addin\rs_rainflow\rainflow1.ipw";
       obj.ssUseThreshold = "0";
       obj.ssThreshold = "0.0";
       obj.ssCols = "20";
       obj.ssRows = "20";
       obj.ssSaveData = "0";
       obj.ssAddZeros = "1";
       obj.ssUseNormalize = "1";
       obj.ssNormalizeValue = "100";
       obj.ssCombineCycles = "1";
       hDoc = Rainflow_Batch(obj);
       if (hDoc != 0) {
           ssPNGSave = GetUserDirectory() + "rain";
           hvPage = DocGetAllPages(hDoc)
           nPage = len(hvPage);
           for (i in 1:nPage) {
               ssFilename = sprintf("%s-%d.png", ssPNGSave, i);
               PageSaveAsBitmapEx(hvPage[i], ssFilename, "PNG", 300);
           }
           DocDestroy(hDoc); // close document
       }
       return TRUE;
   }

.. us.comment

**Kommentar**

Das Rainflow Addin muss geladen sein.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.10.1
     - Neu.

.. seealso::
   :ref:`rainflow-zahlverfahren`,
   :ref:`ADDIN_LoadAddIn`

:sub:`id-1184723`