Skip to content

hfVisualizer Remote Control NSet

nset

hfVisualizer --remote [--target <id>] nset <name> (--content <text> | --content-file <file>)
  • Creates or updates one *Nset, 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 nset 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 NSet widget behavior
  • Content uses the same body syntax as the Define NSet GUI:
  • integer ids or id patterns such as 1,2,3, 1:3, 1:9:2
  • existing nset names
  • -token to remove nodes or referenced sets from the target set
  • __selected__ expands to the current node selection
  • -__selected__ removes the current node selection from the target set

Examples:

hfVisualizer --remote nset LEFT_EDGE --content "1:61:10\nTOP_LINE"
hfVisualizer --remote nset PICKED --content "__selected__,BASE_NODES,-101:120"
hfVisualizer --remote nset REVIEW_PICK --content "__selected__"

nset-rename

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

Example:

hfVisualizer --remote nset-rename LEFT_EDGE LEFT_EDGE_REVIEW

nset-delete

hfVisualizer --remote [--target <id>] nset-delete <name>
  • Deletes one node-set definition.
  • Available only in preprocessing mode.
  • Uses the same dependency cleanup as ModelTree delete:
  • referenced loads and constraints drop the deleted nset reference
  • the command fails when the named nset cannot be deleted

Example:

hfVisualizer --remote nset-delete LEFT_EDGE_REVIEW