View Source Tokenizers.Normalizer (Tokenizers v0.5.0)

Normalizers and normalization functions.

A normalizer is in charge of pre-processing the input string in order to normalize it as relevant for the given use case.

Some common examples of normalization are the Unicode normalization algorithms (NFD, NFKD, NFC & NFKC) or lowercasing. The specificity of tokenizers is that we keep track of the alignment while normalizing. This is essential to allow mapping from the generated tokens back to the input text.

Summary

Functions

Takes care of normalizing raw text before giving it to a Bert model.

Replaces all uppercase to lowercase

Creates a NFC Unicode normalizer.

Creates a NFD Unicode normalizer.

Creates a NFKC Unicode normalizer.

Creates a NFKD Unicode normalizer.

Creates a Nmt normalizer.

Normalizes the given text input.

Precompiled normalizer.

Creates a Prepend normalizer.

Replaces a custom search string with the given content.

Replaces occurrences of a custom regexp pattern with the given content.

Composes multiple normalizers that will run in the provided order.

Creates a Strip normalizer.

Creates a Strip Accent normalizer.

Types

@type t() :: %Tokenizers.Normalizer{resource: reference()}

Functions

Link to this function

bert_normalizer(opts \\ [])

View Source
@spec bert_normalizer(keyword()) :: t()

Takes care of normalizing raw text before giving it to a Bert model.

This includes cleaning the text, handling accents, chinese chars and lowercasing.

Options

  • :clean_text - whether to clean the text, by removing any control characters and replacing all whitespaces by the classic one. Defaults to true

  • :handle_chinese_chars - whether to handle chinese chars by putting spaces around them. Default true

  • :strip_accents - whether to strip all accents. If this option is not specified, then it will be determined by the value for lowercase (as in the original Bert)

  • :lowercase - whether to lowercase. Default true

@spec lowercase() :: t()

Replaces all uppercase to lowercase

@spec nfc() :: t()

Creates a NFC Unicode normalizer.

@spec nfd() :: t()

Creates a NFD Unicode normalizer.

@spec nfkc() :: t()

Creates a NFKC Unicode normalizer.

@spec nfkd() :: t()

Creates a NFKD Unicode normalizer.

@spec nmt() :: t()

Creates a Nmt normalizer.

Link to this function

normalize(normalizer, input)

View Source
@spec normalize(t(), String.t()) :: {:ok, String.t()}

Normalizes the given text input.

@spec precompiled(binary()) :: {:ok, t()} | {:error, any()}

Precompiled normalizer.

Don’t use manually it is used for compatibility with SentencePiece.

@spec prepend(prepend :: String.t()) :: t()

Creates a Prepend normalizer.

Link to this function

replace(search, content)

View Source
@spec replace(String.t(), String.t()) :: t()

Replaces a custom search string with the given content.

Link to this function

replace_regex(pattern, content)

View Source
@spec replace_regex(String.t(), String.t()) :: t()

Replaces occurrences of a custom regexp pattern with the given content.

The pattern should be a string representing a regular expression according to the Oniguruma Regex Engine.

@spec sequence([t()]) :: t()

Composes multiple normalizers that will run in the provided order.

@spec strip(keyword()) :: t()

Creates a Strip normalizer.

Removes all whitespace characters on the specified sides (left, right or both) of the input

Options

  • :left - whether to strip left side. Defaults to true

  • :right - whether to strip right side. Defaults to true

@spec strip_accents() :: t()

Creates a Strip Accent normalizer.

Removes all accent symbols in unicode (to be used with NFD for consistency).