Transformers 文档

Bert日语

Hugging Face's logo
加入 Hugging Face 社区

并获得增强文档体验

开始使用

BertJapanese

概述

在日语文本上训练的 BERT 模型。

有两种不同的分词方法的模型

  • 使用 MeCab 和 WordPiece 进行分词。这需要一些额外的依赖项,fugashi,它是 MeCab 的包装器。
  • 分词成字符。

要使用 MecabTokenizer,您应该 pip install transformers["ja"](或者如果您从源代码安装,则为 pip install -e .["ja"])来安装依赖项。

参见 cl-tohoku 存储库中的详细信息

使用 MeCab 和 WordPiece 分词的模型示例

>>> import torch
>>> from transformers import AutoModel, AutoTokenizer

>>> bertjapanese = AutoModel.from_pretrained("cl-tohoku/bert-base-japanese")
>>> tokenizer = AutoTokenizer.from_pretrained("cl-tohoku/bert-base-japanese")

>>> ## Input Japanese Text
>>> line = "吾輩は猫である。"

>>> inputs = tokenizer(line, return_tensors="pt")

>>> print(tokenizer.decode(inputs["input_ids"][0]))
[CLS] 吾輩 は 猫 で ある 。 [SEP]

>>> outputs = bertjapanese(**inputs)

使用字符分词的模型示例

>>> bertjapanese = AutoModel.from_pretrained("cl-tohoku/bert-base-japanese-char")
>>> tokenizer = AutoTokenizer.from_pretrained("cl-tohoku/bert-base-japanese-char")

>>> ## Input Japanese Text
>>> line = "吾輩は猫である。"

>>> inputs = tokenizer(line, return_tensors="pt")

>>> print(tokenizer.decode(inputs["input_ids"][0]))
[CLS] 吾 輩 は 猫 で あ る 。 [SEP]

>>> outputs = bertjapanese(**inputs)

此模型由 cl-tohoku 贡献。

此实现与 BERT 相同,除了分词方法。有关 API 参考信息,请参阅 BERT 文档

BertJapaneseTokenizer

transformers.BertJapaneseTokenizer

< >

( vocab_file spm_file = None do_lower_case = False do_word_tokenize = True do_subword_tokenize = True word_tokenizer_type = 'basic' subword_tokenizer_type = 'wordpiece' never_split = None unk_token = '[UNK]' sep_token = '[SEP]' pad_token = '[PAD]' cls_token = '[CLS]' mask_token = '[MASK]' mecab_kwargs = None sudachi_kwargs = None jumanpp_kwargs = None **kwargs )

参数

  • vocab_file (str) — 单词片段(wordpiece)词汇表文件路径,每行一个单词片段。
  • spm_file (str, 可选) — SentencePiece 文件路径(通常具有 .spm 或 .model 扩展名),包含词汇表。
  • do_lower_case (bool, 可选,默认为 True) — 是否将输入转换为小写。仅当 do_basic_tokenize=True 时有效。
  • do_word_tokenize (bool, 可选,默认为 True) — 是否进行分词。
  • do_subword_tokenize (bool, 可选,默认为 True) — 是否进行子词分词。
  • word_tokenizer_type (str, 可选,默认为 "basic") — 分词器类型。选择 [“basic”, “mecab”, “sudachi”, “jumanpp”] 中的一种。
  • subword_tokenizer_type (str, 可选,默认为 "wordpiece") — 子词分词器类型。选择 [“wordpiece”, “character”, “sentencepiece”] 中的一种。
  • sudachi_kwargs (dict, 可选) — 传递给 SudachiTokenizer 构造函数的字典。
  • jumanpp_kwargs (dict, 可选) — 传递给 JumanppTokenizer 构造函数的字典。

构建用于日语文本的 BERT 分词器。

此分词器继承自 PreTrainedTokenizer,其中包含大部分主要方法。用户应参考:此超类以获取有关这些方法的更多信息。

build_inputs_with_special_tokens

< >

( token_ids_0: List token_ids_1: Optional = None ) List[int]

参数

  • token_ids_0 (List[int]) — 将添加特殊标记的 ID 列表。
  • token_ids_1 (List[int], 可选) — 序列对的可选第二个 ID 列表。

返回值

List[int]

包含适当特殊标记的 输入 ID 列表。

通过连接和添加特殊标记,从序列或一对序列构建用于序列分类任务的模型输入。BERT 序列具有以下格式

  • 单个序列:[CLS] X [SEP]
  • 序列对:[CLS] A [SEP] B [SEP]

convert_tokens_to_string

< >

( tokens )

将一系列标记(字符串)转换为单个字符串。

create_token_type_ids_from_sequences

< >

( token_ids_0: List token_ids_1: Optional = None ) List[int]

参数

  • token_ids_0 (List[int]) — ID 列表。
  • token_ids_1 (List[int], 可选) — 序列对的可选第二个 ID 列表。

返回值

List[int]

根据给定序列生成 标记类型 ID 列表。

创建从两个序列传递的掩码,以用于序列对分类任务。BERT 序列

对掩码具有以下格式

0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1 1
| first sequence    | second sequence |

如果 token_ids_1None,则此方法仅返回掩码的第一部分(0)。

get_special_tokens_mask

  • token_ids_0 (List[int]) — ID 列表。
  • token_ids_1 (List[int], 可选) — 用于序列对的第二个可选 ID 列表。
  • already_has_special_tokens (bool, 可选, 默认值为 False) — 令牌列表是否已使用模型的特殊令牌进行格式化。

返回值

List[int]

一个整数列表,范围为 [0, 1]:1 表示特殊令牌,0 表示序列令牌。

从未添加特殊令牌的令牌列表中检索序列 ID。当使用分词器 prepare_for_model 方法添加特殊令牌时,会调用此方法。

< > 在 GitHub 上更新