Skip to main content

IVA TPU Python API

Main entities

TPUDevice

TPUDevice is a device handle

TPUProgram

TPUProgram contains TPU instructions and weigths data

TPUProgramInfo

Object can be used to configure inference.

config = TPUProgramInfo()
config.max_tasks_count = 4 # configures depth of tasks queue in driver
config.disable_static_checker = true # disables static checker for program
program = TPUProgram("program.tpu", config)

TPUInference

TPUInference contains input/output data

Example

import asyncio
import numpy as np
from iva_tpu import TPUDevice, TPUProgram, TPUInference

from iva_applications.resnet50 import image_to_tensor
from iva_applications.imagenet import tpu_tensor_to_classes
from PIL import Image

image = Image.open('ILSVRC2012_val_00000045.JPEG')
tensor = image_to_tensor(image)

device = TPUDevice()
program = TPUProgram("resnet50.tpu")  # default TPUProgramInfo is totally fine
device.load_program(program)
inference = TPUInference(program)
inference.load([tensor])
status_future = device._load_inference(inference)  # device returns future for inference status
event_loop = asyncio.get_event_loop()
status = event_loop.run_until_complete(status_future)
assert status.is_success  # check that there is no errors during inference
output = inference.get()  # get results
tpu_tensor_to_classes(output[0], top=1)

TPU Dictionary interface

...
program = TPUProgram("resnet50.tpu")
inference = TPUInference(program)
inference.load({"Placeholder:0": tensor})
...
assert status.is_success
output = inference.get(as_dist=True)
tpu_tensor_to_classes(output["logits:0"], top=1)

TPU Blocking interface

status = device.load_inference_sync(inference) #would block until completion

TPU Raw buffer examples

import asyncio
from iva_tpu import TPUDevice, TPUProgram, TPUInference, ProcessingMode
program = TPUProgram("omega_program_dnn_quant_3.0.0.tpu")
device = TPUDevice()
device.load_program(program)
inference = TPUInference(program)

with open("f.bin", "rb") as f:
    buf=f.read()

inference.load([buf], mode=ProcessingMode.RAW)
asyncio.get_event_loop().run_until_complete(device.load_inference(inference))
outputs = inference.get(mode=ProcessingMode.RAW)

for i in range(3):
  o = outputs[i]
  with open(f"o{i}.bin", "wb") as f:
    f.write(o)

TPU Single inference statistics examples

result = device.load_inference_sync(inference)
result.timings # contains statistics about inference
result.timings["queue_timings"] # contains array of timings for 3 queues (QUEUE_TRANSFER_TO, QUEUE_EXECUTOR, QUEUE_TRANSFER_FROM)
result.timings["queue_timings"][%d] # contains tuple of 2 elements: idle time and actual work time
result.timings["queue_timings"][%d][%d] # contains tuple of 3 values: last, average, maximum through all inferences for the device object
result.timings["execution_timing"][%d] # same as before but with execution on tpu timings

TPU Global statistics examples

device = TPUDevice()
device.stats # returns object with global statistics about the current device
device.stats["mem"] # current usage of memory in the device

Release files for pytpu 15.0.24

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pytpu 15.0.24
File Size Uploaded
pytpu-15.0.24.tar.gz 19.2 kB Details

Release files / pytpu-15.0.24.tar.gz

Download URL pytpu-15.0.24.tar.gz
Size 19.2 kB
Tags Source
SHA-256 checksum
How to use checksums
e63ec3c5011de2dc660adcfd321227e41006aac7d8382e330d4667e8356eb27f
BLAKE2b-256 checksum
How to use checksums
bd9aee7cc0a40291dcb7ef399d30b80892909c3add5e3a0ebf1bc04a8c97f0ba
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/3.7.3 pkginfo/1.7.0 requests/2.21.0 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.7.3

Release history Release notifications | RSS feed

This release

15.0.24 This release

1 release file

15.0.23

1 release file

15.0.21

1 release file

15.0.20

1 release file

15.0.19

1 release file

15.0.18

1 release file

15.0.16

1 release file

15.0.15

1 release file

15.0.14

1 release file

15.0.13

1 release file

15.0.12

1 release file

15.0.11

1 release file

15.0.10

1 release file

15.0.9

1 release file

15.0.8

1 release file

15.0.7

1 release file

15.0.4

1 release file

15.0.3

1 release file

15.0.2

1 release file

14.7.0

1 release file

14.6.8

1 release file

14.6.7

1 release file

14.6.6

1 release file

14.6.5

1 release file

14.6.3

1 release file

14.6.2

1 release file

14.6.1

1 release file

14.6.0

1 release file

14.5.5

1 release file

14.5.3

1 release file

14.5.2

1 release file

14.5.1

1 release file

14.5.0

1 release file

14.4.9

1 release file

14.4.8

1 release file

14.4.7

1 release file

14.4.6

1 release file

14.4.5

1 release file

14.4.4

1 release file

14.4.3

1 release file

14.4.2

1 release file

14.4.1

1 release file

14.4.0

1 release file

14.2.2

1 release file

14.2.1

1 release file

14.2.0

1 release file

14.1.1

1 release file

14.1.0

1 release file

14.0.1

1 release file

14.0.0

1 release file

13.0.18

1 release file

13.0.17

1 release file

13.0.16

1 release file

13.0.15

1 release file

13.0.8

1 release file

13.0.7

1 release file

13.0.6

1 release file

13.0.5

1 release file

13.0.4

1 release file

13.0.3

1 release file

13.0.2

1 release file

13.0.1

1 release file

12.0.1

1 release file

12.0.0

1 release file

2.0.1

1 release file

2.0.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page