Skip to content

hfVisualizer Remote Control Elset

elset

hfVisualizer --remote [--target <id>] elset <name> (--content <text> | --content-file <file>)
  • Creates or updates one *Elset, Name=<name> definition.
  • Exactly one of --content or --content-file is required.
  • Available in both preprocessing and postprocessing modes.
  • This is one of the few definition commands that remain editable in postprocessing mode.
  • Behavior rules:
  • preprocessing: creates a new set or updates an existing set
  • postprocessing: creates a new set, or updates an existing set only when that elset is not used by other objects
  • in postprocessing, a successful apply updates the model in the current DB/HDB file immediately, matching the GUI Define Elset widget behavior
  • Content uses the same body syntax as the Define Elset GUI:
  • integer ids or id patterns such as 10,20,30, 100:110, 1:101:10
  • existing elset names
  • -token to remove elements or referenced sets from the target set
  • __selected__ expands to the current element selection
  • -__selected__ removes the current element selection from the target set

Examples:

hfVisualizer --remote elset COLUMN --content "101:120\nFRAME_OUTER"
hfVisualizer --remote elset PICKED --content "__selected__,FRAME_OUTER"
hfVisualizer --remote elset POST_FACE --content "__selected__,-FRAME_OUTER"

elset-rename

hfVisualizer --remote [--target <id>] elset-rename <old-name> <new-name>
  • Renames one element-set definition.
  • Available only in preprocessing mode.
  • Uses the same name normalization and duplicate-name checks as ModelTree rename.

Example:

hfVisualizer --remote elset-rename COLUMN COLUMN_REVIEW

elset-delete

hfVisualizer --remote [--target <id>] elset-delete <name>
  • Deletes one element-set definition.
  • Available only in preprocessing mode.
  • Uses the same dependency cleanup as ModelTree delete:
  • referenced loads, constraints, embedded-line host elsets, and step target lists are updated automatically
  • the command fails when the named elset cannot be deleted

Example:

hfVisualizer --remote elset-delete COLUMN_REVIEW