SenseRel: Denotational and Connotational Meaning Relations

# SenseRel — Denotational and Connotational Meaning Relations
# Based on the SenseRel benchmark:
#   Cassotti, Baes, De Pascale, Martins Camboim de Sá, Periti, Haslam,
#   Geeraerts, and Tahmasebi (2026), "SenseRel: A Sense-Level Benchmark for
#   Denotational and Connotational Meaning Relations."
#   ACL 2026 (Vol. 1: Long Papers), pp. 499-515.
#   Paper: https://aclanthology.org/2026.acl-long.20/
#   Project (code on GitHub, data on Zenodo): https://www.changeiskey.org/publication/2026-acl/
#
# Each item shows a word with two senses (an original sense and a related sense),
# each given as a definition with an example. Annotators record:
#   1. the DENOTATIONAL relation between the senses — one of five types
#      (generalization, specialization, metonymy, metaphor, homonymy);
#   2. the CONNOTATIONAL difference between the senses along two affective
#      dimensions, valence and arousal, on a Same / Small / Big difference scale
#      (the paper's pair-comparison "Difference" setting, Table 2).

annotation_task_name: "SenseRel - Meaning Relations"
task_dir: "."

data_files:
  - sample-data.json

item_properties:
  id_key: "id"
  text_key: "word"

output_annotation_dir: "annotation_output/"
output_annotation_format: "json"

port: 8000
server_name: localhost

annotation_schemes:
  - annotation_type: radio
    name: denotational_relation
    description: "What is the denotational (conceptual) relation from Sense A (original) to Sense B (new)?"
    labels:
      - "Generalization"
      - "Specialization"
      - "Metonymy"
      - "Metaphor"
      - "Homonymy"
    tooltips:
      "Generalization": "Sense A is a sub-case of Sense B (broadening/widening), e.g. calf: young cow -> young of various large mammals"
      "Specialization": "Sense B is a sub-case of Sense A (narrowing/restriction), e.g. escort: any companion -> a specific kind of companion"
      "Metonymy": "Sense B's referent is related to Sense A's by contiguity, e.g. head: body part -> the mind/intellect"
      "Metaphor": "Sense B's referent is related to Sense A's by figurative similarity, e.g. wing: bird's wing -> wing of a building"
      "Homonymy": "Sense B is etymologically unrelated to Sense A (different lexemes that happen to share a form) - a control case"

  - annotation_type: radio
    name: valence_difference
    description: "How much do the two senses differ in VALENCE (pleasantness / good-bad)?"
    labels:
      - "Same"
      - "Small"
      - "Big"
    tooltips:
      "Same": "No meaningful difference in pleasantness between the senses"
      "Small": "A small shift in pleasantness/unpleasantness"
      "Big": "A large shift in pleasantness/unpleasantness"

  - annotation_type: radio
    name: arousal_difference
    description: "How much do the two senses differ in AROUSAL (energy / calm-excited)?"
    labels:
      - "Same"
      - "Small"
      - "Big"
    tooltips:
      "Same": "No meaningful difference in arousal/energy between the senses"
      "Small": "A small shift in arousal/energy"
      "Big": "A large shift in arousal/energy"

annotation_instructions: |
  Each item shows a WORD and two of its senses: Sense A (the original meaning)
  and Sense B (a related, newer meaning), each with a short definition and an
  example.

  First, choose the denotational relation that best describes how Sense B relates
  to Sense A: generalization, specialization, metonymy, metaphor, or homonymy
  (see the tooltips for definitions and examples). Note that generalization and
  specialization are mirror images that depend on which sense is taken as the
  starting point.

  Then judge how much the two senses differ in affective meaning: valence
  (pleasant vs. unpleasant) and arousal (calm vs. excited), each as Same, Small,
  or Big difference.

html_layout: |
  <div style="padding: 15px; max-width: 820px; margin: auto;">
    <div style="text-align: center; margin-bottom: 12px;">
      <span style="font-size: 24px; font-weight: 700; color: #4338ca;">{{word}}</span>
    </div>
    <div style="background: #eef2ff; border: 1px solid #c7d2fe; border-radius: 8px; padding: 12px 16px; margin-bottom: 8px;">
      <strong style="color: #3730a3;">Sense A (original):</strong>
      <div style="margin: 4px 0;">{{sense_a}}</div>
      <div style="color: #6366f1; font-style: italic; font-size: 14px;">e.g. {{example_a}}</div>
    </div>
    <div style="background: #f5f3ff; border: 1px solid #ddd6fe; border-radius: 8px; padding: 12px 16px;">
      <strong style="color: #5b21b6;">Sense B (new):</strong>
      <div style="margin: 4px 0;">{{sense_b}}</div>
      <div style="color: #7c3aed; font-style: italic; font-size: 14px;">e.g. {{example_b}}</div>
    </div>
  </div>

allow_all_users: true
instances_per_annotator: 40
annotation_per_instance: 3
allow_skip: true