tf.sparse.SparseTensor

Представляет разреженный тензор.

tf.sparse.SparseTensor(
    indices, values, dense_shape
)

TensorFlow представляет разреженный тензор как три отдельных плотных тензора: indices, values, и dense_shape. В Python три тензора объединены в класс SparseTensor для удобства использования. Если у вас есть отдельные indices, values, и dense_shape тензоры, оберните их в объект SparseTensor перед передачей в операции ниже.

Конкретно, разреженный тензор SparseTensor(indices, values, dense_shape) состоит из следующих компонентов, где N и ndims — количество элементов и количество измерений в SparseTensor, соответственно:

• indices: 2-мерный тензор int64 с формой [N, ndims], который определяет индексы элементов в разреженном тензоре, содержащие ненулевые значения (элементы нумеруются с нуля). Например, indices=[[1,3], [2,4]] указывает, что элементы с индексами [1,3] и [2,4] имеют ненулевые значения.

• values: 1-мерный тензор любого типа и формы [N], который предоставляет значения для каждого элемента в indices. Например, при условии indices=[[1,3], [2,4]], параметр values=[18, 3.6] указывает, что элемент [1,3] разреженного тензора имеет значение 18, а элемент [2,4] тензора имеет значение 3,6.

• dense_shape: 1-мерный тензор int64 с формой [ndims], который определяет форму плотного тензора. Принимает список, указывающий количество элементов в каждом измерении. Например, dense_shape=[3,6] определяет двумерный тензор 3x6, dense_shape=[2,3,4] определяет трехмерный тензор 2x3x4, а dense_shape=[9] определяет одномерный тензор с 9 элементами.

Соответствующий плотный тензор удовлетворяет условию:

dense.shape = dense_shape
dense[tuple(indices[i])] = values[i]

Согласно соглашению, indices должен быть отсортирован в порядке строк (или, эквивалентно, в лексикографическом порядке по кортежам indices[i]). Это не накладывается при создании объектов SparseTensor, но большинство операций предполагают правильный порядок. Если порядок разреженного тензора st неправильный, можно получить фиксированную версию, вызвав tf.sparse.reorder(st).

Пример: разреженный тензор

SparseTensor(indices=[[0, 0], [1, 2]], values=[1, 2], dense_shape=[3, 4])

представляет плотный тензор

[[1, 0, 0, 0]
 [0, 0, 2, 0]
 [0, 0, 0, 0]]

Методы

consumers

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

consumers()

eval

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

eval(
    feed_dict=None, session=None
)

Вычисляет этот разреженный тензор в сессии.

Вызов этого метода выполнит все предыдущие операции, которые производят входные данные, необходимые для операции, которая производит этот тензор.

Примечание: Перед вызовом SparseTensor.eval(), его граф должен быть запущен в сессии, и либо должна быть доступна стандартная сессия, либо сессия session должна быть указана явно.

from_value

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

@classmethod
from_value(
    sparse_tensor_value
)

get_shape

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

get_shape()

Получить тензор, представляющий форму плотного тензора.

__div__

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

__div__(
    sp_x, y
)

Делит SparseTensor на плотный тензор поэлементно.

Ограничение: эта операция выполняет распределение только для плотного тензора по отношению к разреженному, но не в обратную сторону.

__mul__

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

__mul__(
    sp_x, y
)

Поэлементно умножает SparseTensor на плотный тензор.

Позиции вывода, соответствующие неявно нулевым элементам в разреженном тензоре, будут нулевыми (то есть не будут занимать место в памяти), независимо от содержимого плотного тензора (даже если он +/-INF, и INF*0 == NaN).

Ограничение: эта операция выполняет распределение только для плотного тензора по отношению к разреженному, но не в обратную сторону.

__truediv__

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

__truediv__(
    sp_x, y
)

Внутренняя вспомогательная функция для 'sp_t / dense_t'.