Merge pull request #802 from PyThaiNLP/add-coref

Add pythainlp.coref

Author: wannaphong

.github/workflows/macos-test.yml

@@ -73,7 +73,7 @@ jobs:
         pip install pytest coverage coveralls
         conda install -c conda-forge icu
         conda install -c conda-forge pyicu
-        if [ -f docker_requirements.txt ]; then pip install -r docker_requirements.txt; fi
+        if [ -f docker_requirements.txt ]; then SKLEARN_ALLOW_DEPRECATED_SKLEARN_PACKAGE_INSTALL=True pip install -r docker_requirements.txt; fi
         pip install deepcut tltk
         pip install .[full]
         python -m nltk.downloader omw-1.4

.github/workflows/pypi-test.yml

@@ -22,7 +22,7 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install deepcut tltk
-        pip install -r https://raw.githubusercontent.com/PyThaiNLP/pythainlp/dev/docker_requirements.txt
+        SKLEARN_ALLOW_DEPRECATED_SKLEARN_PACKAGE_INSTALL=True pip install -r https://raw.githubusercontent.com/PyThaiNLP/pythainlp/dev/docker_requirements.txt
         pip install pythainlp[full]
         python -m nltk.downloader omw-1.4
     - name: Test

.github/workflows/test.yml

@@ -30,7 +30,7 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install pytest coverage coveralls
-        if [ -f docker_requirements.txt ]; then pip install -r docker_requirements.txt; fi
+        if [ -f docker_requirements.txt ]; then SKLEARN_ALLOW_DEPRECATED_SKLEARN_PACKAGE_INSTALL=True pip install -r docker_requirements.txt; fi
         pip install deepcut tltk
         pip install .[full]
         python -m nltk.downloader omw-1.4

docker_requirements.txt

@@ -10,7 +10,7 @@ epitran==1.9
 sacremoses==0.0.41
 sentencepiece==0.1.91
 ssg==0.0.8
-torch==1.8.1
+torch==1.13.1
 fastai==1.0.61
 transformers==4.22.1
 phunspell==0.1.6
@@ -24,13 +24,14 @@ deepcut==0.7.0.0
 h5py==3.1.0
 tensorflow==2.9.3
 pandas==1.4.*
-tltk==1.3.8
+tltk==1.6.8
 OSKut==1.3
 nlpo3==1.2.6
 thai-nner==0.3
-spacy==2.3.*
+spacy==3.5.*
 wunsen==0.0.3
 khanaa==0.0.6
 spacy_thai==0.7.1
 esupar==1.3.8
 ufal.chu-liu-edmonds==1.0.2
+fastcoref==2.1.6

docs/api/coref.rst

@@ -0,0 +1,10 @@
+.. currentmodule:: pythainlp.coref
+
+pythainlp.coref
+===============
+The :class:`pythainlp.coref` is Coreference Resolution for Thai.
+
+Modules
+-------
+
+.. autofunction:: coreference_resolution

docs/notes/installation.rst

@@ -35,6 +35,7 @@ where ``extras`` can be
   - ``esupar`` (to support esupar engine)
   - ``transformers_ud`` (to support transformers_ud engine)
   - ``dependency_parsing`` (to support dependency parsing with all engine)
+  - ``coreference_resolution`` (to support coreference esolution with all engine)
   - ``full`` (install everything)
 
 For dependency details, look at `extras` variable in `setup.py <https://github.com/PyThaiNLP/pythainlp/blob/dev/setup.py>`_.

pythainlp/coref/__init__.py

@@ -0,0 +1,19 @@
+# -*- coding: utf-8 -*-
+# Copyright (C) 2016-2023 PyThaiNLP Project
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""
+PyThaiNLP Coreference Resolution
+"""
+__all__ = ["coreference_resolution"]
+from pythainlp.coref.core import coreference_resolution

pythainlp/coref/_fastcoref.py

@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+# Copyright (C) 2016-2023 PyThaiNLP Project
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from typing import List
+import spacy
+
+
+class FastCoref:
+    def __init__(self, model_name, nlp=spacy.blank("th"), device:str="cpu", type:str="FCoref") -> None:
+        if type == "FCoref":
+            from fastcoref import FCoref as _model
+        else:
+            from fastcoref import LingMessCoref as _model
+        self.model_name = model_name
+        self.nlp = nlp
+        self.model = _model(self.model_name,device=device,nlp=self.nlp)
+    
+    def _to_json(self, _predict):
+        return {
+            "text":_predict.text,
+            "clusters_string":_predict.get_clusters(as_strings=True),
+            "clusters":_predict.get_clusters(as_strings=False)
+        }
+
+    
+    def predict(self, texts:List[str])->dict:
+        return [self._to_json(i) for i in self.model.predict(texts=texts)]

pythainlp/coref/core.py

@@ -0,0 +1,55 @@
+# -*- coding: utf-8 -*-
+# Copyright (C) 2016-2023 PyThaiNLP Project
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from typing import List
+model = None
+
+
+def coreference_resolution(texts:List[str], model_name:str="han-coref-v1.0", device:str="cpu"):
+    """
+    Coreference Resolution
+
+    :param List[str] texts: list texts to do coreference resolution
+    :param str model_name: coreference resolution model
+    :param str device: device for running coreference resolution model (cpu, cuda, and other)
+    :return: List txets of coreference resolution
+    :rtype: List[dict]
+
+    :Options for model_name:
+        * *han-coref-v1.0* - (default) Han-Corf: Thai oreference resolution by PyThaiNLP v1.0
+
+    :Example:
+    ::
+
+        from pythainlp.coref import coreference_resolution
+
+        print(
+            coreference_resolution(
+                ["Bill Gates ได้รับวัคซีน COVID-19 เข็มแรกแล้ว ระบุ ผมรู้สึกสบายมาก"]
+            )
+        )
+        # output:
+        # [
+        # {'text': 'Bill Gates ได้รับวัคซีน COVID-19 เข็มแรกแล้ว ระบุ ผมรู้สึกสบายมาก', 
+        # 'clusters_string': [['Bill Gates', 'ผม']], 
+        # 'clusters': [[(0, 10), (50, 52)]]}
+        # ]
+    """
+    global model
+    if isinstance(texts, str):
+        texts = [texts]
+    if model == None and model_name=="han-coref-v1.0":
+        from pythainlp.coref.han_coref import HanCoref
+        model = HanCoref(device=device)
+    return model.predict(texts)

pythainlp/coref/han_coref.py

@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+# Copyright (C) 2016-2023 PyThaiNLP Project
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from pythainlp.coref._fastcoref import FastCoref
+import spacy
+
+
+class HanCoref(FastCoref):
+    def __init__(self,device:str="cpu",nlp=spacy.blank("th")) -> None:
+        super(self.__class__, self).__init__(
+            model_name="pythainlp/han-coref-v1.0",
+            device=device,
+            nlp=nlp
+        )