Applications/PaCeQuant: Difference between revisions

From MiToBo
Jump to navigationJump to search
Line 88: Line 88:
* AUTO:<br> here PaCeQuant seeks to extract calibration information from the given input data
* AUTO:<br> here PaCeQuant seeks to extract calibration information from the given input data
* MANUAL:<br> the user can enter calibration data, i.e. the physical size of a pixel and the units to use
* MANUAL:<br> the user can enter calibration data, i.e. the physical size of a pixel and the units to use
<span style="color:#ff0000">'''Important notice''':</span><br> Please note that in ImageJ ROI files no calibration data is stored. Thus, when using PaCeQuant to extract features from external segmentation data provided as ImageJ ROIs, you always need to manually provide calibration data.
<span style="color:#ff0000">'''Important notice''':</span><br> Please note that in ImageJ ROI files no calibration data is stored. Thus, when using PaCeQuant to extract features from external segmentation data provided as ImageJ ROIs, you always need to manually provide calibration data. And this also holds when manually post-processing segmentation data extracted with PaCeQuant as all calibration data of the original images will get lost.


===== Configuration of Segmentation Phase =====
===== Configuration of Segmentation Phase =====

Revision as of 16:08, 11 July 2017



PaCeQuant

PaCeQuant is available since release version 1.8.6 of MiToBo.

Latest News

We are proud to announce the first version of PaCeQuant, a tool for high-throughput quantification of shape features for pavement cells!

Related Publications

  • will be announced soon... :-)

Name of Plugin/Operator

de.unihalle.informatik.MiToBo.apps.cellMorphology.PaCeQuant
(available since MiToBo version 1.8.6)

Main features

  • extraction of 27 characteristic shape features to quantify pavement cell shape
  • fully automatic segmentation of cell regions from input images
  • optional import of external/manual cell segmentation data
  • additional R scripts for feature visualization

Usage - Parameters

To run PaCeQuant perform the following steps:

  • install MiToBo by following the instructions on the Installation page
  • run MiToBo and start the operator runner by selecting the menu item PaCeQuant from Plugins -> MiToBo

This will bring up the operator window of PaCeQuant.

Phases and Operation modes

PaCeQuant supports three different options for running listed below:

  • SEGMENTATION_AND_FEATURES:
    expects images as input, segments the images and extracts features
  • SEGMENTATION_ONLY:
    expects images as input, just segments the cell regions, no feature extraction
  • FEATURES_ONLY:
    works on binary or label images or ImageJ regions, extracts features for the given regions

In addition PaCeQuant can be run in either of two modes:

  • INTERACTIVE:
    PaCeQuant processes the data provided directly within the graphical environment of ImageJ, i.e. reads regions from the ROI manager, and directly shows results
  • BATCH:
    PaCeQuant processes all files (images or ROI files) in a given folder and writes results to disk

For batch mode the user can specify an input directory, in interactive mode PaCeQuant expects an input image or regions to be available in ImageJ.

Depending on the chosen phase and operation mode the graphical user interface is dynamically re-configured to show only the options relevant for the selected options.

Input Image/Directory

Depending on the chosen phases and operation modes here you need to specify either input data already loaded in ImageJ/Fiji or a directory where PaCeQuant can find the data to process. In detail, you have to provide the following information for the various configurations:

Operation Mode Phase(s) to Run Input Data
INTERACTIVE SEGMENTATION_ONLY Gray-scale input image already opened in ImageJ/Fiji.
SEGMENTATION_AND_FEATURES Gray-scale input image already opened in ImageJ/Fiji.
FEATURES_ONLY Binary or label image already opened in ImageJ/Fiji, or ImageJ ROI set from ROI manager.
BATCH SEGMENTATION_ONLY Directory containing gray-scale input images.
First-level sub-folders are also processed.
SEGMENTATION_AND_FEATURES Directory containing gray-scale input images.
First-level sub-folders are also processed.
FEATURES_ONLY Directory containing either binary or label images to process, a collection of ImageJ ROI files (with ending '.roi', or an archive of multiple ImageJ ROIs (with ending '.zip').

Important notice:
In BATCH mode PaCeQuant tries to analyze all image files present in the given folder or any of its direct sub-folders. In particular, PaCeQuant will also analyze data from a potential result folder of a previous run, if it is present in the given folder. To avoid problems resulting from analyzing wrong data you should ensure that the provided directory only contains native input images or segmentation data and no other image data not suitable for processing with PaCeQuant.

Calibration

As PaCeQuant measures lengths and areas from the given data it is important that the tool is properly calibrated, i.e. the physical size of a pixel is known. PaCeQuant supports two calibration modes:

  • AUTO:
    here PaCeQuant seeks to extract calibration information from the given input data
  • MANUAL:
    the user can enter calibration data, i.e. the physical size of a pixel and the units to use

Important notice:
Please note that in ImageJ ROI files no calibration data is stored. Thus, when using PaCeQuant to extract features from external segmentation data provided as ImageJ ROIs, you always need to manually provide calibration data. And this also holds when manually post-processing segmentation data extracted with PaCeQuant as all calibration data of the original images will get lost.

Configuration of Segmentation Phase

For detailed configuration of the algorithms applied during the segmentation phase the following parameters are available:

Name Description
Border Contrast Allows to select whether the boundaries of the cells are darker or brighter than the background.
Heuristic for Gap Closing During segmentation sometimes small gaps in the boundaries remain which can be closed by PaCeQuant applying one of the following heuristics:
  • WATERSHED (recommended): calculates a distance image from the binary boundary image extracted so far and then applies a watershed transformation to find additional boundaries
  • NAIVE_HEURISTIC: just calculates the distance between two end-points and links them if the distance is below a threshold
Unit for Size Thresholds Unit in which the size thresholds for filtering valid regions (see next two parameters) are specified, i.e. either PIXELS or MICRONS.
Minimal Size of Cells Segmented cells being too small can automatically be excluded by specifying a minimal size for valid cells.
Maximal Size of Cells Segmented cells being too large can also automatically be excluded by specifying a maximal size for valid cells.
Configuration of Feature Extraction Phase
Name Description
Feature Extraction For feature extraction the MorphologyAnalyzer2D operator of MiToBo is used and can be configured here.
Analyze lobe types? Activates the optional classification of individual lobes into two-cell or three-cell types.
Additional Configuration Parameters
Name Description
Draw region IDs to output image?
Verbose
Show/save additional results?
Show/save feature stack?

Usage - Output data

Sample data

Will be provided soon...