Spaces:

evaluate-metric
/

ter

Runtime error

App Files Files Community

ter / ter.py

lvwerra HF staff

Update Space (evaluate main: c447fc8e)

5b89b3c over 1 year ago

raw history blame contribute delete

No virus

9.99 kB

	# Copyright 2021 The HuggingFace Evaluate Authors.
	#
	# Licensed under the Apache License, Version 2.0 (the "License");
	# you may not use this file except in compliance with the License.
	# You may obtain a copy of the License at
	#
	# http://www.apache.org/licenses/LICENSE-2.0
	#
	# Unless required by applicable law or agreed to in writing, software
	# distributed under the License is distributed on an "AS IS" BASIS,
	# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	# See the License for the specific language governing permissions and
	# limitations under the License.
	""" TER metric as available in sacrebleu. """
	import datasets
	import sacrebleu as scb
	from packaging import version
	from sacrebleu import TER

	import evaluate


	_CITATION = """\
	@inproceedings{snover-etal-2006-study,
	title = "A Study of Translation Edit Rate with Targeted Human Annotation",
	author = "Snover, Matthew and
	Dorr, Bonnie and
	Schwartz, Rich and
	Micciulla, Linnea and
	Makhoul, John",
	booktitle = "Proceedings of the 7th Conference of the Association for Machine Translation in the Americas: Technical Papers",
	month = aug # " 8-12",
	year = "2006",
	address = "Cambridge, Massachusetts, USA",
	publisher = "Association for Machine Translation in the Americas",
	url = "https://aclanthology.org/2006.amta-papers.25",
	pages = "223--231",
	}
	@inproceedings{post-2018-call,
	title = "A Call for Clarity in Reporting {BLEU} Scores",
	author = "Post, Matt",
	booktitle = "Proceedings of the Third Conference on Machine Translation: Research Papers",
	month = oct,
	year = "2018",
	address = "Belgium, Brussels",
	publisher = "Association for Computational Linguistics",
	url = "https://www.aclweb.org/anthology/W18-6319",
	pages = "186--191",
	}
	"""

	_DESCRIPTION = """\
	TER (Translation Edit Rate, also called Translation Error Rate) is a metric to quantify the edit operations that a
	hypothesis requires to match a reference translation. We use the implementation that is already present in sacrebleu
	(https://github.com/mjpost/sacreBLEU#ter), which in turn is inspired by the TERCOM implementation, which can be found
	here: https://github.com/jhclark/tercom.

	The implementation here is slightly different from sacrebleu in terms of the required input format. The length of
	the references and hypotheses lists need to be the same, so you may need to transpose your references compared to
	sacrebleu's required input format. See https://github.com/huggingface/datasets/issues/3154#issuecomment-950746534

	See the README.md file at https://github.com/mjpost/sacreBLEU#ter for more information.
	"""

	_KWARGS_DESCRIPTION = """
	Produces TER scores alongside the number of edits and reference length.

	Args:
	predictions (list of str): The system stream (a sequence of segments).
	references (list of list of str): A list of one or more reference streams (each a sequence of segments).
	normalized (boolean): If `True`, applies basic tokenization and normalization to sentences. Defaults to `False`.
	ignore_punct (boolean): If `True`, applies basic tokenization and normalization to sentences. Defaults to `False`.
	support_zh_ja_chars (boolean): If `True`, tokenization/normalization supports processing of Chinese characters,
	as well as Japanese Kanji, Hiragana, Katakana, and Phonetic Extensions of Katakana.
	Only applies if `normalized = True`. Defaults to `False`.
	case_sensitive (boolean): If `False`, makes all predictions and references lowercase to ignore differences in case. Defaults to `False`.

	Returns:
	'score' (float): TER score (num_edits / sum_ref_lengths * 100)
	'num_edits' (int): The cumulative number of edits
	'ref_length' (float): The cumulative average reference length

	Examples:
	Example 1:
	>>> predictions = ["does this sentence match??",
	... "what about this sentence?",
	... "What did the TER metric user say to the developer?"]
	>>> references = [["does this sentence match", "does this sentence match!?!"],
	... ["wHaT aBoUt ThIs SeNtEnCe?", "wHaT aBoUt ThIs SeNtEnCe?"],
	... ["Your jokes are...", "...TERrible"]]
	>>> ter = evaluate.load("ter")
	>>> results = ter.compute(predictions=predictions,
	... references=references,
	... case_sensitive=True)
	>>> print(results)
	{'score': 150.0, 'num_edits': 15, 'ref_length': 10.0}

	Example 2:
	>>> predictions = ["does this sentence match??",
	... "what about this sentence?"]
	>>> references = [["does this sentence match", "does this sentence match!?!"],
	... ["wHaT aBoUt ThIs SeNtEnCe?", "wHaT aBoUt ThIs SeNtEnCe?"]]
	>>> ter = evaluate.load("ter")
	>>> results = ter.compute(predictions=predictions,
	... references=references,
	... case_sensitive=True)
	>>> print(results)
	{'score': 62.5, 'num_edits': 5, 'ref_length': 8.0}

	Example 3:
	>>> predictions = ["does this sentence match??",
	... "what about this sentence?"]
	>>> references = [["does this sentence match", "does this sentence match!?!"],
	... ["wHaT aBoUt ThIs SeNtEnCe?", "wHaT aBoUt ThIs SeNtEnCe?"]]
	>>> ter = evaluate.load("ter")
	>>> results = ter.compute(predictions=predictions,
	... references=references,
	... normalized=True,
	... case_sensitive=True)
	>>> print(results)
	{'score': 57.14285714285714, 'num_edits': 6, 'ref_length': 10.5}

	Example 4:
	>>> predictions = ["does this sentence match??",
	... "what about this sentence?"]
	>>> references = [["does this sentence match", "does this sentence match!?!"],
	... ["wHaT aBoUt ThIs SeNtEnCe?", "wHaT aBoUt ThIs SeNtEnCe?"]]
	>>> ter = evaluate.load("ter")
	>>> results = ter.compute(predictions=predictions,
	... references=references,
	... ignore_punct=True,
	... case_sensitive=False)
	>>> print(results)
	{'score': 0.0, 'num_edits': 0, 'ref_length': 8.0}

	Example 5:
	>>> predictions = ["does this sentence match??",
	... "what about this sentence?",
	... "What did the TER metric user say to the developer?"]
	>>> references = [["does this sentence match", "does this sentence match!?!"],
	... ["wHaT aBoUt ThIs SeNtEnCe?", "wHaT aBoUt ThIs SeNtEnCe?"],
	... ["Your jokes are...", "...TERrible"]]
	>>> ter = evaluate.load("ter")
	>>> results = ter.compute(predictions=predictions,
	... references=references,
	... ignore_punct=True,
	... case_sensitive=False)
	>>> print(results)
	{'score': 100.0, 'num_edits': 10, 'ref_length': 10.0}
	"""


	@evaluate.utils.file_utils.add_start_docstrings(_DESCRIPTION, _KWARGS_DESCRIPTION)
	class Ter(evaluate.Metric):
	def _info(self):
	if version.parse(scb.__version__) < version.parse("1.4.12"):
	raise ImportWarning(
	"To use `sacrebleu`, the module `sacrebleu>=1.4.12` is required, and the current version of `sacrebleu` doesn't match this condition.\n"
	'You can install it with `pip install "sacrebleu>=1.4.12"`.'
	)
	return evaluate.MetricInfo(
	description=_DESCRIPTION,
	citation=_CITATION,
	homepage="http://www.cs.umd.edu/~snover/tercom/",
	inputs_description=_KWARGS_DESCRIPTION,
	features=[
	datasets.Features(
	{
	"predictions": datasets.Value("string", id="sequence"),
	"references": datasets.Sequence(datasets.Value("string", id="sequence"), id="references"),
	}
	),
	datasets.Features(
	{
	"predictions": datasets.Value("string", id="sequence"),
	"references": datasets.Value("string", id="sequence"),
	}
	),
	],
	codebase_urls=["https://github.com/mjpost/sacreBLEU#ter"],
	reference_urls=[
	"https://github.com/jhclark/tercom",
	],
	)

	def _compute(
	self,
	predictions,
	references,
	normalized: bool = False,
	ignore_punct: bool = False,
	support_zh_ja_chars: bool = False,
	case_sensitive: bool = False,
	):
	# if only one reference is provided make sure we still use list of lists
	if isinstance(references[0], str):
	references = [[ref] for ref in references]

	references_per_prediction = len(references[0])
	if any(len(refs) != references_per_prediction for refs in references):
	raise ValueError("Sacrebleu requires the same number of references for each prediction")
	transformed_references = [[refs[i] for refs in references] for i in range(references_per_prediction)]

	sb_ter = TER(
	normalized=normalized,
	no_punct=ignore_punct,
	asian_support=support_zh_ja_chars,
	case_sensitive=case_sensitive,
	)
	output = sb_ter.corpus_score(predictions, transformed_references)

	return {"score": output.score, "num_edits": output.num_edits, "ref_length": output.ref_length}