tf.lookup.experimental.DenseHashTable

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

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

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

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

Основные псевдонимы

`tf.contrib.lookup.MutableDenseHashTable`

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

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

tf.compat.v1.lookup.experimental.DenseHashTable, `tf.compat.v2.lookup.experimental.DenseHashTable`

tf.lookup.experimental.DenseHashTable(
    key_dtype, value_dtype, default_value, empty_key, deleted_key,
    initial_num_buckets=None, name='MutableDenseHashTable', checkpoint=True
)

Данные могут быть вставлены с помощью метода insert и удалены с помощью метода remove. Он не поддерживает инициализацию с помощью метода init.

Использует "открытую адресацию" с квадратичным перепробованием для разрешения коллизий. По сравнению с MutableHashTable операции вставки, удаления и поиска в DenseHashTable обычно быстрее, но использование памяти может быть выше. Однако DenseHashTable не требует дополнительной памяти для временных тензоров, созданных во время операций сохранения и восстановления.

Пример использования:

table = tf.lookup.DenseHashTable(key_dtype=tf.int64,
                                 value_dtype=tf.int64,
                                 default_value=-1,
                                 empty_key=0,
                                 deleted_key=-1)

sess.run(table.insert(keys, values))
out = table.lookup(query_keys)
print(out.eval())

Аргументы
`key_dtype`	тип тензоров ключей.
`value_dtype`	тип тензоров значений.
`default_value`	Значение, используемое, если ключ отсутствует в таблице.
`empty_key`	ключ, используемый для представления пустых ячеек внутри. Не должен использоваться в операциях вставки, удаления или поиска.
`deleted_key`	ключ, используемый для представления удаленных ячеек внутри. Не должен использоваться в операциях вставки, удаления или поиска и должен отличаться от empty_key.
`initial_num_buckets`	начальное число ячеек.
`name`	имя операции (необязательно).
`checkpoint`	если True, содержимое таблицы сохраняется и восстанавливается из контрольных точек. Если `shared_name` пусто для проверочной таблицы, она используется совместно с именем узла таблицы.

Возбуждает
`ValueError`	Если checkpoint равен True и имя не было указано.

Атрибуты
`key_dtype`	Тип данных ключа таблицы.
`name`	Имя таблицы.
`resource_handle`	Возвращает дескриптор ресурса, связанный с этим ресурсом.
`value_dtype`	Тип данных значений таблицы.

Методы

`erase`

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

erase(
    keys, name=None
)

Удаляет keys и связанные с ним значения из таблицы.

Если ключ отсутствует в таблице, он игнорируется.

Аргументы
`keys`	Ключи для удаления. Может быть тензором любой формы. Должен соответствовать типу ключа таблицы.
`name`	Имя операции (необязательно).

Возвращает
Созданная операция.

Возбуждает
`TypeError`	при `keys` не совпадают с типами данных таблицы.

`export`

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

export(
    name=None
)

Возвращает тензоры всех ключей и значений в таблице.

Аргументы
`name`	Имя операции (необязательно).

Возвращает
Пара тензоров, первый тензор содержит все ключи, а второй — все значения в таблице.

`insert`

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

insert(
    keys, values, name=None
)

Ассоциирует keys со values.

Аргументы
`keys`	Ключи для вставки. Может быть тензором любой формы. Должен соответствовать типу ключа таблицы.
`values`	Значения, которые будут связаны с ключами. Должен быть тензором той же формы, что и `keys`, и соответствовать типу значений таблицы.
`name`	Имя операции (необязательно).

Возвращает
Созданная операция.

Возбуждает
`TypeError`	когда `keys` или `values` не соответствуют типам данных таблицы.

`insert_or_assign`

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

insert_or_assign(
    keys, values, name=None
)

Ассоциирует keys со values.

Аргументы
`keys`	Ключи для вставки. Может быть тензором любой формы. Должен соответствовать типу ключа таблицы.
`values`	Значения, которые будут связаны с ключами. Должен быть тензором той же формы, что и `keys`, и соответствовать типу значений таблицы.
`name`	Имя операции (необязательно).

Возвращает
Созданная операция.

Возбуждает
`TypeError`	когда `keys` или `values` не соответствуют типам данных таблицы.

`lookup`

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

lookup(
    keys, name=None
)

Ищет keys в таблице, выводит соответствующие значения.

Значение default_value используется для ключей, отсутствующих в таблице.

Аргументы
`keys`	Ключи для поиска. Может быть тензором любой формы. Должен соответствовать key_dtype таблицы.
`name`	Имя операции (необязательно).

Возвращает
Тензор, содержащий значения в той же форме, что и `keys`, используя тип значения таблицы.

Возбуждает
`TypeError`	когда `keys` не соответствуют типам данных таблицы.

`remove`

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

remove(
    keys, name=None
)

Удаляет keys и связанные с ним значения из таблицы.

Если ключ отсутствует в таблице, он игнорируется.

Аргументы
`keys`	Ключи для удаления. Может быть тензором любой формы. Должен соответствовать типу ключа таблицы.
`name`	Имя операции (необязательно).

Возвращает
Созданная операция.

Возбуждает
`TypeError`	когда `keys` не соответствуют типам данных таблицы.

`size`

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

size(
    name=None
)

Вычисляет количество элементов в этой таблице.

Аргументы
`name`	Имя операции (необязательно).

Возвращает
Скалярный тензор, содержащий количество элементов в этой таблице.

END_OF_DOCUMENT_MARKER

© 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/r1.15/api_docs/python/tf/lookup/experimental/DenseHashTable