Import ASCII Data¶

Group (Subgroup)¶

IO (Input)

Description¶

This Filter reads ASCII data from any text-based file and imports the data into DREAM.3D-style arrays. The user uses the Filter's wizard to specify which file to import, how the data is formatted, what to call each array, and what type each array should be.

Note: This Filter is intended to read data that is column-oriented, such that each created DREAM.3D array corresponds to a column of data in the ASCII file. Therefore, this Filter will only import scalar arrays. If multiple columns are in fact different components of the same array, then the columns may be imported as separate arrays and then combined in the correct order using the Combine Attribute Arrays Filter.

Separating the Data¶

After clicking the Import Data... button and selecting a file, a wizard appears. The user can choose how the data is delimited: comma (,), tab, semicolon (;) or space ( ). The user may also elect to treat consecutive delimiters as one delimiter.

Selecting how the data is separated

Selecting the Delimiter¶

Selecting the delimiting character(s)

Selecting Import Rows, Data Representation and Column Headers¶

On the last page, the user can set the following information:

Row index to start the import
Header names, either from a line number in the file or manually through a dialog box or select the generated header values
Column data format (choosing the data type or deciding to skip the column)

Setting Numerical Representations, Column Headers and other information

If the data does not have any headers, the user can set a string value for each column. These values will be used as the name of the Attribute Array in DREAM.3D.

Setting Names of each Column which will be used as the name of each **Attribute Array**

Parameters¶

Name	Type	Description
Wizard Data Object	ASCIIWizardData	The object that holds all relevant data collected from the wizard

Required Geometry¶

Not Applicable

Required Objects¶

Kind	Default Name	Type	Component Dimensions	Description
Attribute Matrix	None	Any	1	The path to the attribute matrix to store the arrays that will be imported

Created Objects¶

Kind	Default Name	Type	Component Dimensions	Description
One or more Element/Feature/Ensemble/etc. Attribute Array	None	Any	1	One or more arrays that are created due to importing ASCII data via the wizard

Example Pipelines¶

License & Copyright¶

Please see the description file distributed with this plugin.

DREAM3D Mailing Lists¶

If you need more help with a filter, please consider asking your question on the DREAM3D Users mailing list: