txrm2tiff 1.0.2

A converter for Zeiss txrm and xrm files, created from B24 of Diamond Light Source

txrm2tiff

Converts txrm/xrm files to OME tif/tiff files.

txrm2tiff was created for users of beamline B24 of Diamond Light Source by Thomas Fish. This has been adapted from B24's the automatic processing pipeline. Parts of this code were originally written by Kevin Savage, with further additions and amendments by Peter Chang, Victoria Beilsten-Edmands, and Thomas Fish.

Installation

Available on PyPI and conda-forge as txrm2tiff. To install using PyPI: python -m pip install txrm2tiff

Instructions

txrm2tiff --input {input file path (required)} {--reference reference file path (optional, default=None)} {--output path (optional, default=None)} {--ignore-ref (optional)} {--set-logging (optional, default="info"}

txrm2tiff -h or txrm2tiff --help will give more info

• Optional setup arguments: txrm2tiff setup {--windows-shortcut (WINDOWS ONLY: optional, creates shortcut to .bat file on the desktop for dragndrop processing )}

txrm2tiff setup -h or txrm2tiff setup --help will give more info

---

If no output path is supplied, the output file will be placed at the input path with the extension ".ome.tif"/".ome.tiff" as appropriate. The ".ome" signifies the OME XML metadata header.

dragndrop.bat has been supplied allowing windows users to drag and drop individual files or entire directories for processing (note: you cannot set output path this way). This may require some setup depending on your Python installation, so please see the file.

Logging options are:

• debug OR 1
• info OR 2
• warning OR 3
• error OR 4
• critical OR 5

Examples:

txrm2tiff -h and txrm2tiff setup --h will give more info

txrm2tiff -i input.txrm Saves "input.ome.tiff" with reference applied, if available.

txrm2tiff -i input.txrm -r ref_stack.txrm Saves "input.ome.tiff" with custom reference applied using the median of a txrm stack.

txrm2tiff --input input.txrm --reference ref_single.xrm --ignore-ref Saves "input.ome.tiff" with custom reference applied from a single image (e.g. a Despeckled_Ave.xrm file). If a custom reference is supplied, the ignore reference argument will be ignored.

txrm2tiff -i input.xrm -o custom-output.ome.tif Saves "custom-output.ome.tif" with reference applied, if available.

txrm2tiff --input input.xrm --ignore-ref --set-logging debug Saves "input.ome.tiff" and ignores any reference, shows debug and above level log messages.

txrm2tiff -i input.xrm --output custom-output.ome.tif --set-logging error Saves "custom-output.ome.tiff", shows error and above level log messages.

To batch convert: txrm2tiff --input path/to/inputDirectory/ Converts all xrm/txrm files within input_directory with reference applied, if available.

txrm2tiff --input path/to/inputDirectory/ --ignore-ref Converts all xrm/txrm files within input_directory, ignoring all references.

txrm2tiff --input path/to/inputDirectory/ --output path/to/outputDirectory/ --ignore-ref Converts all xrm/txrm files within "inputDirectory", saving to the automatic name within the specified output directory, ignoring all references.

Batch conversion notes:

• --output must be a directory or it will be ignored and files placed in the same directory as the xrm/txrms
• Sub directories containing any xrm/txrm files found within "inputDirectory" will be copied to "outputDirectory" (directories will be created if they don't already exist)
• --reference inputs will be ignored for batch conversion

Features

• xrm/txrm files will be converted to tif/tiff
• If a reference has been applied within XMController, it will automatically apply the reference (image * 100.0 / reference, as done by XMController)
• Internally stored reference images can be ignored
• A separate file containing reference images can be specified (can be a txrm stack, single xrm image, tiff stack, or tif image) - this overrides any internally stored reference and the ignore reference option
• If it is a mosaic, this is recognised and the reference will be applied to each individual image within the mosaic
• Additional metadata will be added in OME XML format to the header
• Batch convert options
• Within Python, xrm/txrm files can be inspected using from txrm2tiff.txrm_wrapper import TxrmWrapper and using the TxrmWrapper class functions
• Within Python, xrm/txrm files can be converted using convert_and_save or convert functions (from txrm2tiff import convert_and_save, convert); for more control, use the TxrmToImage class functions (from txrm2tiff.txrm_to_image import TxrmToImage)

Requirements

Python 3.6+ (3.8 is recommended)