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.

Controle deslizante de intervalo de dois marcadores do Potato definido para uma faixa etária de 25 a 75Controle deslizante de intervalo no Potato

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.