scipp.binning.make_binned(x, *, edges=None, groups=None, erase=None)#

Create binned data by binning input along all dimensions given by edges or groups.

Usually scipp.bin() or should be preferred, unless the more precise control over which dimensions should be erased is required, or unless grouping and binning at the same time is required.

This does not histogram the data, each output bin will contain a “list” of input values.

At least one argument of edges and groups is required.

If the input is binned and certain bins are masked then changing the binning will apply the masks, i.e., masked bins are treated as empty.


When there is existing binning or grouping, the algorithm assumes that coordinates of the binned data are correct, i.e., compatible with the corresponding coordinate values in the individual bins. If this is not the case then the behavior if UNSPECIFIED. That is, the algorithm may or may not ignore the existing coordinates. If you encounter such as case, remove the conflicting coordinate, e.g., using scipp.DataArray.drop_coords().


DataArray – Binned x.

See also


For histogramming data.


Recommended interface for binning data.

Recommended interface for grouping data.


For creating binned data based on explicitly given index ranges.