.. _`Histogram calculation`:

.. _`org.sysess.sympathy.dataanalysis.histogramcalc`:

Histogram calculation
~~~~~~~~~~~~~~~~~~~~~

.. image:: histogram_calculation.svg
   :width: 48


This node takes a table and calculates a histogram from one of its columns.

The output consists of bin edges and bin values and can for instance be
used in a histogram plot in the node :ref:`Figure`.

Masked values in the data column are ignored. Masked values in the weights
column are treated as 1.

*Input ports*:
    :in: table

        Input data

*Output ports*:
    :out: table

        Histogram data

*Configuration*:
    **Data column:** (data_column)
        Column to create histogram for.
    **Weights column:** (weights_column)
        If you choose a weights column, each value in the data column only contributes its associated weight towards the bin count, instead of 1.
    **Bins:** (bins)
        Number of bins.
    **Auto range** (auto_range)
        When checked, use data range as histogram range.
    **X min:** (x_min)
        Minimum x value.
    **X max:** (x_max)
        Maximum x value.
    **Density** (normed)
        When checked, the result is the value of the probability density function at each bin, normalized such that the integral of the histogram is 1.

.. automodule:: node_histogram_calculation

.. class:: HistogramCalculation


Example flows
#############

* :download:`HistogramCalculation.syx </_examples/Sympathy/Analysis/Statistic/HistogramCalculation.syx>`