tf.expand_dims
| Просмотреть исходный код на GitHub |
Вставляет размерность 1 в форму тензора. (Устаревшие аргументы)
tf.expand_dims(
input, axis=None, name=None, dim=None
)
Учитывая тензор input, эта операция вставляет размерность 1 в индекс размерности axis формы input. Индекс размерности axis начинается с нуля; если вы укажете отрицательное число для axis, оно будет отсчитываться от конца.
Эта операция полезна, если требуется добавить размерность пакетной обработки к одному элементу. Например, если у вас есть один образ с формой [height, width, channels], можно преобразовать его в пакет из 1 изображения с помощью expand_dims(image, 0), что приведет к форме [1, height, width, channels].
Другие примеры:
# 't' is a tensor of shape [2] tf.shape(tf.expand_dims(t, 0)) # [1, 2] tf.shape(tf.expand_dims(t, 1)) # [2, 1] tf.shape(tf.expand_dims(t, -1)) # [2, 1] # 't2' is a tensor of shape [2, 3, 5] tf.shape(tf.expand_dims(t2, 0)) # [1, 2, 3, 5] tf.shape(tf.expand_dims(t2, 2)) # [2, 3, 1, 5] tf.shape(tf.expand_dims(t2, 3)) # [2, 3, 5, 1]
Эта операция требует, чтобы:
-1-input.dims() <= dim <= input.dims()
Эта операция связана с squeeze(), которая удаляет размерности размером 1.
| Аргументы | |
|---|---|
input | Tensor. |
axis | 0-мерный (скалярный). Указывает индекс размерности, в котором необходимо расширить форму input. Должно находиться в диапазоне [-rank(input) - 1, rank(input)]. |
name | Имя выходного Tensor (необязательно). |
dim | 0-мерный (скалярный). Эквивалентно axis, подлежит устареванию. |
| Возвращаемые значения | |
|---|---|
Tensor с теми же данными, что и input, но его форма имеет дополнительную размерность размером 1. |
| Исключения | |
|---|---|
ValueError | если указаны оба или ни один из dim и axis. |
© 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/r1.15/api_docs/python/tf/expand_dims