tf.TypeSpec

Задает тип значения TensorFlow.

Наследуется от: TraceType

tf.TypeSpec предоставляет метаданные, описывающие объект, принимаемый или возвращаемый API TensorFlow. Конкретные подклассы, такие как tf.TensorSpec и tf.RaggedTensorSpec, используются для описания различных типов значений.

Например, аргумент input_signature функции tf.function принимает список (или вложенную структуру) объектов TypeSpec.

В настоящее время создание новых подклассов TypeSpec (за пределами ядра TensorFlow) не поддерживается. В частности, мы можем внести несовместимые изменения в закрытые методы и свойства, определенные этим базовым классом.

Пример:

spec = tf.TensorSpec(shape=[None, None], dtype=tf.int32)
@tf.function(input_signature=[spec])
def double(x):
  return x * 2
double(tf.constant([[1, 2], [3, 4]]))
<tf.Tensor: shape=(2, 2), dtype=int32,
    numpy=array([[2, 4], [6, 8]], dtype=int32)>

Методы

experimental_as_proto

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

experimental_as_proto() -> struct_pb2.TypeSpecProto

Возвращает представление экземпляра TypeSpec в виде proto.

НЕ переопределяйте для пользовательских типов, не относящихся к TensorFlow.

experimental_from_proto

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

@classmethod
experimental_from_proto(
    proto: struct_pb2.TypeSpecProto
) -> 'TypeSpec'

Возвращает экземпляр TypeSpec на основе сериализованного proto.

НЕ переопределяйте для пользовательских типов, не относящихся к TensorFlow.

experimental_type_proto

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

@classmethod
experimental_type_proto() -> Type[struct_pb2.TypeSpecProto]

Возвращает тип proto, связанный с сериализацией TypeSpec.

НЕ переопределяйте для пользовательских типов, не относящихся к TensorFlow.

is_compatible_with

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

is_compatible_with(
    spec_or_value
)

Возвращает значение true, если spec_or_value совместим с этим TypeSpec.

По возможности предпочитайте использовать «is_subtype_of» и «most_specific_common_supertype».

is_subtype_of

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

is_subtype_of(
    other: tf.types.experimental.TraceType
) -> bool

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

Реализует интерфейс tf.types.experimental.func.TraceType.

Если подкласс не переопределяет поведение по умолчанию, предполагается, что TypeSpec ковариантен относительно атрибутов, реализующих TraceType, и инвариантен относительно остальных атрибутов, а также структуры и типа TypeSpec.

most_specific_common_supertype

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

most_specific_common_supertype(
    others: Sequence[tf.types.experimental.TraceType]
) -> Optional['TypeSpec']

Возвращает наиболее специфичный супертип TypeSpec для self и others.

Реализует интерфейс tf.types.experimental.func.TraceType.

Если подкласс не переопределяет поведение по умолчанию, предполагается, что TypeSpec ковариантен относительно атрибутов, реализующих TraceType, и инвариантен относительно остальных атрибутов, а также структуры и типа TypeSpec.

most_specific_compatible_type

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

most_specific_compatible_type(
    other: 'TypeSpec'
) -> 'TypeSpec'

Возвращает наиболее специфичный TypeSpec, совместимый с self и other. (устарело)

Устарело. Используйте вместо этого most_specific_common_supertype. Не переопределяйте эту функцию.

__eq__

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

__eq__(
    other
) -> bool

Возвращает результат self==value.

__ne__

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

__ne__(
    other
) -> bool

Возвращает результат self!=value.