PersonAnalysis

Identifique pessoas por características faciais e corporais

Detecte pessoas e compare identidades cadastradas priorizando as características do rosto. Quando a correspondência facial não estiver disponível, use a reidentificação corporal como apoio. Avalie localmente com o SDK Python.

Apenas para pesquisa acadêmica não comercial. O uso comercial exige licença.

Começar com Python Consultar licenciamento

Python SDK
CPU / CUDA
Cheetah S / L

Ilustração do processoPersonAnalysis

01Referência cadastrada

02Correspondência facial

03Apoio corporal

Ilustração da mesma identidade em quadros diferentes. Este é um diagrama do processo, não uma demonstração ao vivo nem um resultado de desempenho.

Sem correspondênciaperson_id = None

Recursos principais

Três recursos em um único processo de análise

Detectar pessoas

Localize pessoas em cada imagem e associe os rostos detectados aos seus corpos para a comparação posterior de identidades.

Priorizar o rosto

Compare características faciais com as referências cadastradas. Quando há uma correspondência facial adequada, ela tem prioridade.

Complementar com características corporais

Quando não há correspondência facial, compare a aparência corporal com referências salvas. Roupas, ângulo de visão e oclusões podem afetar o resultado.

Comparação de identidades

Cadastrar, comparar e atualizar referências

Sua aplicação fornece rótulos de identidade e imagens de referência. O PersonAnalysis compara as detecções com a galeria da instância atual.

Cadastrar uma referência
Adicione uma imagem com um rótulo de identidade à galeria em memória.
Analisar e comparar
Execute get() em uma imagem e depois match() para comparar as detecções com as identidades cadastradas.
Atualizar a galeria
Após uma correspondência facial confiável e uma associação clara entre rosto e corpo, use update() para adicionar uma referência corporal.

Pacotes de modelos Cheetah

Escolha um pacote para sua avaliação

Dois pacotes públicos combinam detecção de pessoas, reconhecimento facial e reidentificação corporal. Ambos permitem inferência local em CPU ou CUDA.

Cheetah S

CPU / CUDA

27.1 MBTamanho do download

Pacote compacto para avaliação local.

Detector de pessoas: pp_det_small_320.onnx
Reconhecimento facial: MobileFaceNet
Reidentificação corporal: reid_0265 · 256D

Cheetah L

CPU / CUDA

211.5 MBTamanho do download

Modelos maiores de detecção de pessoas e reconhecimento facial.

Detector de pessoas: pp_det_med.onnx
Reconhecimento facial: ResNet50
Reidentificação corporal: reid_0265 · 256D

Ambos compartilham o reid_0265, com características corporais de 256 dimensões. Os pesos públicos destinam-se apenas à pesquisa acadêmica não comercial; o uso comercial exige uma licença de modelos separada.

Integração local

Comece com o SDK Python

O PersonAnalysis está disponível no insightface 2.1 no PyPI. Execute a inferência em CPU ou CUDA e conecte os resultados à lógica de identidades e armazenamento da sua aplicação.

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

Ler o guia de configuração

A aplicação de desktop multilíngue também aceita vídeos locais, câmeras e fluxos RTSP.

Início rápido com 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)

Escopo atual

Não inclui rastreamento contínuo, identificadores anônimos ou registros históricos de eventos.
A galeria de referências fica na memória da instância atual. Uma base persistente de identidades deve ser gerenciada pela sua aplicação.
A reidentificação corporal depende da aparência; mudanças de roupa, oclusões e ângulos de câmera podem afetar as correspondências.

Antes de integrar

Qual é a diferença em relação à análise facial?

O PersonAnalysis acrescenta detecção de pessoas e reidentificação corporal à comparação de identidades pelo rosto. Ele associa rostos a corpos e prioriza correspondências faciais com suas referências cadastradas.

Ele rastreia pessoas ao longo de um vídeo?

Ele analisa imagens e compara identidades cadastradas. Rastreamento contínuo, identificadores anônimos de trajetória e histórico de eventos estão fora do escopo atual.

Posso usar os modelos públicos comercialmente?

O código usa a licença MIT. Os pesos públicos do Cheetah destinam-se apenas à pesquisa acadêmica não comercial. O uso comercial exige uma licença de modelos separada; entre em contato para conhecer as condições de licença e implantação.

O que devo avaliar com meus dados?

Verifique a detecção e as correspondências com seus ângulos de câmera, visibilidade do rosto, mudanças de roupa e oclusões. Ajuste os limiares com dados representativos e meça a velocidade de processamento no hardware de destino.

Avalie o Person Analysis para sua aplicação

Compartilhe suas fontes de entrada, ambiente de implantação e requisitos comerciais para discutir licenciamento de modelos e integração.

Entre em contato Ver no GitHub