Skip to main content

library for question evaluation including KDA, Knowledge Dependent Answerability introduced in EMNLP 2022 work.

Project description

question-score

Repository for KDA(Knowledge-dependent Answerability), EMNLP 2022 work

How to use

pip install --upgrade pip
pip install question-score
from question_score import KDA
kda = KDA()
print(
  kda.kda_small(
    "passage",
    "question",
    ["option1", "option2", "option3", "option4"],
    1
  )
)

What does the score mean?

You can check the explanation of KDA on EMNLP 2022 paper now. The official link from EMNLP 2022 will soon be released.

You can use $KDA_{small}$ or $KDA_{large}$ instead of heavy metric using all model. Below is the performance of the submetrics, which mentioned on the appendix of the paper.

Sub Metric Model Count ( Total Size ) KDA (Valid) Likert (Test)
KDA_small 4 (3.5GB) 0.740 0.377
KDA_large 10 (19.2GB) 0.784 0.421

Citation

@inproceedings{moon-etal-2022-evaluating,
    title = "Evaluating the Knowledge Dependency of Questions",
    author = "Moon, Hyeongdon  and
      Yang, Yoonseok  and
      Yu, Hangyeol  and
      Lee, Seunghyun  and
      Jeong, Myeongho  and
      Park, Juneyoung  and
      Shin, Jamin  and
      Kim, Minsam  and
      Choi, Seungtaek",
    booktitle = "Proceedings of the 2022 Conference on Empirical Methods in Natural Language Processing",
    month = dec,
    year = "2022",
    address = "Abu Dhabi, United Arab Emirates",
    publisher = "Association for Computational Linguistics",
    url = "https://aclanthology.org/2022.emnlp-main.718",
    pages = "10512--10526",
    abstract = "The automatic generation of Multiple Choice Questions (MCQ) has the potential to reduce the time educators spend on student assessment significantly. However, existing evaluation metrics for MCQ generation, such as BLEU, ROUGE, and METEOR, focus on the n-gram based similarity of the generated MCQ to the gold sample in the dataset and disregard their educational value.They fail to evaluate the MCQ{'}s ability to assess the student{'}s knowledge of the corresponding target fact. To tackle this issue, we propose a novel automatic evaluation metric, coined Knowledge Dependent Answerability (KDA), which measures the MCQ{'}s answerability given knowledge of the target fact. Specifically, we first show how to measure KDA based on student responses from a human survey.Then, we propose two automatic evaluation metrics, KDA{\_}disc and KDA{\_}cont, that approximate KDA by leveraging pre-trained language models to imitate students{'} problem-solving behavior.Through our human studies, we show that KDA{\_}disc and KDA{\_}soft have strong correlations with both (1) KDA and (2) usability in an actual classroom setting, labeled by experts. Furthermore, when combined with n-gram based similarity metrics, KDA{\_}disc and KDA{\_}cont are shown to have a strong predictive power for various expert-labeled MCQ quality measures.",
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

question_score-0.0.8.tar.gz (15.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

question_score-0.0.8-py3-none-any.whl (14.2 kB view details)

Uploaded Python 3

File details

Details for the file question_score-0.0.8.tar.gz.

File metadata

  • Download URL: question_score-0.0.8.tar.gz
  • Upload date:
  • Size: 15.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for question_score-0.0.8.tar.gz
Algorithm Hash digest
SHA256 f7f0a2610cd6dd7e031b29aa04f2a2bfc4b3721d7ac01056fa5b262b2d5744dd
MD5 94213cf62743f30aff5f01773f5cfac1
BLAKE2b-256 25e0728d4c7d833bc21c7b74ef49cbd74156767df7541f83ebe44b3511f8cb5c

See more details on using hashes here.

File details

Details for the file question_score-0.0.8-py3-none-any.whl.

File metadata

  • Download URL: question_score-0.0.8-py3-none-any.whl
  • Upload date:
  • Size: 14.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for question_score-0.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 0d58982abafe4ade766f2d24c984040b7eab14e6ab3bc2aac1bcbb08ffba8320
MD5 e30a5abd8e9346e477d6c0fc49a19e98
BLAKE2b-256 8f0447d6972365e0e959aed6bc9354bf5a867bacd658e9dc2b3853e18f8b17cc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page