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
)