tf.experimental.DynamicRaggedShape

Форма разряженного или плотного тензора.

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

tf.experimental.DynamicRaggedShape(
    row_partitions, inner_shape, dtype=None, validate=False
)

Разряженные формы кодируются с помощью двух полей:

• inner_shape: Целочисленный вектор, задающий форму плотного тензора.
• row_partitions: Список объектов RowPartition, описывающих, как эту плоскую форму следует разбить, чтобы добавить разряженные оси.

Если DynamicRaggedShape является формой RaggedTensor rt, то:

1. row_partitions = rt._nested_row_partitions (и, следовательно, len(row_partitions) > 0)
2. inner_shape — это форма rt.flat_values

Если DynamicRaggedShape является формой плотного тензора t, то:

1. row_partitions = []
2. inner_shape — это форма t.

Примеры:

В следующей таблице приведены несколько примеров (где RP(lengths) — сокращение от RowPartition.from_lengths(lengths)):

Подклассы

class Spec

Методы

from_lengths

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

@classmethod
from_lengths(
    lengths: Sequence[Union[Sequence[int], int]],
    num_row_partitions=None,
    dtype=tf.dtypes.int64
)

Создает форму с заданными длинами и num_row_partitions.

Длины могут быть целым неотрицательным числом или списком неотрицательных целых чисел.

Если num_row_partitions равно None, используется минимальное значение num_row_partitions.

Например, [2, (3, 2)] — это форма [[0, 0, 0], [0, 0]], а [2, 2] — форма [[0, 0], [0, 0]]

Выбирается минимальное необходимое значение num_row_partitions (включая ноль).

В следующей таблице приведены несколько примеров (где RP(lengths) — сокращение от RowPartition.from_lengths(lengths)):

Например:

Если требуется, чтобы разбиения строк завершались равномерными разбиениями строк, можно установить num_row_partitions.

Например, ниже URP(3, 12) — это RowPartition.from_uniform_row_length(3, 12)

Представление форм из init():

from_row_partitions

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

@classmethod
from_row_partitions(
    row_partitions, dtype=None
)

Создать форму из row_partitions.

from_tensor

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

@classmethod
from_tensor(
    t, dtype=None
)

Строит разряженную форму для потенциально разряженного тензора.

is_uniform

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

is_uniform(
    axis
)

Возвращает true, если указанное измерение является равномерным.

static_lengths

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

static_lengths(
    ragged_lengths=True
)

Возвращает список статически известных длин осей.

Это представляет известные значения. Для каждого разбиения строк она представляет либо равномерную длину строки (если она статически известна), либо список длин строк, или None, если она статически неизвестна. Для внутренней формы, если ранг известен, то каждое измерение сообщается, если известно, и None в противном случае. Если ранг внутренней формы неизвестен, то возвращаемый список заканчивается многоточием.

with_dtype

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

with_dtype(
    dtype
)

Изменить тип данных формы.

__eq__

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

__eq__(
    other
)

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

__getitem__

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

__getitem__(
    index
)

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

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

Любой срез, который не начинается с нуля, вернет форму с num_row_partitions == 0.

__ne__

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

__ne__(
    other
)

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