Skip to content

Cursore di intervallo

Configura in Potato l'annotazione con cursore a due maniglie per selezionare un intervallo numerico, con estremi, passo ed etichette personalizzabili.

Lo schema di annotazione a cursore di intervallo offre un cursore con due maniglie che permette agli annotatori di selezionare un intervallo di valori invece di un singolo punto. Serve nei compiti in cui la risposta è un intervallo, per esempio la stima di fasce d'età, finestre temporali o intervalli di confidenza.

Cursore di intervallo a due maniglie di Potato impostato su una fascia d'età da 25 a 75Range slider in Potato

Panoramica

A differenza del cursore semplice, che registra un solo valore, il cursore di intervallo ha due maniglie trascinabili che rappresentano l'estremo inferiore e quello superiore. Gli annotatori trascinano l'una o l'altra per definire l'intervallo. I valori correnti sono mostrati accanto al cursore, così la selezione resta precisa.

Avvio rapido

yaml
annotation_schemes:
  - annotation_type: range_slider
    name: age_range
    description: Estimate the age range of the author.
    min_value: 0
    max_value: 100
    step: 1
    left_label: "Young"
    right_label: "Old"

Opzioni di configurazione

CampoTipoPredefinitoDescrizione
annotation_typestringObbligatorioDeve essere "range_slider"
namestringObbligatorioIdentificatore univoco per questo schema
descriptionstringObbligatorioIstruzioni visualizzate agli annotatori
min_valuenumber0Valore minimo della scala del cursore
max_valuenumber100Valore massimo della scala del cursore
stepnumber1Incremento tra un valore selezionabile e il successivo
left_labelstringEtichetta mostrata all'estremo sinistro (minimo) del cursore
right_labelstringEtichetta mostrata all'estremo destro (massimo) del cursore
show_valuesbooleantrueMostra i valori inferiore e superiore attualmente selezionati
default_lownumberPosizione iniziale della maniglia inferiore
default_highnumberPosizione iniziale della maniglia superiore
label_requirement.requiredbooleanfalseSe l'annotazione deve essere completata prima di proseguire

Esempi

Stima della fascia d'età

yaml
annotation_schemes:
  - annotation_type: range_slider
    name: age_estimate
    description: What age range do you think the author falls in?
    min_value: 13
    max_value: 90
    step: 1
    left_label: "Younger"
    right_label: "Older"

Intervallo di confidenza

yaml
annotation_schemes:
  - annotation_type: range_slider
    name: confidence_interval
    description: Select the range within which you believe the true value falls.
    min_value: 0
    max_value: 100
    step: 5
    left_label: "0%"
    right_label: "100%"
    show_values: true

Finestra temporale

yaml
annotation_schemes:
  - annotation_type: range_slider
    name: time_window
    description: When during the day is this activity most likely? (hours)
    min_value: 0
    max_value: 24
    step: 0.5
    left_label: "Midnight"
    right_label: "Midnight"

Intervallo di temperatura confortevole

yaml
annotation_schemes:
  - annotation_type: range_slider
    name: comfort_range
    description: What temperature range (°F) do you find comfortable?
    min_value: 40
    max_value: 110
    step: 1
    left_label: "Cold"
    right_label: "Hot"
    show_values: true

Formato di output

json
{
  "age_estimate": {
    "labels": {
      "low": 28,
      "high": 42
    }
  }
}

L'output contiene sempre i valori low e high, compresi nell'intervallo configurato tra min_value e max_value.

Buone pratiche

  1. Imposta valori iniziali sensati - usa default_low e default_high per non ancorare tutti gli annotatori agli estremi
  2. Scegli un passo adeguato - passi fini (0.1) per i compiti di precisione, passi larghi (5, 10) per le stime approssimative
  3. Aggiungi le etichette agli estremi - left_label e right_label danno un contesto che i soli numeri non trasmettono
  4. Lascia attivo show_values - la lettura numerica aiuta a scegliere con precisione
  5. Usalo solo per veri intervalli - se serve un valore unico, usa il Cursore standard

Ulteriori letture

Per i dettagli implementativi, vedi la documentazione sorgente.