Skip to content

Cloze (rellenar huecos)

Añade pasajes cloze y C-test a un estudio de Potato, con una clave de respuestas que se queda en el servidor y puntuación por hueco en la exportación CSV.

Nuevo en v2.12.0

Un esquema cloze muestra un pasaje con huecos en los que el anotador escribe. Encaja con las pruebas cloze y los C-tests de competencia lingüística, las comprobaciones de comprensión, la normalización de la predictibilidad y la comprobación de lo que un lector recuerda de un ítem.

La clave de respuestas se queda en el servidor. Sirve para puntuar la exportación y nunca se envía al navegador.

Un único pasaje

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

Cada [[...]] es un hueco. El texto que contiene es la respuesta aceptada, con | entre las alternativas. [[]] es un hueco sin clave, que se registra pero no se puntúa.

Un pasaje fijo encaja con una página de encuesta, como un cuestionario de selección de competencia en la fase prestudy (Flujos de trabajo multifase).

Un pasaje por ítem

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 indica el campo del ítem que contiene el pasaje, con los huecos escritos como [[]]. answer_field indica un campo que contiene una lista con una entrada por hueco, cada una de ellas una cadena (con | entre las alternativas) o una lista. Un ítem de un solo hueco puede usar una cadena simple. Las entradas que superan el número de huecos se ignoran, con una advertencia en el registro del servidor.

El campo de respuestas se elimina de la página y de las API de ítems. El texto escrito dentro de [[...]] en el pasaje de un ítem se vacía antes de que el ítem llegue a la página, así que una clave puesta ahí por error tampoco se muestra.

Opciones

ClaveValor predeterminadoSignificado
textUn único pasaje para todos los ítems. Usa esta clave o source_field
source_fieldCampo del ítem que contiene el pasaje de cada ítem
answer_fieldCampo del ítem que contiene la clave de cada ítem, solo con source_field
scoringcase_insensitiveexact, case_insensitive o normalized, que además ignora los acentos y la puntuación
input_width10Anchura de cada hueco, en caracteres
label_requirementrequired: true exige texto en todos los huecos, comprobado en la página y en el servidor

Datos

Cada hueco se guarda como una etiqueta del esquema, blank_1, blank_2, etc., con el texto escrito como valor. Para cada hueco con clave, las exportaciones CSV y TSV añaden <scheme>.blank_<n>_correct (1 o 0), más <scheme>.score y <scheme>.scored_blanks para el ítem. Un pasaje que se deja en blanco puntúa 0.

Las respuestas cloze de las páginas de encuesta se exportan con las demás respuestas de las fases (export_include_phase_data: true) y ahí no se puntúan.

Ejemplo

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

Lecturas adicionales

Para detalles de implementación, consulta la documentación fuente.