DREAM.3D v6 User Manual
Import Images (3D Stack)

Group (Subgroup)

IO (Input)

Description

This Filter is used to import a stack of 2D images that represent a 3D volume. This Filter makes use of Qt's QImage class to perform the import, although not all QImage formats are currently supported by this Filter. Currently, support only exists for 8 bit grayscale, 32 bit RGB, and 32 bit ARGB images. Note that due to limitations of the Xdmf wrapper, 4 component ARGB images cannot be visualized using ParaView. The only current way to solve this issue is to import the image data and then apply the Flatten Image Filter, which will convert the color data to gray scale data. The image can then be visualized in ParaView using the Xdmf wrapper.

Importing a Stack of Images

This Filter will import a directory of sequentially numbered image files into the DREAM.3D data structure, creating a Data Container, Cell Attribute Matrix, and Attribute Array in the process, which the user may name. The user selects the directory that contains all the files to be imported then uses the additional input widgets on the Filter interface (File Prefix, File Suffix, File Extension, and Padding Digits) to make adjustments to the generated file name until the correct number of files is found. The user may also select starting and ending indices to import. The user interface indicates through red and green icons if an expected file exists on the file system. This Filter may also be used to import single images in addition to stacks of images. The user may also enter the origin and resolution of the imported images, if known.


ImportImageStackGUI.png
Import Image Stack User Interface

DREAM.3D contains numerous tools to modify, analyze and segment generic image data. If your images are already pre-processed so that they are segmented into specific regions, DREAM.3D may also be able to work with the image data and produce meaningful results. Three categories of images that DREAM.3D can handle include the following:


Category 1 Image

The regions of the image that represent an Ensemble or Feature each have a unique identifier such as a grayscale value or unique RGB value.

Type1.png
Category 1 Image

Category 2 Image

There are regions in the image that represent Features, where each region has a unique identifier but there are multiple regions with the same identifier.

Type2.png
Category 2 Image

Category 3 Image

Each Feature is traced out via another pixel identifier so that Feature boundaries are "black" and each Feature is "white". This type of image is commonly referred to as a binary image.

Type3.png
Category 3 Image

Note that the above categories represent a small subset of the kinds of images DREAM.3D can process. In general, any kind of multi-dimensional data can be stored and analyzed by DREAM.3D.

Parameters

See Description

Required Geometry

Not Applicable

Required Objects

None

Created Objects

Kind Default Name Type Component Dimensions Description
Data Container ImageDataContainer N/A N/A Created Data Container name with an Image Geometry
Attribute Matrix CellData Cell N/A Created Cell Attribute Matrix name
Cell Attribute Array ImageData uint8_t(n) Attribute Array for the imported image data. The dimensionality of the array depends on the kind of image read: (1) for grayscale, (3) for RGB, and (4) for ARGB

License & Copyright

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!