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