Fortran trên Maguyva: đồ thị mã cho codebase khoa học

Vì sao Fortran cần cấu trúc chứ không phải so khớp chuỗi

Codebase Fortran thường cũ và lớn, do chuyên gia lĩnh vực viết chứ không phải đội phần mềm. Các routine tên SOLVE, Solve và solve là cùng một routine. Module trải rộng trên hàng trăm tệp, và thư viện thủ tục intrinsic lớn đến mức một danh sách lời gọi ngây thơ phần lớn chỉ toàn SQRT, SUM và WRITE.

Một agent chỉ dùng grep sẽ chìm trong nhiễu đó. Maguyva đưa cho agent cấu trúc trước: những đơn vị chương trình nào tồn tại, chúng dùng module nào, và routine nào trong chính mã của bạn gọi lẫn nhau.

Maguyva trích xuất gì từ Fortran

Maguyva bao phủ mã nguồn dạng cố định và dạng tự do (.f, .for, .ftn, .f90, .f95, .f03, .f08). Hàm và subroutine được trích xuất thành ký hiệu có thể gọi, và derived type có thể được chọn làm định nghĩa kiểu trong tìm kiếm cấu trúc.

So khớp ký hiệu không phân biệt chữ hoa chữ thường, giống như chính Fortran. Quan hệ nhập đến từ câu lệnh use và include; từ khóa được bỏ đi để đồ thị lưu tên module. Lời gọi, thao tác đọc, phép gán, tham chiếu kiểu và kế thừa từ derived type mở rộng cũng được đưa vào đồ thị.

Bộ lọc quan hệ loại bỏ khoảng 165 thủ tục intrinsic (câu lệnh I/O và các routine toán học, mảng, chuỗi, chuyển đổi kiểu và thao tác bit), để các cạnh còn lại trỏ vào mã của chính bạn.

Ví dụ prompt cho agent

• “Ai gọi compute_flux, và họ dùng những module nào?” (find_symbol, sau đó dependency_search theo chiều vào)
• “Lần theo cách điều kiện biên được áp dụng trong vòng lặp của bộ giải.” (get_task_context)
• “Tìm mọi đơn vị chương trình dùng module constants.” (text_pattern_search cho use constants, sau đó find_symbol)

Giới hạn đã biết

• Fortran không có decorator hay xử lý ngoại lệ, nên các loại quan hệ này được đánh dấu là không áp dụng.
• Thủ tục gắn với kiểu dùng chung nút với hàm và subroutine thông thường. Hãy dùng preset functions trong structural_search; preset methods không chọn nút Fortran nào.
• Lời gọi tới các intrinsic đã bị lọc không xuất hiện dưới dạng cạnh đồ thị. Dùng text_pattern_search khi bạn cần mọi WRITE hoặc OPEN.

Bước tiếp theo

Kết nối một kho mã bằng hướng dẫn bắt đầu nhanh, sau đó xem toàn bộ ma trận hỗ trợ trên trang tương thích. Nếu mã Fortran của bạn tồn tại cùng mã liên kết C, hãy đọc thêm hướng dẫn C.