FLOW3D 命令行操作

周宇

2017年3月1日 15:59

這部分將介紹 FLOW3D 命令行的模式，包括運行腳本，顯示的結果以及怎樣運用求解器追蹤工具 PEEK。解釋了怎樣利用單行命令進行一系列的運算。標有 $ 的后面為命令提示符。

1. 運行腳本

運行腳本（批處理文件）中包括前處理（runpre）操作，求解運算（runhyd）和后處理（runpost）操作。包括一個特殊的運行腳本（runall），可連續地運行前處理，求解和后處理操作。以及一個可以批處理運算一系列文件的運行腳本。下面詳細介紹其特性。

runpre <ext1> <ext2>：對prepin.<ext1> 進行前處理操作，以 <ext2> 作為輸出文件的擴展名。如果 <ext2> 沒有定義，那么將 <ext1> 用來作為輸出文件的擴展名。

這里涉及 FLOW3D 的擴展名類型，名稱均是在 “. ” 后面出現

runhyd <ext2>：通過 runpre 前處理生成的文件進行求解，以 <ext2> 作為擴展名。如果 <ext2> 沒有定義，則擴展名為 <dat>，其輸出文件的擴展名也為 <dat>。

runpost <ext2>：將 runpre 前處理和 runhyd 求解運算生成的文件作為輸入文件，運行后處理，以 <ext2> 為擴展名。如果 <ext2> 沒有定義，則有以 <dat> 為擴展名的輸入文件和輸出文件。

runall <ext1> <ext2>：將 prepin.<ext1> 文件運行陸續運行以上三個腳本，以<ext2>為擴展名添加到輸出文件中。

runbatch <batch file>：對 <batch file> 文件按順序進行批處理模擬。每個模擬文件相對或絕對的文件路徑通過分開線區分，在下面的例子中，運算完成后，腳本回到運行的目錄下。

下面是針對 Linux 系統的批處理的案例，如果是 Windows 系統，需將 / 改變為 \。注意，例中后三個模擬路徑涉及 runbatch 腳本的執行目錄。

當運行 runpre 和 runpost 腳本，新的生成文件會覆蓋舊文件。但是，如果將舊文件存在目錄中，則會影響 runhyd 和 runall 的正常運行。使用者必須在 runall 和 runhyd 運行前刪除 flsgrf.<ext2>，這有助于避免發生過度寫入結果文件的意外錯誤。舊文件可以通過輸入 $ del flsgrf.<ext2> 刪除（在 Windows 系統下）。

2. 使用腳本

腳本文件設計上是運行在模擬工況的目錄里。腳本存在于 $F3D_HOME/local。目錄中。為了運行這些腳本，必須設置如下環境變量：

F3D_HOME：指定 FLOW3D 的安裝目錄的路徑。

F3DTKNUX_LINCENSE_FILE：指定 FLOW3D 的密鑰服務器的位置。

PATH：PATH 這個環境變量的修改必須包含在 $F3D_HOME/local，否則將找不到運行腳本文件。

F3D_VERSION：指定求解器的版本。對于雙精度版本選擇 double，對于常規雙精度求解器選擇 prehyd。

3. 運行命令行

（1）打開命令提示符或者終端

（2）設置所需的環境變量

Windows：這個可通過復制用來啟動 FLOW3D 批處理文件中的環境變量來完成。批處理文件的內容可以通過右鍵點擊 FLOW3D 圖標選擇編輯查看。

（3）改變求解器運行時的目錄

（4）輸入所需的運行腳本，如 runhyd

PEEK 是選單（有多項提示菜單選擇）程序，使用者在求解運行時可進行基本的控制操作。當求解器交互地運行或者處于批處理模式，PEEK 就可以運行。運行 PEEK，僅需要在程序運行時，在命令提示符或在目錄的終端下輸入 PEEK 即可。

PEEK 常通過顯示運算信息文件 hd3msg.* 的內容來檢查運行狀態。如果運算進程比預期緩慢或者沒有程序運行時的頻繁輸出。

頻繁輸出的情況

使用者就想迫使求解器將 spatial 和 history 數據寫入 flsgrf. 中。當分析出現問題部分有用，使用者希望看到在目前的運算階段怎樣運行下去。如果運算如預期停止運行，運算就會終止。這個選項迫使目前的求解狀態在結束運行前可以寫入到緩沖文件中。如果求解器被系統進程關閉，在終止前使用者將得不到求解狀態，數據將會消失。

PEEK 通過與命名為 HYdr3D_SIgnAL.dat 的文本信號文件交互。每當某一時刻 PEEK 被調用，這個文件就會建立，指示設想的動作將寫入文件。一旦求解器讀到這個信號文件（signal files），它將會被刪除。在執行期間，在每一時間步長的結尾求解器檢查由 PEEK 發出的信號。PEEK 可以指導求解器做一系列的事情，常用的大多數選項如下所示：