Skip to content

hfVisualizer Remote Control Postprocessing

Use these commands after analysis results are available and you want to switch steps, frames, contours, vectors, scales, or overlay displays.

get queries return JSON and do not append a scriptTail. Set-type commands append canonical post-* ... tails to Remote Control History and *.ipc.txt.

Most definition commands remain preprocessing-only, but postprocessing mode still keeps a few GUI-matched exception paths that can modify the current HDB: environment-info set, nset, elset, step Post ..., step-delete-from ..., and history PostHistory ....

post-plot

hfVisualizer --remote [--target <id>] post-plot <contour|diagram|vector|sensor|deformed> <on|off>
  • Controls postprocessing plot toggles in the active view.
  • Available only in postprocessing mode.
  • deformed on fails when the current result step does not contain displacement output D.

post-step

hfVisualizer --remote [--target <id>] post-step <step-name>
hfVisualizer --remote [--target <id>] post-step get
  • post-step <step-name> selects the named result step and moves to frame 1 of that step.
  • post-step get returns the current step and frame state as JSON.
  • Available only in postprocessing mode.
  • <step-name> must match an existing result-step name exactly.
  • The single token get is reserved as a query keyword for this command.

post-frame

hfVisualizer --remote [--target <id>] post-frame <frame-index>
hfVisualizer --remote [--target <id>] post-frame get
  • post-frame <frame-index> selects a frame in the current result step.
  • post-frame get returns the current step and frame state as JSON.
  • Available only in postprocessing mode.
  • <frame-index> is 1-based and must be within the current step frame count.

post-scalar

hfVisualizer --remote [--target <id>] post-scalar <field> [<average-threshold>]
hfVisualizer --remote [--target <id>] post-scalar get
  • Selects the scalar field for the active result step.
  • get returns the current scalar field state as JSON.
  • Available only in postprocessing mode.
  • <field> must be a valid scalar field name for the current step and frame.
  • [<average-threshold>] is optional and must be an integer between 0 and 100.

post-vector

hfVisualizer --remote [--target <id>] post-vector <field>
hfVisualizer --remote [--target <id>] post-vector get
  • Selects the vector or tensor field for the active result step.
  • get returns the current vector field state as JSON.
  • Available only in postprocessing mode.
  • <field> must be a valid vector or tensor field name for the current step and frame.

post-contour

hfVisualizer --remote [--target <id>] post-contour auto-range <on|off>
hfVisualizer --remote [--target <id>] post-contour auto-range get
hfVisualizer --remote [--target <id>] post-contour range <min> <max>
hfVisualizer --remote [--target <id>] post-contour range get
hfVisualizer --remote [--target <id>] post-contour bands <n>
hfVisualizer --remote [--target <id>] post-contour bands get
hfVisualizer --remote [--target <id>] post-contour mode <uniform|custom>
hfVisualizer --remote [--target <id>] post-contour mode get
hfVisualizer --remote [--target <id>] post-contour levels <v1,v2,...>
hfVisualizer --remote [--target <id>] post-contour levels get
hfVisualizer --remote [--target <id>] post-contour overlay <text>
hfVisualizer --remote [--target <id>] post-contour overlay get
hfVisualizer --remote [--target <id>] post-contour overlay-color <r,g,b[,a]>
hfVisualizer --remote [--target <id>] post-contour overlay-color get
  • Controls contour settings in the active postprocessing view.
  • Available only in postprocessing mode.
  • auto-range, range, and bands set operations are rejected while custom contour mode is active.
  • mode custom initializes custom boundary levels from the current uniform range and band state when needed.
  • levels set requires between 2 and 31 strictly increasing boundary values.
  • overlay-color uses integer 0..255 channel values.
  • get returns the full contour state as JSON, plus action-specific aliases such as enabled, min, max, text, or color.

post-scale

hfVisualizer --remote [--target <id>] post-scale deformed auto <on|off>
hfVisualizer --remote [--target <id>] post-scale deformed auto get
hfVisualizer --remote [--target <id>] post-scale deformed value <scale>
hfVisualizer --remote [--target <id>] post-scale deformed value get
hfVisualizer --remote [--target <id>] post-scale diagram auto <on|off>
hfVisualizer --remote [--target <id>] post-scale diagram auto get
hfVisualizer --remote [--target <id>] post-scale diagram value <scale>
hfVisualizer --remote [--target <id>] post-scale diagram value get
hfVisualizer --remote [--target <id>] post-scale vector auto <on|off>
hfVisualizer --remote [--target <id>] post-scale vector auto get
hfVisualizer --remote [--target <id>] post-scale vector value <scale>
hfVisualizer --remote [--target <id>] post-scale vector value get
hfVisualizer --remote [--target <id>] post-scale sensor auto <on|off>
hfVisualizer --remote [--target <id>] post-scale sensor auto get
hfVisualizer --remote [--target <id>] post-scale sensor <e|d|v|a> <scale>
hfVisualizer --remote [--target <id>] post-scale sensor <e|d|v|a> get
  • Controls deformed, diagram, vector, and sensor scale factors in the active postprocessing view.
  • Available only in postprocessing mode.
  • Explicit value or e|d|v|a inputs disable the corresponding auto-scale mode first.
  • get returns the full scale state as JSON, plus query-specific aliases such as enabled or value.

post-display

hfVisualizer --remote [--target <id>] post-display <information|scalarbar|min-max-tag> <on|off>
  • Toggles postprocessing overlay and display items in the active view.
  • Available only in postprocessing mode.
  • information: upper-left information text
  • scalarbar: scalar bar widget
  • min-max-tag: min and max caption tags

post-animation-time-history

hfVisualizer --remote [--target <id>] post-animation-time-history <on|off>
  • Matches Postprocessing > Play > Time History Ani.
  • Available only in postprocessing mode.
  • Fails if scale-factor animation is currently active.

post-animation-scale-factor

hfVisualizer --remote [--target <id>] post-animation-scale-factor <on|off>
  • Matches Postprocessing > Play > Scale Factor Ani.
  • Available only in postprocessing mode.
  • Fails if time-history animation is currently active.

post-animation-loop

hfVisualizer --remote [--target <id>] post-animation-loop <on|off>
  • Matches Postprocessing > Play > Loop.
  • Available only in postprocessing mode.
  • Controls whether the current animation repeats automatically.

post-animation-record

hfVisualizer --remote [--target <id>] post-animation-record <on|off> [<file>]
  • Matches Postprocessing > Play > Record.
  • Available only in postprocessing mode.
  • on requires a writable output file path with .avi or .mp4 extension.
  • off clears the current animation record target.
  • Can be changed only while no animation is active.

Example:

hfVisualizer --remote post-step "LC1-DeadLoad"
hfVisualizer --remote post-frame 7
hfVisualizer --remote post-scalar "S.Mises" 85
hfVisualizer --remote post-contour mode get
hfVisualizer --remote post-animation-record on "D:/work/result.avi"