Plugin type: 3dimage/filter

These plug-ins provide 3D image filters. Unless otherwise noted, they take a gray scale image of abitrary pixel type as input, process it and hand it to the next filter in the pipeline.

Plugins:

bandpass binarize close convert crop dilate downscale erode gauss gradnorm growmask invert kmeans label mask median mlv open reorient resize sandp scale selectbig sepconv sws tee ws

bandpass

intensity bandpass filter. Supported parameters are:

NameTypeDefaultDescription
maxfloat3.40282e+38maximum of the band
minfloat0minimum of the band

binarize

image binarize filter. Supported parameters are:

NameTypeDefaultDescription
maxfloat3.40282e+38maximum of accepted range
minfloat0minimum of accepted range

close

morphological close. Supported parameters are:

NameTypeDefaultDescription
hintstringblacka hint at the main image content (black|white)
shapefactory[sphere;r=2]structuring element. For supported plug-ins see Plugin type: 3dimage/shape

convert

image pixel format conversion filter. Supported parameters are:

NameTypeDefaultDescription
afloat1linear conversion parameter a
bfloat0linear conversion parameter b
mapdictopt
conversion mapping
opt:apply a linear transformation that maps the real input range to the full output range
range:apply linear transformation that maps the input data type range to the output data type range
copy:copy data when converting
linear:apply linear transformation x -> a*x+b
optstat:apply a linear transform that maps based on input mean and variation to the full output range
repndictubyte
output pixel type
float:floating point 32 bit
sbyte:signed 8 bit
ulong:unsigned 64 bit
double:floating point 64 bit
sint:signed 32 bit
ushort:unsigned 16 bit
sshort:signed 16 bit
uint:unsigned 32 bit
slong:signed 64 bit
bit:binary data
ubyte:unsigned 8 bit

crop

Crop a region of an image, the region is always clamped to the original image size in the sense that the given range is kept.. Supported parameters are:

NameTypeDefaultDescription
beginstreamable[<0,0,0>]begin of cropping range
endstreamable[<4294967295,4294967295,4294967295>]end of cropping range, maximum = (-1,-1,-1)

dilate

3d image stack dilate filter. Supported parameters are:

NameTypeDefaultDescription
hintstringblacka hint at the main image content (black|white)
shapefactory[sphere;r=2]structuring element. For supported plug-ins see Plugin type: 3dimage/shape

downscale

Downscale the input image by using a given block size to define the downscale factor. Prior to scaling the image is filtered by a smoothing filter to eliminate high frequency data and avoid aliasing artifacts.. Supported parameters are:

NameTypeDefaultDescription
b3dbounds[<1,1,1>]blocksize
bxuint1blocksize in x direction
byuint1blocksize in y direction
bzuint1blocksize in z direction
kernelstringgausssmoothing filter kernel to be applied (filter width is determined based on the scaling factor)

erode

3d image stack erode filter. Supported parameters are:

NameTypeDefaultDescription
hintstringblacka hint at the main image content (black|white)
shapefactory[sphere;r=2]structuring element. For supported plug-ins see Plugin type: 3dimage/shape

gauss

isotropic 3D gauss filter. Supported parameters are:

NameTypeDefaultDescription
wint1filter width parameter

gradnorm

3D image to gradient norm filter. (This plug-in doesn't take parameters)

growmask

Use an input binary mask and a reference gray scale image to do region growing by adding the neighborhood pixels of an already added pixel if the have a lower intensity that is above the given threshold.. Supported parameters are:

NameTypeDefaultDescription
minfloat1lower threshold for mask growing
refio(required)reference image for mask region growing. For supported file types see Plugin type: 3dimage/io
shapefactory6nneighborhood mask. For supported plug-ins see Plugin type: 3dimage/shape

invert

intensity invert filter. (This plug-in doesn't take parameters)

kmeans

3D image k-means filter. In the output image the pixel value represents the class membership and the class centers are stored as attribute in the image.. Supported parameters are:

NameTypeDefaultDescription
cint3number of classes

label

A filter to label the connected components of a binary image.. Supported parameters are:

NameTypeDefaultDescription
nfactory6nneighborhood mask. For supported plug-ins see Plugin type: 3dimage/shape

mask

Mask an image, one image is taken from the parameters list and the other from the normal filter input. Both images must be of the same dimensions and one must be binary. The attributes of the image coming through the filter pipeline are preserved. The output pixel type corresponds to the input image that is not binary.. Supported parameters are:

NameTypeDefaultDescription
inputio(required)second input image file name. For supported file types see Plugin type: 3dimage/io

median

median 3d filter. Supported parameters are:

NameTypeDefaultDescription
wint1filter width parameter

mlv

Mean of Least Variance 3D image filter. Supported parameters are:

NameTypeDefaultDescription
wint1filter width parameter

open

morphological open. Supported parameters are:

NameTypeDefaultDescription
hintstringblacka hint at the main image content (black|white)
shapefactory[sphere;r=2]structuring element. For supported plug-ins see Plugin type: 3dimage/shape

reorient

3D image reorientation filter. Supported parameters are:

NameTypeDefaultDescription
mapdictxyz
oriantation mapping to be applied
yzx:rotate x->z->y->x
yxz:switch x-y
xyz:keep orientation
xzy:switch y-z
zxy:rotate x->y->z->x

resize

Resize an image. The original data is centered within the new sized image.. Supported parameters are:

NameTypeDefaultDescription
sizestreamable[<0,0,0>]new size of the image a size 0 indicates to keep the size for the corresponding dimension.

sandp

salt and pepper 3d filter. Supported parameters are:

NameTypeDefaultDescription
threshfloat100thresh value
wint1filter width parameter

scale

3D image scale filter. Supported parameters are:

NameTypeDefaultDescription
interpstring[bspline:d=3]interpolation method to be used
s3dbounds[<0,0,0>]target size (component 0:use input image size)
sxuint0target size in x direction (0:use input image size)
syuint0target size in y direction (0:use input image size)
szuint0target size in y direction (0:use input image size)

selectbig

A filter that creats a binary mask representing the intensity with the highest pixel count.The pixel value 0 will be ignored, and if two intensities have the same pixel count, then the result is undefined. The input pixel must have an integral pixel type.. (This plug-in doesn't take parameters)

sepconv

3D image intensity separaple convolution filter. Supported parameters are:

NameTypeDefaultDescription
kxfactory[gauss:w=1]filter kernel in x-direction. For supported plug-ins see Plugin type: 1d/spacialkernel
kyfactory[gauss:w=1]filter kernel in y-direction. For supported plug-ins see Plugin type: 1d/spacialkernel
kzfactory[gauss:w=1]filter kernel in z-direction. For supported plug-ins see Plugin type: 1d/spacialkernel

sws

seeded watershead. The algorithm extracts exactly so many reagions as initial labels are given in the seed image.. Supported parameters are:

NameTypeDefaultDescription
gradbool0Interpret the input image as gradient.
markbool0Mark the segmented watersheds with a special gray scale value
nfactory[sphere:r=1]Neighborhood for watershead region growing. For supported plug-ins see Plugin type: 3dimage/shape
seedstring(required)seed input image containing the lables for the initial regions

tee

Save the input image to a file and also pass it through to the next filter. Supported parameters are:

NameTypeDefaultDescription
fileio(required)name of the output file to save the image too.. For supported file types see Plugin type: 3dimage/io

ws

basic watershead segmentation.. Supported parameters are:

NameTypeDefaultDescription
evalgradbool0Set to 1 if the input image does not represent a gradient norm image
markbool0Mark the segmented watersheds with a special gray scale value
nfactory[sphere:r=1]Neighborhood for watershead region growing. For supported plug-ins see Plugin type: 3dimage/shape
threshfloat0Relative gradient norm threshold. The actual value threshhold value is thresh * (max_grad - min_grad) + min_grad. Bassins seperated by gradients with a lower norm will be joined

Plugin consumers:

mia-3dimagefilter mia-3dimagefilterstack