Modo QDA

El modo QDA convierte Potato en un espacio de trabajo para el análisis de datos cualitativos (QDA). Establece qda_mode.enabled: true y Potato compone un libro de códigos vivo, codificación in vivo, memorandos del analista, casos y búsqueda de texto completo en un solo flujo de trabajo para leer y codificar un corpus entero. Es una alternativa gratuita, de código abierto y basada en la web a herramientas como NVivo, ATLAS.ti, MAXQDA y Dedoose.

El análisis de datos cualitativos es la práctica de asignar códigos a pasajes de texto no estructurado (transcripciones de entrevistas, respuestas abiertas de encuestas, notas de campo o documentos) y agrupar esos códigos en temas. El modo QDA es el interruptor único que habilita en conjunto las funciones de codificación cualitativa de Potato, con valores predeterminados ajustados para un analista que trabaja sobre todo el corpus.

Potato en modo QDA: un esquema de tramo respaldado por un libro de códigos con el panel de búsqueda «Buscar» y las barras laterales «Notas» y «Libro de códigos»

Qué cambia el modo QDA

Habilitar qda_mode asume una postura de codificador único (un analista sobre todo el corpus, sin muestreo entre anotadores que proteger). Sobre esa base, cambia las funciones universales de Potato a sus valores predeterminados cualitativos:

Todos los valores predeterminados pueden anularse. El modo QDA solo cambia el punto de partida. Un backend de crowdsourcing bloquea por la fuerza el libro de códigos en fixed incluso bajo el modo QDA, de modo que los anotadores remunerados no pueden remodelar el libro de códigos compartido.

Inicio 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]

Los bloques cases, search y de memorandos son opcionales, porque el modo QDA ya activa los casos y los memorandos. Escríbelos solo para ajustar los valores predeterminados, como elegir cases.key o habilitar annotator_claim.

Ejecuta el ejemplo incluido desde la raíz del repositorio:

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

Las piezas

• Libro de códigos vivo. El conjunto compartido y mutable de códigos. Incorpora un esquema con codebook: true; bajo el modo QDA puedes ampliar y reorganizar el libro de códigos a medida que lees.
• Codificación in vivo. En un esquema span que también sea codebook: true, selecciona un pasaje y pulsa la tecla in vivo (codebook_invivo_key, por defecto i) para acuñar un código directamente desde el texto resaltado. El compositor muestra los códigos casi duplicados para que reutilices en lugar de fragmentar.
• Memorandos. Notas analíticas adjuntas a una instancia o a una selección de texto concreta, mantenidas en privado para ti o compartidas con el equipo.
• Casos. Agrupa extractos en unidades de análisis (un participante, un documento) y extrae atributos a nivel de caso como condition, para que la tabla cruzada de códigos del administrador pueda tabular los códigos frente a variables a nivel de participante.
• Búsqueda. Búsqueda de texto completo FTS5 sobre el corpus. Con annotator_claim: true, un codificador puede arrastrar cualquier coincidencia a su propia cola.

Configuración

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

Las claves qda_mode.* desconocidas se conservan en lugar de rechazarse, así que puedes escribir YAML compatible con el futuro para funciones que lleguen en fases posteriores.

Exportar tu codificación

Dos exportadores convierten los datos codificados en entregables de investigación cualitativa:

• codebook —— una fila por código, con su jerarquía, descripción, color y recuento de uso.
• quotation_report —— una fila por tramo codificado: la cita, sus desplazamientos de caracteres, la instancia de origen y el codificador. Añade include_memos=true para anexar filas de memorandos.

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

Las funciones codebook, quotation_report y de acuerdo entre anotadores (kappa de Cohen y de Fleiss) se incorporaron todas en la ola de codificación cualitativa de la versión 2.5.0. Consulta Novedades para ver el historial de versiones.

Relacionado

• Guía de acuerdo entre anotadores —— kappa de Cohen y de Fleiss para medir la fiabilidad del codificador
• Formatos de exportación —— la referencia completa de exportadores y columnas
• Modo en solitario —— etiquetado con un solo anotador y asistido por LLM

Para los detalles de implementación, consulta la documentación de origen.