caner-ercan / raw2ometiff

Raw format to OME-TIFF converter

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build status

raw2ometiff converter

Java application to convert a directory of tiles to an OME-TIFF pyramid. This is the second half of iSyntax/.mrxs => OME-TIFF conversion.

Requirements

libblosc (https://github.com/Blosc/c-blosc) version 1.9.0 or later must be installed separately. The native libraries are not packaged with any relevant jars. See also note in n5-zarr readme (https://github.com/saalfeldlab/n5-zarr/blob/0.0.2-beta/README.md)

  • Mac OSX: brew install c-blosc
  • Ubuntu 18.04+: apt-get install libblosc1

Installation

  1. Download and unpack a release artifact:

    https://github.com/glencoesoftware/raw2ometiff/releases

Development Installation

  1. Clone the repository:

    git clone git@github.com:glencoesoftware/raw2ometiff.git

  2. Run the Gradle build as required, a list of available tasks can be found by running:

    ./gradlew tasks

Eclipse Configuration

  1. Run the Gradle Eclipse task:

    ./gradlew eclipse

Usage

Run the conversion (Bio-Formats 6.x):

raw2ometiff tile_directory pyramid.ome.tiff

or generate a 5.9.x-compatible pyramid:

raw2ometiff tile_directory pyramid.tiff --legacy

The input tile directory must contain a full pyramid in a Zarr or N5 container.

By default, LZW compression will be used in the OME-TIFF file. The compression can be changed using the --compression option. Tile compression is performed in parallel. The number of workers can be changed using the --max_workers option.

Areas to improve

  • Compatibility with both iSyntax and .mrxs
    • map JSON metadata to OME-XML (magnification etc.)
    • fix tile sizes used when downsampling (TIFF input only)

License

The converter is distributed under the terms of the GPL license. Please see LICENSE.txt for further details.

About

Raw format to OME-TIFF converter

License:GNU General Public License v2.0


Languages

Language:Java 100.0%