beach-bem 1.4.0

BEACH (BEM + Accumulated CHarge): BEM surface-charging + test-particle prototype (insulator mode) with hybrid E-field and Boris pusher.

BEACH（BEM + Accumulated CHarge）

BEACH は、BEM（境界要素法）ベースの表面帯電 + テスト粒子追跡シミュレータです。 計算本体は Fortran（fpm 管理）、Python は後処理・可視化を担当します。

現行の主対象は insulator accumulation（絶縁体への電荷蓄積） です。BEM による電荷堆積とテスト粒子追跡を batch ごとに繰り返し、表面電位の時間発展を計算します。

電子ビーム照射下での絶縁体メッシュ上の電位分布の時間発展

_{3D model: Rubber Duck PBR Game Ready (TurboSquid)}

クイックスタート

必要なツール:

make --version
gfortran --version
fpm --version
python --version

通常利用では PyPI から導入します。

python -m pip install -U pip setuptools wheel
python -m pip install beach-bem

ユーザーインストール時に beach / beachx が見つからない場合は PATH を確認してください。

export PATH="$HOME/.local/bin:$PATH"

小さな設定を作って実行します。

mkdir run_periodic2
cd run_periodic2

beachx config init
beachx lint beach.toml
beachx config render
beach beach.toml
beachx inspect outputs/latest
beachx animate outputs/latest --quantity potential --save-gif potential_history.gif

開発版を直接試す場合:

python -m pip install "git+https://github.com/Nkzono99/BEACH.git"

ドキュメント

• 公開ドキュメント: GitHub Pages
• ドキュメント一覧: docs/index.md
• 実行・開発・テスト: docs/fortran_workflow.md
• 設定作成・検証: docs/config_workflow.md
• beach.toml 仕様: docs/fortran_parameter_file.md
• Python 後処理 API / CLI: docs/python_postprocess_api.md
• Fortran 実装仕様: SPEC.md

リポジトリ構成

• src/, app/: Fortran 本体
• beach/: Python 後処理ライブラリ
• examples/: 設定例・補助スクリプト
• tests/fortran/, tests/python/: テスト
• docs/: 運用ドキュメント
• schemas/: JSON Schema

開発者向け最短確認

python -m pip install -e . --no-build-isolation
make check

KUDPC のログインノードでは make test* / fpm test を直接実行せず、計算ノードへ投入してください。詳細は docs/fortran_workflow.md を参照してください。