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을 작성할 수 있습니다.

코딩 내보내기

두 가지 내보내기 도구가 코딩된 데이터를 정성 연구 산출물로 바꿉니다.

codebook —— 코드당 한 행으로, 계층, 설명, 색상, 사용 횟수를 포함합니다.
quotation_report —— 코딩된 스팬당 한 행입니다: 인용문, 문자 오프셋, 출처 인스턴스, 코더. include_memos=true를 추가하면 메모 행이 덧붙습니다.