{"id":15027829,"url":"https://github.com/luopeixiang/named_entity_recognition","last_synced_at":"2025-10-19T09:43:05.065Z","repository":{"id":37602095,"uuid":"176981744","full_name":"luopeixiang/named_entity_recognition","owner":"luopeixiang","description":"中文命名实体识别（包括多种模型：HMM，CRF，BiLSTM，BiLSTM+CRF的具体实现）","archived":false,"fork":false,"pushed_at":"2022-06-21T21:48:08.000Z","size":29560,"stargazers_count":2197,"open_issues_count":40,"forks_count":537,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-04-07T22:08:00.847Z","etag":null,"topics":["bi-lstm","bi-lstm-crf","chinese-ner","crf","hmm","named-entity-recognition","ner","nlp","pytorch-ner","pytorch-nlp","sequence-labeling"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/luopeixiang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-03-21T16:13:59.000Z","updated_at":"2025-04-06T14:07:59.000Z","dependencies_parsed_at":"2022-08-09T09:15:37.542Z","dependency_job_id":null,"html_url":"https://github.com/luopeixiang/named_entity_recognition","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luopeixiang%2Fnamed_entity_recognition","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luopeixiang%2Fnamed_entity_recognition/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luopeixiang%2Fnamed_entity_recognition/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luopeixiang%2Fnamed_entity_recognition/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/luopeixiang","download_url":"https://codeload.github.com/luopeixiang/named_entity_recognition/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254384987,"owners_count":22062422,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bi-lstm","bi-lstm-crf","chinese-ner","crf","hmm","named-entity-recognition","ner","nlp","pytorch-ner","pytorch-nlp","sequence-labeling"],"created_at":"2024-09-24T20:07:07.833Z","updated_at":"2025-10-19T09:43:00.007Z","avatar_url":"https://github.com/luopeixiang.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 中文命名实体识别\n\n\n\n## 数据集\n\n本项目尝试使用了多种不同的模型（包括HMM，CRF，Bi-LSTM，Bi-LSTM+CRF）来解决中文命名实体识别问题，数据集用的是论文ACL 2018[Chinese NER using Lattice LSTM](https://github.com/jiesutd/LatticeLSTM)中收集的简历数据，数据的格式如下，它的每一行由一个字及其对应的标注组成，标注集采用BIOES，句子之间用一个空行隔开。\n\n```\n美\tB-LOC\n国\tE-LOC\n的\tO\n华\tB-PER\n莱\tI-PER\n士\tE-PER\n\n我\tO\n跟\tO\n他\tO\n谈\tO\n笑\tO\n风\tO\n生\tO \n```\n\n该数据集就位于项目目录下的`ResumeNER`文件夹里。\n\n## 运行结果\n\n下面是四种不同的模型以及这Ensemble这四个模型预测结果的准确率（取最好）：\n\n|      | HMM    | CRF    | BiLSTM | BiLSTM+CRF | Ensemble |\n| ---- | ------ | ------ | ------ | ---------- | -------- |\n| 召回率  | 91.22% | 95.43% | 95.32% | 95.72%     | 95.65%   |\n| 准确率  | 91.49% | 95.43% | 95.37% | 95.74%     | 95.69%   |\n| F1分数 | 91.30% | 95.42% | 95.32% | 95.70%     | 95.64%   |\n\n最后一列Ensemble是将这四个模型的预测结果结合起来，使用“投票表决”的方法得出最后的预测结果。\n\n（Ensemble的三个指标均不如BiLSTM+CRF，可以认为在Ensemble过程中，是其他三个模型拖累了BiLSTM+CRF）\n\n具体的输出可以查看`output.txt`文件。\n\n\n\n## 快速开始\n\n首先安装依赖项：\n\n```\npip3 install -r requirement.txt\n```\n\n安装完毕之后，直接使用\n\n```\npython3 main.py\n```\n\n即可训练以及评估模型，评估模型将会打印出模型的精确率、召回率、F1分数值以及混淆矩阵，如果想要修改相关模型参数或者是训练参数，可以在`./models/config.py`文件中进行设置。\n\n训练完毕之后，如果想要加载并评估模型，运行如下命令：\n\n```shell\npython3 test.py\n```\n\n下面是这些模型的简单介绍（github网页对数学公式的支持不太好，涉及公式的部分无法正常显示，[我的博客](https://zhuanlan.zhihu.com/p/61227299)  有对这些模型以及代码更加详细的介绍）：\n\n\n\n## 隐马尔可夫模型（Hidden Markov Model，HMM）\t \n\n隐马尔可夫模型描述由一个隐藏的马尔科夫链随机生成不可观测的状态随机序列，再由各个状态生成一个观测而产生观测随机序列的过程（李航 统计学习方法）。隐马尔可夫模型由初始状态分布，状态转移概率矩阵以及观测概率矩阵所确定。\n\n命名实体识别本质上可以看成是一种序列标注问题，在使用HMM解决命名实体识别这种序列标注问题的时候，我们所能观测到的是字组成的序列（观测序列），观测不到的是每个字对应的标注（状态序列）。\n\n**初始状态分布**就是每一个标注的初始化概率，**状态转移概率矩阵**就是由某一个标注转移到下一个标注的概率（就是若前一个词的标注为$tag_i$ ，则下一个词的标注为$tag_j$的概率为 $M_{ij}$），**观测概率矩阵**就是指在\n\n某个标注下，生成某个词的概率。\n\nHMM模型的训练过程对应隐马尔可夫模型的学习问题（李航 统计学习方法），\n\n实际上就是根据训练数据根据最大似然的方法估计模型的三个要素，即上文提到的初始状态分布、状态转移概率矩阵以及观测概率矩阵，模型训练完毕之后，利用模型进行解码，即对给定观测序列，求它对应的状态序列，这里就是对给定的句子，求句子中的每个字对应的标注，针对这个解码问题，我们使用的是维特比（viterbi）算法。\n\n具体的细节可以查看 `models/hmm.py`文件。\n\n\n\n\n\n## 条件随机场（Conditional Random Field, CRF)\n\n HMM模型中存在两个假设，一是输出观察值之间严格独立，二是状态转移过程中当前状态只与前一状态有关。也就是说，在命名实体识别的场景下，HMM认为观测到的句子中的每个字都是相互独立的，而且当前时刻的标注只与前一时刻的标注相关。但实际上，命名实体识别往往需要更多的特征，比如词性，词的上下文等等，同时当前时刻的标注应该与前一时刻以及后一时刻的标注都相关联。由于这两个假设的存在，显然HMM模型在解决命名实体识别的问题上是存在缺陷的。\n\n条件随机场通过引入自定义的特征函数，不仅可以表达观测之间的依赖，还可表示当前观测与前后多个状态之间的复杂依赖，可以有效克服HMM模型面临的问题。\n\n为了建立一个条件随机场，我们首先要定义一个特征函数集，该函数集内的每个特征函数都以标注序列作为输入，提取的特征作为输出。假设该函数集为：\n\n![函数集](./imgs/func_set.png)\n\n其中$x=(x_1, ..., x_m)$表示观测序列，$s = (s_1, ...., s_m)$表示状态序列。然后，条件随机场使用对数线性模型来计算给定观测序列下状态序列的条件概率：\n\n![log_linear_crf](./imgs/log_linear_crf.png)\n\n其中$s^{'}$是是所有可能的状态序列，$w$是条件随机场模型的参数，可以把它看成是每个特征函数的权重。CRF模型的训练其实就是对参数$w$的估计。假设我们有$n$个已经标注好的数据$\\{(x^i, s^i)\\}_{i=1}^n$，\n\n则其对数似然函数的正则化形式如下：\n\n![log_likehood_crf](./imgs/log_likehood_crf.png)\n\n那么，最优参数$w^*$就是：\n\n![w_crf](./imgs/w_crf.png)\n\n模型训练结束之后，对给定的观测序列$x$，它对应的最优状态序列应该是：\n\n![decode_crf](./imgs/decode_crf.png)\n\n解码的时候与HMM类似，也可以采用维特比算法。\n\n具体的细节可以查看 `models/crf.py`文件。\n\n\n\n\n\n## Bi-LSTM\n\n除了以上两种基于概率图模型的方法，LSTM也常常被用来解决序列标注问题。和HMM、CRF不同的是，LSTM是依靠神经网络超强的非线性拟合能力，在训练时将样本通过高维空间中的复杂非线性变换，学习到从样本到标注的函数，之后使用这个函数为指定的样本预测每个token的标注。下方就是使用双向LSTM（双向能够更好的捕捉序列之间的依赖关系）进行序列标注的示意图：\n\n\n\n![biLSTM_NER](./imgs/biLSTM_NER.png)\n\n\n\n基于双向LSTM的序列标注模型实现可以查看`models/bilstm.py`文件。\n\n\n\n##  Bi-LSTM+CRF\n\nLSTM的优点是能够通过双向的设置学习到观测序列（输入的字）之间的依赖，在训练过程中，LSTM能够根据目标（比如识别实体）自动提取观测序列的特征，但是缺点是无法学习到状态序列（输出的标注）之间的关系，要知道，在命名实体识别任务中，标注之间是有一定的关系的，比如B类标注（表示某实体的开头）后面不会再接一个B类标注，所以LSTM在解决NER这类序列标注任务时，虽然可以省去很繁杂的特征工程，但是也存在无法学习到标注上下文的缺点。\n\n相反，CRF的优点就是能对隐含状态建模，学习状态序列的特点，但它的缺点是需要手动提取序列特征。所以一般的做法是，在LSTM后面再加一层CRF，以获得两者的优点。\n\n具体的实现请查看`models/bilstm_crf.py`\n\n\n\n## 代码中一些需要注意的点\n\n* HMM模型中要处理OOV(Out of vocabulary)的问题，就是测试集里面有些字是不在训练集里面的，\n  这个时候通过观测概率矩阵是无法查询到OOV对应的各种状态的概率的，处理这个问题可以将OOV对应的状态的概率分布设为均匀分布。\n* HMM的三个参数（即状态转移概率矩阵、观测概率矩阵以及初始状态概率矩阵）在使用监督学习方法进行估计的过程中，如果有些项从未出现，那么该项对应的位置就为0，而在使用维特比算法进行解码的时候，计算过程需要将这些值相乘，那么如果其中有为0的项，那么整条路径的概率也变成0了。此外，解码过程中多个小概率相乘很可能出现下溢的情况，为了解决这两个问题，我们给那些从未出现过的项赋予一个很小的数(如0.00000001)，同时在进行解码的时候将模型的三个参数都映射到对数空间，这样既可以避免下溢，又可以简化乘法运算。\n* CRF中将训练数据以及测试数据作为模型的输入之前，都需要先用特征函数提取特征！\n* Bi-LSTM+CRF模型可以参考：[Neural Architectures for Named Entity Recognition](https://arxiv.org/pdf/1603.01360.pdf)，可以重点看一下里面的损失函数的定义。代码里面关于损失函数的计算采用的是类似动态规划的方法，不是很好理解，这里推荐看一下以下这些博客：\n\n  * [CRF Layer on the Top of BiLSTM - 5](https://createmomo.github.io/2017/11/11/CRF-Layer-on-the-Top-of-BiLSTM-5/)\n  * [Bi-LSTM-CRF for Sequence Labeling PENG](https://zhuanlan.zhihu.com/p/27338210) \n  * [Pytorch Bi-LSTM + CRF 代码详解](https://blog.csdn.net/cuihuijun1hao/article/details/79405740)\n\n\n\n\n## TODO\n\n* BI-LSTM+CRF 比起Bi-LSTM效果并没有好很多，一种可能的解释是：\n  - 数据集太小，不足够让模型学习到转移矩阵（后续尝试在更大的数据集上测试一下结果）\n* 尝试更加复杂的模型，参考论文[Chinese NER using Lattice LSTM](https://github.com/jiesutd/LatticeLSTM)\n* 更详细的评估结果：打印混淆矩阵，同时输出每种类别的召回率、准确率、F1指标，便于分析。\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluopeixiang%2Fnamed_entity_recognition","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fluopeixiang%2Fnamed_entity_recognition","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluopeixiang%2Fnamed_entity_recognition/lists"}