Magnify

MLModule

genre	Subimage
status	stable
author	Tobias Boskamp
package	MeVisLab/Standard
dll	MLGeometry1
definition	MLGeometry1.def
see also	SubImage, TestPattern, Mask
keywords	Extract, subimage, magnify, zoom, scale, diameter, local, ROI

Purpose

The module Magnify selects a subimage of a given size around a center point from a dataset. The subimage may be masked with a diamond or circular shaped mask and optionally be scaled with regard to its voxelsize.

The (scaled) subimage can be drawn as an overlay to the original image, e.g. as a local magnifying tool. Magnify can also be used to efficiently extract a small region of interest from a dataset by just selecting a center point and a physical diameter.

In combination with properly configured Info, TestPattern and Mask modules, a spherical region of interest can easily be extracted.

Usage

Specify a Center value and a size to obtain a subimage around the center.

By connecting Y and Z to Size X, a symmetric subimage is obtained.

Details

The Outset parameter adds an additional border around the generated subimage.

Tips

To obtain a 3D spherical mask, connect the Size X/Y/Z of an Info module connected to the Magnify output to a TestPattern module's corresponding image size fields and select the Filled Max Ellipsoid pattern. Combine this pattern with the Magnify output using a Mask module.

Windows

Default Panel

Input Fields

input0

name: input0, type: Image

Input image.

Output Fields

output0

name: output0, type: Image

The optionally masked subimage, possibly including a specified border.

Parameter Fields

Field Index

Border Fill: Enum	Y: Float
Center: Vector3	Z: Float
Fill Value: Float
Magnify: Float
Outset: Float
Shape: Enum
Size X: Float
World position and units: Bool

Visible Fields

Center

name: center, type: Vector3, default: 0 0 0

Sets the center position of the subimage in voxel or world coordinates, depending on the World position and units setting.

World position and units

name: worldPosAndUnits, type: Bool, default: FALSE

If checked, world coordinates are used for the Center field and world units (i.e. millimeters) are used for the size fields.

Size X

name: sizeX, type: Float, default: 20

Sets the x-size of the subimage in voxel or mm, depending on World position and units.

Y

name: sizeY, type: Float, default: 20

Sets the y-size of the subimage in voxel or mm, depending on World position and units.

Z

name: sizeZ, type: Float, default: 1

Sets the z-size of the subimage in voxel or mm, depending on World position and units.

Outset

name: outset, type: Float, default: 0

Sets the size of a border which is added in X and Y direction, specified in voxels or in world units, depending on the World position and units setting.

Shape

name: shape, type: Enum, default: Rectangle

Defines the shape for the subimage.

Values:

Title	Name
Rectangle	Rectangle
Circle	Circle
Diamond	Diamond

Border Fill

name: borderFill, type: Enum, default: ImgMin

Defines how the border/mask background of the subimage should be filled.

Values:

Title	Name	Description
Img Min	ImgMin	The input image's minimum value is used as a fill value.
Img Max	ImgMax	The input image's maximum value is used as a fill value.
User Val	UserVal	The Fill Value is used as a fill value.

Fill Value

name: fillValue, type: Float, default: 0

Sets a fill value for filling the borders/mask background if Border Fill is set to UserVal.

Magnify

name: magnify, type: Float, default: 1

Sets the scaling factor applied to the X and Y voxel sizes of the generated subimage.

Specifying a value greater than 1 results in a magnified subimage located at the Center position, e.g. for local magnification of a region of interest.