tf.tpu.experimental.Topology
Описывает набор устройств TPU.
tf.tpu.experimental.Topology(
serialized=None, mesh_shape=None, device_coordinates=None
)
Представляет форму физической сетки, а также соответствие между устройствами TensorFlow TPU и координатами физической сетки.
| Аргументы | |
|---|---|
serialized | Сериализованный TopologyProto или None. Если не None, сериализованный протокол буферизуется для определения топологии. |
mesh_shape | Последовательность из 4 положительных целых чисел или None. Если не None, форма топологии TPU, выраженная количеством ядер. Игнорируется, если serialized не равно None. |
device_coordinates | Массив numpy ранга 3, описывающий соответствие устройств TensorFlow TPU координатам фабрики TPU, или None. Если указан, массив является массивом int32 ранга 3 с формой [tasks, devices, axis]. tasks — количество задач в кластере TPU, devices — количество устройств TPU на задачу, а axis — количество осей в топологии кластера TPU. Каждая запись задает координату axis-й оси в топологии для пары задача/устройство. Топологии TPU являются четырехмерными, с измерениями (x, y, z, core number). Этот аргумент игнорируется, если serialized is notNone`. |
| Вызывает исключения | |
|---|---|
ValueError | Если serialized не описывает корректно сформированную топологию. |
ValueError | Если serialized равно None, а mesh_shape не является последовательностью из 4 положительных целых чисел. |
ValueError | Если serialized равно None, а device_coordinates не является массивом numpy int32 ранга 3, описывающим допустимое соответствие координат. |
| Атрибуты | |
|---|---|
device_coordinates | Описывает соответствие устройств TPU координатам топологии. |
mesh_rank | Возвращает количество измерений в сетке. |
mesh_shape | Массив int32 ранга 1, описывающий форму топологии TPU. |
missing_devices | Массив индексов отсутствующих устройств. |
num_tasks | Возвращает количество задач TensorFlow в срезе TPU. |
num_tpus_per_task | Возвращает количество устройств TPU на задачу в срезе TPU. |
Методы
cpu_device_name_at_coordinates
cpu_device_name_at_coordinates(
device_coordinates, job=None
)
Возвращает устройство CPU, подключенное к логическому ядру.
serialized
serialized()
Возвращает сериализованное представление топологии.
task_ordinal_at_coordinates
task_ordinal_at_coordinates(
device_coordinates
)
Возвращает номер задачи TensorFlow, связанной с device_coordinates.
| Аргументы | |
|---|---|
device_coordinates | Последовательность целых чисел, описывающая физические координаты устройства в фабрике TPU. |
| Возвращает | |
|---|---|
| Возвращает номер задачи TensorFlow, содержащей устройство TPU с указанными физическими координатами. |
tpu_device_name_at_coordinates
tpu_device_name_at_coordinates(
device_coordinates, job=None
)
Возвращает имя устройства TPU, назначенного логическому ядру.
tpu_device_ordinal_at_coordinates
tpu_device_ordinal_at_coordinates(
device_coordinates
)
Возвращает номер устройства TensorFlow в device_coordinates.
| Аргументы | |
|---|---|
device_coordinates | Последовательность целых чисел, описывающая физические координаты устройства в фабрике TPU. |
| Возвращает | |
|---|---|
| Возвращает номер устройства TensorFlow в задаче, соответствующей устройству с указанными физическими координатами. |
© 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/tpu/experimental/Topology