Erode/Dilate Bad Data

Group (Subgroup)

Processing (Cleanup)

Description

Bad data refers to a Cell that has a Feature Id of 0, which means the Cell has failed some sort of test and been marked as a bad Cell. If the bad data is dilated, the Filter grows the bad data by one Cell in an iterative sequence for a user defined number of iterations. During the dilate process the Feature Id of any Cell neighboring a bad Cell will be changed to 0. If the bad data is eroded, the Filter shrinks the bad data by one Cell in an iterative sequence for a user defined number of iterations. During the erode process the Feature Id of the bad Cell is changed from 0 to the Feature Id of the majority of its neighbors. If there is a tie between two Feature Ids, then one of the Feature Ids, chosen randomly, will be assigned to the bad Cell. If Replace Bad Data is selected, all Attribute Arrays will be replaced with their neighbor's value during erosion/dilation (instead of only Feature Id). The Filter also offers the option(s) to turn on/off the erosion or dilation in specific directions (X, Y or Z).

Goals a user might be trying to accomplish with this Filter include:

  • Remove small or thin regions of bad data by running a single (or two) iteration erode operation.
  • Increase the size of a bad data region by running an dilate operation. This might be useful if the experimental technique tends to underestimates the size of certain objects. For example, when running EBSD, the pores (which show up as bad data) are generally smaller in the scans than in the specimen, because the beam, when it is just inside the pore, still can pick up signal from the material just beneath the pore.

Running the erode-dilate operations in pairs can often change the size of some objects without affecting others. For example, if there were a number of big pores and a number of single bad Cells, running a single erode operation would remove the single Cells and reduce the pores by one Cell. If this is followed immediately by a dilate operation, then the pores would grow by one Cell and return to near their original size, while the single Cells would remain removed and not "grow back".

Parameters

Name Type Description
Operation Enumeration Whether to dilate or erode
Number of Iterations int32_t The number of iterations to use for erosion/dilation
X Direction bool Whether to erode/dilate in the X direction
Y Direction bool Whether to erode/dilate in the Y direction
Z Direction bool Whether to erode/dilate in the Z direction
Replace Bad Data bool Whether to replace all data or just Feature Ids

Required Geometry

Image

Required Objects

Kind Default Name Type Component Dimensions Description
Cell Attribute Array FeatureIds int32_t (1) Specifies to which Feature each Cell belongs

Created Objects

None

Example Pipelines

  • (10) SmallIN100 Full Reconstruction
  • (07) SmallIN100 Final Processing
  • 04_Steiner Compact

Please see the description file distributed with this Plugin

DREAM.3D Mailing Lists

If you need more help with a Filter, please consider asking your question on the DREAM.3D Users Google group!