Chọn một cấu trúc mà bạn có thể giải thích
Hãy tạo một thư mục mang tên dự án, rồi vài vị trí với vai trò rõ ràng. Tên một người hay ngày hôm nay không phải lúc nào cũng đủ để hiểu nội dung sau sáu tuần. Một ghi chú đặt ở thư mục gốc phải giải thích đâu là đầu vào, các lần thử đang tiến hành và bản bàn giao được chọn.
Đại học Cambridge khuyến nghị thống nhất sớm cách phân loại và quy tắc đặt tên nhất quán. Mô hình dưới đây là một đề xuất của BriefGPU cho một buổi làm việc nhỏ. Hãy điều chỉnh nếu phần mềm của bạn đã áp đặt sẵn một cấu trúc dự án; đừng di chuyển các tài nguyên liên kết của nó mà không kiểm tra rằng dự án vẫn tìm thấy chúng.
| Emplacement proposé | Ce qu’il contient | Règle de travail |
|---|---|---|
| 00_lire-moi.txt | Mục tiêu, sơ đồ thư mục và lần thử được chọn. | Cập nhật những quyết định hữu ích. |
| 01_entrees | Nguồn nhận được và các phiên bản đã nhận diện. | Không lưu kết quả xử lý vào đây. |
| 02_reglages | Tham số và phiên bản công cụ theo từng lần thử. | Giữ lại các cài đặt thực sự đã dùng. |
| 03_sorties/essai-01 | Kết quả của một lần chạy đã được nhận diện. | Tạo một thư mục khác cho lần thử tiếp theo. |
| 04_suivi | Bảng kê, nhật ký và phản hồi xác nhận. | Liên kết mỗi kết quả với nguồn của nó. |
| 05_livraison/v01 | Tuyển chọn sẵn sàng để bàn giao. | Nhận diện mọi phiên bản bàn giao mới. |
Giữ cho đầu vào nhận được luôn dễ nhận ra
Trước lần xử lý đầu tiên, hãy lập danh sách các nguồn với tên gốc và vị trí của chúng. Giữ một bản nguyên vẹn của các đầu vào này, như Cornell khuyến nghị đối với dữ liệu thô. Chỉ cái tên « bản gốc » không bảo vệ được nội dung: hãy chỉ cho phần mềm một thư mục đầu ra khác và kiểm tra hành vi của nó trên một tệp thử.
Nếu bạn phải chuyển đổi hoặc cắt lại một đầu vào trước khi tính toán, hãy coi bước chuẩn bị này như một giai đoạn đã được nhận diện. Giữ liên kết với nguồn đã nhận. Khi đó bạn có thể phân biệt một lỗi vốn đã có sẵn, một vấn đề ở khâu chuẩn bị và một tác động của quá trình xử lý GPU.
Khi một nguồn mới thay thế nguồn cũ, hãy ghi lại phiên bản và các kết quả cần xem lại. Đừng ghi đè âm thầm một tệp đang được dùng bởi một lần thử mà bạn muốn hiểu rõ. Nguyên tắc là giữ lại nguồn gốc hữu ích, chứ không phải giữ mãi mọi bản sao làm việc.
Đặt mã định danh ổn định cho mỗi đơn vị công việc
Một mã định danh ngắn như image-001 giúp theo dõi cùng một đầu vào qua nhiều lần thử. Vai trò của nó không đổi khi một kết quả được chấp nhận. Hãy giữ trạng thái xác nhận trong bảng kê thay vì liên tục đổi tên tệp theo « tốt », « kém » hay « gần-xong ».
Với một trăm đầu vào, các số từ 001 đến 100 cho một mốc đều đặn. Hãy thêm một tham chiếu nghiệp vụ khi cần cho việc bàn giao. Đừng cho rằng hai tệp cùng tên photo.png, nhận được trong hai thư mục con khác nhau, là cùng một thứ. Đường dẫn đầy đủ của đầu vào phải luôn gắn với mã định danh.
Hãy chọn những tên tương thích với các công cụ đích. Windows đặc biệt dành riêng các ký tự dấu hai chấm, dấu hỏi và dấu hoa thị; các quy tắc thông thường của nó cũng không cho phép phân biệt chắc chắn hai tên chỉ bằng chữ viết hoa. Một tên như image-007_essai-02.png tránh được những nhập nhằng này. Hãy kiểm tra các ràng buộc riêng của những công cụ khác của bạn thay vì hứa hẹn một sự tương thích phổ quát.
Ví dụ: hai lần thử, một bộ sưu tập nguồn duy nhất
Giả sử có tám hình ảnh nhận được trong hai thư mục. Bản kiểm kê gán image-001 đến image-008 và giữ nguyên đường dẫn gốc của chúng. Lần chạy đầu tiên dùng cài đặt essai-01; mọi kết quả đầu ra của nó đều vào thư mục tương ứng. Một lỗi ở image-003 và image-006 dẫn đến lần chạy thử thứ hai chỉ giới hạn ở hai mục này.
Sáu kết quả đạt yêu cầu của lần chạy đầu tiên không được tính lại để làm thư mục đồng nhất hơn. Bản kiểm kê cho biết kết quả nào đã được chọn cho mỗi mục. Bản giao v01 chứa tám tệp với tên như mong đợi, dù nguồn gốc của chúng nằm ở hai lần chạy thử. Ví dụ này mô tả một cách tổ chức, không ngụ ý rằng cài đặt nhất thiết cải thiện kết quả.
| Entrée | Sortie retenue dans l’exemple | Réglages à retrouver | État |
|---|---|---|---|
| image-001 | 03_sorties/essai-01/image-001.png | 02_reglages/essai-01.txt | Đã chấp nhận |
| image-003 | 03_sorties/essai-02/image-003.png | 02_reglages/essai-02.txt | Được chấp nhận sau khi làm lại |
| image-006 | 03_sorties/essai-02/image-006.png | 02_reglages/essai-02.txt | Được chấp nhận sau khi làm lại |
Giữ lại cài đặt tại thời điểm chạy thử
Một tệp tên essai-02.txt có thể chỉ là ghi chú đơn giản nếu phần mềm không xuất được tham số. Hãy ghi phiên bản công cụ, mô hình nếu có, các mục đầu vào liên quan và giá trị bạn đã chọn. Thêm lý do thay đổi so với lần chạy thử trước. Ảnh chụp màn hình có thể bổ sung cho ghi chú khi các tham số chỉ hiển thị trong một cửa sổ.
Tránh dùng một ghi chú duy nhất kiểu "cài đặt hiện tại" rồi thay thế sau mỗi lần chạy. Nó giải thích được lần thử cuối cùng, nhưng không còn giải thích được các kết quả cũ. Nếu nhiều lần chạy thử dùng cùng tham số, hãy tham chiếu đến cùng một cấu hình đã được nhận diện thay vì sao chép lại một cách thừa thãi.
Phiên bản phần mềm và các tham số giúp giải thích một kết quả; chúng không tự đảm bảo tái tạo giống hệt. Một số ứng dụng yêu cầu thông tin hoặc tài nguyên khác. Hãy làm theo tài liệu của chúng cho một nhu cầu làm lại chính xác, đặc biệt khi đó là trạng thái huấn luyện.
Ghi nhật ký giải thích các quyết định
Nhật ký bổ sung cho bản kiểm kê. Bản kiểm kê trả lời "mục này đang ở đâu?"; nhật ký trả lời "vì sao chúng ta đã thay đổi?". Chỉ vài dòng có ngày tháng là đủ: lần chạy thử liên quan, quan sát, quyết định và lần kiểm tra tiếp theo. Tránh sao chép lại từng thông báo của phần mềm nếu không ai có thể dùng đến.
Với ví dụ này, một dòng hữu ích sẽ là: "essai-01: đường viền chưa hoàn chỉnh trên image-003 và image-006; làm lại hai mục này với cài đặt B; giữ các kết quả khác chờ xác nhận cuối cùng." Sau khi xem xét, hãy thêm quyết định thực tế. Đừng viết lại quan sát ban đầu như thể lỗi chưa từng tồn tại.
Hãy đọc lại nhật ký kỹ thuật trước khi chuyển đi: chúng có thể chứa đường dẫn riêng tư hoặc cách truy cập. Giữ các thông tin bí mật tách khỏi thư mục tài liệu. Ghi chú dành cho đồng nghiệp phải giải thích công việc bằng những thông tin mà họ cần.
Phân biệt lưu trữ, bàn giao và sao lưu
Thư mục làm việc lưu giữ các lần chạy thử cần cho lý luận của bạn. Thư mục bàn giao tập hợp những gì người nhận phải nhận. Bản sao lưu lưu giữ các yếu tố cần thiết ở một đích khác, kèm kiểm tra sao chép. Ba thư mục đặt cạnh nhau trên cùng một không gian không tự mình đảm nhiệm được ba chức năng này.
Đừng sao chép toàn bộ nguồn vào mỗi thư mục chạy thử. Hãy liên kết kết quả với đầu vào qua bản kiểm kê. Đối với bàn giao, một bản sao được chọn lọc có thể hữu ích để trao một bộ hoàn chỉnh độc lập; khi đó hãy ghi lại nguồn gốc và phiên bản. Đối với sao lưu, hãy theo hướng dẫn riêng, trong đó trình bày chi tiết bản kiểm kê và việc kiểm tra sau khi truyền.
Trước khi dọn các biến thể bị loại, hãy kiểm tra xem những biến thể nào vẫn cần thiết để giải thích một quyết định hoặc làm lại công việc. Cách tổ chức này không áp đặt bất kỳ thời hạn lưu giữ nào. Nó cho phép quyết định điều gì đáng giữ lại, rồi tìm lại bản sao để tham chiếu.
Thực hiện kiểm tra từ một kết quả được chọn ngẫu nhiên
Chọn một tệp bàn giao mà không mở phần mềm của bạn trước. Từ tên tệp và bản kiểm kê, hãy tìm lại đầu vào của nó, lần chạy thử đã tạo ra nó, các cài đặt và quyết định chấp nhận. Lặp lại với một kết quả đã phải làm lại. Nếu việc tra cứu phụ thuộc vào trí nhớ của bạn, thì đang thiếu một liên kết trong khâu theo dõi.
Sau đó, hãy kiểm tra số lượng: số lượng đầu vào dự kiến, kết quả được giữ lại, các mục bị chặn và các biến thể bị loại trừ. Một thư mục gọn gàng vẫn có thể chưa đầy đủ. Bước kiểm tra nhỏ này hoàn tất khi các sai lệch đều có lý do và người khác có thể hiểu được cần dùng những tệp nào.