Skip to content

Import ASCII Attribute Array

Group (Subgroup)

Core (IO/Read)


This Filter allows the user to import a plain text file containing the contents of a single Attribute Array. The delimeters can be one of the following:

+ comma
+ semicolon
+ space
+ colon
+ tab

The filter does not care about how many values per line but only about reading the proper number of values from the file. If you are trying to read an array into DREAM.3D and there is no existing DataContainer or anything else to hold the data then the user will need to insert the following filters BEFORE using this filter:

+ Create DataContainer: Give the DataContainer a name
+ Create AttributeMatrix: Give the AttributeMatrix a name and set the tuple dimensions to match the number of values in the input file.
+ OPTIONAL: If the data exists as a regular set of data on a grid then the user can also use the "Create Geometry (Image)" filter before importing the data.

Example Data

The example data below has 50 elements. This means that it could successfully be read into an array that has 10 Tuples and 5 Componenets or 50 Tuples and 1 Component. The AttributeMatrix would need to have dimensions such that mulplying all the dimensions together yields 50. For example the AttributeMatrix could have X=5, Y=5 and Z=2 or X=10, Y=5 and Z=1. This filter does not require any type of Geometry as the filter is reading data directly into an array.

0   1   2   3   4   5   6   7   8   9
10  11  12  13  14  15  16  17  18  19
20  21  22  23  24  25  26  27  28  29
30  31  32  33  34  35  36  37  38  39
40  41  42  43  44  45  46  47  48  49

Scalar Types

Value Type
0 signed int 8 bit
1 unsigned int 8 bit
2 signed int 16 bit
3 unsigned int 16 bit
4 signed int 32 bit
5 unsigned int 32 bit
6 signed int 64 bit
7 unsigned int 64 bit
8 Float 32 bit
9 Double 64 bit

Delimeter Types

Value Type
0 comma
1 semicolon
2 space
3 colon
4 tab


Name Type Description
InputFile String The path to the input file including the filename
ScalarType int See table above
Number of Components int The number of components in the array.
Skip Header Lines int If the file has some sort of a header, skip this many lines.
Delimeter int See Table above

Required Geometry

Not Applicable

Required Objects

Kind Default Name Type Component Dimensions Description
Attribute Matrix None DataArrayPath N/A Attribute Matrix to store imported data into

Created Objects

Kind Default Name Type Component Dimensions Description
Attribute Array N/A See Table above based on number of components The created Attribute Array

Example Pipelines

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!