eelbrain.NDVar.bin

NDVar.bin(step=None, start=None, stop=None, func=None, dim=None, name=None, nbins=None, label='center')

Bin the data along a given dimension (default 'time')

Parameters
  • step (Optional[float]) – Time step between bins.

  • start (Optional[float]) – Earliest time point (default is from the beginning).

  • stop (Optional[float]) – End of the data to use (the default is to use as many whole tstep intervals as fit in the data).

  • func (Union[Callable, str, None]) – How to summarize data in each time bin. Can be the name of a numpy function that takes an axis parameter (e.g., ‘sum’, ‘mean’, ‘max’) or ‘extrema’ which selects the value with the maximum absolute value. The default depends on ndvar.info['meas']: ‘p’: minimum; ‘f’: maximum; ‘t’, ‘r’: extrema; otherwise: mean.

  • dim (Optional[str]) – Dimension over which to bin. If the NDVar has more than one dimension, the default is 'time'.

  • name (Optional[str]) – Name of the output NDVar (default is the current name).

  • nbins (Optional[int]) – Instead of specifying step, nbins can be specified to divide dim into an even number of bins.

  • label (Literal[‘start’, ‘center’]) – How to assign labels to the new bins. For example, with dim='time', the new time axis can assign to each bin either the center or the start time of the bin on the original time axis.

Returns

NDVar with data binned along the time axis (i.e., each time point reflects one time bin).

Return type

binned_ndvar