Перейти до основного вмісту

Навчальні матеріали та архів моделі.

Більшості користувачів, які працюють з навчальними матеріалами, достатньо лише --model <path> та --image <path>. Ця сторінка призначена для запуску коду з вихідного дерева, проведення тестів і налагодження, коли потрібно контролювати, звідки беруться архіви моделей і зразки ресурсів.

Не включайте ці матеріали в початкові навчальні посібники. Вони корисні, але це не перший крок.

Перевизначення в архіві моделі.​

Використовуйте ці змінні середовища, коли локальні тести репозиторію або допоміжні скрипти потребують шляху до архіву моделі, не змінюючи кожну команду:

ЗміннаВикористання
SIMA_RESNET50_TARІндивідуальні налаштування для навчальних матеріалів і тестів, що стосуються ResNet-50.
SIMA_MODEL_TARЗагальний архів моделі, який використовується для тестів і прикладів, що базуються на моделях.
SIMA_YOLO_TARМожливість індивідуального налаштування для навчальних матеріалів і тестів, що стосуються детектування в стилі YOLO, якщо це підтримується скриптом.

У навчальних прикладах команди все ще підтримують явне використання прапорців. Для одноразового запуску краще використовувати --model <path>; якщо ж потрібно, щоб багато команд використовували один і той самий артефакт, слід використовувати змінні середовища.

sdk or devkit$export SIMA_RESNET50_TAR=/path/to/resnet_50.tar.gzexport SIMA_YOLO_TAR=/path/to/yolo_v8s.tar.gz

Поширені шляхи в структурі коду.​

Локальні тести та приклади, що використовуються в репозиторії, зазвичай шукають у папці tmp/, яка знаходиться в кореневій директорії репозиторію. Найпоширеніші шляхи до цієї папки:

РесурсЗагальний шлях до вихідного дерева
Архів моделі ResNet-50tmp/resnet_50.tar.gz
Архів моделі YOLOv8stmp/yolo_v8s.tar.gz
Зразок зображення COCOtmp/coco_sample.jpg

Встановлені навчальні матеріали також можуть запускатися з додаткової теки. У такому разі, якщо шляхи до моделі та зображення ще не вказані, передавайте їх явно, якщо вони не знаходяться в /tmp.

Елементи керування для вилучення моделі.​

Neat розпаковує архіви моделей перед їх запуском. Ці змінні в основному призначені для перевірки та керування процесом очищення під час налагодження:

ЗміннаВплив
SIMA_MPK_EXTRACT_ROOT=<dir>Встановлює базову директорію для збереження витягнутих даних моделі.
SIMA_MPK_CLEANUP_EXTRACTED=0Зберігає локальну для процесу proc_run_* папку для вилучених даних після завершення, щоб її можна було перевірити. Інші процеси не можуть автоматично виявити або повторно використовувати цю папку.
SIMA_MPK_EXTRACT_GC_STALE_PROC=0Вимикає очищення покинутих каталогів proc_run_* під час запуску на основі блокування власника.

Використовуйте їх, коли потрібно перевірити згенеровані файли конфігурації або порівняти отримані артефакти між різними запусками. Залиште налаштування за замовчуванням для звичайних навчальних вправ.

Приклади заміни зображень.​

Деякі тести, що використовують структуру вихідного коду, використовують зразок зображення COCO і можуть завантажити його, якщо він відсутній. За потреби використання локального дзеркала, змініть URL-адресу:

sdk or devkit$export SIMA_COCO_URL=https://example.com/path/to/coco_sample.jpg

Для одного запуску навчального посібника краще використовувати --image <path>. Використовуйте SIMA_COCO_URL, коли тестовий набір або завдання CI повинні отримувати дані з контрольованого розташування.

Розподіл відсутніх ресурсів.​

Якщо в інструкції відображається повідомлення SKIP: missing ... або не вдається відкрити модель:

  1. Перевірте шлях, який відображається в повідомленні.
  2. Передавайте ресурс явно, використовуючи прапорець для навчального режиму.
  3. Якщо ви запускаєте тести для SourceTree, встановіть відповідну змінну середовища.
  4. Якщо файл було завантажено з Model Zoo, перевірте назву завантаженого файлу. вкажіть у навчальному посібнику шлях до фактичного файлу .tar.gz.

Не розпаковуйте архів моделі вручну під час звичайного використання. Neat очікує шлях до скомпільованого архіву та самостійно виконує розпакування.