cupy.average(a, axis=None, weights=None, returned=False, *, keepdims=False)[source]#

Returns the weighted average along an axis.

  • a (cupy.ndarray) – Array to compute average.

  • axis (int) – Along which axis to compute average. The flattened array is used by default.

  • weights (cupy.ndarray) – Array of weights where each element corresponds to the value in a. If None, all the values in a have a weight equal to one.

  • returned (bool) – If True, a tuple of the average and the sum of weights is returned, otherwise only the average is returned.

  • keepdims (bool) – If True, the axis is remained as an axis of size one.


The average of the input array along the axis and the sum of weights.

Return type

cupy.ndarray or tuple of cupy.ndarray


This function may synchronize the device if weight is given.

See also