histogram2d¶

sherpa.utils.histogram2d(x, y, x_grid, y_grid)[source]¶

Create 21D histogram from a binned grid (x_grid, y_grid) and array of samples (x, and y).

See the numpy.histogram2d routine for a version with more options.

Parameters:	x (sequence of numbers) – The array of samples (X coordinate) y (sequence of numbers) – The array of samples (Y coordinate), which must have the same size as the `x` sequence. x_grid (sequence of numbers) – The X bin edges. y_grid (sequence of numbers) – The Y bin edges.
Returns:	y – The number of samples in each histogram bin defined by the `x_grid` and `y_grid` arrays.
Return type:	NumPy array

Examples

Given a list of coordinates (xvals, yvals), bin them up so that they match the 5 by 10 pixel image data space. In this case the X grid is [1,2,...,5] and the Y grid is [1,2,..,10].

>>> dataspace2d([5, 10])
>>> (xgrid, ygrid) = get_axes()
>>> n = histogram2d(xvals, yvals, xgrid, ygrid)
>>> set_dep(n)