*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.