*filewriteentities

Saves a BINARY file with only the contents of selected modules/parts.

Syntax

*filewriteentities entity_type mark_id filename reserved

Type

HyperMesh Tcl Modify Command

Description

Saves a BINARY file with only the contents of selected modules/parts. This is useful for shattering a large BINARY file into smaller ones.

There are certain rules and limitations:
  • There can be only one part on the input mark. That part may have multiple children.
  • Only the entities listed below are saved, and all other entities are ignored:
    • All components in the part hierarchy.
    • All elements in those components.
    • All nodes in those components.
    • Materials referred by those components.
    • Properties referred by those components.
    • Materials referred by those properties.
  • Components being exported must not be topologically connected to components in parts that are not included in the hierarchy being exported.

Inputs

entity_type
The entity type to export. Only supported for parts.
mark_id
The mark ID of parts. Valid values are 1 and 2. Only one part may be on the mark.
filename
The full name and ID of the file to write.
reserved
Reserved for future use. Must be set to 0.

Example

To write part 10 and all of its children parts to the file C:/temp/shatter10.hm:
*filewriteentities parts 1 C:/temp/shatter10.hm 0

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

14.0

2019 - Geometry facets are now also saved.