tf.keras.layers.Conv2D
| Просмотреть исходный код на GitHub |
2D-слой свёртки (например, пространственная свёртка изображений).
tf.keras.layers.Conv2D(
filters, kernel_size, strides=(1, 1), padding='valid', data_format=None,
dilation_rate=(1, 1), groups=1, activation=None, use_bias=True,
kernel_initializer='glorot_uniform', bias_initializer='zeros',
kernel_regularizer=None, bias_regularizer=None, activity_regularizer=None,
kernel_constraint=None, bias_constraint=None, **kwargs
)
Этот слой создаёт ядро свёртки, которое свёртывается с входным слоем для получения тензора выходов. Если use_bias равно True, создаётся вектор смещения, который добавляется к выходам. Наконец, если activation не равно None, он также применяется к выходам.
При использовании этого слоя в качестве первого слоя в модели укажите ключевое слово input_shape (кортеж целых чисел, не включая ось образца), например, input_shape=(128, 128, 3) для 128x128 RGB изображений в data_format="channels_last".
Примеры:
# The inputs are 28x28 RGB images with `channels_last` and the batch # size is 4. input_shape = (4, 28, 28, 3) x = tf.random.normal(input_shape) y = tf.keras.layers.Conv2D( 2, 3, activation='relu', input_shape=input_shape[1:])(x) print(y.shape) (4, 26, 26, 2)
# With `dilation_rate` as 2. input_shape = (4, 28, 28, 3) x = tf.random.normal(input_shape) y = tf.keras.layers.Conv2D( 2, 3, activation='relu', dilation_rate=2, input_shape=input_shape[1:])(x) print(y.shape) (4, 24, 24, 2)
# With `padding` as "same". input_shape = (4, 28, 28, 3) x = tf.random.normal(input_shape) y = tf.keras.layers.Conv2D( 2, 3, activation='relu', padding="same", input_shape=input_shape[1:])(x) print(y.shape) (4, 28, 28, 2)
# With extended batch shape [4, 7]: input_shape = (4, 7, 28, 28, 3) x = tf.random.normal(input_shape) y = tf.keras.layers.Conv2D( 2, 3, activation='relu', input_shape=input_shape[2:])(x) print(y.shape) (4, 7, 26, 26, 2)
| Аргументы | |
|---|---|
filters | Целое число, размерность выходного пространства (т.е. количество выходных фильтров свёртки). |
kernel_size | Целое число или кортеж/список из 2 целых чисел, определяющий высоту и ширину окна 2D-свёртки. Может быть целым числом для указания одинакового значения для всех пространственных измерений. |
strides | Целое число или кортеж/список из 2 целых чисел, определяющий шаги свёртки по высоте и ширине. Может быть целым числом для указания одинакового значения для всех пространственных измерений. Указание любого значения шага != 1 несовместимо с указанием любого значения dilation_rate != 1. |
padding | один из "valid" или "same" (регистр не учитывается). |
data_format | Строка, один из channels_last (по умолчанию) или channels_first. Порядок измерений во входных данных. channels_last соответствует входным данным с формой (batch_size, height, width, channels), а channels_first соответствует входным данным с формой (batch_size, channels, height, width). По умолчанию используется значение image_data_format в файле конфигурации Keras по адресу ~/.keras/keras.json. Если вы его никогда не задавали, то это будет channels_last. |
dilation_rate | Целое число или кортеж/список из 2 целых чисел, определяющий скорость сжатия для использования свёртки с сжатием. Может быть целым числом для указания одинакового значения для всех пространственных измерений. В настоящее время указание любого значения dilation_rate != 1 несовместимо с указанием любого значения шага != 1. |
groups | Положительное целое число, определяющее количество групп, на которые входной сигнал разбивается по оси канала. Каждая группа свёртывается отдельно с filters / groups фильтрами. Выход представляет собой конкатенацию всех результатов groups по оси канала. Входные каналы и filters должны быть кратными groups. |
activation | Функция активации для использования. Если вы ничего не укажете, то активация не применяется (см. keras.activations). |
use_bias | Булево значение, указывает, использует ли слой вектор смещения. |
kernel_initializer | Инициализатор матрицы весов kernel (см. keras.initializers). |
bias_initializer | Инициализатор вектора смещения (см. keras.initializers). |
kernel_regularizer | Функция регуляризации, применяемая к матрице весов kernel (см. keras.regularizers). |
bias_regularizer | Функция регуляризации, применяемая к вектору смещения (см. keras.regularizers). |
activity_regularizer | Функция регуляризации, применяемая к выходу слоя (его "активации") (см. keras.regularizers). |
kernel_constraint | Функция ограничения, применяемая к матрице ядра (см. keras.constraints). |
bias_constraint | Функция ограничения, применяемая к вектору смещения (см. keras.constraints). |
Форма входных данных:
4+D тензор с формой: batch_shape + (channels, rows, cols) если data_format='channels_first' или 4+D тензор с формой: batch_shape + (rows, cols, channels) если data_format='channels_last'.
Форма выходных данных:
4+D тензор с формой: batch_shape + (filters, new_rows, new_cols) если data_format='channels_first' или 4+D тензор с формой: batch_shape + (new_rows, new_cols, filters) если data_format='channels_last'. Значения rows и cols могут измениться из-за заполнения.
| Возвращает | |
|---|---|
4+D тензор, представляющий activation(conv2d(inputs, kernel) + bias). |
| Возбуждает | |
|---|---|
ValueError | если padding равно "causal". |
ValueError | при одновременном выполнении strides > 1 и dilation_rate > 1. |
© 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/Conv2D