Modalità QDA

Trasforma Potato in uno spazio di lavoro collaborativo per l'analisi qualitativa dei dati. La modalità QDA combina un libro dei codici vivo, la codifica in vivo, i memo dell'analista, i casi e la ricerca full-text per codificare trascrizioni di interviste, risposte aperte ai sondaggi e note sul campo.

La modalità QDA trasforma Potato in uno spazio di lavoro per l'analisi qualitativa dei dati (QDA). Imposta qda_mode.enabled: true e Potato combina un libro dei codici vivo, la codifica in vivo, i memo dell'analista, i casi e la ricerca full-text in un unico flusso di lavoro per leggere e codificare un intero corpus. È un'alternativa gratuita, open source e basata sul web a strumenti come NVivo, ATLAS.ti, MAXQDA e Dedoose.

L'analisi qualitativa dei dati è la pratica di assegnare codici a passaggi di testo non strutturato (trascrizioni di interviste, risposte aperte ai sondaggi, note sul campo o documenti) e di costruire da quei codici dei temi. La modalità QDA è l'unico interruttore che abilita insieme le funzioni di codifica qualitativa di Potato, con valori predefiniti calibrati per un analista che lavora sull'intero corpus.

Spazio di lavoro della modalità QDA Potato in modalità QDA: uno schema di intervallo supportato da un libro dei codici, con il pannello di ricerca «Trova» e le barre laterali «Note» e «Libro dei codici»

Cosa cambia la modalità QDA

Abilitare qda_mode presuppone un assetto a codificatore singolo (un analista sull'intero corpus, senza campionamento tra annotatori da proteggere). Su questa base, commuta le funzioni universali di Potato ai loro valori predefiniti qualitativi:

Funzione	Valore predefinito standard	Con `qda_mode.enabled: true`
Modalità del libro dei codici	`fixed`	`open` —— aggiungi, rinomina, ricolora, sposta o elimina i codici mentre codifichi
Barra laterale dei memo	disattivata	attivata
Casi	disattivati	attivati, con rilevamento automatico
Ricerca e rivendicazione dell'annotatore	disattivata	disponibile (si attiva con `search.annotator_claim: true`)
Tasto di codifica in vivo	`i`	`i` (attivo su qualsiasi schema `span` contrassegnato con `codebook: true`)

Ogni valore predefinito può essere sovrascritto. La modalità QDA cambia solo il punto di partenza. Un backend di crowdsourcing blocca forzatamente il libro dei codici su fixed anche in modalità QDA, così gli annotatori retribuiti non possono rimodellare il libro dei codici condiviso.

Avvio rapido

yaml

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]

I blocchi cases, search e dei memo sono facoltativi, perché la modalità QDA attiva già casi e memo. Scrivili solo per regolare i valori predefiniti, ad esempio per scegliere la cases.key o abilitare annotator_claim.

Esegui l'esempio incluso dalla radice del repository:

bash

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

I componenti

Libro dei codici vivo. L'insieme condiviso e modificabile di codici. Includi uno schema con codebook: true; in modalità QDA puoi ampliare e riorganizzare il libro dei codici man mano che leggi.
Codifica in vivo. Su uno schema span che è anche codebook: true, seleziona un passaggio e premi il tasto in vivo (codebook_invivo_key, predefinito i) per coniare un codice direttamente dal testo evidenziato. Il compositore mette in evidenza i codici quasi duplicati così da farti riutilizzare invece di frammentare.
Memo. Note analitiche allegate a un'istanza o a una specifica selezione di testo, mantenute private per te o condivise con il team.
Casi. Raggruppa gli estratti in unità di analisi (un partecipante, un documento) ed estrai attributi a livello di caso come condition, così che la tabella incrociata dei codici dell'amministratore possa tabulare i codici rispetto a variabili a livello di partecipante.
Ricerca. Ricerca full-text FTS5 sul corpus. Con annotator_claim: true, un codificatore può trascinare qualsiasi corrispondenza nella propria coda.

Configurazione

yaml

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

Opzione	Predefinito	Descrizione
`qda_mode.enabled`	`false`	Interruttore principale. Inizializza la modalità QDA e applica i valori predefiniti qualitativi qui sopra.
`qda_mode.memos.enabled`	`true`	Se i memo dell'analista sono attivi.
`qda_mode.memos.show_sidebar_by_default`	`true`	Se la barra laterale delle Note è inizialmente aperta.
`qda_mode.codebook.enabled`	`true`	Se il libro dei codici è attivo.
`qda_mode.codebook.mode`	`open`	Diritti di modifica dell'annotatore: `open`, `extensible` o `fixed`. Equivalente al `codebook_mode` di livello superiore.

Le chiavi qda_mode.* sconosciute vengono conservate anziché rifiutate, così puoi scrivere YAML compatibile con il futuro per funzioni che arriveranno in fasi successive.

Esportare la tua codifica

Due esportatori trasformano i dati codificati in prodotti della ricerca qualitativa:

codebook —— una riga per codice, con la sua gerarchia, descrizione, colore e conteggio d'uso.
quotation_report —— una riga per intervallo codificato: la citazione, i suoi offset di caratteri, l'istanza di origine e il codificatore. Aggiungi include_memos=true per accodare le righe dei memo.

bash

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

Le funzioni codebook, quotation_report e di accordo tra annotatori (kappa di Cohen e di Fleiss) sono tutte arrivate con l'ondata di codifica qualitativa della versione 2.5.0. Consulta Novità per la cronologia delle versioni.

Correlati

Guida all'accordo tra annotatori —— kappa di Cohen e di Fleiss per misurare l'affidabilità del codificatore
Formati di esportazione —— il riferimento completo a esportatori e colonne
Modalità singola —— etichettatura con un solo annotatore, assistita da LLM

Per i dettagli di implementazione, consulta la documentazione sorgente.