エラーメッセージ一覧¶

このページは，FrontISTR が出力する代表的なエラーメッセージをカテゴリ別に整理し，原因と対処の方向性を示す参照表である．すべての内部メッセージを網羅するものではなく，hecmw_part1 と fistr1 を利用する際に遭遇しやすいメッセージを中心に扱う．

メッセージが表示された場合は，まずコードの有無とプレフィックスを確認し，次に該当するカテゴリの表で入力ファイル，メッシュ，要素，ソルバ，接触，収束，メモリのどれを見直すべきかを切り分ける．

メッセージの読み方¶

FrontISTR のメッセージには，HEC-MW ライブラリ由来のコード付きメッセージと，fistr1 本体が直接出力するコードなしメッセージがある．コード付きメッセージでは，プレフィックスから出力元のモジュールと重要度を読み取れる．

形式	例	読み方
HECMW-XXX-EYYYY	HECMW-IO-E1014	HEC-MW ライブラリ由来のエラーである．XXX はサブモジュール，E は Error，YYYY は番号を表す．
HECMW-XXX-WYYYY	HECMW-PART-W0401	HEC-MW ライブラリ由来の警告である．W は Warning を表す．
コードなし	`Number of substeps reached max number`	主に `fistr1` 本体が `STOP`，`call hecmw_abort`，`write(,)` などで出力する．

メッセージの末尾に表示される数値や文字列は，ファイル名，材料番号，要素番号，サブステップ番号，内部フラグなどの実行時情報である場合がある．同じ代表メッセージでも末尾の値は解析ケースごとに変わる．

入力解釈エラー¶

入力解釈エラーは，制御ファイル，メッシュデータ，材料定義，リスタート指定などを読み込む段階で発生する．この種のエラーでは，直前に読み込まれていたファイル名，キーワード名，材料名，グループ名を確認する．

メッセージまたはコード	主な原因	対処の方向性
`Cannot open FSTR control file`	制御ファイル，または `!INCLUDE` で指定した入力ファイルを開けない．	実行ディレクトリ，ファイル名，相対パス，アクセス権を確認する．
`material property not defined!`	解析で参照する材料が `!MATERIAL` として定義されていない．	`!SECTION` が参照する材料名と，制御ファイルまたはメッシュデータ内の `!MATERIAL` 名を揃える．
`Error in material property definition!`	材料 ID または材料定義数と参照関係が一致していない．	材料番号，材料定義数，`!SECTION` からの参照を確認する．
`ERROR: Material type not supported`	材料キーワードで未対応の `TYPE` を指定している．	`!ELASTIC`，`!HYPERELASTIC`，`!PLASTIC`，`!VISCOELASTIC` の対応する `TYPE` を確認する．
`We cannot deal with incompressible material currently`	Poisson 比 0.5 の完全非圧縮材料を指定している．	Poisson 比を 0.5 未満に変更し，必要に応じて要素定式化を見直す．
`Mohr-Coulomb and Drucker-Prager do not support temperature dependency`	Mohr-Coulomb または Drucker-Prager で温度依存テーブルを指定している．	温度依存を使わない定義にするか，温度依存に対応する材料モデルを選ぶ．
`Multilinear hardening: Error in plastic strain definition`	多直線硬化の塑性ひずみが単調に定義されていない．	最初の塑性ひずみを 0 とし，塑性ひずみが増加するようにテーブルを修正する．
HECMW-IO-E1012 `Element doesn't have section`	要素に対応するセクション情報がない．	`!SECTION` の要素グループ指定とメッシュ内の要素グループを確認する．
HECMW-IO-E1013 `Cannot set section`	セクションを要素へ割り当てられない．	セクション種別，材料名，要素グループ名の整合を確認する．
HECMW-IO-E1014 `No nodes defined`	節点定義がない．	メッシュデータの節点ブロックが存在するか確認する．
HECMW-IO-E1015 `No elements defined`	要素定義がない．	メッシュデータの要素ブロックが存在するか確認する．
HECMW-UTIL-E0040 `!RESTART: Invalid token in control file`	`!RESTART` の構文が不正である．	`!RESTART` 行の区切り，パラメータ名，値を確認する．
HECMW-UTIL-E0041 `!RESTART: Missing NAME`	`!RESTART` に `NAME` がない．	リスタートデータ名を指定する．
HECMW-UTIL-E0042 `!RESTART: Missing IO`	`!RESTART` に `IO` がない．	読込・書出しの指定を追加する．

メッシュ・要素エラー¶

メッシュ・要素エラーは，要素タイプと機能の組合せ，参照節点，局所座標系，接触面の要素種別が不適切な場合に発生する．入力構文だけでなく，要素形状の品質や節点順序も確認する．

メッセージ	主な原因	対処の方向性
`##Error: This element type is not supported in contact analysis !!!`	接触解析で未対応の要素タイプを接触面に指定している．	接触面に使用する要素タイプとサーフェス定義を見直す．高次要素や特殊要素を接触面に使っていないか確認する．
`Bad reference for beam element!`	梁要素の参照節点または参照方向が不正である．	梁要素の参照節点，局所座標系，節点の重なりを確認する．
`Fail to setup local coordinate`	要素の局所座標系を構成できない．	要素形状のつぶれ，節点順序，重複節点，参照座標系を確認する．

局所座標系の設定失敗は，入力値だけでなくメッシュ品質にも依存する．特に極端に小さい要素，面積や体積が 0 に近い要素，節点順序が反転している要素がないかを確認する．

ソルバ関連エラー¶

ソルバ関連エラーは，線形ソルバ設定の不正，直接法の分解失敗，行列の特異性，外部ライブラリ未リンクなどで発生する．解析が停止した時点の直前ログに，反復法，直接法，接触自由度，MPC などの情報が出力されていないか確認する．

メッセージ	主な原因	対処の方向性
`ERROR ordering option for direct solver out of range`	直接法のオーダリング指定が範囲外である．	`!SOLVER` の直接法オーダリング設定を確認する．
`ERROR in symb. fact. flag: Should be 1 or 0`	記号分解フラグが 0 または 1 以外である．	直接法内部フラグの指定値を確認する．通常はユーザ入力で直接変更しない設定である．
`ERROR in numer. fact. flag: Should be 1 or 0`	数値分解フラグが 0 または 1 以外である．	直接法内部フラグの指定値を確認する．
`ERROR in nufct0. ir =`	直接法の数値分解に失敗している．	拘束不足，剛体モード，材料定数の異常値，接触条件，MPC 条件を確認する．
`error in nusol0. irr =`	直接法の逆代入に失敗している．	数値分解失敗時と同様に，線形系が特異または不整合になっていないか確認する．
`METIS not available`	METIS を利用するオーダリングを指定しているが，METIS 対応でビルドされていない．	METIS を使わない設定に変更するか，METIS 対応で再ビルドする．依存ライブラリは必須・オプション依存ライブラリを参照する．

直接法の分解失敗は，単にソルバ設定だけでなく，モデルの剛体運動，拘束不足，重複拘束，極端な材料定数，接触の不整合によっても起こる．拘束条件と荷重条件を簡単なケースに戻し，最小構成で線形系が解けるか確認すると原因を切り分けやすい．

接触解析エラー¶

接触解析エラーは，接触ペアとサーフェスグループの対応不整合，接触探索時の幾何的な特異性，サーフェス要素タイプの不一致，接触探索用メモリ不足で発生する．接触エラーでは，スレーブ側とマスター側のグループ名，接触面の要素タイプ，初期貫通，接触面の法線方向を確認する．

メッセージ	主な原因	対処の方向性
`Inconsistence in contact and surface definition`	`!CONTACT` または `!EMBED` が参照するサーフェスグループや接触ペアが不整合である．	接触ペア名，サーフェスグループ名，節点・面グループの存在を確認する．
`error in contact state`	接触状態データが有効な接触面を参照していない．	接触面定義，初期接触状態，接触ペアの有効化ステップを確認する．
`Math error in contact searching`	接触点の射影計算で特異な状態になっている．	接触面の形状，節点配置，初期貫通，極端な変形を確認する．
`Error in calculate DispIncreMatrix`	接触面上の変位増分行列を計算できない．	接触面の要素形状がつぶれていないか，節点順序が正しいか確認する．
`Error: cal_node_normal: invalid isin` / `Error: cal_node_normal: invalid isin_n`	節点法線計算で，節点が想定される接触面位置にない．	サーフェス定義，接触面の向き，スレーブ・マスターの指定を確認する．
`type of surface element not defined`	サーフェス要素タイプを特定できない．	接触面として指定した要素タイプと面番号を確認する．
`Allocation error: bktdb%buckets`	接触探索用バケット配列のメモリ確保に失敗している．	接触面数，メッシュ密度，領域分割数，利用可能メモリを見直す．

接触関連のエラーが入力直後に出る場合は，接触ペアやサーフェスグループの名前不一致が主な候補である．非線形反復の途中で出る場合は，変形により接触面が著しくゆがむ，初期貫通が大きすぎる，または時間増分が大きすぎる可能性がある．

接触タイプや接触アルゴリズムの選び方は，接触・埋め込みを参照する．

収束・カットバックエラー¶

収束・カットバックエラーは，非線形静解析でサブステップを進められない場合に発生する．接触の開始・離脱，降伏の急進展，大変形，拘束条件の不整合，荷重増分の過大設定が主な原因になる．

メッセージ	主な原因	対処の方向性
`Number of successive cutback reached max number`	収束失敗によりカットバックを繰り返し，連続失敗回数の上限に達した．	初期時間増分を小さくする．`AUTOINC_PARAM` のカットバック縮小率や連続失敗上限を見直す．接触・材料・境界条件の妥当性を確認する．
`Number of substeps reached max number`	ステップ終了前にサブステップ数の上限に達した．	`SUBSTEPS` を増やす．荷重・時間増分を小さくする．非線形性が急変する時刻で出力時刻やステップ分割を追加する．

収束失敗時は，ソルバの最大反復回数だけを増やしても根本原因が解消しない場合がある．荷重を段階化し，接触条件や材料非線形を単純化したケースで再現性を確認すると，原因を切り分けやすい．

境界条件エラー¶

境界条件エラーは，制御ファイル上の指定が機能上の制約に合わない場合に発生する．回転境界条件では，変位拘束と同じ感覚で総量指定を使うとエラーになる．

メッセージ	主な原因	対処の方向性
`Error: rotational boundary cannot be specified with total value`	回転拘束に総量指定（`TOTAL=YES`）を指定している．	回転拘束では増分指定を用いる．境界条件の定義を `TOTAL=YES` なしに変更する．
`fstr control file error : !BOUNDARY : rotational boundary cannot be specified with total value`	制御ファイル読込段階で同じ制約違反を検出している．	`!BOUNDARY` の回転拘束行と `TOTAL` 指定を確認する．

回転拘束や回転荷重は，要素種別と自由度構成にも依存する．梁・シェルなど回転自由度を持つ要素を使う場合は，境界条件の自由度番号と対象節点グループを併せて確認する．

領域分割（hecmw_part1）エラー¶

hecmw_part1 のエラーは，HECMW-PART で始まるコードとして出力される．領域分割では，入力ファイルの有無，!PARTITION の必須パラメータ，分割手法と領域数の制約，ユーザ指定 part ファイルの整合性を順に確認する．

コード範囲または代表コード	主な原因	対処の方向性
HECMW-PART-E0001〜E0006	ファイル操作，ファイル名，EOF，引数に関する基本エラーである．	指定ファイルの存在，ファイル名長，入力ファイルの終端，コマンド引数を確認する．
HECMW-PART-E0101	制御ファイル内に無効なトークンがある．	`!PARTITION` 行と分割方向指定行の構文を確認する．
HECMW-PART-E0111 `'TYPE' must not be omitted`	`TYPE` が指定されていない．	`!PARTITION, TYPE=NODE-BASED` など，分割タイプを指定する．
HECMW-PART-E0121 `'METHOD' must not be omitted`	`METHOD` が指定されていない．	`METHOD=RCB`，`METHOD=PMETIS`，`METHOD=KMETIS` などを指定する．
HECMW-PART-E0131 `'DOMAIN' must not be omitted`	領域数が指定されていない．	`DOMAIN` に MPI プロセス数に対応する自然数を指定する．
HECMW-PART-E0134 `'METHOD' is 'RCB', but 'DOMAIN' is not n-th power of 2`	RCB 法で領域数が \(2^n\) ではない．	RCB を使う場合は領域数を \(2^n\) にする．任意の領域数が必要な場合は METIS 系を検討する．
HECMW-PART-E0201〜E0206	分割タイプ，分割手法，要素タイプ，分割方向，領域数，オーバーラップ深さが不正である．	`TYPE`，`METHOD`，`DOMAIN`，`DEPTH`，分割方向指定を確認する．
HECMW-PART-E0301〜E0331	分割後データ中の領域番号，節点数，要素数，隣接領域数が範囲外である．	入力メッシュ，ユーザ指定 part ファイル，分割数の整合性を確認する．
HECMW-PART-E0601〜E0606	ユーザ指定 part ファイルに空領域，形式不正，節点数・要素数・領域数の不一致がある．	part ファイルの形式とメッシュとの整合性を確認する．
HECMW-PART-W0401 `EQUATION_BLOCK not found`	`EQUATION_BLOCK` が見つからない警告である．	MPC を使う解析で必要な場合は該当ブロックを確認する．不要な場合は継続可能である．
HECMW-PART-W0502 `Log file for partitioner already initialized`	ログ初期化が重複して呼ばれている．	通常は警告として扱い，直後の致命的エラーの有無を確認する．

領域分割の概念と分割手法の選び方は，領域分割を参照する．並列実行の具体的な手順は実行ガイドを参照する．

メモリ確保エラー¶

メモリ確保エラーは，配列や作業領域を確保できない場合に出力される．大規模メッシュ，接触面が多いモデル，直接法，出力変数が多い解析ではメモリ使用量が増える．

メッセージ	主な原因	対処の方向性
`stop due to allocation error <FSTR_SOLID, TEMPERATURE>`	温度配列の確保に失敗している．	節点数，温度自由度，熱応力設定，利用可能メモリを確認する．
`stop due to allocation error <FSTR_SOLID, GL>`	構造解析用のグローバル配列確保に失敗している．	モデル規模，領域分割数，解析種別，出力項目を見直す．
`Allocation error: bktdb%buckets`	接触探索用バケット配列を確保できない．	接触面数，メッシュ密度，接触ペア数，領域分割を見直す．
`ALLOCATION ERROR, ...`	直接法またはオーダリング処理の作業配列を確保できない．	直接法から反復法への切替，領域分割数の調整，メモリ割当量の増加を検討する．

メモリ不足が疑われる場合は，まず直接法を反復法へ変更できるか確認する．直接法を使う必要がある場合は，モデル規模を小さくする，出力変数を減らす，領域分割数を調整する，ジョブに割り当てるメモリを増やす，などを検討する．

リスタートエラー¶

リスタートエラーは，!RESTART の構文不正，必須パラメータ不足，または読込対象ファイルと現在の解析条件の不整合で発生する．リスタートを使う場合は，書き出した解析と読み込む解析でメッシュ，領域分割数，解析種別，ステップ情報が整合している必要がある．

コード	主な原因	対処の方向性
HECMW-UTIL-E0040 `!RESTART: Invalid token in control file`	`!RESTART` 行の構文が不正である．	パラメータ名，区切り，値の形式を確認する．
HECMW-UTIL-E0041 `!RESTART: Missing NAME`	`NAME` が指定されていない．	リスタートデータ名を指定する．
HECMW-UTIL-E0042 `!RESTART: Missing IO`	`IO` が指定されていない．	読込・書出しの指定を追加する．

リスタート読込に失敗する場合は，リスタートファイル名だけでなく，書出時と読込時のメッシュ，MPI 領域数，ステップ設定，リスタートバージョンを確認する．リスタート機能の概要は，出力・リスタートを参照する．