mean¶

tripy.mean(input: Tensor, dim: int | Sequence[int] | None = None, keepdim: bool = False) → Tensor[source]¶

Returns a new tensor containing the mean of the elements of the input tensor along the specified dimension.

Parameters:

input (Tensor) – [dtype=T1] The input tensor.
dim (int | Sequence[int] | None) – The dimension or dimensions along which to reduce. If this is not provided, all dimensions are reduced.
keepdim (bool) – Whether to retain reduced dimensions in the output. If this is False, reduced dimensions will be squeezed.

Returns:

[dtype=T1] mean of the input tensor

Return type:

Tensor

TYPE CONSTRAINTS:

T1: bfloat16, float16, float32, int32, int64

Example

Example¶

input = tp.reshape(tp.arange(6, dtype=tp.float32), (2, 3))
output = tp.mean(input, dim=1, keepdim=True)

>>> input
tensor(
    [[0.0000, 1.0000, 2.0000],
     [3.0000, 4.0000, 5.0000]], 
    dtype=float32, loc=gpu:0, shape=(2, 3))
>>> output
tensor(
    [[1.0000],
     [4.0000]], 
    dtype=float32, loc=gpu:0, shape=(2, 1))