Ultralytics YOLO27:

Семантическая сегментация с Ultralytics YOLO#

Semantic segmentation examples

Семантическая сегментация присваивает метку класса каждому пикселю изображения, создавая плотную карту классов, охватывающую всю сцену. В отличие от сегментации экземпляров, которая разделяет отдельные объекты, семантическая сегментация объединяет все пиксели одного класса независимо от количества присутствующих отдельных объектов.



Watch: Semantic Segmentation with Ultralytics YOLO26 | Quickstart Tutorial

Результатом работы модели семантической сегментации является единая карта классов высотой на ширину, где значение каждого пикселя соответствует предсказанному ID класса. Это делает семантическую сегментацию идеальной для таких задач разбора сцен, как автономное вождение, анализ медицинских изображений и картографирование типов земного покрова.

Совет

Используй task=semantic или задачу CLI yolo semantic для семантической сегментации. Файлы моделей семантической сегментации YOLO26 используют суффикс -sem, например yolo26n-sem.pt.

Модели#

Ниже показаны модели семантической сегментации YOLO26, предварительно обученные на датасете Cityscapes.

Модели автоматически скачиваются из последнего релиза Ultralytics при первом использовании.

Модельразмер
(пиксели)
mIoUvalСкорость
RTX3090 PyTorch
(мс)
параметры
(M)
FLOPs
(B)
YOLO26n-sem1024 × 204878.34.4 ± 0.01.623.8
YOLO26s-sem1024 × 204880.88.4 ± 0.06.591.0
YOLO26m-sem1024 × 204882.019.9 ± 0.114.3305.5
YOLO26l-sem1024 × 204882.926.5 ± 0.117.8388.2
YOLO26x-sem1024 × 204883.648.9 ± 0.240.1866.9
  • Значения mIoUval приведены для одной модели в одном масштабе на валидационном наборе Cityscapes.
    Воспроизведи с помощью yolo semantic val data=cityscapes.yaml device=0 imgsz=2048
  • Метрики скорости усреднены по изображениям валидационного набора Cityscapes с использованием экземпляра RTX3090.
    Воспроизведи с помощью yolo semantic val data=cityscapes.yaml batch=1 device=0|cpu imgsz=2048
  • Значения Params и FLOPs указаны для объединённой модели после выполнения model.fuse(), которая объединяет слои Conv и BatchNorm. Предварительно обученные контрольные точки сохраняют полную архитектуру обучения и могут показывать большее количество параметров и операций.

Ниже показаны модели семантической сегментации YOLO26, предварительно обученные на датасете ADE20K.

Модели автоматически скачиваются из последнего релиза Ultralytics при первом использовании.

Модельразмер
(пиксели)
mIoUvalСкорость
RTX3090 PyTorch
(мс)
параметры
(M)
FLOPs
(B)
YOLO26n-sem-ade20k64038.83.9 ± 0.21.64.5
YOLO26s-sem-ade20k64045.64.2 ± 0.36.517.5
YOLO26m-sem-ade20k64047.44.7 ± 0.314.459.6
YOLO26l-sem-ade20k64049.78.3 ± 0.217.975.2
YOLO26x-sem-ade20k64051.59.9 ± 0.340.2168.4
  • Значения mIoUval приведены для одной модели в одном масштабе на валидационном наборе ADE20K.
    Воспроизведи с помощью yolo semantic val model=yolo26n-sem-ade20k.pt data=ade20k.yaml device=0 imgsz=640, заменив yolo26n-sem-ade20k.pt на нужную контрольную точку yolo26*-sem-ade20k.pt.
  • Метрики скорости усреднены по изображениям валидационного набора ADE20K с использованием экземпляра RTX3090.
    Воспроизведи с помощью yolo semantic val model=yolo26n-sem-ade20k.pt data=ade20k.yaml batch=1 device=0|cpu imgsz=640, заменив yolo26n-sem-ade20k.pt на нужную контрольную точку yolo26*-sem-ade20k.pt.
  • Значения Params и FLOPs указаны для объединённой модели после выполнения model.fuse(), которая объединяет слои Conv и BatchNorm. Предварительно обученные контрольные точки сохраняют полную архитектуру обучения и могут показывать большее количество параметров и операций.

Смотри предварительный обзор невыпущенного YOLO27 для предварительных результатов mIoU на Cityscapes.

Обучение#

Обучи YOLO26n-sem на датасете Cityscapes8 в течение 100 эпох с размером изображения 1024. Полный список доступных аргументов см. на странице Конфигурация.

Пример
from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n-sem.yaml")  # build a new model from YAML
model = YOLO("yolo26n-sem.pt")  # load a pretrained model (recommended for training)
model = YOLO("yolo26n-sem.yaml").load("yolo26n-sem.pt")  # build from YAML and transfer weights

# Train the model
results = model.train(data="cityscapes8.yaml", epochs=100, imgsz=1024)

Полные сведения о режиме train см. на странице Обучение. Модели семантической сегментации также можно обучать с помощью облачного обучения на платформе Ultralytics.

Формат датасета#

Датасеты для семантической сегментации используют одноканальные изображения масок, обычно в формате PNG, где значение каждого пикселя представляет собой ID класса. Пиксели со значением 255 считаются «игнорируемыми» и исключаются из вычисления потерь. В YAML-файле датасета должны быть указаны пути к изображениям и соответствующим каталогам масок. Подробности о формате см. в руководстве по датасетам для семантической сегментации. Поддерживаются датасеты Cityscapes и ADE20K. Управлять датасетами для семантической сегментации и размечать их можно с помощью аннотации на платформе Ultralytics.

Val#

Проверь точность обученной модели YOLO26n-sem на датасете для семантической сегментации. Явно передай data, чтобы при проверке использовался нужный YAML-файл датасета.

Пример
from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n-sem.pt")  # load an official model
model = YOLO("path/to/best.pt")  # load a custom model

# Validate the model
metrics = model.val(data="cityscapes.yaml")
metrics.miou  # mean Intersection over Union
metrics.pixel_accuracy  # overall pixel accuracy

Predict#

Используй обученную модель YOLO26n-sem для выполнения предсказаний на изображениях.

Пример
from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n-sem.pt")  # load an official model
model = YOLO("path/to/best.pt")  # load a custom model

# Predict with the model
results = model("https://ultralytics.com/images/bus.jpg")  # predict on an image

# Access the results
for result in results:
    semantic_mask = result.semantic_mask.data  # class map, shape (H,W), integer dtype selected by class count

Полное описание режима predict см. на странице Predict.

Выходные данные результатов#

Семантическая сегментация YOLO возвращает один объект Results для каждого изображения. Каждый результат хранит одну плотную карту классов для всего изображения, а не список масок объектов. Пиксели с одинаковым предсказанным классом имеют один и тот же ID класса, даже если они относятся к отдельным объектам.

АтрибутТипФормаОписание
result.semantic_maskSemanticMask(H,W)Плотная карта классов.
result.semantic_mask.datatorch.uint8
torch.int16
torch.int32
(H,W)ID классов; dtype выбирается по количеству классов.
result.masks--Маски экземпляров отсутствуют.
result.boxes--Без рамок и значений уверенности экземпляров.
result.masks.xy--Полигоны по умолчанию отсутствуют.

Описание специфичных для задач полей Results для всех задач см. в разделе Результаты предсказаний по задачам.

Качество границ маски

Семантическая сегментация предсказывает плотную карту классов, а затем изменяет ее размер до формы изображения для визуализации и дальнейшего использования. Поэтому очень тонкие структуры, такие как дорожная разметка, линии разметки площадки, столбы или провода, могут выглядеть ступенчатыми, если вывод выполняется при значительно меньшем imgsz, чем исходное разрешение изображения. Если границы выглядят зубчатыми, сначала повторно проверь исходную модель PyTorch .pt с большим imgsz, например 1024, 1280 или ближайшим практичным значением к размеру исходного изображения. Используй экспортированные модели только после подтверждения того, что результат .pt приемлем, поскольку входные данные с низким разрешением не могут восстановить мелкие детали, отсутствовавшие в предсказанной карте классов.

Сегментация экземпляров и семантическая сегментация#

АспектСегментация экземпляров (task="segment")Семантическая сегментация (task="semantic")
Цель предсказанияСегментировать каждый обнаруженный объект отдельноПрисвоить каждому пикселю один ID класса
Поле результатаresult.masksresult.semantic_mask
Основные данныеresult.masks.dataresult.semantic_mask.data
Форма(N,H,W)(H,W)
Значения пикселейЗначения бинарной маски: 0 или 1ID классов: 0, 1, 2, ...
Dtypetorch.uint8torch.uint8
torch.int16
torch.int32
Объекты одного классаСохраняются как отдельные экземплярыОбъединяются в одну область класса
ПолигоныДа, через result.masks.xy и result.masks.xynПо умолчанию полигоны не выводятся
BBox и confidenceДа, через result.boxesНет BBox или оценок confidence для отдельных экземпляров
Типичное применениеПодсчет, отслеживание, кадрирование, измерения на уровне объектовПлотная разметка сцен, проезжая часть, типы земного покрова, медицинские области

Экспорт#

Экспортируй модель YOLO26n-sem в другой формат, например ONNX, CoreML и т. д.

Пример
from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n-sem.pt")  # load an official model
model = YOLO("path/to/best.pt")  # load a custom model

# Export the model
model.export(format="onnx")

Доступные форматы экспорта моделей семантической сегментации YOLO26 приведены в таблице ниже. Экспортировать модель в любой формат можно с помощью аргумента format, например format='onnx' или format='engine'. Предсказывать или выполнять проверку непосредственно на экспортированных моделях можно с помощью yolo predict model=yolo26n-sem.onnx. Примеры использования для твоей модели отображаются после завершения экспорта.

ФорматАргумент formatМодельМетаданныеАргументы
PyTorch-yolo26n-sem.pt-
TorchScripttorchscriptyolo26n-sem.torchscriptimgsz, quantize, dynamic, nms, batch, device
ONNXonnxyolo26n-sem.onnximgsz, quantize, dynamic, simplify, opset, nms, batch, data, fraction, device
OpenVINOopenvinoyolo26n-sem_openvino_model/imgsz, quantize, dynamic, nms, batch, data, fraction, device
TensorRTengineyolo26n-sem.engineimgsz, quantize, dynamic, simplify, opset, workspace, nms, batch, data, fraction, device
CoreMLcoremlyolo26n-sem.mlpackageimgsz, dynamic, quantize, nms, batch, device
TF SavedModelsaved_modelyolo26n-sem_saved_model/imgsz, keras, quantize, opset, nms, batch, data, fraction, device
TF GraphDefpbyolo26n-sem.pbimgsz, opset, batch, device
TF Edge TPUedgetpuyolo26n-sem_edgetpu.tfliteimgsz, quantize, opset, data, fraction, device
PaddlePaddlepaddleyolo26n-sem_paddle_model/imgsz, batch, device
MNNmnnyolo26n-sem.mnnimgsz, batch, dynamic, quantize, simplify, opset, nms, device
NCNNncnnyolo26n-sem_ncnn_model/imgsz, quantize, batch, device
IMX500imxyolo26n-sem_imx_model/imgsz, quantize, data, fraction, nms, device
RKNNrknnyolo26n-sem_rknn_model/imgsz, batch, name, quantize, simplify, opset, data, fraction, device
ExecuTorchexecutorchyolo26n-sem_executorch_model/imgsz, batch, device
Axeleraaxelerayolo26n-sem_axelera_model/imgsz, batch, quantize, data, fraction, device
DEEPXdeepxyolo26n-sem_deepx_model/imgsz, quantize, simplify, opset, data, optimize, device
Qualcomm QNNqnnyolo26n-sem_qnn.onnximgsz, batch, name, quantize, simplify, opset, data, fraction, device
LiteRTlitertyolo26n-sem.tfliteimgsz, quantize, batch, data, fraction, device
Hailohailoyolo26n-sem_hailo_model/imgsz, name, quantize, data, fraction, simplify, conf, iou
Huawei Ascendascendyolo26n-sem_ascend_model/imgsz, batch, name, quantize, opset, simplify, nms
Apple Core AIcoreaiyolo26n-sem.aimodelimgsz, batch, quantize

nms=None по умолчанию выдает сырые результаты для внешнего NMS. Установи nms=False, чтобы выбрать доступный головной модуль без NMS; неподдерживаемые форматы возвращаются к своему родному пути вывода. Записи nms выше определяют форматы, которые могут встраивать NMS с помощью nms=True.

Полное описание export см. на странице Экспорт.

Часто задаваемые вопросы#

  • Чтобы обучить модель семантической сегментации YOLO26 на пользовательском датасете, подготовь изображения масок PNG, где значение каждого пикселя представляет собой ID класса (0, 1, 2, ...), а пиксели со значением 255 игнорируются во время обучения. Создай YAML-файл датасета с указанием каталогов изображений и масок, затем обучи модель:

    Пример
    from ultralytics import YOLO
    
    # Load a pretrained YOLO26 semantic segmentation model
    model = YOLO("yolo26n-sem.pt")
    
    # Train the model
    results = model.train(data="path/to/your_dataset.yaml", epochs=100, imgsz=512)

    Дополнительные доступные аргументы см. на странице Конфигурация.

  • Сегментация экземпляров и семантическая сегментация — это задачи на уровне пикселей, но они различаются по одному ключевому аспекту:

    • Семантическая сегментация присваивает метку класса каждому пикселю, но не различает отдельные объекты одного класса. Например, все автомобили в сцене получают одну и ту же метку класса.
    • Сегментация экземпляров распознает каждый отдельный объект независимо и создает отдельную маску для каждого объекта, даже если они относятся к одному классу.

    Семантическая сегментация лучше всего подходит для задач понимания сцены, таких как автономное вождение и картографирование типов земного покрова, тогда как сегментация экземпляров предпочтительна, когда важно считать или отслеживать отдельные объекты.

  • Да. Если в твоем датасете используются полигональные метки Ultralytics YOLO (один .txt на изображение), не указывай masks_dir в YAML-файле датасета и убедись, что рядом с изображениями в корне датасета нет каталога masks/ (само его наличие активирует режим PNG-масок, даже если masks_dir не задан). После этого загрузчик преобразует полигоны в семантические маски для каждого изображения на лету. Для многоклассовых датасетов (N > 1) дополнительный класс background автоматически добавляется к names. Для одноклассовых датасетов (N == 1) обучение остается с 1 классом: объявленный тобой класс становится 1 в маске, а непокрытые пиксели становятся 0. Подробности см. в руководстве по датасетам для семантической сегментации.

  • Ultralytics YOLO26 предоставляет встроенные конфигурации для нескольких датасетов семантической сегментации:

    • Cityscapes: городские уличные сцены с 19 классами, широко используемые в исследованиях автономного вождения.
    • ADE20K: крупномасштабный датасет для разбора сцен со 150 классами.

    Также можно использовать любой пользовательский датасет с аннотациями масок PNG, где значения пикселей соответствуют ID классов.

  • Проверь предварительно обученную модель семантической сегментации YOLO26 с помощью YAML-файла датасета, использованного для оценки:

    Пример
    from ultralytics import YOLO
    
    # Load a pretrained model
    model = YOLO("yolo26n-sem.pt")
    
    # Validate the model
    metrics = model.val(data="cityscapes.yaml")
    print("Mean IoU:", metrics.miou)
    print("Pixel Accuracy:", metrics.pixel_accuracy)

    Эти шаги предоставят метрики валидации, такие как среднее пересечение по объединению (mIoU) и точность на уровне пикселей, которые являются стандартными показателями оценки качества семантической сегментации.

  • Экспортируй модель семантической сегментации YOLO26 в формат ONNX с помощью команд Python или CLI:

    Пример
    from ultralytics import YOLO
    
    # Load a pretrained model
    model = YOLO("yolo26n-sem.pt")
    
    # Export the model to ONNX format
    model.export(format="onnx")

    Подробнее об экспорте в различные форматы см. на странице Экспорт.

Комментарии