콘텐츠로 이동

hfVisualizer 원격 제어 Step

step

hfVisualizer --remote [--target <id>] step <type> <name> (--content <text> | --content-file <file>) [--prev <name>] [--nlgeom <on|off>]
  • 기존 step이 있으면 step list에서 원래 위치를 유지한 채 step 정의 하나를 생성하거나 갱신합니다.
  • --content와 --content-file 중 정확히 하나가 필요합니다.
  • step은 preprocessing mode에서 모든 지원 step type을 사용할 수 있습니다.
  • postprocessing mode에서는 <type>=Post만 허용됩니다. 이는 postprocessing mode에서도 유지되는 드문 GUI 예외 definition 경로 중 하나입니다.
  • <type>, <name>은 비어 있으면 안 됩니다.
  • 지원 step type:
  • Static
  • Static, Arclength
  • Static, Quasi
  • Dynamic
  • Seepage
  • Seepage, Transient
  • Frequency
  • ModelUpdating, Static
  • ModelUpdating, Modal
  • ModelUpdating, Bayesian
  • ShapeEstimation
  • Post
  • PerformanceEvaluation
  • Post는 *PostStep, Name=<name>를 만들고, 나머지는 *Step, TYPE=<type>, Name=<name>를 만듭니다.
  • 선택적 --prev <name>은 Prev=<name>에 대응하며 Post, PerformanceEvaluation을 제외한 모든 type에서 허용됩니다.
  • 선택적 --nlgeom <on|off>은 NLGEOM=<ON|OFF>에 대응하며 Static, Static, Arclength, Static, Quasi, Dynamic에서만 허용됩니다.
  • IPC 계층이 계산된 *Step 또는 *PostStep keyword line을 앞에 붙인 뒤 내용을 hfDBReader에 전달합니다.
  • --content 안에서는 줄바꿈을 \n으로 씁니다. \\n은 문자 그대로 유지됩니다.
  • 빈 내용은 허용되지 않습니다.
  • preprocessing mode에서는 성공 시 DB modified 상태를 올리고 render pipeline을 refresh합니다.
  • postprocessing mode에서는 성공 시 추가로 runLastDataProcessingStep()을 실행하고 DB file을 즉시 갱신하며, 이는 GUI Step 위젯과 같은 동작입니다.

예시:

hfVisualizer --remote step Static STEP1 --content "EquiTime, 0.1, 10\n*Activate, Type=Element\nALL"
hfVisualizer --remote step "Static, Arclength" STEP2 --prev STEP1 --nlgeom on --content-file D:\Work\step2.txt
hfVisualizer --remote step Post CHECK1 --content "elem-all\nSSF, D, sensor-check\n1.3*DC.2"

step-rename

hfVisualizer --remote [--target <id>] step-rename <old-name> <new-name>
  • preprocessing mode에서만 사용할 수 있습니다.
  • 두 이름 모두 비어 있으면 안 되며 GUI 편집과 같은 single-token 정규화를 적용합니다.
  • 기존 이름이 실제로 존재해야 합니다.
  • 새 이름이 다른 step과 충돌하면 실패하며, 정규화 후 같은 이름이면 no-op으로 성공합니다.
  • 성공하면 script-save에 canonical step-rename ... tail이 기록됩니다.

예시:

hfVisualizer --remote step-rename STEP1 STEP_MAIN

step-delete

hfVisualizer --remote [--target <id>] step-delete <name>
  • preprocessing mode에서만 사용할 수 있습니다.
  • name은 비어 있으면 안 되며 기존 step을 가리켜야 합니다.
  • ModelTree delete와 같은 삭제 경로를 사용합니다.
  • 기존 delete guard도 그대로 유지됩니다. 예를 들어 다른 step이나 history가 참조 중인 step은 삭제에 실패합니다.
  • 성공하면 script-save에 canonical step-delete ... tail이 기록됩니다.

예시:

hfVisualizer --remote step-delete STEP_MAIN

step-delete-from

hfVisualizer --remote [--target <id>] step-delete-from <name>
  • postprocessing mode에서만 사용할 수 있습니다.
  • name은 비어 있으면 안 되며 TreeWidget의 Delete Steps From ...가 삭제할 수 있는 기존 result-step 경로를 가리켜야 합니다.
  • TreeWidget Delete Steps From ...와 같은 삭제 경로와 guard 규칙을 사용합니다.
  • 성공하면 현재 HDB의 result data를 즉시 수정합니다.
  • 성공 직후 hfVisualizer가 HDB에서 result-step 메타데이터를 다시 읽어 오므로, 파일을 다시 열지 않아도 현재 step/frame 목록이 바로 갱신됩니다.
  • 삭제 후 result step이 하나도 남지 않으면 hfVisualizer는 preprocessing mode로 되돌아갑니다.
  • 성공하면 script-save에 canonical step-delete-from ... tail이 기록됩니다.

예시:

hfVisualizer --remote step-delete-from POST2