Best usage of Keyterms (Proper Names)
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 39
- Forks
- 7
- Avg merge
- 1d 9h
- Merged PRs (30d)
- 5
Description
This issue is to research the best usage of Proper Names (and keyterms more broadly) into the AI drafting flow and determine the best way to use it. Currently, all Proper Names (type PN) are included in training with the same weights, no matter how much or little other training data is being used. A few points of research could be:
A better Keyterm metric
We need to be able to easily determine the effectiveness of different means of adding keyterms and how well they are used. These metrics should account for:
- That the proper keyterms are used in the proper places
- That the Bleu score has not been degraded
- If possible, accounting for different surface forms of the word
This this metric could assessed as well as Bleu and called Keyterm Accuracy. It would be:
KeytermAccuracy = (The number of times the keyterm occurs in the correct verse the correct number of times) / (The total number of instances of keyterms)- Multiples of the keyterms when there should not be multiples of the keyterm should penalize the metric
- A Levenshtein distance should be applied if the word does not appear and if one of "sufficient closeness" appears, then it should be considered a proper match.
- If there are multiple translations of the same term, any one of the proper translations occurring in the verse should be counted as a proper match.
Potential improvements:
Ways to improve the usage of Keyterms without degrading the Bleu and Chrf++ score include:
- Guided decoding and similar methods: #178
- "Enhanced" guided decoding: #652
- Only including the PN's for the books we are inferencing off of
- Only including the PN's for the books we are inferencing off of that are not already in the training data
- Including more than just PN's - can we include more terms? Does it make it better?
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing the AI drafting flow and the related guided-decoding issues #178 and #652. Define and evaluate a Keyterm Accuracy metric alongside BLEU and chrF++, including correct verse placement, counts, surface forms, and alternate translations; done means the research identifies a supported approach and measurable improvements without degrading existing scores.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- machine-learning
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100