インクルードファイルの欠落

主に2つの理由がある。第一に、モデルのモジュール化だ。例えば、複数の解析で共通して使う材料特性（例えば、JIS G 3101 SS400のヤング率

ほとんどがプレーンテキストだ。Abaqusの .inp ファイルに `*INCLUDE` ディレクティブで参照されるファイルや、LS-DYNAのキーファイルに埋め込まれる `*INCLUDE` 節で指定するファイルは、いずれもASCII形式。ただし、Ansys Mechanical APDLがバイナリ結果ファイルをインクルードする `*VREAD` のような特殊なケースもあるが、それは稀だ。

概念的にはそれで正しい。ソルバーがメインの入力ファイルを読み込み、`*INCLUDE` などのディレクティブに遭遇すると、指定されたパスのファイルを読み込み、その内容をあたかもその場に記述されていたかのように処理する。この時、相対パスと絶対パスの解釈がエラーの原因になることが多い。

入力ファイルの「プリプロセス」段階だ。ソルバーは入力ファイルをパース（構文解析）しながら、インクルード命令を見つけ次第、そのファイルを開いて内容をメモリに展開する。例えば、Abaqus/Standardの実行プロセスは、まず `pre.exe` が .inp とインクルードファイルを全て処理して、内部データベースを作成してから、本計算の `standard.exe` が起動する。インクルードファイルが欠落していると、この `pre.exe` の段階でエラーが発生して停止する。

多くのソルバーで可能だが、深さに制限がある。LS-DYNAではデフォルトで10階層までネスト可能だ。しかし、深いネストはパス解決を複雑にし、メンテナンス性を著しく低下させる。実務では、せいぜい2階層までが良いプラクティスとされている。Ansys Mechanical APDLの `/INPUT` コマンドも同様にネストできる。

相対パス指定の場合、基準となる「カレントディレクトリ」が問題になる。メインファイルを実行したディレクトリを基準とするソルバーもあれば、各インクルードファイル自身が置かれているディレクトリを基準とする場合もある。後者の実装では、ネストされたインクルードのパス指定が直感的ではなくなる。MSC Nastranの `INCLUDE` ディレクティブは、メインファイルの位置を基準に相対パスを解決するのが一般的だ。

まず絶対に守るべきは「プロジェクトフォルダの一体化」だ。全ての入力ファイルとインクルードファイルを一つのルートフォルダ（例: `Project_2023_Bracket_Analysis`）以下に置き、サブフォルダ（`/model`, `/include`, `/results`）で整理する。そして、メインファイルからの相対パスは、常にこのルートフォルダを起点として記述する。例えば、`*INCLUDE, INPUT=./include/material.inc` のようにだ。

そのために「相対パス」が重要だ。絶対パス（`C:\Users\name\project\...` や `/home/user/project/...`）を使うと、環境が変わった瞬間に全てのパスが無効になる。プロジェクト全体をZIP圧縮して渡すか、Gitなどのバージョン管理システムで共有する。その際、`.gitignore` で結果ファイルなど巨大なバイナリを除外することを忘れるな。

いくつかの方法がある。第一に、Abaqus/CAEやAnsys Workbenchのような統合環境を使っていれば、前処理段階でファイルの関連性を管理してくれる。第二に、コマンドラインでソルバーの「エコー」や「チェックのみ」モードを使う。例えば、Abaqusで `abaqus job=jobname datacheck` を実行すると、本計算は行わず入力ファイルのチェックだけを行う。この時点でインクルード欠落エラーが検出される。

重要なプラクティスは「参照専用ファイル」と「編集用ファイル」を分けることだ。例えば、材料ライブラリ `MATLIB.inc` は読み取り専用属性に設定し、個別プロジェクトでは `*INCLUDE` で参照するだけにする。そのプロジェクト独自の修正が必要なら、`MATLIB.inc` をコピーして `my_material.inc` を作り、それを編集して参照する。これで元ファイルを壊すリスクがなくなる。

構文とオプションが異なる。Abaqusでは `*INCLUDE` ディレクティブ。Ansys Mechanical APDL（旧称ANSYS Parametric Design Language）では `/INPUT` コマンド。MSC Nastranでは `INCLUDE` ステートメントだ。より重要なのは、パス指定の扱い。Abaqusの `*INCLUDE` は、メインファイルの位置からの相対パスを解釈する。一方、APDLの `/INPUT` は、コマンドを実行する時の「カレントディレクトリ」が基準になるので、バッチ実行時のディレクトリに注意が必要だ。

その通り、COMSOLのネイティブ形式である.mphファイルはバイナリ形式で、モデル設定、メッシュ、結果まで全てを一つのファイルにパッケージ化する。ただし、外部ファイルを参照する機能はある。例えば、「外部材料データ」としてCSVファイルを読み込んだり、「LiveLink™ for MATLAB®」を使って.mファイルからモデルを制御する場合だ。この場合、.mphファイルを移動する時は、参照先のCSVや.mファイルも一緒に移動する必要があり、これがインクルード欠落に似た問題を引き起こす。

OpenFOAMは「ケースディレクトリ」構造が全てだ。`0/`, `constant/`, `system/` というディレクトリに設定ファイルが分散しており、`#include` というC++プリプロセッサと同様の文法でファイルをインクルードする。例えば、乱流モデルの設定を `constant/turbulenceProperties` で `#include "RAS/kEpsilon"` のようにする。パスは常にケースディレクトリが基準になる。ファイルが欠落すると、`FOAM FATAL ERROR` として明確に報告される。

エラーメッセージを一字一句読むことだ。どのソルバーが、どのファイルを、どのディレクトリから探したのかが書かれている。例えば、「Abaqus Error: The following file(s) could not be located: ./sub/model_part.inp」とあれば、メイン.inpファイルがある場所からの相対パス `./sub/` に `model_part.inp` がない。まず、そのパスにファイルが実在するかエクスプローラーやターミナルで確認する。スペルミス（`modul` と `model`）や大文字小文字の区別（Linux環境では重要）も要チェックだ。

最も多いのは「ファイルパーミッション」と「ファイルパスにスペースや日本語が含まれている」ケースだ。特にLinuxクラスタで計算する場合、インクルードファイルの読み取り権限がユーザーにないとエラーになる。`chmod 644 include_file.inc` で権限を変更しよう。また、パスにスペース（`My Project`）や日本語（`解析モデル`）が含まれていると、ソルバーがパスを正しく解釈できないことがある。アンダースコア（`My_Project`）や英数字のみの名前に変更するのが確実だ。

ネットワークの遅延やタイムアウト、あるいはバッチジョブを投入する計算サーバーからそのネットワークドライブが見えていないことが原因だ。HPC環境では、ジョブスクリプト内で、必要なインクルードファイルを計算ノードのローカルストレージ（`$TMPDIR` や `$SCRATCH`）にコピーする処理を記述する。あるいは、プロジェクト全体をネットワークドライブからローカルドライブに移して実行する。これが、CAEベンダーが「ローカルパスを推奨する」理由の一つだ。

それは「キャッシュ」の問題だ。Ansys WorkbenchやAbaqus/CAEは、パフォーマンス向上のため、一度読み込んだ外部ファイルをキャッシュすることがある。Workbenchなら、「Refresh」ボタンや「Update Project」を実行する。Abaqus/CAEで .inp を編集して再実行する場合は、CAEを一旦閉じてコマンドラインから `abaqus job=...` で実行するか、CAE内でジョブを削除して再作成すると、キャッシュがクリアされる。根本的には、統合環境ではなくテキストエディタで入力ファイルを管理する方が、こうした混乱は少ない。