10.102. Pad Image Geometry

Group (Subgroup)

Generic (Generic)

Description

This Filter extends an Image Geometry outward by adding cells around the edges. Each added cell is initialized to a user-specified default value. Optionally, the geometry’s origin can be updated so that the original data stays in the same physical location after padding.

Padding is the inverse operation of Crop Geometry (Image). Common use cases are creating a margin around a sample before applying a transformation, or extending a small ROI to a standard size for batch processing.

Example

Given the input geometry in Figure 1:

Figure 1

Padding with X Min=0, X Max=10, Y Min=0, Y Max=10 produces:

Figure 2

Pad Amounts and Units

The pad amounts (X Min, X Max, Y Min, Y Max, Z Min, Z Max) are integers in cells/voxels. A value of 10 adds 10 cells to that face. Setting a pad amount to 0 means no padding on that face.

Default Value

Each padded cell is initialized to the Default Value for every cell-level Attribute Array in the target Attribute Matrix. The default value is interpreted in the same data type as each array (e.g., for a uint8 array, the value is cast to uint8; for a float32 array, to float32). Pick a value that is sentinel-like in every array (commonly 0).

Update Origin

If Update Origin is OFF (the default), the geometry’s origin stays at its current location. New cells appear at coordinates less than the original origin, so the original data effectively shifts to “the middle” of the new bounds.

If Update Origin is ON, the geometry’s origin is shifted so that the original data stays in its original physical coordinates. New cells extend to coordinates below the original origin.

Required Input Sources

Input Image Geometry – the geometry to extend. Typically produced by Create Image Geometry, ITK Import Image Stack, or an EBSD reader.

Input Parameter(s)

Parameter Name	Parameter Type	Parameter Notes	Description
Pad X Dimension	Bool		Enable padding in the X dimension.
Pad Y Dimension	Bool		Enable padding in the Y dimension.
Pad Z Dimension	Bool		Enable padding in the Z dimension.
X Min & Max Padding (in voxels)	Vector of Int32 Values	Order=X Min,X Max	The Min and Max padding for X Axis
Y Min & Max Padding (in voxels)	Vector of Int32 Values	Order=Y Min,Y Max	The Min and Max padding for Y Axis
Z Min & Max Padding (in voxels)	Vector of Int32 Values	Order=Z Min,Z Max	The Min and Max padding for Z Axis
Default Padding Value	Scalar Value	Int32	The value to apply to the added elements in each of the cell data arrays
Update Origin	Bool		Should the origin of the Image Geometry be updated
Perform In Place	Bool		Removes the original Image Geometry after filter is completed

Input Image Geometry

Parameter Name	Parameter Type	Parameter Notes	Description
Image Geometry	Geometry Selection	Image	Select the Image Geometry Group from the DataStructure.
Cell Data	AttributeMatrixSelection		The Attribute Matrix that holds the cell data for the geometry

Output Image Geometry

Parameter Name	Parameter Type	Parameter Notes	Description
Created Image Geometry	DataGroupCreation		The DataPath to store the created Image Geometry

Example Pipelines

‘pad_image_geometry.d3dpipline’

License & Copyright

Please see the description file distributed with this plugin.

DREAM3D-NX Help

If you need help, need to file a bug report or want to request a new feature, please head over to the DREAM3DNX-Issues GitHub site where the community of DREAM3D-NX users can help answer your questions.