DREAM3D User Manual
Erode/Dilate Bad Data

Group (Subgroup)

Processing Filters (Cleanup)

Description

Bad data refers to a Cell that has a GrainId 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 GrainId of any Cell neighboring a bad Cell** will be changed to 0.

If the bad data is eroded option, 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 GrainId of the bad Cell is changed from 0 to the GrainId of the majority of its neighbors. If there is a tie between two GrainIds, then one of the GrainIds, chosen randomly, will be assigned to the bad Cell.

Goals a user might be trying to accomplish with this Filter are

  • to remove small or thin regions of bad data by running a single (or two) iteration erode operation.
  • to 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
Direction of Operation Dilate or Erode
Number of Iterations The number of iterations to use for the filter

Required DataContainers

Voxel

Required Arrays

Type Default Name Description Comment Filters Known to Create Data
Cell GrainIds Ids (ints) that specify to which Field each Cell belongs. Values should be present from segmentation of experimental data or synthetic generation and cannot be determined by this filter. Not having these values will result in the filter to fail/not execute. Segment Fields (Misorientation, C-Axis Misorientation, Scalar) (Reconstruction), Read Dx File (IO), Read Ph File (IO), Pack Primary Phases (SyntheticBuilding), Insert Precipitate Phases (SyntheticBuilding), Establish Matrix Phase (SyntheticBuilding)

Created Arrays

None

Authors

Copyright: 2012 Michael A. Groeber (AFRL),2012 Michael A. Jackson (BlueQuartz Software)

Contact Info: dream.nosp@m.3d@b.nosp@m.luequ.nosp@m.artz.nosp@m..net

Version: 1.0.0

License: See the License.txt file that came with DREAM3D.

See a bug? Does this documentation need updated with a citation? Send comments, corrections and additions to The DREAM3D development team