tf.keras.layers.ConvLSTM3D
3D Свёрточная LSTM.
Наследуется от: RNN, Layer, Module
tf.keras.layers.ConvLSTM3D(
filters,
kernel_size,
strides=(1, 1, 1),
padding='valid',
data_format=None,
dilation_rate=(1, 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 и др., 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: 6D тензор. -
mask: Бинарный тензор формы(samples, timesteps), указывающий, следует ли маскировать определённый временной шаг. -
training: Булево значение Python, указывающее, должен ли слой вести себя в режиме обучения или в режиме вывода. Этот аргумент передаётся ячейке при её вызове. Это актуально только еслиdropoutилиrecurrent_dropoutустановлены. -
initial_state: Список начальных тензоров состояния, передаваемых в первый вызов ячейки.
Форма входных данных: - Если data_format='channels_first' 6D тензор с формой: (samples, time, channels, rows, cols, depth) - Если data_format='channels_last' 5D тензор с формой: (samples, time, rows, cols, depth, channels) Форма выходных данных:
- Если
return_state: список тензоров. Первый тензор — это вывод. Остальные тензоры — это последние состояния, каждый 5D тензор с формой:(samples, filters, new_rows, new_cols, new_depth)если data_format='channels_first' или формой:(samples, new_rows, new_cols, new_depth, filters)если data_format='channels_last'.rows,cols, иdepthзначения могут измениться из-за заполнения. - Если
return_sequences: 6D тензор с формой:(samples, timesteps, filters, new_rows, new_cols, new_depth)если data_format='channels_first' или формой:(samples, timesteps, new_rows, new_cols, new_depth, filters)если data_format='channels_last'. - В противном случае, 5D тензор с формой:
(samples, filters, new_rows, new_cols, new_depth)если data_format='channels_first' или формой:(samples, new_rows, new_cols, new_depth, 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. Аргументы: states: Массивы NumPy, содержащие значения для начального состояния, которые будут переданы ячейке в первый временной шаг. Когда значение равно None, будет создан нулевой массив NumPy, основанный на размере состояния ячейки.
| Исключения | |
|---|---|
AttributeError | Если слой RNN не состоятельный. |
ValueError | Если размер пачки слоя RNN неизвестен. |
ValueError | Если массив NumPy несовместим со состоянием слоя RNN, как по размеру, так и по типу данных. |
© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.9/api_docs/python/tf/keras/layers/ConvLSTM3D