tf.keras.layers.ConvLSTM2D
| Просмотреть исходный код на GitHub |
Свёрточный LSTM.
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" (регистр не учитывается). |
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 и др., 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 и др., 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.3/api_docs/python/tf/keras/layers/ConvLSTM2D