Inizia

Soluzioni Ultralytics: usa YOLO26 per risolvere problemi del mondo reale

Le soluzioni Ultralytics sono applicazioni pronte all'uso dei modelli Ultralytics YOLO per problemi comuni di visione artificiale, come il conteggio degli oggetti, le mappe di calore e la stima della velocità, la gestione delle code e la sfocatura degli oggetti. La maggior parte delle soluzioni racchiude il rilevamento, il tracciamento o la stima della posa in una classe configurabile, eseguibile da Python o dalla CLI yolo solutions.

Miniatura di Ultralytics Solutions



Guarda: Come eseguire le soluzioni Ultralytics dalla riga di comando (CLI) | Ultralytics YOLO26 🚀

Soluzioni#

Ogni soluzione qui sotto ha una guida dedicata:

Argomenti delle soluzioni#

ArgomentoTipoPredefinitoDescrizione
modelstrNonePercorso a un file modello Ultralytics YOLO.
regionlist o dictNonePunti che definiscono la regione di interesse: un elenco di tuple (x, y) oppure un dizionario che associa i nomi delle regioni agli elenchi di punti per più regioni (solo RegionCounter). Quando None, le soluzioni che richiedono una regione usano un valore predefinito predefinito.
show_inboolTrueFlag che controlla se visualizzare i conteggi in entrata nello stream video.
show_outboolTrueFlag che controlla se visualizzare i conteggi in uscita nello stream video.
analytics_typestr'line'Tipo di grafico, ad es. line, bar, area o pie.
colormapintcv2.COLORMAP_DEEPGREENMappa dei colori da usare per la mappa di calore.
line_widthint2Spessore delle linee dei riquadri, dei punti chiave e dei conteggi disegnati dalla soluzione.
verboseboolTrueAbilita il log per frame della soluzione, con forma dell'input, conteggi per classe e velocità di elaborazione. La chiamata di tracking è sempre silenziosa.
json_filestrNonePercorso al file JSON che contiene tutti i dati sulle coordinate dei parcheggi.
up_anglefloat145.0Soglia angolare per la posa «verso l'alto».
kptslist[int][6, 8, 10]Elenco di tre indici di punti chiave usati per monitorare gli allenamenti. Questi punti chiave corrispondono alle articolazioni o alle parti del corpo, come spalle, gomiti e polsi, per esercizi come flessioni, trazioni, squat ed esercizi per gli addominali.
down_anglefloat90.0Soglia angolare per la posa «verso il basso».
blur_ratiofloat0.5Regola la percentuale di intensità della sfocatura, con valori nell'intervallo 0.1 - 1.0.
crop_dirstr'cropped-detections'Nome della directory in cui archiviare le rilevazioni ritagliate.
recordsint5Numero totale di rilevazioni necessario per attivare un'email con l'allarme di sicurezza.
vision_pointtuple[int, int](20, 20)Punto in cui VisionEye Solution traccia gli oggetti e disegna i percorsi.
sourcestrNonePercorso della sorgente di input (video, RTSP ecc.). Utilizzabile solo con l'interfaccia a riga di comando (CLI) di Solutions.
figsizetuple[float, float](12.8, 7.2)Dimensioni della figura in pollici per i grafici Analytics; (12.8, 7.2) genera un fotogramma da 1280×720.
fpsfloat30.0Fotogrammi al secondo utilizzati per calcolare la velocità.
max_histint5Numero massimo di punti storici da tracciare per oggetto per calcolare velocità e direzione.
meter_per_pixelfloat0.05Fattore di scala utilizzato per convertire la distanza in pixel in unità del mondo reale.
max_speedint120Velocità massima in km/h; le velocità stimate superiori vengono limitate a questo valore.
datastr'images'Percorso della directory di immagini utilizzata per la ricerca di somiglianze.
imgszint640Dimensioni dell'immagine di input per l'inferenza del modello.
recognizerstr o Callable'paddleocr'Backend di riconoscimento del testo: 'paddleocr' (PP-OCRv6 su ONNX Runtime), 'tensorrt' (PP-OCRv6 come motore TensorRT FP16 su GPU NVIDIA), un nome di modello linguistico PaddleOCR come 'korean_PP-OCRv5_mobile_rec' oppure una funzione richiamabile che accetta un ritaglio BGR e restituisce (text, confidence).
Argomenti di tracciamento

Le soluzioni passano gli argomenti di inferenza e tracciamento indicati di seguito a model.track().

ArgomentoTipoPredefinitoDescrizione
trackerstr'tracktrack.yaml'Specifica l'algoritmo di tracciamento da usare. Opzioni integrate: botsort.yaml, bytetrack.yaml, ocsort.yaml, deepocsort.yaml, fasttrack.yaml, tracktrack.yaml.
conffloat0.25Imposta la soglia di confidenza per le rilevazioni; valori più bassi consentono di tracciare più oggetti, ma possono includere falsi positivi.
ioufloat0.5Imposta la soglia di Intersezione sull'unione (IoU) per filtrare le rilevazioni sovrapposte.
classeslistNoneFiltra i risultati in base all'indice della classe. Ad esempio, classes=[0, 2, 3] traccia solo le classi specificate.
devicestrNoneSpecifica il dispositivo per l'inferenza (ad es. cpu, cuda:0 o 0). Consente di scegliere tra CPU, una GPU specifica o altri dispositivi di calcolo per l'esecuzione del modello.
imgszint or tuple640Dimensione dell'immagine di destinazione per l'inferenza: un intero per un'immagine quadrata o una coppia (height, width). Le forme vengono adattate allo stride del modello.
max_detint300Numero massimo di rilevazioni da mantenere per fotogramma prima del tracciamento, che limita gli oggetti elaborati da una soluzione nelle scene dense.
quantizeint or strNonePrecisione dell’inferenza: 16 (FP16) oppure 32/unset (FP32) per i modelli PyTorch e TorchScript quando non si usa la CPU; gli altri formati usano la precisione selezionata dal rispettivo artefatto e ambiente di esecuzione. Sostituisce l’argomento deprecato half.
Argomenti di visualizzazione

Puoi usare show_conf, show_labels e gli altri argomenti menzionati per personalizzare la visualizzazione.

ArgomentoTipoPredefinitoDescrizione
showboolFalseSe True, mostra le immagini o i video annotati in una finestra. Utile per ottenere un riscontro visivo immediato durante lo sviluppo o i test.
show_confboolTrueMostra il punteggio di confidenza di ogni rilevamento accanto all'etichetta. Fornisce indicazioni sul grado di certezza del modello per ciascun rilevamento.
show_labelsboolTrueMostra le etichette di ogni rilevamento nell'output visivo. Permette di identificare immediatamente gli oggetti rilevati.

Uso di SolutionAnnotator#

Tutte le soluzioni Ultralytics usano la classe SolutionAnnotator, che estende la classe principale Annotator e fornisce i seguenti metodi:

MetodoTipo restituitoDescrizione
draw_region()NoneDisegna una regione usando punti, colori e spessore specificati.
queue_counts_display()NoneVisualizza il conteggio delle code nella regione specificata.
display_analytics()NoneVisualizza le statistiche complessive sulla gestione dei parcheggi.
estimate_pose_angle()floatCalcola l'angolo tra tre punti nella posa di un oggetto.
draw_specific_kpts()np.ndarrayDisegna punti chiave specifici sull'immagine.
plot_workout_information()intDisegna sull'immagine un riquadro di testo con etichetta.
plot_angle_and_count_and_stage()NoneVisualizza l'angolo, il conteggio dei passi e la fase per il monitoraggio degli allenamenti.
plot_distance_and_line()NoneVisualizza la distanza tra i centroidi e li collega con una linea.
display_objects_labels()NoneAggiunge etichette delle classi degli oggetti alle bounding box.
sweep_annotator()NoneVisualizza una linea verticale di passaggio e un'etichetta facoltativa.
visioneye()NoneMappa i centroidi degli oggetti e li collega a un punto visivo simile a un "occhio".
adaptive_label()NoneDisegna un'etichetta con sfondo circolare o rettangolare al centro di una bounding box.

Lavorare con SolutionResults#

Quando viene chiamata, ogni soluzione tranne Ricerca per similarità restituisce un oggetto SolutionResults.

  • Per il conteggio degli oggetti, i risultati includono in_count, out_count e classwise_count.
SolutionResults
import cv2

from ultralytics import solutions

im0 = cv2.imread("path/to/img")

region_points = [(20, 400), (1080, 400), (1080, 360), (20, 360)]

counter = solutions.ObjectCounter(
    show=True,  # visualizza l'output
    region=region_points,  # passa i punti della regione
    model="yolo26n.pt",  # model="yolo26n-obb.pt" per il conteggio degli oggetti con il modello OBB.
    # classes=[0, 2],  # conta classi specifiche, ad es. persona e auto con il modello COCO preaddestrato.
    # tracker="botsort.yaml"  # Scegli i tracker, ad es. "bytetrack.yaml"
)
results = counter(im0)
print(results.in_count)  # display in_counts
print(results.out_count)  # display out_counts
print(results.classwise_count)  # display classwise_count

Gli oggetti SolutionResults hanno i seguenti attributi:

AttributoTipoDescrizione
plot_imnp.ndarrayImmagine con sovrapposizioni visive come conteggi, effetti di sfocatura o miglioramenti specifici della soluzione.
in_countintNumero totale di oggetti rilevati che entrano nella zona definita nel flusso video.
out_countintNumero totale di oggetti rilevati che escono dalla zona definita nel flusso video.
classwise_countdict[str, dict[str, int] | int]Conteggi per classe: {"IN": int, "OUT": int} per ObjectCounter e Heatmap oppure un int per Analytics.
queue_countintNumero di oggetti attualmente presenti in una coda o area di attesa predefinita (adatto alla gestione delle code).
workout_countlist[int]Conteggio delle ripetizioni degli allenamenti per ogni traccia di AI Gym (una voce per ogni individuo tracciato al momento).
workout_anglelist[float]Angoli degli esercizi per ogni traccia di AI Gym (una voce per ogni individuo tracciato al momento).
workout_stagelist[str]Fase corrente dell'allenamento per ogni traccia di AI Gym (una voce per ogni individuo tracciato al momento).
pixels_distancefloatDistanza in pixel tra due oggetti o punti, come le bounding box (adatta al calcolo della distanza).
available_slotsintNumero di posti liberi in un'area monitorata (adatto alla gestione dei parcheggi).
filled_slotsintNumero di posti occupati in un'area monitorata (adatto alla gestione dei parcheggi).
email_sentboolIndica se un'email di notifica o di avviso è stata inviata correttamente (adatto agli allarmi di sicurezza).
total_tracksintNumero totale di tracce univoche di oggetti osservate durante l'analisi video.
region_countsdict[str, int]Conteggi degli oggetti all'interno di regioni o zone definite dall'utente.
speed_dictdict[int, int]Dizionario delle velocità stimate degli oggetti, organizzate per traccia, in km/h, ottenute da SpeedEstimator e utili per l'analisi della velocità.
total_crop_objectsintNumero totale di immagini ritagliate degli oggetti generate dalla soluzione ObjectCropper.
speeddict[str, float]Dizionario contenente metriche di prestazione per il tracciamento e l'elaborazione della soluzione.

Per ulteriori dettagli, consulta la documentazione della classe SolutionResults.

Uso delle soluzioni tramite CLI#

Informazioni sul comando

La maggior parte delle soluzioni può essere eseguita direttamente dall'interfaccia a riga di comando.

Sintassi

yolo SOLUTIONS SOLUTION_NAME ARGS
  • SOLUTIONS è una parola chiave obbligatoria.
  • SOLUTION_NAME è uno tra: ['count', 'crop', 'blur', 'workout', 'heatmap', 'isegment', 'queue', 'speed', 'analytics', 'trackzone', 'inference', 'visioneye', 'region', 'security', 'parking'].
  • ARGS (opzionali) sono coppie personalizzate arg=value, come show_in=True, per sostituire le impostazioni predefinite.
yolo solutions count show=True # for object counting

yolo solutions count source="path/to/video.mp4" # specify video file path

Contribuisci alle nostre soluzioni#

I contributi della community sono benvenuti. Se hai creato con Ultralytics YOLO una soluzione non descritta qui, valuta di condividerla come guida per aiutare gli altri utenti.

Domande frequenti#

  • Ultralytics YOLO26 conta gli oggetti in tempo reale combinando rilevamento e tracciamento, così ogni oggetto viene contato una sola volta quando oltrepassa una linea o entra in una regione. Per configurare YOLO26 per l'analisi dei flussi video in diretta, installa ultralytics, carica un modello e passa i fotogrammi video a solutions.ObjectCounter.

  • Ultralytics YOLO26 aggiunge il rilevamento degli oggetti e gli avvisi in tempo reale ai sistemi di sicurezza basati su telecamere. Con la soluzione Sistema di allarme di sicurezza, YOLO26 invia un avviso via email quando il numero di oggetti rilevati nell'area di sorveglianza raggiunge una soglia.

  • Ultralytics YOLO26 conta e traccia le persone all'interno di un'area di coda, fornendoti la lunghezza della coda in tempo reale per ridurre i tempi di attesa e pianificare il personale.

  • Sì. I modelli di stima della posa Ultralytics YOLO26 tracciano in tempo reale i punti chiave del corpo, quindi la soluzione di monitoraggio degli allenamenti può misurare gli angoli delle articolazioni, contare le ripetizioni e indicare la fase corrente dell'esercizio.

  • Ultralytics YOLO26 può generare mappe di calore che mostrano dove gli oggetti compaiono o si spostano più spesso in una scena, evidenziando le aree con maggiore attività. Queste visualizzazioni dei dati ti aiutano a comprendere i modelli di traffico e le tendenze nel tempo.

Commenti23

Fai una domanda, condividi i tuoi risultati o aiuta qualcun altro.

    1. Glenn JocherUltralytics(modificato)

      @ZHIYUAN816 you don't need to set anything: the warning has no effect on training or metrics, only on how many items are drawn on the plotted validation images (optional, for visual review). In current versions that limit follows the max_det argument (default 300).

  1. ZHIYUAN816GitHub

    WARNING ⚠️ Limiting validation plots to first 50 items per image for speed... WARNING ⚠️ Limiting validation plots to first 50 items per image for speed... how to solve this problem bro?

    1. Glenn JocherUltralytics(modificato)

      @ZHIYUAN816 this is not an error but a warning that the plotted prediction images are limited to a maximum number of items per image. It does not affect training. In current versions the limit follows max_det (default 300).

  2. smc0927GitHub

    If I want a target to be detected only once, is it possible? If so, how can I do it?

    1. RizwanMunawarGitHub

      @smc0927 Hi! I’m not entirely sure I understand your question. Could you please clarify a bit?

      Generally, the counting process is designed to occur only once for each track ID. Once an object is counted, it won't be counted again, even if it crosses the same region or line multiple times.

    2. smc0927GitHub

      ok,I want to print out the coordinates of the target, but that's not what I want because it's going to be printed multiple times over a period of time. I want it to be output only once, is there a way to achieve this?

    3. RizwanMunawarGitHub

      @smc0927 Yes it's possible. You can simply iterate over the detection results. BTW, this discussion is more related to Ultralytics solutions, while your question is related to prediction :)

      Sample Code

      from ultralytics import YOLO
      model = YOLO("yolo11n.pt")
      results = model.predict("path/to/im0")
      
      if results[0].boxes.id is not None:
            boxes = results[0].boxes.xyxy.cpu()
            track_ids = results[0].boxes.id.int().cpu().tolist()
            clss = results[0].boxes.cls.cpu().tolist()
      
            for box, cls in enumerate(boxes, clss):
                # Here you can add the logic to display single-time details of the object

      Thanks :)

  3. hodat2608GitHub

    Hi everyone, hi @glenn-jocher, I want to install pycuda on my windows 10 using python 3.12, but I still can't do it. It's hard to find any documentation or tutorials like that, @glenn-jocher or anyone can send me a link or tutorial to install pycuda? Please help me. Thanks first

  4. maxexplorerGitHub

    Hi there,

    After updating Ultralytics and using YOLO11, will the YOLOv8 models still work in this virtual environment?

    Thank you in advance for your help and the great work you’re doing!

    1. Glenn JocherUltralytics

      @maxexplorer yes, YOLOv8 models will continue to work in your virtual environment after updating to YOLO11. If you have further questions, feel free to ask!

  5. yosifsaabGitHub

    hi i have error during using the google colab for classification two classes images by yolov8n
    results = model.train(data=DATA_DIR, epochs=1, imgsz=64)

    1. Glenn JocherUltralytics

      @yosifsaab it seems you're encountering an error with YOLOv8n in Google Colab. Please ensure your DATA_DIR is correctly set and that your dataset is properly formatted. If the issue persists, check the Colab notebook for any specific error messages that might provide more details. For further assistance, you can refer to the Ultralytics documentation.

  6. NkosiyazimelaniGitHub

    Hi guys, how do i update the nc that my model can detect without having to train with old and new objects. i have updated my .YAML file but the model is still detecting the old number of objects(20 instead of 46). i have been told to look on the model itself and change the output number of class to the new updated on but there is nothing of that sort in the model file( best.pt). please help.

    1. Glenn JocherUltralytics(modificato)

      @Nkosiyazimelani the number of classes (nc) is part of the trained model's detection head, so editing the .yaml file after training doesn't change what best.pt predicts. You need to train again with a dataset YAML that has all 46 classes. You don't have to start from scratch, you can fine-tune from your existing weights, and the layers whose shapes depend on the class count are reinitialized automatically:

      from ultralytics import YOLO
      
      model = YOLO("best.pt")
      model.train(data="your_46_class_dataset.yaml", epochs=100)

      Make sure your dataset contains labeled examples of both the old and the new classes, otherwise the model will forget the old ones.

    1. Glenn JocherUltralytics

      @nounotabe to specify the device for running YOLOv8, you can use the device argument. For example, to use the second GPU (cuda:1), you can set device='cuda:1'. This can be done in both the CLI and Python API. If you encounter any issues, please ensure you are using the latest version of the package. For more detailed guidance, you can refer to our documentation at https://docs.ultralytics.com.

    2. cobaltautomationdevGitHub

      lasted version of ultralytics. solutions not works in Windows10, but works in Google Colab. What's wrong with it? How to settle it? from ultralytics import solutions,YOLO , Couldn't import solutions in my windows10.

    3. Glenn JocherUltralytics

      It seems like there might be an issue with the solutions module on Windows 10. Please ensure you are using the latest version of the Ultralytics package. If the issue persists, try reinstalling the package or running the code in a different environment. For further assistance, you can refer to our documentation at https://docs.ultralytics.com/solutions/.

    4. cobaltautomationdevGitHub

      Just updated to v8.2.78 today ,uninstall and reinstall the latest version. and now it works on Windows10 . it seems there something changed in solutions init.py . this file caused import error in previous version. I noticed that in version 8.2.0, file init.py is blank. now add some code in it.