Skip to content

Lückentext (Cloze)

Cloze- und C-Test-Passagen zu einer Potato-Studie hinzufügen, mit einem auf dem Server verbleibenden Lösungsschlüssel und einer Auswertung pro Lücke im CSV-Export.

Neu in v2.12.0

Ein cloze-Schema zeigt eine Passage mit Lücken, in die die annotierende Person tippt. Es eignet sich für Cloze-Tests und C-Tests zur Sprachkompetenz, Verständnisprüfungen, Normierung der Vorhersagbarkeit und die Prüfung, was sich jemand beim Lesen von einem Item gemerkt hat.

Der Lösungsschlüssel bleibt auf dem Server. Er dient zur Auswertung des Exports und wird nie an den Browser gesendet.

Eine Passage

yaml
annotation_schemes:
  - annotation_type: cloze
    name: proficiency
    description: Fill in each blank with one word.
    text: "The library opens at nine and [[closes|shuts]] at six."
    scoring: case_insensitive
    label_requirement:
      required: true

Jedes [[...]] ist eine Lücke. Der Text darin ist die akzeptierte Antwort, mit | zwischen Alternativen. [[]] ist eine Lücke ohne Schlüssel, die aufgezeichnet, aber nicht ausgewertet wird.

Eine feste Passage passt auf eine Umfrageseite, etwa als Screener zur Sprachkompetenz in der prestudy-Phase (Mehrphasige Workflows).

Eine Passage pro Item

yaml
annotation_schemes:
  - annotation_type: cloze
    name: completion
    description: Fill in each blank with one word.
    source_field: passage
    answer_field: answers
json
{"id": "p1", "text": "Passage 1",
 "passage": "Rain is expected [[]] the afternoon, so bring an [[]].",
 "answers": [["in", "during"], "umbrella"]}

source_field nennt das Item-Feld, das die Passage enthält, mit Lücken in der Form [[]]. answer_field nennt ein Feld mit einer Liste, die einen Eintrag pro Lücke enthält, jeweils einen String (mit | zwischen Alternativen) oder eine Liste. Ein Item mit nur einer Lücke kann einen einfachen String verwenden. Einträge über die Anzahl der Lücken hinaus werden ignoriert, mit einer Warnung im Serverprotokoll.

Das Antwortfeld wird aus der Seite und aus den Item-APIs entfernt. Text, der in einer Item-Passage innerhalb von [[...]] steht, wird geleert, bevor das Item die Seite erreicht, sodass auch ein versehentlich dort eingetragener Schlüssel nicht angezeigt wird.

Optionen

SchlüsselStandardwertBedeutung
textEine Passage für jedes Item. Verwenden Sie dies oder source_field
source_fieldItem-Feld mit der Passage jedes Items
answer_fieldItem-Feld mit dem Schlüssel jedes Items, nur zusammen mit source_field
scoringcase_insensitiveexact, case_insensitive oder normalized, das zusätzlich Akzente und Satzzeichen ignoriert
input_width10Breite jeder Lücke, in Zeichen
label_requirementrequired: true verlangt Text in jeder Lücke, geprüft auf der Seite und auf dem Server

Daten

Jede Lücke wird als Label des Schemas gespeichert, blank_1, blank_2 usw., mit dem eingegebenen Text als Wert. Für jede Lücke mit Schlüssel fügen die CSV- und TSV-Exporte <scheme>.blank_<n>_correct (1 oder 0) hinzu, dazu <scheme>.score und <scheme>.scored_blanks für das Item. Eine leer gelassene Passage erhält 0 Punkte.

Cloze-Antworten auf Umfrageseiten werden mit den anderen Phasenantworten exportiert (export_include_phase_data: true) und dort nicht ausgewertet.

Beispiel

bash
python potato/flask_server.py start examples/classification/cloze-test/config.yaml -p 8000

Weiterführende Informationen

Implementierungsdetails finden Sie in der Quelldokumentation.