8000 GitHub - andreped/vsi2tif: Simple tool for converting WSIs from cellSens VSI to pyramidal TIFF
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

andreped/vsi2tif

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

164 Commits
.github/workflows
.github/workflows
 
 
notebooks
notebooks
 
 
shell
shell
 
 
vsi2tif
vsi2tif
 
 
.gitignore
.gitignore
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
setup.cfg
setup.cfg
 
 
setup.py
setup.py
 
 

Repository files navigation

vsi2tif

License Pip Downloads PyPI version DOI Open In Colab

Tool for converting WSIs from Olympus' cellSens VSI to Generic TIFF.

To quickly get started, see these notebooks (Ubuntu Linux, macOS) for installing the tool, converting your first image, and verifying that the image works with OpenSlide.

Continuous integration

Build Type Status
Integration Tests CI
Unit Tests CI
Linting Checks CI

Requirements

To run the tool, you need to configure bftools and vips. To do that, follow the instructions below for the operating system of interest:

Ubuntu

  1. Download bftools (click here)

  2. Install vips and JDK

sudo apt update
sudo apt-get install openjdk-8-jdk
sudo apt install libvips-tools

macOS

  1. Download bftools (click here)

  2. Install vips and JDK

brew install --cask zulu@8
brew install vips

Windows

To install bftools and vips, I recommend using Powershell as much as possible to automate the installation steps.

  1. Download bftools (click here)

  2. Download vips binary from Windows from here or use wget or similar

https://github.com/libvips/build-win64-mxe/releases/download/v8.15.3/vips-dev-w64-all-8.15.3.zip
  1. Uncompress downloaded file and place it at an appropriate place, like at home
unzip ~/Downloads/vips-dev-w64-all-8.15.3.zip
mv ~/Downloads/vips-dev-w64-all-8.15.3/vips-dev-8.15/ ~/vips-dev-8.15/
  1. Add path to vips.exe to the PATH (requires powershell administrator)
< 8000 div class="snippet-clipboard-content notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="$Env:PATH += ";$HOME/vips-dev-8.15/bin/"">
$Env:PATH += ";$HOME/vips-dev-8.15/bin/"

Installation

Install from source:

pip install git+https://github.com/andreped/vsi2tif

Usage

The conversion tool is available through a command line interface (CLI).

Example for converting a single WSI:

vsi2tif -i /path/to/olympus/image.vsi -o /path/to/converted/image.tif -b /path/to/bftools/bfconvert

Here is an example to perform batch conversion of a folder of WSIs:

vsi2tif -i /path/to/olympus/wsis/ -o /path/to/converted/wsis/directory/ -b /path/to/bftools/bfconvert

Comprehensive CLI documentation can be seen below:

usage: vsi2tif [-h] -i INPUT -o OUTPUT -b BFCONVERT [-c COMPRESSION] [-s TILESIZE] [-q QUALITY] [-m MAX_MEM] [-v VERBOSE] [--remove-name-spaces] [-p PLANE] [--noskip-converted] [-f EXTENSION]

vsi2tif - simple tool for converting images from cellSens VSI to Generic TIFF

options:
  -h, --help            show this help message and exit
  -i INPUT, --input INPUT
                        folder with input files
  -o OUTPUT, --output OUTPUT
                        folder for output files
  -b BFCONVERT, --bfconvert BFCONVERT
                        path to bfconvert tool
  -c COMPRESSION, --compression COMPRESSION
                        compression technique for final image - default 'jpeg'
  -s TILESIZE, --tilesize TILESIZE
                        tile size to use during both conversion steps - default 1024
  -q QUALITY, --quality QUALITY
                        compression quality used with JPEG compression - default 87
  -m MAX_MEM, --max-mem MAX_MEM
                        set maximum memory in the java vm - default 32
  -v VERBOSE, --verbose VERBOSE
                        set verbosity level - default 1
  --remove-name-spaces  replace spaces in filename with underscores in batch mode
  -p PLANE, --plane PLANE
                        image plane to convert image from. If set to -1, all series are converted and the largest is kept - default 0
  --noskip-converted    To specifically request existing files to be converted again
  -f EXTENSION, --extension EXTENSION
                        extension type to consider (e.g., .vsi)

License

This project has MIT license.

How to cite DOI

If you found this tool useful in your research, please cite the following:

@software{pedersen2024vsi2tif,
  author       = {André Pedersen and David Bouget and Sebastian Krossa and Erik Smistad},
  title        = {{andreped/vsi2tif: v0.1.4}},
  month        = sep,
  year         = 2024,
  publisher    = {Zenodo},
  version      = {v0.1.4},
  doi          = {10.5281/zenodo.13745169},
  url          = {https://doi.org/10.5281/zenodo.13745169}
}

About

Simple tool for converting WSIs from cellSens VSI to pyramidal TIFF

Topics

fast converter tiff generic openslide olympus vips vsi tif wsi pyramidal bioformats pyvips cellsens pyfast cucim bftools

Resources

Readme

License

MIT license
Activity

Stars

20 stars

Watchers

2 watching

Forks

6 forks
Report repository

Releases 7

v0.1.6 Latest
Jan 30, 2025
+ 6 releases

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages

0