*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