tf.convert_to_tensor
Преобразует заданный value в Tensor.
tf.convert_to_tensor(
value, dtype=None, dtype_hint=None, name=None
) -> tf.Tensor
Используется в блокнотах
| Используется в руководстве | Используется в учебных материалах |
|---|---|
Эта функция преобразует объекты Python различных типов в объекты Tensor. Она принимает объекты Tensor, массивы numpy, списки Python и скалярные значения Python.
Например:
import numpy as np def my_func(arg): arg = tf.convert_to_tensor(arg, dtype=tf.float32) return arg
# The following calls are equivalent. value_1 = my_func(tf.constant([[1.0, 2.0], [3.0, 4.0]])) print(value_1) tf.Tensor( [[1. 2.] [3. 4.]], shape=(2, 2), dtype=float32) value_2 = my_func([[1.0, 2.0], [3.0, 4.0]]) print(value_2) tf.Tensor( [[1. 2.] [3. 4.]], shape=(2, 2), dtype=float32) value_3 = my_func(np.array([[1.0, 2.0], [3.0, 4.0]], dtype=np.float32)) print(value_3) tf.Tensor( [[1. 2.] [3. 4.]], shape=(2, 2), dtype=float32)
Эта функция может быть полезна при создании новой операции в Python (например, my_func в примере выше). Все стандартные конструкторы операций Python применяют эту функцию к каждому из своих входных значений типа Tensor, что позволяет этим операциям принимать массивы numpy, списки Python и скалярные значения в дополнение к объектам Tensor.
Примечание: Эта функция отличается от поведения Numpy по умолчанию для типовfloatиstring, еслиNoneприсутствует в списке или скалярном значении Python. Вместо неявного преобразования значенийNoneбудет выдана ошибка.
| Аргументы | |
|---|---|
value | Объект, для типа которого зарегистрирована функция преобразования Tensor. |
dtype | Необязательный тип элементов возвращаемого тензора. Если он не указан, тип выводится из типа value. |
dtype_hint | Необязательный тип элементов возвращаемого тензора, используемый, если dtype равен None. В некоторых случаях вызывающий код может не определять тип данных при преобразовании в тензор; тогда dtype_hint можно использовать как предпочтительный вариант. Если преобразование в dtype_hint невозможно, этот аргумент не влияет на результат. |
name | Необязательное имя, используемое, если создаётся новый Tensor. |
| Возвращает | |
|---|---|
Tensor на основе value. |
| Вызывает исключения | |
|---|---|
TypeError | Если для преобразования value в dtype не зарегистрирована функция. |
RuntimeError | Если зарегистрированная функция преобразования возвращает недопустимое значение. |
ValueError | Если value является тензором не указанного dtype в режиме графа. |
© 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/convert_to_tensor