DEXCS2020 for OpenFOAM(R) リリースノート

解析シーン毎にTreeFoamのサブセット機能(グリッドエディダ等)を、FreeCADのツールボタンで起動できるようマクロ化してあります。

ダウンロードはこちら(2020/10/〜)



DEXCS for OpenFOAM(R) は、OpenFOAMと、これをより簡単・高度に活用できるようにする為の様々なツールをすべてインストール済のオール・イン・ワンパッケージで、誰でも(と言ってもCAEに無縁の人は対象外ですが・・・)簡単・即使えるようにしたマシンイメージ(isoファイル)です。

詳しくはこちら

DEXCSランチャーのヘルプメニューからも参照できます

DEXCS2020では、

  • ベースOSはubuntu-20.04.01 (LTS)
    • DEXCS2019まではubuntu-18.04系でしたが、メジャーヴァージョンアップです。
  • OpenFOAMやその他の組み込みツールのヴァージョンアップに対応
    • OpenFOAM-v2006
    • cfMesh v1.1.2 。

(cfMeshはOpenFOAM-v1712以降、modules としてOpenFOAM本体に組み込まれています)

  • ここまでは通常の毎年更新作業ですが、DEXCS2019からはDEXCSランチャーを仮想風洞試験という題材はそのままで、GUI操作方法を全く作り変えました
  • DEXCS2020では、これに少し機能追加したのと、ポータビリティを改良。つまり、これらはFreeCADのマクロなんですが、これまでDEXCS上でしか動作しなかったのを、DEXCSでない環境でも動かせる事を考慮したコードに書き換えています。まだ十分な動作確認まで至ってはおりませんが・・・
  • もう1点。TreeFoamがVer-3になって、python3で動くようになり、これにも対応した。
  • pyFoam は、OpenFOAM-v2006への対応はアナウンスされておりません。DEXCSランチャーやTreeFoamで使っている機能(pyFoamPlotWatcher.pyやFoamCleaCase.pyなど)についてのみ動作確認しており、その他の機能については動作未確認です。

インストールと利用法

詳しくはこちら(日本語と英語の切り替え方法も含む)

マシンイメージなので、DVDにイメージ書き込みすれば、DVDから起動してそのまま利用することができます。 (DEXCS初体験の人はこのライブDVDとして「まずは使ってみる」方法をお薦めします。)

  • 継続利用では起動後にインストール機能により、HDD等に直接インストールできる上、使用するユーザー名等を選択することができます。
  • VMWare Playerや、VirtualBox等の仮想環境で起動して、仮想環境を作成することも簡単です。
  • VirtualBoxにインストールする方法は、書籍「OpenFOAMによる熱移動と流れの数値解析」の付録AにDEXCS2015について詳しく記されていますが、基本は同じです。また、DEXCS2011までは、”Guest Additions”が入っておりませんでしたが、DEXCS2016では導入済みなので、共有ファイルの設定など(インストール方法メモの34〜36ページ)も同様に実施可能です。
  • 国際化対応のレベルはDEXCS2015に同じ(英語版のみに対応)ですが、日本語⇆英語のベース環境切り替え方法が、DEXCS2015に比べやや煩雑になっています。(インストール方法メモの8〜13ページ)
  • 一部動作に不具合が確認されています(インストール方法メの19ページ)。解決方法が見出だせませんでした。お判りの方、またこれ以外の不具合に気づかれた方はご連絡下さい。

同梱プログラム

その他のドキュメントについて

  • DEXCSランチャーのヘルプメニュー(上図)を参照下さい。
  • SLURMというリソースマネージャは今回もインストールしてありませんが、下記記事の方法によって追加インストールは可能(のはず)です。
  • JAVA gnuplot GUI の使用方法
    • http://dexcs.net/ocse2/?p=747
    • 上記記事で作成したプロジェクトファイルをケースファイルの在所を変えたり、別ケースで転用利用する際に、プロジェクトファイル中に記されているデータ在所(絶対パス名)を適合するツールを同梱しました。
  • 上記適合ツールは、DEXCSランチャーの左図ボタンにて起動します。⇒ 解説ページ
  • または、TreeFoam /十徳ナイフ /「汎用gnuplot-GUI(jgp)起動」メニューでも起動できます。
  • 但し、十徳ナイフ版では、実行時のダイヤログメッセージが日本語ではありません。

  • TreeFoamの基本的な使い方はTreeFoamのヘルプメニューから、「使い方」を参照して下さい。
    TreeFoamに関する情報は、DEXCS公式HPの AboutTreeFoamの記事にまとめてあります。
    DEXCS2020に搭載のTreeFOAMは、+dexcsSwakとして、上記公式ページに掲載ヴァージョンに対して独自のカスタマイズが加えてあります。

苦労譚

  • ParaViewビルド
  • FreeCAD AppImage版
  • FreeCADビルド版
  • リマスター容量の問題
  • /bin/sh の問題
  • VirtualBox Guest Additions

などなどありますが、近日中に書籍として上梓予定。DEXCS2019をベースとして書きかけ中のhtml版は特設ページにて公開中。書籍版は本DEXCS2020をベースに内容を更新作業中です。

問い合わせ画面の不調について

ここしばらくメール送信が出来ない状態だったようでご迷惑をお掛けしました。多分修復出来たと思います(2021/2/7 再度設定変更しました)。

それでも送信できない方は、以下のアドレス宛送信をお願いします(@は半角の@に編集し直してお使いください)。

nomura@e.email.ne.jp

DEXCSランチャー(FreeCADマクロ版)v200617



先の記事で、表題マクロがTreeFoamの最新版(ver-3.*, python3版)にて機能しないモジュールがあると記したが、これに対処したもの⇒DexcsLauncher4Tf3-200617.tar.gz

インストール方法は先の記事で記したのと全く同じ。

但し、これを動かす為には、TreeFoam本体の変更も必要で、変更用のパッチ(diffTF-3.02vs+DL+swak-200617.tar.gz)も併せて実施する必要がある。変更パッチは、同梱のupDateTF-3.02+DL+swak.shを管理者権限で実行する。

なお、この際、以下に示すように、

$ sudo ./upDateTF-3.02+DL+swak.sh
patching file /opt/TreeFoam/python/getPyQtModule.py
patching file /opt/TreeFoam/python/gridEditorQtDialog.py
patching file /opt/TreeFoam/python/runParaFoamOptionDialog.py
patching file /opt/TreeFoam/python/selectFolderFilesDialog.py
patching file /opt/TreeFoam/python/createAndChangeCaseDialog.py
patching file /opt/TreeFoam/python/runParallelDialog.py
TreeFoam update for DEXCS Launcher has done.

TreeFoam update for TreeFoam+dexcsSwak
dexcsSwak modules exist in /opt/DEXCS/SWAK/
Continue ? (Y/N)

TreeFoam-3.02のpythonモジュールを変更した後、dexcsSwak(dexcs十徳ナイフ) を使用するかどうかを聞いてくる。ここで、DEXCS-OFで構築したシステムであれば、「Y」を入力して、/opt/DEXCS/SWAK以下のモジュールを更新して、TreeFoam-3系でもdexcs十徳ナイフを使えるようになる。

注意事項

並列計算モジュールだけは、起動すると以下の画面が現れる。

具体的には、「並列計算実行」「結果の再構築」が機能しないので留意されたい。

DEXCSランチャー(FreeCADマクロ版)v202006

ダウンロードはこちらから



DEXCSランチャーとは

OpenFOAMを使った仮想風洞試験を、ボタンを順番に押していくだけで、誰でも簡単に実行できるようにすべく、pythonで作成したGUIツールで、DEXCS2019からは、FreeCADのマクロとして実装するようになった。

DEXCSランチャーはこれまで、DEXCS for OpenFOAMというisoイメージ中に同梱される形でしか配付していなかった。これはpythonのソースコードを配付したとしても、DEXCS以外の環境で使用する為には、様々なカスタマイズが必要になって、一般ユーザーが独自でカスタマイズできるようにするには、相当な困難があった為である。

DEXCS2019からはランチャーをFreeCADマクロとして実装した事を契機として、DEXCS2020ではこれらのマクロを、同梱したDEXCS以外の環境でも使えるようにすることを目指して取組中であるが、このたびプロトタイプ版としてDEXCS2019に搭載したマクロをベースに、DEXCS21019とそれ以外のDEXCS(DECS2015以降、DEXCS2018はFreeCADの更新も必要)でも使えるランチャーが出来たので、ここに公開することにした。

また、DEXCSで構築したシステムでなくとも、TreeFoamが動く環境であれば、若干のファイル追加で動作するはずなので、その要件と追加方法についても記しておく。この部分も、DEXCS2020以降では、configDexcsの設定だけで対応可能にしていく予定である。

更新方法

同梱のconfigDexcsというファイルが、以下のようになっている。

# cfMesh がインストールされたOpenFOAM環境
#for DEXCS-2019
    cfMesh     /opt/OpenFOAM/OpenFOAM-v1906
# for DEXCS-2018 ( not available)
#     cfMesh     /opt/OpenFOAM/OpenFOAM-v1806
# for DEXCS-2017
#     cfMesh /opt/OpenFOAM/OpenFOAM-4.x
# for DEXCS-2016
#     cfMesh     /opt/OpenFOAM/OpenFOAM-4.x
# for DEXCS-2015
#     cfMesh     /opt/OpenFOAM/OpenFOAM-2.4.x
# for DEXCS-2014
#     cfMesh     /opt/OpenFOAM/OpenFOAM-2.3.x

#configTreeFoam のインストール場所
    TreeFoam ~/.TreeFoamUser

#dexcs のインストール場所
# for DEXCS-2017 〜
    dexcs     /opt/DEXCS
# for 〜 DEXCS-2016
#    dexcs     ~/Desktop/DEXCS

DEXCS2019で更新する場合はこのままで良いが、それ以外のDEXCSでマクロを使いたい場合には、chMeshがインストールされたOpenFOAM環境と、dexcsのインストール場所を該当のものに変更する(行頭に#の有る行は有効にならないので、有効にしたい行だけ#を外す)。

同梱の updateDexcsLauncher.sh を端末上で実行する。その際、既存のuser.cfgを上書きするかどうかの質問があるので、

$ ./updateDexcsLauncher.sh
DEXCS Launcher update
Overwrite your FreeCAD SettingFile(user.cfg)? (Y/N)

上書きして良ければ「Y」を入力してアップデートは完了。

上書きの可否は、インストール先のFreeCADの利用環境で自身でカスタマイズしたマクロやツールバーの有無次第で判断されたい。上書きしてしまうと、それらの情報が無くなってしまうということである。「N」を入力した場合には、マクロファイルがアップデートされるだけなので、ツールボタンを自身で作り直す作業が必要になる。

なお、上書きした場合でも、元の user.cfg ファイルは、user.cfr.<user>.orig という名前で残すようにしてあるので復元は可能。またテキストファイルなので、内容を理解した上での新旧ファイル間での組み合わせ改変は可能です。

注意事項

  • DEXCS2015では、xfce4-terminal の追加インストールが必要になります。

$ sudo apt install xfce4-terminal

  • DEXCS2018ではFreeCADのAppImage版がインストールされている為動作不可、FreeCADをパッケージ版、もしくはビルド版に変更する必要があります。DEXCS上で上記FreeCADをインストールするには、この記事を参照下さい。

user.cfgを上書きしないで、作り直す方法

DEXCS2017へインストールした例で説明する。FreeCADを起動して、「ツール」メニューから「カスタマイズ」を選択すると以下の画面になる。

ここでマクロ欄右端の▼(上図赤印)をクリックすると、マクロ一覧が現れるので、登録したいマクロを選択し、メニューテキストなど空欄に説明事項を印しておく。ピクセルマップの「…」ボタンを押すと、以下の画面が現れてアイコンを選択できるようになる。何を選んでも良いが、

その際に、「アイコンフォルダー…」のボタンを押して、

「+」ボタンを押して、TreeFoamのアイコンフォルダ(/opt/TreeFoam/icons)を追加しておく。そうすると、TreeFoamのアイコンを登録できるようになる。

空欄を埋めて、アイコンが決まったら、「追加」ボタンを押してひとつのマクロの登録が完了である。

登録が必要なマクロは以下の通りである。

マクロファイル名メニューテキストツールチップ等アイコン
runTreefoam.pytreefoamtreefoam を起動します
runGridEditor.pygridEditorgridEditorの起動
runParaview.pyrunParaviewparaFoamの起動
runClearCase.pyrunClearCase計算結果を削除して、caseを初期化します
runJgp.pyrunJGPlotjgpファイルの適合
checkCaseFileName.pycheckCase解析ケースファイルの確認
runCheckMesh.pycheckMeshcheckMeshを実行する
solverSet.pysolverSet新規にcaseを作成、又はsolverやmeshを入れ替え
editConstantFolder.pyeditConstantFolderPropertiesの編集
editSystemFolder.pyeditSystemFolderDict(system)の編集
runSolver.pyrunSolversolverを起動
runPlotWatcher.pyrunPlotWatcherplotWatcherの起動
runParallel.pyrunParallel並列処理

登録が終わったら、次にツールバーへの登録である。上記カスタマイズ画面において、「ツールバー」のタグ画面にて、左欄で「マクロ」、右欄で「全体」選択し、DEXCSツールバーを展開すると、下図の状態になる。

ここで、登録したマクロを左欄で選択し、中央の右矢印ボタンを押せば、右欄に追加されるので、新たに登録したもののうち、必要なものを右欄に移し、順序も好みで入れ替えて使ってもらえば良い。

DEXCS以外のプラットフォームで動作させる為の要件

  • cfMesh(cartesianMesh)がインストールされており、configDecs中に、これを起動する為の(ビルドした)OpenFOAMの環境情報が記してある事。

  • TreeFoamがインストールされており(+dexcsSwak版でなくとも可)、configDecs中に configTreeFoam のインストール場所が記されている事。但し、ヴァージョン2系のみ。ヴァージョン3系では一部のマクロが動作しない(ので現在製作中)。
  • FreeCADのVerは0.16以上で、AppImage版でない事
  • configDecs中にdexcs指定フォルダを定義しておき、指定したフォルダ下にSWAKというフォルダとtemplateというフォルダを作成。SWAKフォルダ下にpyDexcsSwak.py という空ファイルを作成。templateフォルダ下には、dexcsという名前でOpenFOAMのケースフォルダを収納しておく。ケースフォルダの中身は、ケースファイルとして有効な内容であれば何でも良いが、FreeCADモデルがOpenFOAMのケースフォルダでない場所でメッシュ作成する際の雛形フォルダとして使われることになる。

(タイトル)未定(副題)DEXCS for OpenFOAM の使い方

このページは、いずれ書籍化する予定で作成中のものですが、途中まで書きかけてサイズが大きくなり読みにくくなってしまったので、特設ページにて各章ごとに分割作成することとしました。




また、

  • 書籍のタイトルが未定
  • 出版元も未定(自費出版でも良いか・・・)

なので、これは!というのがあれば、またもちろん、

  • 内容に対するご意見・ご要望も

お寄せ下さい。