*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
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 module on the input mark. That module may have multiple children.
- Only the entities listed below are saved, and all other entities are ignored:
- All components in the module 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 modules not part of the hierarchy being exported.
Inputs
- entity_type
- The entity type to export. Only supported for modules.
- mark_id
- The mark ID of modules. Valid values are 1 and 2. Only one module 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 module 10 and all of its children modules to the file
C:/temp/shatter10.hm:
*filewriteentities modules 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