8.13. Combine STL Files

Group (Subgroup)

Reader/Input

Description

This Filter combines all of the STL files from a given directory into a single triangle geometry. This filter will make use of the Import STL File Filter to read in each stl file in the given directory and then will proceed to combine each of the imported files into a single triangle geometry.

There is an option to label the faces and vertices with a “Part Number” that represents the index into the list of files that was used as the input. This would be based on the lexographical index and starts from 1. This allows for the immediate “segmentation” of the resulting triangle geometry or just as a convenience to “color by” in the visualization widget. This can also be used in the “Write STL Files from Triangle Geometry” Filter if the selection for the “File Grouping Type” is set to “Part Index” in the UI. Then use the “Part Number” array that is created in this filter for the “Part Index”.

Input Parameter(s)

Parameter Name	Parameter Type	Parameter Notes	Description
Path to STL Files	FileSystemPath		The path to the folder containing all the STL files to be combined
Generate Triangle Part Numbers	Bool		When true, each triangle will get an index associated with the index of the STL file
Generate Triangle Face Labels	Bool		When true, the ‘Face Labels’ array will be created.
Generate Vertex Part Numbers	Bool		When true, each vertex will get an index associated with the index of the STL file

Output Geometry

Parameter Name	Parameter Type	Parameter Notes	Description
Triangle Geometry	DataGroupCreation		The path to the triangle geometry to be created from the combined STL files

Output Face Data

Parameter Name	Parameter Type	Parameter Notes	Description
Face Attribute Matrix	DataObjectName		The name of the face level attribute matrix to be created with the geometry
Face Normals	DataObjectName		The name of the data array in which to store the face normals for the created triangle geometry
Created Part Number Array	DataObjectName		The name of the part numbers data array
Created Face Labels Array	DataObjectName		The name of the ‘Face Labels’ data array

Output Vertex Data

Parameter Name	Parameter Type	Parameter Notes	Description
Vertex Attribute Matrix	DataObjectName		The name of the vertex level attribute matrix to be created with the geometry
Created Part Number Labels	DataObjectName		The name of the part numbers data array

Output Feature Data

Parameter Name	Parameter Type	Parameter Notes	Description
Feature Attribute Matrix	DataObjectName		The name of the created feature attribute matrix
Active	DataObjectName		Specifies if the Feature is still in the sample (true if the Feature is in the sample and false if it is not). At the end of the Filter, all Features will be Active
File List Array	DataObjectName		The path to a String array that will store the input paths of each file that was read.

Example Pipelines

CombineStlFiles

License & Copyright

Please see the description file distributed with this plugin.

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.