Fortran di Maguyva: graf kode untuk basis kode ilmiah

Mengapa Fortran butuh struktur, bukan pencocokan string

Basis kode Fortran biasanya tua dan besar, ditulis oleh pakar bidang, bukan tim perangkat lunak. Rutin bernama SOLVE, Solve, dan solve adalah rutin yang sama. Modul tersebar di ratusan berkas, dan pustaka prosedur intrinsik begitu besar sehingga daftar panggilan yang naif sebagian besar berisi SQRT, SUM, dan WRITE.

Agen yang hanya mengandalkan grep akan tenggelam dalam derau itu. Maguyva memberinya struktur lebih dulu: unit program apa saja yang ada, modul apa yang dipakai, dan rutin mana dalam kode Anda sendiri yang saling memanggil.

Apa yang diekstrak Maguyva dari Fortran

Maguyva mencakup sumber berformat tetap dan berformat bebas (.f, .for, .ftn, .f90, .f95, .f03, .f08). Fungsi dan subrutin diekstrak sebagai simbol yang dapat dipanggil, dan derived type dapat dipilih sebagai definisi tipe dalam pencarian struktural.

Pencocokan simbol tidak peka huruf besar-kecil, sama seperti Fortran itu sendiri. Relasi impor berasal dari pernyataan use dan include; kata kuncinya dibuang sehingga graf menyimpan nama modul. Panggilan, pembacaan, penugasan, referensi tipe, dan pewarisan dari derived type yang diperluas juga masuk ke graf.

Filter relasi membuang sekitar 165 prosedur intrinsik (pernyataan I/O serta rutin matematika, larik, string, konversi tipe, dan manipulasi bit), sehingga edge yang tersisa menunjuk ke kode Anda sendiri.

Contoh prompt agen

• “Siapa yang memanggil compute_flux, dan modul apa yang mereka gunakan?” (find_symbol, lalu dependency_search arah masuk)
• “Telusuri bagaimana syarat batas diterapkan di loop solver.” (get_task_context)
• “Temukan setiap unit program yang menggunakan modul constants.” (text_pattern_search untuk use constants, lalu find_symbol)

Batasan yang diketahui

• Fortran tidak memiliki decorator maupun penanganan eksepsi, sehingga jenis relasi tersebut ditandai tidak berlaku.
• Prosedur yang terikat tipe berbagi node yang sama dengan fungsi dan subrutin biasa. Gunakan preset functions di structural_search; preset methods tidak memilih node Fortran apa pun.
• Panggilan ke intrinsik yang difilter tidak muncul sebagai edge graf. Gunakan text_pattern_search saat Anda membutuhkan setiap WRITE atau OPEN.

Langkah berikutnya

Hubungkan repositori dengan panduan memulai cepat, lalu periksa matriks dukungan lengkap di halaman kompatibilitas. Jika Fortran Anda hidup berdampingan dengan kode binding C, baca juga panduan C.