Modo QDA

O Modo QDA transforma o Potato em um espaço de trabalho para análise de dados qualitativos (QDA). Defina qda_mode.enabled: true e o Potato reúne um livro de códigos vivo, codificação in vivo, memorandos do analista, casos e busca de texto completo em um único fluxo de trabalho para ler e codificar um corpus inteiro. É uma alternativa gratuita, de código aberto e baseada na web a ferramentas como NVivo, ATLAS.ti, MAXQDA e Dedoose.

A análise de dados qualitativos é a prática de atribuir códigos a trechos de texto não estruturado (transcrições de entrevistas, respostas abertas de pesquisas, notas de campo ou documentos) e organizar esses códigos em temas. O Modo QDA é o interruptor único que habilita em conjunto os recursos de codificação qualitativa do Potato, com padrões ajustados para um analista que trabalha sobre todo o corpus.

Potato no Modo QDA: um esquema de intervalo apoiado por um livro de códigos, com o painel de busca «Localizar» e as barras laterais «Notas» e «Livro de códigos»

O que o Modo QDA muda

Habilitar qda_mode pressupõe uma postura de codificador único (um analista sobre todo o corpus, sem amostragem entre anotadores a proteger). Sobre essa base, ele alterna os recursos universais do Potato para seus padrões qualitativos:

Todo padrão pode ser substituído. O Modo QDA apenas muda o ponto de partida. Um backend de crowdsourcing força o bloqueio do livro de códigos em fixed mesmo no Modo QDA, de modo que anotadores remunerados não possam remodelar o livro de códigos compartilhado.

Início rápido

annotation_task_name: My Qualitative Study
task_dir: .
output_annotation_dir: annotation_output/
data_files:
- data/interviews.json
item_properties:
  id_key: id
  text_key: text
 
qda_mode:
  enabled: true            # compose codebook + memos + cases + search
 
codebook_invivo_key: i     # mint a code from a text selection
 
cases:                     # group excerpts into units of analysis
  enabled: true
  key: participant_id
  attributes: [condition]
 
search:                    # let the coder jump to any matching excerpt
  enabled: true
  annotator_claim: true
 
annotation_schemes:
- annotation_type: span    # span + codebook = in-vivo coding
  name: codes
  description: Highlight a passage and apply (or mint, via `i`) a code
  codebook: true
  labels: [access barriers, cost concerns, provider trust]

Os blocos cases, search e de memorandos são opcionais, porque o Modo QDA já ativa casos e memorandos. Escreva-os apenas para ajustar os padrões, como escolher a cases.key ou habilitar annotator_claim.

Execute o exemplo incluído a partir da raiz do repositório:

python potato/flask_server.py start examples/advanced/qda-mode-example/config.yaml -p 8000

As peças

• Livro de códigos vivo. O conjunto compartilhado e mutável de códigos. Inclua um esquema com codebook: true; no Modo QDA você pode expandir e reorganizar o livro de códigos à medida que lê.
• Codificação in vivo. Em um esquema span que também seja codebook: true, selecione um trecho e pressione a tecla in vivo (codebook_invivo_key, padrão i) para cunhar um código diretamente a partir do texto destacado. O compositor traz à tona códigos quase duplicados para que você reutilize em vez de fragmentar.
• Memorandos. Notas analíticas anexadas a uma instância ou a uma seleção de texto específica, mantidas privadas para você ou compartilhadas com a equipe.
• Casos. Agrupe trechos em unidades de análise (um participante, um documento) e extraia atributos no nível do caso, como condition, para que a tabela cruzada de códigos do administrador possa tabular os códigos contra variáveis no nível do participante.
• Busca. Busca de texto completo FTS5 sobre o corpus. Com annotator_claim: true, um codificador pode puxar qualquer correspondência para a própria fila.

Configuração

qda_mode:
  enabled: true
  memos:
    enabled: true                 # memo defaults under QDA Mode
    show_sidebar_by_default: true
  codebook:
    enabled: true
    mode: open                    # open | extensible | fixed

Chaves qda_mode.* desconhecidas são preservadas em vez de rejeitadas, então você pode escrever YAML compatível com o futuro para recursos que chegarem em fases posteriores.

Exportar sua codificação

Dois exportadores transformam dados codificados em entregáveis de pesquisa qualitativa:

• codebook —— uma linha por código, com sua hierarquia, descrição, cor e contagem de uso.
• quotation_report —— uma linha por intervalo codificado: a citação, seus deslocamentos de caractere, a instância de origem e o codificador. Adicione include_memos=true para anexar linhas de memorandos.

python -m potato.export config.yaml --format quotation_report \
  --option include_memos=true -o quotations.csv

Os recursos codebook, quotation_report e de concordância entre anotadores (kappa de Cohen e de Fleiss) chegaram todos na onda de codificação qualitativa da versão 2.5.0. Consulte Novidades para ver o histórico de versões.

Relacionado

• Guia de concordância entre anotadores —— kappa de Cohen e de Fleiss para medir a confiabilidade do codificador
• Formatos de exportação —— a referência completa de exportadores e colunas
• Modo solo —— rotulagem com um único anotador, assistida por LLM

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