Pełna macierz eksportu

Kształt macierzy

Kluczem macierzy jest (family, task, format). Klucze rodzin są kanonicznymi nazwami z rejestru modeli, klucze zadań pochodzą z libreyolo.tasks.TASKS, a formatów jest dwanaście:

onnx, torchscript, executorch, tensorrt, openvino, paddle, mnn, rknn, ncnn, tflite, coreml, coreai.

model.export(format=...) przyjmuje dodatkowo dwa aliasy: engine dla tensorrt oraz litert dla tflite, czyli obecnej nazwy TensorFlow Lite. Format i sufiks .tflite pozostają bez zmian.

from libreyolo.export.support import (    EXPORT_FORMATS,    get_support,    validated_alternatives,) print(EXPORT_FORMATS) entry = get_support("yolo9", "detect", "onnx")print(entry.tier, entry.since)print(entry.constraint) print(validated_alternatives("yolo9", "detect"))

libreyolo formats --family yolo9 --task detectlibreyolo formats --family yolo9 --task detect --json

Ponieważ komórka jest funkcją trzech kluczy, pełna siatka jest duża i zmienia się w każdym wydaniu. Jest generowana, a nie pisana ręcznie, i znajduje się w docs/export_support.md w repozytorium biblioteki. Zamiast czytać kopię, należy odpytać macierz z Pythona lub CLI.

Trzy poziomy

Kombinacje validated i available przechodzą bez potwierdzenia ani ogólnego ostrzeżenia. Zapisane dowody i ograniczenia pozostają widoczne w wygenerowanej dokumentacji. Zablokowana kombinacja kończy się niepowodzeniem przed sprawdzaniem zależności, wczytywaniem kalibracji, śledzeniem lub utworzeniem artefaktu.

Dodanie wpisu validated wymaga testu zgodności i pola since.

SupportEntry zawiera cztery pola: tier, ciąg reason, wydanie since i ciąg constraint. Podczas integracji znaczenie ma przede wszystkim ograniczenie. Znacznik wyboru obowiązuje tylko w określonych w nim warunkach, zwykle przy stałym obszarze wejściowym, batchu 1, FP32 i nazwanej wersji środowiska uruchomieniowego.

Sposób wyboru komórki

get_support(family, task, fmt) rozstrzyga w poniższej kolejności. Obowiązuje pierwsza pasująca reguła.

1. Nieznane zadanie lub format spoza dwunastu zwraca blocked.
2. Jawny wpis (family, task, format) jest zwracany w zapisanej postaci.
3. Blokada całej rodziny zwraca blocked z przyczyną tej rodziny.
4. Blokada całego zadania zwraca blocked z przyczyną tego zadania.
5. Dla ncnn rodzina z listy blokad NCNN zwraca blocked.
6. mnn zwraca blocked: dla tej rodziny i zadania nie ma kontraktu środowiska uruchomieniowego.
7. rknn zwraca blocked. RKNN w tej wersji ogranicza się dokładnie do wariantów detekcji przetestowanych w symulatorze: YOLO9-t, YOLO9-E2E-t, YOLO-NAS-s i PicoDet-s na RK3588.
8. tensorrt i openvino zwracają available: ścieżka konwertera istnieje, ale nie zapisano zgodności w środowisku uruchomieniowym dla tej rodziny i zadania.
9. tflite, paddle, coreai i coreml zwracają blocked, każdy z własną przyczyną.
10. Wszystkie pozostałe przypadki zwracają available: konwersja jest zaimplementowana, ale nie zapisano zgodności numerycznej w środowisku uruchomieniowym.

Asymetria w krokach od 8 do 10 jest celowa. TensorRT i OpenVINO wykonują ogólną konwersję z ONNX, więc warto podjąć próbę dla niewymienionej kombinacji. TFLite, Paddle, Core AI i CoreML wymagają ścieżki właściwej dla rodziny, dlatego niewymieniona kombinacja jest odrzuceniem, a nie zaproszeniem do próby.

Zablokowane zadania

Te zadania są zablokowane dla każdej rodziny bez jawnego wpisu.

Jawny wpis nadpisuje te blokady. Dzięki temu może eksportować na przykład podłączona rodzina semantic.

Zablokowane rodziny

PicoSAM3 jest wyjątkiem na poziomie modeli sterowanych podpowiedziami: eksportuje surową sieć ROI o rozmiarze 96 pikseli do ONNX.

Zablokowane dla NCNN

Dekodery w stylu DETR wymagają operacji próbkowania, których NCNN nie implementuje, dlatego poniższe rodziny są zablokowane dla ncnn, chyba że jawny wpis stanowi inaczej: Deformable DETR, DETR, DINO-DETR, D-FINE, LW-DETR, DEIM, DEIMv2, RT-DETR, RT-DETRv2, RT-DETRv4, RF-DETR i EC. Komunikat odrzucenia wskazuje ONNX, OpenVINO, TorchScript i TensorRT jako alternatywy.

Progi zgodności

Komórka validated oznacza, że wyeksportowany artefakt odtworzył model natywny w poniższych granicach:

Wiersze zapytań DETR są nieuporządkowanym zbiorem, dlatego zgodność rodziny DETR wyrównuje wiersze zapytań jako zbiór, a nie pozycyjnie.

Eksport

from libreyolo import LibreYOLOfrom libreyolo.export.support import get_support model = LibreYOLO("LibreYOLO9t.pt")print(model.export(format="onnx")) # Sprawdź przed wywołaniem: zablokowana kombinacja zgłasza błąd w kontroli wstępnej,# a komunikat zawiera tę przyczynę.blocked = get_support("domedetr", "detect", "onnx")print(blocked.tier)print(blocked.reason)

Zablokowana kombinacja zgłasza NotImplementedError podczas kontroli wstępnej, a komunikat zawiera zapisaną przyczynę. validated_alternatives(family, task) zwraca formaty zweryfikowane dla tej pary, co warto wyświetlić obok odrzucenia.

Argumenty wspólne dla wszystkich eksporterów wymieniono na stronie API modelu. Argumenty właściwe dla formatów opisano na stronach poszczególnych formatów.

Interpretowanie ograniczenia

Komórka validated jest stwierdzeniem dotyczącym jednej zmierzonej konfiguracji, a nie całego formatu. Ciąg ograniczenia, taki jak FP32, batch 1, fixed 520x520 input, oznacza, że zgodność zapisano dla danego kształtu i precyzji. Eksport z inną rozdzielczością lub rozmiarem batcha nadal tworzy artefakt, ale nie jest konfiguracją, z której pochodzi wynik.