PersonAnalysis

Распознавайте людей по признакам лица и тела

Обнаруживайте людей и сопоставляйте их с зарегистрированными личностями в первую очередь по лицу. Если сопоставление по лицу недоступно, используйте реидентификацию по телу. Оцените возможности локально с помощью Python SDK.

Только для некоммерческих научных исследований. Для коммерческого использования нужна лицензия.

Начать с Python Обсудить лицензию

Python SDK
CPU / CUDA
Cheetah S / L

Схема процессаPersonAnalysis

01Зарегистрированный образец

02Совпадение по лицу

03Дополнение по телу

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

Нет совпаденияperson_id = None

Основные возможности

Три функции в одном процессе анализа

Обнаружение людей

Определяйте положение людей на каждом изображении и связывайте обнаруженные лица с телами для последующего сопоставления личности.

Приоритет сопоставления по лицу

Сравнивайте признаки лица с зарегистрированными образцами. При наличии подходящего совпадения результат по лицу имеет приоритет.

Признаки тела как дополнение

Если лицо не позволяет найти совпадение, сравнивайте внешний вид тела с сохранёнными образцами. Одежда, ракурс и перекрытия могут влиять на результат.

Сопоставление личности

Регистрация, сопоставление и обновление образцов

Ваше приложение предоставляет метки личности и эталонные изображения. PersonAnalysis сравнивает обнаружения с галереей текущего экземпляра.

Регистрация образца
Добавьте эталонное изображение с меткой личности в галерею в оперативной памяти.
Анализ и сопоставление
Вызовите get() для изображения, затем match(), чтобы сравнить обнаружения с зарегистрированными личностями.
Обновление галереи
После надёжного совпадения по лицу и однозначной связи лица с телом используйте update(), чтобы добавить образец тела.

Наборы моделей Cheetah

Выберите набор моделей для оценки

Два открыто доступных набора объединяют обнаружение людей, распознавание лиц и реидентификацию по телу. Оба поддерживают локальный запуск на CPU или CUDA.

Cheetah S

CPU / CUDA

27.1 MBРазмер загрузки

Компактный набор для локальной оценки.

Детектор людей: pp_det_small_320.onnx
Распознавание лиц: MobileFaceNet
Реидентификация по телу: reid_0265 · 256D

Cheetah L

CPU / CUDA

211.5 MBРазмер загрузки

Более крупные модели обнаружения людей и распознавания лиц.

Детектор людей: pp_det_med.onnx
Распознавание лиц: ResNet50
Реидентификация по телу: reid_0265 · 256D

Оба набора используют reid_0265 с 256-мерными признаками тела. Публичные веса моделей разрешено использовать только для некоммерческих научных исследований; коммерческое использование требует отдельной лицензии на модели.

Локальная интеграция

Начните с Python SDK

PersonAnalysis доступен в insightface 2.1 на PyPI. Используйте CPU или CUDA и подключайте результаты к собственной логике управления личностями и хранения данных.

python -m pip install --upgrade "insightface==2.1"

Читать руководство по настройке

Многоязычное настольное приложение также поддерживает локальные видео, камеры и потоки RTSP.

Быстрый старт на Python

person_analysis.py

1import cv2
2from insightface.app import PersonAnalysis
3
4with PersonAnalysis(name="cheetah_s") as app:
5    registration = app.register("person_001", "reference.jpg")
6    if registration.accepted == 0:
7        raise ValueError(registration.rejected)
8
9    image = cv2.imread("scene.jpg")
10    if image is None:
11        raise FileNotFoundError("scene.jpg")
12
13    matches = app.match(app.get(image))
14    for result in matches:
15        print(result.person_id, result.matched_by)

Текущие границы возможностей

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

Перед интеграцией

Чем это отличается от анализа лиц?

PersonAnalysis дополняет сопоставление личности по лицу обнаружением людей и реидентификацией по телу. Он связывает лица с телами и отдаёт приоритет совпадениям по лицу с зарегистрированными образцами.

Отслеживает ли система людей на протяжении видео?

Она анализирует изображения и сопоставляет зарегистрированные личности. Непрерывное отслеживание, анонимные идентификаторы траекторий и история событий пока не входят в её возможности.

Можно ли использовать публичные модели коммерчески?

Код распространяется по лицензии MIT. Публичные веса Cheetah разрешено использовать только для некоммерческих научных исследований. Для коммерческого использования нужна отдельная лицензия на модели. Свяжитесь с нами, чтобы обсудить условия лицензирования и развёртывания.

Что следует проверить на собственных данных?

Оцените обнаружение и сопоставление при ваших ракурсах камеры, видимости лица, смене одежды и перекрытиях. Подберите пороги на репрезентативных данных и измерьте скорость обработки на целевом оборудовании.

Оцените Person Analysis для своего приложения

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

Связаться с нами Посмотреть на GitHub