vak.common.labels.multi_char_labels_to_single_char

vak.common.labels.multi_char_labels_to_single_char(labelmap: dict, skip: tuple[str] = ('background',)) → dict[source]

Return a copy of a labelmap where any labels that are strings with multiple characters are converted to single characters.

This makes it possible to correctly compute metrics like Levenshtein edit distance.

Labels that are strings with multiple characters are replaced by a single-label character from the constant vak.labels.DUMMY_SINGLE_CHAR_LABELS. The replacement is grabbed with the index of the multi-character label from the sorted dict.

Parameters:

  • labelmap (dict) – That maps human-readable string labels to integers. As returned by vak.labels.to_map.

  • skip (tuple) – A tuple of labels to leave as multiple characters. Default is a tuple containing just vak.common.constants.DEFAULT_BACKGROUND_LABEL.

Returns:

labelmap – Where any keys with multiple characters in string are converted to dummy single characters.

Return type:

dict