tf.TensorShape

Представляет форму Tensor.

tf.TensorShape(
    dims
)

Объект TensorShape представляет собой возможно частичное описание формы Tensor. Он может быть одним из следующих:

• Полностью известная форма: имеет известное число измерений и известный размер для каждого измерения. Пример: TensorShape([16, 256])
• Частично известная форма: имеет известное число измерений и неизвестный размер для одного или нескольких измерений. Пример: TensorShape([None, 256])
• Неизвестная форма: имеет неизвестное число измерений и неизвестный размер во всех измерениях. Пример: TensorShape(None)

Если тензор получен в результате операции типа "Foo", его форму можно вывести, если для "Foo" зарегистрирована функция определения формы. Подробности о функциях определения формы и способах их регистрации см. в разделе Функции определения формы. В качестве альтернативы, форму можно задать явно, используя tf.Tensor.set_shape.

Методы

as_list

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

as_list()

Возвращает список целых чисел или None для каждого измерения.

as_proto

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

as_proto()

Возвращает эту форму в виде TensorShapeProto.

assert_has_rank

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

assert_has_rank(
    rank
)

Вызывает исключение, если self не совместима с заданным rank.

assert_is_compatible_with

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

assert_is_compatible_with(
    other
)

Вызывает исключение, если self и other не представляют одну и ту же форму.

Этот метод можно использовать для проверки существования формы, которую представляют как self, так и other.

assert_is_fully_defined

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

assert_is_fully_defined()

Вызывает исключение, если self не определена полностью во всех измерениях.

assert_same_rank

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

assert_same_rank(
    other
)

Вызывает исключение, если self и other не имеют совместимых рангов.

concatenate

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

concatenate(
    other
)

Возвращает конкатенацию измерений в self и other.

Примечание: Если self или other полностью неизвестны, конкатенация отбросит информацию о другой форме. В будущем мы можем поддерживать конкатенацию, сохраняющую эту информацию для использования со срезами.

is_compatible_with

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

is_compatible_with(
    other
)

Возвращает True, если self совместимо с other.

Две возможно частично определённые формы совместимы, если существует полностью определённая форма, которую оба могут представлять. Таким образом, совместимость позволяет коду вывода формы рассуждать о частично определённых формах. Например:

• TensorShape(None) совместимо со всеми формами.

• TensorShape([None, None]) совместимо со всеми двумерными формами, такими как TensorShape([32, 784]), а также TensorShape(None). Оно не совместимо, например, с TensorShape([None]) или TensorShape([None, None, None]).

• TensorShape([32, None]) совместимо со всеми двумерными формами с размером 32 в 0-м измерении, а также TensorShape([None, None]) и TensorShape(None). Оно не совместимо, например, с TensorShape([32]), TensorShape([32, None, 1]) или TensorShape([64, None]).

• TensorShape([32, 784]) совместимо само с собой, а также с TensorShape([32, None]), TensorShape([None, 784]), TensorShape([None, None]) и TensorShape(None). Оно не совместимо, например, с TensorShape([32, 1, 784]) или TensorShape([None]).

Отношение совместимости рефлексивно и симметрично, но не транзитивно. Например, TensorShape([32, 784]) совместимо с TensorShape(None), а TensorShape(None) совместимо с TensorShape([4, 4]), но TensorShape([32, 784]) не совместимо с TensorShape([4, 4]).

is_fully_defined

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

is_fully_defined()

Возвращает True, если self полностью определена во всех измерениях.

merge_with

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

merge_with(
    other
)

Возвращает TensorShape, объединяющую информацию в self и other.

Размеры в self и other объединяются поэлементно в соответствии с правилами, определёнными для Dimension.merge_with().

most_specific_compatible_shape

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

most_specific_compatible_shape(
    other
)

Возвращает наиболее специфичную форму TensorShape, совместимую с self и other.

• TensorShape([None, 1]) — это наиболее специфичная TensorShape, совместимая как с TensorShape([2, 1]), так и с TensorShape([5, 1]). Обратите внимание, что TensorShape(None) также совместима с вышеупомянутыми TensorShape.

• TensorShape([1, 2, 3]) — это наиболее специфичная TensorShape, совместимая как с TensorShape([1, 2, 3]), так и с TensorShape([1, 2, 3]). Существуют и менее специфичные TensorShape, совместимые с вышеупомянутыми TensorShape, например, TensorShape([1, 2, None]), TensorShape(None).

num_elements

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

num_elements()

Возвращает общее количество элементов или None для неполных форм.

with_rank

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

with_rank(
    rank
)

Возвращает форму на основе self с заданным рангом.

Этот метод преобразует полностью неизвестную форму в форму с известным рангом.

with_rank_at_least

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

with_rank_at_least(
    rank
)

Возвращает форму на основе self с по крайней мере заданным рангом.

with_rank_at_most

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

with_rank_at_most(
    rank
)

Возвращает форму на основе self с максимально заданным рангом.

__add__

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

__add__(
    other
)

__bool__

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

__bool__()

Возвращает True, если эта форма содержит ненулевую информацию.

__concat__

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

__concat__(
    other
)

__eq__

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

__eq__(
    other
)

Возвращает True, если self эквивалентна other.

__getitem__

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

__getitem__(
    key
)

Возвращает значение измерения или формы в зависимости от ключа.

__iter__

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

__iter__()

Возвращает self.dims если ранг известен, в противном случае генерирует ValueError.

__len__

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

__len__()

Возвращает ранг этой формы или генерирует ValueError, если он не указан.

__ne__

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

__ne__(
    other
)

Возвращает True, если self известно как отличное от other.

__nonzero__

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

__nonzero__()

Возвращает True, если эта форма содержит ненулевую информацию.

__radd__

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

__radd__(
    other
)