====== Histogram chart ======

A histogram chart is only available for probabilistic data, and displays one or more simulation outputs in the form of a histogram.
{{:histomgram.png?600|Histogram}}
===== Creating a histogram =====

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

  * If you select a non-time dependent output, a [[Quick_view|quick view]] is created which, by default, is a [[Histogram_chart|histogram]] for non-time dependent, probabilistic outputs. //Or//,
  * Right-click the output or outputs that you wish to plot and select **Histogram** from the popup-menu

From the [[Charts_window|charts window]]

  * Click the {{:Histogram24.png}} button, //or//
  * Right-click the charts window and select **Create | Histogram** from the popup-menu

===== Editing a histogram =====

Some properties can be changed directly by using the controls below the chart. For a histogram there are controls for:

  * **Legend** - Toggle legend on/off
  * **Time-point** - Select time point for the histogram. Only applicable for time dependent outputs.

To change other properties either right-click the chart in the [[Charts_window|charts window]] and select **Edit**, or double-click the chart, or click the {{:Edit24.png|Edit}} button in the title bar.

The chart editor has two tabs:

==== Properties ====

This screen let you edit properties such as name and axes, that are common to most charts. Please see [[Editing_chart_properties|editing chart properties]] for more information.

==== Data ====

  * **Timepoint** – For time dependent outputs, specify the time point you wish to plot.\\
  * **Number of bins** – Enter the number of bins for the histogram. This number applies to all outputs. You can use the drop-down list to the right to use an algorithm that calculates the optimal number of bins from the selected data.
  * **Bin estination routine** - Select a method for selecting the number of bins in a histogram.
    * Arbitrary (//by default//) 
    * Freedman-Diaconis 
    * Optimal 
    * Scott 
    * Sturges 
    * Venables-Ripley
  * **Type** – Select which type of histogram you want to create.
    * Frequency - Display number of occurances.
    * Relative frequency - Divide number of occurances by the total number of observations.
    * Scale area to one - Plot density of data. The total area of the histogram is normalized to 1.
  * **Values** – Select the outputs you wish to include in the histogram.

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

  * [[Charts_window|Charts window]]
  * [[Results_window|Results window]]