# uproot.behaviors.TH1.Histogram

Defined in [uproot.behaviors.TH1](https://github.com/scikit-hep/uproot5/blob/db953cf9827349b3d24eb6742404158c1dfd5481/src/uproot/behaviors/TH1.py) on [line 51](https://github.com/scikit-hep/uproot5/blob/db953cf9827349b3d24eb6742404158c1dfd5481/src/uproot/behaviors/TH1.py#L51).

### *class* uproot.behaviors.TH1.Histogram

Abstract class for histograms.

<a id="uproot-behaviors-th1-histogram-name"></a>

## name

#### Histogram.name

The name of the histogram.

<a id="uproot-behaviors-th1-histogram-title"></a>

## title

#### Histogram.title

The title of the histogram.

<a id="uproot-behaviors-th1-histogram-axes"></a>

## axes

#### Histogram.axes

A tuple of all [uproot.behaviors.TAxis.TAxis](uproot.behaviors.TAxis.TAxis.html.md) objects.

<a id="uproot-behaviors-th1-histogram-axis"></a>

## axis

#### Histogram.axis(axis)

Returns a specified [uproot.behaviors.TAxis.TAxis](uproot.behaviors.TAxis.TAxis.html.md) object.

The `axis` can be specified as

* a non-negative integer: `0` is the first axis, `1` is the second,
  and `2` is the third.
* a negative integer: `-1` is the last axis, `-2` is the
  second-to-last, and `-3` is the third-to-last.
* a string: `"x"` is the first axis, `"y"` is the second, and `"z"`
  is the third

(assuming that the histogram dimension supports a given `axis`).

<a id="uproot-behaviors-th1-histogram-weighted"></a>

## weighted

#### Histogram.weighted

True if the histogram has weights (`fSumw2`); False otherwise.

<a id="uproot-behaviors-th1-histogram-kind"></a>

## kind

#### Histogram.kind

`"COUNT"` for true histograms (TH\*) and
`"MEAN"` for profile plots (TProfile\*).

* **Type:**
  The meaning of this object

<a id="uproot-behaviors-th1-histogram-values"></a>

## values

#### Histogram.values(flow=False)

* **Parameters:**
  **flow** (*bool*) – If True, include underflow and overflow bins before and
  after the normal (finite-width) bins.

Bin contents as a 1, 2, or 3 dimensional `numpy.ndarray`. The
`numpy.dtype` of this array depends on the histogram type.

Setting `flow=True` increases the length of each dimension by two.

<a id="uproot-behaviors-th1-histogram-errors"></a>

## errors

#### Histogram.errors(flow=False)

* **Parameters:**
  **flow** (*bool*) – If True, include underflow and overflow bins before and
  after the normal (finite-width) bins.

Errors (uncertainties) in the [values](#uproot-behaviors-th1-histogram-values)
as a 1, 2, or 3 dimensional `numpy.ndarray` of `numpy.float64`.

If `fSumw2` (weights) are available, they will be used in the
calculation of the errors. If not, errors are assumed to be the square
root of the values.

Setting `flow=True` increases the length of each dimension by two.

<a id="uproot-behaviors-th1-histogram-variances"></a>

## variances

#### Histogram.variances(flow=False)

* **Parameters:**
  **flow** (*bool*) – If True, include underflow and overflow bins before and
  after the normal (finite-width) bins.

Variances (uncertainties squared) in the
[values](#uproot-behaviors-th1-histogram-values) as a 1, 2, or 3
dimensional `numpy.ndarray` of `numpy.float64`.

If `fSumw2` (weights) are available, they will be used in the
calculation of the variances. If not, variances are assumed to be equal
to the values.

Setting `flow=True` increases the length of each dimension by two.

<a id="uproot-behaviors-th1-histogram-counts"></a>

## counts

#### Histogram.counts(flow=False)

* **Parameters:**
  **flow** (*bool*) – If True, include underflow and overflow bins before and
  after the normal (finite-width) bins.

Returns the (possibly weighted) number of entries in each bin. For
histograms, this is equal to [values](#uproot-behaviors-th1-histogram-values).

<a id="uproot-behaviors-th1-histogram-to-boost"></a>

## to_boost

#### Histogram.to_boost(metadata=None, axis_metadata=None)

* **Parameters:**
  * **metadata** (*dict* *of* *str → str*) – Metadata to collect (keys) and
    their C++ class member names (values).
  * **axis_metadata** (*dict* *of* *str → str*) – Metadata to collect from
    each axis.

Converts the histogram into a `boost-histogram` object.

<a id="uproot-behaviors-th1-histogram-to-hist"></a>

## to_hist

#### Histogram.to_hist(metadata=None, axis_metadata=None)

* **Parameters:**
  * **metadata** (*dict* *of* *str → str*) – Metadata to collect (keys) and
    their C++ class member names (values).
  * **axis_metadata** (*dict* *of* *str → str*) – Metadata to collect from
    each axis.

Converts the histogram into a `hist` object.
