Mode QDA

Transformez Potato en un espace de travail collaboratif d'analyse de données qualitatives. Le mode QDA réunit un livre de codes vivant, le codage in vivo, les mémos de l'analyste, les cas et la recherche en texte intégral pour coder des transcriptions d'entretiens, des réponses ouvertes d'enquêtes et des notes de terrain.

Le mode QDA transforme Potato en un espace de travail d'analyse de données qualitatives (QDA). Définissez qda_mode.enabled: true et Potato réunit un livre de codes vivant, le codage in vivo, les mémos de l'analyste, les cas et la recherche en texte intégral dans un seul flux de travail pour lire et coder un corpus entier. C'est une alternative gratuite, open source et accessible depuis le web à des outils comme NVivo, ATLAS.ti, MAXQDA et Dedoose.

L'analyse de données qualitatives consiste à attribuer des codes à des passages de texte non structuré (transcriptions d'entretiens, réponses ouvertes d'enquêtes, notes de terrain ou documents) et à regrouper ces codes en thèmes. Le mode QDA est l'interrupteur unique qui active ensemble les fonctions de codage qualitatif de Potato, avec des valeurs par défaut réglées pour un analyste travaillant sur l'ensemble du corpus.

Espace de travail du mode QDA Potato en mode QDA : un schéma de plage adossé à un livre de codes, avec le panneau de recherche « Rechercher » et les barres latérales « Notes » et « Livre de codes »

Ce que change le mode QDA

Activer qda_mode suppose une posture à codeur unique (un analyste sur l'ensemble du corpus, sans échantillonnage inter-annotateurs à préserver). Sur cette base, il bascule les fonctions universelles de Potato vers leurs valeurs par défaut qualitatives :

Fonction	Valeur par défaut standard	Avec `qda_mode.enabled: true`
Mode du livre de codes	`fixed`	`open` —— ajoutez, renommez, recolorez, déplacez ou supprimez des codes pendant que vous codez
Barre latérale des mémos	désactivée	activée
Cas	désactivés	activés, avec détection automatique
Recherche et revendication par l'annotateur	désactivée	disponible (à activer avec `search.annotator_claim: true`)
Touche de codage in vivo	`i`	`i` (active sur tout schéma `span` marqué `codebook: true`)

Chaque valeur par défaut peut être remplacée. Le mode QDA ne change que le point de départ. Un backend de crowdsourcing verrouille de force le livre de codes sur fixed même sous le mode QDA, de sorte que les annotateurs rémunérés ne peuvent pas remodeler le livre de codes partagé.

Démarrage rapide

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]

Les blocs cases, search et mémos sont facultatifs, car le mode QDA active déjà les cas et les mémos. Ne les écrivez que pour ajuster les valeurs par défaut, par exemple choisir la cases.key ou activer annotator_claim.

Exécutez l'exemple fourni depuis la racine du dépôt :

bash

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

Les composants

Livre de codes vivant. L'ensemble partagé et modifiable de codes. Intégrez un schéma avec codebook: true ; sous le mode QDA, vous pouvez enrichir et réorganiser le livre de codes au fil de votre lecture.
Codage in vivo. Sur un schéma span qui est aussi codebook: true, sélectionnez un passage et appuyez sur la touche in vivo (codebook_invivo_key, par défaut i) pour frapper un code directement à partir du texte surligné. Le compositeur fait remonter les codes quasi dupliqués afin que vous réutilisiez au lieu de fragmenter.
Mémos. Notes analytiques rattachées à une instance ou à une sélection de texte précise, gardées privées ou partagées avec l'équipe.
Cas. Regroupez des extraits en unités d'analyse (un participant, un document) et extrayez des attributs au niveau du cas comme condition, afin que le tableau croisé des codes côté administrateur puisse croiser les codes avec des variables au niveau du participant.
Recherche. Recherche en texte intégral FTS5 sur le corpus. Avec annotator_claim: true, un codeur peut tirer n'importe quelle correspondance dans sa propre file.

Configuration

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

Option	Par défaut	Description
`qda_mode.enabled`	`false`	Interrupteur principal. Initialise le mode QDA et applique les valeurs par défaut qualitatives ci-dessus.
`qda_mode.memos.enabled`	`true`	Si les mémos de l'analyste sont actifs.
`qda_mode.memos.show_sidebar_by_default`	`true`	Si la barre latérale des Notes démarre ouverte.
`qda_mode.codebook.enabled`	`true`	Si le livre de codes est actif.
`qda_mode.codebook.mode`	`open`	Droits d'édition de l'annotateur : `open`, `extensible` ou `fixed`. Équivalent au `codebook_mode` de niveau supérieur.

Les clés qda_mode.* inconnues sont conservées plutôt que rejetées, ce qui vous permet d'écrire un YAML compatible avec l'avenir pour des fonctions qui arriveront lors de phases ultérieures.

Exporter votre codage

Deux exportateurs transforment les données codées en livrables de recherche qualitative :

codebook —— une ligne par code, avec sa hiérarchie, sa description, sa couleur et son nombre d'utilisations.
quotation_report —— une ligne par plage codée : la citation, ses décalages de caractères, l'instance source et le codeur. Ajoutez include_memos=true pour annexer les lignes de mémos.

bash

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

Les fonctions codebook, quotation_report et d'accord inter-annotateurs (kappa de Cohen et de Fleiss) sont toutes arrivées avec la vague de codage qualitatif de la version 2.5.0. Consultez Nouveautés pour l'historique des versions.

Connexe

Guide de l'accord inter-annotateurs —— kappa de Cohen et de Fleiss pour mesurer la fiabilité du codeur
Formats d'exportation —— la référence complète des exportateurs et des colonnes
Mode solo —— étiquetage à annotateur unique, assisté par LLM

Pour les détails d'implémentation, consultez la documentation source.