Home · Quickstart · User Guide and Examples · Interfaces Index · Developers · About · Nipy

# nipype.interfaces.slicer.filtering.histogrammatching module

Autogenerated file - DO NOT EDIT If you spot a bug, please report it on the mailing list and/or change the generator.

## HistogramMatching

Link to code

> Bases: SEMLikeCommandLine

> Wrapped executable: `HistogramMatching`.

> title: Histogram Matching

> category: Filtering

> description: Normalizes the grayscale values of a source image based on the grayscale values of a reference image. This filter uses a histogram matching technique where the histograms of the two images are matched only at a specified number of quantile values.

> The filter was originally designed to normalize MR images of the sameMR protocol and same body part. The algorithm works best if background pixels are excluded from both the source and reference histograms. A simple background exclusion method is to exclude all pixels whose grayscale values are smaller than the mean grayscale value. ThresholdAtMeanIntensity switches on this simple background exclusion method.

> Number of match points governs the number of quantile values to be matched.

> The filter assumes that both the source and reference are of the same type and that the input and output image type have the same number of dimension and have scalar pixel types.

> version: 0.1.0.$Revision: 19608 $(alpha)

> documentation-url: http://wiki.slicer.org/slicerWiki/index.php/Documentation/4.1/Modules/HistogramMatching

> contributor: Bill Lorensen (GE)

> acknowledgements: This work is part of the National Alliance for Medical Image Computing (NAMIC), funded by the National Institutes of Health through the NIH Roadmap for Medical Research, Grant U54 EB005149.

> argsa string

>   Additional parameters to the command. Maps to a command-line argument: `%s`.

> environa dictionary with keys which are a bytes or None or a value of class ‘str’ and with values which are a bytes or None or a value of class ‘str’

>   Environment variables. (Nipype default value: `{}`)

> inputVolumea pathlike object or string representing an existing file

>   Input volume to be filtered. Maps to a command-line argument: `%s` (position: -3).

> numberOfHistogramLevelsan integer

>   The number of hisogram levels to use. Maps to a command-line argument: `--numberOfHistogramLevels %d`.

> numberOfMatchPointsan integer

>   The number of match points to use. Maps to a command-line argument: `--numberOfMatchPoints %d`.

> outputVolumea boolean or a pathlike object or string representing a file

>   Output volume. This is the input volume with intensities matched to the reference volume. Maps to a command-line argument: `%s` (position: -1).

> referenceVolumea pathlike object or string representing an existing file

>   Input volume whose histogram will be matched. Maps to a command-line argument: `%s` (position: -2).

> thresholda boolean

>   If on, only pixels above the mean in each volume are thresholded. Maps to a command-line argument: `--threshold`.

> outputVolumea pathlike object or string representing an existing file

>   Output volume. This is the input volume with intensities matched to the reference volume.