MaguyvaのFortran対応: 科学技術コードのためのコードグラフ

Fortranに必要なのは文字列マッチではなく構造

Fortranのコードベースは、古く、大きく、ソフトウェアチームではなく分野の専門家によって書かれていることがよくあります。SOLVE、Solve、solve という名前のルーチンはすべて同じルーチンです。モジュールは数百のファイルで共有され、組み込み手続きのライブラリも大きいため、素朴な呼び出し一覧はほとんどが SQRT、SUM、WRITE で埋まります。

grepしか使わないエージェントは、このノイズに埋もれてしまいます。Maguyvaはまず構造を渡します。どのプログラム単位が存在し、どのモジュールを使い、どのユーザールーチンが互いに呼び出しているのかです。

MaguyvaがFortranで抽出するもの

Maguyvaは固定形式と自由形式のソース（.f、.for、.ftn、.f90、.f95、.f03、.f08）に対応しています。関数とサブルーチンは呼び出し可能なシンボルとして抽出され、派生型は構造検索で型定義として選択できます。

シンボルの照合はFortran自身の規則に合わせて大文字と小文字を区別しません。インポート関係は use と include から作られ、キーワードを取り除いてモジュール名をグラフに保存します。呼び出し、読み取り、代入、型参照、そして拡張された派生型からの継承もグラフに含まれます。

関係性フィルターは約165個の組み込み手続き（I/O文、数学、配列、文字列、型変換、ビット操作のルーチン）を除外するため、残るエッジはあなた自身のコードを指します。

エージェントへのプロンプト例

• 「compute_flux を呼び出すサブルーチンはどれで、それぞれどのモジュールを使っているか？」（find_symbol、次に dependency_search の incoming）
• 「ソルバーループで境界条件がどのように適用されているかを追跡して。」（get_task_context）
• 「constants モジュールを使うプログラム単位をすべて見つけて。」（text_pattern_search で use constants を検索し、次に find_symbol）

既知の制限

• Fortranにはデコレーターも例外処理もないため、それらの関係タイプは適用対象外としてマークされています。
• 型束縛手続きは、通常の関数やサブルーチンと同じノードを共有します。structural_search では functions プリセットを使ってください。methods プリセットはFortranのノードを選択しません。
• 除外された組み込み手続きへの呼び出しはグラフのエッジとして現れません。すべての WRITE や OPEN が必要なときは text_pattern_search を使ってください。

次のステップ

クイックスタートでリポジトリを接続し、互換性ページで完全な対応マトリクスを確認してください。FortranがCのグルーコードと並んでいる場合は、Cガイドもご覧ください。