Skip to content

hfSectionVisualizer Remote Control Definition

Definition

  • Use definition commands to build the section-analysis input data: functions, materials, sections, and analysis definitions.
  • GUI Apply actions in the Function, Material, Section, and Analysis editors append the same IPC commands to the default script history.

Function

hfSectionVisualizer --remote [--target <id>] function <type> <name> (--content <text> | --content-file <file>)

Material

hfSectionVisualizer --remote [--target <id>] material <type> <name> (--content <text> | --content-file <file>) [--neg-stop-strain <value>] [--pos-stop-strain <value>] [--signal <text> | --signal-file <file>]
  • Creates or updates one section *Material, TYPE=<type>, Name=<name> definition.
  • Exactly one of --content or --content-file is required.
  • <type> and <name> must not be empty.
  • Optional --neg-stop-strain and --pos-stop-strain override the section-material stop strains after the material body is applied.
  • Optional --signal or --signal-file attaches section signal definitions to the same material.
  • --signal and --signal-file are mutually exclusive.
  • Inside --content and --signal, use \n for line breaks. \\n stays literal.
  • Empty material content is rejected.
  • The command updates the section model in place and marks the current section model as changed.

Example:

hfSectionVisualizer --remote material UConcrete C30 --content "30000,0.2,..." --neg-stop-strain -0.003 --pos-stop-strain 0.00015
hfSectionVisualizer --remote material USteel REBAR --content-file D:\Work\rebar-material.txt --signal-file D:\Work\rebar-signal.txt

Section

hfSectionVisualizer --remote [--target <id>] section <name> (--content <text> | --content-file <file>) [--taper <on|off>]

Analysis

hfSectionVisualizer --remote [--target <id>] analysis <name> --section <name> (--content <text> | --content-file <file>) [--right <on|off>] [--ref <a,b,c>] [--output <Preselect|All>]

Environment UnitSystem

hfSectionVisualizer --remote [--target <id>] environment-unit-system get
hfSectionVisualizer --remote [--target <id>] environment-unit-system set <force-length|none>
  • Definition command notes:
  • exactly one of --content or --content-file is required where applicable
  • analysis requires --section
  • successful GUI edits in the Definition editors are recorded with these same command forms
  • environment-unit-system get returns the current *Environment, TYPE=UnitSystem token as JSON
  • environment-unit-system set accepts tokens such as kN-cm
  • environment-unit-system set none clears the section unit system