Name: Potato
Author: Potato

Se stai addestrando un rilevatore di oggetti, ti servono i bounding box. Questo tutorial parte da una configurazione minima e arriva agli attributi, alle regole di validazione e a una configurazione completa da produzione. Per le opzioni sulle immagini che ci stanno dietro, vedi la documentazione sull'annotazione di immagini.

Impostazione di base dei bounding box

Configurazione minima

yaml

annotation_task_name: "Object Detection Annotation"
 
data_files:
  - "data/images.json"
 
annotation_schemes:
  - annotation_type: image_annotation
    name: objects
    description: "Draw boxes around all objects"
    tools:
      - bbox
    labels:
      - name: car
        color: "#FF6B6B"
      - name: person
        color: "#4ECDC4"
      - name: bicycle
        color: "#45B7D1"

Come funziona

Scegli un'etichetta dalla barra degli strumenti
Clicca e trascina per disegnare un riquadro
Sposta gli angoli per rifinirlo
Aggiungi altri riquadri quando serve
Invia quando hai finito

Gli annotatori disegnano i bounding box direttamente sull'immagine, cliccando e trascinando:

Interfaccia di annotazione con bounding box per il rilevamento di oggetti Lo strumento bounding box permette di disegnare ed etichettare regioni rettangolari sulle immagini

Configurazione dettagliata delle etichette

yaml

annotation_schemes:
  - annotation_type: image_annotation
    name: objects
    description: "Annotate all visible objects"
    tools:
      - bbox
    labels:
      - name: person
        color: "#FF6B6B"
        description: "Any human, partial or full"
        keyboard_shortcut: "p"
 
      - name: car
        color: "#4ECDC4"
        description: "Cars, trucks, SUVs"
        keyboard_shortcut: "c"
 
      - name: motorcycle
        color: "#45B7D1"
        description: "Motorcycles and scooters"
        keyboard_shortcut: "m"
 
      - name: bicycle
        color: "#96CEB4"
        description: "Bicycles of all types"
        keyboard_shortcut: "b"
 
      - name: traffic_light
        color: "#FFEAA7"
        description: "Traffic signals"
        keyboard_shortcut: "t"
 
      - name: stop_sign
        color: "#DDA0DD"
        description: "Stop signs"
        keyboard_shortcut: "s"

Aggiungere attributi agli oggetti

Raccogli informazioni in più su ogni riquadro:

yaml

annotation_schemes:
  - annotation_type: image_annotation
    name: objects
    tools:
      - bbox
    labels:
      - name: person
        color: "#FF6B6B"
        attributes:
          - name: occlusion
            type: radio
            options: [none, partial, heavy]
          - name: truncated
            type: checkbox
            description: "Object extends beyond image"
          - name: difficult
            type: checkbox
            description: "Hard to identify"

Quando un annotatore disegna un riquadro, gli viene chiesto di compilare questi attributi.

Regole di validazione

Tieni sotto controllo la qualità dell'annotazione con la validazione:

yaml

annotation_schemes:
  - annotation_type: image_annotation
    name: objects
    tools:
      - bbox
    labels: [...]
    min_annotations: 1

Scorciatoie da tastiera

Potato ha già delle scorciatoie da tastiera per annotare più in fretta:

I tasti numerici selezionano le etichette
Canc elimina le annotazioni selezionate
Le frecce spostano da un elemento all'altro

Opzioni di visualizzazione

Configura come viene mostrata l'immagine:

yaml

image_display:
  width: 800
  height: 600

Configurazione completa per la produzione

yaml

annotation_task_name: "Autonomous Driving - Object Detection"
 
data_files:
  - "data/driving_frames.json"
 
annotation_schemes:
  - annotation_type: image_annotation
    name: objects
    description: "Annotate all traffic participants and objects"
    tools:
      - bbox
    min_annotations: 1
    labels:
      - name: vehicle
        color: "#FF6B6B"
        keyboard_shortcut: "v"
        attributes:
          - name: type
            type: radio
            options: [car, truck, bus, motorcycle, bicycle]
          - name: occlusion
            type: radio
            options: [0%, 1-25%, 26-50%, 51-75%, 76-99%]
 
      - name: pedestrian
        color: "#4ECDC4"
        keyboard_shortcut: "p"
        attributes:
          - name: pose
            type: radio
            options: [standing, walking, sitting, lying]
          - name: age_group
            type: radio
            options: [child, adult, elderly]
 
      - name: cyclist
        color: "#45B7D1"
        keyboard_shortcut: "c"
 
      - name: traffic_sign
        color: "#FFEAA7"
        keyboard_shortcut: "t"
        attributes:
          - name: sign_type
            type: radio
            options: [stop, yield, speed_limit, warning, other]
 
      - name: traffic_light
        color: "#DDA0DD"
        keyboard_shortcut: "l"
        attributes:
          - name: state
            type: radio
            options: [red, yellow, green, off, unknown]

Formato di output

json

{
  "frame_id": "frame_0001",
  "frame_path": "/images/frame_0001.jpg",
  "image_dimensions": {"width": 1920, "height": 1080},
  "annotations": {
    "objects": [
      {
        "label": "vehicle",
        "bbox": [450, 380, 680, 520],
        "attributes": {
          "type": "car",
          "occlusion": "0%"
        }
      },
      {
        "label": "pedestrian",
        "bbox": [820, 400, 870, 550],
        "attributes": {
          "pose": "walking",
          "age_group": "adult"
        }
      }
    ]
  }
}

Consigli per bounding box di qualità

Disegna i riquadri aderenti all'oggetto, così non dai in pasto al modello un mucchio di sfondo. Metti per iscritto come trattare i casi scomodi, come le occlusioni e gli oggetti tagliati dal bordo, e all'inizio guardate insieme un gruppo di esempi, così tutti li disegnano allo stesso modo. Tieni d'occhio il numero di riquadri e la distribuzione delle dimensioni: uno scarto improvviso di solito vuol dire che qualcuno sta interpretando le regole in modo diverso.

Prossimi passi

Aggiungi l'annotazione con poligoni per una segmentazione precisa
Scopri il rilevamento di keypoint per la stima della posa
Imposta il controllo di qualità per avere annotazioni affidabili

Documentazione completa su Annotazione di Immagini.