Package: txrm2tiff
txrm2tiffConverts TXRM/XRM files to OME-TIFF files.Txrm2tiff was created for users of beamline B24 of Diamond Light Source by Thomas Fish. This has been adapted from, and is used by, 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.InstallationAvailable on PyPI and conda-forge astxrm2tiff. To install:PyPI:python -m pip install txrm2tiffconda-forge:conda install -c conda-forge txrm2tiffInstructionstxrm2tiff{--inputinput file path (required)} {--referencereference file path (optional, default=None)} {--outputpath (optional, default=None)} {--annotate(optional)} {--datatypeoutput data type (optional, choices=[uint16, float32, float64], default=None)} {--apply-shifts(optional)} {--ignore-ref(optional)} {--set-logging(optional), default="info"}If no output path is supplied, the output file will be placed at the input path with the extension ".ome.tiff". The ".ome" signifies the OME XML metadata header.Unless the data type is specified, the data type will be as it would be direct from XRM Data Explorer. This means that unreferenced images will remain uint16, whereas referenced images will be output as float32.Logging options are:debug OR 1info OR 2warning OR 3error OR 4critical OR 5This README aims to be accurate to the latest version with useful examples. However,txrm2tiff -hortxrm2tiff --helpwill be 100% accurate to the installed version, unlike this README, so please do consult that too.- Setup options:txrm2tiff setup{--windows-shortcut(WINDOWS ONLY: optional, creates shortcut on the desktop for drag'n'drop processing)}txrm2tiff setup -hortxrm2tiff setup --helpwill give more info.- Inspector options:txrm2tiff inspect{--inputinput file path (required)} {--extra(optional, default=False)} {--list-streams(optional, default=False)} {--inspect-streamsspace separated streams (optional)}txrm2tiff inspect --inputortxrm2tiff inspect -ifollowed by the path of a txrm/xrm file will output some basic information about the images contained.Adding--extraor-ewill add further information to this output.Adding--list-streamsor-lwill list all of the streams* in addition to the any previous output. This will be a lot so it may be useful to save this to a file using> file.txt.Adding--inspect-streamsor-sfollowed by a 1 or more space separated stream names will read each stream using a variety of formats. As txrm and xrm files do not save the streams with information on what data type is being used**, the output will take some interpreting.txrm2tiff inspect -hortxrm2tiff inspect --helpwill give more info.Additional Notes:*XRM and TXRM files are 'OLE' type files. These files to separate and store information in streams.** with the exception of images, which do get the image data type saved separately.NOTE:any commands beginning withtxrm2tiffare essentially equivalent to usingpython -m txrm2tiff(arguments will be parsed by the same parser via either method). This may be useful if there were any installation issues.dragndrop.bathas 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.Examples:txrm2tiff -handtxrm2tiff setup --hwill give more infotxrm2tiff -i input.txrmSaves "input.ome.tiff" with reference applied, if available.txrm2tiff -i input.txrm -r ref_stack.txrmSaves "input.ome.tiff" with a reference image applied from running Despeckle & Average on the the txrm stack. This Despeckle & Average algorithm is near-identical to the Zeiss algorithm, based on their logic.txrm2tiff --input input.txrm --reference ref_single.xrm --ignore-refSaves "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.tiffSaves "custom-output.ome.tiff" with reference applied, if available.txrm2tiff -i input.xrm --annotateSaves "input.ome.tiff", as well as a separate file "input_Annotated.tiff", which has annotations overlaid (if annotations are found) and scale bar.txrm2tiff --input input.xrm --ignore-ref --set-logging debugSaves "input.ome.tiff" and ignores any reference, shows debug and above level log messages.txrm2tiff --input input.xrm --apply-shifts --datatype uint16Saves "input.ome.tiff", applies any available shifts within the file, and saves the output as uint16.txrm2tiff -i input.xrm --output custom-output.ome.tif --set-logging errorSaves "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-refConverts all XRM/TXRM files within input_directory, ignoring all references.txrm2tiff --input path/to/inputDirectory/ --output path/to/outputDirectory/ --ignore-refConverts all XRM/TXRM files within "inputDirectory", saving to the automatic name within the specified output directory, ignoring all references.Batch conversion notes:--outputmustbe a directory or it will be ignored and files placed in the same directory as the XRM/TXRMsSub directories containing any XRM/TXRM files found within "inputDirectory" will be copied to "outputDirectory" (directories will be created if they don't already exist)--referenceinputs will be ignored for batch conversionFeaturesConverts XRM/TXRM v3.0 (from XM Controller) & v5.0 (from XRM Data Explorer) files to TIFF.If a reference has been applied within XM Controller/XRM Data Explorer, it will automatically apply the reference (image * 100.0 / reference, as done by XM Controller). Internal references can also be ignored.Custom reference images can be specified (can be a TXRM or XRM file, or a TIFF image or stack) - this option overrides any internally stored reference and the ignore reference option.If the reference exposure is available (e.g. from XRM/TXRM or OME-TIFF), the reference image will be rescaled to the image exposure at 0° (if applicable).Any annotations from XRM/TXRM v5.0 files can be exported and saved (along with a scale bar).Data type of the output image can be specified (warnings will be given if the data type limits off the dynamic range of the image, also values are rounded before casting float -> integer).Metadata will be added in OME XML format to the header.Batch convert options.Inspector (can extract any information from XRM/TXRM files).Within Python, XRM/TXRM files can be opened and interacted with using the functionopen_txrm(from txrm2tiff import open_txrm), which returns aTxrmobject of the correct version. Recomended usage:with open_txrm(...) as txrm:.Within Python, XRM/TXRM files can quickly be converted and saved usingconvert_and_save(from txrm2tiff import convert_and_save).