helpers
¶
Functions:

Returns the edges for a given grid vector as well as the corresponding width of these bins. 

This is a wrapper around scipy's binned_statistic. 
 pyEvalData.helpers.edges4grid(grid)[source]¶
Returns the edges for a given grid vector as well as the corresponding width of these bins.
The
grid
is NOT altered  on purpose! So even if thegrid
is not unique there will be bins of width 0.Be also aware of the hanling of the first and last bin, as they will contain values which will lay outside of the original
grid
.grid x x x x x x x x
edges         
binwidth <—> <—> <—> <—> <—> <—> <—> <—>
 Attributes
grid (ndarray[float]) – array of grid points.
 Returns
(tuple) –
edges (ndarray[float])  array of edges.
binwidth (ndarray[float])  array of bin widths.
 pyEvalData.helpers.bin_data(y, x, X, statistic='mean')[source]¶
This is a wrapper around scipy’s binned_statistic. In the first step possbile masked elements from the input arrays x and y are removed. The same applies for the new grid array X which is also sorted and made unique.
In a second step the edges for the new grid are calculated by
edges4grid
and used to calculate the new binned values Y by usingscipy.stats.binned_statistsic
.The type of statistic can be chosen. In case of sum Poisson statistics are applied to calculate the standard derivation of the binned values Y. Also errors due to the horizontal binning are calculated and returned. All return values contain only elements with according nonzero bins.
 Parameters
y (ndarray[float]) – input y array.
x (ndarray[float]) – input x array.
X (ndarray[float]) – new grid array.
statistic (str, optional) – type of statistics used for scipy’s
binned_statistic
 default ismean
.
 Returns
(tuple) –
Y (ndarray[float])  binned Y data without zerobins.
X (ndarray[float])  new X grid array.
Yerr (ndarray[float])  Error for Y, according to statistic.
Xerr (ndarray[float])  Error for Y, according to statistic.
Ystd (ndarray[float])  Std for Y, according to statistic.
Xstd (ndarray[float])  Std for X, according to statistic.
edges (ndarray[float])  Edges of binned data.
bins (ndarray[float])  Indices of the bins.
n (ndarray[float])  Number of values per given bin.