8.150. Write STL Files from Triangle Geometry

Group (Subgroup)

IO (Output)

Description

WARNING: The filter now provides implict overflow capabilities for very large datasets, but this will lead to many duplicated vertices being produced. Be sure to run a cleaning algorithm when importing these files into DREAM3DNX or other software. For more info see below.

This Filter can generate a single or multiple binary STL (StereoLithography) files for a given Triangle Geometry. This is controlled by the “File Grouping Type” parameter which is a combo box parameter type with the following choices:

  • Features: The user must supply a 2 component Int32 array where the values are the 2 features that the triangle belongs to.

  • Phases and Features: The user must the same kind of array as in the “Features” but also must supply a single component array that represents another higher order of grouping, such as a phase (in the case of microstructure data) or a part number in the base of importing a large multipart geometry.

  • Single File: The entire Triangle Geometry is saved as a single STL File

  • Part Index: The user must supply a single component Int32 array at the triangle level that represents which part the triangle belongs to. This is handy when the Triangle Geometry has distinct, non-overlapping “parts”, such as an AM build with.

This filter supports overflow capabilities for all of the “File Grouping Type”(s) (including single file). This means if you have over the maximum number of triangles for a single STL file (2,147,483,647), the remaining triangles will be written to “overflow files” which will follow the following syntax {filename}_overflow_{count}. Warnings will be emitted during preflight if it is known or a possibility this will occur. Due to the nature of STL files containing all the vertices relative to the triangles in the file, duplicate vertices will be written between the files. For single file overflow, the files will be written in parallel with the number of additional tasks being equivalent to ({number of triangles in Geometry} / 2,147,483,647) + 1. For multiple files, the existing tasks handling the grouping write out are also responsible for creating/writing any overflow files.

Input Parameter(s)

Parameter Name

Parameter Type

Parameter Notes

Description

File Grouping Type

Choices

How to partition the stl files

Output STL Directory

FileSystemPath

Directory to dump the STL file(s) to

Output STL File Prefix

String

The prefix name of created files (other values will be appended later - including the .stl extension)

Output STL File

FileSystemPath

STL File to dump the Triangle Geometry to

Input Data Objects

Parameter Name

Parameter Type

Parameter Notes

Description

Selected Triangle Geometry

Geometry Selection

Triangle

The geometry to print

Face labels

Array Selection

Allowed Types: int32 Comp. Shape: 2

The triangle feature ids array to order/index files by

Feature Phases

Array Selection

Allowed Types: int32 Comp. Shape: 1

The feature phases array to further order/index files by

Part Numbers

Array Selection

Allowed Types: int32 Comp. Shape: 1

The Part Numbers to order/index files by

DREAM3D-NX Help

If you need help, need to file a bug report or want to request a new feature, please head over to the DREAM3DNX-Issues GitHub site where the community of DREAM3D-NX users can help answer your questions.