Spec-Zone.ru › TensorFlow 2.9

tf.keras.layers.Conv2D

Просмотреть исходный код на GitHub

2D-слой свертки (например, пространственная свертка по изображениям).

Наследуется от: Layer, Module

Просмотр псевдонимов

Основные псевдонимы

tf.keras.layers.Convolution2D

Псевдонимы для миграции

См. Руководство по миграции для получения дополнительной информации.

tf.compat.v1.keras.layers.Conv2D, tf.compat.v1.keras.layers.Convolution2D

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 (кортеж целых чисел или None, не включая ось образца), например, input_shape=(128, 128, 3) для 128x128 RGB изображений в data_format="channels_last". Вы можете использовать None при переменном размере измерения.

Примеры:

# 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" (регистр не учитывается). "valid" означает отсутствие заполнения. "same" приводит к дополнению нулями равномерно слева/справа или сверху/снизу входных данных. Когда padding="same" и strides=1, размер вывода такой же, как и вход.
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). По умолчанию 'glorot_uniform'.
bias_initializer Инициализатор для вектора смещения (см. keras.initializers). По умолчанию 'zeros'.
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.

Методы

convolution_op

Просмотреть исходный код

convolution_op(
    inputs, kernel
)

© 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/Conv2D

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API