tf.keras.layers.ConvLSTM3D
3D Свёрточная LSTM.
Наследуется от: RNN, Layer, Operation
tf.keras.layers.ConvLSTM3D(
filters,
kernel_size,
strides=1,
padding='valid',
data_format=None,
dilation_rate=1,
activation='tanh',
recurrent_activation='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,
dropout=0.0,
recurrent_dropout=0.0,
seed=None,
return_sequences=False,
return_state=False,
go_backwards=False,
stateful=False,
**kwargs
)
Аналогично слою LSTM, но преобразования входных данных и рекуррентные преобразования — оба свёрточные.
| Аргументы | |
|---|---|
filters | int, размерность выходного пространства (количество фильтров в свёртке). |
kernel_size | int или кортеж/список из 3 целых чисел, определяющий размер окна свёртки. |
strides | int или кортеж/список из 3 целых чисел, определяющий шаг свёртки. strides > 1 несовместимо с dilation_rate > 1. |
padding | строка, "valid" или "same" (регистр не учитывается). "valid" означает отсутствие заполнения. "same" приводит к равномерному заполнению слева/справа или сверху/снизу входных данных таким образом, что выходные высота/ширина совпадают с входными. |
data_format | строка, либо "channels_last" или "channels_first". Порядок измерений во входных данных. "channels_last" соответствует входам с формой (batch, steps, features), а "channels_first" соответствует входам с формой (batch, features, steps). По умолчанию используется значение image_data_format, найденное в файле конфигурации Keras по адресу ~/.keras/keras.json. Если вы его никогда не устанавливали, то он будет "channels_last". |
dilation_rate | int или кортеж/список из 3 целых чисел, определяющий скорость расширения для свёртки с расширением. |
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 | Функция ограничения, применяемая к вектору смещения. |
dropout | Вещественное число от 0 до 1. Доля единиц для выпадения при линейном преобразовании входных данных. |
recurrent_dropout | Вещественное число от 0 до 1. Доля единиц для выпадения при линейном преобразовании рекуррентного состояния. |
seed | Случайное семя для выпадения. |
return_sequences | Булево значение. Возвращать ли последнее выходное значение в последовательности выходов или всю последовательность. По умолчанию: False. |
return_state | Булево значение. Возвращать ли последнее состояние дополнительно к выходу. По умолчанию: False. |
go_backwards | Булево (по умолчанию: False). Если True, обрабатывать последовательность в обратном порядке и вернуть обращённую последовательность. |
stateful | Булево (по умолчанию False). Если True, последнее состояние для каждого образца в индексе i в наборе будет использоваться в качестве начального состояния для образца в индексе i в следующем наборе. |
unroll | Булево (по умолчанию: False). Если True, сеть будет развернута, иначе будет использоваться символический цикл. Развёртывание может ускорить RNN, хотя оно, как правило, более ресурсоёмкое. Развёртывание подходит только для коротких последовательностей. |
| Аргументы вызова | |
|---|---|
inputs | 6D тензор. |
mask | Бинарный тензор формы (samples, timesteps), указывающий, следует ли маскировать определённый шаг во времени. |
training | Булевое значение Python, указывающее, должна ли слои работать в режиме обучения или в режиме вывода. Это актуально только если dropout или recurrent_dropout установлены. |
initial_state | Список начальных тензоров состояния, которые необходимо передать в первый вызов ячейки. |
Форма входа:
- Если
data_format='channels_first': 5D тензор с формой:(samples, time, channels, *spatial_dims) - Если
data_format='channels_last': 5D тензор с формой:(samples, time, *spatial_dims, channels)
Форма выхода:
- Если
return_state: список тензоров. Первый тензор — выход. Остальные тензоры — последние состояния, каждый 4D тензор с формой:(samples, filters, *spatial_dims), еслиdata_format='channels_first'или формой:(samples, *spatial_dims, filters), еслиdata_format='channels_last'. - Если
return_sequences: 5D тензор с формой:(samples, timesteps, filters, *spatial_dims), если data_format='channels_first' или формой:(samples, timesteps, *spatial_dims, filters), еслиdata_format='channels_last'. - В противном случае 4D тензор с формой:
(samples, filters, *spatial_dims), еслиdata_format='channels_first'или формой:(samples, *spatial_dims, filters), еслиdata_format='channels_last'.
Ссылки:
- Ши и др., 2015 (текущая реализация не включает петлю обратной связи по выходу ячеек).
| Атрибуты | |
|---|---|
activation | |
bias_constraint | |
bias_initializer | |
bias_regularizer | |
data_format | |
dilation_rate | |
dropout | |
filters | |
input | Извлекает тензор(ы) входа(ов) символической операции. Возвращает только тензор(ы), соответствующие первому вызову операции. |
kernel_constraint | |
kernel_initializer | |
kernel_regularizer | |
kernel_size | |
output | Извлекает выходной(ые) тензор(ы) слоя. Возвращает только тензор(ы), соответствующие первому вызову операции. |
padding | |
recurrent_activation | |
recurrent_constraint | |
recurrent_dropout | |
recurrent_initializer | |
recurrent_regularizer | |
strides | |
unit_forget_bias | |
use_bias | |
Методы
from_config
@classmethod
from_config(
config
)
Создаёт слой из его конфигурации.
Этот метод — обратный к get_config, способный создать тот же слой из словаря конфигурации. Он не обрабатывает подключение слоёв (обрабатывается Network), а также веса (обрабатываются set_weights).
| Аргументы | |
|---|---|
config | Словарь Python, обычно выход get_config. |
| Возвращает | |
|---|---|
| Экземпляр слоя. |
get_initial_state
get_initial_state(
batch_size
)
inner_loop
inner_loop(
sequences, initial_state, mask, training=False
)
reset_state
reset_state()
reset_states
reset_states()
symbolic_call
symbolic_call(
*args, **kwargs
)
© 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/api_docs/python/tf/keras/layers/ConvLSTM3D