An open API service indexing awesome lists of open source software.

https://github.com/arogozhnikov/iview5d

Extremely simplistic viewer of small ndimensional patches for jupyter notebook. Powered by einops
https://github.com/arogozhnikov/iview5d

Last synced: 3 months ago
JSON representation

Extremely simplistic viewer of small ndimensional patches for jupyter notebook. Powered by einops

Awesome Lists containing this project

README

        

# iview5d (stack viewer)

Extremely simplistic viewer of small ndimensional patches for jupyter notebooks.
Powered by einops transformation

## Installation

Right from github
```
pip install git+https://[email protected]/arogozhnikov/iview5d.git
```

## Usage (viewing)

- Move your cursor over the image - as you move a cursor, element of a stack that is shown, changes.
- Main usage - collect multiple parameters/layers, where 'side-to-side' is not an option

## Usage (code)

First arument is tensor or list of tensors (from any framework)
Second argument corresponds to einops transformation pattern.

Output should have 4 or 5 dimensions in the following order

- x-controllable (changed by moving a mouse over the image)
- y-controllable (changed by moving a mouse over the image)
- height
- width
- (optional) color

Code below outputs a viewer in jupyter:

```python
from iview5d import iview5d
iview5d(
stack,
'batch z channel h w -> batch z h w channel',
zoom=0.5,
)
```

Axes will be used as:
- batch -> move cursor along x
- z -> move cursor along y
- h w channel - shown image (at each position of cursor)

## Video

See how it looks in action: [video](https://raw.githubusercontent.com/arogozhnikov/iview5d/example/example/view5d.webm?token=ABQGVW576NCEE4LZARB746S7M3BQS)

## Try it out (demonstration)

[nbviewer link](https://nbviewer.jupyter.org/github/arogozhnikov/iview5d/blob/master/example/Example.ipynb),
move cursor over all images

## Warning

No additional features are planned for this project, it is designed to be small and convenient.
If you need fully-powered stack viewer - find a corresponding project