Skip to content

hfVisualizer Remote Control Environment

environment-unit-system

hfVisualizer --remote [--target <id>] environment-unit-system get
hfVisualizer --remote [--target <id>] environment-unit-system set <force-length-time-temp|none>
  • get returns the current global *Environment, TYPE=UnitSystem token as JSON.
  • set applies the same global UnitSystem behavior used by the GUI Environment > UnitSystem editor.
  • set requires preprocessing mode.
  • If set changes the length unit, hfVisualizer resets the camera to refit the resized model in the render views.
  • The value must be either:
  • a 4-field token such as kN-mm-s-K
  • none to clear the global UnitSystem
  • Clearing to none is rejected when local UnitSystem definitions still exist in functions or sections.
  • GUI Environment > UnitSystem Apply records the same canonical environment-unit-system set ... tail in Remote Control History and *.ipc.txt.

Example:

hfVisualizer --remote environment-unit-system get
hfVisualizer --remote environment-unit-system set kN-mm-s-K
hfVisualizer --remote environment-unit-system set none

environment-info

hfVisualizer --remote [--target <id>] environment-info get
hfVisualizer --remote [--target <id>] environment-info set (--content <text> | --content-file <file>)
  • get returns the current normalized *Environment, TYPE=Info text as JSON.
  • set applies the same Info body content used by the GUI Environment > Info editor.
  • set is available in preprocessing mode and, as one of the few GUI-matched exceptions, also in postprocessing mode.
  • Exactly one of --content or --content-file is required for set.
  • Inside --content, use \n for line breaks. \\n stays literal.
  • Empty content is rejected.
  • In postprocessing mode, a successful apply updates the DB file immediately, matching the GUI Environment > Info behavior.
  • GUI Environment > Info Apply records the same canonical environment-info set --content ... tail in Remote Control History and *.ipc.txt.

Example:

hfVisualizer --remote environment-info get
hfVisualizer --remote environment-info set --content "The bridge is analyzed by Hyfeast.\nReviewed on site."

environment-control

hfVisualizer --remote [--target <id>] environment-control get
hfVisualizer --remote [--target <id>] environment-control set (--content <text> | --content-file <file>)
  • get returns:
  • the current normalized *Environment, TYPE=Control text
  • structured control fields: compact, equationPrint, shell5Dof, outputPrecision, constraintHandler, nonsmoothIntegrationLevel, boundaryTolerance
  • set applies the same Control body content used by the GUI Environment > Control editor.
  • set requires preprocessing mode.
  • Exactly one of --content or --content-file is required for set.
  • Inside --content, use \n for line breaks. \\n stays literal.
  • Empty content is rejected.
  • GUI Environment > Control Apply records the same canonical environment-control set --content ... tail in Remote Control History and *.ipc.txt.

Example:

hfVisualizer --remote environment-control get
hfVisualizer --remote environment-control set --content "Compact=Off, OutputPrecision=double, BoundaryTolerance=1e-5"