Skip to content

Initialize Synthetic Volume

Group (Subgroup)

Synthetic Building (Packing)


This Filter creates an empty volume composed of an Image Geometry to serve as a base for inserting Features to create a synthetic microstructure. The Filter wil also create a Data Container in which to hold the generated Image Geometry and a corresponding Cell Attribute Matrix. The user sets the dimensions, origin, and resolution of the Image Geometry. The dimensons are the X, Y, and Z extents of the Image Geometry in number of Cells. The resolution represents the edge length of a given Cell, and therefore has units of length. The origin is the real space location of the (0, 0, 0) coordinate. When selecting the Estimate Number of Features option, the Filter will guess at how many Features may end up being inserted into the volume based on the Statistics defined in a .dream3d file. Note that this estimation is only valid if the file chosen is the same file used as the source of the chosen Statistics array.

For more information on synthetic building, visit the tutorial.

User Interface

Relationship between Dimensions and Resolution

It can be confusing to keep straight the relationship between the Dimensions and Resolution and how changes will effect the number of features that would be generated. The table below illustrates the relationship via images from four synthetic generation runs where each run only the dimension or resolution was changed. The inputs were either 128 or 64 voxels on a side and either 0.5 or 0.25 resolution. The units are arbitrary length units. Examining the images in the table will allow the user to better understand the relationship.

Resolution (0.5^3) Resolution (0.25^3)
Dimensions (128^3) 316 Features 40 Features
Dimensions (64^3) 44 Features 2 Features


Name Type Description
Estimate Number of Features bool Whether to estimate the number of Features in the primary phase that may be inserted into the volume
Input Statistics File File Path The input .dream3d statistics file. Only needed if Estimate Number of Features is checked
Dimensions int32_t (3x) The (X, Y, Z) extents of the Image Geometry in voxels
Resolution float (3x) The (dx, dy, dz) resolution of the Image Geometry in units of length
Origin float (3x) The location of the (0, 0, 0) coordinate

Required Geometry

Not Applicable

Required Objects

Kind Default Name Type Component Dimensions Description
Ensemble Attribute Array Statistics Statistics Object (1) Statistics objects (depending on Phase Type) that store fits to descriptors such as size distribution, shape distribution, neighbor distribution, ODF, MDF, etc.
Ensemble Attribute Array PhaseTypes uint32_t (1) Enumeration specifying the phase type of each Ensemble

Created Objects

Kind Default Name Type Component Dimensions Description
Data Container SyntheticVolumeDataContainer N/A N/A Created synthetic volume Data Container name with an Image Geometry
Attribute Matrix CellData Cell N/A Created Cell Attribute Matrix name

Example Pipelines

  • (02) Single Hexagonal Phase Equiaxed
  • (03) Single Cubic Phase Rolled
  • (05) Composite
  • InsertTransformationPhase
  • (01) Single Cubic Phase Equiaxed
  • (04) Two Phase Cubic Hexagonal Particles Equiaxed
  • (06) SmallIN100 Synthetic

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!