README.md

metadata

language:
  - ko
  - zh
language_bcp47:
  - zh-Hant
license: other
library_name: pytorch
tags:
  - joseon
  - hanmun
  - hanja
  - huneum
  - lexicalization
  - korean-history
datasets:
  - custom
metrics:
  - accuracy

Joseon Level 2 Huneum Selector

This is the promoted Level 2 훈음 selector for the Joseon-to-Day project. It selects Korean readings for Hanja spans using structured candidate sets.

This repository contains a project-specific PyTorch artifact rather than a standard Transformers model:

• huneum_selector.pt: model weights
• model_config.json: model/vocabulary configuration
• candidate_manifest.json: candidate metadata
• metrics.json: promoted evaluation metrics
• huneum_error_analysis.json: diagnostic errors

Evaluation

Promoted dev result:

Metric	Value
exact row accuracy	0.9953
correct rows	5054 / 5078
character accuracy	0.9981
selector accuracy	0.9949
deterministic single-candidate accuracy	1.0000

By label:

Label	Exact
book/title/evidence	1.0000
person/name	0.9953
place	0.9948

Intended Use

Use this model after Level 1 span detection to choose readings for Korean historical names, places, book titles, and related Hanja/Hanmun spans.

Limitations

The artifact is tied to the Joseon-to-Day project code and candidate format. It is not a standalone general Hanja-to-Korean transliteration package.

Loading

Use the project loader/training code from the Joseon-to-Day repository. The artifact is intentionally published with its config and manifest so the project pipeline can reproduce the promoted Level 2 selector.