Hugging Face的Transformers庫(kù)簡(jiǎn)單用法

1. 基本用法

Hugging face提供的transformers庫(kù)主要用于預(yù)訓(xùn)練模型的載入舟肉,需要載入三個(gè)基本對(duì)象

from transformers import BertConfig
from transformers import BertModel
from transformers import BertTokenizer

BertConfig是該庫(kù)中模型配置的class扔涧。

BertModel模型的class(還有其它的繼承BertPreTrainedModel的派生類依痊,對(duì)應(yīng)不同的Bert任務(wù)隧饼,BertForNextSentencePrediction以及BertForSequenceClassification)促脉。

BertTokenizer分詞的class(這個(gè)分詞對(duì)象比BERT官方代碼的好用覆旭,輸入文本中的[SEP]等特殊字符不會(huì)被切開,而是作為一個(gè)整體保留下來)钉蒲。

推薦使用科大訊飛的pytorch版預(yù)訓(xùn)練模型切端,中文BERT-wwm系列模型,也可以自己手動(dòng)把tensorflow的checkpoint文件轉(zhuǎn)化為pytorch模型顷啼。以訊飛下載的模型為例:

tokenizer = BertTokenizer.from_pretrained('chinese_roberta_wwm_ext_pytorch')  # 默認(rèn)回去讀取文件下的vocab.txt文件
model = BertModel.from_pretrained('chinese_roberta_wwm_ext_pytorch')  # 應(yīng)該會(huì)報(bào)錯(cuò), 默認(rèn)讀取config.json, 需要重命名bert_config.json
# 或者這樣改, 手動(dòng)指定config對(duì)象
config = BertConfig.from_json_file('model_path/bert_config.json')
model = BertModel.from_pretrained('model_path', config=config)

至此踏枣,預(yù)訓(xùn)練模型和分詞工具已經(jīng)載入完成昌屉,下面是一個(gè)簡(jiǎn)單的實(shí)例。

s_a, s_b = "李白拿了個(gè)錘子", "錘子茵瀑?"
# 分詞是tokenizer.tokenize, 分詞并轉(zhuǎn)化為id是tokenier.encode
# 簡(jiǎn)單調(diào)用一下, 不作任何處理經(jīng)過transformer
input_id = tokenizer.encode(s_a)
input_id = torch.tensor([input_id])  # 輸入數(shù)據(jù)是tensor且batch形式的
sequence_output, pooled_output = model(input_id) # 輸出形狀分別是[1, 9, 768], [1, 768]
# 但是輸入BertModel的還需要指示前后句子的信息的token type, 以及遮掉PAD部分的attention mask
inputs = tokenizer.encode_plus(s_a, text_pair=s_b, return_tensors="pt")  # 還有些常用的可選參數(shù)max_length, pad_to_max_length等
print(inputs.keys())  # 返回的是一個(gè)包含id, mask信息的字典
# dict_keys(['input_ids', 'token_type_ids', 'attention_mask']
sequence_output, pooled_output = model(**inputs)

2. 關(guān)于Fine-tuning

不推薦自己從頭開始寫下游任務(wù)的fine-tuning流程间驮,數(shù)據(jù)預(yù)處理加上訓(xùn)練流程巨煩人。如果再加上warm up马昨,weight decay竞帽,甚至多卡訓(xùn)練,簡(jiǎn)直爆炸鸿捧。推薦在transformers提供的栗子上面修改屹篓,比如官方給的xnli數(shù)據(jù)集上的樣例

主要需要修改run_xnli.py文件import的幾個(gè)數(shù)據(jù)結(jié)構(gòu)

from transformers import xnli_compute_metric as compute_metric
from transformers import xnli_output_modes as output_modes
from transformers import xnli_processors as processors

# 注釋掉以上三行, 我們重新寫這些模塊

# compute_metric是evaluation階段的評(píng)估函數(shù), xnli是文本分類任務(wù)
def compute_metric(task_name, preds, labels):
    assert len(preds) == len(labels)
    if task_name == "your_task":
        return {"acc": (preds == labels).mean()}
    else:
        raise KeyError(task_name)
        
# output_modes任務(wù)輸出形式
output_modes = {"your_task": "classification"}  # 回歸任務(wù)則是"regression"

processor類似于google Bert代碼中的寫法匙奴,參考此處TextProcessor的寫法堆巧。另外有個(gè)地方和google不一樣。

# DataProcessor基類多了一個(gè)方法, 用于載入tensorflow Dataset的數(shù)據(jù), 
# 一般沒有這個(gè)需求, 就不用去管它泼菌。
def get_example_from_tensor_dict(self, tensor_dict):
    pass
    
processors = {"your_task": YourProcessor}

采用這里的Processor和數(shù)據(jù)形式恳邀,給出一個(gè)運(yùn)行腳本的樣例:

#!/bin/bash
export DATA_DIR=/data_path     # 數(shù)據(jù)路徑
export MODEL_PATH=/model_path  # 與訓(xùn)練模型路徑

CUDA_VISIBLE_DEVICES=0 python run_xnli.py  \
    --model_type bert   \
    --model_name_or_path ${MODEL_PATH} \
    --task_name your_task  \
    --do_train    \
    --do_eval     \
    --do_lower_case  \
    --data_dir ${DATA_DIR}  \
    --max_seq_length 64 \ 
    --per_gpu_train_batch_size 32  \
    --per_gpu_eval_batch_size 32  \
    --warmup_steps 100  \
    --learning_rate 5e-5  \
    --num_train_epochs 5.0  \
    --output_dir /model_output_dir  \
    --overwrite_output_dir
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市灶轰,隨后出現(xiàn)的幾起案子谣沸,更是在濱河造成了極大的恐慌,老刑警劉巖笋颤,帶你破解...
    沈念sama閱讀 218,386評(píng)論 6 506
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件乳附,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡伴澄,警方通過查閱死者的電腦和手機(jī)赋除,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,142評(píng)論 3 394
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來非凌,“玉大人举农,你說我怎么就攤上這事〕ㄎ耍” “怎么了颁糟?”我有些...
    開封第一講書人閱讀 164,704評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)喉悴。 經(jīng)常有香客問我棱貌,道長(zhǎng),這世上最難降的妖魔是什么箕肃? 我笑而不...
    開封第一講書人閱讀 58,702評(píng)論 1 294
  • 正文 為了忘掉前任婚脱,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘障贸。我一直安慰自己错森,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,716評(píng)論 6 392
  • 文/花漫 我一把揭開白布篮洁。 她就那樣靜靜地躺著涩维,像睡著了一般。 火紅的嫁衣襯著肌膚如雪嘀粱。 梳的紋絲不亂的頭發(fā)上激挪,一...
    開封第一講書人閱讀 51,573評(píng)論 1 305
  • 那天辰狡,我揣著相機(jī)與錄音锋叨,去河邊找鬼。 笑死宛篇,一個(gè)胖子當(dāng)著我的面吹牛娃磺,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播叫倍,決...
    沈念sama閱讀 40,314評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼偷卧,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了吆倦?” 一聲冷哼從身側(cè)響起听诸,我...
    開封第一講書人閱讀 39,230評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎蚕泽,沒想到半個(gè)月后晌梨,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,680評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡须妻,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,873評(píng)論 3 336
  • 正文 我和宋清朗相戀三年仔蝌,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片荒吏。...
    茶點(diǎn)故事閱讀 39,991評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡敛惊,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出绰更,到底是詐尸還是另有隱情瞧挤,我是刑警寧澤,帶...
    沈念sama閱讀 35,706評(píng)論 5 346
  • 正文 年R本政府宣布儡湾,位于F島的核電站皿伺,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏盒粮。R本人自食惡果不足惜鸵鸥,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,329評(píng)論 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧妒穴,春花似錦宋税、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,910評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至矮台,卻和暖如春乏屯,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背瘦赫。 一陣腳步聲響...
    開封第一講書人閱讀 33,038評(píng)論 1 270
  • 我被黑心中介騙來泰國(guó)打工辰晕, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人确虱。 一個(gè)月前我還...
    沈念sama閱讀 48,158評(píng)論 3 370
  • 正文 我出身青樓含友,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親校辩。 傳聞我的和親對(duì)象是個(gè)殘疾皇子窘问,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,941評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容

  • 本文上兩篇系列 NLP的巨人肩膀(上) NLP的巨人肩膀(中) 4.6 Bidirectional Encoder...
    weizier閱讀 6,432評(píng)論 1 22
  • 風(fēng)呼呼刮,雨瀟瀟灑宜咒,想刮便刮惠赫,愿灑任灑,池塘滿了呱歡群蛙故黑。 蟲唧唧鬧儿咱,蟬吱吱噪,粉紅蓮霧熟倍阐,蒂把自落下概疆,萬(wàn)類生靈暢...
    在植樹節(jié)種無(wú)花果閱讀 136評(píng)論 0 2
  • 一天,公主被一條惡龍拐走國(guó)王下令峰搪,說:“要是誰(shuí)殺死惡龍岔冀,把公主帶回來!那我便把公主許配給誰(shuí)概耻!” 消息一出使套,...
    天吟閱讀 1,562評(píng)論 0 2
  • 長(zhǎng)大應(yīng)該是變得溫暖,對(duì)全世界都溫暖
    榴蓮妹子閱讀 80評(píng)論 0 0
  • 生命的悲劇不在于美麗的事物過早衰亡鞠柄,而在于他們變得蒼老和鄙俗侦高。“這個(gè)有著黃金般色澤心靈的騎士”厌杜,這個(gè)“行走在城市陰...
    吾言的簡(jiǎn)書閱讀 280評(píng)論 0 0