NAME

#

pict.slice3d - Shows the sliced images of 3D bitmap data in npy format

SYNOPSIS

#

homcloud-pict-slice3d
    [-h] [-s SLICE] [-S SPACER] [-r RANGE]
    [--image-viewer IMAGE_VIEWER]
    input [input ...]

This program can also be invoked as python3 -m homcloud.cli.pict.slice3d.

ALIAS

#

homcloud-pict-slice3d

DESCRIPTION

#

This program shows the sliced images of 3D bitmap data in npy format.

-s option specifies which axis (0, 1, or 2) is used for slicing.

You can see multiple npy data files with the same shape side by side. -S option specifies the number of blank spacer pixels between each sliced image.

--image-viewer specifies the program name of the image viewer you want (default: eog -n). The viewer should be able to display multiple images in the order of the file paths given on the command line. Some image viewers such as eog and ristretto are good for that purpose.

OPTIONS

#

-h, --help            show this help message and exit
-s SLICE, --slice SLICE
                      slicing direction (0, 1, or 2) (default: 0)
-S SPACER, --spacer SPACER
                      spacer pixels (default: 10)
-r RANGE, --range RANGE
                      range of slices
--image-viewer IMAGE_VIEWER
                      image viewer program name (default: "eog -n")

-r/--range takes the form START:END (plain integers, e.g. 5:20); only slice indices in [START, END) along the slicing axis are rendered. If omitted, all slices are rendered.

This command has no -V/--version or --license option, unlike most other homcloud-* commands.

EXAMPLES

#

# Sliced along the yz-plane (-s 2), separator is 5 pixels, eog is used as the image viewer
homcloud-pict-slice3d -s 2 -S 5 m1.npy m2.npy --image-viewer eog

NOTES

#

All input .npy files should have the same shape. The current implementation’s shape check is a no-op bug (it does not actually compare shapes), so mismatched inputs are not rejected and may produce a broken or misleading montage; make sure your inputs share a shape yourself.