Spec-Zone.ru › TensorFlow 2.3

tf.sparse.bincount

Подсчёт количества вхождений целочисленного значения в тензоре.

Просмотр псевдонимов

Псевдонимы совместимости для миграции

См. Руководство по миграции для получения более подробной информации.

tf.compat.v1.sparse.bincount

tf.sparse.bincount(
    values, weights=None, axis=0, minlength=None, maxlength=None,
    binary_output=False, name=None
)

Этот оператор принимает N-мерный Tensor, RaggedTensor, или SparseTensor, и возвращает N-мерный int64 SparseTensor, где элемент [i0...i[axis], j] содержит количество раз, которое значение j встречается в срезе [i0...i[axis], :] входного тензора. В настоящее время поддерживаются только N=0 и N=-1.

Аргументы
values Тензор, RaggedTensor или SparseTensor, значения которых необходимо подсчитать. Эти тензоры должны иметь ранг 2, если axis=-1.
weights Если не None, должен иметь ту же форму, что и arr. Для каждого значения в value, ячейка будет инкрементирована соответствующим весом, а не на 1.
axis Ось для срезки. Оси на и ниже axis будут сглажены перед подсчётом в ячейках. В настоящее время поддерживаются только 0, и -1. Если None, все оси будут сглажены (эквивалентно передаче 0).
minlength Если задано, гарантирует, что у выходных данных есть длина не меньше minlength, дополняя нулями в конце при необходимости.
maxlength Если задано, пропускает значения в values, которые равны или больше maxlength, гарантируя, что выходные данные имеют максимальную длину maxlength.
binary_output Если True, этот оператор выведет 1 вместо количества вхождений токена (эквивалентно one_hot + reduce_any вместо one_hot + reduce_add). По умолчанию False.
name Имя для этого оператора.
Возвращаемые значения
SparseTensor с output.shape = values.shape[:axis] + [N], где N равен
  • maxlength (если задано);
  • minlength (если задано и minlength > reduce_max(values));
  • 0 (если values пусто);
  • reduce_max(values) + 1 в противном случае.

Примеры:

Подсчёт каждого элемента в отдельных партиях

Этот пример принимает входной сигнал (который может быть тензором, RaggedTensor или SparseTensor) и возвращает SparseTensor, где значение (i, j) — это количество раз, когда значение j встречается в партии i.

data = np.array([[10, 20, 30, 20], [11, 101, 11, 10001]], dtype=np.int64)
output = tf.sparse.bincount(data, axis=-1)
print(output)
SparseTensor(indices=tf.Tensor(
[[    0    10]
 [    0    20]
 [    0    30]
 [    1    11]
 [    1   101]
 [    1 10001]], shape=(6, 2), dtype=int64),
 values=tf.Tensor([1 2 1 2 1 1], shape=(6,), dtype=int64),
 dense_shape=tf.Tensor([    2 10002], shape=(2,), dtype=int64))

Подсчёт с определённой формой выходных данных

Этот пример принимает входной сигнал (который может быть тензором, RaggedTensor или SparseTensor) и возвращает SparseTensor, где значение (i, j) — это количество раз, когда значение j встречается в партии i. Однако все значения j, превышающие 'maxlength', игнорируются. Dense_shape выходного SparseTensor устанавливается в 'minlength'. Обратите внимание, что, хотя входной сигнал идентичен примеру выше, значение '10001' в элементе партии 2 опускается, а форма dense_shape — [2, 500], а не [2, 10002] или [2, 102].

minlength = maxlength = 500
data = np.array([[10, 20, 30, 20], [11, 101, 11, 10001]], dtype=np.int64)
output = tf.sparse.bincount(
   data, axis=-1, minlength=minlength, maxlength=maxlength)
print(output)
SparseTensor(indices=tf.Tensor(
[[  0  10]
 [  0  20]
 [  0  30]
 [  1  11]
 [  1 101]], shape=(5, 2), dtype=int64),
 values=tf.Tensor([1 2 1 2 1], shape=(5,), dtype=int64),
 dense_shape=tf.Tensor([  2 500], shape=(2,), dtype=int64))

Двоичный подсчёт

Этот пример принимает входной сигнал (который может быть тензором, RaggedTensor или SparseTensor) и возвращает SparseTensor, где (i, j) равно 1, если значение j встречается в партии i хотя бы один раз, и 0 в противном случае. Обратите внимание, что, даже если некоторые значения (например, 20 в партии 1 и 11 в партии 2) встречаются более одного раза, тензор 'values' содержит только единицы.

data = np.array([[10, 20, 30, 20], [11, 101, 11, 10001]], dtype=np.int64)
output = tf.sparse.bincount(data, binary_output=True, axis=-1)
print(output)
SparseTensor(indices=tf.Tensor(
[[    0    10]
 [    0    20]
 [    0    30]
 [    1    11]
 [    1   101]
 [    1 10001]], shape=(6, 2), dtype=int64),
 values=tf.Tensor([1 1 1 1 1 1], shape=(6,), dtype=int64),
 dense_shape=tf.Tensor([    2 10002], shape=(2,), dtype=int64))

Подсчёт с весами

Этот пример принимает два входных сигнала — тензор значений и тензор весов. Эти тензоры должны иметь одинаковую форму и одинаковые строки или индексы в случае RaggedTensors или SparseTensors. При подсчёте с весами оператор выведет SparseTensor, где значение (i, j) — это сумма значений в тензоре весов для партии i в местах, где тензор значений имеет значение j. В этом случае тип выходных данных совпадает с типом данных тензора весов.

data = np.array([[10, 20, 30, 20], [11, 101, 11, 10001]], dtype=np.int64)
weights = [[2, 0.25, 15, 0.5], [2, 17, 3, 0.9]]
output = tf.sparse.bincount(data, weights=weights, axis=-1)
print(output)
SparseTensor(indices=tf.Tensor(
[[    0    10]
 [    0    20]
 [    0    30]
 [    1    11]
 [    1   101]
 [    1 10001]], shape=(6, 2), dtype=int64),
 values=tf.Tensor([2. 0.75 15. 5. 17. 0.9], shape=(6,), dtype=float32),
 dense_shape=tf.Tensor([    2 10002], shape=(2,), dtype=int64))

© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.3/api_docs/python/tf/sparse/bincount

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API