o !wi;@sdZddlZddlmZmZmZmZddlmZ ddl m Z m Z ddl mZmZgdZdde e ddfdeeeefd eeeefd ee je jfd ee je jfd eeeefd ee je jfdefddZdde e ddfdeeeefd eeeefd ee je jfd ee je jfd eeeefd ee je jfdefddZdde e ddfdeeeefd eeeefd ee je jfd ee je jfd eeeefd ee je jfdefddZdde e ddfdeeeefd eeeefd ee je jfd ee je jfd eeeefd ee je jfdefddZe e fd eeeefd eeeefd ee je jfd ee je jfdeeeff ddZdde e dddfdeeeefd eeeefd ee je jfd ee je jfded eeeefd ee je jfdeeeeefffddZdeeeefd eeeefd eeeefd ee je jfd ee je jfd ee je jff ddZdS)a Convenience methods for calculating a number of similarity error measures between a reference and hypothesis sentence. These measures are commonly used to measure the performance for an automatic speech recognition (ASR) system. The following measures are implemented: - Word Error Rate (WER), which is where this library got its name from. This has long been (and arguably still is) the de facto standard for computing ASR performance. - Match Error Rate (MER) - Word Information Lost (WIL) - Word Information Preserved (WIP) - Character Error Rate (CER) Note that these functions merely call [jiwer.process_words][process.process_words] and [jiwer.process_characters][process.process_characters]. It is more efficient to call `process_words` or `process_characters` and access the results from the [jiwer.WordOutput][process.WordOutput] and [jiwer.CharacterOutput][process.CharacterOutput] classes. N)ListUnionDictAny) transforms) wer_default cer_default) process_wordsprocess_characters)wermerwilwipcercompute_measures reference hypothesisreference_transformhypothesis_transformtruthtruth_transformreturncC0t||||||d\}}}}t||||}|jS)a Calculate the word error rate (WER) between one or more reference and hypothesis sentences. Args: reference: The reference sentence(s) hypothesis: The hypothesis sentence(s) reference_transform: The transformation(s) to apply to the reference string(s) hypothesis_transform: The transformation(s) to apply to the hypothesis string(s) truth: Deprecated, renamed to `reference` truth_transform: Deprecated, renamed to `reference_transform` Deprecated: Arguments `truth` and `truth_transform` have been renamed to respectively `reference` and `reference_transform`. Therefore, the keyword arguments `truth` and `truth_transform` will be removed in the next release. At the same time, `reference` and `reference_transform` will lose their default value. Returns: (float): The word error rate of the given reference and hypothesis sentence(s). rrrrrr)_deprecate_truthr r rrrrrroutputrK/home/ubuntu/sommelier/.venv/lib/python3.10/site-packages/jiwer/measures.pyr Bs"$ r cCr)a Calculate the match error rate (MER) between one or more reference and hypothesis sentences. Args: reference: The reference sentence(s) hypothesis: The hypothesis sentence(s) reference_transform: The transformation(s) to apply to the reference string(s) hypothesis_transform: The transformation(s) to apply to the hypothesis string(s) truth: Deprecated, renamed to `reference` truth_transform: Deprecated, renamed to `reference_transform` Deprecated: Arguments `truth` and `truth_transform` have been renamed to respectively `reference` and `reference_transform`. Therefore, the keyword arguments `truth` and `truth_transform` will be removed in the next release. At the same time, `reference` and `reference_transform` will lose their default value. Returns: (float): The match error rate of the given reference and hypothesis sentence(s). r)rr r rrrrr u"$ r cCr)a Calculate the word information preserved (WIP) between one or more reference and hypothesis sentences. Args: reference: The reference sentence(s) hypothesis: The hypothesis sentence(s) reference_transform: The transformation(s) to apply to the reference string(s) hypothesis_transform: The transformation(s) to apply to the hypothesis string(s) truth: Deprecated, renamed to `reference` truth_transform: Deprecated, renamed to `reference_transform` Deprecated: Arguments `truth` and `truth_transform` have been renamed to respectively `reference` and `reference_transform`. Therefore, the keyword arguments `truth` and `truth_transform` will be removed in the next release. At the same time, `reference` and `reference_transform` will lose their default value. Returns: (float): The word information preserved of the given reference and hypothesis sentence(s). r)rr rrrrrrrrcCr)a Calculate the word information lost (WIL) between one or more reference and hypothesis sentences. Args: reference: The reference sentence(s) hypothesis: The hypothesis sentence(s) reference_transform: The transformation(s) to apply to the reference string(s) hypothesis_transform: The transformation(s) to apply to the hypothesis string(s) truth: Deprecated, renamed to `reference` truth_transform: Deprecated, renamed to `reference_transform` Deprecated: Arguments `truth` and `truth_transform` have been renamed to respectively `reference` and `reference_transform`. Therefore, the keyword arguments `truth` and `truth_transform` will be removed in the next release. At the same time, `reference` and `reference_transform` will lose their default value. Returns: (float): The word information lost of the given reference and hypothesis sentence(s). r)rr r rrrrr rr c CsPttdt||||d}|j|j|j|j|j|j |j |j |j |j |jd S)aN Efficiently computes all measures using only one function call. Deprecated: Deprecated method. Superseded by [jiwer.process_words][process.process_words]. This method will be removed on next release. Args: truth: The reference sentence(s) hypothesis: The hypothesis sentence(s) truth_transform: The transformation(s) to apply to the reference string(s) hypothesis_transform: The transformation(s) to apply to the hypothesis string(s) Returns: (dict): A dictionary containing key-value pairs for all measures. zIjiwer.compute_measures() is deprecated. Please use jiwer.process_words().)rrrr) r r r rhits substitutions deletions insertionsopsrr)warningswarnDeprecationWarningr r r r rr r!r"r# alignments references hypotheses)rrrrrrrrrs.rF return_dictcCs\t||||||d\}}}}t||||}|r+ttd|j|j|j|j|j dS|jS)a Calculate the character error rate (CER) between one or more reference and hypothesis sentences. Args: reference: The reference sentence(s) hypothesis: The hypothesis sentence(s) reference_transform: The transformation(s) to apply to the reference string(s) hypothesis_transform: The transformation(s) to apply to the hypothesis string(s) return_dict: Deprecated option to return the more results in a dict instead of returning only the cer as a single float value truth: Deprecated, renamed to `reference` truth_transform: Deprecated, renamed to `reference_transform` Deprecated: Argument `return_dict` will be deprecated. Please use [jiwer.process_characters][process.process_characters] instead. Arguments `truth` and `truth_transform` have been renamed to respectively `reference` and `reference_transform`. Therefore, the keyword arguments `truth` and `truth_transform` will be removed in the next release. At the same time, `reference` and `reference_transform` will lose their default value. Returns: (float): The character error rate of the given reference and hypothesis sentence(s). rzK`return_dict` is deprecated, please use jiwer.process_characters() instead.)rr r!r"r#) rr r%r&r'rr r!r"r#)rrrrr+rrrrrrrLs:* rcCsh|durttd|durtd|}|dur"ttd|}|dus*|dur.td||||fS)Nz?keyword argument `truth` is deprecated, please use `reference`.z#cannot give `reference` and `truth`zSkeyword argument `truth_transform` is deprecated, please use `reference_transform`.zndetected default values for reference or hypothesis arguments, please provide actual string or list of strings)r%r&r' ValueError)rrrrrrrrrrs* r)__doc__r%typingrrrrjiwerrtrjiwer.transformationsrr jiwer.processr r __all__strComposeAbstractTransformfloatr r rr rboolrrrrrrs  4 5 5 ;  8 I