# tf.sparse.segment_mean

<br />

|---|---|
| [![](https://www.tensorflow.org/images/tf_logo_32px.png) TensorFlow 2 version](https://www.tensorflow.org/api_docs/python/tf/sparse/segment_mean) | [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v1.15.0/tensorflow/python/ops/math_ops.py#L3753-L3797) |

Computes the mean along sparse segments of a tensor.

#### View aliases


**Main aliases**

\`tf.sparse_segment_mean\`
**Compat aliases for migration**

See
[Migration guide](https://www.tensorflow.org/guide/migrate) for
more details.

[`tf.compat.v1.sparse.segment_mean`](https://www.tensorflow.org/api_docs/python/tf/compat/v1/sparse_segment_mean), [`tf.compat.v1.sparse_segment_mean`](https://www.tensorflow.org/api_docs/python/tf/compat/v1/sparse_segment_mean)

<br />

    tf.sparse.segment_mean(
        data, indices, segment_ids, name=None, num_segments=None
    )

Read [the section on
segmentation](https://www.tensorflow.org/versions/r2.0/api_docs/python/tf/math#about_segmentation)
for an explanation of segments.

Like [`tf.math.segment_mean`](https://www.tensorflow.org/versions/r1.15/api_docs/python/tf/math/segment_mean), but `segment_ids` can have rank less than
`data`'s first dimension, selecting a subset of dimension 0, specified by
`indices`.
`segment_ids` is allowed to have missing ids, in which case the output will
be zeros at those indices. In those cases `num_segments` is used to determine
the size of the output.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `data` | A `Tensor` with data that will be assembled in the output. |
| `indices` | A 1-D `Tensor` with indices into `data`. Has same rank as `segment_ids`. |
| `segment_ids` | A 1-D `Tensor` with indices into the output `Tensor`. Values should be sorted and can be repeated. |
| `name` | A name for the operation (optional). |
| `num_segments` | An optional int32 scalar. Indicates the size of the output `Tensor`. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A `tensor` of the shape as data, except for dimension 0 which has size `k`, the number of segments specified via `num_segments` or inferred for the last element in `segments_ids`. ||

<br />