NAME

#

view_index_pict – Draw birth and death pixels for 2D cubical/bitmap filtrations created from digital pictures

SYNOPSIS

#

homcloud-view-index-pict
    [-h] [-V] -d DEGREE [-f FILTER]
    [-v VECTORIZED_HISTOGRAM_MASK] [-H HISTOINFO] [-B]
    [-D] [-L] [-s SCALE] [-M MARKER_TYPE] [-S MARKER_SIZE]
    [--show-command SHOW_COMMAND] [--no-label]
    [--birth-color BIRTH_COLOR] [--death-color DEATH_COLOR]
    [--line-color LINE_COLOR] [-o OUTPUT]
    picture diagram

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

ALIAS

#

homcloud-view-index-pict

DESCRIPTION

#

Draws birth and death pixels for 2D cubical/bitmap filtrations created from digital pictures onto the original picture.

You need to specify two files, picture and diagram: picture is the original picture file, and diagram is a .pdgm file produced with the boundary map saved (-M on), for example by homcloud-pict-binarize-nd or homcloud-pict-pixel-levelset-nd.

-f/--filter can be given multiple times to select only the birth-death pairs that satisfy all of the given predicates, e.g. -f "lifetime > 5.0". The supported predicate targets are lifetime, birth, and death, and the supported operators are >, <, >=, <=, and ==.

Alternatively, -v/--vectorized-histogram-mask together with -H/--histoinfo selects pairs by a 0/1 mask vector produced from a vectorized histogram (see homcloud-vectorize-PD); both options must be given together.

OPTIONS

#

-h, --help            show this help message and exit
-V, --version         show program's version number and exit
-d DEGREE, --degree DEGREE
                      degree of PH
-f FILTER, --filter FILTER
                      filters (ex: "lifetime > 5.0")
-v VECTORIZED_HISTOGRAM_MASK, --vectorized-histogram-mask VECTORIZED_HISTOGRAM_MASK
                      0-1 vector textfile for mask
-H HISTOINFO, --histoinfo HISTOINFO
                      vectorize histogram information (both -v and -H are
                      required)
-B, --birth           plot birth pixels
-D, --death           plot death pixels
-L, --line            draw line between death and birth pixels
-s SCALE, --scale SCALE
                      image scaling factor (1, 3, 5, ...)
-M MARKER_TYPE, --marker-type MARKER_TYPE
                      marker type (point, filled-diamond(default), square,
                      filled-square, circle, filled-circle)
-S MARKER_SIZE, --marker-size MARKER_SIZE
                      marker size (default: 1)
--show-command SHOW_COMMAND
                      image display command
--no-label            birth-death labels are not drawn
--birth-color BIRTH_COLOR
                      birth pixel color
--death-color DEATH_COLOR
                      death pixel color
--line-color LINE_COLOR
                      birth-death line color
-o OUTPUT, --output OUTPUT
                      output filername

--birth-color, --death-color, and --line-color accept a color in #rrggbb hex form (e.g. #ff0000).

OUTPUT

#

If -o is given, the annotated picture is saved to that path. Otherwise it is written to a temporary PNG file and opened with the program named by --show-command (default: eog).

NOTES

#

The old -T/--type and -N/--negate options (for dipha/idipha diagram files) no longer exist; the input diagram must now be a .pdgm file.