/cellom2tif

Python command line interface to convert Cellomics .C01 files to TIFF.

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

cellom2tif

Python script to convert Cellomics .C01 files to TIFF.

Read the BioFormats report card for Cellomics files. In short: it's not a great format. So you might as well convert all your Cellomics files to TIFF and forget about them forever. Software developers will thank you.

Continuous integration

Cellom2tif uses Travis-CI and Coveralls for continuous integration:

Build Status Coverage Status

Dependencies

Uses python-bioformats and javabridge to perform the conversion.

  • numpy >= 1.6
  • javabridge >= 1.0.3
  • python-bioformats >= 1.0.3

Note that (much of) Python BioFormats is GPL-licensed (v2). All the code in cellom2tif is BSD-licensed (3-clause), except where it is forbidden by the GPL by the import of Python BioFormats. Consult your lawyer. (I don't have one.)

Usage

$ cellom2tif -h
usage: cellom2tif [-h] [-E FILENAME] [-m] [-v] root_path out_path

Convert a bunch of Cellomics .C01 files to TIFFs.

positional arguments:
  root_path             The path containing .C01 files
  out_path              The path to output the TIFFs.

optional arguments:
  -h, --help            show this help message and exit
  -E FILENAME, --error-file FILENAME
                        Log problem filenames to the given filename.
  -m, --ignore-masks    Ignore files ending in "o1.C01".
  -v, --verbose         Print out runtime information.

Note that weird behavior may occur when the input and output directories are the same, or subdirectories of one another, since the script recurses down subdirectories and recreates the subdirectory structure in the output path.

Licenses

Christoph Gohlke's excellent tifffile.py is included for easy writing of TIFF files, and is itself BSD-licensed (3-clause).

As noted above (Dependencies), cellom2tif is BSD-licensed (where possible), and GPLv2-licensed (where required).

Author

Juan Nunez-Iglesias (juan.n@unimelb.edu.au).