Fortran in Maguyva: Code-Graphen für wissenschaftliche Codebasen

Warum Fortran Struktur braucht statt String-Matching

Fortran-Codebasen sind meist alt, groß und von Fachleuten der jeweiligen Domäne geschrieben, nicht von Softwareteams. Routinen namens SOLVE, Solve und solve sind dieselbe Routine. Module werden von Hunderten Dateien gemeinsam genutzt, und die Bibliothek der intrinsischen Prozeduren ist so groß, dass eine naive Aufrufliste vor allem aus SQRT, SUM und WRITE besteht.

Ein Agent, der nur grept, geht in diesem Rauschen unter. Maguyva liefert ihm zuerst die Struktur: welche Programmeinheiten es gibt, welche Module sie nutzen und welche eigenen Routinen sich gegenseitig aufrufen.

Was Maguyva in Fortran extrahiert

Maguyva deckt Quelltext in festem und freiem Format ab (.f, .for, .ftn, .f90, .f95, .f03, .f08). Funktionen und Subroutinen werden als aufrufbare Symbole extrahiert, und abgeleitete Typen lassen sich in der Struktursuche als Typdefinitionen auswählen.

Der Symbolabgleich ignoriert Groß- und Kleinschreibung, genau wie Fortran selbst. Importbeziehungen entstehen aus use und include; das Schlüsselwort wird entfernt, sodass der Graph den Modulnamen speichert. Aufrufe, Lesezugriffe, Zuweisungen, Typreferenzen und Vererbung aus erweiterten abgeleiteten Typen sind ebenfalls Teil des Graphen.

Der Beziehungsfilter entfernt rund 165 intrinsische Prozeduren (I/O-Anweisungen sowie Mathematik-, Array-, String-, Typkonvertierungs- und Bitoperations-Routinen), sodass die verbleibenden Kanten auf deinen eigenen Code zeigen.

Beispiel-Prompts für Agenten

• „Welche Subroutinen rufen compute_flux auf, und welche Module nutzen sie?“ (find_symbol, dann dependency_search incoming)
• „Verfolge, wie Randbedingungen in der Solver-Schleife angewendet werden.“ (get_task_context)
• „Finde jede Programmeinheit, die das Modul constants nutzt.“ (text_pattern_search nach use constants, dann find_symbol)

Bekannte Grenzen

• Fortran hat weder Decorators noch Ausnahmebehandlung, daher sind diese Beziehungstypen als nicht anwendbar markiert.
• Typgebundene Prozeduren teilen sich dieselben Knoten wie gewöhnliche Funktionen und Subroutinen. Nutze in structural_search das Preset functions; das Preset methods wählt keine Fortran-Knoten aus.
• Aufrufe gefilterter intrinsischer Prozeduren erscheinen nicht als Graphkanten. Verwende text_pattern_search, wenn du jedes WRITE oder OPEN brauchst.

Nächste Schritte

Verbinde ein Repository über den Schnellstart und prüfe dann die vollständige Unterstützungsmatrix auf der Kompatibilitätsseite. Wenn Fortran neben C-Glue-Code liegt, lies auch den C-Leitfaden.