Esta página foi traduzida pela API Cloud Translation.
Switch to English

tf.TensorShape

TensorFlow 1 versão Ver fonte no GitHub

Representa a forma de um Tensor .

Usado nos cadernos

Usado na guia Usado nos tutoriais

Um TensorShape representa uma especificação forma possivelmente-parcial para um Tensor . Pode ser um dos seguintes:

  • Forma totalmente conhecidas: tem um número conhecido de dimensões e um tamanho conhecido para cada dimensão. por exemplo TensorShape([16, 256])
  • Forma parcialmente conhecida: tem um número de dimensões conhecidas, e um tamanho desconhecido para uma ou mais dimensões. por exemplo TensorShape([None, 256])
  • Forma desconhecido: tem um número desconhecido de dimensões, e um tamanho desconhecido em todas as dimensões. por exemplo TensorShape(None)

Se um tensor é produzido por uma operação do tipo "Foo" , a sua forma pode-se inferir se existe uma função forma registrado para "Foo" . Veja Funções de forma para obter detalhes sobre funções de forma e como se inscrever eles. Alternativamente, a forma pode ser explicitamente definida usando tf.Tensor.set_shape .

dims A lista de dimensões, ou Nenhum se a forma não é especificado.

TypeError Se escurece não pode ser convertido para uma lista de dimensões.

dims Descontinuada. Devolve uma lista de dimensões para esta forma.

Sugerir TensorShape.as_list vez.

ndims Acessor obsoleto para rank .
rank Devolve a classificação desta forma, ou Nenhum se não é especificado.

Métodos

as_list

Ver fonte

Retorna uma lista de números inteiros ou None para cada dimensão.

Devoluções
Uma lista de números inteiros ou None para cada dimensão.

Levanta
ValueError Se self é uma forma desconhecida com uma classificação desconhecida.

as_proto

Ver fonte

Retorna esta forma como um TensorShapeProto .

assert_has_rank

Ver fonte

Levanta uma exceção se self não é compatível com o determinado rank .

args
rank Um inteiro.

Levanta
ValueError Se self não representa uma forma com um determinado rank .

assert_is_compatible_with

Ver fonte

Levanta exceção se self e other não representam a mesma forma.

Este método pode ser usado para afirmar que existe uma forma que tanto self e other representam.

args
other Outra TensorShape.

Levanta
ValueError Se self e other não representam a mesma forma.

assert_is_fully_defined

Ver fonte

Levanta uma exceção se self não está totalmente definido em todas as dimensões.

Levanta
ValueError Se self não tem um valor conhecido para cada dimensão.

assert_same_rank

Ver fonte

Levanta uma exceção se self e other não têm fileiras compatíveis.

args
other Outra TensorShape .

Levanta
ValueError Se self e other não representem formas com o mesmo valor.

concatenate

Ver fonte

Retorna a concatenação da dimensão em self e other .

args
other Outra TensorShape .

Devoluções
Um TensorShape cujas dimensões são a concatenação das dimensões em self e other .

is_compatible_with

Ver fonte

Retorna true se e somente se self é compatível com a other .

Duas formas possivelmente parcialmente-definidas são compatíveis quando existe uma forma totalmente definido que ambas as formas podem representar. Assim, permite que o código de compatibilidade inferência forma para raciocinar sobre formas parcialmente definidas. Por exemplo:

  • TensorShape (None) é compatível com todas as formas.

  • TensorShape ([Nada, Nada]) é compatível com todas as formas bidimensionais, tais como TensorShape ([32, 784]), e também TensorShape (Nenhum). Ele não é compatível com, por exemplo, TensorShape ([Nenhum]) ou TensorShape ([Nada, Nada, Nenhum]).

  • TensorShape ([32, Nenhum]) é compatível com todas as formas bidimensionais com tamanho 32 na dimensão 0, e também TensorShape ([Nada, Nada]) e TensorShape (Nenhum). Ele não é compatível com, por exemplo, TensorShape ([32]), TensorShape ([32, Nenhum, 1]) ou TensorShape ([64, Nenhum]).

  • TensorShape ([32, 784]) é compatível com a própria, e também TensorShape ([32, Nenhum]), TensorShape ([Nenhum, 784]), TensorShape ([Nada, Nada]) e TensorShape (Nenhum). Ele não é compatível com, por exemplo, TensorShape ([32, 1, 784]) ou TensorShape ([Nenhum]).

A relação compatibilidade é reflexiva e simétrica, mas não transitiva. Por exemplo, TensorShape ([32, 784]) é compatível com TensorShape (Nenhum), e TensorShape (Nenhum) é compatível com TensorShape ([4, 4]), mas TensorShape ([32, 784]) não é compatível com TensorShape ([4, 4]).

args
other Outra TensorShape.

Devoluções
Verdadeira sse self é compatível com a other .

is_fully_defined

Ver fonte

Retorna true se e somente se self está totalmente definido em todas as dimensões.

merge_with

Ver fonte

Retorna um TensorShape combinando as informações em self e other .

As dimensões de self e other são fundidos elemento a elemento, de acordo com as regras definidas para Dimension.merge_with() .

args
other Outra TensorShape .

Devoluções
Um TensorShape contendo a informação combinada de self e other .

Levanta
ValueError Se self e other não são compatíveis.

most_specific_compatible_shape

Ver fonte

Retorna o TensorShape mais específico compatível com a self e other .

  • TensorShape ([Nenhum, 1]) é o mais TensorShape específico compatível com ambas TensorShape ([2, 1]) e TensorShape ([5, 1]). Note-se que TensorShape (Nenhum) também é compatível com TensorShapes acima mencionados.

  • TensorShape ([1, 2, 3]), é a mais TensorShape específico compatível com ambas TensorShape ([1, 2, 3]) e TensorShape ([1, 2, 3]). Há mais TensorShapes menos específicos compatíveis com os acima mencionados, por exemplo, TensorShapes TensorShape ([1, 2, Nenhum]), TensorShape (Nenhum).

args
other Outra TensorShape .

Devoluções
A TensorShape que é a forma compatível específica a maioria dos self e other .

num_elements

Ver fonte