Skip to content

Controle de Intervalo (Range Slider)

Configure a anotação de controle deslizante de intervalo com dois cursores no Potato para selecionar uma faixa numérica com limites, tamanho de passo e rótulos de extremidade personalizáveis.

O esquema de anotação de controle de intervalo oferece um controle deslizante com dois cursores que permite aos anotadores selecionar uma faixa de valores em vez de um único ponto. Isso é útil para tarefas em que a resposta é um intervalo ou um período, como estimar faixas etárias, janelas de tempo ou intervalos de confiança.

Visão Geral

Diferente de um controle deslizante padrão, que captura um único valor, o controle de intervalo tem dois cursores arrastáveis que representam as extremidades inferior e superior de uma faixa. Os anotadores arrastam qualquer um dos cursores para definir o intervalo. Os valores atuais são exibidos ao lado do controle deslizante para maior precisão.

Início Rápido

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"

Opções de Configuração

CampoTipoPadrãoDescrição
annotation_typestringObrigatórioDeve ser "range_slider"
namestringObrigatórioIdentificador único para este esquema
descriptionstringObrigatórioInstruções exibidas aos anotadores
min_valuenumber0Valor mínimo da escala do controle deslizante
max_valuenumber100Valor máximo da escala do controle deslizante
stepnumber1Incremento entre os valores selecionáveis
left_labelstringRótulo exibido na extremidade esquerda (mínima) do controle deslizante
right_labelstringRótulo exibido na extremidade direita (máxima) do controle deslizante
show_valuesbooleantrueExibe os valores inferior e superior atualmente selecionados
default_lownumberPosição padrão do cursor inferior
default_highnumberPosição padrão do cursor superior
label_requirement.requiredbooleanfalseDefine se a anotação deve ser concluída antes de prosseguir

Exemplos

Estimativa de Faixa Etária

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"
    default_low: 25
    default_high: 45

Intervalo de Confiança

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
    label_requirement:
      required: true

Janela de Tempo

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"
    default_low: 9
    default_high: 17

Faixa de Conforto Térmico

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 de Saída

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

A saída sempre contém os valores low e high dentro da faixa configurada de min_value a max_value.

Boas Práticas

  1. Defina padrões significativos - use default_low e default_high para evitar que todos os anotadores fiquem ancorados nos extremos
  2. Escolha um tamanho de passo adequado - passos refinados (0.1) para tarefas precisas, passos grosseiros (5, 10) para estimativas aproximadas
  3. Adicione rótulos de extremidade - left_label e right_label oferecem contexto semântico além dos números brutos
  4. Mantenha show_values ativado - leituras numéricas ajudam os anotadores a fazer seleções precisas
  5. Use para tarefas de intervalo de verdade - se apenas um único valor é necessário, use o Controle Deslizante padrão

Leitura Complementar

Para detalhes de implementação, consulte a documentação de origem.