Skip to content

hfVisualizer Remote Control Load

load

hfVisualizer --remote [--target <id>] load <type> <name> (--content <text> | --content-file <file>) [--func <name>]
  • Creates or updates one *Load, TYPE=<type>, Name=<name>[, Func=<name>] definition.
  • Exactly one of --content or --content-file is required.
  • load runs only in preprocessing mode.
  • <type> and <name> must not be empty.
  • --func <name> is optional and must refer to an existing function when used.
  • Supported load types are:
  • Concentric
  • Displacement
  • Gravity
  • SeismicRelative
  • Temperature
  • LineDistributed
  • LineMoving
  • SurfaceDistributed
  • SurfaceMoving
  • PedestrianMoving
  • FreeFieldSeismic
  • Content is passed directly to readLoadModification(..., true) after the IPC layer prepends the *Load keyword line.
  • Inside --content, use \n for line breaks. \\n stays literal.
  • Empty content is rejected.
  • After a successful apply, the created or updated load becomes the current load selection, matching the GUI Load widget behavior.

Example:

hfVisualizer --remote load Gravity DEAD --content "ALL, 0, 0, -9.81"
hfVisualizer --remote load Concentric LIVE --func TIME1 --content-file D:\Work\concentric-load.txt

load-rename

hfVisualizer --remote [--target <id>] load-rename <old-name> <new-name>
  • Available only in preprocessing mode.
  • Both names must be non-empty and use the same single-token normalization as GUI edits.
  • The source name must exist.
  • The target name must not collide with another load unless it normalizes to the same name, in which case the command succeeds as a no-op.
  • Successful execution is recorded by script-save as a canonical load-rename ... tail.

Example:

hfVisualizer --remote load-rename DEAD DEAD_G

load-delete

hfVisualizer --remote [--target <id>] load-delete <name>
  • Available only in preprocessing mode.
  • name must be non-empty and must resolve to an existing load.
  • The command uses the same delete path as ModelTree delete, so step references and current load selection are cleaned up together.
  • Successful execution is recorded by script-save as a canonical load-delete ... tail.

Example:

hfVisualizer --remote load-delete DEAD_G