Выберите структуру, которую сможете объяснить
Создайте папку с названием проекта, а затем несколько мест с ясными ролями. Имени человека или сегодняшней даты не всегда достаточно, чтобы понять содержимое через шесть недель. Заметка в корне должна объяснять, где находятся исходники, текущие попытки и выбранная поставка.
Кембриджский университет рекомендует заранее договориться о классификации и единообразных правилах именования. Приведённая ниже модель — предложение BriefGPU для небольшого сеанса. Адаптируйте её, если ваше программное обеспечение уже задаёт структуру проекта; не перемещайте связанные с ним ресурсы, не проверив, что проект их находит.
| Emplacement proposé | Ce qu’il contient | Règle de travail |
|---|---|---|
| 00_lire-moi.txt | Цель, план папок и выбранная попытка. | Обновляйте полезные решения. |
| 01_entrees | Полученные источники и идентифицированные версии. | Не сохраняйте здесь результаты обработки. |
| 02_reglages | Параметры и версии инструментов по попыткам. | Сохраняйте фактически использованные настройки. |
| 03_sorties/essai-01 | Результаты конкретного запуска. | Создайте другую папку для следующей попытки. |
| 04_suivi | Опись, журнал и отзывы о проверке. | Связывайте каждый результат с его источником. |
| 05_livraison/v01 | Подборка, готовая к передаче. | Определяйте любую новую версию поставки. |
Сохраняйте полученный исходник узнаваемым
Перед первой обработкой составьте список источников с их исходным именем и местоположением. Сохраните неизменную версию этих исходников, как рекомендует Корнеллский университет для необработанных данных. Простое название «оригиналы» не защищает содержимое: укажите программе другую папку вывода и проверьте её поведение на пробном файле.
Если перед вычислением нужно преобразовать или обрезать исходник, рассматривайте эту подготовку как отдельный этап. Сохраняйте связь с полученным источником. Тогда вы сможете отличить уже имевшийся дефект, проблему подготовки и эффект обработки на GPU.
Когда новый источник заменяет старый, отметьте версию и результаты, которые нужно пересмотреть. Не перезаписывайте молча файл, использованный в попытке, которую вы хотите понять. Правило — сохранять полезное происхождение, а не хранить бесконечно все рабочие копии.
Присвойте каждой единице работы стабильный идентификатор
Короткий идентификатор вроде image-001 помогает отслеживать один и тот же исходник в нескольких попытках. Его роль не меняется, когда результат принят. Храните статус проверки в описи, а не переименовывайте файлы без конца в «хороший», «плохой» или «почти-финальный».
Для ста исходников номера от 001 до 100 дают ровный ориентир. Добавьте рабочую ссылку, когда она нужна для поставки. Не предполагайте, что два файла с именем photo.png, полученные в двух разных подпапках, означают одно и то же. Полный путь исходника должен оставаться связанным с идентификатором.
Выбирайте имена, совместимые с целевыми инструментами. В Windows, в частности, зарезервированы двоеточие, вопросительный знак и звёздочка; её обычные правила также не позволяют надёжно различать два имени только по заглавной букве. Имя вроде image-007_essai-02.png позволяет избежать этих неоднозначностей. Проверяйте ограничения, свойственные другим вашим инструментам, а не обещайте универсальную совместимость.
Пример: две попытки, одна коллекция источников
Предположим, получено восемь изображений в двух папках. Опись присваивает им имена от image-001 до image-008 и сохраняет их исходные пути. Первый проход использует настройки essai-01; все его результаты попадают в соответствующую папку. Дефект на image-003 и image-006 приводит ко второму проходу, ограниченному только этими двумя записями.
Шесть удачных результатов первого прохода не пересчитываются ради единообразия папки. Опись указывает, какой результат был принят для каждой записи. Поставка v01 содержит восемь файлов с ожидаемыми именами, даже если их происхождение распределяется между двумя проходами. Этот пример описывает организацию, не предполагая, что настройки обязательно улучшают результаты.
| 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 | Принято |
| image-003 | 03_sorties/essai-02/image-003.png | 02_reglages/essai-02.txt | Принято после доработки |
| image-006 | 03_sorties/essai-02/image-006.png | 02_reglages/essai-02.txt | Принято после доработки |
Сохраняйте настройки на момент прохода
Файл с именем essai-02.txt может быть простой заметкой, если программа не умеет экспортировать свои параметры. Запишите версию инструмента, использованную модель, затронутые записи и выбранные вами значения. Добавьте причину изменения по сравнению с предыдущим проходом. Заметку может дополнить снимок экрана, когда параметры видны только в окне.
Избегайте единственной заметки «текущие настройки», которую вы заменяете после каждого прохода. Она объяснит последнюю попытку, но уже не прежние результаты. Если несколько проходов используют одни и те же параметры, ссылайтесь на одну и ту же обозначенную конфигурацию, а не переписывайте её без пользы.
Версия программы и параметры облегчают объяснение результата; сами по себе они не гарантируют точного воспроизведения. Некоторые приложения требуют других сведений или ресурсов. Следуйте их документации, когда нужно точное воспроизведение, особенно если речь идёт о состоянии обучения.
Ведите журнал, который объясняет решения
Журнал дополняет опись. Опись отвечает на вопрос «на каком этапе эта запись?»; журнал отвечает на вопрос «почему мы изменили?». Достаточно нескольких строк с датами: затронутый проход, наблюдение, решение и следующая проверка. Не переписывайте каждое сообщение программы, если им всё равно никто не сможет воспользоваться.
Для примера полезная строка выглядела бы так: «essai-01: неполные контуры на image-003 и image-006; переделать эти две записи с настройкой B; остальные результаты оставить в ожидании финальной проверки». После просмотра добавьте фактическое решение. Не переписывайте первоначальное наблюдение так, будто дефекта никогда не было.
Перечитывайте технические журналы перед передачей: в них могут быть личные пути или способы доступа. Держите секреты отдельно от папки с документами. Заметка, предназначенная коллеге, должна объяснять работу с теми сведениями, которые ему нужны.
Различайте хранение, поставку и резервную копию
Рабочая папка хранит проходы, полезные для ваших рассуждений. Папка поставки собирает то, что должен получить адресат. Резервная копия хранит нужные элементы в другом месте с проверкой копирования. Три папки, расположенные рядом в одном и том же пространстве, сами по себе не выполняют эти три функции.
Не копируйте все исходники в каждую папку прохода. Связывайте результаты с записями через опись. Для поставки может пригодиться отобранная копия, чтобы передать самодостаточный набор; тогда укажите её происхождение и версию. Для резервной копии следуйте отдельному руководству, где подробно описаны опись и проверка после переноса.
Прежде чем удалять отброшенные варианты, проверьте те, что ещё нужны для объяснения решения или повторного выполнения работы. Эта организация не устанавливает никакого срока хранения. Она позволяет решить, что стоит сохранить, а затем найти копию, которая служит ориентиром.
Проведите проверку по случайно выбранному результату
Выберите файл поставки, не открывая сначала вашу программу. По его имени и описи найдите его запись, проход, который его создал, его настройки и решение о приёме. Повторите с результатом, который потребовал доработки. Если поиск зависит от вашей памяти, значит, в отслеживании не хватает звена.
Затем проверьте количества: число предусмотренных входных данных, отобранных результатов, заблокированных элементов и исключённых вариантов. Даже аккуратно упорядоченная папка может быть неполной. Эта небольшая проверка завершена, когда у расхождений есть причина и кто-то другой может понять, какие файлы использовать.