.. highlightlang:: us

.. index:: rainflow
.. index:: rainflow matrix
.. index:: Rainflow Counting

.. _rainflow-counting:

Rainflow Counting
=================

The Addin RS_RAINFLOW is an extension for UniPlot to execute a rainflow counting
algorithm. 

.. _installation_rainflow:

Installation
------------

Open the Addin Manager (:ref:`tools-add-in-manager`) and mark the Addin
``Rainflow-counting algorithm``.

After restart the User Toolbar should contain one new button: "Rainflow...".

.. _usage_rainflow:

Usage
-----

* Load the stress data into a diagram, e.g. stress vs. time. 

* Select the new curve and click the **Rainflow...** button.

* The following dialog box will be displayed:

  .. image:: S:/uniplot-obj/images/rainflow-configuration-en.*

  **Normalize signal in percent 'round(signal/value*100**'): If this option is 
  selected the rainflow cycles will be normalized in percent and rounded to the 
  nearest integer.

  **Ignore all turning points with a range smaller than the following threshold**:
  If this option is selected all rainflow cycles are removed, if the range is
  smaller than the given threshold: ``abs(Max-Min) > threshold)``. If the data is
  normalized the threshold must be specified in percent. Otherwise it is
  specified in the stress data units.

  **Combine cycles in output**: If the option is selected the the number of
  occurrences of cycles with identical Min/Max values is calculated and printed
  in the last column of the data table. 

Template
^^^^^^^^

An example template can be found in the :file:`\\uniplot\\addin\\rs_rainflow`
directory. The template's name is :file:`rainflow1.ipw`. You can modify the
template or use it to create a new template. Do not change diagram names. 
The names are used in the UniScript file.

The following diagrams are supported:

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

   * - Diagram Name
     - Meaning
   * - RF-DutyCycle
     - Range (Min-Max)
   * - RF-Hist-Ampli
     - Amplitude Histogram
   * - RF-Hist-Mean
     - Average Histogram
   * - RF-Matrix
     - Rainflow Matrix
   * - RF-StressData
     - Original Data
   * - RF-Hist-Max
     - Maximum Value Histogram

.. _uniscript-interface:

UniScript Interface
-------------------

See :ref:`Rainflow_Batch`.

.. _problems_rainflow:

Problems
--------

If you have any problems using the addin please do not hesitate to contact
us.

:sub:`id-2006200`