tf.sparse.reset_shape

Сбрасывает форму SparseTensor, не изменяя индексы и значения.

Показать псевдонимы

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

Подробнее см. в руководстве по миграции.

tf.compat.v1.sparse.reset_shape, tf.compat.v1.sparse_reset_shape

tf.sparse.reset_shape(
    sp_input, new_shape=None
)

Если new_shape равно None, возвращает копию sp_input с формой, сброшенной до минимальной ограничивающей рамки sp_input. Если у sp_input нет значений, формой будут нули во всех измерениях.

Если задано new_shape, оно должно быть больше или равно форме sp_input по всем измерениям. Если это условие выполнено, форма возвращённого SparseTensor будет сброшена до new_shape, а его индексы и значения останутся такими же, как у sp_input..

Пример

Пример
Рассмотрим `sp_input` с формой [2, 3, 5]: Задать `new_shape` как [3, 7] нельзя, поскольку это соответствует тензору ранга 2, тогда как `sp_input` имеет ранг 3. В этом случае при построении графа возникнет ValueError (если обе формы известны) или во время выполнения — OpError. Значение `new_shape`, равное [2, 3, 6], допустимо, поскольку по каждому измерению эта форма больше или равна исходной форме [2, 3, 5]. С другой стороны, задать new_shape как [2, 3, 4] также нельзя: третье измерение меньше, чем в исходной форме 2, 3, 5. Если `new_shape` равно None, возвращённый SparseTensor будет иметь форму [2, 3, 4], соответствующую минимальной ограничивающей рамке `sp_input`.

Рассмотрим sp_input с формой [2, 3, 5]:

Задать new_shape как [3, 7] нельзя, поскольку это соответствует тензору ранга 2, тогда как sp_input имеет ранг 3. В этом случае при построении графа возникнет ValueError (если обе формы известны) или во время выполнения — OpError.
Значение new_shape, равное [2, 3, 6], допустимо, поскольку по каждому измерению эта форма больше или равна исходной форме [2, 3, 5].
С другой стороны, задать new_shape как [2, 3, 4] также нельзя: третье измерение меньше, чем в исходной форме 2, 3, 5.
Если new_shape равно None, возвращённый SparseTensor будет иметь форму [2, 3, 4], соответствующую минимальной ограничивающей рамке sp_input.

Аргументы
`sp_input`	Входной `SparseTensor`.
`new_shape`	None или вектор, задающий новую форму возвращаемого `SparseTensor`.

Возвращает
`SparseTensor` с индексами и значениями, не изменёнными относительно `sp_input`. Его форма равна `new_shape`, если она задана. В противном случае она соответствует минимальной ограничивающей рамке `sp_input`.

Вызывает исключение
`TypeError`	Если `sp_input` не является `SparseTensor`.
`ValueError`	Если `new_shape` соответствует тензору с рангом, отличающимся от ранга `sp_input` (если формы известны при построении графа).
`ValueError`	Если при построении графа установлено, что размеры измерений `new_shape` слишком малы.
`OpError`	Если размеры измерений `new_shape` слишком малы. Если формы неизвестны при построении графа и во время выполнения обнаружено, что ранги не совпадают.

© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/api_docs/python/tf/sparse/reset_shape