Fortran i Maguyva: kodgrafer för vetenskapliga kodbaser

Varför Fortran behöver struktur, inte strängmatchning

Fortran-kodbaser är ofta gamla, stora och skrivna av domänexperter snarare än mjukvaruteam. Rutiner med namnen SOLVE, Solve och solve är samma rutin. Moduler delas av hundratals filer, och biblioteket med inbyggda procedurer är så stort att en naiv anropslista mest består av SQRT, SUM och WRITE.

En agent som bara greppar drunknar i det bruset. Maguyva ger den strukturen först: vilka programenheter som finns, vilka moduler de använder och vilka egna rutiner som anropar varandra.

Vad Maguyva extraherar i Fortran

Maguyva täcker källkod i fast och fritt format (.f, .for, .ftn, .f90, .f95, .f03, .f08). Funktioner och subrutiner extraheras som anropbara symboler, och härledda typer kan väljas som typdefinitioner i strukturell sökning.

Symbolmatchningen är skiftlägesokänslig, precis som Fortran självt. Importrelationer kommer från use och include; nyckelordet tas bort så att grafen lagrar modulnamnet. Anrop, läsningar, tilldelningar, typreferenser och arv från utökade härledda typer ingår också i grafen.

Relationsfiltret tar bort omkring 165 inbyggda procedurer (I/O-satser samt rutiner för matematik, arrayer, strängar, typkonvertering och bitoperationer), så att kanterna som blir kvar pekar på din egen kod.

Exempel på prompter för agenter

• “Vilka subrutiner anropar compute_flux, och vilka moduler använder de?” (find_symbol, sedan dependency_search incoming)
• “Spåra hur randvillkor tillämpas i lösarens loop.” (get_task_context)
• “Hitta alla programenheter som använder modulen constants.” (text_pattern_search efter use constants, sedan find_symbol)

Kända begränsningar

• Fortran har varken dekoratorer eller undantagshantering, så de relationstyperna är markerade som ej tillämpliga.
• Typbundna procedurer delar samma noder som vanliga funktioner och subrutiner. Använd förinställningen functions i structural_search; förinställningen methods väljer inga Fortran-noder.
• Anrop till filtrerade inbyggda procedurer visas inte som kanter i grafen. Använd text_pattern_search när du behöver varje WRITE eller OPEN.

Nästa steg

Anslut ett repo med snabbstarten och kontrollera sedan hela stödmatrisen på kompatibilitetssidan. Om din Fortran ligger bredvid limkod i C, läs även guiden för C.