QDA モード

Potato を協働型の定性データ分析ワークスペースに変えます。QDA モードは、生きたコードブック、インビボ・コーディング、アナリスト・メモ、ケース、全文検索を組み合わせ、インタビュー記録や自由記述式アンケート回答、フィールドノートをコーディングします。

QDA モードは Potato を定性データ分析（QDA）ワークスペースに変えます。 qda_mode.enabled: true を設定すると、Potato は生きたコードブック、インビボ・コーディング、アナリスト・メモ、ケース、全文検索を一つのワークフローに組み合わせ、コーパス全体を読みながらコーディングできるようにします。これは NVivo、ATLAS.ti、MAXQDA、Dedoose といったツールに代わる、無料・オープンソース・ウェブベースの選択肢です。

定性データ分析とは、非構造化テキスト（インタビュー記録、自由記述式アンケート回答、フィールドノート、文書）の一節にコードを付与し、それらのコードからテーマを構築していく実践です。QDA モードは Potato の定性コーディング機能をまとめて有効にする単一のスイッチであり、一人のアナリストがコーパス全体にわたって作業する場面に合わせてデフォルト値が調整されています。

QDA モードのワークスペース QDA モードの Potato：コードブックに支えられたスパン・スキームと「検索」パネル、そして「メモ」と「コードブック」のサイドバー

QDA モードが変えるもの

qda_mode を有効にすると、単一コーダーの姿勢（一人のアナリストがコーパス全体を扱い、保護すべきアノテーター間サンプリングがない状態）が想定されます。それを前提に、Potato の汎用機能を定性向けのデフォルト値へ切り替えます。

機能	標準のデフォルト	`qda_mode.enabled: true` の場合
コードブックのモード	`fixed`	`open` —— コーディングしながらコードの追加・改名・色変更・移動・削除が可能
メモのサイドバー	オフ	オン
ケース	オフ	オン、自動検出付き
アノテーターの検索＆クレーム	オフ	利用可能（`search.annotator_claim: true` でオプトイン）
インビボ・コーディングのキー	`i`	`i`（`codebook: true` とマークされた任意の `span` スキームで有効）

すべてのデフォルト値はオーバーライドできます。QDA モードは出発点を変えるだけです。クラウドソーシングのバックエンドでは、QDA モード下であってもコードブックが fixed に強制ロックされるため、有償アノテーターが共有コードブックを作り変えることはできません。

クイックスタート

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]

cases、search、メモのブロックは省略可能です。QDA モードがすでにケースとメモをオンにしているためです。cases.key を選ぶ、あるいは annotator_claim を有効にするといった、デフォルト値の調整が必要な場合にのみ記述してください。

リポジトリのルートから、同梱の例を実行します。

bash

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

構成要素

生きたコードブック。 共有・可変なコードの集合。codebook: true でスキームを組み込みます。QDA モードでは、読みながらコードブックを拡張・再編成できます。
インビボ・コーディング。 codebook: true でもある span スキームで、一節を選択してインビボ・キー（codebook_invivo_key、デフォルトは i）を押すと、ハイライトしたテキストから直接コードを鋳造できます。コンポーザーが類似する重複コードを示すので、断片化させずに再利用できます。
メモ。 インスタンスや特定のテキスト選択に付与する分析的なノート。自分だけに非公開にも、チームと共有することもできます。
ケース。 抜粋を分析単位（参加者、文書）にまとめ、condition のようなケースレベルの属性を引き上げます。これにより、管理者のコード・クロス集計でコードを参加者レベルの変数と照らし合わせて表にできます。
検索。 コーパス全体に対する FTS5 全文検索。annotator_claim: true を使えば、コーダーは任意のマッチを自分のキューに取り込めます。

設定

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

オプション	デフォルト	説明
`qda_mode.enabled`	`false`	マスタースイッチ。QDA モードを初期化し、上記の定性向けデフォルト値を適用します。
`qda_mode.memos.enabled`	`true`	アナリスト・メモが有効かどうか。
`qda_mode.memos.show_sidebar_by_default`	`true`	メモのサイドバーを最初から開いておくかどうか。
`qda_mode.codebook.enabled`	`true`	コードブックが有効かどうか。
`qda_mode.codebook.mode`	`open`	アノテーターの編集権限：`open`、`extensible`、または `fixed`。トップレベルの `codebook_mode` と同等です。

未知の qda_mode.* キーは拒否されず保持されるため、後のフェーズで登場する機能に向けて前方互換な YAML を書けます。

コーディング結果のエクスポート

2 つのエクスポーターが、コーディング済みデータを定性研究の成果物に変えます。

codebook —— コードごとに 1 行。階層、説明、色、使用回数を含みます。
quotation_report —— コーディング済みスパンごとに 1 行：引用、その文字オフセット、ソースインスタンス、コーダー。include_memos=true を追加するとメモの行が付加されます。