tf.keras.layers.ConvLSTM2D
| Просмотреть исходный код на GitHub |
Сверточная LSTM.
Наследуется от: RNN, Layer, Module
tf.keras.layers.ConvLSTM2D(
filters, kernel_size, strides=(1, 1), padding='valid',
data_format=None, dilation_rate=(1, 1), activation='tanh',
recurrent_activation='hard_sigmoid', use_bias=True,
kernel_initializer='glorot_uniform',
recurrent_initializer='orthogonal',
bias_initializer='zeros', unit_forget_bias=True,
kernel_regularizer=None, recurrent_regularizer=None, bias_regularizer=None,
activity_regularizer=None, kernel_constraint=None, recurrent_constraint=None,
bias_constraint=None, return_sequences=False, return_state=False,
go_backwards=False, stateful=False, dropout=0.0, recurrent_dropout=0.0, **kwargs
)
Она похожа на слой LSTM, но преобразования входных данных и рекуррентные преобразования — оба сверточные.
| Аргументы | |
|---|---|
filters | Целое число, размерность выходного пространства (т.е. количество выходных фильтров в свертке). |
kernel_size | Целое число или кортеж/список из n целых чисел, определяющих размеры окна свертки. |
strides | Целое число или кортеж/список из n целых чисел, определяющих шаги свертки. Указание любого значения шага != 1 несовместимо с указанием любого значения dilation_rate != 1. |
padding | Одно из "valid" или "same" (регистр не учитывается). "valid" означает отсутствие заполнения. "same" приводит к равномерному дополнению слева/справа или сверху/снизу входных данных таким образом, чтобы выходные размеры высоты/ширины совпадали с входными. |
data_format | Строка, одно из значений channels_last (по умолчанию) или channels_first. Порядок измерений во входных данных. channels_last соответствует входам с формой (batch, time, ..., channels), а channels_first соответствует входам с формой (batch, time, channels, ...). По умолчанию используется значение image_data_format из файла конфигурации Keras по адресу ~/.keras/keras.json. Если значение не установлено, оно будет равно "channels_last". |
dilation_rate | Целое число или кортеж/список из n целых чисел, определяющих скорость сжатия для свертки с сжатием. В настоящее время указание любого значения dilation_rate != 1 несовместимо с указанием любого значения strides != 1. |
activation | Функция активации для использования. По умолчанию используется гиперболическая тангенс-функция активации (tanh(x)). |
recurrent_activation | Функция активации для использования на рекуррентном шаге. |
use_bias | Булево значение, указывающее, использует ли слой вектор смещения. |
kernel_initializer | Инициализатор для матрицы весов kernel, используемой для линейного преобразования входных данных. |
recurrent_initializer | Инициализатор для матрицы весов recurrent_kernel, используемой для линейного преобразования рекуррентного состояния. |
bias_initializer | Инициализатор вектора смещения. |
unit_forget_bias | Булево значение. Если True, к смещению забывающего блока в момент инициализации добавляется 1. Используйте в сочетании с bias_initializer="zeros". Это рекомендуется в Jozefowicz et al., 2015 |
kernel_regularizer | Функция регуляризации, применяемая к матрице весов kernel . |
recurrent_regularizer | Функция регуляризации, применяемая к матрице весов recurrent_kernel . |
bias_regularizer | Функция регуляризации, применяемая к вектору смещения. |
activity_regularizer | Функция регуляризации, применяемая к. |
kernel_constraint | Функция ограничения, применяемая к матрице весов kernel . |
recurrent_constraint | Функция ограничения, применяемая к матрице весов recurrent_kernel . |
bias_constraint | Функция ограничения, применяемая к вектору смещения. |
return_sequences | Булево значение. Вернуть ли только последний вывод в последовательности вывода, или всю последовательность. (По умолчанию False) |
return_state | Булево значение. Возвращать ли последнее состояние в дополнение к выводу. (По умолчанию False) |
go_backwards | Булево значение (по умолчанию False). Если True, обрабатывать последовательность входных данных в обратном порядке. |
stateful | Булево значение (по умолчанию False). Если True, последнее состояние для каждого образца с индексом i в пакете будет использоваться в качестве начального состояния для образца с индексом i в следующем пакете. |
dropout | Значение с плавающей точкой от 0 до 1. Доля единиц для отбрасывания при линейном преобразовании входных данных. |
recurrent_dropout | Значение с плавающей точкой от 0 до 1. Доля единиц для отбрасывания при линейном преобразовании рекуррентного состояния. |
Аргументы вызова:
-
inputs: 5D тензор. -
mask: Бинарный тензор формы(samples, timesteps), указывающий, должен ли быть замаскирован определенный временной шаг. -
training: Булево значение Python, указывающее, должен ли слой работать в режиме обучения или в режиме вывода. Этот аргумент передается ячейке при ее вызове. Это актуально только еслиdropoutилиrecurrent_dropoutзаданы. -
initial_state: Список тензоров начального состояния, которые должны быть переданы в первый вызов ячейки.
Форма входных данных:
- Если data_format='channels_first' 5D тензор с формой:
(samples, time, channels, rows, cols) - Если data_format='channels_last' 5D тензор с формой:
(samples, time, rows, cols, channels)
Форма выходных данных:
- Если
return_state: список тензоров. Первый тензор — выход. Остальные тензоры — последние состояния, каждый 4D тензор с формой:(samples, filters, new_rows, new_cols)если data_format='channels_first' или 4D тензор с формой:(samples, new_rows, new_cols, filters)если data_format='channels_last'.rowsиcolsзначения могут измениться из-за заполнения. - Если
return_sequences: 5D тензор с формой:(samples, timesteps, filters, new_rows, new_cols)если data_format='channels_first' или 5D тензор с формой:(samples, timesteps, new_rows, new_cols, filters)если data_format='channels_last'. - В противном случае 4D тензор с формой:
(samples, filters, new_rows, new_cols)если data_format='channels_first' или 4D тензор с формой:(samples, new_rows, new_cols, filters)если data_format='channels_last'.
| Возбуждения | |
|---|---|
ValueError | в случае неверных аргументов конструктора. |
Ссылки:
- Shi et al., 2015 (текущая реализация не включает петлю обратной связи на выходе ячеек).
| Атрибуты | |
|---|---|
activation | |
bias_constraint | |
bias_initializer | |
bias_regularizer | |
data_format | |
dilation_rate | |
dropout | |
filters | |
kernel_constraint | |
kernel_initializer | |
kernel_regularizer | |
kernel_size | |
padding | |
recurrent_activation | |
recurrent_constraint | |
recurrent_dropout | |
recurrent_initializer | |
recurrent_regularizer | |
states | |
strides | |
unit_forget_bias | |
use_bias | |
Методы
reset_states
reset_states(
states=None
)
Сбросить записанные состояния для состоятельного слоя RNN.
Может использоваться только тогда, когда слой RNN создан с stateful = True. Аргументы: состояния: массивы NumPy, содержащие значение для начального состояния, которое будет передано ячейке на первом временном шаге. Если значение None, будет создан массив NumPy с нулями, соответствующий размеру состояния ячейки.
| Возбуждения | |
|---|---|
AttributeError | Когда слой RNN не является состоятельным. |
ValueError | Когда размер пакета слоя RNN неизвестен. |
ValueError | Когда входной массив NumPy несовместим с состоянием слоя RNN, по размеру или типу данных. |
© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.4/api_docs/python/tf/keras/layers/ConvLSTM2D