Skip to main content

Tiny tensor visualiser: vz.plot(t) / vz.save(t)

Project description

vizy: One-line tensor visualization for PyTorch and NumPy

Stop juggling tensor formats. Just visualize.

Display or save any NumPy array or PyTorch tensor (supports 2D, 3D, 4D shapes) with a single line:

import vizy

vizy.plot(tensor)               # shows image or grid
vizy.save("image.png", tensor)  # saves to file
vizy.save(tensor)               # saves to temp file and prints path
vizy.summary(tensor)            # prints info like res, dtype, device, range, etc.

Let's say you have a PyTorch tensor with shape (BS, 3, H, W). Instead of

plt.imshow(tensor.cpu().numpy()[0].transpose(1, 2, 0))
plt.imshow(tensor.cpu().numpy()[1].transpose(1, 2, 0))
...

You can just do:

vizy.plot(tensor)

Example output:

Example notebook showing vizy.plot() with different tensor formats

Or if you are in an ssh session, you can just do:

vizy.save(tensor)

It will automatically save the tensor to a temporary file and print the path, so you can scp it to your local machine and visualize it.

Technical Details

Note: This library uses PIL/Pillow for image visualization and saving. This library handles tensor format detection, conversion, and grid layout, but the actual plotting is done via PIL.

Installation

pip install vizy

Buy Me A Coffee

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vizy-1.3.0.tar.gz (446.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vizy-1.3.0-py3-none-any.whl (12.4 kB view details)

Uploaded Python 3

File details

Details for the file vizy-1.3.0.tar.gz.

File metadata

  • Download URL: vizy-1.3.0.tar.gz
  • Upload date:
  • Size: 446.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.14

File hashes

Hashes for vizy-1.3.0.tar.gz
Algorithm Hash digest
SHA256 4537794e972e10bd938619e1ec16ddb9623a9f4cbd38e1d9d8cac2f5c63523c5
MD5 204ed74dcd0144fdae72bbaa2acb31dd
BLAKE2b-256 a4a106a5b7f980df97777c9a35c235fecd52cb2b294a5e5fc07c73f79b54f00a

See more details on using hashes here.

File details

Details for the file vizy-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: vizy-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 12.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.14

File hashes

Hashes for vizy-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 06271ecb02c10cabe7658b4e024910f147392885282d7108646bac8fb5e87462
MD5 448caa9a793437161ddd2f4c6cb770cf
BLAKE2b-256 669d4db421f0114d7631383f83d4376c698c261679371cd8d07f0f61d3a7f7f4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page