tensorflow::ops::SampleDistortedBoundingBoxV2

#include <image_ops.h>

Генерирует одну случайную искажённую область для изображения.

Краткое описание

Аннотации границ области часто предоставляются дополнительно к целевым меткам в задачах распознавания изображений или локализации объектов. Распространённый приём для обучения такой системы — случайное искажение изображения при сохранении его содержимого, т. е. аугментация данных. Данный оператор выводит случайное искажение локализации объекта, т. е. границы области, заданной image_size, bounding_boxes и рядом ограничений.

Выходным значением этого оператора является единственная граница области, которая может быть использована для обрезки исходного изображения. Результат возвращается как 3 тензора: begin, size и bboxes. Первые 2 тензора можно напрямую подать на tf.slice для обрезки изображения. Последний может быть передан в tf.image.draw_bounding_boxes для визуализации вида границы области.

Границы области предоставляются и возвращаются как [y_min, x_min, y_max, x_max]. Координаты границ области — числа с плавающей точкой в [0.0, 1.0], относительные к ширине и высоте исходного изображения.

Например,

# Generate a single distorted bounding box.
begin, size, bbox_for_draw = tf.image.sample_distorted_bounding_box(
    tf.shape(image),
    bounding_boxes=bounding_boxes)

# Draw the bounding box in an image summary.
image_with_box = tf.image.draw_bounding_boxes(tf.expand_dims(image, 0),
                                              bbox_for_draw)
tf.summary.image('images_with_box', image_with_box)

# Employ the bounding box to distort the image.
distorted_image = tf.slice(image, begin, size)

Обратите внимание, что если информация о границах области недоступна, установка use_image_if_no_bounding_boxes = true предполагает наличие одной неявной границы области, покрывающей всё изображение. Если use_image_if_no_bounding_boxes имеет значение false, а границы области не указаны, возникает ошибка.

Аргументы:

• scope: Объект Scope
• image_size: 1-мерный массив, содержащий [height, width, channels].
• bounding_boxes: 3-мерный массив с формой [batch, N, 4], описывающий N границ области, связанных с изображением.
• min_object_covered: Область изображения, полученная после обрезки, должна содержать не менее этой доли любой предоставленной границы области. Значение этого параметра должно быть неотрицательным. В случае 0, область обрезки не должна перекрывать ни одну из предоставленных границ области.

Необязательные атрибуты (см. Attrs):

• seed: Если seed или seed2 установлены в ненулевое значение, генератор случайных чисел инициализируется заданным seed. В противном случае он инициализируется случайным значением.
• seed2: Второй параметр для инициализации генератора случайных чисел, чтобы избежать коллизий.
• aspect_ratio_range: Область изображения, полученная после обрезки, должна иметь отношение сторон = ширина / высота в этом диапазоне.
• area_range: Область изображения, полученная после обрезки, должна содержать часть исходного изображения в этом диапазоне.
• max_attempts: Количество попыток генерации области изображения, удовлетворяющей заданным ограничениям. После max_attempts неудачных попыток возвращается всё изображение.
• use_image_if_no_bounding_boxes: Управляет поведением при отсутствии границ области. Если true, предполагается неявная граница области, покрывающая весь вход. Если false, возникает ошибка.

Возвращаемое значение:

• Output begin: 1-мерный массив, содержащий [offset_height, offset_width, 0]. Используется в качестве входных данных для tf.slice.
• Output size: 1-мерный массив, содержащий [target_height, target_width, -1]. Используется в качестве входных данных для tf.slice.
• Output bboxes: 3-мерный массив с формой [1, 1, 4], содержащий искажённую границу области. Используется в качестве входных данных для tf.image.draw_bounding_boxes.

Общедоступные атрибуты

::tensorflow::Output bboxes

::tensorflow::Output begin

Operation operation

::tensorflow::Output size

Общедоступные функции

 SampleDistortedBoundingBoxV2(
  const ::tensorflow::Scope & scope,
  ::tensorflow::Input image_size,
  ::tensorflow::Input bounding_boxes,
  ::tensorflow::Input min_object_covered
)

 SampleDistortedBoundingBoxV2(
  const ::tensorflow::Scope & scope,
  ::tensorflow::Input image_size,
  ::tensorflow::Input bounding_boxes,
  ::tensorflow::Input min_object_covered,
  const SampleDistortedBoundingBoxV2::Attrs & attrs
)

Общедоступные статические функции

Attrs AreaRange(
  const gtl::ArraySlice< float > & x
)

Attrs AspectRatioRange(
  const gtl::ArraySlice< float > & x
)

Attrs MaxAttempts(
  int64 x
)

Attrs Seed(
  int64 x
)

Attrs Seed2(
  int64 x
)

Attrs UseImageIfNoBoundingBoxes(
  bool x
)