Skip to content

MITEL-UNIUD/SlideJ

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SlideJ

Synopsis

SlideJ is an ImageJ plugin for processing digital slides (also known as virtual slides, WSI, etc). SlideJ has been tested on slides in the following formats: Aperio .SVS, Leica .SCN, Hamamatsu .NDPI, Mirax, Generic tiled TIFF and regular TIFF. It works by splitting the slide in square tiles and iterating a user-configurable macro on each of them.

SlideJ can be called directly from the ImageJ user interface, but as many other plugins, also from another macro. At launch, a modal dialog is shown to configure the main execution parameters.

Motivation

SlideJ was created to provide a common framework for rapid prototyping of image processing and analysis of digital slides using ImageJ. It is based on Bio-Formats, which already provides digital slide access, but SlideJ adds a layer of abstraction useful for many algorithms (though not all).

SlideJ has been developed with the partial support of the EU Marie Curie project AIDPATH, grant no. 612471.

Installation

To install SlideJ, just put it in the Plugins folder of ImageJ. The only requirements are the Bio-Formats package and fiji-lib.jar (put them in the jar folder of ImageJ, or directly use Fiji.(For the latest new version of Fiji.app just put SlideJ_.jar in plugins folder, for previous versions of ImageJ put SlideJ_.class in plugins folder.)

Instructions

The interface of the plugin is a dialog that resembles the one implemented in ImageJ for batch macro execution. The user is allowed to process multiple images present in a folder and store the eventual results in a different folder by setting up paths in the “Input…” and “Output…” fields, respectively. A macro selection button allows the user to choose the file containing the macro to be executed on the tiles.

SlideJ logo

Another parameter is aimed at setting the tile size according to user needs (typically depending on maximum memory available - the more the better, up to 16384 or so). In addition to that, another parameter defines the overlap between tiles, identical for X and Y directions (useful for some algorithms).

The last parameter defines whether the tiles are deleted or not after each processing step. If not, they will be available after SlideJ run. Tiles are stored in TIFF format with a file name that reflects their position on the overall digital slide according to the following template:

OriginalFileName.ext__series_Xorigin_Yorigin.tif

Tests

To test SlideJ, create a folder (e.g., "in") and put digital slides into it; create annother folder to storing tiles (e.g., "out"). Choose a macro you want to run on your slides. From the ImageJ Plugins menu, call the plugin, set parameters, and wait.

Contributors

If you develop macros based on ImageJ that could be useful to the community, please feel free to upload them here, thanks.

License

SlideJ is licensed under LGPL 3.0.

Authors and citation

SlideJ is developed by Giulia Lucrezia Baroni, Vincenzo Della Mea and David Pilutti at the Medical Informatics, Telemedicine and eHealth Lab, dept. of Mathematics, Computer Science and Physics, University of Udine, Italy.

If you use it, please cite Slidej as:

Della Mea V, Baroni GL, Pilutti D, Di Loreto C (2017) SlideJ: An ImageJ plugin for automated processing of whole slide images. PLoS ONE 12(7): e0180540.

About

SlideJ: an ImageJ plugin for WSI processing

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages