tf.keras.layers.GlobalAveragePooling1D
Stay organized with collections
Save and categorize content based on your preferences.
Global average pooling operation for temporal data.
Inherits From: Layer
, Module
tf.keras.layers.GlobalAveragePooling1D(
data_format='channels_last', **kwargs
)
Examples:
input_shape = (2, 3, 4)
x = tf.random.normal(input_shape)
y = tf.keras.layers.GlobalAveragePooling1D()(x)
print(y.shape)
(2, 4)
Args |
data_format
|
A string,
one of channels_last (default) or channels_first .
The ordering of the dimensions in the inputs.
channels_last corresponds to inputs with shape
(batch, steps, features) while channels_first
corresponds to inputs with shape
(batch, features, steps) .
|
keepdims
|
A boolean, whether to keep the temporal dimension or not.
If keepdims is False (default), the rank of the tensor is reduced
for spatial dimensions.
If keepdims is True , the temporal dimension are retained with
length 1.
The behavior is the same as for tf.reduce_mean or np.mean .
|
Call arguments |
inputs
|
A 3D tensor.
|
mask
|
Binary tensor of shape (batch_size, steps) indicating whether
a given step should be masked (excluded from the average).
|
|
- If
data_format='channels_last' :
3D tensor with shape:
(batch_size, steps, features)
- If
data_format='channels_first' :
3D tensor with shape:
(batch_size, features, steps)
|
Output shape |
- If
keepdims =False:
2D tensor with shape (batch_size, features) .
- If
keepdims =True:
- If
data_format='channels_last' :
3D tensor with shape (batch_size, 1, features)
- If
data_format='channels_first' :
3D tensor with shape (batch_size, features, 1)
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates. Some content is licensed under the numpy license.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[],[],null,["# tf.keras.layers.GlobalAveragePooling1D\n\n\u003cbr /\u003e\n\n|------------------------------------------------------------------------------------------------------------------------------------|\n| [View source on GitHub](https://github.com/keras-team/keras/tree/v2.10.0/keras/layers/pooling/global_average_pooling1d.py#L27-L98) |\n\nGlobal average pooling operation for temporal data.\n\nInherits From: [`Layer`](../../../tf/keras/layers/Layer), [`Module`](../../../tf/Module)\n\n#### View aliases\n\n\n**Main aliases**\n\n[`tf.keras.layers.GlobalAvgPool1D`](https://www.tensorflow.org/api_docs/python/tf/keras/layers/GlobalAveragePooling1D)\n**Compat aliases for migration**\n\nSee\n[Migration guide](https://www.tensorflow.org/guide/migrate) for\nmore details.\n\n\\`tf.compat.v1.keras.layers.GlobalAveragePooling1D\\`, \\`tf.compat.v1.keras.layers.GlobalAvgPool1D\\`\n\n\u003cbr /\u003e\n\n tf.keras.layers.GlobalAveragePooling1D(\n data_format='channels_last', **kwargs\n )\n\n#### Examples:\n\n input_shape = (2, 3, 4)\n x = tf.random.normal(input_shape)\n y = tf.keras.layers.GlobalAveragePooling1D()(x)\n print(y.shape)\n (2, 4)\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Args ---- ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `data_format` | A string, one of `channels_last` (default) or `channels_first`. The ordering of the dimensions in the inputs. `channels_last` corresponds to inputs with shape `(batch, steps, features)` while `channels_first` corresponds to inputs with shape `(batch, features, steps)`. |\n| `keepdims` | A boolean, whether to keep the temporal dimension or not. If `keepdims` is `False` (default), the rank of the tensor is reduced for spatial dimensions. If `keepdims` is `True`, the temporal dimension are retained with length 1. The behavior is the same as for [`tf.reduce_mean`](../../../tf/math/reduce_mean) or `np.mean`. |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Call arguments -------------- ||\n|----------|----------------------------------------------------------------------------------------------------------------------------|\n| `inputs` | A 3D tensor. |\n| `mask` | Binary tensor of shape `(batch_size, steps)` indicating whether a given step should be masked (excluded from the average). |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Input shape ----------- ||\n|---|---|\n| \u003cbr /\u003e - If `data_format='channels_last'`: 3D tensor with shape: `(batch_size, steps, features)` - If `data_format='channels_first'`: 3D tensor with shape: `(batch_size, features, steps)` ||\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Output shape ------------ ||\n|---|---|\n| \u003cbr /\u003e - If `keepdims`=False: 2D tensor with shape `(batch_size, features)`. - If `keepdims`=True: - If `data_format='channels_last'`: 3D tensor with shape `(batch_size, 1, features)` - If `data_format='channels_first'`: 3D tensor with shape `(batch_size, features, 1)` ||\n\n\u003cbr /\u003e"]]