diff --git a/docs/source/index.rst b/docs/source/index.rst index d48af986..e175dd94 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -1,17 +1,17 @@ fastNLP 中文文档 ===================== -`fastNLP `_ 是一款轻量级的 NLP 处理套件。你既可以使用它快速地完成一个序列标注 -(NER、POS-Tagging等)、中文分词、文本分类、Matching、指代消解、摘要等任务 -(详见 `reproduction `_ ); -也可以使用它构建许多复杂的网络模型,进行科研。它具有如下的特性: - -- 统一的Tabular式数据容器,让数据预处理过程简洁明了。内置多种数据集的 :mod:`~fastNLP.io.data_loader` ,省去预处理代码; -- 多种训练、测试组件,例如训练器 :class:`~fastNLP.Trainer` ;测试器 :class:`~fastNLP.Tester` ;以及各种评测 :mod:`~fastNLP.core.metrics` 等等; -- 各种方便的NLP工具,例如预处理 :mod:`embedding` 加载(包括ELMo和BERT); 中间数据存储 :func:`cache ` 等; -- 提供诸多高级模块 :mod:`~fastNLP.modules`,例如 :class:`~fastNLP.modules.VarLSTM` , :class:`Transformer` , :class:`CRF` 等; -- 在序列标注、中文分词、文本分类、Matching、指代消解、摘要等任务上封装了各种 :mod:`~fastNLP.models` 可供直接使用; -- 训练器便捷且具有扩展性,提供多种内置 :mod:`~fastNLP.core.callback` 函数,方便实验记录、异常捕获等。 +`fastNLP `_ 是一款轻量级的自然语言处理(NLP)工具包。你既可以用它来快速地完成一个NLP任务, +也可以用它在研究中快速构建更复杂的模型。 + +fastNLP具有如下的特性: + +- 统一的Tabular式数据容器,简化数据预处理过程; +- 内置多种数据集的 :class:`~fastNLP.io.Loader` 和 :class:`~fastNLP.io.Pipe` ,省去预处理代码; +- 各种方便的NLP工具,例如Embedding加载(包括 :class:`~fastNLP.embeddings.ElmoEmbedding` 和 :class:`~fastNLP.embeddings.BertEmbedding` )、中间数据cache等; +- 部分 `数据集与预训练模型 `_ 的自动下载; +- 提供多种神经网络组件以及复现模型(涵盖中文分词、命名实体识别、句法分析、文本分类、文本匹配、指代消解、摘要等任务); +- :class:`~fastNLP.Trainer` 提供多种内置 :mod:`~fastNLP.core.callback` 函数,方便实验记录、异常捕获等. 用户手册 diff --git a/fastNLP/core/metrics.py b/fastNLP/core/metrics.py index 4c05e94b..6aca0b20 100644 --- a/fastNLP/core/metrics.py +++ b/fastNLP/core/metrics.py @@ -380,7 +380,7 @@ class AccuracyMetric(MetricBase): class ClassifyFPreRecMetric(MetricBase): - """ + r""" 分类问题计算FPR值的Metric(其它的Metric参见 :mod:`fastNLP.core.metrics` ) 最后得到的metric结果为:: @@ -999,6 +999,9 @@ def _pred_topk(y_prob, k=1): class CMRC2018Metric(MetricBase): + r""" + CRMC2018任务的评价metric + """ def __init__(self, answers=None, raw_chars=None, context_len=None, pred_start=None, pred_end=None): super().__init__() self._init_param_map(answers=answers, raw_chars=raw_chars, context_len=context_len, pred_start=pred_start, diff --git a/fastNLP/embeddings/contextual_embedding.py b/fastNLP/embeddings/contextual_embedding.py index 9910a44b..2c8a9963 100644 --- a/fastNLP/embeddings/contextual_embedding.py +++ b/fastNLP/embeddings/contextual_embedding.py @@ -21,6 +21,9 @@ from ..core.vocabulary import Vocabulary class ContextualEmbedding(TokenEmbedding): + r""" + ContextualEmbedding组件. BertEmbedding与ElmoEmbedding的基类 + """ def __init__(self, vocab: Vocabulary, word_dropout: float = 0.0, dropout: float = 0.0): super(ContextualEmbedding, self).__init__(vocab, word_dropout=word_dropout, dropout=dropout)