LinuxCommandLibrary

zeisstopnm

Convert Zeis scanner files to PNM image

TLDR

Convert a Zeiss cofocal file into either .pgm or .ppm format

$ zeisstopnm [path/to/file]
copy

Convert a Zeiss cofocal file to Netbpm format while explicitly specifying the target file type
$ zeisstopnm -[pgm|ppm] [path/to/file]
copy

SYNOPSIS

zeisstopnm [-verbose] [-alphaout alphafile] [zeissfile]

PARAMETERS

-verbose
    Display progress and processing details on standard error

-alphaout alphafile
    Output an alpha channel mask as PGM or PNM to the specified file

DESCRIPTION

zeisstopnm is a Netpbm utility that converts images from the proprietary Zeiss confocal microscope format to the portable PNM (Portable aNyMap) format, which encompasses PBM (bitmap), PGM (grayscale), and PPM (color) images.

Designed for researchers using Zeiss microscopy systems, it parses the Zeiss file header—containing metadata like dimensions, bit depth, and color information—and extracts pixel data for output. This enables seamless integration with open-source image processing tools in the Netpbm ecosystem, such as filters, converters, and viewers.

The tool reads from a file or standard input and writes to standard output, supporting pipeline workflows. It handles both grayscale and color Zeiss images, automatically selecting the appropriate PNM subtype. An optional alpha channel can be extracted separately for transparency or masking applications.

CAVEATS

Zeiss format varies by microscope model and software version; test compatibility with sample files. No error correction for corrupted headers.

INPUT HANDLING

If no zeissfile given, reads from stdin; supports single-image Zeiss files.

OUTPUT FORMAT

Automatically PPM for color, PGM for grayscale, or PBM for bitonal based on source data.

HISTORY

Added to Netpbm suite in the late 1990s for scientific imaging support; contributed by researchers to handle Zeiss confocal data as part of ongoing Netpbm expansions for microscopy formats.

SEE ALSO

pnm(5), ppm(5), pgm(5), netpbm(1)

Copied to clipboard