Annotazione di immagini

Annota immagini con bounding box, poligoni, disegno libero e punti di riferimento.

Il sistema di annotazione di immagini di Potato supporta più metodi di annotazione per compiti di computer vision, inclusi il rilevamento di oggetti, la segmentazione e l'annotazione di keypoint.

Strumenti supportati

Strumento	Descrizione	Caso d'uso
`bbox`	Bounding box rettangolari	Rilevamento di oggetti
`polygon`	Poligoni a più punti	Segmentazione di istanze
`freeform`	Disegno a mano libera	Forme irregolari
`landmark`	Marcatori punto	Rilevamento di keypoint
`fill`	Strumento di riempimento pixel	Maschere di segmentazione
`eraser`	Cancella regioni dipinte	Correzione di maschere di segmentazione
`brush`	Pennello	Segmentazione fine

Configurazione di base

yaml

annotation_schemes:
  - name: "objects"
    description: "Draw boxes around all objects"
    annotation_type: "image_annotation"
    tools:
      - bbox
    labels:
      - person
      - car
      - bicycle

Opzioni di configurazione

Campo	Tipo	Predefinito	Descrizione
`name`	string	Obbligatorio	Identificatore univoco dell'annotazione
`description`	string	Obbligatorio	Istruzioni mostrate agli annotatori
`annotation_type`	string	Obbligatorio	Deve essere `"image_annotation"`
`tools`	list	Obbligatorio	Strumenti di annotazione abilitati (`bbox`, `polygon`, `freeform`, `landmark`, `fill`, `eraser`, `brush`)
`labels`	list	Obbligatorio	Etichette di categoria per le annotazioni
`zoom_enabled`	boolean	true	Abilita i controlli di zoom
`pan_enabled`	boolean	true	Abilita la navigazione tramite trascinamento
`min_annotations`	integer	0	Annotazioni minime richieste
`max_annotations`	integer	null	Annotazioni massime consentite (null = illimitato)
`freeform_brush_size`	integer	5	Dimensione del pennello per il disegno libero
`freeform_simplify`	float	2.0	Fattore di semplificazione del percorso

Configurazione delle etichette

Le etichette possono essere semplici stringhe o oggetti dettagliati:

yaml

# Simple labels (auto-colored)
labels:
  - person
  - car
  - tree
 
# Detailed labels with custom colors and shortcuts
labels:
  - name: "person"
    color: "#FF6B6B"
    key_value: "1"
  - name: "car"
    color: "#4ECDC4"
    key_value: "2"
  - name: "bicycle"
    color: "#45B7D1"
    key_value: "3"

Esempi

Rilevamento di oggetti (Bounding Box)

yaml

annotation_schemes:
  - name: "detection"
    description: "Draw bounding boxes around all vehicles"
    annotation_type: "image_annotation"
    tools:
      - bbox
    labels:
      - name: "car"
        color: "#3B82F6"
        key_value: "1"
      - name: "truck"
        color: "#10B981"
        key_value: "2"
      - name: "motorcycle"
        color: "#F59E0B"
        key_value: "3"
    min_annotations: 1
    zoom_enabled: true

Segmentazione di istanze (Poligoni)

yaml

annotation_schemes:
  - name: "segmentation"
    description: "Draw polygons around each object"
    annotation_type: "image_annotation"
    tools:
      - polygon
    labels:
      - name: "building"
        color: "#8B5CF6"
      - name: "road"
        color: "#64748B"
      - name: "vegetation"
        color: "#22C55E"
    zoom_enabled: true
    pan_enabled: true

Annotazione di keypoint (Landmark)

yaml

annotation_schemes:
  - name: "facial_landmarks"
    description: "Mark facial keypoints"
    annotation_type: "image_annotation"
    tools:
      - landmark
    labels:
      - name: "left_eye"
        color: "#3B82F6"
      - name: "right_eye"
        color: "#3B82F6"
      - name: "nose"
        color: "#10B981"
      - name: "left_mouth"
        color: "#F59E0B"
      - name: "right_mouth"
        color: "#F59E0B"

Strumenti multipli

yaml

annotation_schemes:
  - name: "mixed_annotation"
    description: "Use boxes for objects and polygons for regions"
    annotation_type: "image_annotation"
    tools:
      - bbox
      - polygon
    labels:
      - name: "object"
        color: "#3B82F6"
      - name: "region"
        color: "#10B981"

Scorciatoie da tastiera

Tasto	Azione
`b`	Attiva lo strumento bounding box
`p`	Attiva lo strumento poligono
`f`	Attiva lo strumento libero
`l`	Attiva lo strumento landmark
`1-9`	Seleziona etichetta
`Delete`	Rimuovi l'annotazione selezionata
`Ctrl+Z`	Annulla
`Ctrl+Y`	Ripristina
`+` / `-`	Zoom avanti/indietro

Formato dei dati

Dati di input

Il file di dati deve includere percorsi o URL delle immagini:

json

[
  {
    "id": "img_001",
    "image_url": "https://example.com/images/photo1.jpg"
  },
  {
    "id": "img_002",
    "image_url": "/data/images/photo2.png"
  }
]

Configura il campo immagine nella configurazione:

yaml

item_properties:
  id_key: id
  text_key: image_url

Formato di output

Le annotazioni includono dati geometrici per ogni annotazione:

json

{
  "id": "img_001",
  "annotations": {
    "objects": [
      {
        "id": "ann_1",
        "type": "bbox",
        "label": "car",
        "geometry": {
          "x": 100,
          "y": 150,
          "width": 200,
          "height": 100
        }
      },
      {
        "id": "ann_2",
        "type": "polygon",
        "label": "building",
        "geometry": {
          "points": [
            [50, 50],
            [150, 50],
            [150, 200],
            [50, 200]
          ]
        }
      }
    ]
  }
}

Formati immagine supportati

JPEG / JPG
PNG
GIF
WebP

Maschere di segmentazione

Novità nella v2.2.0

Gli strumenti fill, eraser e brush abilitano l'annotazione di maschere di segmentazione a livello di pixel. Questi strumenti sono ideali per i compiti di segmentazione semantica in cui sono necessari confini di regione precisi.

yaml

annotation_schemes:
  - name: "segmentation"
    description: "Paint segmentation masks"
    annotation_type: "image_annotation"
    tools:
      - fill
      - eraser
      - brush
    labels:
      - name: "foreground"
        color: "#3B82F6"
      - name: "background"
        color: "#6B7280"
    freeform_brush_size: 10

Tasto	Azione
`i`	Attiva lo strumento riempimento
`e`	Attiva lo strumento gomma
`r`	Attiva lo strumento pennello

Bounding box su PDF/documenti

Novità nella v2.2.0

Disegna bounding box su pagine PDF e immagini di documenti. Se combinato con il tipo di visualizzazione pdf in instance_display, gli annotatori possono disegnare riquadri su singole pagine di documenti PDF.

yaml

instance_display:
  fields:
    - key: pdf_url
      type: pdf
 
annotation_schemes:
  - name: "document_regions"
    description: "Draw boxes around figures and tables"
    annotation_type: "image_annotation"
    tools:
      - bbox
    labels:
      - name: "figure"
        color: "#3B82F6"
      - name: "table"
        color: "#10B981"
      - name: "equation"
        color: "#F59E0B"

Buone pratiche

Usa gli strumenti appropriati - Bounding box per il rilevamento rapido, poligoni per confini precisi, fill/brush per la segmentazione
Definisci etichette chiare - Usa categorie distinte e non sovrapposte
Imposta limiti di annotazione - Usa min_annotations per garantire la completezza
Abilita lo zoom - Essenziale per annotazioni dettagliate su immagini ad alta risoluzione
Usa le scorciatoie da tastiera - Accelera significativamente l'annotazione
Fornisci colori per le etichette - Rende più facile distinguere visivamente le annotazioni