===== Overview =====

[[Table|Tables]] allow simulation data to be presented in a tabular form. The data which is presented by the table can be transformed in different ways, and can be multi dimensional. When the dimension of the data is larger than two, columns are split to to provide space.

For a general table, the following dimensions are possible:

  * **Outputs** - The outputs that have been selected for the table.
  * **Statistics** - If the data is probabilistic, then statistics can be presented in an extra dimension. It is also possible to display data for specific (or all) iterations.
  * **Time** - If any of the outputs is time dependent, then the time dimension allow you to select which time points to show data for. It is also possible to show the minimum/maximum value across the time vector or the time points for which the minimum or maximum occurs.
  * **Indices** - For each dimension of the selected outputs, a dimension is available for the table data. These dimensions allow you to select all, or only a sub-set of the indices of an [[Index list|index list]].

===== Creating a table =====

From the [[Results_window|results window]] (Recommended)

  * Right-click the outputs that you want to include and select **Table** from the popup-menu.

From the [[Tables_window|tables window]]

  * Right-click the tables window and select **Create | Table** from the popup-menu.

===== Table controls =====

The controls beneath the table let you change the appearance of the table.

  * **Format** - Select either scientific or decimal format
  * **Digits** - Select the number of digits to show

**Highlight**

  * **Highest** - Select to highlight the highest value in each column.
  * **Lowest** - Select to highlight the lowest value in each column.
  * **Condition** - Select to enter a condition. The condition is on the form x<sub>start</sub> < x < <sub>end</sub> and will be evaluated for each cell in the table. Cells who’s value fulfills the condition will be highlighted.

===== Editing a table =====

To edit a table either right-click the table in the [[Tables_window|tables window]] and select **Edit**, or double-click the table, or click the {{:Edit24.png|Edit}} button in the title bar.

The table editor has the following tabs:

  * **Outputs** - Select which outputs to include in the table. The outputs should all have the same dimension. 
  * **Indices** - Depending on the dimension of the outputs that were selected, you can select which indices to include or to include all indices.
  * **Time** - If the outputs are time dependent, this tab allows you to select which time points to display data for. 
    * **Specific** - Select either all time points or specific time points to include
    * **First** - Display the first time point
    * **Last** - Display the last time point
    * **Max over time** - Display the maximum value for each output over time 
    * **Time for max** - Display the time point for the maximum value for each output
    * **Min over time** - Display the minimum value for each output over time 
    * **Time for min** - Display the time point for the minimum value for each output
  * **Statistics** - If any of the outputs is probabilistic, this tab allows you to select which statistics to calculate on the data and/or which iterations to show data for.
    * **Statistics** - Select which statistics to calculate
    * **Percentile** - Give values for up to three percentiles to include
    * **Iteration** - Select which iterations (or all) to include in the table
  * **Appearance** - Select the order of the rows/columns as well as the data format
    * **Rows** - Select which of the dimensions to use for the row headers
    * **Columns** - Choose the order in which the remaining dimensions are displayed
    * **Format** - Select scientific format or decimal format
    * **Decimals** - Select the number of decimal points to show

===== See also =====

  * [[Table]]
  * [[Tables window]]