tf.keras.layers.MaxPool1D
Stay organized with collections
Save and categorize content based on your preferences.
Max pooling operation for 1D temporal data.
Inherits From: Layer
, Operation
tf.keras.layers.MaxPool1D(
pool_size=2,
strides=None,
padding='valid',
data_format=None,
name=None,
**kwargs
)
Used in the notebooks
Used in the guide |
Used in the tutorials |
|
|
Downsamples the input representation by taking the maximum value over a
spatial window of size pool_size
. The window is shifted by strides
.
The resulting output when using the "valid"
padding option has a shape of:
output_shape = (input_shape - pool_size + 1) / strides)
.
The resulting output shape when using the "same"
padding option is:
output_shape = input_shape / strides
Args |
pool_size
|
int, size of the max pooling window.
|
strides
|
int or None. Specifies how much the pooling window moves
for each pooling step. If None, it will default to pool_size .
|
padding
|
string, either "valid" or "same" (case-insensitive).
"valid" means no padding. "same" results in padding evenly to
the left/right or up/down of the input such that output has the same
height/width dimension as the input.
|
data_format
|
string, either "channels_last" 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) . It defaults to the image_data_format
value found in your Keras config file at ~/.keras/keras.json .
If you never set it, then it will be "channels_last" .
|
- 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
data_format="channels_last"
:
3D tensor with shape (batch_size, downsampled_steps, features)
.
- If
data_format="channels_first"
:
3D tensor with shape (batch_size, features, downsampled_steps)
.
Examples:
strides=1
and padding="valid"
:
x = np.array([1., 2., 3., 4., 5.])
x = np.reshape(x, [1, 5, 1])
max_pool_1d = keras.layers.MaxPooling1D(pool_size=2,
strides=1, padding="valid")
max_pool_1d(x)
strides=2
and padding="valid"
:
x = np.array([1., 2., 3., 4., 5.])
x = np.reshape(x, [1, 5, 1])
max_pool_1d = keras.layers.MaxPooling1D(pool_size=2,
strides=2, padding="valid")
max_pool_1d(x)
strides=1
and padding="same"
:
x = np.array([1., 2., 3., 4., 5.])
x = np.reshape(x, [1, 5, 1])
max_pool_1d = keras.layers.MaxPooling1D(pool_size=2,
strides=1, padding="same")
max_pool_1d(x)
Attributes |
input
|
Retrieves the input tensor(s) of a symbolic operation.
Only returns the tensor(s) corresponding to the first time
the operation was called.
|
output
|
Retrieves the output tensor(s) of a layer.
Only returns the tensor(s) corresponding to the first time
the operation was called.
|
Methods
from_config
View source
@classmethod
from_config(
config
)
Creates a layer from its config.
This method is the reverse of get_config
,
capable of instantiating the same layer from the config
dictionary. It does not handle layer connectivity
(handled by Network), nor weights (handled by set_weights
).
Args |
config
|
A Python dictionary, typically the
output of get_config.
|
Returns |
A layer instance.
|
symbolic_call
View source
symbolic_call(
*args, **kwargs
)
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 2024-06-07 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-06-07 UTC."],[],[],null,["# tf.keras.layers.MaxPool1D\n\n\u003cbr /\u003e\n\n|---------------------------------------------------------------------------------------------------------------------------|\n| [View source on GitHub](https://github.com/keras-team/keras/tree/v3.3.3/keras/src/layers/pooling/max_pooling1d.py#L5-L91) |\n\nMax pooling operation for 1D temporal data.\n\nInherits From: [`Layer`](../../../tf/keras/Layer), [`Operation`](../../../tf/keras/Operation)\n\n#### View aliases\n\n\n**Main aliases**\n\n[`tf.keras.layers.MaxPooling1D`](https://www.tensorflow.org/api_docs/python/tf/keras/layers/MaxPool1D)\n\n\u003cbr /\u003e\n\n tf.keras.layers.MaxPool1D(\n pool_size=2,\n strides=None,\n padding='valid',\n data_format=None,\n name=None,\n **kwargs\n )\n\n### Used in the notebooks\n\n| Used in the guide | Used in the tutorials |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| - [Using Counterfactual Logit Pairing with Keras](https://www.tensorflow.org/responsible_ai/model_remediation/counterfactual/guide/counterfactual_keras) | - [Wiki Talk Comments Toxicity Prediction](https://www.tensorflow.org/responsible_ai/fairness_indicators/tutorials/Fairness_Indicators_TFCO_Wiki_Case_Study) |\n\nDownsamples the input representation by taking the maximum value over a\nspatial window of size `pool_size`. The window is shifted by `strides`.\n\nThe resulting output when using the `\"valid\"` padding option has a shape of:\n`output_shape = (input_shape - pool_size + 1) / strides)`.\n\nThe resulting output shape when using the `\"same\"` padding option is:\n`output_shape = input_shape / strides`\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Args ---- ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pool_size` | int, size of the max pooling window. |\n| `strides` | int or None. Specifies how much the pooling window moves for each pooling step. If None, it will default to `pool_size`. |\n| `padding` | string, either `\"valid\"` or `\"same\"` (case-insensitive). `\"valid\"` means no padding. `\"same\"` results in padding evenly to the left/right or up/down of the input such that output has the same height/width dimension as the input. |\n| `data_format` | string, either `\"channels_last\"` 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)`. It defaults to the `image_data_format` value found in your Keras config file at `~/.keras/keras.json`. If you never set it, then it will be `\"channels_last\"`. |\n\n\u003cbr /\u003e\n\n#### Input shape:\n\n- If `data_format=\"channels_last\"`: 3D tensor with shape `(batch_size, steps, features)`.\n- If `data_format=\"channels_first\"`: 3D tensor with shape `(batch_size, features, steps)`.\n\n#### Output shape:\n\n- If `data_format=\"channels_last\"`: 3D tensor with shape `(batch_size, downsampled_steps, features)`.\n- If `data_format=\"channels_first\"`: 3D tensor with shape `(batch_size, features, downsampled_steps)`.\n\n#### Examples:\n\n`strides=1` and `padding=\"valid\"`: \n\n x = np.array([1., 2., 3., 4., 5.])\n x = np.reshape(x, [1, 5, 1])\n max_pool_1d = keras.layers.MaxPooling1D(pool_size=2,\n strides=1, padding=\"valid\")\n max_pool_1d(x)\n\n`strides=2` and `padding=\"valid\"`: \n\n x = np.array([1., 2., 3., 4., 5.])\n x = np.reshape(x, [1, 5, 1])\n max_pool_1d = keras.layers.MaxPooling1D(pool_size=2,\n strides=2, padding=\"valid\")\n max_pool_1d(x)\n\n`strides=1` and `padding=\"same\"`: \n\n x = np.array([1., 2., 3., 4., 5.])\n x = np.reshape(x, [1, 5, 1])\n max_pool_1d = keras.layers.MaxPooling1D(pool_size=2,\n strides=1, padding=\"same\")\n max_pool_1d(x)\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Attributes ---------- ||\n|----------|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `input` | Retrieves the input tensor(s) of a symbolic operation. \u003cbr /\u003e Only returns the tensor(s) corresponding to the *first time* the operation was called. |\n| `output` | Retrieves the output tensor(s) of a layer. \u003cbr /\u003e Only returns the tensor(s) corresponding to the *first time* the operation was called. |\n\n\u003cbr /\u003e\n\nMethods\n-------\n\n### `from_config`\n\n[View source](https://github.com/keras-team/keras/tree/v3.3.3/keras/src/ops/operation.py#L191-L213) \n\n @classmethod\n from_config(\n config\n )\n\nCreates a layer from its config.\n\nThis method is the reverse of `get_config`,\ncapable of instantiating the same layer from the config\ndictionary. It does not handle layer connectivity\n(handled by Network), nor weights (handled by `set_weights`).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Args ||\n|----------|----------------------------------------------------------|\n| `config` | A Python dictionary, typically the output of get_config. |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Returns ||\n|---|---|\n| A layer instance. ||\n\n\u003cbr /\u003e\n\n### `symbolic_call`\n\n[View source](https://github.com/keras-team/keras/tree/v3.3.3/keras/src/ops/operation.py#L58-L70) \n\n symbolic_call(\n *args, **kwargs\n )"]]