tf.experimental.DynamicRaggedShape

Форма тензора с неоднородной или плотной структурой.

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

tf.experimental.DynamicRaggedShape(
    row_partitions: Sequence[tf.experimental.RowPartition],
    inner_shape: tf.types.experimental.TensorLike,
    dtype: Optional[tf.dtypes.DType] = None,
    validate: bool = False,
    static_inner_shape: ... = None
)

Используется в блокнотах

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

• 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 равно None, используется минимальное значение num_row_partitions.

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

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

В следующей таблице приведено несколько примеров (где 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
)

Создаёт форму из разделов строк.

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.