EricThomson/tiffit

Do simple things with multi-page tiff files

tiffit

Lightweight command-line interface for handling tiff files in BigTIFF format.

Convert, extract information, and concatenate. That's it. Nothing fancy.

installation and usage

Install with pip and then use from command line.

pip install tiffit

# convert file into a well-behaved bigtiff file
tiffit convert old.tiff new.tiff

# get info about file without loading into memory
tiffit info filename.tiff

# concatenate two tiff files into a single bigtiff file
tiffit concat file1.tiff file2.tiff newfile.tiff

Notes / caveats

• If there is other information you would like to see read out from the info command, please open an issue.
• For a summary of tiff (thousands of incompatible file formats) specs, see this excellent overview. It is a bit dated, but is still the most readable and detailed reference I've found.
• If you need a package with more complexity, see:
  • opencv
  • pillow
  • tiffile
  • tifftools

To do

• add option to split tiff file in two (tifftools split)
• add keyword argument to info so user can check on specific image in stack.
• don't allow mixing of formats: add autoconversion of concatenated files.
• add verbosity keyword controller for convert and concat.

Acknowledgments

• Powered by the tifffile and tifftools packages.
• Developed with support from NIH Bioinformatics, NIEHS Neurobehavioral Core, NIEHS Neurobiology Laboratories. In particular thanks to Shaohua Wang for help during development.