RDFILE
------


.. figure:: ../media/image1035.png
   :figwidth: 2.79167in
   :align: center 

**Purpose**

Read time dependent values from a csv file.

**Parameters** 

+---------------+---------------+------+---------+---------+--------------------------------------------+
| Parameter     | input         | unit | range   | default | remarks                                    |
+===============+===============+======+=========+=========+============================================+
| CASE_I###.csv | integer       | [-]  | [0,999] |         | Number which gets appended to the casename |
+---------------+---------------+------+---------+---------+--------------------------------------------+
| Function type | Continue/Step |      |         |Continue |                                            |
+---------------+---------------+------+---------+---------+--------------------------------------------+
| Time unit     | ms/s/         |      |         | s       | unit used for time column                  |
|               |               |      |         |         |                                            |
|               | min/hr        |      |         |         |                                            |
+---------------+---------------+------+---------+---------+--------------------------------------------+

**Remarks** 

The csv file must be located in the **same** directory as the Wanda case files. 
The name of the file must have the following format: **<casename>_I###.csv**. 
Where <casename> is the full name of the Wanda casefiles without extension. 
### is a number between 0 and 999, which is the same number that must be entered as input of the parameter **CASE_I###.csv**.
Thus, for a case named **example.wdi** a file can be named **example_I000.csv**. The input **CASE_I###.csv** in the selection property window is then **0**. 

The csv-input file must contain 2 columns, which are separated by a comma, tab or space. Please note that a semi-column is not allowed. 
Also note that the values in the CSV file must use a period ('.') as decimal symbol. In contrary to the WANDA Gui, the RDFILE symbol does not follow the system settings for number format. 
The first column contains the time in the unit system as specified with the input parameter **Time unit**. This column should always start with **0** on its first row.
The second column contains the function value for each time step. The unit system of this function value is not known by the H- or C-component to which the control component is connected.
Therefore, the values must be entered in SI-units. An example of an input file is shown in :numref:`fig_definition_rdfile_inputfile`.


With the function type “Continue” intermediate points are interpolated. 
If the simulation time exceeds the last row of the file, the last function value will be maintained.
This is shown in :numref:`fig_definition_rdfile_continue`.

With the function type “Step” the function value will remain constant until the next point in the file.
This is shown in :numref:`fig_definition_rdfile_step`.

The file may contain a header with comments, which should start with a ‘#’ or ‘*’.

**Example** 

.. _fig_definition_rdfile_inputfile:
.. figure:: ../media/image1036.png
   :figwidth: 5.41667in
   :align: center 

   Example of input file

.. _fig_definition_rdfile_continue:
.. figure:: ../media/image1037.png
   :figwidth: 3.61458in
   :align: center 

   Result with Type = Continue

.. _fig_definition_rdfile_step:
.. figure:: ../media/image1038.png
   :figwidth: 3.64583in
   :align: center 

   Result with Type = Step
   

.. include:: substitutions_control.rst