From 3755ee90d38ec0b1fbc0e9fbbef3ecf7da70fc22 Mon Sep 17 00:00:00 2001
From: Francis Tyers <ftyers@users.noreply.github.com>
Date: Mon, 20 Feb 2017 22:36:54 +0100
Subject: [PATCH 0001/1374] Update vislcg.py
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This fixes the бир нәрсе problem, but leaves a problem with multiwords... e.g.

2-3	екеуі де	_	_	_	_	_	_	_	_
2	екеуі	екеу	_	num	px3sp|nom	1	appos	_	_
3	де	"да	_	postadv	_	2	advmod	_	_
---
 udapi/block/read/vislcg.py | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/udapi/block/read/vislcg.py b/udapi/block/read/vislcg.py
index 3c5852d7..d5906650 100644
--- a/udapi/block/read/vislcg.py
+++ b/udapi/block/read/vislcg.py
@@ -23,6 +23,7 @@ def read_tree(self, document=None):
                 break
             if line[0] == '#':
                 # Are comments allowed in VISL-cg?
+                # FMT: Yes :)
                 continue
 
             if line[0].isspace():
@@ -60,15 +61,17 @@ def read_tree(self, document=None):
                 raise ValueError("Node %s HEAD is out of range (%d)" % (node, parents[node_ord]))
 
         return root
-
+    
     @staticmethod
     def _node(line, root):
-        fields = shlex.split(line)
-        lemma = fields[0]
-        xpos = fields[1]
-        feats_list = fields[2:-2]
+        delim = line.rfind('"');
+        lemma = line[2:delim]
+        fields = line[delim+1:].split()
+        xpos = fields[0]
+        feats_list = fields[3:-2]
         feats = '|'.join(feats_list) if feats_list else '_'
         deprel = fields[-2][1:]
         parent_ord = int(fields[-1].split('->')[1])
         node = root.create_child(lemma=lemma, xpos=xpos, feats=feats, deprel=deprel)
         return node, parent_ord
+

From c1348ab59dee8bf72bbbb25afe590e6f641ccf3c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 20 Feb 2017 21:01:17 +0100
Subject: [PATCH 0002/1374] ud.MarkBugs tests=<regex>

If we want to apply just one or two tests.
---
 udapi/block/ud/markbugs.py | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index 37fd94bd..be3235f8 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -31,22 +31,31 @@
 class MarkBugs(Block):
     """Block for checking suspicious/wrong constructions in UD v2."""
 
-    def __init__(self, save_stats=True, skip=None, **kwargs):
+    def __init__(self, save_stats=True, tests=None, skip=None, **kwargs):
         """Create the MarkBugs block object.
 
         Args:
         save_stats: store the bug statistics overview into `document.misc["bugs"]`?
-        skip: a regex. If `re.search(skip, short_msg)` the node is not reported.
+        tests: a regex of tests to include.
+            If `not re.search(tests, short_msg)` the node is not reported.
+            You can use e.g. `tests=aux-chain|cop-upos` to apply only those two tests.
+            Default = None (or empty string or '.*') which all tests.
+        skip: a regex of tests to exclude.
+            If `re.search(skip, short_msg)` the node is not reported.
             You can use e.g. `skip=no-(VerbForm|NumType|PronType)`.
+            This has higher priority than the `tests` regex.
             Default = None (or empty string) which means no skipping.
         """
         super().__init__(**kwargs)
         self.save_stats = save_stats
         self.stats = collections.Counter()
+        self.tests_re = re.compile(tests) if (tests is not None and tests != '') else None
         self.skip_re = re.compile(skip) if (skip is not None and skip != '') else None
 
     def log(self, node, short_msg, long_msg):
         """Log node.address() + long_msg and add ToDo=short_msg to node.misc."""
+        if self.tests_re is not None and not self.tests_re.search(short_msg):
+            return
         if self.skip_re is not None and self.skip_re.search(short_msg):
             return
         logging.debug('node %s %s: %s', node.address(), short_msg, long_msg)

From 58ba3e6ecb48300b434a487df6635e8b0be5ad8d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 21 Feb 2017 19:13:31 +0100
Subject: [PATCH 0003/1374] node.sdeprel for language-specific deprel subtype

---
 udapi/core/node.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index fd87bc13..7666c428 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -106,6 +106,21 @@ def udeprel(self):
         """
         return self.deprel.split(':')[0] if self.deprel is not None else None
 
+    @property
+    def sdeprel(self):
+        """Return the language-specific part of dependency relation.
+
+        E.g. if deprel = `acl:relcl` then sdeprel = `relcl`.
+        If deprel=`acl` then sdeprel = empty string.
+        If deprel is `None` then `node.sdeprel` will return `None` as well.
+        """
+        if self.deprel is None:
+            return None
+        parts = self.deprel.split(':', 1)
+        if len(parts) == 2:
+            return parts[1]
+        return ''
+
     @property
     def feats(self):
         """Property for morphological features stored as a `Feats` object.

From ea524a647102ba70850320fe8a2b66e5991a9a7c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 21 Feb 2017 19:14:04 +0100
Subject: [PATCH 0004/1374] convert e.g. dobj:lvc to obj:lvc

---
 udapi/block/ud/convert1to2.py | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/convert1to2.py b/udapi/block/ud/convert1to2.py
index 72d08ab8..ce549256 100644
--- a/udapi/block/ud/convert1to2.py
+++ b/udapi/block/ud/convert1to2.py
@@ -114,15 +114,21 @@ def change_upos_copula(node):
         if node.deprel == 'cop' and node.upos not in ("AUX", "PRON"):
             node.upos = "AUX"
 
-    @staticmethod
-    def change_deprel_simple(node):
+    def change_deprel_simple(self, node):
         """mwe→fixed, dobj→obj, *pass→*:pass, name→flat, foreign→flat+Foreign=Yes."""
-        if node.deprel == 'foreign':
+        if node.udeprel == 'foreign':
             node.feats['Foreign'] = 'Yes'
+        udeprel, sdeprel = node.udeprel, node.sdeprel
         try:
-            node.deprel = DEPREL_CHANGE[node.deprel]
+            node.deprel = DEPREL_CHANGE[udeprel]
         except KeyError:
-            pass
+            return
+        if sdeprel:
+            if ':' in node.deprel:
+                self.log(node, 'deprel', 'deprel=%s:%s new_deprel=%s but %s is lost' %
+                         (udeprel, sdeprel, node.deprel, sdeprel))
+            else:
+                node.deprel += ':' + sdeprel
 
     def change_neg(self, node):
         """neg→advmod/det/ToDo + Polarity=Neg.

From 0146cf4e4977df300e5ab9ab4fe98878fcce97ed Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 21 Feb 2017 20:04:02 +0100
Subject: [PATCH 0005/1374] fix read.Vislcg

Mea culpa: `line.lstrip(line)`
is not `line = line.lstrip()`
---
 udapi/block/read/conllu.py |  2 +-
 udapi/block/read/vislcg.py | 21 ++++++++++-----------
 2 files changed, 11 insertions(+), 12 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 8c80a779..79ccfaea 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -72,7 +72,7 @@ def parse_comment_line(line, root):
                 root.newdoc = value
             return
 
-        root.comment = root.comment + line[1:] + "\n"
+        root.comment += line[1:] + "\n"
 
     # pylint: disable=too-many-locals,too-many-branches,too-many-statements
     # Maybe the code could be refactored, but it is speed-critical,
diff --git a/udapi/block/read/vislcg.py b/udapi/block/read/vislcg.py
index d5906650..3d8b7637 100644
--- a/udapi/block/read/vislcg.py
+++ b/udapi/block/read/vislcg.py
@@ -1,6 +1,4 @@
 """Vislcg is a reader block the VISL-cg format."""
-import shlex
-
 from udapi.core.basereader import BaseReader
 from udapi.core.root import Root
 
@@ -22,13 +20,11 @@ def read_tree(self, document=None):
             if line == '':
                 break
             if line[0] == '#':
-                # Are comments allowed in VISL-cg?
-                # FMT: Yes :)
+                root.comment += line[1:] + "\n"
                 continue
 
             if line[0].isspace():
-                line.lstrip(line)
-                node, parent_ord = self._node(line, root)
+                node, parent_ord = self._node(line.lstrip(), root)
                 words.append(node)
                 parents.append(parent_ord)
             else:
@@ -61,12 +57,16 @@ def read_tree(self, document=None):
                 raise ValueError("Node %s HEAD is out of range (%d)" % (node, parents[node_ord]))
 
         return root
-    
+
     @staticmethod
     def _node(line, root):
-        delim = line.rfind('"');
-        lemma = line[2:delim]
-        fields = line[delim+1:].split()
+        # line contains "lemma" xpos feat1 feat2 .. featN @deprel #ord->parent.ord
+        # Lemma can contain spaces, but quotes within lemma are not escaped,
+        # so we cannot use fields = shlex.split(line)
+        # Let's hope that xpos, feats and deprel do not contain any quotes.
+        end_quote_pos = line.rfind('"');
+        lemma = line[2:end_quote_pos]
+        fields = line[end_quote_pos+1:].split()
         xpos = fields[0]
         feats_list = fields[3:-2]
         feats = '|'.join(feats_list) if feats_list else '_'
@@ -74,4 +74,3 @@ def _node(line, root):
         parent_ord = int(fields[-1].split('->')[1])
         node = root.create_child(lemma=lemma, xpos=xpos, feats=feats, deprel=deprel)
         return node, parent_ord
-

From 1aa0cdcf8abd08dd10140f09c402461ffea433fa Mon Sep 17 00:00:00 2001
From: Francis Tyers <ftyers@users.noreply.github.com>
Date: Tue, 21 Feb 2017 20:11:30 +0100
Subject: [PATCH 0006/1374] Update vislcg.py

From the second character, not the third, e.g. \t"foo
---
 udapi/block/read/vislcg.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/read/vislcg.py b/udapi/block/read/vislcg.py
index 3d8b7637..4c2eb618 100644
--- a/udapi/block/read/vislcg.py
+++ b/udapi/block/read/vislcg.py
@@ -65,7 +65,7 @@ def _node(line, root):
         # so we cannot use fields = shlex.split(line)
         # Let's hope that xpos, feats and deprel do not contain any quotes.
         end_quote_pos = line.rfind('"');
-        lemma = line[2:end_quote_pos]
+        lemma = line[1:end_quote_pos]
         fields = line[end_quote_pos+1:].split()
         xpos = fields[0]
         feats_list = fields[3:-2]

From bc37e233002c30647a3542f2c47aed93169d2bbe Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 22 Feb 2017 13:50:02 +0100
Subject: [PATCH 0007/1374] prevent "BrokenPipeError: [Errno 32] Broken pipe"

---
 bin/udapy | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/bin/udapy b/bin/udapy
index 03b9e3d2..773661c8 100755
--- a/bin/udapy
+++ b/bin/udapy
@@ -66,5 +66,13 @@ if __name__ == "__main__":
         args.scenario = args.scenario + ['marked_only=1']
     if args.no_color:
         args.scenario = args.scenario + ['color=0']
+
     runner = Run(args)
-    runner.execute()
+    # udapy is often piped to head etc., e.g.
+    # `seq 1000 | udapy -s read.Sentences | head`
+    # Let's prevent Python from reporting (with distracting stacktrace)
+    # "BrokenPipeError: [Errno 32] Broken pipe"
+    try:
+        runner.execute()
+    except (BrokenPipeError, IOError):
+        pass

From 0380d3d719e40af81a7cad9b38bf2991b0c12df2 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 22 Feb 2017 14:37:56 +0100
Subject: [PATCH 0008/1374] UD_Galician-specific conversion of UDv1 to UDv2

or rather fixing the errors in the UDv1.4
---
 udapi/block/ud/gl/__init__.py |  0
 udapi/block/ud/gl/to2.py      | 59 +++++++++++++++++++++++++++++++++++
 2 files changed, 59 insertions(+)
 create mode 100644 udapi/block/ud/gl/__init__.py
 create mode 100644 udapi/block/ud/gl/to2.py

diff --git a/udapi/block/ud/gl/__init__.py b/udapi/block/ud/gl/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/ud/gl/to2.py b/udapi/block/ud/gl/to2.py
new file mode 100644
index 00000000..f5f0f451
--- /dev/null
+++ b/udapi/block/ud/gl/to2.py
@@ -0,0 +1,59 @@
+"""Block ud.gl.To2 UD_Galician-specific conversion of UDv1 to UDv2
+
+Author: Martin Popel
+"""
+from udapi.core.block import Block
+
+ADP_HEAD_PREFERENCES = {
+    'NOUN': 10,
+    'PRON': 9,
+    'ADJ': 8,
+    'VERB': 8,
+    'PUNCT': -10,
+}
+
+class To2(Block):
+    """Block for fixing the remaining cases (before ud.Convert1to2) in UD_Galician."""
+
+    def process_node(self, node):
+
+        # UD_Galician v1.4 uses incorrectly deprel=cop not for the copula verb,
+        # but for its complement (typically ADJ) and also copula is the head.
+        if node.deprel == 'cop':
+            copula = node.parent
+            # In UDv2 discussions it has been decided that only a limited set of verbs
+            # can be annotated as copula. For Spanish, "estar" was questionable, but accepted.
+            # I guess in Galician it is the same. The rest (considerar, resultar, quedar,...)
+            # should not be annotated as copulas. Luckily, in UD_Galician v1.4 they are
+            # governing the clause, so no change of topology is needed, just deprel=xcomp.
+            if copula.lemma in ('ser', 'estar'):
+                node.parent = copula.parent
+                for cop_child in copula.children:
+                    cop_child.parent = node
+                copula.parent = node
+                node.deprel = copula.deprel
+                copula.deprel = 'cop'
+            else:
+                node.deprel = 'xcomp'
+
+        # Prepositions should depend on the noun, not vice versa.
+        # This is easy to fix, but unfortunatelly, there are many nodes with deprel=case
+        # which are not actually prepostions or case markes, but standard NOUNs, VERBs etc.
+        # These are left as ToDo.
+        if node.deprel == 'case' and node.children:
+            if node.upos not in ('ADP', 'CONJ', 'PART'):
+                node.misc['ToDo'] = 'case-upos'
+            else:
+                children = sorted(node.children, key=lambda n: -ADP_HEAD_PREFERENCES.get(n.upos, 0))
+                children[0].parent = node.parent
+                node.parent = children[0]
+                for child in children[1:]:
+                    child.parent = children[0]
+
+        # Punctuation should have no children.
+        if node.deprel == 'punct' and node.children and node.upos == 'PUNCT':
+            children = sorted(node.children, key=lambda n: -ADP_HEAD_PREFERENCES.get(n.upos, 0))
+            children[0].parent = node.parent
+            node.parent = children[0]
+            for child in children[1:]:
+                child.parent = children[0]

From 41eaf1f28e07227aaebb5fca2b1f91c437faa146 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 22 Feb 2017 17:08:54 +0100
Subject: [PATCH 0009/1374] allow e.g. sent_id_filter=101

---
 udapi/core/basereader.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 0146ca90..bb126ae7 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -21,7 +21,7 @@ def __init__(self, files='-', zone='keep', bundles_per_doc=0, encoding='utf-8',
         self.finished = False
         self.sent_id_filter = None
         if sent_id_filter is not None:
-            self.sent_id_filter = re.compile(sent_id_filter)
+            self.sent_id_filter = re.compile(str(sent_id_filter))
             logging.debug('Using sent_id_filter=%s', sent_id_filter)
         self.split_docs = split_docs
 

From 5fe11898506d2920ae571105e70045ae54a3582e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 22 Feb 2017 17:31:27 +0100
Subject: [PATCH 0010/1374] pylint

---
 udapi/block/read/vislcg.py | 31 ++++++++++++++++---------------
 1 file changed, 16 insertions(+), 15 deletions(-)

diff --git a/udapi/block/read/vislcg.py b/udapi/block/read/vislcg.py
index 4c2eb618..26b3d787 100644
--- a/udapi/block/read/vislcg.py
+++ b/udapi/block/read/vislcg.py
@@ -27,20 +27,21 @@ def read_tree(self, document=None):
                 node, parent_ord = self._node(line.lstrip(), root)
                 words.append(node)
                 parents.append(parent_ord)
-            else:
-                if words:
-                    words[0].form = form
-                    if len(words) > 1:
-                        split_forms = form.split()
-                        if len(words) == len(split_forms):
-                            for word, split_form in zip(words, split_forms):
-                                word.form = split_form
-                        else:
-                            for word in words[1:]:
-                                word.form = '_'
-                        root.create_multiword_token(words, form=form)
-                    words = []
-                form = line[2:-2]
+                continue
+
+            if words:
+                words[0].form = form
+                if len(words) > 1:
+                    split_forms = form.split()
+                    if len(words) == len(split_forms):
+                        for word, split_form in zip(words, split_forms):
+                            word.form = split_form
+                    else:
+                        for word in words[1:]:
+                            word.form = '_'
+                    root.create_multiword_token(words, form=form)
+                words = []
+            form = line[2:-2]
 
         if words:
             words[0].form = form
@@ -64,7 +65,7 @@ def _node(line, root):
         # Lemma can contain spaces, but quotes within lemma are not escaped,
         # so we cannot use fields = shlex.split(line)
         # Let's hope that xpos, feats and deprel do not contain any quotes.
-        end_quote_pos = line.rfind('"');
+        end_quote_pos = line.rfind('"')
         lemma = line[1:end_quote_pos]
         fields = line[end_quote_pos+1:].split()
         xpos = fields[0]

From 19db31ab1094280cf45d97b49dbe34db1b8c08ed Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 22 Feb 2017 18:31:13 +0100
Subject: [PATCH 0011/1374] block for fixing punct nodes with children

---
 udapi/block/ud/fixpunctchild.py | 9 +++++++++
 1 file changed, 9 insertions(+)
 create mode 100644 udapi/block/ud/fixpunctchild.py

diff --git a/udapi/block/ud/fixpunctchild.py b/udapi/block/ud/fixpunctchild.py
new file mode 100644
index 00000000..a9f16b8c
--- /dev/null
+++ b/udapi/block/ud/fixpunctchild.py
@@ -0,0 +1,9 @@
+"""Block ud.FixPunctChild for making sure punctuation nodes have no children."""
+from udapi.core.block import Block
+
+class FixPunctChild(Block):
+    """Make sure punct nodes have no children by rehanging the children upwards."""
+
+    def process_node(self, node):
+        while node.parent.deprel == 'punct':
+            node.parent = node.parent.parent

From c31300d1427316145685dd65ec77414b44d5f0d1 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 22 Feb 2017 23:03:34 +0100
Subject: [PATCH 0012/1374] deprel=punct iff upos=PUNCT

---
 udapi/block/ud/markbugs.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index be3235f8..14b07797 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -118,6 +118,9 @@ def process_node(self, node):
         if parent.deprel == 'punct':
             self.log(node, 'punct-child', 'parent.deprel=punct')
 
+        if upos == 'PUNCT' and deprel != 'punct':
+            self.log(node, 'punct-deprel', 'upos=PUNCT deprel!=punct (but %s)' % deprel)
+
         # See http://universaldependencies.org/u/overview/syntax.html#the-status-of-function-words
         # TODO: Promotion by Head Elision: It is difficult to detect this exception.
         #       So far, I have just excluded "det" from the forbidded parent.deprel set
@@ -147,7 +150,7 @@ def process_node(self, node):
         if upos == 'SYM' and form.isalpha():
             self.log(node, 'sym-alpha', "upos=SYM but all form chars are alphabetical: " + form)
 
-        if upos == 'PUNCT' and  any(char.isalpha() for char in form):
+        if upos == 'PUNCT' and any(char.isalpha() for char in form):
             self.log(node, 'punct-alpha', "upos=PUNCT but form has alphabetical char(s): " + form)
 
     def after_process_document(self, document):

From c07fa8b03dda39b53adf6437d70a2dec74146753 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 23 Feb 2017 15:55:24 +0100
Subject: [PATCH 0013/1374] add `cc-upos` test, make `punct-deprel` test less
 strict

---
 udapi/block/ud/markbugs.py | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index 14b07797..1897c39c 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -66,7 +66,7 @@ def log(self, node, short_msg, long_msg):
             node.misc['Bug'] = short_msg
         self.stats[short_msg] += 1
 
-    # pylint: disable=too-many-branches
+    # pylint: disable=too-many-branches, too-many-statements
     def process_node(self, node):
         form, deprel, upos, feats = node.form, node.deprel, node.upos, node.feats
         parent = node.parent
@@ -118,9 +118,6 @@ def process_node(self, node):
         if parent.deprel == 'punct':
             self.log(node, 'punct-child', 'parent.deprel=punct')
 
-        if upos == 'PUNCT' and deprel != 'punct':
-            self.log(node, 'punct-deprel', 'upos=PUNCT deprel!=punct (but %s)' % deprel)
-
         # See http://universaldependencies.org/u/overview/syntax.html#the-status-of-function-words
         # TODO: Promotion by Head Elision: It is difficult to detect this exception.
         #       So far, I have just excluded "det" from the forbidded parent.deprel set
@@ -153,6 +150,17 @@ def process_node(self, node):
         if upos == 'PUNCT' and any(char.isalpha() for char in form):
             self.log(node, 'punct-alpha', "upos=PUNCT but form has alphabetical char(s): " + form)
 
+        if upos == 'PUNCT' and deprel not in ('punct', 'fixed', 'goeswith', 'root'):
+            self.log(node, 'punct-deprel', 'upos=PUNCT deprel!=punct|fixed|goeswith|root (but %s)'
+                     % deprel)
+
+        # http://universaldependencies.org/u/dep/cc.html says
+        #   "cc is the relation between a conjunct and a preceding
+        #   [coordinating conjunction](http://universaldependencies.org/u/pos/CCONJ)."
+        # No other upos is allowed in the documentation, although e.g. PART is common in the data.
+        if deprel == 'cc' and upos != 'CCONJ':
+            self.log(node, 'cc-upos', "deprel=cc upos!=CCONJ (but %s): " % upos)
+
     def after_process_document(self, document):
         total = 0
         message = 'ud.MarkBugs Error Overview:'

From 51e3e9853525cad6e17031deab455a11324d41e6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 23 Feb 2017 20:36:48 +0100
Subject: [PATCH 0014/1374] don't silence all IOError

I had included IOError because SO says,
Windows raise it instead of BrokenPipeError,
but now I see it was not a good idea.
---
 bin/udapy                        | 5 +++--
 udapi/block/read/addsentences.py | 2 +-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/bin/udapy b/bin/udapy
index 773661c8..c756c5cb 100755
--- a/bin/udapy
+++ b/bin/udapy
@@ -48,7 +48,8 @@ elif args.quiet:
 else:
     level = logging.INFO
 
-logging.basicConfig(format='%(asctime)-15s [%(levelname)7s] %(funcName)s - %(message)s', level=level)
+logging.basicConfig(format='%(asctime)-15s [%(levelname)7s] %(funcName)s - %(message)s',
+                    level=level)
 
 # Process and provide the scenario.
 if __name__ == "__main__":
@@ -74,5 +75,5 @@ if __name__ == "__main__":
     # "BrokenPipeError: [Errno 32] Broken pipe"
     try:
         runner.execute()
-    except (BrokenPipeError, IOError):
+    except BrokenPipeError:
         pass
diff --git a/udapi/block/read/addsentences.py b/udapi/block/read/addsentences.py
index 75c4ac7d..67c79ee8 100644
--- a/udapi/block/read/addsentences.py
+++ b/udapi/block/read/addsentences.py
@@ -34,7 +34,7 @@ def process_document(self, document):
         for bundle in document.bundles:
             line = self.filehandle.readline()
             if line == '':
-                raise IOError('File does not have enoush lines')
+                raise IOError('File does not have enough lines')
             root = bundle.get_tree(zone=self.zone)
             root.text = line.rstrip()
         self.finished = not self.files.has_next_file()

From 30ac74b178638ec849718b30e1e09da8f911b4e5 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 23 Feb 2017 21:18:10 +0100
Subject: [PATCH 0015/1374] escape html special chars in
 write.TextModeTreesHtml

---
 udapi/block/write/textmodetrees.py     | 14 +++++++++-----
 udapi/block/write/textmodetreeshtml.py |  9 +++++++++
 2 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index 3c9f7308..a2c949cc 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -214,17 +214,21 @@ def process_tree(self, root):
                 stack = sorted(stack, key=lambda x: -self._gaps[x.ord])
 
         # Print headers (if required) and the tree itself
+        self.print_headers(root)
+        for line in self.lines:
+            print(line)
+
+        if self.add_empty_line:
+            print('')
+
+    def print_headers(self, root):
+        """Print sent_id, text and other comments related to the tree."""
         if self.print_sent_id:
             print('# sent_id = ' + root.address())
         if self.print_text:
             print("# text = " + (root.get_sentence() if root.is_root() else root.compute_text()))
         if self.print_comments and root.comment:
             print('#' + self.colorize_comment(root.comment.rstrip().replace('\n', '\n#')))
-        for line in self.lines:
-            print(line)
-
-        if self.add_empty_line:
-            print('')
 
     def _ends(self, idx, chars):
         return bool(self.lines[idx] and self.lines[idx][-1] in chars)
diff --git a/udapi/block/write/textmodetreeshtml.py b/udapi/block/write/textmodetreeshtml.py
index ecb0efb8..21bd8e92 100644
--- a/udapi/block/write/textmodetreeshtml.py
+++ b/udapi/block/write/textmodetreeshtml.py
@@ -72,3 +72,12 @@ def colorize_comment(self, comment):
     def colorize_attr(attr, value, marked):
         """Return a string with color markup for a given attr and its value."""
         return "<span class='%s'>%s</span>" % (attr, escape(value))
+
+    def print_headers(self, root):
+        if self.print_sent_id:
+            print('# sent_id = ' + escape(root.address()))
+        if self.print_text:
+            text = "# text = " + (root.get_sentence() if root.is_root() else root.compute_text())
+            print(escape(text))
+        if self.print_comments and root.comment:
+            print(escape('#' + self.colorize_comment(root.comment.rstrip().replace('\n', '\n#'))))

From 23d7814f187a6224b17a68b596cbe8e29ab91345 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 23 Feb 2017 21:24:43 +0100
Subject: [PATCH 0016/1374] skip `appos-chain`, add `list-chain` and
 `list-rightheaded`

---
 udapi/block/ud/markbugs.py | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index 1897c39c..44cfb5cc 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -71,11 +71,20 @@ def process_node(self, node):
         form, deprel, upos, feats = node.form, node.deprel, node.upos, node.feats
         parent = node.parent
 
-        for dep in ('aux', 'fixed', 'appos', 'goeswith'):
+        for dep in ('aux', 'fixed', 'goeswith', 'list'):
             if deprel == dep and parent.deprel == dep:
                 self.log(node, dep + '-chain', dep + ' dependencies should not form a chain.')
 
-        for dep in ('flat', 'fixed', 'conj', 'appos', 'goeswith'):
+        # 'appos-chain' is more difficult to test because nested appositions are allowed.
+        # The commented-out code below prevents just some of the false alarms
+        # (those where changing the nested appos into flat would result in non-projectivity).
+        # Unfortunatelly, there are still too many false alarms, so let's skip this test completely.
+        # It seems that multiple appositions as siblings are much less common than nested.
+        # if deprel == 'appos' and parent.deprel == 'appos':
+        #     if not node.precedes(parent.children[-1]):
+        #         self.log(node, 'appos-chain', 'appos should not form a chain except when nested.')
+
+        for dep in ('flat', 'fixed', 'conj', 'appos', 'goeswith', 'list'):
             if deprel == dep and node.precedes(parent):
                 self.log(node, dep + '-rightheaded',
                          dep + ' relations should be left-headed, not right.')

From e9474fe8c2846630f74b9f68a17b7b30a3127dc4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 15 Mar 2017 22:56:39 +0100
Subject: [PATCH 0017/1374] DualDict can be initialized with string or dict

this allows us to use e.g.
`root.create_multiword_token(nodes, mwt_form, another_node.misc)`
instead of unintuitive
`root.create_multiword_token(nodes, mwt_form, str(another_node.misc))`
---
 udapi/core/dualdict.py | 15 +++++++--------
 udapi/core/mwt.py      |  2 +-
 udapi/core/node.py     |  4 ++--
 3 files changed, 10 insertions(+), 11 deletions(-)

diff --git a/udapi/core/dualdict.py b/udapi/core/dualdict.py
index a68cb0bb..2b98f45c 100644
--- a/udapi/core/dualdict.py
+++ b/udapi/core/dualdict.py
@@ -28,14 +28,13 @@ class DualDict(collections.abc.MutableMapping):
     """
     __slots__ = ['_string', '_dict']
 
-    def __init__(self, string=None, *args, **kwargs):
-        if string is not None:
-            if args:
-                raise ValueError('If string is specified, no other arg is allowed ' + str(args))
-            if kwargs:
-                raise ValueError('If string is specified, no other kwarg is allowed ' + str(kwargs))
-        self._dict = dict(args, **kwargs)
-        self._string = string
+    def __init__(self, value=None, **kwargs):
+        if value is not None and kwargs:
+            raise ValueError('If value is specified, no other kwarg is allowed ' + str(kwargs))
+        self._dict = dict(**kwargs)
+        self._string = None
+        if value is not None:
+            self.set_mapping(value)
 
     def __str__(self):
         if self._string is None:
diff --git a/udapi/core/mwt.py b/udapi/core/mwt.py
index 8a623804..19bbdbb5 100644
--- a/udapi/core/mwt.py
+++ b/udapi/core/mwt.py
@@ -9,7 +9,7 @@ class MWT(object):
     def __init__(self, words=None, form=None, misc=None, root=None):
         self.words = words if words is not None else []
         self.form = form
-        self._misc = DualDict(string=misc)
+        self._misc = DualDict(misc)
         self.root = root
         for word in self.words:
             word._mwt = self # pylint: disable=W0212
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 7666c428..0d745baa 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -85,9 +85,9 @@ def __init__(self, form=None, lemma=None, upos=None, # pylint: disable=too-many-
         self.lemma = lemma
         self.upos = upos
         self.xpos = xpos
-        self._feats = Feats(string=feats)
+        self._feats = Feats(feats)
         self.deprel = deprel
-        self._misc = DualDict(string=misc)
+        self._misc = DualDict(misc)
         self._raw_deps = '_'
         self._deps = None
         self._parent = None

From a364bd76736fff4975c4af46913cac3e4ce7576d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 16 Mar 2017 19:19:13 +0100
Subject: [PATCH 0018/1374] new blocks ud.RemoveMwt and ud.cs.AddMwt

Plus abstract base class ud.AddMwt.
---
 udapi/block/ud/addmwt.py      | 69 ++++++++++++++++++++++++++++++++
 udapi/block/ud/cs/__init__.py |  0
 udapi/block/ud/cs/addmwt.py   | 74 +++++++++++++++++++++++++++++++++++
 udapi/block/ud/removemwt.py   | 37 ++++++++++++++++++
 4 files changed, 180 insertions(+)
 create mode 100644 udapi/block/ud/addmwt.py
 create mode 100644 udapi/block/ud/cs/__init__.py
 create mode 100644 udapi/block/ud/cs/addmwt.py
 create mode 100644 udapi/block/ud/removemwt.py

diff --git a/udapi/block/ud/addmwt.py b/udapi/block/ud/addmwt.py
new file mode 100644
index 00000000..6d74d4a2
--- /dev/null
+++ b/udapi/block/ud/addmwt.py
@@ -0,0 +1,69 @@
+"""Abstract base class ud.AddMwt for heuristic detection of multi-word tokens."""
+from udapi.core.block import Block
+
+class AddMwt(Block):
+    """Detect and mark MWTs (split them into words and add the words to the tree)."""
+
+    def process_node(self, node):
+        analysis = self.multiword_analysis(node)
+        if analysis is None:
+            return
+        orig_attr = {}
+        for attr in 'form lemma upos xpos feats deprel misc'.split():
+            orig_attr[attr] = getattr(node, attr)
+
+        forms = analysis['form'].split()
+        main = analysis.get('main', 0)
+        parent = node if analysis.get('shape', '') == 'subtree' else node.parent
+        nodes = []
+        for form in forms[0:main]:
+            new_node = parent.create_child(form=form)
+            new_node.shift_before_node(node)
+            nodes.append(new_node)
+        node.form = forms[main]
+        nodes.append(node)
+        for form in forms[main+1:]:
+            new_node = parent.create_child(form=form)
+            new_node.shift_after_node(nodes[-1])
+            nodes.append(new_node)
+
+        if orig_attr['form'].isupper():
+            for new_node in nodes:
+                new_node.form = new_node.form.upper()
+        elif orig_attr['form'][0].isupper():
+            nodes[0].form = nodes[0].form.title()
+
+        for attr in 'lemma upos xpos feats deprel misc'.split():
+            if attr in analysis:
+                values = analysis[attr].split()
+                for i, new_node in enumerate(nodes):
+                    if values[i] == '*':
+                        setattr(new_node, attr, orig_attr[attr])
+                    else:
+                        setattr(new_node, attr, values[i])
+
+        mwt = node.root.create_multiword_token(nodes, orig_attr['form'], orig_attr['misc'])
+        node.misc = None
+        self.postprocess_mwt(mwt)
+
+    def multiword_analysis(self, node):
+        """Return a dict with MWT info or None if `node` does not represent a multiword token.
+
+        An example return value is::
+        {
+            'form': 'aby bych',
+            'lemma': 'aby být',
+            'upos': 'SCONJ AUX',
+            'xpos': 'J,------------- Vc-S---1-------',
+            'feats': '_ Mood=Cnd|Number=Sing|Person=1|VerbForm=Fin', # _ means empty FEATS
+            'deprel': '* aux', # * means keep the original deprel
+            'main': 0, # which of the two words will inherit the original children (if any)
+            'shape': 'siblings', # the newly created nodes will be siblings or alternatively
+            #'shape': 'subtree', # the main-indexed node will be the head
+        }
+        """
+        raise NotImplementedError('multiword_analysis must be overriden in subclasses')
+
+    def postprocess_mwt(self, mwt):
+        """Optional postprocessing of newly created MWTs."""
+        pass
diff --git a/udapi/block/ud/cs/__init__.py b/udapi/block/ud/cs/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
new file mode 100644
index 00000000..17e0648c
--- /dev/null
+++ b/udapi/block/ud/cs/addmwt.py
@@ -0,0 +1,74 @@
+"""Block ud.cs.AddMwt for heuristic detection of multi-word tokens."""
+import udapi.block.ud.addmwt
+
+MWTS = {
+    'abych': {'form': 'aby bych', 'feats': '_ Mood=Cnd|Number=Sing|Person=1|VerbForm=Fin'},
+    'kdybych': {'form': 'když bych', 'feats': '_ Mood=Cnd|Number=Sing|Person=1|VerbForm=Fin'},
+    'abys': {'form': 'aby bys', 'feats': '_ Mood=Cnd|Number=Sing|Person=2|VerbForm=Fin'},
+    'kdybys': {'form': 'když bys', 'feats': '_ Mood=Cnd|Number=Sing|Person=2|VerbForm=Fin'},
+    'aby': {'form': 'aby by', 'feats': '_ Mood=Cnd|Person=3|VerbForm=Fin'},
+    'kdyby': {'form': 'když by', 'feats': '_ Mood=Cnd|Person=3|VerbForm=Fin'},
+    'abychom': {'form': 'aby bychom', 'feats': '_ Mood=Cnd|Number=Plur|Person=1|VerbForm=Fin'},
+    'kdybychom': {'form': 'když bychom', 'feats': '_ Mood=Cnd|Number=Plur|Person=1|VerbForm=Fin'},
+    'abyste': {'form': 'aby byste', 'feats': '_ Mood=Cnd|Number=Plur|Person=2|VerbForm=Fin'},
+    'kdybyste': {'form': 'když byste', 'feats': '_ Mood=Cnd|Number=Plur|Person=2|VerbForm=Fin'},
+}
+for v in MWTS.values():
+    v['upos'] = 'SCONJ AUX'
+    number = '-'
+    if 'Sing' in v['feats']:
+        number = 'S'
+    elif 'Plur' in v['feats']:
+        number = 'P'
+    person = '-'
+    if 'Person=1' in v['feats']:
+        person = '1'
+    elif 'Person=2' in v['feats']:
+        person = '2'
+
+    v['xpos'] = 'J,------------- Vc-%s---%s-------' % (number, person)
+    v['deprel'] = '* aux'
+    v['lemma'] = v['form'].split()[0] + ' být'
+    v['main'] = 0
+    v['shape'] = 'siblings'
+
+# nač -> na + co
+for prep in 'na za o'.split():
+    MWTS[prep + 'č'] = {
+        'form': prep + ' co',
+        'lemma': prep + ' co',
+        'upos': 'ADP PRON',
+        'deprel': 'case *',
+        'main': 1,
+        'shape': 'subtree',
+    }
+
+class AddMwt(udapi.block.ud.addmwt.AddMwt):
+    """Detect and mark MWTs (split them into words and add the words to the tree)."""
+
+    def multiword_analysis(self, node):
+        """Return a dict with MWT info or None if `node` does not represent a multiword token."""
+        analysis = MWTS.get(node.form.lower(), None)
+        if analysis is not None:
+            return analysis
+
+        # There is no VerbType=verbconj in the UD_Czech data.
+        # The purpose of this rule is rather to show that
+        # it is possible to write such "dynamic" rules
+        # (which cannot be included in static MWTS).
+        if node.form.lower().endswith('ť') and node.feats['VerbType'] == 'verbconj':
+            return {
+                'form': node.form.lower()[:-1] + ' neboť',
+                'lemma': '* neboť',
+                'upos': '* CCONJ',
+                'xpos': 'Vt-S---3P-NA--2 J^-------------',
+                'feats': '* _',
+                'deprel': '* cc',
+                'main': 0,
+                'shape': 'subtree',
+            }
+        return None
+
+    def postprocess_mwt(self, mwt):
+        if mwt.words[0].deprel == 'fixed' and mwt.words[0].parent.parent.upos == 'VERB':
+            mwt.words[1].parent = mwt.words[0].parent.parent
diff --git a/udapi/block/ud/removemwt.py b/udapi/block/ud/removemwt.py
new file mode 100644
index 00000000..462e9fbd
--- /dev/null
+++ b/udapi/block/ud/removemwt.py
@@ -0,0 +1,37 @@
+"""Block ud.RemoveMwt for removing multi-word tokens."""
+from udapi.core.block import Block
+
+class RemoveMwt(Block):
+    """Substitute MWTs with one word representing the whole MWT."""
+
+    def process_tree(self, root):
+        for mwt in root.multiword_tokens:
+            words = mwt.words
+            words[0].form = mwt.form
+            words[0].misc = mwt.misc
+            words[0].upos = self.guess_upos(words)
+            words[0].feats = self.guess_feats(words)
+            words[0].deprel = self.guess_deprel(words)
+            mwt.remove()
+            for word in words[1:]:
+                word.remove(children='rehang')
+
+    @staticmethod
+    def guess_upos(words):
+        """UPOS of the whole MWT"""
+        return words[0].upos
+
+    @staticmethod
+    def guess_deprel(words):
+        """DEPREL of the whole MWT"""
+        return words[0].deprel
+        # Alternatively, we could define deprel subtypes
+        #return words[0].deprel + ':' + ','.join([w.deprel for w in words[1:]])
+
+    @staticmethod
+    def guess_feats(words):
+        """FEATS of the whole MWT"""
+        feats = words[0].feats
+        for word in words[1:]:
+            feats.update(word.feats)
+        return feats

From f0dff5a2d3f79c7ab6f71d7fa4c99b06012307e5 Mon Sep 17 00:00:00 2001
From: Prokopis Prokopidis <prokopis@ilsp.gr>
Date: Fri, 17 Mar 2017 14:31:17 +0200
Subject: [PATCH 0019/1374] add new block ud.el.AddMwt

---
 udapi/block/ud/el/__init__.py |  0
 udapi/block/ud/el/addmwt.py   | 48 +++++++++++++++++++++++++++++++++++
 2 files changed, 48 insertions(+)
 create mode 100644 udapi/block/ud/el/__init__.py
 create mode 100644 udapi/block/ud/el/addmwt.py

diff --git a/udapi/block/ud/el/__init__.py b/udapi/block/ud/el/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/ud/el/addmwt.py b/udapi/block/ud/el/addmwt.py
new file mode 100644
index 00000000..fd16a0f5
--- /dev/null
+++ b/udapi/block/ud/el/addmwt.py
@@ -0,0 +1,48 @@
+"""Block ud.el.AddMwt for heuristic detection of multi-word (σε+DET) tokens. Notice that this should be used only for converting existing conllu files. Ideally a tokenizer should have already split the MWTs. Also notice that this block does not deal with the relatively rare PRON(Person=2)+'*+PRON(Person=3, i.e. "σ'το" and "στο") MWTs."""
+import udapi.block.ud.addmwt
+
+MWTS = {
+    'στη': {'form'  : 'σ τη', 
+            'lemma' : 'σε ο', 
+            'upos'  : 'ADP DET',  
+            'xpos'  : 'AsPpSp AtDf',
+            'feats' : '_ Case=Acc|Gender=Fem|Number=Sing', 
+            'deprel': 'case det', 
+            'main'  : 0, # which of the two words will inherit the original children (if any)
+            'shape' : 'siblings', # the newly created nodes will be siblings},	
+            },
+    'στην':  {'form': 'σ την',  'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Fem|Number=Sing',  'deprel': 'case det', 'main': 0,  'shape': 'siblings'},   
+    'στις':  {'form': 'σ τις',  'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Fem|Number=Plur',  'deprel': 'case det', 'main': 0,  'shape': 'siblings'},   
+    'στα':   {'form': 'σ τα',   'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Neut|Number=Plur', 'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
+    'στους': {'form': 'σ τους', 'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Masc|Number=Plur', 'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
+    'στον':  {'form': 'σ τον',  'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Masc|Number=Sing', 'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
+}
+
+#for v in MWTS.values():
+#    pass
+
+class AddMwt(udapi.block.ud.addmwt.AddMwt):
+    """Detect and mark MWTs (split them into words and add the words to the tree)."""
+
+    def multiword_analysis(self, node):
+        """Return a dict with MWT info or None if `node` does not represent a multiword token."""
+        analysis = MWTS.get(node.form.lower(), None)
+        if analysis is not None:
+            return analysis
+
+        # Write a rule for ambigous prep+article MWTs
+        if node.form.lower() == 'στο' and node.feats['Gender'] == 'Masc':
+            return {
+                'form': 'σ το','lemma': 'σε ο','upos': 'ADP DET','xpos': 'AsPpSp AtDf','deprel': 'case det','main': 0,'shape': 'siblings',
+                'feats': '_ Case=Acc|Gender=Masc|Number=Sing',
+            }
+        elif node.form.lower() == 'στο':
+            return {
+                'form': 'σ το','lemma': 'σε ο','upos': 'ADP DET','xpos': 'AsPpSp AtDf','deprel': 'case det','main': 0,'shape': 'siblings',
+                'feats': '_ Case=Acc|Gender=Neut|Number=Sing',
+            }
+            
+        return None
+
+#    def postprocess_mwt(self, mwt):
+#        pass

From f060ccc335d4d7201f667b7477697f1e2a57bc00 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 17 Mar 2017 15:13:59 +0100
Subject: [PATCH 0020/1374] introduce node.feats.copy(), ud.AddMwt supports
 e.g. Case=* rule

---
 udapi/block/ud/addmwt.py | 9 ++++++++-
 udapi/core/dualdict.py   | 5 +++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/addmwt.py b/udapi/block/ud/addmwt.py
index 6d74d4a2..653cfa26 100644
--- a/udapi/block/ud/addmwt.py
+++ b/udapi/block/ud/addmwt.py
@@ -9,8 +9,10 @@ def process_node(self, node):
         if analysis is None:
             return
         orig_attr = {}
-        for attr in 'form lemma upos xpos feats deprel misc'.split():
+        for attr in 'form lemma upos xpos deprel'.split():
             orig_attr[attr] = getattr(node, attr)
+        orig_attr['feats'] = node.feats.copy()
+        orig_attr['misc'] = node.misc.copy()
 
         forms = analysis['form'].split()
         main = analysis.get('main', 0)
@@ -39,6 +41,11 @@ def process_node(self, node):
                 for i, new_node in enumerate(nodes):
                     if values[i] == '*':
                         setattr(new_node, attr, orig_attr[attr])
+                    elif attr == 'feats' and '*' in values[i]:
+                        new_node.feats = values[i]
+                        for feat_name, feat_value in list(new_node.feats.items()):
+                            if feat_value == '*':
+                                new_node.feats[feat_name] = orig_attr['feats'][feat_name]
                     else:
                         setattr(new_node, attr, values[i])
 
diff --git a/udapi/core/dualdict.py b/udapi/core/dualdict.py
index 2b98f45c..edad9c37 100644
--- a/udapi/core/dualdict.py
+++ b/udapi/core/dualdict.py
@@ -1,5 +1,6 @@
 """DualDict is a dict with lazily synchronized string representation."""
 import collections.abc
+import copy
 
 class DualDict(collections.abc.MutableMapping):
     """DualDict class serves as dict with lazily synchronized string representation.
@@ -93,6 +94,10 @@ def clear(self):
         self._string = '_'
         self._dict.clear()
 
+    def copy(self):
+        """Return a deep copy of this instance."""
+        return copy.deepcopy(self)
+
     def set_mapping(self, value):
         """Set the mapping from a dict or string.
 

From 5b814e651d820361599da28cb75d19e179c5b2b4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 17 Mar 2017 15:17:36 +0100
Subject: [PATCH 0021/1374] simpify ud.el.AddMwt by the newly introduced
 Gender=*

---
 udapi/block/ud/el/addmwt.py | 41 +++++++++----------------------------
 1 file changed, 10 insertions(+), 31 deletions(-)

diff --git a/udapi/block/ud/el/addmwt.py b/udapi/block/ud/el/addmwt.py
index fd16a0f5..d61f7616 100644
--- a/udapi/block/ud/el/addmwt.py
+++ b/udapi/block/ud/el/addmwt.py
@@ -2,47 +2,26 @@
 import udapi.block.ud.addmwt
 
 MWTS = {
-    'στη': {'form'  : 'σ τη', 
-            'lemma' : 'σε ο', 
-            'upos'  : 'ADP DET',  
+    'στη': {'form'  : 'σ τη',
+            'lemma' : 'σε ο',
+            'upos'  : 'ADP DET',
             'xpos'  : 'AsPpSp AtDf',
-            'feats' : '_ Case=Acc|Gender=Fem|Number=Sing', 
-            'deprel': 'case det', 
+            'feats' : '_ Case=Acc|Gender=Fem|Number=Sing',
+            'deprel': 'case det',
             'main'  : 0, # which of the two words will inherit the original children (if any)
-            'shape' : 'siblings', # the newly created nodes will be siblings},	
+            'shape' : 'siblings', # the newly created nodes will be siblings},
             },
-    'στην':  {'form': 'σ την',  'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Fem|Number=Sing',  'deprel': 'case det', 'main': 0,  'shape': 'siblings'},   
-    'στις':  {'form': 'σ τις',  'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Fem|Number=Plur',  'deprel': 'case det', 'main': 0,  'shape': 'siblings'},   
+    'στην':  {'form': 'σ την',  'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Fem|Number=Sing',  'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
+    'στις':  {'form': 'σ τις',  'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Fem|Number=Plur',  'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
     'στα':   {'form': 'σ τα',   'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Neut|Number=Plur', 'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
     'στους': {'form': 'σ τους', 'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Masc|Number=Plur', 'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
     'στον':  {'form': 'σ τον',  'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Masc|Number=Sing', 'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
+    'στο':   {'form': 'σ το',   'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=*|Number=Sing',    'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
 }
 
-#for v in MWTS.values():
-#    pass
-
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
     """Detect and mark MWTs (split them into words and add the words to the tree)."""
 
     def multiword_analysis(self, node):
         """Return a dict with MWT info or None if `node` does not represent a multiword token."""
-        analysis = MWTS.get(node.form.lower(), None)
-        if analysis is not None:
-            return analysis
-
-        # Write a rule for ambigous prep+article MWTs
-        if node.form.lower() == 'στο' and node.feats['Gender'] == 'Masc':
-            return {
-                'form': 'σ το','lemma': 'σε ο','upos': 'ADP DET','xpos': 'AsPpSp AtDf','deprel': 'case det','main': 0,'shape': 'siblings',
-                'feats': '_ Case=Acc|Gender=Masc|Number=Sing',
-            }
-        elif node.form.lower() == 'στο':
-            return {
-                'form': 'σ το','lemma': 'σε ο','upos': 'ADP DET','xpos': 'AsPpSp AtDf','deprel': 'case det','main': 0,'shape': 'siblings',
-                'feats': '_ Case=Acc|Gender=Neut|Number=Sing',
-            }
-            
-        return None
-
-#    def postprocess_mwt(self, mwt):
-#        pass
+        return MWTS.get(node.form.lower(), None)

From 843c1dfa02aa0f0be62f2e6aa52c84ba980b1967 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 17 Mar 2017 15:31:42 +0100
Subject: [PATCH 0022/1374] fix pylint warning (line length) and further
 simplify

---
 udapi/block/ud/el/addmwt.py | 40 ++++++++++++++++++++++---------------
 1 file changed, 24 insertions(+), 16 deletions(-)

diff --git a/udapi/block/ud/el/addmwt.py b/udapi/block/ud/el/addmwt.py
index d61f7616..39e23620 100644
--- a/udapi/block/ud/el/addmwt.py
+++ b/udapi/block/ud/el/addmwt.py
@@ -1,24 +1,32 @@
-"""Block ud.el.AddMwt for heuristic detection of multi-word (σε+DET) tokens. Notice that this should be used only for converting existing conllu files. Ideally a tokenizer should have already split the MWTs. Also notice that this block does not deal with the relatively rare PRON(Person=2)+'*+PRON(Person=3, i.e. "σ'το" and "στο") MWTs."""
+"""Block ud.el.AddMwt for heuristic detection of multi-word (σε+DET) tokens.
+
+Notice that this should be used only for converting existing conllu files.
+Ideally a tokenizer should have already split the MWTs.
+Also notice that this block does not deal with the relatively rare
+PRON(Person=2)+'*+PRON(Person=3, i.e. "σ'το" and "στο") MWTs.
+"""
 import udapi.block.ud.addmwt
 
 MWTS = {
-    'στη': {'form'  : 'σ τη',
-            'lemma' : 'σε ο',
-            'upos'  : 'ADP DET',
-            'xpos'  : 'AsPpSp AtDf',
-            'feats' : '_ Case=Acc|Gender=Fem|Number=Sing',
-            'deprel': 'case det',
-            'main'  : 0, # which of the two words will inherit the original children (if any)
-            'shape' : 'siblings', # the newly created nodes will be siblings},
-            },
-    'στην':  {'form': 'σ την',  'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Fem|Number=Sing',  'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
-    'στις':  {'form': 'σ τις',  'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Fem|Number=Plur',  'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
-    'στα':   {'form': 'σ τα',   'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Neut|Number=Plur', 'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
-    'στους': {'form': 'σ τους', 'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Masc|Number=Plur', 'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
-    'στον':  {'form': 'σ τον',  'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=Masc|Number=Sing', 'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
-    'στο':   {'form': 'σ το',   'lemma': 'σε ο',  'upos':'ADP DET', 'xpos':'AsPpSp AtDf', 'feats': '_ Case=Acc|Gender=*|Number=Sing',    'deprel': 'case det', 'main': 0,  'shape': 'siblings'},
+    'στη':   {'form': 'σ τη', 'feats':   '_ Case=Acc|Gender=Fem|Number=Sing'},
+    'στην':  {'form': 'σ την', 'feats':  '_ Case=Acc|Gender=Fem|Number=Sing'},
+    'στα':   {'form': 'σ τα', 'feats':   '_ Case=Acc|Gender=Neut|Number=Plur'},
+    'στους': {'form': 'σ τους', 'feats': '_ Case=Acc|Gender=Masc|Number=Plur'},
+    'στις':  {'form': 'σ τις', 'feats':  '_ Case=Acc|Gender=Fem|Number=Plur'},
+    'στον':  {'form': 'σ τον', 'feats':  '_ Case=Acc|Gender=Masc|Number=Sing'},
+    'στο':   {'form': 'σ το', 'feats':   '_ Case=Acc|Gender=*|Number=Sing'},
 }
 
+# shared values for all entries in MWTS
+for v in MWTS.values():
+    v['lemma'] = 'σε ο'
+    v['upos'] = 'ADP DET'
+    v['xpos'] = 'AsPpSp AtDf'
+    v['deprel'] = 'case det'
+    # The following are the default values
+    #v['main'] = 0 # which of the two words will inherit the original children (if any)
+    #v['shape'] = 'siblings', # the newly created nodes will be siblings
+
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
     """Detect and mark MWTs (split them into words and add the words to the tree)."""
 

From 292591e3745567f6c8692cd7ea6f85d2733a044e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 17 Mar 2017 22:14:52 +0100
Subject: [PATCH 0023/1374] =?UTF-8?q?de/projectivization=20=C3=A0=20la=20N?=
 =?UTF-8?q?ivre=20&=20Nilsson=20(2005)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/transform/__init__.py |  0
 udapi/block/transform/deproj.py   | 42 +++++++++++++++++++++
 udapi/block/transform/proj.py     | 62 +++++++++++++++++++++++++++++++
 3 files changed, 104 insertions(+)
 create mode 100644 udapi/block/transform/__init__.py
 create mode 100644 udapi/block/transform/deproj.py
 create mode 100644 udapi/block/transform/proj.py

diff --git a/udapi/block/transform/__init__.py b/udapi/block/transform/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/transform/deproj.py b/udapi/block/transform/deproj.py
new file mode 100644
index 00000000..3a6dcda5
--- /dev/null
+++ b/udapi/block/transform/deproj.py
@@ -0,0 +1,42 @@
+"""Block Deproj for deprojectivization of pseudo-projective trees à la Nivre & Nilsson (2005).
+
+See ud.transform.Proj for details.
+TODO: implement also path and head+path strategies.
+"""
+from udapi.core.block import Block
+
+class Deproj(Block):
+    """De-projectivize the trees à la Nivre & Nilsson (2005)."""
+
+    def __init__(self, strategy='head', label='misc', **kwargs):
+        """Create the Deproj block object."""
+        super().__init__(**kwargs)
+        self.strategy = strategy
+        self.label = label
+
+    def process_node(self, node):
+        if self.label == 'misc':
+            label = node.misc['pproj']
+        elif self.label == 'deprel':
+            parts = node.sdeprel.split('+', 1)
+            if len(parts) == 2:
+                label = parts[1]
+                node.deprel = node.udeprel + (':' + parts[0] if parts[0] else '')
+            else:
+                label = ''
+        else:
+            raise(ValueError('Unknown parameter label=%s' % self.label))
+        if label == '':
+            return
+        reconstructed_parent = self.head_strategy(node, label)
+        if reconstructed_parent:
+            node.parent = reconstructed_parent
+
+    def head_strategy(self, node, label):
+        queue = [n for n in node.parent.children if n!=node] # TODO deque
+        while queue:
+            adept = queue.pop(0)
+            if adept.udeprel == label:
+                return adept
+            queue.extend(adept.children)
+        return None
diff --git a/udapi/block/transform/proj.py b/udapi/block/transform/proj.py
new file mode 100644
index 00000000..f15e46e9
--- /dev/null
+++ b/udapi/block/transform/proj.py
@@ -0,0 +1,62 @@
+"""Block Proj for (pseudo-)projectivization of trees à la Nivre & Nilsson (2005).
+
+See http://www.aclweb.org/anthology/P/P05/P05-1013.pdf.
+This block tries to replicate Malt parser's projectivization:
+http://www.maltparser.org/userguide.html#singlemalt_proj
+http://www.maltparser.org/optiondesc.html#pproj-marking_strategy
+
+TODO: implement also path and head+path strategies.
+TODO: Sometimes it would be better (intuitively)
+      to lower the gap-node (if its whole subtree is in the gap
+      and if this does not cause more non-projectivities)
+      rather than to lift several nodes whose parent-edge crosses this gap.
+      We would need another label value (usually the lowering is of depth 1),
+      but the advantage is that reconstruction of lowered edges
+      during deprojectivization is simple and needs no heuristics.
+"""
+from udapi.core.block import Block
+
+class Proj(Block):
+    """Projectivize the trees à la Nivre & Nilsson (2005)."""
+
+    def __init__(self, strategy='head', lifting_order='deepest', label='misc', **kwargs):
+        """Create the Proj block object."""
+        super().__init__(**kwargs)
+        self.lifting_order = lifting_order
+        self.strategy = strategy
+        self.label = label
+
+    def process_tree(self, tree):
+        nonprojs = [self.nonproj_info(n) for n in tree.descendants if n.is_nonprojective()]
+        for nonproj in sorted(nonprojs, key=lambda info: info[0]):
+            self.lift(nonproj[1])
+
+    def nonproj_info(self, node):
+        if self.lifting_order == 'shortest':
+            return (abs(node.ord - node.parent.ord), node)
+        orig_parent = node.parent
+        node.parent = node.parent.parent
+        depth = 1
+        while node.is_nonprojective():
+            node.parent = node.parent.parent
+            depth += 1
+        node.parent = orig_parent
+        return (-depth, node)
+
+    def lift(self, node):
+        orig_parent = node.parent
+        depth = 0
+        while node.is_nonprojective():
+            node.parent = node.parent.parent
+            depth += 1
+        if depth == 0:
+            return
+        self.mark(node, orig_parent.udeprel)
+
+    def mark(self, node, label):
+        if self.label == 'misc':
+            node.misc['pproj'] = label
+        elif self.label == 'deprel':
+            node.deprel = '%s:%s+%s' % (node.udeprel, node.sdeprel, label)
+        else:
+            raise(ValueError('Unknown parameter label=%s' % self.label))

From 2e2617eec9310d67d750a763177b067224383c2a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 18 Mar 2017 15:14:42 +0100
Subject: [PATCH 0024/1374] add draft of blocks eval.Parsing and eval.LcsF1

---
 udapi/block/eval/__init__.py |   0
 udapi/block/eval/lcsf1.py    | 201 +++++++++++++++++++++++++++++++++++
 udapi/block/eval/parsing.py  |  35 ++++++
 3 files changed, 236 insertions(+)
 create mode 100644 udapi/block/eval/__init__.py
 create mode 100644 udapi/block/eval/lcsf1.py
 create mode 100644 udapi/block/eval/parsing.py

diff --git a/udapi/block/eval/__init__.py b/udapi/block/eval/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/eval/lcsf1.py b/udapi/block/eval/lcsf1.py
new file mode 100644
index 00000000..09d84e61
--- /dev/null
+++ b/udapi/block/eval/lcsf1.py
@@ -0,0 +1,201 @@
+"""Block eval.LcsF1 for evaluating differences between sentences with P/R/F1."""
+from udapi.core.basewriter import BaseWriter
+
+class LcsF1(BaseWriter):
+    """Evaluate differences between sentences (in different zones) with P/R/F1."""
+
+    def __init__(self, gold_zone, attributes='form', focus='.*', details=4, **kwargs):
+        """Create the LcsF1 block object."""
+        super().__init__(**kwargs)
+        self.gold_zone = gold_zone
+        self.attributes = attributes
+        self.focus = focus
+        self.details = details
+        self._stats = {}
+        self.correct, self.pred, self.gold = 0, 0, 0
+
+    def process_tree(self, tree):
+        gold_tree = tree.bundle.get_tree(self.gold_zone)
+        if tree == gold_tree:
+            return
+        #self._stats['zones'][tree.zone] += 1
+
+        attrs = self.attributes.split(',')
+        pred_tokens = ['_'.join(n.get_attrs(attrs)) for n in tree.descendants]
+        gold_tokens = ['_'.join(n.get_attrs(attrs)) for n in gold_tree.descendants]
+        common = find_lcs(pred_tokens, gold_tokens)
+
+        # my $focus = $self->focus;
+        # if ($focus ne '.*') {
+        #     @common      = grep {/$focus/} @common;
+        #     @pred_tokens = grep {/$focus/} @pred_tokens;
+        #     @gold_tokens = grep {/$focus/} @gold_tokens;
+        # }
+
+        self.correct += len(common)
+        self.pred += len(pred_tokens)
+        self.gold += len(gold_tokens)
+
+        # if ($self->details){
+        #     $self->_stats->{C}{$_}++ for (@common);
+        #     $self->_stats->{P}{$_}++ for (@pred_tokens);
+        #     $self->_stats->{G}{$_}++ for (@gold_tokens);
+        #     $self->_stats->{T}{$_}++ for (@gold_tokens, @pred_tokens);
+        # }
+
+    def process_end(self):
+        # Redirect the default filehandle to the file specified by self.files
+        self.before_process_document(None)
+
+        # my %pred_zones = %{$self->_stats->{zones}};
+        # my @pz = keys %pred_zones;
+        # if (!@pz) {
+        #     warn 'Block Eval::LcsF1 was not applied to any zone. Check the parameter zones='.$self->zones;
+        # } elsif (@pz > 1){
+        #     warn "Block Eval::LcsF1 was applied to more than one zone (@pz). "
+        #        . 'The results are mixed together. Check the parameter zones='.$self->zones;
+        # }
+        # say "Comparing predicted trees (zone=@pz) with gold trees (zone="
+        #     . $self->gold_zone . "), sentences=$pred_zones{$pz[0]}";
+        #
+        # if ($self->details){
+        #     say '=== Details ===';
+        #     my $total_count = $self->_stats->{T};
+        #     my @tokens = sort {$total_count->{$b} <=> $total_count->{$a}} keys %{$total_count};
+        #     splice @tokens, $self->details;
+        #     printf "%-10s %5s %5s %5s %6s  %6s  %6s\n", qw(token pred gold corr prec rec F1);
+        #     foreach my $token (@tokens){
+        #         my ($p, $g, $c) = map {$self->_stats->{$_}{$token}||0} (qw(P G C));
+        #         my $pr = $c / ($p || 1);
+        #         my $re = $c / ($g || 1);
+        #         my $f  = 2 * $pr * $re / (($pr + $re)||1);
+        #         printf "%-10s %5d %5d %5d %6.2f%% %6.2f%% %6.2f%%\n",
+        #             $token, $p, $g, $c, 100*$pr, 100*$re, 100*$f
+        #     }
+        #     say '=== Totals ==='
+        # }
+
+
+        print("%-9s = %7d\n"*3 % ('predicted', self.pred, 'gold', self.gold, 'correct', self.correct))
+        # ($pred, $gold) = map {$_||1} ($pred, $gold); # prevent division by zero
+        # my $prec = $correct / $pred;
+        # my $rec  = $correct / $gold;
+        # my $f1   = 2 * $prec * $rec / (($prec + $rec)||1);
+        # printf "%-9s = %6.2f%%\n"x3, precision=>100*$prec, recall=>100*$rec, F1=>100*$f1;
+
+
+# difflib.SequenceMatcher does not compute LCS, so let's implement it here
+# TODO: make faster by trimming common prefix and sufix
+def find_lcs(x, y):
+    m, n = len(x), len(y)
+    C = [[0] * (n + 1) for _ in range(m + 1)]
+    for i in range(1, m+1):
+        for j in range(1, n+1):
+            C[i][j] = C[i-1][j-1] + 1 if x[i-1] == y[j-1] else max(C[i][j-1], C[i-1][j])
+    index = C[m][n]
+    lcs = [None] * index
+    while m > 0 and n > 0:
+        if x[m-1] == y[n-1]:
+            lcs[index-1] = x[m-1]
+            m, n, index = m-1, n-1, index-1
+        elif C[m-1][n] > C[m][n-1]:
+            m -= 1
+        else:
+            n -= 1
+    return lcs
+
+
+'''
+Udapi::Block::Eval::LcsF1 - evaluate differences between sentences with P/R/F1
+
+=head1 SYNOPSIS
+
+ Eval::LcsF1 zones=en_pred gold_zone=en_gold to=results.txt
+
+ # prints something like
+ predicted =     210
+ gold      =     213
+ correct   =     210
+ precision = 100.00%
+ recall    =  98.59%
+ F1        =  99.29%
+
+ Eval::LcsF1 gold_zone=y attributes=form,upos focus='^(?i:an?|the)_DET$' details=4
+
+ # prints something like
+ === Details ===
+ token       pred  gold  corr   prec     rec      F1
+ the_DET      711   213   188  26.44%  88.26%  40.69%
+ The_DET       82    25    19  23.17%  76.00%  35.51%
+ a_DET          0    62     0   0.00%   0.00%   0.00%
+ an_DET         0    16     0   0.00%   0.00%   0.00%
+ === Totals ===
+ predicted =     793
+ gold      =     319
+ correct   =     207
+ precision =  26.10%
+ recall    =  64.89%
+ F1        =  37.23%
+
+=head1 DESCRIPTION
+
+This block finds differences between nodes of trees in two zones
+and reports the overall precision, recall and F1.
+The two zones are "predicted" (on which this block is applied)
+and "gold" (which needs to be specified with parameter C<gold>).
+
+This block also reports the number of total nodes in the predicted zone
+and in the gold zone and the number of "correct" nodes,
+that is predicted nodes which are also in the gold zone.
+By default two nodes are considered "the same" if they have the same C<form>,
+but it is possible to check also for other nodes' attributes
+(with parameter C<attributes>).
+
+As usual:
+
+ precision = correct / predicted
+ recall = correct / gold
+ F1 = 2 * precision * recall / (precision + recall)
+
+The implementation is based on finding the longest common subsequence (LCS)
+between the nodes in the two trees.
+This means that the two zones do not need to be explicitly word-aligned.
+
+=head1 PARAMETERS
+
+=head2 zones
+
+Which zone contains the "predicted" trees?
+Make sure that you specify just one zone.
+If you leave the default value "all" and the document contains more zones,
+the results will be mixed, which is most likely not what you wanted.
+Exception: If the document conaints just two zones (predicted and gold trees),
+you can keep the default value "all" because this block
+will skip comparison of the gold zone with itself.
+
+=head2 gold_zone
+
+Which zone contains the gold-standard trees?
+
+=head2 attributes
+
+comma separated list of attributes which should be checked
+when deciding whether two nodes are equivalent in LCS
+
+=head2 focus
+
+Regular expresion constraining the tokens we are interested in.
+If more attributes were specified in the C<attributes> parameter,
+their values are concatenated with underscore, so C<focus> should reflect that
+e.g. C<attributes=form,upos focus='^(a|the)_DET$'>.
+
+For case-insensitive focus use e.g. C<focus='^(?i)the$'>
+(which is equivalent to C<focus='^[Tt][Hh][Ee]$'>)
+
+=head2 details
+
+Print also detailed statistics for each token (matching the C<focus>).
+The value of this parameter C<details> specifies the number of tokens to include.
+The tokens are sorted according to the sum of their I<predicted> and I<gold> counts.
+
+'''
diff --git a/udapi/block/eval/parsing.py b/udapi/block/eval/parsing.py
new file mode 100644
index 00000000..3c7f5da8
--- /dev/null
+++ b/udapi/block/eval/parsing.py
@@ -0,0 +1,35 @@
+"""Block eval.Parsing for evaluating UAS and LAS - gold and pred must have the same tokens."""
+from udapi.core.basewriter import BaseWriter
+
+class Parsing(BaseWriter):
+    """Evaluate labeled and unlabeled attachment score (LAS and UAS)."""
+
+    def __init__(self, gold_zone, **kwargs):
+        """Create the eval.Parsing block object."""
+        super().__init__(**kwargs)
+        self.gold_zone = gold_zone
+        self.correct_las, self.correct_uas, self.total = 0, 0, 0
+
+    def process_tree(self, tree):
+        gold_tree = tree.bundle.get_tree(self.gold_zone)
+        if tree == gold_tree:
+            return
+        pred_nodes = tree.descendants
+        gold_nodes = gold_tree.descendants
+        if len(pred_nodes) != len(gold_nodes):
+            raise ValueError('The sentences do not match (%d vs. %d nodes)'
+                             % (len(pred_nodes), len(gold_nodes)))
+
+        self.total += len(pred_nodes)
+        for pred_node, gold_node in zip(pred_nodes, gold_nodes):
+            if pred_node.parent.ord == gold_node.parent.ord:
+                self.correct_uas += 1
+                if pred_node.deprel == gold_node.deprel:
+                    self.correct_las += 1
+
+    def process_end(self):
+        # Redirect the default filehandle to the file specified by self.files
+        self.before_process_document(None)
+        print('nodes = %d' % self.total)
+        print('UAS = %6.2f' % (100 * self.correct_uas / self.total))
+        print('LAS = %6.2f' % (100 * self.correct_las / self.total))

From 5477d3c739644df10de6fce34fee8d7f40081177 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 19 Mar 2017 16:41:58 +0100
Subject: [PATCH 0025/1374] simple tokenization: morpho.TokenizeOnWhitespace

---
 udapi/block/eval/lcsf1.py                  |  8 ++--
 udapi/block/morpho/__init__.py             |  0
 udapi/block/morpho/tokenizeonwhitespace.py | 46 ++++++++++++++++++++++
 3 files changed, 51 insertions(+), 3 deletions(-)
 create mode 100644 udapi/block/morpho/__init__.py
 create mode 100644 udapi/block/morpho/tokenizeonwhitespace.py

diff --git a/udapi/block/eval/lcsf1.py b/udapi/block/eval/lcsf1.py
index 09d84e61..2c085779 100644
--- a/udapi/block/eval/lcsf1.py
+++ b/udapi/block/eval/lcsf1.py
@@ -1,7 +1,7 @@
 """Block eval.LcsF1 for evaluating differences between sentences with P/R/F1."""
 from udapi.core.basewriter import BaseWriter
 
-class LcsF1(BaseWriter):
+class LcsF1(BaseWriter): # pylint: disable=too-many-instance-attributes
     """Evaluate differences between sentences (in different zones) with P/R/F1."""
 
     def __init__(self, gold_zone, attributes='form', focus='.*', details=4, **kwargs):
@@ -50,7 +50,8 @@ def process_end(self):
         # my %pred_zones = %{$self->_stats->{zones}};
         # my @pz = keys %pred_zones;
         # if (!@pz) {
-        #     warn 'Block Eval::LcsF1 was not applied to any zone. Check the parameter zones='.$self->zones;
+        #     warn 'Block Eval::LcsF1 was not applied to any zone. Check the parameter zones='
+        #          . $self->zones;
         # } elsif (@pz > 1){
         #     warn "Block Eval::LcsF1 was applied to more than one zone (@pz). "
         #        . 'The results are mixed together. Check the parameter zones='.$self->zones;
@@ -76,7 +77,8 @@ def process_end(self):
         # }
 
 
-        print("%-9s = %7d\n"*3 % ('predicted', self.pred, 'gold', self.gold, 'correct', self.correct))
+        print("%-9s = %7d\n"*3
+              % ('predicted', self.pred, 'gold', self.gold, 'correct', self.correct))
         # ($pred, $gold) = map {$_||1} ($pred, $gold); # prevent division by zero
         # my $prec = $correct / $pred;
         # my $rec  = $correct / $gold;
diff --git a/udapi/block/morpho/__init__.py b/udapi/block/morpho/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/morpho/tokenizeonwhitespace.py b/udapi/block/morpho/tokenizeonwhitespace.py
new file mode 100644
index 00000000..ef6f5d6f
--- /dev/null
+++ b/udapi/block/morpho/tokenizeonwhitespace.py
@@ -0,0 +1,46 @@
+"""Block morpho.TokenizeOnWhitespace"""
+from udapi.core.block import Block
+
+class TokenizeOnWhitespace(Block):
+    """"Base tokenizer, splits on whitespaces, fills SpaceAfter=No."""
+
+    @staticmethod
+    def tokenize_sentence(string):
+        """A method to be overriden in subclasses."""
+        return string
+
+    def process_tree(self, root):
+        if root.children:
+            raise ValueError('Tree %s is already tokenized.' % root)
+        sentence = ' '.join(root.text.split())
+        tokens = self.tokenize_sentence(sentence).split()
+        for i, token in enumerate(tokens, 1):
+            space_after = False
+
+            # Delete the token from the begining of the sentence.
+            if sentence.startswith(token):
+                sentence = sentence[len(token):]
+                # This is the expected case. The sentence starts with the token.
+                # If it is followed by a space, delete the space and set space_after=True.
+                if not len(sentence):
+                    space_after = True
+                elif sentence.startswith(' '):
+                    space_after = True
+                    sentence = sentence[1:]
+            else:
+                # The token (returned from tokenization) does not match the start of sentence.
+                # E.g. '. . . word' is tokenized as  '... word'.
+                # Let's delete the start of sentence anyway,
+                # using a non-greedy regex and the expected next token
+                # returned from the tokenization.
+                # my $next_token = $tokens[$i+1];
+                # my ($first, $rest) = ($sentence =~ /^(.*?)(\Q$next_token\E.*)$/);
+                # $no_space_after = 1 if (defined $first && $first !~ /\s$/);
+                # $sentence = $rest if (defined $rest);
+                raise ValueError('tokenization does not match: "%s" vs "%s"' % (token, sentence))
+
+            # create a new node
+            node = root.create_child(form=token)
+            node.ord = i
+            if not space_after:
+                node.misc = 'SpaceAfter=No'

From ca3e822d25656b4c59e17865ec934363df9a9d7e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 19 Mar 2017 16:43:19 +0100
Subject: [PATCH 0026/1374] draft of UDPipe integration

---
 udapi/block/udpipe/__init__.py |   0
 udapi/block/udpipe/base.py     | 180 +++++++++++++++++++++++++++++++++
 udapi/block/udpipe/en.py       |  10 ++
 udapi/tool/__init__.py         |   0
 udapi/tool/udpipe.py           |  40 ++++++++
 5 files changed, 230 insertions(+)
 create mode 100644 udapi/block/udpipe/__init__.py
 create mode 100644 udapi/block/udpipe/base.py
 create mode 100644 udapi/block/udpipe/en.py
 create mode 100644 udapi/tool/__init__.py
 create mode 100644 udapi/tool/udpipe.py

diff --git a/udapi/block/udpipe/__init__.py b/udapi/block/udpipe/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
new file mode 100644
index 00000000..914c160f
--- /dev/null
+++ b/udapi/block/udpipe/base.py
@@ -0,0 +1,180 @@
+"""Block udpipe.Base for tagging and parsing using UDPipe."""
+from udapi.core.block import Block
+from udapi.tool.udpipe import UDPipe
+
+KNOWN_MODELS = {
+    'grc': 'models/udpipe/2.0/ancient_greek-proiel-ud-2.0-conll17-170315.udpipe',
+    'grc_proiel': 'models/udpipe/2.0/ancient_greek-ud-2.0-conll17-170315.udpipe',
+    'ar': 'models/udpipe/2.0/arabic-ud-2.0-conll17-170315.udpipe',
+    'eu': 'models/udpipe/2.0/basque-ud-2.0-conll17-170315.udpipe',
+    'bg': 'models/udpipe/2.0/bulgarian-ud-2.0-conll17-170315.udpipe',
+    'ca': 'models/udpipe/2.0/catalan-ud-2.0-conll17-170315.udpipe',
+    'zh': 'models/udpipe/2.0/chinese-ud-2.0-conll17-170315.udpipe',
+    'hr': 'models/udpipe/2.0/croatian-ud-2.0-conll17-170315.udpipe',
+    'cs_cac': 'models/udpipe/2.0/czech-cac-ud-2.0-conll17-170315.udpipe',
+    'cs_cltt': 'models/udpipe/2.0/czech-cltt-ud-2.0-conll17-170315.udpipe',
+    'cs': 'models/udpipe/2.0/czech-ud-2.0-conll17-170315.udpipe',
+    'da': 'models/udpipe/2.0/danish-ud-2.0-conll17-170315.udpipe',
+    'nl_lassysmall': 'models/udpipe/2.0/dutch-lassysmall-ud-2.0-conll17-170315.udpipe',
+    'nl': 'models/udpipe/2.0/dutch-ud-2.0-conll17-170315.udpipe',
+    'en_lines': 'models/udpipe/2.0/english-lines-ud-2.0-conll17-170315.udpipe',
+    'en_partut': 'models/udpipe/2.0/english-partut-ud-2.0-conll17-170315.udpipe',
+    'en': 'models/udpipe/2.0/english-ud-2.0-conll17-170315.udpipe',
+    'et': 'models/udpipe/2.0/estonian-ud-2.0-conll17-170315.udpipe',
+    'fi_ftb': 'models/udpipe/2.0/finnish-ftb-ud-2.0-conll17-170315.udpipe',
+    'fi': 'models/udpipe/2.0/finnish-ud-2.0-conll17-170315.udpipe',
+    'fr_partut': 'models/udpipe/2.0/french-partut-ud-2.0-conll17-170315.udpipe',
+    'fr_sequoia': 'models/udpipe/2.0/french-sequoia-ud-2.0-conll17-170315.udpipe',
+    'fr': 'models/udpipe/2.0/french-ud-2.0-conll17-170315.udpipe',
+    'gl_treegal': 'models/udpipe/2.0/galician-treegal-ud-2.0-conll17-170315.udpipe',
+    'gl': 'models/udpipe/2.0/galician-ud-2.0-conll17-170315.udpipe',
+    'de': 'models/udpipe/2.0/german-ud-2.0-conll17-170315.udpipe',
+    'got': 'models/udpipe/2.0/gothic-ud-2.0-conll17-170315.udpipe',
+    'el': 'models/udpipe/2.0/greek-ud-2.0-conll17-170315.udpipe',
+    'he': 'models/udpipe/2.0/hebrew-ud-2.0-conll17-170315.udpipe',
+    'hi': 'models/udpipe/2.0/hindi-ud-2.0-conll17-170315.udpipe',
+    'hu': 'models/udpipe/2.0/hungarian-ud-2.0-conll17-170315.udpipe',
+    'id': 'models/udpipe/2.0/indonesian-ud-2.0-conll17-170315.udpipe',
+    'ga': 'models/udpipe/2.0/irish-ud-2.0-conll17-170315.udpipe',
+    'it_partut': 'models/udpipe/2.0/italian-partut-ud-2.0-conll17-170315.udpipe',
+    'it': 'models/udpipe/2.0/italian-ud-2.0-conll17-170315.udpipe',
+    'ja': 'models/udpipe/2.0/japanese-ud-2.0-conll17-170315.udpipe',
+    'kk': 'models/udpipe/2.0/kazakh-ud-2.0-conll17-170315.udpipe',
+    'ko': 'models/udpipe/2.0/korean-ud-2.0-conll17-170315.udpipe',
+    'la_ittb': 'models/udpipe/2.0/latin-ittb-ud-2.0-conll17-170315.udpipe',
+    'la_proiel': 'models/udpipe/2.0/latin-proiel-ud-2.0-conll17-170315.udpipe',
+    'la': 'models/udpipe/2.0/latin-ud-2.0-conll17-170315.udpipe',
+    'lv': 'models/udpipe/2.0/latvian-ud-2.0-conll17-170315.udpipe',
+    'no_bokmaal': 'models/udpipe/2.0/norwegian-bokmaal-ud-2.0-conll17-170315.udpipe',
+    'no_nynorsk': 'models/udpipe/2.0/norwegian-nynorsk-ud-2.0-conll17-170315.udpipe',
+    'cu': 'models/udpipe/2.0/old_church_slavonic-ud-2.0-conll17-170315.udpipe',
+    'fa': 'models/udpipe/2.0/persian-ud-2.0-conll17-170315.udpipe',
+    'pl': 'models/udpipe/2.0/polish-ud-2.0-conll17-170315.udpipe',
+    'pt_br': 'models/udpipe/2.0/portuguese-br-ud-2.0-conll17-170315.udpipe',
+    'pt': 'models/udpipe/2.0/portuguese-ud-2.0-conll17-170315.udpipe',
+    'ro': 'models/udpipe/2.0/romanian-ud-2.0-conll17-170315.udpipe',
+    'ru_syntagrus': 'models/udpipe/2.0/russian-syntagrus-ud-2.0-conll17-170315.udpipe',
+    'ru': 'models/udpipe/2.0/russian-ud-2.0-conll17-170315.udpipe',
+    'sk': 'models/udpipe/2.0/slovak-ud-2.0-conll17-170315.udpipe',
+    'sl_sst': 'models/udpipe/2.0/slovenian-sst-ud-2.0-conll17-170315.udpipe',
+    'sl': 'models/udpipe/2.0/slovenian-ud-2.0-conll17-170315.udpipe',
+    'es_ancora': 'models/udpipe/2.0/spanish-ancora-ud-2.0-conll17-170315.udpipe',
+    'es': 'models/udpipe/2.0/spanish-ud-2.0-conll17-170315.udpipe',
+    'sv_lines': 'models/udpipe/2.0/swedish-lines-ud-2.0-conll17-170315.udpipe',
+    'sv': 'models/udpipe/2.0/swedish-ud-2.0-conll17-170315.udpipe',
+    'tr': 'models/udpipe/2.0/turkish-ud-2.0-conll17-170315.udpipe',
+    'uk': 'models/udpipe/2.0/ukrainian-ud-2.0-conll17-170315.udpipe',
+    'ur': 'models/udpipe/2.0/urdu-ud-2.0-conll17-170315.udpipe',
+    'ug': 'models/udpipe/2.0/uyghur-ud-2.0-conll17-170315.udpipe',
+    'vi': 'models/udpipe/2.0/vietnamese-ud-2.0-conll17-170315.udpipe',
+}
+
+class Base(Block):
+    """Base class for all UDPipe blocks."""
+
+    # pylint: disable=too-many-arguments
+    def __init__(self, model=None, model_alias=None,
+                 tokenize=False, tag=True, parse=True, **kwargs):
+        """Create the udpipe.En block object."""
+        super().__init__(**kwargs)
+        self.model, self.model_alias = model, model_alias
+        self._tool = None
+        self.tokenize, self.tag, self.parse = tokenize, tag, parse
+
+    @property
+    def tool(self):
+        """Return the tool (UDPipe in this case), created lazily."""
+        if self._tool:
+            return self._tool
+        if not self.model:
+            if not self.model_alias:
+                raise ValueError('model (path/to/model) or model_alias (e.g. en) must be set!')
+            self.model = KNOWN_MODELS[self.model_alias]
+        self._tool = UDPipe(model=self.model)
+        return self._tool
+
+    def process_tree(self, root):
+        tok, tag, par = self.tokenize, self.tag, self.parse
+        if not tok and tag and par:
+            return self.tool.tag_parse_tree(root)
+        # TODO
+        # return $self->tool->tokenize_tag_parse_tree($root) if  $tok &&  $tag &&  $par;
+        # return $self->tool->tokenize_tag_tree($root)       if  $tok &&  $tag && !$par;
+        # return $self->tool->tokenize_tree($root)           if  $tok && !$tag && !$par;
+        # return $self->tool->tag_parse_tree($root)          if !$tok &&  $tag &&  $par;
+        # return $self->tool->tag_tree($root)                if !$tok &&  $tag && !$par;
+        # return $self->tool->parse_tree($root)              if !$tok && !$tag &&  $par;
+        raise ValueError("Unimplemented tokenize=%s tag=%s parse=%s" % (tok, tag, par))
+
+'''
+Udapi::Block::UDPipe::Base - tokenize, tag and parse into UD
+
+=head1 SYNOPSIS
+
+ # from the command line
+ echo John loves Mary | udapi.pl Read::Sentences UDPipe::Base model_alias=en Write::TextModeTrees
+
+ # in scenario
+ UDPipe::Base model=/home/me/english-ud-1.2-160523.udpipe
+ UDPipe::Base model_alias=en
+ UDPipe::EN # shortcut for the above
+ UDPipe::EN tokenize=1 tag=1 parse=0
+
+=head1 DESCRIPTION
+
+This block loads L<Udapi::Tool::UDPipe> (a wrapper for the UDPipe C++ tool) with
+the given C<model> for analysis into the Universal Dependencies (UD) style.
+UDPipe can do tokenization, tagging (plus lemmatization and universal features)
+and parsing (with deprel labels) and users of this block can select which of the
+substasks should be done using parameters C<tokenize>, C<tag> and C<parse>.
+The default is to do all three.
+
+=head1 TODO
+
+UDPipe can do also sentence segmentation, but L<Udapi::Tool::UDPipe> does not supported it yet.
+
+Similarly with multi-word tokens.
+
+=head1 PARAMETERS
+
+=head2 C<model>
+
+Path to the model file within Udapi share
+(or relative path starting with "./" or absolute path starting with "/").
+This parameter is required if C<model_alias> is not supplied.
+
+=head2 C<model_alias>
+
+The C<model> parameter can be omitted if this parameter is supplied.
+Currently available model aliases are:
+
+B<grc_proiel, grc, ar, eu, bg, hr, cs, da, nl, en, et, fi, fi_ftb, fr, got, de,
+el, he, hi, hu, id, ga, it, la_itt, la_proiel, la, no, cu, fa, po, ro, pt, sl,
+es, ta, sv>.
+
+They correspond to paths where the language code in the alias is substituted
+with the respective language name, e.g. B<grc_proiel> expands to
+C<models/udpipe/ancient-greek-ud-1.2-160523.udpipe>.
+
+=head1 tokenize
+
+Do tokenization, i.e. create new nodes with attributes
+C<form>, C<misc> (if SpaceAfter=No) and C<ord>.
+The sentence string is taken from the root's attribute C<text>.
+
+=head1 tag
+
+Fill node attributes: C<lemma>, C<upos>, C<xpos> and C<feats>.
+On the input, just the attribute C<form> is expected.
+
+=head1 parse
+
+Fill node attributes: C<deprel> and rehang the nodes to their parent.
+On the input, attributes C<lemma>, C<upos>, C<xpos> and C<feats> are expected.
+
+=head1 SEE ALSO
+
+L<http://ufal.mff.cuni.cz/udpipe>
+
+L<Udapi::Tool::UDPipe>
+'''
diff --git a/udapi/block/udpipe/en.py b/udapi/block/udpipe/en.py
new file mode 100644
index 00000000..7cb74a25
--- /dev/null
+++ b/udapi/block/udpipe/en.py
@@ -0,0 +1,10 @@
+"""Block udpipe.En for tagging and parsing English."""
+from udapi.block.udpipe.base import Base
+
+
+class En(Base):
+    """Tag and parse English."""
+
+    def __init__(self, **kwargs):
+        """Create the udpipe.En block object."""
+        super().__init__(model_alias='en', **kwargs)
diff --git a/udapi/tool/__init__.py b/udapi/tool/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/tool/udpipe.py b/udapi/tool/udpipe.py
new file mode 100644
index 00000000..dbfb1e74
--- /dev/null
+++ b/udapi/tool/udpipe.py
@@ -0,0 +1,40 @@
+'''Wrapper for UDPipe (more pythonic than ufal.udpipe).'''
+import io
+import os
+
+from ufal.udpipe import Model, Pipeline, ProcessingError # pylint: disable=no-name-in-module
+from udapi.block.read.conllu import Conllu as ConlluReader
+
+class UDPipe:
+    '''Wrapper for UDPipe (more pythonic than ufal.udpipe).'''
+
+    def __init__(self, model):
+        """Create the UDPipe tool object."""
+        self.model = model
+        path = self.model_path()
+        self.tool = Model.load(path)
+        if not self.tool:
+            raise IOError("Cannot load model from file '%s'" % path)
+        self.error = ProcessingError()
+        self.conllu_reader = ConlluReader()
+
+    def model_path(self):
+        """Return absolute path to the model file to be loaded."""
+        if self.model.startswith('/') or self.model.startswith('.'):
+            return self.model
+        elif os.environ.get('UDAPI_DATA'):
+            return os.environ['UDAPI_DATA'] + '/' + self.model
+        else:
+            return os.environ.get('HOME') + '/' + self.model
+
+    def tag_parse_tree(self, root):
+        """Tag (+lemmatize, fill FEATS) and parse a tree (already tokenized)."""
+        pipeline = Pipeline(self.tool, 'horizontal', Pipeline.DEFAULT, Pipeline.DEFAULT, 'conllu')
+        in_data = " ".join([n.form for n in root.descendants])
+        out_data = pipeline.process(in_data, self.error)
+        if self.error.occurred():
+            raise IOError("UDPipe error " + self.error.message)
+        self.conllu_reader.files.filehandle = io.StringIO(out_data)
+        parsed = self.conllu_reader.read_tree()
+        # pylint: disable=protected-access
+        root._children, root._descendants = parsed._children, parsed._descendants

From 6eb2a6e236756c1cb621f7d4a43c5b28e9c9aa4a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 19 Mar 2017 21:40:55 +0100
Subject: [PATCH 0027/1374] alternative loading of the UDPipe-parsed trees
 which preserves MISC

---
 udapi/tool/udpipe.py | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/udapi/tool/udpipe.py b/udapi/tool/udpipe.py
index dbfb1e74..c4487e23 100644
--- a/udapi/tool/udpipe.py
+++ b/udapi/tool/udpipe.py
@@ -35,6 +35,16 @@ def tag_parse_tree(self, root):
         if self.error.occurred():
             raise IOError("UDPipe error " + self.error.message)
         self.conllu_reader.files.filehandle = io.StringIO(out_data)
-        parsed = self.conllu_reader.read_tree()
-        # pylint: disable=protected-access
-        root._children, root._descendants = parsed._children, parsed._descendants
+        parsed_root = self.conllu_reader.read_tree()
+        nodes = [root] + root.descendants
+        for parsed_node in parsed_root.descendants:
+            node = nodes[parsed_node.ord]
+            node.parent = nodes[parsed_node.parent.ord]
+            for attr in 'upos xpos lemma feats'.split():
+                setattr(node, attr, getattr(parsed_node, attr))
+
+        # TODO: benchmark which solution is the fastest one. E.g. we could also do
+        #for node, parsed_node in zip(root.descendants, parsed_root.descendants):
+        #    parsed_node.misc = node.misc
+        ## pylint: disable=protected-access
+        #root._children, root._descendants = parsed_root._children, parsed_root._descendants

From e2c17e69ad5db4dffb7674bb2b182dad9cf9d201 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 19 Mar 2017 21:42:34 +0100
Subject: [PATCH 0028/1374] add tokenize.Simple

Also
* rename morpho.TokenizeOnWhitespace tokenize.OnWhitespace
* let the `tokenize_sentence` method return directly the list of tokens
---
 udapi/block/{morpho => tokenize}/__init__.py         |  0
 .../onwhitespace.py}                                 |  8 ++++----
 udapi/block/tokenize/simple.py                       | 12 ++++++++++++
 3 files changed, 16 insertions(+), 4 deletions(-)
 rename udapi/block/{morpho => tokenize}/__init__.py (100%)
 rename udapi/block/{morpho/tokenizeonwhitespace.py => tokenize/onwhitespace.py} (92%)
 create mode 100644 udapi/block/tokenize/simple.py

diff --git a/udapi/block/morpho/__init__.py b/udapi/block/tokenize/__init__.py
similarity index 100%
rename from udapi/block/morpho/__init__.py
rename to udapi/block/tokenize/__init__.py
diff --git a/udapi/block/morpho/tokenizeonwhitespace.py b/udapi/block/tokenize/onwhitespace.py
similarity index 92%
rename from udapi/block/morpho/tokenizeonwhitespace.py
rename to udapi/block/tokenize/onwhitespace.py
index ef6f5d6f..544c4da6 100644
--- a/udapi/block/morpho/tokenizeonwhitespace.py
+++ b/udapi/block/tokenize/onwhitespace.py
@@ -1,19 +1,19 @@
-"""Block morpho.TokenizeOnWhitespace"""
+"""Block tokenize.OnWhitespace"""
 from udapi.core.block import Block
 
-class TokenizeOnWhitespace(Block):
+class OnWhitespace(Block):
     """"Base tokenizer, splits on whitespaces, fills SpaceAfter=No."""
 
     @staticmethod
     def tokenize_sentence(string):
         """A method to be overriden in subclasses."""
-        return string
+        return string.split()
 
     def process_tree(self, root):
         if root.children:
             raise ValueError('Tree %s is already tokenized.' % root)
         sentence = ' '.join(root.text.split())
-        tokens = self.tokenize_sentence(sentence).split()
+        tokens = self.tokenize_sentence(sentence)
         for i, token in enumerate(tokens, 1):
             space_after = False
 
diff --git a/udapi/block/tokenize/simple.py b/udapi/block/tokenize/simple.py
new file mode 100644
index 00000000..82403cee
--- /dev/null
+++ b/udapi/block/tokenize/simple.py
@@ -0,0 +1,12 @@
+"""Block tokenize.Simple"""
+import re
+
+from udapi.block.tokenize.onwhitespace import OnWhitespace
+
+class Simple(OnWhitespace):
+    """Simple tokenizer, splits on whitespaces and punctuation, fills SpaceAfter=No."""
+
+    @staticmethod
+    def tokenize_sentence(string):
+        """A method to be overriden in subclasses."""
+        return re.findall(r'\w+|[^\w\s]', string)

From c46092f25d5014eae744a9c9ec3835d44310b9d0 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 19 Mar 2017 21:46:47 +0100
Subject: [PATCH 0029/1374] revert back to the old UDPipe models (UDv1.2)

We can switch the the new UDv2.0 models once UDPipe 1.1
is relased on PyPI
---
 udapi/block/udpipe/base.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
index 914c160f..eea4b64d 100644
--- a/udapi/block/udpipe/base.py
+++ b/udapi/block/udpipe/base.py
@@ -3,6 +3,11 @@
 from udapi.tool.udpipe import UDPipe
 
 KNOWN_MODELS = {
+    'en': 'models/udpipe/english-ud-1.2-160523.udpipe',
+}
+
+# TODO use the new models once UDPipe 1.1 is published and available on PyPI as ufal.udpipe
+V2_KNOWN_MODELS = {
     'grc': 'models/udpipe/2.0/ancient_greek-proiel-ud-2.0-conll17-170315.udpipe',
     'grc_proiel': 'models/udpipe/2.0/ancient_greek-ud-2.0-conll17-170315.udpipe',
     'ar': 'models/udpipe/2.0/arabic-ud-2.0-conll17-170315.udpipe',

From a142807b160b59920d28fd4d0f82d9884de71823 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 19 Mar 2017 22:59:19 +0100
Subject: [PATCH 0030/1374] UDPipe tokenizer (without segmenter)

---
 udapi/block/udpipe/base.py |  4 +++-
 udapi/tool/udpipe.py       | 43 +++++++++++++++++++++++++++++++++++++-
 2 files changed, 45 insertions(+), 2 deletions(-)

diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
index eea4b64d..d72cbf16 100644
--- a/udapi/block/udpipe/base.py
+++ b/udapi/block/udpipe/base.py
@@ -79,7 +79,7 @@ class Base(Block):
 
     # pylint: disable=too-many-arguments
     def __init__(self, model=None, model_alias=None,
-                 tokenize=False, tag=True, parse=True, **kwargs):
+                 tokenize=True, tag=True, parse=True, **kwargs):
         """Create the udpipe.En block object."""
         super().__init__(**kwargs)
         self.model, self.model_alias = model, model_alias
@@ -100,6 +100,8 @@ def tool(self):
 
     def process_tree(self, root):
         tok, tag, par = self.tokenize, self.tag, self.parse
+        if tok and tag and par:
+            return self.tool.tokenize_tag_parse_tree(root)
         if not tok and tag and par:
             return self.tool.tag_parse_tree(root)
         # TODO
diff --git a/udapi/tool/udpipe.py b/udapi/tool/udpipe.py
index c4487e23..2fdbc337 100644
--- a/udapi/tool/udpipe.py
+++ b/udapi/tool/udpipe.py
@@ -2,7 +2,7 @@
 import io
 import os
 
-from ufal.udpipe import Model, Pipeline, ProcessingError # pylint: disable=no-name-in-module
+from ufal.udpipe import Model, Pipeline, ProcessingError, Sentence # pylint: disable=no-name-in-module
 from udapi.block.read.conllu import Conllu as ConlluReader
 
 class UDPipe:
@@ -17,6 +17,7 @@ def __init__(self, model):
             raise IOError("Cannot load model from file '%s'" % path)
         self.error = ProcessingError()
         self.conllu_reader = ConlluReader()
+        self.tokenizer = self.tool.newTokenizer(Model.DEFAULT)
 
     def model_path(self):
         """Return absolute path to the model file to be loaded."""
@@ -48,3 +49,43 @@ def tag_parse_tree(self, root):
         #    parsed_node.misc = node.misc
         ## pylint: disable=protected-access
         #root._children, root._descendants = parsed_root._children, parsed_root._descendants
+
+    def tokenize_tag_parse_tree(self, root):
+        """Tokenize, tag (+lemmatize, fill FEATS) and parse the text stored in `root.text`."""
+        if root.children:
+            raise ValueError('Tree already contained nodes before tokenization')
+
+        # tokenization (I cannot turn off segmenter, so I need to join the segments)
+        self.tokenizer.setText(root.text)
+        u_sentence = Sentence()
+        is_another = self.tokenizer.nextSentence(u_sentence)
+        u_words    = u_sentence.words
+        n_words    = u_words.size() - 1
+        if is_another:
+            u_sent_cont = Sentence()
+            while self.tokenizer.nextSentence(u_sent_cont):
+                n_cont = u_sent_cont.words.size() - 1
+                for i in range(1, n_cont+1):
+                    u_w = u_sent_cont.words[i]
+                    n_words += 1
+                    u_w.id = n_words
+                    u_words.append(u_w)
+
+        # tagging and parsing
+        self.tool.tag(u_sentence, Model.DEFAULT)
+        self.tool.parse(u_sentence, Model.DEFAULT)
+
+        # converting UDPipe nodes to Udapi nodes
+        heads, nodes = [], [root]
+        for i in range(1, u_words.size()):
+            u_w = u_words[i]
+            node = root.create_child(
+                form=u_w.form, lemma=u_w.lemma, upos=u_w.upostag,
+                xpos=u_w.xpostag, feats=u_w.feats, deprel=u_w.deprel,
+            )
+            node.misc = u_w.misc
+            heads.append(u_w.head)
+            nodes.append(node)
+        for node in nodes[1:]:
+            head = heads.pop(0)
+            node.parent = nodes[head]

From 22a1acdcdb1b9b1d31ab6b8bc4f612e7c290343f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 23 Mar 2017 11:29:16 +0100
Subject: [PATCH 0031/1374] add util.Mark for marking nodes

`util.Mark node='XY'` is a shortcut for
`util.Eval node='if XY: node.misc["Mark"] = self.mark'`
and in combination with `udapy -TM` it is also a shortcut for
`util.Filter keep_tree_if_node='XY'`
But I think it is useful enough to become a separate block.
---
 udapi/block/util/filter.py |  2 +-
 udapi/block/util/mark.py   | 30 ++++++++++++++++++++++++++++++
 2 files changed, 31 insertions(+), 1 deletion(-)
 create mode 100644 udapi/block/util/mark.py

diff --git a/udapi/block/util/filter.py b/udapi/block/util/filter.py
index 88bedb76..b812fb64 100644
--- a/udapi/block/util/filter.py
+++ b/udapi/block/util/filter.py
@@ -15,7 +15,7 @@ class Filter(Block):
     # keep only trees which contain ToDo|Bug nodes
     udapy -s util.Filter keep_tree_if_node='re.match("ToDo|Bug", str(node.misc))' < in > filtered
 
-    # keep only non-projective trees, annotate non-projective edges with Mark=nofeats and show.
+    # keep only non-projective trees, annotate non-projective edges with Mark=nonproj and show.
     udapy -T util.Filter keep_tree_if_node='node.is_nonprojective()' mark=nonproj < in | less -R
 
     # delete trees which contain deprel=remnant
diff --git a/udapi/block/util/mark.py b/udapi/block/util/mark.py
new file mode 100644
index 00000000..42052336
--- /dev/null
+++ b/udapi/block/util/mark.py
@@ -0,0 +1,30 @@
+"""util.Mark is a special block for marking nodes specified by parameters."""
+import re # may be useful in eval, thus pylint: disable=unused-import
+
+from udapi.core.block import Block
+
+# We need eval in this block
+# pylint: disable=eval-used
+class Mark(Block):
+    """Mark nodes specified by parameters.
+
+    Example usage from command line::
+    # see non-projective trees with non-projective edges highlighted
+    udapy -TM util.Mark node='node.is_nonprojective()' < in | less -R
+    """
+    def __init__(self, node, mark=1, **kwargs):
+        """Create the Mark block object.
+
+        Args:
+        `node`: Python expression to be evaluated for each node and if True,
+            the node will be marked.
+
+        `mark`: the node will be marked with `Mark=<mark>` in `node.misc`. Default=1.
+        """
+        super().__init__(**kwargs)
+        self.mark = mark
+        self.node = node
+
+    def process_node(self, node):
+        if eval(self.node):
+            node.misc['Mark'] = self.mark

From 60a5c645a52bd6f2262faa144d42584fee4a84c4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 23 Mar 2017 11:36:27 +0100
Subject: [PATCH 0032/1374] template for tutorial.Adpositions

---
 udapi/block/tutorial/__init__.py    |  0
 udapi/block/tutorial/adpositions.py | 33 +++++++++++++++++++++++++++++
 2 files changed, 33 insertions(+)
 create mode 100644 udapi/block/tutorial/__init__.py
 create mode 100644 udapi/block/tutorial/adpositions.py

diff --git a/udapi/block/tutorial/__init__.py b/udapi/block/tutorial/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/tutorial/adpositions.py b/udapi/block/tutorial/adpositions.py
new file mode 100644
index 00000000..cc8bafba
--- /dev/null
+++ b/udapi/block/tutorial/adpositions.py
@@ -0,0 +1,33 @@
+"""tutorial.Adpositions block template.
+
+Example usage:
+for a in */sample.conllu; do
+    printf '%50s ' $a;
+    udapy tutorial.Adpositions < $a;
+done | tee results.txt
+
+# What are the English postpositions?
+cat UD_English/sample.conllu | udapy -TM util.Mark \
+ node='node.upos == "ADP" and node.parent.precedes(node)' | less -R
+"""
+from udapi.core.block import Block
+
+class Adpositions(Block):
+    """Compute the number of prepositions and postpositions."""
+
+    def __init__(self, **kwargs):
+        """Create the Adpositions block object."""
+        super().__init__(**kwargs)
+        self.prepositions = 0
+        self.postpositions = 0
+
+    def process_node(self, node):
+        # TODO: Your task: distinguish prepositions and postpositions
+        if node.upos == "ADP":
+            self.prepositions += 1
+
+    def process_end(self):
+        total = self.prepositions + self.postpositions or 1
+        prep = 100 * self.prepositions / total
+        post = 100 * self.postpositions / total
+        print("prepositions %5.1f%%, postpositions %5.1f%%" % (prep, post))

From 17d6a83cd5cee6c47bffa2e1a2fda73c7e98438e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 25 Mar 2017 02:47:53 +0100
Subject: [PATCH 0033/1374] add punct-nonproj test to ud.MarkBugs

---
 udapi/block/ud/markbugs.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index 44cfb5cc..f785f556 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -163,6 +163,9 @@ def process_node(self, node):
             self.log(node, 'punct-deprel', 'upos=PUNCT deprel!=punct|fixed|goeswith|root (but %s)'
                      % deprel)
 
+        if upos == 'PUNCT' and node.is_nonprojective():
+            self.log(node, 'punct-nonproj', 'upos=PUNCT and edge is non-projective')
+
         # http://universaldependencies.org/u/dep/cc.html says
         #   "cc is the relation between a conjunct and a preceding
         #   [coordinating conjunction](http://universaldependencies.org/u/pos/CCONJ)."

From 70d6d86b3c611e05b4b7ea8d87529ea028a0d0db Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 27 Mar 2017 17:59:14 +0200
Subject: [PATCH 0034/1374] generate documentation with Sphinx

---
 README.md        |   1 +
 docs/.gitignore  |   4 ++
 docs/Makefile    |  20 ++++++
 docs/api.rst     |  17 +++++
 docs/conf.py     | 176 +++++++++++++++++++++++++++++++++++++++++++++++
 docs/index.rst   |  24 +++++++
 docs/install.rst |  21 ++++++
 7 files changed, 263 insertions(+)
 create mode 100644 docs/.gitignore
 create mode 100644 docs/Makefile
 create mode 100644 docs/api.rst
 create mode 100644 docs/conf.py
 create mode 100644 docs/index.rst
 create mode 100644 docs/install.rst

diff --git a/README.md b/README.md
index 721d1354..d0666b70 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,7 @@
 Python framework for processing Universal Dependencies data
 
 [![Build Status](https://travis-ci.org/udapi/udapi-python.svg?branch=master)](https://travis-ci.org/udapi/udapi-python)
+[![Website](https://img.shields.io/website-up-down-green-red/http/udapi.github.io.svg)](http://udapi.github.io)
 
 ## Requirements
 - You need Python 3.3 or higher.
diff --git a/docs/.gitignore b/docs/.gitignore
new file mode 100644
index 00000000..a1d82581
--- /dev/null
+++ b/docs/.gitignore
@@ -0,0 +1,4 @@
+_build
+udapi.rst
+udapi.*.rst
+modules.rst
diff --git a/docs/Makefile b/docs/Makefile
new file mode 100644
index 00000000..17d5375a
--- /dev/null
+++ b/docs/Makefile
@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SPHINXPROJ    = Udapi
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
\ No newline at end of file
diff --git a/docs/api.rst b/docs/api.rst
new file mode 100644
index 00000000..0857cc98
--- /dev/null
+++ b/docs/api.rst
@@ -0,0 +1,17 @@
+.. _api:
+
+=================
+API Documentation
+=================
+
+``udapi`` package
+========================
+
+.. automodule:: udapi
+   :members:
+
+------------------------
+
+**Sub-modules**
+
+.. toctree:: modules
diff --git a/docs/conf.py b/docs/conf.py
new file mode 100644
index 00000000..3e7864a5
--- /dev/null
+++ b/docs/conf.py
@@ -0,0 +1,176 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+#
+# Udapi documentation build configuration file, created by
+# sphinx-quickstart on Mon Mar 27 17:08:03 2017.
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+import os
+import sys
+sys.path.insert(0, os.path.abspath('..'))
+
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#
+# needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.todo',
+    'sphinx.ext.coverage',
+    'sphinx.ext.ifconfig',
+    'sphinx.ext.viewcode']
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+#
+# source_suffix = ['.rst', '.md']
+source_suffix = '.rst'
+
+# The master toctree document.
+master_doc = 'index'
+
+# General information about the project.
+project = 'Udapi'
+copyright = '2017, Martin Popel'
+author = 'Martin Popel'
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The short X.Y version.
+version = '0'
+# The full version, including alpha/beta/rc tags.
+release = '1'
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This patterns also effect to html_static_path and html_extra_path
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+# html_theme = 'alabaster'
+import sphinx_rtd_theme
+html_theme = 'sphinx_rtd_theme'
+html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+#
+# html_theme_options = {}
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+
+# -- Options for HTMLHelp output ------------------------------------------
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'Udapidoc'
+
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #
+    # 'papersize': 'letterpaper',
+
+    # The font size ('10pt', '11pt' or '12pt').
+    #
+    # 'pointsize': '10pt',
+
+    # Additional stuff for the LaTeX preamble.
+    #
+    # 'preamble': '',
+
+    # Latex figure (float) alignment
+    #
+    # 'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (master_doc, 'Udapi.tex', 'Udapi Documentation',
+     'Martin Popel', 'manual'),
+]
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, 'udapi', 'Udapi Documentation',
+     [author], 1)
+]
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (master_doc, 'Udapi', 'Udapi Documentation',
+     author, 'Udapi', 'API and framework for processing Universal Dependencies',
+     'Miscellaneous'),
+]
+
+
+def run_apidoc(_):
+
+    cur_dir = os.path.abspath(os.path.dirname(__file__))
+    print(cur_dir)
+    module = os.path.abspath(os.path.join(cur_dir, "..", "udapi"))
+    print(module)
+
+    from sphinx.apidoc import main
+    main(['--separate', '-o', cur_dir, module, '--force'])
+
+def setup(app):
+    app.connect('builder-inited', run_apidoc)
+
diff --git a/docs/index.rst b/docs/index.rst
new file mode 100644
index 00000000..78a2d540
--- /dev/null
+++ b/docs/index.rst
@@ -0,0 +1,24 @@
+.. Udapi documentation master file, created by
+   sphinx-quickstart on Mon Mar 27 17:08:03 2017.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Welcome to Udapi's documentation!
+=================================
+
+Udapi is a framework providing an API for processing
+`Universal Dependencies <http://universaldependencies.org>`_ data.
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents:
+
+   install
+   api
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
diff --git a/docs/install.rst b/docs/install.rst
new file mode 100644
index 00000000..14f81527
--- /dev/null
+++ b/docs/install.rst
@@ -0,0 +1,21 @@
+.. _instalation:
+
+============
+Installation
+============
+
+You need Python 3.3 or higher, pip3 and git.
+
+
+Let's clone the git repo to ``~/udapi-python/``, install dependencies
+and setup ``$PATH`` and ``$PYTHONPATH`` accordingly:
+
+.. code-block:: bash
+
+  cd
+  git clone https://github.com/udapi/udapi-python.git
+  pip3 install --user -r udapi-python/requirements.txt
+  echo '## Use Udapi from ~/udapi-python/ ##'                >> ~/.bashrc
+  echo 'export PATH="$HOME/udapi-python/bin:$PATH"'          >> ~/.bashrc
+  echo 'export PYTHONPATH="$HOME/udapi-python/:$PYTHONPATH"' >> ~/.bashrc
+  source ~/.bashrc # or open new bash

From 30f308f7d2401b5af579ffa0fba0fd097b35df99 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 27 Mar 2017 19:14:24 +0200
Subject: [PATCH 0035/1374] link udapi.readthedocs.io

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index d0666b70..7183cd6c 100644
--- a/README.md
+++ b/README.md
@@ -3,6 +3,7 @@ Python framework for processing Universal Dependencies data
 
 [![Build Status](https://travis-ci.org/udapi/udapi-python.svg?branch=master)](https://travis-ci.org/udapi/udapi-python)
 [![Website](https://img.shields.io/website-up-down-green-red/http/udapi.github.io.svg)](http://udapi.github.io)
+[![Documentation Status](https://readthedocs.org/projects/udapi/badge/)](http://udapi.readthedocs.io)
 
 ## Requirements
 - You need Python 3.3 or higher.

From 4cc3e13e7c7b89180da2662b37f9634e78b32656 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 27 Mar 2017 20:49:30 +0200
Subject: [PATCH 0036/1374] fix rst syntax (work in progress)

---
 udapi/block/transform/proj.py       | 15 ++---
 udapi/block/tutorial/adpositions.py | 13 +++--
 udapi/block/ud/addmwt.py            |  1 +
 udapi/block/ud/convert1to2.py       | 13 +++--
 udapi/block/ud/el/addmwt.py         |  2 +-
 udapi/block/ud/ro/setspaceafter.py  | 22 ++++---
 udapi/block/write/html.py           | 24 ++++----
 udapi/block/write/sdparse.py        | 28 ++++-----
 udapi/block/write/textmodetrees.py  | 91 +++++++++++++++--------------
 udapi/block/write/tikz.py           | 15 ++---
 udapi/block/write/vislcg.py         | 64 ++++++++++----------
 11 files changed, 153 insertions(+), 135 deletions(-)

diff --git a/udapi/block/transform/proj.py b/udapi/block/transform/proj.py
index f15e46e9..6254b917 100644
--- a/udapi/block/transform/proj.py
+++ b/udapi/block/transform/proj.py
@@ -6,13 +6,14 @@
 http://www.maltparser.org/optiondesc.html#pproj-marking_strategy
 
 TODO: implement also path and head+path strategies.
+
 TODO: Sometimes it would be better (intuitively)
-      to lower the gap-node (if its whole subtree is in the gap
-      and if this does not cause more non-projectivities)
-      rather than to lift several nodes whose parent-edge crosses this gap.
-      We would need another label value (usually the lowering is of depth 1),
-      but the advantage is that reconstruction of lowered edges
-      during deprojectivization is simple and needs no heuristics.
+to lower the gap-node (if its whole subtree is in the gap
+and if this does not cause more non-projectivities)
+rather than to lift several nodes whose parent-edge crosses this gap.
+We would need another label value (usually the lowering is of depth 1),
+but the advantage is that reconstruction of lowered edges
+during deprojectivization is simple and needs no heuristics.
 """
 from udapi.core.block import Block
 
@@ -59,4 +60,4 @@ def mark(self, node, label):
         elif self.label == 'deprel':
             node.deprel = '%s:%s+%s' % (node.udeprel, node.sdeprel, label)
         else:
-            raise(ValueError('Unknown parameter label=%s' % self.label))
+            raise ValueError('Unknown parameter label=%s' % self.label)
diff --git a/udapi/block/tutorial/adpositions.py b/udapi/block/tutorial/adpositions.py
index cc8bafba..cf2ad514 100644
--- a/udapi/block/tutorial/adpositions.py
+++ b/udapi/block/tutorial/adpositions.py
@@ -1,14 +1,15 @@
 """tutorial.Adpositions block template.
 
-Example usage:
-for a in */sample.conllu; do
+Example usage::
+
+ for a in */sample.conllu; do
     printf '%50s ' $a;
     udapy tutorial.Adpositions < $a;
-done | tee results.txt
+ done | tee results.txt
 
-# What are the English postpositions?
-cat UD_English/sample.conllu | udapy -TM util.Mark \
- node='node.upos == "ADP" and node.parent.precedes(node)' | less -R
+ # What are the English postpositions?
+ cat UD_English/sample.conllu | udapy -TM util.Mark \
+   node='node.upos == "ADP" and node.parent.precedes(node)' | less -R
 """
 from udapi.core.block import Block
 
diff --git a/udapi/block/ud/addmwt.py b/udapi/block/ud/addmwt.py
index 653cfa26..eab2158b 100644
--- a/udapi/block/ud/addmwt.py
+++ b/udapi/block/ud/addmwt.py
@@ -57,6 +57,7 @@ def multiword_analysis(self, node):
         """Return a dict with MWT info or None if `node` does not represent a multiword token.
 
         An example return value is::
+
         {
             'form': 'aby bych',
             'lemma': 'aby být',
diff --git a/udapi/block/ud/convert1to2.py b/udapi/block/ud/convert1to2.py
index ce549256..e389e476 100644
--- a/udapi/block/ud/convert1to2.py
+++ b/udapi/block/ud/convert1to2.py
@@ -275,13 +275,16 @@ def fix_remnants_in_tree(self, root):
         Remnant's parent is always the correlate (same-role) node.
         Usually, correlate's parent is the head of the whole ellipsis subtree,
         i.e. the first conjunct. However, sometimes remnants are deeper, e.g.
-        'Over 300 Iraqis are reported dead and 500 wounded.' with edges:
-         nsubjpass(reported, Iraqis)
-         nummod(Iraqis, 300)
-         remnant(300, 500)
+        'Over 300 Iraqis are reported dead and 500 wounded.' with edges::
+
+          nsubjpass(reported, Iraqis)
+          nummod(Iraqis, 300)
+          remnant(300, 500)
+
         Let's expect all remnants in one tree are part of the same ellipsis structure.
+
         TODO: theoretically, there may be more ellipsis structures with remnants in one tree,
-              but I have no idea how to distinguish them from the deeper-remnants cases.
+        but I have no idea how to distinguish them from the deeper-remnants cases.
         """
         remnants = [n for n in root.descendants if n.deprel == 'remnant']
         if not remnants:
diff --git a/udapi/block/ud/el/addmwt.py b/udapi/block/ud/el/addmwt.py
index 39e23620..81a98836 100644
--- a/udapi/block/ud/el/addmwt.py
+++ b/udapi/block/ud/el/addmwt.py
@@ -3,7 +3,7 @@
 Notice that this should be used only for converting existing conllu files.
 Ideally a tokenizer should have already split the MWTs.
 Also notice that this block does not deal with the relatively rare
-PRON(Person=2)+'*+PRON(Person=3, i.e. "σ'το" and "στο") MWTs.
+``PRON(Person=2)+'*+PRON(Person=3, i.e. "σ'το" and "στο")`` MWTs.
 """
 import udapi.block.ud.addmwt
 
diff --git a/udapi/block/ud/ro/setspaceafter.py b/udapi/block/ud/ro/setspaceafter.py
index 80bfda8f..bc18f364 100644
--- a/udapi/block/ud/ro/setspaceafter.py
+++ b/udapi/block/ud/ro/setspaceafter.py
@@ -1,7 +1,8 @@
 """Block ud.ro.SetSpaceAfter for heuristic setting of SpaceAfter=No in Romanian.
 
-Usage:
-udapy -s ud.ro.SetSpaceAfter < in.conllu > fixed.conllu
+Usage::
+
+  udapy -s ud.ro.SetSpaceAfter < in.conllu > fixed.conllu
 
 Author: Martin Popel
 """
@@ -13,13 +14,16 @@ class SetSpaceAfter(udapi.block.ud.setspaceafter.SetSpaceAfter):
     """Block for heuristic setting of the SpaceAfter=No MISC attribute in Romanian.
 
     Romanian uses many contractions, e.g.
-    raw    | meaning | tokenized | lemmatized
-    -------|---------|-----------|-----------
-    n-ar   | nu ar   | n- ar     | nu avea
-    să-i   | să îi   | să -i     | să el
-    într-o | în o    | într- o   | întru un
-    nu-i   | nu îi   | nu -i     | nu el
-    nu-i   | nu e    | nu -i     | nu fi
+
+    =======  =======  =========  ==========
+    raw      meaning  tokenized  lemmatized
+    =======  =======  =========  ==========
+    n-ar     nu ar    n- ar      nu avea
+    să-i     să îi    să -i      să el
+    într-o   în o     într- o    întru un
+    nu-i     nu îi    nu -i      nu el
+    nu-i     nu e     nu -i      nu fi
+    =======  =======  =========  ==========
 
     Detokenization is quite simple: no space after word-final hyphen and before word-initial hyphen.
     There are just two exceptions, I have found:
diff --git a/udapi/block/write/html.py b/udapi/block/write/html.py
index 2fd76bf7..85b8dcc9 100644
--- a/udapi/block/write/html.py
+++ b/udapi/block/write/html.py
@@ -5,17 +5,19 @@
 class Html(BaseWriter):
     """A writer for HTML+JavaScript+SVG visualization of dependency trees.
 
-    Usage:
-    # from the command line
-    udapy write.Html < file.conllu > file.html
-    firefox file.html
-
-    # for offline use, we need to download first three JavaScript libraries
-    wget https://code.jquery.com/jquery-2.1.4.min.js
-    wget https://cdn.rawgit.com/eligrey/FileSaver.js/master/FileSaver.min.js
-    wget https://cdn.rawgit.com/ufal/js-treex-view/gh-pages/js-treex-view.js
-    udapy write.Html path_to_js=. < file.conllu > file.html
-    firefox file.html
+    .. code-block:: bash
+
+      # from the command line
+      udapy write.Html < file.conllu > file.html
+      firefox file.html
+
+    For offline use, we need to download first three JavaScript libraries::
+
+      wget https://code.jquery.com/jquery-2.1.4.min.js
+      wget https://cdn.rawgit.com/eligrey/FileSaver.js/master/FileSaver.min.js
+      wget https://cdn.rawgit.com/ufal/js-treex-view/gh-pages/js-treex-view.js
+      udapy write.Html path_to_js=. < file.conllu > file.html
+      firefox file.html
 
     This writer produces an html file with drawings of the dependency trees
     in the document (there are buttons for selecting which bundle will be shown).
diff --git a/udapi/block/write/sdparse.py b/udapi/block/write/sdparse.py
index 209938b5..60b78d6d 100644
--- a/udapi/block/write/sdparse.py
+++ b/udapi/block/write/sdparse.py
@@ -8,33 +8,35 @@ class Sdparse(BaseWriter):
     """A writer of files in the Stanford dependencies format, suitable for Brat visualization.
 
     Usage:
-    udapy write.Sdparse print_upos=0 < in.conllu
+    ``udapy write.Sdparse print_upos=0 < in.conllu``
 
     Example output::
 
-    ~~~ sdparse
-    Corriere Sport da pagina 23 a pagina 26
-    name(Corriere, Sport)
-    case(pagina-4, da)
-    nmod(Corriere, pagina-4)
-    nummod(pagina-4, 23)
-    case(pagina-7, a)
-    nmod(Corriere, pagina-7)
-    nummod(pagina-7, 26)
-    ~~~
+      ~~~ sdparse
+      Corriere Sport da pagina 23 a pagina 26
+      name(Corriere, Sport)
+      case(pagina-4, da)
+      nmod(Corriere, pagina-4)
+      nummod(pagina-4, 23)
+      case(pagina-7, a)
+      nmod(Corriere, pagina-7)
+      nummod(pagina-7, 26)
+      ~~~
 
     To visualize it, use embedded Brat, e.g. go to
-    http://universaldependencies.org/visualization.html#editing
+    http://universaldependencies.org/visualization.html#editing.
     Click the edit button and paste the output of this writer excluding the `~~~` marks.
 
     Notes:
-    Original Stanford dependencies format (http://nlp.stanford.edu/software/dependencies_manual.pdf)
+    The original `Stanford dependencies format
+    <http://nlp.stanford.edu/software/dependencies_manual.pdf>`_
     allows explicit specification of the root dependency, e.g. `root(ROOT-0, makes-8)`.
     However, this is not allowed by Brat, so this writer does not print it.
 
     UD v2.0 allows tokens with spaces, but I am not aware of any Brat support.
 
     Alternatives:
+
     * `write.Conllu` Brat recently supports also the CoNLL-U input
     * `write.TextModeTrees` may be more readable/useful in some usecases
     * `write.Html` dtto, press "Save as SVG" button, convert to pdf
diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index a2c949cc..b5968b3a 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -20,64 +20,67 @@
 class TextModeTrees(BaseWriter):
     """An ASCII pretty printer of dependency trees.
 
-    SYNOPSIS
-    # from command line (visualize CoNLL-U files)
-    udapy write.TextModeTrees color=1 < file.conllu | less -R
+    .. code-block:: bash
 
-    # is scenario (examples of other parameters)
-    write.TextModeTrees indent=1 print_sent_id=1 print_sentence=1
-    write.TextModeTrees zones=en,cs attributes=form,lemma,upos minimize_cross=0
+      # from the command line (visualize CoNLL-U files)
+      udapy write.TextModeTrees color=1 < file.conllu | less -R
+
+    In scenario (examples of other parameters)::
+
+      write.TextModeTrees indent=1 print_sent_id=1 print_sentence=1
+      write.TextModeTrees zones=en,cs attributes=form,lemma,upos minimize_cross=0
 
-    DESCRIPTION
     This block prints dependency trees in plain-text format.
-    For example the following CoNLL-U file (with tabs instead of spaces)
-
-    1  I     I     PRON  PRP Number=Sing|Person=1 2  nsubj     _ _
-    2  saw   see   VERB  VBD Tense=Past           0  root      _ _
-    3  a     a     DET   DT  Definite=Ind         4  det       _ _
-    4  dog   dog   NOUN  NN  Number=Sing          2  dobj      _ _
-    5  today today NOUN  NN  Number=Sing          2  nmod:tmod _ SpaceAfter=No
-    6  ,     ,     PUNCT ,   _                    2  punct     _ _
-    7  which which DET   WDT PronType=Rel         10 nsubj     _ _
-    8  was   be    VERB  VBD Person=3|Tense=Past  10 cop       _ _
-    9  a     a     DET   DT  Definite=Ind         10 det       _ _
-    10 boxer boxer NOUN  NN  Number=Sing          4  acl:relcl _ SpaceAfter=No
-    11 .     .     PUNCT .   _                    2  punct     _ _
-
-    will be printed (with the default parameters) as
-    ─┮
-     │ ╭─╼ I PRON nsubj
-     ╰─┾ saw VERB root
-       │                        ╭─╼ a DET det
-       ├────────────────────────┾ dog NOUN dobj
-       ├─╼ today NOUN nmod:tmod │
-       ├─╼ , PUNCT punct        │
-       │                        │ ╭─╼ which DET nsubj
-       │                        │ ├─╼ was VERB cop
-       │                        │ ├─╼ a DET det
-       │                        ╰─┶ boxer NOUN acl:relcl
-       ╰─╼ . PUNCT punct
+    For example the following CoNLL-U file (with tabs instead of spaces)::
+
+      1  I     I     PRON  PRP Number=Sing|Person=1 2  nsubj     _ _
+      2  saw   see   VERB  VBD Tense=Past           0  root      _ _
+      3  a     a     DET   DT  Definite=Ind         4  det       _ _
+      4  dog   dog   NOUN  NN  Number=Sing          2  dobj      _ _
+      5  today today NOUN  NN  Number=Sing          2  nmod:tmod _ SpaceAfter=No
+      6  ,     ,     PUNCT ,   _                    2  punct     _ _
+      7  which which DET   WDT PronType=Rel         10 nsubj     _ _
+      8  was   be    VERB  VBD Person=3|Tense=Past  10 cop       _ _
+      9  a     a     DET   DT  Definite=Ind         10 det       _ _
+      10 boxer boxer NOUN  NN  Number=Sing          4  acl:relcl _ SpaceAfter=No
+      11 .     .     PUNCT .   _                    2  punct     _ _
+
+    will be printed (with the default parameters) as::
+
+      ─┮
+       │ ╭─╼ I PRON nsubj
+       ╰─┾ saw VERB root
+         │                        ╭─╼ a DET det
+         ├────────────────────────┾ dog NOUN dobj
+         ├─╼ today NOUN nmod:tmod │
+         ├─╼ , PUNCT punct        │
+         │                        │ ╭─╼ which DET nsubj
+         │                        │ ├─╼ was VERB cop
+         │                        │ ├─╼ a DET det
+         │                        ╰─┶ boxer NOUN acl:relcl
+         ╰─╼ . PUNCT punct
 
     Some non-projective trees cannot be printed witout crossing edges.
-    TextModeTrees uses a special "bridge" symbol ─╪─ to mark this:
-    ─┮
-     │ ╭─╼ 1
-     ├─╪───┮ 2
-     ╰─┶ 3 │
-           ╰─╼ 4
-
-    By default parameter `color=auto`, so if the output is printed to the console
+    TextModeTrees uses a special "bridge" symbol ─╪─ to mark this::
+
+      ─┮
+       │ ╭─╼ 1
+       ├─╪───┮ 2
+       ╰─┶ 3 │
+             ╰─╼ 4
+
+    By default parameter ``color=auto``, so if the output is printed to the console
     (not file or pipe), each node attribute is printed in different color.
     If a given node's MISC contains any of `ToDo`, `Bug` or `Mark` attributes
     (or any other specified in the parameter `mark`), the node will be highlighted
     (by reveresing the background and foreground colors).
 
     This block's method `process_tree` can be called on any node (not only root),
-    which is useful for printing subtrees using `node.print_subtree()`,
+    which is useful for printing subtrees using ``node.print_subtree()``,
     which is internally implemented using this block.
 
     SEE ALSO
-    `write.TextModeTreesHtml`
+    :py:class:`.TextModeTreesHtml`
     """
 
     def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
diff --git a/udapi/block/write/tikz.py b/udapi/block/write/tikz.py
index 4eb69221..7e95454e 100644
--- a/udapi/block/write/tikz.py
+++ b/udapi/block/write/tikz.py
@@ -7,19 +7,20 @@
 class Tikz(BaseWriter):
     r"""A writer of files in the LaTeX with tikz-dependency format.
 
-    Usage:
-    udapy write.Tikz < my.conllu > my.tex
-    pdflatex my.tex
-    xdg-open my.pdf
+    Usage::
+
+      udapy write.Tikz < my.conllu > my.tex
+      pdflatex my.tex
+      xdg-open my.pdf
 
     Long sentences may result in too large pictures.
     You can tune the width (in addition to changing fontsize or using minipage and rescaling) with
-      ``\begin{deptext}[column sep=0.2cm]``
+    ``\begin{deptext}[column sep=0.2cm]``
     or individually for each word:
-      ``My \&[.5cm] dog \& etc.``
+    ``My \&[.5cm] dog \& etc.``
     By default, the height of the horizontal segment of a dependency edge is proportional
     to the distance between the linked words. You can tune the height with:
-     ``\depedge[edge unit distance=1.5ex]{9}{1}{deprel}``
+    ``\depedge[edge unit distance=1.5ex]{9}{1}{deprel}``
 
     See `tikz-dependency documentation
     <http://mirrors.ctan.org/graphics/pgf/contrib/tikz-dependency/tikz-dependency-doc.pdf>`_
diff --git a/udapi/block/write/vislcg.py b/udapi/block/write/vislcg.py
index 9179eeb2..5dd5f52b 100644
--- a/udapi/block/write/vislcg.py
+++ b/udapi/block/write/vislcg.py
@@ -19,44 +19,44 @@ class Vislcg(BaseWriter):
     See https://visl.sdu.dk/visl/vislcg-doc.html
 
     Usage:
-    udapy write.Vislcg < in.conllu > out.vislcg
+    ``udapy write.Vislcg < in.conllu > out.vislcg``
 
     Example output::
 
-    "<Қыз>"
-            "қыз" n nom @nsubj #1->3
-    "<оның>"
-            "ол" prn pers p3 sg gen @nmod:poss #2->3
-    "<қарындасы>"
-            "қарындас" n px3sp nom @parataxis #3->8
-                "е" cop aor p3 sg @cop #4->3
-    "<,>"
-            "," cm @punct #5->8
-    "<ол>"
-            "ол" prn pers p3 sg nom @nsubj #6->8
-    "<бес>"
-            "бес" num @nummod #7->8
-    "<жаста>"
-            "жас" n loc @root #8->0
-                "е" cop aor p3 sg @cop #9->8
-    "<.>"
-            "." sent @punct #10->8
+      "<Қыз>"
+              "қыз" n nom @nsubj #1->3
+      "<оның>"
+              "ол" prn pers p3 sg gen @nmod:poss #2->3
+      "<қарындасы>"
+              "қарындас" n px3sp nom @parataxis #3->8
+                  "е" cop aor p3 sg @cop #4->3
+      "<,>"
+              "," cm @punct #5->8
+      "<ол>"
+              "ол" prn pers p3 sg nom @nsubj #6->8
+      "<бес>"
+              "бес" num @nummod #7->8
+      "<жаста>"
+              "жас" n loc @root #8->0
+                  "е" cop aor p3 sg @cop #9->8
+      "<.>"
+              "." sent @punct #10->8
 
     Example input::
 
-    # text = Қыз оның қарындасы, ол бес жаста.
-    1    Қыз        қыз       _  n     nom             3  nsubj      _  _
-    2    оның       ол        _  prn   pers|p3|sg|gen  3  nmod:poss  _  _
-    3-4  қарындасы  _         _  _     _               _  _          _  _
-    3    қарындасы  қарындас  _  n     px3sp|nom       8  parataxis  _  _
-    4    _          е         _  cop   aor|p3|sg       3  cop        _  _
-    5    ,          ,         _  cm    _               8  punct      _  _
-    6    ол         ол        _  prn   pers|p3|sg|nom  8  nsubj      _  _
-    7    бес        бес       _  num   _               8  nummod     _  _
-    8-9  жаста      _         _  _     _               _  _          _  _
-    8    жаста      жас       _  n     loc             0  root       _  _
-    9    _          е         _  cop   aor|p3|sg       8  cop        _  _
-    10   .          .         _  sent  _               8  punct      _  _
+      # text = Қыз оның қарындасы, ол бес жаста.
+      1    Қыз        қыз       _  n     nom             3  nsubj      _  _
+      2    оның       ол        _  prn   pers|p3|sg|gen  3  nmod:poss  _  _
+      3-4  қарындасы  _         _  _     _               _  _          _  _
+      3    қарындасы  қарындас  _  n     px3sp|nom       8  parataxis  _  _
+      4    _          е         _  cop   aor|p3|sg       3  cop        _  _
+      5    ,          ,         _  cm    _               8  punct      _  _
+      6    ол         ол        _  prn   pers|p3|sg|nom  8  nsubj      _  _
+      7    бес        бес       _  num   _               8  nummod     _  _
+      8-9  жаста      _         _  _     _               _  _          _  _
+      8    жаста      жас       _  n     loc             0  root       _  _
+      9    _          е         _  cop   aor|p3|sg       8  cop        _  _
+      10   .          .         _  sent  _               8  punct      _  _
     """
 
     def process_tree(self, tree):

From bc09e9e5039f7aadcfdc2fe759ed253c17fa130c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 28 Mar 2017 15:12:36 +0200
Subject: [PATCH 0037/1374] new tutorial task template

---
 udapi/block/tutorial/addcommas.py | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 udapi/block/tutorial/addcommas.py

diff --git a/udapi/block/tutorial/addcommas.py b/udapi/block/tutorial/addcommas.py
new file mode 100644
index 00000000..8c04e242
--- /dev/null
+++ b/udapi/block/tutorial/addcommas.py
@@ -0,0 +1,22 @@
+"""tutorial.AddCommas block template."""
+from udapi.core.block import Block
+
+class AddCommas(Block):
+    """Heuristically insert nodes for missing commas."""
+
+    def process_node(self, node):      
+        if self.should_add_comma_before(node):
+            comma = node.create_child(form=',', deprel='punct', upos='PUNCT')
+            comma.shift_before_node(node)
+
+    def should_add_comma_before(self, node):
+        # TODO: Your task: implement some heuristics
+        prev_node = node.prev_node
+        if prev_node is None:
+            return False
+        if prev_node.lemma == 'however':
+            return True
+        if any(n.deprel == 'appos' for n in prev_node.children):
+            return True
+        
+        return False

From 48e0ca452b0d42d87c3237146441d11521cb9419 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 30 Mar 2017 22:20:00 +0200
Subject: [PATCH 0038/1374] block parameter `zones`

---
 udapi/core/block.py | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/udapi/core/block.py b/udapi/core/block.py
index 7326f7f8..453b1d65 100644
--- a/udapi/core/block.py
+++ b/udapi/core/block.py
@@ -5,8 +5,8 @@
 class Block(object):
     """The smallest processing unit for processing Universal Dependencies data."""
 
-    def __init__(self, **kwargs):
-        pass
+    def __init__(self, zones='all'):
+        self.zones = zones
 
     def process_start(self):
         """A hook method that is executed before processing UD data"""
@@ -28,7 +28,8 @@ def process_tree(self, tree):
     def process_bundle(self, bundle):
         """Process a UD bundle"""
         for tree in bundle:
-            self.process_tree(tree)
+            if self._should_process_tree(tree):
+                self.process_tree(tree)
 
     def process_document(self, document):
         """Process a UD document"""
@@ -44,3 +45,12 @@ def before_process_document(self, document):
     def after_process_document(self, document):
         """This method is called after each process_document."""
         pass
+
+    def _should_process_tree(self, tree):
+        if self.zones == 'all':
+            return True
+        if self.zones == '' and tree.zone == '':
+            return True
+        if tree.zone in self.zones.split(','):
+            return True
+        return False

From 20ebcec7551fab001d94036f64d718a4c4681a56 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 30 Mar 2017 23:10:26 +0200
Subject: [PATCH 0039/1374] implement all the functionality of eval.F1

---
 udapi/block/eval/f1.py    | 191 +++++++++++++++++++++++++++++++++++
 udapi/block/eval/lcsf1.py | 203 --------------------------------------
 2 files changed, 191 insertions(+), 203 deletions(-)
 create mode 100644 udapi/block/eval/f1.py
 delete mode 100644 udapi/block/eval/lcsf1.py

diff --git a/udapi/block/eval/f1.py b/udapi/block/eval/f1.py
new file mode 100644
index 00000000..90be94ec
--- /dev/null
+++ b/udapi/block/eval/f1.py
@@ -0,0 +1,191 @@
+"""Block eval.F1 for evaluating differences between sentences with P/R/F1.
+
+``eval.F1 zones=en_pred gold_zone=en_gold details=0``
+prints something like::
+
+  predicted =     210
+  gold      =     213
+  correct   =     210
+  precision = 100.00%
+  recall    =  98.59%
+  F1        =  99.29%
+
+``eval.F1 gold_zone=y attributes=form,upos focus='(?i:an?|the)_DET' details=4``
+prints something like::
+
+  === Details ===
+  token       pred  gold  corr   prec     rec      F1
+  the_DET      711   213   188  26.44%  88.26%  40.69%
+  The_DET       82    25    19  23.17%  76.00%  35.51%
+  a_DET          0    62     0   0.00%   0.00%   0.00%
+  an_DET         0    16     0   0.00%   0.00%   0.00%
+  === Totals ===
+  predicted =     793
+  gold      =     319
+  correct   =     207
+  precision =  26.10%
+  recall    =  64.89%
+  F1        =  37.23%
+
+This block finds differences between nodes of trees in two zones
+and reports the overall precision, recall and F1.
+The two zones are "predicted" (on which this block is applied)
+and "gold" (which needs to be specified with parameter ``gold``).
+
+This block also reports the number of total nodes in the predicted zone
+and in the gold zone and the number of "correct" nodes,
+that is predicted nodes which are also in the gold zone.
+By default two nodes are considered "the same" if they have the same ``form``,
+but it is possible to check also for other nodes' attributes
+(with parameter ``attributes``).
+
+As usual::
+
+  precision = correct / predicted
+  recall = correct / gold
+  F1 = 2 * precision * recall / (precision + recall)
+
+The implementation is based on finding the longest common subsequence (LCS)
+between the nodes in the two trees.
+This means that the two zones do not need to be explicitly word-aligned.
+"""
+from collections import Counter
+import logging
+import re
+
+from udapi.core.basewriter import BaseWriter
+
+# pylint: disable=too-many-instance-attributes,invalid-name
+class F1(BaseWriter):
+    """Evaluate differences between sentences (in different zones) with P/R/F1.
+
+    Args:
+    zones: Which zone contains the "predicted" trees?
+           Make sure that you specify just one zone.
+           If you leave the default value "all" and the document contains more zones,
+           the results will be mixed, which is most likely not what you wanted.
+           Exception: If the document conaints just two zones (predicted and gold trees),
+           you can keep the default value "all" because this block
+           will skip comparison of the gold zone with itself.
+
+    gold_zone: Which zone contains the gold-standard trees?
+
+    attributes: comma separated list of attributes which should be checked
+                when deciding whether two nodes are equivalent in LCS
+
+    focus: Regular expresion constraining the tokens we are interested in.
+           If more attributes were specified in the ``attributes`` parameter,
+           their values are concatenated with underscore, so ``focus`` should reflect that
+           e.g. ``attributes=form,upos focus='(a|the)_DET'``.
+           For case-insensitive focus use e.g. ``focus='(?i)the'``
+           (which is equivalent to ``focus='[Tt][Hh][Ee]'``).
+
+    details: Print also detailed statistics for each token (matching the ``focus``).
+             The value of this parameter ``details`` specifies the number of tokens to include.
+             The tokens are sorted according to the sum of their *predicted* and *gold* counts.
+    """
+
+    def __init__(self, gold_zone, attributes='form', focus=None, details=4, **kwargs):
+        """Create the eval.F1 block object."""
+        super().__init__(**kwargs)
+        self.gold_zone = gold_zone
+        self.attrs = attributes.split(',')
+        self.focus = None
+        if focus is not None:
+            self.focus = re.compile(focus)
+        self.details = details
+        self.correct, self.pred, self.gold = 0, 0, 0
+        self.visited_zones = Counter()
+        if details:
+            self._common = Counter()
+            self._pred = Counter()
+            self._gold = Counter()
+            self._total = Counter()
+
+    def process_tree(self, tree):
+        gold_tree = tree.bundle.get_tree(self.gold_zone)
+        if tree == gold_tree:
+            return
+        self.visited_zones[tree.zone] += 1
+
+        pred_tokens = ['_'.join(n.get_attrs(self.attrs)) for n in tree.descendants]
+        gold_tokens = ['_'.join(n.get_attrs(self.attrs)) for n in gold_tree.descendants]
+        common = find_lcs(pred_tokens, gold_tokens)
+
+        if self.focus is not None:
+            common = [x for x in common if self.focus.fullmatch(x)]
+            pred_tokens = [x for x in pred_tokens if self.focus.fullmatch(x)]
+            gold_tokens = [x for x in gold_tokens if self.focus.fullmatch(x)]
+
+        self.correct += len(common)
+        self.pred += len(pred_tokens)
+        self.gold += len(gold_tokens)
+
+        if self.details:
+            for x in common:
+                self._common[x] += 1
+            for x in gold_tokens:
+                self._gold[x] += 1
+                self._total[x] += 1
+            for x in pred_tokens:
+                self._pred[x] += 1
+                self._total[x] += 1
+
+    def process_end(self):
+        # Redirect the default filehandle to the file specified by self.files
+        self.before_process_document(None)
+
+        if not self.visited_zones:
+            logging.warning('Block eval.F1 was not applied to any zone. '
+                            'Check the parameter zones=%s', self.zones)
+        elif len(self.visited_zones) > 1:
+            logging.warning('Block eval.F1 was applied to more than one zone %s. '
+                            'The results are mixed together. Check the parameter zones=%s',
+                            list(self.visited_zones.elements()), self.zones)
+        print('Comparing predicted trees (zone=%s) with gold trees (zone=%s), sentences=%d'
+              % (next(self.visited_zones.elements()), self.gold_zone,
+                 self.visited_zones.most_common(1)[0][1]))
+        if self.details:
+            print('=== Details ===')
+            print('%-10s %5s %5s %5s %6s  %6s  %6s'
+                  % ('token', 'pred', 'gold', 'corr', 'prec', 'rec', 'F1'))
+            tokens = self._total.most_common(self.details)
+            for token, _ in tokens:
+                _prec = self._common[token] / (self._pred[token] or 1)
+                _rec = self._common[token] / (self._gold[token] or 1)
+                _f1 = 2 * _prec * _rec / ((_prec + _rec) or 1)
+                print('%-10s %5d %5d %5d %6.2f%% %6.2f%% %6.2f%%'
+                      % (token, self._pred[token], self._gold[token], self._common[token],
+                         100*_prec, 100*_rec, 100*_f1))
+            print('=== Totals ===')
+
+        print("%-9s = %7d\n"*3
+              % ('predicted', self.pred, 'gold', self.gold, 'correct', self.correct), end='')
+        pred, gold = self.pred or 1, self.gold or 1 # prevent division by zero
+        precision = self.correct / pred
+        recall = self.correct / gold
+        f1 = 2 * precision * recall / ((precision + recall) or 1)
+        print("%-9s = %6.2f%%\n" * 3
+              % ('precision', 100*precision, 'recall', 100*recall, 'F1', 100*f1), end='')
+
+
+# difflib.SequenceMatcher does not compute LCS, so let's implement it here
+# TODO: make faster by trimming common prefix and sufix
+def find_lcs(x, y):
+    """Find longest common subsequence."""
+    m, n = len(x), len(y)
+    C = [[0] * (n + 1) for _ in range(m + 1)]
+    for i in range(1, m+1):
+        for j in range(1, n+1):
+            C[i][j] = C[i-1][j-1] + 1 if x[i-1] == y[j-1] else max(C[i][j-1], C[i-1][j])
+    index = C[m][n]
+    lcs = [None] * index
+    while m > 0 and n > 0:
+        if x[m-1] == y[n-1]:
+            lcs[index-1] = x[m-1]
+            m, n, index = m-1, n-1, index-1
+        elif C[m-1][n] > C[m][n-1]:
+            m -= 1
+        else:
+            n -= 1
+    return lcs
diff --git a/udapi/block/eval/lcsf1.py b/udapi/block/eval/lcsf1.py
deleted file mode 100644
index 2c085779..00000000
--- a/udapi/block/eval/lcsf1.py
+++ /dev/null
@@ -1,203 +0,0 @@
-"""Block eval.LcsF1 for evaluating differences between sentences with P/R/F1."""
-from udapi.core.basewriter import BaseWriter
-
-class LcsF1(BaseWriter): # pylint: disable=too-many-instance-attributes
-    """Evaluate differences between sentences (in different zones) with P/R/F1."""
-
-    def __init__(self, gold_zone, attributes='form', focus='.*', details=4, **kwargs):
-        """Create the LcsF1 block object."""
-        super().__init__(**kwargs)
-        self.gold_zone = gold_zone
-        self.attributes = attributes
-        self.focus = focus
-        self.details = details
-        self._stats = {}
-        self.correct, self.pred, self.gold = 0, 0, 0
-
-    def process_tree(self, tree):
-        gold_tree = tree.bundle.get_tree(self.gold_zone)
-        if tree == gold_tree:
-            return
-        #self._stats['zones'][tree.zone] += 1
-
-        attrs = self.attributes.split(',')
-        pred_tokens = ['_'.join(n.get_attrs(attrs)) for n in tree.descendants]
-        gold_tokens = ['_'.join(n.get_attrs(attrs)) for n in gold_tree.descendants]
-        common = find_lcs(pred_tokens, gold_tokens)
-
-        # my $focus = $self->focus;
-        # if ($focus ne '.*') {
-        #     @common      = grep {/$focus/} @common;
-        #     @pred_tokens = grep {/$focus/} @pred_tokens;
-        #     @gold_tokens = grep {/$focus/} @gold_tokens;
-        # }
-
-        self.correct += len(common)
-        self.pred += len(pred_tokens)
-        self.gold += len(gold_tokens)
-
-        # if ($self->details){
-        #     $self->_stats->{C}{$_}++ for (@common);
-        #     $self->_stats->{P}{$_}++ for (@pred_tokens);
-        #     $self->_stats->{G}{$_}++ for (@gold_tokens);
-        #     $self->_stats->{T}{$_}++ for (@gold_tokens, @pred_tokens);
-        # }
-
-    def process_end(self):
-        # Redirect the default filehandle to the file specified by self.files
-        self.before_process_document(None)
-
-        # my %pred_zones = %{$self->_stats->{zones}};
-        # my @pz = keys %pred_zones;
-        # if (!@pz) {
-        #     warn 'Block Eval::LcsF1 was not applied to any zone. Check the parameter zones='
-        #          . $self->zones;
-        # } elsif (@pz > 1){
-        #     warn "Block Eval::LcsF1 was applied to more than one zone (@pz). "
-        #        . 'The results are mixed together. Check the parameter zones='.$self->zones;
-        # }
-        # say "Comparing predicted trees (zone=@pz) with gold trees (zone="
-        #     . $self->gold_zone . "), sentences=$pred_zones{$pz[0]}";
-        #
-        # if ($self->details){
-        #     say '=== Details ===';
-        #     my $total_count = $self->_stats->{T};
-        #     my @tokens = sort {$total_count->{$b} <=> $total_count->{$a}} keys %{$total_count};
-        #     splice @tokens, $self->details;
-        #     printf "%-10s %5s %5s %5s %6s  %6s  %6s\n", qw(token pred gold corr prec rec F1);
-        #     foreach my $token (@tokens){
-        #         my ($p, $g, $c) = map {$self->_stats->{$_}{$token}||0} (qw(P G C));
-        #         my $pr = $c / ($p || 1);
-        #         my $re = $c / ($g || 1);
-        #         my $f  = 2 * $pr * $re / (($pr + $re)||1);
-        #         printf "%-10s %5d %5d %5d %6.2f%% %6.2f%% %6.2f%%\n",
-        #             $token, $p, $g, $c, 100*$pr, 100*$re, 100*$f
-        #     }
-        #     say '=== Totals ==='
-        # }
-
-
-        print("%-9s = %7d\n"*3
-              % ('predicted', self.pred, 'gold', self.gold, 'correct', self.correct))
-        # ($pred, $gold) = map {$_||1} ($pred, $gold); # prevent division by zero
-        # my $prec = $correct / $pred;
-        # my $rec  = $correct / $gold;
-        # my $f1   = 2 * $prec * $rec / (($prec + $rec)||1);
-        # printf "%-9s = %6.2f%%\n"x3, precision=>100*$prec, recall=>100*$rec, F1=>100*$f1;
-
-
-# difflib.SequenceMatcher does not compute LCS, so let's implement it here
-# TODO: make faster by trimming common prefix and sufix
-def find_lcs(x, y):
-    m, n = len(x), len(y)
-    C = [[0] * (n + 1) for _ in range(m + 1)]
-    for i in range(1, m+1):
-        for j in range(1, n+1):
-            C[i][j] = C[i-1][j-1] + 1 if x[i-1] == y[j-1] else max(C[i][j-1], C[i-1][j])
-    index = C[m][n]
-    lcs = [None] * index
-    while m > 0 and n > 0:
-        if x[m-1] == y[n-1]:
-            lcs[index-1] = x[m-1]
-            m, n, index = m-1, n-1, index-1
-        elif C[m-1][n] > C[m][n-1]:
-            m -= 1
-        else:
-            n -= 1
-    return lcs
-
-
-'''
-Udapi::Block::Eval::LcsF1 - evaluate differences between sentences with P/R/F1
-
-=head1 SYNOPSIS
-
- Eval::LcsF1 zones=en_pred gold_zone=en_gold to=results.txt
-
- # prints something like
- predicted =     210
- gold      =     213
- correct   =     210
- precision = 100.00%
- recall    =  98.59%
- F1        =  99.29%
-
- Eval::LcsF1 gold_zone=y attributes=form,upos focus='^(?i:an?|the)_DET$' details=4
-
- # prints something like
- === Details ===
- token       pred  gold  corr   prec     rec      F1
- the_DET      711   213   188  26.44%  88.26%  40.69%
- The_DET       82    25    19  23.17%  76.00%  35.51%
- a_DET          0    62     0   0.00%   0.00%   0.00%
- an_DET         0    16     0   0.00%   0.00%   0.00%
- === Totals ===
- predicted =     793
- gold      =     319
- correct   =     207
- precision =  26.10%
- recall    =  64.89%
- F1        =  37.23%
-
-=head1 DESCRIPTION
-
-This block finds differences between nodes of trees in two zones
-and reports the overall precision, recall and F1.
-The two zones are "predicted" (on which this block is applied)
-and "gold" (which needs to be specified with parameter C<gold>).
-
-This block also reports the number of total nodes in the predicted zone
-and in the gold zone and the number of "correct" nodes,
-that is predicted nodes which are also in the gold zone.
-By default two nodes are considered "the same" if they have the same C<form>,
-but it is possible to check also for other nodes' attributes
-(with parameter C<attributes>).
-
-As usual:
-
- precision = correct / predicted
- recall = correct / gold
- F1 = 2 * precision * recall / (precision + recall)
-
-The implementation is based on finding the longest common subsequence (LCS)
-between the nodes in the two trees.
-This means that the two zones do not need to be explicitly word-aligned.
-
-=head1 PARAMETERS
-
-=head2 zones
-
-Which zone contains the "predicted" trees?
-Make sure that you specify just one zone.
-If you leave the default value "all" and the document contains more zones,
-the results will be mixed, which is most likely not what you wanted.
-Exception: If the document conaints just two zones (predicted and gold trees),
-you can keep the default value "all" because this block
-will skip comparison of the gold zone with itself.
-
-=head2 gold_zone
-
-Which zone contains the gold-standard trees?
-
-=head2 attributes
-
-comma separated list of attributes which should be checked
-when deciding whether two nodes are equivalent in LCS
-
-=head2 focus
-
-Regular expresion constraining the tokens we are interested in.
-If more attributes were specified in the C<attributes> parameter,
-their values are concatenated with underscore, so C<focus> should reflect that
-e.g. C<attributes=form,upos focus='^(a|the)_DET$'>.
-
-For case-insensitive focus use e.g. C<focus='^(?i)the$'>
-(which is equivalent to C<focus='^[Tt][Hh][Ee]$'>)
-
-=head2 details
-
-Print also detailed statistics for each token (matching the C<focus>).
-The value of this parameter C<details> specifies the number of tokens to include.
-The tokens are sorted according to the sum of their I<predicted> and I<gold> counts.
-
-'''

From 09d964dbbcbbaa2fb64b84f2ab61305f771ece48 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 4 Apr 2017 20:01:10 +0200
Subject: [PATCH 0040/1374] keep root.sent_id and root.bundle.bundle_id in sync

and both are writeable
---
 udapi/core/basereader.py |  1 -
 udapi/core/bundle.py     | 15 +++++++++++++--
 udapi/core/root.py       |  5 +++++
 3 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index bb126ae7..f9e22fbb 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -128,7 +128,6 @@ def process_document(self, document):
                     root.zone = parts[1]
                 add_to_the_last_bundle = bundle_id == last_bundle_id
                 last_bundle_id = bundle_id
-                root.sent_id = None
 
             if self.zone != 'keep':
                 root.zone = self.zone
diff --git a/udapi/core/bundle.py b/udapi/core/bundle.py
index 0a94c799..d29b2268 100644
--- a/udapi/core/bundle.py
+++ b/udapi/core/bundle.py
@@ -16,13 +16,24 @@ class Bundle(object):
     Trees in one bundle are distinguished by a zone label.
     """
 
-    __slots__ = ["trees", "number", "bundle_id", "_document"]
+    __slots__ = ["trees", "number", "_bundle_id", "_document"]
 
     def __init__(self, bundle_id=None, document=None):
         self.trees = []
-        self.bundle_id = bundle_id
+        self._bundle_id = bundle_id
         self._document = document
 
+    @property
+    def bundle_id(self):
+        """ID of this bundle."""
+        return self._bundle_id
+
+    @bundle_id.setter
+    def bundle_id(self, bundle_id):
+        self._bundle_id = bundle_id
+        for tree in self.trees:
+            tree._sent_id = bundle_id + '/' + tree.zone # pylint: disable=protected-access
+
     def __str__(self):
         if self.bundle_id is None:
             return 'bundle without id'
diff --git a/udapi/core/root.py b/udapi/core/root.py
index 5b141391..e5435c59 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -44,6 +44,11 @@ def sent_id(self):
 
     @sent_id.setter
     def sent_id(self, sent_id):
+        if self._bundle is not None:
+            parts = sent_id.split('/', 1)
+            self._bundle.bundle_id = parts[0]
+            if len(parts) == 2:
+                self.zone = parts[1]
         self._sent_id = sent_id
 
     @property

From a1e0abbb6af36b322d5647bde27ec2de7ed7b022 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 4 Apr 2017 21:16:11 +0200
Subject: [PATCH 0041/1374] util.FindBug

---
 udapi/block/util/findbug.py | 60 +++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 udapi/block/util/findbug.py

diff --git a/udapi/block/util/findbug.py b/udapi/block/util/findbug.py
new file mode 100644
index 00000000..d01221b7
--- /dev/null
+++ b/udapi/block/util/findbug.py
@@ -0,0 +1,60 @@
+"""Block util.FindBug for debugging.
+
+Usage:
+If block xy.Z fails with a Python exception,
+insert "util.FindBug block=" into the scenario,
+e.g. to debug ``second.Block``, use
+
+udapy first.Block util.FindBug block=second.Block > bug.conllu
+
+This will create the file bug.conllu with the bundle, which caused the bug.
+"""
+import copy
+import logging
+
+from udapi.core.basewriter import BaseWriter
+from udapi.block.write.conllu import Conllu
+from udapi.core.run import _parse_block_name
+
+class FindBug(BaseWriter):
+    """Debug another block by finding a minimal testcase conllu file."""
+
+    def __init__(self, block, first_error_only=True, **kwargs):
+        """Args: block, first_error_only"""
+        super().__init__(**kwargs)
+        self.block = block
+        self.first_error_only = first_error_only
+
+    def process_document(self, document):
+        sub_path, class_name = _parse_block_name(self.block)
+        module = "udapi.block." + sub_path + "." + class_name.lower()
+        try:
+            command = "from " + module + " import " + class_name + " as b"
+            logging.debug("Trying to run command: %s", command)
+            exec(command) # pylint: disable=exec-used
+        except Exception:
+            logging.warning("Error when trying import the block %s", self.block)
+            raise
+
+        command = "b()" # TODO params as kwargs
+        logging.debug("Trying to evaluate this: %s", command)
+        new_block = eval(command) # pylint: disable=eval-used
+
+        doc_copy = copy.deepcopy(document)
+        writer = Conllu(files=self.orig_files)
+
+        for bundle_no, bundle in enumerate(doc_copy.bundles, 1):
+            logging.debug('Block %s processing bundle #%d (id=%s)',
+                          self.block, bundle_no, bundle.bundle_id)
+            try:
+                new_block.process_bundle(bundle)
+            except Exception as exc: # pylint: disable=broad-except
+                logging.warning('util.FindBug found a problem in bundle %d in block %s: %r',
+                                bundle_no, self.block, exc)
+                logging.warning('Printing a minimal example to %s', self.orig_files)
+
+                for tree in document.bundles[bundle_no-1].trees:
+                    writer.process_tree(tree)
+
+                if self.first_error_only:
+                    raise

From cf35654eee088384f41043c506d2cca1f00fb189 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 4 Apr 2017 23:04:32 +0200
Subject: [PATCH 0042/1374] ud.Google2ud draft of conversion script

---
 udapi/block/ud/google2ud.py             | 93 +++++++++++++++++++++++++
 udapi/block/ud/setspaceafterfromtext.py |  2 +
 2 files changed, 95 insertions(+)
 create mode 100644 udapi/block/ud/google2ud.py

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
new file mode 100644
index 00000000..12081ecc
--- /dev/null
+++ b/udapi/block/ud/google2ud.py
@@ -0,0 +1,93 @@
+"""Block ud.google2ud for converting Google Universal Dependency Treebank into UD.
+
+Usage:
+udapy -s ud.Google2ud ud.SetSpaceAfterFromText ud.Convert1to2 < google.conllu > ud2.conllu
+"""
+from udapi.block.ud.convert1to2 import Convert1to2
+
+DEPREL_CHANGE = {
+    "ROOT": "root",
+    "prep": "case",
+    "p": "punct",
+    "poss": "nmod:poss",
+    "ps": "case",
+    "num": "nummod", # TODO ??
+    "number": "nummod", # TODO ??
+    "tmod": "nmod:tmod",
+    "vmod": "acl",
+    "rcmod": "acl:relcl",
+    "npadvmod": "advmod",
+    "prt": "compound:prt",
+    "preconj": "cc:preconj",
+    "predet": "det:predet",
+    "gmod": "amod",
+    "gobj": "obj",
+}
+
+
+class Google2ud(Convert1to2):
+    """Convert Google Universal Dependency Treebank into UD style."""
+
+    def process_tree(self, root):
+        comment_lines = root.comment.split("\n")
+        root.sent_id = comment_lines[0].strip()
+        root.text = comment_lines[1].strip()
+        root.comment = ''
+
+        for node in root.descendants:
+            self.process_node(node)
+
+        # This needs to be executed after all other deprels are converted
+        for node in root.descendants:
+            if node.deprel in ('acomp', 'attr'): # TODO not sure about attr
+                copula = node.parent
+                node.parent = copula.parent
+                node.deprel = copula.deprel
+                copula.parent = node
+                copula.deprel = 'cop'
+                for child in copula.children:
+                    child.parent = node
+
+    def process_node(self, node):
+        orig_feats = dict(node.feats)
+        node.feats = None
+        for name, value in orig_feats.items():
+            if value != 'false':
+                name = name.split('/')[1].capitalize()
+                node.misc[name] = value.capitalize()
+
+        if node.misc['Proper'] and node.upos == 'NOUN':
+            node.upos = 'PROPN'
+            del node.misc['Proper']
+
+        try:
+            node.deprel = DEPREL_CHANGE[node.deprel]
+        except KeyError:
+            pass
+
+        if node.deprel == 'nn':
+            if node.upos == 'PROPN' and node.parent.upos == 'PROPN':
+                node.deprel = 'flat'
+            else:
+                node.deprel = 'compound'
+        elif node.deprel in ('pobj', 'pcomp'):
+            if node.parent.deprel == 'case':
+                preposition = node.parent
+                node.parent = preposition.parent
+                preposition.parent = node
+                node.deprel = 'nmod' if node.deprel == 'pobj' else 'xcomp' # TODO check xcomp
+                # ud.Convert1to2 will change 'nmod' to 'obl' if needed
+            else:
+                self.log(node, node.deprel, node.deprel + ' but parent.deprel!=case')
+                node.deprel = 'obj'
+        elif node.deprel == 'infmod':
+            node.deprel = 'xcomp'
+            node.feats['VerbForm'] = 'Inf'
+        elif node.deprel == 'partmod':
+            node.deprel = 'ccomp'
+            node.feats['VerbForm'] = 'Part'
+
+        if node.upos == '.':
+            node.upos = 'PUNCT'
+        elif node.upos == 'PRT':
+            node.upos = 'PART'
diff --git a/udapi/block/ud/setspaceafterfromtext.py b/udapi/block/ud/setspaceafterfromtext.py
index 0c4d8d9d..3dcd12f2 100644
--- a/udapi/block/ud/setspaceafterfromtext.py
+++ b/udapi/block/ud/setspaceafterfromtext.py
@@ -14,6 +14,8 @@ class SetSpaceAfterFromText(Block):
 
     def process_tree(self, root):
         text = root.text
+        if text is None:
+            raise ValueError('Tree %s has no text, cannot use ud.SetSpaceAfterFromText' % root)
         computed = root.compute_text()
         if text == computed:
             return

From 7dfdf9bcc629024103b6bd9b2558a7a28783a970 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 5 Apr 2017 15:17:21 +0200
Subject: [PATCH 0043/1374] adapting for other languages

---
 udapi/block/ud/google2ud.py | 109 +++++++++++++++++++++++++++++++-----
 1 file changed, 95 insertions(+), 14 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 12081ecc..ad7e1436 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -1,9 +1,10 @@
 """Block ud.google2ud for converting Google Universal Dependency Treebank into UD.
 
 Usage:
-udapy -s ud.Google2ud ud.SetSpaceAfterFromText ud.Convert1to2 < google.conllu > ud2.conllu
+udapy -s ud.Google2ud < google.conllu > ud2.conllu
 """
 from udapi.block.ud.convert1to2 import Convert1to2
+from udapi.block.ud.setspaceafterfromtext import SetSpaceAfterFromText
 
 DEPREL_CHANGE = {
     "ROOT": "root",
@@ -24,18 +25,62 @@
     "gobj": "obj",
 }
 
+FEATS_CHANGE = {
+    "proper=false": "",
+    "case=prep": "",
+    "gender=unsp_g": "",
+    "voice=unsp_v": "",
+    "number=unsp_n": "",
+    "tense=unsp_t": "",
+    "reciprocity=non-rcp": "",
+    "reciprocity=rcp": "PronType=Rcp",
+    "aspect=imperf": "Aspect=Imp",
+    "form=long": "Variant=Long",
+    "form=short": "Variant=Short",
+    "person=reflex": "Reflex=Yes",
+    "case=reflex": "Reflex=Yes",
+    "gender=pl_tantum": "Number=Ptan",
+    "gender_antecedent=fem_a": "Gender=Fem",
+    "gender_antecedent=masc_a": "Gender=Masc",
+    "gender_antecedent=neut_a": "Gender=Neut",
+    "number_antecedent=sing_a": "Number=Sing",
+    "number_antecedent=plur_a": "Number=Plur",
+    "person_antecedent=1_a": "Person=1",
+    "person_antecedent=2_a": "Person=2",
+    "person_antecedent=3_a": "Person=3",
+    "definiteness=def": "Definite=Def",
+    "definiteness=indef": "Definite=Ind",
+    "mood=sub1": "Mood=Sub", # TODO: what is the difference between sub1 and sub2 in German?
+    "mood=sub2": "Mood=Sub",
+    "tense=cnd": "Mood=Cnd",
+    "degree=sup_a": "Degree=Abs",
+    "degree=sup_r": "Degree=Sup",
+    "case=obl": "Case=Acc",
+}
 
 class Google2ud(Convert1to2):
     """Convert Google Universal Dependency Treebank into UD style."""
 
+    def __init__(self, lang='unk', **kwargs):
+        """Create the Google2ud block instance.
+
+        See ``Convert1to2`` for all the args.
+        """
+        super().__init__(**kwargs)
+        self.lang = lang
+        self._spaceafter_block = SetSpaceAfterFromText()
+
     def process_tree(self, root):
         comment_lines = root.comment.split("\n")
-        root.sent_id = comment_lines[0].strip()
+        root.sent_id = comment_lines[0].strip().replace(' ', '-')
         root.text = comment_lines[1].strip()
         root.comment = ''
 
         for node in root.descendants:
-            self.process_node(node)
+            self.fix_feats(node)
+            self.fix_upos(node)
+            self.fix_deprel(node)
+            #self.fix_quotes(node)
 
         # This needs to be executed after all other deprels are converted
         for node in root.descendants:
@@ -48,18 +93,52 @@ def process_tree(self, root):
                 for child in copula.children:
                     child.parent = node
 
-    def process_node(self, node):
+        # call ud.SetSpaceAfterFromText
+        self._spaceafter_block.process_tree(root)
+
+        # call ud.Convert1to2
+        super().process_tree(root)
+
+    @staticmethod
+    def fix_feats(node):
+        """Remove language prefixes, capitalize names and values, apply FEATS_CHANGE."""
         orig_feats = dict(node.feats)
         node.feats = None
         for name, value in orig_feats.items():
-            if value != 'false':
-                name = name.split('/')[1].capitalize()
-                node.misc[name] = value.capitalize()
+            name = name.split('/')[1]
+            if name == 'inflection_type':
+                node.misc['InflectionType'] = value.capitalize()
+                continue
+            if "antecedent" in name and node.upos == 'PRON':
+                node.feats["PronType"] = "Prs"
+            new = FEATS_CHANGE.get(name + '=' + value)
+            if new is not None:
+                if new != '':
+                    new_name, new_value = new.split('=')
+                    node.feats[new_name] = new_value
+            else:
+                node.feats[name.capitalize()] = value.capitalize()
+
+    def fix_upos(self, node):
+        """PRT→PART, .→PUNCT, NOUN+Proper→PROPN."""
+        if node.upos == '.':
+            node.upos = 'PUNCT'
+        elif node.upos == 'PRT':
+            node.upos = 'PART'
+        if node.feats['Proper']:
+            if node.upos == 'NOUN':
+                node.upos = 'PROPN'
+                if node.feats['Proper'] != 'True':
+                    self.log(node, 'unexpected-proper', 'Proper=' + node.feats['Proper'])
+            else:
+                node.misc['Proper'] = node.feats['Proper']
+            del node.feats['Proper']
 
-        if node.misc['Proper'] and node.upos == 'NOUN':
-            node.upos = 'PROPN'
-            del node.misc['Proper']
+    def fix_deprel(self, node):
+        """Convert Google dependency relations to UD deprels.
 
+        Change topology where needed.
+        """
         try:
             node.deprel = DEPREL_CHANGE[node.deprel]
         except KeyError:
@@ -87,7 +166,9 @@ def process_node(self, node):
             node.deprel = 'ccomp'
             node.feats['VerbForm'] = 'Part'
 
-        if node.upos == '.':
-            node.upos = 'PUNCT'
-        elif node.upos == 'PRT':
-            node.upos = 'PART'
+    def fix_quotes(self, node):
+        """Reconstruct the original quotes."""
+        if node.xpos == '``':
+            node.form = '„' if self.lang == 'de' else '"'
+        elif node.xpos == "''":
+            node.form = '“' if self.lang == 'de' else '"'

From bf81ad21d4bf161806e11eb795a1bf722119940d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 6 Apr 2017 12:28:37 +0200
Subject: [PATCH 0044/1374] node.get_attrs() more powerfull

---
 udapi/core/node.py | 59 +++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 56 insertions(+), 3 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 0d745baa..e717ccbe 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -465,15 +465,68 @@ def is_leaf(self):
         """Is this node a leaf, ie. a node without any children?"""
         return not self.children
 
+    def _get_attr(self, name): # pylint: disable=too-many-return-statements
+        if name == 'dir':
+            if self.parent.is_root():
+                return 'root'
+            return 'left' if self.precedes(self.parent) else 'right'
+        if name == 'edge':
+            if self.parent.is_root():
+                return 0
+            return self.ord - self.parent.ord
+        if name == 'children':
+            return len(self.children)
+        if name == 'siblings':
+            return len(self.parent.children) - 1
+        if name == 'depth':
+            value = 0
+            tmp = self
+            while not tmp.is_root():
+                tmp = tmp.parent
+                value += 1
+            return value
+        if name == 'feats_split':
+            return str(self.feats).split('|')
+        return getattr(self, name)
+
     def get_attrs(self, attrs, undefs=None, stringify=True):
-        """Return multiple attributes, possibly subsitituting empty ones.
+        """Return multiple attributes or pseudo-attributes, possibly substituting empty ones.
+
+        Pseudo-attributes:
+        p_xy is the (pseudo) attribute xy of the parent node.
+        c_xy is a list of the (pseudo) attributes xy of the children nodes.
+        dir: 'left' = the node is a left child of its parent,
+             'right' = the node is a rigth child of its parent,
+             'root' = the node's parent is the technical root.
+        edge: length of the edge to parent (`node.ord - node.parent.ord`) or 0 if parent is root
+        children: number of children nodes.
+        siblings: number of siblings nodes.
+        depth: depth in the dependency tree (technical root has depth=0, highest word has depth=1).
+        feats_split: list of name=value formatted strings of the FEATS.
 
         Args:
-        attrs: A list of attribute names, e.g. ['form', 'lemma'].
+        attrs: A list of attribute names, e.g. ``['form', 'lemma', 'p_upos']``.
         undefs: A value to be used instead of None for empty (undefined) values.
         stringify: Apply `str()` on each value (except for None)
         """
-        values = [getattr(self, name) for name in attrs]
+        values = []
+        for name in attrs:
+            if name.startswith('p_'):
+                if name == 'p_feats_split':
+                    values.extend(self.parent._get_attr(name[2:]))
+                else:
+                    values.append(self.parent._get_attr(name[2:]))
+            elif name.startswith('c_'):
+                for child in self.children:
+                    if name == 'c_feats_split':
+                        values.extend(child._get_attr(name[2:]))
+                    else:
+                        values.append(child._get_attr(name[2:]))
+            elif name == 'feats_split':
+                values.extend(self._get_attr(name))
+            else:
+                values.append(self._get_attr(name))
+
         if undefs is not None:
             values = [x if x is not None else undefs for x in values]
         if stringify:

From 81c0c872d4fe6b96fe23651418fb1a996c3d2d43 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 6 Apr 2017 12:29:53 +0200
Subject: [PATCH 0045/1374] util.See prints useful statistics on matching nodes

---
 udapi/block/util/see.py | 119 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 119 insertions(+)
 create mode 100644 udapi/block/util/see.py

diff --git a/udapi/block/util/see.py b/udapi/block/util/see.py
new file mode 100644
index 00000000..57cdf81c
--- /dev/null
+++ b/udapi/block/util/see.py
@@ -0,0 +1,119 @@
+"""Block util.See prints statistics about the nodes matching a given condition.
+
+Example usage from the command line::
+
+udapy util.See node='node.is_nonprojective()' n=3 \
+ stats=dir,children,c_upos,p_lemma,deprel,feats_split < in.conllu
+
+Example output::
+
+node.is_nonprojective()
+matches 245 out of 35766 nodes (0.7%) in 174 out of 1478 trees (11.8%)
+=== dir (2 values) ===
+          right   193  78% delta=+37%
+           left    52  21% delta=-33%
+=== children (9 values) ===
+              0    64  26% delta=-38%
+              2    58  23% delta=+14%
+              3    38  15% delta= +7%
+=== c_upos (15 values) ===
+           NOUN   118  23% delta= +4%
+            DET    61  12% delta= -3%
+          PROPN    47   9% delta= +1%
+=== p_lemma (187 values) ===
+             il     5   2% delta= +1%
+       fonction     4   1% delta= +1%
+         écrire     4   1% delta= +1%
+=== deprel (22 values) ===
+          appos    41  16% delta=+15%
+           conj    41  16% delta=+13%
+          punct    36  14% delta= +4%
+=== feats_split (20 values) ===
+    Number=Sing   114  21% delta= +2%
+    Gender=Masc    81  15% delta= +3%
+              _    76  14% delta= -6%
+
+In addition to absolute counts for each value, the percentage within matching nodes is printed
+and a delta relative to percentage within all nodes.
+This helps to highlight what is special about the matching nodes.
+"""
+from collections import Counter
+import re # may be useful in eval, thus pylint: disable=unused-import
+
+from udapi.core.block import Block
+
+STATS = 'dir,edge,depth,children,siblings,p_upos,p_lemma,c_upos,form,lemma,upos,deprel,feats_split'
+
+# We need eval in this block
+# pylint: disable=eval-used
+class See(Block):
+    """Print statistics about the nodes specified by the parameter `node`."""
+
+    def __init__(self, node, n=5, stats=STATS, **kwargs):
+        """Args:
+        `node`: Python expression to be evaluated for each node and if True,
+            the node will be considered "matching".
+        `n`: Top n values will be printed for each statistic.
+        `stats`: a list of comma-separated statistics to be printed.
+            A statistic can be an attribute (`form`, `lemma`) or a pseudo-attribute
+            (`depth` = depth of a node in dependency tree,
+            `children` = number of children nodes,
+            `p_lemma` = lemma of a parent node, etc).
+            See `udapi.core.Node.get_attrs` for a full list of statistics.
+        """
+        super().__init__(**kwargs)
+        self.node = node
+        self.n_limit = n
+        self.stats = stats.split(',')
+        self.match = dict()
+        self.every = dict()
+        for stat in self.stats:
+            self.match[stat] = Counter()
+            self.every[stat] = Counter()
+        self.overall = Counter()
+
+    def process_tree(self, root):
+        self.overall['trees'] += 1
+        tree_match = False
+        for node in root.descendants:
+            matching = self.process_node(node)
+            self.overall['nodes'] += 1
+            if matching:
+                self.overall['matching_nodes'] += 1
+                if not tree_match:
+                    self.overall['matching_trees'] += 1
+                    tree_match = True
+
+    def process_node(self, node):
+        matching = eval(self.node)
+        for stat in self.stats:
+            for value in node.get_attrs([stat], undefs=''):
+                self.every[stat][value] += 1
+                self.every[stat]['T O T A L'] += 1
+                if matching:
+                    self.match[stat][value] += 1
+                    self.match[stat]['T O T A L'] += 1
+        return matching
+
+    def process_end(self):
+        print(self.node)
+        print("matches %d out of %d nodes (%.1f%%) in %d out of %d trees (%.1f%%)"
+              % (self.overall['matching_nodes'],
+                 self.overall['nodes'],
+                 self.overall['matching_nodes'] * 100 / self.overall['nodes'],
+                 self.overall['matching_trees'],
+                 self.overall['trees'],
+                 self.overall['matching_trees'] * 100 / self.overall['trees']))
+        for stat in self.stats:
+            vals = len(self.match[stat].keys()) - 1
+            print("=== %s (%d value%s) ===" % (stat, vals, 's' if vals > 1 else ''))
+            match_total = self.match[stat]['T O T A L'] or 1
+            every_total = self.every[stat]['T O T A L'] or 1
+            for value, match_count in self.match[stat].most_common(self.n_limit + 1):
+                if value == 'T O T A L':
+                    continue
+                every_count = self.every[stat][value]
+                match_perc = 100 * match_count / match_total
+                every_perc = 100 * every_count / every_total
+                print("%15s %5d %3d%% delta=%+3d%%"
+                      % (value, match_count, match_perc, match_perc - every_perc))

From 884cf18511f22aefe476d159833c9ae70bb9a2e0 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 6 Apr 2017 12:34:48 +0200
Subject: [PATCH 0046/1374] draft of Indonesian conversion

---
 udapi/block/ud/google2ud.py | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index ad7e1436..95ee5fa2 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -23,6 +23,9 @@
     "predet": "det:predet",
     "gmod": "amod",
     "gobj": "obj",
+    "postneg": "neg", # will be changed to advmod + Polarity=Neg in ud.Convert1to2
+    "pronl": "obj", # TODO: or expl? UD_French seems to use a mix of both
+    "redup": "compound:plur",
 }
 
 FEATS_CHANGE = {
@@ -56,6 +59,7 @@
     "degree=sup_a": "Degree=Abs",
     "degree=sup_r": "Degree=Sup",
     "case=obl": "Case=Acc",
+    "tense=impf": "Tense=Imp",
 }
 
 class Google2ud(Convert1to2):
@@ -134,6 +138,21 @@ def fix_upos(self, node):
                 node.misc['Proper'] = node.feats['Proper']
             del node.feats['Proper']
 
+        # Indonesian uses prefixes (me, di, ber, ke,...) and suffixes (an, kan, i,...),
+        # which are written without spaces with the main word/stem (according to the raw text).
+        # These could be treated as syntactic words and annotated using multi-word tokens.
+        # However, there is no annotation about their dependency relations (just suff, pref)
+        # and UD_Indonesian v2.0 keeps them as one word with the stem. So let's follow this style.
+        if node.upos == 'AFFIX':
+            if node.deprel == 'suff':
+                node.prev_node.form += node.form
+            elif node.deprel == 'pref':
+                node.next_node.form = node.form + node.next_node.form
+            else:
+                self.log(node, 'affix', 'upos=AFFIX deprel=' + node.deprel)
+                return
+            node.remove(children='rehang')
+
     def fix_deprel(self, node):
         """Convert Google dependency relations to UD deprels.
 

From fc46d4e40f3e56d108dea97facfe8fb31be6c9af Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 8 Apr 2017 01:02:05 +0200
Subject: [PATCH 0047/1374] ud.Google2ud update

---
 udapi/block/ud/google2ud.py | 77 +++++++++++++++++++++++++++++--------
 1 file changed, 62 insertions(+), 15 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 95ee5fa2..510c6b2f 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -9,11 +9,12 @@
 DEPREL_CHANGE = {
     "ROOT": "root",
     "prep": "case",
+    "ncomp": "case", # TODO ?
     "p": "punct",
     "poss": "nmod:poss",
     "ps": "case",
-    "num": "nummod", # TODO ??
-    "number": "nummod", # TODO ??
+    "num": "nummod",
+    "number": "nummod", # TODO ?
     "tmod": "nmod:tmod",
     "vmod": "acl",
     "rcmod": "acl:relcl",
@@ -26,15 +27,35 @@
     "postneg": "neg", # will be changed to advmod + Polarity=Neg in ud.Convert1to2
     "pronl": "obj", # TODO: or expl? UD_French seems to use a mix of both
     "redup": "compound:plur",
+    "oblcomp": "obl",
+    "mes": "dep", # TODO ?
+    "mwn": "compound:n", # nominal multi-word
+    "mwa": "compound:a", # adjectival multi-word
+    "mwv": "compound:v", # verbal multi-word
+    "asp": "aux", # aspectual particle
+    "rcmodrel": "mark:relcl",
+    "auxcaus": "aux", # redundant with Voice=Cau
+    "topic": "dep",
+    "possessive": "case",
+    "quantmod": "det", # TODO UD_Hindi uses "dep" for the same words
+    # TODO: "ref" - in basic dependencies it should be rehanged and relabelled
+    "conjv": "compound:conjv",
 }
 
 FEATS_CHANGE = {
     "proper=false": "",
     "case=prep": "",
+    "case=unsp_c": "",
     "gender=unsp_g": "",
+    "gender_antecedent=unsp_g": "",
     "voice=unsp_v": "",
     "number=unsp_n": "",
+    "number_antecedent=unsp_n": "",
     "tense=unsp_t": "",
+    "mood=unsp_m": "",
+    "animacy=unsp_r": "",
+    "aspect=unsp_a": "",
+    "case=rel": "", # redundant with rcmodrel (mark:relcl)
     "reciprocity=non-rcp": "",
     "reciprocity=rcp": "PronType=Rcp",
     "aspect=imperf": "Aspect=Imp",
@@ -42,24 +63,30 @@
     "form=short": "Variant=Short",
     "person=reflex": "Reflex=Yes",
     "case=reflex": "Reflex=Yes",
+    "case=dir": "Case=Nom",
     "gender=pl_tantum": "Number=Ptan",
-    "gender_antecedent=fem_a": "Gender=Fem",
-    "gender_antecedent=masc_a": "Gender=Masc",
-    "gender_antecedent=neut_a": "Gender=Neut",
-    "number_antecedent=sing_a": "Number=Sing",
-    "number_antecedent=plur_a": "Number=Plur",
-    "person_antecedent=1_a": "Person=1",
-    "person_antecedent=2_a": "Person=2",
-    "person_antecedent=3_a": "Person=3",
+    "gender_antecedent=fem_a": "Gender[psor]=Fem",
+    "gender_antecedent=masc_a": "Gender[psor]=Masc",
+    "gender_antecedent=neut_a": "Gender[psor]=Neut",
+    "number_antecedent=sing_a": "Number[psor]=Sing",
+    "number_antecedent=plur_a": "Number[psor]=Plur",
+    "person_antecedent=1_a": "Person[psor]=1",
+    "person_antecedent=2_a": "Person[psor]=2",
+    "person_antecedent=3_a": "Person[psor]=3",
     "definiteness=def": "Definite=Def",
     "definiteness=indef": "Definite=Ind",
     "mood=sub1": "Mood=Sub", # TODO: what is the difference between sub1 and sub2 in German?
     "mood=sub2": "Mood=Sub",
+    "mood=inter": "PronType=Int", # TODO or keep Mood=Inter (it is used in UD_Chinese)
     "tense=cnd": "Mood=Cnd",
     "degree=sup_a": "Degree=Abs",
     "degree=sup_r": "Degree=Sup",
     "case=obl": "Case=Acc",
     "tense=impf": "Tense=Imp",
+    "animacy=rat": "Animacy=Hum",
+    "animacy=irrat": "Animacy=Nhum",
+    "honorific=hon": "Polite=Form",
+    "mood=psm": "Tense=Fut", # TODO ?
 }
 
 class Google2ud(Convert1to2):
@@ -108,7 +135,7 @@ def fix_feats(node):
         """Remove language prefixes, capitalize names and values, apply FEATS_CHANGE."""
         orig_feats = dict(node.feats)
         node.feats = None
-        for name, value in orig_feats.items():
+        for name, value in sorted(orig_feats.items()):
             name = name.split('/')[1]
             if name == 'inflection_type':
                 node.misc['InflectionType'] = value.capitalize()
@@ -143,15 +170,18 @@ def fix_upos(self, node):
         # These could be treated as syntactic words and annotated using multi-word tokens.
         # However, there is no annotation about their dependency relations (just suff, pref)
         # and UD_Indonesian v2.0 keeps them as one word with the stem. So let's follow this style.
+        # Chinese AFFIXes are more tricky to convert.
+        # It seems these words are quite often tagged as PART in UD_Chinese.
         if node.upos == 'AFFIX':
             if node.deprel == 'suff':
                 node.prev_node.form += node.form
+                node.remove(children='rehang')
             elif node.deprel == 'pref':
                 node.next_node.form = node.form + node.next_node.form
+                node.remove(children='rehang')
             else:
                 self.log(node, 'affix', 'upos=AFFIX deprel=' + node.deprel)
-                return
-            node.remove(children='rehang')
+                node.upos = 'PART'
 
     def fix_deprel(self, node):
         """Convert Google dependency relations to UD deprels.
@@ -169,12 +199,26 @@ def fix_deprel(self, node):
             else:
                 node.deprel = 'compound'
         elif node.deprel in ('pobj', 'pcomp'):
-            if node.parent.deprel == 'case':
+            if node.parent.deprel in ('case', 'prep'):
                 preposition = node.parent
                 node.parent = preposition.parent
                 preposition.parent = node
-                node.deprel = 'nmod' if node.deprel == 'pobj' else 'xcomp' # TODO check xcomp
+
                 # ud.Convert1to2 will change 'nmod' to 'obl' if needed
+                node.deprel = 'nmod' if node.deprel == 'pobj' else 'xcomp' # TODO check xcomp
+
+                # Prepositions should not have any children (except for deprel=fixed/mwe), see
+                # http://universaldependencies.org/u/overview/syntax.html#multiword-function-words.
+                # Unfortunatelly, there are many annotation errors and it is almost always better
+                # to rehang the extra children (at least to prevent spurious non-projectivities).
+                # In case of PUNCTuation it is surely correct.
+                # Otherwise, let's mark it as ToDo.
+                for extra_prep_child in preposition.children:
+                    if extra_prep_child.udeprel in ('fixed', 'mwe'):
+                        continue
+                    extra_prep_child.parent = node
+                    if extra_prep_child.upos != 'PUNCT':
+                        self.log(extra_prep_child, 'ex-adp-child', 'was an extra adposition child')
             else:
                 self.log(node, node.deprel, node.deprel + ' but parent.deprel!=case')
                 node.deprel = 'obj'
@@ -184,6 +228,9 @@ def fix_deprel(self, node):
         elif node.deprel == 'partmod':
             node.deprel = 'ccomp'
             node.feats['VerbForm'] = 'Part'
+        elif node.deprel == 'suff':
+            node.misc['OrigDeprel'] = 'suff'
+            node.deprel = 'dep'
 
     def fix_quotes(self, node):
         """Reconstruct the original quotes."""

From 2530a11fd75454ec67565701e9564b2fa242baf9 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 8 Apr 2017 18:00:35 +0200
Subject: [PATCH 0048/1374] autopep8

---
 udapi/block/demo/rehangprepositions.py  |  1 +
 udapi/block/eval/f1.py                  | 24 ++++++++-------
 udapi/block/eval/parsing.py             |  1 +
 udapi/block/read/addsentences.py        |  2 ++
 udapi/block/read/conllu.py              |  6 ++--
 udapi/block/read/vislcg.py              |  3 +-
 udapi/block/tokenize/onwhitespace.py    |  1 +
 udapi/block/tokenize/simple.py          |  1 +
 udapi/block/transform/deproj.py         |  3 +-
 udapi/block/transform/proj.py           |  1 +
 udapi/block/tutorial/addcommas.py       |  5 ++--
 udapi/block/tutorial/adpositions.py     |  1 +
 udapi/block/ud/addmwt.py                |  3 +-
 udapi/block/ud/bg/removedotafterabbr.py |  1 +
 udapi/block/ud/convert1to2.py           |  5 ++--
 udapi/block/ud/cs/addmwt.py             |  1 +
 udapi/block/ud/el/addmwt.py             |  5 ++--
 udapi/block/ud/fixpunctchild.py         |  1 +
 udapi/block/ud/ga/to2.py                |  1 +
 udapi/block/ud/gl/to2.py                |  1 +
 udapi/block/ud/goeswithfromtext.py      |  3 +-
 udapi/block/ud/google2ud.py             | 40 ++++++++++++++-----------
 udapi/block/ud/he/fixneg.py             |  1 +
 udapi/block/ud/markbugs.py              |  1 +
 udapi/block/ud/removemwt.py             |  3 +-
 udapi/block/ud/ro/fixneg.py             |  3 +-
 udapi/block/ud/ro/setspaceafter.py      |  3 +-
 udapi/block/ud/ru/fixremnant.py         |  1 +
 udapi/block/ud/setspaceafter.py         |  5 ++--
 udapi/block/ud/setspaceafterfromtext.py |  1 +
 udapi/block/ud/splitunderscoretokens.py |  1 +
 udapi/block/udpipe/base.py              |  1 +
 udapi/block/util/eval.py                |  8 +++--
 udapi/block/util/filter.py              |  9 +++---
 udapi/block/util/findbug.py             | 11 +++----
 udapi/block/util/mark.py                |  5 +++-
 udapi/block/util/see.py                 |  4 ++-
 udapi/block/util/wc.py                  |  1 +
 udapi/block/write/conllu.py             |  2 +-
 udapi/block/write/html.py               |  5 ++--
 udapi/block/write/textmodetrees.py      | 10 ++++---
 udapi/block/write/textmodetreeshtml.py  |  7 +++--
 udapi/block/write/tikz.py               |  2 +-
 udapi/block/write/vislcg.py             |  1 +
 udapi/core/basereader.py                |  3 +-
 udapi/core/basewriter.py                |  1 +
 udapi/core/bundle.py                    |  2 +-
 udapi/core/dualdict.py                  |  1 +
 udapi/core/feats.py                     |  1 +
 udapi/core/files.py                     |  3 +-
 udapi/core/mwt.py                       |  4 +--
 udapi/core/node.py                      | 38 ++++++++++++-----------
 udapi/core/root.py                      |  3 +-
 udapi/core/run.py                       | 10 ++++---
 udapi/core/tests/test_node.py           |  4 +--
 udapi/tool/udpipe.py                    | 13 ++++----
 56 files changed, 170 insertions(+), 108 deletions(-)

diff --git a/udapi/block/demo/rehangprepositions.py b/udapi/block/demo/rehangprepositions.py
index 8d641b49..d25e29bc 100644
--- a/udapi/block/demo/rehangprepositions.py
+++ b/udapi/block/demo/rehangprepositions.py
@@ -4,6 +4,7 @@
 
 class RehangPrepositions(Block):
     """This block takes all prepositions (upos=ADP) and rehangs them above their parent."""
+
     def process_node(self, node):
         if node.upos == "ADP":
             origparent = node.parent
diff --git a/udapi/block/eval/f1.py b/udapi/block/eval/f1.py
index 90be94ec..a4f93a1b 100644
--- a/udapi/block/eval/f1.py
+++ b/udapi/block/eval/f1.py
@@ -56,6 +56,8 @@
 from udapi.core.basewriter import BaseWriter
 
 # pylint: disable=too-many-instance-attributes,invalid-name
+
+
 class F1(BaseWriter):
     """Evaluate differences between sentences (in different zones) with P/R/F1.
 
@@ -156,17 +158,17 @@ def process_end(self):
                 _f1 = 2 * _prec * _rec / ((_prec + _rec) or 1)
                 print('%-10s %5d %5d %5d %6.2f%% %6.2f%% %6.2f%%'
                       % (token, self._pred[token], self._gold[token], self._common[token],
-                         100*_prec, 100*_rec, 100*_f1))
+                         100 * _prec, 100 * _rec, 100 * _f1))
             print('=== Totals ===')
 
-        print("%-9s = %7d\n"*3
+        print("%-9s = %7d\n" * 3
               % ('predicted', self.pred, 'gold', self.gold, 'correct', self.correct), end='')
-        pred, gold = self.pred or 1, self.gold or 1 # prevent division by zero
+        pred, gold = self.pred or 1, self.gold or 1  # prevent division by zero
         precision = self.correct / pred
         recall = self.correct / gold
         f1 = 2 * precision * recall / ((precision + recall) or 1)
         print("%-9s = %6.2f%%\n" * 3
-              % ('precision', 100*precision, 'recall', 100*recall, 'F1', 100*f1), end='')
+              % ('precision', 100 * precision, 'recall', 100 * recall, 'F1', 100 * f1), end='')
 
 
 # difflib.SequenceMatcher does not compute LCS, so let's implement it here
@@ -175,16 +177,16 @@ def find_lcs(x, y):
     """Find longest common subsequence."""
     m, n = len(x), len(y)
     C = [[0] * (n + 1) for _ in range(m + 1)]
-    for i in range(1, m+1):
-        for j in range(1, n+1):
-            C[i][j] = C[i-1][j-1] + 1 if x[i-1] == y[j-1] else max(C[i][j-1], C[i-1][j])
+    for i in range(1, m + 1):
+        for j in range(1, n + 1):
+            C[i][j] = C[i - 1][j - 1] + 1 if x[i - 1] == y[j - 1] else max(C[i][j - 1], C[i - 1][j])
     index = C[m][n]
     lcs = [None] * index
     while m > 0 and n > 0:
-        if x[m-1] == y[n-1]:
-            lcs[index-1] = x[m-1]
-            m, n, index = m-1, n-1, index-1
-        elif C[m-1][n] > C[m][n-1]:
+        if x[m - 1] == y[n - 1]:
+            lcs[index - 1] = x[m - 1]
+            m, n, index = m - 1, n - 1, index - 1
+        elif C[m - 1][n] > C[m][n - 1]:
             m -= 1
         else:
             n -= 1
diff --git a/udapi/block/eval/parsing.py b/udapi/block/eval/parsing.py
index 3c7f5da8..86d7b089 100644
--- a/udapi/block/eval/parsing.py
+++ b/udapi/block/eval/parsing.py
@@ -1,6 +1,7 @@
 """Block eval.Parsing for evaluating UAS and LAS - gold and pred must have the same tokens."""
 from udapi.core.basewriter import BaseWriter
 
+
 class Parsing(BaseWriter):
     """Evaluate labeled and unlabeled attachment score (LAS and UAS)."""
 
diff --git a/udapi/block/read/addsentences.py b/udapi/block/read/addsentences.py
index 67c79ee8..f7f8d764 100644
--- a/udapi/block/read/addsentences.py
+++ b/udapi/block/read/addsentences.py
@@ -3,6 +3,8 @@
 
 # pylint: disable=abstract-method
 # read_tree() does not need to be installed here
+
+
 class AddSentences(BaseReader):
     """A reader for adding plain-text sentences (one sentence per line) files.
 
diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 79ccfaea..ba10d163 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -12,6 +12,7 @@
 RE_TEXT = re.compile(r'^# text\s*=\s*(.+)')
 RE_NEWPARDOC = re.compile(r'^# (newpar|newdoc) (?:\s*id\s*=\s*(.+))?')
 
+
 class Conllu(BaseReader):
     """A reader of the CoNLL-U files."""
 
@@ -49,7 +50,6 @@ def __init__(self, strict=False, separator='tab',
         self.strict = strict
         self.separator = separator
 
-
     @staticmethod
     def parse_comment_line(line, root):
         """Parse one line of CoNLL-U and fill sent_id, text, newpar, newdoc in root."""
@@ -112,7 +112,7 @@ def read_tree(self, document=None):
                     empty = root.create_empty_child(form=fields[1], lemma=fields[2], upos=fields[3],
                                                     xpos=fields[4], feats=fields[5], misc=fields[9])
                     empty.ord = fields[0]
-                    empty.raw_deps = fields[8] # TODO
+                    empty.raw_deps = fields[8]  # TODO
                     continue
 
                 node = root.create_child()
@@ -163,7 +163,7 @@ def read_tree(self, document=None):
         # Create multi-word tokens.
         for fields in mwts:
             range_start, range_end = fields[0].split('-')
-            words = nodes[int(range_start):int(range_end)+1]
+            words = nodes[int(range_start):int(range_end) + 1]
             root.create_multiword_token(words, form=fields[1], misc=fields[-1])
 
         return root
diff --git a/udapi/block/read/vislcg.py b/udapi/block/read/vislcg.py
index 26b3d787..9ad272e3 100644
--- a/udapi/block/read/vislcg.py
+++ b/udapi/block/read/vislcg.py
@@ -2,6 +2,7 @@
 from udapi.core.basereader import BaseReader
 from udapi.core.root import Root
 
+
 class Vislcg(BaseReader):
     """A reader of the VISL-cg format, suitable for VISL Constraint Grammer Parser."""
 
@@ -67,7 +68,7 @@ def _node(line, root):
         # Let's hope that xpos, feats and deprel do not contain any quotes.
         end_quote_pos = line.rfind('"')
         lemma = line[1:end_quote_pos]
-        fields = line[end_quote_pos+1:].split()
+        fields = line[end_quote_pos + 1:].split()
         xpos = fields[0]
         feats_list = fields[3:-2]
         feats = '|'.join(feats_list) if feats_list else '_'
diff --git a/udapi/block/tokenize/onwhitespace.py b/udapi/block/tokenize/onwhitespace.py
index 544c4da6..5451b3a1 100644
--- a/udapi/block/tokenize/onwhitespace.py
+++ b/udapi/block/tokenize/onwhitespace.py
@@ -1,6 +1,7 @@
 """Block tokenize.OnWhitespace"""
 from udapi.core.block import Block
 
+
 class OnWhitespace(Block):
     """"Base tokenizer, splits on whitespaces, fills SpaceAfter=No."""
 
diff --git a/udapi/block/tokenize/simple.py b/udapi/block/tokenize/simple.py
index 82403cee..f7010d13 100644
--- a/udapi/block/tokenize/simple.py
+++ b/udapi/block/tokenize/simple.py
@@ -3,6 +3,7 @@
 
 from udapi.block.tokenize.onwhitespace import OnWhitespace
 
+
 class Simple(OnWhitespace):
     """Simple tokenizer, splits on whitespaces and punctuation, fills SpaceAfter=No."""
 
diff --git a/udapi/block/transform/deproj.py b/udapi/block/transform/deproj.py
index 3a6dcda5..581f5a6b 100644
--- a/udapi/block/transform/deproj.py
+++ b/udapi/block/transform/deproj.py
@@ -5,6 +5,7 @@
 """
 from udapi.core.block import Block
 
+
 class Deproj(Block):
     """De-projectivize the trees à la Nivre & Nilsson (2005)."""
 
@@ -33,7 +34,7 @@ def process_node(self, node):
             node.parent = reconstructed_parent
 
     def head_strategy(self, node, label):
-        queue = [n for n in node.parent.children if n!=node] # TODO deque
+        queue = [n for n in node.parent.children if n != node]  # TODO deque
         while queue:
             adept = queue.pop(0)
             if adept.udeprel == label:
diff --git a/udapi/block/transform/proj.py b/udapi/block/transform/proj.py
index 6254b917..6e284b4c 100644
--- a/udapi/block/transform/proj.py
+++ b/udapi/block/transform/proj.py
@@ -17,6 +17,7 @@
 """
 from udapi.core.block import Block
 
+
 class Proj(Block):
     """Projectivize the trees à la Nivre & Nilsson (2005)."""
 
diff --git a/udapi/block/tutorial/addcommas.py b/udapi/block/tutorial/addcommas.py
index 8c04e242..ccc26a66 100644
--- a/udapi/block/tutorial/addcommas.py
+++ b/udapi/block/tutorial/addcommas.py
@@ -1,10 +1,11 @@
 """tutorial.AddCommas block template."""
 from udapi.core.block import Block
 
+
 class AddCommas(Block):
     """Heuristically insert nodes for missing commas."""
 
-    def process_node(self, node):      
+    def process_node(self, node):
         if self.should_add_comma_before(node):
             comma = node.create_child(form=',', deprel='punct', upos='PUNCT')
             comma.shift_before_node(node)
@@ -18,5 +19,5 @@ def should_add_comma_before(self, node):
             return True
         if any(n.deprel == 'appos' for n in prev_node.children):
             return True
-        
+
         return False
diff --git a/udapi/block/tutorial/adpositions.py b/udapi/block/tutorial/adpositions.py
index cf2ad514..9c4e131b 100644
--- a/udapi/block/tutorial/adpositions.py
+++ b/udapi/block/tutorial/adpositions.py
@@ -13,6 +13,7 @@
 """
 from udapi.core.block import Block
 
+
 class Adpositions(Block):
     """Compute the number of prepositions and postpositions."""
 
diff --git a/udapi/block/ud/addmwt.py b/udapi/block/ud/addmwt.py
index eab2158b..ffa78bbb 100644
--- a/udapi/block/ud/addmwt.py
+++ b/udapi/block/ud/addmwt.py
@@ -1,6 +1,7 @@
 """Abstract base class ud.AddMwt for heuristic detection of multi-word tokens."""
 from udapi.core.block import Block
 
+
 class AddMwt(Block):
     """Detect and mark MWTs (split them into words and add the words to the tree)."""
 
@@ -24,7 +25,7 @@ def process_node(self, node):
             nodes.append(new_node)
         node.form = forms[main]
         nodes.append(node)
-        for form in forms[main+1:]:
+        for form in forms[main + 1:]:
             new_node = parent.create_child(form=form)
             new_node.shift_after_node(nodes[-1])
             nodes.append(new_node)
diff --git a/udapi/block/ud/bg/removedotafterabbr.py b/udapi/block/ud/bg/removedotafterabbr.py
index d1d94628..a132dad1 100644
--- a/udapi/block/ud/bg/removedotafterabbr.py
+++ b/udapi/block/ud/bg/removedotafterabbr.py
@@ -7,6 +7,7 @@
 """
 from udapi.core.block import Block
 
+
 class RemoveDotAfterAbbr(Block):
     """Block for deleting extra PUNCT nodes after abbreviations.
 
diff --git a/udapi/block/ud/convert1to2.py b/udapi/block/ud/convert1to2.py
index e389e476..53529afb 100644
--- a/udapi/block/ud/convert1to2.py
+++ b/udapi/block/ud/convert1to2.py
@@ -23,9 +23,10 @@
     "csubjpass": "csubj:pass",
     "auxpass": "aux:pass",
     "name": "flat:name",
-    "foreign": "flat", # "flat:foreign" not needed once we have Foreign=Yes in FEATS
+    "foreign": "flat",  # "flat:foreign" not needed once we have Foreign=Yes in FEATS
 }
 
+
 class Convert1to2(Block):
     """Block for converting UD v1 to UD v2."""
 
@@ -45,7 +46,7 @@ def __init__(self, skip='', save_stats=True, **kwargs):
         self.skip = {k for k in skip.split(',')}
         self.save_stats = save_stats
 
-    def process_tree(self, tree): # pylint: disable=too-many-branches
+    def process_tree(self, tree):  # pylint: disable=too-many-branches
         """Apply all the changes on the current tree.
 
         This method is automatically called on each tree by Udapi.
diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 17e0648c..4c203ddc 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -43,6 +43,7 @@
         'shape': 'subtree',
     }
 
+
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
     """Detect and mark MWTs (split them into words and add the words to the tree)."""
 
diff --git a/udapi/block/ud/el/addmwt.py b/udapi/block/ud/el/addmwt.py
index 81a98836..8381c69f 100644
--- a/udapi/block/ud/el/addmwt.py
+++ b/udapi/block/ud/el/addmwt.py
@@ -24,8 +24,9 @@
     v['xpos'] = 'AsPpSp AtDf'
     v['deprel'] = 'case det'
     # The following are the default values
-    #v['main'] = 0 # which of the two words will inherit the original children (if any)
-    #v['shape'] = 'siblings', # the newly created nodes will be siblings
+    # v['main'] = 0 # which of the two words will inherit the original children (if any)
+    # v['shape'] = 'siblings', # the newly created nodes will be siblings
+
 
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
     """Detect and mark MWTs (split them into words and add the words to the tree)."""
diff --git a/udapi/block/ud/fixpunctchild.py b/udapi/block/ud/fixpunctchild.py
index a9f16b8c..07ef3eb3 100644
--- a/udapi/block/ud/fixpunctchild.py
+++ b/udapi/block/ud/fixpunctchild.py
@@ -1,6 +1,7 @@
 """Block ud.FixPunctChild for making sure punctuation nodes have no children."""
 from udapi.core.block import Block
 
+
 class FixPunctChild(Block):
     """Make sure punct nodes have no children by rehanging the children upwards."""
 
diff --git a/udapi/block/ud/ga/to2.py b/udapi/block/ud/ga/to2.py
index 4d8506e1..dbf093a9 100644
--- a/udapi/block/ud/ga/to2.py
+++ b/udapi/block/ud/ga/to2.py
@@ -4,6 +4,7 @@
 """
 from udapi.core.block import Block
 
+
 class To2(Block):
     """Block for fixing the remaining cases (after ud.Convert1to2) in UD_Irish."""
 
diff --git a/udapi/block/ud/gl/to2.py b/udapi/block/ud/gl/to2.py
index f5f0f451..81a17c64 100644
--- a/udapi/block/ud/gl/to2.py
+++ b/udapi/block/ud/gl/to2.py
@@ -12,6 +12,7 @@
     'PUNCT': -10,
 }
 
+
 class To2(Block):
     """Block for fixing the remaining cases (before ud.Convert1to2) in UD_Galician."""
 
diff --git a/udapi/block/ud/goeswithfromtext.py b/udapi/block/ud/goeswithfromtext.py
index 64e1d99f..fe419fa2 100644
--- a/udapi/block/ud/goeswithfromtext.py
+++ b/udapi/block/ud/goeswithfromtext.py
@@ -9,6 +9,7 @@
 
 from udapi.core.block import Block
 
+
 class GoeswithFromText(Block):
     """Block for splitting nodes and attaching via goeswith according to the the sentence text.
 
@@ -96,6 +97,6 @@ def process_tree(self, root):
                 else:
                     last_node.misc['SpaceAfter'] = 'No'
             else:
-                assert False # we have checked the whole sentence already
+                assert False  # we have checked the whole sentence already
         if text:
             logging.warning('Extra text "%s" in tree %s', text, root)
diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 510c6b2f..b082c0af 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -9,12 +9,12 @@
 DEPREL_CHANGE = {
     "ROOT": "root",
     "prep": "case",
-    "ncomp": "case", # TODO ?
+    "ncomp": "case",  # TODO ?
     "p": "punct",
     "poss": "nmod:poss",
     "ps": "case",
     "num": "nummod",
-    "number": "nummod", # TODO ?
+    "number": "nummod",  # TODO ?
     "tmod": "nmod:tmod",
     "vmod": "acl",
     "rcmod": "acl:relcl",
@@ -24,20 +24,20 @@
     "predet": "det:predet",
     "gmod": "amod",
     "gobj": "obj",
-    "postneg": "neg", # will be changed to advmod + Polarity=Neg in ud.Convert1to2
-    "pronl": "obj", # TODO: or expl? UD_French seems to use a mix of both
+    "postneg": "neg",  # will be changed to advmod + Polarity=Neg in ud.Convert1to2
+    "pronl": "obj",  # TODO: or expl? UD_French seems to use a mix of both
     "redup": "compound:plur",
     "oblcomp": "obl",
-    "mes": "dep", # TODO ?
-    "mwn": "compound:n", # nominal multi-word
-    "mwa": "compound:a", # adjectival multi-word
-    "mwv": "compound:v", # verbal multi-word
-    "asp": "aux", # aspectual particle
+    "mes": "dep",  # TODO ?
+    "mwn": "compound:n",  # nominal multi-word
+    "mwa": "compound:a",  # adjectival multi-word
+    "mwv": "compound:v",  # verbal multi-word
+    "asp": "aux",         # aspectual particle
     "rcmodrel": "mark:relcl",
-    "auxcaus": "aux", # redundant with Voice=Cau
+    "auxcaus": "aux",     # redundant with Voice=Cau
     "topic": "dep",
     "possessive": "case",
-    "quantmod": "det", # TODO UD_Hindi uses "dep" for the same words
+    "quantmod": "det",  # TODO UD_Hindi uses "dep" for the same words
     # TODO: "ref" - in basic dependencies it should be rehanged and relabelled
     "conjv": "compound:conjv",
 }
@@ -55,7 +55,7 @@
     "mood=unsp_m": "",
     "animacy=unsp_r": "",
     "aspect=unsp_a": "",
-    "case=rel": "", # redundant with rcmodrel (mark:relcl)
+    "case=rel": "",  # redundant with rcmodrel (mark:relcl)
     "reciprocity=non-rcp": "",
     "reciprocity=rcp": "PronType=Rcp",
     "aspect=imperf": "Aspect=Imp",
@@ -75,9 +75,9 @@
     "person_antecedent=3_a": "Person[psor]=3",
     "definiteness=def": "Definite=Def",
     "definiteness=indef": "Definite=Ind",
-    "mood=sub1": "Mood=Sub", # TODO: what is the difference between sub1 and sub2 in German?
+    "mood=sub1": "Mood=Sub",  # TODO: what is the difference between sub1 and sub2 in German?
     "mood=sub2": "Mood=Sub",
-    "mood=inter": "PronType=Int", # TODO or keep Mood=Inter (it is used in UD_Chinese)
+    "mood=inter": "PronType=Int",  # TODO or keep Mood=Inter (it is used in UD_Chinese)
     "tense=cnd": "Mood=Cnd",
     "degree=sup_a": "Degree=Abs",
     "degree=sup_r": "Degree=Sup",
@@ -86,9 +86,10 @@
     "animacy=rat": "Animacy=Hum",
     "animacy=irrat": "Animacy=Nhum",
     "honorific=hon": "Polite=Form",
-    "mood=psm": "Tense=Fut", # TODO ?
+    "mood=psm": "Tense=Fut",  # TODO ?
 }
 
+
 class Google2ud(Convert1to2):
     """Convert Google Universal Dependency Treebank into UD style."""
 
@@ -111,11 +112,11 @@ def process_tree(self, root):
             self.fix_feats(node)
             self.fix_upos(node)
             self.fix_deprel(node)
-            #self.fix_quotes(node)
+            # self.fix_quotes(node)
 
         # This needs to be executed after all other deprels are converted
         for node in root.descendants:
-            if node.deprel in ('acomp', 'attr'): # TODO not sure about attr
+            if node.deprel in ('acomp', 'attr'):  # TODO not sure about attr
                 copula = node.parent
                 node.parent = copula.parent
                 node.deprel = copula.deprel
@@ -183,6 +184,9 @@ def fix_upos(self, node):
                 self.log(node, 'affix', 'upos=AFFIX deprel=' + node.deprel)
                 node.upos = 'PART'
 
+        if node.upos == 'PUNCT' and node.form in ('$', '£'):
+            node.upos = 'SYM'
+
     def fix_deprel(self, node):
         """Convert Google dependency relations to UD deprels.
 
@@ -205,7 +209,7 @@ def fix_deprel(self, node):
                 preposition.parent = node
 
                 # ud.Convert1to2 will change 'nmod' to 'obl' if needed
-                node.deprel = 'nmod' if node.deprel == 'pobj' else 'xcomp' # TODO check xcomp
+                node.deprel = 'nmod' if node.deprel == 'pobj' else 'xcomp'  # TODO check xcomp
 
                 # Prepositions should not have any children (except for deprel=fixed/mwe), see
                 # http://universaldependencies.org/u/overview/syntax.html#multiword-function-words.
diff --git a/udapi/block/ud/he/fixneg.py b/udapi/block/ud/he/fixneg.py
index 5062854c..15325990 100644
--- a/udapi/block/ud/he/fixneg.py
+++ b/udapi/block/ud/he/fixneg.py
@@ -6,6 +6,7 @@
 
 from udapi.core.block import Block
 
+
 class FixNeg(Block):
     """Block for fixing the remaining cases (after ud.Convert1to2) of deprel=neg in UD_Hebrew."""
 
diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index f785f556..6c63e93f 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -28,6 +28,7 @@
     'VERB': 'VerbForm',
 }
 
+
 class MarkBugs(Block):
     """Block for checking suspicious/wrong constructions in UD v2."""
 
diff --git a/udapi/block/ud/removemwt.py b/udapi/block/ud/removemwt.py
index 462e9fbd..99c37b4d 100644
--- a/udapi/block/ud/removemwt.py
+++ b/udapi/block/ud/removemwt.py
@@ -1,6 +1,7 @@
 """Block ud.RemoveMwt for removing multi-word tokens."""
 from udapi.core.block import Block
 
+
 class RemoveMwt(Block):
     """Substitute MWTs with one word representing the whole MWT."""
 
@@ -26,7 +27,7 @@ def guess_deprel(words):
         """DEPREL of the whole MWT"""
         return words[0].deprel
         # Alternatively, we could define deprel subtypes
-        #return words[0].deprel + ':' + ','.join([w.deprel for w in words[1:]])
+        # return words[0].deprel + ':' + ','.join([w.deprel for w in words[1:]])
 
     @staticmethod
     def guess_feats(words):
diff --git a/udapi/block/ud/ro/fixneg.py b/udapi/block/ud/ro/fixneg.py
index a22131b2..68888aa6 100644
--- a/udapi/block/ud/ro/fixneg.py
+++ b/udapi/block/ud/ro/fixneg.py
@@ -6,13 +6,14 @@
 
 from udapi.core.block import Block
 
+
 class FixNeg(Block):
     """Block for fixing the remaining cases (after ud.Convert1to2) of deprel=neg in UD_Romanian."""
 
     def process_node(self, node):
         if node.deprel == "neg":
             if node.upos == "PRON" and node.form == "ne":
-                node.feats = 'Polarity=Neg' # delete other features
+                node.feats = 'Polarity=Neg'  # delete other features
             elif node.upos != "ADJ":
                 logging.warning("Strange node %s with deprel=neg", node)
             node.upos = "ADV"
diff --git a/udapi/block/ud/ro/setspaceafter.py b/udapi/block/ud/ro/setspaceafter.py
index bc18f364..6c4b27e3 100644
--- a/udapi/block/ud/ro/setspaceafter.py
+++ b/udapi/block/ud/ro/setspaceafter.py
@@ -10,6 +10,7 @@
 
 import udapi.block.ud.setspaceafter
 
+
 class SetSpaceAfter(udapi.block.ud.setspaceafter.SetSpaceAfter):
     """Block for heuristic setting of the SpaceAfter=No MISC attribute in Romanian.
 
@@ -37,7 +38,7 @@ def process_tree(self, root):
 
             # Mark contractions like -i, -și, -l, -urilor, but not negative numbers like -12,3.
             # Store SpaceAfter=No to the previous node.
-            next_form = nodes[i+1].form
+            next_form = nodes[i + 1].form
             if re.match('-.*[^0-9,.]', next_form):
                 self.mark_no_space(node)
 
diff --git a/udapi/block/ud/ru/fixremnant.py b/udapi/block/ud/ru/fixremnant.py
index d94b0e5c..b41431db 100644
--- a/udapi/block/ud/ru/fixremnant.py
+++ b/udapi/block/ud/ru/fixremnant.py
@@ -4,6 +4,7 @@
 """
 from udapi.core.block import Block
 
+
 class FixRemnant(Block):
     """ad-hoc fixing the remaining cases (after ud.Convert1to2) of deprel=remnant in UD_Russian."""
 
diff --git a/udapi/block/ud/setspaceafter.py b/udapi/block/ud/setspaceafter.py
index 00193770..e796bf0d 100644
--- a/udapi/block/ud/setspaceafter.py
+++ b/udapi/block/ud/setspaceafter.py
@@ -9,6 +9,7 @@
 
 from udapi.core.block import Block
 
+
 class SetSpaceAfter(Block):
     """Block for heuristic setting of the SpaceAfter=No MISC attribute."""
 
@@ -40,14 +41,14 @@ def process_tree(self, root):
             not_after += '“'
 
         for i, node in enumerate(nodes[:-1]):
-            next_form = nodes[i+1].form
+            next_form = nodes[i + 1].form
             if node.form in self.not_after or next_form in not_before:
                 self.mark_no_space(node)
             if matching_quotes and node.form == '"':
                 if odd_indexed_quote:
                     self.mark_no_space(node)
                 elif i:
-                    self.mark_no_space(nodes[i-1])
+                    self.mark_no_space(nodes[i - 1])
                 odd_indexed_quote = not odd_indexed_quote
 
         if matching_quotes and nodes[-1].form == '"':
diff --git a/udapi/block/ud/setspaceafterfromtext.py b/udapi/block/ud/setspaceafterfromtext.py
index 3dcd12f2..e3a1f90f 100644
--- a/udapi/block/ud/setspaceafterfromtext.py
+++ b/udapi/block/ud/setspaceafterfromtext.py
@@ -9,6 +9,7 @@
 
 from udapi.core.block import Block
 
+
 class SetSpaceAfterFromText(Block):
     """Block for setting of the SpaceAfter=No MISC attribute according to the sentence text."""
 
diff --git a/udapi/block/ud/splitunderscoretokens.py b/udapi/block/ud/splitunderscoretokens.py
index 25caeb3b..094f181a 100644
--- a/udapi/block/ud/splitunderscoretokens.py
+++ b/udapi/block/ud/splitunderscoretokens.py
@@ -8,6 +8,7 @@
 import logging
 from udapi.core.block import Block
 
+
 class SplitUnderscoreTokens(Block):
     """Block for spliting tokens with underscores and attaching the new nodes using deprel=flat.
 
diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
index d72cbf16..78563abb 100644
--- a/udapi/block/udpipe/base.py
+++ b/udapi/block/udpipe/base.py
@@ -74,6 +74,7 @@
     'vi': 'models/udpipe/2.0/vietnamese-ud-2.0-conll17-170315.udpipe',
 }
 
+
 class Base(Block):
     """Base class for all UDPipe blocks."""
 
diff --git a/udapi/block/util/eval.py b/udapi/block/util/eval.py
index c5fa04f2..9bde12bf 100644
--- a/udapi/block/util/eval.py
+++ b/udapi/block/util/eval.py
@@ -5,10 +5,12 @@
 
 from udapi.core.block import Block
 
-pp = pprint.pprint # pylint: disable=invalid-name
+pp = pprint.pprint  # pylint: disable=invalid-name
 
 # We need exec in this block and the variables this etc. are not unused but provided for the exec
 # pylint: disable=exec-used,unused-variable
+
+
 class Eval(Block):
     r"""Special block for evaluating code given by parameters.
 
@@ -66,7 +68,7 @@ def process_document(self, document):
 
         if self.bundle or self.before_bundle or self.after_bundle or self.tree or self.node:
             for bundle in doc.bundles:
-                #TODO if self._should_process_bundle(bundle):
+                # TODO if self._should_process_bundle(bundle):
                 self.process_bundle(bundle)
 
     def process_bundle(self, bundle):
@@ -83,7 +85,7 @@ def process_bundle(self, bundle):
         if self.tree or self.node:
             trees = bundle.trees
             for tree in trees:
-                #TODO if not self._should_process_tree(tree): continue
+                # TODO if not self._should_process_tree(tree): continue
                 self.process_tree(tree)
 
         if self.after_bundle:
diff --git a/udapi/block/util/filter.py b/udapi/block/util/filter.py
index b812fb64..6d4118d6 100644
--- a/udapi/block/util/filter.py
+++ b/udapi/block/util/filter.py
@@ -1,10 +1,12 @@
 """Filter is a special block for keeping/deleting subtrees specified by parameters."""
-import re # may be useful in eval, thus pylint: disable=unused-import
+import re  # may be useful in eval, thus pylint: disable=unused-import
 
 from udapi.core.block import Block
 
 # We need eval in this block
 # pylint: disable=eval-used
+
+
 class Filter(Block):
     """Special block for keeping/deleting subtrees specified by parameters.
 
@@ -25,8 +27,7 @@ class Filter(Block):
     udapy -s util.Filter delete_subtree='node.deprel == "remnant"' < in > filtered
     """
 
-
-    def __init__(self, # pylint: disable=too-many-arguments
+    def __init__(self,  # pylint: disable=too-many-arguments
                  delete_tree=None, delete_tree_if_node=None, delete_subtree=None,
                  keep_tree=None, keep_tree_if_node=None, keep_subtree=None,
                  mark=None, **kwargs):
@@ -72,7 +73,7 @@ def __init__(self, # pylint: disable=too-many-arguments
         self.keep_subtree = keep_subtree
         self.mark = mark
 
-    def process_tree(self, tree): # pylint: disable=too-many-branches
+    def process_tree(self, tree):  # pylint: disable=too-many-branches
         root = tree
 
         if self.delete_tree is not None:
diff --git a/udapi/block/util/findbug.py b/udapi/block/util/findbug.py
index d01221b7..e05afe76 100644
--- a/udapi/block/util/findbug.py
+++ b/udapi/block/util/findbug.py
@@ -16,6 +16,7 @@
 from udapi.block.write.conllu import Conllu
 from udapi.core.run import _parse_block_name
 
+
 class FindBug(BaseWriter):
     """Debug another block by finding a minimal testcase conllu file."""
 
@@ -31,14 +32,14 @@ def process_document(self, document):
         try:
             command = "from " + module + " import " + class_name + " as b"
             logging.debug("Trying to run command: %s", command)
-            exec(command) # pylint: disable=exec-used
+            exec(command)  # pylint: disable=exec-used
         except Exception:
             logging.warning("Error when trying import the block %s", self.block)
             raise
 
-        command = "b()" # TODO params as kwargs
+        command = "b()"  # TODO params as kwargs
         logging.debug("Trying to evaluate this: %s", command)
-        new_block = eval(command) # pylint: disable=eval-used
+        new_block = eval(command)  # pylint: disable=eval-used
 
         doc_copy = copy.deepcopy(document)
         writer = Conllu(files=self.orig_files)
@@ -48,12 +49,12 @@ def process_document(self, document):
                           self.block, bundle_no, bundle.bundle_id)
             try:
                 new_block.process_bundle(bundle)
-            except Exception as exc: # pylint: disable=broad-except
+            except Exception as exc:  # pylint: disable=broad-except
                 logging.warning('util.FindBug found a problem in bundle %d in block %s: %r',
                                 bundle_no, self.block, exc)
                 logging.warning('Printing a minimal example to %s', self.orig_files)
 
-                for tree in document.bundles[bundle_no-1].trees:
+                for tree in document.bundles[bundle_no - 1].trees:
                     writer.process_tree(tree)
 
                 if self.first_error_only:
diff --git a/udapi/block/util/mark.py b/udapi/block/util/mark.py
index 42052336..02682a92 100644
--- a/udapi/block/util/mark.py
+++ b/udapi/block/util/mark.py
@@ -1,10 +1,12 @@
 """util.Mark is a special block for marking nodes specified by parameters."""
-import re # may be useful in eval, thus pylint: disable=unused-import
+import re  # may be useful in eval, thus pylint: disable=unused-import
 
 from udapi.core.block import Block
 
 # We need eval in this block
 # pylint: disable=eval-used
+
+
 class Mark(Block):
     """Mark nodes specified by parameters.
 
@@ -12,6 +14,7 @@ class Mark(Block):
     # see non-projective trees with non-projective edges highlighted
     udapy -TM util.Mark node='node.is_nonprojective()' < in | less -R
     """
+
     def __init__(self, node, mark=1, **kwargs):
         """Create the Mark block object.
 
diff --git a/udapi/block/util/see.py b/udapi/block/util/see.py
index 57cdf81c..aa7131b7 100644
--- a/udapi/block/util/see.py
+++ b/udapi/block/util/see.py
@@ -38,7 +38,7 @@
 This helps to highlight what is special about the matching nodes.
 """
 from collections import Counter
-import re # may be useful in eval, thus pylint: disable=unused-import
+import re  # may be useful in eval, thus pylint: disable=unused-import
 
 from udapi.core.block import Block
 
@@ -46,6 +46,8 @@
 
 # We need eval in this block
 # pylint: disable=eval-used
+
+
 class See(Block):
     """Print statistics about the nodes specified by the parameter `node`."""
 
diff --git a/udapi/block/util/wc.py b/udapi/block/util/wc.py
index df9db3f4..403daf5f 100644
--- a/udapi/block/util/wc.py
+++ b/udapi/block/util/wc.py
@@ -1,6 +1,7 @@
 """Wc is a special block for printing statistics (word count etc)."""
 from udapi.core.block import Block
 
+
 class Wc(Block):
     """Special block for printing statistics (word count etc)."""
 
diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index 8c65f0fd..6c2dc314 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -15,7 +15,7 @@ def __init__(self, print_sent_id=True, print_text=True, print_empty_trees=True,
         self.node_attributes = ["ord", "form", "lemma", "upos", "xpos",
                                 "feats", "parent", "deprel", "raw_deps", "misc"]
 
-    def process_tree(self, tree): # pylint: disable=too-many-branches
+    def process_tree(self, tree):  # pylint: disable=too-many-branches
         nodes = tree.descendants
 
         # Empty sentences are not allowed in CoNLL-U, so with print_empty_trees==0
diff --git a/udapi/block/write/html.py b/udapi/block/write/html.py
index 85b8dcc9..ec33b0fd 100644
--- a/udapi/block/write/html.py
+++ b/udapi/block/write/html.py
@@ -73,7 +73,7 @@ def process_document(self, doc):
             js_t_v = self.path_to_js + '/js-treex-view.js'
 
         print('<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8">')
-        print('<title>Udapi viewer</title>') # TODO doc.loaded_from
+        print('<title>Udapi viewer</title>')  # TODO doc.loaded_from
         for js_file in (jquery, fsaver, js_t_v):
             print('<script src="%s"></script>' % js_file)
         print('</head>\n<body>')
@@ -134,7 +134,7 @@ def print_node(node):
         multiline_feats = feats.replace('|', r'\n')
         print(',{{"id":{id_node},"parent":{id_parent},"order":{order},{firstson_str}{rbrother_str}'
               '"data":{{"ord":{order},"form":"{form}","lemma":"{lemma}","upos":"{upos}",'
-              '"xpos":"{xpos}","feats":"{feats}","deprel":"{deprel}",' # TODO: deps
+              '"xpos":"{xpos}","feats":"{feats}","deprel":"{deprel}",'  # TODO: deps
               '"misc":"{misc}","id":"{address}"}},'
               '"labels":["{form}","#{{#bb0000}}{upos}","#{{#0000bb}}{deprel}"],'
               '"hint":"lemma={lemma}\\n{multiline_feats}"}}'.format(**locals()))
@@ -151,6 +151,7 @@ def _id(node):
         return 'null'
     return '"n%s"' % node.address().replace('#', '-').replace('/', '-')
 
+
 def _esc(string):
     if string is None:
         string = ''
diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index b5968b3a..d32a5fe1 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -17,6 +17,8 @@
 # Too many instance variables, arguments, branches...
 # I don't see how to fix this while not making the code less readable or more difficult to use.
 # pylint: disable=R0902,R0912,R0913,R0914
+
+
 class TextModeTrees(BaseWriter):
     """An ASCII pretty printer of dependency trees.
 
@@ -181,17 +183,17 @@ def process_tree(self, root):
 
         # Precompute the number of non-projective gaps for each subtree
         if self.minimize_cross:
-            self._gaps = [0,] * (1 + len(root.root.descendants))
+            self._gaps = [0, ] * (1 + len(root.root.descendants))
             self._compute_gaps(root)
 
         # Precompute lines for printing
-        stack = [root,]
+        stack = [root, ]
         while stack:
             node = stack.pop()
             children = node.children(add_self=1)
             min_idx, max_idx = self._index_of[children[0].ord], self._index_of[children[-1].ord]
-            max_length = max([self.lengths[i] for i in range(min_idx, max_idx+1)])
-            for idx in range(min_idx, max_idx+1):
+            max_length = max([self.lengths[i] for i in range(min_idx, max_idx + 1)])
+            for idx in range(min_idx, max_idx + 1):
                 idx_node = allnodes[idx]
                 filler = '─' if self._ends(idx, '─╭╰├╪') else ' '
                 self._add(idx, filler * (max_length - self.lengths[idx]))
diff --git a/udapi/block/write/textmodetreeshtml.py b/udapi/block/write/textmodetreeshtml.py
index 21bd8e92..4da977a5 100644
--- a/udapi/block/write/textmodetreeshtml.py
+++ b/udapi/block/write/textmodetreeshtml.py
@@ -1,5 +1,5 @@
 """An ASCII pretty printer of colored dependency trees in HTML."""
-from html import escape # pylint: disable=no-name-in-module
+from html import escape  # pylint: disable=no-name-in-module
 
 from udapi.block.write.textmodetrees import TextModeTrees
 
@@ -15,6 +15,7 @@
   mark {box-shadow: 0px 0px 0px 1px red; font-weight: bold;}
 '''
 
+
 class TextModeTreesHtml(TextModeTrees):
     """An ASCII pretty printer of colored dependency trees in HTML.
 
@@ -41,7 +42,8 @@ def __init__(self, color=True, title='Udapi visualization', **kwargs):
     def before_process_document(self, document):
         # TextModeTrees.before_process_document changes the color property,
         # we need to skip this, but call BaseWriter's method which redirects stdout.
-        super(TextModeTrees, self).before_process_document(document) #pylint: disable=bad-super-call
+        super(TextModeTrees, self).before_process_document(
+            document)  # pylint: disable=bad-super-call
         print('<!DOCTYPE html>\n<html>\n<head>\n<meta charset="utf-8">')
         print('<title>' + self.title + '</title>')
         print('<style>' + STYLE)
@@ -50,7 +52,6 @@ def before_process_document(self, document):
             for key, value in sorted(document.meta.items()):
                 print('%s = %s' % (key, value))
 
-
     def after_process_document(self, document):
         super().after_process_document(document)
         print("</pre>\n</body>\n</html>")
diff --git a/udapi/block/write/tikz.py b/udapi/block/write/tikz.py
index 7e95454e..19480e23 100644
--- a/udapi/block/write/tikz.py
+++ b/udapi/block/write/tikz.py
@@ -97,4 +97,4 @@ def process_tree(self, tree):
             else:
                 print(r'\depedge{%d}{%d}{%s}' % (node.parent.ord, node.ord, node.deprel))
         print(r'\end{dependency}')
-        print('') # empty line marks a new paragraph in LaTeX
+        print('')  # empty line marks a new paragraph in LaTeX
diff --git a/udapi/block/write/vislcg.py b/udapi/block/write/vislcg.py
index 5dd5f52b..569b1056 100644
--- a/udapi/block/write/vislcg.py
+++ b/udapi/block/write/vislcg.py
@@ -13,6 +13,7 @@
     '|': '§verbar.',
 }
 
+
 class Vislcg(BaseWriter):
     """A writer of files in the VISL-cg format, suitable for VISL Constraint Grammer Parser.
 
diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index f9e22fbb..b4913df6 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -6,6 +6,8 @@
 from udapi.core.files import Files
 
 # pylint: disable=too-many-instance-attributes
+
+
 class BaseReader(Block):
     """Base class for all reader blocks."""
 
@@ -65,7 +67,6 @@ def read_tree(self, document=None):
         """
         raise NotImplementedError("Class %s doesn't implement read_tree" % self.__class__.__name__)
 
-
     def filtered_read_tree(self, document=None):
         """Load and return one more tree matching the `sent_id_filter`.
 
diff --git a/udapi/core/basewriter.py b/udapi/core/basewriter.py
index 8f52ec0c..36edd1aa 100644
--- a/udapi/core/basewriter.py
+++ b/udapi/core/basewriter.py
@@ -5,6 +5,7 @@
 from udapi.core.block import Block
 from udapi.core.files import Files
 
+
 class BaseWriter(Block):
     """Base class for all reader blocks."""
 
diff --git a/udapi/core/bundle.py b/udapi/core/bundle.py
index d29b2268..ad243b72 100644
--- a/udapi/core/bundle.py
+++ b/udapi/core/bundle.py
@@ -32,7 +32,7 @@ def bundle_id(self):
     def bundle_id(self, bundle_id):
         self._bundle_id = bundle_id
         for tree in self.trees:
-            tree._sent_id = bundle_id + '/' + tree.zone # pylint: disable=protected-access
+            tree._sent_id = bundle_id + '/' + tree.zone  # pylint: disable=protected-access
 
     def __str__(self):
         if self.bundle_id is None:
diff --git a/udapi/core/dualdict.py b/udapi/core/dualdict.py
index edad9c37..a79c0610 100644
--- a/udapi/core/dualdict.py
+++ b/udapi/core/dualdict.py
@@ -2,6 +2,7 @@
 import collections.abc
 import copy
 
+
 class DualDict(collections.abc.MutableMapping):
     """DualDict class serves as dict with lazily synchronized string representation.
 
diff --git a/udapi/core/feats.py b/udapi/core/feats.py
index dd693533..ebac38eb 100644
--- a/udapi/core/feats.py
+++ b/udapi/core/feats.py
@@ -1,6 +1,7 @@
 """Feats class for storing morphological features of nodes in UD trees."""
 import udapi.core.dualdict
 
+
 class Feats(udapi.core.dualdict.DualDict):
     """Feats class for storing morphological features of nodes in UD trees.
 
diff --git a/udapi/core/files.py b/udapi/core/files.py
index acbfa320..29ad60e9 100644
--- a/udapi/core/files.py
+++ b/udapi/core/files.py
@@ -7,6 +7,7 @@
 import gzip
 import lzma
 
+
 class Files(object):
     """Helper class for iterating over filenames.
 
@@ -71,7 +72,7 @@ def _token_to_filenames(token):
                 filenames = [line.rstrip('\n') for line in filelist]
             directory = os.path.dirname(token[1:])
             if directory != '.':
-                filenames = [f if f[0] != '/' else directory+'/'+f for f in filenames]
+                filenames = [f if f[0] != '/' else directory + '/' + f for f in filenames]
         else:
             filenames = token
         return filenames
diff --git a/udapi/core/mwt.py b/udapi/core/mwt.py
index 19bbdbb5..289adcdb 100644
--- a/udapi/core/mwt.py
+++ b/udapi/core/mwt.py
@@ -12,7 +12,7 @@ def __init__(self, words=None, form=None, misc=None, root=None):
         self._misc = DualDict(misc)
         self.root = root
         for word in self.words:
-            word._mwt = self # pylint: disable=W0212
+            word._mwt = self  # pylint: disable=W0212
 
     @property
     def misc(self):
@@ -33,7 +33,7 @@ def ord_range(self):
     def remove(self):
         """Delete this multi-word token (but keep its words)."""
         for word in self.words:
-            word._mwt = None # pylint: disable=W0212
+            word._mwt = None  # pylint: disable=W0212
         self.root.multiword_tokens = [tok for tok in self.root.multiword_tokens if tok != self]
 
     def address(self):
diff --git a/udapi/core/node.py b/udapi/core/node.py
index e717ccbe..b268e081 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -20,6 +20,7 @@
 # The set of public attributes/properties and methods of Node was well-thought.
 # pylint: disable=too-many-instance-attributes,too-many-public-methods
 
+
 class Node(object):
     """Class for representing nodes in Universal Dependency trees.
 
@@ -62,22 +63,22 @@ class Node(object):
     # With Python 3.5 split dict, slots may not be better.
     # TODO: Should not we include __weakref__ in slots?
     __slots__ = [
-        'ord',       # Word-order index of the node (root has 0).
-        'form',      # Word form or punctuation symbol.
-        'lemma',     # Lemma of word form.
-        'upos',      # Universal PoS tag
-        'xpos',      # Language-specific part-of-speech tag; underscore if not available.
-        'deprel',    # UD dependency relation to the HEAD (root iff HEAD = 0).
-        '_misc',     # Any other annotation as udapi.core.dualdict.DualDict object.
-        '_raw_deps', # Enhanced dependencies (head-deprel pairs) in their original CoNLLU format.
-        '_deps',     # Deserialized enhanced dependencies in a list of {parent, deprel} dicts.
-        '_feats',    # Morphological features as udapi.core.feats.Feats object.
-        '_parent',   # Parent node.
-        '_children', # Ord-ordered list of child nodes.
-        '_mwt',      # multi-word token in which this word participates
+        'ord',        # Word-order index of the node (root has 0).
+        'form',       # Word form or punctuation symbol.
+        'lemma',      # Lemma of word form.
+        'upos',       # Universal PoS tag.
+        'xpos',       # Language-specific part-of-speech tag; underscore if not available.
+        'deprel',     # UD dependency relation to the HEAD (root iff HEAD = 0).
+        '_misc',      # Any other annotation as udapi.core.dualdict.DualDict object.
+        '_raw_deps',  # Enhanced dependencies (head-deprel pairs) in their original CoNLLU format.
+        '_deps',      # Deserialized enhanced dependencies in a list of {parent, deprel} dicts.
+        '_feats',     # Morphological features as udapi.core.feats.Feats object.
+        '_parent',    # Parent node.
+        '_children',  # Ord-ordered list of child nodes.
+        '_mwt',       # Multi-word token in which this word participates.
     ]
 
-    def __init__(self, form=None, lemma=None, upos=None, # pylint: disable=too-many-arguments
+    def __init__(self, form=None, lemma=None, upos=None,  # pylint: disable=too-many-arguments
                  xpos=None, feats=None, deprel=None, misc=None):
         """Create a new node and initialize its attributes using the keyword arguments."""
         self.ord = None
@@ -346,8 +347,8 @@ def create_empty_child(self, **kwargs):
         """Create and return a new empty node child of the current node."""
         new_node = Node(**kwargs)
         self.root.empty_nodes.append(new_node)
-        #self.enh_children.append(new_node) TODO
-        #new_node.enh_parents.append(self) TODO
+        # self.enh_children.append(new_node) TODO
+        # new_node.enh_parents.append(self) TODO
         return new_node
 
     # TODO: make private: _unordered_descendants
@@ -465,7 +466,7 @@ def is_leaf(self):
         """Is this node a leaf, ie. a node without any children?"""
         return not self.children
 
-    def _get_attr(self, name): # pylint: disable=too-many-return-statements
+    def _get_attr(self, name):  # pylint: disable=too-many-return-statements
         if name == 'dir':
             if self.parent.is_root():
                 return 'root'
@@ -652,6 +653,7 @@ class ListOfNodes(list):
     nodes = node.children()
     nodes = node.children(add_self=True, following_only=True)
     """
+
     def __init__(self, iterable, origin):
         """Create a new ListOfNodes.
 
@@ -710,7 +712,7 @@ def find_minimal_common_treelet(*args):
     new_nodes = {}
     highest = None
     while len(nodes) > 1:
-        node = nodes.pop(0) # TODO deque
+        node = nodes.pop(0)  # TODO deque
         parent = node.parent
         if parent is None:
             highest = node
diff --git a/udapi/core/root.py b/udapi/core/root.py
index e5435c59..aab361c1 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -8,6 +8,7 @@
 # The set of public attributes/properties and methods of Root was well-thought.
 # pylint: disable=too-many-instance-attributes
 
+
 class Root(Node):
     """Class for representing root nodes (technical roots) in UD trees."""
     __slots__ = ['_sent_id', '_zone', '_bundle', '_descendants', '_mwts',
@@ -35,7 +36,7 @@ def __init__(self, sent_id=None, zone=None, comment='', text=None, newpar=None,
         self._bundle = None
         self._descendants = []
         self._mwts = []
-        self.empty_nodes = [] # TODO: private
+        self.empty_nodes = []  # TODO: private
 
     @property
     def sent_id(self):
diff --git a/udapi/core/run.py b/udapi/core/run.py
index 037ec722..f42f3f9d 100644
--- a/udapi/core/run.py
+++ b/udapi/core/run.py
@@ -23,6 +23,7 @@ def _parse_block_name(block_name):
     # Return a path and the last name as a class name.
     return '.'.join(names[:-1]), names[-1]
 
+
 def _parse_command_line_arguments(scenario):
     """
     Obtain a list of block names and a list of their arguments from the command line arguments list.
@@ -65,6 +66,7 @@ def _parse_command_line_arguments(scenario):
 
     return block_names, block_args
 
+
 def _import_blocks(block_names, block_args):
     """
     Parse block names, import particular packages and call the constructor for each object.
@@ -84,16 +86,16 @@ def _import_blocks(block_names, block_args):
         try:
             command = "from " + module + " import " + class_name + " as b" + str(block_id)
             logging.debug("Trying to run command: %s", command)
-            exec(command) # pylint: disable=exec-used
+            exec(command)  # pylint: disable=exec-used
         except Exception:
             logging.warning("Error when trying import the block %s", block_name)
             raise
 
         # Run the imported module.
-        kwargs = block_args[block_id] # pylint: disable=unused-variable
+        kwargs = block_args[block_id]  # pylint: disable=unused-variable
         command = "b%s(**kwargs)" % block_id
         logging.debug("Trying to evaluate this: %s", command)
-        new_block_instance = eval(command) # pylint: disable=eval-used
+        new_block_instance = eval(command)  # pylint: disable=eval-used
         blocks.append(new_block_instance)
 
     return blocks
@@ -132,7 +134,7 @@ def execute(self):
         readers = []
         for block in blocks:
             try:
-                block.finished # pylint: disable=pointless-statement
+                block.finished  # pylint: disable=pointless-statement
                 readers.append(block)
             except AttributeError:
                 pass
diff --git a/udapi/core/tests/test_node.py b/udapi/core/tests/test_node.py
index b1f86f9f..695bf946 100755
--- a/udapi/core/tests/test_node.py
+++ b/udapi/core/tests/test_node.py
@@ -110,7 +110,7 @@ def test_print_subtree(self):
             root3.print_subtree(color=False, attributes='form', print_sent_id=0, print_text=0)
             self.assertEqual(capture.getvalue(), expected3)
         finally:
-            sys.stdout = sys.__stdout__ # pylint: disable=redefined-variable-type
+            sys.stdout = sys.__stdout__  # pylint: disable=redefined-variable-type
 
     def test_feats(self):
         """Test the morphological featrues."""
@@ -120,7 +120,7 @@ def test_feats(self):
         self.assertEqual(str(node.feats), '_')
         node.feats = None
         self.assertEqual(str(node.feats), '_')
-        node.feats = {} # pylint: disable=redefined-variable-type
+        node.feats = {}  # pylint: disable=redefined-variable-type
         self.assertEqual(str(node.feats), '_')
 
         node.feats = 'Mood=Ind|Person=1|Voice=Act'
diff --git a/udapi/tool/udpipe.py b/udapi/tool/udpipe.py
index 2fdbc337..f388a6f7 100644
--- a/udapi/tool/udpipe.py
+++ b/udapi/tool/udpipe.py
@@ -2,9 +2,10 @@
 import io
 import os
 
-from ufal.udpipe import Model, Pipeline, ProcessingError, Sentence # pylint: disable=no-name-in-module
+from ufal.udpipe import Model, Pipeline, ProcessingError, Sentence  # pylint: disable=no-name-in-module
 from udapi.block.read.conllu import Conllu as ConlluReader
 
+
 class UDPipe:
     '''Wrapper for UDPipe (more pythonic than ufal.udpipe).'''
 
@@ -45,9 +46,9 @@ def tag_parse_tree(self, root):
                 setattr(node, attr, getattr(parsed_node, attr))
 
         # TODO: benchmark which solution is the fastest one. E.g. we could also do
-        #for node, parsed_node in zip(root.descendants, parsed_root.descendants):
+        # for node, parsed_node in zip(root.descendants, parsed_root.descendants):
         #    parsed_node.misc = node.misc
-        ## pylint: disable=protected-access
+        # pylint: disable=protected-access
         #root._children, root._descendants = parsed_root._children, parsed_root._descendants
 
     def tokenize_tag_parse_tree(self, root):
@@ -59,13 +60,13 @@ def tokenize_tag_parse_tree(self, root):
         self.tokenizer.setText(root.text)
         u_sentence = Sentence()
         is_another = self.tokenizer.nextSentence(u_sentence)
-        u_words    = u_sentence.words
-        n_words    = u_words.size() - 1
+        u_words = u_sentence.words
+        n_words = u_words.size() - 1
         if is_another:
             u_sent_cont = Sentence()
             while self.tokenizer.nextSentence(u_sent_cont):
                 n_cont = u_sent_cont.words.size() - 1
-                for i in range(1, n_cont+1):
+                for i in range(1, n_cont + 1):
                     u_w = u_sent_cont.words[i]
                     n_words += 1
                     u_w.id = n_words

From 5678b0eee780ab67e1a74d7dde6381f50077d66a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 12 Apr 2017 23:30:00 +0200
Subject: [PATCH 0049/1374] ud.de.AddMwt for heuristic detection of German
 contractions

---
 udapi/block/ud/de/__init__.py |  0
 udapi/block/ud/de/addmwt.py   | 49 +++++++++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+)
 create mode 100644 udapi/block/ud/de/__init__.py
 create mode 100644 udapi/block/ud/de/addmwt.py

diff --git a/udapi/block/ud/de/__init__.py b/udapi/block/ud/de/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/ud/de/addmwt.py b/udapi/block/ud/de/addmwt.py
new file mode 100644
index 00000000..23ac54f9
--- /dev/null
+++ b/udapi/block/ud/de/addmwt.py
@@ -0,0 +1,49 @@
+"""Block ud.de.AddMwt for heuristic detection of German contractions.
+
+According to the UD guidelines, contractions such as "am" = "an dem"
+should be annotated using multi-word tokens.
+
+Notice that this should be used only for converting existing conllu files.
+Ideally a tokenizer should have already split the MWTs.
+"""
+import udapi.block.ud.addmwt
+
+MWTS = {
+    'am':      {'form': 'an dem', },
+    'ans':     {'form': 'an das', },
+    'aufs':    {'form': 'auf das', },
+    'beim':    {'form': 'bei dem', },
+    'durchs':  {'form': 'durch das', },
+    'fürs':    {'form': 'fürs das', },
+    'hinterm': {'form': 'hinter dem', },
+    'im':      {'form': 'in dem', },
+    'ins':     {'form': 'in das', },
+    'übers':   {'form': 'über das', },
+    'ums':     {'form': 'um das', },
+    'unters':  {'form': 'unter das', },
+    'unterm':  {'form': 'unter dem', },
+    'vom':     {'form': 'von dem', },
+    'vors':    {'form': 'vor das', },
+    'vorm':    {'form': 'vor dem', },
+    'zum':     {'form': 'zu dem', },
+    'zur':     {'form': 'zu der', },
+}
+
+# shared values for all entries in MWTS
+for v in MWTS.values():
+    v['lemma'] = v['form'].split()[0] + ' der'
+    v['upos'] = 'ADP DET'
+    v['xpos'] = 'APPR ART'
+    v['deprel'] = 'case det'
+    v['feats'] = '_ *'
+    # The following are the default values
+    # v['main'] = 0 # which of the two words will inherit the original children (if any)
+    # v['shape'] = 'siblings', # the newly created nodes will be siblings
+
+
+class AddMwt(udapi.block.ud.addmwt.AddMwt):
+    """Detect and mark MWTs (split them into words and add the words to the tree)."""
+
+    def multiword_analysis(self, node):
+        """Return a dict with MWT info or None if `node` does not represent a multiword token."""
+        return MWTS.get(node.form.lower(), None)

From 1aa1ee6fbc5c1bbd39fad41206c777661db7fb09 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 13 Apr 2017 00:58:45 +0200
Subject: [PATCH 0050/1374] use ud.de.AddMwt in ud.Google2ud

---
 udapi/block/ud/google2ud.py | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index b082c0af..23efab75 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -5,6 +5,7 @@
 """
 from udapi.block.ud.convert1to2 import Convert1to2
 from udapi.block.ud.setspaceafterfromtext import SetSpaceAfterFromText
+from udapi.block.ud.de.addmwt import AddMwt as de_AddMwt
 
 DEPREL_CHANGE = {
     "ROOT": "root",
@@ -101,6 +102,9 @@ def __init__(self, lang='unk', **kwargs):
         super().__init__(**kwargs)
         self.lang = lang
         self._spaceafter_block = SetSpaceAfterFromText()
+        self._addmwt_block = None
+        if lang == 'de':
+            self._addmwt_block = de_AddMwt()
 
     def process_tree(self, root):
         comment_lines = root.comment.split("\n")
@@ -108,11 +112,14 @@ def process_tree(self, root):
         root.text = comment_lines[1].strip()
         root.comment = ''
 
+        # In German: "im" -> "in dem" etc.
+        if self._addmwt_block:
+            self._addmwt_block.process_tree(root)
+
         for node in root.descendants:
             self.fix_feats(node)
             self.fix_upos(node)
             self.fix_deprel(node)
-            # self.fix_quotes(node)
 
         # This needs to be executed after all other deprels are converted
         for node in root.descendants:
@@ -235,10 +242,3 @@ def fix_deprel(self, node):
         elif node.deprel == 'suff':
             node.misc['OrigDeprel'] = 'suff'
             node.deprel = 'dep'
-
-    def fix_quotes(self, node):
-        """Reconstruct the original quotes."""
-        if node.xpos == '``':
-            node.form = '„' if self.lang == 'de' else '"'
-        elif node.xpos == "''":
-            node.form = '“' if self.lang == 'de' else '"'

From a242271537311c21414303928c89f79b99e420cf Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 13 Apr 2017 11:55:53 +0200
Subject: [PATCH 0051/1374] updates for ja, ko, tr

---
 udapi/block/ud/convert1to2.py |  2 +-
 udapi/block/ud/google2ud.py   | 17 ++++++++++++++++-
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/convert1to2.py b/udapi/block/ud/convert1to2.py
index 53529afb..fa46960d 100644
--- a/udapi/block/ud/convert1to2.py
+++ b/udapi/block/ud/convert1to2.py
@@ -146,7 +146,7 @@ def change_neg(self, node):
             if 'Neg' not in node.feats['PronType']:
                 node.feats['Polarity'] = 'Neg'
 
-            if node.upos in ['ADV', 'PART']:
+            if node.upos in ['ADV', 'PART', 'AUX']:
                 node.deprel = 'advmod'
             elif node.upos == 'DET':
                 node.deprel = 'det'
diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 23efab75..1e2ca83b 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -41,6 +41,8 @@
     "quantmod": "det",  # TODO UD_Hindi uses "dep" for the same words
     # TODO: "ref" - in basic dependencies it should be rehanged and relabelled
     "conjv": "compound:conjv",
+    "advphmod": "advmod",
+    "clas": "clf",
 }
 
 FEATS_CHANGE = {
@@ -88,6 +90,13 @@
     "animacy=irrat": "Animacy=Nhum",
     "honorific=hon": "Polite=Form",
     "mood=psm": "Tense=Fut",  # TODO ?
+    "form=fin": "VerbForm=Fin",
+    "form=ger": "VerbForm=Ger",
+    #"form=irr": "VerbForm=?",
+    #"form=adn": "VerbForm=?",
+    "formality=fml": "Polite=Form",
+    "Evidentiality=Nfh": "Evident=Nfh",
+    "Evidentiality=Fh": "Evident=Fh",
 }
 
 
@@ -155,11 +164,13 @@ def fix_feats(node):
                 if new != '':
                     new_name, new_value = new.split('=')
                     node.feats[new_name] = new_value
+            elif name[0].isupper():
+                node.feats[name] = value
             else:
                 node.feats[name.capitalize()] = value.capitalize()
 
     def fix_upos(self, node):
-        """PRT→PART, .→PUNCT, NOUN+Proper→PROPN."""
+        """PRT→PART, .→PUNCT, NOUN+Proper→PROPN, VERB+neg→AUX."""
         if node.upos == '.':
             node.upos = 'PUNCT'
         elif node.upos == 'PRT':
@@ -173,6 +184,10 @@ def fix_upos(self, node):
                 node.misc['Proper'] = node.feats['Proper']
             del node.feats['Proper']
 
+        # Japanese uses negators with deprel=neg, which should be changed to advmod in Convert1to2.
+        if node.upos == "VERB" and node.deprel == "neg":
+            node.upos = "AUX"
+
         # Indonesian uses prefixes (me, di, ber, ke,...) and suffixes (an, kan, i,...),
         # which are written without spaces with the main word/stem (according to the raw text).
         # These could be treated as syntactic words and annotated using multi-word tokens.

From e5ba3d9db97dd7153231c70e31cbad46ec81f583 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 17 Apr 2017 00:19:33 +0200
Subject: [PATCH 0052/1374] allow upos=ADV deprel=cc

---
 udapi/block/ud/markbugs.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index 6c63e93f..dc244a79 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -171,7 +171,8 @@ def process_node(self, node):
         #   "cc is the relation between a conjunct and a preceding
         #   [coordinating conjunction](http://universaldependencies.org/u/pos/CCONJ)."
         # No other upos is allowed in the documentation, although e.g. PART is common in the data.
-        if deprel == 'cc' and upos != 'CCONJ':
+        # There are clear cases of adverbs in role of cc (e.g. "respektive" in Swedish and Czech).
+        if deprel == 'cc' and upos not in ('CCONJ', 'ADV'):
             self.log(node, 'cc-upos', "deprel=cc upos!=CCONJ (but %s): " % upos)
 
     def after_process_document(self, document):

From dd787ce6ca09393b45972ecd6719f32156392cef Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 17 Apr 2017 00:30:39 +0200
Subject: [PATCH 0053/1374] ud.ComplyWithText for adapting the nodes to comply
 with the text.

---
 udapi/block/ud/complywithtext.py | 233 +++++++++++++++++++++++++++++++
 1 file changed, 233 insertions(+)
 create mode 100644 udapi/block/ud/complywithtext.py

diff --git a/udapi/block/ud/complywithtext.py b/udapi/block/ud/complywithtext.py
new file mode 100644
index 00000000..38394b59
--- /dev/null
+++ b/udapi/block/ud/complywithtext.py
@@ -0,0 +1,233 @@
+r"""Block ComplyWithText for adapting the nodes to comply with the text.
+
+Implementation design details:
+Most of the inconsistencies between tree tokens and the raw text are simple to solve.
+However, there may be also rare cases when it is not clear how to align the tokens
+with the text. This block tries to solve the general case using several heuristics.
+
+One possible implementation is to find the LCS (longest common subsequence)
+of the raw text and concatenation of tokens' forms.
+However, it is quite difficult to map these character-level diffs to token-level diffs
+(one character-level diff may partially overlap with two tokens).
+
+So this implementation starts with running a LCS-like algorithm (difflib) on a sequence of tokens
+(instead of sequence of characters). Tokens from trees are obtain with `root.token_descendants`
+(these tokens may be standard nodes for syntactic words or multi-word tokens).
+From the raw text (`root.text`), we obtain "tokens" by splitting it on spaces and punctuation
+(or more precisely any non-word character -- ``re.findall(r'\w+|[^\w\s]', string)``).
+This tokenization is just approximate, to increase the chance of 1-1 alignment.
+This heuristics does not work for languages written without spaces (e.g. Chinese, Japanese).
+
+Author: Martin Popel
+"""
+import difflib
+import logging
+import re
+
+from udapi.core.block import Block
+from udapi.core.mwt import MWT
+
+
+class ComplyWithText(Block):
+    """Adapt the nodes to comply with the text."""
+
+    def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, **kwargs):
+        """Args:
+        fix_text - After all heuristics are applied, the token forms may still not match the text.
+                   Should we edit the text to match the token forms (as a last resort)?
+                   Default=True.
+        prefer_mwt - What to do if multiple subsequent nodes correspond to a text written
+                     without spaces and non-word characters (punctuation)?
+                     E.g. if "3pm doesn't" is annotated with four nodes "3 pm does n't".
+                     We can use either SpaceAfter=No, or create a multi-word token (MWT).
+                     Note that if there is space or punctuation, SpaceAfter=No will be used always
+                     (e.g. "3 p.m." annotated with three nodes "3 p. m.").
+                     If the character sequence does not match exactly, MWT will be used always
+                     (e.g. "3pm doesn't" annotated with four nodes "3 p.m. does not").
+                     Thus this parameter influences only the "unclear" cases.
+                     Default=True (i.e. prefer multi-word tokens over SpaceAfter=No).
+        allow_goeswith - If a node corresponds to multiple space-separated strings in text,
+                         which are not allowed as tokens with space, we can either leave this diff
+                         unresolved or create new nodes and join them with the `goeswith` deprel.
+                         Default=True (i.e. add the goeswith nodes if applicable).
+        """
+        super().__init__(**kwargs)
+        self.fix_text = fix_text
+        self.prefer_mwt = prefer_mwt
+        self.allow_goeswith = allow_goeswith
+
+    def process_tree(self, root):
+        text = root.text
+        if text is None:
+            raise ValueError('Tree %s has no text, cannot use ud.ComplyWithText' % root)
+
+        # Normalize the stored text (double space -> single space)
+        # and skip sentences which are already ok.
+        text = ' '.join(text.split())
+        if text == root.compute_text():
+            return
+
+        # To improve the 1-1 alignment, let's tokenize the text on spaces and punctuation.
+        # We need to tokenize the token forms in the exactly same way, e.g. "5-6" -> "5" "-" "6".
+        tree_nodes = root.token_descendants
+        tree_forms = [t.form for t in tree_nodes]
+        text_forms = text.split()
+        tree_split_forms, tree_split_nodes = self.tokenize_list(tree_forms, tree_nodes)
+        text_split_forms, text_split_nodes = self.tokenize_list(text_forms, text_forms)
+
+        # Align. difflib does may not give LCS, but usually it is good enough.
+        matcher = difflib.SequenceMatcher(None, tree_split_forms, text_split_forms, autojunk=False)
+        diffs = list(matcher.get_opcodes())
+
+        # Make sure each diff starts on original token boundary.
+        # If not, merge the diff with the previous diff.
+        # E.g. (equal, ["5"], ["5"]), (replace, ["-","6"], ["–","7"])
+        # is changed into (replace, ["5","-","6"], ["5","–","7"])
+        for i, diff in enumerate(diffs):
+            edit, tree_lo, tree_hi, text_lo, text_hi = diff
+
+            if edit != 'insert' and tree_split_nodes[tree_lo] is None:
+                if edit == 'equal':
+                    while tree_split_nodes[tree_lo] is None and tree_lo < tree_hi:
+                        tree_lo += 1
+                        text_lo += 1
+                    if tree_lo == tree_hi:
+                        diffs[i] = ('ignore', 0, 0, 0, 0)
+                    else:
+                        diffs[i] = ('equal', tree_lo, tree_hi, text_lo, text_hi)
+                    diffs[i - 1] = ('replace', diffs[i - 1][1], tree_lo, diffs[i - 1][3], text_lo)
+                else:
+                    if diffs[i - 1][0] != 'equal':
+                        diffs[i - 1] = ('replace', diffs[i - 1][1],
+                                        tree_hi, diffs[i - 1][3], text_hi)
+                        diffs[i] = ('ignore', 0, 0, 0, 0)
+                    else:
+                        p_tree_hi = diffs[i - 1][2] - 1
+                        p_text_hi = diffs[i - 1][4] - 1
+                        while tree_split_nodes[p_tree_hi] is None:
+                            p_tree_hi -= 1
+                            p_text_hi -= 1
+                            assert p_tree_hi >= diffs[i - 1][1]
+                            assert p_text_hi >= diffs[i - 1][3]
+                        diffs[i - 1] = ('equal', diffs[i - 1][1], p_tree_hi,
+                                        diffs[i - 1][3], p_text_hi)
+                        diffs[i] = ('replace', p_tree_hi, tree_hi, p_text_hi, text_hi)
+
+        # TODO split diffs if possible, e.g.
+        # ['_', 'atenuación', '_', 'de', 'os'] --> ['_atenuación_', 'dos']
+        # should be divided into two diffs:
+        # ['_', 'atenuación', '_'] --> ['_atenuación_']
+        # ['de', 'os'] --> ['dos']
+        # This would probably need running another SequenceMatcher on characters
+        # and then aligning the tokens/nodes.
+
+        for diff in diffs:
+            edit, tree_lo, tree_hi, text_lo, text_hi = diff
+
+            # Focus only on edits of type 'replace', log insertions and deletions as failures.
+            if edit in ('equal', 'ignore'):
+                continue
+            if edit in ('insert', 'delete'):
+                logging.warning('Unable to solve token-vs-text mismatch\n%s',
+                                self.diff2str(diff, tree_split_forms, text_split_forms))
+                continue
+
+            # Revert the splittng and solve the diff.
+            nodes = [n for n in tree_split_nodes[tree_lo:tree_hi] if n is not None]
+            form = text_split_forms[text_lo]
+            for i in range(text_lo + 1, text_hi):
+                if text_split_nodes[i] is not None:
+                    form += ' '
+                form += text_split_forms[i]
+            self.solve_diff(nodes, form)
+
+        # Fill SpaceAfter=No.
+        tmp_text = text
+        for node in root.token_descendants:
+            if tmp_text.startswith(node.form):
+                tmp_text = tmp_text[len(node.form):]
+                if not tmp_text or tmp_text[0].isspace():
+                    del node.misc['SpaceAfter']
+                    tmp_text = tmp_text.lstrip()
+                else:
+                    node.misc['SpaceAfter'] = 'No'
+            else:
+                logging.warning('Node %s does not match text "%s"', node, tmp_text[:20])
+                return
+
+        # Edit root.text if needed.
+        if self.fix_text:
+            computed_text = root.compute_text()
+            if text != computed_text:
+                root.add_comment('ToDoOrigText = ' + root.text)
+                root.text = computed_text
+
+    def solve_diff(self, nodes, form):
+        """Fix a given (minimal) tokens-vs-text inconsistency."""
+        nodes_str = ' '.join([n.form for n in nodes])
+        node = nodes[0]
+
+        # First, solve the cases when the text contains a space.
+        if ' ' in form:
+            if len(nodes) == 1 and node.form == form.replace(' ', ''):
+                if self.allow_space(form):
+                    self.store_orig_form(node, form)
+                    node.form = form
+                elif self.allow_goeswith:
+                    forms = form.split()
+                    node.form = forms[0]
+                    for split_form in reversed(form[1:]):
+                        new = node.create_child(form=split_form, deprel='goeswith', upos=node.upos)
+                        new.shift_after_node(node)
+                else:
+                    logging.warning('Unable to solve 1:m diff:\n%s -> %s', nodes_str, form)
+            else:
+                logging.warning('Unable to solve n:m diff:\n%s -> %s', nodes_str, form)
+
+        # Second, solve the cases when multiple nodes match one form (without any spaces).
+        elif len(nodes) > 1:
+            # If the match is exact, we can choose between MWT ans SpaceAfter solutions.
+            if not self.prefer_mwt and ''.join([n.form for n in nodes]) == form:
+                pass  # SpaceAfter=No will be added later on.
+            # If one of the nodes is already a MWT, we cannot have nested MWTs.
+            # TODO: enlarge the MWT instead of failing.
+            elif any(isinstance(n, MWT) for n in nodes):
+                logging.warning('Unable to solve partial-MWT diff:\n%s -> %s', nodes_str, form)
+            # Otherwise, create a new MWT.
+            else:
+                node.root.create_multiword_token(nodes, form)
+
+        # Third, solve the 1-1 cases.
+        else:
+            self.store_orig_form(node, form)
+            node.form = form
+
+    def allow_space(self, form):
+        return re.fullmatch('[0-9 ]+([,.][0-9]+)?', form)
+
+    def store_orig_form(self, node, new_form):
+        if node.form not in ("''", "``"):
+            node.misc['OrigForm'] = node.form
+
+    def tokenize_list(self, strings, nodes):
+        new_strings = []
+        new_nodes = []
+        for string, node in zip(strings, nodes):
+            new_nodes.append(node)
+            substrings = self.tokenize(string)
+            if len(substrings) > 1:
+                new_strings.extend(substrings)
+                new_nodes.extend([None] * (len(substrings) - 1))
+            else:
+                new_strings.append(string)
+        return new_strings, new_nodes
+
+    @staticmethod
+    def tokenize(string):
+        return re.findall(r'\w+|[^\w\s]', string)
+
+    @staticmethod
+    def diff2str(diff, tree, text):
+        old = tree[diff[1]:diff[2]]
+        new = text[diff[3]:diff[4]]
+        return '{:7} {!r:>50} --> {!r}'.format(diff[0], old, new)

From 89b671fd956641b3b4e5cf6ce0dae27260ae0cb6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 18 Apr 2017 12:37:00 +0200
Subject: [PATCH 0054/1374] fix edge cases in ud.ComplyWithText and use it in
 ud.Google2ud

---
 udapi/block/ud/complywithtext.py        | 72 ++++++++++++++++---------
 udapi/block/ud/google2ud.py             | 23 ++++----
 udapi/block/ud/setspaceafterfromtext.py |  3 +-
 3 files changed, 61 insertions(+), 37 deletions(-)

diff --git a/udapi/block/ud/complywithtext.py b/udapi/block/ud/complywithtext.py
index 38394b59..627dc942 100644
--- a/udapi/block/ud/complywithtext.py
+++ b/udapi/block/ud/complywithtext.py
@@ -31,30 +31,33 @@
 class ComplyWithText(Block):
     """Adapt the nodes to comply with the text."""
 
-    def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, **kwargs):
+    def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, max_mwt_length=4,
+                 **kwargs):
         """Args:
-        fix_text - After all heuristics are applied, the token forms may still not match the text.
-                   Should we edit the text to match the token forms (as a last resort)?
-                   Default=True.
+        fix_text: After all heuristics are applied, the token forms may still not match the text.
+            Should we edit the text to match the token forms (as a last resort)? Default=True.
         prefer_mwt - What to do if multiple subsequent nodes correspond to a text written
-                     without spaces and non-word characters (punctuation)?
-                     E.g. if "3pm doesn't" is annotated with four nodes "3 pm does n't".
-                     We can use either SpaceAfter=No, or create a multi-word token (MWT).
-                     Note that if there is space or punctuation, SpaceAfter=No will be used always
-                     (e.g. "3 p.m." annotated with three nodes "3 p. m.").
-                     If the character sequence does not match exactly, MWT will be used always
-                     (e.g. "3pm doesn't" annotated with four nodes "3 p.m. does not").
-                     Thus this parameter influences only the "unclear" cases.
-                     Default=True (i.e. prefer multi-word tokens over SpaceAfter=No).
+            without spaces and non-word characters (punctuation)?
+            E.g. if "3pm doesn't" is annotated with four nodes "3 pm does n't".
+            We can use either SpaceAfter=No, or create a multi-word token (MWT).
+            Note that if there is space or punctuation, SpaceAfter=No will be used always
+            (e.g. "3 p.m." annotated with three nodes "3 p. m.").
+            If the character sequence does not match exactly, MWT will be used always
+            (e.g. "3pm doesn't" annotated with four nodes "3 p.m. does not").
+            Thus this parameter influences only the "unclear" cases.
+            Default=True (i.e. prefer multi-word tokens over SpaceAfter=No).
         allow_goeswith - If a node corresponds to multiple space-separated strings in text,
-                         which are not allowed as tokens with space, we can either leave this diff
-                         unresolved or create new nodes and join them with the `goeswith` deprel.
-                         Default=True (i.e. add the goeswith nodes if applicable).
+            which are not allowed as tokens with space, we can either leave this diff
+            unresolved or create new nodes and join them with the `goeswith` deprel.
+            Default=True (i.e. add the goeswith nodes if applicable).
+        max_mwt_length - Maximum length of newly created multi-word tokens (in syntactic words).
+            Default=4.
         """
         super().__init__(**kwargs)
         self.fix_text = fix_text
         self.prefer_mwt = prefer_mwt
         self.allow_goeswith = allow_goeswith
+        self.max_mwt_length = max_mwt_length
 
     def process_tree(self, root):
         text = root.text
@@ -79,6 +82,11 @@ def process_tree(self, root):
         matcher = difflib.SequenceMatcher(None, tree_split_forms, text_split_forms, autojunk=False)
         diffs = list(matcher.get_opcodes())
 
+        if logging.getLogger().isEnabledFor(logging.DEBUG):
+            print('=== After matcher:')
+            for diff in diffs:
+                print(self.diff2str(diff, tree_split_forms, text_split_forms))
+
         # Make sure each diff starts on original token boundary.
         # If not, merge the diff with the previous diff.
         # E.g. (equal, ["5"], ["5"]), (replace, ["-","6"], ["–","7"])
@@ -88,7 +96,7 @@ def process_tree(self, root):
 
             if edit != 'insert' and tree_split_nodes[tree_lo] is None:
                 if edit == 'equal':
-                    while tree_split_nodes[tree_lo] is None and tree_lo < tree_hi:
+                    while tree_lo < tree_hi and tree_split_nodes[tree_lo] is None:
                         tree_lo += 1
                         text_lo += 1
                     if tree_lo == tree_hi:
@@ -97,22 +105,30 @@ def process_tree(self, root):
                         diffs[i] = ('equal', tree_lo, tree_hi, text_lo, text_hi)
                     diffs[i - 1] = ('replace', diffs[i - 1][1], tree_lo, diffs[i - 1][3], text_lo)
                 else:
-                    if diffs[i - 1][0] != 'equal':
-                        diffs[i - 1] = ('replace', diffs[i - 1][1],
-                                        tree_hi, diffs[i - 1][3], text_hi)
+                    prev_i = i - 1
+                    while diffs[prev_i][0] == 'ignore':
+                        prev_i -= 1
+                    if diffs[prev_i][0] != 'equal':
+                        diffs[prev_i] = ('replace', diffs[prev_i][1],
+                                         tree_hi, diffs[prev_i][3], text_hi)
                         diffs[i] = ('ignore', 0, 0, 0, 0)
                     else:
-                        p_tree_hi = diffs[i - 1][2] - 1
-                        p_text_hi = diffs[i - 1][4] - 1
+                        p_tree_hi = diffs[prev_i][2] - 1
+                        p_text_hi = diffs[prev_i][4] - 1
                         while tree_split_nodes[p_tree_hi] is None:
                             p_tree_hi -= 1
                             p_text_hi -= 1
-                            assert p_tree_hi >= diffs[i - 1][1]
-                            assert p_text_hi >= diffs[i - 1][3]
-                        diffs[i - 1] = ('equal', diffs[i - 1][1], p_tree_hi,
-                                        diffs[i - 1][3], p_text_hi)
+                            assert p_tree_hi >= diffs[prev_i][1]
+                            assert p_text_hi >= diffs[prev_i][3]
+                        diffs[prev_i] = ('equal', diffs[prev_i][1], p_tree_hi,
+                                         diffs[prev_i][3], p_text_hi)
                         diffs[i] = ('replace', p_tree_hi, tree_hi, p_text_hi, text_hi)
 
+        if logging.getLogger().isEnabledFor(logging.DEBUG):
+            print('=== After re-merging split tokens:')
+            for diff in diffs:
+                print(self.diff2str(diff, tree_split_forms, text_split_forms))
+
         # TODO split diffs if possible, e.g.
         # ['_', 'atenuación', '_', 'de', 'os'] --> ['_atenuación_', 'dos']
         # should be divided into two diffs:
@@ -193,6 +209,10 @@ def solve_diff(self, nodes, form):
             # TODO: enlarge the MWT instead of failing.
             elif any(isinstance(n, MWT) for n in nodes):
                 logging.warning('Unable to solve partial-MWT diff:\n%s -> %s', nodes_str, form)
+            # MWT with too many words are suspicious.
+            elif len(nodes) > self.max_mwt_length:
+                logging.warning('Not creating too long (%d>%d) MWT:\n%s -> %s',
+                                len(nodes), self.max_mwt_length, nodes_str, form)
             # Otherwise, create a new MWT.
             else:
                 node.root.create_multiword_token(nodes, form)
diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 1e2ca83b..c8d51499 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -1,10 +1,10 @@
-"""Block ud.google2ud for converting Google Universal Dependency Treebank into UD.
+"""Block ud.Google2ud for converting Google Universal Dependency Treebank into UD.
 
 Usage:
 udapy -s ud.Google2ud < google.conllu > ud2.conllu
 """
 from udapi.block.ud.convert1to2 import Convert1to2
-from udapi.block.ud.setspaceafterfromtext import SetSpaceAfterFromText
+from udapi.block.ud.complywithtext import ComplyWithText
 from udapi.block.ud.de.addmwt import AddMwt as de_AddMwt
 
 DEPREL_CHANGE = {
@@ -92,8 +92,8 @@
     "mood=psm": "Tense=Fut",  # TODO ?
     "form=fin": "VerbForm=Fin",
     "form=ger": "VerbForm=Ger",
-    #"form=irr": "VerbForm=?",
-    #"form=adn": "VerbForm=?",
+    # "form=irr": "VerbForm=?",
+    # "form=adn": "VerbForm=?",
     "formality=fml": "Polite=Form",
     "Evidentiality=Nfh": "Evident=Nfh",
     "Evidentiality=Fh": "Evident=Fh",
@@ -103,24 +103,32 @@
 class Google2ud(Convert1to2):
     """Convert Google Universal Dependency Treebank into UD style."""
 
-    def __init__(self, lang='unk', **kwargs):
+    def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
         """Create the Google2ud block instance.
 
         See ``Convert1to2`` for all the args.
         """
         super().__init__(**kwargs)
         self.lang = lang
-        self._spaceafter_block = SetSpaceAfterFromText()
         self._addmwt_block = None
         if lang == 'de':
             self._addmwt_block = de_AddMwt()
 
+        # UD_English v2.0 still uses "do n't" with SpaceAfter=No,
+        # instead of annotating it as a multiword token.
+        # In several other languages it is also common
+        # that syntactic words are not separated with a space without being an MWT.
+        self._comply_block = ComplyWithText(prefer_mwt=bool(lang not in non_mwt_langs.split()))
+
     def process_tree(self, root):
         comment_lines = root.comment.split("\n")
         root.sent_id = comment_lines[0].strip().replace(' ', '-')
         root.text = comment_lines[1].strip()
         root.comment = ''
 
+        if self._comply_block:
+            self._comply_block.process_tree(root)
+
         # In German: "im" -> "in dem" etc.
         if self._addmwt_block:
             self._addmwt_block.process_tree(root)
@@ -141,9 +149,6 @@ def process_tree(self, root):
                 for child in copula.children:
                     child.parent = node
 
-        # call ud.SetSpaceAfterFromText
-        self._spaceafter_block.process_tree(root)
-
         # call ud.Convert1to2
         super().process_tree(root)
 
diff --git a/udapi/block/ud/setspaceafterfromtext.py b/udapi/block/ud/setspaceafterfromtext.py
index e3a1f90f..c5321221 100644
--- a/udapi/block/ud/setspaceafterfromtext.py
+++ b/udapi/block/ud/setspaceafterfromtext.py
@@ -17,8 +17,7 @@ def process_tree(self, root):
         text = root.text
         if text is None:
             raise ValueError('Tree %s has no text, cannot use ud.SetSpaceAfterFromText' % root)
-        computed = root.compute_text()
-        if text == computed:
+        if text == root.compute_text():
             return
 
         for node in root.token_descendants:

From 88460ab494510532bb935e31d033dd7b48eb972b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 18 Apr 2017 18:12:45 +0200
Subject: [PATCH 0055/1374] minor edits

---
 udapi/block/ud/complywithtext.py | 72 ++++++++++++++++----------------
 1 file changed, 37 insertions(+), 35 deletions(-)

diff --git a/udapi/block/ud/complywithtext.py b/udapi/block/ud/complywithtext.py
index 627dc942..ff0272b9 100644
--- a/udapi/block/ud/complywithtext.py
+++ b/udapi/block/ud/complywithtext.py
@@ -83,9 +83,9 @@ def process_tree(self, root):
         diffs = list(matcher.get_opcodes())
 
         if logging.getLogger().isEnabledFor(logging.DEBUG):
-            print('=== After matcher:')
+            logging.warning('=== After matcher:')
             for diff in diffs:
-                print(self.diff2str(diff, tree_split_forms, text_split_forms))
+                logging.warning(self.diff2str(diff, tree_split_forms, text_split_forms))
 
         # Make sure each diff starts on original token boundary.
         # If not, merge the diff with the previous diff.
@@ -93,41 +93,42 @@ def process_tree(self, root):
         # is changed into (replace, ["5","-","6"], ["5","–","7"])
         for i, diff in enumerate(diffs):
             edit, tree_lo, tree_hi, text_lo, text_hi = diff
+            if edit != 'insert' and tree_split_nodes[tree_lo] is not None:
+                continue
 
-            if edit != 'insert' and tree_split_nodes[tree_lo] is None:
-                if edit == 'equal':
-                    while tree_lo < tree_hi and tree_split_nodes[tree_lo] is None:
-                        tree_lo += 1
-                        text_lo += 1
-                    if tree_lo == tree_hi:
-                        diffs[i] = ('ignore', 0, 0, 0, 0)
-                    else:
-                        diffs[i] = ('equal', tree_lo, tree_hi, text_lo, text_hi)
-                    diffs[i - 1] = ('replace', diffs[i - 1][1], tree_lo, diffs[i - 1][3], text_lo)
+            prev_i = i - 1
+            while diffs[prev_i][0] == 'ignore':
+                prev_i -= 1
+            if edit == 'equal':
+                while tree_lo < tree_hi and tree_split_nodes[tree_lo] is None:
+                    tree_lo += 1
+                    text_lo += 1
+                if tree_lo == tree_hi:
+                    diffs[i] = ('ignore', 0, 0, 0, 0)
+                else:
+                    diffs[i] = ('equal', tree_lo, tree_hi, text_lo, text_hi)
+                diffs[prev_i] = ('replace', diffs[prev_i][1], tree_lo, diffs[prev_i][3], text_lo)
+            else:
+                if diffs[prev_i][0] != 'equal':
+                    diffs[prev_i] = ('replace', diffs[prev_i][1],
+                                     tree_hi, diffs[prev_i][3], text_hi)
+                    diffs[i] = ('ignore', 0, 0, 0, 0)
                 else:
-                    prev_i = i - 1
-                    while diffs[prev_i][0] == 'ignore':
-                        prev_i -= 1
-                    if diffs[prev_i][0] != 'equal':
-                        diffs[prev_i] = ('replace', diffs[prev_i][1],
-                                         tree_hi, diffs[prev_i][3], text_hi)
-                        diffs[i] = ('ignore', 0, 0, 0, 0)
-                    else:
-                        p_tree_hi = diffs[prev_i][2] - 1
-                        p_text_hi = diffs[prev_i][4] - 1
-                        while tree_split_nodes[p_tree_hi] is None:
-                            p_tree_hi -= 1
-                            p_text_hi -= 1
-                            assert p_tree_hi >= diffs[prev_i][1]
-                            assert p_text_hi >= diffs[prev_i][3]
-                        diffs[prev_i] = ('equal', diffs[prev_i][1], p_tree_hi,
-                                         diffs[prev_i][3], p_text_hi)
-                        diffs[i] = ('replace', p_tree_hi, tree_hi, p_text_hi, text_hi)
+                    p_tree_hi = diffs[prev_i][2] - 1
+                    p_text_hi = diffs[prev_i][4] - 1
+                    while tree_split_nodes[p_tree_hi] is None:
+                        p_tree_hi -= 1
+                        p_text_hi -= 1
+                        assert p_tree_hi >= diffs[prev_i][1]
+                        assert p_text_hi >= diffs[prev_i][3]
+                    diffs[prev_i] = ('equal', diffs[prev_i][1], p_tree_hi,
+                                     diffs[prev_i][3], p_text_hi)
+                    diffs[i] = ('replace', p_tree_hi, tree_hi, p_text_hi, text_hi)
 
         if logging.getLogger().isEnabledFor(logging.DEBUG):
-            print('=== After re-merging split tokens:')
+            logging.warning('=== After re-merging split tokens:')
             for diff in diffs:
-                print(self.diff2str(diff, tree_split_forms, text_split_forms))
+                logging.warning(self.diff2str(diff, tree_split_forms, text_split_forms))
 
         # TODO split diffs if possible, e.g.
         # ['_', 'atenuación', '_', 'de', 'os'] --> ['_atenuación_', 'dos']
@@ -245,9 +246,10 @@ def tokenize_list(self, strings, nodes):
     @staticmethod
     def tokenize(string):
         return re.findall(r'\w+|[^\w\s]', string)
+        # return string
 
     @staticmethod
     def diff2str(diff, tree, text):
-        old = tree[diff[1]:diff[2]]
-        new = text[diff[3]:diff[4]]
-        return '{:7} {!r:>50} --> {!r}'.format(diff[0], old, new)
+        old = ' '.join(tree[diff[1]:diff[2]])
+        new = ' '.join(text[diff[3]:diff[4]])
+        return '{:7} {!s:>50} --> {!s}'.format(diff[0], old, new)

From 03ff17fc861673e48fc5a73ab5a034bc49a33c0d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 19 Apr 2017 18:01:39 +0200
Subject: [PATCH 0056/1374] reimplement ComplyWithText using character-based
 LCS

---
 udapi/block/ud/complywithtext.py | 237 +++++++++++++++++--------------
 1 file changed, 127 insertions(+), 110 deletions(-)

diff --git a/udapi/block/ud/complywithtext.py b/udapi/block/ud/complywithtext.py
index ff0272b9..82cda8e3 100644
--- a/udapi/block/ud/complywithtext.py
+++ b/udapi/block/ud/complywithtext.py
@@ -10,6 +10,14 @@
 However, it is quite difficult to map these character-level diffs to token-level diffs
 (one character-level diff may partially overlap with two tokens).
 
+We need to insert spaces into the sequences to prevent mis-alignment.
+For example, text "énfase na necesidade" with 4 nodes "énfase en a necesidade"
+should be solved by adding multiword token "na" over the nodes "en" and "a".
+However, running LCS (or difflib) over the character sequences
+"énfaseenanecesidade"
+"énfasenanecesidade"
+may result in énfase -> énfas.
+
 So this implementation starts with running a LCS-like algorithm (difflib) on a sequence of tokens
 (instead of sequence of characters). Tokens from trees are obtain with `root.token_descendants`
 (these tokens may be standard nodes for syntactic words or multi-word tokens).
@@ -59,6 +67,18 @@ def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, max_mwt_
         self.allow_goeswith = allow_goeswith
         self.max_mwt_length = max_mwt_length
 
+    @staticmethod
+    def allow_space(form):
+        """Is space allowed within this token form?"""
+        return re.fullmatch('[0-9 ]+([,.][0-9]+)?', form)
+
+    @staticmethod
+    def store_orig_form(node, new_form):
+        """Store the original form of this node into MISC, unless the change is common&expected."""
+        _ = new_form
+        if node.form not in ("''", "``"):
+            node.misc['OrigForm'] = node.form
+
     def process_tree(self, root):
         text = root.text
         if text is None:
@@ -70,93 +90,21 @@ def process_tree(self, root):
         if text == root.compute_text():
             return
 
-        # To improve the 1-1 alignment, let's tokenize the text on spaces and punctuation.
-        # We need to tokenize the token forms in the exactly same way, e.g. "5-6" -> "5" "-" "6".
-        tree_nodes = root.token_descendants
-        tree_forms = [t.form for t in tree_nodes]
-        text_forms = text.split()
-        tree_split_forms, tree_split_nodes = self.tokenize_list(tree_forms, tree_nodes)
-        text_split_forms, text_split_nodes = self.tokenize_list(text_forms, text_forms)
+        tree_chars, char_nodes = _nodes_to_chars(root.token_descendants)
 
-        # Align. difflib does may not give LCS, but usually it is good enough.
-        matcher = difflib.SequenceMatcher(None, tree_split_forms, text_split_forms, autojunk=False)
+        # Align. difflib may not give LCS, but usually it is good enough.
+        matcher = difflib.SequenceMatcher(None, tree_chars, text, autojunk=False)
         diffs = list(matcher.get_opcodes())
+        _log_diffs(diffs, tree_chars, text, 'matcher')
 
-        if logging.getLogger().isEnabledFor(logging.DEBUG):
-            logging.warning('=== After matcher:')
-            for diff in diffs:
-                logging.warning(self.diff2str(diff, tree_split_forms, text_split_forms))
-
-        # Make sure each diff starts on original token boundary.
-        # If not, merge the diff with the previous diff.
-        # E.g. (equal, ["5"], ["5"]), (replace, ["-","6"], ["–","7"])
-        # is changed into (replace, ["5","-","6"], ["5","–","7"])
-        for i, diff in enumerate(diffs):
-            edit, tree_lo, tree_hi, text_lo, text_hi = diff
-            if edit != 'insert' and tree_split_nodes[tree_lo] is not None:
-                continue
-
-            prev_i = i - 1
-            while diffs[prev_i][0] == 'ignore':
-                prev_i -= 1
-            if edit == 'equal':
-                while tree_lo < tree_hi and tree_split_nodes[tree_lo] is None:
-                    tree_lo += 1
-                    text_lo += 1
-                if tree_lo == tree_hi:
-                    diffs[i] = ('ignore', 0, 0, 0, 0)
-                else:
-                    diffs[i] = ('equal', tree_lo, tree_hi, text_lo, text_hi)
-                diffs[prev_i] = ('replace', diffs[prev_i][1], tree_lo, diffs[prev_i][3], text_lo)
-            else:
-                if diffs[prev_i][0] != 'equal':
-                    diffs[prev_i] = ('replace', diffs[prev_i][1],
-                                     tree_hi, diffs[prev_i][3], text_hi)
-                    diffs[i] = ('ignore', 0, 0, 0, 0)
-                else:
-                    p_tree_hi = diffs[prev_i][2] - 1
-                    p_text_hi = diffs[prev_i][4] - 1
-                    while tree_split_nodes[p_tree_hi] is None:
-                        p_tree_hi -= 1
-                        p_text_hi -= 1
-                        assert p_tree_hi >= diffs[prev_i][1]
-                        assert p_text_hi >= diffs[prev_i][3]
-                    diffs[prev_i] = ('equal', diffs[prev_i][1], p_tree_hi,
-                                     diffs[prev_i][3], p_text_hi)
-                    diffs[i] = ('replace', p_tree_hi, tree_hi, p_text_hi, text_hi)
-
-        if logging.getLogger().isEnabledFor(logging.DEBUG):
-            logging.warning('=== After re-merging split tokens:')
-            for diff in diffs:
-                logging.warning(self.diff2str(diff, tree_split_forms, text_split_forms))
-
-        # TODO split diffs if possible, e.g.
-        # ['_', 'atenuación', '_', 'de', 'os'] --> ['_atenuación_', 'dos']
-        # should be divided into two diffs:
-        # ['_', 'atenuación', '_'] --> ['_atenuación_']
-        # ['de', 'os'] --> ['dos']
-        # This would probably need running another SequenceMatcher on characters
-        # and then aligning the tokens/nodes.
-
-        for diff in diffs:
-            edit, tree_lo, tree_hi, text_lo, text_hi = diff
+        diffs = self.unspace_diffs(diffs, tree_chars, text)
+        _log_diffs(diffs, tree_chars, text, 'unspace')
 
-            # Focus only on edits of type 'replace', log insertions and deletions as failures.
-            if edit in ('equal', 'ignore'):
-                continue
-            if edit in ('insert', 'delete'):
-                logging.warning('Unable to solve token-vs-text mismatch\n%s',
-                                self.diff2str(diff, tree_split_forms, text_split_forms))
-                continue
+        diffs = self.merge_diffs(diffs, char_nodes)
+        _log_diffs(diffs, tree_chars, text, 'merge')
 
-            # Revert the splittng and solve the diff.
-            nodes = [n for n in tree_split_nodes[tree_lo:tree_hi] if n is not None]
-            form = text_split_forms[text_lo]
-            for i in range(text_lo + 1, text_hi):
-                if text_split_nodes[i] is not None:
-                    form += ' '
-                form += text_split_forms[i]
-            self.solve_diff(nodes, form)
+        # Solve diffs.
+        self.solve_diffs(diffs, tree_chars, char_nodes, text)
 
         # Fill SpaceAfter=No.
         tmp_text = text
@@ -179,9 +127,82 @@ def process_tree(self, root):
                 root.add_comment('ToDoOrigText = ' + root.text)
                 root.text = computed_text
 
+    def unspace_diffs(self, orig_diffs, tree_chars, text):
+        diffs = []
+        for diff in orig_diffs:
+            edit, tree_lo, tree_hi, text_lo, text_hi = diff
+            if edit != 'insert':
+                if tree_chars[tree_lo] == ' ':
+                    tree_lo += 1
+                if tree_chars[tree_hi - 1] == ' ':
+                    tree_hi -= 1
+            old = tree_chars[tree_lo:tree_hi]
+            new = text[text_lo:text_hi]
+            if old == '' and new == '':
+                continue
+            elif old == new:
+                edit = 'equal'
+            elif old == '':
+                edit = 'insert'
+            diffs.append((edit, tree_lo, tree_hi, text_lo, text_hi))
+        return diffs
+
+    def merge_diffs(self, orig_diffs, char_nodes):
+        """Make sure each diff starts on original token boundary.
+
+        If not, merge the diff with the previous diff.
+        E.g. (equal, "5", "5"), (replace, "-6", "–7")
+        is changed into (replace, "5-6", "5–7")
+        """
+        diffs = []
+        for diff in orig_diffs:
+            edit, tree_lo, tree_hi, text_lo, text_hi = diff
+            if edit != 'insert' and char_nodes[tree_lo] is not None:
+                diffs.append(diff)
+            elif edit == 'equal':
+                while tree_lo < tree_hi and char_nodes[tree_lo] is None:
+                    tree_lo += 1
+                    text_lo += 1
+                diffs[-1] = ('replace', diffs[-1][1], tree_lo, diffs[-1][3], text_lo)
+                if tree_lo < tree_hi:
+                    diffs.append(('equal', tree_lo, tree_hi, text_lo, text_hi))
+            else:
+                if not diffs:
+                    diffs = [diff]
+                elif diffs[-1][0] != 'equal':
+                    diffs[-1] = ('replace', diffs[-1][1], tree_hi, diffs[-1][3], text_hi)
+                else:
+                    p_tree_hi = diffs[-1][2] - 1
+                    p_text_hi = diffs[-1][4] - 1
+                    while char_nodes[p_tree_hi] is None:
+                        p_tree_hi -= 1
+                        p_text_hi -= 1
+                        assert p_tree_hi >= diffs[-1][1]
+                        assert p_text_hi >= diffs[-1][3]
+                    diffs[-1] = ('equal', diffs[-1][1], p_tree_hi, diffs[-1][3], p_text_hi)
+                    diffs.append(('replace', p_tree_hi, tree_hi, p_text_hi, text_hi))
+        return diffs
+
+    def solve_diffs(self, diffs, tree_chars, char_nodes, text):
+        for diff in diffs:
+            edit, tree_lo, tree_hi, text_lo, text_hi = diff
+
+            # Focus only on edits of type 'replace', log insertions and deletions as failures.
+            if edit == 'equal':
+                continue
+            if edit in ('insert', 'delete'):
+                logging.warning('Unable to solve token-vs-text mismatch\n%s',
+                                _diff2str(diff, tree_chars, text))
+                continue
+
+            # Revert the splittng and solve the diff.
+            nodes = [n for n in char_nodes[tree_lo:tree_hi] if n is not None]
+            form = text[text_lo:text_hi]
+            self.solve_diff(nodes, form.strip())
+
     def solve_diff(self, nodes, form):
         """Fix a given (minimal) tokens-vs-text inconsistency."""
-        nodes_str = ' '.join([n.form for n in nodes])
+        nodes_str = ' '.join([n.form for n in nodes])  # just for debugging
         node = nodes[0]
 
         # First, solve the cases when the text contains a space.
@@ -193,7 +214,7 @@ def solve_diff(self, nodes, form):
                 elif self.allow_goeswith:
                     forms = form.split()
                     node.form = forms[0]
-                    for split_form in reversed(form[1:]):
+                    for split_form in reversed(forms[1:]):
                         new = node.create_child(form=split_form, deprel='goeswith', upos=node.upos)
                         new.shift_after_node(node)
                 else:
@@ -223,33 +244,29 @@ def solve_diff(self, nodes, form):
             self.store_orig_form(node, form)
             node.form = form
 
-    def allow_space(self, form):
-        return re.fullmatch('[0-9 ]+([,.][0-9]+)?', form)
 
-    def store_orig_form(self, node, new_form):
-        if node.form not in ("''", "``"):
-            node.misc['OrigForm'] = node.form
+def _nodes_to_chars(nodes):
+    chars, char_nodes = [], []
+    for node in nodes:
+        form = node.form
+        if node.misc['SpaceAfter'] != 'No' and node != nodes[-1]:
+            form += ' '
+        chars.extend(form)
+        char_nodes.append(node)
+        char_nodes.extend([None] * (len(form) - 1))
+    return ''.join(chars), char_nodes
 
-    def tokenize_list(self, strings, nodes):
-        new_strings = []
-        new_nodes = []
-        for string, node in zip(strings, nodes):
-            new_nodes.append(node)
-            substrings = self.tokenize(string)
-            if len(substrings) > 1:
-                new_strings.extend(substrings)
-                new_nodes.extend([None] * (len(substrings) - 1))
-            else:
-                new_strings.append(string)
-        return new_strings, new_nodes
 
-    @staticmethod
-    def tokenize(string):
-        return re.findall(r'\w+|[^\w\s]', string)
-        # return string
+def _log_diffs(diffs, tree_chars, text, msg):
+    if logging.getLogger().isEnabledFor(logging.DEBUG):
+        logging.warning('=== After %s:', msg)
+        for diff in diffs:
+            logging.warning(_diff2str(diff, tree_chars, text))
 
-    @staticmethod
-    def diff2str(diff, tree, text):
-        old = ' '.join(tree[diff[1]:diff[2]])
-        new = ' '.join(text[diff[3]:diff[4]])
-        return '{:7} {!s:>50} --> {!s}'.format(diff[0], old, new)
+
+def _diff2str(diff, tree, text):
+    old = '|' + ''.join(tree[diff[1]:diff[2]]) + '|'
+    new = '|' + ''.join(text[diff[3]:diff[4]]) + '|'
+    if diff[0] == 'equal':
+        return '{:7} {!s:>50}'.format(diff[0], old)
+    return '{:7} {!s:>50} --> {!s}'.format(diff[0], old, new)

From 85a0396ecd767cfe1e243b223c4bb0f2a5b74c4c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 20 Apr 2017 23:43:29 +0200
Subject: [PATCH 0057/1374] agent->obl:agent in Hindi

---
 udapi/block/ud/complywithtext.py | 18 ++++++++++--------
 udapi/block/ud/google2ud.py      |  1 +
 2 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/udapi/block/ud/complywithtext.py b/udapi/block/ud/complywithtext.py
index 82cda8e3..6eda2c4b 100644
--- a/udapi/block/ud/complywithtext.py
+++ b/udapi/block/ud/complywithtext.py
@@ -1,17 +1,19 @@
 r"""Block ComplyWithText for adapting the nodes to comply with the text.
 
 Implementation design details:
-Most of the inconsistencies between tree tokens and the raw text are simple to solve.
+Usually, most of the inconsistencies between tree tokens and the raw text are simple to solve.
 However, there may be also rare cases when it is not clear how to align the tokens
-with the text. This block tries to solve the general case using several heuristics.
+(nodes in the tree) with the raw text (stored in ``root.text``).
+This block tries to solve the general case using several heuristics.
 
-One possible implementation is to find the LCS (longest common subsequence)
-of the raw text and concatenation of tokens' forms.
-However, it is quite difficult to map these character-level diffs to token-level diffs
-(one character-level diff may partially overlap with two tokens).
+It starts with running a LCS-like algorithm (LCS = longest common subsequence)
+``difflib.SequenceMatcher`` on the raw text and concatenation of tokens' forms,
+i.e. on sequences of characters (as opposed to running LCS on sequences of tokens).
 
-We need to insert spaces into the sequences to prevent mis-alignment.
-For example, text "énfase na necesidade" with 4 nodes "énfase en a necesidade"
+To prevent mis-alignment problems, we keep the spaces present in the raw text
+and we insert spaces into the concatenated forms (``tree_chars``) according to ``SpaceAfter=No``.
+An example of a mis-alignment problem:
+text "énfase na necesidade" with 4 nodes "énfase en a necesidade"
 should be solved by adding multiword token "na" over the nodes "en" and "a".
 However, running LCS (or difflib) over the character sequences
 "énfaseenanecesidade"
diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index c8d51499..832359de 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -39,6 +39,7 @@
     "topic": "dep",
     "possessive": "case",
     "quantmod": "det",  # TODO UD_Hindi uses "dep" for the same words
+    "agent": "obl:agent",
     # TODO: "ref" - in basic dependencies it should be rehanged and relabelled
     "conjv": "compound:conjv",
     "advphmod": "advmod",

From 8499aef79e8ecf1a6e9198071b58ce069b180622 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 22 Apr 2017 01:49:57 +0200
Subject: [PATCH 0058/1374] add ud.FixChain for fixing the fixed-chain bug,
 goeswith-chain bug

---
 udapi/block/ud/fixchain.py | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 udapi/block/ud/fixchain.py

diff --git a/udapi/block/ud/fixchain.py b/udapi/block/ud/fixchain.py
new file mode 100644
index 00000000..029f9ec9
--- /dev/null
+++ b/udapi/block/ud/fixchain.py
@@ -0,0 +1,18 @@
+"""Block ud.FixChain for making sure deprel=fixed|goeswith|list does not form a chain."""
+from udapi.core.block import Block
+
+
+class FixChain(Block):
+    """Make sure deprel=fixed does not form a chain, but a flat structure."""
+
+    def __init__(self, deprels='fixed,goeswith,list', **kwargs):
+        """Args:
+        deprels: comma-separated list of deprels to be fixed. Default = fixed,goeswith,list.
+        """
+        super().__init__(**kwargs)
+        self.deprels = deprels.split(',')
+
+    def process_node(self, node):
+        for deprel in self.deprels:
+            if node.deprel == deprel and node.parent.deprel == deprel:
+                node.parent = node.parent.parent

From 1cad2fde6cee84a2607d59ffbb532ebe554f9753 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 22 Apr 2017 01:51:43 +0200
Subject: [PATCH 0059/1374] ud.Google2ud solves Portuguese bugs: fixed-chain
 and goeswith-gap

---
 udapi/block/ud/complywithtext.py |  8 --------
 udapi/block/ud/google2ud.py      | 16 ++++++++++++++++
 2 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/udapi/block/ud/complywithtext.py b/udapi/block/ud/complywithtext.py
index 6eda2c4b..cead294a 100644
--- a/udapi/block/ud/complywithtext.py
+++ b/udapi/block/ud/complywithtext.py
@@ -20,14 +20,6 @@
 "énfasenanecesidade"
 may result in énfase -> énfas.
 
-So this implementation starts with running a LCS-like algorithm (difflib) on a sequence of tokens
-(instead of sequence of characters). Tokens from trees are obtain with `root.token_descendants`
-(these tokens may be standard nodes for syntactic words or multi-word tokens).
-From the raw text (`root.text`), we obtain "tokens" by splitting it on spaces and punctuation
-(or more precisely any non-word character -- ``re.findall(r'\w+|[^\w\s]', string)``).
-This tokenization is just approximate, to increase the chance of 1-1 alignment.
-This heuristics does not work for languages written without spaces (e.g. Chinese, Japanese).
-
 Author: Martin Popel
 """
 import difflib
diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 832359de..b781ca43 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -5,6 +5,7 @@
 """
 from udapi.block.ud.convert1to2 import Convert1to2
 from udapi.block.ud.complywithtext import ComplyWithText
+from udapi.block.ud.fixchain import FixChain
 from udapi.block.ud.de.addmwt import AddMwt as de_AddMwt
 
 DEPREL_CHANGE = {
@@ -115,6 +116,10 @@ def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
         if lang == 'de':
             self._addmwt_block = de_AddMwt()
 
+        self._fixchain_block = None
+        if lang in {'pt'}:
+            self._fixchain_block = FixChain()
+
         # UD_English v2.0 still uses "do n't" with SpaceAfter=No,
         # instead of annotating it as a multiword token.
         # In several other languages it is also common
@@ -153,6 +158,17 @@ def process_tree(self, root):
         # call ud.Convert1to2
         super().process_tree(root)
 
+        if self._fixchain_block:
+            self._fixchain_block.process_tree(root)
+
+        if self.lang == 'pt':
+            for node in root.descendants[2:]:
+                if node.deprel == 'goeswith' and node.prev_node.form == '-':
+                    node.parent.form += '-' + node.form
+                    node.parent.misc['SpaceAfter'] = node.misc['SpaceAfter']
+                    node.prev_node.remove(children='rehang')
+                    node.remove(children='rehang')
+
     @staticmethod
     def fix_feats(node):
         """Remove language prefixes, capitalize names and values, apply FEATS_CHANGE."""

From b36fa86c1486478d64a200d069d50feaae1e7899 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 22 Apr 2017 02:40:38 +0200
Subject: [PATCH 0060/1374] pt AddMwt (draft)

---
 udapi/block/ud/google2ud.py   |  3 ++
 udapi/block/ud/pt/__init__.py |  0
 udapi/block/ud/pt/addmwt.py   | 64 +++++++++++++++++++++++++++++++++++
 3 files changed, 67 insertions(+)
 create mode 100644 udapi/block/ud/pt/__init__.py
 create mode 100644 udapi/block/ud/pt/addmwt.py

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index b781ca43..9b0fa0ac 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -7,6 +7,7 @@
 from udapi.block.ud.complywithtext import ComplyWithText
 from udapi.block.ud.fixchain import FixChain
 from udapi.block.ud.de.addmwt import AddMwt as de_AddMwt
+from udapi.block.ud.pt.addmwt import AddMwt as pt_AddMwt
 
 DEPREL_CHANGE = {
     "ROOT": "root",
@@ -115,6 +116,8 @@ def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
         self._addmwt_block = None
         if lang == 'de':
             self._addmwt_block = de_AddMwt()
+        elif lang == 'pt':
+            self._addmwt_block = pt_AddMwt()
 
         self._fixchain_block = None
         if lang in {'pt'}:
diff --git a/udapi/block/ud/pt/__init__.py b/udapi/block/ud/pt/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/ud/pt/addmwt.py b/udapi/block/ud/pt/addmwt.py
new file mode 100644
index 00000000..5c96f710
--- /dev/null
+++ b/udapi/block/ud/pt/addmwt.py
@@ -0,0 +1,64 @@
+"""Block ud.pt.AddMwt for heuristic detection of Portuguese contractions.
+
+According to the UD guidelines, contractions such as "dele" = "de ele"
+should be annotated using multi-word tokens.
+
+Note that this block should be used only for converting legacy conllu files.
+Ideally a tokenizer should have already split the MWTs.
+"""
+import udapi.block.ud.addmwt
+
+MWTS = {
+    'à':       {'form': 'a a', 'lemma': 'a o'},
+    'às':      {'form': 'a as', 'lemma': 'a o'},
+    # 'ao':      {'form': 'a o', 'lemma': 'a o'},  # Sometimes annotated just as ao/ao/ADP/case
+    'aos':     {'form': 'a os', 'lemma': 'a o'},
+    'da':      {'form': 'de a', 'lemma': 'de o'},
+    'das':     {'form': 'de as', 'lemma': 'de o'},
+    'desta':   {'form': 'de esta', 'lemma': 'de este'},
+    'dele':    {'form': 'de ele', 'lemma': 'de ele', 'upos': 'ADP PRON', 'deprel': 'case *'},
+    'deles':   {'form': 'de eles', 'lemma': 'de eles', 'upos': 'ADP PRON', 'deprel': 'case *'},
+    # 'disso': {'form': 'de isso', TODO}
+    'do':      {'form': 'de o', 'lemma': 'de o'},  # 'upos': 'ADP PRON', 'deprel': 'case *''
+    'dos':     {'form': 'de os', 'lemma': 'de o'},
+    'na':      {'form': 'em a', 'lemma': 'em o'},
+    'nesta':   {'form': 'em esta', 'lemma': 'em este'},
+    'no':      {'form': 'em o', 'lemma': 'em o'},
+    'nos':     {'form': 'em os', 'lemma': 'em o'},
+    'numa':    {'form': 'em uma', 'lemma': 'em um'},
+    'pelos':   {'form': 'por os', 'lemma': 'por o'},
+    'pelo':    {'form': 'por o', 'lemma': 'por o'},
+}
+
+# shared values for all entries in MWTS
+for v in MWTS.values():
+    if not v.get('upos'):
+        v['upos'] = 'ADP DET'
+    if not v.get('deprel'):
+        v['deprel'] = 'case det'
+    v['feats'] = '_ *'
+    # The following are the default values
+    # v['main'] = 0 # which of the two words will inherit the original children (if any)
+    # v['shape'] = 'siblings', # the newly created nodes will be siblings
+
+
+class AddMwt(udapi.block.ud.addmwt.AddMwt):
+    """Detect and mark MWTs (split them into words and add the words to the tree)."""
+
+    def multiword_analysis(self, node):
+        """Return a dict with MWT info or None if `node` does not represent a multiword token."""
+        analysis = MWTS.get(node.form.lower(), None)
+        if analysis is not None:
+            return analysis
+
+        if node.form.lower().endswith('-se') and node.upos == 'VERB':
+            return {
+                'form': node.form.lower()[:-3] + ' se',
+                'lemma': '* se',
+                'upos': '* PRON',
+                'feats': '* _',
+                'deprel': '* nsubj',  # or '* expl'
+                'main': 0,
+                'shape': 'subtree',
+            }
+        return None

From b8a273297d5b3fb421395af93d371e51cb9846d4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 24 Apr 2017 02:02:28 +0200
Subject: [PATCH 0061/1374] better ud.pt.AddMwt

---
 udapi/block/ud/pt/addmwt.py | 69 ++++++++++++++++++++++++++++++++++---
 1 file changed, 65 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/pt/addmwt.py b/udapi/block/ud/pt/addmwt.py
index 5c96f710..c8361a95 100644
--- a/udapi/block/ud/pt/addmwt.py
+++ b/udapi/block/ud/pt/addmwt.py
@@ -11,23 +11,44 @@
 MWTS = {
     'à':       {'form': 'a a', 'lemma': 'a o'},
     'às':      {'form': 'a as', 'lemma': 'a o'},
-    # 'ao':      {'form': 'a o', 'lemma': 'a o'},  # Sometimes annotated just as ao/ao/ADP/case
+    'ao':      {'form': 'a o', 'lemma': 'a o'},
     'aos':     {'form': 'a os', 'lemma': 'a o'},
     'da':      {'form': 'de a', 'lemma': 'de o'},
     'das':     {'form': 'de as', 'lemma': 'de o'},
+    'dessa':   {'form': 'de essa', 'lemma': 'de esse'},
+    'dessas':  {'form': 'de essas', 'lemma': 'de esse'},
+    'desse':   {'form': 'de esse', 'lemma': 'de esse'},
+    'desses':  {'form': 'de esses', 'lemma': 'de esse'},
     'desta':   {'form': 'de esta', 'lemma': 'de este'},
-    'dele':    {'form': 'de ele', 'lemma': 'de ele', 'upos': 'ADP PRON', 'deprel': 'case *'},
-    'deles':   {'form': 'de eles', 'lemma': 'de eles', 'upos': 'ADP PRON', 'deprel': 'case *'},
-    # 'disso': {'form': 'de isso', TODO}
+    'destas':  {'form': 'de estas', 'lemma': 'de este'},
+    'deste':   {'form': 'de este', 'lemma': 'de este'},
+    'destes':  {'form': 'de estes', 'lemma': 'de este'},
+    'disso':   {'form': 'de isso', 'lemma': 'de este'},
+    'disto':   {'form': 'de isto', 'lemma': 'de este'},
     'do':      {'form': 'de o', 'lemma': 'de o'},  # 'upos': 'ADP PRON', 'deprel': 'case *''
     'dos':     {'form': 'de os', 'lemma': 'de o'},
+    'dum':     {'form': 'de um', 'lemma': 'de um'},
+    'duma':    {'form': 'de uma', 'lemma': 'de um'},
+    'dumas':   {'form': 'de umas', 'lemma': 'de um'},
+    'duns':    {'form': 'de uns', 'lemma': 'de um'},
     'na':      {'form': 'em a', 'lemma': 'em o'},
+    'nas':     {'form': 'em as', 'lemma': 'em o'},  # ADP PRON
+    'nesses':  {'form': 'em esses', 'lemma': 'em esse'},
     'nesta':   {'form': 'em esta', 'lemma': 'em este'},
+    'neste':   {'form': 'em este', 'lemma': 'em este'},
+    'nisto':   {'form': 'em isto', 'lemma': 'em este',
+                'upos': 'ADP PRON', 'main': 1, 'shape': 'subtree'},
     'no':      {'form': 'em o', 'lemma': 'em o'},
     'nos':     {'form': 'em os', 'lemma': 'em o'},
+    'num':     {'form': 'em um', 'lemma': 'em um'},
     'numa':    {'form': 'em uma', 'lemma': 'em um'},
+    'numas':   {'form': 'em umas', 'lemma': 'em um'},
+    'nuns':    {'form': 'em uns', 'lemma': 'em um'},
+    'pela':    {'form': 'por a', 'lemma': 'por o'},
+    'pelas':   {'form': 'por as', 'lemma': 'por o'},
     'pelos':   {'form': 'por os', 'lemma': 'por o'},
     'pelo':    {'form': 'por o', 'lemma': 'por o'},
+    # TODO daí = de aí = ADP ADV = case advmod
 }
 
 # shared values for all entries in MWTS
@@ -41,6 +62,16 @@
     # v['main'] = 0 # which of the two words will inherit the original children (if any)
     # v['shape'] = 'siblings', # the newly created nodes will be siblings
 
+for pronoun in 'ela ele eles elas'.split():
+    MWTS['d' + pronoun] = {
+        'form': 'de ' + pronoun,
+        'lemma': 'de ' + pronoun,
+        'upos': 'ADP PRON',
+        'deprel': 'case *',
+        'main': 1,
+        'shape': 'subtree',
+    }
+
 
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
     """Detect and mark MWTs (split them into words and add the words to the tree)."""
@@ -61,4 +92,34 @@ def multiword_analysis(self, node):
                 'main': 0,
                 'shape': 'subtree',
             }
+        elif node.form.lower().endswith('-lo') and node.upos == 'VERB':
+            return {
+                'form': node.form.lower()[:-3] + ' lo',
+                'lemma': '* ele',
+                'upos': '* PRON',
+                'feats': '* _',
+                'deprel': '* obj',
+                'main': 0,
+                'shape': 'subtree',
+            }
+        elif node.form.lower().endswith('-los') and node.upos == 'VERB':
+            return {
+                'form': node.form.lower()[:-4] + ' los',
+                'lemma': '* eles',
+                'upos': '* PRON',
+                'feats': '* _',
+                'deprel': '* obj',
+                'main': 0,
+                'shape': 'subtree',
+            }
+        elif node.form.lower().endswith('-o') and node.upos == 'VERB':
+            return {
+                'form': node.form.lower()[:-2] + ' o',
+                'lemma': '* ele',
+                'upos': '* PRON',
+                'feats': '* _',
+                'deprel': '* obj',
+                'main': 0,
+                'shape': 'subtree',
+            }
         return None

From 4109e7f420e712913ed0b5cab62b742cf257d79b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 24 Apr 2017 02:30:01 +0200
Subject: [PATCH 0062/1374] AddMwt blocks need to be applied after prepositions
 are under nouns

---
 udapi/block/ud/google2ud.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 9b0fa0ac..5cb0dd10 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -138,10 +138,6 @@ def process_tree(self, root):
         if self._comply_block:
             self._comply_block.process_tree(root)
 
-        # In German: "im" -> "in dem" etc.
-        if self._addmwt_block:
-            self._addmwt_block.process_tree(root)
-
         for node in root.descendants:
             self.fix_feats(node)
             self.fix_upos(node)
@@ -161,10 +157,15 @@ def process_tree(self, root):
         # call ud.Convert1to2
         super().process_tree(root)
 
+        # In German: "im" -> "in dem" etc.
+        # This needs to be applied after prepositions are under nouns.
+        if self._addmwt_block:
+            self._addmwt_block.process_tree(root)
+
         if self._fixchain_block:
             self._fixchain_block.process_tree(root)
 
-        if self.lang == 'pt':
+        if self.lang in {'pt', 'it'}:
             for node in root.descendants[2:]:
                 if node.deprel == 'goeswith' and node.prev_node.form == '-':
                     node.parent.form += '-' + node.form

From 8c875ec7865f06bff0e10121959f631b50f12b27 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 24 Apr 2017 03:15:22 +0200
Subject: [PATCH 0063/1374] handle deprel=fixed in ud.pt.AddMwt

---
 udapi/block/ud/pt/addmwt.py | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/udapi/block/ud/pt/addmwt.py b/udapi/block/ud/pt/addmwt.py
index c8361a95..f49232c8 100644
--- a/udapi/block/ud/pt/addmwt.py
+++ b/udapi/block/ud/pt/addmwt.py
@@ -79,6 +79,23 @@ class AddMwt(udapi.block.ud.addmwt.AddMwt):
     def multiword_analysis(self, node):
         """Return a dict with MWT info or None if `node` does not represent a multiword token."""
         analysis = MWTS.get(node.form.lower(), None)
+
+        # If the input is e.g.:
+        # 1   na      _ ADP  _ _ deprel_x ?
+        # 2   verdade _ NOUN _ _ fixed    1
+        # The expected output is:
+        # 1-2 na      _ _    _ _ _        _
+        # 1   em      _ ADP  _ _ deprel_x ?
+        # 2   a       _ DET  _ _ fixed    1
+        # 3   verdade _ NOUN _ _ fixed    1
+        if analysis and analysis['deprel'] == 'case det' and node.udeprel != 'case':
+            copy = dict(analysis)
+            copy['deprel'] = '* det'
+            copy['shape'] = 'subtree'
+            first_child = next((c for c in node.children if node.precedes(c)), None)
+            if first_child is not None and first_child.udeprel == 'fixed':
+                copy['deprel'] = '* fixed'
+            return copy
         if analysis is not None:
             return analysis
 

From 6ca5db8866aa33ae483332276dcf2c9d8a824721 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 24 Apr 2017 03:27:54 +0200
Subject: [PATCH 0064/1374] fix PT goeswith->compound

---
 udapi/block/ud/google2ud.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 5cb0dd10..1f35f63b 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -173,6 +173,12 @@ def process_tree(self, root):
                     node.prev_node.remove(children='rehang')
                     node.remove(children='rehang')
 
+        # This must follow fixing the hyphen-goeswith. E.g. "Primeira Dama"
+        if self.lang in {'pt'}:
+            for node in root.descendants:
+                if node.deprel == 'goeswith':
+                    node.deprel = 'compound'
+
     @staticmethod
     def fix_feats(node):
         """Remove language prefixes, capitalize names and values, apply FEATS_CHANGE."""

From 80a4f5b36991552f0ebc6e2a27e091fbd7f893fe Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 24 Apr 2017 16:45:22 +0200
Subject: [PATCH 0065/1374] gmod -> nmod (not amod)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

gmod means (most probably) genitive modifier, so it is mostly with nouns.
If the word does not contain Case=Gen
(e.g. in Arabic which is written without كسرة (kasra)),
we keep nmod:gmod as the label, so we don't loose the information.
---
 udapi/block/ud/google2ud.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 1f35f63b..e7043ed3 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -25,7 +25,6 @@
     "prt": "compound:prt",
     "preconj": "cc:preconj",
     "predet": "det:predet",
-    "gmod": "amod",
     "gobj": "obj",
     "postneg": "neg",  # will be changed to advmod + Polarity=Neg in ud.Convert1to2
     "pronl": "obj",  # TODO: or expl? UD_French seems to use a mix of both
@@ -289,3 +288,5 @@ def fix_deprel(self, node):
         elif node.deprel == 'suff':
             node.misc['OrigDeprel'] = 'suff'
             node.deprel = 'dep'
+        elif node.deprel == 'gmod':
+            node.deprel = 'nmod' if node.feats['Case'] == 'Gen' else 'nmod:gmod'

From a068a4f9e6e15ddc9f33c74aa8165bb437107b05 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 24 Apr 2017 17:39:22 +0200
Subject: [PATCH 0066/1374] merge goeswith-hyphen tokens also in Russian

but make sure to not apply the rule on unexpected structures
---
 udapi/block/ud/google2ud.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index e7043ed3..20b40be7 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -164,9 +164,11 @@ def process_tree(self, root):
         if self._fixchain_block:
             self._fixchain_block.process_tree(root)
 
-        if self.lang in {'pt', 'it'}:
+        if self.lang in {'pt', 'it', 'ru'}:
             for node in root.descendants[2:]:
-                if node.deprel == 'goeswith' and node.prev_node.form == '-':
+                if (node.deprel == 'goeswith' and node.prev_node.form == '-'
+                    and node.parent == node.prev_node.parent
+                    and node.parent == node.prev_node.prev_node):
                     node.parent.form += '-' + node.form
                     node.parent.misc['SpaceAfter'] = node.misc['SpaceAfter']
                     node.prev_node.remove(children='rehang')

From da6a26f8edde0e4f7299859c3d86d4a4129b2e0f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 24 Apr 2017 18:28:05 +0200
Subject: [PATCH 0067/1374] use ud.FixRightheaded (so far for Hindi only)

---
 udapi/block/ud/fixrightheaded.py | 31 +++++++++++++++++++++++++++++++
 udapi/block/ud/google2ud.py      | 10 ++++++++++
 2 files changed, 41 insertions(+)
 create mode 100644 udapi/block/ud/fixrightheaded.py

diff --git a/udapi/block/ud/fixrightheaded.py b/udapi/block/ud/fixrightheaded.py
new file mode 100644
index 00000000..0bb7d28c
--- /dev/null
+++ b/udapi/block/ud/fixrightheaded.py
@@ -0,0 +1,31 @@
+"""Block ud.FixRightheaded for making sure flat,fixed,appos,goeswith,list is head initial.
+
+Note that deprel=conj should also be left-headed,
+but it is not included in this fix-block by default
+because coordinations are more difficult to convert
+and one should use a specialized block instead.
+"""
+from udapi.core.block import Block
+
+
+class FixRightheaded(Block):
+    """Make sure deprel=flat,fixed,... form a head-initial (i.e. left-headed) structure."""
+
+    def __init__(self, deprels='flat,fixed,appos,goeswith,list', **kwargs):
+        """Args:
+        deprels: comma-separated list of deprels to be fixed.
+            Default = flat,fixed,appos,goeswith,list.
+        """
+        super().__init__(**kwargs)
+        self.deprels = deprels.split(',')
+
+    def process_node(self, node):
+        for deprel in self.deprels:
+            if node.deprel == deprel and node.precedes(node.parent):
+                orig_parent = node.parent
+                node.parent = orig_parent.parent
+                for child in orig_parent.children:
+                    child.parent = node
+                orig_parent.parent = node
+                node.deprel = orig_parent.deprel
+                orig_parent.deprel = deprel
diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 20b40be7..ffd7d4c9 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -6,6 +6,7 @@
 from udapi.block.ud.convert1to2 import Convert1to2
 from udapi.block.ud.complywithtext import ComplyWithText
 from udapi.block.ud.fixchain import FixChain
+from udapi.block.ud.fixrightheaded import FixRightheaded
 from udapi.block.ud.de.addmwt import AddMwt as de_AddMwt
 from udapi.block.ud.pt.addmwt import AddMwt as pt_AddMwt
 
@@ -118,6 +119,10 @@ def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
         elif lang == 'pt':
             self._addmwt_block = pt_AddMwt()
 
+        self._fixrigheaded_block = None
+        if lang in {'hi'}:
+            self._fixrigheaded_block = FixRightheaded()
+
         self._fixchain_block = None
         if lang in {'pt'}:
             self._fixchain_block = FixChain()
@@ -161,6 +166,11 @@ def process_tree(self, root):
         if self._addmwt_block:
             self._addmwt_block.process_tree(root)
 
+        # deprel=fixed,flat,... should be always head-initial
+        if self._fixrigheaded_block:
+            self._fixrigheaded_block.process_tree(root)
+
+        # and it form a flat structure, not a chain.
         if self._fixchain_block:
             self._fixchain_block.process_tree(root)
 

From 9e24cce5a02cfae0b60bdf7e7b2349986c8925f5 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 24 Apr 2017 18:53:44 +0200
Subject: [PATCH 0068/1374] comma (or other PUNCT) in coordination should have
 deprel=punct, not cc

---
 udapi/block/ud/google2ud.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index ffd7d4c9..e37813b2 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -302,3 +302,6 @@ def fix_deprel(self, node):
             node.deprel = 'dep'
         elif node.deprel == 'gmod':
             node.deprel = 'nmod' if node.feats['Case'] == 'Gen' else 'nmod:gmod'
+        elif node.deprel == 'cc':
+            if node.upos == 'PUNCT' and node.form == ',':
+                node.deprel = 'punct'

From 09e66b9b8574bd212871f9c9661715e55e53f494 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 24 Apr 2017 20:10:44 +0200
Subject: [PATCH 0069/1374] more languages need  ud.FixRightheaded

---
 udapi/block/ud/google2ud.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index e37813b2..5815bfa9 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -120,7 +120,8 @@ def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
             self._addmwt_block = pt_AddMwt()
 
         self._fixrigheaded_block = None
-        if lang in {'hi'}:
+        # TODO: add 'de'
+        if lang in {'ar', 'en', 'fr', 'hi', 'ru', 'th', 'tr', 'zh'}:
             self._fixrigheaded_block = FixRightheaded()
 
         self._fixchain_block = None

From 8a0ed798559af9821ecd629a157fc8162df6281a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 25 Apr 2017 15:56:19 +0200
Subject: [PATCH 0070/1374] add tutorial.AddArticles template

---
 udapi/block/tutorial/addarticles.py | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 udapi/block/tutorial/addarticles.py

diff --git a/udapi/block/tutorial/addarticles.py b/udapi/block/tutorial/addarticles.py
new file mode 100644
index 00000000..20a4295f
--- /dev/null
+++ b/udapi/block/tutorial/addarticles.py
@@ -0,0 +1,10 @@
+"""tutorial.AddArticles block template."""
+from udapi.core.block import Block
+
+class AddArticles(Block):
+    """Heuristically insert English articles."""
+
+    def process_node(self, node):
+        if node.upos == "NOUN":
+            the = node.create_child(form="the", lemma="the", upos="DET", deprel="det")
+            the.shift_before_subtree(node)

From 6738a56a5f28e50fb08a1e8e8b30dfe0f8b3ca35 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 25 Apr 2017 19:26:21 +0200
Subject: [PATCH 0071/1374] draft of ud.FixPunct

---
 udapi/block/ud/fixpunct.py | 57 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 udapi/block/ud/fixpunct.py

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
new file mode 100644
index 00000000..83663748
--- /dev/null
+++ b/udapi/block/ud/fixpunct.py
@@ -0,0 +1,57 @@
+"""Block ud.FixPunct for making sure punctuation is attached projectively.
+
+Punctuation in Universal Dependencies has the tag PUNCT, dependency relation punct,
+and is always attached projectively, usually to the head of a neighboring subtree
+to its left or right.
+Punctuation normally does not have children. If it does, we will skip it.
+It is unclear what to do anyway, and we won't have to check for cycles.
+
+Tries to re-attach punctuation projectively.
+It should help in cases where punctuation is attached randomly, always to the root
+or always to the neighboring word. However, there are limits to what it can do;
+for example it cannot always recognize whether a comma is introduced to separate
+the block to its left or to its right. Hence if the punctuation before running
+this block is almost good, the block may actually do more harm than good.
+
+Since the punctuation should not have children, we should not create a non-projectivity
+if we check the roof edges going to the right.
+However, it is still possible that we will attach the punctuation non-projectively
+by joining a non-projectivity that already exists.
+For example, the left neighbor (node i-1) may have its parent at i-3,
+and the node i-2 forms a gap (does not depend on i-3).
+"""
+from udapi.core.block import Block
+
+
+class FixPunct(Block):
+    """Make sure punct nodes are attached punctuation is attached projectively."""
+
+    def process_node(self, node):
+        # TODO fix punct-child
+        if node.upos != "PUNCT" or not node.is_leaf():
+            return
+
+        # Initialize the candidates (left and right) with the nearest nodes excluding punctuation.
+        l_cand, r_cand = node.prev_node, node.next_node
+        while l_cand.ord > 0 and l_cand.upos == "PUNCT":
+            l_cand = l_cand.prev_node
+        while r_cand is not None and r_cand.upos == "PUNCT":
+            r_cand = r_cand.next_node
+
+        # Climb up from the candidates, until we would reach the root or "cross" the punctuation.
+        if l_cand.is_root():
+            l_cand = None
+        else:
+            while not l_cand.parent.is_root() and l_cand.parent.precedes(node):
+                l_cand = l_cand.parent
+        if r_cand is not None:
+            while not r_cand.parent.is_root() and node.precedes(r_cand.parent):
+                r_cand = r_cand.parent
+
+        # Now select between l_cand and r_cand -- which will be the new parent?
+        # The lower one. Note that one if neither is descendant of the other and neither is None
+        # (which can happen in rare non-projective cases), we arbitrarily prefer r_cand.
+        if l_cand is not None and not l_cand.is_root() and l_cand.is_descendant_of(r_cand):
+            node.parent = l_cand
+        elif r_cand is not None:
+            node.parent = r_cand

From 81f5684b77757dfa876d419508afcee5a2c31eba Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 25 Apr 2017 20:13:05 +0200
Subject: [PATCH 0072/1374] fix NUM/det -> DET/det

---
 udapi/block/ud/google2ud.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 5815bfa9..e78d63eb 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -253,6 +253,9 @@ def fix_upos(self, node):
         if node.upos == 'PUNCT' and node.form in ('$', '£'):
             node.upos = 'SYM'
 
+        if node.upos == "NUM" and node.deprel == "det" and not node.form.isnumeric():
+            node.upos = "DET"
+
     def fix_deprel(self, node):
         """Convert Google dependency relations to UD deprels.
 

From cbb25c24e8d0826e58ef6661245c8103cc15566d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 26 Apr 2017 11:37:24 +0200
Subject: [PATCH 0073/1374] just comments

---
 udapi/block/ud/google2ud.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index e78d63eb..92686e82 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -81,8 +81,8 @@
     "person_antecedent=3_a": "Person[psor]=3",
     "definiteness=def": "Definite=Def",
     "definiteness=indef": "Definite=Ind",
-    "mood=sub1": "Mood=Sub",  # TODO: what is the difference between sub1 and sub2 in German?
-    "mood=sub2": "Mood=Sub",
+    "mood=sub1": "Mood=Sub",  # TODO: Tense=Pres (in German)
+    "mood=sub2": "Mood=Sub",  # TODO: Tense=Past (in German)
     "mood=inter": "PronType=Int",  # TODO or keep Mood=Inter (it is used in UD_Chinese)
     "tense=cnd": "Mood=Cnd",
     "degree=sup_a": "Degree=Abs",
@@ -175,11 +175,11 @@ def process_tree(self, root):
         if self._fixchain_block:
             self._fixchain_block.process_tree(root)
 
-        if self.lang in {'pt', 'it', 'ru'}:
+        if self.lang in {'it', 'pt', 'ru'}:
             for node in root.descendants[2:]:
                 if (node.deprel == 'goeswith' and node.prev_node.form == '-'
-                    and node.parent == node.prev_node.parent
-                    and node.parent == node.prev_node.prev_node):
+                        and node.parent == node.prev_node.parent
+                        and node.parent == node.prev_node.prev_node):
                     node.parent.form += '-' + node.form
                     node.parent.misc['SpaceAfter'] = node.misc['SpaceAfter']
                     node.prev_node.remove(children='rehang')
@@ -272,7 +272,7 @@ def fix_deprel(self, node):
             else:
                 node.deprel = 'compound'
         elif node.deprel in ('pobj', 'pcomp'):
-            if node.parent.deprel in ('case', 'prep'):
+            if node.parent.deprel in ('case', 'prep'):  # or node.parent.upos in ('DET', 'ADP'):
                 preposition = node.parent
                 node.parent = preposition.parent
                 preposition.parent = node

From 653e0e6433efb032d70adcbfeb4133aeb8aa439e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 26 Apr 2017 15:00:03 +0200
Subject: [PATCH 0074/1374] ud.FixPunct handles also paired punctuation and is
 applied on German

---
 udapi/block/ud/fixpunct.py  | 62 ++++++++++++++++++++++++++++++++++---
 udapi/block/ud/google2ud.py | 25 ++++++++-------
 2 files changed, 71 insertions(+), 16 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 83663748..5ab962fc 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -21,16 +21,36 @@
 and the node i-2 forms a gap (does not depend on i-3).
 """
 from udapi.core.block import Block
+# pylint: disable=no-self-use
 
+PAIRED_PUNCT = {
+    '(': ')',
+    '[': ']',
+    '{': '}',
+    '„': '“', # Czech and German quotation marks
+    }
 
 class FixPunct(Block):
     """Make sure punct nodes are attached punctuation is attached projectively."""
 
-    def process_node(self, node):
-        # TODO fix punct-child
-        if node.upos != "PUNCT" or not node.is_leaf():
-            return
+    def process_tree(self, root):
+        # First, make sure no PUNCT has children
+        for node in root.descendants:
+            while node.parent.upos == "PUNCT":
+                node.parent = node.parent.parent
 
+        # Then make sure subordinate punctuations have correct parent.
+        for node in root.descendants:
+            if node.upos == "PUNCT":
+                self._fix_subord_punct(node)
+
+        # Then fix paired punctuations: quotes and brackets.
+        for node in root.descendants:
+            closing_punct = PAIRED_PUNCT.get(node.form, None)
+            if closing_punct is not None:
+                self._fix_paired_punct(root, node, closing_punct)
+
+    def _fix_subord_punct(self, node):
         # Initialize the candidates (left and right) with the nearest nodes excluding punctuation.
         l_cand, r_cand = node.prev_node, node.next_node
         while l_cand.ord > 0 and l_cand.upos == "PUNCT":
@@ -53,5 +73,39 @@ def process_node(self, node):
         # (which can happen in rare non-projective cases), we arbitrarily prefer r_cand.
         if l_cand is not None and not l_cand.is_root() and l_cand.is_descendant_of(r_cand):
             node.parent = l_cand
+            node.deprel = "punct"
         elif r_cand is not None:
             node.parent = r_cand
+            node.deprel = "punct"
+
+    def _fix_paired_punct(self, root, opening_node, closing_punct):
+        nested_level = 0
+        for node in root.descendants[opening_node.ord:]:
+            if node.form == opening_node.form:
+                nested_level += 1
+            elif node.form == closing_punct:
+                if nested_level > 0:
+                    nested_level -= 0
+                else:
+                    self._fix_pair(root, opening_node, node)
+                    return
+
+    def _fix_pair(self, root, opening_node, closing_node):
+        head = None
+        for node in root.descendants[opening_node.ord : closing_node.ord - 1]:
+            if node.parent.precedes(opening_node) or closing_node.precedes(node.parent):
+                if head is not None:
+                    return
+                else:
+                    head = node
+
+        closing_node.parent = head
+        opening_node.parent = head
+        # We expect at least one of the brackets to be already attached to the head
+        # (and the other probably higher).
+        # If it is not the case, maybe there are projectivity issues
+        # and we should not enforce attachment to the head.
+        #if opening_node.parent == head:
+        #    closing_node.parent = head
+        #elif closing_node.parent == head:
+        #    opening_node.parent = head
diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 92686e82..346e6629 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -7,6 +7,7 @@
 from udapi.block.ud.complywithtext import ComplyWithText
 from udapi.block.ud.fixchain import FixChain
 from udapi.block.ud.fixrightheaded import FixRightheaded
+from udapi.block.ud.fixpunct import FixPunct
 from udapi.block.ud.de.addmwt import AddMwt as de_AddMwt
 from udapi.block.ud.pt.addmwt import AddMwt as pt_AddMwt
 
@@ -113,6 +114,7 @@ def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
         """
         super().__init__(**kwargs)
         self.lang = lang
+
         self._addmwt_block = None
         if lang == 'de':
             self._addmwt_block = de_AddMwt()
@@ -124,6 +126,10 @@ def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
         if lang in {'ar', 'en', 'fr', 'hi', 'ru', 'th', 'tr', 'zh'}:
             self._fixrigheaded_block = FixRightheaded()
 
+        self._fixpunct_block = None
+        if lang in {'de'}:
+            self._fixpunct_block = FixPunct()
+
         self._fixchain_block = None
         if lang in {'pt'}:
             self._fixchain_block = FixChain()
@@ -162,18 +168,13 @@ def process_tree(self, root):
         # call ud.Convert1to2
         super().process_tree(root)
 
-        # In German: "im" -> "in dem" etc.
-        # This needs to be applied after prepositions are under nouns.
-        if self._addmwt_block:
-            self._addmwt_block.process_tree(root)
-
-        # deprel=fixed,flat,... should be always head-initial
-        if self._fixrigheaded_block:
-            self._fixrigheaded_block.process_tree(root)
-
-        # and it form a flat structure, not a chain.
-        if self._fixchain_block:
-            self._fixchain_block.process_tree(root)
+        for block in (
+                self._addmwt_block,        # e.g. "im" -> "in dem" in de. Must follow Convert1to2.
+                self._fixrigheaded_block,  # deprel=fixed,flat,... should be always head-initial
+                self._fixchain_block,      # and form a flat structure, not a chain.
+                self._fixpunct_block):     # commas should depend on the subord unit.
+            if block:
+                block.process_tree(root)
 
         if self.lang in {'it', 'pt', 'ru'}:
             for node in root.descendants[2:]:

From f7077ef495bb260111b759212ac631c5d0a72b3f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 26 Apr 2017 17:34:31 +0200
Subject: [PATCH 0075/1374] pylint's disable does not fit "the same line"

---
 udapi/block/write/textmodetreeshtml.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/write/textmodetreeshtml.py b/udapi/block/write/textmodetreeshtml.py
index 4da977a5..a90b7ef7 100644
--- a/udapi/block/write/textmodetreeshtml.py
+++ b/udapi/block/write/textmodetreeshtml.py
@@ -42,8 +42,8 @@ def __init__(self, color=True, title='Udapi visualization', **kwargs):
     def before_process_document(self, document):
         # TextModeTrees.before_process_document changes the color property,
         # we need to skip this, but call BaseWriter's method which redirects stdout.
-        super(TextModeTrees, self).before_process_document(
-            document)  # pylint: disable=bad-super-call
+        # pylint: disable=bad-super-call
+        super(TextModeTrees, self).before_process_document(document)
         print('<!DOCTYPE html>\n<html>\n<head>\n<meta charset="utf-8">')
         print('<title>' + self.title + '</title>')
         print('<style>' + STYLE)

From 2cb303d4853d464bec2db1bdefbbbca059378c70 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 26 Apr 2017 17:35:45 +0200
Subject: [PATCH 0076/1374] cosmetic update of write.TextModeTrees
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

A visual aid so it is easier to recognize
whether a given node precedes or follows its parent.
Imagine there are many siblings
(or some of the siblings have many descendants),
so they may end up far away from their parent
and the parent cannot be easily found.
The old visualization was:
```
 ╭─╼ a
 ├─╼ b
 ...
 ├─╼ k
─┾ parent
 ├─╼ l
 ...
 ├─╼ y
 ╰─╼ z
```

Now, we have:
```
 ╭─╼ a
 ┢─╼ b
 ...
 ┢─╼ k
─┾ parent
 ┡─╼ l
 ...
 ┡─╼ y
 ╰─╼ z
```
Thanks to @danzeman for feedback.
---
 udapi/block/write/textmodetrees.py | 10 +++++-----
 udapi/core/tests/test_node.py      | 10 +++++-----
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index d32a5fe1..2c9c9f31 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -133,10 +133,10 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         self._horiz = line + '╼'
         self._draw = [[line + '┾', line + '┮'], [line + '┶', self._horiz]]
 
-        # _space[is_bottommost][is_topmost]
+        # _space[precedes_parent][is_topmost_or_bottommost]
         # _vert[is_crossing]
         space = ' ' * indent
-        self._space = [[space + '├', space + '╭'], [space + '╰']]
+        self._space = [[space + '┡', space + '╰'], [space + '┢', space + '╭']]
         self._vert = [space + '│', line + '╪']
 
         self.attrs = attributes.split(',')
@@ -195,7 +195,7 @@ def process_tree(self, root):
             max_length = max([self.lengths[i] for i in range(min_idx, max_idx + 1)])
             for idx in range(min_idx, max_idx + 1):
                 idx_node = allnodes[idx]
-                filler = '─' if self._ends(idx, '─╭╰├╪') else ' '
+                filler = '─' if self._ends(idx, '─╭╰╪┡┢') else ' '
                 self._add(idx, filler * (max_length - self.lengths[idx]))
 
                 topmost = idx == min_idx
@@ -205,9 +205,9 @@ def process_tree(self, root):
                     self.add_node(idx, node)
                 else:
                     if idx_node.parent is not node:
-                        self._add(idx, self._vert[self._ends(idx, '─╭╰├╪')])
+                        self._add(idx, self._vert[self._ends(idx, '─╭╰╪┡┢')])
                     else:
-                        self._add(idx, self._space[botmost][topmost])
+                        self._add(idx, self._space[idx < node.ord][topmost or botmost])
                         if idx_node.is_leaf():
                             self._add(idx, self._horiz)
                             self.add_node(idx, idx_node)
diff --git a/udapi/core/tests/test_node.py b/udapi/core/tests/test_node.py
index 695bf946..52e94722 100755
--- a/udapi/core/tests/test_node.py
+++ b/udapi/core/tests/test_node.py
@@ -68,17 +68,17 @@ def test_print_subtree(self):
                      "─┮\n"
                      " │ ╭─╼ Slovenská ADJ amod\n"
                      " ╰─┾ ústava NOUN root\n"
-                     "   ├─╼ : PUNCT punct\n"
+                     "   ┡─╼ : PUNCT punct\n"
                      "   ╰─┮ pro ADP appos\n"
-                     "     ├─╼ i CONJ cc\n"
+                     "     ┡─╼ i CONJ cc\n"
                      "     ╰─╼ proti ADP conj\n"
                      "\n")
         expected2 = ("─┮\n"
                      " │ ╭─╼ Slovenská Case=Nom|Degree=Pos|Gender=Fem|Negative=Pos|Number=Sing _\n"
                      " ╰─┾ ústava Case=Nom|Gender=Fem|Negative=Pos|Number=Sing SpaceAfter=No\n"
-                     "   ├─╼ : _ _\n"
+                     "   ┡─╼ : _ _\n"
                      "   ╰─┮ pro AdpType=Prep|Case=Acc LId=pro-1\n"
-                     "     ├─╼ i _ LId=i-1\n"
+                     "     ┡─╼ i _ LId=i-1\n"
                      "     ╰─╼ proti AdpType=Prep|Case=Dat LId=proti-1\n"
                      "\n")
 
@@ -91,7 +91,7 @@ def test_print_subtree(self):
         nodes[4].parent = nodes[2]
         expected3 = ("─┮\n"
                      " │ ╭─╼ 1\n"
-                     " ├─╪───┮ 2\n"
+                     " ┡─╪───┮ 2\n"
                      " ╰─┶ 3 │\n"
                      "       ╰─╼ 4\n"
                      "\n")

From e772bf419320f6e3a48bbeb7689cefe2a08718d2 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 27 Apr 2017 15:09:58 +0200
Subject: [PATCH 0077/1374] one feature can be mapped to multiple features

(This makes no differences in German, as the data consistently used
Tense=Pres with sub1 and Tense=Pase with sub2.)
---
 udapi/block/ud/google2ud.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 346e6629..6f0787a2 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -82,8 +82,8 @@
     "person_antecedent=3_a": "Person[psor]=3",
     "definiteness=def": "Definite=Def",
     "definiteness=indef": "Definite=Ind",
-    "mood=sub1": "Mood=Sub",  # TODO: Tense=Pres (in German)
-    "mood=sub2": "Mood=Sub",  # TODO: Tense=Past (in German)
+    "mood=sub1": "Mood=Sub|Tense=Pres",  # de
+    "mood=sub2": "Mood=Sub|Tense=Past",  # de
     "mood=inter": "PronType=Int",  # TODO or keep Mood=Inter (it is used in UD_Chinese)
     "tense=cnd": "Mood=Cnd",
     "degree=sup_a": "Degree=Abs",
@@ -187,7 +187,7 @@ def process_tree(self, root):
                     node.remove(children='rehang')
 
         # This must follow fixing the hyphen-goeswith. E.g. "Primeira Dama"
-        if self.lang in {'pt'}:
+        if self.lang in {'pt', 'de'}:
             for node in root.descendants:
                 if node.deprel == 'goeswith':
                     node.deprel = 'compound'
@@ -207,8 +207,9 @@ def fix_feats(node):
             new = FEATS_CHANGE.get(name + '=' + value)
             if new is not None:
                 if new != '':
-                    new_name, new_value = new.split('=')
-                    node.feats[new_name] = new_value
+                    for new_pair in new.split('|'):
+                        new_name, new_value = new_pair.split('=')
+                        node.feats[new_name] = new_value
             elif name[0].isupper():
                 node.feats[name] = value
             else:

From 2dcb3ab7d767f3266526ec97a4bb1886e26b815b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 27 Apr 2017 15:39:53 +0200
Subject: [PATCH 0078/1374] parataxis->conj if preceded by cc

---
 udapi/block/ud/google2ud.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 6f0787a2..4d3575bb 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -311,3 +311,8 @@ def fix_deprel(self, node):
         elif node.deprel == 'cc':
             if node.upos == 'PUNCT' and node.form == ',':
                 node.deprel = 'punct'
+        elif node.deprel == 'parataxis':
+            if node.children:
+                cc_node = node.descendants[0].prev_node
+                if cc_node.udeprel == 'cc' and cc_node.parent == node.parent:
+                    node.deprel = 'conj'

From 490c5501409ecbe5d9b06ebdaf481db76504ded3 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 27 Apr 2017 16:49:25 +0200
Subject: [PATCH 0079/1374] add English translations

---
 udapi/block/ud/google2ud.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 4d3575bb..5baa3453 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -144,7 +144,8 @@ def process_tree(self, root):
         comment_lines = root.comment.split("\n")
         root.sent_id = comment_lines[0].strip().replace(' ', '-')
         root.text = comment_lines[1].strip()
-        root.comment = ''
+        # The third line of comments contains the English translation.
+        root.comment = '' if self.lang == "en" or len(comment_lines) < 3 else comment_lines[2]
 
         if self._comply_block:
             self._comply_block.process_tree(root)

From c0a92c4cb451139563caf097dded3d5ea7743f92 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 27 Apr 2017 17:48:43 +0200
Subject: [PATCH 0080/1374] German: infinitive-marking "zu": CONJ/cc ->
 PART/mark

---
 udapi/block/ud/google2ud.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 5baa3453..4947af9e 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -259,6 +259,11 @@ def fix_upos(self, node):
         if node.upos == "NUM" and node.deprel == "det" and not node.form.isnumeric():
             node.upos = "DET"
 
+        if self.lang == 'de' and node.upos == 'CONJ' and node.form.lower() == 'zu':
+            node.deprel = 'mark'
+            node.upos = 'PART'
+            node.xpos = 'RP'
+
     def fix_deprel(self, node):
         """Convert Google dependency relations to UD deprels.
 

From d334291bdea48439f7f5d5956bce31f2be9133ed Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 27 Apr 2017 17:49:10 +0200
Subject: [PATCH 0081/1374] util.Mark add=0 causes all previously marked nodes
 to get unmarked

---
 udapi/block/util/mark.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/udapi/block/util/mark.py b/udapi/block/util/mark.py
index 02682a92..c57f7443 100644
--- a/udapi/block/util/mark.py
+++ b/udapi/block/util/mark.py
@@ -15,7 +15,7 @@ class Mark(Block):
     udapy -TM util.Mark node='node.is_nonprojective()' < in | less -R
     """
 
-    def __init__(self, node, mark=1, **kwargs):
+    def __init__(self, node, mark=1, add=True, **kwargs):
         """Create the Mark block object.
 
         Args:
@@ -23,11 +23,18 @@ def __init__(self, node, mark=1, **kwargs):
             the node will be marked.
 
         `mark`: the node will be marked with `Mark=<mark>` in `node.misc`. Default=1.
+
+        `add`: should we keep existing Mark|ToDo|Bug? Default=True.
         """
         super().__init__(**kwargs)
         self.mark = mark
         self.node = node
+        self.add = add
 
     def process_node(self, node):
         if eval(self.node):
             node.misc['Mark'] = self.mark
+        elif not self.add:
+            del node.misc['Mark']
+            del node.misc['ToDo']
+            del node.misc['Bug']

From bd8cbe6f501ed3c9f9e92876016275bff11e9a04 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 27 Apr 2017 23:35:17 +0200
Subject: [PATCH 0082/1374] fix bug in conversion of coordinated prepositional
 phrases

---
 udapi/block/ud/google2ud.py | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 4947af9e..9b3f8c99 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -150,6 +150,10 @@ def process_tree(self, root):
         if self._comply_block:
             self._comply_block.process_tree(root)
 
+        # TODO solve multi-word prepositions first
+        # if node.deprel in ('pobj', 'pcomp'):
+        #   if node.parent.deprel in ('pobj', 'pcomp'):
+
         for node in root.descendants:
             self.fix_feats(node)
             self.fix_upos(node)
@@ -280,13 +284,19 @@ def fix_deprel(self, node):
             else:
                 node.deprel = 'compound'
         elif node.deprel in ('pobj', 'pcomp'):
-            if node.parent.deprel in ('case', 'prep'):  # or node.parent.upos in ('DET', 'ADP'):
+            if node.parent.deprel in ('case', 'prep', 'conj'):
                 preposition = node.parent
                 node.parent = preposition.parent
                 preposition.parent = node
 
                 # ud.Convert1to2 will change 'nmod' to 'obl' if needed
-                node.deprel = 'nmod' if node.deprel == 'pobj' else 'xcomp'  # TODO check xcomp
+                if preposition.deprel == 'conj':
+                    node.deprel = 'conj'
+                    preposition.deprel = 'case'
+                elif node.deprel == 'pobj':
+                    node.deprel = 'nmod'
+                else:
+                    node.deprel = 'xcomp'  # TODO check if pcomp -> xcomp is correct
 
                 # Prepositions should not have any children (except for deprel=fixed/mwe), see
                 # http://universaldependencies.org/u/overview/syntax.html#multiword-function-words.

From 7321e12a59bf01139b0ee75a8619eb2aeb91a6f9 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 28 Apr 2017 12:19:46 +0200
Subject: [PATCH 0083/1374] add missing "nisso"

---
 udapi/block/ud/pt/addmwt.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/pt/addmwt.py b/udapi/block/ud/pt/addmwt.py
index f49232c8..11ebfbbf 100644
--- a/udapi/block/ud/pt/addmwt.py
+++ b/udapi/block/ud/pt/addmwt.py
@@ -36,6 +36,7 @@
     'nesses':  {'form': 'em esses', 'lemma': 'em esse'},
     'nesta':   {'form': 'em esta', 'lemma': 'em este'},
     'neste':   {'form': 'em este', 'lemma': 'em este'},
+    'nisso':   {'form': 'em isso', 'lemma': 'em este'},
     'nisto':   {'form': 'em isto', 'lemma': 'em este',
                 'upos': 'ADP PRON', 'main': 1, 'shape': 'subtree'},
     'no':      {'form': 'em o', 'lemma': 'em o'},

From 40636139bc8a42a9a5af416ca3c96d50e0f5f223 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 28 Apr 2017 12:51:14 +0200
Subject: [PATCH 0084/1374] fix_multiword_prep

---
 udapi/block/ud/google2ud.py | 42 ++++++++++++++++++++++++++++++++++---
 1 file changed, 39 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 9b3f8c99..979cad0d 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -150,9 +150,9 @@ def process_tree(self, root):
         if self._comply_block:
             self._comply_block.process_tree(root)
 
-        # TODO solve multi-word prepositions first
-        # if node.deprel in ('pobj', 'pcomp'):
-        #   if node.parent.deprel in ('pobj', 'pcomp'):
+        # Multi-word prepositions must be solved before fix_deprel() fixes pobj+pcomp.
+        for node in root.descendants:
+            self.fix_multiword_prep(node)
 
         for node in root.descendants:
             self.fix_feats(node)
@@ -197,6 +197,42 @@ def process_tree(self, root):
                 if node.deprel == 'goeswith':
                     node.deprel = 'compound'
 
+    def fix_multiword_prep(self, node):
+        """Solve pobj/pcomp depending on pobj/pcomp.
+
+         Only some of these cases are multi-word prepositions (which should get deprel=fixed).
+         """
+        if node.deprel in ('pobj', 'pcomp') and node.parent.deprel in ('pobj', 'pcomp'):
+            lo_prep = node.parent
+            hi_prep = node.parent.parent
+            if hi_prep.deprel != 'prep':
+                return
+            # E.g. in "from A to B", the Google style attaches "to"/pcomp under "from"/prep.
+            # Let's use this heuristics: if the prepositions are not next to each other,
+            # they should be siblings (as in "from A to B").
+            if abs(lo_prep.ord - hi_prep.ord) != 1:
+                lo_prep.parent = hi_prep.parent
+                lo_prep.deprel = 'prep'
+            # Some languages (e.g. pt) in UDv2 do not use multi-word prepositions at all.
+            elif self.lang in {'pt'}:
+                node.parent = hi_prep
+                lo_prep.parent = node
+                lo_prep.deprel = 'case'
+            # Otherwise, they are probably multi-word prepositions, e.g. "according to",
+            # but they can also be sibling prepositions, e.g. "out of".
+            # The Google style does not distinguish those and I don't see any heuristics,
+            # so let's mark these cases as ToDo.
+            else:
+                first_prep, second_prep = hi_prep, lo_prep
+                if lo_prep.precedes(hi_prep):
+                    first_prep, second_prep = lo_prep, hi_prep
+                    first_prep.parent = hi_prep.parent
+                    second_prep.parent = first_prep
+                for prep_child in second_prep.children:
+                    prep_child.parent = first_prep
+                second_prep.deprel = 'fixed'
+                self.log(second_prep, 'unsure-multi-prep', 'deprel=fixed, but may be siblings')
+
     @staticmethod
     def fix_feats(node):
         """Remove language prefixes, capitalize names and values, apply FEATS_CHANGE."""

From b13335712afee33d6f5e13ba56ead6c828f98cc9 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 28 Apr 2017 20:04:16 +0200
Subject: [PATCH 0085/1374] fix_goeswith for fr and _merge_with that merges
 also feats

---
 udapi/block/ud/google2ud.py | 42 +++++++++++++++++++++++++++++++++----
 1 file changed, 38 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 979cad0d..dd029fba 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -147,9 +147,15 @@ def process_tree(self, root):
         # The third line of comments contains the English translation.
         root.comment = '' if self.lang == "en" or len(comment_lines) < 3 else comment_lines[2]
 
+        # ud.ComplyWithText is the very first step because it may change the tokenization
+        # and also it fills SpaceAfter=No, which is used in further steps.
         if self._comply_block:
             self._comply_block.process_tree(root)
 
+        # deprel=goeswith must be fixed next because it also changes tokenization
+        for node in root.descendants:
+            self.fix_goeswith(node)
+
         # Multi-word prepositions must be solved before fix_deprel() fixes pobj+pcomp.
         for node in root.descendants:
             self.fix_multiword_prep(node)
@@ -186,10 +192,8 @@ def process_tree(self, root):
                 if (node.deprel == 'goeswith' and node.prev_node.form == '-'
                         and node.parent == node.prev_node.parent
                         and node.parent == node.prev_node.prev_node):
-                    node.parent.form += '-' + node.form
-                    node.parent.misc['SpaceAfter'] = node.misc['SpaceAfter']
-                    node.prev_node.remove(children='rehang')
-                    node.remove(children='rehang')
+                    self._merge_with(node.parent, node.prev_node)
+                    self._merge_with(node.parent, node)
 
         # This must follow fixing the hyphen-goeswith. E.g. "Primeira Dama"
         if self.lang in {'pt', 'de'}:
@@ -197,6 +201,36 @@ def process_tree(self, root):
                 if node.deprel == 'goeswith':
                     node.deprel = 'compound'
 
+    def fix_goeswith(self, node):
+        """Solve deprel=goeswith which is almost always wrong in the Google annotation."""
+        if node.deprel != 'goeswith':
+            return
+        if self.lang in {'fr'}:
+            if node.parent.precedes(node) and node.prev_node.misc['SpaceAfter'] == 'No':
+                self._merge_with(node.prev_node, node)
+            elif node.precedes(node.parent) and node.misc['SpaceAfter'] == 'No':
+                self._merge_with(node.next_node, node)
+
+    @staticmethod
+    def _merge_with(node, delete_node):
+        """Concat forms, merge feats, remove `delete_node`, and keep SpaceAfter of the right node.
+
+        Should be called only on neighboring nodes.
+        """
+        if node.precedes(delete_node):
+            node.form += delete_node.form
+            node.misc['SpaceAfter'] = delete_node.misc['SpaceAfter']
+        else:
+            node.form = delete_node.form + node.form
+        if node.parent == delete_node:
+            node.parent = delete_node.parent
+        for child in delete_node.children:
+            child.parent = node
+        delete_node.feats.update(node.feats)
+        node.feats = delete_node.feats
+        # node.misc['Merge'] = 1
+        delete_node.remove()
+
     def fix_multiword_prep(self, node):
         """Solve pobj/pcomp depending on pobj/pcomp.
 

From 045dfaa9763231fdc3cacb998bf710242d13a43e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 29 Apr 2017 10:20:43 +0200
Subject: [PATCH 0086/1374] node.no_space_after - syntactic sugar Boolean
 property

a shortcut for `node.misc["SpaceAfter"] == "No"`
---
 udapi/core/node.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index b268e081..feec38a6 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -631,6 +631,11 @@ def is_nonprojective(self):
         # For projective edges, span must include all the nodes between parent and self.
         return len(span) != distance - 1
 
+    @property
+    def no_space_after(self):
+        """Boolean property as a shortcut for `node.misc["SpaceAfter"] == "No"`."""
+        return self.misc["SpaceAfter"] == "No"
+
 
 class ListOfNodes(list):
     """Helper class for results of node.children and node.descendants.

From 96e8537859c208077968bb92d570447f0c5e47dd Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 29 Apr 2017 11:24:28 +0200
Subject: [PATCH 0087/1374] more principled solution of goeswith for
 de,fr,it,pt,ru

---
 udapi/block/ud/google2ud.py | 57 ++++++++++++++++++++++++-------------
 1 file changed, 37 insertions(+), 20 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index dd029fba..11deff14 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -152,9 +152,17 @@ def process_tree(self, root):
         if self._comply_block:
             self._comply_block.process_tree(root)
 
-        # deprel=goeswith must be fixed next because it also changes tokenization
-        for node in root.descendants:
-            self.fix_goeswith(node)
+        # `deprel=goeswith` must be fixed now because it also changes the number of nodes.
+        # Unlike UDv2, Google style uses `goeswith` mostly to fix "wrong" tokenization,
+        # e.g. "e-mail" written correctly without spaces, but tokenized into three words.
+        # Moreover, the hyphen is not always marked with `goeswith`.
+        if self.lang in {'de', 'fr', 'it', 'pt', 'ru'}:
+            for node in root.descendants:
+                if node.form == '-' and node.no_space_after and node.prev_node.no_space_after:
+                    if 'goeswith' in (node.prev_node.deprel, node.next_node.deprel):
+                        node.deprel = 'goeswith'
+            for node in root.descendants:
+                self.fix_goeswith(node)
 
         # Multi-word prepositions must be solved before fix_deprel() fixes pobj+pcomp.
         for node in root.descendants:
@@ -187,29 +195,38 @@ def process_tree(self, root):
             if block:
                 block.process_tree(root)
 
-        if self.lang in {'it', 'pt', 'ru'}:
-            for node in root.descendants[2:]:
-                if (node.deprel == 'goeswith' and node.prev_node.form == '-'
-                        and node.parent == node.prev_node.parent
-                        and node.parent == node.prev_node.prev_node):
-                    self._merge_with(node.parent, node.prev_node)
-                    self._merge_with(node.parent, node)
-
-        # This must follow fixing the hyphen-goeswith. E.g. "Primeira Dama"
-        if self.lang in {'pt', 'de'}:
-            for node in root.descendants:
-                if node.deprel == 'goeswith':
-                    node.deprel = 'compound'
-
     def fix_goeswith(self, node):
         """Solve deprel=goeswith which is almost always wrong in the Google annotation."""
         if node.deprel != 'goeswith':
             return
-        if self.lang in {'fr'}:
-            if node.parent.precedes(node) and node.prev_node.misc['SpaceAfter'] == 'No':
+
+        # It has been decided German should use "compound" and keep e.g. "E-mail" as three words.
+        # The only two cases we want to merge are:
+        # * dots marking ordinal numbers (21. Oktober) should be merged with the number
+        #   keeping the upos of the number (Google has the dot as parent, don't ask me why).
+        #   There are still bugs in the output ("Oktober" depends on "21.") which I give up.
+        # * apostrophes in foreign words "don't" or "Smith'" (the original English was "Smith's").
+        if self.lang == 'de':
+            if (node.precedes(node.parent) and node.misc['SpaceAfter'] == 'No'
+                    and node.next_node.form in ".'"):
+                node.next_node.upos = node.upos
+                self._merge_with(node.next_node, node)
+            elif (node.parent.precedes(node) and node.prev_node.misc['SpaceAfter'] == 'No'
+                  and node.prev_node.form in ".'"):
+                node.prev_node.upos = node.upos
                 self._merge_with(node.prev_node, node)
-            elif node.precedes(node.parent) and node.misc['SpaceAfter'] == 'No':
+            else:
+                node.deprel = 'compound'
+
+        # Other languages use goeswith for marking Google-tokenization errors.
+        # In Portuguese, there are in addition cases like "Primeira Dama".
+        elif self.lang in {'fr', 'it', 'pt', 'ru'}:
+            if node.precedes(node.parent) and node.misc['SpaceAfter'] == 'No':
                 self._merge_with(node.next_node, node)
+            elif node.parent.precedes(node) and node.prev_node.misc['SpaceAfter'] == 'No':
+                self._merge_with(node.prev_node, node)
+            elif self.lang in {'pt'}:
+                node.deprel = 'compound'
 
     @staticmethod
     def _merge_with(node, delete_node):

From cb78408fdc49a1cf11497e8efc8ee09c2dbb0d43 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 29 Apr 2017 14:53:29 +0200
Subject: [PATCH 0088/1374] French-specific edits and using flat:name for PROPN
 instead of compound

---
 udapi/block/ud/google2ud.py | 23 +++++++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 11deff14..adb4f160 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -103,6 +103,10 @@
     "Evidentiality=Fh": "Evident=Fh",
 }
 
+FR_DAYS_MONTHS = ('lundi mardi mercredi jeudi vendredi samedi dimanche '
+                  'janvier février mars avril mai juin juillet août '
+                  'septembre octobre novembre décembre'.split())
+
 
 class Google2ud(Convert1to2):
     """Convert Google Universal Dependency Treebank into UD style."""
@@ -161,6 +165,9 @@ def process_tree(self, root):
                 if node.form == '-' and node.no_space_after and node.prev_node.no_space_after:
                     if 'goeswith' in (node.prev_node.deprel, node.next_node.deprel):
                         node.deprel = 'goeswith'
+                    if self.lang == 'fr':
+                        node.deprel = 'goeswith'
+                        node.parent = node.next_node
             for node in root.descendants:
                 self.fix_goeswith(node)
 
@@ -168,9 +175,12 @@ def process_tree(self, root):
         for node in root.descendants:
             self.fix_multiword_prep(node)
 
+        # Fixing feats, upos and deprel in separate steps (the order is important).
         for node in root.descendants:
             self.fix_feats(node)
+        for node in root.descendants:
             self.fix_upos(node)
+        for node in root.descendants:
             self.fix_deprel(node)
 
         # This needs to be executed after all other deprels are converted
@@ -355,6 +365,9 @@ def fix_upos(self, node):
             node.upos = 'PART'
             node.xpos = 'RP'
 
+        if self.lang == 'fr' and node.upos == 'PROPN' and node.form.lower() in FR_DAYS_MONTHS:
+            node.upos = 'NOUN'
+
     def fix_deprel(self, node):
         """Convert Google dependency relations to UD deprels.
 
@@ -365,9 +378,9 @@ def fix_deprel(self, node):
         except KeyError:
             pass
 
-        if node.deprel == 'nn':
+        if node.deprel in ('nn', 'compound'):
             if node.upos == 'PROPN' and node.parent.upos == 'PROPN':
-                node.deprel = 'flat'
+                node.deprel = 'flat:name'
             else:
                 node.deprel = 'compound'
         elif node.deprel in ('pobj', 'pcomp'):
@@ -419,3 +432,9 @@ def fix_deprel(self, node):
                 cc_node = node.descendants[0].prev_node
                 if cc_node.udeprel == 'cc' and cc_node.parent == node.parent:
                     node.deprel = 'conj'
+        elif node.deprel == 'dislocated':
+            if self.lang == 'fr':
+                nsubj = next((n for n in node.parent.children if n.udeprel == 'nsubj'), None)
+                if nsubj is not None:
+                    node.deprel = 'nsubj'
+                    nsubj.deprel = 'expl'

From 13c75af5c2e1886d5b78efcff38a6f04157b183a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 29 Apr 2017 15:23:52 +0200
Subject: [PATCH 0089/1374] French: NOUN should not be expl according to
 Marie-Catherine

---
 udapi/block/ud/google2ud.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index adb4f160..31d1c418 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -437,4 +437,4 @@ def fix_deprel(self, node):
                 nsubj = next((n for n in node.parent.children if n.udeprel == 'nsubj'), None)
                 if nsubj is not None:
                     node.deprel = 'nsubj'
-                    nsubj.deprel = 'expl'
+                    nsubj.deprel = 'expl' if nsubj.upos == 'PRON' else 'dislocated'

From bcb29e1d923866c5a6c8e89d753d1a9a08e77075 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 29 Apr 2017 16:27:18 +0200
Subject: [PATCH 0090/1374] improve ud.FixPunct

- quotes around a phrase with multiple heads are attached
  to the best-possible heads
- quotes for multiple languages added
- subord punct rules are not applied to paired punct
  (and all punct is excluded from the head adepts)
---
 udapi/block/ud/fixpunct.py  | 43 +++++++++++++++++++++----------------
 udapi/block/ud/google2ud.py |  3 +--
 2 files changed, 25 insertions(+), 21 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 5ab962fc..2cdcd1fa 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -23,13 +23,25 @@
 from udapi.core.block import Block
 # pylint: disable=no-self-use
 
+# TODO Add a heuristics for ASCI "quotes".
+# TODO Add ‘single’ quotes, but make sure these symbols are not used e.g. as apostrophes.
+# TODO We need to know the language, there are many other quotation styles,
+#      e.g. Finnish and Swedish uses the same symbol for opening and closing: ”X”.
+#      Danish uses uses the French quotes, but switched: »X«.
 PAIRED_PUNCT = {
     '(': ')',
     '[': ']',
     '{': '}',
-    '„': '“', # Czech and German quotation marks
+    '“': '”',   # quotation marks used in English,...
+    '„': '“',   # Czech, German, Russian,...
+    '«': '»',   # French, Russian, Spanish,...
+    '‹': '›',   # dtto
+    '《': '》',  # Korean, Chinese
+    '「': '」',  # Chinese, Japanese
+    '『': '』',  # dtto
     }
 
+
 class FixPunct(Block):
     """Make sure punct nodes are attached punctuation is attached projectively."""
 
@@ -41,7 +53,7 @@ def process_tree(self, root):
 
         # Then make sure subordinate punctuations have correct parent.
         for node in root.descendants:
-            if node.upos == "PUNCT":
+            if node.upos == "PUNCT" and not PAIRED_PUNCT.get(node.form, None):
                 self._fix_subord_punct(node)
 
         # Then fix paired punctuations: quotes and brackets.
@@ -91,21 +103,14 @@ def _fix_paired_punct(self, root, opening_node, closing_punct):
                     return
 
     def _fix_pair(self, root, opening_node, closing_node):
-        head = None
-        for node in root.descendants[opening_node.ord : closing_node.ord - 1]:
+        heads = []
+        for node in root.descendants[opening_node.ord: closing_node.ord - 1]:
             if node.parent.precedes(opening_node) or closing_node.precedes(node.parent):
-                if head is not None:
-                    return
-                else:
-                    head = node
-
-        closing_node.parent = head
-        opening_node.parent = head
-        # We expect at least one of the brackets to be already attached to the head
-        # (and the other probably higher).
-        # If it is not the case, maybe there are projectivity issues
-        # and we should not enforce attachment to the head.
-        #if opening_node.parent == head:
-        #    closing_node.parent = head
-        #elif closing_node.parent == head:
-        #    opening_node.parent = head
+                if node.upos != 'PUNCT':
+                    heads.append(node)
+        if len(heads) == 1:
+            opening_node.parent = heads[0]
+            closing_node.parent = heads[0]
+        elif len(heads) > 1:
+            opening_node.parent = sorted(heads, key=lambda n: n.descendants(add_self=1)[0].ord)[0]
+            closing_node.parent = sorted(heads, key=lambda n: -n.descendants(add_self=1)[-1].ord)[0]
diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 31d1c418..9dc09567 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -126,8 +126,7 @@ def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
             self._addmwt_block = pt_AddMwt()
 
         self._fixrigheaded_block = None
-        # TODO: add 'de'
-        if lang in {'ar', 'en', 'fr', 'hi', 'ru', 'th', 'tr', 'zh'}:
+        if lang in {'ar', 'de', 'en', 'fr', 'hi', 'ru', 'th', 'tr', 'zh'}:
             self._fixrigheaded_block = FixRightheaded()
 
         self._fixpunct_block = None

From 8cab3b518597bec0b23321dfd49799ecc8a09016 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 29 Apr 2017 17:33:04 +0200
Subject: [PATCH 0091/1374] PROPN vs NOUN should be recognized based on
 xpos=NNP

rather than based on feats["Proper"]
---
 udapi/block/ud/fixpunct.py  |  2 +-
 udapi/block/ud/google2ud.py | 15 ++++++++-------
 2 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 2cdcd1fa..8cda6add 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -81,7 +81,7 @@ def _fix_subord_punct(self, node):
                 r_cand = r_cand.parent
 
         # Now select between l_cand and r_cand -- which will be the new parent?
-        # The lower one. Note that one if neither is descendant of the other and neither is None
+        # The lower one. Note that if neither is descendant of the other and neither is None
         # (which can happen in rare non-projective cases), we arbitrarily prefer r_cand.
         if l_cand is not None and not l_cand.is_root() and l_cand.is_descendant_of(r_cand):
             node.parent = l_cand
diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 9dc09567..7ca4a6ad 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -316,20 +316,21 @@ def fix_feats(node):
             else:
                 node.feats[name.capitalize()] = value.capitalize()
 
+        # Don't loose info about proper names which will not have upos=PROPN.
+        if node.feats['Proper'] == 'True':
+            if node.xpos not in {'NNP', 'NNPS'}:
+                node.misc['Proper'] = 'True'
+            del node.feats['Proper']
+
     def fix_upos(self, node):
         """PRT→PART, .→PUNCT, NOUN+Proper→PROPN, VERB+neg→AUX."""
         if node.upos == '.':
             node.upos = 'PUNCT'
         elif node.upos == 'PRT':
             node.upos = 'PART'
-        if node.feats['Proper']:
-            if node.upos == 'NOUN':
+        elif node.upos == 'NOUN':
+            if node.xpos in {'NNP', 'NNPS'}:
                 node.upos = 'PROPN'
-                if node.feats['Proper'] != 'True':
-                    self.log(node, 'unexpected-proper', 'Proper=' + node.feats['Proper'])
-            else:
-                node.misc['Proper'] = node.feats['Proper']
-            del node.feats['Proper']
 
         # Japanese uses negators with deprel=neg, which should be changed to advmod in Convert1to2.
         if node.upos == "VERB" and node.deprel == "neg":

From 76da0a56b70c49656ce06af37a4410300e43771c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 29 Apr 2017 18:07:33 +0200
Subject: [PATCH 0092/1374] =?UTF-8?q?=C3=89tats-Unis=20PROPN?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/google2ud.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 7ca4a6ad..bc9a08c5 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -365,8 +365,11 @@ def fix_upos(self, node):
             node.upos = 'PART'
             node.xpos = 'RP'
 
-        if self.lang == 'fr' and node.upos == 'PROPN' and node.form.lower() in FR_DAYS_MONTHS:
-            node.upos = 'NOUN'
+        if self.lang == 'fr':
+            if node.upos == 'PROPN' and node.form.lower() in FR_DAYS_MONTHS:
+                node.upos = 'NOUN'
+            if node.form == 'États-Unis':
+                node.upos = 'PROPN'
 
     def fix_deprel(self, node):
         """Convert Google dependency relations to UD deprels.

From 0ec7a3d3ae56ef8de740e15bead37d7a041e7b60 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 29 Apr 2017 18:26:27 +0200
Subject: [PATCH 0093/1374] French title+name should be flat:name, not appos.

---
 udapi/block/ud/google2ud.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index bc9a08c5..a72cb203 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -441,3 +441,6 @@ def fix_deprel(self, node):
                 if nsubj is not None:
                     node.deprel = 'nsubj'
                     nsubj.deprel = 'expl' if nsubj.upos == 'PRON' else 'dislocated'
+        elif node.deprel == 'appos':
+            if self.lang == 'fr' and node.parent.form in {'M.', 'Mme', 'Dr'}:
+                node.deprel = 'flat:name'

From 9a6d332f33a3c4a5e96a14d37a8e94a0b90bdc4d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 29 Apr 2017 22:30:54 +0200
Subject: [PATCH 0094/1374] print _ for None values, so it is consistent with
 write.Conllu

and also consistent with the case when a given attribute
is explicitly set to the underscore
Udapi still distinguishes None, underscore and empty string values.
---
 udapi/block/write/textmodetrees.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index 2c9c9f31..b42df299 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -87,7 +87,7 @@ class TextModeTrees(BaseWriter):
 
     def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
                  minimize_cross=True, color='auto', attributes='form,upos,deprel',
-                 print_undef_as='', print_doc_meta=True, print_comments=False,
+                 print_undef_as='_', print_doc_meta=True, print_comments=False,
                  mark='ToDo|Bug|Mark', marked_only=False, **kwargs):
         """Create new TextModeTrees block object.
 

From 4ad2c07be2bd2eeca8317572325aebceb492caf2 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 30 Apr 2017 00:25:20 +0200
Subject: [PATCH 0095/1374] Google Turkish annotation is inconsistent in feats
 capitalization

---
 udapi/block/ud/google2ud.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index a72cb203..ce557f2c 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -51,6 +51,7 @@
 
 FEATS_CHANGE = {
     "proper=false": "",
+    "Proper=false": "",
     "case=prep": "",
     "case=unsp_c": "",
     "gender=unsp_g": "",

From f21be2aa1c1c3f65ab36dc0bcda4f95549ea8db4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 30 Apr 2017 02:27:52 +0200
Subject: [PATCH 0096/1374] new ud.fr.AddMwt, used in ud.Google2ud

---
 udapi/block/ud/fr/__init__.py |  0
 udapi/block/ud/fr/addmwt.py   | 82 +++++++++++++++++++++++++++++++++++
 udapi/block/ud/google2ud.py   |  3 ++
 3 files changed, 85 insertions(+)
 create mode 100644 udapi/block/ud/fr/__init__.py
 create mode 100644 udapi/block/ud/fr/addmwt.py

diff --git a/udapi/block/ud/fr/__init__.py b/udapi/block/ud/fr/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/ud/fr/addmwt.py b/udapi/block/ud/fr/addmwt.py
new file mode 100644
index 00000000..948a927a
--- /dev/null
+++ b/udapi/block/ud/fr/addmwt.py
@@ -0,0 +1,82 @@
+"""Block ud.fr.AddMwt for heuristic detection of French contractions.
+
+According to the UD guidelines, contractions such as "des" = "de les"
+should be annotated using multi-word tokens.
+
+Note that this block should be used only for converting legacy conllu files.
+Ideally a tokenizer should have already split the MWTs.
+"""
+import udapi.block.ud.addmwt
+
+MWTS = {
+    'au':         {'form': 'à le', 'lemma': 'à le'},
+    'aux':        {'form': 'à les', 'lemma': 'à le'},
+    'des':        {'form': 'de les', 'lemma': 'de le'},
+    'du':         {'form': 'de le', 'lemma': 'de le'},
+
+    'auquel':     {'form': 'à lequel', 'upos': 'ADP PRON', 'lemma': 'à lequel'},
+    'auxquels':   {'form': 'à lesquels', 'upos': 'ADP PRON', 'lemma': 'à lequel'},
+    'auxquelles': {'form': 'à lesquelles', 'upos': 'ADP PRON', 'lemma': 'à lequel'},
+    'desquels':   {'form': 'de lesquels', 'upos': 'ADP PRON', 'lemma': 'de lequel'},
+    'desquelles': {'form': 'de lesquelles', 'upos': 'ADP PRON', 'lemma': 'de lequel'},
+    'duquel':     {'form': 'de lequel', 'upos': 'ADP PRON', 'lemma': 'de lequel'},
+}
+# TODO https://fr.wiktionary.org/wiki/des#Vocabulaire_apparent.C3.A9_par_le_sens_2
+# lists more contractions, e.g. "dudit", "audit"
+
+# shared values for all entries in MWTS
+for v in MWTS.values():
+    if not v.get('upos'):
+        v['upos'] = 'ADP DET'
+    if not v.get('shape'):
+        v['shape'] = 'subtree'
+    if not v.get('deprel'):
+        v['deprel'] = 'case det' if v['upos'] == 'ADP DET' else 'case *'
+    if not v.get('main'):
+        v['main'] = 1 if v['upos'] == 'ADP PRON' else 0
+    v['feats'] = '_ *'
+
+
+class AddMwt(udapi.block.ud.addmwt.AddMwt):
+    """Detect and mark MWTs (split them into words and add the words to the tree)."""
+
+    def multiword_analysis(self, node):
+        """Return a dict with MWT info or None if `node` does not represent a multiword token."""
+
+        # "du" can be
+        # - "du + le" (tagged ADP)
+        # - the partitive article "du" (tagged DET)
+        # - past participle of devoir (correctly dû, tagged VERB)
+        # Only the ADP case should be split.
+        # Similarly with "des" -> "de les".
+        if node.upos != 'ADP':
+            return None
+
+        return MWTS.get(node.form.lower(), None)
+
+    # "du" has a shape which is neither "siblings" nor "subtree"
+    # E.g. in "À partir du XXIe siècle"
+    # "du" = "de le", but
+    # "de" is attached to "À", while "le" is attached to "siècle".
+    def postprocess_mwt(self, mwt):
+        if mwt.form.lower() in {'du', 'des', 'au', 'aux'}:
+            if mwt.words[0].descendants[-1] != mwt.words[1]:
+                pass
+            elif mwt.words[0].precedes(mwt.words[0].parent):
+                mwt.words[1].parent = mwt.words[0].parent
+            else:
+                head = mwt.words[1].next_node
+                while head.upos not in {'NOUN', 'PROPN'} and not head.is_root():
+                    if head.parent.precedes(head):
+                        head = mwt.words[1].next_node
+                        break
+                    head = head.parent
+                if head.is_root():
+                    head = mwt.words[1].next_node
+                mwt.words[1].parent = head
+
+        if mwt.words[1].parent == mwt.words[0] and mwt.words[0].descendants[-1].deprel == 'fixed':
+            mwt.words[1].deprel = 'fixed'
+        if (mwt.words[0].parent.precedes(mwt.words[0])
+                and mwt.words[0].prev_node.udeprel in {'case', 'fixed'}):
+            mwt.words[0].deprel = 'fixed'
diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index ce557f2c..f9b0e6c0 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -9,6 +9,7 @@
 from udapi.block.ud.fixrightheaded import FixRightheaded
 from udapi.block.ud.fixpunct import FixPunct
 from udapi.block.ud.de.addmwt import AddMwt as de_AddMwt
+from udapi.block.ud.fr.addmwt import AddMwt as fr_AddMwt
 from udapi.block.ud.pt.addmwt import AddMwt as pt_AddMwt
 
 DEPREL_CHANGE = {
@@ -123,6 +124,8 @@ def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
         self._addmwt_block = None
         if lang == 'de':
             self._addmwt_block = de_AddMwt()
+        elif lang == 'fr':
+            self._addmwt_block = fr_AddMwt()
         elif lang == 'pt':
             self._addmwt_block = pt_AddMwt()
 

From 9e97a2751979c2cc59c2fda8c2f526b86c3dbb84 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 30 Apr 2017 02:47:34 +0200
Subject: [PATCH 0097/1374] fix Russian fixed-chain bugs

---
 udapi/block/ud/google2ud.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index f9b0e6c0..1066410c 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -138,7 +138,7 @@ def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
             self._fixpunct_block = FixPunct()
 
         self._fixchain_block = None
-        if lang in {'pt'}:
+        if lang in {'pt', 'ru'}:
             self._fixchain_block = FixChain()
 
         # UD_English v2.0 still uses "do n't" with SpaceAfter=No,

From c70701cac97223c9d1c83eab27b78bc603f57a56 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 30 Apr 2017 04:09:36 +0200
Subject: [PATCH 0098/1374] handle also ASCII quotes and be more conservative

---
 udapi/block/ud/fixpunct.py | 53 +++++++++++++++++++++++++++++---------
 1 file changed, 41 insertions(+), 12 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 8cda6add..e3d9b333 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -23,8 +23,6 @@
 from udapi.core.block import Block
 # pylint: disable=no-self-use
 
-# TODO Add a heuristics for ASCI "quotes".
-# TODO Add ‘single’ quotes, but make sure these symbols are not used e.g. as apostrophes.
 # TODO We need to know the language, there are many other quotation styles,
 #      e.g. Finnish and Swedish uses the same symbol for opening and closing: ”X”.
 #      Danish uses uses the French quotes, but switched: »X«.
@@ -32,6 +30,8 @@
     '(': ')',
     '[': ']',
     '{': '}',
+    '"': '"',   # ASCII double quotes
+    "'": "'",   # ASCII single quotes
     '“': '”',   # quotation marks used in English,...
     '„': '“',   # Czech, German, Russian,...
     '«': '»',   # French, Russian, Spanish,...
@@ -45,6 +45,12 @@
 class FixPunct(Block):
     """Make sure punct nodes are attached punctuation is attached projectively."""
 
+    def __init__(self, conservative=True, **kwargs):
+        """Create the ud.FixPunct block instance."""
+        super().__init__(**kwargs)
+        self.conservative = conservative
+        self._is_closing = dict()
+
     def process_tree(self, root):
         # First, make sure no PUNCT has children
         for node in root.descendants:
@@ -58,11 +64,18 @@ def process_tree(self, root):
 
         # Then fix paired punctuations: quotes and brackets.
         for node in root.descendants:
-            closing_punct = PAIRED_PUNCT.get(node.form, None)
-            if closing_punct is not None:
-                self._fix_paired_punct(root, node, closing_punct)
+            if self._is_closing.get(node.ord):
+                del self._is_closing[node.ord]
+            else:
+                closing_punct = PAIRED_PUNCT.get(node.form, None)
+                if closing_punct is not None:
+                    self._fix_paired_punct(root, node, closing_punct)
 
     def _fix_subord_punct(self, node):
+        # Dot used as the ordinal-number marker (in some languages) or abbreviation marker.
+        if node.form == '.' and node.parent == node.prev_node:  # and node.parent.form.isdigit():
+            return
+
         # Initialize the candidates (left and right) with the nearest nodes excluding punctuation.
         l_cand, r_cand = node.prev_node, node.next_node
         while l_cand.ord > 0 and l_cand.upos == "PUNCT":
@@ -84,23 +97,37 @@ def _fix_subord_punct(self, node):
         # The lower one. Note that if neither is descendant of the other and neither is None
         # (which can happen in rare non-projective cases), we arbitrarily prefer r_cand.
         if l_cand is not None and not l_cand.is_root() and l_cand.is_descendant_of(r_cand):
-            node.parent = l_cand
-            node.deprel = "punct"
+            cand = l_cand
         elif r_cand is not None:
-            node.parent = r_cand
-            node.deprel = "punct"
+            cand = r_cand
+        else:
+            return
+
+        # The guidelines say:
+        #    Within the relevant unit, a punctuation mark is attached
+        #    at the highest possible node that preserves projectivity.
+        # However, sometimes it is difficult to detect the unit (and its head).
+        # E.g. in "Der Mann, den Sie gestern kennengelernt haben, kam wieder."
+        # the second comma should depend on "kennengelernt", not on "Mann"
+        # because the unit is just the relative clause.
+        # "Conservative" means try to keep the parent, unless we are sure it is wrong.
+        if self.conservative and node.parent.is_descendant_of(cand):
+            pass
+        else:
+            node.parent = cand
+        node.deprel = "punct"
 
     def _fix_paired_punct(self, root, opening_node, closing_punct):
         nested_level = 0
         for node in root.descendants[opening_node.ord:]:
-            if node.form == opening_node.form:
-                nested_level += 1
-            elif node.form == closing_punct:
+            if node.form == closing_punct:
                 if nested_level > 0:
                     nested_level -= 0
                 else:
                     self._fix_pair(root, opening_node, node)
                     return
+            elif node.form == opening_node.form:
+                nested_level += 1
 
     def _fix_pair(self, root, opening_node, closing_node):
         heads = []
@@ -111,6 +138,8 @@ def _fix_pair(self, root, opening_node, closing_node):
         if len(heads) == 1:
             opening_node.parent = heads[0]
             closing_node.parent = heads[0]
+            self._is_closing[closing_node.ord] = True
         elif len(heads) > 1:
             opening_node.parent = sorted(heads, key=lambda n: n.descendants(add_self=1)[0].ord)[0]
             closing_node.parent = sorted(heads, key=lambda n: -n.descendants(add_self=1)[-1].ord)[0]
+            self._is_closing[closing_node.ord] = True

From e060c8db085ebea286e0b99a54f5cff14432dd54 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 30 Apr 2017 04:20:51 +0200
Subject: [PATCH 0099/1374] ud.FixPunct also for fr

It could be used for all languages, I hope.
---
 udapi/block/ud/google2ud.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 1066410c..29e66706 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -134,7 +134,7 @@ def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
             self._fixrigheaded_block = FixRightheaded()
 
         self._fixpunct_block = None
-        if lang in {'de'}:
+        if lang in {'de', 'fr'}:
             self._fixpunct_block = FixPunct()
 
         self._fixchain_block = None

From b4ce7f29b240e9f68397fb77d0eaba4f36f7d197 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 30 Apr 2017 15:47:53 +0200
Subject: [PATCH 0100/1374] allow read.AddSentences into=english_text

---
 udapi/block/read/addsentences.py | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/udapi/block/read/addsentences.py b/udapi/block/read/addsentences.py
index f7f8d764..5dc2d7a9 100644
--- a/udapi/block/read/addsentences.py
+++ b/udapi/block/read/addsentences.py
@@ -14,8 +14,17 @@ class AddSentences(BaseReader):
     `cat in.conllu | udapy -s read.Conllu read.AddSentences files=in.txt > merged.conllu`
     """
 
-    def __init__(self, zone='', **kwargs):
+    def __init__(self, zone='', into='text', **kwargs):
+        """Args:
+        into: name of the comment-attribute where the sentence should be stored. Default = text.
+            That is the sentence is stored in `root.text` and in CoNLL-U it will look like e.g.
+            `# text = John loves Mary.`
+            Any other name than "text" is stored to `root.comment`, so e.g. `into=english_text`
+            will result in a CoNLL-U with a comment line:
+            `# english_text = John loves Mary.`
+        """
         super().__init__(zone=zone, **kwargs)
+        self.into = into
 
     @staticmethod
     def is_multizone_reader():
@@ -38,5 +47,8 @@ def process_document(self, document):
             if line == '':
                 raise IOError('File does not have enough lines')
             root = bundle.get_tree(zone=self.zone)
-            root.text = line.rstrip()
+            if self.into == 'text':
+                root.text = line.rstrip()
+            else:
+                root.comment += ' ' + self.into + " = " + line.rstrip() + "\n"
         self.finished = not self.files.has_next_file()

From 76235ea99968793fa782d9104ecfb68b66865a1c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 1 May 2017 17:18:18 +0200
Subject: [PATCH 0101/1374] yet another improvement, so ud.FixPunct does not
 introduce non-proj

even in sentences like
I call him "Bob."

Also, I don't see a reason for not using the "conservative"
parameter (it works nice even on Google German data, where
punctuation was completely wrong).
So I am deleting the parameter.
---
 udapi/block/ud/fixpunct.py | 49 ++++++++++++++++++++++----------------
 1 file changed, 29 insertions(+), 20 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index e3d9b333..abf843b3 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -45,11 +45,10 @@
 class FixPunct(Block):
     """Make sure punct nodes are attached punctuation is attached projectively."""
 
-    def __init__(self, conservative=True, **kwargs):
+    def __init__(self, **kwargs):
         """Create the ud.FixPunct block instance."""
         super().__init__(**kwargs)
-        self.conservative = conservative
-        self._is_closing = dict()
+        self._punct_type = None
 
     def process_tree(self, root):
         # First, make sure no PUNCT has children
@@ -57,20 +56,24 @@ def process_tree(self, root):
             while node.parent.upos == "PUNCT":
                 node.parent = node.parent.parent
 
-        # Then make sure subordinate punctuations have correct parent.
+        # Second, fix paired punctuations: quotes and brackets, marking them in _punct_type.
+        # This should be done before handling the subordinate punctuation,
+        # in order to prevent non-projectivities e.g. in dot-before-closing-quote style sentences:
+        #   I call him "Bob."
+        # Here both quotes and the sentence-final dot should be attached to "Bob".
+        # (As you can see on the previous line, I don't like this American typographic rule.)
+        self._punct_type = [None] * (1 + len(root.descendants))
         for node in root.descendants:
-            if node.upos == "PUNCT" and not PAIRED_PUNCT.get(node.form, None):
-                self._fix_subord_punct(node)
-
-        # Then fix paired punctuations: quotes and brackets.
-        for node in root.descendants:
-            if self._is_closing.get(node.ord):
-                del self._is_closing[node.ord]
-            else:
+            if self._punct_type[node.ord] != 'closing':
                 closing_punct = PAIRED_PUNCT.get(node.form, None)
                 if closing_punct is not None:
                     self._fix_paired_punct(root, node, closing_punct)
 
+        # Third, fix subordinate punctuation (i.e. any punctuation not marked in _punct_type).
+        for node in root.descendants:
+            if node.upos == "PUNCT" and not self._punct_type[node.ord]:
+                self._fix_subord_punct(node)
+
     def _fix_subord_punct(self, node):
         # Dot used as the ordinal-number marker (in some languages) or abbreviation marker.
         if node.form == '.' and node.parent == node.prev_node:  # and node.parent.form.isdigit():
@@ -84,13 +87,17 @@ def _fix_subord_punct(self, node):
             r_cand = r_cand.next_node
 
         # Climb up from the candidates, until we would reach the root or "cross" the punctuation.
+        # If the candidates' descendants span across the punctuation, we also stop
+        # because climbing higher would cause a non-projectivity (the punct would be the gap).
         if l_cand.is_root():
             l_cand = None
         else:
-            while not l_cand.parent.is_root() and l_cand.parent.precedes(node):
+            while (not l_cand.parent.is_root() and l_cand.parent.precedes(node)
+                   and not node.precedes(l_cand.descendants(add_self=1)[-1])):
                 l_cand = l_cand.parent
         if r_cand is not None:
-            while not r_cand.parent.is_root() and node.precedes(r_cand.parent):
+            while (not r_cand.parent.is_root() and node.precedes(r_cand.parent)
+                   and not r_cand.descendants(add_self=1)[0].precedes(node)):
                 r_cand = r_cand.parent
 
         # Now select between l_cand and r_cand -- which will be the new parent?
@@ -100,6 +107,8 @@ def _fix_subord_punct(self, node):
             cand = l_cand
         elif r_cand is not None:
             cand = r_cand
+        elif l_cand is not None:
+            cand = l_cand
         else:
             return
 
@@ -110,10 +119,8 @@ def _fix_subord_punct(self, node):
         # E.g. in "Der Mann, den Sie gestern kennengelernt haben, kam wieder."
         # the second comma should depend on "kennengelernt", not on "Mann"
         # because the unit is just the relative clause.
-        # "Conservative" means try to keep the parent, unless we are sure it is wrong.
-        if self.conservative and node.parent.is_descendant_of(cand):
-            pass
-        else:
+        # We try to be conservative and keep the parent, unless we are sure it is wrong.
+        if not node.parent.is_descendant_of(cand):
             node.parent = cand
         node.deprel = "punct"
 
@@ -138,8 +145,10 @@ def _fix_pair(self, root, opening_node, closing_node):
         if len(heads) == 1:
             opening_node.parent = heads[0]
             closing_node.parent = heads[0]
-            self._is_closing[closing_node.ord] = True
+            self._punct_type[opening_node.ord] = 'opening'
+            self._punct_type[closing_node.ord] = 'closing'
         elif len(heads) > 1:
             opening_node.parent = sorted(heads, key=lambda n: n.descendants(add_self=1)[0].ord)[0]
             closing_node.parent = sorted(heads, key=lambda n: -n.descendants(add_self=1)[-1].ord)[0]
-            self._is_closing[closing_node.ord] = True
+            self._punct_type[opening_node.ord] = 'opening'
+            self._punct_type[closing_node.ord] = 'closing'

From c4afa39e99e60b4c33549466be8c015f5b3bca4c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 1 May 2017 17:45:32 +0200
Subject: [PATCH 0102/1374] =?UTF-8?q?add=20Spanish-specific=20marks=20?=
 =?UTF-8?q?=C2=BF=3F=C2=A1!=20and=20check=20final=20punct?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

which should not be attached to any following nodes
---
 udapi/block/ud/fixpunct.py | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index abf843b3..ab40bb14 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -39,8 +39,12 @@
     '《': '》',  # Korean, Chinese
     '「': '」',  # Chinese, Japanese
     '『': '』',  # dtto
+    '¿': '?',   # Spanish question quotation marks
+    '¡': '!',   # Spanish exclamation quotation marks
     }
 
+FINAL_PUNCT = '.?!'
+
 
 class FixPunct(Block):
     """Make sure punct nodes are attached punctuation is attached projectively."""
@@ -76,11 +80,17 @@ def process_tree(self, root):
 
     def _fix_subord_punct(self, node):
         # Dot used as the ordinal-number marker (in some languages) or abbreviation marker.
-        if node.form == '.' and node.parent == node.prev_node:  # and node.parent.form.isdigit():
+        # TODO: detect these cases somehow
+        # Numbers can be detected with `node.parent.form.isdigit()`,
+        # but abbreviations are more tricky because the Abbr=Yes feature is not always used.
+        if node.form == '.' and node.parent == node.prev_node:
             return
 
         # Initialize the candidates (left and right) with the nearest nodes excluding punctuation.
+        # Final punctuation should not be attached to any following, so exclude r_cand there.
         l_cand, r_cand = node.prev_node, node.next_node
+        if node.form in FINAL_PUNCT:
+            r_cand = None
         while l_cand.ord > 0 and l_cand.upos == "PUNCT":
             l_cand = l_cand.prev_node
         while r_cand is not None and r_cand.upos == "PUNCT":

From 47d0dd32a25efd96c06fa520f33633adcd83969e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 1 May 2017 18:00:16 +0200
Subject: [PATCH 0103/1374] normalize the attachment of punctuation for all
 languages

---
 udapi/block/ud/google2ud.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 29e66706..d303c1ae 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -133,9 +133,8 @@ def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
         if lang in {'ar', 'de', 'en', 'fr', 'hi', 'ru', 'th', 'tr', 'zh'}:
             self._fixrigheaded_block = FixRightheaded()
 
-        self._fixpunct_block = None
-        if lang in {'de', 'fr'}:
-            self._fixpunct_block = FixPunct()
+        # Normalize the attachment of punctuation for all languages.
+        self._fixpunct_block = FixPunct()
 
         self._fixchain_block = None
         if lang in {'pt', 'ru'}:

From 560b7d1beadd04a49b57afdbde6800b99d67f861 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 1 May 2017 21:48:04 +0200
Subject: [PATCH 0104/1374] most nmod:tmod should be converted to obl:tmod

---
 udapi/block/ud/convert1to2.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/convert1to2.py b/udapi/block/ud/convert1to2.py
index fa46960d..9df235ac 100644
--- a/udapi/block/ud/convert1to2.py
+++ b/udapi/block/ud/convert1to2.py
@@ -183,10 +183,15 @@ def is_nominal(node):
 
     def change_nmod(self, node):
         """nmod→obl if parent is not nominal, but predicate."""
-        if node.deprel == 'nmod':
+        if node.udeprel == 'nmod':
             parent_is_nominal = self.is_nominal(node.parent)
             if parent_is_nominal == 'no':
-                node.deprel = 'obl'
+                if node.sdeprel:
+                    node.deprel = 'obl' + ':' + node.sdeprel
+                else:
+                    node.deprel = 'obl'
+            elif node.deprel == 'nmod:tmod':
+                node.deprel = 'obl:tmod'
             elif parent_is_nominal == 'maybe':
                 self.log(node, 'nmod', 'deprel=nmod, but parent is ambiguous nominal/predicate')
 

From 71f54afe0265387b4bee9f053bf5f40b47bb7116 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 2 May 2017 19:56:41 +0200
Subject: [PATCH 0105/1374] allow util.See test=r_lemma,l_lemma

---
 udapi/core/node.py | 27 ++++++++++++++-------------
 1 file changed, 14 insertions(+), 13 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index feec38a6..f8c53a57 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -496,6 +496,8 @@ def get_attrs(self, attrs, undefs=None, stringify=True):
         Pseudo-attributes:
         p_xy is the (pseudo) attribute xy of the parent node.
         c_xy is a list of the (pseudo) attributes xy of the children nodes.
+        l_xy is the (pseudo) attribute xy of the previous (left in LTR langs) node.
+        r_xy is the (pseudo) attribute xy of the following (right in LTR langs) node.
         dir: 'left' = the node is a left child of its parent,
              'right' = the node is a rigth child of its parent,
              'root' = the node's parent is the technical root.
@@ -512,21 +514,20 @@ def get_attrs(self, attrs, undefs=None, stringify=True):
         """
         values = []
         for name in attrs:
+            nodes = [self]
             if name.startswith('p_'):
-                if name == 'p_feats_split':
-                    values.extend(self.parent._get_attr(name[2:]))
-                else:
-                    values.append(self.parent._get_attr(name[2:]))
+                nodes, name = [self.parent], name[2:]
             elif name.startswith('c_'):
-                for child in self.children:
-                    if name == 'c_feats_split':
-                        values.extend(child._get_attr(name[2:]))
-                    else:
-                        values.append(child._get_attr(name[2:]))
-            elif name == 'feats_split':
-                values.extend(self._get_attr(name))
-            else:
-                values.append(self._get_attr(name))
+                nodes, name = self.children, name[2:]
+            elif name.startswith('l_'):
+                nodes, name = [self.prev_node], name[2:]
+            elif name.startswith('r_'):
+                nodes, name = [self.next_node], name[2:]
+            for node in (n for n in nodes if n is not None):
+                if name == 'feats_split':
+                    values.extend(node._get_attr(name))
+                else:
+                    values.append(node._get_attr(name))
 
         if undefs is not None:
             values = [x if x is not None else undefs for x in values]

From e44e001253d74cf915a6c49ff4ca791d9b493069 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 May 2017 11:45:31 +0200
Subject: [PATCH 0106/1374] fix upos=X->SYM and deprel=punct

---
 udapi/block/ud/google2ud.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index d303c1ae..58b65753 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -327,7 +327,14 @@ def fix_feats(node):
 
     def fix_upos(self, node):
         """PRT→PART, .→PUNCT, NOUN+Proper→PROPN, VERB+neg→AUX."""
-        if node.upos == '.':
+        if node.xpos == 'SYM':  # These are almost always tagged as upos=X which is wrong.
+            node.upos = 'SYM'
+            if node.deprel in {'punct', 'p'}:
+                if node.form in "_-.؟”'":
+                    node.upos == 'PUNCT'
+                else:
+                    node.deprel = 'dep'  # This is another way how to say deprel=todo.
+        elif node.upos == '.':
             node.upos = 'PUNCT'
         elif node.upos == 'PRT':
             node.upos = 'PART'

From 657c6e817f7a33751009ef071d97eb710c3ceccf Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 May 2017 11:58:49 +0200
Subject: [PATCH 0107/1374] oops

---
 udapi/block/ud/google2ud.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 58b65753..d06b7746 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -331,7 +331,7 @@ def fix_upos(self, node):
             node.upos = 'SYM'
             if node.deprel in {'punct', 'p'}:
                 if node.form in "_-.؟”'":
-                    node.upos == 'PUNCT'
+                    node.upos = 'PUNCT'
                 else:
                     node.deprel = 'dep'  # This is another way how to say deprel=todo.
         elif node.upos == '.':

From 842cc46d54839090fe286f6bbc7398af7288988c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 May 2017 13:07:45 +0200
Subject: [PATCH 0108/1374] fixes for languages which have been already
 manually edited

---
 udapi/block/ud/exgoogle2ud.py | 66 +++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 udapi/block/ud/exgoogle2ud.py

diff --git a/udapi/block/ud/exgoogle2ud.py b/udapi/block/ud/exgoogle2ud.py
new file mode 100644
index 00000000..f3dbb86d
--- /dev/null
+++ b/udapi/block/ud/exgoogle2ud.py
@@ -0,0 +1,66 @@
+"""Block ud.ExGoogle2ud converts data which were originally annotated in Google style
+then converted with an older version of ud.Google2ud to UDv2,
+then manually edited and we don't want to loose these edits,
+so we cannot simply rerun the newer version of ud.Google2ud on the original Google data.
+"""
+from udapi.block.ud.fixchain import FixChain
+from udapi.block.ud.fixpunct import FixPunct
+from udapi.block.ud.fixrightheaded import FixRightheaded
+from udapi.core.block import Block
+
+class ExGoogle2ud(Block):
+    """Convert former Google Universal Dependency Treebank into UD style."""
+
+    def __init__(self, lang='unk', **kwargs):
+        super().__init__(**kwargs)
+        self.lang = lang
+        self._fixpunct_block = FixPunct()
+        self._fixrigheaded_block = FixRightheaded()
+        self._fixchain_block = FixChain()
+
+    def process_tree(self, root):
+        for node in root.descendants:
+            self.fix_node(node)
+
+        for block in (
+                self._fixrigheaded_block,  # deprel=fixed,flat,... should be always head-initial
+                self._fixchain_block,      # and form a flat structure, not a chain.
+                self._fixpunct_block):     # commas should depend on the subord unit.
+            if block:
+                block.process_tree(root)
+
+    def fix_node(self, node):
+        """Various fixed taken from ud.Google2ud."""
+
+        if node.xpos == 'SYM':  # These are almost always tagged as upos=X which is wrong.
+            node.upos = 'SYM'
+            if node.deprel in {'punct', 'p'}:
+                if node.form in "_-.؟”'":
+                    node.upos = 'PUNCT'
+                else:
+                    node.deprel = 'dep'  # This is another way how to say deprel=todo.
+
+        if node.udeprel == 'nmod' and node.deprel != 'nmod':
+            parent_is_nominal = self.is_nominal(node.parent)
+            if parent_is_nominal == 'no':
+                node.deprel = 'obl' + ':' + node.sdeprel
+            elif node.deprel == 'nmod:tmod':
+                node.deprel = 'obl:tmod'
+
+
+    @staticmethod
+    def is_nominal(node):
+        """Returns 'no' (for predicates), 'yes' (sure nominals) or 'maybe'.
+
+        Used in `change_nmod`."""
+        if node.upos in ["VERB", "AUX", "ADJ", "ADV"]:
+            return 'no'
+        # Include NUM for examples such as "one of the guys"
+        # and DET for examples such as "some/all of them"
+        if node.upos in ["NOUN", "PRON", "PROPN", "NUM", "DET"]:
+            # check whether the node is a predicate
+            # (either has a nsubj/csubj dependendent or a copula dependent)
+            if any(["subj" in child.deprel or child.deprel == 'cop' for child in node.children]):
+                return 'maybe'
+            return 'yes'
+        return 'maybe'

From b50238603244497206af835c1daeb59b9d981614 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 May 2017 13:32:36 +0200
Subject: [PATCH 0109/1374] Arabic: obl:gmod -> obl + Case=Gen

---
 udapi/block/ud/exgoogle2ud.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/exgoogle2ud.py b/udapi/block/ud/exgoogle2ud.py
index f3dbb86d..929297f5 100644
--- a/udapi/block/ud/exgoogle2ud.py
+++ b/udapi/block/ud/exgoogle2ud.py
@@ -47,6 +47,9 @@ def fix_node(self, node):
             elif node.deprel == 'nmod:tmod':
                 node.deprel = 'obl:tmod'
 
+        if node.deprel == 'obl:gmod' and self.lang == 'ar':
+            node.deprel = 'obl'
+            node.feats['Case'] = 'Gen'
 
     @staticmethod
     def is_nominal(node):

From 2ecf5deb65624f4369c54022cbf93bea9a158613 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 May 2017 14:01:16 +0200
Subject: [PATCH 0110/1374] @dan-zeman suggested nmod with ADJ parent should
 stay nmod, not obl

---
 udapi/block/ud/convert1to2.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/convert1to2.py b/udapi/block/ud/convert1to2.py
index 9df235ac..ca14bba6 100644
--- a/udapi/block/ud/convert1to2.py
+++ b/udapi/block/ud/convert1to2.py
@@ -169,7 +169,7 @@ def is_nominal(node):
         """Returns 'no' (for predicates), 'yes' (sure nominals) or 'maybe'.
 
         Used in `change_nmod`."""
-        if node.upos in ["VERB", "AUX", "ADJ", "ADV"]:
+        if node.upos in ["VERB", "AUX", "ADV"]:
             return 'no'
         # Include NUM for examples such as "one of the guys"
         # and DET for examples such as "some/all of them"
@@ -192,6 +192,8 @@ def change_nmod(self, node):
                     node.deprel = 'obl'
             elif node.deprel == 'nmod:tmod':
                 node.deprel = 'obl:tmod'
+            elif node.deprel == 'nmod:poss':
+                node.deprel = 'nmod:poss'
             elif parent_is_nominal == 'maybe':
                 self.log(node, 'nmod', 'deprel=nmod, but parent is ambiguous nominal/predicate')
 

From db52b4ac651e7d0153debc678663ce8d6b1a9ed4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 May 2017 14:36:04 +0200
Subject: [PATCH 0111/1374] =?UTF-8?q?H=C3=A9ctor=20provided=20rules=20for?=
 =?UTF-8?q?=20Spanish=20(false)=20multi-word=20prepositions?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/google2ud.py | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index d06b7746..2b5c5b78 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -281,6 +281,14 @@ def fix_multiword_prep(self, node):
                 node.parent = hi_prep
                 lo_prep.parent = node
                 lo_prep.deprel = 'case'
+            elif self.lang == 'es' and lo_prep.form in {'entre', 'en', 'a'}:
+                node.parent = hi_prep
+                lo_prep.parent = node
+                lo_prep.deprel = 'case'
+            elif self.lang == 'es' and lo_prep.form == 'para':
+                node.parent, node.deprel = hi_prep.parent, 'obj'
+                lo_prep.deprel, hi_prep.deprel = 'mark', 'mark'
+                lo_prep.parent, hi_prep.parent = node, node
             # Otherwise, they are probably multi-word prepositions, e.g. "according to",
             # but they can also be sibling prepositions, e.g. "out of".
             # The Google style does not distinguish those and I don't see any heuristics,
@@ -294,7 +302,10 @@ def fix_multiword_prep(self, node):
                 for prep_child in second_prep.children:
                     prep_child.parent = first_prep
                 second_prep.deprel = 'fixed'
-                self.log(second_prep, 'unsure-multi-prep', 'deprel=fixed, but may be siblings')
+                if self.lang == 'es' and lo_prep.form == 'par':
+                    pass
+                else:
+                    self.log(second_prep, 'unsure-multi-prep', 'deprel=fixed, but may be siblings')
 
     @staticmethod
     def fix_feats(node):

From 5b656f0740dc2fba2d24299d3946cdd3030e008e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 May 2017 14:40:54 +0200
Subject: [PATCH 0112/1374] highlighting differences between two conllu files

to be used with `udapy -HM`
---
 udapi/block/util/markdiff.py | 41 ++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 udapi/block/util/markdiff.py

diff --git a/udapi/block/util/markdiff.py b/udapi/block/util/markdiff.py
new file mode 100644
index 00000000..a79f6a32
--- /dev/null
+++ b/udapi/block/util/markdiff.py
@@ -0,0 +1,41 @@
+"""util.MarkDiff is a special block for marking differences between parallel trees."""
+from udapi.core.block import Block
+
+class MarkDiff(Block):
+    """Mark differences between parallel trees."""
+
+    def __init__(self, gold_zone, attributes='form,p_ord,lemma,upos,xpos,deprel,feats,misc',
+                 mark=1, add=False, **kwargs):
+        """Create the Mark block object."""
+        super().__init__(**kwargs)
+        self.gold_zone = gold_zone
+        self.attrs = attributes.split(',')
+        self.mark = mark
+        self.add = add
+
+    def process_tree(self, tree):
+        gold_tree = tree.bundle.get_tree(self.gold_zone)
+        if tree == gold_tree:
+            return
+        nodes, gold_nodes = tree.descendants, gold_tree.descendants
+        if len(nodes) != len(gold_nodes):
+            # TODO use eval.F1.find_lcs
+            tree.misc['Mark'] = self.mark
+        else:
+            for node, gold_node in zip(nodes, gold_nodes):
+                self.diff_nodes(node, gold_node)
+
+    def diff_nodes(self, node, gold_node):
+        """Compare attributes of two nodes and mark if different."""
+        label = '_'.join(node.get_attrs(self.attrs))
+        gold_label = '_'.join(gold_node.get_attrs(self.attrs))
+        if not self.add:
+            del node.misc['Mark']
+            del node.misc['ToDo']
+            del node.misc['Bug']
+            del gold_node.misc['Mark']
+            del gold_node.misc['ToDo']
+            del gold_node.misc['Bug']
+        if label != gold_label:
+            node.misc['Mark'] = self.mark
+            gold_node.misc['Mark'] = self.mark

From b144db2592a17d9e4d79dfe03d27abc90bcabc87 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 May 2017 17:57:39 +0200
Subject: [PATCH 0113/1374] root.comment may end with a newline

but `root.add_comment` should never create an empty comment line
---
 udapi/core/root.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/core/root.py b/udapi/core/root.py
index aab361c1..1d609258 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -202,7 +202,7 @@ def add_comment(self, string):
         if self.comment is None:
             self.comment = string
         else:
-            self.comment += "\n " + string
+            self.comment = self.comment.rstrip() + "\n " + string
 
     @property
     def token_descendants(self):

From 580a1530d375c9916109e1f6e1faf2c4426e5df7 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 May 2017 18:21:25 +0200
Subject: [PATCH 0114/1374] root.misc is not printed, use root.add_comment
 instead

---
 udapi/block/util/markdiff.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/udapi/block/util/markdiff.py b/udapi/block/util/markdiff.py
index a79f6a32..b1542608 100644
--- a/udapi/block/util/markdiff.py
+++ b/udapi/block/util/markdiff.py
@@ -19,8 +19,9 @@ def process_tree(self, tree):
             return
         nodes, gold_nodes = tree.descendants, gold_tree.descendants
         if len(nodes) != len(gold_nodes):
-            # TODO use eval.F1.find_lcs
-            tree.misc['Mark'] = self.mark
+            # TODO use eval.F1.find_lcs to find the nodes responsible for the diff
+            tree.add_comment('Mark = %s' % self.mark)
+            gold_tree.add_comment('Mark = %s' % self.mark)
         else:
             for node, gold_node in zip(nodes, gold_nodes):
                 self.diff_nodes(node, gold_node)

From f88d6d29176c96b742b6fe2ad58918bf941d03c3 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 May 2017 18:22:14 +0200
Subject: [PATCH 0115/1374] don't highlight a tree if its comment just contains
 "Mark"

e.g. in english_text
---
 udapi/block/write/textmodetrees.py | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index b42df299..607ad48e 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -111,8 +111,9 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         print_doc_meta: Print `document.meta` metadata before each document?
         print_comments: Print comments (other than sent_id and text)?
         mark: a regex. If `re.search(mark, str(node.misc))` the node is highlighted.
-            If `print_comments and re.search(mark, root.comment)` the comment is highlighted.
-            Empty string means no highlighting. Default = 'ToDo|Bug|Mark'.
+            If `print_comments and re.search(r'^ (%s) = ' % mark, root.comment, re.M)`
+            the comment is highlighted.
+            Empty string means no highlighting. Default = 'ToDo|ToDoOrigText|Bug|Mark'.
         marked_only: print only trees containing one or more marked nodes/comments. Default=False.
         """
         super().__init__(**kwargs)
@@ -140,7 +141,10 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         self._vert = [space + '│', line + '╪']
 
         self.attrs = attributes.split(',')
-        self.mark_re = re.compile(mark, re.S) if (mark is not None and mark != '') else None
+        self.mark_re, self.comment_mark_re = None, None
+        if mark is not None and mark != '':
+            self.mark_re = re.compile(mark)
+            self.comment_mark_re = re.compile(r'^ (%s) = ' % mark, re.M)
         self._index_of = []
         self._gaps = []
         self.lines = []
@@ -170,7 +174,7 @@ def should_print_tree(self, root):
             return True
         if not self.print_comments or root.comment is None or self.mark_re is None:
             return False
-        return self.mark_re.search(root.comment)
+        return self.comment_mark_re.search(root.comment)
 
     def process_tree(self, root):
         """Print the tree to (possibly redirected) sys.stdout."""

From d0e61c3df0f6e454c288b5695a83df2dbb8407ea Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 May 2017 18:29:36 +0200
Subject: [PATCH 0116/1374] yet another solution of deprel=nmod below upos=ADJ

this is a compromise between an observation
that ADJ may be an NP head and an observation
that ADJ is often related to the copula verb.
---
 udapi/block/ud/convert1to2.py | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/convert1to2.py b/udapi/block/ud/convert1to2.py
index ca14bba6..4cd76beb 100644
--- a/udapi/block/ud/convert1to2.py
+++ b/udapi/block/ud/convert1to2.py
@@ -171,14 +171,16 @@ def is_nominal(node):
         Used in `change_nmod`."""
         if node.upos in ["VERB", "AUX", "ADV"]:
             return 'no'
+        # check whether the node is a predicate
+        # (either has a nsubj/csubj dependendent or a copula dependent)
+        has_cop = any("subj" in child.deprel or child.deprel == 'cop' for child in node.children)
+        # Adjectives are very likely complements of copula verbs.
+        if node.upos == "ADJ":
+            return "no" if has_cop else "maybe"
         # Include NUM for examples such as "one of the guys"
         # and DET for examples such as "some/all of them"
         if node.upos in ["NOUN", "PRON", "PROPN", "NUM", "DET"]:
-            # check whether the node is a predicate
-            # (either has a nsubj/csubj dependendent or a copula dependent)
-            if any(["subj" in child.deprel or child.deprel == 'cop' for child in node.children]):
-                return 'maybe'
-            return 'yes'
+            return "maybe" if has_cop else "yes"
         return 'maybe'
 
     def change_nmod(self, node):

From 74749568745c65b8d15b1caa680abaa58c7beca5 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 May 2017 18:51:25 +0200
Subject: [PATCH 0117/1374] deprel=aux should have no children
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

E.g. in "bewahren zu können"
"zu" should depend on "bewahren" because "können" is aux.
---
 udapi/block/ud/google2ud.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 2b5c5b78..cd306113 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -385,6 +385,8 @@ def fix_upos(self, node):
             node.deprel = 'mark'
             node.upos = 'PART'
             node.xpos = 'RP'
+            if node.parent.deprel == 'aux':
+                node.parent = node.parent.parent
 
         if self.lang == 'fr':
             if node.upos == 'PROPN' and node.form.lower() in FR_DAYS_MONTHS:

From 93b9cd4d6af515c239a1b66793a968aecac829c3 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 May 2017 19:33:36 +0200
Subject: [PATCH 0118/1374] CONJ->SCONJ if deprel=mark

---
 udapi/block/ud/google2ud.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index cd306113..aa8ec16c 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -337,7 +337,7 @@ def fix_feats(node):
             del node.feats['Proper']
 
     def fix_upos(self, node):
-        """PRT→PART, .→PUNCT, NOUN+Proper→PROPN, VERB+neg→AUX."""
+        """PRT→PART, .→PUNCT, NOUN+Proper→PROPN, VERB+neg→AUX etc."""
         if node.xpos == 'SYM':  # These are almost always tagged as upos=X which is wrong.
             node.upos = 'SYM'
             if node.deprel in {'punct', 'p'}:
@@ -388,6 +388,9 @@ def fix_upos(self, node):
             if node.parent.deprel == 'aux':
                 node.parent = node.parent.parent
 
+        if node.upos == 'CONJ' and node.deprel == 'mark':
+            node.upos = 'SCONJ'
+
         if self.lang == 'fr':
             if node.upos == 'PROPN' and node.form.lower() in FR_DAYS_MONTHS:
                 node.upos = 'NOUN'

From a3e009ec7cad0bd209c5a0ac27b95973a9e3e26e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 4 May 2017 01:59:53 +0200
Subject: [PATCH 0119/1374] preventing other types of non-projectivity and
 handling paired commas

---
 udapi/block/ud/fixpunct.py | 34 +++++++++++++++++++++++++++-------
 1 file changed, 27 insertions(+), 7 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index ab40bb14..fda8e637 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -86,39 +86,59 @@ def _fix_subord_punct(self, node):
         if node.form == '.' and node.parent == node.prev_node:
             return
 
+        # Even non-paired punctuation like commas and dashes may work as paired.
+        # Detect such cases and try to preserve, but only if projective.
+        p_desc = node.parent.descendants(add_self=1)
+        if node in (p_desc[0], p_desc[-1]) and len(p_desc) == p_desc[-1].ord - p_desc[0].ord + 1:
+            if (p_desc[0].upos == 'PUNCT' and p_desc[-1].upos == 'PUNCT'
+                    and p_desc[0].parent == node.parent and p_desc[-1].parent == node.parent):
+                return
+
         # Initialize the candidates (left and right) with the nearest nodes excluding punctuation.
         # Final punctuation should not be attached to any following, so exclude r_cand there.
         l_cand, r_cand = node.prev_node, node.next_node
         if node.form in FINAL_PUNCT:
             r_cand = None
         while l_cand.ord > 0 and l_cand.upos == "PUNCT":
+            if self._punct_type[l_cand.ord] == 'opening':
+                l_cand = None
+                break
             l_cand = l_cand.prev_node
         while r_cand is not None and r_cand.upos == "PUNCT":
+            if self._punct_type[r_cand.ord] == 'closing':
+                r_cand = None
+                break
             r_cand = r_cand.next_node
 
         # Climb up from the candidates, until we would reach the root or "cross" the punctuation.
         # If the candidates' descendants span across the punctuation, we also stop
         # because climbing higher would cause a non-projectivity (the punct would be the gap).
+        l_path, r_path = [l_cand], [r_cand]
         if l_cand.is_root():
             l_cand = None
         else:
             while (not l_cand.parent.is_root() and l_cand.parent.precedes(node)
                    and not node.precedes(l_cand.descendants(add_self=1)[-1])):
                 l_cand = l_cand.parent
+                l_path.append(l_cand)
         if r_cand is not None:
             while (not r_cand.parent.is_root() and node.precedes(r_cand.parent)
                    and not r_cand.descendants(add_self=1)[0].precedes(node)):
                 r_cand = r_cand.parent
+                r_path.append(r_cand)
 
         # Now select between l_cand and r_cand -- which will be the new parent?
         # The lower one. Note that if neither is descendant of the other and neither is None
-        # (which can happen in rare non-projective cases), we arbitrarily prefer r_cand.
-        if l_cand is not None and not l_cand.is_root() and l_cand.is_descendant_of(r_cand):
-            cand = l_cand
-        elif r_cand is not None:
-            cand = r_cand
+        # (which can happen in rare non-projective cases), we arbitrarily prefer l_cand,
+        # but if the original parent is either on l_path or r_path, we keep it as acceptable.
+        if l_cand is not None and l_cand.is_descendant_of(r_cand):
+            cand, path = l_cand, l_path
+        elif r_cand is not None and r_cand.is_descendant_of(l_cand):
+            cand, path = r_cand, r_path
         elif l_cand is not None:
-            cand = l_cand
+            cand, path = l_cand, l_path + r_path
+        elif r_cand is not None:
+            cand, path = r_cand, l_path + r_path
         else:
             return
 
@@ -130,7 +150,7 @@ def _fix_subord_punct(self, node):
         # the second comma should depend on "kennengelernt", not on "Mann"
         # because the unit is just the relative clause.
         # We try to be conservative and keep the parent, unless we are sure it is wrong.
-        if not node.parent.is_descendant_of(cand):
+        if node.parent not in path:
             node.parent = cand
         node.deprel = "punct"
 

From 88fe0df0427869f65da3ede59b8f7dc017c7a108 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 4 May 2017 02:00:49 +0200
Subject: [PATCH 0120/1374] CCONJ->SCONJ if deprel=mark also for exgoogle

---
 udapi/block/ud/exgoogle2ud.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/ud/exgoogle2ud.py b/udapi/block/ud/exgoogle2ud.py
index 929297f5..5471ab94 100644
--- a/udapi/block/ud/exgoogle2ud.py
+++ b/udapi/block/ud/exgoogle2ud.py
@@ -8,6 +8,7 @@
 from udapi.block.ud.fixrightheaded import FixRightheaded
 from udapi.core.block import Block
 
+
 class ExGoogle2ud(Block):
     """Convert former Google Universal Dependency Treebank into UD style."""
 
@@ -51,6 +52,9 @@ def fix_node(self, node):
             node.deprel = 'obl'
             node.feats['Case'] = 'Gen'
 
+        if node.upos == 'CCONJ' and node.deprel == 'mark':
+            node.upos = 'SCONJ'
+
     @staticmethod
     def is_nominal(node):
         """Returns 'no' (for predicates), 'yes' (sure nominals) or 'maybe'.

From ce8c0ab3e2ec9e8b55f1e68ab84d9b395656b337 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 4 May 2017 02:43:23 +0200
Subject: [PATCH 0121/1374] Japanese needs ComplyWithText (or something even
 stronger)

---
 udapi/block/ud/exgoogle2ud.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/ud/exgoogle2ud.py b/udapi/block/ud/exgoogle2ud.py
index 5471ab94..f41d25f1 100644
--- a/udapi/block/ud/exgoogle2ud.py
+++ b/udapi/block/ud/exgoogle2ud.py
@@ -6,6 +6,7 @@
 from udapi.block.ud.fixchain import FixChain
 from udapi.block.ud.fixpunct import FixPunct
 from udapi.block.ud.fixrightheaded import FixRightheaded
+from udapi.block.ud.complywithtext import ComplyWithText
 from udapi.core.block import Block
 
 
@@ -18,12 +19,16 @@ def __init__(self, lang='unk', **kwargs):
         self._fixpunct_block = FixPunct()
         self._fixrigheaded_block = FixRightheaded()
         self._fixchain_block = FixChain()
+        self._comply_block = None
+        if lang == 'ja':
+            self._comply_block = ComplyWithText()
 
     def process_tree(self, root):
         for node in root.descendants:
             self.fix_node(node)
 
         for block in (
+                self._comply_block,
                 self._fixrigheaded_block,  # deprel=fixed,flat,... should be always head-initial
                 self._fixchain_block,      # and form a flat structure, not a chain.
                 self._fixpunct_block):     # commas should depend on the subord unit.

From 6cc27c430645a39725f9809aa2836e9835ca58a2 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 4 May 2017 04:06:01 +0200
Subject: [PATCH 0122/1374] Spanish AddMwt

---
 udapi/block/ud/es/__init__.py |  0
 udapi/block/ud/es/addmwt.py   | 86 +++++++++++++++++++++++++++++++++++
 udapi/block/ud/exgoogle2ud.py |  8 +++-
 udapi/block/ud/google2ud.py   |  3 ++
 4 files changed, 96 insertions(+), 1 deletion(-)
 create mode 100644 udapi/block/ud/es/__init__.py
 create mode 100644 udapi/block/ud/es/addmwt.py

diff --git a/udapi/block/ud/es/__init__.py b/udapi/block/ud/es/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/ud/es/addmwt.py b/udapi/block/ud/es/addmwt.py
new file mode 100644
index 00000000..072a6479
--- /dev/null
+++ b/udapi/block/ud/es/addmwt.py
@@ -0,0 +1,86 @@
+"""Block ud.es.AddMwt for heuristic detection of Spanish contractions.
+
+According to the UD guidelines, contractions such as "dele" = "de ele"
+should be annotated using multi-word tokens.
+
+Note that this block should be used only for converting legacy conllu files.
+Ideally a tokenizer should have already split the MWTs.
+"""
+import re
+import udapi.block.ud.addmwt
+
+MWTS = {
+    'al':      {'form': 'a el'},
+    'del':     {'form': 'de el'},
+}
+
+LEMMA = {
+    'se': 'él',
+    'le': 'él',
+    'la': 'él',
+    'lo': 'él',
+    'te': 'tú',
+    'me': 'yo',
+}
+
+# shared values for all entries in MWTS
+for v in MWTS.values():
+    v['lemma'] = v['form']
+    v['upos'] = 'ADP DET'
+    v['deprel'] = '* det'
+    v['feats'] = '_ *'
+    # The following are the default values
+    # v['main'] = 0 # which of the two words will inherit the original children (if any)
+    # v['shape'] = 'siblings', # the newly created nodes will be siblings
+
+
+class AddMwt(udapi.block.ud.addmwt.AddMwt):
+    """Detect and mark MWTs (split them into words and add the words to the tree)."""
+
+    def multiword_analysis(self, node):
+        """Return a dict with MWT info or None if `node` does not represent a multiword token."""
+        analysis = MWTS.get(node.form.lower(), None)
+
+        if analysis is not None:
+            return analysis
+
+        if node.upos not in {'VERB', 'AUX'}:
+            return None
+
+        form = node.form.lower()
+
+        if re.search('(me|la|le|lo|se|te)$', form):
+            verbform = node.feats['VerbForm']
+            # TODO there are contractions even with VerbForm=Fin
+            if verbform == 'Fin' or form == 'pese':
+                return None
+            del node.feats['VerbForm']
+            pron = form[-2:]
+            return {
+                'form': form[:-2] + ' ' + pron,
+                'lemma': '* ' + LEMMA[pron],
+                'upos': '* PRON',
+                'feats': 'VerbForm=%s *' % verbform,
+                'deprel': '* iobj',
+                'main': 0,
+                'shape': 'subtree',
+            }
+
+        if re.search('l[oe]s$', form):
+            verbform = node.feats['VerbForm']
+            if verbform == 'Fin':
+                return None
+            del node.feats['VerbForm']
+            pron = form[-3:]
+            return {
+                'form': form[:-3] + ' ' + pron,
+                'lemma': '* él',
+                'upos': '* PRON',
+                'feats': 'VerbForm=%s *' % verbform,
+                'deprel': '* iobj',
+                'main': 0,
+                'shape': 'subtree',
+            }
+
+        # TODO: multiple suffixes, e.g. compratelo = compra + te + lo
+        return None
diff --git a/udapi/block/ud/exgoogle2ud.py b/udapi/block/ud/exgoogle2ud.py
index f41d25f1..ff491544 100644
--- a/udapi/block/ud/exgoogle2ud.py
+++ b/udapi/block/ud/exgoogle2ud.py
@@ -7,6 +7,7 @@
 from udapi.block.ud.fixpunct import FixPunct
 from udapi.block.ud.fixrightheaded import FixRightheaded
 from udapi.block.ud.complywithtext import ComplyWithText
+from udapi.block.ud.es.addmwt import AddMwt as es_AddMwt
 from udapi.core.block import Block
 
 
@@ -23,11 +24,16 @@ def __init__(self, lang='unk', **kwargs):
         if lang == 'ja':
             self._comply_block = ComplyWithText()
 
+        self._addmwt_block = None
+        if lang == 'es':
+            self._addmwt_block = es_AddMwt()
+
     def process_tree(self, root):
         for node in root.descendants:
             self.fix_node(node)
 
         for block in (
+                self._addmwt_block,
                 self._comply_block,
                 self._fixrigheaded_block,  # deprel=fixed,flat,... should be always head-initial
                 self._fixchain_block,      # and form a flat structure, not a chain.
@@ -46,7 +52,7 @@ def fix_node(self, node):
                 else:
                     node.deprel = 'dep'  # This is another way how to say deprel=todo.
 
-        if node.udeprel == 'nmod' and node.deprel != 'nmod':
+        if self.lang != 'es' and node.udeprel == 'nmod' and node.deprel != 'nmod':
             parent_is_nominal = self.is_nominal(node.parent)
             if parent_is_nominal == 'no':
                 node.deprel = 'obl' + ':' + node.sdeprel
diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index aa8ec16c..5849bd33 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -9,6 +9,7 @@
 from udapi.block.ud.fixrightheaded import FixRightheaded
 from udapi.block.ud.fixpunct import FixPunct
 from udapi.block.ud.de.addmwt import AddMwt as de_AddMwt
+from udapi.block.ud.es.addmwt import AddMwt as es_AddMwt
 from udapi.block.ud.fr.addmwt import AddMwt as fr_AddMwt
 from udapi.block.ud.pt.addmwt import AddMwt as pt_AddMwt
 
@@ -124,6 +125,8 @@ def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
         self._addmwt_block = None
         if lang == 'de':
             self._addmwt_block = de_AddMwt()
+        elif lang == 'es':
+            self._addmwt_block = es_AddMwt()
         elif lang == 'fr':
             self._addmwt_block = fr_AddMwt()
         elif lang == 'pt':

From 78f75bcf69284c3690f6a56fef2f1d1b75602781 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 4 May 2017 21:22:02 +0200
Subject: [PATCH 0123/1374] Italian should not use ud.FixPunct

in order to be consistent with UD_Italian
---
 udapi/block/ud/exgoogle2ud.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/exgoogle2ud.py b/udapi/block/ud/exgoogle2ud.py
index ff491544..ed7056f4 100644
--- a/udapi/block/ud/exgoogle2ud.py
+++ b/udapi/block/ud/exgoogle2ud.py
@@ -17,7 +17,8 @@ class ExGoogle2ud(Block):
     def __init__(self, lang='unk', **kwargs):
         super().__init__(**kwargs)
         self.lang = lang
-        self._fixpunct_block = FixPunct()
+
+        self._fixpunct_block = None if self.lang == 'it' else FixPunct()
         self._fixrigheaded_block = FixRightheaded()
         self._fixchain_block = FixChain()
         self._comply_block = None

From e83a197f796e585322983dab46078e8e969b89cc Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 May 2017 10:03:00 +0200
Subject: [PATCH 0124/1374] Spanish VERB+PRON contractions are annotated as two
 words in Google data

---
 udapi/block/ud/es/addmwt.py   |  6 +++++-
 udapi/block/ud/exgoogle2ud.py |  4 ++++
 udapi/block/ud/joinasmwt.py   | 22 ++++++++++++++++++++++
 3 files changed, 31 insertions(+), 1 deletion(-)
 create mode 100644 udapi/block/ud/joinasmwt.py

diff --git a/udapi/block/ud/es/addmwt.py b/udapi/block/ud/es/addmwt.py
index 072a6479..2086b65b 100644
--- a/udapi/block/ud/es/addmwt.py
+++ b/udapi/block/ud/es/addmwt.py
@@ -37,6 +37,10 @@
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
     """Detect and mark MWTs (split them into words and add the words to the tree)."""
 
+    def __init__(self, verbpron=False, **kwargs):
+        super().__init__(**kwargs)
+        self.verbpron = verbpron
+
     def multiword_analysis(self, node):
         """Return a dict with MWT info or None if `node` does not represent a multiword token."""
         analysis = MWTS.get(node.form.lower(), None)
@@ -44,7 +48,7 @@ def multiword_analysis(self, node):
         if analysis is not None:
             return analysis
 
-        if node.upos not in {'VERB', 'AUX'}:
+        if not self.verbpron or node.upos not in {'VERB', 'AUX'}:
             return None
 
         form = node.form.lower()
diff --git a/udapi/block/ud/exgoogle2ud.py b/udapi/block/ud/exgoogle2ud.py
index ed7056f4..7cdd43b9 100644
--- a/udapi/block/ud/exgoogle2ud.py
+++ b/udapi/block/ud/exgoogle2ud.py
@@ -8,6 +8,7 @@
 from udapi.block.ud.fixrightheaded import FixRightheaded
 from udapi.block.ud.complywithtext import ComplyWithText
 from udapi.block.ud.es.addmwt import AddMwt as es_AddMwt
+from udapi.block.ud.joinasmwt import JoinAsMwt
 from udapi.core.block import Block
 
 
@@ -26,8 +27,10 @@ def __init__(self, lang='unk', **kwargs):
             self._comply_block = ComplyWithText()
 
         self._addmwt_block = None
+        self._joinasmwt_block = None
         if lang == 'es':
             self._addmwt_block = es_AddMwt()
+            self._joinasmwt_block = JoinAsMwt()
 
     def process_tree(self, root):
         for node in root.descendants:
@@ -35,6 +38,7 @@ def process_tree(self, root):
 
         for block in (
                 self._addmwt_block,
+                self._joinasmwt_block,
                 self._comply_block,
                 self._fixrigheaded_block,  # deprel=fixed,flat,... should be always head-initial
                 self._fixchain_block,      # and form a flat structure, not a chain.
diff --git a/udapi/block/ud/joinasmwt.py b/udapi/block/ud/joinasmwt.py
new file mode 100644
index 00000000..aa675878
--- /dev/null
+++ b/udapi/block/ud/joinasmwt.py
@@ -0,0 +1,22 @@
+"""Block ud.JoinAsMwt for creating multi-word tokens
+
+if multiple neighboring words are not separated by a space
+and the boundaries between the word forms are alphabetical.
+"""
+from udapi.core.block import Block
+
+
+class JoinAsMwt(Block):
+    """Create MWTs if words are not separated by a space.."""
+
+    def process_node(self, node):
+        if node.multiword_token:
+            return
+        mwt_nodes = [node]
+        while (node.no_space_after and node.next_node and not node.next_node.multiword_token
+               and node.form[-1].isalpha() and node.next_node.form[0].isalpha()):
+            node = node.next_node
+            mwt_nodes.append(node)
+        if len(mwt_nodes) > 1:
+            mwt_form = ''.join([n.form for n in mwt_nodes])
+            node.root.create_multiword_token(mwt_nodes, mwt_form, node.misc)

From e232e4c79d9262cc28376d45f70a1f075e5bc6d2 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 May 2017 10:22:01 +0200
Subject: [PATCH 0125/1374] words inside MWT should not have SpaceAfter=No

---
 udapi/block/ud/joinasmwt.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/joinasmwt.py b/udapi/block/ud/joinasmwt.py
index aa675878..255f759a 100644
--- a/udapi/block/ud/joinasmwt.py
+++ b/udapi/block/ud/joinasmwt.py
@@ -20,3 +20,5 @@ def process_node(self, node):
         if len(mwt_nodes) > 1:
             mwt_form = ''.join([n.form for n in mwt_nodes])
             node.root.create_multiword_token(mwt_nodes, mwt_form, node.misc)
+            for mwt_node in mwt_nodes:
+                del mwt_node.misc['SpaceAfter']

From 4fa99fa90b439813549459568b185d959804e152 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 May 2017 12:09:44 +0200
Subject: [PATCH 0126/1374] ud.Fix* should be applied on "flat:name" in
 addition to "flat"

---
 udapi/block/ud/fixchain.py       | 2 +-
 udapi/block/ud/fixrightheaded.py | 7 ++++---
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/fixchain.py b/udapi/block/ud/fixchain.py
index 029f9ec9..0e6fa12a 100644
--- a/udapi/block/ud/fixchain.py
+++ b/udapi/block/ud/fixchain.py
@@ -14,5 +14,5 @@ def __init__(self, deprels='fixed,goeswith,list', **kwargs):
 
     def process_node(self, node):
         for deprel in self.deprels:
-            if node.deprel == deprel and node.parent.deprel == deprel:
+            if node.udeprel == deprel and node.parent.udeprel == deprel:
                 node.parent = node.parent.parent
diff --git a/udapi/block/ud/fixrightheaded.py b/udapi/block/ud/fixrightheaded.py
index 0bb7d28c..9e127a9f 100644
--- a/udapi/block/ud/fixrightheaded.py
+++ b/udapi/block/ud/fixrightheaded.py
@@ -21,11 +21,12 @@ def __init__(self, deprels='flat,fixed,appos,goeswith,list', **kwargs):
 
     def process_node(self, node):
         for deprel in self.deprels:
-            if node.deprel == deprel and node.precedes(node.parent):
+            if node.udeprel == deprel and node.precedes(node.parent):
                 orig_parent = node.parent
                 node.parent = orig_parent.parent
                 for child in orig_parent.children:
                     child.parent = node
                 orig_parent.parent = node
-                node.deprel = orig_parent.deprel
-                orig_parent.deprel = deprel
+                head_deprel = orig_parent.deprel
+                orig_parent.deprel = node.deprel
+                node.deprel = head_deprel

From 2223983e09514526b272a5b733b22dc6257d1706 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 May 2017 12:10:26 +0200
Subject: [PATCH 0127/1374] Spanish Google uses deprel=nn, but these should
 never be compound

---
 udapi/block/ud/exgoogle2ud.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/udapi/block/ud/exgoogle2ud.py b/udapi/block/ud/exgoogle2ud.py
index 7cdd43b9..f63fad74 100644
--- a/udapi/block/ud/exgoogle2ud.py
+++ b/udapi/block/ud/exgoogle2ud.py
@@ -71,6 +71,14 @@ def fix_node(self, node):
         if node.upos == 'CCONJ' and node.deprel == 'mark':
             node.upos = 'SCONJ'
 
+        if self.lang == 'es':
+            if node.deprel == 'compound':
+                # most of the uppercase compounds are upos=PROPN, but not all, e.g. Hack Forums
+                if node.form[0].isupper():
+                    node.deprel = 'flat:name'
+                else:
+                    node.deprel = 'nmod'
+
     @staticmethod
     def is_nominal(node):
         """Returns 'no' (for predicates), 'yes' (sure nominals) or 'maybe'.

From 55fb247281e25e5333f944a565357765767a2820 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 5 May 2017 14:33:15 +0200
Subject: [PATCH 0128/1374] Changes suggested by @ermanh.

---
 udapi/block/ud/google2ud.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 5849bd33..a1b9f8fa 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -16,7 +16,7 @@
 DEPREL_CHANGE = {
     "ROOT": "root",
     "prep": "case",
-    "ncomp": "case",  # TODO ?
+    "ncomp": "case:loc",  # only in Chinese; Herman proposes case:loc
     "p": "punct",
     "poss": "nmod:poss",
     "ps": "case",
@@ -32,9 +32,9 @@
     "gobj": "obj",
     "postneg": "neg",  # will be changed to advmod + Polarity=Neg in ud.Convert1to2
     "pronl": "obj",  # TODO: or expl? UD_French seems to use a mix of both
-    "redup": "compound:plur",
+    "redup": "compound:plur",  # TODO: compound:plur in Indonesian; compound:redup elsewhere
     "oblcomp": "obl",
-    "mes": "dep",  # TODO ?
+    "mes": "clf",  # TODO: structural transformation needed
     "mwn": "compound:n",  # nominal multi-word
     "mwa": "compound:a",  # adjectival multi-word
     "mwv": "compound:v",  # verbal multi-word

From 4802b069721c1d017515b6958378f223f159196c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 5 May 2017 14:33:15 +0200
Subject: [PATCH 0129/1374] Changes suggested by @ermanh.

---
 udapi/block/ud/google2ud.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 5849bd33..a1b9f8fa 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -16,7 +16,7 @@
 DEPREL_CHANGE = {
     "ROOT": "root",
     "prep": "case",
-    "ncomp": "case",  # TODO ?
+    "ncomp": "case:loc",  # only in Chinese; Herman proposes case:loc
     "p": "punct",
     "poss": "nmod:poss",
     "ps": "case",
@@ -32,9 +32,9 @@
     "gobj": "obj",
     "postneg": "neg",  # will be changed to advmod + Polarity=Neg in ud.Convert1to2
     "pronl": "obj",  # TODO: or expl? UD_French seems to use a mix of both
-    "redup": "compound:plur",
+    "redup": "compound:plur",  # TODO: compound:plur in Indonesian; compound:redup elsewhere
     "oblcomp": "obl",
-    "mes": "dep",  # TODO ?
+    "mes": "clf",  # TODO: structural transformation needed
     "mwn": "compound:n",  # nominal multi-word
     "mwa": "compound:a",  # adjectival multi-word
     "mwv": "compound:v",  # verbal multi-word

From 80b3e789cee7ef017158b486b971fa66448fd92b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 May 2017 14:45:07 +0200
Subject: [PATCH 0130/1374] implement @dan-zeman's comment

---
 udapi/block/ud/google2ud.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index a1b9f8fa..6cbf1eeb 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -32,7 +32,6 @@
     "gobj": "obj",
     "postneg": "neg",  # will be changed to advmod + Polarity=Neg in ud.Convert1to2
     "pronl": "obj",  # TODO: or expl? UD_French seems to use a mix of both
-    "redup": "compound:plur",  # TODO: compound:plur in Indonesian; compound:redup elsewhere
     "oblcomp": "obl",
     "mes": "clf",  # TODO: structural transformation needed
     "mwn": "compound:n",  # nominal multi-word
@@ -473,3 +472,5 @@ def fix_deprel(self, node):
         elif node.deprel == 'appos':
             if self.lang == 'fr' and node.parent.form in {'M.', 'Mme', 'Dr'}:
                 node.deprel = 'flat:name'
+        elif node.deprel == 'redup':
+            node.deprel = 'compound:plur' if self.lang == 'id' else 'compound:redup'

From 91c554a11943dbf7cb259b803821ea4762756b15 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 5 May 2017 16:10:11 +0200
Subject: [PATCH 0131/1374] Compound:prt is for Germanic languages only.

---
 udapi/block/ud/google2ud.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 6cbf1eeb..76df231f 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -26,7 +26,6 @@
     "vmod": "acl",
     "rcmod": "acl:relcl",
     "npadvmod": "advmod",
-    "prt": "compound:prt",
     "preconj": "cc:preconj",
     "predet": "det:predet",
     "gobj": "obj",
@@ -472,5 +471,7 @@ def fix_deprel(self, node):
         elif node.deprel == 'appos':
             if self.lang == 'fr' and node.parent.form in {'M.', 'Mme', 'Dr'}:
                 node.deprel = 'flat:name'
+        elif node.deprel == 'prt':
+            node.deprel = 'compound:prt' if self.lang in {'en', 'de', 'nl', 'sv', 'da', 'no'} else 'dep:prt'
         elif node.deprel == 'redup':
             node.deprel = 'compound:plur' if self.lang == 'id' else 'compound:redup'

From d5a782f53587d0afb581a41c56d80fb557c0e337 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 6 May 2017 14:10:17 +0200
Subject: [PATCH 0132/1374] fix Spanish MWT: "el" should always depend on NOUN

---
 udapi/block/ud/es/addmwt.py | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/udapi/block/ud/es/addmwt.py b/udapi/block/ud/es/addmwt.py
index 2086b65b..ee85b1d6 100644
--- a/udapi/block/ud/es/addmwt.py
+++ b/udapi/block/ud/es/addmwt.py
@@ -88,3 +88,17 @@ def multiword_analysis(self, node):
 
         # TODO: multiple suffixes, e.g. compratelo = compra + te + lo
         return None
+
+    # Sometimes "del" has a shape which is neither "siblings" nor "subtree".
+    # E.g. in "a partir del NOUN"
+    # "del" = "de el", but
+    # "de" is attached to "a" (as fixed), while "el" is attached to the NOUN.
+    def postprocess_mwt(self, mwt):
+        if mwt.form.lower() in {'al', 'del'} and mwt.words[1].parent.precedes(mwt.words[1]):
+            head = mwt.words[1].next_node
+            while head.upos not in {'NOUN', 'PROPN'}:
+                if head.parent.precedes(head) or head.is_root():
+                    head = mwt.words[1].next_node
+                    break
+                head = head.parent
+            mwt.words[1].parent = head

From 3c8cdd3a4f1d35ae1fed21bdbf7fd4f84360d728 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 6 May 2017 16:18:35 +0200
Subject: [PATCH 0133/1374] fix Google-Turkish coordinations

---
 udapi/block/ud/fixrightheaded.py |  5 +++--
 udapi/block/ud/google2ud.py      | 15 ++++++++++++++-
 2 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/fixrightheaded.py b/udapi/block/ud/fixrightheaded.py
index 9e127a9f..045278dd 100644
--- a/udapi/block/ud/fixrightheaded.py
+++ b/udapi/block/ud/fixrightheaded.py
@@ -24,8 +24,9 @@ def process_node(self, node):
             if node.udeprel == deprel and node.precedes(node.parent):
                 orig_parent = node.parent
                 node.parent = orig_parent.parent
-                for child in orig_parent.children:
-                    child.parent = node
+                if deprel != 'conj':
+                    for child in orig_parent.children:
+                        child.parent = node
                 orig_parent.parent = node
                 head_deprel = orig_parent.deprel
                 orig_parent.deprel = node.deprel
diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 76df231f..f06c8db1 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -131,8 +131,10 @@ def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
             self._addmwt_block = pt_AddMwt()
 
         self._fixrigheaded_block = None
-        if lang in {'ar', 'de', 'en', 'fr', 'hi', 'ru', 'th', 'tr', 'zh'}:
+        if lang in {'ar', 'de', 'en', 'fr', 'hi', 'ru', 'th', 'zh'}:
             self._fixrigheaded_block = FixRightheaded()
+        elif lang == 'tr':
+            self._fixrigheaded_block = FixRightheaded(deprels='conj,flat,fixed,appos,goeswith,list')
 
         # Normalize the attachment of punctuation for all languages.
         self._fixpunct_block = FixPunct()
@@ -174,6 +176,17 @@ def process_tree(self, root):
             for node in root.descendants:
                 self.fix_goeswith(node)
 
+        # Google Turkish annotation of coordination is very different from both UDv1 and UDv2.
+        if self.lang == 'tr':
+            for node in root.descendants:
+                conjs = [n for n in node.children if n.deprel == 'conj']
+                if conjs:
+                    conjs[0].parent = node.parent
+                    conjs[0].deprel = node.deprel
+                    node.deprel = 'conj'
+                    for nonfirst_conj in conjs[1:] + [node]:
+                        nonfirst_conj.parent = conjs[0]
+
         # Multi-word prepositions must be solved before fix_deprel() fixes pobj+pcomp.
         for node in root.descendants:
             self.fix_multiword_prep(node)

From aaa7c759c1bf3ca50aeb97b0af47d2b63a00e6a9 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 6 May 2017 17:26:59 +0200
Subject: [PATCH 0134/1374] UD_Turkish has no pairs of alphabetical words not
 separated by a space

without being a part of MWT, so let's join such words into MWT.
(Similarly for Spanish - this only follows the ud.ExGoogle2ud).
---
 udapi/block/ud/google2ud.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index f06c8db1..4d996159 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -12,6 +12,7 @@
 from udapi.block.ud.es.addmwt import AddMwt as es_AddMwt
 from udapi.block.ud.fr.addmwt import AddMwt as fr_AddMwt
 from udapi.block.ud.pt.addmwt import AddMwt as pt_AddMwt
+from udapi.block.ud.joinasmwt import JoinAsMwt
 
 DEPREL_CHANGE = {
     "ROOT": "root",
@@ -129,6 +130,7 @@ def __init__(self, lang='unk', non_mwt_langs='ar en ja ko zh', **kwargs):
             self._addmwt_block = fr_AddMwt()
         elif lang == 'pt':
             self._addmwt_block = pt_AddMwt()
+        self._joinasmwt_block = JoinAsMwt() if lang in {'es', 'tr'} else None
 
         self._fixrigheaded_block = None
         if lang in {'ar', 'de', 'en', 'fr', 'hi', 'ru', 'th', 'zh'}:
@@ -215,6 +217,7 @@ def process_tree(self, root):
 
         for block in (
                 self._addmwt_block,        # e.g. "im" -> "in dem" in de. Must follow Convert1to2.
+                self._joinasmwt_block,     # no pair of alphabetical words with SpaceAfter=No
                 self._fixrigheaded_block,  # deprel=fixed,flat,... should be always head-initial
                 self._fixchain_block,      # and form a flat structure, not a chain.
                 self._fixpunct_block):     # commas should depend on the subord unit.

From 480dff974fa62d4be3738638e7eaade35aa94f6b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 6 May 2017 19:22:37 +0200
Subject: [PATCH 0135/1374] improve util.MarkDiff, so it works even for
 deleted/inserted nodes

---
 udapi/block/util/markdiff.py | 54 ++++++++++++++++++++++--------------
 1 file changed, 33 insertions(+), 21 deletions(-)

diff --git a/udapi/block/util/markdiff.py b/udapi/block/util/markdiff.py
index b1542608..22a7a03e 100644
--- a/udapi/block/util/markdiff.py
+++ b/udapi/block/util/markdiff.py
@@ -1,10 +1,12 @@
 """util.MarkDiff is a special block for marking differences between parallel trees."""
+import difflib
 from udapi.core.block import Block
 
+
 class MarkDiff(Block):
     """Mark differences between parallel trees."""
 
-    def __init__(self, gold_zone, attributes='form,p_ord,lemma,upos,xpos,deprel,feats,misc',
+    def __init__(self, gold_zone, attributes='form,lemma,upos,xpos,deprel,feats,misc',
                  mark=1, add=False, **kwargs):
         """Create the Mark block object."""
         super().__init__(**kwargs)
@@ -17,26 +19,36 @@ def process_tree(self, tree):
         gold_tree = tree.bundle.get_tree(self.gold_zone)
         if tree == gold_tree:
             return
-        nodes, gold_nodes = tree.descendants, gold_tree.descendants
-        if len(nodes) != len(gold_nodes):
-            # TODO use eval.F1.find_lcs to find the nodes responsible for the diff
+        if not self.add:
+            for node in tree.descendants + gold_tree.descendants:
+                del node.misc['Mark']
+                del node.misc['ToDo']
+                del node.misc['Bug']
+
+        pred_nodes, gold_nodes = tree.descendants, gold_tree.descendants
+        # Make sure both pred and gold trees are marked, even if one has just deleted nodes.
+        if len(pred_nodes) != len(gold_nodes):
             tree.add_comment('Mark = %s' % self.mark)
             gold_tree.add_comment('Mark = %s' % self.mark)
-        else:
-            for node, gold_node in zip(nodes, gold_nodes):
-                self.diff_nodes(node, gold_node)
+        pred_tokens = ['_'.join(n.get_attrs(self.attrs)) for n in pred_nodes]
+        gold_tokens = ['_'.join(n.get_attrs(self.attrs)) for n in gold_nodes]
+        matcher = difflib.SequenceMatcher(None, pred_tokens, gold_tokens, autojunk=False)
+        diffs = list(matcher.get_opcodes())
 
-    def diff_nodes(self, node, gold_node):
-        """Compare attributes of two nodes and mark if different."""
-        label = '_'.join(node.get_attrs(self.attrs))
-        gold_label = '_'.join(gold_node.get_attrs(self.attrs))
-        if not self.add:
-            del node.misc['Mark']
-            del node.misc['ToDo']
-            del node.misc['Bug']
-            del gold_node.misc['Mark']
-            del gold_node.misc['ToDo']
-            del gold_node.misc['Bug']
-        if label != gold_label:
-            node.misc['Mark'] = self.mark
-            gold_node.misc['Mark'] = self.mark
+        alignment = {-1: -1}
+        for diff in diffs:
+            edit, pred_lo, pred_hi, gold_lo, gold_hi = diff
+            if edit in {'equal', 'replace'}:
+                for i in range(pred_lo, pred_hi):
+                    alignment[i] = i - pred_lo + gold_lo
+
+        for diff in diffs:
+            edit, pred_lo, pred_hi, gold_lo, gold_hi = diff
+            if edit == 'equal':
+                for p_node, g_node in zip(pred_nodes[pred_lo:pred_hi], gold_nodes[gold_lo:gold_hi]):
+                    if alignment.get(p_node.parent.ord - 1) != g_node.parent.ord - 1:
+                        p_node.misc['Mark'] = self.mark
+                        g_node.misc['Mark'] = self.mark
+            else:
+                for node in pred_nodes[pred_lo:pred_hi] + gold_nodes[gold_lo:gold_hi]:
+                    node.misc['Mark'] = self.mark

From e7dc8a49e4dcbcc52f39c7b5f0d20f75164636d9 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 7 May 2017 00:58:47 +0200
Subject: [PATCH 0136/1374] solve Turkish deprel=ig

---
 udapi/block/ud/google2ud.py | 34 +++++++++++++++++++++++++++++++---
 1 file changed, 31 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 4d996159..8da281e5 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -3,6 +3,7 @@
 Usage:
 udapy -s ud.Google2ud < google.conllu > ud2.conllu
 """
+import re
 from udapi.block.ud.convert1to2 import Convert1to2
 from udapi.block.ud.complywithtext import ComplyWithText
 from udapi.block.ud.fixchain import FixChain
@@ -167,7 +168,7 @@ def process_tree(self, root):
         # Unlike UDv2, Google style uses `goeswith` mostly to fix "wrong" tokenization,
         # e.g. "e-mail" written correctly without spaces, but tokenized into three words.
         # Moreover, the hyphen is not always marked with `goeswith`.
-        if self.lang in {'de', 'fr', 'it', 'pt', 'ru'}:
+        if self.lang in {'de', 'fr', 'it', 'pt', 'ru', 'tr'}:
             for node in root.descendants:
                 if node.form == '-' and node.no_space_after and node.prev_node.no_space_after:
                     if 'goeswith' in (node.prev_node.deprel, node.next_node.deprel):
@@ -179,6 +180,7 @@ def process_tree(self, root):
                 self.fix_goeswith(node)
 
         # Google Turkish annotation of coordination is very different from both UDv1 and UDv2.
+        # Also some of the deprel=ig nodes should be merged with their parents.
         if self.lang == 'tr':
             for node in root.descendants:
                 conjs = [n for n in node.children if n.deprel == 'conj']
@@ -188,6 +190,9 @@ def process_tree(self, root):
                     node.deprel = 'conj'
                     for nonfirst_conj in conjs[1:] + [node]:
                         nonfirst_conj.parent = conjs[0]
+            for node in root.descendants:
+                if node.deprel == 'ig' and re.match('leş|laş', node.parent.form.lower()):
+                    self._merge_with(node.parent, node)
 
         # Multi-word prepositions must be solved before fix_deprel() fixes pobj+pcomp.
         for node in root.descendants:
@@ -249,7 +254,7 @@ def fix_goeswith(self, node):
 
         # Other languages use goeswith for marking Google-tokenization errors.
         # In Portuguese, there are in addition cases like "Primeira Dama".
-        elif self.lang in {'fr', 'it', 'pt', 'ru'}:
+        elif self.lang in {'fr', 'it', 'pt', 'ru', 'tr'}:
             if node.precedes(node.parent) and node.misc['SpaceAfter'] == 'No':
                 self._merge_with(node.next_node, node)
             elif node.parent.precedes(node) and node.prev_node.misc['SpaceAfter'] == 'No':
@@ -488,6 +493,29 @@ def fix_deprel(self, node):
             if self.lang == 'fr' and node.parent.form in {'M.', 'Mme', 'Dr'}:
                 node.deprel = 'flat:name'
         elif node.deprel == 'prt':
-            node.deprel = 'compound:prt' if self.lang in {'en', 'de', 'nl', 'sv', 'da', 'no'} else 'dep:prt'
+            if self.lang in {'en', 'de', 'nl', 'sv', 'da', 'no'}:
+                node.deprel = 'compound:prt'
+            else:
+                node.deprel = 'dep:prt'
         elif node.deprel == 'redup':
             node.deprel = 'compound:plur' if self.lang == 'id' else 'compound:redup'
+        elif node.deprel == 'ig':
+            if node.parent.form == 'ki':
+                ki = node.parent
+                node.deprel = ki.deprel
+                ki.upos = 'ADP'
+                ki.deprel = 'case'
+                node.parent = ki.parent
+                ki.parent = node
+            elif node.upos == 'AUX' or node.form == 'ler':  # dır, dir, ydi, dı, ydı, tu, değil,...
+                node.deprel = 'cop'
+            elif node.parent.upos == 'AUX':  # yaşlıyken, gençken,...
+                copula = node.parent
+                node.parent = copula.parent
+                copula.parent = node
+                node.deprel = copula.deprel
+                copula.deprel = 'cop'
+            elif node.upos == 'PUNCT':
+                node.deprel == 'punct'
+            else:
+                node.deprel = 'dep:ig'

From 19973301f9abf38d77e83670a4251f8f7d9dbd90 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 7 May 2017 01:18:03 +0200
Subject: [PATCH 0137/1374] Turkish: prt -> advmod:emph

---
 udapi/block/ud/google2ud.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 8da281e5..56f7dff4 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -495,6 +495,8 @@ def fix_deprel(self, node):
         elif node.deprel == 'prt':
             if self.lang in {'en', 'de', 'nl', 'sv', 'da', 'no'}:
                 node.deprel = 'compound:prt'
+            elif self.lang == 'tr':
+                node.deprel = 'advmod:emph'
             else:
                 node.deprel = 'dep:prt'
         elif node.deprel == 'redup':

From 98223fc330b817805b8977641fbab5e8f1834bfd Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 7 May 2017 23:18:01 +0200
Subject: [PATCH 0138/1374] allow e.g. `node.udeprel = 'nmod'`

---
 udapi/core/node.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index f8c53a57..c01f51a5 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -107,6 +107,14 @@ def udeprel(self):
         """
         return self.deprel.split(':')[0] if self.deprel is not None else None
 
+    @udeprel.setter
+    def udeprel(self, value):
+        sdeprel = self.sdeprel
+        if sdeprel is not None and sdeprel != '':
+            self.deprel = value + ':' + sdeprel
+        else:
+            self.deprel = value
+
     @property
     def sdeprel(self):
         """Return the language-specific part of dependency relation.

From 7e492aad992580c753bb060330aeb0f988937483 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 8 May 2017 00:37:53 +0200
Subject: [PATCH 0139/1374] fix Turkish deprels narg, obl:poss etc.

---
 udapi/block/ud/google2ud.py | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 56f7dff4..453bb9c0 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -49,6 +49,7 @@
     "conjv": "compound:conjv",
     "advphmod": "advmod",
     "clas": "clf",
+    "narg": "nmod:arg",  # Turkish only
 }
 
 FEATS_CHANGE = {
@@ -99,8 +100,6 @@
     "mood=psm": "Tense=Fut",  # TODO ?
     "form=fin": "VerbForm=Fin",
     "form=ger": "VerbForm=Ger",
-    # "form=irr": "VerbForm=?",
-    # "form=adn": "VerbForm=?",
     "formality=fml": "Polite=Form",
     "Evidentiality=Nfh": "Evident=Nfh",
     "Evidentiality=Fh": "Evident=Fh",
@@ -229,6 +228,12 @@ def process_tree(self, root):
             if block:
                 block.process_tree(root)
 
+        if self.lang == 'tr':
+            root.children[0].deprel = 'root'
+            for node in root.descendants:
+                if node.deprel in {'obl:poss', 'obl:arg'}:
+                    node.udeprel = 'nmod'
+
     def fix_goeswith(self, node):
         """Solve deprel=goeswith which is almost always wrong in the Google annotation."""
         if node.deprel != 'goeswith':
@@ -502,7 +507,7 @@ def fix_deprel(self, node):
         elif node.deprel == 'redup':
             node.deprel = 'compound:plur' if self.lang == 'id' else 'compound:redup'
         elif node.deprel == 'ig':
-            if node.parent.form == 'ki':
+            if node.parent.form == 'ki' and node.parent.deprel not in {'prep', 'pobj'}:
                 ki = node.parent
                 node.deprel = ki.deprel
                 ki.upos = 'ADP'
@@ -518,6 +523,6 @@ def fix_deprel(self, node):
                 node.deprel = copula.deprel
                 copula.deprel = 'cop'
             elif node.upos == 'PUNCT':
-                node.deprel == 'punct'
+                node.deprel = 'punct'
             else:
                 node.deprel = 'dep:ig'

From efa0a43ebde15d3663b0ba635f36b45a3a4af053 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 9 May 2017 07:46:43 +0200
Subject: [PATCH 0140/1374] fix highlighting comment in write.TextModeTreesHtml

escape must be applied before the highlighting,
otherwise the <mark>tags</mark> are escaped.
---
 udapi/block/write/textmodetreeshtml.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/write/textmodetreeshtml.py b/udapi/block/write/textmodetreeshtml.py
index a90b7ef7..75a39a97 100644
--- a/udapi/block/write/textmodetreeshtml.py
+++ b/udapi/block/write/textmodetreeshtml.py
@@ -67,7 +67,7 @@ def colorize_comment(self, comment):
         """Return a string with color markup for a given comment."""
         if self.mark_re is None:
             return comment
-        return self.mark_re.sub(r'<mark>\g<0></mark>', comment)
+        return self.comment_mark_re.sub(r'<mark>\g<0></mark>', comment)
 
     @staticmethod
     def colorize_attr(attr, value, marked):
@@ -81,4 +81,4 @@ def print_headers(self, root):
             text = "# text = " + (root.get_sentence() if root.is_root() else root.compute_text())
             print(escape(text))
         if self.print_comments and root.comment:
-            print(escape('#' + self.colorize_comment(root.comment.rstrip().replace('\n', '\n#'))))
+            print('#' + self.colorize_comment(escape(root.comment)).rstrip().replace('\n', '\n#'))

From 262ca32c330c91880c07d4674700781e55411e2e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 9 May 2017 08:24:02 +0200
Subject: [PATCH 0141/1374] util.Eval should respect the parameter "zones"

---
 udapi/block/util/eval.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/util/eval.py b/udapi/block/util/eval.py
index 9bde12bf..b814b80d 100644
--- a/udapi/block/util/eval.py
+++ b/udapi/block/util/eval.py
@@ -85,8 +85,8 @@ def process_bundle(self, bundle):
         if self.tree or self.node:
             trees = bundle.trees
             for tree in trees:
-                # TODO if not self._should_process_tree(tree): continue
-                self.process_tree(tree)
+                if self._should_process_tree(tree):
+                    self.process_tree(tree)
 
         if self.after_bundle:
             exec(self.expand_eval_code(self.after_bundle))

From 7a91696d7831aeb003731c87834bdb65c525f0b0 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 9 May 2017 13:01:10 +0200
Subject: [PATCH 0142/1374] tutorial.Parse template and transform.Flatten

the latter is a bit faster and shorter to write alternative for
util.Eval node='node.parent=node.root'
---
 udapi/block/transform/flatten.py |  8 ++++++++
 udapi/block/tutorial/parse.py    | 21 +++++++++++++++++++++
 2 files changed, 29 insertions(+)
 create mode 100644 udapi/block/transform/flatten.py
 create mode 100644 udapi/block/tutorial/parse.py

diff --git a/udapi/block/transform/flatten.py b/udapi/block/transform/flatten.py
new file mode 100644
index 00000000..f5867eb0
--- /dev/null
+++ b/udapi/block/transform/flatten.py
@@ -0,0 +1,8 @@
+"""transform.Flatten block for flattening trees."""
+from udapi.core.block import Block
+
+class Flatten(Block):
+    """Apply `node.parent = node.root` on all nodes."""
+
+    def process_node(self, node):
+        node.parent = node.root
diff --git a/udapi/block/tutorial/parse.py b/udapi/block/tutorial/parse.py
new file mode 100644
index 00000000..c401faf7
--- /dev/null
+++ b/udapi/block/tutorial/parse.py
@@ -0,0 +1,21 @@
+"""tutorial.Parse block template.
+
+Usage:
+udapy read.Conllu zone=gold files=sample.conllu \
+      read.Conllu zone=pred files=sample.conllu \
+      transform.Flatten zones=pred \
+      tutorial.Parse zones=pred \
+      eval.Parsing gold_zone=gold \
+      util.MarkDiff gold_zone=gold \
+      write.TextModeTreesHtml marked_only=1 files=parse-diff.html
+"""
+from udapi.core.block import Block
+
+class Parse(Block):
+    """Dependency parsing."""
+
+    def process_tree(self, root):
+        # TODO: Your task: implement a better heuristics than "right chain"
+        for node in root.descendants:
+            if node.next_node:
+                node.parent = node.next_node

From 2c64a6c9b139ba8edaf73296b2d850fef3c1be4b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 9 May 2017 13:23:32 +0200
Subject: [PATCH 0143/1374] flatten should also delete all deprels (make them
 "root")

---
 udapi/block/transform/flatten.py | 3 ++-
 udapi/block/tutorial/parse.py    | 1 +
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/transform/flatten.py b/udapi/block/transform/flatten.py
index f5867eb0..ded64fb1 100644
--- a/udapi/block/transform/flatten.py
+++ b/udapi/block/transform/flatten.py
@@ -2,7 +2,8 @@
 from udapi.core.block import Block
 
 class Flatten(Block):
-    """Apply `node.parent = node.root` on all nodes."""
+    """Apply `node.parent = node.root; node.deprel = 'root'` on all nodes."""
 
     def process_node(self, node):
         node.parent = node.root
+        node.deprel = 'root'
diff --git a/udapi/block/tutorial/parse.py b/udapi/block/tutorial/parse.py
index c401faf7..77928782 100644
--- a/udapi/block/tutorial/parse.py
+++ b/udapi/block/tutorial/parse.py
@@ -19,3 +19,4 @@ def process_tree(self, root):
         for node in root.descendants:
             if node.next_node:
                 node.parent = node.next_node
+                node.deprel = 'root'

From 85fe28cf44a1c11819ec408b691114f253bd0fae Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 11 May 2017 18:23:31 +0200
Subject: [PATCH 0144/1374] report also udeprel LAS (ignoring sdeprel)

---
 udapi/block/eval/parsing.py | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/udapi/block/eval/parsing.py b/udapi/block/eval/parsing.py
index 86d7b089..3e1b7ff2 100644
--- a/udapi/block/eval/parsing.py
+++ b/udapi/block/eval/parsing.py
@@ -9,7 +9,7 @@ def __init__(self, gold_zone, **kwargs):
         """Create the eval.Parsing block object."""
         super().__init__(**kwargs)
         self.gold_zone = gold_zone
-        self.correct_las, self.correct_uas, self.total = 0, 0, 0
+        self.correct_las, self.correct_ulas, self.correct_uas, self.total = 0, 0, 0, 0
 
     def process_tree(self, tree):
         gold_tree = tree.bundle.get_tree(self.gold_zone)
@@ -27,10 +27,14 @@ def process_tree(self, tree):
                 self.correct_uas += 1
                 if pred_node.deprel == gold_node.deprel:
                     self.correct_las += 1
+                if pred_node.udeprel == gold_node.udeprel:
+                    self.correct_ulas += 1
+
 
     def process_end(self):
         # Redirect the default filehandle to the file specified by self.files
         self.before_process_document(None)
         print('nodes = %d' % self.total)
-        print('UAS = %6.2f' % (100 * self.correct_uas / self.total))
-        print('LAS = %6.2f' % (100 * self.correct_las / self.total))
+        print('UAS           = %6.2f' % (100 * self.correct_uas / self.total))
+        print('LAS (deprel)  = %6.2f' % (100 * self.correct_las / self.total))
+        print('LAS (udeprel) = %6.2f' % (100 * self.correct_las / self.total))

From 33bdb7d7529f7b07870927155bde15fc64852240 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 18 May 2017 23:23:28 +0200
Subject: [PATCH 0145/1374] FixChain should fix also deprel=flat

---
 udapi/block/ud/fixchain.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/fixchain.py b/udapi/block/ud/fixchain.py
index 0e6fa12a..b3a586f6 100644
--- a/udapi/block/ud/fixchain.py
+++ b/udapi/block/ud/fixchain.py
@@ -1,11 +1,11 @@
-"""Block ud.FixChain for making sure deprel=fixed|goeswith|list does not form a chain."""
+"""Block ud.FixChain for making sure deprel=fixed|flat|goeswith|list does not form a chain."""
 from udapi.core.block import Block
 
 
 class FixChain(Block):
-    """Make sure deprel=fixed does not form a chain, but a flat structure."""
+    """Make sure deprel=fixed etc. does not form a chain, but a flat structure."""
 
-    def __init__(self, deprels='fixed,goeswith,list', **kwargs):
+    def __init__(self, deprels='fixed,flat,goeswith,list', **kwargs):
         """Args:
         deprels: comma-separated list of deprels to be fixed. Default = fixed,goeswith,list.
         """

From 5ae3fece2bf575d35b3cbda9761231cad2e68444 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 19 May 2017 19:38:06 +0200
Subject: [PATCH 0146/1374] bugfix (if comma after opening punctuation)

---
 udapi/block/ud/fixpunct.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index fda8e637..e810c58d 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -114,7 +114,7 @@ def _fix_subord_punct(self, node):
         # If the candidates' descendants span across the punctuation, we also stop
         # because climbing higher would cause a non-projectivity (the punct would be the gap).
         l_path, r_path = [l_cand], [r_cand]
-        if l_cand.is_root():
+        if l_cand is None or l_cand.is_root():
             l_cand = None
         else:
             while (not l_cand.parent.is_root() and l_cand.parent.precedes(node)

From 06fb8167da295625ecf8768d745c79180a6a36d6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 19 May 2017 20:26:08 +0200
Subject: [PATCH 0147/1374] ud.MarkBugs tests punct-nonproj-gap (in addition to
 punct-nonproj)

using a new method `node.is_nonprojective_gap()`
---
 udapi/block/ud/markbugs.py |  7 +++++--
 udapi/core/node.py         | 22 ++++++++++++++++++++++
 2 files changed, 27 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index dc244a79..ac94242b 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -164,8 +164,11 @@ def process_node(self, node):
             self.log(node, 'punct-deprel', 'upos=PUNCT deprel!=punct|fixed|goeswith|root (but %s)'
                      % deprel)
 
-        if upos == 'PUNCT' and node.is_nonprojective():
-            self.log(node, 'punct-nonproj', 'upos=PUNCT and edge is non-projective')
+        if upos == 'PUNCT':
+            if node.is_nonprojective():
+                self.log(node, 'punct-nonproj', 'upos=PUNCT and edge is non-projective')
+            if node.is_nonprojective_gap() and not node.parent.is_nonprojective_gap():
+                self.log(node, 'punct-nonproj-gap', 'upos=PUNCT and causing a non-projectivity')
 
         # http://universaldependencies.org/u/dep/cc.html says
         #   "cc is the relation between a conjunct and a preceding
diff --git a/udapi/core/node.py b/udapi/core/node.py
index c01f51a5..e9fbe1a5 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -640,6 +640,28 @@ def is_nonprojective(self):
         # For projective edges, span must include all the nodes between parent and self.
         return len(span) != distance - 1
 
+    def is_nonprojective_gap(self):
+        """Is the node causing a non-projective gap within another node's subtree?
+
+        Is there at least one node X such that
+        - this node is not a descendant of X, but
+        - this node is within span of X, i.e. it is between (word-order-wise)
+          X's leftmost descendant (or X itself) and X's rightmost descendant (or X itself).
+        """
+        ancestors = set()
+        node = self
+        while node.parent:
+            ancestors.add(node)
+            node = node.parent
+        all_nodes = node.descendants
+        for left_node in all_nodes[:self.ord - 1]:
+            if self.precedes(left_node.parent) and left_node.parent not in ancestors:
+                return True
+        for right_node in all_nodes[self.ord:]:
+            if right_node.parent.precedes(node) and right_node.parent not in ancestors:
+                return True
+        return False
+
     @property
     def no_space_after(self):
         """Boolean property as a shortcut for `node.misc["SpaceAfter"] == "No"`."""

From 6c51531d76e20a3e2f2ce7ccf1fc3929e99a8e4c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 19 May 2017 21:47:31 +0200
Subject: [PATCH 0148/1374] don't highlight "Mark" in MISC unless it is "Mark="

---
 udapi/block/write/textmodetrees.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index 607ad48e..bcfc51cc 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -88,7 +88,7 @@ class TextModeTrees(BaseWriter):
     def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
                  minimize_cross=True, color='auto', attributes='form,upos,deprel',
                  print_undef_as='_', print_doc_meta=True, print_comments=False,
-                 mark='ToDo|Bug|Mark', marked_only=False, **kwargs):
+                 mark='ToDo|ToDoOrigText|Bug|Mark', marked_only=False, **kwargs):
         """Create new TextModeTrees block object.
 
         Args:
@@ -110,7 +110,7 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         print_undef_as: What should be printed instead of undefined attribute values (if any)?
         print_doc_meta: Print `document.meta` metadata before each document?
         print_comments: Print comments (other than sent_id and text)?
-        mark: a regex. If `re.search(mark, str(node.misc))` the node is highlighted.
+        mark: a regex. If `re.search(mark + '=', str(node.misc))` the node is highlighted.
             If `print_comments and re.search(r'^ (%s) = ' % mark, root.comment, re.M)`
             the comment is highlighted.
             Empty string means no highlighting. Default = 'ToDo|ToDoOrigText|Bug|Mark'.
@@ -143,7 +143,7 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         self.attrs = attributes.split(',')
         self.mark_re, self.comment_mark_re = None, None
         if mark is not None and mark != '':
-            self.mark_re = re.compile(mark)
+            self.mark_re = re.compile(mark + '=')
             self.comment_mark_re = re.compile(r'^ (%s) = ' % mark, re.M)
         self._index_of = []
         self._gaps = []

From 8b72352c47ca2cf9262258d6795e0f851c03998f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 20 May 2017 00:19:06 +0200
Subject: [PATCH 0149/1374] switch to UDv2 UDPipe models

---
 udapi/block/udpipe/base.py | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
index 78563abb..11e12b65 100644
--- a/udapi/block/udpipe/base.py
+++ b/udapi/block/udpipe/base.py
@@ -3,11 +3,6 @@
 from udapi.tool.udpipe import UDPipe
 
 KNOWN_MODELS = {
-    'en': 'models/udpipe/english-ud-1.2-160523.udpipe',
-}
-
-# TODO use the new models once UDPipe 1.1 is published and available on PyPI as ufal.udpipe
-V2_KNOWN_MODELS = {
     'grc': 'models/udpipe/2.0/ancient_greek-proiel-ud-2.0-conll17-170315.udpipe',
     'grc_proiel': 'models/udpipe/2.0/ancient_greek-ud-2.0-conll17-170315.udpipe',
     'ar': 'models/udpipe/2.0/arabic-ud-2.0-conll17-170315.udpipe',

From 05f63c56fd964bd371f292f189018f3fd98245f2 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 20 May 2017 12:19:09 +0200
Subject: [PATCH 0150/1374] use udeprel instead of deprel in ud.MarkBugs

---
 udapi/block/ud/markbugs.py | 45 +++++++++++++++++++-------------------
 1 file changed, 22 insertions(+), 23 deletions(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index ac94242b..def2580a 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -69,11 +69,11 @@ def log(self, node, short_msg, long_msg):
 
     # pylint: disable=too-many-branches, too-many-statements
     def process_node(self, node):
-        form, deprel, upos, feats = node.form, node.deprel, node.upos, node.feats
+        form, udeprel, upos, feats = node.form, node.udeprel, node.upos, node.feats
         parent = node.parent
 
         for dep in ('aux', 'fixed', 'goeswith', 'list'):
-            if deprel == dep and parent.deprel == dep:
+            if udeprel == dep and parent.udeprel == dep:
                 self.log(node, dep + '-chain', dep + ' dependencies should not form a chain.')
 
         # 'appos-chain' is more difficult to test because nested appositions are allowed.
@@ -86,24 +86,24 @@ def process_node(self, node):
         #         self.log(node, 'appos-chain', 'appos should not form a chain except when nested.')
 
         for dep in ('flat', 'fixed', 'conj', 'appos', 'goeswith', 'list'):
-            if deprel == dep and node.precedes(parent):
+            if udeprel == dep and node.precedes(parent):
                 self.log(node, dep + '-rightheaded',
                          dep + ' relations should be left-headed, not right.')
 
-        if deprel == 'cop' and upos not in ('AUX', 'PRON'):
+        if udeprel == 'cop' and upos not in ('AUX', 'PRON'):
             self.log(node, 'cop-upos', 'deprel=cop upos!=AUX|PRON (but %s)' % upos)
 
-        if deprel == 'mark' and upos == 'PRON':
+        if udeprel == 'mark' and upos == 'PRON':
             self.log(node, 'mark-upos', 'deprel=mark upos=PRON')
 
-        if deprel == 'det' and upos not in ('DET', 'PRON'):
+        if udeprel == 'det' and upos not in ('DET', 'PRON'):
             self.log(node, 'det-upos', 'deprel=det upos!=DET|PRON (but %s)' % upos)
 
-        if deprel == 'punct' and upos != 'PUNCT':
+        if udeprel == 'punct' and upos != 'PUNCT':
             self.log(node, 'punct-upos', 'deprel=punct upos!=PUNCT (but %s)' % upos)
 
         for i_upos, i_feat in REQUIRED_FEATURE_FOR_UPOS.items():
-            if upos == i_upos and not node.feats[i_feat]:
+            if upos == i_upos and not feats[i_feat]:
                 self.log(node, 'no-' + i_feat, 'upos=%s but %s feature is missing' % (upos, i_feat))
 
         if feats['VerbForm'] == 'Fin':
@@ -116,16 +116,16 @@ def process_node(self, node):
             self.log(node, 'degree-upos',
                      'Degree=%s upos!=ADJ|ADV (but %s)' % (feats['Degree'], upos))
 
-        subject_children = [n for n in node.children if 'subj' in n.deprel]
+        subject_children = [n for n in node.children if 'subj' in n.udeprel]
         if len(subject_children) > 1:
             self.log(node, 'multi-subj', 'More than one [nc]subj(:pass)? child')
 
-        object_children = [n for n in node.children if n.deprel in ('obj', 'ccomp')]
+        object_children = [n for n in node.children if n.udeprel in ('obj', 'ccomp')]
         if len(object_children) > 1:
             self.log(node, 'multi-obj', 'More than one obj|ccomp child')
 
         # In addition to http://universaldependencies.org/svalidation.html
-        if parent.deprel == 'punct':
+        if parent.udeprel == 'punct':
             self.log(node, 'punct-child', 'parent.deprel=punct')
 
         # See http://universaldependencies.org/u/overview/syntax.html#the-status-of-function-words
@@ -138,15 +138,15 @@ def process_node(self, node):
         #       It seems the documentation does not allow any other deprel than advmod,
         #       so there should be no false alarms. Some errors are not reported, i.e. the cases
         #       when advmod incorrectly depends on a function word ("right before midnight").
-        if parent.deprel in ('aux', 'cop', 'mark', 'clf', 'case'):
-            if deprel not in ('conj', 'cc', 'punct', 'fixed', 'goeswith', 'advmod'):
+        if parent.udeprel in ('aux', 'cop', 'mark', 'clf', 'case'):
+            if udeprel not in ('conj', 'cc', 'punct', 'fixed', 'goeswith', 'advmod'):
                 self.log(node, parent.deprel + '-child',
                          'parent.deprel=%s deprel!=conj|cc|punct|fixed|goeswith' % parent.deprel)
 
         # goeswith should be left-headed, but this is already checked, so let's skip right-headed.
-        if deprel == 'goeswith' and parent.precedes(node):
+        if udeprel == 'goeswith' and parent.precedes(node):
             span = node.root.descendants(add_self=1)[parent.ord:node.ord]
-            intruder = next((n for n in span[1:] if n.deprel != "goeswith"), None)
+            intruder = next((n for n in span[1:] if n.udeprel != "goeswith"), None)
             if intruder is not None:
                 self.log(intruder, 'goeswith-gap', "deprel!=goeswith but lies within goeswith span")
             else:
@@ -160,22 +160,21 @@ def process_node(self, node):
         if upos == 'PUNCT' and any(char.isalpha() for char in form):
             self.log(node, 'punct-alpha', "upos=PUNCT but form has alphabetical char(s): " + form)
 
-        if upos == 'PUNCT' and deprel not in ('punct', 'fixed', 'goeswith', 'root'):
+        if upos == 'PUNCT' and udeprel not in ('punct', 'fixed', 'goeswith', 'root'):
             self.log(node, 'punct-deprel', 'upos=PUNCT deprel!=punct|fixed|goeswith|root (but %s)'
-                     % deprel)
+                     % udeprel)
 
-        if upos == 'PUNCT':
-            if node.is_nonprojective():
-                self.log(node, 'punct-nonproj', 'upos=PUNCT and edge is non-projective')
-            if node.is_nonprojective_gap() and not node.parent.is_nonprojective_gap():
-                self.log(node, 'punct-nonproj-gap', 'upos=PUNCT and causing a non-projectivity')
+        if upos == 'PUNCT' and node.is_nonprojective():
+            self.log(node, 'punct-nonproj', 'upos=PUNCT and edge is non-projective')
+        if upos == 'PUNCT' and node.is_nonprojective_gap() and not parent.is_nonprojective_gap():
+            self.log(node, 'punct-nonproj-gap', 'upos=PUNCT and causing a non-projectivity')
 
         # http://universaldependencies.org/u/dep/cc.html says
         #   "cc is the relation between a conjunct and a preceding
         #   [coordinating conjunction](http://universaldependencies.org/u/pos/CCONJ)."
         # No other upos is allowed in the documentation, although e.g. PART is common in the data.
         # There are clear cases of adverbs in role of cc (e.g. "respektive" in Swedish and Czech).
-        if deprel == 'cc' and upos not in ('CCONJ', 'ADV'):
+        if udeprel == 'cc' and upos not in ('CCONJ', 'ADV'):
             self.log(node, 'cc-upos', "deprel=cc upos!=CCONJ (but %s): " % upos)
 
     def after_process_document(self, document):

From 482769459a2b45a1bac2d138b15dce14b581c9eb Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 20 May 2017 20:41:29 +0200
Subject: [PATCH 0151/1374] oops, LAS udeprel was actually LAS deprel

---
 udapi/block/eval/parsing.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/eval/parsing.py b/udapi/block/eval/parsing.py
index 3e1b7ff2..6923c1fb 100644
--- a/udapi/block/eval/parsing.py
+++ b/udapi/block/eval/parsing.py
@@ -37,4 +37,4 @@ def process_end(self):
         print('nodes = %d' % self.total)
         print('UAS           = %6.2f' % (100 * self.correct_uas / self.total))
         print('LAS (deprel)  = %6.2f' % (100 * self.correct_las / self.total))
-        print('LAS (udeprel) = %6.2f' % (100 * self.correct_las / self.total))
+        print('LAS (udeprel) = %6.2f' % (100 * self.correct_ulas / self.total))

From 9d7900a44d4da284cded8be46f4b1c1954a3bac4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 20 May 2017 20:47:15 +0200
Subject: [PATCH 0152/1374] add ufal.udpipe to dependencies and bump version

---
 requirements.txt |  1 +
 setup.py         | 10 +++++-----
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index a994db47..647361f7 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,2 +1,3 @@
 colorama
 termcolor
+ufal.udpipe
diff --git a/setup.py b/setup.py
index b9d0890b..1ec8e468 100644
--- a/setup.py
+++ b/setup.py
@@ -10,14 +10,14 @@
 
 setup(
     name='udapi-python',
-    version='0.1',
+    version='0.2',
     description='Python framework for processing Universal Dependencies data',
-    author='Vincent Kriz',
-    author_email='kriz@ufal.mff.cuni.cz',
+    author='Martin Popel',
+    author_email='popel@ufal.mff.cuni.cz',
     url='https://github.com/udapi/udapi-python',
     packages=find_packages(),
     scripts=['bin/udapy'],
     tests_require=['pytest'],
-    install_requires=['colorama', 'termcolor'],
-    python_requires='>=3.3'
+    install_requires=['colorama', 'termcolor', 'ufal.udpipe'],
+    python_requires='>=3.3',
 )

From fa879631f5f28d4226b141b1fa86a956e1a7f7c0 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 20 May 2017 22:19:49 +0200
Subject: [PATCH 0153/1374] install g++-4.8 on Travis before installing
 ufal.udpipe

---
 .travis.yml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/.travis.yml b/.travis.yml
index 7a8ded6c..d45259b8 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -3,6 +3,11 @@ python:
   - "3.3"
   - "3.4"
   - "3.5"
+before_install:
+  - sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
+  - sudo apt-get update -qq
+  - sudo apt-get install -qq gcc-4.8 g++-4.8
+  - CC=g++-4.8 pip install ufal.udpipe
 install:
   - python setup.py install
 script:

From dd033eba06935063322a06b0a9826dd37a35a5c4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 21 May 2017 03:27:54 +0200
Subject: [PATCH 0154/1374] download models automatically if missing

---
 udapi/core/resource.py | 20 ++++++++++++++++++++
 udapi/tool/udpipe.py   | 17 ++++-------------
 2 files changed, 24 insertions(+), 13 deletions(-)
 create mode 100644 udapi/core/resource.py

diff --git a/udapi/core/resource.py b/udapi/core/resource.py
new file mode 100644
index 00000000..9e5923f1
--- /dev/null
+++ b/udapi/core/resource.py
@@ -0,0 +1,20 @@
+"""Utilities for downloading models and ither resources."""
+import logging
+import urllib.request
+import os
+
+BASEURL = 'http://ufallab.ms.mff.cuni.cz/tectomt/share/data/'
+
+def require_file(path):
+    """Return absolute path to the file and download it if missing."""
+    if path.startswith('/') or path.startswith('.'):
+        if not os.path.isfile(path):
+            raise IOError(path + " does not exist")
+        return os.path.abspath(path)
+    udapi_data = os.environ.get('UDAPI_DATA', os.environ.get('HOME'))
+    full_path = udapi_data + '/' + path
+    if not os.path.isfile(full_path):
+        logging.info('Downloading %s to %s', BASEURL + path, full_path)
+        os.makedirs(os.path.dirname(full_path), exist_ok=True)
+        urllib.request.urlretrieve(BASEURL + path, full_path)
+    return full_path
diff --git a/udapi/tool/udpipe.py b/udapi/tool/udpipe.py
index f388a6f7..8fe024c7 100644
--- a/udapi/tool/udpipe.py
+++ b/udapi/tool/udpipe.py
@@ -1,18 +1,18 @@
-'''Wrapper for UDPipe (more pythonic than ufal.udpipe).'''
+"""Wrapper for UDPipe (more pythonic than ufal.udpipe)."""
 import io
-import os
 
 from ufal.udpipe import Model, Pipeline, ProcessingError, Sentence  # pylint: disable=no-name-in-module
+from udapi.core.resource import require_file
 from udapi.block.read.conllu import Conllu as ConlluReader
 
 
 class UDPipe:
-    '''Wrapper for UDPipe (more pythonic than ufal.udpipe).'''
+    """Wrapper for UDPipe (more pythonic than ufal.udpipe)."""
 
     def __init__(self, model):
         """Create the UDPipe tool object."""
         self.model = model
-        path = self.model_path()
+        path = require_file(model)
         self.tool = Model.load(path)
         if not self.tool:
             raise IOError("Cannot load model from file '%s'" % path)
@@ -20,15 +20,6 @@ def __init__(self, model):
         self.conllu_reader = ConlluReader()
         self.tokenizer = self.tool.newTokenizer(Model.DEFAULT)
 
-    def model_path(self):
-        """Return absolute path to the model file to be loaded."""
-        if self.model.startswith('/') or self.model.startswith('.'):
-            return self.model
-        elif os.environ.get('UDAPI_DATA'):
-            return os.environ['UDAPI_DATA'] + '/' + self.model
-        else:
-            return os.environ.get('HOME') + '/' + self.model
-
     def tag_parse_tree(self, root):
         """Tag (+lemmatize, fill FEATS) and parse a tree (already tokenized)."""
         pipeline = Pipeline(self.tool, 'horizontal', Pipeline.DEFAULT, Pipeline.DEFAULT, 'conllu')

From c45418fd31671dd5937d0e966432e11ab4dca196 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 21 May 2017 22:14:10 +0200
Subject: [PATCH 0155/1374] note on C++11

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index 7183cd6c..4621c918 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,7 @@ Python framework for processing Universal Dependencies data
 
 ## Requirements
 - You need Python 3.3 or higher.
+- If the [ufal.udpipe](https://pypi.python.org/pypi/ufal.udpipe/) parser is needed, make sure you have a C++11 compiler (e.g. [g++ 4.7 or newer](.travis.yml#L9)).
 
 ## Install Udapi for developers
 Let's clone the git repo to `~/udapi-python/`, install dependencies

From 7f8edea5afa80e02291bc694dc4e24333cfe2d6d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 23 May 2017 08:25:29 +0200
Subject: [PATCH 0156/1374] ud.MarkBugs reports if there are too many different
 copula lemmas

---
 udapi/block/ud/markbugs.py | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index def2580a..1969278a 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -32,7 +32,7 @@
 class MarkBugs(Block):
     """Block for checking suspicious/wrong constructions in UD v2."""
 
-    def __init__(self, save_stats=True, tests=None, skip=None, **kwargs):
+    def __init__(self, save_stats=True, tests=None, skip=None, max_cop_lemmas=2, **kwargs):
         """Create the MarkBugs block object.
 
         Args:
@@ -46,12 +46,17 @@ def __init__(self, save_stats=True, tests=None, skip=None, **kwargs):
             You can use e.g. `skip=no-(VerbForm|NumType|PronType)`.
             This has higher priority than the `tests` regex.
             Default = None (or empty string) which means no skipping.
+        max_cop_lemmas: how many different lemmas are allowed to have deprel=cop.
+            Default = 2, so all except for the two most frequent lemmas are reported as bugs.
         """
         super().__init__(**kwargs)
         self.save_stats = save_stats
         self.stats = collections.Counter()
         self.tests_re = re.compile(tests) if (tests is not None and tests != '') else None
         self.skip_re = re.compile(skip) if (skip is not None and skip != '') else None
+        self.max_cop_lemmas = max_cop_lemmas
+        self.cop_count = collections.Counter()
+        self.cop_nodes = collections.defaultdict(list)
 
     def log(self, node, short_msg, long_msg):
         """Log node.address() + long_msg and add ToDo=short_msg to node.misc."""
@@ -177,7 +182,18 @@ def process_node(self, node):
         if udeprel == 'cc' and upos not in ('CCONJ', 'ADV'):
             self.log(node, 'cc-upos', "deprel=cc upos!=CCONJ (but %s): " % upos)
 
+        if udeprel == 'cop':
+            lemma = node.lemma if node.lemma != '_' else form
+            self.cop_nodes[lemma].append(node)
+            self.cop_count[lemma] += 1
+
     def after_process_document(self, document):
+        for lemma, _count in self.cop_count.most_common()[self.max_cop_lemmas:]:
+            for node in self.cop_nodes[lemma]:
+                self.log(node, 'cop-many-lemmas', 'deprel=cop but lemma=%s not in top-%d'
+                         % (lemma, self.max_cop_lemmas))
+        self.cop_count.clear()
+        self.cop_nodes.clear()
         total = 0
         message = 'ud.MarkBugs Error Overview:'
         for bug, count in sorted(self.stats.items(), key=lambda pair: (pair[1], pair[0])):

From 726625d2c8d2c896d69f78a3756dec3994f5a786 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 25 May 2017 17:27:36 +0200
Subject: [PATCH 0157/1374] util.Split for splitting documents into several
 parts

---
 udapi/block/read/addsentences.py |  2 +-
 udapi/block/util/split.py        | 39 ++++++++++++++++++++++++++++++++
 udapi/core/bundle.py             | 12 +++++++---
 3 files changed, 49 insertions(+), 4 deletions(-)
 create mode 100644 udapi/block/util/split.py

diff --git a/udapi/block/read/addsentences.py b/udapi/block/read/addsentences.py
index 5dc2d7a9..f676fbe7 100644
--- a/udapi/block/read/addsentences.py
+++ b/udapi/block/read/addsentences.py
@@ -2,7 +2,7 @@
 from udapi.core.basereader import BaseReader
 
 # pylint: disable=abstract-method
-# read_tree() does not need to be installed here
+# read_tree() does not need to be implemented here
 
 
 class AddSentences(BaseReader):
diff --git a/udapi/block/util/split.py b/udapi/block/util/split.py
new file mode 100644
index 00000000..6eb2f650
--- /dev/null
+++ b/udapi/block/util/split.py
@@ -0,0 +1,39 @@
+"""util.Split is a special block for splitting documents."""
+import math
+from udapi.core.basereader import BaseReader
+
+# pylint: disable=abstract-method
+# read_tree() does not need to be installed here
+
+
+class Split(BaseReader):
+    """Split Udapi document (with sentence-aligned trees in bundles) into several parts."""
+
+    def __init__(self, parts=None, bundles_per_doc=None, **kwargs):
+        """Args:
+        parts: into how many parts should the document be split
+        bundles_per_doc: number of bundles per the newly created part
+        """
+        super().__init__(**kwargs)
+        if parts is None and bundles_per_doc is None:
+            raise ValueError('parts or bundles_per_doc must be specified')
+        if parts is not None and bundles_per_doc is not None:
+            raise ValueError('Cannot specify both parts and bundles_per_doc')
+        self.parts = parts
+        self.bundles_per_doc = bundles_per_doc
+        self.buffer = None
+
+    @staticmethod
+    def is_multizone_reader():
+        return False
+
+    def process_document(self, document):
+        if not self.buffer:
+            self.buffer = document.bundles
+            document.bundles = []
+            if self.bundles_per_doc is None:
+                self.bundles_per_doc = math.ceil(len(self.buffer) / self.parts)
+        self.buffer.extend(document.bundles)
+        document.bundles = self.buffer[:self.bundles_per_doc]
+        self.buffer = self.buffer[self.bundles_per_doc:]
+        self.finished = not self.buffer
diff --git a/udapi/core/bundle.py b/udapi/core/bundle.py
index ad243b72..516544cf 100644
--- a/udapi/core/bundle.py
+++ b/udapi/core/bundle.py
@@ -43,12 +43,11 @@ def __iter__(self):
         return iter(self.trees)
 
     def document(self):
-        """returns the document in which the bundle is contained"""
+        """Returns the document in which the bundle is contained."""
         return self._document
 
     def get_tree(self, zone=''):
-        """returns the tree root whose zone is equal to zone"""
-
+        """Returns the tree root whose zone is equal to zone."""
         trees = [tree for tree in self.trees if tree.zone == zone]
         if len(trees) == 1:
             return trees[0]
@@ -58,6 +57,13 @@ def get_tree(self, zone=''):
             raise Exception("More than one tree with zone=" +
                             zone + " in the bundle")
 
+    def has_tree(self, zone=''):
+        """Does this bundle contain a tree with a given zone?"""
+        for tree in self.trees:
+            if tree.zone == zone:
+                return True
+        return False
+
     def create_tree(self, zone=None):
         """Return the root of a newly added tree with a given zone."""
         root = Root()

From 1fcfeef7f95c3ff581348493d04360d5e5213561 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 29 May 2017 03:08:53 +0200
Subject: [PATCH 0158/1374] (partial) support for moving nodes between trees
 via parent setter

---
 udapi/core/bundle.py |  3 +--
 udapi/core/node.py   | 16 +++++++++++++---
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/udapi/core/bundle.py b/udapi/core/bundle.py
index 516544cf..ffffa565 100644
--- a/udapi/core/bundle.py
+++ b/udapi/core/bundle.py
@@ -92,8 +92,7 @@ def add_tree(self, root):
 
     def remove(self):
         """Remove a bundle from the document."""
-        self.document.bundles = [
-            bundle for bundle in self.document.bundles if not bundle == self]
+        self._document.bundles = [bundle for bundle in self._document.bundles if bundle != self]
 
     def address(self):
         """Return bundle_id or '?' if missing."""
diff --git a/udapi/core/node.py b/udapi/core/node.py
index e9fbe1a5..1e056c0a 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -270,13 +270,23 @@ def parent(self, new_parent):
             climbing_node = climbing_node.parent
 
         # Remove the current Node from the children of the old parent.
-        if self.parent:
-            self.parent._children = [node for node in self.parent.children if node != self]
+        # In case of moving a subtree from one tree to another, update also the ordering.
+        if self._parent:
+            self._parent._children = [node for node in self.parent.children if node != self]
+            old_root, new_root = self._parent.root, climbing_node
+            if old_root != new_root:
+                old_root._update_ordering()
+                moving_nodes = self.descendants(add_self=True)
+                new_ord = new_root._descendants[-1].ord + 1 if new_root._descendants else 1
+                for moving_node in moving_nodes:
+                    moving_node.ord = new_ord
+                    new_ord += 1
+                new_root._descendants.extend(moving_nodes)
 
         # Set the new parent.
         self._parent = new_parent
 
-        # Append the current node the the new parent children.
+        # Append the current node to the new parent children.
         new_parent._children = sorted(new_parent.children + [self], key=lambda child: child.ord)
 
     @property

From e5852d489567c77bc595470d9e8a64afb4e9fdc5 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 29 May 2017 20:48:43 +0200
Subject: [PATCH 0159/1374] first draft of sentence alignment for CoNLL2017
 evaluation

---
 udapi/block/util/resegmentgold.py | 98 +++++++++++++++++++++++++++++++
 udapi/core/root.py                | 35 +++++++++++
 2 files changed, 133 insertions(+)
 create mode 100644 udapi/block/util/resegmentgold.py

diff --git a/udapi/block/util/resegmentgold.py b/udapi/block/util/resegmentgold.py
new file mode 100644
index 00000000..6aeafc44
--- /dev/null
+++ b/udapi/block/util/resegmentgold.py
@@ -0,0 +1,98 @@
+"""util.ResegmentGold is a block for sentence alignment and re-segmentation of two zones."""
+from udapi.core.block import Block
+from udapi.core.mwt import MWT
+from udapi.core.root import Root
+
+
+class ResegmentGold(Block):
+    """Sentence-align two zones (gold and pred) and resegment the pred zone.
+
+    The two zones must contain the same sequence of characters.
+    """
+
+    def __init__(self, gold_zone, **kwargs):
+        """Args:
+        gold_zone: which zone contains the gold segmentation
+        """
+        super().__init__(**kwargs)
+        self.gold_zone = gold_zone
+
+    def process_document(self, document):
+        pred_trees = []
+        for bundle in reversed(document.bundles):
+            zones = [t.zone for t in bundle.trees]
+            if len(zones) > 2 or (len(zones) == 2 and self.gold_zone not in zones):
+                raise ValueError('Expected two zones, but found: ' + str(zones))
+            for tree in bundle.trees:
+                if tree.zone != self.gold_zone:
+                    pred_trees.append(tree)
+                    tree.remove()
+        for bundle in document.bundles:
+            if not bundle.trees:
+                bundle.remove()
+        if not document.bundles:
+            raise ValueError('No bundles with gold_zone=' + self.gold_zone)
+
+        for bundle in document.bundles:
+            g_tree = bundle.trees[0]
+            p_tree = pred_trees.pop()
+            g_chars = ''.join(t.form for t in g_tree.token_descendants).replace(' ', '')
+            p_chars = ''.join(t.form for t in p_tree.token_descendants).replace(' ', '')
+            if g_chars == p_chars:
+                bundle.add_tree(p_tree)
+                continue
+            while len(g_chars) > len(p_chars):
+                if not pred_trees:
+                    _print(document)
+                    print(g_chars)
+                    print(p_chars)
+                    raise ValueError('no pred_trees')
+                new_p_tree = pred_trees.pop()
+                p_chars += ''.join(t.form for t in new_p_tree.token_descendants).replace(' ', '')
+                p_tree.steal_nodes(new_p_tree.descendants)
+            if not p_chars.startswith(g_chars):
+                g_tree.print_subtree()
+                print('---------------------- p_chars do not start with g_chars')
+                p_tree.print_subtree()
+                raise ValueError('p_chars do not start with g_chars')
+                # index = 0
+                # while g_chars[index] == p_chars[index]:
+                #     index += 1
+                # raise ValueError(
+                #     "The concatenation of tokens in the gold and pred trees differ!\n" +
+                #     "First 20 differing characters in gold: '%s' and pred: '%s'"
+                #     % (g_chars[index:index + 20], p_chars[index:index + 20]))
+            if g_chars == p_chars:
+                bundle.add_tree(p_tree)
+                continue
+
+            # p_tree contains more nodes than it should
+            p_chars = ''
+            tokens = p_tree.token_descendants
+            old_words = []
+            for index, token in enumerate(tokens):
+                p_chars += token.form.replace(' ', '')
+                if len(p_chars) > len(g_chars):
+                    # TODO
+                    g_tree.print_subtree()
+                    print('----------------------')
+                    p_tree.print_subtree()
+                    raise ValueError('Cannot solve token over sentence boundary')
+                if len(p_chars) == len(g_chars):
+                    next_p_tree = Root(sent_id=p_tree.bundle.bundle_id + '-split2/' + p_tree.zone)
+                    words = [t.words if isinstance(t, MWT) else t for t in tokens[index + 1:]]
+                    next_p_tree.steal_nodes(words)
+                    pred_trees.append(next_p_tree)
+                    bundle.add_tree(p_tree)
+                    break
+                else:
+                    if isinstance(token, MWT):
+                        old_words.extend(token.words)
+                    else:
+                        old_words.append(token)
+
+
+def _print(doc):
+    for bun in doc.bundles:
+        for tre in bun.trees:
+            tre.print_subtree()
diff --git a/udapi/core/root.py b/udapi/core/root.py
index 1d609258..5f3110f6 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -233,3 +233,38 @@ def token_descendants(self):
             else:
                 result.append(node)
         return result
+
+    def steal_nodes(self, nodes):
+        """Move nodes from another tree to this tree (append)."""
+        old_root = nodes[0].root
+        for node in nodes[1:]:
+            if node.root != old_root:
+                raise ValueError("steal_nodes(nodes) was called with nodes from several trees")
+        nodes = sorted(nodes, key=lambda n: n.ord)
+        whole_tree = nodes == old_root.descendants
+        new_ord = len(self._descendants)
+        # pylint: disable=protected-access
+        for node in nodes:
+            new_ord += 1
+            node.ord = new_ord
+            if not whole_tree:
+                for child in [n for n in node.children if n not in nodes]:
+                    child.parent = old_root
+            if node.parent == old_root or (not whole_tree and node.parent not in nodes):
+                node.parent._children = [n for n in node.parent._children if n != node]
+                node._parent = self
+                self._children.append(node)
+        if whole_tree:
+            old_root._descendants = []
+            self._mwts += old_root.multiword_tokens
+            old_root.multiword_tokens = []
+        else:
+            old_root._descendants = [n for n in old_root._descendants if n not in nodes]
+            mwt = node.multiword_token
+            for node in nodes:
+                if mwt:
+                    words = [w for w in mwt.words if w in nodes]
+                    mwt.remove()
+                    self.create_multiword_token(words=words, form=mwt.form, misc=mwt.misc)
+        self._descendants += nodes
+        # pylint: enable=protected-access

From 78b2c951ffc46ba03150337a16de91f92aab8a98 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 30 May 2017 19:40:01 +0200
Subject: [PATCH 0160/1374] sentence alignment for CoNLL2017 evaluation

---
 udapi/block/util/resegmentgold.py | 85 +++++++++++++++----------------
 udapi/core/root.py                |  4 +-
 2 files changed, 43 insertions(+), 46 deletions(-)

diff --git a/udapi/block/util/resegmentgold.py b/udapi/block/util/resegmentgold.py
index 6aeafc44..ea5dbb76 100644
--- a/udapi/block/util/resegmentgold.py
+++ b/udapi/block/util/resegmentgold.py
@@ -10,7 +10,7 @@ class ResegmentGold(Block):
     The two zones must contain the same sequence of characters.
     """
 
-    def __init__(self, gold_zone, **kwargs):
+    def __init__(self, gold_zone='gold', **kwargs):
         """Args:
         gold_zone: which zone contains the gold segmentation
         """
@@ -18,22 +18,9 @@ def __init__(self, gold_zone, **kwargs):
         self.gold_zone = gold_zone
 
     def process_document(self, document):
-        pred_trees = []
-        for bundle in reversed(document.bundles):
-            zones = [t.zone for t in bundle.trees]
-            if len(zones) > 2 or (len(zones) == 2 and self.gold_zone not in zones):
-                raise ValueError('Expected two zones, but found: ' + str(zones))
-            for tree in bundle.trees:
-                if tree.zone != self.gold_zone:
-                    pred_trees.append(tree)
-                    tree.remove()
-        for bundle in document.bundles:
-            if not bundle.trees:
-                bundle.remove()
-        if not document.bundles:
-            raise ValueError('No bundles with gold_zone=' + self.gold_zone)
+        pred_trees = self.extract_pred_trees(document)
 
-        for bundle in document.bundles:
+        for bundle_no, bundle in enumerate(document.bundles):
             g_tree = bundle.trees[0]
             p_tree = pred_trees.pop()
             g_chars = ''.join(t.form for t in g_tree.token_descendants).replace(' ', '')
@@ -41,35 +28,24 @@ def process_document(self, document):
             if g_chars == p_chars:
                 bundle.add_tree(p_tree)
                 continue
-            while len(g_chars) > len(p_chars):
+
+            # Make sure that p_tree contains enough nodes.
+            while len(p_chars) < len(g_chars):
                 if not pred_trees:
-                    _print(document)
-                    print(g_chars)
-                    print(p_chars)
-                    raise ValueError('no pred_trees')
+                    raise ValueError('no pred_trees:\n%s\n%s' % (p_chars, g_chars))
                 new_p_tree = pred_trees.pop()
                 p_chars += ''.join(t.form for t in new_p_tree.token_descendants).replace(' ', '')
                 p_tree.steal_nodes(new_p_tree.descendants)
+            self.choose_root(p_tree, g_tree)
             if not p_chars.startswith(g_chars):
-                g_tree.print_subtree()
-                print('---------------------- p_chars do not start with g_chars')
-                p_tree.print_subtree()
-                raise ValueError('p_chars do not start with g_chars')
-                # index = 0
-                # while g_chars[index] == p_chars[index]:
-                #     index += 1
-                # raise ValueError(
-                #     "The concatenation of tokens in the gold and pred trees differ!\n" +
-                #     "First 20 differing characters in gold: '%s' and pred: '%s'"
-                #     % (g_chars[index:index + 20], p_chars[index:index + 20]))
+                raise ValueError('p_chars do not start with g_chars:\n%s\n%s' % (p_chars, g_chars))
             if g_chars == p_chars:
                 bundle.add_tree(p_tree)
                 continue
 
-            # p_tree contains more nodes than it should
+            # Now p_tree contains more nodes than it should.
             p_chars = ''
             tokens = p_tree.token_descendants
-            old_words = []
             for index, token in enumerate(tokens):
                 p_chars += token.form.replace(' ', '')
                 if len(p_chars) > len(g_chars):
@@ -79,20 +55,41 @@ def process_document(self, document):
                     p_tree.print_subtree()
                     raise ValueError('Cannot solve token over sentence boundary')
                 if len(p_chars) == len(g_chars):
-                    next_p_tree = Root(sent_id=p_tree.bundle.bundle_id + '-split2/' + p_tree.zone)
+                    next_p_tree = Root(zone=p_tree.zone)
                     words = [t.words if isinstance(t, MWT) else t for t in tokens[index + 1:]]
                     next_p_tree.steal_nodes(words)
+                    self.choose_root(p_tree, g_tree)
+                    self.choose_root(next_p_tree, document.bundles[bundle_no + 1].trees[0])
                     pred_trees.append(next_p_tree)
                     bundle.add_tree(p_tree)
                     break
-                else:
-                    if isinstance(token, MWT):
-                        old_words.extend(token.words)
-                    else:
-                        old_words.append(token)
 
+    def extract_pred_trees(self, document):
+        """Delete all trees with zone!=gold_zone from the document and return them."""
+        pred_trees = []
+        for bundle in reversed(document.bundles):
+            zones = [t.zone for t in bundle.trees]
+            if len(zones) > 2 or (len(zones) == 2 and self.gold_zone not in zones):
+                raise ValueError('Expected two zones including gold_zone=%s, but found: %s'
+                                 % (self.gold_zone, zones))
+            for tree in bundle.trees:
+                if tree.zone != self.gold_zone:
+                    pred_trees.append(tree)
+                    tree.remove()
+        for bundle in document.bundles:
+            if not bundle.trees:
+                bundle.remove()
+        if not document.bundles:
+            raise ValueError('No bundles with gold_zone=' + self.gold_zone)
+        return pred_trees
 
-def _print(doc):
-    for bun in doc.bundles:
-        for tre in bun.trees:
-            tre.print_subtree()
+    @staticmethod
+    def choose_root(p_tree, g_tree):
+        """Prevent multiple roots, which are forbidden in the evaluation script."""
+        p_subroots = p_tree.children
+        if len(p_subroots) > 1:
+            g_subroot_form = g_tree.children[0]
+            p_subroot = next((n for n in p_subroots if n.form == g_subroot_form), p_subroots[0])
+            for false_subroot in (n for n in p_subroots if n != p_subroot):
+                false_subroot.parent = p_subroot
+                false_subroot.deprel = 'dep:wrong-' + false_subroot.deprel
diff --git a/udapi/core/root.py b/udapi/core/root.py
index 5f3110f6..c9dc0666 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -15,7 +15,7 @@ class Root(Node):
                  'empty_nodes', 'text', 'comment', 'newpar', 'newdoc']
 
     # pylint: disable=too-many-arguments
-    def __init__(self, sent_id=None, zone=None, comment='', text=None, newpar=None, newdoc=None):
+    def __init__(self, zone=None, comment='', text=None, newpar=None, newdoc=None):
         """Create new root node."""
         # Call constructor of the parent object.
         super().__init__()
@@ -31,7 +31,7 @@ def __init__(self, sent_id=None, zone=None, comment='', text=None, newpar=None,
         self.newpar = newpar
         self.newdoc = newdoc
 
-        self._sent_id = sent_id
+        self._sent_id = None
         self._zone = zone
         self._bundle = None
         self._descendants = []

From fcfe01217db58bb1089a501b4b157c33b890cdf1 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 31 May 2017 14:09:54 +0200
Subject: [PATCH 0161/1374] bugfix: oops, Python does not flatten lists like
 Perl

---
 udapi/block/util/resegmentgold.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/udapi/block/util/resegmentgold.py b/udapi/block/util/resegmentgold.py
index ea5dbb76..e8d377cc 100644
--- a/udapi/block/util/resegmentgold.py
+++ b/udapi/block/util/resegmentgold.py
@@ -18,6 +18,8 @@ def __init__(self, gold_zone='gold', **kwargs):
         self.gold_zone = gold_zone
 
     def process_document(self, document):
+        if not document.bundles:
+            return
         pred_trees = self.extract_pred_trees(document)
 
         for bundle_no, bundle in enumerate(document.bundles):
@@ -56,7 +58,12 @@ def process_document(self, document):
                     raise ValueError('Cannot solve token over sentence boundary')
                 if len(p_chars) == len(g_chars):
                     next_p_tree = Root(zone=p_tree.zone)
-                    words = [t.words if isinstance(t, MWT) else t for t in tokens[index + 1:]]
+                    words = []
+                    for token in tokens[index + 1:]:
+                        if isinstance(token, MWT):
+                            words.extend(token.words)
+                        else:
+                            words.append(token)
                     next_p_tree.steal_nodes(words)
                     self.choose_root(p_tree, g_tree)
                     self.choose_root(next_p_tree, document.bundles[bundle_no + 1].trees[0])

From 9b2c16d1f0e2d226d0977e08193f8546fd5bdf79 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 31 May 2017 15:07:49 +0200
Subject: [PATCH 0162/1374] solve Pred token crossing gold sentences

---
 udapi/block/util/resegmentgold.py | 23 +++++++++++++++++------
 1 file changed, 17 insertions(+), 6 deletions(-)

diff --git a/udapi/block/util/resegmentgold.py b/udapi/block/util/resegmentgold.py
index e8d377cc..6ab119a4 100644
--- a/udapi/block/util/resegmentgold.py
+++ b/udapi/block/util/resegmentgold.py
@@ -1,4 +1,5 @@
 """util.ResegmentGold is a block for sentence alignment and re-segmentation of two zones."""
+import logging
 from udapi.core.block import Block
 from udapi.core.mwt import MWT
 from udapi.core.root import Root
@@ -51,11 +52,21 @@ def process_document(self, document):
             for index, token in enumerate(tokens):
                 p_chars += token.form.replace(' ', '')
                 if len(p_chars) > len(g_chars):
-                    # TODO
-                    g_tree.print_subtree()
-                    print('----------------------')
-                    p_tree.print_subtree()
-                    raise ValueError('Cannot solve token over sentence boundary')
+                    logging.warning('Pred token crossing gold sentences: %s', g_tree.sent_id)
+                    # E.g. gold cs ln95048-151-p2s8 contains SpaceAfter=No on the last word
+                    # of the sentence, resulting in "uklidnila.Komentář" in the raw text.
+                    # It is not obvious how to fix this "properly", i.e. without increasing
+                    # or decreasing the resulting LAS. The current solution is quite hacky.
+                    if index + 1 == len(tokens):
+                        next_p_tree = Root(zone=p_tree.zone)
+                        pred_trees.append(next_p_tree)
+                        next_p_tree.create_child(deprel='wrong', form=p_chars[len(g_chars):])
+                        bundle.add_tree(p_tree)
+                        break
+                    else:
+                        next_tok = tokens[index + 1]
+                        next_tok.form = p_chars[len(g_chars):] + next_tok.form
+                        p_chars = g_chars
                 if len(p_chars) == len(g_chars):
                     next_p_tree = Root(zone=p_tree.zone)
                     words = []
@@ -99,4 +110,4 @@ def choose_root(p_tree, g_tree):
             p_subroot = next((n for n in p_subroots if n.form == g_subroot_form), p_subroots[0])
             for false_subroot in (n for n in p_subroots if n != p_subroot):
                 false_subroot.parent = p_subroot
-                false_subroot.deprel = 'dep:wrong-' + false_subroot.deprel
+                false_subroot.deprel = 'wrong-' + false_subroot.deprel

From ebf3203ce96d648ebd11af9f1f0e3536082d4f0b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 31 May 2017 15:08:21 +0200
Subject: [PATCH 0163/1374] eval.Conll17 for evaluating LAS,UAS,etc

---
 udapi/block/eval/conll17.py | 104 ++++++++++++++++++++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 udapi/block/eval/conll17.py

diff --git a/udapi/block/eval/conll17.py b/udapi/block/eval/conll17.py
new file mode 100644
index 00000000..42b7bb33
--- /dev/null
+++ b/udapi/block/eval/conll17.py
@@ -0,0 +1,104 @@
+"""Block eval.Conll17 for evaluating LAS,UAS,etc - gold and pred may have different tokenization.
+
+This is a reimplementation of the CoNLL2017 shared task official evaluation script,
+http://universaldependencies.org/conll17/evaluation.html
+
+The gold trees and predicted (system-output) trees need to be sentence-aligned
+e.g. using `util.ResegmentGold`.
+"""
+import argparse
+import difflib
+from collections import Counter
+from udapi.core.basewriter import BaseWriter
+
+CLAS_IGNORE = {'aux', 'case', 'cc', 'clf', 'cop', 'det', 'mark', 'punct'}
+
+class Conll17(BaseWriter):
+    """Evaluate labeled and unlabeled attachment score (LAS and UAS)."""
+
+    def __init__(self, gold_zone='gold', print_raw=False, print_results=True, **kwargs):
+        """Args:
+        gold_zone - Which zone contains the gold-standard trees (the other zone contains "pred")?
+        print_raw - Print raw counts (pred, gold, Words, LAS) for each sentence.
+            This is useful for bootstrap resampling post-processing to get confidence intervals.
+        print_results - Print a table with overall results after all document are processed.
+        """
+        super().__init__(**kwargs)
+        self.gold_zone = gold_zone
+        self.total_count = Counter()
+        self.print_raw = print_raw
+        self.print_results = print_results
+
+    def process_tree(self, tree):
+        gold_tree = tree.bundle.get_tree(self.gold_zone)
+        if tree == gold_tree:
+            return
+        pred_nodes = tree.descendants
+        gold_nodes = gold_tree.descendants
+        pred_forms = [n.form.lower() for n in pred_nodes]
+        gold_forms = [n.form.lower() for n in gold_nodes]
+        matcher = difflib.SequenceMatcher(None, pred_forms, gold_forms, autojunk=False)
+        aligned = []
+        for diff in matcher.get_opcodes():
+            edit, pred_lo, pred_hi, gold_lo, gold_hi = diff
+            if edit == 'equal':
+                aligned.extend(zip(pred_nodes[pred_lo:pred_hi], gold_nodes[gold_lo:gold_hi]))
+        align_map = {tree: gold_tree}
+        for p_node, g_node in aligned:
+            align_map[p_node] = g_node
+
+        count = Counter()
+        count['pred'] = len(pred_nodes)
+        count['gold'] = len(gold_nodes)
+        count['Words'] = len(aligned)
+        count['pred_clas'] = len([n for n in pred_nodes if n.udeprel not in CLAS_IGNORE])
+        count['gold_clas'] = len([n for n in gold_nodes if n.udeprel not in CLAS_IGNORE])
+        count['alig_clas'] = len([n for _, n in aligned if n.udeprel not in CLAS_IGNORE])
+
+        for p_node, g_node in aligned:
+            for attr in ('UPOS', 'XPOS', 'Feats', 'Lemma'):
+                if p_node.get_attrs([attr.lower()]) == g_node.get_attrs([attr.lower()]):
+                    count[attr] += 1
+            if align_map.get(p_node.parent) == g_node.parent:
+                count['UAS'] += 1
+                if p_node.udeprel == g_node.udeprel:
+                    count['LAS'] += 1
+                    if g_node.udeprel not in CLAS_IGNORE:
+                        count['CLAS'] += 1
+        self.total_count.update(count)
+
+        if self.print_raw:
+            scores = [str(count[s]) for s in ('pred', 'gold', 'Words', 'LAS')]
+            print(' '.join(scores))
+
+    def process_end(self):
+        if not self.print_results:
+            return
+
+        # Redirect the default filehandle to the file specified by self.files
+        self.before_process_document(None)
+
+        metrics = ('Words', 'UPOS', 'XPOS', 'Feats', 'Lemma', 'UAS', 'LAS', 'CLAS')
+        print("Metric     | Precision |    Recall |  F1 Score | AligndAcc")
+        print("-----------+-----------+-----------+-----------+-----------")
+        pred, gold = self.total_count['pred'], self.total_count['gold']
+        alig = self.total_count['Words']
+        for metric in metrics:
+            if metric == 'CLAS':
+                pred, gold = self.total_count['pred_clas'], self.total_count['gold_clas']
+                alig = self.total_count['alig_clas']
+            correct = self.total_count[metric]
+            precision = correct / pred if pred else 0
+            recall = correct / gold if gold else 0
+            alignacc = correct / alig if alig else 0
+            fscore = 2 * correct / (pred + gold) if pred + gold else 0
+            print("{:11}|{:10.2f} |{:10.2f} |{:10.2f} |{:10.2f}".format(
+                metric, 100 * precision, 100 * recall, 100 * fscore, 100 * alignacc))
+
+def main():
+    parser = argparse.ArgumentParser()
+    # TODO post-process bootstrap
+    args = parser.parse_args()
+
+if __name__ == "__main__":
+    main()

From abf1993f73e10997a9c8910ca69c96ba9362e46a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 1 Jun 2017 10:43:42 +0200
Subject: [PATCH 0164/1374] add reader's parameter ignore_sent_id

It allows loading two conllu files (each with sent_id) into two zones
and silencing the warning "Mismatch in bundle IDs:".
---
 udapi/core/basereader.py | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index b4913df6..1f732568 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -13,7 +13,7 @@ class BaseReader(Block):
 
     # pylint: disable=too-many-arguments
     def __init__(self, files='-', zone='keep', bundles_per_doc=0, encoding='utf-8',
-                 sent_id_filter=None, split_docs=False, **kwargs):
+                 sent_id_filter=None, split_docs=False, ignore_sent_id=False, **kwargs):
         super().__init__(**kwargs)
         self.files = Files(filenames=files)
         self.zone = zone
@@ -26,6 +26,7 @@ def __init__(self, files='-', zone='keep', bundles_per_doc=0, encoding='utf-8',
             self.sent_id_filter = re.compile(str(sent_id_filter))
             logging.debug('Using sent_id_filter=%s', sent_id_filter)
         self.split_docs = split_docs
+        self.ignore_sent_id = ignore_sent_id
 
     @staticmethod
     def is_multizone_reader():
@@ -121,9 +122,10 @@ def process_document(self, document):
             add_to_the_last_bundle = 0
             trees_loaded += 1
 
-            tree_id = root.sent_id
-            if tree_id is not None:
-                parts = tree_id.split('/', 1)
+            if self.ignore_sent_id:
+                root.sent_id = None
+            if root.sent_id is not None:
+                parts = root.sent_id.split('/', 1)
                 bundle_id = parts[0]
                 if len(parts) == 2:
                     root.zone = parts[1]

From a84a8595eea0825d9e7f737e0bd5d08d3903be66 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 1 Jun 2017 15:47:56 +0200
Subject: [PATCH 0165/1374] let root.steal_nodes() be the only official way for
 moving nodes across trees

So `node.parent = another_tree_node` is now forbidden
and it cannot be used even internally within `steal_nodes()`.
The previous implementation was buggy anyway.
---
 udapi/core/node.py | 13 ++++---------
 udapi/core/root.py |  4 +++-
 2 files changed, 7 insertions(+), 10 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 1e056c0a..8e42e991 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -270,19 +270,14 @@ def parent(self, new_parent):
             climbing_node = climbing_node.parent
 
         # Remove the current Node from the children of the old parent.
-        # In case of moving a subtree from one tree to another, update also the ordering.
+        # Forbid moving nodes from one tree to another using parent setter.
         if self._parent:
             self._parent._children = [node for node in self.parent.children if node != self]
+            # TODO: .root is currently computed, so it is quite slow
             old_root, new_root = self._parent.root, climbing_node
             if old_root != new_root:
-                old_root._update_ordering()
-                moving_nodes = self.descendants(add_self=True)
-                new_ord = new_root._descendants[-1].ord + 1 if new_root._descendants else 1
-                for moving_node in moving_nodes:
-                    moving_node.ord = new_ord
-                    new_ord += 1
-                new_root._descendants.extend(moving_nodes)
-
+                raise ValueError('Cannot move nodes between trees with parent setter, '
+                                 'use new_root.steal_nodes(nodes_to_be_moved) instead')
         # Set the new parent.
         self._parent = new_parent
 
diff --git a/udapi/core/root.py b/udapi/core/root.py
index c9dc0666..56105872 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -249,7 +249,9 @@ def steal_nodes(self, nodes):
             node.ord = new_ord
             if not whole_tree:
                 for child in [n for n in node.children if n not in nodes]:
-                    child.parent = old_root
+                    child._parent = old_root
+                    old_root._children = sorted(old_root.children + [child], key=lambda n: n.ord)
+                node._children = [n for n in node.children if n in nodes]
             if node.parent == old_root or (not whole_tree and node.parent not in nodes):
                 node.parent._children = [n for n in node.parent._children if n != node]
                 node._parent = self

From 723d6a3555bfc8d722978f301c428063ac6f6a8b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 1 Jun 2017 15:51:21 +0200
Subject: [PATCH 0166/1374] better bugreport with sent_id

---
 udapi/block/util/resegmentgold.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/util/resegmentgold.py b/udapi/block/util/resegmentgold.py
index 6ab119a4..39ebe6e9 100644
--- a/udapi/block/util/resegmentgold.py
+++ b/udapi/block/util/resegmentgold.py
@@ -41,7 +41,8 @@ def process_document(self, document):
                 p_tree.steal_nodes(new_p_tree.descendants)
             self.choose_root(p_tree, g_tree)
             if not p_chars.startswith(g_chars):
-                raise ValueError('p_chars do not start with g_chars:\n%s\n%s' % (p_chars, g_chars))
+                raise ValueError('sent_id=%s: !p_chars.startswith(g_chars):\np_chars=%s\ng_chars=%s'
+                                 % (g_tree.sent_id, p_chars, g_chars))
             if g_chars == p_chars:
                 bundle.add_tree(p_tree)
                 continue

From b9378cd0794bb6bca7d85625e83d39d34ee424cd Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 1 Jun 2017 17:56:41 +0200
Subject: [PATCH 0167/1374] node.sdeprel is not also a setter

---
 udapi/block/ud/convert1to2.py | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/udapi/block/ud/convert1to2.py b/udapi/block/ud/convert1to2.py
index 4cd76beb..d76c50b9 100644
--- a/udapi/block/ud/convert1to2.py
+++ b/udapi/block/ud/convert1to2.py
@@ -188,10 +188,7 @@ def change_nmod(self, node):
         if node.udeprel == 'nmod':
             parent_is_nominal = self.is_nominal(node.parent)
             if parent_is_nominal == 'no':
-                if node.sdeprel:
-                    node.deprel = 'obl' + ':' + node.sdeprel
-                else:
-                    node.deprel = 'obl'
+                node.udeprel = 'obl'
             elif node.deprel == 'nmod:tmod':
                 node.deprel = 'obl:tmod'
             elif node.deprel == 'nmod:poss':

From 45a6698ec01172be2234fd315e8bd785c523c3cd Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 3 Jun 2017 01:12:08 +0200
Subject: [PATCH 0168/1374] bootstrap resampling confidence intervals and
 p-value for eval.Conll17

---
 udapi/block/eval/conll17.py | 136 +++++++++++++++++++++++++++++++++++-
 1 file changed, 134 insertions(+), 2 deletions(-)

diff --git a/udapi/block/eval/conll17.py b/udapi/block/eval/conll17.py
index 42b7bb33..6ecd3b5c 100644
--- a/udapi/block/eval/conll17.py
+++ b/udapi/block/eval/conll17.py
@@ -1,18 +1,52 @@
-"""Block eval.Conll17 for evaluating LAS,UAS,etc - gold and pred may have different tokenization.
+"""Block&script eval.Conll17 for evaluating LAS,UAS,etc as in CoNLL2017 UD shared task.
 
 This is a reimplementation of the CoNLL2017 shared task official evaluation script,
 http://universaldependencies.org/conll17/evaluation.html
 
 The gold trees and predicted (system-output) trees need to be sentence-aligned
 e.g. using `util.ResegmentGold`.
+Unlike in `eval.Parsing`, the gold and predicted trees can have different tokenization.
+
+Example execution::
+
+    #!/bin/bash
+    SYSTEMS=`ls systems`
+    [[ $# -ne 0 ]] && SYSTEMS=$@
+    set -x
+    set -e
+    for sys in $SYSTEMS; do
+        mkdir -p results/$sys
+        for testset in `ls systems/$sys`; do
+            udapy read.Conllu zone=gold files=gold/$testset \
+                  read.Conllu zone=pred files=systems/$sys/$testset ignore_sent_id=1 \
+                  util.ResegmentGold \
+                  eval.Conll17 print_results=0 print_raw=1 \
+                  > results/$sys/${testset%.conllu}
+        done
+    done
+    python3 `python3 -c 'import udapi.block.eval.conll17 as x; print(x.__file__)'` -r 100
+
+The last line executes this block as a script and computes bootstrap resampling with 100 resamples
+(default=1000, it is recommended to keep the default or higher value unless testing the interface).
+This prints the ranking and confidence intervals (95% by default) and also p-values for each
+pair of systems with neighboring ranks. If the difference in LAS is significant
+(according to a paired bootstrap test, by default if p < 0.05),
+a line is printed between the two systems.
+
+TODO: Bootstrap currently reports only LAS, but all the other measures could be added as well.
 """
 import argparse
 import difflib
+import logging
+import os
+import random
+import sys
 from collections import Counter
 from udapi.core.basewriter import BaseWriter
 
 CLAS_IGNORE = {'aux', 'case', 'cc', 'clf', 'cop', 'det', 'mark', 'punct'}
 
+
 class Conll17(BaseWriter):
     """Evaluate labeled and unlabeled attachment score (LAS and UAS)."""
 
@@ -95,10 +129,108 @@ def process_end(self):
             print("{:11}|{:10.2f} |{:10.2f} |{:10.2f} |{:10.2f}".format(
                 metric, 100 * precision, 100 * recall, 100 * fscore, 100 * alignacc))
 
+
+def prec_rec_f1(correct, pred, gold, alig=0):
+    precision = correct / pred if pred else 0
+    recall = correct / gold if gold else 0
+    alignacc = correct / alig if alig else 0
+    fscore = 2 * correct / (pred + gold) if pred + gold else 0
+    return precision, recall, fscore, alignacc
+
+
 def main():
     parser = argparse.ArgumentParser()
-    # TODO post-process bootstrap
+    parser.add_argument("--dir_results", "-d", default="results", help="directory with results")
+    parser.add_argument("--resamples", "-r", default=1000, type=int, help="how many resamples")
+    parser.add_argument("--confidence", "-c", default=95, help="use x-percent confidence interval")
+    parser.add_argument("--tests", "-t", default='all', help="comma-separated test sets")
+    parser.add_argument("--systems", "-s", default='all', help="comma-separated systems")
+    parser.add_argument("--randseed", default=0, type=int, help="random seed, default=sys time")
     args = parser.parse_args()
+    res_dir, resamples, conf = args.dir_results, args.resamples, args.confidence
+    alpha = (1 - conf/100) / 2
+    index_lo = int(alpha * (resamples - 1))
+    index_hi = resamples - 1 - index_lo
+    index_mid = int(resamples / 2)
+    if args.systems == 'all':
+        systems = os.listdir(res_dir)
+    else:
+        systems = args.systems.split(',')
+    if args.tests == 'all':
+        tests = set()
+        for system in systems:
+            tests.update(os.listdir(res_dir + '/' + system))
+        tests = sorted(tests)
+    else:
+        tests = args.tests.split(',')
+    if args.randseed:
+        random.seed(args.randseed)
+    results = []
+
+    print('Loading...', file=sys.stderr)
+    for system in systems:
+        sys_results = []
+        results.append(sys_results)
+        for i_test, test in enumerate(tests):
+            filename = '/'.join((res_dir, system, test))
+            try:
+                with open(filename) as res_file:
+                    sys_results.extend([[i_test] + list(map(int, l.split())) for l in res_file])
+            except FileNotFoundError:
+                logging.warning(filename + ' not found')
+    samples = len(sys_results)
+
+    print('Resampling...', file=sys.stderr)
+    boot_results = []
+    for i_resample in range(resamples):
+        print(i_resample + 1, file=sys.stderr, end='\r')
+        resample_results = []
+        boot_results.append(resample_results)
+        for i_system in range(len(systems)):
+            pred, gold, words, las = ([0] * len(tests) for _ in range(4))
+            for _ in range(samples):
+                i_test, pre, gol, wor, la_ = random.choice(results[i_system])
+                pred[i_test] += pre
+                gold[i_test] += gol
+                words[i_test] += wor
+                las[i_test] += la_
+            fscore_sum = 0
+            for i_test in range(len(tests)):
+                _prec, _rec, fscore, _aligacc = prec_rec_f1(las[i_test], pred[i_test], gold[i_test])
+                fscore_sum += fscore
+            resample_results.append(fscore_sum / len(tests))
+    print('\n', file=sys.stderr)
+
+    sys_fscores = []
+    for i_system, system in enumerate(systems):
+        sys_fscores.append([boot_results[i_resample][i_system] for i_resample in range(resamples)])
+    final_results = []
+    sys_sys_wins = [[0] * len(systems) for x in range(len(systems))]
+    for i_system, system in enumerate(systems):
+        for j_system in range(i_system):
+            for i, j in zip(sys_fscores[i_system], sys_fscores[j_system]):
+                if i > j:
+                    sys_sys_wins[i_system][j_system] += 1
+                elif i < j:
+                    sys_sys_wins[j_system][i_system] += 1
+        fscores = sorted(sys_fscores[i_system])
+        final_results.append([i_system, fscores[index_mid], fscores[index_lo], fscores[index_hi]])
+
+    sorted_systems = sorted(final_results, key=lambda x: -x[1])
+    for rank, sys_results in enumerate(sorted_systems):
+        i_system, f1_mid, f1_lo, f1_hi = sys_results
+        if rank < len(systems) - 1:
+            j_worse_sys = sorted_systems[rank + 1][0]
+            p_value = (sys_sys_wins[j_worse_sys][i_system] + 1) / (resamples + 1)
+            p_str = " p=%.3f" % p_value
+        else:
+            p_value, p_str = 1, ""
+        print("%2d. %17s %5.2f ±%5.2f (%5.2f .. %5.2f)%s" %
+              (rank + 1, systems[i_system],
+               100 * f1_mid, 50 * (f1_hi - f1_lo), 100 * f1_lo, 100 * f1_hi, p_str))
+        if p_value < (1 - conf/100):
+            print('-' * 60)
+
 
 if __name__ == "__main__":
     main()

From b20215dee71c5ed866d4eca39220b997507505fb Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 3 Jun 2017 03:19:45 +0200
Subject: [PATCH 0169/1374] example output documented

---
 udapi/block/eval/conll17.py | 56 +++++++++++++++++++++++++++++++++++--
 1 file changed, 54 insertions(+), 2 deletions(-)

diff --git a/udapi/block/eval/conll17.py b/udapi/block/eval/conll17.py
index 6ecd3b5c..12158e55 100644
--- a/udapi/block/eval/conll17.py
+++ b/udapi/block/eval/conll17.py
@@ -1,4 +1,4 @@
-"""Block&script eval.Conll17 for evaluating LAS,UAS,etc as in CoNLL2017 UD shared task.
+r"""Block&script eval.Conll17 for evaluating LAS,UAS,etc as in CoNLL2017 UD shared task.
 
 This is a reimplementation of the CoNLL2017 shared task official evaluation script,
 http://universaldependencies.org/conll17/evaluation.html
@@ -7,7 +7,25 @@
 e.g. using `util.ResegmentGold`.
 Unlike in `eval.Parsing`, the gold and predicted trees can have different tokenization.
 
-Example execution::
+An example usage and output::
+
+    $ udapy read.Conllu zone=gold files=gold.conllu \
+            read.Conllu zone=pred files=pred.conllu ignore_sent_id=1 \
+            eval.Conll17
+    Metric     | Precision |    Recall |  F1 Score | AligndAcc
+    -----------+-----------+-----------+-----------+-----------
+    Words      |     27.91 |     52.17 |     36.36 |    100.00
+    UPOS       |     27.91 |     52.17 |     36.36 |    100.00
+    XPOS       |     27.91 |     52.17 |     36.36 |    100.00
+    Feats      |     27.91 |     52.17 |     36.36 |    100.00
+    Lemma      |     27.91 |     52.17 |     36.36 |    100.00
+    UAS        |     16.28 |     30.43 |     21.21 |     58.33
+    LAS        |     16.28 |     30.43 |     21.21 |     58.33
+    CLAS       |     10.34 |     16.67 |     12.77 |     37.50
+
+
+For evaluating multiple systems and testsets (as in CoNLL2017)
+stored in `systems/testset_name/system_name.conllu` you can use::
 
     #!/bin/bash
     SYSTEMS=`ls systems`
@@ -33,6 +51,40 @@
 (according to a paired bootstrap test, by default if p < 0.05),
 a line is printed between the two systems.
 
+The output looks like::
+
+     1.          Stanford 76.17 ± 0.12 (76.06 .. 76.30) p=0.001
+    ------------------------------------------------------------
+     2.              C2L2 74.88 ± 0.12 (74.77 .. 75.01) p=0.001
+    ------------------------------------------------------------
+     3.               IMS 74.29 ± 0.13 (74.16 .. 74.43) p=0.001
+    ------------------------------------------------------------
+     4.          HIT-SCIR 71.99 ± 0.14 (71.84 .. 72.12) p=0.001
+    ------------------------------------------------------------
+     5.           LATTICE 70.81 ± 0.13 (70.67 .. 70.94) p=0.001
+    ------------------------------------------------------------
+     6.        NAIST-SATO 70.02 ± 0.13 (69.89 .. 70.16) p=0.001
+    ------------------------------------------------------------
+     7.    Koc-University 69.66 ± 0.13 (69.52 .. 69.79) p=0.002
+    ------------------------------------------------------------
+     8.   UFAL-UDPipe-1-2 69.36 ± 0.13 (69.22 .. 69.49) p=0.001
+    ------------------------------------------------------------
+     9.            UParse 68.75 ± 0.14 (68.62 .. 68.89) p=0.003
+    ------------------------------------------------------------
+    10.     Orange-Deskin 68.50 ± 0.13 (68.37 .. 68.62) p=0.448
+    11.          TurkuNLP 68.48 ± 0.14 (68.34 .. 68.62) p=0.029
+    ------------------------------------------------------------
+    12.              darc 68.29 ± 0.13 (68.16 .. 68.42) p=0.334
+    13.  conll17-baseline 68.25 ± 0.14 (68.11 .. 68.38) p=0.003
+    ------------------------------------------------------------
+    14.             MQuni 67.93 ± 0.13 (67.80 .. 68.06) p=0.062
+    15.             fbaml 67.78 ± 0.13 (67.65 .. 67.91) p=0.283
+    16.     LyS-FASTPARSE 67.73 ± 0.13 (67.59 .. 67.85) p=0.121
+    17.        LIMSI-LIPN 67.61 ± 0.14 (67.47 .. 67.75) p=0.445
+    18.             RACAI 67.60 ± 0.13 (67.46 .. 67.72) p=0.166
+    19.     IIT-Kharagpur 67.50 ± 0.14 (67.36 .. 67.64) p=0.447
+    20.           naistCL 67.49 ± 0.15 (67.34 .. 67.63)
+
 TODO: Bootstrap currently reports only LAS, but all the other measures could be added as well.
 """
 import argparse

From 42435d0c3bc646b90778a0f6be0c7a4a3a33dc82 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 5 Jun 2017 09:11:59 +0200
Subject: [PATCH 0170/1374] make the visual hints in TextModeTrees optional

which were introduced in 2cb303d4853d464be
---
 udapi/block/write/textmodetrees.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index bcfc51cc..54680e88 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -88,7 +88,7 @@ class TextModeTrees(BaseWriter):
     def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
                  minimize_cross=True, color='auto', attributes='form,upos,deprel',
                  print_undef_as='_', print_doc_meta=True, print_comments=False,
-                 mark='ToDo|ToDoOrigText|Bug|Mark', marked_only=False, **kwargs):
+                 mark='ToDo|ToDoOrigText|Bug|Mark', marked_only=False, hints=True, **kwargs):
         """Create new TextModeTrees block object.
 
         Args:
@@ -115,6 +115,8 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
             the comment is highlighted.
             Empty string means no highlighting. Default = 'ToDo|ToDoOrigText|Bug|Mark'.
         marked_only: print only trees containing one or more marked nodes/comments. Default=False.
+        hints: use thick-marked segments (┡ and ┢) to distinguish whether a given node precedes
+            or follows its parent. Default=True. If False, plain ├ is used in both cases.
         """
         super().__init__(**kwargs)
         self.print_sent_id = print_sent_id
@@ -137,7 +139,10 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         # _space[precedes_parent][is_topmost_or_bottommost]
         # _vert[is_crossing]
         space = ' ' * indent
-        self._space = [[space + '┡', space + '╰'], [space + '┢', space + '╭']]
+        if hints:
+            self._space = [[space + '┡', space + '╰'], [space + '┢', space + '╭']]
+        else:
+            self._space = [[space + '├', space + '╰'], [space + '├', space + '╭']]
         self._vert = [space + '│', line + '╪']
 
         self.attrs = attributes.split(',')

From 5b42cefa2fb95866d34772716899343b590e13e1 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 5 Jun 2017 10:27:18 +0200
Subject: [PATCH 0171/1374] write.Treex

---
 udapi/block/write/treex.py | 64 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 udapi/block/write/treex.py

diff --git a/udapi/block/write/treex.py b/udapi/block/write/treex.py
new file mode 100644
index 00000000..7faea414
--- /dev/null
+++ b/udapi/block/write/treex.py
@@ -0,0 +1,64 @@
+"""write.Treex is a writer block for Treex XML (e.g. for TrEd editing)."""
+from udapi.core.basewriter import BaseWriter
+
+
+class Treex(BaseWriter):
+    """A writer of files in the Treex format."""
+
+    def before_process_document(self, doc):
+        super().before_process_document(doc)
+        print('<?xml version="1.0" encoding="UTF-8"?>\n'
+              '<treex_document xmlns="http://ufal.mff.cuni.cz/pdt/pml/">\n'
+              '  <head>\n'
+              '    <schema href="treex_schema.xml" />\n'
+              '  </head>\n'
+              '  <meta/>\n'
+              '  <bundles>')
+
+    def after_process_document(self, doc):
+        print("  </bundles>\n</treex_document>\n")
+        super().after_process_document(doc)
+
+    def process_bundle(self, bundle):
+        print('    <LM id="%s">\n      <zones>' % bundle.bundle_id)
+        super().process_bundle(bundle)
+        print('      </zones>\n    </LM>')
+
+    def process_tree(self, tree):
+        zone_parts = tree.zone.split('_')
+        language, selector = zone_parts if len(zone_parts) == 2 else ('und', tree.zone)
+        tree_id = tree.bundle.bundle_id + '-' + language
+        ind = ' ' * 8
+        print(ind + "<zone language='%s' selector='%s'>" % (language, selector))
+        if tree.text:
+            print(ind + "  <sentence>%s</sentence>" % tree.text)
+        print(ind + "  <trees>\n" + ind + "    <a_tree id='%s'>" % tree_id)
+        self.print_subtree(tree, tree_id, ' ' * 12)
+        print(ind + "    </a_tree>\n" + ind + "  </trees>\n" + ind + "</zone>")
+
+    def print_subtree(self, node, tree_id, indent):
+        """Recrsively print trees in Treex format."""
+        if not node.is_root():
+            print(indent + "<LM id='%s-n%s'>" % (tree_id, node.ord))
+        ind = indent + '  '
+        print(ind + "<ord>%s</ord>" % node.ord)
+        if not node.is_root():
+            if node.form:
+                print(ind + "<form>%s</form>" % node.form)
+            if node.lemma:
+                print(ind + "<lemma>%s</lemma>" % node.lemma)
+            if node.upos:
+                print(ind + "<tag>%s</tag>" % node.upos)
+            if node.deprel:
+                print(ind + "<deprel>%s</deprel>" % node.deprel)
+            print(ind + "<conll><pos>%s</pos><feat>%s</feat></conll>"
+                  % (node.xpos, str(node.feats)))
+
+        # TODO misc and deps into wild, but probably need to encode ř as \x{159} etc.
+        if node.children:
+            print(ind + "<children>")
+            for child in node. children:
+                self.print_subtree(child, tree_id, ind + '  ')
+            print(ind + "</children>")
+        if not node.is_root():
+            print(indent + "</LM>")

From 6c1589a4a002e0c4f92888e65d69ec29007d1150 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 8 Jun 2017 18:28:26 +0200
Subject: [PATCH 0172/1374] allow reading conllu without dependencies

e.g. UDPipe baseline files in CoNLL2017 shared task
(which contain an underscore in the HEAD and DEPREL columns).
---
 udapi/block/read/conllu.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index ba10d163..8303d096 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -16,7 +16,7 @@
 class Conllu(BaseReader):
     """A reader of the CoNLL-U files."""
 
-    def __init__(self, strict=False, separator='tab',
+    def __init__(self, strict=False, separator='tab', empty_parent='warn',
                  attributes='ord,form,lemma,upos,xpos,feats,head,deprel,deps,misc', **kwargs):
         """Create the Conllu reader object.
 
@@ -26,6 +26,8 @@ def __init__(self, strict=False, separator='tab',
             Default='tab' is the only possibility in valid CoNLL-U files.
             'space' means one or more whitespaces (this does not allow forms with space).
             'doublespace' means two or more spaces.
+        empty_parent: What to do if HEAD is _? Default=warn - issue a warning and attach to the root
+            or if strict=1 issue an exception. With `empty_parent=ignore` no warning is issued.
         attributes: comma-separated list of column names in the input files
             (default='ord,form,lemma,upos,xpos,feats,head,deprel,deps,misc')
             Changing the default can be used for loading CoNLL-like formats (not valid CoNLL-U).
@@ -49,6 +51,7 @@ def __init__(self, strict=False, separator='tab',
         self.node_attributes = attributes.split(',')
         self.strict = strict
         self.separator = separator
+        self.empty_parent = empty_parent
 
     @staticmethod
     def parse_comment_line(line, root):
@@ -124,7 +127,9 @@ def read_tree(self, document=None):
                             parents.append(int(fields[n_attribute]))
                         except ValueError as exception:
                             if not self.strict and fields[n_attribute] == '_':
-                                logging.warning("Empty parent/head index in '%s'", line)
+                                if self.empty_parent == 'warn':
+                                    logging.warning("Empty parent/head index in '%s'", line)
+                                parents.append(0)
                             else:
                                 raise exception
                     elif attribute_name == 'ord':

From 3fe163a4c0feb5e844e325024b5f6e6da66c5764 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 26 Jun 2017 23:42:16 +0200
Subject: [PATCH 0173/1374] ud.JoinAsMwt: don't duplicate MISC in MWTs, param
 revert_orig_form

---
 udapi/block/ud/joinasmwt.py | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/joinasmwt.py b/udapi/block/ud/joinasmwt.py
index 255f759a..02c54206 100644
--- a/udapi/block/ud/joinasmwt.py
+++ b/udapi/block/ud/joinasmwt.py
@@ -9,6 +9,15 @@
 class JoinAsMwt(Block):
     """Create MWTs if words are not separated by a space.."""
 
+    def __init__(self, revert_orig_form=True, **kwargs):
+        """Args:
+        revert_orig_form: if any node of the newly created MWT has `misc['OrigForm']`,
+            it is used as the FORM (and deleted from MISC). Useful after `ud.ComplyWithText`.
+            Default=True.
+        """
+        super().__init__(**kwargs)
+        self.revert_orig_form = revert_orig_form
+
     def process_node(self, node):
         if node.multiword_token:
             return
@@ -19,6 +28,13 @@ def process_node(self, node):
             mwt_nodes.append(node)
         if len(mwt_nodes) > 1:
             mwt_form = ''.join([n.form for n in mwt_nodes])
-            node.root.create_multiword_token(mwt_nodes, mwt_form, node.misc)
+            mwt = node.root.create_multiword_token(mwt_nodes, mwt_form)
+            if node.misc['SpaceAfter'] == 'No':
+                mwt.misc['SpaceAfter'] = 'No'
             for mwt_node in mwt_nodes:
                 del mwt_node.misc['SpaceAfter']
+            if self.revert_orig_form:
+                for mwt_node in mwt_nodes:
+                    if mwt_node.misc['OrigForm']:
+                        mwt_node.form = mwt_node.misc['OrigForm']
+                        del mwt_node.misc['OrigForm']

From 329e0f7fc7c81c7c0c138834775d502e3d12e5f3 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 27 Jun 2017 12:36:08 +0200
Subject: [PATCH 0174/1374] support for reading and writing doc-level and
 tree-level json data

---
 udapi/block/read/conllu.py            | 12 ++++++++++--
 udapi/block/write/conllu.py           | 14 ++++++++++++++
 udapi/core/document.py                |  1 +
 udapi/core/root.py                    |  3 ++-
 udapi/core/tests/data/babinsky.conllu | 20 ++++++++++++++++++++
 udapi/core/tests/external_tests.sh    |  3 +++
 6 files changed, 50 insertions(+), 3 deletions(-)
 create mode 100644 udapi/core/tests/data/babinsky.conllu

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 8303d096..8edf1359 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -1,4 +1,5 @@
 """"Conllu is a reader block for the CoNLL-U files."""
+import json
 import logging
 import re
 
@@ -11,6 +12,7 @@
 RE_SENT_ID = re.compile(r'^# sent_id\s*=?\s*(\S+)')
 RE_TEXT = re.compile(r'^# text\s*=\s*(.+)')
 RE_NEWPARDOC = re.compile(r'^# (newpar|newdoc) (?:\s*id\s*=\s*(.+))?')
+RE_JSON = re.compile(r'^# json_(doc_)?([^ =]+)\s*=\s*(.+)')
 
 
 class Conllu(BaseReader):
@@ -54,7 +56,7 @@ def __init__(self, strict=False, separator='tab', empty_parent='warn',
         self.empty_parent = empty_parent
 
     @staticmethod
-    def parse_comment_line(line, root):
+    def parse_comment_line(line, root, document):
         """Parse one line of CoNLL-U and fill sent_id, text, newpar, newdoc in root."""
         sent_id_match = RE_SENT_ID.match(line)
         if sent_id_match is not None:
@@ -75,6 +77,12 @@ def parse_comment_line(line, root):
                 root.newdoc = value
             return
 
+        json_match = RE_JSON.match(line)
+        if json_match is not None:
+            container = document if json_match.group(1) == 'doc_' else root
+            container.json[json_match.group(2)] = json.loads(json_match.group(3))
+            return
+
         root.comment += line[1:] + "\n"
 
     # pylint: disable=too-many-locals,too-many-branches,too-many-statements
@@ -93,7 +101,7 @@ def read_tree(self, document=None):
             if line == '':
                 break
             if line[0] == '#':
-                self.parse_comment_line(line, root)
+                self.parse_comment_line(line, root, document)
             else:
                 if self.separator == 'tab':
                     fields = line.split('\t')
diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index 6c2dc314..5185906b 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -1,4 +1,5 @@
 """Conllu class is a a writer of files in the CoNLL-U format."""
+import json
 from udapi.core.basewriter import BaseWriter
 
 
@@ -35,6 +36,11 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
         if self.print_text:
             print("# text = " + tree.get_sentence())
 
+        if tree.json:
+            for key, value in sorted(tree.json.items()):
+                print("# json_%s = %s"
+                      % (key, json.dumps(value, ensure_ascii=False, sort_keys=True)))
+
         comment = tree.comment
         if comment:
             comment = comment.rstrip()
@@ -73,3 +79,11 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
 
         # Empty line separates trees in CoNLL-U (and is required after the last tree as well)
         print("")
+
+    def before_process_document(self, document):
+        """Print json_doc_* headers."""
+        super().before_process_document(document)
+        if document.json:
+            for key, value in sorted(document.json.items()):
+                print("# json_doc_%s = %s"
+                      % (key, json.dumps(value, ensure_ascii=False, sort_keys=True)))
diff --git a/udapi/core/document.py b/udapi/core/document.py
index b64ee29c..66164997 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -13,6 +13,7 @@ def __init__(self):
         self.bundles = []
         self._highest_bundle_id = 0
         self.meta = {}
+        self.json = {}
 
     def __iter__(self):
         return iter(self.bundles)
diff --git a/udapi/core/root.py b/udapi/core/root.py
index 56105872..7460e77b 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -12,7 +12,7 @@
 class Root(Node):
     """Class for representing root nodes (technical roots) in UD trees."""
     __slots__ = ['_sent_id', '_zone', '_bundle', '_descendants', '_mwts',
-                 'empty_nodes', 'text', 'comment', 'newpar', 'newdoc']
+                 'empty_nodes', 'text', 'comment', 'newpar', 'newdoc', 'json']
 
     # pylint: disable=too-many-arguments
     def __init__(self, zone=None, comment='', text=None, newpar=None, newdoc=None):
@@ -30,6 +30,7 @@ def __init__(self, zone=None, comment='', text=None, newpar=None, newdoc=None):
         self.text = text
         self.newpar = newpar
         self.newdoc = newdoc
+        self.json = {}  # TODO: or None and mask as {} in property reader&writer to save memory?
 
         self._sent_id = None
         self._zone = zone
diff --git a/udapi/core/tests/data/babinsky.conllu b/udapi/core/tests/data/babinsky.conllu
new file mode 100644
index 00000000..034ac7d0
--- /dev/null
+++ b/udapi/core/tests/data/babinsky.conllu
@@ -0,0 +1,20 @@
+# json_doc_entities = [{"id": "E1", "labels": ["Jaroslav Vomáčka", "Jarda"], "mentions": ["s1#m1", "s2#m1"]}, {"id": "E2", "labels": ["Babinský"], "mentions": ["s2#m2"]}]
+# json_doc_relations = [{"from": "E1", "id": "R1", "to": "E2", "type": "call"}]
+# sent_id = 1
+# text = Vyšetřování Jaroslava Vomáčky.
+# json_mentions = [{"id": "s1#m1", "label": "Jaroslav Vomáčka", "span": [2, 3]}]
+1	Vyšetřování	vyšetřování	NOUN	NNNS1-----A----	Case=Nom|Gender=Neut|Number=Sing|Polarity=Pos	0	root	_	_
+2	Jaroslava	Jaroslav	PROPN	NNMS2-----A----	Animacy=Anim|Case=Gen|Gender=Masc|NameType=Giv|Number=Sing|Polarity=Pos	1	nmod	_	_
+3	Vomáčky	Vomáčka	PROPN	NNMS2-----A----	Animacy=Anim|Case=Gen|Gender=Masc|NameType=Sur|Number=Sing|Polarity=Pos	2	flat	_	SpaceAfter=No
+4	.	.	PUNCT	Z:-------------	_	1	punct	_	SpaceAfter=No
+
+# sent_id = 2
+# text = Jarda telefonoval loupežníkovi Babinskému.
+# json_mention_relations = [{"from": "s2#m1", "id": "r1", "to": "s2#m2", "type": "call"}]
+# json_mentions = [{"id": "s2#m1", "label": "Jaroslav", "span": [1]}, {"id": "s2#m2", "label": "Babinský", "span": [4]}]
+1	Jarda	Jarda	PROPN	NNMS1-----A----	Animacy=Anim|Case=Nom|Gender=Masc|NameType=Giv|Number=Sing|Polarity=Pos	2	nsubj	_	_
+2	telefonoval	telefonovat	VERB	VpYS---XR-AA---	Aspect=Imp|Gender=Masc|Number=Sing|Polarity=Pos|Tense=Past|VerbForm=Part|Voice=Act	0	root	_	_
+3	loupežníkovi	loupežník	NOUN	NNMS3-----A----	Animacy=Anim|Case=Dat|Gender=Masc|Number=Sing|Polarity=Pos	4	nmod	_	_
+4	Babinskému	Babinský	PROPN	NNMS3-----A----	Animacy=Anim|Case=Dat|Gender=Masc|NameType=Sur|Number=Sing|Polarity=Pos	2	obj	_	SpaceAfter=No
+5	.	.	PUNCT	Z:-------------	_	2	punct	_	SpaceAfter=No
+
diff --git a/udapi/core/tests/external_tests.sh b/udapi/core/tests/external_tests.sh
index 55ded49d..85cda295 100755
--- a/udapi/core/tests/external_tests.sh
+++ b/udapi/core/tests/external_tests.sh
@@ -1,3 +1,6 @@
 #!/bin/bash
+set -e
 
 udapy read.Conllu files=data/UD_Czech_sample.conllu write.Conllu print_sent_id=0 print_text=0 > out.conllu && diff data/UD_Czech_sample.conllu out.conllu && rm out.conllu
+
+cat data/babinsky.conllu | udapy -s > out.conllu && diff data/babinsky.conllu out.conllu && rm out.conllu
\ No newline at end of file

From b495764532a26ef13bcfb59c4ac6fac57e958b1c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 27 Jun 2017 19:22:26 +0200
Subject: [PATCH 0175/1374] rename json_doc_ => doc_json_

so it does not share prefix with "json_"
---
 udapi/block/read/conllu.py            | 2 +-
 udapi/block/write/conllu.py           | 4 ++--
 udapi/core/tests/data/babinsky.conllu | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 8edf1359..59284f89 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -12,7 +12,7 @@
 RE_SENT_ID = re.compile(r'^# sent_id\s*=?\s*(\S+)')
 RE_TEXT = re.compile(r'^# text\s*=\s*(.+)')
 RE_NEWPARDOC = re.compile(r'^# (newpar|newdoc) (?:\s*id\s*=\s*(.+))?')
-RE_JSON = re.compile(r'^# json_(doc_)?([^ =]+)\s*=\s*(.+)')
+RE_JSON = re.compile(r'^# (doc_)?json_([^ =]+)\s*=\s*(.+)')
 
 
 class Conllu(BaseReader):
diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index 5185906b..cb69159d 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -81,9 +81,9 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
         print("")
 
     def before_process_document(self, document):
-        """Print json_doc_* headers."""
+        """Print doc_json_* headers."""
         super().before_process_document(document)
         if document.json:
             for key, value in sorted(document.json.items()):
-                print("# json_doc_%s = %s"
+                print("# doc_json_%s = %s"
                       % (key, json.dumps(value, ensure_ascii=False, sort_keys=True)))
diff --git a/udapi/core/tests/data/babinsky.conllu b/udapi/core/tests/data/babinsky.conllu
index 034ac7d0..32bc53cf 100644
--- a/udapi/core/tests/data/babinsky.conllu
+++ b/udapi/core/tests/data/babinsky.conllu
@@ -1,5 +1,5 @@
-# json_doc_entities = [{"id": "E1", "labels": ["Jaroslav Vomáčka", "Jarda"], "mentions": ["s1#m1", "s2#m1"]}, {"id": "E2", "labels": ["Babinský"], "mentions": ["s2#m2"]}]
-# json_doc_relations = [{"from": "E1", "id": "R1", "to": "E2", "type": "call"}]
+# doc_json_entities = [{"id": "E1", "labels": ["Jaroslav Vomáčka", "Jarda"], "mentions": ["s1#m1", "s2#m1"]}, {"id": "E2", "labels": ["Babinský"], "mentions": ["s2#m2"]}]
+# doc_json_relations = [{"from": "E1", "id": "R1", "to": "E2", "type": "call"}]
 # sent_id = 1
 # text = Vyšetřování Jaroslava Vomáčky.
 # json_mentions = [{"id": "s1#m1", "label": "Jaroslav Vomáčka", "span": [2, 3]}]

From f78cc6b0b7c41ffb8936c924e4f90b9809756f9d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 23 Oct 2017 18:21:48 +0200
Subject: [PATCH 0176/1374] udapy -h prints examples of usage

Fixes #20
---
 bin/udapy | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/bin/udapy b/bin/udapy
index c756c5cb..9bb58f53 100755
--- a/bin/udapy
+++ b/bin/udapy
@@ -7,7 +7,14 @@ from udapi.core.run import Run
 
 # Parse command line arguments.
 argparser = argparse.ArgumentParser(
-    description='udapy - Python interface to Udapi - API for Universal Dependencies')
+    formatter_class=argparse.RawTextHelpFormatter,
+    usage="udapy [optional_arguments] scenario",
+    epilog="See http://udapi.github.io",
+    description="udapy - Python interface to Udapi - API for Universal Dependencies\n\n"
+                "Examples of usage:\n"
+                "  udapy -s read.Sentences udpipe.En < in.txt > out.conllu\n"
+                "  udapy -T < sample.conllu | less -R\n"
+                "  udapy -HAM ud.MarkBugs < sample.conllu > bugs.html\n")
 argparser.add_argument(
     "-q", "--quiet", action="store_true",
     help="Warning, info and debug messages are suppressed. Only fatal errors are reported.")

From 48e9a6931645e09bea01a49681544c1968d8f8a7 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 23 Oct 2017 19:45:09 +0200
Subject: [PATCH 0177/1374] fix https redirects

found with
cd docs && make linkcheck
---
 udapi/block/write/html.py    | 2 +-
 udapi/block/write/sdparse.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/write/html.py b/udapi/block/write/html.py
index ec33b0fd..b06c971a 100644
--- a/udapi/block/write/html.py
+++ b/udapi/block/write/html.py
@@ -34,7 +34,7 @@ class Html(BaseWriter):
 
     This block is based on `Treex::View <https://metacpan.org/release/Treex-View>`_
     but takes a different approach. `Treex::View` depends on (older version of)
-    `Valence` (Perl interface to `Electron <http://electron.atom.io/>`_)
+    `Valence` (Perl interface to `Electron <https://electron.atom.io/>`_)
     and comes with a script `view-treex`, which takes a treex file,
     converts it to json behind the scenes (which is quite slow)
     and displays the json in a Valence window.
diff --git a/udapi/block/write/sdparse.py b/udapi/block/write/sdparse.py
index 60b78d6d..13487738 100644
--- a/udapi/block/write/sdparse.py
+++ b/udapi/block/write/sdparse.py
@@ -29,7 +29,7 @@ class Sdparse(BaseWriter):
 
     Notes:
     The original `Stanford dependencies format
-    <http://nlp.stanford.edu/software/dependencies_manual.pdf>`_
+    <https://nlp.stanford.edu/software/dependencies_manual.pdf>`_
     allows explicit specification of the root dependency, e.g. `root(ROOT-0, makes-8)`.
     However, this is not allowed by Brat, so this writer does not print it.
 

From 043b3533ebdd1f152989290cfc898a48762c0d59 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 23 Oct 2017 19:57:21 +0200
Subject: [PATCH 0178/1374] trying to fix readthedocs build fails

https://readthedocs.org/projects/udapi/builds/6164583/
http://docs.readthedocs.io/en/latest/faq.html#i-get-import-errors-on-libraries-that-depend-on-c-modules
---
 docs/conf.py | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/docs/conf.py b/docs/conf.py
index 3e7864a5..47967fc1 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -21,6 +21,15 @@
 import sys
 sys.path.insert(0, os.path.abspath('..'))
 
+from unittest.mock import MagicMock
+
+class Mock(MagicMock):
+    @classmethod
+    def __getattr__(cls, name):
+        return MagicMock()
+
+MOCK_MODULES = ['ufal.udpipe']
+sys.modules.update((mod_name, Mock()) for mod_name in MOCK_MODULES)
 
 # -- General configuration ------------------------------------------------
 
@@ -62,7 +71,7 @@
 # The short X.Y version.
 version = '0'
 # The full version, including alpha/beta/rc tags.
-release = '1'
+release = '2'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

From 31c87219f7976f571c1e6fc8161cb3fd912fb38b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 23 Oct 2017 20:41:46 +0200
Subject: [PATCH 0179/1374] update setup.py

* rename the distribution to just "udapi"
 (the original suffix "-python" on PyPI makes no sense)
* bump version to 0.2.1
 (semver.org requires X.Y.Z where Z cannot be omitted)
* exclude ufal.udpipe from install_requires, but keep it in requirements.txt
  - https://packaging.python.org/discussions/install-requires-vs-requirements/ says
  "install_requires [...] should be used to specify what a project minimally needs"
  while requirements.txt often contains an exhaustive listing.
  - readthedocs.io has problems with ufal.udpipe because of missing C++11
* add fields required by "setup.py sdist"
---
 setup.py | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/setup.py b/setup.py
index 1ec8e468..bbc49234 100644
--- a/setup.py
+++ b/setup.py
@@ -9,15 +9,25 @@
     raise SystemExit('Udapi requires Python 3.3 or higher.')
 
 setup(
-    name='udapi-python',
-    version='0.2',
+    name='udapi',
+    version='0.2.1',
     description='Python framework for processing Universal Dependencies data',
+    long_description=(
+      'Udapi is an open-source framework providing API for processing '
+      'Universal Dependencies data. It is available in Python, Perl and Java. '
+      'Udapi is suitable both for full-fledged applications and fast '
+      'prototyping: visualization of dependency trees, format conversions, '
+      'querying, editing and transformations, validity tests, dependency '
+      'parsing, evaluation etc.'
+    ),
     author='Martin Popel',
     author_email='popel@ufal.mff.cuni.cz',
     url='https://github.com/udapi/udapi-python',
     packages=find_packages(),
     scripts=['bin/udapy'],
     tests_require=['pytest'],
-    install_requires=['colorama', 'termcolor', 'ufal.udpipe'],
+    install_requires=['colorama', 'termcolor'],
     python_requires='>=3.3',
+    license='GPL 2 or newer',
+    platforms='any',
 )

From 1fb1e08bcd9b9d93ee0395ccd4b4b861b98c6d70 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 23 Oct 2017 20:53:08 +0200
Subject: [PATCH 0180/1374] Create LICENSE

---
 LICENSE | 674 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 674 insertions(+)
 create mode 100644 LICENSE

diff --git a/LICENSE b/LICENSE
new file mode 100644
index 00000000..9cecc1d4
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,674 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    {one line to give the program's name and a brief idea of what it does.}
+    Copyright (C) {year}  {name of author}
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    {project}  Copyright (C) {year}  {fullname}
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<http://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.

From 27dfb39d1431825d09dd959658da88ccdef04fa8 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 24 Oct 2017 11:16:28 +0200
Subject: [PATCH 0181/1374] Update README.md

---
 README.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 4621c918..a082cc00 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,9 @@ Python framework for processing Universal Dependencies data
 
 ## Requirements
 - You need Python 3.3 or higher.
-- If the [ufal.udpipe](https://pypi.python.org/pypi/ufal.udpipe/) parser is needed, make sure you have a C++11 compiler (e.g. [g++ 4.7 or newer](.travis.yml#L9)).
+- If the [ufal.udpipe](https://pypi.python.org/pypi/ufal.udpipe/) parser is needed,
+  make sure you have a C++11 compiler (e.g. [g++ 4.7 or newer](.travis.yml#L9))
+  and install UDPipe with `pip3 install --user --upgrade ufal.udpipe`.
 
 ## Install Udapi for developers
 Let's clone the git repo to `~/udapi-python/`, install dependencies
@@ -23,9 +25,9 @@ source ~/.bashrc # or open new bash
 ```
 
 ## Install Udapi for users
-This is similar to the above, but installs Udapi to the standard (user) Python paths.
+This is similar to the above, but installs Udapi from PyPI to the standard (user) Python paths.
 ```
-pip3 install --user --upgrade git+https://github.com/udapi/udapi-python.git
+pip3 install --user --upgrade udapi
 ```
 Try `udapy -h` to check it is installed correctly.
 If it fails, make sure your `PATH` includes the directory where `pip3` installed the `udapy` script.

From ad69273c5eb065cee60968152ea586396be29ef1 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 24 Oct 2017 17:25:22 +0200
Subject: [PATCH 0182/1374] bugfix: newdoc does not need to be followed by a
 space

---
 udapi/block/read/conllu.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 59284f89..bcd935f3 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -11,7 +11,7 @@
 # This reader accepts also older-style sent_id (until UD v2.0 treebanks are released).
 RE_SENT_ID = re.compile(r'^# sent_id\s*=?\s*(\S+)')
 RE_TEXT = re.compile(r'^# text\s*=\s*(.+)')
-RE_NEWPARDOC = re.compile(r'^# (newpar|newdoc) (?:\s*id\s*=\s*(.+))?')
+RE_NEWPARDOC = re.compile(r'^# (newpar|newdoc)(?:\s+id\s*=\s*(.+))?')
 RE_JSON = re.compile(r'^# (doc_)?json_([^ =]+)\s*=\s*(.+)')
 
 

From 75f71e4d526f6850fcba0dfcedae0740e9bd3485 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 24 Oct 2017 18:31:49 +0200
Subject: [PATCH 0183/1374] requirements for ReadTheDocs without ufal.udpipe

---
 docs/requirements.txt | 2 ++
 1 file changed, 2 insertions(+)
 create mode 100644 docs/requirements.txt

diff --git a/docs/requirements.txt b/docs/requirements.txt
new file mode 100644
index 00000000..a994db47
--- /dev/null
+++ b/docs/requirements.txt
@@ -0,0 +1,2 @@
+colorama
+termcolor

From 555c9c4b77eaedd3984f284d3d1b59f10f1e1aca Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 24 Oct 2017 18:38:41 +0200
Subject: [PATCH 0184/1374] mock for ufal.udpipe is not needed

It did not solve the problem anyway.
---
 docs/conf.py | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 47967fc1..45966b57 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -21,16 +21,6 @@
 import sys
 sys.path.insert(0, os.path.abspath('..'))
 
-from unittest.mock import MagicMock
-
-class Mock(MagicMock):
-    @classmethod
-    def __getattr__(cls, name):
-        return MagicMock()
-
-MOCK_MODULES = ['ufal.udpipe']
-sys.modules.update((mod_name, Mock()) for mod_name in MOCK_MODULES)
-
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.

From c04f5f40373ba54c501fc10a703cfbfde7353fca Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 2 Nov 2017 23:19:04 +0100
Subject: [PATCH 0185/1374] fix an edge case with punctuation-only sentences

fix https://github.com/UniversalDependencies/tools/issues/21
---
 udapi/block/ud/fixpunct.py | 27 +++++++++++++++++++++------
 1 file changed, 21 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index e810c58d..23f4be74 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -3,10 +3,9 @@
 Punctuation in Universal Dependencies has the tag PUNCT, dependency relation punct,
 and is always attached projectively, usually to the head of a neighboring subtree
 to its left or right.
-Punctuation normally does not have children. If it does, we will skip it.
-It is unclear what to do anyway, and we won't have to check for cycles.
+Punctuation normally does not have children. If it does, we will fix it first.
 
-Tries to re-attach punctuation projectively.
+This block tries to re-attach punctuation projectively and according to the guidelines.
 It should help in cases where punctuation is attached randomly, always to the root
 or always to the neighboring word. However, there are limits to what it can do;
 for example it cannot always recognize whether a comma is introduced to separate
@@ -14,7 +13,7 @@
 this block is almost good, the block may actually do more harm than good.
 
 Since the punctuation should not have children, we should not create a non-projectivity
-if we check the roof edges going to the right.
+if we check the root edges going to the right.
 However, it is still possible that we will attach the punctuation non-projectively
 by joining a non-projectivity that already exists.
 For example, the left neighbor (node i-1) may have its parent at i-3,
@@ -47,7 +46,7 @@
 
 
 class FixPunct(Block):
-    """Make sure punct nodes are attached punctuation is attached projectively."""
+    """Make sure punctuation nodes are attached projectively."""
 
     def __init__(self, **kwargs):
         """Create the ud.FixPunct block instance."""
@@ -78,6 +77,15 @@ def process_tree(self, root):
             if node.upos == "PUNCT" and not self._punct_type[node.ord]:
                 self._fix_subord_punct(node)
 
+        # Finally, check if root is still marked with deprel=root.
+        # This may not hold if the original root was a paired punctuation, which was rehanged.
+        for node in root.children:
+            if node.udeprel != 'root':
+                node.udeprel = 'root'
+                for another_node in root.descendants:
+                    if another_node.parent != root and another_node.udeprel == 'root':
+                        another_node.udeprel = 'punct'
+
     def _fix_subord_punct(self, node):
         # Dot used as the ordinal-number marker (in some languages) or abbreviation marker.
         # TODO: detect these cases somehow
@@ -168,10 +176,17 @@ def _fix_paired_punct(self, root, opening_node, closing_punct):
 
     def _fix_pair(self, root, opening_node, closing_node):
         heads = []
+        punct_heads = []
         for node in root.descendants[opening_node.ord: closing_node.ord - 1]:
             if node.parent.precedes(opening_node) or closing_node.precedes(node.parent):
-                if node.upos != 'PUNCT':
+                if node.upos == 'PUNCT':
+                    punct_heads.append(node)
+                else:
                     heads.append(node)
+        # Punctuation should not have children, but if there is no other head candidate,
+        # let's break this rule.
+        if len(heads) == 0:
+            heads = punct_heads
         if len(heads) == 1:
             opening_node.parent = heads[0]
             closing_node.parent = heads[0]

From 5886be4aeb8c0e178d94cbc9aa01bacffba654b9 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 13 Nov 2017 13:05:36 +0100
Subject: [PATCH 0186/1374] root.sent_id returns always the same as
 root.address()

`root.address()` seems redundant now, but it is parallel to
`node.address()` and `bundle.address()`, so let's keep it.

Also fixing a bug with split_docs, where the tree with `newdoc`
(which is a leftover from the last document, stored in `_buffer`)
could have `bundle.bundle_id = 1` not respecting the `sent_id`
stored in the tree.
---
 udapi/core/basereader.py | 22 ++++++++++++++--------
 udapi/core/root.py       | 36 ++++++++++++++++++------------------
 2 files changed, 32 insertions(+), 26 deletions(-)

diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 1f732568..25feb7f0 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -96,12 +96,18 @@ def process_document(self, document):
 
         # There may be a tree left in the buffer when reading the last doc.
         if self._buffer:
-            # TODO list.pop(0) is inefficient, use collections.deque.popleft()
-            bundle = orig_bundles.pop(0) if orig_bundles else document.create_bundle()
-            bundle.add_tree(self._buffer)
-            if self._buffer.newdoc and self._buffer.newdoc is not True:
-                document.meta["docname"] = self._buffer.newdoc
+            root = self._buffer
             self._buffer = None
+            if orig_bundles:
+                # TODO list.pop(0) is inefficient, use collections.deque.popleft()
+                bundle = orig_bundles.pop(0)
+            else:
+                bundle = document.create_bundle()
+                if root._sent_id is not None:
+                    bundle.bundle_id = root._sent_id.split('/', 1)[0]
+            bundle.add_tree(root)
+            if root.newdoc and root.newdoc is not True:
+                document.meta["docname"] = root.newdoc
 
         filehandle = self.filehandle
         if filehandle is None:
@@ -123,9 +129,9 @@ def process_document(self, document):
             trees_loaded += 1
 
             if self.ignore_sent_id:
-                root.sent_id = None
-            if root.sent_id is not None:
-                parts = root.sent_id.split('/', 1)
+                root._sent_id = None
+            if root._sent_id is not None:
+                parts = root._sent_id.split('/', 1)
                 bundle_id = parts[0]
                 if len(parts) == 2:
                     root.zone = parts[1]
diff --git a/udapi/core/root.py b/udapi/core/root.py
index 7460e77b..ae259718 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -42,6 +42,13 @@ def __init__(self, zone=None, comment='', text=None, newpar=None, newdoc=None):
     @property
     def sent_id(self):
         """ID of this tree, stored in the sent_id comment in CoNLL-U."""
+        if self._sent_id is not None:
+            return self._sent_id
+        zone = '/' + self.zone if self.zone else ''
+        if self._bundle is not None:
+            self._sent_id = self._bundle.address() + zone
+        else:
+            self._sent_id = '?' + zone
         return self._sent_id
 
     @sent_id.setter
@@ -53,6 +60,17 @@ def sent_id(self, sent_id):
                 self.zone = parts[1]
         self._sent_id = sent_id
 
+    def address(self):
+        """Full (document-wide) id of the root.
+
+        The general format of root nodes is:
+        root.bundle.bundle_id + '/' + root.zone, e.g. s123/en_udpipe.
+        If zone is empty, the slash is excluded as well, e.g. s123.
+        If bundle is missing (could occur during loading), '?' is used instead.
+        Root's address is stored in CoNLL-U files as sent_id (in a special comment).
+        """
+        return self.sent_id
+
     @property
     def bundle(self):
         """Return the bundle which this tree belongs to."""
@@ -124,24 +142,6 @@ def shift(self, reference_node, after=0, move_subtree=0, reference_subtree=0):
         """Attempts at changing the word order of root result in Exception."""
         raise Exception('Technical root cannot be shifted as it is always the first node')
 
-    def address(self):
-        """Full (document-wide) id of the root.
-
-        The general format of root nodes is:
-        root.bundle.bundle_id + '/' + root.zone, e.g. s123/en_udpipe.
-        If zone is empty, the slash is excluded as well, e.g. s123.
-        If bundle is missing (could occur during loading), '?' is used instead.
-        Root's address is stored in CoNLL-U files as sent_id (in a special comment).
-        TODO: Make sure root.sent_id returns always the same string as root.address.
-        """
-        zone = '/' + self.zone if self.zone else ''
-        if self._bundle is not None:
-            return self._bundle.address() + zone
-        elif self.sent_id is not None:
-            return self.sent_id + zone
-        else:
-            return '?' + zone
-
     # TODO document whether misc is a string or dict or it can be both
     def create_multiword_token(self, words=None, form=None, misc=None):
         """Create and return a new multi-word token (MWT) in this tree.

From af2fcc5b1d3da6be161b3022acecd134c87e0a2e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 13 Nov 2017 13:11:54 +0100
Subject: [PATCH 0187/1374] fixing a bug with doc_json and newdoc

doc_json annotations were loaded to the previous document
if multiple documents were stored in one file and loaded
with `read.Conllu split_docs=1`.
At the time of parsing a CoNLL-U tree, we don't know
whether it will be stored in a "current" document,
or whether a new document will have to be created
(because of `newdoc` annotation).

- adding a test for this bug
- fixing it by storing the data in a special temp location
  `root.json['__doc__']` and moving to the corrent document
  later on
---
 udapi/block/read/conllu.py            |  8 ++++++--
 udapi/core/bundle.py                  |  4 ++++
 udapi/core/tests/data/babinsky.conllu | 10 ++++++++++
 udapi/core/tests/external_tests.sh    |  4 ++--
 4 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index bcd935f3..645b9685 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -79,8 +79,12 @@ def parse_comment_line(line, root, document):
 
         json_match = RE_JSON.match(line)
         if json_match is not None:
-            container = document if json_match.group(1) == 'doc_' else root
-            container.json[json_match.group(2)] = json.loads(json_match.group(3))
+            container = root.json
+            if json_match.group(1) == 'doc_':
+                if '__doc__' not in root.json:
+                    root.json['__doc__'] = {}
+                container = root.json['__doc__']
+            container[json_match.group(2)] = json.loads(json_match.group(3))
             return
 
         root.comment += line[1:] + "\n"
diff --git a/udapi/core/bundle.py b/udapi/core/bundle.py
index ffffa565..5a9d6808 100644
--- a/udapi/core/bundle.py
+++ b/udapi/core/bundle.py
@@ -88,6 +88,10 @@ def add_tree(self, root):
         self.check_zone(root.zone)
         root.bundle = self
         self.trees.append(root)
+        doc_json = root.json.get('__doc__')
+        if doc_json:
+            self._document.json.update(doc_json)
+            del root.json['__doc__']
         return root
 
     def remove(self):
diff --git a/udapi/core/tests/data/babinsky.conllu b/udapi/core/tests/data/babinsky.conllu
index 32bc53cf..f23a81e7 100644
--- a/udapi/core/tests/data/babinsky.conllu
+++ b/udapi/core/tests/data/babinsky.conllu
@@ -18,3 +18,13 @@
 4	Babinskému	Babinský	PROPN	NNMS3-----A----	Animacy=Anim|Case=Dat|Gender=Masc|NameType=Sur|Number=Sing|Polarity=Pos	2	obj	_	SpaceAfter=No
 5	.	.	PUNCT	Z:-------------	_	2	punct	_	SpaceAfter=No
 
+# doc_json_entities = [{"id": "E3", "labels": ["Rumcajs"], "mentions": ["s3#m1"]}]
+# newdoc
+# sent_id = 3
+# text = Rumcajs je loupežník.
+# json_mentions = [{"id": "s3#m1", "label": "Rumcajs", "span": [1]}]
+1	Rumcajs	Rumcajs	PROPN	NNMS1-----A----	Animacy=Anim|Case=Nom|Gender=Masc|NameType=Sur|Number=Sing|Polarity=Pos	3	nsubj	_	_
+2	je	být	AUX	VB-S---3P-AA---	Mood=Ind|Number=Sing|Person=3|Polarity=Pos|Tense=Pres|VerbForm=Fin|Voice=Act	3	cop	_	_
+3	loupežník	loupežník	NOUN	NNMS1-----A----	Animacy=Anim|Case=Nom|Gender=Masc|Number=Sing|Polarity=Pos	0	root	_	SpaceAfter=No
+4	.	.	PUNCT	Z:-------------	_	3	punct	_	SpaceAfter=No
+
diff --git a/udapi/core/tests/external_tests.sh b/udapi/core/tests/external_tests.sh
index 85cda295..ac93cadb 100755
--- a/udapi/core/tests/external_tests.sh
+++ b/udapi/core/tests/external_tests.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 set -e
 
-udapy read.Conllu files=data/UD_Czech_sample.conllu write.Conllu print_sent_id=0 print_text=0 > out.conllu && diff data/UD_Czech_sample.conllu out.conllu && rm out.conllu
+udapy write.Conllu print_sent_id=0 print_text=0 < data/UD_Czech_sample.conllu > out.conllu && diff data/UD_Czech_sample.conllu out.conllu && rm out.conllu
 
-cat data/babinsky.conllu | udapy -s > out.conllu && diff data/babinsky.conllu out.conllu && rm out.conllu
\ No newline at end of file
+udapy -s read.Conllu files=data/babinsky.conllu split_docs=1 > out.conllu && diff data/babinsky.conllu out.conllu && rm out.conllu

From 0509cfe8cc0fa19d84dc022e54ca0c6af2af1b66 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 13 Nov 2017 13:20:21 +0100
Subject: [PATCH 0188/1374] reverting the idea that read_tree has access to the
 doc

The document to which a given tree will be stored
is not known at this time, so it was misleading to
provide such parameter.
It is decided based on the tree's `root.newdoc`
whether the tree will be added to a new document
(which is not created yet).
---
 udapi/block/read/conllu.py |  6 +++---
 udapi/block/read/vislcg.py |  2 +-
 udapi/core/basereader.py   | 10 +++++-----
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 645b9685..a2fd0406 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -56,7 +56,7 @@ def __init__(self, strict=False, separator='tab', empty_parent='warn',
         self.empty_parent = empty_parent
 
     @staticmethod
-    def parse_comment_line(line, root, document):
+    def parse_comment_line(line, root):
         """Parse one line of CoNLL-U and fill sent_id, text, newpar, newdoc in root."""
         sent_id_match = RE_SENT_ID.match(line)
         if sent_id_match is not None:
@@ -92,7 +92,7 @@ def parse_comment_line(line, root, document):
     # pylint: disable=too-many-locals,too-many-branches,too-many-statements
     # Maybe the code could be refactored, but it is speed-critical,
     # so benchmarking is needed because calling extra methods may result in slowdown.
-    def read_tree(self, document=None):
+    def read_tree(self):
         if self.filehandle is None:
             return None
 
@@ -105,7 +105,7 @@ def read_tree(self, document=None):
             if line == '':
                 break
             if line[0] == '#':
-                self.parse_comment_line(line, root, document)
+                self.parse_comment_line(line, root)
             else:
                 if self.separator == 'tab':
                     fields = line.split('\t')
diff --git a/udapi/block/read/vislcg.py b/udapi/block/read/vislcg.py
index 9ad272e3..4c5a87ab 100644
--- a/udapi/block/read/vislcg.py
+++ b/udapi/block/read/vislcg.py
@@ -8,7 +8,7 @@ class Vislcg(BaseReader):
 
     # TODO check validity and raise helpful exceptions if not valid
     # pylint: disable=too-many-branches
-    def read_tree(self, document=None):
+    def read_tree(self):
         if self.filehandle is None:
             return None
 
diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 25feb7f0..818ce945 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -59,7 +59,7 @@ def next_filehandle(self):
         """Go to the next file and retrun its filehandle."""
         return self.files.next_filehandle()
 
-    def read_tree(self, document=None):
+    def read_tree(self):
         """Load one (more) tree from self.files and return its root.
 
         This method must be overriden in all readers.
@@ -68,13 +68,13 @@ def read_tree(self, document=None):
         """
         raise NotImplementedError("Class %s doesn't implement read_tree" % self.__class__.__name__)
 
-    def filtered_read_tree(self, document=None):
+    def filtered_read_tree(self):
         """Load and return one more tree matching the `sent_id_filter`.
 
         This method uses `read_tree()` internally.
         This is the method called by `process_document`.
         """
-        tree = self.read_tree(document)
+        tree = self.read_tree()
         if self.sent_id_filter is None:
             return tree
         while True:
@@ -84,7 +84,7 @@ def filtered_read_tree(self, document=None):
                 return tree
             logging.debug('Skipping sentence %s as it does not match the sent_id_filter %s.',
                           tree.sent_id, self.sent_id_filter)
-            tree = self.read_tree(document)
+            tree = self.read_tree()
 
     # pylint: disable=too-many-branches,too-many-statements
     # Maybe the code could be refactored, but it is speed-critical,
@@ -118,7 +118,7 @@ def process_document(self, document):
 
         trees_loaded = 0
         while True:
-            root = self.filtered_read_tree(document)
+            root = self.filtered_read_tree()
             if root is None:
                 if trees_loaded == 0 and self.files.has_next_file():
                     filehandle = self.next_filehandle()

From f2c209eeee7a75b2c6eeb6445a375fa6d4e3a8cb Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 30 Nov 2017 17:02:49 +0100
Subject: [PATCH 0189/1374] MorphoDiTa wrapper

---
 udapi/tool/morphodita.py | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 udapi/tool/morphodita.py

diff --git a/udapi/tool/morphodita.py b/udapi/tool/morphodita.py
new file mode 100644
index 00000000..656c6acb
--- /dev/null
+++ b/udapi/tool/morphodita.py
@@ -0,0 +1,31 @@
+"""Wrapper for MorphoDiTa (more pythonic than ufal.morphodita)."""
+from collections import namedtuple
+
+from ufal.morphodita import Morpho, TaggedLemmasForms  # pylint: disable=no-name-in-module
+from udapi.core.resource import require_file
+
+FormInfo = namedtuple('FormInfo', 'form lemma tag guesser')
+
+
+class MorphoDiTa:
+    """Wrapper for MorphoDiTa."""
+
+    def __init__(self, model):
+        """Create the MorphoDiTa tool object."""
+        self.model = model
+        path = require_file(model)
+        self.tool = Morpho.load(path)
+        if not self.tool:
+            raise IOError("Cannot load model from file '%s'" % path)
+
+    def forms_of_lemma(self, lemma, tag_wildcard='?', guesser=True):
+        """Return all forms of a given lemma matching a given tag wildcard."""
+
+        use_guesser = 1 if guesser else 0
+        lemmas_forms = TaggedLemmasForms()
+        used_guesser = self.tool.generate(lemma, tag_wildcard, use_guesser, lemmas_forms)
+        forms = []
+        for lemma_forms in lemmas_forms:
+            for form in lemma_forms.forms:
+                forms.append(FormInfo(form.form, lemma_forms.lemma, form.tag, used_guesser))
+        return forms

From 388e4c566e45bf179a245acc4e368835d4a40881 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 30 Nov 2017 17:04:22 +0100
Subject: [PATCH 0190/1374] demo 1984-ization block for Tom Kocmi

---
 udapi/block/newspeak/__init__.py |  0
 udapi/block/newspeak/prevele.py  | 66 ++++++++++++++++++++++++++++++++
 udapi/block/udpipe/cs.py         | 10 +++++
 3 files changed, 76 insertions(+)
 create mode 100644 udapi/block/newspeak/__init__.py
 create mode 100644 udapi/block/newspeak/prevele.py
 create mode 100644 udapi/block/udpipe/cs.py

diff --git a/udapi/block/newspeak/__init__.py b/udapi/block/newspeak/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/newspeak/prevele.py b/udapi/block/newspeak/prevele.py
new file mode 100644
index 00000000..dd616571
--- /dev/null
+++ b/udapi/block/newspeak/prevele.py
@@ -0,0 +1,66 @@
+"""newspeak.PreVele block for 1984-like newspeak-ization.
+
+This is just a demo/draft.
+
+Usage:
+  $ echo 'Nejhorší žena je lepší než nejlepší muž.' | \
+         udapy -q read.Sentences udpipe.Cs newspeak.PreVele write.Sentences
+  Převelenedobrá žena je veledobrá než převeledobrý muž.
+"""
+from udapi.core.block import Block
+from udapi.tool.morphodita import MorphoDiTa
+
+ANTONYMS = {
+    'špatný': 'dobrý',
+    'pomalý': 'rychlý',
+    # 'muž': 'žena',  this does not work because xpos contains gender,
+    # we would also need to exploit the parsing and change gender of all congruent adj children.
+}
+
+
+class PreVele(Block):
+    """Change all comparatives to vele-x and superlatives to převele-x."""
+
+    def __init__(self, morphodita_path='models/morphodita/cs/',
+                 morphodita_model='czech-morfflex-131112.dict',
+                 **kwargs):
+        """Create the PreVele block object."""
+        super().__init__(**kwargs)
+        self.morphodita = MorphoDiTa(model=morphodita_path + morphodita_model)
+
+    def process_tree(self, tree):
+
+        # apply process_node on all nodes
+        super().process_tree(tree)
+
+        # Capitalize if needed
+        first_node = tree.descendants[0]
+        if tree.text[0].isupper() and not first_node.form[0].isupper():
+            first_node.form = first_node.form[0].upper() + first_node.form[1:]
+
+        # Recompute the sentence string
+        tree.text = tree.compute_text()
+
+    def process_node(self, node):
+        antonym = ANTONYMS.get(node.lemma)
+        if antonym is not None:
+            if node.xpos[11] == 'N':
+                if node.form.lower().startswith('ne'):
+                    node.lemma = antonym
+                    node.xpos = node.xpos[:10] + 'A' + node.xpos[11:]
+                    node.form = node.form[2:]
+            else:
+                forms = self.morphodita.forms_of_lemma(antonym, node.xpos)
+                if forms:
+                    node.lemma = antonym
+                    node.xpos = node.xpos[:10] + 'N' + node.xpos[11:]
+                    node.form = 'ne' + forms[0].form
+
+        degree = node.feats["Degree"]
+        if degree in ("Sup", "Cmp"):
+            new_xpos = node.xpos[:9] + '1' + node.xpos[10:]
+            forms = self.morphodita.forms_of_lemma(node.lemma, new_xpos)
+            if forms:
+                new_form = "vele" if degree == "Cmp" else "převele"
+                new_form += forms[0].form
+                node.form = new_form
diff --git a/udapi/block/udpipe/cs.py b/udapi/block/udpipe/cs.py
new file mode 100644
index 00000000..743efcb7
--- /dev/null
+++ b/udapi/block/udpipe/cs.py
@@ -0,0 +1,10 @@
+"""Block udpipe.Cs for tagging and parsing Czech."""
+from udapi.block.udpipe.base import Base
+
+
+class Cs(Base):
+    """Tag and parse Czech."""
+
+    def __init__(self, **kwargs):
+        """Create the udpipe.Cs block object."""
+        super().__init__(model_alias='cs', **kwargs)

From 1a7492b58796fb78f31109c88d3e9514984ab731 Mon Sep 17 00:00:00 2001
From: Tom Kocmi <kocmitom@gmail.com>
Date: Sun, 10 Dec 2017 16:03:07 +0100
Subject: [PATCH 0191/1374] Allowing the import of private modules

---
 udapi/core/run.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/udapi/core/run.py b/udapi/core/run.py
index f42f3f9d..512213f3 100644
--- a/udapi/core/run.py
+++ b/udapi/core/run.py
@@ -82,7 +82,12 @@ def _import_blocks(block_names, block_args):
     for (block_id, block_name) in enumerate(block_names):
         # Importing module dynamically.
         sub_path, class_name = _parse_block_name(block_name)
-        module = "udapi.block." + sub_path + "." + class_name.lower()
+        
+        if block_name.startswith('.'):
+            # Private modules are recognized by a dot at the beginning
+            module = block_name.lower()[1:]
+        else:            
+            module = "udapi.block." + sub_path + "." + class_name.lower()
         try:
             command = "from " + module + " import " + class_name + " as b" + str(block_id)
             logging.debug("Trying to run command: %s", command)

From c9efe469860d27039c6acb49e90d4d0446fb70b2 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 19 Dec 2017 21:28:25 +0100
Subject: [PATCH 0192/1374] before_process_document of writers must be called

otherwise the output goes to stdout
instead of the file provided in constructor
---
 udapi/core/document.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/core/document.py b/udapi/core/document.py
index 66164997..ad7bbdbe 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -29,9 +29,13 @@ def create_bundle(self):
     def load_conllu(self, filename):
         """Load a document from a conllu-formatted file."""
         reader = ConlluReader(files=filename)
+        reader.before_process_document(self)
         reader.process_document(self)
+        reader.after_process_document(self)
 
     def store_conllu(self, filename):
         """Store a document into a conllu-formatted file."""
         writer = ConlluWriter(files=filename)
+        writer.before_process_document(self)
         writer.process_document(self)
+        writer.after_process_document(self)

From c8ca5dd05ca0d6bf4c99148ef7f851c3b7fd76ca Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 21 Dec 2017 03:24:04 +0100
Subject: [PATCH 0193/1374] support for loading/storing documents from/to
 strings

doc.from_conllu_string(s)
s = doc.to_conllu_strint()
---
 udapi/core/basereader.py |  7 ++++---
 udapi/core/basewriter.py | 16 ++++++++++++++--
 udapi/core/block.py      |  5 +++++
 udapi/core/document.py   | 24 ++++++++++++++++--------
 udapi/core/files.py      | 17 ++++++++++++-----
 udapi/core/run.py        |  8 +++-----
 6 files changed, 54 insertions(+), 23 deletions(-)

diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 818ce945..9e3b6488 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -12,13 +12,14 @@ class BaseReader(Block):
     """Base class for all reader blocks."""
 
     # pylint: disable=too-many-arguments
-    def __init__(self, files='-', zone='keep', bundles_per_doc=0, encoding='utf-8',
+    def __init__(self, files='-', filehandle=None, zone='keep', bundles_per_doc=0, encoding='utf-8',
                  sent_id_filter=None, split_docs=False, ignore_sent_id=False, **kwargs):
         super().__init__(**kwargs)
-        self.files = Files(filenames=files)
+        if filehandle is not None:
+            files = None
+        self.files = Files(filenames=files, filehandle=filehandle, encoding=encoding)
         self.zone = zone
         self.bundles_per_doc = bundles_per_doc
-        self.encoding = encoding
         self._buffer = None
         self.finished = False
         self.sent_id_filter = None
diff --git a/udapi/core/basewriter.py b/udapi/core/basewriter.py
index 36edd1aa..ed574c95 100644
--- a/udapi/core/basewriter.py
+++ b/udapi/core/basewriter.py
@@ -9,10 +9,14 @@
 class BaseWriter(Block):
     """Base class for all reader blocks."""
 
-    def __init__(self, files='-', docname_as_file=False, encoding='utf-8', newline='\n', **kwargs):
+    def __init__(self, files='-', filehandle=None, docname_as_file=False, encoding='utf-8',
+                 newline='\n', **kwargs):
         super().__init__(**kwargs)
         self.orig_files = files
-        self.files = Files(filenames=files)
+        if filehandle is not None:
+            files = None
+            self.orig_files = '<filehandle>'
+        self.files = Files(filenames=files, filehandle=filehandle)
         self.encoding = encoding
         self.newline = newline
         self.docname_as_file = docname_as_file
@@ -34,6 +38,10 @@ def next_filename(self):
         return self.files.next_filename()
 
     def before_process_document(self, document):
+        if self.orig_files == '<filehandle>':
+            logging.info('Writing to filehandle.')
+            sys.stdout = self.files.filehandle
+            return
         if self.orig_files == '-':
             if self.docname_as_file:
                 docname = document.meta.get('docname', None)
@@ -60,3 +68,7 @@ def before_process_document(self, document):
         else:
             logging.info('Writing to file %s.', filename)
             sys.stdout = open(filename, 'wt', encoding=self.encoding, newline=self.newline)
+
+    def after_process_document(self, document):
+        if self.orig_files == '<filehandle>':
+            sys.stdout = sys.__stdout__
diff --git a/udapi/core/block.py b/udapi/core/block.py
index 453b1d65..4ddbaf2b 100644
--- a/udapi/core/block.py
+++ b/udapi/core/block.py
@@ -31,6 +31,11 @@ def process_bundle(self, bundle):
             if self._should_process_tree(tree):
                 self.process_tree(tree)
 
+    def apply_on_document(self, document):
+        self.before_process_document(document)
+        self.process_document(document)
+        self.after_process_document(document)
+
     def process_document(self, document):
         """Process a UD document"""
         for bundle_no, bundle in enumerate(document.bundles, 1):
diff --git a/udapi/core/document.py b/udapi/core/document.py
index ad7bbdbe..778e5bd9 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -1,7 +1,7 @@
 """Document class is a container for UD trees."""
 
+import io
 from udapi.core.bundle import Bundle
-
 from udapi.block.read.conllu import Conllu as ConlluReader
 from udapi.block.write.conllu import Conllu as ConlluWriter
 
@@ -26,16 +26,24 @@ def create_bundle(self):
         bundle.number = len(self.bundles)
         return bundle
 
-    def load_conllu(self, filename):
+    def load_conllu(self, filename=None):
         """Load a document from a conllu-formatted file."""
         reader = ConlluReader(files=filename)
-        reader.before_process_document(self)
-        reader.process_document(self)
-        reader.after_process_document(self)
+        reader.apply_on_document(self)
 
     def store_conllu(self, filename):
         """Store a document into a conllu-formatted file."""
         writer = ConlluWriter(files=filename)
-        writer.before_process_document(self)
-        writer.process_document(self)
-        writer.after_process_document(self)
+        writer.apply_on_document(self)
+
+    def from_conllu_string(self, string):
+        """Load a document from a conllu-formatted string."""
+        reader = ConlluReader(filehandle=io.StringIO(string))
+        reader.apply_on_document(self)
+
+    def to_conllu_string(self):
+        """Return the document as a conllu-formatted string."""
+        fh = io.StringIO()
+        writer = ConlluWriter(filehandle=fh)
+        writer.apply_on_document(self)
+        return fh.getvalue()
diff --git a/udapi/core/files.py b/udapi/core/files.py
index 29ad60e9..523fe303 100644
--- a/udapi/core/files.py
+++ b/udapi/core/files.py
@@ -29,16 +29,21 @@ class Files(object):
     >>> filehandle = files.next_filehandle()
     """
 
-    def __init__(self, filenames, encoding='utf-8'):
-        if isinstance(filenames, list):
+    def __init__(self, filenames=None, filehandle=None, encoding='utf-8'):
+        self.filehandle = None
+        self.file_number = 0
+        self.encoding = encoding
+        if filehandle is not None:
+            self.filehandle = filehandle
+            if filenames is not None:
+                raise ValueError('Cannot specify both "filenames" and "filehandle"')
+            self.filenames = ['<filehandle_input>']
+        elif isinstance(filenames, list):
             self.filenames = filenames
         elif isinstance(filenames, str):
             self.filenames = self.string_to_filenames(filenames)
         else:
             raise ValueError('Parameter "filenames" must be a list or str')
-        self.filehandle = None
-        self.encoding = encoding
-        self.file_number = 0
 
     def string_to_filenames(self, string):
         """Parse a pattern string (e.g. '!dir??/file*.txt') and return a list of matching filenames.
@@ -105,6 +110,8 @@ def next_filehandle(self):
             fhandle = None
         elif filename == '-':
             fhandle = sys.stdin
+        elif filename == '<filehandle_input>':
+            fhandle = self.filehandle
         else:
             filename_extension = filename.split('.')[-1]
             if filename_extension == 'gz':
diff --git a/udapi/core/run.py b/udapi/core/run.py
index 512213f3..c730a1a7 100644
--- a/udapi/core/run.py
+++ b/udapi/core/run.py
@@ -82,11 +82,11 @@ def _import_blocks(block_names, block_args):
     for (block_id, block_name) in enumerate(block_names):
         # Importing module dynamically.
         sub_path, class_name = _parse_block_name(block_name)
-        
+
         if block_name.startswith('.'):
             # Private modules are recognized by a dot at the beginning
             module = block_name.lower()[1:]
-        else:            
+        else:
             module = "udapi.block." + sub_path + "." + class_name.lower()
         try:
             command = "from " + module + " import " + class_name + " as b" + str(block_id)
@@ -156,9 +156,7 @@ def execute(self):
             logging.info(" ---- ROUND ----")
             for block in blocks:
                 logging.info("Executing block " + block.__class__.__name__)
-                block.before_process_document(document)
-                block.process_document(document)
-                block.after_process_document(document)
+                block.apply_on_document(document)
 
             finished = True
 

From 9d8365ecdb02dece78aaea8de942e9dd750d346e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 8 Jan 2018 22:41:37 +0100
Subject: [PATCH 0194/1374] bump version to 0.2.2

---
 CHANGES.txt | 11 +++++++++++
 setup.py    |  2 +-
 2 files changed, 12 insertions(+), 1 deletion(-)
 create mode 100644 CHANGES.txt

diff --git a/CHANGES.txt b/CHANGES.txt
new file mode 100644
index 00000000..dbcd9702
--- /dev/null
+++ b/CHANGES.txt
@@ -0,0 +1,11 @@
+Udapi Change Log
+----------------
+See https://github.com/udapi/udapi-python/commits/master for details.
+
+0.2.2 2018-01-08
+ - support for loading/storing documents from/to strings
+ - allow private modules (starting with dot instead of udapi.block)
+ - MorphoDiTa wrapper udapi/tool/morphodita.py
+ - root.sent_id returns always the same as root.address()
+
+0.2.1 2017-10-23 the first PyPI release
\ No newline at end of file
diff --git a/setup.py b/setup.py
index bbc49234..7197d909 100644
--- a/setup.py
+++ b/setup.py
@@ -10,7 +10,7 @@
 
 setup(
     name='udapi',
-    version='0.2.1',
+    version='0.2.2',
     description='Python framework for processing Universal Dependencies data',
     long_description=(
       'Udapi is an open-source framework providing API for processing '

From 6067ccb5256bb024f414dc8b664b3cb03269d2de Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 16 Feb 2018 01:33:24 +0100
Subject: [PATCH 0195/1374] allow ud.FixPunct to edit only upos=PUNCT nodes

fixes #45
---
 udapi/block/ud/fixpunct.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 23f4be74..546add79 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -48,10 +48,11 @@
 class FixPunct(Block):
     """Make sure punctuation nodes are attached projectively."""
 
-    def __init__(self, **kwargs):
+    def __init__(self, check_paired_punct_upos=False, **kwargs):
         """Create the ud.FixPunct block instance."""
         super().__init__(**kwargs)
         self._punct_type = None
+        self.check_paired_punct_upos = check_paired_punct_upos
 
     def process_tree(self, root):
         # First, make sure no PUNCT has children
@@ -163,6 +164,9 @@ def _fix_subord_punct(self, node):
         node.deprel = "punct"
 
     def _fix_paired_punct(self, root, opening_node, closing_punct):
+        if self.check_paired_punct_upos and opening_node.upos != 'PUNCT':
+            return
+
         nested_level = 0
         for node in root.descendants[opening_node.ord:]:
             if node.form == closing_punct:

From 7cf82d2c5a34ac9a7e8df8330ab736e090addd17 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 9 Mar 2018 17:55:20 +0100
Subject: [PATCH 0196/1374] optionally copy PUNCT dependencies to enahnced deps

use `ud.FixPunct copy_to_enhanced=1`
Fixes #47
---
 udapi/block/ud/fixpunct.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 546add79..7d5bb483 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -48,11 +48,12 @@
 class FixPunct(Block):
     """Make sure punctuation nodes are attached projectively."""
 
-    def __init__(self, check_paired_punct_upos=False, **kwargs):
+    def __init__(self, check_paired_punct_upos=False, copy_to_enhanced=False, **kwargs):
         """Create the ud.FixPunct block instance."""
         super().__init__(**kwargs)
         self._punct_type = None
         self.check_paired_punct_upos = check_paired_punct_upos
+        self.copy_to_enhanced = copy_to_enhanced
 
     def process_tree(self, root):
         # First, make sure no PUNCT has children
@@ -87,6 +88,11 @@ def process_tree(self, root):
                     if another_node.parent != root and another_node.udeprel == 'root':
                         another_node.udeprel = 'punct'
 
+        if self.copy_to_enhanced:
+            for node in root.descendants:
+                if node.upos == "PUNCT":
+                    node.deps = [{'parent': node.parent, 'deprel': 'punct'}]
+
     def _fix_subord_punct(self, node):
         # Dot used as the ordinal-number marker (in some languages) or abbreviation marker.
         # TODO: detect these cases somehow

From d536e6ff3a3c95f413e48d5cd7512383939064b2 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 21 Mar 2018 20:58:37 +0100
Subject: [PATCH 0197/1374] conll2018 version of the evaluation script with
 MLAS and BLEX

---
 udapi/block/eval/conll18.py | 320 ++++++++++++++++++++++++++++++++++++
 1 file changed, 320 insertions(+)
 create mode 100644 udapi/block/eval/conll18.py

diff --git a/udapi/block/eval/conll18.py b/udapi/block/eval/conll18.py
new file mode 100644
index 00000000..97bc68aa
--- /dev/null
+++ b/udapi/block/eval/conll18.py
@@ -0,0 +1,320 @@
+r"""Block&script eval.Conll18 for evaluating LAS,UAS,etc as in CoNLL2018 UD shared task.
+
+This is a reimplementation of the CoNLL2018 shared task official evaluation script,
+http://universaldependencies.org/conll18/evaluation.html
+
+The gold trees and predicted (system-output) trees need to be sentence-aligned
+e.g. using `util.ResegmentGold`.
+Unlike in `eval.Parsing`, the gold and predicted trees can have different tokenization.
+
+An example usage and output::
+
+    $ udapy read.Conllu zone=gold files=gold.conllu \
+            read.Conllu zone=pred files=pred.conllu ignore_sent_id=1 \
+            eval.Conll18
+    Metric     | Precision |    Recall |  F1 Score | AligndAcc
+    -----------+-----------+-----------+-----------+-----------
+    Words      |     27.91 |     52.17 |     36.36 |    100.00
+    UPOS       |     27.91 |     52.17 |     36.36 |    100.00
+    XPOS       |     27.91 |     52.17 |     36.36 |    100.00
+    Feats      |     27.91 |     52.17 |     36.36 |    100.00
+    Lemma      |     27.91 |     52.17 |     36.36 |    100.00
+    UAS        |     16.28 |     30.43 |     21.21 |     58.33
+    LAS        |     16.28 |     30.43 |     21.21 |     58.33
+    CLAS       |     10.34 |     16.67 |     12.77 |     37.50
+
+
+For evaluating multiple systems and testsets (as in CoNLL2018)
+stored in `systems/testset_name/system_name.conllu` you can use::
+
+    #!/bin/bash
+    SYSTEMS=`ls systems`
+    [[ $# -ne 0 ]] && SYSTEMS=$@
+    set -x
+    set -e
+    for sys in $SYSTEMS; do
+        mkdir -p results/$sys
+        for testset in `ls systems/$sys`; do
+            udapy read.Conllu zone=gold files=gold/$testset \
+                  read.Conllu zone=pred files=systems/$sys/$testset ignore_sent_id=1 \
+                  util.ResegmentGold \
+                  eval.Conll18 print_results=0 print_raw=LAS \
+                  > results/$sys/${testset%.conllu}
+        done
+    done
+    python3 `python3 -c 'import udapi.block.eval.conll18 as x; print(x.__file__)'` -r 100
+
+The last line executes this block as a script and computes bootstrap resampling with 100 resamples
+(default=1000, it is recommended to keep the default or higher value unless testing the interface).
+This prints the ranking and confidence intervals (95% by default) and also p-values for each
+pair of systems with neighboring ranks. If the difference in LAS is significant
+(according to a paired bootstrap test, by default if p < 0.05),
+a line is printed between the two systems.
+
+The output looks like::
+
+     1.          Stanford 76.17 ± 0.12 (76.06 .. 76.30) p=0.001
+    ------------------------------------------------------------
+     2.              C2L2 74.88 ± 0.12 (74.77 .. 75.01) p=0.001
+    ------------------------------------------------------------
+     3.               IMS 74.29 ± 0.13 (74.16 .. 74.43) p=0.001
+    ------------------------------------------------------------
+     4.          HIT-SCIR 71.99 ± 0.14 (71.84 .. 72.12) p=0.001
+    ------------------------------------------------------------
+     5.           LATTICE 70.81 ± 0.13 (70.67 .. 70.94) p=0.001
+    ------------------------------------------------------------
+     6.        NAIST-SATO 70.02 ± 0.13 (69.89 .. 70.16) p=0.001
+    ------------------------------------------------------------
+     7.    Koc-University 69.66 ± 0.13 (69.52 .. 69.79) p=0.002
+    ------------------------------------------------------------
+     8.   UFAL-UDPipe-1-2 69.36 ± 0.13 (69.22 .. 69.49) p=0.001
+    ------------------------------------------------------------
+     9.            UParse 68.75 ± 0.14 (68.62 .. 68.89) p=0.003
+    ------------------------------------------------------------
+    10.     Orange-Deskin 68.50 ± 0.13 (68.37 .. 68.62) p=0.448
+    11.          TurkuNLP 68.48 ± 0.14 (68.34 .. 68.62) p=0.029
+    ------------------------------------------------------------
+    12.              darc 68.29 ± 0.13 (68.16 .. 68.42) p=0.334
+    13.  conll18-baseline 68.25 ± 0.14 (68.11 .. 68.38) p=0.003
+    ------------------------------------------------------------
+    14.             MQuni 67.93 ± 0.13 (67.80 .. 68.06) p=0.062
+    15.             fbaml 67.78 ± 0.13 (67.65 .. 67.91) p=0.283
+    16.     LyS-FASTPARSE 67.73 ± 0.13 (67.59 .. 67.85) p=0.121
+    17.        LIMSI-LIPN 67.61 ± 0.14 (67.47 .. 67.75) p=0.445
+    18.             RACAI 67.60 ± 0.13 (67.46 .. 67.72) p=0.166
+    19.     IIT-Kharagpur 67.50 ± 0.14 (67.36 .. 67.64) p=0.447
+    20.           naistCL 67.49 ± 0.15 (67.34 .. 67.63)
+"""
+import argparse
+import difflib
+import logging
+import os
+import random
+import sys
+from collections import Counter
+from udapi.core.basewriter import BaseWriter
+
+CONTENT = {'nsubj', 'obj', 'iobj', 'csubj', 'ccomp', 'xcomp', 'obl', 'vocative', 'expl',
+           'dislocated', 'advcl', 'advmod', 'discourse', 'nmod', 'appos', 'nummod', 'acl',
+           'amod', 'conj', 'fixed', 'flat', 'compound', 'list', 'parataxis', 'orphan', 'goeswith',
+           'reparandum', 'root', 'dep'}
+FUNCTIONAL = {'aux', 'cop', 'mark', 'det', 'clf', 'case', 'cc'}
+UNIV_FEATS = {'PronType', 'NumType', 'Poss', 'Reflex', 'Foreign', 'Abbr', 'Gender', 'Animacy',
+              'Number', 'Case', 'Definite', 'Degree', 'VerbForm', 'Mood', 'Tense', 'Aspect',
+              'Voice', 'Evident', 'Polarity', 'Person', 'Polite'}
+
+class Conll18(BaseWriter):
+    """Evaluate LAS, UAS, MLAS and BLEX."""
+
+    def __init__(self, gold_zone='gold', print_raw=False, print_results=True, **kwargs):
+        """Args:
+        gold_zone - Which zone contains the gold-standard trees (the other zone contains "pred")?
+        print_raw - Print raw counts (pred, gold, aligned, correct) for each sentence.
+            This is useful for bootstrap resampling post-processing to get confidence intervals.
+            The parameter print_raw specifies a given metric
+            (UAS, LAS, MLAS, BLEX, UPOS, XPOS, Feats, Lemma) or is 0 (or False) by default.
+        print_results - Print a table with overall results after all document are processed.
+        """
+        super().__init__(**kwargs)
+        self.gold_zone = gold_zone
+        self.total_count = Counter()
+        self.print_raw = print_raw
+        self.print_results = print_results
+
+    def process_tree(self, tree):
+        gold_tree = tree.bundle.get_tree(self.gold_zone)
+        if tree == gold_tree:
+            return
+        pred_nodes = tree.descendants
+        gold_nodes = gold_tree.descendants
+        pred_forms = [n.form.lower() for n in pred_nodes]
+        gold_forms = [n.form.lower() for n in gold_nodes]
+        matcher = difflib.SequenceMatcher(None, pred_forms, gold_forms, autojunk=False)
+        aligned = []
+        for diff in matcher.get_opcodes():
+            edit, pred_lo, pred_hi, gold_lo, gold_hi = diff
+            if edit == 'equal':
+                aligned.extend(zip(pred_nodes[pred_lo:pred_hi], gold_nodes[gold_lo:gold_hi]))
+        align_map = {tree: gold_tree}
+        for p_node, g_node in aligned:
+            align_map[p_node] = g_node
+
+        count = Counter()
+        count['pred'] = len(pred_nodes)
+        count['gold'] = len(gold_nodes)
+        count['Words'] = len(aligned)
+        count['pred_cont'] = len([n for n in pred_nodes if n.udeprel in CONTENT])
+        count['gold_cont'] = len([n for n in gold_nodes if n.udeprel in CONTENT])
+        count['alig_cont'] = len([n for _, n in aligned if n.udeprel in CONTENT])
+
+        for p_node, g_node in aligned:
+            for attr in ('UPOS', 'XPOS', 'Feats', 'Lemma'):
+                if p_node.get_attrs([attr.lower()]) == g_node.get_attrs([attr.lower()]):
+                    count[attr] += 1
+            if align_map.get(p_node.parent) == g_node.parent:
+                count['UAS'] += 1
+                if p_node.udeprel == g_node.udeprel:
+                    count['LAS'] += 1
+                    if g_node.udeprel in CONTENT:
+                        count['CLAS'] += 1
+                        if g_node.lemma == '_' or g_node.lemma == p_node.lemma:
+                            count['BLEX'] += 1
+                        if self._morpho_match(p_node, g_node, align_map):
+                            count['MLAS'] += 1
+        self.total_count.update(count)
+
+        if self.print_raw:
+            if self.print_raw in {'CLAS', 'BLEX', 'MLAS'}:
+                scores = [str(count[s]) for s in ('pred_cont', 'gold_cont', 'alig_cont',
+                                                  self.print_raw)]
+            else:
+                scores = [str(count[s]) for s in ('pred', 'gold', 'Words', self.print_raw)]
+            print(' '.join(scores))
+
+    def _morpho_match(self, p_node, g_node, align_map, check_children=True):
+        if p_node.upos != g_node.upos:
+            return False
+        for feat in UNIV_FEATS:
+            if p_node.feats[feat] != g_node.feats[feat]:
+                return False
+        if check_children:
+            p_children = [c for c in p_node.children if c.udeprel in FUNCTIONAL]
+            g_children = [c for c in g_node.children if c.udeprel in FUNCTIONAL]
+            if len(p_children) != len(g_children):
+                return False
+            for p_child, g_child in zip(p_children, g_children):
+                if align_map.get(p_child) != g_child:
+                    return False
+                if p_child.udeprel != g_child.udeprel:
+                    return False
+                if not self._morpho_match(p_child, g_child, None, check_children=False):
+                    return False
+        return True
+
+    def process_end(self):
+        if not self.print_results:
+            return
+
+        # Redirect the default filehandle to the file specified by self.files
+        self.before_process_document(None)
+
+        metrics = ('Words', 'UPOS', 'XPOS', 'Feats', 'Lemma', 'UAS', 'LAS', 'CLAS', 'BLEX', 'MLAS')
+        print("Metric     | Precision |    Recall |  F1 Score | AligndAcc")
+        print("-----------+-----------+-----------+-----------+-----------")
+        for metric in metrics:
+            if metric in {'CLAS', 'BLEX', 'MLAS'}:
+                pred, gold = self.total_count['pred_cont'], self.total_count['gold_cont']
+                alig = self.total_count['alig_cont']
+            else:
+                pred, gold = self.total_count['pred'], self.total_count['gold']
+                alig = self.total_count['Words']
+            correct = self.total_count[metric]
+            precision, recall, fscore, alignacc = prec_rec_f1(correct, pred, gold, alig)
+            print("{:11}|{:10.2f} |{:10.2f} |{:10.2f} |{:10.2f}".format(
+                metric, 100 * precision, 100 * recall, 100 * fscore, 100 * alignacc))
+
+
+def prec_rec_f1(correct, pred, gold, alig=0):
+    precision = correct / pred if pred else 0
+    recall = correct / gold if gold else 0
+    alignacc = correct / alig if alig else 0
+    fscore = 2 * correct / (pred + gold) if pred + gold else 0
+    return precision, recall, fscore, alignacc
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--dir_results", "-d", default="results", help="directory with results")
+    parser.add_argument("--resamples", "-r", default=1000, type=int, help="how many resamples")
+    parser.add_argument("--confidence", "-c", default=95, help="use x-percent confidence interval")
+    parser.add_argument("--tests", "-t", default='all', help="comma-separated test sets")
+    parser.add_argument("--systems", "-s", default='all', help="comma-separated systems")
+    parser.add_argument("--randseed", default=0, type=int, help="random seed, default=sys time")
+    args = parser.parse_args()
+    res_dir, resamples, conf = args.dir_results, args.resamples, args.confidence
+    alpha = (1 - conf/100) / 2
+    index_lo = int(alpha * (resamples - 1))
+    index_hi = resamples - 1 - index_lo
+    index_mid = int(resamples / 2)
+    if args.systems == 'all':
+        systems = os.listdir(res_dir)
+    else:
+        systems = args.systems.split(',')
+    if args.tests == 'all':
+        tests = set()
+        for system in systems:
+            tests.update(os.listdir(res_dir + '/' + system))
+        tests = sorted(tests)
+    else:
+        tests = args.tests.split(',')
+    if args.randseed:
+        random.seed(args.randseed)
+    results = []
+
+    print('Loading...', file=sys.stderr)
+    for system in systems:
+        sys_results = []
+        results.append(sys_results)
+        for i_test, test in enumerate(tests):
+            filename = '/'.join((res_dir, system, test))
+            try:
+                with open(filename) as res_file:
+                    sys_results.extend([[i_test] + list(map(int, l.split())) for l in res_file])
+            except FileNotFoundError:
+                logging.warning(filename + ' not found')
+    samples = len(sys_results)
+
+    print('Resampling...', file=sys.stderr)
+    boot_results = []
+    for i_resample in range(resamples):
+        print(i_resample + 1, file=sys.stderr, end='\r')
+        resample_results = []
+        boot_results.append(resample_results)
+        for i_system in range(len(systems)):
+            pred, gold, words, correct = ([0] * len(tests) for _ in range(4))
+            for _ in range(samples):
+                i_test, pre, gol, wor, corr = random.choice(results[i_system])
+                pred[i_test] += pre
+                gold[i_test] += gol
+                words[i_test] += wor
+                correct[i_test] += corr
+            fscore_sum = 0
+            for i_test in range(len(tests)):
+                _prec, _rec, fscore, _aligacc = prec_rec_f1(correct[i_test], pred[i_test], gold[i_test])
+                fscore_sum += fscore
+            resample_results.append(fscore_sum / len(tests))
+    print('\n', file=sys.stderr)
+
+    sys_fscores = []
+    for i_system, system in enumerate(systems):
+        sys_fscores.append([boot_results[i_resample][i_system] for i_resample in range(resamples)])
+    final_results = []
+    sys_sys_wins = [[0] * len(systems) for x in range(len(systems))]
+    for i_system, system in enumerate(systems):
+        for j_system in range(i_system):
+            for i, j in zip(sys_fscores[i_system], sys_fscores[j_system]):
+                if i > j:
+                    sys_sys_wins[i_system][j_system] += 1
+                elif i < j:
+                    sys_sys_wins[j_system][i_system] += 1
+        fscores = sorted(sys_fscores[i_system])
+        final_results.append([i_system, fscores[index_mid], fscores[index_lo], fscores[index_hi]])
+
+    sorted_systems = sorted(final_results, key=lambda x: -x[1])
+    for rank, sys_results in enumerate(sorted_systems):
+        i_system, f1_mid, f1_lo, f1_hi = sys_results
+        if rank < len(systems) - 1:
+            j_worse_sys = sorted_systems[rank + 1][0]
+            p_value = (sys_sys_wins[j_worse_sys][i_system] + 1) / (resamples + 1)
+            p_str = " p=%.3f" % p_value
+        else:
+            p_value, p_str = 1, ""
+        print("%2d. %17s %5.2f ±%5.2f (%5.2f .. %5.2f)%s" %
+              (rank + 1, systems[i_system],
+               100 * f1_mid, 50 * (f1_hi - f1_lo), 100 * f1_lo, 100 * f1_hi, p_str))
+        if p_value < (1 - conf/100):
+            print('-' * 60)
+
+
+if __name__ == "__main__":
+    main()

From c8fbca0a38e8ce741f5fda4a9b3778f186ce41a1 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 3 Apr 2018 19:19:35 +0200
Subject: [PATCH 0198/1374] add language param for AddCommas, add RemoveCommas

---
 udapi/block/tutorial/addcommas.py    | 15 ++++++++++++++-
 udapi/block/tutorial/removecommas.py | 13 +++++++++++++
 2 files changed, 27 insertions(+), 1 deletion(-)
 create mode 100644 udapi/block/tutorial/removecommas.py

diff --git a/udapi/block/tutorial/addcommas.py b/udapi/block/tutorial/addcommas.py
index ccc26a66..de707094 100644
--- a/udapi/block/tutorial/addcommas.py
+++ b/udapi/block/tutorial/addcommas.py
@@ -1,10 +1,23 @@
 """tutorial.AddCommas block template."""
 from udapi.core.block import Block
 
+# nickname = xy123
+# TODO: make up a unique nickname and edit the previous line
+# if you want your results to be listed on the NPFL070 web (under that nickname).
+# Delete the line if you don't want to listed on the web.
 
 class AddCommas(Block):
     """Heuristically insert nodes for missing commas."""
 
+    def __init__(self, language='en', **kwargs):
+        """Create the AddCommas block object.
+
+        Args:
+        `language`: which language-specific rules to use ('en' or 'cs')
+        """
+        super().__init__(**kwargs)
+        self.language = language
+
     def process_node(self, node):
         if self.should_add_comma_before(node):
             comma = node.create_child(form=',', deprel='punct', upos='PUNCT')
@@ -15,7 +28,7 @@ def should_add_comma_before(self, node):
         prev_node = node.prev_node
         if prev_node is None:
             return False
-        if prev_node.lemma == 'however':
+        if self.language == 'en' and node.lemma == 'however':
             return True
         if any(n.deprel == 'appos' for n in prev_node.children):
             return True
diff --git a/udapi/block/tutorial/removecommas.py b/udapi/block/tutorial/removecommas.py
new file mode 100644
index 00000000..a07e2bba
--- /dev/null
+++ b/udapi/block/tutorial/removecommas.py
@@ -0,0 +1,13 @@
+"""tutorial.RemoveCommas helper block."""
+from udapi.core.block import Block
+
+
+class RemoveCommas(Block):
+    """Delete all comma nodes and edit SpaceAfter and text accordingly."""
+
+    def process_tree(self, root):
+        for node in root.descendants:
+            if node.form == ",":
+                node.remove(children="rehang")
+                del node.prev_node.misc['SpaceAfter']
+        root.text = root.compute_text()

From 9a8015c3124467e3ddfad3a5d8ef569d0ab425f1 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 4 Apr 2018 11:21:31 +0200
Subject: [PATCH 0199/1374] Thai also should use compound:prt

---
 udapi/block/ud/google2ud.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/google2ud.py b/udapi/block/ud/google2ud.py
index 453bb9c0..3ba20c5c 100644
--- a/udapi/block/ud/google2ud.py
+++ b/udapi/block/ud/google2ud.py
@@ -498,7 +498,7 @@ def fix_deprel(self, node):
             if self.lang == 'fr' and node.parent.form in {'M.', 'Mme', 'Dr'}:
                 node.deprel = 'flat:name'
         elif node.deprel == 'prt':
-            if self.lang in {'en', 'de', 'nl', 'sv', 'da', 'no'}:
+            if self.lang in {'en', 'de', 'nl', 'sv', 'da', 'no', 'th'}:
                 node.deprel = 'compound:prt'
             elif self.lang == 'tr':
                 node.deprel = 'advmod:emph'

From 984a9ea5c1f98ee5aba2fea4e762bd54b953f213 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 10 Apr 2018 17:55:01 +0200
Subject: [PATCH 0200/1374] fix bug (prev_node instead of node) introduced in
 my last commit

---
 udapi/block/tutorial/addcommas.py | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/udapi/block/tutorial/addcommas.py b/udapi/block/tutorial/addcommas.py
index de707094..97677d89 100644
--- a/udapi/block/tutorial/addcommas.py
+++ b/udapi/block/tutorial/addcommas.py
@@ -10,25 +10,20 @@ class AddCommas(Block):
     """Heuristically insert nodes for missing commas."""
 
     def __init__(self, language='en', **kwargs):
-        """Create the AddCommas block object.
-
-        Args:
-        `language`: which language-specific rules to use ('en' or 'cs')
-        """
         super().__init__(**kwargs)
         self.language = language
 
     def process_node(self, node):
+        # TODO: Your task: implement some heuristics
         if self.should_add_comma_before(node):
             comma = node.create_child(form=',', deprel='punct', upos='PUNCT')
             comma.shift_before_node(node)
 
     def should_add_comma_before(self, node):
-        # TODO: Your task: implement some heuristics
         prev_node = node.prev_node
         if prev_node is None:
             return False
-        if self.language == 'en' and node.lemma == 'however':
+        if self.language == 'en' and prev_node.lemma == 'however':
             return True
         if any(n.deprel == 'appos' for n in prev_node.children):
             return True

From 6d8ef782f0e4fc47b0b4a412eecffad11b16b17c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 15 Apr 2018 17:45:51 +0200
Subject: [PATCH 0201/1374] fix edge cases in util.ResegmentGold and
 eval.Conll2018

goal: make eval.Conll2018's output more similar to the official script
---
 udapi/block/eval/conll18.py       | 66 ++++++++++++++++++-------------
 udapi/block/util/resegmentgold.py | 17 +++++++-
 2 files changed, 54 insertions(+), 29 deletions(-)

diff --git a/udapi/block/eval/conll18.py b/udapi/block/eval/conll18.py
index 97bc68aa..0df41b46 100644
--- a/udapi/block/eval/conll18.py
+++ b/udapi/block/eval/conll18.py
@@ -106,7 +106,8 @@
 class Conll18(BaseWriter):
     """Evaluate LAS, UAS, MLAS and BLEX."""
 
-    def __init__(self, gold_zone='gold', print_raw=False, print_results=True, **kwargs):
+    def __init__(self, gold_zone='gold', print_raw=False, print_results=True, print_counts=False,
+                 **kwargs):
         """Args:
         gold_zone - Which zone contains the gold-standard trees (the other zone contains "pred")?
         print_raw - Print raw counts (pred, gold, aligned, correct) for each sentence.
@@ -114,12 +115,17 @@ def __init__(self, gold_zone='gold', print_raw=False, print_results=True, **kwar
             The parameter print_raw specifies a given metric
             (UAS, LAS, MLAS, BLEX, UPOS, XPOS, Feats, Lemma) or is 0 (or False) by default.
         print_results - Print a table with overall results after all document are processed.
+        print_counts - Print counts of correct/gold/system instead of prec/rec/f1 for all metrics.
         """
         super().__init__(**kwargs)
         self.gold_zone = gold_zone
         self.total_count = Counter()
         self.print_raw = print_raw
         self.print_results = print_results
+        self.print_counts = print_counts
+
+    def _ufeats(self, feats):
+        return '|'.join(sorted(x for x in feats.split('|') if x.split('=', 1)[0] in UNIV_FEATS))
 
     def process_tree(self, tree):
         gold_tree = tree.bundle.get_tree(self.gold_zone)
@@ -135,9 +141,10 @@ def process_tree(self, tree):
             edit, pred_lo, pred_hi, gold_lo, gold_hi = diff
             if edit == 'equal':
                 aligned.extend(zip(pred_nodes[pred_lo:pred_hi], gold_nodes[gold_lo:gold_hi]))
-        align_map = {tree: gold_tree}
+        align_map, feats_match = {tree: gold_tree}, {}
         for p_node, g_node in aligned:
             align_map[p_node] = g_node
+            feats_match[p_node] = self._ufeats(str(p_node.feats)) == self._ufeats(str(g_node.feats))
 
         count = Counter()
         count['pred'] = len(pred_nodes)
@@ -148,9 +155,10 @@ def process_tree(self, tree):
         count['alig_cont'] = len([n for _, n in aligned if n.udeprel in CONTENT])
 
         for p_node, g_node in aligned:
-            for attr in ('UPOS', 'XPOS', 'Feats', 'Lemma'):
-                if p_node.get_attrs([attr.lower()]) == g_node.get_attrs([attr.lower()]):
-                    count[attr] += 1
+            count['UPOS'] += 1 if p_node.upos == g_node.upos else 0
+            count['XPOS'] += 1 if p_node.xpos == g_node.xpos else 0
+            count['Lemmas'] += 1 if g_node.lemma == '_' or p_node.lemma == g_node.lemma else 0
+            count['UFeats'] += 1 if feats_match[p_node] else 0
             if align_map.get(p_node.parent) == g_node.parent:
                 count['UAS'] += 1
                 if p_node.udeprel == g_node.udeprel:
@@ -159,7 +167,7 @@ def process_tree(self, tree):
                         count['CLAS'] += 1
                         if g_node.lemma == '_' or g_node.lemma == p_node.lemma:
                             count['BLEX'] += 1
-                        if self._morpho_match(p_node, g_node, align_map):
+                        if self._morpho_match(p_node, g_node, align_map, feats_match):
                             count['MLAS'] += 1
         self.total_count.update(count)
 
@@ -171,24 +179,20 @@ def process_tree(self, tree):
                 scores = [str(count[s]) for s in ('pred', 'gold', 'Words', self.print_raw)]
             print(' '.join(scores))
 
-    def _morpho_match(self, p_node, g_node, align_map, check_children=True):
-        if p_node.upos != g_node.upos:
+    def _morpho_match(self, p_node, g_node, align_map, feats_match):
+        if p_node.upos != g_node.upos or not feats_match[p_node]:
+            return False
+        p_children = [c for c in p_node.children if c.udeprel in FUNCTIONAL]
+        g_children = [c for c in g_node.children if c.udeprel in FUNCTIONAL]
+        if len(p_children) != len(g_children):
             return False
-        for feat in UNIV_FEATS:
-            if p_node.feats[feat] != g_node.feats[feat]:
+        for p_child, g_child in zip(p_children, g_children):
+            if align_map.get(p_child) != g_child:
                 return False
-        if check_children:
-            p_children = [c for c in p_node.children if c.udeprel in FUNCTIONAL]
-            g_children = [c for c in g_node.children if c.udeprel in FUNCTIONAL]
-            if len(p_children) != len(g_children):
+            if p_child.udeprel != g_child.udeprel:
+                return False
+            if p_child.upos != g_child.upos or not feats_match[p_child]:
                 return False
-            for p_child, g_child in zip(p_children, g_children):
-                if align_map.get(p_child) != g_child:
-                    return False
-                if p_child.udeprel != g_child.udeprel:
-                    return False
-                if not self._morpho_match(p_child, g_child, None, check_children=False):
-                    return False
         return True
 
     def process_end(self):
@@ -198,20 +202,28 @@ def process_end(self):
         # Redirect the default filehandle to the file specified by self.files
         self.before_process_document(None)
 
-        metrics = ('Words', 'UPOS', 'XPOS', 'Feats', 'Lemma', 'UAS', 'LAS', 'CLAS', 'BLEX', 'MLAS')
-        print("Metric     | Precision |    Recall |  F1 Score | AligndAcc")
+        metrics = ('Words', 'UPOS', 'XPOS', 'UFeats', 'Lemmas', 'UAS', 'LAS', 'CLAS', 'MLAS', 'BLEX')
+        if self.print_counts:
+            print("Metric     | Correct   |      Gold | Predicted | Aligned")
+        else:
+            print("Metric     | Precision |    Recall |  F1 Score | AligndAcc")
         print("-----------+-----------+-----------+-----------+-----------")
         for metric in metrics:
+            correct = self.total_count[metric]
             if metric in {'CLAS', 'BLEX', 'MLAS'}:
                 pred, gold = self.total_count['pred_cont'], self.total_count['gold_cont']
                 alig = self.total_count['alig_cont']
             else:
                 pred, gold = self.total_count['pred'], self.total_count['gold']
                 alig = self.total_count['Words']
-            correct = self.total_count[metric]
-            precision, recall, fscore, alignacc = prec_rec_f1(correct, pred, gold, alig)
-            print("{:11}|{:10.2f} |{:10.2f} |{:10.2f} |{:10.2f}".format(
-                metric, 100 * precision, 100 * recall, 100 * fscore, 100 * alignacc))
+            if self.print_counts:
+                print("{:11}|{:10} |{:10} |{:10} |{:10}".format(
+                    metric, correct, gold, pred, alig))
+            else:
+                precision, recall, fscore, alignacc = prec_rec_f1(correct, pred, gold, alig)
+                alignacc = "{:10.2f}".format(100 * alignacc) if metric != 'Words' else ""
+                print("{:11}|{:10.2f} |{:10.2f} |{:10.2f} |{}".format(
+                    metric, 100 * precision, 100 * recall, 100 * fscore, alignacc))
 
 
 def prec_rec_f1(correct, pred, gold, alig=0):
diff --git a/udapi/block/util/resegmentgold.py b/udapi/block/util/resegmentgold.py
index 39ebe6e9..654ec524 100644
--- a/udapi/block/util/resegmentgold.py
+++ b/udapi/block/util/resegmentgold.py
@@ -76,9 +76,22 @@ def process_document(self, document):
                             words.extend(token.words)
                         else:
                             words.append(token)
+                    next_p_subroot = None
+                    for word in words:
+                        if word.parent == word.root:
+                            next_p_subroot = word
+                        if word.deprel.startswith('wrong-'):
+                            word.deprel = word.deprel[6:]
                     next_p_tree.steal_nodes(words)
                     self.choose_root(p_tree, g_tree)
-                    self.choose_root(next_p_tree, document.bundles[bundle_no + 1].trees[0])
+                    next_p_subroots = next_p_tree.children
+                    if len(next_p_subroots) > 1:
+                        if next_p_subroot:
+                            for false_subroot in (n for n in next_p_subroots if n != next_p_subroot):
+                                false_subroot.parent = next_p_subroot
+                                false_subroot.deprel = 'wrong-' + false_subroot.deprel
+                        else:
+                            self.choose_root(next_p_tree, document.bundles[bundle_no + 1].trees[0])
                     pred_trees.append(next_p_tree)
                     bundle.add_tree(p_tree)
                     break
@@ -107,7 +120,7 @@ def choose_root(p_tree, g_tree):
         """Prevent multiple roots, which are forbidden in the evaluation script."""
         p_subroots = p_tree.children
         if len(p_subroots) > 1:
-            g_subroot_form = g_tree.children[0]
+            g_subroot_form = g_tree.children[0].form
             p_subroot = next((n for n in p_subroots if n.form == g_subroot_form), p_subroots[0])
             for false_subroot in (n for n in p_subroots if n != p_subroot):
                 false_subroot.parent = p_subroot

From 9f4730748705c8c1fbc5de569829fd94f7a0a156 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 16 Apr 2018 02:03:44 +0200
Subject: [PATCH 0202/1374] util.ResegmentGold should not change any deprel

it should use `misc['Rehanged']` instead to mark nodes
which should not be counted as correct in UAS etc.
even if they have the correct parent.
---
 udapi/block/eval/conll18.py       |  4 +--
 udapi/block/util/resegmentgold.py | 48 ++++++++++++++++---------------
 2 files changed, 27 insertions(+), 25 deletions(-)

diff --git a/udapi/block/eval/conll18.py b/udapi/block/eval/conll18.py
index 0df41b46..70e6de24 100644
--- a/udapi/block/eval/conll18.py
+++ b/udapi/block/eval/conll18.py
@@ -159,7 +159,7 @@ def process_tree(self, tree):
             count['XPOS'] += 1 if p_node.xpos == g_node.xpos else 0
             count['Lemmas'] += 1 if g_node.lemma == '_' or p_node.lemma == g_node.lemma else 0
             count['UFeats'] += 1 if feats_match[p_node] else 0
-            if align_map.get(p_node.parent) == g_node.parent:
+            if align_map.get(p_node.parent) == g_node.parent and not p_node.misc['Rehanged']:
                 count['UAS'] += 1
                 if p_node.udeprel == g_node.udeprel:
                     count['LAS'] += 1
@@ -182,7 +182,7 @@ def process_tree(self, tree):
     def _morpho_match(self, p_node, g_node, align_map, feats_match):
         if p_node.upos != g_node.upos or not feats_match[p_node]:
             return False
-        p_children = [c for c in p_node.children if c.udeprel in FUNCTIONAL]
+        p_children = [c for c in p_node.children if c.udeprel in FUNCTIONAL and not c.misc['Rehanged']]
         g_children = [c for c in g_node.children if c.udeprel in FUNCTIONAL]
         if len(p_children) != len(g_children):
             return False
diff --git a/udapi/block/util/resegmentgold.py b/udapi/block/util/resegmentgold.py
index 654ec524..454eae79 100644
--- a/udapi/block/util/resegmentgold.py
+++ b/udapi/block/util/resegmentgold.py
@@ -22,6 +22,10 @@ def process_document(self, document):
         if not document.bundles:
             return
         pred_trees = self.extract_pred_trees(document)
+        was_subroot = set()
+        for pred_tree in pred_trees:
+            for n in pred_tree.children:
+                was_subroot.add(n)
 
         for bundle_no, bundle in enumerate(document.bundles):
             g_tree = bundle.trees[0]
@@ -33,13 +37,16 @@ def process_document(self, document):
                 continue
 
             # Make sure that p_tree contains enough nodes.
+            moved_roots = []
             while len(p_chars) < len(g_chars):
                 if not pred_trees:
                     raise ValueError('no pred_trees:\n%s\n%s' % (p_chars, g_chars))
                 new_p_tree = pred_trees.pop()
                 p_chars += ''.join(t.form for t in new_p_tree.token_descendants).replace(' ', '')
+                moved_roots.extend(new_p_tree.children)
                 p_tree.steal_nodes(new_p_tree.descendants)
-            self.choose_root(p_tree, g_tree)
+            self.choose_root(p_tree, was_subroot, g_tree)
+
             if not p_chars.startswith(g_chars):
                 raise ValueError('sent_id=%s: !p_chars.startswith(g_chars):\np_chars=%s\ng_chars=%s'
                                  % (g_tree.sent_id, p_chars, g_chars))
@@ -61,7 +68,8 @@ def process_document(self, document):
                     if index + 1 == len(tokens):
                         next_p_tree = Root(zone=p_tree.zone)
                         pred_trees.append(next_p_tree)
-                        next_p_tree.create_child(deprel='wrong', form=p_chars[len(g_chars):])
+                        next_p_tree.create_child(deprel='wrong', form=p_chars[len(g_chars):],
+                                                 misc='Rehanged=Yes')
                         bundle.add_tree(p_tree)
                         break
                     else:
@@ -76,22 +84,12 @@ def process_document(self, document):
                             words.extend(token.words)
                         else:
                             words.append(token)
-                    next_p_subroot = None
                     for word in words:
-                        if word.parent == word.root:
-                            next_p_subroot = word
-                        if word.deprel.startswith('wrong-'):
-                            word.deprel = word.deprel[6:]
+                        if word in was_subroot:
+                            del word.misc['Rehanged']
                     next_p_tree.steal_nodes(words)
-                    self.choose_root(p_tree, g_tree)
-                    next_p_subroots = next_p_tree.children
-                    if len(next_p_subroots) > 1:
-                        if next_p_subroot:
-                            for false_subroot in (n for n in next_p_subroots if n != next_p_subroot):
-                                false_subroot.parent = next_p_subroot
-                                false_subroot.deprel = 'wrong-' + false_subroot.deprel
-                        else:
-                            self.choose_root(next_p_tree, document.bundles[bundle_no + 1].trees[0])
+                    self.choose_root(p_tree, was_subroot, g_tree)
+                    self.choose_root(next_p_tree, was_subroot, document.bundles[bundle_no + 1].trees[0])
                     pred_trees.append(next_p_tree)
                     bundle.add_tree(p_tree)
                     break
@@ -116,12 +114,16 @@ def extract_pred_trees(self, document):
         return pred_trees
 
     @staticmethod
-    def choose_root(p_tree, g_tree):
+    def choose_root(p_tree, was_subroot, g_tree):
         """Prevent multiple roots, which are forbidden in the evaluation script."""
-        p_subroots = p_tree.children
-        if len(p_subroots) > 1:
+        possible_subroots = [n for n in p_tree.children if n in was_subroot]
+        if possible_subroots:
             g_subroot_form = g_tree.children[0].form
-            p_subroot = next((n for n in p_subroots if n.form == g_subroot_form), p_subroots[0])
-            for false_subroot in (n for n in p_subroots if n != p_subroot):
-                false_subroot.parent = p_subroot
-                false_subroot.deprel = 'wrong-' + false_subroot.deprel
+            the_subroot = next((n for n in possible_subroots if n.form == g_subroot_form), possible_subroots[0])
+        else:
+            the_subroot = p_tree.children[0]
+            the_subroot.misc['Rehanged'] = 'Yes'
+        for subroot in p_tree.children:
+            if subroot is not the_subroot:
+                subroot.parent = the_subroot
+                subroot.misc['Rehanged'] = 'Yes'

From 8ca27c47b6b681c49151f9acaeac2804ad597ba1 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 16 Apr 2018 16:32:57 +0200
Subject: [PATCH 0203/1374] add nickname to hw templates

---
 udapi/block/tutorial/addarticles.py | 4 ++++
 udapi/block/tutorial/parse.py       | 8 ++++++++
 2 files changed, 12 insertions(+)

diff --git a/udapi/block/tutorial/addarticles.py b/udapi/block/tutorial/addarticles.py
index 20a4295f..96f0ba2f 100644
--- a/udapi/block/tutorial/addarticles.py
+++ b/udapi/block/tutorial/addarticles.py
@@ -1,4 +1,8 @@
 """tutorial.AddArticles block template."""
+# nickname = xy123
+# TODO: make up a unique nickname and edit the previous line
+# if you want your results to be listed on the NPFL070 web (under that nickname).
+# Delete the line if you don't want to listed on the web.
 from udapi.core.block import Block
 
 class AddArticles(Block):
diff --git a/udapi/block/tutorial/parse.py b/udapi/block/tutorial/parse.py
index 77928782..db732a12 100644
--- a/udapi/block/tutorial/parse.py
+++ b/udapi/block/tutorial/parse.py
@@ -9,11 +9,19 @@
       util.MarkDiff gold_zone=gold \
       write.TextModeTreesHtml marked_only=1 files=parse-diff.html
 """
+# nickname = xy123
+# TODO: make up a unique nickname and edit the previous line
+# if you want your results to be listed on the NPFL070 web (under that nickname).
+# Delete the line if you don't want to listed on the web.
 from udapi.core.block import Block
 
 class Parse(Block):
     """Dependency parsing."""
 
+    def __init__(self, language='en', **kwargs):
+        super().__init__(**kwargs)
+        self.language = language
+
     def process_tree(self, root):
         # TODO: Your task: implement a better heuristics than "right chain"
         for node in root.descendants:

From d3efc9e0ba7cc6463f7e81b0990bd8372b745248 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 17 Apr 2018 17:56:29 +0200
Subject: [PATCH 0204/1374] fix an edge case with the same form roots

Two clauses (merged into one sentence in the gold data)
may have the same subroot word form.
Luke 9,48
---
 udapi/block/util/resegmentgold.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/udapi/block/util/resegmentgold.py b/udapi/block/util/resegmentgold.py
index 454eae79..2af649ca 100644
--- a/udapi/block/util/resegmentgold.py
+++ b/udapi/block/util/resegmentgold.py
@@ -118,8 +118,11 @@ def choose_root(p_tree, was_subroot, g_tree):
         """Prevent multiple roots, which are forbidden in the evaluation script."""
         possible_subroots = [n for n in p_tree.children if n in was_subroot]
         if possible_subroots:
-            g_subroot_form = g_tree.children[0].form
-            the_subroot = next((n for n in possible_subroots if n.form == g_subroot_form), possible_subroots[0])
+            the_subroot = possible_subroots[0]
+            g_subroot = g_tree.children[0]
+            possible_subroots = sorted([n for n in possible_subroots if n.form == g_subroot.form],
+                                       key=lambda n: abs(n.ord - g_subroot.ord))
+            the_subroot = possible_subroots[0] if possible_subroots else the_subroot
         else:
             the_subroot = p_tree.children[0]
             the_subroot.misc['Rehanged'] = 'Yes'

From a2acdec90fad67bc5efac4e16dd584cff83b7a80 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 17 Apr 2018 18:53:19 +0200
Subject: [PATCH 0205/1374] eval.conll18 reports AllTags

and is more similar to the official evaluation script
---
 udapi/block/eval/conll18.py       | 9 +++++++--
 udapi/block/util/resegmentgold.py | 7 +++++++
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/udapi/block/eval/conll18.py b/udapi/block/eval/conll18.py
index 70e6de24..72612832 100644
--- a/udapi/block/eval/conll18.py
+++ b/udapi/block/eval/conll18.py
@@ -11,6 +11,7 @@
 
     $ udapy read.Conllu zone=gold files=gold.conllu \
             read.Conllu zone=pred files=pred.conllu ignore_sent_id=1 \
+            util.ResegmentGold \
             eval.Conll18
     Metric     | Precision |    Recall |  F1 Score | AligndAcc
     -----------+-----------+-----------+-----------+-----------
@@ -159,6 +160,8 @@ def process_tree(self, tree):
             count['XPOS'] += 1 if p_node.xpos == g_node.xpos else 0
             count['Lemmas'] += 1 if g_node.lemma == '_' or p_node.lemma == g_node.lemma else 0
             count['UFeats'] += 1 if feats_match[p_node] else 0
+            if feats_match[p_node] and p_node.upos == g_node.upos and p_node.xpos == g_node.xpos:
+                count['AllTags'] += 1
             if align_map.get(p_node.parent) == g_node.parent and not p_node.misc['Rehanged']:
                 count['UAS'] += 1
                 if p_node.udeprel == g_node.udeprel:
@@ -168,7 +171,8 @@ def process_tree(self, tree):
                         if g_node.lemma == '_' or g_node.lemma == p_node.lemma:
                             count['BLEX'] += 1
                         if self._morpho_match(p_node, g_node, align_map, feats_match):
-                            count['MLAS'] += 1
+                            if not p_node.misc['FuncChildMissing']:
+                                count['MLAS'] += 1
         self.total_count.update(count)
 
         if self.print_raw:
@@ -202,7 +206,8 @@ def process_end(self):
         # Redirect the default filehandle to the file specified by self.files
         self.before_process_document(None)
 
-        metrics = ('Words', 'UPOS', 'XPOS', 'UFeats', 'Lemmas', 'UAS', 'LAS', 'CLAS', 'MLAS', 'BLEX')
+        metrics = ('Words', 'UPOS', 'XPOS', 'UFeats', 'AllTags',
+                   'Lemmas', 'UAS', 'LAS', 'CLAS', 'MLAS', 'BLEX')
         if self.print_counts:
             print("Metric     | Correct   |      Gold | Predicted | Aligned")
         else:
diff --git a/udapi/block/util/resegmentgold.py b/udapi/block/util/resegmentgold.py
index 2af649ca..d1499cb7 100644
--- a/udapi/block/util/resegmentgold.py
+++ b/udapi/block/util/resegmentgold.py
@@ -4,6 +4,7 @@
 from udapi.core.mwt import MWT
 from udapi.core.root import Root
 
+FUNCTIONAL = {'aux', 'cop', 'mark', 'det', 'clf', 'case', 'cc'}
 
 class ResegmentGold(Block):
     """Sentence-align two zones (gold and pred) and resegment the pred zone.
@@ -87,6 +88,12 @@ def process_document(self, document):
                     for word in words:
                         if word in was_subroot:
                             del word.misc['Rehanged']
+                        if word.parent is not p_tree and word.parent not in words:
+                            if word.udeprel in FUNCTIONAL:
+                                word.parent.misc['FuncChildMissing'] = 'Yes'
+                        for child in word.children:
+                            if child not in words and child.udeprel in FUNCTIONAL:
+                                word.misc['FuncChildMissing'] = 'Yes'
                     next_p_tree.steal_nodes(words)
                     self.choose_root(p_tree, was_subroot, g_tree)
                     self.choose_root(next_p_tree, was_subroot, document.bundles[bundle_no + 1].trees[0])

From 50522c20c33ddeacfd326c8afeb4198cb9a8d728 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 3 May 2018 16:12:12 +0200
Subject: [PATCH 0206/1374] minor edit

---
 udapi/block/util/resegmentgold.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/util/resegmentgold.py b/udapi/block/util/resegmentgold.py
index d1499cb7..a93f01f4 100644
--- a/udapi/block/util/resegmentgold.py
+++ b/udapi/block/util/resegmentgold.py
@@ -122,7 +122,7 @@ def extract_pred_trees(self, document):
 
     @staticmethod
     def choose_root(p_tree, was_subroot, g_tree):
-        """Prevent multiple roots, which are forbidden in the evaluation script."""
+        """Prevent multiple roots, which are forbidden in CoNLL-U."""
         possible_subroots = [n for n in p_tree.children if n in was_subroot]
         if possible_subroots:
             the_subroot = possible_subroots[0]

From 812cd0f71a5667733b8cbbf756ac5aba12f04d84 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 3 May 2018 16:13:41 +0200
Subject: [PATCH 0207/1374] update usage in demo (filename->files)

fixes #48
---
 demo/python-demo.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/demo/python-demo.sh b/demo/python-demo.sh
index aefa17cf..d83e51d9 100755
--- a/demo/python-demo.sh
+++ b/demo/python-demo.sh
@@ -3,4 +3,4 @@
 export PATH=../bin:$PATH
 export PYTHONPATH=../:$PYTHONPATH
 
-udapy read.Conllu filename=en-sample.conllu demo.RehangPrepositions write.Conllu > prepositions-up.conllu
+udapy read.Conllu files=en-sample.conllu demo.RehangPrepositions write.Conllu > prepositions-up.conllu

From 6b7e808538754638971cba49f56a69be207ce6fd Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 31 May 2018 22:06:18 +0200
Subject: [PATCH 0208/1374] allow to specify encoding for stdin

---
 udapi/core/files.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/core/files.py b/udapi/core/files.py
index 523fe303..7a711dfe 100644
--- a/udapi/core/files.py
+++ b/udapi/core/files.py
@@ -1,6 +1,7 @@
 """Files is a helper class for iterating over filenames."""
 
 import glob
+import io
 import sys
 import os.path
 import bz2
@@ -109,7 +110,7 @@ def next_filehandle(self):
         if filename is None:
             fhandle = None
         elif filename == '-':
-            fhandle = sys.stdin
+            fhandle = io.TextIOWrapper(sys.stdin.buffer, encoding=self.encoding)
         elif filename == '<filehandle_input>':
             fhandle = self.filehandle
         else:

From 4d7c87f0672d809f0367f6cf6eefb90a746b51e5 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 31 May 2018 22:07:09 +0200
Subject: [PATCH 0209/1374] ignore BOM when reading utf8 files

Windows editors like to include BOM although it is deprecated for UTF8.
Ignoring BOM is better than throwing an error and suggesting Windows
users (or anyone who has such BOM files) to use
sed -i '1s/^\xEF\xBB\xBF//' file.conllu

When writing conllu, we won't insert BOM, of course.
---
 udapi/core/basereader.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 9e3b6488..b5e159a2 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -12,7 +12,7 @@ class BaseReader(Block):
     """Base class for all reader blocks."""
 
     # pylint: disable=too-many-arguments
-    def __init__(self, files='-', filehandle=None, zone='keep', bundles_per_doc=0, encoding='utf-8',
+    def __init__(self, files='-', filehandle=None, zone='keep', bundles_per_doc=0, encoding='utf-8-sig',
                  sent_id_filter=None, split_docs=False, ignore_sent_id=False, **kwargs):
         super().__init__(**kwargs)
         if filehandle is not None:

From 471578e011799805a28cb3abc3078565a6240240 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 1 Jun 2018 01:32:19 +0200
Subject: [PATCH 0210/1374] getter should not change sent_id

`root._bundle` can be None only when loading/creating a tree.
During that process someone may call `node.address()`
(e.g. via `node.__str__` in a debug prints or warnings).
But `node.address()` calls `node.root.address()`
and that calls `root.sent_id` getter.
If this getter sets `root._sent_id` to `'?' + zone`,
the loading may fail with strange unexpected results,
because the loading uses `root._sent_id` when loading CoNLL-U
which contains sent_id in comments,
but having all sent_id='?' results in adding all trees into the same
bundle and failing that a tree with zone '?' already exists
in that bundle.
---
 udapi/core/root.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/core/root.py b/udapi/core/root.py
index ae259718..7944cd55 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -48,7 +48,7 @@ def sent_id(self):
         if self._bundle is not None:
             self._sent_id = self._bundle.address() + zone
         else:
-            self._sent_id = '?' + zone
+            return '?' + zone
         return self._sent_id
 
     @sent_id.setter

From 5918fbd4e084e38a14641123c923d3efa4d0d9d7 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 1 Jun 2018 02:14:04 +0200
Subject: [PATCH 0211/1374] an option to "fix" cycles in CoNLL-U by attaching
 to root

Usage:
cat with_cycles.conllu | udapy -s read.Conllu fix_cycles=1 > fixed.conllu

Of course, this is not the proper correction, just a work-around
(UD guidelines do not allow multiple nodes attached to root).
This is useful e.g. when you don't have time to fix the cycles manually
and just want to extract some info from the invalid conllu.
This way at least you can load the file into Udapi
and e.g. try to fix the multiple roots automatically
or detect if there are any other problems.
---
 udapi/block/read/conllu.py | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index a2fd0406..1b3383fb 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -18,7 +18,7 @@
 class Conllu(BaseReader):
     """A reader of the CoNLL-U files."""
 
-    def __init__(self, strict=False, separator='tab', empty_parent='warn',
+    def __init__(self, strict=False, separator='tab', empty_parent='warn', fix_cycles=False,
                  attributes='ord,form,lemma,upos,xpos,feats,head,deprel,deps,misc', **kwargs):
         """Create the Conllu reader object.
 
@@ -54,6 +54,7 @@ def __init__(self, strict=False, separator='tab', empty_parent='warn',
         self.strict = strict
         self.separator = separator
         self.empty_parent = empty_parent
+        self.fix_cycles = fix_cycles
 
     @staticmethod
     def parse_comment_line(line, root):
@@ -174,6 +175,13 @@ def read_tree(self):
         for node_ord, node in enumerate(nodes[1:], 1):
             try:
                 node.parent = nodes[parents[node_ord]]
+            # TODO add a special Exception class for cycles
+            except ValueError as e:
+                if self.fix_cycles:
+                    logging.warning("Ignoring a cycle (attaching to the root instead):\n%s", e)
+                    node.parent = root
+                else:
+                    raise
             except IndexError:
                 raise ValueError("Node %s HEAD is out of range (%d)" % (node, parents[node_ord]))
 

From de8d5294f77c76c6ef7a55ffadb56bb4d82a281c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 12 Jun 2018 15:27:59 +0200
Subject: [PATCH 0212/1374] Let UDPipe ignore trees with no nodes

fixes #49
---
 udapi/tool/udpipe.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/udapi/tool/udpipe.py b/udapi/tool/udpipe.py
index 8fe024c7..5d17ae97 100644
--- a/udapi/tool/udpipe.py
+++ b/udapi/tool/udpipe.py
@@ -22,14 +22,17 @@ def __init__(self, model):
 
     def tag_parse_tree(self, root):
         """Tag (+lemmatize, fill FEATS) and parse a tree (already tokenized)."""
+        descendants = root.descendants
+        if not descendants:
+            return
         pipeline = Pipeline(self.tool, 'horizontal', Pipeline.DEFAULT, Pipeline.DEFAULT, 'conllu')
-        in_data = " ".join([n.form for n in root.descendants])
+        in_data = " ".join([n.form for n in descendants])
         out_data = pipeline.process(in_data, self.error)
         if self.error.occurred():
             raise IOError("UDPipe error " + self.error.message)
         self.conllu_reader.files.filehandle = io.StringIO(out_data)
         parsed_root = self.conllu_reader.read_tree()
-        nodes = [root] + root.descendants
+        nodes = [root] + descendants
         for parsed_node in parsed_root.descendants:
             node = nodes[parsed_node.ord]
             node.parent = nodes[parsed_node.parent.ord]

From f41031def5a4a9bd3646c2d9d3ad2e7ed63a023f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 12 Jun 2018 16:03:55 +0200
Subject: [PATCH 0213/1374] options how to handle empty lines/trees

read.Sentences ignore_empty_lines=1 # skip empty lines in the input

All Udapi blocks now also have parameter `if_empty_tree`,
with possible values: process (default), skip, skip_warn, fail, delete.
---
 udapi/block/read/sentences.py | 12 ++++++++++++
 udapi/core/block.py           | 25 +++++++++++++++++++++++--
 2 files changed, 35 insertions(+), 2 deletions(-)

diff --git a/udapi/block/read/sentences.py b/udapi/block/read/sentences.py
index 14840a50..c3a02ddd 100644
--- a/udapi/block/read/sentences.py
+++ b/udapi/block/read/sentences.py
@@ -6,6 +6,10 @@
 class Sentences(BaseReader):
     """A reader for plain-text sentences (one sentence per line) files."""
 
+    def __init__(self, ignore_empty_lines=False, **kwargs):
+        self.ignore_empty_lines = ignore_empty_lines
+        super().__init__(**kwargs)
+
     @staticmethod
     def is_multizone_reader():
         """Can this reader read bundles which contain more zones?.
@@ -18,8 +22,16 @@ def read_tree(self, document=None):
         if self.filehandle is None:
             return None
         line = self.filehandle.readline()
+        # if readline() returns an empty string, the end of the file has been
+        # reached, while a blank line is represented by '\n'
+        # (or '\r\n' if reading a Windows file on Unix machine).
         if line == '':
             return None
+        if self.ignore_empty_lines:
+            while line in {'\n', '\r\n'}:
+                line = self.filehandle.readline()
+                if line == '':
+                    return None
         root = Root()
         root.text = line.rstrip()
         return root
diff --git a/udapi/core/block.py b/udapi/core/block.py
index 4ddbaf2b..67c299f0 100644
--- a/udapi/core/block.py
+++ b/udapi/core/block.py
@@ -3,10 +3,17 @@
 
 
 class Block(object):
-    """The smallest processing unit for processing Universal Dependencies data."""
+    """The smallest processing unit for processing Universal Dependencies data.
 
-    def __init__(self, zones='all'):
+    Parameters:
+    zones: which zone to process (default="all")
+    if_empty_tree: what to do when encountering a tree with no nodes.
+        Possible values are: process (default), skip, skip_warn, fail, delete.
+    """
+
+    def __init__(self, zones='all', if_empty_tree='process'):
         self.zones = zones
+        self.if_empty_tree = if_empty_tree
 
     def process_start(self):
         """A hook method that is executed before processing UD data"""
@@ -52,6 +59,20 @@ def after_process_document(self, document):
         pass
 
     def _should_process_tree(self, tree):
+        if self.if_empty_tree != 'process' and not tree.descendants:
+            if self.if_empty_tree == 'skip':
+                return False
+            elif self.if_empty_tree == 'delete':
+                tree.remove()
+                return False
+            elif self.if_empty_tree == 'skip_warn':
+                logging.warning("Tree %s is empty", tree)
+                return False
+            elif self.if_empty_tree == 'fail':
+                raise Exception("Tree %s is empty" % tree)
+            else:
+                raise ValueError("Unknown value for if_empty_tree: "
+                                 + self.if_empty_tree)
         if self.zones == 'all':
             return True
         if self.zones == '' and tree.zone == '':

From c8741af269105023564ccfe4c0f2509eedd824f2 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 23 Jun 2018 01:11:28 +0200
Subject: [PATCH 0214/1374] fix url of FileSaver.min.js

---
 udapi/block/write/html.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/write/html.py b/udapi/block/write/html.py
index b06c971a..148b29ee 100644
--- a/udapi/block/write/html.py
+++ b/udapi/block/write/html.py
@@ -14,7 +14,7 @@ class Html(BaseWriter):
     For offline use, we need to download first three JavaScript libraries::
 
       wget https://code.jquery.com/jquery-2.1.4.min.js
-      wget https://cdn.rawgit.com/eligrey/FileSaver.js/master/FileSaver.min.js
+      wget https://cdn.rawgit.com/eligrey/FileSaver.js/1.3.4r/FileSaver.min.js
       wget https://cdn.rawgit.com/ufal/js-treex-view/gh-pages/js-treex-view.js
       udapy write.Html path_to_js=. < file.conllu > file.html
       firefox file.html
@@ -65,7 +65,7 @@ def __init__(self, path_to_js='web', **kwargs):
     def process_document(self, doc):
         if self.path_to_js == 'web':
             jquery = 'https://code.jquery.com/jquery-2.1.4.min.js'
-            fsaver = 'https://cdn.rawgit.com/eligrey/FileSaver.js/master/FileSaver.min.js'
+            fsaver = 'https://cdn.rawgit.com/eligrey/FileSaver.js/1.3.4/FileSaver.min.js'
             js_t_v = 'https://cdn.rawgit.com/ufal/js-treex-view/gh-pages/js-treex-view.js'
         else:
             jquery = self.path_to_js + '/jquery-2.1.4.min.js'

From 3814dd2ef06fb33d3b384db327f2c698660e1d2d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 25 Jun 2018 00:10:58 +0200
Subject: [PATCH 0215/1374] write.Tikz as_tree=1

---
 udapi/block/write/tikz.py | 58 +++++++++++++++++++++++++++++++--------
 1 file changed, 47 insertions(+), 11 deletions(-)

diff --git a/udapi/block/write/tikz.py b/udapi/block/write/tikz.py
index 19480e23..802487b5 100644
--- a/udapi/block/write/tikz.py
+++ b/udapi/block/write/tikz.py
@@ -10,6 +10,8 @@ class Tikz(BaseWriter):
     Usage::
 
       udapy write.Tikz < my.conllu > my.tex
+      # or for 2D tree-like rendering
+      udapy write.Tikz as_tree=1 < my.conllu > my.tex
       pdflatex my.tex
       xdg-open my.pdf
 
@@ -26,13 +28,18 @@ class Tikz(BaseWriter):
     <http://mirrors.ctan.org/graphics/pgf/contrib/tikz-dependency/tikz-dependency-doc.pdf>`_
     for details.
 
+    With ``as_tree=1``, there are two options how to visualize deprels:
+    either as labels positioned on the edges by uncommenting the relevant style definition,
+    or by adding ``deprel`` to the list of attributes, so deprels are above/below the words.
+    The latter is the default because the edge labels need manual tweaks to prevent overlapping.
+
     Alternatives:
     * use `write.TextModeTrees` and include it in verbatim environment in LaTeX.
     * use `write.Html`, press "Save as SVG" button, convert to pdf and include in LaTeX.
     """
 
     def __init__(self, print_sent_id=True, print_text=True, print_preambule=True,
-                 attributes='form,upos', **kwargs):
+                 attributes=None, as_tree=False, **kwargs):
         """Create the Tikz block object.
 
         Args:
@@ -46,15 +53,31 @@ def __init__(self, print_sent_id=True, print_text=True, print_preambule=True,
         self.print_sent_id = print_sent_id
         self.print_text = print_text
         self.print_preambule = print_preambule
-        self.node_attributes = attributes.split(',')
+        if attributes is not None:
+           self.node_attributes = attributes.split(',')
+        elif as_tree:
+            self.node_attributes = 'form,upos,deprel'.split(',')
+        else:
+            self.node_attributes = 'form,upos'.split(',')
+        self.as_tree = as_tree
 
     def before_process_document(self, doc):
         super().before_process_document(doc)
         if self.print_preambule:
-            print(r'\documentclass{article}')
+            print(r'\documentclass[multi=dependency]{standalone}')
             print(r'\usepackage[T1]{fontenc}')
             print(r'\usepackage[utf8]{inputenc}')
             print(r'\usepackage{tikz-dependency}')
+            if self.as_tree:
+                print(r'\tikzset{depedge/.style = {blue,thick}, %,<-')
+                print(r'  deplabel/.style = {opacity=0, %black, fill opacity=0.9, text opacity=1,')
+                print(r'   % yshift=4pt, pos=0.1, inner sep=0, fill=white, font={\scriptsize}')
+                print(r'  },')
+                print(r'  depnode/.style = {draw,circle,fill,blue,inner sep=1.5pt},')
+                print(r'  depguide/.style = {dashed,gray},')
+                print(r'}')
+                print(r'\newlength{\deplevel}\setlength{\deplevel}{8mm}')
+                print(r'\newlength{\depskip}\setlength{\depskip}{4mm}')
             print(r'\begin{document}')
 
     def after_process_document(self, doc):
@@ -81,8 +104,7 @@ def process_tree(self, tree):
 
         lines = ['' for _ in self.node_attributes]
         for node in nodes:
-            values = [str(getattr(node, attr_name)) for attr_name in self.node_attributes]
-            values = [v if v != '_' else r'\_' for v in values]
+            values = [v.replace('_', r'\_') for v in node.get_attrs(self.node_attributes)]
             max_len = max(len(value) for value in values)
             for index, value in enumerate(values):
                 if node.ord > 1:
@@ -91,10 +113,24 @@ def process_tree(self, tree):
         for line in lines:
             print(line + r' \\')
         print(r'\end{deptext}')
-        for node in nodes:
-            if node.parent.is_root():
-                print(r'\deproot{%d}{root}' % node.ord)
-            else:
-                print(r'\depedge{%d}{%d}{%s}' % (node.parent.ord, node.ord, node.deprel))
+        if self.as_tree:
+            depths = [n._get_attr('depth') for n in nodes]
+            max_depth = max(depths)
+            for node in nodes:
+                print(r'\node (w%d) [yshift=\depskip+%s\deplevel,depnode] at (\wordref{1}{%d}) {};'
+                      % (node.ord, max_depth - depths[node.ord - 1], node.ord))
+            for node in nodes:
+                print(r'\draw[depguide] (w%d)--(\wordref{1}{%d});'  % (node.ord, node.ord), end='')
+                if node.parent.is_root():
+                    print('')
+                else:
+                    print(r' \draw[depedge] (w%d)--node[deplabel] {%s} (w%d);'
+                          % (node.ord, node.deprel, node.parent.ord))
+        else:
+            for node in nodes:
+                if node.parent.is_root():
+                    print(r'\deproot{%d}{root}' % node.ord)
+                else:
+                    print(r'\depedge{%d}{%d}{%s}' % (node.parent.ord, node.ord, node.deprel))
         print(r'\end{dependency}')
-        print('')  # empty line marks a new paragraph in LaTeX
+        print('')  # empty line marks a new paragraph in LaTeX, but multi=dependency causes newpage

From 33af0f217259ac7249e21c0c3a0d8662ba7015d1 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 25 Jun 2018 00:12:05 +0200
Subject: [PATCH 0216/1374] write.TextModeTrees
 layout=classic|compact|align-words|align

---
 udapi/block/write/textmodetrees.py | 76 +++++++++++++++++++++++++++---
 1 file changed, 70 insertions(+), 6 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index 54680e88..be673b2f 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -29,7 +29,7 @@ class TextModeTrees(BaseWriter):
 
     In scenario (examples of other parameters)::
 
-      write.TextModeTrees indent=1 print_sent_id=1 print_sentence=1
+      write.TextModeTrees indent=2 print_sent_id=0 print_sentence=1 layout=align
       write.TextModeTrees zones=en,cs attributes=form,lemma,upos minimize_cross=0
 
     This block prints dependency trees in plain-text format.
@@ -47,7 +47,7 @@ class TextModeTrees(BaseWriter):
       10 boxer boxer NOUN  NN  Number=Sing          4  acl:relcl _ SpaceAfter=No
       11 .     .     PUNCT .   _                    2  punct     _ _
 
-    will be printed (with the default parameters) as::
+    will be printed (with the default parameters plus hints=0) as::
 
       ─┮
        │ ╭─╼ I PRON nsubj
@@ -62,6 +62,51 @@ class TextModeTrees(BaseWriter):
          │                        ╰─┶ boxer NOUN acl:relcl
          ╰─╼ . PUNCT punct
 
+    With ``layout=compact``, the output will be (note the nodes "today" and ",")::
+
+      ─┮
+       │ ╭─╼ I PRON nsubj
+       ╰─┾ saw VERB root
+         │   ╭─╼ a DET det
+         ┡───┾ dog NOUN dobj
+         ┡─╼ │ today NOUN nmod:tmod
+         ┡─╼ │ , PUNCT punct
+         │   │ ╭─╼ which DET nsubj
+         │   │ ┢─╼ was VERB cop
+         │   │ ┢─╼ a DET det
+         │   ╰─┶ boxer NOUN acl:relcl
+         ╰─╼ . PUNCT punct
+
+    With ``layout=align-words``, the output will be::
+
+      ─┮
+       │ ╭─╼       I PRON nsubj
+       ╰─┾         saw VERB root
+         │   ╭─╼   a DET det
+         ┡───┾     dog NOUN dobj
+         ┡─╼ │     today NOUN nmod:tmod
+         ┡─╼ │     , PUNCT punct
+         │   │ ╭─╼ which DET nsubj
+         │   │ ┢─╼ was VERB cop
+         │   │ ┢─╼ a DET det
+         │   ╰─┶   boxer NOUN acl:relcl
+         ╰─╼       . PUNCT punct
+
+    And finally with ``layout=align``::
+
+      ─┮
+       │ ╭─╼       I     PRON  nsubj
+       ╰─┾         saw   VERB  root
+         │   ╭─╼   a     DET   det
+         ┡───┾     dog   NOUN  dobj
+         ┡─╼ │     today NOUN  nmod:tmod
+         ┡─╼ │     ,     PUNCT punct
+         │   │ ╭─╼ which DET   nsubj
+         │   │ ┢─╼ was   VERB  cop
+         │   │ ┢─╼ a     DET   det
+         │   ╰─┶   boxer NOUN  acl:relcl
+         ╰─╼       .     PUNCT punct
+
     Some non-projective trees cannot be printed witout crossing edges.
     TextModeTrees uses a special "bridge" symbol ─╪─ to mark this::
 
@@ -71,7 +116,7 @@ class TextModeTrees(BaseWriter):
        ╰─┶ 3 │
              ╰─╼ 4
 
-    By default parameter ``color=auto``, so if the output is printed to the console
+    With ``color=auto`` (which is the default), if the output is printed to the console
     (not file or pipe), each node attribute is printed in different color.
     If a given node's MISC contains any of `ToDo`, `Bug` or `Mark` attributes
     (or any other specified in the parameter `mark`), the node will be highlighted
@@ -88,7 +133,8 @@ class TextModeTrees(BaseWriter):
     def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
                  minimize_cross=True, color='auto', attributes='form,upos,deprel',
                  print_undef_as='_', print_doc_meta=True, print_comments=False,
-                 mark='ToDo|ToDoOrigText|Bug|Mark', marked_only=False, hints=True, **kwargs):
+                 mark='ToDo|ToDoOrigText|Bug|Mark', marked_only=False, hints=True,
+                 layout='classic', **kwargs):
         """Create new TextModeTrees block object.
 
         Args:
@@ -117,6 +163,10 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         marked_only: print only trees containing one or more marked nodes/comments. Default=False.
         hints: use thick-marked segments (┡ and ┢) to distinguish whether a given node precedes
             or follows its parent. Default=True. If False, plain ├ is used in both cases.
+        layout: 'classic' (default) shows word attributes immediately next to each node,
+            'compact' never print edges after (right to) words even in non-projectivities,
+            'align-words' as 'compact' but all first attributes (forms by default) are aligned,
+            'align' as 'align-words' but all attributes are aligned in columns.
         """
         super().__init__(**kwargs)
         self.print_sent_id = print_sent_id
@@ -130,6 +180,7 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         self.print_comments = print_comments
         self.mark = mark
         self.marked_only = marked_only
+        self.layout = layout
 
         # _draw[is_bottommost][is_topmost]
         line = '─' * indent
@@ -211,7 +262,8 @@ def process_tree(self, root):
                 botmost = idx == max_idx
                 if idx_node is node:
                     self._add(idx, self._draw[botmost][topmost])
-                    self.add_node(idx, node)
+                    if self.layout == 'classic':
+                        self.add_node(idx, node)
                 else:
                     if idx_node.parent is not node:
                         self._add(idx, self._vert[self._ends(idx, '─╭╰╪┡┢')])
@@ -219,7 +271,8 @@ def process_tree(self, root):
                         self._add(idx, self._space[idx < node.ord][topmost or botmost])
                         if idx_node.is_leaf():
                             self._add(idx, self._horiz)
-                            self.add_node(idx, idx_node)
+                            if self.layout == 'classic':
+                                self.add_node(idx, idx_node)
                         else:
                             stack.append(idx_node)
 
@@ -227,6 +280,17 @@ def process_tree(self, root):
             if self.minimize_cross:
                 stack = sorted(stack, key=lambda x: -self._gaps[x.ord])
 
+        if self.layout != 'classic':
+            columns_attrs = [[a] for a in self.attrs] if self.layout == 'align' else [self.attrs]
+            for col_attrs in columns_attrs:
+                self.attrs = col_attrs
+                max_length = max(self.lengths)
+                for idx, node in enumerate(allnodes):
+                    if self.layout.startswith('align'):
+                        self._add(idx, ' ' * (max_length - self.lengths[idx]))
+                    self.add_node(idx, node)
+            self.attrs = [a for sublist in columns_attrs for a in sublist]
+
         # Print headers (if required) and the tree itself
         self.print_headers(root)
         for line in self.lines:

From 36f4951afad91a01ae4df69d99f05558b3a1e900 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 3 Jul 2018 12:33:58 +0200
Subject: [PATCH 0217/1374] documentation error

---
 udapi/block/eval/conll17.py | 2 +-
 udapi/block/eval/conll18.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/eval/conll17.py b/udapi/block/eval/conll17.py
index 12158e55..61e86383 100644
--- a/udapi/block/eval/conll17.py
+++ b/udapi/block/eval/conll17.py
@@ -25,7 +25,7 @@
 
 
 For evaluating multiple systems and testsets (as in CoNLL2017)
-stored in `systems/testset_name/system_name.conllu` you can use::
+stored in `systems/system_name/testset_name.conllu` you can use::
 
     #!/bin/bash
     SYSTEMS=`ls systems`
diff --git a/udapi/block/eval/conll18.py b/udapi/block/eval/conll18.py
index 72612832..22f42a42 100644
--- a/udapi/block/eval/conll18.py
+++ b/udapi/block/eval/conll18.py
@@ -26,7 +26,7 @@
 
 
 For evaluating multiple systems and testsets (as in CoNLL2018)
-stored in `systems/testset_name/system_name.conllu` you can use::
+stored in `systems/system_name/testset_name.conllu` you can use::
 
     #!/bin/bash
     SYSTEMS=`ls systems`

From a42acfa47a8daf9fa7ff84ac643804b161b99f2d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 4 Jul 2018 16:12:42 +0200
Subject: [PATCH 0218/1374] Ignore all spaces from Zs when matching gold and
 pred characters

see https://github.com/ufal/conll2018/commit/c0c6c58da485f52e74f48
---
 udapi/block/util/resegmentgold.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/udapi/block/util/resegmentgold.py b/udapi/block/util/resegmentgold.py
index a93f01f4..b39db31c 100644
--- a/udapi/block/util/resegmentgold.py
+++ b/udapi/block/util/resegmentgold.py
@@ -1,5 +1,6 @@
 """util.ResegmentGold is a block for sentence alignment and re-segmentation of two zones."""
 import logging
+import unicodedata
 from udapi.core.block import Block
 from udapi.core.mwt import MWT
 from udapi.core.root import Root
@@ -31,8 +32,10 @@ def process_document(self, document):
         for bundle_no, bundle in enumerate(document.bundles):
             g_tree = bundle.trees[0]
             p_tree = pred_trees.pop()
-            g_chars = ''.join(t.form for t in g_tree.token_descendants).replace(' ', '')
-            p_chars = ''.join(t.form for t in p_tree.token_descendants).replace(' ', '')
+            g_chars = ''.join(t.form for t in g_tree.token_descendants)
+            p_chars = ''.join(t.form for t in p_tree.token_descendants)
+            g_chars = ''.join(filter(lambda c: unicodedata.category(c) != "Zs", g_chars))
+            p_chars = ''.join(filter(lambda c: unicodedata.category(c) != "Zs", p_chars))
             if g_chars == p_chars:
                 bundle.add_tree(p_tree)
                 continue

From 5305e9d441fd83a9b3fa88d1a29a526bb21f0516 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 4 Jul 2018 22:40:01 +0200
Subject: [PATCH 0219/1374] delete whitespace everywhere (fix the previous
 commit)

---
 udapi/block/util/resegmentgold.py | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/udapi/block/util/resegmentgold.py b/udapi/block/util/resegmentgold.py
index b39db31c..383510b6 100644
--- a/udapi/block/util/resegmentgold.py
+++ b/udapi/block/util/resegmentgold.py
@@ -20,6 +20,10 @@ def __init__(self, gold_zone='gold', **kwargs):
         super().__init__(**kwargs)
         self.gold_zone = gold_zone
 
+    @staticmethod
+    def _strip_spaces(string):
+        return ''.join(filter(lambda c: unicodedata.category(c) != "Zs", string))
+
     def process_document(self, document):
         if not document.bundles:
             return
@@ -32,8 +36,8 @@ def process_document(self, document):
         for bundle_no, bundle in enumerate(document.bundles):
             g_tree = bundle.trees[0]
             p_tree = pred_trees.pop()
-            g_chars = ''.join(t.form for t in g_tree.token_descendants)
-            p_chars = ''.join(t.form for t in p_tree.token_descendants)
+            g_chars = self._strip_spaces(''.join(t.form for t in g_tree.token_descendants))
+            p_chars = self._strip_spaces(''.join(t.form for t in p_tree.token_descendants))
             g_chars = ''.join(filter(lambda c: unicodedata.category(c) != "Zs", g_chars))
             p_chars = ''.join(filter(lambda c: unicodedata.category(c) != "Zs", p_chars))
             if g_chars == p_chars:
@@ -46,7 +50,7 @@ def process_document(self, document):
                 if not pred_trees:
                     raise ValueError('no pred_trees:\n%s\n%s' % (p_chars, g_chars))
                 new_p_tree = pred_trees.pop()
-                p_chars += ''.join(t.form for t in new_p_tree.token_descendants).replace(' ', '')
+                p_chars += self._strip_spaces(''.join(t.form for t in new_p_tree.token_descendants))
                 moved_roots.extend(new_p_tree.children)
                 p_tree.steal_nodes(new_p_tree.descendants)
             self.choose_root(p_tree, was_subroot, g_tree)
@@ -62,7 +66,7 @@ def process_document(self, document):
             p_chars = ''
             tokens = p_tree.token_descendants
             for index, token in enumerate(tokens):
-                p_chars += token.form.replace(' ', '')
+                p_chars += self._strip_spaces(token.form)
                 if len(p_chars) > len(g_chars):
                     logging.warning('Pred token crossing gold sentences: %s', g_tree.sent_id)
                     # E.g. gold cs ln95048-151-p2s8 contains SpaceAfter=No on the last word

From 09025ee167e1e00d0b1f54d6338547092c765dd1 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 17 Dec 2018 16:18:36 +0100
Subject: [PATCH 0220/1374] allow e.g. write.Tikz
 attributes=upos,misc[SpaceAfter]

---
 udapi/core/node.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 8e42e991..6e399631 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -501,6 +501,10 @@ def _get_attr(self, name):  # pylint: disable=too-many-return-statements
             return value
         if name == 'feats_split':
             return str(self.feats).split('|')
+        if name.startswith('feats['):
+            return self.feats[name[6:-1]]
+        if name.startswith('misc['):
+            return self.misc[name[5:-1]]
         return getattr(self, name)
 
     def get_attrs(self, attrs, undefs=None, stringify=True):

From c47a15c177bea02dc38995ec80ff095fc09c7669 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 17 Dec 2018 16:24:11 +0100
Subject: [PATCH 0221/1374] node.gloss as a r/w shortcut for node.misc["Gloss"]

---
 udapi/core/node.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 6e399631..483f1fa2 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -676,6 +676,14 @@ def no_space_after(self):
         """Boolean property as a shortcut for `node.misc["SpaceAfter"] == "No"`."""
         return self.misc["SpaceAfter"] == "No"
 
+    @property
+    def gloss(self):
+        """String property as a shortcut for `node.misc["Gloss"]`."""
+        return self.misc["Gloss"]
+
+    @gloss.setter
+    def gloss(self, new_gloss):
+        self.misc["Gloss"] = new_gloss
 
 class ListOfNodes(list):
     """Helper class for results of node.children and node.descendants.

From 54c9101fb0c4dd18b26ca5b65eae74dca091aa54 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 17 Dec 2018 16:47:17 +0100
Subject: [PATCH 0222/1374] allow `write.Tikz comment_attribute=text_en`

---
 udapi/block/write/tikz.py | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/udapi/block/write/tikz.py b/udapi/block/write/tikz.py
index 802487b5..e03a3f17 100644
--- a/udapi/block/write/tikz.py
+++ b/udapi/block/write/tikz.py
@@ -39,7 +39,7 @@ class Tikz(BaseWriter):
     """
 
     def __init__(self, print_sent_id=True, print_text=True, print_preambule=True,
-                 attributes=None, as_tree=False, **kwargs):
+                 attributes=None, as_tree=False, comment_attribute=None, **kwargs):
         """Create the Tikz block object.
 
         Args:
@@ -48,6 +48,8 @@ def __init__(self, print_sent_id=True, print_text=True, print_preambule=True,
         print_preambule: surround each document with LaTeX preambule (`documentclass` etc)
             and `end{document}` (default=True)
         attributes: comma-separated list of node attributes to print (each on a separate line).
+        as_tree: boolean - should print it as a 2D tree?
+        comment_attribute: which attribute to print as a string under each graph (e.g. text_en)
         """
         super().__init__(**kwargs)
         self.print_sent_id = print_sent_id
@@ -60,6 +62,7 @@ def __init__(self, print_sent_id=True, print_text=True, print_preambule=True,
         else:
             self.node_attributes = 'form,upos'.split(',')
         self.as_tree = as_tree
+        self.comment_attribute = comment_attribute
 
     def before_process_document(self, doc):
         super().before_process_document(doc)
@@ -78,6 +81,8 @@ def before_process_document(self, doc):
                 print(r'}')
                 print(r'\newlength{\deplevel}\setlength{\deplevel}{8mm}')
                 print(r'\newlength{\depskip}\setlength{\depskip}{4mm}')
+            print(r'\newcommand{\deptrans}[1]{\node (t) at (\matrixref.south)[yshift=-1mm]'
+                  " {``#1''}};}")
             print(r'\begin{document}')
 
     def after_process_document(self, doc):
@@ -132,5 +137,12 @@ def process_tree(self, tree):
                     print(r'\deproot{%d}{root}' % node.ord)
                 else:
                     print(r'\depedge{%d}{%d}{%s}' % (node.parent.ord, node.ord, node.deprel))
+        if self.comment_attribute and tree.comment:
+            start_pos = tree.comment.find(self.comment_attribute + ' = ')
+            if start_pos != -1:
+                start_pos += len(self.comment_attribute) + 3
+                end_pos = tree.comment.find('\n', start_pos)
+                print(r'\deptrans{' + tree.comment[start_pos:end_pos])
+
         print(r'\end{dependency}')
         print('')  # empty line marks a new paragraph in LaTeX, but multi=dependency causes newpage

From 31c1eed315bb27193565a0b6048b5577126cd19d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 22 Jan 2019 12:39:07 +0100
Subject: [PATCH 0223/1374] Fixing my own typo.

---
 udapi/block/write/tikz.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/write/tikz.py b/udapi/block/write/tikz.py
index e03a3f17..58f53a3d 100644
--- a/udapi/block/write/tikz.py
+++ b/udapi/block/write/tikz.py
@@ -82,7 +82,7 @@ def before_process_document(self, doc):
                 print(r'\newlength{\deplevel}\setlength{\deplevel}{8mm}')
                 print(r'\newlength{\depskip}\setlength{\depskip}{4mm}')
             print(r'\newcommand{\deptrans}[1]{\node (t) at (\matrixref.south)[yshift=-1mm]'
-                  " {``#1''}};}")
+                  " {``#1''};}")
             print(r'\begin{document}')
 
     def after_process_document(self, doc):

From 917ef46d9309705acfefe8650de5944a846021a3 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 22 Apr 2019 14:43:11 -0700
Subject: [PATCH 0224/1374] prevent non-projectivities also in another (edge)
 case

Prevent creating (or preserving) non-projectively attached punctuation
in cases when it is neighboring another non-projectively attached node.
Fixes #52
---
 udapi/block/ud/fixpunct.py | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 7d5bb483..dea1035d 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -14,10 +14,6 @@
 
 Since the punctuation should not have children, we should not create a non-projectivity
 if we check the root edges going to the right.
-However, it is still possible that we will attach the punctuation non-projectively
-by joining a non-projectivity that already exists.
-For example, the left neighbor (node i-1) may have its parent at i-3,
-and the node i-2 forms a gap (does not depend on i-3).
 """
 from udapi.core.block import Block
 # pylint: disable=no-self-use
@@ -128,17 +124,24 @@ def _fix_subord_punct(self, node):
         # Climb up from the candidates, until we would reach the root or "cross" the punctuation.
         # If the candidates' descendants span across the punctuation, we also stop
         # because climbing higher would cause a non-projectivity (the punct would be the gap).
+        # We also stop if the candidate is attached non-projectively to its parent,
+        # because climbing higher would make the edge from the punctuation non-projective as well.
+        # For example, the left neighbor (node i-1) may have its parent at i-3,
+        # and the node i-2 forms a gap (does not depend on i-3)
+        # - in this case, the punctuation must be attached to the node i-1 (not i-3).
         l_path, r_path = [l_cand], [r_cand]
         if l_cand is None or l_cand.is_root():
             l_cand = None
         else:
             while (not l_cand.parent.is_root() and l_cand.parent.precedes(node)
-                   and not node.precedes(l_cand.descendants(add_self=1)[-1])):
+                   and not node.precedes(l_cand.descendants(add_self=1)[-1])
+                   and not l_cand.is_nonprojective()):
                 l_cand = l_cand.parent
                 l_path.append(l_cand)
         if r_cand is not None:
             while (not r_cand.parent.is_root() and node.precedes(r_cand.parent)
-                   and not r_cand.descendants(add_self=1)[0].precedes(node)):
+                   and not r_cand.descendants(add_self=1)[0].precedes(node)
+                   and not r_cand.is_nonprojective()):
                 r_cand = r_cand.parent
                 r_path.append(r_cand)
 

From 4e3e034d2b0d8ce07b4cd14395bef7250a8e7365 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 23 Apr 2019 17:43:00 -0700
Subject: [PATCH 0225/1374] yet another solution for not introducing
 non-projectivities in edge cases

Fixes #52
---
 udapi/block/ud/fixpunct.py | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index dea1035d..0d617edb 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -124,27 +124,28 @@ def _fix_subord_punct(self, node):
         # Climb up from the candidates, until we would reach the root or "cross" the punctuation.
         # If the candidates' descendants span across the punctuation, we also stop
         # because climbing higher would cause a non-projectivity (the punct would be the gap).
-        # We also stop if the candidate is attached non-projectively to its parent,
-        # because climbing higher would make the edge from the punctuation non-projective as well.
-        # For example, the left neighbor (node i-1) may have its parent at i-3,
-        # and the node i-2 forms a gap (does not depend on i-3)
-        # - in this case, the punctuation must be attached to the node i-1 (not i-3).
         l_path, r_path = [l_cand], [r_cand]
         if l_cand is None or l_cand.is_root():
             l_cand = None
         else:
             while (not l_cand.parent.is_root() and l_cand.parent.precedes(node)
-                   and not node.precedes(l_cand.descendants(add_self=1)[-1])
-                   and not l_cand.is_nonprojective()):
+                   and not node.precedes(l_cand.descendants(add_self=1)[-1])):
                 l_cand = l_cand.parent
                 l_path.append(l_cand)
         if r_cand is not None:
             while (not r_cand.parent.is_root() and node.precedes(r_cand.parent)
-                   and not r_cand.descendants(add_self=1)[0].precedes(node)
-                   and not r_cand.is_nonprojective()):
+                   and not r_cand.descendants(add_self=1)[0].precedes(node)):
                 r_cand = r_cand.parent
                 r_path.append(r_cand)
 
+        # Filter out candidates which would lead to non-projectivities.
+        orig_parent = node.parent
+        l_path = [n for n in l_path if n and self._will_be_projective(node, n)]
+        r_path = [n for n in r_path if n and self._will_be_projective(node, n)]
+        l_cand = l_path[-1] if l_path else None
+        r_cand = r_path[-1] if r_path else None
+        node.parent = orig_parent
+
         # Now select between l_cand and r_cand -- which will be the new parent?
         # The lower one. Note that if neither is descendant of the other and neither is None
         # (which can happen in rare non-projective cases), we arbitrarily prefer l_cand,
@@ -172,6 +173,10 @@ def _fix_subord_punct(self, node):
             node.parent = cand
         node.deprel = "punct"
 
+    def _will_be_projective(self, node, cand):
+        node.parent = cand
+        return not node.is_nonprojective()
+
     def _fix_paired_punct(self, root, opening_node, closing_punct):
         if self.check_paired_punct_upos and opening_node.upos != 'PUNCT':
             return

From a058df75180befe63c53e76e80e1d5f48875283f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 23 Apr 2019 18:13:48 -0700
Subject: [PATCH 0226/1374] fix a bug in none.is_nonprojective_gap()

---
 udapi/core/node.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 483f1fa2..f1702e6f 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -667,7 +667,7 @@ def is_nonprojective_gap(self):
             if self.precedes(left_node.parent) and left_node.parent not in ancestors:
                 return True
         for right_node in all_nodes[self.ord:]:
-            if right_node.parent.precedes(node) and right_node.parent not in ancestors:
+            if right_node.parent.precedes(self) and right_node.parent not in ancestors:
                 return True
         return False
 

From 7298c29226f2036e2609d50d1bc846cff2a9511e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 24 Apr 2019 13:53:55 -0700
Subject: [PATCH 0227/1374] Fix CoNLL-U export for sentence-initial empty nodes
 and also for multiple empty nodes on the same position in sentence. Fixes
 #53.

---
 udapi/block/write/conllu.py | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index cb69159d..4b931bac 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -47,9 +47,20 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
             print('#' + comment.replace('\n', '\n#'))
 
         last_mwt_id = 0
+        last_ord = 0
         empty_nodes = list(tree.empty_nodes)
-        next_empty_ord = int(float(empty_nodes[0].ord)) if empty_nodes else -1
         for node in nodes:
+            # print all empty nodes which should go here
+            while empty_nodes:
+                next_empty_ord = int(float(empty_nodes[0].ord))
+                if next_empty_ord > last_ord:
+                    break
+                empty = empty_nodes.pop(0)
+                values = [str(getattr(empty, a)) for a in self.node_attributes]
+                values[6] = '_'
+                values[7] = '_'
+                print('\t'.join(values))
+
             mwt = node.multiword_token
             if mwt and node.ord > last_mwt_id:
                 last_mwt_id = mwt.words[-1].ord
@@ -63,13 +74,7 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
             except AttributeError:
                 values[6] = '0'
             print('\t'.join(values))
-            if node.ord == next_empty_ord:
-                empty = empty_nodes.pop(0)
-                values = [str(getattr(empty, a)) for a in self.node_attributes]
-                values[6] = '_'
-                values[7] = '_'
-                print('\t'.join(values))
-                next_empty_ord = int(float(empty_nodes[0].ord)) if empty_nodes else -1
+            last_ord = node.ord
 
         # Empty sentences are not allowed in CoNLL-U,
         # but with print_empty_trees==1 (which is the default),

From 8c1a8a74495f59a6584f960b2c9e30097090de7a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 24 Apr 2019 18:39:28 -0700
Subject: [PATCH 0228/1374] Prevent non-projectivities in case of "[...]"

where the three-dots token is a PUNCT with children
(which is against the guidelines, but there is no other way),
but if we forbid attaching it outside of the parenthesis,
we effectively keep its original attachement, which could be non-projective.
---
 udapi/block/ud/fixpunct.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 0d617edb..e3e6319b 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -111,12 +111,12 @@ def _fix_subord_punct(self, node):
         if node.form in FINAL_PUNCT:
             r_cand = None
         while l_cand.ord > 0 and l_cand.upos == "PUNCT":
-            if self._punct_type[l_cand.ord] == 'opening':
+            if self._punct_type[l_cand.ord] == 'opening' and l_cand.parent != node:
                 l_cand = None
                 break
             l_cand = l_cand.prev_node
         while r_cand is not None and r_cand.upos == "PUNCT":
-            if self._punct_type[r_cand.ord] == 'closing':
+            if self._punct_type[r_cand.ord] == 'closing' and r_cand.parent != node:
                 r_cand = None
                 break
             r_cand = r_cand.next_node

From 02394f7978db281f09e830bfa8e2c01c2b4982ce Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 25 Apr 2019 11:21:27 -0700
Subject: [PATCH 0229/1374] util.Filter keep_node='Python expreession'

---
 udapi/block/util/filter.py | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/udapi/block/util/filter.py b/udapi/block/util/filter.py
index 6d4118d6..811973ec 100644
--- a/udapi/block/util/filter.py
+++ b/udapi/block/util/filter.py
@@ -30,7 +30,7 @@ class Filter(Block):
     def __init__(self,  # pylint: disable=too-many-arguments
                  delete_tree=None, delete_tree_if_node=None, delete_subtree=None,
                  keep_tree=None, keep_tree_if_node=None, keep_subtree=None,
-                 mark=None, **kwargs):
+                 keep_node=None, mark=None, **kwargs):
         """Create the Filter block object.
 
         Args:
@@ -56,6 +56,10 @@ def __init__(self,  # pylint: disable=too-many-arguments
             If no node in the tree was marked (i.e. only the root without any children remained),
             the whole tree will be deleted.
 
+        `keep_node`: Python expression to be evaluated for each node and if False,
+            the node will be deleted and its children rehanged to its parent.
+            Multiple nodes can be deleted (or kept) this way.
+
         `mark`: a string or None. This makes sense only with `keep_tree_if_node`, where the
             matched nodes are marked with `Mark=<mark>` in `node.misc`, so they will be highlighted
             if printed with `write.TextModeTrees`. Default=None.
@@ -71,6 +75,7 @@ def __init__(self,  # pylint: disable=too-many-arguments
         self.keep_tree = keep_tree
         self.keep_tree_if_node = keep_tree_if_node
         self.keep_subtree = keep_subtree
+        self.keep_node = keep_node
         self.mark = mark
 
     def process_tree(self, tree):  # pylint: disable=too-many-branches
@@ -118,8 +123,17 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
                     kept_subtrees.append(node)
             if not kept_subtrees:
                 tree.remove()
+                return
             else:
                 for node in kept_subtrees:
                     node.parent = root
                 for orig_subroot in [n for n in root.children if n not in kept_subtrees]:
                     orig_subroot.remove()
+
+        if self.keep_node is not None:
+            nodes_to_delete = [node for node in tree.descendants if not eval(self.keep_node)]
+            if nodes_to_delete == tree.descendants:
+                tree.remove()
+                return
+            for node in nodes_to_delete:
+                node.remove(children='rehang')

From 1a3805b71c56a59cb7ab68e719bcd56aba63522c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 25 Apr 2019 13:40:44 -0700
Subject: [PATCH 0230/1374] fix few more rare cases of punct-nonproj-gap

---
 udapi/block/ud/fixpunct.py | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index e3e6319b..2f00756a 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -215,3 +215,13 @@ def _fix_pair(self, root, opening_node, closing_node):
             closing_node.parent = sorted(heads, key=lambda n: -n.descendants(add_self=1)[-1].ord)[0]
             self._punct_type[opening_node.ord] = 'opening'
             self._punct_type[closing_node.ord] = 'closing'
+
+        # In rare cases, non-projective gaps may remain. Let's dirty fix these!
+        # E.g. in "the (lack of) reproducibility", the closing parenthesis
+        # should be attached to "of" rather than to "lack"
+        # -- breaking the paired-marks-have-same-parent rule
+        # in order to prevent the punct-nonproj-gap bug (recently checked by validator.py).
+        if opening_node.is_nonprojective_gap():
+            opening_node.parent = opening_node.next_node
+        if closing_node.is_nonprojective_gap():
+            closing_node.parent = closing_node.prev_node

From 1d45aa3b6bf259aef299a7dea10e62b01b91d106 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 25 Apr 2019 16:10:14 -0700
Subject: [PATCH 0231/1374] Consider a pair of ' characters a paired single
 quotation only if upos=PUNCT

Fixes #54
---
 udapi/block/ud/fixpunct.py | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 2f00756a..e3c8dc3b 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -45,7 +45,16 @@ class FixPunct(Block):
     """Make sure punctuation nodes are attached projectively."""
 
     def __init__(self, check_paired_punct_upos=False, copy_to_enhanced=False, **kwargs):
-        """Create the ud.FixPunct block instance."""
+        """Create the ud.FixPunct block instance.
+
+        Args:
+        check_paired_punct_upos: fix paired punctuation tokens only if their UPOS=PUNCT.
+            The default is false, which means that fixed punctuation is detected only
+            based on the form with the exception of single quote / apostrophe character,
+            which is frequently ambiguous, so UPOS=PUNCT is checked always.
+        copy_to_enhanced: for all PUNCT nodes, let the enhanced depencies be the same
+            as the basic dependencies.
+        """
         super().__init__(**kwargs)
         self._punct_type = None
         self.check_paired_punct_upos = check_paired_punct_upos
@@ -178,7 +187,8 @@ def _will_be_projective(self, node, cand):
         return not node.is_nonprojective()
 
     def _fix_paired_punct(self, root, opening_node, closing_punct):
-        if self.check_paired_punct_upos and opening_node.upos != 'PUNCT':
+        if (self.check_paired_punct_upos
+            or opening_node.form == "'") and opening_node.upos != 'PUNCT':
             return
 
         nested_level = 0

From d1d16529862bf537195259569b1a34108725de0e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 30 Apr 2019 11:22:00 -0700
Subject: [PATCH 0232/1374] root should be among the ancestors to prevent false
 nonproj-gaps

---
 udapi/core/node.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index f1702e6f..c0684e60 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -657,11 +657,11 @@ def is_nonprojective_gap(self):
         - this node is within span of X, i.e. it is between (word-order-wise)
           X's leftmost descendant (or X itself) and X's rightmost descendant (or X itself).
         """
-        ancestors = set()
+        ancestors = set([self])
         node = self
         while node.parent:
-            ancestors.add(node)
             node = node.parent
+            ancestors.add(node)
         all_nodes = node.descendants
         for left_node in all_nodes[:self.ord - 1]:
             if self.precedes(left_node.parent) and left_node.parent not in ancestors:

From 4b896f0f79a86ae9ef06e403f50caeb25ca83103 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 30 Apr 2019 13:13:01 -0700
Subject: [PATCH 0233/1374] even in edge cases we should non introduce
 punct-child bugs

---
 udapi/block/ud/fixpunct.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index e3c8dc3b..e9507c23 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -211,6 +211,7 @@ def _fix_pair(self, root, opening_node, closing_node):
                     punct_heads.append(node)
                 else:
                     heads.append(node)
+
         # Punctuation should not have children, but if there is no other head candidate,
         # let's break this rule.
         if len(heads) == 0:
@@ -233,5 +234,13 @@ def _fix_pair(self, root, opening_node, closing_node):
         # in order to prevent the punct-nonproj-gap bug (recently checked by validator.py).
         if opening_node.is_nonprojective_gap():
             opening_node.parent = opening_node.next_node
+            while (opening_node.parent.ord < closing_node.ord - 1
+                and (opening_node.parent.upos == 'PUNCT' or opening_node.is_nonprojective()
+                or opening_node.is_nonprojective_gap())):
+                    opening_node.parent = opening_node.parent.next_node
         if closing_node.is_nonprojective_gap():
             closing_node.parent = closing_node.prev_node
+            while (closing_node.parent.ord > opening_node.ord + 1
+                and (closing_node.parent.upos == 'PUNCT' or closing_node.is_nonprojective()
+                or closing_node.is_nonprojective_gap())):
+                    closing_node.parent = closing_node.parent.prev_node

From cf0d7bbd8aa04d6789c556f0d52374f97fc3478b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 6 May 2019 17:24:00 -0700
Subject: [PATCH 0234/1374] fix a bug when printing subtrees

---
 udapi/block/write/textmodetrees.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index be673b2f..1f8163c5 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -268,7 +268,8 @@ def process_tree(self, root):
                     if idx_node.parent is not node:
                         self._add(idx, self._vert[self._ends(idx, '─╭╰╪┡┢')])
                     else:
-                        self._add(idx, self._space[idx < node.ord][topmost or botmost])
+                        precedes_parent = idx < self._index_of[node.ord]
+                        self._add(idx, self._space[precedes_parent][topmost or botmost])
                         if idx_node.is_leaf():
                             self._add(idx, self._horiz)
                             if self.layout == 'classic':

From 5b582f6b9a1a705767222c9b628ed4dbfd10186b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 6 May 2019 17:37:13 -0700
Subject: [PATCH 0235/1374] bugfix in ud.FixPunct

we want to prevent punct-nonproj-gap bugs,
i.e. nodes which are the *primary* cause of non-projective gaps,
but we don't care about nodes which *inherited* it,
i.e. already their parent is causing a non-projective gap.
---
 udapi/block/ud/fixpunct.py | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index e9507c23..2c26a294 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -186,6 +186,9 @@ def _will_be_projective(self, node, cand):
         node.parent = cand
         return not node.is_nonprojective()
 
+    def _causes_gap(self, node):
+        return node.is_nonprojective_gap() and not node.parent.is_nonprojective_gap()
+
     def _fix_paired_punct(self, root, opening_node, closing_punct):
         if (self.check_paired_punct_upos
             or opening_node.form == "'") and opening_node.upos != 'PUNCT':
@@ -232,15 +235,15 @@ def _fix_pair(self, root, opening_node, closing_node):
         # should be attached to "of" rather than to "lack"
         # -- breaking the paired-marks-have-same-parent rule
         # in order to prevent the punct-nonproj-gap bug (recently checked by validator.py).
-        if opening_node.is_nonprojective_gap():
+        if self._causes_gap(opening_node):
             opening_node.parent = opening_node.next_node
             while (opening_node.parent.ord < closing_node.ord - 1
                 and (opening_node.parent.upos == 'PUNCT' or opening_node.is_nonprojective()
-                or opening_node.is_nonprojective_gap())):
+                or self._causes_gap(opening_node))):
                     opening_node.parent = opening_node.parent.next_node
-        if closing_node.is_nonprojective_gap():
+        if self._causes_gap(closing_node):
             closing_node.parent = closing_node.prev_node
             while (closing_node.parent.ord > opening_node.ord + 1
                 and (closing_node.parent.upos == 'PUNCT' or closing_node.is_nonprojective()
-                or closing_node.is_nonprojective_gap())):
+                or self._causes_gap(closing_node))):
                     closing_node.parent = closing_node.parent.prev_node

From cb2539abe259778d76240a1134269c3bdcc0b8bb Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 17 Jun 2019 13:14:17 -0700
Subject: [PATCH 0236/1374] fix a bug which prevented fixing of nested quotes

fixes #55
---
 udapi/block/ud/fixpunct.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 2c26a294..96ec0ed5 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -198,7 +198,7 @@ def _fix_paired_punct(self, root, opening_node, closing_punct):
         for node in root.descendants[opening_node.ord:]:
             if node.form == closing_punct:
                 if nested_level > 0:
-                    nested_level -= 0
+                    nested_level -= 1
                 else:
                     self._fix_pair(root, opening_node, node)
                     return

From aea510f9724ea7b3ab4137e868b89114b5886221 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 23 Oct 2019 12:45:14 +0200
Subject: [PATCH 0237/1374] update UDPipe model defaults from 2.0 to 2.4

---
 udapi/block/udpipe/base.py | 171 +++++++++++++++++++++++--------------
 1 file changed, 107 insertions(+), 64 deletions(-)

diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
index 11e12b65..0c623ab6 100644
--- a/udapi/block/udpipe/base.py
+++ b/udapi/block/udpipe/base.py
@@ -3,70 +3,113 @@
 from udapi.tool.udpipe import UDPipe
 
 KNOWN_MODELS = {
-    'grc': 'models/udpipe/2.0/ancient_greek-proiel-ud-2.0-conll17-170315.udpipe',
-    'grc_proiel': 'models/udpipe/2.0/ancient_greek-ud-2.0-conll17-170315.udpipe',
-    'ar': 'models/udpipe/2.0/arabic-ud-2.0-conll17-170315.udpipe',
-    'eu': 'models/udpipe/2.0/basque-ud-2.0-conll17-170315.udpipe',
-    'bg': 'models/udpipe/2.0/bulgarian-ud-2.0-conll17-170315.udpipe',
-    'ca': 'models/udpipe/2.0/catalan-ud-2.0-conll17-170315.udpipe',
-    'zh': 'models/udpipe/2.0/chinese-ud-2.0-conll17-170315.udpipe',
-    'hr': 'models/udpipe/2.0/croatian-ud-2.0-conll17-170315.udpipe',
-    'cs_cac': 'models/udpipe/2.0/czech-cac-ud-2.0-conll17-170315.udpipe',
-    'cs_cltt': 'models/udpipe/2.0/czech-cltt-ud-2.0-conll17-170315.udpipe',
-    'cs': 'models/udpipe/2.0/czech-ud-2.0-conll17-170315.udpipe',
-    'da': 'models/udpipe/2.0/danish-ud-2.0-conll17-170315.udpipe',
-    'nl_lassysmall': 'models/udpipe/2.0/dutch-lassysmall-ud-2.0-conll17-170315.udpipe',
-    'nl': 'models/udpipe/2.0/dutch-ud-2.0-conll17-170315.udpipe',
-    'en_lines': 'models/udpipe/2.0/english-lines-ud-2.0-conll17-170315.udpipe',
-    'en_partut': 'models/udpipe/2.0/english-partut-ud-2.0-conll17-170315.udpipe',
-    'en': 'models/udpipe/2.0/english-ud-2.0-conll17-170315.udpipe',
-    'et': 'models/udpipe/2.0/estonian-ud-2.0-conll17-170315.udpipe',
-    'fi_ftb': 'models/udpipe/2.0/finnish-ftb-ud-2.0-conll17-170315.udpipe',
-    'fi': 'models/udpipe/2.0/finnish-ud-2.0-conll17-170315.udpipe',
-    'fr_partut': 'models/udpipe/2.0/french-partut-ud-2.0-conll17-170315.udpipe',
-    'fr_sequoia': 'models/udpipe/2.0/french-sequoia-ud-2.0-conll17-170315.udpipe',
-    'fr': 'models/udpipe/2.0/french-ud-2.0-conll17-170315.udpipe',
-    'gl_treegal': 'models/udpipe/2.0/galician-treegal-ud-2.0-conll17-170315.udpipe',
-    'gl': 'models/udpipe/2.0/galician-ud-2.0-conll17-170315.udpipe',
-    'de': 'models/udpipe/2.0/german-ud-2.0-conll17-170315.udpipe',
-    'got': 'models/udpipe/2.0/gothic-ud-2.0-conll17-170315.udpipe',
-    'el': 'models/udpipe/2.0/greek-ud-2.0-conll17-170315.udpipe',
-    'he': 'models/udpipe/2.0/hebrew-ud-2.0-conll17-170315.udpipe',
-    'hi': 'models/udpipe/2.0/hindi-ud-2.0-conll17-170315.udpipe',
-    'hu': 'models/udpipe/2.0/hungarian-ud-2.0-conll17-170315.udpipe',
-    'id': 'models/udpipe/2.0/indonesian-ud-2.0-conll17-170315.udpipe',
-    'ga': 'models/udpipe/2.0/irish-ud-2.0-conll17-170315.udpipe',
-    'it_partut': 'models/udpipe/2.0/italian-partut-ud-2.0-conll17-170315.udpipe',
-    'it': 'models/udpipe/2.0/italian-ud-2.0-conll17-170315.udpipe',
-    'ja': 'models/udpipe/2.0/japanese-ud-2.0-conll17-170315.udpipe',
-    'kk': 'models/udpipe/2.0/kazakh-ud-2.0-conll17-170315.udpipe',
-    'ko': 'models/udpipe/2.0/korean-ud-2.0-conll17-170315.udpipe',
-    'la_ittb': 'models/udpipe/2.0/latin-ittb-ud-2.0-conll17-170315.udpipe',
-    'la_proiel': 'models/udpipe/2.0/latin-proiel-ud-2.0-conll17-170315.udpipe',
-    'la': 'models/udpipe/2.0/latin-ud-2.0-conll17-170315.udpipe',
-    'lv': 'models/udpipe/2.0/latvian-ud-2.0-conll17-170315.udpipe',
-    'no_bokmaal': 'models/udpipe/2.0/norwegian-bokmaal-ud-2.0-conll17-170315.udpipe',
-    'no_nynorsk': 'models/udpipe/2.0/norwegian-nynorsk-ud-2.0-conll17-170315.udpipe',
-    'cu': 'models/udpipe/2.0/old_church_slavonic-ud-2.0-conll17-170315.udpipe',
-    'fa': 'models/udpipe/2.0/persian-ud-2.0-conll17-170315.udpipe',
-    'pl': 'models/udpipe/2.0/polish-ud-2.0-conll17-170315.udpipe',
-    'pt_br': 'models/udpipe/2.0/portuguese-br-ud-2.0-conll17-170315.udpipe',
-    'pt': 'models/udpipe/2.0/portuguese-ud-2.0-conll17-170315.udpipe',
-    'ro': 'models/udpipe/2.0/romanian-ud-2.0-conll17-170315.udpipe',
-    'ru_syntagrus': 'models/udpipe/2.0/russian-syntagrus-ud-2.0-conll17-170315.udpipe',
-    'ru': 'models/udpipe/2.0/russian-ud-2.0-conll17-170315.udpipe',
-    'sk': 'models/udpipe/2.0/slovak-ud-2.0-conll17-170315.udpipe',
-    'sl_sst': 'models/udpipe/2.0/slovenian-sst-ud-2.0-conll17-170315.udpipe',
-    'sl': 'models/udpipe/2.0/slovenian-ud-2.0-conll17-170315.udpipe',
-    'es_ancora': 'models/udpipe/2.0/spanish-ancora-ud-2.0-conll17-170315.udpipe',
-    'es': 'models/udpipe/2.0/spanish-ud-2.0-conll17-170315.udpipe',
-    'sv_lines': 'models/udpipe/2.0/swedish-lines-ud-2.0-conll17-170315.udpipe',
-    'sv': 'models/udpipe/2.0/swedish-ud-2.0-conll17-170315.udpipe',
-    'tr': 'models/udpipe/2.0/turkish-ud-2.0-conll17-170315.udpipe',
-    'uk': 'models/udpipe/2.0/ukrainian-ud-2.0-conll17-170315.udpipe',
-    'ur': 'models/udpipe/2.0/urdu-ud-2.0-conll17-170315.udpipe',
-    'ug': 'models/udpipe/2.0/uyghur-ud-2.0-conll17-170315.udpipe',
-    'vi': 'models/udpipe/2.0/vietnamese-ud-2.0-conll17-170315.udpipe',
+    'af': 'models/udpipe/2.4/afrikaans-afribooms-ud-2.4-190531.udpipe',
+    'af_afribooms': 'models/udpipe/2.4/afrikaans-afribooms-ud-2.4-190531.udpipe',
+    'grc': 'models/udpipe/2.4/ancient_greek-perseus-ud-2.4-190531.udpipe',
+    'grc_perseus': 'models/udpipe/2.4/ancient_greek-perseus-ud-2.4-190531.udpipe',
+    'grc_proiel': 'models/udpipe/2.4/ancient_greek-proiel-ud-2.4-190531.udpipe',
+    'ar': 'models/udpipe/2.4/arabic-padt-ud-2.4-190531.udpipe',
+    'ar_padt': 'models/udpipe/2.4/arabic-padt-ud-2.4-190531.udpipe',
+    'hy': 'models/udpipe/2.4/armenian-armtdp-ud-2.4-190531.udpipe',
+    'hy_armtdp': 'models/udpipe/2.4/armenian-armtdp-ud-2.4-190531.udpipe',
+    'eu': 'models/udpipe/2.4/basque-bdt-ud-2.4-190531.udpipe',
+    'eu_bdt': 'models/udpipe/2.4/basque-bdt-ud-2.4-190531.udpipe',
+    'be': 'models/udpipe/2.4/belarusian-hse-ud-2.4-190531.udpipe',
+    'be_hse': 'models/udpipe/2.4/belarusian-hse-ud-2.4-190531.udpipe',
+    'bg': 'models/udpipe/2.4/bulgarian-btb-ud-2.4-190531.udpipe',
+    'bg_btb': 'models/udpipe/2.4/bulgarian-btb-ud-2.4-190531.udpipe',
+    'ca': 'models/udpipe/2.4/catalan-ancora-ud-2.4-190531.udpipe',
+    'ca_ancora': 'models/udpipe/2.4/catalan-ancora-ud-2.4-190531.udpipe',
+    'zh': 'models/udpipe/2.4/chinese-gsd-ud-2.4-190531.udpipe',
+    'zh_gsd': 'models/udpipe/2.4/chinese-gsd-ud-2.4-190531.udpipe',
+    'lzh': 'models/udpipe/2.4/classical_chinese-kyoto-ud-2.4-190531.udpipe',
+    'lzh_kyoto': 'models/udpipe/2.4/classical_chinese-kyoto-ud-2.4-190531.udpipe',
+    'cop': 'models/udpipe/2.4/coptic-scriptorium-ud-2.4-190531.udpipe',
+    'cop_scriptotium': 'models/udpipe/2.4/coptic-scriptorium-ud-2.4-190531.udpipe',
+    'hr': 'models/udpipe/2.4/croatian-set-ud-2.4-190531.udpipe',
+    'hr_set': 'models/udpipe/2.4/croatian-set-ud-2.4-190531.udpipe',
+    'cs': 'models/udpipe/2.4/czech-pdt-ud-2.4-190531.udpipe',
+    'cs_pdt': 'models/udpipe/2.4/czech-pdt-ud-2.4-190531.udpipe',
+    'cs_cac': 'models/udpipe/2.4/czech-cac-ud-2.4-190531.udpipe',
+    'cs_cltt': 'models/udpipe/2.4/czech-cltt-ud-2.4-190531.udpipe',
+    'cs_fictree': 'models/udpipe/2.4/czech-fictree-ud-2.4-190531.udpipe',
+    'da': 'models/udpipe/2.4/danish-ddt-ud-2.4-190531.udpipe',
+    'da_ddt': 'models/udpipe/2.4/danish-ddt-ud-2.4-190531.udpipe',
+    'nl': 'models/udpipe/2.4/dutch-alpino-ud-2.4-190531.udpipe',
+    'nl_alpino': 'models/udpipe/2.4/dutch-alpino-ud-2.4-190531.udpipe',
+    'nl_lassysmall': 'models/udpipe/2.4/dutch-lassysmall-ud-2.4-190531.udpipe',
+    'en': 'models/udpipe/2.4/english-ewt-ud-2.4-190531.udpipe',
+    'en_ewt': 'models/udpipe/2.4/english-ewt-ud-2.4-190531.udpipe',
+    'en_gum': 'models/udpipe/2.4/english-gum-ud-2.4-190531.udpipe',
+    'en_lines': 'models/udpipe/2.4/english-lines-ud-2.4-190531.udpipe',
+    'en_partut': 'models/udpipe/2.4/english-partut-ud-2.4-190531.udpipe',
+    'et_edt': 'models/udpipe/2.4/estonian-edt-ud-2.4-190531.udpipe',
+    'et_ewt': 'models/udpipe/2.4/estonian-ewt-ud-2.4-190531.udpipe',
+    'fi': 'models/udpipe/2.4/finnish-tdt-ud-2.4-190531.udpipe',
+    'fi_tdt': 'models/udpipe/2.4/finnish-tdt-ud-2.4-190531.udpipe',
+    'fi_ftb': 'models/udpipe/2.4/finnish-ftb-ud-2.4-190531.udpipe',
+    'fr_gsd': 'models/udpipe/2.4/french-gsd-ud-2.4-190531.udpipe',
+    'fr_partut': 'models/udpipe/2.4/french-partut-ud-2.4-190531.udpipe',
+    'fr_sequoia': 'models/udpipe/2.4/french-sequoia-ud-2.4-190531.udpipe',
+    'fr_spoken': 'models/udpipe/2.4/french-spoken-ud-2.4-190531.udpipe',
+    'gl_ctg': 'models/udpipe/2.4/galician-ctg-ud-2.4-190531.udpipe',
+    'gl_treegal': 'models/udpipe/2.4/galician-treegal-ud-2.4-190531.udpipe',
+    'de': 'models/udpipe/2.4/german-gsd-ud-2.4-190531.udpipe',
+    'got': 'models/udpipe/2.4/gothic-proiel-ud-2.4-190531.udpipe',
+    'el': 'models/udpipe/2.4/greek-gdt-ud-2.4-190531.udpipe',
+    'he': 'models/udpipe/2.4/hebrew-htb-ud-2.4-190531.udpipe',
+    'hi': 'models/udpipe/2.4/hindi-hdtb-ud-2.4-190531.udpipe',
+    'hu': 'models/udpipe/2.4/hungarian-szeged-ud-2.4-190531.udpipe',
+    'id': 'models/udpipe/2.4/indonesian-gsd-ud-2.4-190531.udpipe',
+    'ga': 'models/udpipe/2.4/irish-idt-ud-2.4-190531.udpipe',
+    'it_isdt': 'models/udpipe/2.4/italian-isdt-ud-2.4-190531.udpipe',
+    'it_partut': 'models/udpipe/2.4/italian-partut-ud-2.4-190531.udpipe',
+    'it_postwita': 'models/udpipe/2.4/italian-postwita-ud-2.4-190531.udpipe',
+    'it_vit': 'models/udpipe/2.4/italian-vit-ud-2.4-190531.udpipe',
+    'ja': 'models/udpipe/2.4/japanese-gsd-ud-2.4-190531.udpipe',
+    'ko_gsd': 'models/udpipe/2.4/korean-gsd-ud-2.4-190531.udpipe',
+    'ko_kaist': 'models/udpipe/2.4/korean-kaist-ud-2.4-190531.udpipe',
+    'la_ittb': 'models/udpipe/2.4/latin-ittb-ud-2.4-190531.udpipe',
+    'la_perseus': 'models/udpipe/2.4/latin-perseus-ud-2.4-190531.udpipe',
+    'la_proiel': 'models/udpipe/2.4/latin-proiel-ud-2.4-190531.udpipe',
+    'lv': 'models/udpipe/2.4/latvian-lvtb-ud-2.4-190531.udpipe',
+    'lt_alksnis': 'models/udpipe/2.4/lithuanian-alksnis-ud-2.4-190531.udpipe',
+    'lt_hse': 'models/udpipe/2.4/lithuanian-hse-ud-2.4-190531.udpipe',
+    'mt': 'models/udpipe/2.4/maltese-mudt-ud-2.4-190531.udpipe',
+    'mr': 'models/udpipe/2.4/marathi-ufal-ud-2.4-190531.udpipe',
+    'sme': 'models/udpipe/2.4/north_sami-giella-ud-2.4-190531.udpipe',
+    'no_bokmaal': 'models/udpipe/2.4/norwegian-bokmaal-ud-2.4-190531.udpipe',
+    'no_nynorsklia': 'models/udpipe/2.4/norwegian-nynorsklia-ud-2.4-190531.udpipe',
+    'no_nynorsk': 'models/udpipe/2.4/norwegian-nynorsk-ud-2.4-190531.udpipe',
+    'cu': 'models/udpipe/2.4/old_church_slavonic-proiel-ud-2.4-190531.udpipe',
+    'fro': 'models/udpipe/2.4/old_french-srcmf-ud-2.4-190531.udpipe',
+    'orv': 'models/udpipe/2.4/old_russian-torot-ud-2.4-190531.udpipe',
+    'fa': 'models/udpipe/2.4/persian-seraji-ud-2.4-190531.udpipe',
+    'pl_lfg': 'models/udpipe/2.4/polish-lfg-ud-2.4-190531.udpipe',
+    'pl_pdb': 'models/udpipe/2.4/polish-pdb-ud-2.4-190531.udpipe',
+    'pt_bosque': 'models/udpipe/2.4/portuguese-bosque-ud-2.4-190531.udpipe',
+    'pt_gsd': 'models/udpipe/2.4/portuguese-gsd-ud-2.4-190531.udpipe',
+    'ro_nonstandard': 'models/udpipe/2.4/romanian-nonstandard-ud-2.4-190531.udpipe',
+    'ro_rrt': 'models/udpipe/2.4/romanian-rrt-ud-2.4-190531.udpipe',
+    'ru_gsd': 'models/udpipe/2.4/russian-gsd-ud-2.4-190531.udpipe',
+    'ru_syntagrus': 'models/udpipe/2.4/russian-syntagrus-ud-2.4-190531.udpipe',
+    'ru_taiga': 'models/udpipe/2.4/russian-taiga-ud-2.4-190531.udpipe',
+    'sr': 'models/udpipe/2.4/serbian-set-ud-2.4-190531.udpipe',
+    'sk': 'models/udpipe/2.4/slovak-snk-ud-2.4-190531.udpipe',
+    'sl_ssj': 'models/udpipe/2.4/slovenian-ssj-ud-2.4-190531.udpipe',
+    'sl_sst': 'models/udpipe/2.4/slovenian-sst-ud-2.4-190531.udpipe',
+    'es_ancora': 'models/udpipe/2.4/spanish-ancora-ud-2.4-190531.udpipe',
+    'es_gsd': 'models/udpipe/2.4/spanish-gsd-ud-2.4-190531.udpipe',
+    'sv_lines': 'models/udpipe/2.4/swedish-lines-ud-2.4-190531.udpipe',
+    'sv_talbanken': 'models/udpipe/2.4/swedish-talbanken-ud-2.4-190531.udpipe',
+    'ta': 'models/udpipe/2.4/tamil-ttb-ud-2.4-190531.udpipe',
+    'te': 'models/udpipe/2.4/telugu-mtg-ud-2.4-190531.udpipe',
+    'tr': 'models/udpipe/2.4/turkish-imst-ud-2.4-190531.udpipe',
+    'uk': 'models/udpipe/2.4/ukrainian-iu-ud-2.4-190531.udpipe',
+    'ur': 'models/udpipe/2.4/urdu-udtb-ud-2.4-190531.udpipe',
+    'ug': 'models/udpipe/2.4/uyghur-udt-ud-2.4-190531.udpipe',
+    'vi': 'models/udpipe/2.4/vietnamese-vtb-ud-2.4-190531.udpipe',
+    'wo': 'models/udpipe/2.4/wolof-wtb-ud-2.4-190531.udpipe',
 }
 
 

From 531c1cfb54f158f069fbc626e038d160b1efc1c9 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 23 Oct 2019 13:22:25 +0200
Subject: [PATCH 0238/1374] drop tests of Python 3.3 in Travis, add 3.6 and 3.7

---
 .travis.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index d45259b8..8d5f2f69 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,8 +1,9 @@
 language: python
 python:
-  - "3.3"
   - "3.4"
   - "3.5"
+  - "3.6"
+  - "3.7"
 before_install:
   - sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
   - sudo apt-get update -qq

From 4addd58c5761b77750e9a83ac62665eb0f58caca Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 23 Oct 2019 15:11:27 +0200
Subject: [PATCH 0239/1374] allow `udpipe.Cs resegment=1`

---
 udapi/block/udpipe/base.py | 41 ++++++++++++--------
 udapi/tool/udpipe.py       | 79 ++++++++++++++++++++++++--------------
 2 files changed, 76 insertions(+), 44 deletions(-)

diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
index 0c623ab6..2af62d27 100644
--- a/udapi/block/udpipe/base.py
+++ b/udapi/block/udpipe/base.py
@@ -1,6 +1,7 @@
 """Block udpipe.Base for tagging and parsing using UDPipe."""
 from udapi.core.block import Block
 from udapi.tool.udpipe import UDPipe
+from udapi.core.bundle import Bundle
 
 KNOWN_MODELS = {
     'af': 'models/udpipe/2.4/afrikaans-afribooms-ud-2.4-190531.udpipe',
@@ -118,12 +119,12 @@ class Base(Block):
 
     # pylint: disable=too-many-arguments
     def __init__(self, model=None, model_alias=None,
-                 tokenize=True, tag=True, parse=True, **kwargs):
+                 tokenize=True, tag=True, parse=True, resegment=False, **kwargs):
         """Create the udpipe.En block object."""
         super().__init__(**kwargs)
         self.model, self.model_alias = model, model_alias
         self._tool = None
-        self.tokenize, self.tag, self.parse = tokenize, tag, parse
+        self.tokenize, self.tag, self.parse, self.resegment = tokenize, tag, parse, resegment
 
     @property
     def tool(self):
@@ -137,20 +138,30 @@ def tool(self):
         self._tool = UDPipe(model=self.model)
         return self._tool
 
-    def process_tree(self, root):
+    def process_document(self, doc):
         tok, tag, par = self.tokenize, self.tag, self.parse
-        if tok and tag and par:
-            return self.tool.tokenize_tag_parse_tree(root)
-        if not tok and tag and par:
-            return self.tool.tag_parse_tree(root)
-        # TODO
-        # return $self->tool->tokenize_tag_parse_tree($root) if  $tok &&  $tag &&  $par;
-        # return $self->tool->tokenize_tag_tree($root)       if  $tok &&  $tag && !$par;
-        # return $self->tool->tokenize_tree($root)           if  $tok && !$tag && !$par;
-        # return $self->tool->tag_parse_tree($root)          if !$tok &&  $tag &&  $par;
-        # return $self->tool->tag_tree($root)                if !$tok &&  $tag && !$par;
-        # return $self->tool->parse_tree($root)              if !$tok && !$tag &&  $par;
-        raise ValueError("Unimplemented tokenize=%s tag=%s parse=%s" % (tok, tag, par))
+        old_bundles = doc.bundles
+        new_bundles = []
+        for bundle in old_bundles:
+            for tree in bundle:
+                new_bundles.append(bundle)
+                if self._should_process_tree(tree):
+                    if tok and tag and par:
+                        new_trees = self.tool.tokenize_tag_parse_tree(tree, resegment=self.resegment)
+                        if self.resegment and len(new_trees) > 1:
+                            orig_bundle_id = bundle.bundle_id
+                            bundle.bundle_id = orig_bundle_id + '-1'
+                            tree.text = None
+                            for i, new_tree in enumerate(new_trees[1:], 2):
+                                new_bundle = Bundle(document=doc, bundle_id=orig_bundle_id + '-' + str(i))
+                                new_tree.zone = tree.zone
+                                new_bundle.add_tree(new_tree)
+                                new_bundles.append(new_bundle)
+                    elif not tok and tag and par:
+                        self.tool.tag_parse_tree(tree)
+                    else:
+                        raise ValueError("Unimplemented tokenize=%s tag=%s parse=%s" % (tok, tag, par))
+        doc.bundles = new_bundles
 
 '''
 Udapi::Block::UDPipe::Base - tokenize, tag and parse into UD
diff --git a/udapi/tool/udpipe.py b/udapi/tool/udpipe.py
index 5d17ae97..f42b2944 100644
--- a/udapi/tool/udpipe.py
+++ b/udapi/tool/udpipe.py
@@ -4,6 +4,7 @@
 from ufal.udpipe import Model, Pipeline, ProcessingError, Sentence  # pylint: disable=no-name-in-module
 from udapi.core.resource import require_file
 from udapi.block.read.conllu import Conllu as ConlluReader
+from udapi.core.root import Root
 
 
 class UDPipe:
@@ -45,42 +46,62 @@ def tag_parse_tree(self, root):
         # pylint: disable=protected-access
         #root._children, root._descendants = parsed_root._children, parsed_root._descendants
 
-    def tokenize_tag_parse_tree(self, root):
-        """Tokenize, tag (+lemmatize, fill FEATS) and parse the text stored in `root.text`."""
+    def tokenize_tag_parse_tree(self, root, resegment=False):
+        """Tokenize, tag (+lemmatize, fill FEATS) and parse the text stored in `root.text`.
+
+        If resegment=True, the returned list of Udapi trees may contain multiple trees.
+        """
         if root.children:
             raise ValueError('Tree already contained nodes before tokenization')
 
-        # tokenization (I cannot turn off segmenter, so I need to join the segments)
+        # Tokenize and segment the text (segmentation cannot be turned off in older UDPipe versions).
         self.tokenizer.setText(root.text)
-        u_sentence = Sentence()
-        is_another = self.tokenizer.nextSentence(u_sentence)
-        u_words = u_sentence.words
-        n_words = u_words.size() - 1
-        if is_another:
-            u_sent_cont = Sentence()
-            while self.tokenizer.nextSentence(u_sent_cont):
-                n_cont = u_sent_cont.words.size() - 1
-                for i in range(1, n_cont + 1):
-                    u_w = u_sent_cont.words[i]
+        is_another = True
+        u_sentences = []
+        while is_another:
+            u_sentence = Sentence()
+            is_another = self.tokenizer.nextSentence(u_sentence)
+            if is_another:
+                u_sentences.append(u_sentence)
+
+        # If resegmentation was not required, we need to join the segments.
+        if not resegment and len(u_sentences) > 1:
+            first_sent = u_sentences[0]
+            n_words = first_sent.words.size() - 1
+            for other_sent in u_sentences[1:]:
+                other_words = other_sent.words.size() - 1
+                for i in range(1, other_words + 1):
+                    u_w = other_sent.words[i]
                     n_words += 1
                     u_w.id = n_words
-                    u_words.append(u_w)
+                    first_sent.words.append(u_w)
+            u_sentences = [first_sent]
 
         # tagging and parsing
-        self.tool.tag(u_sentence, Model.DEFAULT)
-        self.tool.parse(u_sentence, Model.DEFAULT)
+        for u_sentence in u_sentences:
+            self.tool.tag(u_sentence, Model.DEFAULT)
+            self.tool.parse(u_sentence, Model.DEFAULT)
 
         # converting UDPipe nodes to Udapi nodes
-        heads, nodes = [], [root]
-        for i in range(1, u_words.size()):
-            u_w = u_words[i]
-            node = root.create_child(
-                form=u_w.form, lemma=u_w.lemma, upos=u_w.upostag,
-                xpos=u_w.xpostag, feats=u_w.feats, deprel=u_w.deprel,
-            )
-            node.misc = u_w.misc
-            heads.append(u_w.head)
-            nodes.append(node)
-        for node in nodes[1:]:
-            head = heads.pop(0)
-            node.parent = nodes[head]
+        new_root = root
+        trees = []
+        for u_sentence in u_sentences:
+            if not new_root:
+                new_root = Root()
+            heads, nodes = [], [new_root]
+            u_words = u_sentence.words
+            for i in range(1, u_words.size()):
+                u_w = u_words[i]
+                node = new_root.create_child(
+                    form=u_w.form, lemma=u_w.lemma, upos=u_w.upostag,
+                    xpos=u_w.xpostag, feats=u_w.feats, deprel=u_w.deprel,
+                )
+                node.misc = u_w.misc
+                heads.append(u_w.head)
+                nodes.append(node)
+            for node in nodes[1:]:
+                head = heads.pop(0)
+                node.parent = nodes[head]
+            trees.append(new_root)
+            new_root = None
+        return trees

From 0ba159c33634b70b72b35aa57d8d09b5245bab9e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 27 Oct 2019 13:01:13 -0700
Subject: [PATCH 0240/1374] fix reading from a @filelist (which never worked)

_token_to_filenames(token) now always returns a list
(even if token represents a sinle filename)
and string_to_filenames flattens the list of lists.
Fixes #56.
---
 udapi/core/files.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/udapi/core/files.py b/udapi/core/files.py
index 7a711dfe..3a13f230 100644
--- a/udapi/core/files.py
+++ b/udapi/core/files.py
@@ -7,6 +7,7 @@
 import bz2
 import gzip
 import lzma
+import itertools
 
 
 class Files(object):
@@ -63,7 +64,8 @@ def string_to_filenames(self, string):
             if not filenames:
                 raise RuntimeError('No filenames matched "%s" pattern' % pattern)
             return filenames
-        return [self._token_to_filenames(tok) for tok in string.replace(',', ' ').split()]
+        return list(itertools.chain.from_iterable(self._token_to_filenames(tok)
+                                                  for tok in string.replace(',', ' ').split()))
 
     @staticmethod
     def _token_to_filenames(token):
@@ -80,7 +82,7 @@ def _token_to_filenames(token):
             if directory != '.':
                 filenames = [f if f[0] != '/' else directory + '/' + f for f in filenames]
         else:
-            filenames = token
+            filenames = [token]
         return filenames
 
     @property

From 2c39b236f58fe579982ae5e782d94c619ea48e7e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 27 Oct 2019 14:05:27 -0700
Subject: [PATCH 0241/1374] store input filename in
 `document.meta['loaded_from']`

---
 udapi/core/basereader.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index b5e159a2..f1e32d18 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -126,6 +126,8 @@ def process_document(self, document):
                     continue
                 self.finished = not self.files.has_next_file()
                 break
+            if trees_loaded == 0:
+                document.meta['loaded_from'] = self.filename
             add_to_the_last_bundle = 0
             trees_loaded += 1
 

From 752e5d77d7be1e50bdae46e2088837609160566c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 6 Nov 2019 22:12:20 +0100
Subject: [PATCH 0242/1374] prevent sent_id ending with a slash (but with no
 zone)

---
 udapi/core/bundle.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/udapi/core/bundle.py b/udapi/core/bundle.py
index 5a9d6808..aa030259 100644
--- a/udapi/core/bundle.py
+++ b/udapi/core/bundle.py
@@ -31,8 +31,11 @@ def bundle_id(self):
     @bundle_id.setter
     def bundle_id(self, bundle_id):
         self._bundle_id = bundle_id
-        for tree in self.trees:
-            tree._sent_id = bundle_id + '/' + tree.zone  # pylint: disable=protected-access
+        if len(self.trees) == 1 and self.trees[0].zone == '':
+            self.trees[0]._sent_id = bundle_id
+        else:
+            for tree in self.trees:
+                tree._sent_id = bundle_id + '/' + tree.zone  # pylint: disable=protected-access
 
     def __str__(self):
         if self.bundle_id is None:

From 27879db2a0e055e4a53408ce9a3ffd0aa6e0e836 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 8 Nov 2019 14:57:50 +0100
Subject: [PATCH 0243/1374] add block segment.Simple for simple sentence
 segmentation

---
 udapi/block/segment/simple.py | 39 +++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 udapi/block/segment/simple.py

diff --git a/udapi/block/segment/simple.py b/udapi/block/segment/simple.py
new file mode 100644
index 00000000..5842a6c5
--- /dev/null
+++ b/udapi/block/segment/simple.py
@@ -0,0 +1,39 @@
+"""Block segment.Simple"""
+from udapi.core.block import Block
+from udapi.core.bundle import Bundle
+import re
+
+# We don't want to introduce the extra "regex" dependency for \p{Lu} support.
+# import sys
+# pLu = '[{}]'.format("".join([chr(i) for i in range(sys.maxunicode) if chr(i).isupper()]))
+# p = re.compile(pLu)
+
+
+class Simple(Block):
+    """"Base segmenter, splits on sentence-final segmentation followed by uppercase."""
+
+    @staticmethod
+    def segment_string(string):
+        """A method to be overriden in subclasses."""
+        return re.sub(r'([.!?])(["“»›]?) (["„«¿¡‹(]?)(\d|[ČĎŇÓŘŠŤÚŽA-Z])', r'\1\2\n\3\4', string).split('\n')
+
+
+    def process_document(self, doc):
+        old_bundles = doc.bundles
+        new_bundles = []
+        for bundle in old_bundles:
+            for tree in bundle:
+                new_bundles.append(bundle)
+                if self._should_process_tree(tree):
+                    if tree.children:
+                        raise ValueError("Segmenting already tokenized text is not supported.")
+                    sentences = self.segment_string(tree.text)
+                    orig_bundle_id = bundle.bundle_id
+                    bundle.bundle_id = orig_bundle_id + '-1'
+                    if len(sentences) > 1:
+                        tree.text = sentences[0]
+                        for i, sentence in enumerate(sentences[1:], 2):
+                            new_bundle = Bundle(document=doc, bundle_id=orig_bundle_id + '-' + str(i))
+                            new_bundle.create_tree(tree.zone).text = sentence
+                            new_bundles.append(new_bundle)
+        doc.bundles = new_bundles
\ No newline at end of file

From fd454c27567c7bab4545c4ce577722eed68ebf57 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 18 Nov 2019 07:23:59 +0100
Subject: [PATCH 0244/1374] improve segment.Simple

---
 udapi/block/segment/simple.py | 50 +++++++++++++++++++++++++++--------
 1 file changed, 39 insertions(+), 11 deletions(-)

diff --git a/udapi/block/segment/simple.py b/udapi/block/segment/simple.py
index 5842a6c5..b4f2bbe4 100644
--- a/udapi/block/segment/simple.py
+++ b/udapi/block/segment/simple.py
@@ -3,27 +3,55 @@
 from udapi.core.bundle import Bundle
 import re
 
-# We don't want to introduce the extra "regex" dependency for \p{Lu} support.
-# import sys
-# pLu = '[{}]'.format("".join([chr(i) for i in range(sys.maxunicode) if chr(i).isupper()]))
-# p = re.compile(pLu)
-
-
 class Simple(Block):
-    """"Base segmenter, splits on sentence-final segmentation followed by uppercase."""
+    """"Heuristic segmenter, splits on sentence-final segmentation followed by uppercase."""
 
     @staticmethod
-    def segment_string(string):
-        """A method to be overriden in subclasses."""
-        return re.sub(r'([.!?])(["“»›]?) (["„«¿¡‹(]?)(\d|[ČĎŇÓŘŠŤÚŽA-Z])', r'\1\2\n\3\4', string).split('\n')
+    def is_nonfinal_abbrev(token):
+        """Is a given token an abbreviation (without the final period) which cannot end a sentence?"""
+        if re.search('(např|e.g.)$', token):
+            return True
+        return False
+
+
+    def is_boundary(self, first, second):
+        """Is there a sentence boundary between the first and second token?"""
+        if first[-1] in '"“»›)':
+            first = first[:-1]
+        if second[0] in '"„«¿¡‹(':
+            second = second[1:]
+        if not second[0].isupper() or second[0].isdigit():
+            return False
+        if not first[-1] in '.!?':
+            return False
+        if first[-1] == '.':
+            if len(first) == 2 and first[0].isupper():
+                return False
+            if self.is_nonfinal_abbrev(first[:-1]):
+                return False
+        return True
+
+
+    def segment_string(self, string):
+        """Return a list of sentences in a given string."""
+        tokens = string.split(' ')
+        previous = tokens[0]
+        segments = [previous]
+        for token in tokens[1:]:
+            if self.is_boundary(previous, token):
+                segments.append(token)
+            else:
+                segments[-1] += ' ' + token
+            previous = token
+        return segments
 
 
     def process_document(self, doc):
         old_bundles = doc.bundles
         new_bundles = []
         for bundle in old_bundles:
+            new_bundles.append(bundle)
             for tree in bundle:
-                new_bundles.append(bundle)
                 if self._should_process_tree(tree):
                     if tree.children:
                         raise ValueError("Segmenting already tokenized text is not supported.")

From 516addae5ba1694af45985f033d863ec72c35107 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 18 Nov 2019 07:25:43 +0100
Subject: [PATCH 0245/1374] allow udpipe.base parse=0 and various bugfixes

---
 udapi/block/udpipe/base.py |  5 +++--
 udapi/core/bundle.py       |  2 ++
 udapi/tool/udpipe.py       | 29 +++++++++++++++++------------
 3 files changed, 22 insertions(+), 14 deletions(-)

diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
index 2af62d27..34028a4a 100644
--- a/udapi/block/udpipe/base.py
+++ b/udapi/block/udpipe/base.py
@@ -146,8 +146,9 @@ def process_document(self, doc):
             for tree in bundle:
                 new_bundles.append(bundle)
                 if self._should_process_tree(tree):
-                    if tok and tag and par:
-                        new_trees = self.tool.tokenize_tag_parse_tree(tree, resegment=self.resegment)
+                    if tok:
+                        new_trees = self.tool.tokenize_tag_parse_tree(tree, resegment=self.resegment,
+                                                                      tag=self.tag, parse=self.parse)
                         if self.resegment and len(new_trees) > 1:
                             orig_bundle_id = bundle.bundle_id
                             bundle.bundle_id = orig_bundle_id + '-1'
diff --git a/udapi/core/bundle.py b/udapi/core/bundle.py
index aa030259..4df1deb2 100644
--- a/udapi/core/bundle.py
+++ b/udapi/core/bundle.py
@@ -100,6 +100,8 @@ def add_tree(self, root):
     def remove(self):
         """Remove a bundle from the document."""
         self._document.bundles = [bundle for bundle in self._document.bundles if bundle != self]
+        for i, bundle in enumerate(self._document.bundles):
+            bundle.number = i
 
     def address(self):
         """Return bundle_id or '?' if missing."""
diff --git a/udapi/tool/udpipe.py b/udapi/tool/udpipe.py
index f42b2944..c81a7562 100644
--- a/udapi/tool/udpipe.py
+++ b/udapi/tool/udpipe.py
@@ -37,7 +37,7 @@ def tag_parse_tree(self, root):
         for parsed_node in parsed_root.descendants:
             node = nodes[parsed_node.ord]
             node.parent = nodes[parsed_node.parent.ord]
-            for attr in 'upos xpos lemma feats'.split():
+            for attr in 'upos xpos lemma feats deprel'.split():
                 setattr(node, attr, getattr(parsed_node, attr))
 
         # TODO: benchmark which solution is the fastest one. E.g. we could also do
@@ -46,7 +46,7 @@ def tag_parse_tree(self, root):
         # pylint: disable=protected-access
         #root._children, root._descendants = parsed_root._children, parsed_root._descendants
 
-    def tokenize_tag_parse_tree(self, root, resegment=False):
+    def tokenize_tag_parse_tree(self, root, resegment=False, tag=True, parse=True):
         """Tokenize, tag (+lemmatize, fill FEATS) and parse the text stored in `root.text`.
 
         If resegment=True, the returned list of Udapi trees may contain multiple trees.
@@ -78,9 +78,13 @@ def tokenize_tag_parse_tree(self, root, resegment=False):
             u_sentences = [first_sent]
 
         # tagging and parsing
-        for u_sentence in u_sentences:
-            self.tool.tag(u_sentence, Model.DEFAULT)
-            self.tool.parse(u_sentence, Model.DEFAULT)
+        if tag:
+            for u_sentence in u_sentences:
+                self.tool.tag(u_sentence, Model.DEFAULT)
+                if parse:
+                    self.tool.parse(u_sentence, Model.DEFAULT)
+        elif parse:
+            raise ValueError('Combination parse=True tag=False is not allowed.')
 
         # converting UDPipe nodes to Udapi nodes
         new_root = root
@@ -94,14 +98,15 @@ def tokenize_tag_parse_tree(self, root, resegment=False):
                 u_w = u_words[i]
                 node = new_root.create_child(
                     form=u_w.form, lemma=u_w.lemma, upos=u_w.upostag,
-                    xpos=u_w.xpostag, feats=u_w.feats, deprel=u_w.deprel,
+                    xpos=u_w.xpostag, feats=u_w.feats, deprel=u_w.deprel, misc=u_w.misc,
                 )
-                node.misc = u_w.misc
-                heads.append(u_w.head)
-                nodes.append(node)
-            for node in nodes[1:]:
-                head = heads.pop(0)
-                node.parent = nodes[head]
+                if parse:
+                    heads.append(u_w.head)
+                    nodes.append(node)
+            if parse:
+                for node in nodes[1:]:
+                    head = heads.pop(0)
+                    node.parent = nodes[head]
             trees.append(new_root)
             new_root = None
         return trees

From 997b6f0b5e1181ed9a535d6eb5c0479ab22082f4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 18 Nov 2019 07:26:54 +0100
Subject: [PATCH 0246/1374] segment.Merge merges sentences ending with
 semicolons

---
 udapi/block/segment/merge.py | 46 ++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 udapi/block/segment/merge.py

diff --git a/udapi/block/segment/merge.py b/udapi/block/segment/merge.py
new file mode 100644
index 00000000..9ada45f1
--- /dev/null
+++ b/udapi/block/segment/merge.py
@@ -0,0 +1,46 @@
+"""Block segment.Merge"""
+from udapi.core.block import Block
+
+class Merge(Block):
+    """"Re-segmenter merging selected sentences (trees).
+
+    This class merges sentences ending with semicolons,
+    but it can be used as a base class for merging based on different criteria
+    by overriding one of the `should_*` methods.
+    """
+
+    @staticmethod
+    def should_merge_tokens(first, second):
+        """Is there actually a sentence boundary between the first and second node?"""
+        if first.form[-1] == ';':
+            return True
+        return False
+
+    def should_merge_bundles(self, first_bundle, second_bundle):
+        """Is there actually a sentence boundary between the first and second bundle?"""
+        first_tree = self._get_our_tree(first_bundle)
+        second_tree = self._get_our_tree(second_bundle)
+        return self.should_merge_tokens(first_tree.descendants[-1], second_tree.descendants[0])
+
+
+    def _get_our_tree(self, bundle):
+        for tree in bundle:
+            if self._should_process_tree(tree):
+                return tree
+        raise ValueError("Bundle %s contains no tree to process." % bundle.address())
+
+
+    def process_document(self, doc):
+        old_bundles = doc.bundles
+        prev_bundle = old_bundles[0]
+        new_bundles = [prev_bundle]
+        for bundle in old_bundles[1:]:
+            if self.should_merge_bundles(prev_bundle, bundle):
+                for tree in bundle:
+                    prev_tree = prev_bundle.get_tree(tree.zone)
+                    prev_tree.steal_nodes(tree.descendants)
+                    prev_tree.text = prev_tree.compute_text()
+            else:
+                new_bundles.append(bundle)
+                prev_bundle = bundle
+        doc.bundles = new_bundles
\ No newline at end of file

From e5c51e66e341c003b7e092f3498310f2125f0a18 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 20 Nov 2019 18:32:59 +0100
Subject: [PATCH 0247/1374] rename newspeak.PreVele to demo.Newspeak

---
 udapi/block/{newspeak/prevele.py => demo/newspeak.py} | 6 +++---
 udapi/block/newspeak/__init__.py                      | 0
 2 files changed, 3 insertions(+), 3 deletions(-)
 rename udapi/block/{newspeak/prevele.py => demo/newspeak.py} (93%)
 delete mode 100644 udapi/block/newspeak/__init__.py

diff --git a/udapi/block/newspeak/prevele.py b/udapi/block/demo/newspeak.py
similarity index 93%
rename from udapi/block/newspeak/prevele.py
rename to udapi/block/demo/newspeak.py
index dd616571..6be2caf5 100644
--- a/udapi/block/newspeak/prevele.py
+++ b/udapi/block/demo/newspeak.py
@@ -1,10 +1,10 @@
-"""newspeak.PreVele block for 1984-like newspeak-ization.
+"""demo.Newspeak block for 1984-like newspeak-ization of Czech.
 
 This is just a demo/draft.
 
 Usage:
   $ echo 'Nejhorší žena je lepší než nejlepší muž.' | \
-         udapy -q read.Sentences udpipe.Cs newspeak.PreVele write.Sentences
+         udapy -q read.Sentences udpipe.Cs demo.Newspeak write.Sentences
   Převelenedobrá žena je veledobrá než převeledobrý muž.
 """
 from udapi.core.block import Block
@@ -18,7 +18,7 @@
 }
 
 
-class PreVele(Block):
+class Newspeak(Block):
     """Change all comparatives to vele-x and superlatives to převele-x."""
 
     def __init__(self, morphodita_path='models/morphodita/cs/',
diff --git a/udapi/block/newspeak/__init__.py b/udapi/block/newspeak/__init__.py
deleted file mode 100644
index e69de29b..00000000

From e7a649cefe737d0c6b67d7edd210b5587dc88c25 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 23 Nov 2019 22:54:45 +0100
Subject: [PATCH 0248/1374] fix loading empty trees

---
 udapi/block/read/conllu.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 1b3383fb..83f7a1c3 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -164,8 +164,10 @@ def read_tree(self):
         # they need to create one artificial node and mark it with Empty=Yes.
         # In that case, we will delete this node, so the tree will have just the (technical) root.
         # See also udapi.block.write.Conllu, which is compatible with this trick.
-        if len(nodes) == 2 and nodes[1].misc == 'Empty=Yes':
+        if len(nodes) == 2 and str(nodes[1].misc) == 'Empty=Yes':
             nodes.pop()
+            root._children = []
+            root._descendants = []
 
         # Set dependency parents (now, all nodes of the tree are created).
         # TODO: parent setter checks for cycles, but this is something like O(n*log n)

From c0f3cd2dd6e0e547e85180b18332398083222bbe Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 25 Nov 2019 01:02:45 +0100
Subject: [PATCH 0249/1374] first draft of a block for Silvie

---
 udapi/block/demo/complexity.py | 267 +++++++++++++++++++++++++++++++++
 1 file changed, 267 insertions(+)
 create mode 100644 udapi/block/demo/complexity.py

diff --git a/udapi/block/demo/complexity.py b/udapi/block/demo/complexity.py
new file mode 100644
index 00000000..a5d972e9
--- /dev/null
+++ b/udapi/block/demo/complexity.py
@@ -0,0 +1,267 @@
+"""demo.Complexity prints statistics on syntactic complexity.
+"""
+from udapi.core.basewriter import BaseWriter
+from collections import deque
+
+
+def non_punct(nodes):
+    return [n for n in nodes if n.upos != 'PUNCT']
+
+
+def is_np(node):
+    return node.upos in ("NOUN", "PROPN") or (node.upos == "PRON" and node.feats["PronType"] == "Prs" and not node.feats["Poss"])
+
+
+def is_vp(node):
+    """E.g. prosili, naléhali a žadonili => 1 coordinated verb phrase, head “prosili”. 
+
+    [POS == “VERB”, [deprel == “conj”, POS == “VERB”]], unique coordination heads
+    TODO: zahrnout i non-VERB?
+    - vznikla a byla přijata(conj,ADJ,parent=vznikla)
+    - je(cop,AUX) nešťastný(ADJ) a nechá(conj,VERB,parent=nešťastný) se nalákat
+    - "podařilo se to a dokladem(ClauseHead,NOUN,conj,parent=podařilo) je(cop,AUX,parent=dokladem)"
+    - omezit se jen na (či využít) ClauseHead, nebo zahrnout i non-finite verbs (koordinace infinitivů či příčestí)?
+    "stihl(ClauseHead) napsat(VerbForm=Inf) a publikovat(VerbForm=Inf)" ... napsat ani publikovat nejsou ClauseHead
+    "rozhodl se ukončit a ukazuje(ClauseHead,parent=ukončit)" správně by mělo být parent=rozhodl, ale parser dělá chyby.
+    - Parsing vůbec dělá mnoho chyb v koordinacích, takže je vhodné podmínky velmi omezit.
+    """
+    return node.upos == "VERB" or node.misc["ClauseHead"]
+
+
+def is_relcl(node):
+    """Is a given node a head of a relative clause?
+    
+    Unfortunatelly, UDPipe 2.4 produces just acl instead of acl:relcl.
+    """
+    if node.deprel == 'acl:relcl':
+        return True
+    return node.udeprel == 'acl' and next((c for c in node.children if 'Rel' in c.feats['PronType']), None)
+
+
+def is_postponed_nom_mod(node):
+    """Is a given node a postponed nominal modifier?
+    
+    Silvie: [(POS in {“NOUN”, “PROPN”} | POS == “PRON” & feats:PronType == “Prs” & !(feats:Poss==”Yes”)), child with higher word order than parent
+    [deprel != “conj”, POS in {“NOUN”, “PROPN”} | POS == “PRON” & feats:PronType == “Prs” & !(feats:Poss==”Yes”)]
+    
+    TODO: Tohle hledá v češtině zcela běžné jevy jako "vznik díla". Nechceme hledat něco jiného?
+    """
+    return node.udeprel != 'conj' and is_np(node) and node.parent.precedes(node) and is_np(node.parent)
+
+
+def is_postponed_adj_mod(node):
+    # TODO můžeme rozlišovat holý přívlastek ("písní ruských") a rozvitý ("milenec známý z pozdějšího zpracování")
+    return node.parent.precedes(node) and is_np(node.parent) and node.upos == 'ADJ' #and not node.children
+
+
+def is_complex_nominal(node):
+    """[(POS in {“NOUN”, “PROPN”} | POS == “PRON” & feats:PronType == “Prs” & !(feats:Poss==”Yes”)) 2x descendant [deprel != “conj”]]
+    TODO: punct, case, cc a dep taky ignorovat?
+    TODO: opravdu descendants a ne children? (descendants snadno roste nad všechny meze, je-li tam třeba vedlejší věta)
+    TODO: beztak bude chtít odfiltrovat copuly: "Jádrem tvorby jsou sbírky." - Jádrem má 3 děti.
+    TODO: a nezvýšit ten limit z 2x aspoň na 3x?
+    """
+    return is_np(node) and len([n for n in node.children if n.deprel not in ('conj', 'punct', 'case', 'cc', 'dep', 'cop')]) > 1
+
+class Complexity(BaseWriter):
+
+    def __init__(self, matches=False, **kwargs):
+        super().__init__(**kwargs)
+        self.matches = matches
+
+
+    def process_tree(self, root):
+        print("# " + root.text)
+        
+        allnodes = root.descendants
+        depth, clause_depth = {0: 0}, {0: 0}
+        queue = deque(root.children)
+        clause_heads = []
+        while queue:
+            node = queue.popleft()
+            depth[node.ord] = depth[node.parent.ord] + 1
+            clause_depth[node.ord] = clause_depth[node.parent.ord]
+            if self.is_finite_clause_head(node):
+                node.misc['ClauseHead'] = 1
+                clause_heads.append(node)
+                clause_depth[node.ord] += 1
+            queue.extend(node.children)
+        max_depth = sorted(depth.values())[-1]
+        max_clause_depth = sorted(clause_depth.values())[-1]
+
+        t_units = self.get_t_units([n for n in root.children if n.deprel == 'root'])
+        total_t_units_length = sum(len(t_unit) for t_unit in t_units)
+        mean_t_unit_length = total_t_units_length / (len(t_units) or 1) # TODO co reportovat, když věta nemá žádné t-units?
+               
+        if not self.matches:
+            print("\t".join(str(x) for x in [root.sent_id, len(non_punct(allnodes)), max_depth, max_clause_depth, mean_t_unit_length]), end='')
+        
+        self.report("clauses", [[n] for n in clause_heads], 'subtree')
+        self.report("adjectivized_predicates", [[n] for n in allnodes if self.is_adjectivized_predicate(n)])
+        self.report("controlled_predicates", [[n] for n in allnodes if self.is_controlled_predicate(n)])
+        self.report("main_clauses", self.get_main_clauses(root), 'subtree_within_clause')
+        self.report("coordinated_verb_phrases", self.get_coord_phrase(root, is_vp))
+        self.report("coordinated_noun_phrases", self.get_coord_phrase(root, is_np))
+        self.report("coordinated_adjective_phrases", self.get_coord_phrase(root, lambda n: n.upos in ("ADJ", "DET")))
+        self.report("coordinated_adverb_phrases", self.get_coord_phrase(root, lambda n: n.upos == "ADV"))
+        self.report("t-units", t_units)
+        self.report("complex_t-units", self.get_complex_t_units(root))
+        # TODO: najde "básně a písně" a "rychtář a rychtářka" UDPipe kdovíproč určil jako ADV a ADV. Zkontrolovat, máme-li nejlepší možný UDPipe model.
+        self.report("relative_clauses", [[n] for n in allnodes if is_relcl(n)], 'subtree_within_clause')
+        self.report("postponed_nominal_modifiers", [[n] for n in allnodes if is_postponed_nom_mod(n)])
+        # TODO postponed_adj_mod si přidal Martin
+        #self.report("postponed_adjective_modifiers", [[n] for n in allnodes if is_postponed_adj_mod(n)])
+        self.report("complex_nominals", [[n] for n in allnodes if is_complex_nominal(n)])
+
+        if not self.matches:
+            # TODO: pro total koordinace asi nemá smysl reportovat matches, jen total count?
+            self.report("coordinated_phrases_total", self.get_coord_phrase(root, lambda _: True))
+            
+            nonpunct_upos = [n.upos for n in non_punct(allnodes)] + ['NONE', 'NONE']
+            brackets = str(len([n for n in allnodes if n.form == '(']))
+            dashes = str(len([n for n in allnodes if n.form in '-–—―'])) # hyphen, en-dash, em-dash, horizonatal bar
+            colons = str(len([n for n in allnodes if n.form == ':']))
+            semicolons = str(len([n for n in allnodes if n.form == ';']))
+            print("\t", "\t".join([nonpunct_upos[0], nonpunct_upos[1], brackets, dashes, colons, semicolons]))
+
+
+    def report(self, category, groups, expand_type='no'):
+        if self.matches:
+            for group in groups:
+                self.print_match(category, group, expand_type)
+        else:
+            print("\t" + str(len(groups)), end='')
+
+
+    def expand_subtree(self, nodes, expand_type):
+        if expand_type == 'no':
+            return nodes
+        if len(nodes) > 1:
+            raise Exception("expanding more than one node not implemented yet")
+        if expand_type == 'subtree':
+            return nodes[0].descendants(add_self=True)
+        #if expand_type == 'subtree_except_conj':
+            #result = nodes
+            #for child in group.children:
+                #if child.udeprel != 'conj':
+                    #result.extend(child.descendants(add_self=True))
+            #return = sorted(result, key=lambda n: n.ord)
+        if expand_type == 'subtree_within_clause':
+            stack = [n for n in nodes[0].children if n.udeprel != 'conj']
+            while stack:
+                node = stack.pop()
+                if not node.misc["ClauseHead"]:
+                    nodes.append(node)
+                    stack.extend(node.children())
+            return sorted(nodes, key=lambda n: n.ord)
+        raise ValueError("unknown expand value " + expand_type)
+
+
+    def print_match(self, category, group, expand_type='no'):
+        nodes = self.expand_subtree(group, expand_type)
+        lemmas = " ".join(n.lemma for n in nodes)
+        tags = " ".join(n.upos for n in nodes)
+        n_tokens = str(len(non_punct(nodes)))
+        print("\t".join([category, nodes[0].root.sent_id, lemmas, tags, n_tokens]))
+
+
+    def is_finite_clause_head(self, node):
+        """Is a given node a head of a finite clause?
+
+        Silvie: [(POS == „VERB“ & feats:Verbform == „Fin“ | Verbform == „Part“} ) ] OR [(POS in {„ADJ“, „NOUN“, „PROPN“}, [child POS ==  „AUX“)]]
+        - POS == „VERB“ je zbytečné, protože VerbForm=Part je nastaveno i u ADJ ("je nucen" apod.)
+        - child POS == „AUX“ zase matchuje i např. na "Vidím psa(NOUN), který je(AUX,acl,parent=psa) z dávné doby."
+        - adjectivized predicates (převažující(VerbForm=Part) básně) by neměly být určeny jako clause_head
+        
+        * Most finite verbs with deprel=amod are parsing errors - they should have deprel=acl,
+          but for better robustness we include these as well.
+        * Similarly "dep" and "orphan" are mostly parsing errors.
+        * TODO: by uncommenting the nsubj/csubj line, we find few more real clause heads, but also some false positives.    
+        """
+        # TODO appos
+        if ((node.udeprel in {'root', 'conj', 'acl', 'advcl', 'ccomp', 'csubj', 'obl', 'parataxis', 'amod', 'dep', 'orphan'} and self.is_finite_verb(node))
+                #or any(c.udeprel in {'nsubj', 'csubj'} for c in node.children)
+                or (any(c.udeprel == 'cop' for c in node.children) and node.udeprel != 'xcomp')):
+            return True
+        xcomp_child = next((c for c in node.children if c.udeprel == 'xcomp'), None)
+        return xcomp_child and any(c.udeprel == 'cop' for c in xcomp_child.children)
+
+
+    # TODO: zahrnout i: bude(aux,AUX,parent=chovat) se chovat(VERB,VerbForm=Inf)
+    def is_finite_verb(self, node):
+        return (node.feats['VerbForm'] in {'Fin', 'Part'} and
+                (node.upos == 'VERB' or
+                 node.upos == 'ADJ' and any(c.deprel == 'aux:pass' for c in node.children)))
+
+
+    def is_adjectivized_predicate(self, node):
+        """E.g. kouřící komín, zbitý kluk
+
+        Silvie: [(POS == „ADJ“ & feats:VerbForm == „Part“), parent [POS in {„NOUN“, „PROPN“}] ]
+        - parent [POS in {„NOUN“, „PROPN“}] zamezí případům jako
+         "kvůli nesmyslné a stupňující(parent=nesmyslné,deprel=conj) se žárlivosti"
+         "Nové pronikající(parent=Nové,deprel=amod) socialistické myšlení" asi chyba parsingu, mělo být parent=myšlení?
+        - dotaz naopak matchuje na "způsob, jakým jsou popsány", proto přidávám podmínku not node.misc["ClauseHead"]
+        """
+        return (node.feats["VerbForm"] == "Part"
+            and node.upos == "ADJ"
+            and (node.parent.upos in {"NOUN","PROPN"} or (node.udeprel == "conj" and node.parent.upos == "ADJ"))
+            and not node.misc["ClauseHead"])
+
+
+    def is_controlled_predicate(self, node):
+        """E.g. Mohli jsme odejít i zůstat.
+        
+        TODO: Chceme zahrnout i druhý a další člen koordinace, např. "stihl napsat a publikovat",
+        tedy node.udeprel == "conj" and node.parent.udeprel == "xcomp"?
+        """
+        return node.deprel == "xcomp"
+
+
+    def get_main_clauses(self, root):
+        main_heads = []
+        for main_head in root.children:
+            main_heads.append(main_head)
+            main_heads.extend(n for n in main_head.children if n.udeprel == 'conj')
+        return [[n] for n in main_heads]
+
+    def get_coord_phrase(self, root, phrase_type_function):
+        results = []
+        for node in root.descendants:
+            if phrase_type_function(node):
+                conjuncts = [n for n in node.children if n.udeprel == 'conj' and phrase_type_function(n)]
+                if conjuncts:
+                    conjunctions = []
+                    for conj in conjuncts:
+                        # TODO multiword conjunctions (udeprel=flat)?
+                        conjunctions.extend([n for n in conj.children if n.udeprel == 'cc'])
+                    results.append(sorted([node] + conjuncts + conjunctions, key=lambda n: n.ord))
+        return results
+
+
+    def get_t_units(self, main_heads):
+        results = []
+        for main_head in main_heads:
+            main_clause = [main_head]
+            dep_heads = []
+            stack = main_head.children
+            while stack:
+                node = stack.pop()
+                if node.misc["ClauseHead"]:
+                    dep_heads.append(node)
+                else:
+                    main_clause.append(node)
+                    stack.extend(node.children)
+            main_clause = sorted(main_clause, key=lambda n: n.ord)
+            
+            for dep_clause_head in dep_heads:
+                results.append(main_clause + self.expand_subtree([dep_clause_head], 'subtree')) # TODO subtree_within_clause?
+        return results
+
+    
+    def get_complex_t_units(self, root):
+        results = []
+        for node in root.descendants:
+            if node.deprel != 'root' and node.misc["ClauseHead"]: # TODO: exclude the main clause?
+                results += self.get_t_units([node])
+        return results

From c3221e2ce0718f77de69adeb9462628bf16bee6d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 25 Nov 2019 13:06:37 +0100
Subject: [PATCH 0250/1374] tidy demo.Complexity

---
 udapi/block/demo/complexity.py | 237 +++++++++++++++++----------------
 1 file changed, 119 insertions(+), 118 deletions(-)

diff --git a/udapi/block/demo/complexity.py b/udapi/block/demo/complexity.py
index a5d972e9..020f8b17 100644
--- a/udapi/block/demo/complexity.py
+++ b/udapi/block/demo/complexity.py
@@ -13,7 +13,7 @@ def is_np(node):
 
 
 def is_vp(node):
-    """E.g. prosili, naléhali a žadonili => 1 coordinated verb phrase, head “prosili”. 
+    """E.g. prosili, naléhali a žadonili => 1 coordinated verb phrase, head “prosili”.
 
     [POS == “VERB”, [deprel == “conj”, POS == “VERB”]], unique coordination heads
     TODO: zahrnout i non-VERB?
@@ -30,20 +30,20 @@ def is_vp(node):
 
 def is_relcl(node):
     """Is a given node a head of a relative clause?
-    
+
     Unfortunatelly, UDPipe 2.4 produces just acl instead of acl:relcl.
     """
     if node.deprel == 'acl:relcl':
         return True
-    return node.udeprel == 'acl' and next((c for c in node.children if 'Rel' in c.feats['PronType']), None)
+    return node.udeprel == 'acl' and any('Rel' in c.feats['PronType'] for c in node.children)
 
 
 def is_postponed_nom_mod(node):
     """Is a given node a postponed nominal modifier?
-    
+
     Silvie: [(POS in {“NOUN”, “PROPN”} | POS == “PRON” & feats:PronType == “Prs” & !(feats:Poss==”Yes”)), child with higher word order than parent
     [deprel != “conj”, POS in {“NOUN”, “PROPN”} | POS == “PRON” & feats:PronType == “Prs” & !(feats:Poss==”Yes”)]
-    
+
     TODO: Tohle hledá v češtině zcela běžné jevy jako "vznik díla". Nechceme hledat něco jiného?
     """
     return node.udeprel != 'conj' and is_np(node) and node.parent.precedes(node) and is_np(node.parent)
@@ -61,68 +61,67 @@ def is_complex_nominal(node):
     TODO: beztak bude chtít odfiltrovat copuly: "Jádrem tvorby jsou sbírky." - Jádrem má 3 děti.
     TODO: a nezvýšit ten limit z 2x aspoň na 3x?
     """
-    return is_np(node) and len([n for n in node.children if n.deprel not in ('conj', 'punct', 'case', 'cc', 'dep', 'cop')]) > 1
+    return is_np(node) and len([n for n in node.descendants if n.deprel not in ('conj', 'punct', 'case', 'cc', 'dep', 'cop')]) > 1
 
-class Complexity(BaseWriter):
 
-    def __init__(self, matches=False, **kwargs):
-        super().__init__(**kwargs)
-        self.matches = matches
+def is_finite_clause_head(node):
+    """Is a given node a head of a finite clause?
 
+    Silvie: [(POS == „VERB“ & feats:Verbform == „Fin“ | Verbform == „Part“} ) ] OR [(POS in {„ADJ“, „NOUN“, „PROPN“}, [child POS ==  „AUX“)]]
+    - POS == „VERB“ je zbytečné, protože VerbForm=Part je nastaveno i u ADJ ("je nucen" apod.)
+    - child POS == „AUX“ zase matchuje i např. na "Vidím psa(NOUN), který je(AUX,acl,parent=psa) z dávné doby."
+    - adjectivized predicates (převažující(VerbForm=Part) básně) by neměly být určeny jako clause_head
 
-    def process_tree(self, root):
-        print("# " + root.text)
-        
-        allnodes = root.descendants
-        depth, clause_depth = {0: 0}, {0: 0}
-        queue = deque(root.children)
-        clause_heads = []
-        while queue:
-            node = queue.popleft()
-            depth[node.ord] = depth[node.parent.ord] + 1
-            clause_depth[node.ord] = clause_depth[node.parent.ord]
-            if self.is_finite_clause_head(node):
-                node.misc['ClauseHead'] = 1
-                clause_heads.append(node)
-                clause_depth[node.ord] += 1
-            queue.extend(node.children)
-        max_depth = sorted(depth.values())[-1]
-        max_clause_depth = sorted(clause_depth.values())[-1]
+    * Most finite verbs with deprel=amod are parsing errors - they should have deprel=acl,
+      but for better robustness we include these as well.
+    * Similarly "dep" and "orphan" are mostly parsing errors.
+    * TODO: by uncommenting the nsubj/csubj line, we find few more real clause heads, but also some false positives.
+    """
+    # TODO appos
+    if ((node.udeprel in {'root', 'conj', 'acl', 'advcl', 'ccomp', 'csubj', 'obl', 'parataxis', 'amod', 'dep', 'orphan'}
+         and is_finite_verb(node))
+            #or any(c.udeprel in {'nsubj', 'csubj'} for c in node.children)
+            or (any(c.udeprel == 'cop' for c in node.children) and node.udeprel != 'xcomp')):
+        return True
+    xcomp_child = next((c for c in node.children if c.udeprel == 'xcomp'), None)
+    return xcomp_child and any(c.udeprel == 'cop' for c in xcomp_child.children)
 
-        t_units = self.get_t_units([n for n in root.children if n.deprel == 'root'])
-        total_t_units_length = sum(len(t_unit) for t_unit in t_units)
-        mean_t_unit_length = total_t_units_length / (len(t_units) or 1) # TODO co reportovat, když věta nemá žádné t-units?
-               
-        if not self.matches:
-            print("\t".join(str(x) for x in [root.sent_id, len(non_punct(allnodes)), max_depth, max_clause_depth, mean_t_unit_length]), end='')
-        
-        self.report("clauses", [[n] for n in clause_heads], 'subtree')
-        self.report("adjectivized_predicates", [[n] for n in allnodes if self.is_adjectivized_predicate(n)])
-        self.report("controlled_predicates", [[n] for n in allnodes if self.is_controlled_predicate(n)])
-        self.report("main_clauses", self.get_main_clauses(root), 'subtree_within_clause')
-        self.report("coordinated_verb_phrases", self.get_coord_phrase(root, is_vp))
-        self.report("coordinated_noun_phrases", self.get_coord_phrase(root, is_np))
-        self.report("coordinated_adjective_phrases", self.get_coord_phrase(root, lambda n: n.upos in ("ADJ", "DET")))
-        self.report("coordinated_adverb_phrases", self.get_coord_phrase(root, lambda n: n.upos == "ADV"))
-        self.report("t-units", t_units)
-        self.report("complex_t-units", self.get_complex_t_units(root))
-        # TODO: najde "básně a písně" a "rychtář a rychtářka" UDPipe kdovíproč určil jako ADV a ADV. Zkontrolovat, máme-li nejlepší možný UDPipe model.
-        self.report("relative_clauses", [[n] for n in allnodes if is_relcl(n)], 'subtree_within_clause')
-        self.report("postponed_nominal_modifiers", [[n] for n in allnodes if is_postponed_nom_mod(n)])
-        # TODO postponed_adj_mod si přidal Martin
-        #self.report("postponed_adjective_modifiers", [[n] for n in allnodes if is_postponed_adj_mod(n)])
-        self.report("complex_nominals", [[n] for n in allnodes if is_complex_nominal(n)])
 
-        if not self.matches:
-            # TODO: pro total koordinace asi nemá smysl reportovat matches, jen total count?
-            self.report("coordinated_phrases_total", self.get_coord_phrase(root, lambda _: True))
-            
-            nonpunct_upos = [n.upos for n in non_punct(allnodes)] + ['NONE', 'NONE']
-            brackets = str(len([n for n in allnodes if n.form == '(']))
-            dashes = str(len([n for n in allnodes if n.form in '-–—―'])) # hyphen, en-dash, em-dash, horizonatal bar
-            colons = str(len([n for n in allnodes if n.form == ':']))
-            semicolons = str(len([n for n in allnodes if n.form == ';']))
-            print("\t", "\t".join([nonpunct_upos[0], nonpunct_upos[1], brackets, dashes, colons, semicolons]))
+# TODO: zahrnout i: bude(aux,AUX,parent=chovat) se chovat(VERB,VerbForm=Inf)
+def is_finite_verb(node):
+    return (node.feats['VerbForm'] in {'Fin', 'Part'} and
+            (node.upos == 'VERB' or
+             node.upos == 'ADJ' and any(c.deprel == 'aux:pass' for c in node.children)))
+
+
+def is_adjectivized_predicate(node):
+    """E.g. kouřící komín, zbitý kluk
+
+    Silvie: [(POS == „ADJ“ & feats:VerbForm == „Part“), parent [POS in {„NOUN“, „PROPN“}] ]
+    - parent [POS in {„NOUN“, „PROPN“}] zamezí případům jako
+     "kvůli nesmyslné a stupňující(parent=nesmyslné,deprel=conj) se žárlivosti"
+     "Nové pronikající(parent=Nové,deprel=amod) socialistické myšlení" asi chyba parsingu, mělo být parent=myšlení?
+    - dotaz naopak matchuje na "způsob, jakým jsou popsány", proto přidávám podmínku not node.misc["ClauseHead"]
+    """
+    return (node.feats["VerbForm"] == "Part"
+        and node.upos == "ADJ"
+        and (node.parent.upos in {"NOUN","PROPN"} or (node.udeprel == "conj" and node.parent.upos == "ADJ"))
+        and not node.misc["ClauseHead"])
+
+
+def is_controlled_predicate(node):
+    """E.g. Mohli jsme odejít i zůstat.
+
+    TODO: Chceme zahrnout i druhý a další člen koordinace, např. "stihl napsat a publikovat",
+    tedy node.udeprel == "conj" and node.parent.udeprel == "xcomp"?
+    """
+    return node.deprel == "xcomp"
+
+class Complexity(BaseWriter):
+
+    def __init__(self, matches=False, **kwargs):
+        super().__init__(**kwargs)
+        self.matches = matches
 
 
     def report(self, category, groups, expand_type='no'):
@@ -165,59 +164,6 @@ def print_match(self, category, group, expand_type='no'):
         print("\t".join([category, nodes[0].root.sent_id, lemmas, tags, n_tokens]))
 
 
-    def is_finite_clause_head(self, node):
-        """Is a given node a head of a finite clause?
-
-        Silvie: [(POS == „VERB“ & feats:Verbform == „Fin“ | Verbform == „Part“} ) ] OR [(POS in {„ADJ“, „NOUN“, „PROPN“}, [child POS ==  „AUX“)]]
-        - POS == „VERB“ je zbytečné, protože VerbForm=Part je nastaveno i u ADJ ("je nucen" apod.)
-        - child POS == „AUX“ zase matchuje i např. na "Vidím psa(NOUN), který je(AUX,acl,parent=psa) z dávné doby."
-        - adjectivized predicates (převažující(VerbForm=Part) básně) by neměly být určeny jako clause_head
-        
-        * Most finite verbs with deprel=amod are parsing errors - they should have deprel=acl,
-          but for better robustness we include these as well.
-        * Similarly "dep" and "orphan" are mostly parsing errors.
-        * TODO: by uncommenting the nsubj/csubj line, we find few more real clause heads, but also some false positives.    
-        """
-        # TODO appos
-        if ((node.udeprel in {'root', 'conj', 'acl', 'advcl', 'ccomp', 'csubj', 'obl', 'parataxis', 'amod', 'dep', 'orphan'} and self.is_finite_verb(node))
-                #or any(c.udeprel in {'nsubj', 'csubj'} for c in node.children)
-                or (any(c.udeprel == 'cop' for c in node.children) and node.udeprel != 'xcomp')):
-            return True
-        xcomp_child = next((c for c in node.children if c.udeprel == 'xcomp'), None)
-        return xcomp_child and any(c.udeprel == 'cop' for c in xcomp_child.children)
-
-
-    # TODO: zahrnout i: bude(aux,AUX,parent=chovat) se chovat(VERB,VerbForm=Inf)
-    def is_finite_verb(self, node):
-        return (node.feats['VerbForm'] in {'Fin', 'Part'} and
-                (node.upos == 'VERB' or
-                 node.upos == 'ADJ' and any(c.deprel == 'aux:pass' for c in node.children)))
-
-
-    def is_adjectivized_predicate(self, node):
-        """E.g. kouřící komín, zbitý kluk
-
-        Silvie: [(POS == „ADJ“ & feats:VerbForm == „Part“), parent [POS in {„NOUN“, „PROPN“}] ]
-        - parent [POS in {„NOUN“, „PROPN“}] zamezí případům jako
-         "kvůli nesmyslné a stupňující(parent=nesmyslné,deprel=conj) se žárlivosti"
-         "Nové pronikající(parent=Nové,deprel=amod) socialistické myšlení" asi chyba parsingu, mělo být parent=myšlení?
-        - dotaz naopak matchuje na "způsob, jakým jsou popsány", proto přidávám podmínku not node.misc["ClauseHead"]
-        """
-        return (node.feats["VerbForm"] == "Part"
-            and node.upos == "ADJ"
-            and (node.parent.upos in {"NOUN","PROPN"} or (node.udeprel == "conj" and node.parent.upos == "ADJ"))
-            and not node.misc["ClauseHead"])
-
-
-    def is_controlled_predicate(self, node):
-        """E.g. Mohli jsme odejít i zůstat.
-        
-        TODO: Chceme zahrnout i druhý a další člen koordinace, např. "stihl napsat a publikovat",
-        tedy node.udeprel == "conj" and node.parent.udeprel == "xcomp"?
-        """
-        return node.deprel == "xcomp"
-
-
     def get_main_clauses(self, root):
         main_heads = []
         for main_head in root.children:
@@ -225,6 +171,7 @@ def get_main_clauses(self, root):
             main_heads.extend(n for n in main_head.children if n.udeprel == 'conj')
         return [[n] for n in main_heads]
 
+
     def get_coord_phrase(self, root, phrase_type_function):
         results = []
         for node in root.descendants:
@@ -238,7 +185,7 @@ def get_coord_phrase(self, root, phrase_type_function):
                     results.append(sorted([node] + conjuncts + conjunctions, key=lambda n: n.ord))
         return results
 
-
+    # TODO koordinace hlavních i vedlejších vět
     def get_t_units(self, main_heads):
         results = []
         for main_head in main_heads:
@@ -253,15 +200,69 @@ def get_t_units(self, main_heads):
                     main_clause.append(node)
                     stack.extend(node.children)
             main_clause = sorted(main_clause, key=lambda n: n.ord)
-            
+
             for dep_clause_head in dep_heads:
-                results.append(main_clause + self.expand_subtree([dep_clause_head], 'subtree')) # TODO subtree_within_clause?
+                results.append(main_clause + self.expand_subtree([dep_clause_head], 'subtree'))
         return results
 
-    
+    # TODO complex t-unit má jinou definici: 3 klauze
     def get_complex_t_units(self, root):
         results = []
         for node in root.descendants:
             if node.deprel != 'root' and node.misc["ClauseHead"]: # TODO: exclude the main clause?
                 results += self.get_t_units([node])
         return results
+
+
+    def process_tree(self, root):
+        print("# " + root.text)
+
+        allnodes = root.descendants
+        depth, clause_depth = {0: 0}, {0: 0}
+        queue = deque(root.children)
+        clause_heads = []
+        while queue:
+            node = queue.popleft()
+            depth[node.ord] = depth[node.parent.ord] + 1
+            clause_depth[node.ord] = clause_depth[node.parent.ord]
+            if is_finite_clause_head(node):
+                node.misc['ClauseHead'] = 1
+                clause_heads.append(node)
+                clause_depth[node.ord] += 1
+            queue.extend(node.children)
+        max_depth = sorted(depth.values())[-1]
+        max_clause_depth = sorted(clause_depth.values())[-1]
+
+        t_units = self.get_t_units([n for n in root.children if n.deprel == 'root'])
+        total_t_units_length = sum(len(t_unit) for t_unit in t_units)
+        mean_t_unit_length = total_t_units_length / (len(t_units) or 1) # TODO co reportovat, když věta nemá žádné t-units?
+
+        if not self.matches:
+            print("\t".join(str(x) for x in [root.sent_id, len(non_punct(allnodes)), max_depth, max_clause_depth, mean_t_unit_length]), end='')
+
+        self.report("clauses", [[n] for n in clause_heads], 'subtree')
+        self.report("adjectivized_predicates", [[n] for n in allnodes if is_adjectivized_predicate(n)])
+        self.report("controlled_predicates", [[n] for n in allnodes if is_controlled_predicate(n)])
+        self.report("main_clauses", self.get_main_clauses(root), 'subtree_within_clause')
+        self.report("coordinated_verb_phrases", self.get_coord_phrase(root, is_vp))
+        self.report("coordinated_noun_phrases", self.get_coord_phrase(root, is_np))
+        self.report("coordinated_adjective_phrases", self.get_coord_phrase(root, lambda n: n.upos in ("ADJ", "DET")))
+        self.report("coordinated_adverb_phrases", self.get_coord_phrase(root, lambda n: n.upos == "ADV"))
+        self.report("t-units", t_units)
+        self.report("complex_t-units", self.get_complex_t_units(root))
+        # TODO: najde "básně a písně" a "rychtář a rychtářka" UDPipe kdovíproč určil jako ADV a ADV. Zkontrolovat, máme-li nejlepší možný UDPipe model.
+        self.report("relative_clauses", [[n] for n in allnodes if is_relcl(n)], 'subtree_within_clause')
+        self.report("postponed_nominal_modifiers", [[n] for n in allnodes if is_postponed_nom_mod(n)])
+        self.report("postponed_adjective_modifiers", [[n] for n in allnodes if is_postponed_adj_mod(n)])
+        self.report("complex_nominals", [[n] for n in allnodes if is_complex_nominal(n)])
+
+        if not self.matches:
+            # TODO: pro total koordinace asi nemá smysl reportovat matches, jen total count?
+            self.report("coordinated_phrases_total", self.get_coord_phrase(root, lambda _: True))
+
+            nonpunct_upos = [n.upos for n in non_punct(allnodes)] + ['NONE', 'NONE']
+            brackets = str(len([n for n in allnodes if n.form == '(']))
+            dashes = str(len([n for n in allnodes if n.form in '-–—―'])) # hyphen, en-dash, em-dash, horizonatal bar
+            colons = str(len([n for n in allnodes if n.form == ':']))
+            semicolons = str(len([n for n in allnodes if n.form == ';']))
+            print("\t", "\t".join([nonpunct_upos[0], nonpunct_upos[1], brackets, dashes, colons, semicolons]))

From c700ea1e276b9a3b63a0c16ede00daa5c95e7863 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 10 Dec 2019 14:27:37 +0100
Subject: [PATCH 0251/1374] fix a bug in eval.F1

---
 udapi/block/eval/f1.py | 66 ++++++++++++++++++++++++++++++------------
 1 file changed, 48 insertions(+), 18 deletions(-)

diff --git a/udapi/block/eval/f1.py b/udapi/block/eval/f1.py
index a4f93a1b..982e4190 100644
--- a/udapi/block/eval/f1.py
+++ b/udapi/block/eval/f1.py
@@ -112,9 +112,32 @@ def process_tree(self, tree):
 
         pred_tokens = ['_'.join(n.get_attrs(self.attrs)) for n in tree.descendants]
         gold_tokens = ['_'.join(n.get_attrs(self.attrs)) for n in gold_tree.descendants]
-        common = find_lcs(pred_tokens, gold_tokens)
 
-        if self.focus is not None:
+        # lcs("abc", "acb") can be either "ab" or "ac".
+        # We want to prefer the LCS with the highest number of non-focused tokens.
+        # E.g. if focus="," then lcs("a,c", "ac,") should be "ac" and the comma should be evaluated
+        # as non-aligned, i.e. eval.F1 should return precision=recall=f1=0 for this sentence.
+        if self.focus is None:
+            common = find_lcs(pred_tokens, gold_tokens)
+        else:
+            nf_pred_tokens = [x for x in pred_tokens if not self.focus.fullmatch(x)]
+            nf_gold_tokens = [x for x in gold_tokens if not self.focus.fullmatch(x)]
+            nf_common = find_lcs(nf_pred_tokens, nf_gold_tokens)
+            i, j, c, un_pred, un_gold, common  = 0, 0, 0, [], [], []
+            while i < len(pred_tokens) and j < len(gold_tokens):
+                while nf_common[c] != pred_tokens[i]:
+                    un_pred.append(pred_tokens[i])
+                    i += 1
+                while nf_common[c] != gold_tokens[j]:
+                    un_gold.append(gold_tokens[j])
+                    j += 1
+                common += find_lcs(un_pred, un_gold)
+                un_pred, un_gold  = [], []
+                while c < len(nf_common) and nf_common[c] == pred_tokens[i] and nf_common[c] == gold_tokens[j]:
+                    i, j, c = i+1, j+1, c+1
+                if c == len(nf_common):
+                    common += find_lcs(pred_tokens[i+1:], gold_tokens[j+1:])
+                    break
             common = [x for x in common if self.focus.fullmatch(x)]
             pred_tokens = [x for x in pred_tokens if self.focus.fullmatch(x)]
             gold_tokens = [x for x in gold_tokens if self.focus.fullmatch(x)]
@@ -172,22 +195,29 @@ def process_end(self):
 
 
 # difflib.SequenceMatcher does not compute LCS, so let's implement it here
-# TODO: make faster by trimming common prefix and sufix
 def find_lcs(x, y):
     """Find longest common subsequence."""
     m, n = len(x), len(y)
-    C = [[0] * (n + 1) for _ in range(m + 1)]
-    for i in range(1, m + 1):
-        for j in range(1, n + 1):
-            C[i][j] = C[i - 1][j - 1] + 1 if x[i - 1] == y[j - 1] else max(C[i][j - 1], C[i - 1][j])
-    index = C[m][n]
-    lcs = [None] * index
-    while m > 0 and n > 0:
-        if x[m - 1] == y[n - 1]:
-            lcs[index - 1] = x[m - 1]
-            m, n, index = m - 1, n - 1, index - 1
-        elif C[m - 1][n] > C[m][n - 1]:
-            m -= 1
-        else:
-            n -= 1
-    return lcs
+    if m == 0 or n == 0:
+        return []
+    elif x[0] == y[0]:
+        i = 1
+        while i < min(m, n) and x[i] == y[i]:
+            i += 1
+        return x[:i] + (find_lcs(x[i:], y[i:]) if i < min(m, n) else [])
+    else:
+        C = [[0] * (n + 1) for _ in range(m + 1)]
+        for i in range(1, m + 1):
+            for j in range(1, n + 1):
+                C[i][j] = C[i - 1][j - 1] + 1 if x[i - 1] == y[j - 1] else max(C[i][j - 1], C[i - 1][j])
+        index = C[m][n]
+        lcs = [None] * index
+        while m > 0 and n > 0:
+            if x[m - 1] == y[n - 1]:
+                lcs[index - 1] = x[m - 1]
+                m, n, index = m - 1, n - 1, index - 1
+            elif C[m - 1][n] > C[m][n - 1]:
+                m -= 1
+            else:
+                n -= 1
+        return lcs

From dd0fe498a8ca6a8177a8c8fdcb106a55fb1024d4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 12 Dec 2019 14:52:09 +0100
Subject: [PATCH 0252/1374] use `is` instead of `==` for node identity checks,
 it is faster

---
 udapi/core/node.py | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index c0684e60..2b1006fd 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -254,17 +254,17 @@ def parent(self, new_parent):
         (from the list of original parent's children).
         """
         # If the parent is already assigned, return.
-        if self.parent == new_parent:
+        if self.parent is new_parent:
             return
 
         # The node itself couldn't be assigned as a parent.
-        if self == new_parent:
+        if self is new_parent:
             raise ValueError('Cannot set a node as its own parent (cycle are forbidden): %s' % self)
 
         # Check if the current Node is not an antecedent of the new parent.
         climbing_node = new_parent
         while not climbing_node.is_root():
-            if climbing_node == self:
+            if climbing_node is self:
                 raise ValueError('Setting the parent of %s to %s would lead to a cycle.'
                                  % (self, new_parent))
             climbing_node = climbing_node.parent
@@ -272,10 +272,10 @@ def parent(self, new_parent):
         # Remove the current Node from the children of the old parent.
         # Forbid moving nodes from one tree to another using parent setter.
         if self._parent:
-            self._parent._children = [node for node in self.parent.children if node != self]
+            self._parent._children = [node for node in self.parent.children if node is not self]
             # TODO: .root is currently computed, so it is quite slow
             old_root, new_root = self._parent.root, climbing_node
-            if old_root != new_root:
+            if old_root is not new_root:
                 raise ValueError('Cannot move nodes between trees with parent setter, '
                                  'use new_root.steal_nodes(nodes_to_be_moved) instead')
         # Set the new parent.
@@ -342,7 +342,7 @@ def is_descendant_of(self, node):
         """Is the current node a descendant of the node given as argument?"""
         climber = self.parent
         while climber:
-            if climber == node:
+            if climber is node:
                 return True
             climber = climber.parent
         return False
@@ -392,7 +392,7 @@ def remove(self, children=None):
             `warn` means to issue a warning if any children are present and delete them.
             `rehang_warn` means to rehang and warn:-).
         """
-        self.parent._children = [child for child in self.parent.children if child != self]
+        self.parent._children = [child for child in self.parent.children if child is not self]
         if children is not None and self.children:
             if children.startswith('rehang'):
                 for child in self.children:
@@ -413,7 +413,7 @@ def shift(self, reference_node, after=0, move_subtree=0, reference_subtree=0):
         reference_ord = reference_node.ord
 
         if reference_subtree:
-            for node in [n for n in reference_node.descendants() if n != self]:
+            for node in [n for n in reference_node.descendants() if n is not self]:
                 if (after and node.ord > reference_ord) or (not after and node.ord < reference_ord):
                     reference_ord = node.ord
 

From 05e63a375de5b4e86f389fecc89b238c4feae5dd Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 12 Dec 2019 14:55:54 +0100
Subject: [PATCH 0253/1374] nicer error message for `node.parent = None`

---
 udapi/core/node.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 2b1006fd..dd3d2980 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -257,9 +257,11 @@ def parent(self, new_parent):
         if self.parent is new_parent:
             return
 
-        # The node itself couldn't be assigned as a parent.
+        # The node itself couldn't be assigned as a parent. None cannot be used as parent.
         if self is new_parent:
             raise ValueError('Cannot set a node as its own parent (cycle are forbidden): %s' % self)
+        if new_parent is None:
+            raise ValueError('Cannot set None as parent: %s' % self)
 
         # Check if the current Node is not an antecedent of the new parent.
         climbing_node = new_parent

From 19b4e680b2ff7bbbec6060b9b97bcb1949f3196d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 26 Mar 2020 20:20:01 +0100
Subject: [PATCH 0254/1374] return `sys.stdout` always back to its original
 value

and close the filehandle (unless it is the real __stdout__).
Fixes #57.
---
 udapi/core/basewriter.py | 31 ++++++++++++++++---------------
 1 file changed, 16 insertions(+), 15 deletions(-)

diff --git a/udapi/core/basewriter.py b/udapi/core/basewriter.py
index ed574c95..956d08c9 100644
--- a/udapi/core/basewriter.py
+++ b/udapi/core/basewriter.py
@@ -42,6 +42,7 @@ def before_process_document(self, document):
             logging.info('Writing to filehandle.')
             sys.stdout = self.files.filehandle
             return
+        old_filehandle = sys.stdout
         if self.orig_files == '-':
             if self.docname_as_file:
                 docname = document.meta.get('docname', None)
@@ -52,23 +53,23 @@ def before_process_document(self, document):
                     logging.warning('docname_as_file=1 but the document contains no docname')
             else:
                 sys.stdout = sys.__stdout__
-            return
-
-        old_filehandle = sys.stdout
-        if old_filehandle.fileno != sys.stdout.fileno:
+        else:
+            filename = self.next_filename()
+            if filename is None:
+                raise RuntimeError('There are more documents to save than filenames given (%s)'
+                                % self.orig_files)
+            elif filename == '-':
+                logging.info('Writing to stdout.')
+                sys.stdout = sys.__stdout__
+            else:
+                logging.info('Writing to file %s.', filename)
+                sys.stdout = open(filename, 'wt', encoding=self.encoding, newline=self.newline)
+        if old_filehandle.fileno() not in (sys.stdout.fileno(), sys.__stdout__.fileno()):
             old_filehandle.close()
 
-        filename = self.next_filename()
-        if filename is None:
-            raise RuntimeError('There are more documents to save than filenames given (%s)'
-                               % self.orig_files)
-        elif filename == '-':
-            logging.info('Writing to stdout.')
-            sys.stdout = sys.__stdout__
-        else:
-            logging.info('Writing to file %s.', filename)
-            sys.stdout = open(filename, 'wt', encoding=self.encoding, newline=self.newline)
 
     def after_process_document(self, document):
-        if self.orig_files == '<filehandle>':
+        sys.stdout.flush()
+        if sys.stdout.fileno() != sys.__stdout__.fileno():
+            sys.stdout.close()
             sys.stdout = sys.__stdout__

From a09e43340c6cc4c71bf82948a25c74280681c81a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 27 Mar 2020 00:09:30 +0100
Subject: [PATCH 0255/1374] Jupyter stdout doesn't support fileno() and
 __stdout__ != stdout

---
 udapi/core/basewriter.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/udapi/core/basewriter.py b/udapi/core/basewriter.py
index 956d08c9..1d64e874 100644
--- a/udapi/core/basewriter.py
+++ b/udapi/core/basewriter.py
@@ -13,6 +13,7 @@ def __init__(self, files='-', filehandle=None, docname_as_file=False, encoding='
                  newline='\n', **kwargs):
         super().__init__(**kwargs)
         self.orig_files = files
+        self.orig_stdout = sys.stdout
         if filehandle is not None:
             files = None
             self.orig_files = '<filehandle>'
@@ -52,7 +53,7 @@ def before_process_document(self, document):
                 else:
                     logging.warning('docname_as_file=1 but the document contains no docname')
             else:
-                sys.stdout = sys.__stdout__
+                sys.stdout = self.orig_stdout
         else:
             filename = self.next_filename()
             if filename is None:
@@ -60,16 +61,16 @@ def before_process_document(self, document):
                                 % self.orig_files)
             elif filename == '-':
                 logging.info('Writing to stdout.')
-                sys.stdout = sys.__stdout__
+                sys.stdout = self.orig_stdout
             else:
                 logging.info('Writing to file %s.', filename)
                 sys.stdout = open(filename, 'wt', encoding=self.encoding, newline=self.newline)
-        if old_filehandle.fileno() not in (sys.stdout.fileno(), sys.__stdout__.fileno()):
+        if old_filehandle not in (sys.stdout, self.orig_stdout):
             old_filehandle.close()
 
 
     def after_process_document(self, document):
         sys.stdout.flush()
-        if sys.stdout.fileno() != sys.__stdout__.fileno():
+        if sys.stdout != self.orig_stdout:
             sys.stdout.close()
-            sys.stdout = sys.__stdout__
+            sys.stdout = self.orig_stdout

From 29e1edab9823083b8440af872d9a9db4e100e3b8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 19 Apr 2020 14:45:48 +0200
Subject: [PATCH 0256/1374] Processing enhanced dependencies does not work.\

---
 udapi/core/node.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index dd3d2980..02b6f049 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -228,7 +228,11 @@ def deps(self):
                 return self._deps
 
             for raw_dependency in self._raw_deps.split('|'):
-                head, deprel = raw_dependency.split(':')
+                # Deprel itself may contain one or more ':' (subtypes).
+                pieces = raw_dependency.split(':')
+                head = pieces[0]
+                deprel = ':'.join(pieces[1:])
+                ###!!! The following line will throw an exception if the head is an empty node, e.g., '7.1'.
                 parent = nodes[int(head)]
                 self._deps.append({'parent': parent, 'deprel': deprel})
 

From 33b0d260dc085ed09626cda052bf9184a83ba226 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 20 Apr 2020 14:48:43 +0200
Subject: [PATCH 0257/1374] Another quick patch of node.deps.

---
 udapi/core/node.py | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 02b6f049..ee5bc24e 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -232,8 +232,15 @@ def deps(self):
                 pieces = raw_dependency.split(':')
                 head = pieces[0]
                 deprel = ':'.join(pieces[1:])
-                ###!!! The following line will throw an exception if the head is an empty node, e.g., '7.1'.
-                parent = nodes[int(head)]
+                # Empty nodes have to be located differently than normal nodes.
+                if '.' in head:
+                    matching = [x for x in self.root.empty_nodes if x.ord == head]
+                    if len(matching) > 0:
+                        parent = matching[0]
+                    else:
+                        parent = None ###!!! what should we do here?
+                else:
+                    parent = nodes[int(head)]
                 self._deps.append({'parent': parent, 'deprel': deprel})
 
         return self._deps

From 912af2639c1fae9d2d7648f1b9a745b234d02edb Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 4 May 2020 11:41:59 +0200
Subject: [PATCH 0258/1374] prevent ud.FixPunct to create multiple sub-roots

Fixes #60
---
 udapi/block/ud/fixpunct.py | 32 ++++++++++++++++++++++----------
 1 file changed, 22 insertions(+), 10 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 96ec0ed5..55097997 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -61,7 +61,9 @@ def __init__(self, check_paired_punct_upos=False, copy_to_enhanced=False, **kwar
         self.copy_to_enhanced = copy_to_enhanced
 
     def process_tree(self, root):
-        # First, make sure no PUNCT has children
+        # First, make sure no PUNCT has children.
+        # This may introduce multiple subroots, which will be fixed later on
+        # (preventing to temporarily create multiple subroots here would prevent fixing some errors).
         for node in root.descendants:
             while node.parent.upos == "PUNCT":
                 node.parent = node.parent.parent
@@ -84,15 +86,25 @@ def process_tree(self, root):
             if node.upos == "PUNCT" and not self._punct_type[node.ord]:
                 self._fix_subord_punct(node)
 
-        # Finally, check if root is still marked with deprel=root.
-        # This may not hold if the original root was a paired punctuation, which was rehanged.
-        for node in root.children:
-            if node.udeprel != 'root':
-                node.udeprel = 'root'
-                for another_node in root.descendants:
-                    if another_node.parent != root and another_node.udeprel == 'root':
-                        another_node.udeprel = 'punct'
 
+        # UD requires "exactly one word is the head of the sentence, dependent on a notional ROOT", i.e. a single "subroot".
+        # This seems to be a stronger rule than no-PUNCT-children because it is checked by the validator.
+        # So lets prevent multiple subroots (at the cost of possibly re-introducing PUNCT-children).
+        if len(root.children) > 1:
+            selected_subroot = next((n for n in root.children if n.udeprel == 'root'), root.children[0])
+            for a_subroot in root.children:
+                if a_subroot != selected_subroot:
+                    a_subroot.parent = selected_subroot
+
+        # Check if the subroot is still marked with deprel=root.
+        # This may not hold if the original subroot was a paired punctuation, which was rehanged.
+        if root.children[0].udeprel != 'root':
+            root.children[0].udeprel = 'root'
+            for another_node in root.children[0].descendants:
+                if another_node.udeprel == 'root':
+                    another_node.udeprel = 'punct'
+
+        # TODO: This block changes parents not only for PUNCT nodes. These should be reflected into enhanced deps as well.
         if self.copy_to_enhanced:
             for node in root.descendants:
                 if node.upos == "PUNCT":
@@ -135,7 +147,7 @@ def _fix_subord_punct(self, node):
         # because climbing higher would cause a non-projectivity (the punct would be the gap).
         l_path, r_path = [l_cand], [r_cand]
         if l_cand is None or l_cand.is_root():
-            l_cand = None
+            l_cand, l_path = None, []
         else:
             while (not l_cand.parent.is_root() and l_cand.parent.precedes(node)
                    and not node.precedes(l_cand.descendants(add_self=1)[-1])):

From 1e4004f577f3c6e471528ce4b87dd570ce8f2706 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 11 May 2020 14:15:47 +0200
Subject: [PATCH 0259/1374] ud.FixPunct should not introduce punct-nonproj-gap
 errors

(in addition to punct-nonproj errors, as defined and checked by the UD validator and ud.MarkBugs).
Fixes #52
---
 udapi/block/ud/fixpunct.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 55097997..cc34a0d0 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -159,7 +159,8 @@ def _fix_subord_punct(self, node):
                 r_cand = r_cand.parent
                 r_path.append(r_cand)
 
-        # Filter out candidates which would lead to non-projectivities.
+        # Filter out candidates which would lead to non-projectivities, i.e. bugs
+        # punct-nonproj and punct-nonproj-gap as checked by the UD validator and ud.MarkBugs.
         orig_parent = node.parent
         l_path = [n for n in l_path if n and self._will_be_projective(node, n)]
         r_path = [n for n in r_path if n and self._will_be_projective(node, n)]
@@ -196,7 +197,7 @@ def _fix_subord_punct(self, node):
 
     def _will_be_projective(self, node, cand):
         node.parent = cand
-        return not node.is_nonprojective()
+        return not node.is_nonprojective() and not self._causes_gap(node)
 
     def _causes_gap(self, node):
         return node.is_nonprojective_gap() and not node.parent.is_nonprojective_gap()

From 2385ff1218726157b4f0cba1bb6d3a905ec5562b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 29 Jun 2020 23:05:01 +0200
Subject: [PATCH 0260/1374] support Udpipe segmentation w/o
 tokenization/tagging/parsing

e.g. `udpipe.En tag=0 parse=0 tokenize=0 resegment=1`

Also, even when `tokenize=1 resegment=1`, the newly created trees
should have `tree.text` set to the correct sentence string.
---
 udapi/block/udpipe/base.py | 12 +++++++++++-
 udapi/tool/udpipe.py       | 13 +++++++++++++
 2 files changed, 24 insertions(+), 1 deletion(-)

diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
index 34028a4a..3ec4a131 100644
--- a/udapi/block/udpipe/base.py
+++ b/udapi/block/udpipe/base.py
@@ -152,7 +152,6 @@ def process_document(self, doc):
                         if self.resegment and len(new_trees) > 1:
                             orig_bundle_id = bundle.bundle_id
                             bundle.bundle_id = orig_bundle_id + '-1'
-                            tree.text = None
                             for i, new_tree in enumerate(new_trees[1:], 2):
                                 new_bundle = Bundle(document=doc, bundle_id=orig_bundle_id + '-' + str(i))
                                 new_tree.zone = tree.zone
@@ -160,6 +159,17 @@ def process_document(self, doc):
                                 new_bundles.append(new_bundle)
                     elif not tok and tag and par:
                         self.tool.tag_parse_tree(tree)
+                    elif not tok and not tag and not par and self.resegment:
+                        sentences = self.tool.segment_text(tree.text)
+                        if len(sentences) > 1:
+                            orig_bundle_id = bundle.bundle_id
+                            bundle.bundle_id = orig_bundle_id + '-1'
+                            tree.text = sentences[0]
+                            for i, sentence in enumerate(sentences[1:], 2):
+                                new_bundle = Bundle(document=doc, bundle_id=orig_bundle_id + '-' + str(i))
+                                new_tree = new_bundle.create_tree(zone=tree.zone)
+                                new_tree.text = sentence
+                                new_bundles.append(new_bundle)
                     else:
                         raise ValueError("Unimplemented tokenize=%s tag=%s parse=%s" % (tok, tag, par))
         doc.bundles = new_bundles
diff --git a/udapi/tool/udpipe.py b/udapi/tool/udpipe.py
index c81a7562..c08785da 100644
--- a/udapi/tool/udpipe.py
+++ b/udapi/tool/udpipe.py
@@ -92,6 +92,7 @@ def tokenize_tag_parse_tree(self, root, resegment=False, tag=True, parse=True):
         for u_sentence in u_sentences:
             if not new_root:
                 new_root = Root()
+            new_root.text = u_sentence.getText()
             heads, nodes = [], [new_root]
             u_words = u_sentence.words
             for i in range(1, u_words.size()):
@@ -110,3 +111,15 @@ def tokenize_tag_parse_tree(self, root, resegment=False, tag=True, parse=True):
             trees.append(new_root)
             new_root = None
         return trees
+
+    def segment_text(self, text):
+        """Segment the provided text into sentences."""
+        self.tokenizer.setText(text)
+        is_another = True
+        sentences = []
+        while is_another:
+            u_sentence = Sentence()
+            is_another = self.tokenizer.nextSentence(u_sentence)
+            if is_another:
+                sentences.append(u_sentence.getText())
+        return sentences

From 000205820e632461f36455b48fd60af4c58ef3cb Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 21 Oct 2020 10:40:23 +0200
Subject: [PATCH 0261/1374] Added a block to fix pseudocopulas in a UD
 treebank.

---
 udapi/block/ud/fixpseudocop.py | 39 ++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 udapi/block/ud/fixpseudocop.py

diff --git a/udapi/block/ud/fixpseudocop.py b/udapi/block/ud/fixpseudocop.py
new file mode 100644
index 00000000..ab07eaaa
--- /dev/null
+++ b/udapi/block/ud/fixpseudocop.py
@@ -0,0 +1,39 @@
+"""Block to fix annotation of verbs that are currently treated as copulas
+   but they should be treated as normal verbs (with secondary predication)
+   instead."""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixPseudoCop(Block):
+
+    def __init__(self, lemma, **kwargs):
+        """Create the ud.FixPseudoCop block instance.
+
+        Args:
+        lemma: the lemma of the pseudocopula that should be fixed
+        """
+        super().__init__(**kwargs)
+        self.lemma = lemma
+
+    def process_node(self, node):
+        pseudocop = self.lemma
+        if node.lemma == pseudocop and node.udeprel == "cop":
+            secpred = node.parent
+            grandparent = secpred.parent
+            node.parent = grandparent
+            node.deprel = secpred.deprel
+            secpred.parent = node
+            secpred.deprel = "xcomp"
+            ###!!! We should also take care of DEPS if they exist.
+            # As a copula, the word was tagged AUX. Now it should be VERB.
+            node.upos = "VERB"
+            # Examine the children of the original parent.
+            # Those that modify the clause should be re-attached to me.
+            # Those that modify the word (noun, adjective) should stay there.
+            for c in secpred.children:
+                # obl is borderline. It could modify an adjective rather than a clause.
+                # obj and iobj should not occur in copular clauses but it sometimes
+                # occurs with pseudocopulas: "I declare him handsome."
+                if re.match("(nsubj|csubj|advmod|advcl|obj|iobj|obl|aux|mark|punct|cc|expl|dislocated|vocative|discourse|parataxis)", c.udeprel):
+                    c.parent = node

From 2fb4e005c76473bbd9ee64cf40a235078f1f09b3 Mon Sep 17 00:00:00 2001
From: Francesco Mambrini <f.mambrini@gmail.com>
Date: Sat, 7 Nov 2020 14:30:08 +0100
Subject: [PATCH 0262/1374] Issue 62: proposed fix and test

---
 udapi/core/node.py               |  4 ++-
 udapi/core/tests/test_enhdeps.py | 62 ++++++++++++++++++++++++++++++++
 2 files changed, 65 insertions(+), 1 deletion(-)
 create mode 100644 udapi/core/tests/test_enhdeps.py

diff --git a/udapi/core/node.py b/udapi/core/node.py
index dd3d2980..0851f202 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -195,7 +195,9 @@ def raw_deps(self):
         if self._deps is not None:
             serialized_deps = []
             for secondary_dependence in self._deps:
-                serialized_deps.append('%d:%s' % (secondary_dependence[
+                # serialized_deps.append('%d:%s' % (secondary_dependence[
+                #    'parent'].ord, secondary_dependence['deprel']))
+                serialized_deps.append('{}:{}'.format(secondary_dependence[
                     'parent'].ord, secondary_dependence['deprel']))
             self._raw_deps = '|'.join(serialized_deps)
         return self._raw_deps
diff --git a/udapi/core/tests/test_enhdeps.py b/udapi/core/tests/test_enhdeps.py
new file mode 100644
index 00000000..fd80b3f2
--- /dev/null
+++ b/udapi/core/tests/test_enhdeps.py
@@ -0,0 +1,62 @@
+import unittest
+import os
+import udapi
+
+from udapi.core.root import Root
+from udapi.core.node import Node, find_minimal_common_treelet
+from udapi.core.document import Document
+from udapi.block.read.conllu import Conllu as ConlluReader
+from udapi.block.write.conllu import Conllu as ConlluWriter
+
+
+class TestEnhDeps(unittest.TestCase):
+    """Unit tests for udapi.core.node and enhanced dependecies.
+    Tests the behaviour with empty nodes (with decimal ord, such as 0.1, 2.3 etc.) as well"""
+
+    @classmethod
+    def setUpClass(cls):
+        cls.doc = Document()
+        cls.data = os.path.join(os.path.dirname(udapi.__file__), "core", "tests", "data", "enh_deps.conllu")
+        cls.doc.load_conllu(cls.data)
+        cls.tree = cls.doc.bundles[0].get_tree()
+        cls.nodes = cls.tree.descendants
+        cls.add_empty_node(cls.tree, 3)
+
+    @staticmethod
+    def add_empty_node(tree, ord_before, decimal=1):
+        """Add an empty node to tree after the node with index `ord_before`.
+        Empty node will receive ord=`ord_before`.`decimal`"""
+        e = tree.create_empty_child()
+        e.ord = float('{}.{}'.format(ord_before, decimal))
+        e.form = "E{}".format(e.ord)
+
+    def test_datapath(self):
+        self.assertTrue(os.path.isfile(self.data))
+
+    def test_nodes(self):
+        self.assertEqual(6, len(self.nodes))
+
+    def test_ord_type(self):
+        self.assertIsNot(str, type(self.nodes[0].ord))
+
+    def test_create_empty(self):
+        writer = ConlluWriter()
+        writer.apply_on_document(self.doc)
+        # self.tree.print_subtree()
+        self.assertGreater(len(self.tree.empty_nodes), 0)
+
+    def test_regular_deps(self):
+
+        n = self.nodes[0]
+        self.assertEqual("0:root|2:amod", n.raw_deps)
+
+    def test_create_deps2empty(self):
+        e = self.tree.empty_nodes[0]
+        h = self.nodes[1]
+        d = self.nodes[5]
+        e.deps.append({'parent': h, 'deprel':'dep:e2h'})
+        d.deps.append({'parent': e, 'deprel': 'dep:d2e'})
+        self.assertEqual("2:dep:e2h", e.raw_deps, )
+        self.assertEqual("5:conj|3.1:dep:d2e", d.raw_deps)
+
+

From fd1e4a0806877f602c35cdad767c59c6ea49ee2c Mon Sep 17 00:00:00 2001
From: Francesco Mambrini <f.mambrini@gmail.com>
Date: Sat, 7 Nov 2020 14:38:54 +0100
Subject: [PATCH 0263/1374] Issue 62: cleaned up previous code

---
 udapi/core/node.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 0851f202..b51e5505 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -195,8 +195,6 @@ def raw_deps(self):
         if self._deps is not None:
             serialized_deps = []
             for secondary_dependence in self._deps:
-                # serialized_deps.append('%d:%s' % (secondary_dependence[
-                #    'parent'].ord, secondary_dependence['deprel']))
                 serialized_deps.append('{}:{}'.format(secondary_dependence[
                     'parent'].ord, secondary_dependence['deprel']))
             self._raw_deps = '|'.join(serialized_deps)

From 928d25f1f19cdd6689d64c63a6edd9d7941cb47d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 17 Nov 2020 23:04:45 +0100
Subject: [PATCH 0264/1374] VerbForm is not obligatory in Austronesian
 languages (#64).

---
 udapi/block/ud/markbugs.py | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index 1969278a..c8b06328 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -8,6 +8,13 @@
 Usage:
 udapy -s ud.MarkBugs < in.conllu > marked.conllu 2> log.txt
 
+Some tests may be customized for individual languages if the language code is
+available as the zone id. The zone id can be provided in the sentence id after
+the slash (e.g., "sent_id = s125/en" for English), or as a parameter of the
+reader:
+
+udapy -s read.Conllu zone=en ud.MarkBugs < in.conllu > marked.conllu 2> log.txt
+
 Errors are both logged to stderr and marked within the nodes' MISC field,
 e.g. `node.misc['Bug'] = 'aux-chain'`, so the output conllu file can be
 searched for "Bug=" occurences.
@@ -109,7 +116,10 @@ def process_node(self, node):
 
         for i_upos, i_feat in REQUIRED_FEATURE_FOR_UPOS.items():
             if upos == i_upos and not feats[i_feat]:
-                self.log(node, 'no-' + i_feat, 'upos=%s but %s feature is missing' % (upos, i_feat))
+                # Some languages do not distinguish finite and non-finite forms of verbs.
+                # The VerbForm feature is not obligatory in those languages.
+                if not node.root.zone.split("_")[0] in {"id", "tl", "hil", "ifb"}:
+                    self.log(node, 'no-' + i_feat, 'upos=%s but %s feature is missing' % (upos, i_feat))
 
         if feats['VerbForm'] == 'Fin':
             if upos not in ('VERB', 'AUX'):

From 3dd3af69a5314e32ed71def7a3e8cf81226b3571 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 17 Nov 2020 23:09:10 +0100
Subject: [PATCH 0265/1374] Fix: The new condition should affect only VerbForm
 (#64).

---
 udapi/block/ud/markbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index c8b06328..cbd57eef 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -118,7 +118,7 @@ def process_node(self, node):
             if upos == i_upos and not feats[i_feat]:
                 # Some languages do not distinguish finite and non-finite forms of verbs.
                 # The VerbForm feature is not obligatory in those languages.
-                if not node.root.zone.split("_")[0] in {"id", "tl", "hil", "ifb"}:
+                if i_feat != "VerbForm" or not node.root.zone.split("_")[0] in {"id", "tl", "hil", "ifb"}:
                     self.log(node, 'no-' + i_feat, 'upos=%s but %s feature is missing' % (upos, i_feat))
 
         if feats['VerbForm'] == 'Fin':

From 0e809365578514e1d76b784f96c73fd798ce6e6e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 20 Nov 2020 01:17:56 +0100
Subject: [PATCH 0266/1374] make Udapi easier to use from IPython

For example to print subjects with more than 4 children:
```
import udapi
doc = udapi.Document("UD_English/sample.conllu")
subjects = [n for n in doc.nodes if n.deprel == 'nsubj']
for subject in subjects:
     if len(subject.children) > 4:
         subject.print_subtree()
```
---
 udapi/__init__.py      |  1 +
 udapi/core/document.py | 20 +++++++++++++++++++-
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/udapi/__init__.py b/udapi/__init__.py
index e69de29b..598df7fd 100644
--- a/udapi/__init__.py
+++ b/udapi/__init__.py
@@ -0,0 +1 @@
+from .core.document import Document
diff --git a/udapi/core/document.py b/udapi/core/document.py
index 778e5bd9..c7e7b870 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -9,11 +9,14 @@
 class Document(object):
     """Document is a container for Universal Dependency trees."""
 
-    def __init__(self):
+    def __init__(self, filename=None):
+        """Create a new Udapi document. Optionally, load the CoNLL-U file specified in `filename`."""
         self.bundles = []
         self._highest_bundle_id = 0
         self.meta = {}
         self.json = {}
+        if filename is not None:
+            self.load_conllu(filename)
 
     def __iter__(self):
         return iter(self.bundles)
@@ -47,3 +50,18 @@ def to_conllu_string(self):
         writer = ConlluWriter(filehandle=fh)
         writer.apply_on_document(self)
         return fh.getvalue()
+
+    @property
+    def trees(self):
+        """An iterator over all trees in the document."""
+        for bundle in self:
+            for tree in bundle:
+                yield tree
+
+    @property
+    def nodes(self):
+        """An iterator over all nodes in the document."""
+        for bundle in self:
+            for tree in bundle:
+                for node in tree.descendants:
+                    yield node

From 0a39dcd80da4b3402405b330c1794ace619efff8 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 21 Nov 2020 03:45:11 +0100
Subject: [PATCH 0267/1374] further tricks for IPython

Allow e.g.:
```
import udapi
doc = udapi.Document("one-sentence-per-line.txt")
udapi.create_block("udpipe.En").run(doc)
udapi.create_block("util.See", node='node.is_nonprojective()', n=2).run(doc)
```
---
 udapi/__init__.py      |  1 +
 udapi/core/block.py    |  5 +++++
 udapi/core/document.py | 19 +++++++++++++++++--
 udapi/core/run.py      |  6 ++++++
 4 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/udapi/__init__.py b/udapi/__init__.py
index 598df7fd..afdd8025 100644
--- a/udapi/__init__.py
+++ b/udapi/__init__.py
@@ -1 +1,2 @@
 from .core.document import Document
+from .core.run import create_block
diff --git a/udapi/core/block.py b/udapi/core/block.py
index 67c299f0..3292866f 100644
--- a/udapi/core/block.py
+++ b/udapi/core/block.py
@@ -38,6 +38,11 @@ def process_bundle(self, bundle):
             if self._should_process_tree(tree):
                 self.process_tree(tree)
 
+    def run(self, document):
+        self.process_start()
+        self.apply_on_document(document)
+        self.process_end()
+
     def apply_on_document(self, document):
         self.before_process_document(document)
         self.process_document(document)
diff --git a/udapi/core/document.py b/udapi/core/document.py
index c7e7b870..b0e17d2a 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -4,19 +4,34 @@
 from udapi.core.bundle import Bundle
 from udapi.block.read.conllu import Conllu as ConlluReader
 from udapi.block.write.conllu import Conllu as ConlluWriter
+from udapi.block.read.sentences import Sentences as SentencesReader
 
 
 class Document(object):
     """Document is a container for Universal Dependency trees."""
 
     def __init__(self, filename=None):
-        """Create a new Udapi document. Optionally, load the CoNLL-U file specified in `filename`."""
+        """Create a new Udapi document.
+
+        Args:
+        filename: load the specified file.
+            Only `*.conlu` (using `udapi.block.read.conllu`)
+            and `*.txt` (using `udapi.block.read.sentences`) filenames are supported.
+            No pre-processing is applied, so when loading the document from a *.txt file,
+            `Document("a.txt").nodes` will be empty and you need to run tokenization first.
+        """
         self.bundles = []
         self._highest_bundle_id = 0
         self.meta = {}
         self.json = {}
         if filename is not None:
-            self.load_conllu(filename)
+            if filename.endswith(".conllu"):
+                self.load_conllu(filename)
+            elif filename.endswith(".txt"):
+                reader = SentencesReader(files=filename)
+                reader.apply_on_document(self)
+            else:
+                raise ValueError("Only *.conllu and *.txt are supported. Provided: " + filename)
 
     def __iter__(self):
         return iter(self.bundles)
diff --git a/udapi/core/run.py b/udapi/core/run.py
index c730a1a7..0a08504c 100644
--- a/udapi/core/run.py
+++ b/udapi/core/run.py
@@ -171,3 +171,9 @@ def execute(self):
     def scenario_string(self):
         """Return the scenario string."""
         return "\n".join(self.args.scenario)
+
+
+def create_block(block, **kwargs):
+    """A factory function for creating new block instances (handy for IPython)."""
+    blocks = _import_blocks([block], [kwargs])
+    return blocks[0]

From f1b4d8ae36557feb0f93306a2a7d1b780abc8d88 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 30 Nov 2020 22:13:27 +0100
Subject: [PATCH 0268/1374] rename node.print_subtree() to node.draw()

for consistency with `bundle.draw()` and `doc.draw()`
---
 udapi/block/write/textmodetrees.py |  4 ++--
 udapi/core/bundle.py               |  5 +++++
 udapi/core/document.py             | 21 ++++++++++++++++++---
 udapi/core/node.py                 |  5 +++++
 udapi/core/tests/test_enhdeps.py   |  2 +-
 udapi/core/tests/test_node.py      | 12 ++++++------
 6 files changed, 37 insertions(+), 12 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index 1f8163c5..fd29e72e 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -123,7 +123,7 @@ class TextModeTrees(BaseWriter):
     (by reveresing the background and foreground colors).
 
     This block's method `process_tree` can be called on any node (not only root),
-    which is useful for printing subtrees using ``node.print_subtree()``,
+    which is useful for printing subtrees using ``node.draw()``,
     which is internally implemented using this block.
 
     SEE ALSO
@@ -207,7 +207,7 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         self.lengths = []
 
     # We want to be able to call process_tree not only on root node,
-    # so this block can be called from node.print_subtree(**kwargs)
+    # so this block can be called from node.print_draw(**kwargs)
     # on any node and print its subtree. Thus, we cannot assume that
     # allnodes[idx].ord == idx. Instead of node.ord, we'll use index_of[node.ord],
     # which is its index within the printed subtree.
diff --git a/udapi/core/bundle.py b/udapi/core/bundle.py
index 4df1deb2..591b8a84 100644
--- a/udapi/core/bundle.py
+++ b/udapi/core/bundle.py
@@ -3,6 +3,7 @@
 import re
 
 from udapi.core.root import Root
+from udapi.block.write.textmodetrees import TextModeTrees
 
 VALID_ZONE_REGEX = re.compile("^[a-z-]*(_[A-Za-z0-9-]+)?$")
 
@@ -106,3 +107,7 @@ def remove(self):
     def address(self):
         """Return bundle_id or '?' if missing."""
         return self.bundle_id if self.bundle_id is not None else '?'
+
+    def draw(self, **kwargs):
+        """Pretty print the trees using TextModeTrees."""
+        TextModeTrees(**kwargs).process_bundle(self)
diff --git a/udapi/core/document.py b/udapi/core/document.py
index b0e17d2a..25699398 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -1,11 +1,12 @@
 """Document class is a container for UD trees."""
 
 import io
+import contextlib
 from udapi.core.bundle import Bundle
 from udapi.block.read.conllu import Conllu as ConlluReader
 from udapi.block.write.conllu import Conllu as ConlluWriter
 from udapi.block.read.sentences import Sentences as SentencesReader
-
+from udapi.block.write.textmodetrees import TextModeTrees
 
 class Document(object):
     """Document is a container for Universal Dependency trees."""
@@ -36,6 +37,16 @@ def __init__(self, filename=None):
     def __iter__(self):
         return iter(self.bundles)
 
+    def __getitem__(self, key):
+        return self.bundles[key]
+
+    def __str__(self):
+        """Pretty print the whole document using write.TextModeTrees."""
+        fh = io.StringIO()
+        with contextlib.redirect_stdout(fh):
+            TextModeTrees(color=True).run(self)
+        return fh.getvalue()
+
     def create_bundle(self):
         """Create a new bundle and add it at the end of the document."""
         self._highest_bundle_id += 1
@@ -62,8 +73,8 @@ def from_conllu_string(self, string):
     def to_conllu_string(self):
         """Return the document as a conllu-formatted string."""
         fh = io.StringIO()
-        writer = ConlluWriter(filehandle=fh)
-        writer.apply_on_document(self)
+        with contextlib.redirect_stdout(fh):
+            ConlluWriter().apply_on_document(self)
         return fh.getvalue()
 
     @property
@@ -80,3 +91,7 @@ def nodes(self):
             for tree in bundle:
                 for node in tree.descendants:
                     yield node
+
+    def draw(self, **kwargs):
+        """Pretty print the trees using TextModeTrees."""
+        TextModeTrees(**kwargs).run(self)
diff --git a/udapi/core/node.py b/udapi/core/node.py
index de58c9be..32061b16 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -600,6 +600,11 @@ def compute_text(self, use_mwt=True):
         return string.rstrip()
 
     def print_subtree(self, **kwargs):
+        """deprecated name for draw()"""
+        logging.warning("node.print_subtree() is deprecated, use node.draw() instead.")
+        TextModeTrees(**kwargs).process_tree(self)
+
+    def draw(self, **kwargs):
         """Print ASCII visualization of the dependency structure of this subtree.
 
         This method is useful for debugging.
diff --git a/udapi/core/tests/test_enhdeps.py b/udapi/core/tests/test_enhdeps.py
index fd80b3f2..80fe0209 100644
--- a/udapi/core/tests/test_enhdeps.py
+++ b/udapi/core/tests/test_enhdeps.py
@@ -42,7 +42,7 @@ def test_ord_type(self):
     def test_create_empty(self):
         writer = ConlluWriter()
         writer.apply_on_document(self.doc)
-        # self.tree.print_subtree()
+        # self.tree.draw()
         self.assertGreater(len(self.tree.empty_nodes), 0)
 
     def test_regular_deps(self):
diff --git a/udapi/core/tests/test_node.py b/udapi/core/tests/test_node.py
index 52e94722..7d811456 100755
--- a/udapi/core/tests/test_node.py
+++ b/udapi/core/tests/test_node.py
@@ -56,8 +56,8 @@ def test_topology(self):
         self.assertEqual([node.ord for node in nodes], [2, 1, 3, 4, 5, 6])
         self.assertEqual([node.ord for node in root.descendants()], [1, 2, 3, 4, 5, 6])
 
-    def test_print_subtree(self):
-        """Test print_subtree() method, which uses udapi.block.write.textmodetrees."""
+    def test_draw(self):
+        """Test the draw() method, which uses udapi.block.write.textmodetrees."""
         doc = Document()
         data_filename = os.path.join(os.path.dirname(__file__), 'data', 'enh_deps.conllu')
         doc.load_conllu(data_filename)
@@ -98,16 +98,16 @@ def test_print_subtree(self):
 
         try:
             sys.stdout = capture = io.StringIO()
-            root.print_subtree(color=False)
+            root.draw(color=False)
             self.assertEqual(capture.getvalue(), expected1)
             capture.seek(0)
             capture.truncate()
-            root.print_subtree(color=False, attributes='form,feats,misc',
-                               print_sent_id=False, print_text=False)
+            root.draw(color=False, attributes='form,feats,misc',
+                      print_sent_id=False, print_text=False)
             self.assertEqual(capture.getvalue(), expected2)
             capture.seek(0)
             capture.truncate()
-            root3.print_subtree(color=False, attributes='form', print_sent_id=0, print_text=0)
+            root3.draw(color=False, attributes='form', print_sent_id=0, print_text=0)
             self.assertEqual(capture.getvalue(), expected3)
         finally:
             sys.stdout = sys.__stdout__  # pylint: disable=redefined-variable-type

From e94591fce7f68d0e317fca5628c966e766f777ad Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 1 Dec 2020 08:06:47 +0100
Subject: [PATCH 0269/1374] tutorial/01-visualizing.ipynb

---
 tutorial/01-visualizing.ipynb | 554 ++++++++++++++++++++++++++++++++++
 1 file changed, 554 insertions(+)
 create mode 100644 tutorial/01-visualizing.ipynb

diff --git a/tutorial/01-visualizing.ipynb b/tutorial/01-visualizing.ipynb
new file mode 100644
index 00000000..382bb11f
--- /dev/null
+++ b/tutorial/01-visualizing.ipynb
@@ -0,0 +1,554 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Introduction\n",
+    "Udapi is an API and framework for processing [Universal Dependencies](http://universaldependencies.org/). In this tutorial, we will focus on the Python version of Udapi. Perl and Java versions are [available](http://udapi.github.io/) as well, but they are missing some of the features.\n",
+    "\n",
+    "Udapi can be used from the shell (e.g. Bash), using the wrapper script `udapy`. It can be also used as a library, from Python, IPython or Jupyter notebooks. We will show both of these ways bellow.\n",
+    "\n",
+    "This tutorial uses Details sections for extra info (if you want to know more or if you run into problems). You need to click on it to show its content.\n",
+    "<details><summary>Details</summary>\n",
+    "It is a substitute for footnotes. The content may be long and showing it in the main text may be distracting.\n",
+    "</details>\n",
+    "\n",
+    "### Install (upgrade) Udapi\n",
+    "First, make sure you have the newest version of Udapi. If you have already installed Udapi [using git clone](https://github.com/udapi/udapi-python#install-udapi-for-developers), just run `git pull`. If you have not installed Udapi yet, run\n",
+    "<details><summary>Details</summary>\n",
+    "<ul>\n",
+    "  <li> The command below installs Udapi from GitHub (from the master branch). With <code>pip3 install --user --upgrade udapi</code>, you can install the last version released on PyPI (possibly older).\n",
+    "  <li> The exclamation mark (!) in Jupyter or IPython means that the following command will be executed by the system shell (e.g. Bash).\n",
+    "</ul>\n",
+    "</details>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!pip3 install --user --upgrade git+https://github.com/udapi/udapi-python.git\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Now, make sure you can run the command-line interface `udapy`, e.g. by printing the help message."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {
+    "collapsed": true
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "usage: udapy [optional_arguments] scenario\r\n",
+      "\r\n",
+      "udapy - Python interface to Udapi - API for Universal Dependencies\r\n",
+      "\r\n",
+      "Examples of usage:\r\n",
+      "  udapy -s read.Sentences udpipe.En < in.txt > out.conllu\r\n",
+      "  udapy -T < sample.conllu | less -R\r\n",
+      "  udapy -HAM ud.MarkBugs < sample.conllu > bugs.html\r\n",
+      "\r\n",
+      "positional arguments:\r\n",
+      "  scenario              A sequence of blocks and their parameters.\r\n",
+      "\r\n",
+      "optional arguments:\r\n",
+      "  -h, --help            show this help message and exit\r\n",
+      "  -q, --quiet           Warning, info and debug messages are suppressed. Only fatal errors are reported.\r\n",
+      "  -v, --verbose         Warning, info and debug messages are printed to the STDERR.\r\n",
+      "  -s, --save            Add write.Conllu to the end of the scenario\r\n",
+      "  -T, --save_text_mode_trees\r\n",
+      "                        Add write.TextModeTrees color=1 to the end of the scenario\r\n",
+      "  -H, --save_html       Add write.TextModeTreesHtml color=1 to the end of the scenario\r\n",
+      "  -A, --save_all_attributes\r\n",
+      "                        Add attributes=form,lemma,upos,xpos,feats,deprel,misc (to be used after -T and -H)\r\n",
+      "  -C, --save_comments   Add print_comments=1 (to be used after -T and -H)\r\n",
+      "  -M, --marked_only     Add marked_only=1 to the end of the scenario (to be used after -T and -H)\r\n",
+      "  -N, --no_color        Add color=0 to the end of the scenario, this overrides color=1 of -T and -H\r\n",
+      "\r\n",
+      "See http://udapi.github.io\r\n"
+     ]
+    }
+   ],
+   "source": [
+    "!udapy -h"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<details><summary>Details: If the previous command fails with \"udapy: command not found\"</summary>\n",
+    "This means that Udapi is not properly installed. When installing Udapi with <code>pip3 --user</code>, it is installed into <code>~/.local/lib/python3.6/site-packages/udapi/</code> (or similar depending on your Python version) and the wrapper into <code>~/.local/bin</code>. Thus you need to\n",
+    "<pre>\n",
+    "export PATH=\"$HOME/.local/bin/:$PATH\"\n",
+    "</pre>\n",
+    "</details>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Browse CoNLL-U files\n",
+    "### Get sample UD data\n",
+    "\n",
+    "Download and extract [ud20sample.tgz](http://ufal.mff.cuni.cz/~popel/udapi/ud20sample.tgz). There are just 100 sentences for each of the 70 treebanks (`sample.conllu`),  plus 4 bigger files (`train.conllu` and `dev.conllu`) for German, English, French and Czech. For full UD ([2.0](https://lindat.mff.cuni.cz/repository/xmlui/handle/11234/1-1983) or [newer](https://lindat.mff.cuni.cz/repository/xmlui/handle/11234/1-3424)), go to [Lindat](https://lindat.cz)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {
+    "collapsed": true
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "--2020-12-01 07:53:37--  http://ufal.mff.cuni.cz/~popel/udapi/ud20sample.tgz\n",
+      "Resolving ufal.mff.cuni.cz (ufal.mff.cuni.cz)... 195.113.20.52\n",
+      "Connecting to ufal.mff.cuni.cz (ufal.mff.cuni.cz)|195.113.20.52|:80... connected.\n",
+      "HTTP request sent, awaiting response... 200 OK\n",
+      "Length: 4670982 (4,5M) [application/x-gzip]\n",
+      "Saving to: ‘ud20sample.tgz.1’\n",
+      "\n",
+      "ud20sample.tgz.1    100%[===================>]   4,45M  1,49MB/s    in 3,0s    \n",
+      "\n",
+      "2020-12-01 07:53:40 (1,49 MB/s) - ‘ud20sample.tgz.1’ saved [4670982/4670982]\n",
+      "\n",
+      "/home/martin/udapi/python/notebook/sample\n"
+     ]
+    }
+   ],
+   "source": [
+    "!wget http://ufal.mff.cuni.cz/~popel/udapi/ud20sample.tgz\n",
+    "!tar -xf ud20sample.tgz\n",
+    "%cd sample"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let's choose one of the sample files and see the raw [CoNLL-U format](https://universaldependencies.org/format.html).\n",
+    "<details><summary>Details: executing from Bash, IPython, Jupyter</summary>\n",
+    "<ul>\n",
+    "<li>If you see \"No such file or directory\" error, make sure you executed the previous cell. Note that the <code>cd</code> command is not prefixed by an exclamation mark because that would run in a sub-shell, which \"forgets\" the changed directory when finished. It is prefixed by a percent sign, which marks it as <a href=\"https://ipython.readthedocs.io/en/stable/interactive/magics.html#magic-cd\">IPython magic</a>.\n",
+    "<li><code>cat</code> is another IPython magic command, this time an alias for the shell command of the same name (so you can prefix <code>cat</code> with an exclamation mark, if you prefer), which prints a given file. With <code>automagic</code> on, you can use it without the percent sign.\n",
+    "<li>In this tutorial, we use <code>| head</code> to show just the first 10 lines of the output (preventing thus big ipynb file size). You can ignore the \"cat: write error: Broken pipe\" warning.\n",
+    "<li>When using Jupyter, you can omit the <code>| head</code> because long outputs are automatically wrapped in a text box with a scrollbar.\n",
+    "<li>When running this from IPython or Bash, you can use a pager: <code>less UD_Ancient_Greek/sample.conllu</code>\n",
+    "</ul>\n",
+    "</details>\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# newdoc id = tlg0008.tlg001.perseus-grc1.13.tb.xml\r\n",
+      "# sent_id = tlg0008.tlg001.perseus-grc1.13.tb.xml@1144\r\n",
+      "# text = ἐρᾷ μὲν ἁγνὸς οὐρανὸς τρῶσαι χθόνα, ἔρως δὲ γαῖαν λαμβάνει γάμου τυχεῖν·\r\n",
+      "1\tἐρᾷ\tἐράω\tVERB\tv3spia---\tMood=Ind|Number=Sing|Person=3|Tense=Pres|VerbForm=Fin|Voice=Act\t0\troot\t_\t_\r\n",
+      "2\tμὲν\tμέν\tADV\td--------\t_\t1\tadvmod\t_\t_\r\n",
+      "3\tἁγνὸς\tἁγνός\tADJ\ta-s---mn-\tCase=Nom|Gender=Masc|Number=Sing\t4\tnmod\t_\t_\r\n",
+      "4\tοὐρανὸς\tοὐρανός\tNOUN\tn-s---mn-\tCase=Nom|Gender=Masc|Number=Sing\t1\tnsubj\t_\t_\r\n",
+      "5\tτρῶσαι\tτιτρώσκω\tVERB\tv--ana---\tTense=Past|VerbForm=Inf|Voice=Act\t1\txcomp\t_\t_\r\n",
+      "6\tχθόνα\tχθών\tNOUN\tn-s---fa-\tCase=Acc|Gender=Fem|Number=Sing\t5\tobj\t_\tSpaceAfter=No\r\n",
+      "7\t,\t,\tPUNCT\tu--------\t_\t1\tpunct\t_\t_\r\n",
+      "cat: write error: Broken pipe\r\n"
+     ]
+    }
+   ],
+   "source": [
+    "cat UD_Ancient_Greek/sample.conllu | head"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Browse conllu files with `udapy -T`\n",
+    "While the CoNLL-U format was designed with readibility (by both machines and humans) on mind, it may be still a bit difficult to read and interpret by humans. Let's visualize the dependency tree structure using ASCII-art by piping the conllu file into `udapy -T`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "2020-12-01 08:00:33,276 [   INFO] execute - No reader specified, using read.Conllu\n",
+      "2020-12-01 08:00:33,276 [   INFO] execute -  ---- ROUND ----\n",
+      "2020-12-01 08:00:33,276 [   INFO] execute - Executing block Conllu\n",
+      "2020-12-01 08:00:33,305 [   INFO] execute - Executing block TextModeTrees\n",
+      "docname = tlg0008.tlg001.perseus-grc1.13.tb.xml\n",
+      "loaded_from = -\n",
+      "# sent_id = tlg0008.tlg001.perseus-grc1.13.tb.xml@1144\n",
+      "# text = ἐρᾷ μὲν ἁγνὸς οὐρανὸς τρῶσαι χθόνα, ἔρως δὲ γαῖαν λαμβάνει γάμου τυχεῖν·\n",
+      "─┮\n",
+      " ╰─┮ \u001b[33mἐρᾷ\u001b[0m \u001b[31mVERB\u001b[0m \u001b[34mroot\u001b[0m\n",
+      "   ┡─╼ \u001b[33mμὲν\u001b[0m \u001b[31mADV\u001b[0m \u001b[34madvmod\u001b[0m\n",
+      "   │ ╭─╼ \u001b[33mἁγνὸς\u001b[0m \u001b[31mADJ\u001b[0m \u001b[34mnmod\u001b[0m\n",
+      "   ┡─┶ \u001b[33mοὐρανὸς\u001b[0m \u001b[31mNOUN\u001b[0m \u001b[34mnsubj\u001b[0m\n",
+      "   ┡─┮ \u001b[33mτρῶσαι\u001b[0m \u001b[31mVERB\u001b[0m \u001b[34mxcomp\u001b[0m\n",
+      "   │ ╰─╼ \u001b[33mχθόνα\u001b[0m \u001b[31mNOUN\u001b[0m \u001b[34mobj\u001b[0m\n",
+      "   ┡─╼ \u001b[33m,\u001b[0m \u001b[31mPUNCT\u001b[0m \u001b[34mpunct\u001b[0m\n",
+      "   │               ╭─╼ \u001b[33mἔρως\u001b[0m \u001b[31mNOUN\u001b[0m \u001b[34mnsubj\u001b[0m\n",
+      "   ┡─╼ \u001b[33mδὲ\u001b[0m \u001b[31mCCONJ\u001b[0m \u001b[34mcc\u001b[0m │\n",
+      "   │               ┢─╼ \u001b[33mγαῖαν\u001b[0m \u001b[31mNOUN\u001b[0m \u001b[34mobj\u001b[0m\n",
+      "   ┡───────────────┾ \u001b[33mλαμβάνει\u001b[0m \u001b[31mVERB\u001b[0m \u001b[34mconj\u001b[0m\n",
+      "   │               │ ╭─╼ \u001b[33mγάμου\u001b[0m \u001b[31mNOUN\u001b[0m \u001b[34mobj\u001b[0m\n",
+      "   │               ╰─┶ \u001b[33mτυχεῖν\u001b[0m \u001b[31mVERB\u001b[0m \u001b[34mxcomp\u001b[0m\n",
+      "   ╰─╼ \u001b[33m·\u001b[0m \u001b[31mPUNCT\u001b[0m \u001b[34mpunct\u001b[0m\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "cat UD_Ancient_Greek/sample.conllu | udapy -T | head -n 20"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<details><summary>Details:</summary>\n",
+    "<ul>\n",
+    "<li>You may be used to see dependency trees where the root node is on the top and words are ordered horizontally (left to right). Here, the root is on left and words are ordered vertically (top to bottom).\n",
+    "<li>The colors are implemented using the <a href=\"https://pypi.org/project/colorama/\">colorama package</a> and ANSI escape codes. When running this from IPython or Bash and using <code>less</code>, you need to instruct it to display the colors with <code>-R</code>:\n",
+    "<code>\n",
+    "cat UD_Ancient_Greek/sample.conllu | udapy -T | less -R\n",
+    "</code>\n",
+    "<li>You can also use <code>udapy -T -N</code> to disable the colors.\n",
+    "<li><code>udapy -q</code> suppresses all Udapi messages (warnings, info, debug) printed on the standard error output, so only fatal errors are printed. By default only debug messages are suppresses, but these can be printed with <code>udapy -v</code>.\n",
+    "<li>But you already know this because you have read <code>udapy -h</code>, am I right?\n",
+    "</ul>\n",
+    "</details>\n",
+    "\n",
+    "`udapy -T` is a shortcut for `udapy write.TextModeTrees color=1`, where `write.TextModeTrees` is a so-called *block* (a basic Udapi processing unit) and `color=1` is its parameter. See [the documentation](https://udapi.readthedocs.io/en/latest/udapi.block.write.html#module-udapi.block.write.textmodetrees) (or even [the source code](https://github.com/udapi/udapi-python/blob/master/udapi/block/write/textmodetrees.py) of `write.TextModeTrees` to learn about further parameters. Now, let's print also the LEMMA and MISC columns and display the columns vertically aligned using parameters `layout=align attributes=form,lemma,upos,deprel,misc`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "docname = tlg0008.tlg001.perseus-grc1.13.tb.xml\r\n",
+      "loaded_from = -\r\n",
+      "# sent_id = tlg0008.tlg001.perseus-grc1.13.tb.xml@1144\r\n",
+      "# text = ἐρᾷ μὲν ἁγνὸς οὐρανὸς τρῶσαι χθόνα, ἔρως δὲ γαῖαν λαμβάνει γάμου τυχεῖν·\r\n",
+      "─┮                                         \r\n",
+      " ╰─┮         \u001b[33mἐρᾷ\u001b[0m      \u001b[36mἐράω\u001b[0m     \u001b[31mVERB\u001b[0m  \u001b[34mroot\u001b[0m   _\u001b[0m\r\n",
+      "   ┡─╼       \u001b[33mμὲν\u001b[0m      \u001b[36mμέν\u001b[0m      \u001b[31mADV\u001b[0m   \u001b[34madvmod\u001b[0m _\u001b[0m\r\n",
+      "   │ ╭─╼     \u001b[33mἁγνὸς\u001b[0m    \u001b[36mἁγνός\u001b[0m    \u001b[31mADJ\u001b[0m   \u001b[34mnmod\u001b[0m   _\u001b[0m\r\n",
+      "   ┡─┶       \u001b[33mοὐρανὸς\u001b[0m  \u001b[36mοὐρανός\u001b[0m  \u001b[31mNOUN\u001b[0m  \u001b[34mnsubj\u001b[0m  _\u001b[0m\r\n",
+      "   ┡─┮       \u001b[33mτρῶσαι\u001b[0m   \u001b[36mτιτρώσκω\u001b[0m \u001b[31mVERB\u001b[0m  \u001b[34mxcomp\u001b[0m  _\u001b[0m\r\n",
+      "   │ ╰─╼     \u001b[33mχθόνα\u001b[0m    \u001b[36mχθών\u001b[0m     \u001b[31mNOUN\u001b[0m  \u001b[34mobj\u001b[0m    SpaceAfter=No\u001b[0m\r\n",
+      "   ┡─╼       \u001b[33m,\u001b[0m        \u001b[36m,\u001b[0m        \u001b[31mPUNCT\u001b[0m \u001b[34mpunct\u001b[0m  _\u001b[0m\r\n",
+      "   │   ╭─╼   \u001b[33mἔρως\u001b[0m     \u001b[36mἔρως\u001b[0m     \u001b[31mNOUN\u001b[0m  \u001b[34mnsubj\u001b[0m  _\u001b[0m\r\n",
+      "   ┡─╼ │     \u001b[33mδὲ\u001b[0m       \u001b[36mδέ\u001b[0m       \u001b[31mCCONJ\u001b[0m \u001b[34mcc\u001b[0m     _\u001b[0m\r\n",
+      "   │   ┢─╼   \u001b[33mγαῖαν\u001b[0m    \u001b[36mγαῖα\u001b[0m     \u001b[31mNOUN\u001b[0m  \u001b[34mobj\u001b[0m    _\u001b[0m\r\n",
+      "   ┡───┾     \u001b[33mλαμβάνει\u001b[0m \u001b[36mλαμβάνω\u001b[0m  \u001b[31mVERB\u001b[0m  \u001b[34mconj\u001b[0m   _\u001b[0m\r\n",
+      "   │   │ ╭─╼ \u001b[33mγάμου\u001b[0m    \u001b[36mγάμος\u001b[0m    \u001b[31mNOUN\u001b[0m  \u001b[34mobj\u001b[0m    _\u001b[0m\r\n",
+      "   │   ╰─┶   \u001b[33mτυχεῖν\u001b[0m   \u001b[36mτυγχάνω\u001b[0m  \u001b[31mVERB\u001b[0m  \u001b[34mxcomp\u001b[0m  SpaceAfter=No\u001b[0m\r\n",
+      "   ╰─╼       \u001b[33m·\u001b[0m        \u001b[36m·\u001b[0m        \u001b[31mPUNCT\u001b[0m \u001b[34mpunct\u001b[0m  _\u001b[0m\r\n",
+      "\r\n"
+     ]
+    }
+   ],
+   "source": [
+    "cat UD_Ancient_Greek/sample.conllu | udapy -q write.TextModeTrees color=1 layout=align attributes=form,lemma,upos,deprel,misc | head -n 20"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Browse conllu files from IPython/Jupyter\n",
+    "So far, we were using Udapi only via its command-line interface `udapy`, which is handy, but not very Pythonic. So let's now use Udapi as a library and load the English conllu sample file into a document `doc` and visualize the sixth tree (i.e. `doc[5]` in zero-based indexing)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# sent_id = weblog-juancole.com_juancole_20051126063000_ENG_20051126_063000-0006\n",
+      "# text = The third was being run by the head of an investment firm.\n",
+      "─┮\n",
+      " │   ╭─╼ \u001b[33mThe\u001b[0m \u001b[31mDET\u001b[0m \u001b[34mdet\u001b[0m\n",
+      " │ ╭─┶ \u001b[33mthird\u001b[0m \u001b[31mADJ\u001b[0m \u001b[34mnsubj:pass\u001b[0m\n",
+      " │ ┢─╼ \u001b[33mwas\u001b[0m \u001b[31mAUX\u001b[0m \u001b[34maux\u001b[0m\n",
+      " │ ┢─╼ \u001b[33mbeing\u001b[0m \u001b[31mAUX\u001b[0m \u001b[34maux:pass\u001b[0m\n",
+      " ╰─┾ \u001b[33mrun\u001b[0m \u001b[31mVERB\u001b[0m \u001b[34mroot\u001b[0m\n",
+      "   │ ╭─╼ \u001b[33mby\u001b[0m \u001b[31mADP\u001b[0m \u001b[34mcase\u001b[0m\n",
+      "   │ ┢─╼ \u001b[33mthe\u001b[0m \u001b[31mDET\u001b[0m \u001b[34mdet\u001b[0m\n",
+      "   ┡─┾ \u001b[33mhead\u001b[0m \u001b[31mNOUN\u001b[0m \u001b[34mobl\u001b[0m\n",
+      "   │ │ ╭─╼ \u001b[33mof\u001b[0m \u001b[31mADP\u001b[0m \u001b[34mcase\u001b[0m\n",
+      "   │ │ ┢─╼ \u001b[33man\u001b[0m \u001b[31mDET\u001b[0m \u001b[34mdet\u001b[0m\n",
+      "   │ │ ┢─╼ \u001b[33minvestment\u001b[0m \u001b[31mNOUN\u001b[0m \u001b[34mcompound\u001b[0m\n",
+      "   │ ╰─┶ \u001b[33mfirm\u001b[0m \u001b[31mNOUN\u001b[0m \u001b[34mnmod\u001b[0m\n",
+      "   ╰─╼ \u001b[33m.\u001b[0m \u001b[31mPUNCT\u001b[0m \u001b[34mpunct\u001b[0m\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "import udapi\n",
+    "doc = udapi.Document(\"UD_English/sample.conllu\")\n",
+    "doc[5].draw()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<details><summary>Details:</summary>\n",
+    "<ul>\n",
+    "<li><code>doc = udapi.Document(filename)</code> is a shortcut for\n",
+    "<pre>\n",
+    "import udapi.core.document\n",
+    "doc = udapi.core.document.Document(filename)\n",
+    "</pre>\n",
+    "<li>We can print the whole document using <code>doc.draw()</code>.\n",
+    "<li><code>doc.draw(**kwargs)</code> is a shortcut for creating a <code>write.TextModeTrees</code> block and applying it on the document:\n",
+    "<pre>\n",
+    "import udapi.block.write.textmodetrees\n",
+    "block = udapi.block.write.textmodetrees.TextModeTrees(**kwargs)\n",
+    "block.run(doc)\n",
+    "</pre>\n",
+    "</ul>\n",
+    "</details>\n",
+    "\n",
+    "The `draw()` method takes the same parameters as the `write.TextModeTrees` block, so we can for example display only the node ID (aka `ord`, i.e. word-order index), form and [universal (morpho-syntactic) features](https://universaldependencies.org/u/feat/index.html).\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# sent_id = weblog-juancole.com_juancole_20051126063000_ENG_20051126_063000-0006\n",
+      "# text = The third was being run by the head of an investment firm.\n",
+      "─┮                      \n",
+      " │   ╭─╼   \u001b[32m1\u001b[0m  \u001b[33mThe\u001b[0m        Definite=Def|PronType=Art\u001b[0m\n",
+      " │ ╭─┶     \u001b[32m2\u001b[0m  \u001b[33mthird\u001b[0m      Degree=Pos|NumType=Ord\u001b[0m\n",
+      " │ ┢─╼     \u001b[32m3\u001b[0m  \u001b[33mwas\u001b[0m        Mood=Ind|Number=Sing|Person=3|Tense=Past|VerbForm=Fin\u001b[0m\n",
+      " │ ┢─╼     \u001b[32m4\u001b[0m  \u001b[33mbeing\u001b[0m      VerbForm=Ger\u001b[0m\n",
+      " ╰─┾       \u001b[32m5\u001b[0m  \u001b[33mrun\u001b[0m        Tense=Past|VerbForm=Part|Voice=Pass\u001b[0m\n",
+      "   │ ╭─╼   \u001b[32m6\u001b[0m  \u001b[33mby\u001b[0m         _\u001b[0m\n",
+      "   │ ┢─╼   \u001b[32m7\u001b[0m  \u001b[33mthe\u001b[0m        Definite=Def|PronType=Art\u001b[0m\n",
+      "   ┡─┾     \u001b[32m8\u001b[0m  \u001b[33mhead\u001b[0m       Number=Sing\u001b[0m\n",
+      "   │ │ ╭─╼ \u001b[32m9\u001b[0m  \u001b[33mof\u001b[0m         _\u001b[0m\n",
+      "   │ │ ┢─╼ \u001b[32m10\u001b[0m \u001b[33man\u001b[0m         Definite=Ind|PronType=Art\u001b[0m\n",
+      "   │ │ ┢─╼ \u001b[32m11\u001b[0m \u001b[33minvestment\u001b[0m Number=Sing\u001b[0m\n",
+      "   │ ╰─┶   \u001b[32m12\u001b[0m \u001b[33mfirm\u001b[0m       Number=Sing\u001b[0m\n",
+      "   ╰─╼     \u001b[32m13\u001b[0m \u001b[33m.\u001b[0m          _\u001b[0m\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "doc[5].draw(layout=\"align\", attributes=\"ord,form,feats\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Document representation in Udapi\n",
+    "\n",
+    "Udapi [document](https://github.com/udapi/udapi-python/blob/master/udapi/core/document.py) consists of a sequence of so-called *bundles*, mirroring a sequence of sentences in a typical natural language text.\n",
+    "\n",
+    "A [bundle](https://github.com/udapi/udapi-python/blob/master/udapi/core/bundle.py) corresponds to a sentence,\n",
+    "possibly in multiple versions or with different representations, such as sentence-tuples from parallel corpora, or paraphrases in the same language or alternative analyses (e.g. parses produced by different parsers). If there are more trees in a bundle, they must be distinguished by a so-called *zone* (a label which contains the language code).\n",
+    "\n",
+    "Each tree is represented by a special (artificial) [root](https://github.com/udapi/udapi-python/blob/master/udapi/core/root.py) node, which is added to the top of a CoNLL-U tree in the Udapi model. The root node bears the ID of a given tree/sentence (`sent_id`) and its word order (`ord`) is 0. Technically, Root is subclass of Node, with some extra methods.\n",
+    "\n",
+    "The [Node](https://github.com/udapi/udapi-python/blob/master/udapi/core/node.py) class corresponds to a node\n",
+    "of a dependency tree. It provides access to all the CoNLL-U-defined attributes (`ord`, `form`, `lemma`, `upos`, `xpos`, `feats`, `deprel`, `deps`, `misc`). There are methods for tree traversal (`parent`, `root`, `children`, `descendants`); word-order traversal (`next_node`, `prev_node`); tree manipulation (`parent` setter) including word-order changes (`shift_after_node(x)`, `shift_before_subtree(x)`, etc.); and utility methods: `is_descendant_of(x)`, `is_nonprojective()`, `precedes(x)`, `is_leaf()`, `is_root()`, `get_attrs([])`, `compute_text()`, `draw()`.\n",
+    "\n",
+    "## Exercise 1: Count prepositions and postpositions\n",
+    "[Prepositions and postpositions](https://en.wikipedia.org/wiki/Preposition_and_postposition) are together called *adpositions* and assigned the [ADP](https://universaldependencies.org/u/pos/ADP.html) universal part-of-speech tag (`upos`) in UD. Some languages (e.g. English) use mostly prepositions, others mostly postpositions.\n",
+    "* Do you know any English postpositions?\n",
+    "* Guess the typical adposition type (i.e. whether a given language uses more prepositions or postpositions) for at least 10 languages of your choice (from those in UD2.0).\n",
+    "* Complete the following code and find out how many prepositions and postpositions are in `UD_English/sample.conllu` (which has been loaded into `doc`)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "prepositions, postpositions = 0, 0\n",
+    "# Iterate over all nodes in the document (in all trees)\n",
+    "for node in doc.nodes:\n",
+    "    if node.upos == \"ADP\":\n",
+    "        # TODO: fix this code to actually distinguish prepositions and postpositions\n",
+    "        prepositions += 1\n",
+    "# Print the results\n",
+    "prepositions, postpositions"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "If you don't know how to proceed click on the following hints.\n",
+    "<details><summary>Hint 1:</summary>\n",
+    "In some dependency grammars, adpositions govern noun (i.e. adposition is the *parent* of a given noun node). In other dependency grammars, adpositions depend on nouns (i.e. noun is the *parent* of a given adposition). Find out which style is being used by UD. Check <a href=\"https://universaldependencies.org/u/overview/syntax.html\">the UD documentation</a> or inspect some of the tree visualizations and guess.\n",
+    "</details>\n",
+    "<details><summary>Hint 2:</summary>\n",
+    "See the <a href=\"https://udapi.readthedocs.io/en/latest/udapi.core.html#module-udapi.core.node\">Node documentation</a> and find out how to obtain dependency parent and dependency children. Note that these are properties of a given node, rather than methods, so you should not write parentheses () after the property name.\n",
+    "</details>\n",
+    "<details><summary>Hint 3:</summary>\n",
+    "<code>doc.nodes</code> iterates over all nodes in the document sorted by the word order, but this would be cumbersome to exploit. Find a method of <code>Node</code> to detect the relative word order of two nodes (within the same tree/sentence).\n",
+    "</details>\n",
+    "<details><summary>Hint 4:</summary>\n",
+    "Use <code>node.parent</code> and <code>node.precedes(another_node)</code>.\n",
+    "The latter is a shortcut for <code>node.ord &lt; another_node.ord</code>.\n",
+    "</details>\n",
+    "<details><summary>Solution:</summary>\n",
+    "<pre>\n",
+    "for node in doc.nodes:\n",
+    "    if node.upos == \"ADP\":\n",
+    "        if node.precedes(node.parent):\n",
+    "            prepositions += 1\n",
+    "        else:\n",
+    "            postpositions += 1\n",
+    "</pre>\n",
+    "</details>\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Exercise 2: Explore English postpositions\n",
+    "The previous exercise indicates there are 7 occurrences of postpositions in the English sample. Find these 7 occurrences and visualize them using `node.draw()`. Count which adpositions (`lemma`) with which dependency relations (`deprel`) are responsible for these occurrences. Recompute these statistics on the bigger English training data. Can you explain these occurrences? What are the reasons? Is any occurrence an annotation error?"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# For the statistics, you may find useful: count[\"any string\"] += 1\n",
+    "import collections\n",
+    "count = collections.Counter()\n",
+    "big_doc = udapi.Document(\"UD_English/train.conllu\")\n",
+    "\n",
+    "for node in doc.nodes:\n",
+    "    # TODO detect postposition\n",
+    "    pass\n",
+    "\n",
+    "# Print the statistics\n",
+    "count.most_common()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<details><summary>Solution 1:</summary>\n",
+    "<pre>\n",
+    "for node in doc.nodes:\n",
+    "    if node.upos == \"ADP\" and node.parent.precedes(node):\n",
+    "        node.parent.draw()\n",
+    "        count[node.lemma + \" \" + node.deprel] += 1\n",
+    "</pre>\n",
+    "</details>\n",
+    "<details><summary>Hint 1:</summary>\n",
+    "We can see there are many particles of phrase verbs, e.g. \"busted up\".\n",
+    "These seem to be correctly annotated as <code>ADP</code> according to the UD guidelines.\n",
+    "Let's filter out those cases and focus on the rest and let's switch to the big train data.\n",
+    "</details>\n",
+    "<details><summary>Solution 2:</summary>\n",
+    "<pre>\n",
+    "count = collections.Counter()\n",
+    "for node in big_doc.nodes:\n",
+    "    if node.upos == \"ADP\" and node.parent.precedes(node) and node.parent.upos != \"VERB\":\n",
+    "        count[node.lemma + \" \" + node.deprel] += 1\n",
+    "count.most_common()\n",
+    "</pre>\n",
+    "Alternatively to <code>node.parent.upos != \"VERB\"</code>,\n",
+    "you could also filter out <code>node.deprel != \"compound:prt\"</code>,\n",
+    "or directly focus on <code>node.deprel == \"case\"</code>\n",
+    "</details>\n",
+    "<details><summary>Partial answer:</summary>\n",
+    "Most of the occurrences are actually annotated correctly,\n",
+    "although they are not typically considered as postpositions.\n",
+    "For example, <code>node.deprel == \"fixed\"</code> is being used for multi-word adpositions,\n",
+    "such as \"because of\", where \"of\" depends on \"because\" from technical (and consistency) reasons,\n",
+    "but the whole multi-word adpositions precedes its governing nound, so it is actually a multi-word preposition.\n",
+    "\n",
+    "What about the remaining occurrences, after filtering out <code>node.deprel not in {\"compound:prt\", \"fixed\"}</code>?\n",
+    "</details>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "In the next tutorial, [02-blocks.ipynb](02-blocks.ipynb), we will explore several useful Udapi blocks, some of which may be handy when working further on Exercise 2 or similar tasks."
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

From e9091688e6f60e7408c1e44d87832172d469ead8 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 1 Dec 2020 08:22:18 +0100
Subject: [PATCH 0270/1374] tutorial README.md

---
 tutorial/README.md | 9 +++++++++
 1 file changed, 9 insertions(+)
 create mode 100644 tutorial/README.md

diff --git a/tutorial/README.md b/tutorial/README.md
new file mode 100644
index 00000000..05e96d59
--- /dev/null
+++ b/tutorial/README.md
@@ -0,0 +1,9 @@
+# Udapi tutorial
+
+To run this tutorial, install [Jupyter Notebook](https://jupyter.org/install.html) (or JupyterLab) and run `jupyter notebook` from  this directory.
+
+Don't display the tutorial `ipynb` files on GitHub because it cannot render the collapsible Details, Hints and Solution sections, so you would miss important parts of the tutorial.
+If you don't have Jupyter installed, you can display the tutorial with https://nbviewer.jupyter.org, using the following links:
+
+- [01-visualizing.ipynb](https://nbviewer.jupyter.org/github/udapi/udapi-python/blob/master/tutorial/01-visualizing.ipynb)
+- [02-blocks.ipynb](https://nbviewer.jupyter.org/github/udapi/udapi-python/blob/master/tutorial/01-blocks.ipynb)

From 5eb27a80fc3b1563050a37c31275e31661a02c45 Mon Sep 17 00:00:00 2001
From: Zdenek Zabokrtsky <zabokrtsky@ufal.mff.cuni.cz>
Date: Wed, 27 Jan 2021 22:23:55 +0100
Subject: [PATCH 0271/1374] a block that prints most frequent values for each
 attribute stored in the MISC field

---
 udapi/block/corefud/__init__.py  |  0
 udapi/block/corefud/miscstats.py | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 32 insertions(+)
 create mode 100644 udapi/block/corefud/__init__.py
 create mode 100644 udapi/block/corefud/miscstats.py

diff --git a/udapi/block/corefud/__init__.py b/udapi/block/corefud/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/corefud/miscstats.py b/udapi/block/corefud/miscstats.py
new file mode 100644
index 00000000..4f4e86c0
--- /dev/null
+++ b/udapi/block/corefud/miscstats.py
@@ -0,0 +1,32 @@
+from udapi.core.block import Block
+from collections import Counter
+import re
+
+class MiscStats(Block):
+    """Block corefud.MiscStats prints 10 most frequent values of each attribute stored in the MISC field"""
+
+    def __init__(self, maxvalues=10):
+        
+        """Create the corefud.MiscStats
+
+        Args:
+        maxvalues: the number of most frequent values
+                   to be printed for each attribute.
+
+        """
+        self.maxvalues = maxvalues
+        self.valuecounter = {}
+        self.zones = 'all'
+
+    def process_node(self,node):
+        for attrname in node.misc:
+            shortattrname = re.sub(r'\[\d+\]',r'',attrname)
+            if not shortattrname in self.valuecounter:
+                self.valuecounter[shortattrname] = Counter()
+            self.valuecounter[shortattrname][node.misc[attrname]] += 1
+
+    def process_end(self):
+        for attrname in self.valuecounter:
+            print("MISC attribute: "+attrname)
+            for value,freq in self.valuecounter[attrname].most_common(self.maxvalues):
+                print("    "+str(value)+"   "+str(freq))

From 1def22ea2da0fd4ced8cb999c7fb180e69309702 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 27 Jan 2021 23:42:58 +0100
Subject: [PATCH 0272/1374] call super() constructor

---
 udapi/block/corefud/miscstats.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/corefud/miscstats.py b/udapi/block/corefud/miscstats.py
index 4f4e86c0..e7aabc03 100644
--- a/udapi/block/corefud/miscstats.py
+++ b/udapi/block/corefud/miscstats.py
@@ -5,7 +5,7 @@
 class MiscStats(Block):
     """Block corefud.MiscStats prints 10 most frequent values of each attribute stored in the MISC field"""
 
-    def __init__(self, maxvalues=10):
+    def __init__(self, maxvalues=10, **kwargs):
         
         """Create the corefud.MiscStats
 
@@ -14,9 +14,9 @@ def __init__(self, maxvalues=10):
                    to be printed for each attribute.
 
         """
+        super().__init__(**kwargs)
         self.maxvalues = maxvalues
         self.valuecounter = {}
-        self.zones = 'all'
 
     def process_node(self,node):
         for attrname in node.misc:

From 8a4d1b2a6467aaa84aafb0009726d636db8584e6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 27 Jan 2021 23:43:52 +0100
Subject: [PATCH 0273/1374] allow `util.See stats=misc_split` similarly to
 feats_split

---
 udapi/core/node.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 32061b16..3c917e29 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -514,6 +514,8 @@ def _get_attr(self, name):  # pylint: disable=too-many-return-statements
             return value
         if name == 'feats_split':
             return str(self.feats).split('|')
+        if name == 'misc_split':
+            return str(self.misc).split('|')
         if name.startswith('feats['):
             return self.feats[name[6:-1]]
         if name.startswith('misc['):
@@ -554,7 +556,7 @@ def get_attrs(self, attrs, undefs=None, stringify=True):
             elif name.startswith('r_'):
                 nodes, name = [self.next_node], name[2:]
             for node in (n for n in nodes if n is not None):
-                if name == 'feats_split':
+                if name in {'feats_split', 'misc_split'}:
                     values.extend(node._get_attr(name))
                 else:
                     values.append(node._get_attr(name))

From 70525351aea920c8e0f0e0dbd6da6523dc68bb77 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 1 Feb 2021 08:41:38 +0100
Subject: [PATCH 0274/1374] allow `d = udapi.Document(filename="my.txt",
 rstrip="\n")`

so that spaces and `\r` at ends of lines are preserved,
which is needed in some character-indexed formats.
---
 udapi/block/read/sentences.py | 15 ++++++++++++---
 udapi/core/document.py        |  6 ++++--
 2 files changed, 16 insertions(+), 5 deletions(-)

diff --git a/udapi/block/read/sentences.py b/udapi/block/read/sentences.py
index c3a02ddd..758b4980 100644
--- a/udapi/block/read/sentences.py
+++ b/udapi/block/read/sentences.py
@@ -4,10 +4,19 @@
 
 
 class Sentences(BaseReader):
-    """A reader for plain-text sentences (one sentence per line) files."""
+    r"""A reader for plain-text sentences (one sentence per line) files.
 
-    def __init__(self, ignore_empty_lines=False, **kwargs):
+    Args:
+    ignore_empty_lines: if True, delete empty lines from the input.
+        Default=False.
+    rstrip: a set of characters to be stripped from the end of each line.
+        Default='\r\n '. You can use rstrip='\n' if you want to preserve
+        any space or '\r' (Carriage Return) at end of line,
+        so that `udpipe.Base resegment=1` keeps these characters in `SpacesAfter`.
+    """
+    def __init__(self, ignore_empty_lines=False, rstrip='\r\n ', **kwargs):
         self.ignore_empty_lines = ignore_empty_lines
+        self.rstrip = rstrip
         super().__init__(**kwargs)
 
     @staticmethod
@@ -33,5 +42,5 @@ def read_tree(self, document=None):
                 if line == '':
                     return None
         root = Root()
-        root.text = line.rstrip()
+        root.text = line.rstrip(self.rstrip)
         return root
diff --git a/udapi/core/document.py b/udapi/core/document.py
index 25699398..0f5241c5 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -11,7 +11,7 @@
 class Document(object):
     """Document is a container for Universal Dependency trees."""
 
-    def __init__(self, filename=None):
+    def __init__(self, filename=None, **kwargs):
         """Create a new Udapi document.
 
         Args:
@@ -20,6 +20,8 @@ def __init__(self, filename=None):
             and `*.txt` (using `udapi.block.read.sentences`) filenames are supported.
             No pre-processing is applied, so when loading the document from a *.txt file,
             `Document("a.txt").nodes` will be empty and you need to run tokenization first.
+            You can pass additional parameters for `udapi.block.read.sentences`
+            (`ignore_empty_lines` and `rstrip`).
         """
         self.bundles = []
         self._highest_bundle_id = 0
@@ -29,7 +31,7 @@ def __init__(self, filename=None):
             if filename.endswith(".conllu"):
                 self.load_conllu(filename)
             elif filename.endswith(".txt"):
-                reader = SentencesReader(files=filename)
+                reader = SentencesReader(files=filename, **kwargs)
                 reader.apply_on_document(self)
             else:
                 raise ValueError("Only *.conllu and *.txt are supported. Provided: " + filename)

From 18a5f173d15008a3cf3221b05ff3b25c6a1387b2 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 2 Feb 2021 17:21:53 +0100
Subject: [PATCH 0275/1374] "udapy -X" for adding params to the end of the
 scenario

---
 bin/udapy | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/bin/udapy b/bin/udapy
index 9bb58f53..eaaa00cc 100755
--- a/bin/udapy
+++ b/bin/udapy
@@ -42,6 +42,10 @@ argparser.add_argument(
 argparser.add_argument(
     "-N", "--no_color", action="store_true",
     help="Add color=0 to the end of the scenario, this overrides color=1 of -T and -H")
+argparser.add_argument(
+    "-X", "--extra", action="append",
+    help="Add a specified parameter (or a block name) to the end of the scenario\n"
+         "For example 'udapy -TNX attributes=form,misc -X layout=align < my.conllu'")
 argparser.add_argument(
     'scenario', nargs=argparse.REMAINDER, help="A sequence of blocks and their parameters.")
 
@@ -74,6 +78,8 @@ if __name__ == "__main__":
         args.scenario = args.scenario + ['marked_only=1']
     if args.no_color:
         args.scenario = args.scenario + ['color=0']
+    if args.extra:
+        args.scenario += args.extra
 
     runner = Run(args)
     # udapy is often piped to head etc., e.g.

From 4c7c8e10dc0f5151fae5b6222b84cf84b47121c6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 2 Feb 2021 18:46:03 +0100
Subject: [PATCH 0276/1374] improved ud.SetSpaceAfter and added an
 English-specific subclass

fixes #67
---
 udapi/block/ud/en/__init__.py      |  0
 udapi/block/ud/en/setspaceafter.py | 46 ++++++++++++++++++++++++++++++
 udapi/block/ud/setspaceafter.py    | 28 ++++++++++--------
 3 files changed, 62 insertions(+), 12 deletions(-)
 create mode 100644 udapi/block/ud/en/__init__.py
 create mode 100644 udapi/block/ud/en/setspaceafter.py

diff --git a/udapi/block/ud/en/__init__.py b/udapi/block/ud/en/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/ud/en/setspaceafter.py b/udapi/block/ud/en/setspaceafter.py
new file mode 100644
index 00000000..1ebc3054
--- /dev/null
+++ b/udapi/block/ud/en/setspaceafter.py
@@ -0,0 +1,46 @@
+"""Block ud.en.SetSpaceAfter for heuristic setting of SpaceAfter=No in English.
+
+Usage::
+
+  udapy -s ud.en.SetSpaceAfter < in.conllu > fixed.conllu
+
+Author: Martin Popel
+"""
+import udapi.block.ud.setspaceafter
+
+
+class SetSpaceAfter(udapi.block.ud.setspaceafter.SetSpaceAfter):
+    """Block for heuristic setting of the SpaceAfter=No MISC attribute in English.
+
+    """
+
+    def process_tree(self, root):
+        nodes = root.descendants
+        for i, node in enumerate(nodes[:-1]):
+            next_form = nodes[i + 1].form
+            
+            # Contractions like "don't" and possessive suffix 's should be annotated as MWT.
+            # However, older UD_English-EWT versions did not follow this rule and even v2.7
+            # contains some forgotten occurrences, so let's handle these as well.           
+            if next_form in {"n't", "'s"}:
+                self.mark_no_space(node)
+
+            # Parsers may distinguish opening and closing single quotes by XPOS.
+            elif node.form == "'" and node.xpos == "``":
+                self.mark_no_space(node)
+            elif next_form == "'" and nodes[i + 1].xpos == "''":
+                self.mark_no_space(node)
+
+
+            # hyphen-compounds
+            elif node.form == '-' and i:
+                if ((nodes[i - 1] is node.parent or nodes[i - 1].parent is node.parent) and
+                    (nodes[i + 1] is node.parent or nodes[i + 1].parent is node.parent)):
+                    self.mark_no_space(nodes[i - 1])
+                    self.mark_no_space(node)
+            
+            # $200
+            elif node.form == '$' and nodes[i + 1].upos == 'NUM':
+                self.mark_no_space(node)
+
+        super().process_tree(root)
diff --git a/udapi/block/ud/setspaceafter.py b/udapi/block/ud/setspaceafter.py
index e796bf0d..04c9fffb 100644
--- a/udapi/block/ud/setspaceafter.py
+++ b/udapi/block/ud/setspaceafter.py
@@ -13,10 +13,11 @@
 class SetSpaceAfter(Block):
     """Block for heuristic setting of the SpaceAfter=No MISC attribute."""
 
-    def __init__(self, not_after='¡¿([{„', not_before='.,;:!?}])', fix_text=True, **kwargs):
+    def __init__(self, not_after='¡ ¿ ( [ { „ /', not_before='. , ; : ! ? } ] ) / ?? ??? !! !!! ... …',
+                 fix_text=True, extra_not_after='', extra_not_before='', **kwargs):
         super().__init__(**kwargs)
-        self.not_after = not_after
-        self.not_before = not_before
+        self.not_after = (not_after + ' ' + extra_not_after).split(' ')
+        self.not_before = (not_before + ' ' + extra_not_before).split(' ')
         self.fix_text = fix_text
         self.changed = False
 
@@ -26,7 +27,7 @@ def process_tree(self, root):
         self.changed = False
 
         # Undirected double quotes are ambiguous.
-        # If there is an even number of quotes in a sentence, supposed they are not nested
+        # If there is an even number of quotes in a sentence, suppose they are not nested
         # and treat odd-indexed ones as opening and even-indexed ones as closing.
         # Otherwise (odd number, e.g. when quoting multiple sentences), don't remove any space.
         matching_quotes = not bool(count_of_form['"'] % 2)
@@ -36,22 +37,25 @@ def process_tree(self, root):
         # Some languages use directed „quotes“ and some “quotes”,
         # so the symbol “ (U+201C) is ambiguous and we heuristically check for presence of „.
         if count_of_form['„']:
-            not_before += '“'
+            not_before += ['“']
         else:
-            not_after += '“'
+            not_after += ['“']
 
         for i, node in enumerate(nodes[:-1]):
             next_form = nodes[i + 1].form
             if node.form in self.not_after or next_form in not_before:
                 self.mark_no_space(node)
-            if matching_quotes and node.form == '"':
-                if odd_indexed_quote:
+            if node.form == '"':
+                if matching_quotes:
+                    if odd_indexed_quote:
+                        self.mark_no_space(node)
+                    elif i:
+                        self.mark_no_space(nodes[i - 1])
+                    odd_indexed_quote = not odd_indexed_quote
+                elif i==0:
                     self.mark_no_space(node)
-                elif i:
-                    self.mark_no_space(nodes[i - 1])
-                odd_indexed_quote = not odd_indexed_quote
 
-        if matching_quotes and nodes[-1].form == '"':
+        if nodes[-1].form == '"':
             self.mark_no_space(nodes[-2])
 
         if self.fix_text and self.changed:

From fee50975f11aec6659eb0ea130da1aabef2bc2ec Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 Feb 2021 06:28:16 +0100
Subject: [PATCH 0277/1374] bundle.document instead of bundle.document() for
 consistency

---
 udapi/core/bundle.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/core/bundle.py b/udapi/core/bundle.py
index 591b8a84..110ed42c 100644
--- a/udapi/core/bundle.py
+++ b/udapi/core/bundle.py
@@ -46,6 +46,7 @@ def __str__(self):
     def __iter__(self):
         return iter(self.trees)
 
+    @property
     def document(self):
         """Returns the document in which the bundle is contained."""
         return self._document

From c4567359290f406ea6b71c48857ff2975037ce88 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 Feb 2021 06:33:02 +0100
Subject: [PATCH 0278/1374] basic support for coreference

---
 udapi/core/basewriter.py |   2 +
 udapi/core/coref.py      | 193 +++++++++++++++++++++++++++++++++++++++
 udapi/core/document.py   |  18 ++++
 udapi/core/node.py       |  17 ++++
 udapi/core/root.py       |   4 +
 5 files changed, 234 insertions(+)
 create mode 100644 udapi/core/coref.py

diff --git a/udapi/core/basewriter.py b/udapi/core/basewriter.py
index 1d64e874..3f28d155 100644
--- a/udapi/core/basewriter.py
+++ b/udapi/core/basewriter.py
@@ -2,6 +2,7 @@
 import sys
 import logging
 
+import udapi.core.coref
 from udapi.core.block import Block
 from udapi.core.files import Files
 
@@ -39,6 +40,7 @@ def next_filename(self):
         return self.files.next_filename()
 
     def before_process_document(self, document):
+        udapi.core.coref.store_coref_to_misc(document)
         if self.orig_files == '<filehandle>':
             logging.info('Writing to filehandle.')
             sys.stdout = self.files.filehandle
diff --git a/udapi/core/coref.py b/udapi/core/coref.py
new file mode 100644
index 00000000..7fae4387
--- /dev/null
+++ b/udapi/core/coref.py
@@ -0,0 +1,193 @@
+"""Classes for handling coreference."""
+
+class CorefMention(object):
+    """Class for representing a mention (instance of an entity)."""
+    __slots__ = ['_head', '_cluster', '_bridging', '_words']
+
+    def __init__(self, head, cluster=None):
+        self._head = head
+        self._cluster = cluster
+        if cluster is not None:
+            cluster._mentions.append(self)
+        self._bridging = None
+        self._words = []
+
+    @property
+    def head(self):
+        return self._head
+
+    # TODO change head - make sure it is already within the span (_words) or add it?
+
+    @property
+    def cluster(self):
+        return self._cluster
+
+    @cluster.setter
+    def cluster(self, new_cluster):
+        if self._cluster is not None:
+            raise NotImplementedError('changing the cluster of a mention not supported yet')
+        self._cluster = new_cluster
+        new_cluster._mentions.append(new_cluster)
+
+    @property
+    def bridging(self):
+        return self._bridging
+
+    # TODO add/edit bridging
+
+    @property
+    def words(self):
+        return self._words
+
+    @words.setter
+    def words(self, new_words):
+        if self.head not in new_words:
+            raise ValueError(f"Head {self.head} not in new_words {new_words}")
+        for old_word in self._words:
+            old_word._mentions.remove(self)
+        self._words = new_words
+        for new_word in new_words:
+            new_word._mentions.append(self)
+
+    @property
+    def span(self):
+        def _nums_to_ranges(nums):
+            lo, hi = nums[0], nums[0]
+            for num in nums[1:]:
+                if num == hi + 1:
+                    hi = num
+                else:
+                    yield (lo, hi)
+                    lo, hi = num, num
+            yield (lo, hi)
+
+        if not self._words:
+            return ''
+        ords = sorted(n.ord for n in self._words)
+        if len(ords) == 1:
+            return str(ords[0])
+        first, last = ords[0], ords[-1]
+        if ords == list(range(first, last+1)):
+            return "%g-%g" % (first, last)
+        return ','.join( '%g' % r[0] if r[0]==r[1] else '%g-%g' % r for r in _nums_to_ranges(ords))
+
+    @span.setter
+    def span(self, new_span):
+        ranges = []
+        for span_str in new_span.split(','):
+            if '-' not in span_str:
+                lo = hi = float(span_str)
+            else:
+                lo, hi = (float(x) for x in span_str.split('-'))
+            ranges.append((lo, hi))
+
+        def _num_in_ranges(num):
+            for (lo, hi) in ranges:
+                if num > hi:
+                    return False
+                if num >= lo:
+                    return True
+                return False
+
+        new_words = [w for w in self._head.root.descendants_and_empty if _num_in_ranges(w.ord)]
+        self.words = new_words
+
+
+class CorefCluster(object):
+    """Class for representing all mentions of a given entity."""
+    __slots__ = ['_cluster_id', '_mentions', 'cluster_type', '_split_ante']
+
+    def __init__(self, cluster_id, cluster_type=None):
+        self._cluster_id = cluster_id
+        self._mentions = []
+        self.cluster_type = cluster_type
+        self._split_ante = None
+
+    @property
+    def cluster_id(self):
+        return self._cluster_id
+
+    @property
+    def mentions(self):
+        return self._mentions
+
+    def create_mention(self, head, mention_words=None, mention_span=None):
+        if mention_words is not None and mention_span is not None:
+            raise ValueError("Cannot set both mention_words and mention_span")
+        mention = CorefMention(head, self)
+        if mention_words is not None:
+            mention.words = mention_words
+        elif mention_span is not None:
+            mention.span = mention_span
+        return mention
+
+    @property
+    def split_ante(self):
+        return self._split_ante
+
+    # TODO add/edit split_ante
+
+    # TODO adapt depending on how mention.bridging is implemented (callable list subclass)
+    def all_bridging(self):
+        for m in self._mentions:
+            if m._bridging:
+                for b in m._bridging:
+                    yield b
+
+
+def create_coref_cluster(head, cluster_id=None, cluster_type=None, **kwargs):
+    clusters = head.root.bundle.document.coref_clusters
+    if not cluster_id:
+        counter = 1
+        while clusters.get('c%d' % counter):
+            counter += 1
+        cluster_id = 'c%d' % counter
+    elif clusters.get(cluster_id):
+        raise ValueError("Cluster with a id %s already exists", cluster_id)
+    cluster = CorefCluster(cluster_id, cluster_type)
+    cluster.create_mention(head, **kwargs)
+    clusters[cluster_id] = cluster
+    return cluster
+
+
+def load_coref_from_misc(doc):
+    clusters = {}
+    for node in doc.nodes:
+        cluster_id = node.misc["ClusterId"]
+        if cluster_id:
+            cluster = clusters.get(cluster_id)
+            if cluster is None:
+                cluster = CorefCluster(cluster_id)
+                clusters[cluster_id] = cluster
+            mention = CorefMention(node, cluster)
+            if node.misc["MentionSpan"]:
+                mention.span = node.misc["MentionSpan"]
+            cluster_type = node.misc["ClusterType"]
+            if cluster_type is not None:
+                if cluster.cluster_type is not None and cluster_type != cluster.cluster_type:
+                    logging.warning(f"cluster_type mismatch in {node}: {cluster.cluster_type} != {cluster_type}")
+                cluster.cluster_type = cluster_type
+            # TODO deserialize Bridging and Split
+            mention._bridging = node.misc["Bridging"]
+            mention._split_ante = node.misc["Split"]
+    doc._coref_clusters = clusters
+
+# TODO don't recompute the serialization if not needed, i.e. if doc._is_coref_stored_in_misc is True,
+# but make it False after each edit of coref or change of ord (reordering, new nodes, deleted nodes...).
+def store_coref_to_misc(doc):
+    if not doc._coref_clusters:
+        return
+    for node in doc.nodes:
+        del node.misc["ClusterId"]
+        del node.misc["MentionSpan"]
+        del node.misc["ClusterType"]
+        del node.misc["Bridging"]
+        del node.misc["Split"]
+    for cluster in doc._coref_clusters.values():
+        for mention in cluster.mentions:
+            head = mention.head
+            head.misc["ClusterId"] = cluster.cluster_id
+            head.misc["MentionSpan"] = mention.span
+            head.misc["ClusterType"] = cluster.cluster_type
+            head.misc["Bridging"] = mention.bridging
+            head.misc["Split"] = cluster.split_ante
diff --git a/udapi/core/document.py b/udapi/core/document.py
index 0f5241c5..36edb856 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -2,6 +2,7 @@
 
 import io
 import contextlib
+import udapi.core.coref
 from udapi.core.bundle import Bundle
 from udapi.block.read.conllu import Conllu as ConlluReader
 from udapi.block.write.conllu import Conllu as ConlluWriter
@@ -27,6 +28,7 @@ def __init__(self, filename=None, **kwargs):
         self._highest_bundle_id = 0
         self.meta = {}
         self.json = {}
+        self._coref_clusters = None
         if filename is not None:
             if filename.endswith(".conllu"):
                 self.load_conllu(filename)
@@ -97,3 +99,19 @@ def nodes(self):
     def draw(self, **kwargs):
         """Pretty print the trees using TextModeTrees."""
         TextModeTrees(**kwargs).run(self)
+
+    def _load_coref(self):
+        """De-serialize coreference-related objects (CorefMention, CorefCluster).
+
+        This internal method will be called automatically whenever any coref-related method is called.
+        It iterates through all nodes in the document and creates the objects based on the info in MISC
+        (stored in attributes ClusterId, MentionSpan, ClusterType, Split, Bridging).
+        """
+        if self._coref_clusters is None:
+            udapi.core.coref.load_coref_from_misc(self)
+
+    @property
+    def coref_clusters(self):
+        """A dict mapping ClusterId to a CorefCluster object."""
+        self._load_coref()
+        return self._coref_clusters
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 3c917e29..00b18c9d 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -5,6 +5,7 @@
 """
 import logging
 
+import udapi.core.coref
 from udapi.block.write.textmodetrees import TextModeTrees
 from udapi.core.dualdict import DualDict
 from udapi.core.feats import Feats
@@ -76,6 +77,7 @@ class Node(object):
         '_parent',    # Parent node.
         '_children',  # Ord-ordered list of child nodes.
         '_mwt',       # Multi-word token in which this word participates.
+        '_mentions',  # List of udapi.core.coref.CorefMention objects whose span includes this node
     ]
 
     def __init__(self, form=None, lemma=None, upos=None,  # pylint: disable=too-many-arguments
@@ -94,6 +96,7 @@ def __init__(self, form=None, lemma=None, upos=None,  # pylint: disable=too-many
         self._parent = None
         self._children = list()
         self._mwt = None
+        self._mentions = list()
 
     def __str__(self):
         """Pretty print of the Node object."""
@@ -705,6 +708,20 @@ def gloss(self):
     def gloss(self, new_gloss):
         self.misc["Gloss"] = new_gloss
 
+    @property
+    def coref_mentions(self):
+        self.root.bundle.document._load_coref()
+        return self._mentions
+
+    @property
+    def coref_clusters(self):
+        self.root.bundle.document._load_coref()
+        return [m.cluster for m in self._mentions if m.cluster is not None]
+
+    def create_coref_cluster(self, **kwargs):
+        return udapi.core.coref.create_coref_cluster(head=self, **kwargs)
+
+
 class ListOfNodes(list):
     """Helper class for results of node.children and node.descendants.
 
diff --git a/udapi/core/root.py b/udapi/core/root.py
index 7944cd55..364c6845 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -235,6 +235,10 @@ def token_descendants(self):
                 result.append(node)
         return result
 
+    @property
+    def descendants_and_empty(self):
+        return sorted(self._descendants + self.empty_nodes, key=lambda n: float(n.ord))
+
     def steal_nodes(self, nodes):
         """Move nodes from another tree to this tree (append)."""
         old_root = nodes[0].root

From bf25a8ae3d986ec1df68a773d4914a10e237a0eb Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 Feb 2021 17:52:21 +0100
Subject: [PATCH 0279/1374] bump to 0.2.3

- require Python 3.6+ due to f-strings
- Travis test with Python 3.6-3.9
- expect pip older than 2016, which knows python_requires
---
 .travis.yml |  4 ++--
 CHANGES.txt |  6 +++++-
 README.md   |  2 +-
 setup.py    | 10 ++--------
 4 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 8d5f2f69..92714116 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,9 +1,9 @@
 language: python
 python:
-  - "3.4"
-  - "3.5"
   - "3.6"
   - "3.7"
+  - "3.8"
+  - "3.9"
 before_install:
   - sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
   - sudo apt-get update -qq
diff --git a/CHANGES.txt b/CHANGES.txt
index dbcd9702..73418e3b 100644
--- a/CHANGES.txt
+++ b/CHANGES.txt
@@ -2,10 +2,14 @@ Udapi Change Log
 ----------------
 See https://github.com/udapi/udapi-python/commits/master for details.
 
+0.2.3 2021-02-04
+ - support for enhanced dependencies and coreference
+ - requires Python 3.6+ due to f-strings
+
 0.2.2 2018-01-08
  - support for loading/storing documents from/to strings
  - allow private modules (starting with dot instead of udapi.block)
  - MorphoDiTa wrapper udapi/tool/morphodita.py
  - root.sent_id returns always the same as root.address()
 
-0.2.1 2017-10-23 the first PyPI release
\ No newline at end of file
+0.2.1 2017-10-23 the first PyPI release
diff --git a/README.md b/README.md
index a082cc00..3bf52eec 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@ Python framework for processing Universal Dependencies data
 [![Documentation Status](https://readthedocs.org/projects/udapi/badge/)](http://udapi.readthedocs.io)
 
 ## Requirements
-- You need Python 3.3 or higher.
+- You need Python 3.6 or higher.
 - If the [ufal.udpipe](https://pypi.python.org/pypi/ufal.udpipe/) parser is needed,
   make sure you have a C++11 compiler (e.g. [g++ 4.7 or newer](.travis.yml#L9))
   and install UDPipe with `pip3 install --user --upgrade ufal.udpipe`.
diff --git a/setup.py b/setup.py
index 7197d909..804ebd59 100644
--- a/setup.py
+++ b/setup.py
@@ -2,15 +2,9 @@
 
 from setuptools import setup, find_packages
 
-# python_requires is supported by pip only from November 2016,
-# so let's check the Python version also the old way.
-import sys
-if sys.version_info < (3, 3):
-    raise SystemExit('Udapi requires Python 3.3 or higher.')
-
 setup(
     name='udapi',
-    version='0.2.2',
+    version='0.2.3',
     description='Python framework for processing Universal Dependencies data',
     long_description=(
       'Udapi is an open-source framework providing API for processing '
@@ -27,7 +21,7 @@
     scripts=['bin/udapy'],
     tests_require=['pytest'],
     install_requires=['colorama', 'termcolor'],
-    python_requires='>=3.3',
+    python_requires='>=3.6',
     license='GPL 2 or newer',
     platforms='any',
 )

From 156b66ed2903757a2ffa51944be65713a68f27ab Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 4 Feb 2021 22:03:36 +0100
Subject: [PATCH 0280/1374] create_mention improvements - If no head is
 specified, the first word from mention_words will be used instead. - If
 mention_words are provided, they must contain the head. - docstring

---
 udapi/core/coref.py | 102 ++++++++++++++++++++++++++++++++------------
 1 file changed, 75 insertions(+), 27 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 7fae4387..162cc15b 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -45,7 +45,7 @@ def words(self, new_words):
             raise ValueError(f"Head {self.head} not in new_words {new_words}")
         for old_word in self._words:
             old_word._mentions.remove(self)
-        self._words = new_words
+        self._words = new_words # TODO sorted
         for new_word in new_words:
             new_word._mentions.append(self)
 
@@ -63,7 +63,7 @@ def _nums_to_ranges(nums):
 
         if not self._words:
             return ''
-        ords = sorted(n.ord for n in self._words)
+        ords = sorted(n.ord for n in self._words) # TODO vypustit sorted
         if len(ords) == 1:
             return str(ords[0])
         first, last = ords[0], ords[-1]
@@ -73,24 +73,7 @@ def _nums_to_ranges(nums):
 
     @span.setter
     def span(self, new_span):
-        ranges = []
-        for span_str in new_span.split(','):
-            if '-' not in span_str:
-                lo = hi = float(span_str)
-            else:
-                lo, hi = (float(x) for x in span_str.split('-'))
-            ranges.append((lo, hi))
-
-        def _num_in_ranges(num):
-            for (lo, hi) in ranges:
-                if num > hi:
-                    return False
-                if num >= lo:
-                    return True
-                return False
-
-        new_words = [w for w in self._head.root.descendants_and_empty if _num_in_ranges(w.ord)]
-        self.words = new_words
+        self.words = span_to_nodes(self._head.root, new_span)
 
 
 class CorefCluster(object):
@@ -109,15 +92,41 @@ def cluster_id(self):
 
     @property
     def mentions(self):
+        #TODO return sorted(self._mentions, key=lambda x:...
         return self._mentions
 
-    def create_mention(self, head, mention_words=None, mention_span=None):
-        if mention_words is not None and mention_span is not None:
-            raise ValueError("Cannot set both mention_words and mention_span")
+    def create_mention(self, head=None, mention_words=None, mention_span=None):
+        """Create a new CoreferenceMention object within this CorefCluster.
+
+        Args:
+        head: a node where the annotation about this CorefMention will be stored in MISC.
+            The head is supposed to be the linguistic head of the mention,
+            i.e. the highest node in the dependency tree,
+            but if such information is not available (yet),
+            it can be any node within the mention_words.
+            If no head is specified, the first word from mention_words will be used instead.
+        mention_words: a list of nodes of the mention.
+            This argument is optional, but if provided, it must contain the head.
+            The nodes can be both normal nodes or empty nodes.
+        mention_span: an alternative way how to specify mention_words
+            using a string such as "3-5,6,7.1-7.2".
+            (which means, there is an empty node 5.1 and normal node 7,
+            which are not part of the mention).
+            At most one of the args mention_words and mention_span can be specified.
+        """
+        if mention_words and mention_span:
+            raise ValueError("Cannot specify both mention_words and mention_span")
+        if head and mention_words and head not in mention_words:
+            raise ValueError(f"Head {head} is not among the specified mention_words")
+        if head is None and mention_words is None:
+            raise ValueError("Either head or mention_words must be specified")
+        if head is None:
+            head = mention_words[0]
+
         mention = CorefMention(head, self)
-        if mention_words is not None:
+        if mention_words:
             mention.words = mention_words
-        elif mention_span is not None:
+        if mention_span:
             mention.span = mention_span
         return mention
 
@@ -172,8 +181,7 @@ def load_coref_from_misc(doc):
             mention._split_ante = node.misc["Split"]
     doc._coref_clusters = clusters
 
-# TODO don't recompute the serialization if not needed, i.e. if doc._is_coref_stored_in_misc is True,
-# but make it False after each edit of coref or change of ord (reordering, new nodes, deleted nodes...).
+
 def store_coref_to_misc(doc):
     if not doc._coref_clusters:
         return
@@ -191,3 +199,43 @@ def store_coref_to_misc(doc):
             head.misc["ClusterType"] = cluster.cluster_type
             head.misc["Bridging"] = mention.bridging
             head.misc["Split"] = cluster.split_ante
+
+
+def span_to_nodes(root, span):
+    ranges = []
+    for span_str in span.split(','):
+        if '-' not in span_str:
+            lo = hi = float(span_str)
+        else:
+            lo, hi = (float(x) for x in span_str.split('-'))
+        ranges.append((lo, hi))
+
+    def _num_in_ranges(num):
+        for (lo, hi) in ranges:
+            if num > hi:
+                return False
+            if num >= lo:
+                return True
+            return False
+
+    return [w for w in root.descendants_and_empty if _num_in_ranges(w.ord)]
+
+
+def nodes_to_span(nodes):
+    def _nums_to_ranges(nums):
+        lo, hi = nums[0], nums[0]
+        for num in nums[1:]:
+            if num == hi + 1:
+                hi = num
+            else:
+                yield (lo, hi)
+                lo, hi = num, num
+        yield (lo, hi)
+
+    ords = sorted(n.ord for n in nodes) # TODO vypustit sorted
+    if len(ords) == 1:
+        return str(ords[0])
+    first, last = ords[0], ords[-1]
+    if ords == list(range(first, last+1)):
+        return "%g-%g" % (first, last)
+    return ','.join( '%g' % r[0] if r[0]==r[1] else '%g-%g' % r for r in _nums_to_ranges(ords))

From 5086ca0b70943e19003bb9e51e3947d4f429e2ca Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 4 Feb 2021 22:51:04 +0100
Subject: [PATCH 0281/1374] report span correctly, e.g. "3-5,6" if there is 5.1
 which is not part of the span

---
 udapi/core/coref.py | 60 ++++++++++++++++++---------------------------
 1 file changed, 24 insertions(+), 36 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 162cc15b..2a47b3ea 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -51,25 +51,7 @@ def words(self, new_words):
 
     @property
     def span(self):
-        def _nums_to_ranges(nums):
-            lo, hi = nums[0], nums[0]
-            for num in nums[1:]:
-                if num == hi + 1:
-                    hi = num
-                else:
-                    yield (lo, hi)
-                    lo, hi = num, num
-            yield (lo, hi)
-
-        if not self._words:
-            return ''
-        ords = sorted(n.ord for n in self._words) # TODO vypustit sorted
-        if len(ords) == 1:
-            return str(ords[0])
-        first, last = ords[0], ords[-1]
-        if ords == list(range(first, last+1)):
-            return "%g-%g" % (first, last)
-        return ','.join( '%g' % r[0] if r[0]==r[1] else '%g-%g' % r for r in _nums_to_ranges(ords))
+        return nodes_to_span(self._words)
 
     @span.setter
     def span(self, new_span):
@@ -222,20 +204,26 @@ def _num_in_ranges(num):
 
 
 def nodes_to_span(nodes):
-    def _nums_to_ranges(nums):
-        lo, hi = nums[0], nums[0]
-        for num in nums[1:]:
-            if num == hi + 1:
-                hi = num
-            else:
-                yield (lo, hi)
-                lo, hi = num, num
-        yield (lo, hi)
-
-    ords = sorted(n.ord for n in nodes) # TODO vypustit sorted
-    if len(ords) == 1:
-        return str(ords[0])
-    first, last = ords[0], ords[-1]
-    if ords == list(range(first, last+1)):
-        return "%g-%g" % (first, last)
-    return ','.join( '%g' % r[0] if r[0]==r[1] else '%g-%g' % r for r in _nums_to_ranges(ords))
+    """Converts a list of nodes into a string specifying ranges of their ords.
+
+    For example, nodes with ords 3, 4, 5 and 7 will be converted to "3-5,7".
+    The function handles also empty nodes, so e.g. 3.1, 3.2 and 3.3 will be converted to "3.1-3.3".
+    Note that empty nodes may form gaps in the span, so if a given tree contains
+    an empty node with ord 5.1, but only nodes with ords 3, 4, 5, 6, 7.1 and 7.2
+    are provided as `nodes`, the resulting string will be "3-5,6,7.1-7.2".
+    This means that the implementation needs to iterate of all nodes
+    in a given tree (root.descendants_and_empty) to check for such gaps.
+    """
+    if not nodes:
+        return ''
+    all_nodes = nodes[0].root.descendants_and_empty
+    i, found, ranges = -1, 0, []
+    while i + 1 < len(all_nodes) and found < len(nodes):
+        i += 1
+        if all_nodes[i] in nodes:
+            lo = all_nodes[i].ord
+            while i < len(all_nodes) and all_nodes[i] in nodes:
+                i, found = i + 1, found + 1
+            hi = all_nodes[i - 1].ord
+            ranges.append(f"{lo}-{hi}" if hi > lo else f"{lo}")
+    return ','.join(ranges)

From 75e59cf7c5c9b6132eff480246977cfd39ca7a26 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 4 Feb 2021 22:56:36 +0100
Subject: [PATCH 0282/1374] cluster_mention.head = new_head

---
 udapi/core/coref.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 2a47b3ea..d00eb058 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -16,7 +16,11 @@ def __init__(self, head, cluster=None):
     def head(self):
         return self._head
 
-    # TODO change head - make sure it is already within the span (_words) or add it?
+    @head.setter
+    def head(self, new_head):
+        if new_head not in self._words:
+            raise ValueError(f"New head {new_head} not in mention words")
+        self._head = new_head
 
     @property
     def cluster(self):
@@ -42,7 +46,7 @@ def words(self):
     @words.setter
     def words(self, new_words):
         if self.head not in new_words:
-            raise ValueError(f"Head {self.head} not in new_words {new_words}")
+            raise ValueError(f"Head {self.head} not in new_words")
         for old_word in self._words:
             old_word._mentions.remove(self)
         self._words = new_words # TODO sorted

From 64264ec98815782ab136f536010fe0b33ae878dc Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 Feb 2021 15:50:36 +0100
Subject: [PATCH 0283/1374] rename misc["Split"] to misc["SplitAnte"]

and store it in CorefCluster, not CorefMention
---
 udapi/core/coref.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index d00eb058..32e0a87a 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -162,9 +162,9 @@ def load_coref_from_misc(doc):
                 if cluster.cluster_type is not None and cluster_type != cluster.cluster_type:
                     logging.warning(f"cluster_type mismatch in {node}: {cluster.cluster_type} != {cluster_type}")
                 cluster.cluster_type = cluster_type
-            # TODO deserialize Bridging and Split
+            # TODO deserialize Bridging and SplitAnte
             mention._bridging = node.misc["Bridging"]
-            mention._split_ante = node.misc["Split"]
+            cluster._split_ante = node.misc["SplitAnte"]
     doc._coref_clusters = clusters
 
 
@@ -176,7 +176,7 @@ def store_coref_to_misc(doc):
         del node.misc["MentionSpan"]
         del node.misc["ClusterType"]
         del node.misc["Bridging"]
-        del node.misc["Split"]
+        del node.misc["SplitAnte"]
     for cluster in doc._coref_clusters.values():
         for mention in cluster.mentions:
             head = mention.head
@@ -184,7 +184,7 @@ def store_coref_to_misc(doc):
             head.misc["MentionSpan"] = mention.span
             head.misc["ClusterType"] = cluster.cluster_type
             head.misc["Bridging"] = mention.bridging
-            head.misc["Split"] = cluster.split_ante
+            head.misc["SplitAnte"] = cluster.split_ante
 
 
 def span_to_nodes(root, span):

From e82ff0eb27c72bba1fdc7c6ab439ed6c94dafb77 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 Feb 2021 16:21:26 +0100
Subject: [PATCH 0284/1374] more pythonic

---
 udapi/core/node.py | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 00b18c9d..7aaa3984 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -232,16 +232,13 @@ def deps(self):
 
             for raw_dependency in self._raw_deps.split('|'):
                 # Deprel itself may contain one or more ':' (subtypes).
-                pieces = raw_dependency.split(':')
-                head = pieces[0]
-                deprel = ':'.join(pieces[1:])
+                head, deprel = raw_dependency.split(':', maxsplit=1)
                 # Empty nodes have to be located differently than normal nodes.
                 if '.' in head:
-                    matching = [x for x in self.root.empty_nodes if x.ord == head]
-                    if len(matching) > 0:
-                        parent = matching[0]
-                    else:
-                        parent = None ###!!! what should we do here?
+                    try:
+                        parent = next(x for x in self.root.empty_nodes if x.ord == head)
+                    except StopIteration:
+                        raise ValueError(f'Empty node with ord={head} not found')
                 else:
                     parent = nodes[int(head)]
                 self._deps.append({'parent': parent, 'deprel': deprel})

From 459d4ecd35b8ac37bb19d5dc664b11fa6e2b5a4e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 Feb 2021 21:25:44 +0100
Subject: [PATCH 0285/1374] create_empty_child() creates EmptyNode

- EmptyNode is a subclass of Node
- root is stored in empty nodes, not computed
  (because empty nodes have parent=None and root may be unreachable)
- node.create_empty_child(deprel='...')
  deprel is now required - it is the enhanced UD deprel to be stored in DEPS
- argument `after` specifies the position (ord) of the newly created empty node
- root.create_empty_child() is a faster version, which does not set `deps` and `ord`.
---
 udapi/core/node.py | 46 ++++++++++++++++++++++++++++++++++++++++++----
 udapi/core/root.py | 15 ++++++++++++++-
 2 files changed, 56 insertions(+), 5 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 7aaa3984..cc1c7110 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -369,12 +369,36 @@ def create_child(self, **kwargs):
         new_node.parent = self
         return new_node
 
-    def create_empty_child(self, **kwargs):
-        """Create and return a new empty node child of the current node."""
-        new_node = Node(**kwargs)
-        self.root.empty_nodes.append(new_node)
+    def create_empty_child(self, deprel, after=True, **kwargs):
+        """Create and return a new empty node child of the current node.
+
+        Args:
+            deprel: the enhanced dependency relation (required to be stored in DEPS)
+            form, lemma, upos, xpos, feats, misc: as in Node, the default is '_'
+            after: position the newly created empty node after this `node`?
+                If True (default), the `new_node.ord` will be `node.ord + 0.1`,
+                unless there is already an empty node with such ord,
+                in which case it will be `node.ord + 0.2` etc.
+                If False, the new node will be placed immediately before `node`.
+        """
+        new_node = EmptyNode(root=self.root, **kwargs)
+        new_node.deps = [{'parent': self, 'deprel': deprel}]
         # self.enh_children.append(new_node) TODO
         # new_node.enh_parents.append(self) TODO
+        base_ord = self.ord if after else self.ord - 1
+        new_ord = base_ord + 0.1
+        for empty in self.root.empty_nodes:
+            if empty.ord > new_ord:
+                break
+            if empty.ord == new_ord:
+                #if isinstance(new_ord, OrdTuple);
+                #    new_ord.increase()
+                #elif new_ord == base_ord + 0.9:
+                #    new_ord = OrdTuple(base_ord, 10)
+                #else:
+                new_ord = round(new_ord+0.1, 1)
+        new_node.ord = new_ord
+        self.root.empty_nodes.append(new_node)
         return new_node
 
     # TODO: make private: _unordered_descendants
@@ -719,6 +743,20 @@ def create_coref_cluster(self, **kwargs):
         return udapi.core.coref.create_coref_cluster(head=self, **kwargs)
 
 
+class EmptyNode(Node):
+    """Class for representing empty nodes (for ellipsis in enhanced UD)."""
+    __slots__ = ['_root']
+
+    def __init__(self, root, form='_', lemma='_', upos='_', xpos='_', feats='_', misc='_'):
+        super().__init__(form=form, lemma=lemma, upos=upos,
+                         xpos=xpos, feats=feats, deprel='_', misc=misc)
+        self._root = root
+
+    @property
+    def root(self):
+        return self._root
+
+
 class ListOfNodes(list):
     """Helper class for results of node.children and node.descendants.
 
diff --git a/udapi/core/root.py b/udapi/core/root.py
index 364c6845..a47bcf8e 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -1,7 +1,7 @@
 """Root class represents the technical root node in each tree."""
 import logging
 
-from udapi.core.node import Node, ListOfNodes
+from udapi.core.node import Node, EmptyNode, ListOfNodes
 from udapi.core.mwt import MWT
 
 # 7 instance attributes is too low (CoNLL-U has 10 columns)
@@ -142,6 +142,19 @@ def shift(self, reference_node, after=0, move_subtree=0, reference_subtree=0):
         """Attempts at changing the word order of root result in Exception."""
         raise Exception('Technical root cannot be shifted as it is always the first node')
 
+    def create_empty_child(self, **kwargs):
+        """Create and return a new empty node within this tree.
+
+        This root-specific implementation overrides `Node.create_empty_child()'.
+        It is faster because it does not set `deps` and `ord` of the newly created node.
+        It is up to the user to set up these attributes correctly.
+        It is used in `udapi.block.read.conllu` (where speed is important and thus,
+        only `raw_deps` are set up instead of `deps`).
+        """
+        new_node = EmptyNode(root=self, **kwargs)
+        self.empty_nodes.append(new_node)
+        return new_node
+
     # TODO document whether misc is a string or dict or it can be both
     def create_multiword_token(self, words=None, form=None, misc=None):
         """Create and return a new multi-word token (MWT) in this tree.

From 82a6d2dbab862f42a5e9bb0e3e10d0d57bd7f549 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 Feb 2021 21:48:25 +0100
Subject: [PATCH 0286/1374] fix write.Conllu, so that None attributes are
 converted to _

In Python, empty attributes should be None (it is more memory efficient than '_'),
the underscore is just a matter of CoNLL-U serialization.
---
 udapi/block/write/conllu.py | 3 ++-
 udapi/core/node.py          | 7 +++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index 4b931bac..50cf366d 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -56,7 +56,8 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
                 if next_empty_ord > last_ord:
                     break
                 empty = empty_nodes.pop(0)
-                values = [str(getattr(empty, a)) for a in self.node_attributes]
+                values = [getattr(empty, attr_name) for attr_name in self.node_attributes]
+                values = ['_' if v is None else str(v) for v in values]
                 values[6] = '_'
                 values[7] = '_'
                 print('\t'.join(values))
diff --git a/udapi/core/node.py b/udapi/core/node.py
index cc1c7110..680009c9 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -1,6 +1,6 @@
 """Node class and related classes and functions.
 
-In addition to class `Node`, this module contains class `ListOfNodes`
+In addition to class `Node`, this module contains also classes `EmptyNode` and `ListOfNodes`
 and function `find_minimal_common_treelet`.
 """
 import logging
@@ -747,9 +747,8 @@ class EmptyNode(Node):
     """Class for representing empty nodes (for ellipsis in enhanced UD)."""
     __slots__ = ['_root']
 
-    def __init__(self, root, form='_', lemma='_', upos='_', xpos='_', feats='_', misc='_'):
-        super().__init__(form=form, lemma=lemma, upos=upos,
-                         xpos=xpos, feats=feats, deprel='_', misc=misc)
+    def __init__(self, root, form=None, lemma=None, upos=None, xpos=None, feats=None, misc=None):
+        super().__init__(form=form, lemma=lemma, upos=upos, xpos=xpos, feats=feats, misc=misc)
         self._root = root
 
     @property

From dc09ee577f7f42ed7004fbe0c75d955a8c098be3 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 Feb 2021 22:42:41 +0100
Subject: [PATCH 0287/1374] store ord in node._ord internally

so the setter can be overriden in EmptyNode
---
 udapi/core/node.py | 42 +++++++++++++++++++++++++++++++++++++++---
 1 file changed, 39 insertions(+), 3 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 680009c9..6fb0d331 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -28,9 +28,10 @@ class Node(object):
     Attributes `form`, `lemma`, `upos`, `xpos` and `deprel` are public attributes of type `str`,
     so you can use e.g. `node.lemma = node.form`.
 
-    `node.ord` is a int type public attribute for storing the node's word order index,
+    `node.ord` is a int type property for storing the node's word-order index,
     but assigning to it should be done with care, so the non-root nodes have `ord`s 1,2,3...
     It is recommended to use one of the `node.shift_*` methods for reordering nodes.
+    Note that `EmptyNode`s (subclass of `Node`) have decimal ords (and no `shift_*` methods).
 
     For changing dependency structure (topology) of the tree, there is the `parent` property,
     e.g. `node.parent = node.parent.parent` and `node.create_child()` method.
@@ -63,8 +64,10 @@ class Node(object):
     # TODO: Benchmark memory and speed of slots vs. classic dict.
     # With Python 3.5 split dict, slots may not be better.
     # TODO: Should not we include __weakref__ in slots?
+    # TODO: Benchmark using node._ord instead node.ord in this file
+    # TODO: Benchmark storing root in node._root (as it is done in EmptyNode)
     __slots__ = [
-        'ord',        # Word-order index of the node (root has 0).
+        '_ord',       # Word-order index of the node (root has 0).
         'form',       # Word form or punctuation symbol.
         'lemma',      # Lemma of word form.
         'upos',       # Universal PoS tag.
@@ -83,7 +86,7 @@ class Node(object):
     def __init__(self, form=None, lemma=None, upos=None,  # pylint: disable=too-many-arguments
                  xpos=None, feats=None, deprel=None, misc=None):
         """Create a new node and initialize its attributes using the keyword arguments."""
-        self.ord = None
+        self._ord = None
         self.form = form
         self.lemma = lemma
         self.upos = upos
@@ -102,6 +105,15 @@ def __str__(self):
         """Pretty print of the Node object."""
         return "node<%s, %s>" % (self.address(), self.form)
 
+    # ord is implemented as a property, so that it can be overriden in EmptyNode and Root
+    @property
+    def ord(self):
+        return self._ord
+
+    @ord.setter
+    def ord(self, new_ord):
+        self._ord = new_ord
+
     @property
     def udeprel(self):
         """Return the universal part of dependency relation, e.g. `acl` instead of `acl:relcl`.
@@ -755,6 +767,30 @@ def __init__(self, root, form=None, lemma=None, upos=None, xpos=None, feats=None
     def root(self):
         return self._root
 
+    @property
+    def parent(self):
+        return None
+
+    @parent.setter
+    def parent(self, _):
+        """Attempts at setting parent of EmptyNode result in AttributeError exception."""
+        raise AttributeError('EmptyNode cannot have a (basic-UD) parent.')
+
+    @property
+    def ord(self):
+        return self._ord
+
+    @ord.setter
+    def ord(self, new_ord):
+        """Empty node's ord setter accepts float and str."""
+        if isinstance(new_ord, str):
+            self._ord = float(new_ord)
+        elif isinstance(new_ord, float):
+            self._ord = new_ord
+        else:
+            raise ValueError('Only str and float are allowed for EmptyNode ord setter,'
+                             f' but {type(new_ord)} was given.')
+
 
 class ListOfNodes(list):
     """Helper class for results of node.children and node.descendants.

From e339642ee8bde3346426966c6f7f5b3627fc028c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 Feb 2021 22:55:17 +0100
Subject: [PATCH 0288/1374] class OrdTuple, so that 1.9 < OrdTuple('1.10')

---
 udapi/core/node.py | 66 ++++++++++++++++++++++++++++++++++++++++------
 1 file changed, 58 insertions(+), 8 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 6fb0d331..1564c070 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -1,9 +1,10 @@
 """Node class and related classes and functions.
 
-In addition to class `Node`, this module contains also classes `EmptyNode` and `ListOfNodes`
-and function `find_minimal_common_treelet`.
+In addition to class `Node`, this module contains also classes
+`EmptyNode`, `OrdTuple` and `ListOfNodes` and function `find_minimal_common_treelet`.
 """
 import logging
+import functools
 
 import udapi.core.coref
 from udapi.block.write.textmodetrees import TextModeTrees
@@ -403,12 +404,12 @@ def create_empty_child(self, deprel, after=True, **kwargs):
             if empty.ord > new_ord:
                 break
             if empty.ord == new_ord:
-                #if isinstance(new_ord, OrdTuple);
-                #    new_ord.increase()
-                #elif new_ord == base_ord + 0.9:
-                #    new_ord = OrdTuple(base_ord, 10)
-                #else:
-                new_ord = round(new_ord+0.1, 1)
+                if isinstance(new_ord, OrdTuple):
+                    new_ord.increase()
+                elif new_ord == base_ord + 0.9:
+                    new_ord = OrdTuple(base_ord, 10)
+                else:
+                    new_ord = round(new_ord+0.1, 1)
         new_node.ord = new_ord
         self.root.empty_nodes.append(new_node)
         return new_node
@@ -792,6 +793,55 @@ def ord(self, new_ord):
                              f' but {type(new_ord)} was given.')
 
 
+@functools.total_ordering
+class OrdTuple:
+    """Class for the rare case of 9+ consecutive empty nodes, i.e. ords x.10, x.11 etc.
+
+    Ord 1.10 cannot be stored as float, which would result in 1.1.
+    We thus store it as a tuple (1,10) wrapped in OrdTuple, so that comparisons work,
+    e.g.: 1.9 < OrdTuple('1.10') < 2
+    """
+    __slots__ = ('_key')
+
+    def __init__(self, string):
+        m = re.match(r'(\d+)\.(\d+)$', string)
+        if not m:
+            raise ValueError(f"Ord {string} does not match \\d+.\\d+")
+        major, minor = int(m.group(1)), int(m.group(2))
+        if minor == 0:
+            raise ValueError(f"Ord {string} should be stored as int")
+        if minor < 10:
+            raise ValueError(f"Ord {string} should be stored as float")
+        self._key = (major, minor)
+
+    def __repr__(self):
+        return f"{self._key[0]}.{self._key[1]}"
+
+    def __eq__(self, other):
+        if isinstance(other, int):
+            return False
+        elif isinstance(other, float):
+            return self._key == (int(other), int(10*other - 10*int(other)))
+        elif isinstance(other, OrdTuple):
+            return self._key == other._key
+        else:
+            raise ValueError(f"OrdTuple cannot be compared with {type(other)}")
+
+    def __lt__(self, other):
+        if isinstance(other, int):
+            return self._key < (other, 0)
+        elif isinstance(other, float):
+            return self._key < (int(other), int(10*other - 10*int(other)))
+        elif isinstance(other, OrdTuple):
+            return self._key < other._key
+        else:
+            raise ValueError(f"OrdTuple cannot be compared with {type(other)}")
+
+    def increase(self):
+        """Increment the decimal part of this ord."""
+        self._key = (self.key[0], self._key[1]+1)
+
+
 class ListOfNodes(list):
     """Helper class for results of node.children and node.descendants.
 

From 6dbc65c5d090b30f7645d1d739443d6a51cd3e15 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 6 Feb 2021 00:05:42 +0100
Subject: [PATCH 0289/1374] mention_words can be an empty string at any time

---
 udapi/core/coref.py | 4 ++--
 udapi/core/node.py  | 1 -
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 32e0a87a..460230b8 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -18,7 +18,7 @@ def head(self):
 
     @head.setter
     def head(self, new_head):
-        if new_head not in self._words:
+        if self._words and new_head not in self._words:
             raise ValueError(f"New head {new_head} not in mention words")
         self._head = new_head
 
@@ -45,7 +45,7 @@ def words(self):
 
     @words.setter
     def words(self, new_words):
-        if self.head not in new_words:
+        if new_words and self.head not in new_words:
             raise ValueError(f"Head {self.head} not in new_words")
         for old_word in self._words:
             old_word._mentions.remove(self)
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 1564c070..def2ee18 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -22,7 +22,6 @@
 # The set of public attributes/properties and methods of Node was well-thought.
 # pylint: disable=too-many-instance-attributes,too-many-public-methods
 
-
 class Node(object):
     """Class for representing nodes in Universal Dependency trees.
 

From 1d88f035416a75b5d46377c9dd0a6e7d739fad94 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 6 Feb 2021 00:29:42 +0100
Subject: [PATCH 0290/1374] overload __lt__, so we can use node1 < node2

---
 udapi/block/demo/complexity.py   |  8 ++++----
 udapi/core/node.py               | 10 +++++++---
 udapi/core/root.py               |  9 +++++----
 udapi/core/tests/test_enhdeps.py |  1 +
 udapi/core/tests/test_node.py    |  4 ++++
 5 files changed, 21 insertions(+), 11 deletions(-)

diff --git a/udapi/block/demo/complexity.py b/udapi/block/demo/complexity.py
index 020f8b17..99e8a046 100644
--- a/udapi/block/demo/complexity.py
+++ b/udapi/block/demo/complexity.py
@@ -144,7 +144,7 @@ def expand_subtree(self, nodes, expand_type):
             #for child in group.children:
                 #if child.udeprel != 'conj':
                     #result.extend(child.descendants(add_self=True))
-            #return = sorted(result, key=lambda n: n.ord)
+            #return = sorted(result)
         if expand_type == 'subtree_within_clause':
             stack = [n for n in nodes[0].children if n.udeprel != 'conj']
             while stack:
@@ -152,7 +152,7 @@ def expand_subtree(self, nodes, expand_type):
                 if not node.misc["ClauseHead"]:
                     nodes.append(node)
                     stack.extend(node.children())
-            return sorted(nodes, key=lambda n: n.ord)
+            return sorted(nodes)
         raise ValueError("unknown expand value " + expand_type)
 
 
@@ -182,7 +182,7 @@ def get_coord_phrase(self, root, phrase_type_function):
                     for conj in conjuncts:
                         # TODO multiword conjunctions (udeprel=flat)?
                         conjunctions.extend([n for n in conj.children if n.udeprel == 'cc'])
-                    results.append(sorted([node] + conjuncts + conjunctions, key=lambda n: n.ord))
+                    results.append(sorted([node] + conjuncts + conjunctions))
         return results
 
     # TODO koordinace hlavních i vedlejších vět
@@ -199,7 +199,7 @@ def get_t_units(self, main_heads):
                 else:
                     main_clause.append(node)
                     stack.extend(node.children)
-            main_clause = sorted(main_clause, key=lambda n: n.ord)
+            main_clause = sorted(main_clause)
 
             for dep_clause_head in dep_heads:
                 results.append(main_clause + self.expand_subtree([dep_clause_head], 'subtree'))
diff --git a/udapi/core/node.py b/udapi/core/node.py
index def2ee18..f0a4f5c0 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -22,6 +22,7 @@
 # The set of public attributes/properties and methods of Node was well-thought.
 # pylint: disable=too-many-instance-attributes,too-many-public-methods
 
+@functools.total_ordering
 class Node(object):
     """Class for representing nodes in Universal Dependency trees.
 
@@ -114,6 +115,9 @@ def ord(self):
     def ord(self, new_ord):
         self._ord = new_ord
 
+    def __lt__(self, other):
+        return self.ord < other.ord
+
     @property
     def udeprel(self):
         """Return the universal part of dependency relation, e.g. `acl` instead of `acl:relcl`.
@@ -307,7 +311,7 @@ def parent(self, new_parent):
         self._parent = new_parent
 
         # Append the current node to the new parent children.
-        new_parent._children = sorted(new_parent.children + [self], key=lambda child: child.ord)
+        new_parent._children = sorted(new_parent.children + [self])
 
     @property
     def children(self):
@@ -361,7 +365,7 @@ def descendants(self):
          nodes4 = [n for n in node.descendants if n.ord < node.ord] + [node]
         See documentation of ListOfNodes for details.
         """
-        return ListOfNodes(sorted(self.unordered_descendants(), key=lambda n: n.ord), origin=self)
+        return ListOfNodes(sorted(self.unordered_descendants()), origin=self)
 
     def is_descendant_of(self, node):
         """Is the current node a descendant of the node given as argument?"""
@@ -884,7 +888,7 @@ def __call__(self, add_self=False, following_only=False, preceding_only=False):
             result = [x for x in result if x.ord <= self.origin.ord]
         if following_only:
             result = [x for x in result if x.ord >= self.origin.ord]
-        return sorted(result, key=lambda node: node.ord)
+        return sorted(result)
 
 
 def find_minimal_common_treelet(*args):
diff --git a/udapi/core/root.py b/udapi/core/root.py
index a47bcf8e..484fa319 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -153,6 +153,7 @@ def create_empty_child(self, **kwargs):
         """
         new_node = EmptyNode(root=self, **kwargs)
         self.empty_nodes.append(new_node)
+        self.empty_nodes.sort()
         return new_node
 
     # TODO document whether misc is a string or dict or it can be both
@@ -186,7 +187,7 @@ def _update_ordering(self):
         Update also the list of all tree nodes stored in root._descendants.
         This method is automatically called after node removal or reordering.
         """
-        self._descendants = sorted(self.unordered_descendants(), key=lambda node: node.ord)
+        self._descendants = sorted(self.unordered_descendants())
         for (new_ord, node) in enumerate(self._descendants, 1):
             node.ord = new_ord
 
@@ -250,7 +251,7 @@ def token_descendants(self):
 
     @property
     def descendants_and_empty(self):
-        return sorted(self._descendants + self.empty_nodes, key=lambda n: float(n.ord))
+        return sorted(self._descendants + self.empty_nodes)
 
     def steal_nodes(self, nodes):
         """Move nodes from another tree to this tree (append)."""
@@ -258,7 +259,7 @@ def steal_nodes(self, nodes):
         for node in nodes[1:]:
             if node.root != old_root:
                 raise ValueError("steal_nodes(nodes) was called with nodes from several trees")
-        nodes = sorted(nodes, key=lambda n: n.ord)
+        nodes = sorted(nodes)
         whole_tree = nodes == old_root.descendants
         new_ord = len(self._descendants)
         # pylint: disable=protected-access
@@ -268,7 +269,7 @@ def steal_nodes(self, nodes):
             if not whole_tree:
                 for child in [n for n in node.children if n not in nodes]:
                     child._parent = old_root
-                    old_root._children = sorted(old_root.children + [child], key=lambda n: n.ord)
+                    old_root._children = sorted(old_root.children + [child])
                 node._children = [n for n in node.children if n in nodes]
             if node.parent == old_root or (not whole_tree and node.parent not in nodes):
                 node.parent._children = [n for n in node.parent._children if n != node]
diff --git a/udapi/core/tests/test_enhdeps.py b/udapi/core/tests/test_enhdeps.py
index 80fe0209..3f473bf3 100644
--- a/udapi/core/tests/test_enhdeps.py
+++ b/udapi/core/tests/test_enhdeps.py
@@ -58,5 +58,6 @@ def test_create_deps2empty(self):
         d.deps.append({'parent': e, 'deprel': 'dep:d2e'})
         self.assertEqual("2:dep:e2h", e.raw_deps, )
         self.assertEqual("5:conj|3.1:dep:d2e", d.raw_deps)
+        self.assertEqual(self.tree.descendants_and_empty, self.nodes[:3] + [e] + self.nodes[3:])
 
 
diff --git a/udapi/core/tests/test_node.py b/udapi/core/tests/test_node.py
index 7d811456..23ac0402 100755
--- a/udapi/core/tests/test_node.py
+++ b/udapi/core/tests/test_node.py
@@ -52,6 +52,10 @@ def test_topology(self):
 
         # ords and reorderings
         self.assertEqual([node.ord for node in nodes], [1, 2, 3, 4, 5, 6])
+        self.assertTrue(nodes[0].precedes(nodes[1]))
+        self.assertTrue(nodes[0] < nodes[1])
+        self.assertFalse(nodes[0] > nodes[1])
+        self.assertTrue(nodes[0] <= nodes[0])
         nodes[0].shift_after_node(nodes[1])
         self.assertEqual([node.ord for node in nodes], [2, 1, 3, 4, 5, 6])
         self.assertEqual([node.ord for node in root.descendants()], [1, 2, 3, 4, 5, 6])

From 87ac4206ae1413df17ff8efc0d5f5676876cf9c9 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 6 Feb 2021 02:43:22 +0100
Subject: [PATCH 0291/1374] each node now stores an explicit reference to the
 root (node._root)

Benchmark "NewTreex" shows 0.5% more memory, but total time 6% faster
(rehanging, i.e. changing a parent is 21% faster, next_node 65% faster):

experiment|TIME  |MAXMEM |load  |save |iterN|rehang|remove|add  |reorder|
----------|-----:|------:|-----:|----:|----:|-----:|-----:|----:|------:|
udapi     |40.507|832.815|17.066|4.521|0.715|3.502 |2.348 |2.868|4.174  |
udapi_new |37.958|837.302|16.720|3.846|0.251|2.766 |2.284 |2.699|4.106  |
---
 udapi/core/node.py            | 31 +++++++++++--------------------
 udapi/core/root.py            |  3 ++-
 udapi/core/tests/test_node.py |  2 +-
 3 files changed, 14 insertions(+), 22 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index f0a4f5c0..239b250c 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -66,7 +66,6 @@ class Node(object):
     # With Python 3.5 split dict, slots may not be better.
     # TODO: Should not we include __weakref__ in slots?
     # TODO: Benchmark using node._ord instead node.ord in this file
-    # TODO: Benchmark storing root in node._root (as it is done in EmptyNode)
     __slots__ = [
         '_ord',       # Word-order index of the node (root has 0).
         'form',       # Word form or punctuation symbol.
@@ -80,13 +79,15 @@ class Node(object):
         '_feats',     # Morphological features as udapi.core.feats.Feats object.
         '_parent',    # Parent node.
         '_children',  # Ord-ordered list of child nodes.
+        '_root',      # Technical root of the tree
         '_mwt',       # Multi-word token in which this word participates.
         '_mentions',  # List of udapi.core.coref.CorefMention objects whose span includes this node
     ]
 
-    def __init__(self, form=None, lemma=None, upos=None,  # pylint: disable=too-many-arguments
+    def __init__(self, root, form=None, lemma=None, upos=None,  # pylint: disable=too-many-arguments
                  xpos=None, feats=None, deprel=None, misc=None):
         """Create a new node and initialize its attributes using the keyword arguments."""
+        self._root = root
         self._ord = None
         self.form = form
         self.lemma = lemma
@@ -106,6 +107,10 @@ def __str__(self):
         """Pretty print of the Node object."""
         return "node<%s, %s>" % (self.address(), self.form)
 
+    @property
+    def root(self):
+        return self._root
+
     # ord is implemented as a property, so that it can be overriden in EmptyNode and Root
     @property
     def ord(self):
@@ -336,14 +341,6 @@ def children(self):
         """
         return ListOfNodes(self._children, origin=self)
 
-    @property
-    def root(self):
-        """Return the (technical) root node of the whole tree."""
-        node = self
-        while node.parent:
-            node = node.parent
-        return node
-
     @property
     def descendants(self):
         """Return a list of all descendants of the current node.
@@ -378,7 +375,7 @@ def is_descendant_of(self, node):
 
     def create_child(self, **kwargs):
         """Create and return a new child of the current node."""
-        new_node = Node(**kwargs)
+        new_node = Node(root=self._root, **kwargs)
         new_node.ord = len(self.root._descendants) + 1
         self.root._descendants.append(new_node)
         self.children.append(new_node)
@@ -761,15 +758,6 @@ def create_coref_cluster(self, **kwargs):
 
 class EmptyNode(Node):
     """Class for representing empty nodes (for ellipsis in enhanced UD)."""
-    __slots__ = ['_root']
-
-    def __init__(self, root, form=None, lemma=None, upos=None, xpos=None, feats=None, misc=None):
-        super().__init__(form=form, lemma=lemma, upos=upos, xpos=xpos, feats=feats, misc=misc)
-        self._root = root
-
-    @property
-    def root(self):
-        return self._root
 
     @property
     def parent(self):
@@ -795,6 +783,9 @@ def ord(self, new_ord):
             raise ValueError('Only str and float are allowed for EmptyNode ord setter,'
                              f' but {type(new_ord)} was given.')
 
+    def shift(self, reference_node, after=0, move_subtree=0, reference_subtree=0):
+        """Attempts at changing the word order of EmptyNode result in NotImplemented exception."""
+        raise NotImplemented('Empty nodes cannot be re-order using shift* methods yet.')
 
 @functools.total_ordering
 class OrdTuple:
diff --git a/udapi/core/root.py b/udapi/core/root.py
index 484fa319..06d018f4 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -18,7 +18,7 @@ class Root(Node):
     def __init__(self, zone=None, comment='', text=None, newpar=None, newdoc=None):
         """Create new root node."""
         # Call constructor of the parent object.
-        super().__init__()
+        super().__init__(root=self)
 
         self.ord = 0
         self.form = '<ROOT>'
@@ -266,6 +266,7 @@ def steal_nodes(self, nodes):
         for node in nodes:
             new_ord += 1
             node.ord = new_ord
+            node._root = self
             if not whole_tree:
                 for child in [n for n in node.children if n not in nodes]:
                     child._parent = old_root
diff --git a/udapi/core/tests/test_node.py b/udapi/core/tests/test_node.py
index 23ac0402..f38ca585 100755
--- a/udapi/core/tests/test_node.py
+++ b/udapi/core/tests/test_node.py
@@ -118,7 +118,7 @@ def test_draw(self):
 
     def test_feats(self):
         """Test the morphological featrues."""
-        node = Node()
+        node = Node(root=None)
         self.assertEqual(str(node.feats), '_')
         node.feats = ''
         self.assertEqual(str(node.feats), '_')

From 27b8be77c36b3581a22fd8a37f2fdcdd25e81619 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 6 Feb 2021 03:43:50 +0100
Subject: [PATCH 0292/1374] keep mention.word always sorted, better error msg
 when parsing span

---
 udapi/core/coref.py | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 460230b8..59c87d18 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -49,7 +49,7 @@ def words(self, new_words):
             raise ValueError(f"Head {self.head} not in new_words")
         for old_word in self._words:
             old_word._mentions.remove(self)
-        self._words = new_words # TODO sorted
+        self._words = sorted(new_words)
         for new_word in new_words:
             new_word._mentions.append(self)
 
@@ -190,10 +190,13 @@ def store_coref_to_misc(doc):
 def span_to_nodes(root, span):
     ranges = []
     for span_str in span.split(','):
-        if '-' not in span_str:
-            lo = hi = float(span_str)
-        else:
-            lo, hi = (float(x) for x in span_str.split('-'))
+        try:
+            if '-' not in span_str:
+                lo = hi = float(span_str)
+            else:
+                lo, hi = (float(x) for x in span_str.split('-'))
+        except ValueError as e:
+            raise ValueError(f"Cannot parse '{span}': {e}")
         ranges.append((lo, hi))
 
     def _num_in_ranges(num):

From a0f677551e78f19852c1682f2a6f3c5e7a4afaf4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 6 Feb 2021 14:28:52 +0100
Subject: [PATCH 0293/1374] bug fix in parsing spans

---
 udapi/core/coref.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 59c87d18..a3777698 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -201,11 +201,11 @@ def span_to_nodes(root, span):
 
     def _num_in_ranges(num):
         for (lo, hi) in ranges:
-            if num > hi:
+            if num < lo:
                 return False
-            if num >= lo:
+            if num <= hi:
                 return True
-            return False
+        return False
 
     return [w for w in root.descendants_and_empty if _num_in_ranges(w.ord)]
 

From 76ba743616125d84f48c63443eb5fdbe7d680861 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 6 Feb 2021 19:02:01 +0100
Subject: [PATCH 0294/1374] support for ClusterId[1]

reading+writing support for multiple clusters in one node
stored using layered attributes
---
 udapi/core/coref.py | 52 +++++++++++++++++++++++++++++++--------------
 1 file changed, 36 insertions(+), 16 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index a3777698..613261d1 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -1,4 +1,5 @@
 """Classes for handling coreference."""
+import re
 
 class CorefMention(object):
     """Class for representing a mention (instance of an entity)."""
@@ -148,43 +149,62 @@ def create_coref_cluster(head, cluster_id=None, cluster_type=None, **kwargs):
 def load_coref_from_misc(doc):
     clusters = {}
     for node in doc.nodes:
+        index, index_str = 0, ""
         cluster_id = node.misc["ClusterId"]
-        if cluster_id:
+        if not cluster_id:
+            index, index_str = 1, "[1]"
+            cluster_id = node.misc["ClusterId[1]"]
+        while cluster_id:
             cluster = clusters.get(cluster_id)
             if cluster is None:
                 cluster = CorefCluster(cluster_id)
                 clusters[cluster_id] = cluster
             mention = CorefMention(node, cluster)
-            if node.misc["MentionSpan"]:
-                mention.span = node.misc["MentionSpan"]
-            cluster_type = node.misc["ClusterType"]
+            if node.misc["MentionSpan" + index_str]:
+                mention.span = node.misc["MentionSpan" + index_str]
+            cluster_type = node.misc["ClusterType" + index_str]
             if cluster_type is not None:
                 if cluster.cluster_type is not None and cluster_type != cluster.cluster_type:
                     logging.warning(f"cluster_type mismatch in {node}: {cluster.cluster_type} != {cluster_type}")
                 cluster.cluster_type = cluster_type
             # TODO deserialize Bridging and SplitAnte
-            mention._bridging = node.misc["Bridging"]
-            cluster._split_ante = node.misc["SplitAnte"]
+            mention._bridging = node.misc["Bridging" + index_str]
+            cluster._split_ante = node.misc["SplitAnte" + index_str]
+            index += 1
+            index_str = f"[{index}]"
+            cluster_id = node.misc["ClusterId" + index_str]
     doc._coref_clusters = clusters
 
 
 def store_coref_to_misc(doc):
     if not doc._coref_clusters:
         return
+    attrs = ("ClusterId", "MentionSpan", "ClusterType", "Bridging", "SplitAnte")
     for node in doc.nodes:
-        del node.misc["ClusterId"]
-        del node.misc["MentionSpan"]
-        del node.misc["ClusterType"]
-        del node.misc["Bridging"]
-        del node.misc["SplitAnte"]
+        for key in list(node.misc):
+            if any(re.match(attr + r'(\[\d+\])?$', key) for attr in attrs):
+                del node.misc[key]
     for cluster in doc._coref_clusters.values():
         for mention in cluster.mentions:
             head = mention.head
-            head.misc["ClusterId"] = cluster.cluster_id
-            head.misc["MentionSpan"] = mention.span
-            head.misc["ClusterType"] = cluster.cluster_type
-            head.misc["Bridging"] = mention.bridging
-            head.misc["SplitAnte"] = cluster.split_ante
+            if head.misc["ClusterId"]:
+                for a in attrs:
+                    if head.misc[a]:
+                        head.misc[a + "[1]"] = head.misc[a]
+                        del head.misc[a]
+                index_str = "[2]"
+            else:
+                index, index_str = 1, "[1]"
+                while(head.misc["ClusterId" + index_str]):
+                    index += 1
+                    index_str = f"[{index}]"
+                if index == 1:
+                    index_str = ""
+            head.misc["ClusterId" + index_str] = cluster.cluster_id
+            head.misc["MentionSpan" + index_str] = mention.span
+            head.misc["ClusterType" + index_str] = cluster.cluster_type
+            head.misc["Bridging" + index_str] = mention.bridging
+            head.misc["SplitAnte" + index_str] = cluster.split_ante
 
 
 def span_to_nodes(root, span):

From ac3f69e0e656ac984e3a3ea9a2e7a2a4c3fe01ac Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 7 Feb 2021 21:17:21 +0100
Subject: [PATCH 0295/1374] bug fixes: node.ord is never a string now, it can
 be int, float or OrdTuple

root.create_empty_child() should not sort the empty nodes
because they may not have ord filled.
In contrast, node.create_empty_child() should sort the empty nodes.
---
 udapi/core/node.py | 3 ++-
 udapi/core/root.py | 1 -
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 239b250c..6c2ef03f 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -257,7 +257,7 @@ def deps(self):
                 # Empty nodes have to be located differently than normal nodes.
                 if '.' in head:
                     try:
-                        parent = next(x for x in self.root.empty_nodes if x.ord == head)
+                        parent = next(x for x in self.root.empty_nodes if str(x.ord) == head)
                     except StopIteration:
                         raise ValueError(f'Empty node with ord={head} not found')
                 else:
@@ -412,6 +412,7 @@ def create_empty_child(self, deprel, after=True, **kwargs):
                     new_ord = round(new_ord+0.1, 1)
         new_node.ord = new_ord
         self.root.empty_nodes.append(new_node)
+        self.root.empty_nodes.sort()
         return new_node
 
     # TODO: make private: _unordered_descendants
diff --git a/udapi/core/root.py b/udapi/core/root.py
index 06d018f4..2d76e9ea 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -153,7 +153,6 @@ def create_empty_child(self, **kwargs):
         """
         new_node = EmptyNode(root=self, **kwargs)
         self.empty_nodes.append(new_node)
-        self.empty_nodes.sort()
         return new_node
 
     # TODO document whether misc is a string or dict or it can be both

From 542707fb94047fe39977ea84307184bbd7cc312a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 7 Feb 2021 21:21:03 +0100
Subject: [PATCH 0296/1374] draft of ordering of CorefMention objects

---
 udapi/core/coref.py | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 613261d1..51cb7240 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -1,6 +1,8 @@
 """Classes for handling coreference."""
 import re
+import functools
 
+@functools.total_ordering
 class CorefMention(object):
     """Class for representing a mention (instance of an entity)."""
     __slots__ = ['_head', '_cluster', '_bridging', '_words']
@@ -13,6 +15,25 @@ def __init__(self, head, cluster=None):
         self._bridging = None
         self._words = []
 
+    def __lt__(self, other):
+        """Does this mention precedes (word-order wise) the `other` mention?
+
+        This method defines a total ordering of all mentions
+        (within one cluster or across different clusters).
+        The position is primarily defined by the first word in each mention
+        (or by the head if mention.words are missing).
+        If two mentions start at the same word,
+        their order is defined by the last word in their span
+        -- the shorter mention precedes the longer one.
+        """
+        node1 = self._words[0] if self._words else self._head
+        node2 = other._words[0] if other._words else other._head
+        if node1 is node2:
+            node1 = self._words[-1] if self._words else self._head
+            node2 = other._words[-1] if other._words else other._head
+            return node1 > node2
+        return node1 < node2
+
     @property
     def head(self):
         return self._head

From b27a153d5298e5dab89f807dcf4360e37febab16 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 8 Feb 2021 14:11:01 +0100
Subject: [PATCH 0297/1374] write.TextModeTrees prints empty nodes by default

---
 udapi/block/write/textmodetrees.py | 21 +++++++++++++++------
 udapi/core/node.py                 | 13 +++++++++++++
 2 files changed, 28 insertions(+), 6 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index fd29e72e..f3dad456 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -132,7 +132,7 @@ class TextModeTrees(BaseWriter):
 
     def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
                  minimize_cross=True, color='auto', attributes='form,upos,deprel',
-                 print_undef_as='_', print_doc_meta=True, print_comments=False,
+                 print_undef_as='_', print_doc_meta=True, print_comments=False, print_empty=True,
                  mark='ToDo|ToDoOrigText|Bug|Mark', marked_only=False, hints=True,
                  layout='classic', **kwargs):
         """Create new TextModeTrees block object.
@@ -156,6 +156,7 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         print_undef_as: What should be printed instead of undefined attribute values (if any)?
         print_doc_meta: Print `document.meta` metadata before each document?
         print_comments: Print comments (other than sent_id and text)?
+        print_empty: Print empty nodes?
         mark: a regex. If `re.search(mark + '=', str(node.misc))` the node is highlighted.
             If `print_comments and re.search(r'^ (%s) = ' % mark, root.comment, re.M)`
             the comment is highlighted.
@@ -178,6 +179,7 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         self.print_undef_as = print_undef_as
         self.print_doc_meta = print_doc_meta
         self.print_comments = print_comments
+        self.print_empty = print_empty
         self.mark = mark
         self.marked_only = marked_only
         self.layout = layout
@@ -222,11 +224,11 @@ def _compute_gaps(self, node):
         self._gaps[node.ord] = rmost - lmost - descs
         return lmost, rmost, descs + 1
 
-    def should_print_tree(self, root):
+    def should_print_tree(self, root, allnodes):
         """Should this tree be printed?"""
         if not self.marked_only:
             return True
-        if any(self.is_marked(n) for n in root.descendants(add_self=1)):
+        if any(self.is_marked(n) for n in allnodes):
             return True
         if not self.print_comments or root.comment is None or self.mark_re is None:
             return False
@@ -234,8 +236,11 @@ def should_print_tree(self, root):
 
     def process_tree(self, root):
         """Print the tree to (possibly redirected) sys.stdout."""
-        allnodes = root.descendants(add_self=1)
-        if not self.should_print_tree(root):
+        if self.print_empty:
+            allnodes = [root] + root.descendants_and_empty
+        else:
+            allnodes = root.descendants(add_self=1)
+        if not self.should_print_tree(root, allnodes):
             return
         self._index_of = {allnodes[i].ord: i for i in range(len(allnodes))}
         self.lines = [''] * len(allnodes)
@@ -281,7 +286,11 @@ def process_tree(self, root):
             if self.minimize_cross:
                 stack = sorted(stack, key=lambda x: -self._gaps[x.ord])
 
-        if self.layout != 'classic':
+        if self.layout == 'classic':
+            for idx, node in enumerate(allnodes):
+                if node.is_empty():
+                    self.add_node(idx, node)
+        else:
             columns_attrs = [[a] for a in self.attrs] if self.layout == 'align' else [self.attrs]
             for col_attrs in columns_attrs:
                 self.attrs = col_attrs
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 6c2ef03f..6dd6301f 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -433,6 +433,15 @@ def is_root():
         """
         return False
 
+    @staticmethod
+    def is_empty():
+        """Is the current node an empty node?
+
+        Returns False for all Node instances.
+        True is returned only by instances of the EmptyNode subclass.
+        """
+        return False
+
     def remove(self, children=None):
         """Delete this node and all its descendants.
 
@@ -760,6 +769,10 @@ def create_coref_cluster(self, **kwargs):
 class EmptyNode(Node):
     """Class for representing empty nodes (for ellipsis in enhanced UD)."""
 
+    def is_empty(self):
+        """Return True for all EmptyNode instances."""
+        return True
+
     @property
     def parent(self):
         return None

From 5f1497028e15a667d8d120269d66b5bc6d0ff6cb Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 8 Feb 2021 17:07:17 +0100
Subject: [PATCH 0298/1374] 18% faster loading

* l.append(x) is faster than l += [x]
* l.sort(); l2=l; is faster than l2 = sorted(l)
---
 udapi/core/coref.py | 18 +++++++++++++++---
 udapi/core/node.py  |  9 +++++++--
 2 files changed, 22 insertions(+), 5 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 51cb7240..b593b898 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -69,11 +69,23 @@ def words(self):
     def words(self, new_words):
         if new_words and self.head not in new_words:
             raise ValueError(f"Head {self.head} not in new_words")
+        kept_words = []
         for old_word in self._words:
-            old_word._mentions.remove(self)
-        self._words = sorted(new_words)
+            if old_word in new_words:
+                kept_words.append(old_word)
+            else:
+                old_word._mentions.remove(self)
+        #for old_word in self._words:
+        #    old_word._mentions.remove(self)
+        new_words.sort()
+        self._words = new_words
         for new_word in new_words:
-            new_word._mentions.append(self)
+            if new_word not in kept_words:
+                #new_word._mentions.append(self)
+                if new_word._mentions and self > new_word._mentions[-1]:
+                    new_word._mentions.append(self)
+                else:
+                    new_word._mentions = sorted(new_word._mentions + [self])
 
     @property
     def span(self):
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 6dd6301f..34d06609 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -316,7 +316,11 @@ def parent(self, new_parent):
         self._parent = new_parent
 
         # Append the current node to the new parent children.
-        new_parent._children = sorted(new_parent.children + [self])
+        if new_parent._children and self > new_parent._children[-1]:
+            new_parent._children.append(self)
+        else:
+            new_parent._children.append(self)
+            new_parent._children.sort()
 
     @property
     def children(self):
@@ -893,7 +897,8 @@ def __call__(self, add_self=False, following_only=False, preceding_only=False):
             result = [x for x in result if x.ord <= self.origin.ord]
         if following_only:
             result = [x for x in result if x.ord >= self.origin.ord]
-        return sorted(result)
+        result.sort()
+        return result
 
 
 def find_minimal_common_treelet(*args):

From 44c291b930fa591477c87457a17c0e76e6ee22ea Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 9 Feb 2021 09:53:07 +0100
Subject: [PATCH 0299/1374] huge speedup: "NewTreex" benchmark 40s -> 25s

The main trick is to prevent creating new lists (and memory allocations) wherever possible.
E.g. `node.children` creates a new `ListOfNodes` object with a copy of the list of children
and `node.children(add_self=True)` creates one more copy (and the previous copy is thrown away for gc).
Thus internally, we can call node._children (which currently does not guarantee sorted result),
which creates no extra list.
`node.children(add_self=True)` was changed so it creates just a single new list.
Further speedup is possible in future.

Very minor speedup is due to direct usage of attributes instead of overloaded properties, e.g. node._ord instead of node.ord.
This is not worth the effort in user blocks, but internally in the core API it makes a (small) difference in total.
---
 udapi/core/block.py    |   2 +-
 udapi/core/document.py |   2 +-
 udapi/core/node.py     | 193 +++++++++++++++++++++--------------------
 udapi/core/root.py     |   2 +-
 4 files changed, 103 insertions(+), 96 deletions(-)

diff --git a/udapi/core/block.py b/udapi/core/block.py
index 3292866f..64b8bcc5 100644
--- a/udapi/core/block.py
+++ b/udapi/core/block.py
@@ -29,7 +29,7 @@ def process_node(self, _):
 
     def process_tree(self, tree):
         """Process a UD tree"""
-        for node in tree.descendants:
+        for node in tree._descendants:
             self.process_node(node)
 
     def process_bundle(self, bundle):
diff --git a/udapi/core/document.py b/udapi/core/document.py
index 36edb856..6bf2e55d 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -93,7 +93,7 @@ def nodes(self):
         """An iterator over all nodes in the document."""
         for bundle in self:
             for tree in bundle:
-                for node in tree.descendants:
+                for node in tree._descendants:
                     yield node
 
     def draw(self, **kwargs):
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 34d06609..1bf118c7 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -121,7 +121,7 @@ def ord(self, new_ord):
         self._ord = new_ord
 
     def __lt__(self, other):
-        return self.ord < other.ord
+        return self._ord < other._ord
 
     @property
     def udeprel(self):
@@ -220,7 +220,7 @@ def raw_deps(self):
             serialized_deps = []
             for secondary_dependence in self._deps:
                 serialized_deps.append('{}:{}'.format(secondary_dependence[
-                    'parent'].ord, secondary_dependence['deprel']))
+                    'parent']._ord, secondary_dependence['deprel']))
             self._raw_deps = '|'.join(serialized_deps)
         return self._raw_deps
 
@@ -243,7 +243,7 @@ def deps(self):
         """
         if self._deps is None:
             # Obtain a list of all nodes in the dependency tree.
-            nodes = [self.root] + self.root.descendants()
+            nodes = [self._root] + self._root._descendants
 
             # Create a list of secondary dependencies.
             self._deps = list()
@@ -257,7 +257,7 @@ def deps(self):
                 # Empty nodes have to be located differently than normal nodes.
                 if '.' in head:
                     try:
-                        parent = next(x for x in self.root.empty_nodes if str(x.ord) == head)
+                        parent = next(x for x in self._root.empty_nodes if str(x._ord) == head)
                     except StopIteration:
                         raise ValueError(f'Empty node with ord={head} not found')
                 else:
@@ -286,7 +286,7 @@ def parent(self, new_parent):
         (from the list of original parent's children).
         """
         # If the parent is already assigned, return.
-        if self.parent is new_parent:
+        if self._parent is new_parent:
             return
 
         # The node itself couldn't be assigned as a parent. None cannot be used as parent.
@@ -301,14 +301,13 @@ def parent(self, new_parent):
             if climbing_node is self:
                 raise ValueError('Setting the parent of %s to %s would lead to a cycle.'
                                  % (self, new_parent))
-            climbing_node = climbing_node.parent
+            climbing_node = climbing_node._parent
 
         # Remove the current Node from the children of the old parent.
         # Forbid moving nodes from one tree to another using parent setter.
         if self._parent:
-            self._parent._children = [node for node in self.parent.children if node is not self]
-            # TODO: .root is currently computed, so it is quite slow
-            old_root, new_root = self._parent.root, climbing_node
+            self._parent._children = [node for node in self._parent._children if node is not self]
+            old_root, new_root = self._parent._root, climbing_node
             if old_root is not new_root:
                 raise ValueError('Cannot move nodes between trees with parent setter, '
                                  'use new_root.steal_nodes(nodes_to_be_moved) instead')
@@ -316,11 +315,12 @@ def parent(self, new_parent):
         self._parent = new_parent
 
         # Append the current node to the new parent children.
-        if new_parent._children and self > new_parent._children[-1]:
-            new_parent._children.append(self)
-        else:
-            new_parent._children.append(self)
-            new_parent._children.sort()
+        new_parent._children.append(self)
+#         if not new_parent._children or self > new_parent._children[-1]:
+#             new_parent._children.append(self)
+#         else:
+#             new_parent._children.append(self)
+#             new_parent._children.sort()
 
     @property
     def children(self):
@@ -366,24 +366,24 @@ def descendants(self):
          nodes4 = [n for n in node.descendants if n.ord < node.ord] + [node]
         See documentation of ListOfNodes for details.
         """
-        return ListOfNodes(sorted(self.unordered_descendants()), origin=self)
+        return ListOfNodes(self.unordered_descendants(), origin=self)
 
     def is_descendant_of(self, node):
         """Is the current node a descendant of the node given as argument?"""
-        climber = self.parent
+        climber = self._parent
         while climber:
             if climber is node:
                 return True
-            climber = climber.parent
+            climber = climber._parent
         return False
 
     def create_child(self, **kwargs):
         """Create and return a new child of the current node."""
         new_node = Node(root=self._root, **kwargs)
-        new_node.ord = len(self.root._descendants) + 1
-        self.root._descendants.append(new_node)
-        self.children.append(new_node)
-        new_node.parent = self
+        new_node._ord = len(self._root._descendants) + 1
+        self._root._descendants.append(new_node)
+        self._children.append(new_node)
+        new_node._parent = self
         return new_node
 
     def create_empty_child(self, deprel, after=True, **kwargs):
@@ -398,32 +398,35 @@ def create_empty_child(self, deprel, after=True, **kwargs):
                 in which case it will be `node.ord + 0.2` etc.
                 If False, the new node will be placed immediately before `node`.
         """
-        new_node = EmptyNode(root=self.root, **kwargs)
+        new_node = EmptyNode(root=self._root, **kwargs)
         new_node.deps = [{'parent': self, 'deprel': deprel}]
         # self.enh_children.append(new_node) TODO
         # new_node.enh_parents.append(self) TODO
-        base_ord = self.ord if after else self.ord - 1
+        base_ord = self._ord if after else self._ord - 1
         new_ord = base_ord + 0.1
-        for empty in self.root.empty_nodes:
-            if empty.ord > new_ord:
+        for empty in self._root.empty_nodes:
+            if empty._ord > new_ord:
                 break
-            if empty.ord == new_ord:
+            if empty._ord == new_ord:
                 if isinstance(new_ord, OrdTuple):
                     new_ord.increase()
                 elif new_ord == base_ord + 0.9:
                     new_ord = OrdTuple(base_ord, 10)
                 else:
                     new_ord = round(new_ord+0.1, 1)
-        new_node.ord = new_ord
-        self.root.empty_nodes.append(new_node)
-        self.root.empty_nodes.sort()
+        new_node._ord = new_ord
+        if not self._root.empty_nodes or new_node > self._root.empty_nodes[-1]:
+            self._root.empty_nodes.append(new_node)
+        else:
+            self._root.empty_nodes.append(new_node)
+            self._root.empty_nodes.sort()
         return new_node
 
     # TODO: make private: _unordered_descendants
     def unordered_descendants(self):
         """Return a list of all descendants in any order."""
         descendants = []
-        for child in self.children:
+        for child in self._children:
             descendants.append(child)
             descendants.extend(child.unordered_descendants())
         return descendants
@@ -456,40 +459,45 @@ def remove(self, children=None):
             `warn` means to issue a warning if any children are present and delete them.
             `rehang_warn` means to rehang and warn:-).
         """
-        self.parent._children = [child for child in self.parent.children if child is not self]
-        if children is not None and self.children:
+        self._parent._children = [child for child in self._parent._children if child is not self]
+        if children is not None and self._children:
             if children.startswith('rehang'):
-                for child in self.children:
-                    child.parent = self.parent
+                for child in self._children:
+                    child.parent = self._parent # TODO child._parent = self._parent
             if children.endswith('warn'):
                 logging.warning('%s is being removed by remove(children=%s), '
                                 ' but it has (unexpected) children', self, children)
-        self.root._update_ordering()
+        self._root._update_ordering()
 
     # TODO: make private: _shift
     def shift(self, reference_node, after=0, move_subtree=0, reference_subtree=0):
         """Internal method for changing word order."""
-        nodes_to_move = [self]
-
         if move_subtree:
-            nodes_to_move.extend(self.descendants())
-
-        reference_ord = reference_node.ord
+            nodes_to_move = self.unordered_descendants()
+            nodes_to_move.append(self)
+        else:
+            nodes_to_move = [self]
 
+        reference_ord = reference_node._ord
         if reference_subtree:
-            for node in [n for n in reference_node.descendants() if n is not self]:
-                if (after and node.ord > reference_ord) or (not after and node.ord < reference_ord):
-                    reference_ord = node.ord
+            if after:
+                for node in reference_node.unordered_descendants():
+                    if node._ord > reference_ord and node is not self:
+                        reference_ord = node._ord
+            else:
+                for node in reference_node.unordered_descendants():
+                    if node._ord < reference_ord and node is not self:
+                        reference_ord = node._ord
 
         common_delta = 0.5 if after else -0.5
 
         # TODO: can we use some sort of epsilon instead of choosing a silly
         # upper bound for out-degree?
         for node_to_move in nodes_to_move:
-            node_to_move.ord = reference_ord + common_delta + \
-                (node_to_move.ord - self.ord) / 100000.
+            node_to_move._ord = reference_ord + common_delta + \
+                (node_to_move._ord - self._ord) / 100000.
 
-        self.root._update_ordering()
+        self._root._update_ordering()
 
     # TODO add without_children kwarg
     def shift_after_node(self, reference_node):
@@ -519,48 +527,48 @@ def shift_before_subtree(self, reference_node, without_children=0):
     @property
     def prev_node(self):
         """Return the previous node according to word order."""
-        new_ord = self.ord - 1
+        new_ord = self._ord - 1
         if new_ord < 0:
             return None
         if new_ord == 0:
-            return self.root
-        return self.root._descendants[new_ord - 1]
+            return self._root
+        return self._root._descendants[new_ord - 1]
 
     @property
     def next_node(self):
         """Return the following node according to word order."""
         # Note that all_nodes[n].ord == n+1
         try:
-            return self.root._descendants[self.ord]
+            return self._root._descendants[self._ord]
         except IndexError:
             return None
 
     def precedes(self, node):
         """Does this node precedes another `node` in word order (`self.ord < node.ord`)?"""
-        return self.ord < node.ord
+        return self._ord < node._ord
 
     def is_leaf(self):
         """Is this node a leaf, ie. a node without any children?"""
-        return not self.children
+        return not self._children
 
     def _get_attr(self, name):  # pylint: disable=too-many-return-statements
         if name == 'dir':
-            if self.parent.is_root():
+            if self._parent.is_root():
                 return 'root'
-            return 'left' if self.precedes(self.parent) else 'right'
+            return 'left' if self.precedes(self._parent) else 'right'
         if name == 'edge':
-            if self.parent.is_root():
+            if self._parent.is_root():
                 return 0
-            return self.ord - self.parent.ord
+            return self._ord - self._parent._ord
         if name == 'children':
-            return len(self.children)
+            return len(self._children)
         if name == 'siblings':
-            return len(self.parent.children) - 1
+            return len(self._parent._children) - 1
         if name == 'depth':
             value = 0
             tmp = self
             while not tmp.is_root():
-                tmp = tmp.parent
+                tmp = tmp._parent
                 value += 1
             return value
         if name == 'feats_split':
@@ -599,7 +607,7 @@ def get_attrs(self, attrs, undefs=None, stringify=True):
         for name in attrs:
             nodes = [self]
             if name.startswith('p_'):
-                nodes, name = [self.parent], name[2:]
+                nodes, name = [self._parent], name[2:]
             elif name.startswith('c_'):
                 nodes, name = self.children, name[2:]
             elif name.startswith('l_'):
@@ -641,8 +649,8 @@ def compute_text(self, use_mwt=True):
         for node in self.descendants(add_self=not self.is_root()):
             mwt = node.multiword_token
             if use_mwt and mwt:
-                if node.ord > last_mwt_id:
-                    last_mwt_id = mwt.words[-1].ord
+                if node._ord > last_mwt_id:
+                    last_mwt_id = mwt.words[-1]._ord
                     string += mwt.form
                     if mwt.misc['SpaceAfter'] != 'No':
                         string += ' '
@@ -679,7 +687,7 @@ def address(self):
         e.g. s123/en_udpipe#4. If zone is empty, the slash is excluded as well,
         e.g. s123#4.
         """
-        return '%s#%d' % (self.root.address() if self.root else '?', self.ord)
+        return '%s#%d' % (self._root.address() if self._root else '?', self._ord)
 
     @property
     def multiword_token(self):
@@ -701,13 +709,13 @@ def is_nonprojective(self):
         and the total number of nodes in the span.
         """
         # Root and its children are always projective
-        parent = self.parent
+        parent = self._parent
         if not parent or parent.is_root():
             return False
 
         # Edges between neighboring nodes are always projective.
         # Check it now to make it a bit faster.
-        ord1, ord2 = self.ord, parent.ord
+        ord1, ord2 = self._ord, parent._ord
         if ord1 > ord2:
             ord1, ord2 = ord2, ord1
         distance = ord2 - ord1
@@ -715,7 +723,7 @@ def is_nonprojective(self):
             return False
 
         # Get all the descendants of parent that are in the span of the edge.
-        span = [n for n in parent.descendants if n.ord > ord1 and n.ord < ord2]
+        span = [n for n in parent.unordered_descendants() if n._ord > ord1 and n._ord < ord2]
 
         # For projective edges, span must include all the nodes between parent and self.
         return len(span) != distance - 1
@@ -730,15 +738,15 @@ def is_nonprojective_gap(self):
         """
         ancestors = set([self])
         node = self
-        while node.parent:
-            node = node.parent
+        while node._parent:
+            node = node._parent
             ancestors.add(node)
-        all_nodes = node.descendants
-        for left_node in all_nodes[:self.ord - 1]:
-            if self.precedes(left_node.parent) and left_node.parent not in ancestors:
+        all_nodes = node._descendants
+        for left_node in all_nodes[:self._ord - 1]:
+            if self.precedes(left_node._parent) and left_node._parent not in ancestors:
                 return True
-        for right_node in all_nodes[self.ord:]:
-            if right_node.parent.precedes(self) and right_node.parent not in ancestors:
+        for right_node in all_nodes[self._ord:]:
+            if right_node._parent.precedes(self) and right_node._parent not in ancestors:
                 return True
         return False
 
@@ -758,12 +766,12 @@ def gloss(self, new_gloss):
 
     @property
     def coref_mentions(self):
-        self.root.bundle.document._load_coref()
+        self._root.bundle.document._load_coref()
         return self._mentions
 
     @property
     def coref_clusters(self):
-        self.root.bundle.document._load_coref()
+        self._root.bundle.document._load_coref()
         return [m.cluster for m in self._mentions if m.cluster is not None]
 
     def create_coref_cluster(self, **kwargs):
@@ -876,7 +884,7 @@ class ListOfNodes(list):
     nodes = node.children(add_self=True, following_only=True)
     """
 
-    def __init__(self, iterable, origin):
+    def __init__(self, iterable, origin, skip_sort=False):
         """Create a new ListOfNodes.
 
         Args:
@@ -884,21 +892,20 @@ def __init__(self, iterable, origin):
         origin: a node which is the parent/ancestor of these nodes
         """
         super().__init__(iterable)
+        if not skip_sort:
+            self.sort()
         self.origin = origin
 
     def __call__(self, add_self=False, following_only=False, preceding_only=False):
         """Returns a subset of nodes contained in this list as specified by the args."""
-        if not add_self and not following_only and not preceding_only:
-            return self
-        result = list(self)
         if add_self:
-            result.append(self.origin)
+            self.append(self.origin)
+            self.sort()
         if preceding_only:
-            result = [x for x in result if x.ord <= self.origin.ord]
+            return [x for x in self if x._ord <= self.origin._ord]
         if following_only:
-            result = [x for x in result if x.ord >= self.origin.ord]
-        result.sort()
-        return result
+            return [x for x in self if x._ord >= self.origin._ord]
+        return self
 
 
 def find_minimal_common_treelet(*args):
@@ -917,7 +924,7 @@ def find_minimal_common_treelet(*args):
     """
     nodes = list(args)
     # The input nodes are surely in the treelet, let's mark this with "1".
-    in_treelet = {node.ord: 1 for node in nodes}
+    in_treelet = {node._ord: 1 for node in nodes}
 
     # Step 1: Find a node (`highest`) which is governing all the input `nodes`.
     #         It may not be the lowest such node, however.
@@ -936,14 +943,14 @@ def find_minimal_common_treelet(*args):
     highest = None
     while len(nodes) > 1:
         node = nodes.pop(0)  # TODO deque
-        parent = node.parent
+        parent = node._parent
         if parent is None:
             highest = node
-        elif in_treelet.get(parent.ord, False):
-            in_treelet[parent.ord] = 1
+        elif in_treelet.get(parent._ord, False):
+            in_treelet[parent._ord] = 1
         else:
-            new_nodes[parent.ord] = parent
-            in_treelet[parent.ord] = node
+            new_nodes[parent._ord] = parent
+            in_treelet[parent._ord] = node
             nodes.append(parent)
 
     # In most cases, `nodes` now contain just one node -- the one we were looking for.
@@ -954,11 +961,11 @@ def find_minimal_common_treelet(*args):
     # If the `highest` node is unsure, climb down using poiners stored in `in_treelet`.
     # All such nodes which were rejected as true members of the minimal common treelet
     # must be deleted from the set of newly added nodes `new_nodes`.
-    child = in_treelet[highest.ord]
+    child = in_treelet[highest._ord]
     while child != 1:
-        del new_nodes[highest.ord]
+        del new_nodes[highest._ord]
         highest = child
-        child = in_treelet[highest.ord]
+        child = in_treelet[highest._ord]
 
     # We return the root of the minimal common treelet plus all the newly added nodes.
     return (highest, new_nodes.values())
diff --git a/udapi/core/root.py b/udapi/core/root.py
index 2d76e9ea..7482d1e2 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -112,7 +112,7 @@ def descendants(self):
         The nodes are sorted by their ord.
         This root-specific implementation returns all the nodes in the tree except the root itself.
         """
-        return ListOfNodes(self._descendants, origin=self)
+        return ListOfNodes(self._descendants, origin=self, skip_sort=True)
 
     def is_descendant_of(self, node):
         """Is the current node a descendant of the node given as argument?

From 4bb190883a6c19218fd8e54217a4bf70c694d7b6 Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Tue, 9 Feb 2021 00:00:37 +0100
Subject: [PATCH 0300/1374] bugfix: if resegment==False, the text attribute
 should contain the whole text, not just the first sentence after segmentation

---
 udapi/tool/udpipe.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/tool/udpipe.py b/udapi/tool/udpipe.py
index c08785da..18f6b2ca 100644
--- a/udapi/tool/udpipe.py
+++ b/udapi/tool/udpipe.py
@@ -1,5 +1,6 @@
 """Wrapper for UDPipe (more pythonic than ufal.udpipe)."""
 import io
+import sys
 
 from ufal.udpipe import Model, Pipeline, ProcessingError, Sentence  # pylint: disable=no-name-in-module
 from udapi.core.resource import require_file
@@ -92,7 +93,7 @@ def tokenize_tag_parse_tree(self, root, resegment=False, tag=True, parse=True):
         for u_sentence in u_sentences:
             if not new_root:
                 new_root = Root()
-            new_root.text = u_sentence.getText()
+            new_root.text = u_sentence.getText() if resegment else root.text
             heads, nodes = [], [new_root]
             u_words = u_sentence.words
             for i in range(1, u_words.size()):

From bac4e88f08b3b4979a28a5827a5da28eb8ab1aa7 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 9 Feb 2021 11:37:45 +0100
Subject: [PATCH 0301/1374] minor speedup

---
 udapi/core/coref.py | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index b593b898..e5f3d3d5 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -75,17 +75,15 @@ def words(self, new_words):
                 kept_words.append(old_word)
             else:
                 old_word._mentions.remove(self)
-        #for old_word in self._words:
-        #    old_word._mentions.remove(self)
         new_words.sort()
         self._words = new_words
         for new_word in new_words:
             if new_word not in kept_words:
-                #new_word._mentions.append(self)
-                if new_word._mentions and self > new_word._mentions[-1]:
+                if not new_word._mentions or self > new_word._mentions[-1]:
                     new_word._mentions.append(self)
                 else:
-                    new_word._mentions = sorted(new_word._mentions + [self])
+                    new_word._mentions.append(self)
+                    new_word._mentions.sort()
 
     @property
     def span(self):

From 2089000fb8f9d83271544b42eeae36572d0497a1 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 9 Feb 2021 23:41:11 +0100
Subject: [PATCH 0302/1374] keep node._children always sorted

This makes the NewTreex benchmark slightly slower,
but this is due to the fact it almost never reads node.children,
while it often changes the list of children (load, add, remove, rehang, reorder).
We can make the loading faster in future.
---
 udapi/core/node.py | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 1bf118c7..08eca6bc 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -315,12 +315,11 @@ def parent(self, new_parent):
         self._parent = new_parent
 
         # Append the current node to the new parent children.
-        new_parent._children.append(self)
-#         if not new_parent._children or self > new_parent._children[-1]:
-#             new_parent._children.append(self)
-#         else:
-#             new_parent._children.append(self)
-#             new_parent._children.sort()
+        if not new_parent._children or self > new_parent._children[-1]:
+            new_parent._children.append(self)
+        else:
+            new_parent._children.append(self)
+            new_parent._children.sort()
 
     @property
     def children(self):
@@ -343,7 +342,7 @@ def children(self):
          nodes4 = [n for n in node.children if n.ord < node.ord] + [node]
         See documentation of ListOfNodes for details.
         """
-        return ListOfNodes(self._children, origin=self)
+        return ListOfNodes(self._children, origin=self, skip_sort=True)
 
     @property
     def descendants(self):
@@ -862,6 +861,12 @@ def increase(self):
         self._key = (self.key[0], self._key[1]+1)
 
 
+# Implementation note on ListOfNodes
+# We could inherit from collections.abc.Sequence, store the list in self._data
+# and implement __getitem__ and __len__ by delegating it to self._data.
+# I thought it could be faster because we prevent copying of the list in super().__init__(iterable).
+# In practice, it is slower because of the delegation: native list's __getitem__ is C-optimized.
+# So let's just inherit from list.
 class ListOfNodes(list):
     """Helper class for results of node.children and node.descendants.
 
@@ -883,6 +888,7 @@ class ListOfNodes(list):
     nodes = node.children()
     nodes = node.children(add_self=True, following_only=True)
     """
+    __slots__ = ('origin',)
 
     def __init__(self, iterable, origin, skip_sort=False):
         """Create a new ListOfNodes.
@@ -890,6 +896,7 @@ def __init__(self, iterable, origin, skip_sort=False):
         Args:
         iterable: a list of nodes
         origin: a node which is the parent/ancestor of these nodes
+        skip_sort: is the data already sorted?
         """
         super().__init__(iterable)
         if not skip_sort:

From 0cb07cdb22551783a5c92934a2913ea43acb2fe2 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 10 Feb 2021 01:28:35 +0100
Subject: [PATCH 0303/1374] minor speedup by preventing recursion in
 unordered_descendants()

Implementing it as a generator was actually a bit slower,
both using `yield from child.unordered_descendants()`
and usign a stack and yielding always a single node.
---
 udapi/core/node.py | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 08eca6bc..b4c60559 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -424,10 +424,13 @@ def create_empty_child(self, deprel, after=True, **kwargs):
     # TODO: make private: _unordered_descendants
     def unordered_descendants(self):
         """Return a list of all descendants in any order."""
-        descendants = []
-        for child in self._children:
-            descendants.append(child)
-            descendants.extend(child.unordered_descendants())
+        stack = list(self._children)
+        descendants = list(stack)
+        while(stack):
+            n = stack.pop()
+            if n._children:
+                stack.extend(n._children)
+                descendants.extend(n._children)
         return descendants
 
     @staticmethod

From cb5c8808e09907de61079961eeb1bce2b37a41b8 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 10 Feb 2021 03:07:00 +0100
Subject: [PATCH 0304/1374] minor speedup: node.descendants builds ListOfNodes
 to prevent one list copying

Thus no skip_sort is needed in ListOfNodes' __init__.
---
 udapi/core/node.py | 17 +++++++++++------
 udapi/core/root.py |  2 +-
 2 files changed, 12 insertions(+), 7 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index b4c60559..caa95129 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -342,7 +342,7 @@ def children(self):
          nodes4 = [n for n in node.children if n.ord < node.ord] + [node]
         See documentation of ListOfNodes for details.
         """
-        return ListOfNodes(self._children, origin=self, skip_sort=True)
+        return ListOfNodes(self._children, origin=self)
 
     @property
     def descendants(self):
@@ -365,7 +365,15 @@ def descendants(self):
          nodes4 = [n for n in node.descendants if n.ord < node.ord] + [node]
         See documentation of ListOfNodes for details.
         """
-        return ListOfNodes(self.unordered_descendants(), origin=self)
+        stack = list(self._children)
+        descendants = ListOfNodes(stack, origin=self)
+        while(stack):
+            n = stack.pop()
+            if n._children:
+                stack.extend(n._children)
+                descendants.extend(n._children)
+        descendants.sort()
+        return descendants
 
     def is_descendant_of(self, node):
         """Is the current node a descendant of the node given as argument?"""
@@ -893,17 +901,14 @@ class ListOfNodes(list):
     """
     __slots__ = ('origin',)
 
-    def __init__(self, iterable, origin, skip_sort=False):
+    def __init__(self, iterable, origin):
         """Create a new ListOfNodes.
 
         Args:
         iterable: a list of nodes
         origin: a node which is the parent/ancestor of these nodes
-        skip_sort: is the data already sorted?
         """
         super().__init__(iterable)
-        if not skip_sort:
-            self.sort()
         self.origin = origin
 
     def __call__(self, add_self=False, following_only=False, preceding_only=False):
diff --git a/udapi/core/root.py b/udapi/core/root.py
index 7482d1e2..2d76e9ea 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -112,7 +112,7 @@ def descendants(self):
         The nodes are sorted by their ord.
         This root-specific implementation returns all the nodes in the tree except the root itself.
         """
-        return ListOfNodes(self._descendants, origin=self, skip_sort=True)
+        return ListOfNodes(self._descendants, origin=self)
 
     def is_descendant_of(self, node):
         """Is the current node a descendant of the node given as argument?

From d701452314d04471d856e0f582f4b4cb90519d0a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 10 Feb 2021 04:28:51 +0100
Subject: [PATCH 0305/1374] inline root._update_ordering()

It was used only in node.remove() and node.shift()
and in both cases it could be optimized.
---
 udapi/core/node.py | 11 +++++++++--
 udapi/core/root.py | 10 ----------
 2 files changed, 9 insertions(+), 12 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index caa95129..0471dd30 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -477,7 +477,11 @@ def remove(self, children=None):
             if children.endswith('warn'):
                 logging.warning('%s is being removed by remove(children=%s), '
                                 ' but it has (unexpected) children', self, children)
-        self._root._update_ordering()
+
+        self._root._descendants = sorted(self._root.unordered_descendants())
+        for (new_ord, node) in enumerate(self._root._descendants, 1):
+            node.ord = new_ord
+
 
     # TODO: make private: _shift
     def shift(self, reference_node, after=0, move_subtree=0, reference_subtree=0):
@@ -507,7 +511,10 @@ def shift(self, reference_node, after=0, move_subtree=0, reference_subtree=0):
             node_to_move._ord = reference_ord + common_delta + \
                 (node_to_move._ord - self._ord) / 100000.
 
-        self._root._update_ordering()
+        self._root._descendants.sort()
+        for (new_ord, node) in enumerate(self._root._descendants, 1):
+            node.ord = new_ord
+
 
     # TODO add without_children kwarg
     def shift_after_node(self, reference_node):
diff --git a/udapi/core/root.py b/udapi/core/root.py
index 2d76e9ea..3fbe5fca 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -180,16 +180,6 @@ def multiword_tokens(self, mwts):
         """Set the list of all multi-word tokens in this tree."""
         self._mwts = mwts
 
-    def _update_ordering(self):
-        """Update the ord attribute of all nodes.
-
-        Update also the list of all tree nodes stored in root._descendants.
-        This method is automatically called after node removal or reordering.
-        """
-        self._descendants = sorted(self.unordered_descendants())
-        for (new_ord, node) in enumerate(self._descendants, 1):
-            node.ord = new_ord
-
     def get_sentence(self, if_missing='detokenize'):
         """Return either the stored `root.text` or (if None) `root.compute_text()`.
 

From ee1c4a32734a88a27df62a47cb90c10ebd619e6e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 10 Feb 2021 05:00:44 +0100
Subject: [PATCH 0306/1374] speedup: when node.remove() deletes just node

---
 udapi/core/node.py | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 0471dd30..ea2b11d0 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -478,9 +478,21 @@ def remove(self, children=None):
                 logging.warning('%s is being removed by remove(children=%s), '
                                 ' but it has (unexpected) children', self, children)
 
-        self._root._descendants = sorted(self._root.unordered_descendants())
-        for (new_ord, node) in enumerate(self._root._descendants, 1):
-            node.ord = new_ord
+        # When self is the only node being removed, it is faster to root._descendants.remove(self)
+        # and update the ords only where necessary (from self._ord further).
+        # When removing also its children+descendants, it is faster to recompute root._descendants
+        # and update all ords (computing leftmost descendant of self would be too slow).
+        if not self._children:
+            try:
+                self._root._descendants.remove(self)
+            except ValueError:
+                pass # self may be an already deleted node e.g. if n.remove() called twice
+            for (new_ord, node) in enumerate(self._root._descendants[self._ord - 1:], self._ord):
+                node.ord = new_ord
+        else:
+            self._root._descendants = sorted(self._root.unordered_descendants())
+            for (new_ord, node) in enumerate(self._root._descendants, 1):
+                node.ord = new_ord
 
 
     # TODO: make private: _shift

From 34ea72b7a7e3677e74f8658e232e70eac3b9cd3b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 10 Feb 2021 09:55:32 +0100
Subject: [PATCH 0307/1374] 10% faster loading of CoNLL-U files

---
 udapi/block/read/conllu.py | 37 ++++++++++++++++++++++++-------------
 1 file changed, 24 insertions(+), 13 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 83f7a1c3..e9adbae1 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -5,6 +5,7 @@
 
 from udapi.core.basereader import BaseReader
 from udapi.core.root import Root
+from udapi.core.node import Node
 
 # Compile a set of regular expressions that will be searched over the lines.
 # The equal sign after sent_id was added to the specification in UD v2.0.
@@ -131,7 +132,8 @@ def read_tree(self):
                     empty.raw_deps = fields[8]  # TODO
                     continue
 
-                node = root.create_child()
+                node = Node(root=root)
+                root._descendants.append(node)
 
                 # TODO slow implementation of speed-critical loading
                 for (n_attribute, attribute_name) in enumerate(self.node_attributes):
@@ -170,22 +172,31 @@ def read_tree(self):
             root._descendants = []
 
         # Set dependency parents (now, all nodes of the tree are created).
-        # TODO: parent setter checks for cycles, but this is something like O(n*log n)
-        # if done for each node. It could be done faster if the whole tree is checked at once.
-        # Also parent setter removes the node from its old parent's list of children,
-        # this could be skipped here by not using `node = root.create_child()`.
         for node_ord, node in enumerate(nodes[1:], 1):
             try:
-                node.parent = nodes[parents[node_ord]]
-            # TODO add a special Exception class for cycles
-            except ValueError as e:
-                if self.fix_cycles:
-                    logging.warning("Ignoring a cycle (attaching to the root instead):\n%s", e)
-                    node.parent = root
-                else:
-                    raise
+                parent = nodes[parents[node_ord]]
             except IndexError:
                 raise ValueError("Node %s HEAD is out of range (%d)" % (node, parents[node_ord]))
+            if node is parent:
+                if self.fix_cycles:
+                    logging.warning("Ignoring a cycle (attaching to the root instead):\n%s", node)
+                    node._parent = root
+                    root._children.append(node)
+                else:
+                    raise ValueError(f"Detected a cycle: {node} attached to itself")
+            elif node.children:
+                climbing = parent._parent
+                while climbing:
+                    if climbing == node:
+                        if self.fix_cycles:
+                            logging.warning("Ignoring a cycle (attaching to the root instead):\n%s", parent)
+                            parent = root
+                            break
+                        else:
+                            raise ValueError(f"Detected a cycle: {node}")
+                    climbing = climbing._parent
+            node._parent = parent
+            parent._children.append(node)
 
         # Create multi-word tokens.
         for fields in mwts:

From 1ada00a6e51d372663ded6a0886c029317cc4c18 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 12 Feb 2021 02:10:51 +0100
Subject: [PATCH 0308/1374] explanatory comment

---
 udapi/core/node.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index ea2b11d0..2cfdb5c4 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -365,6 +365,9 @@ def descendants(self):
          nodes4 = [n for n in node.descendants if n.ord < node.ord] + [node]
         See documentation of ListOfNodes for details.
         """
+        # The following code is equivalent to
+        # ListOfNodes(sorted(self.unordered_descendants()), origin=self)
+        # but it is faster because there is no extra copying of lists of nodes.
         stack = list(self._children)
         descendants = ListOfNodes(stack, origin=self)
         while(stack):

From 15ed2bafbb04ed29bfc5cbc54a164ed43a26fa67 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 12 Feb 2021 04:09:31 +0100
Subject: [PATCH 0309/1374] make reordering (node.shift*) 50% faster

---
 udapi/core/node.py | 71 ++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 59 insertions(+), 12 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 2cfdb5c4..65d050a2 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -502,8 +502,7 @@ def remove(self, children=None):
     def shift(self, reference_node, after=0, move_subtree=0, reference_subtree=0):
         """Internal method for changing word order."""
         if move_subtree:
-            nodes_to_move = self.unordered_descendants()
-            nodes_to_move.append(self)
+            nodes_to_move = self.descendants(add_self=True)
         else:
             nodes_to_move = [self]
 
@@ -518,17 +517,65 @@ def shift(self, reference_node, after=0, move_subtree=0, reference_subtree=0):
                     if node._ord < reference_ord and node is not self:
                         reference_ord = node._ord
 
-        common_delta = 0.5 if after else -0.5
-
-        # TODO: can we use some sort of epsilon instead of choosing a silly
-        # upper bound for out-degree?
-        for node_to_move in nodes_to_move:
-            node_to_move._ord = reference_ord + common_delta + \
-                (node_to_move._ord - self._ord) / 100000.
+        # convert shift_after_node to shift_before_node
+        reference_ord += 1 if after else 0
+
+        first_ord, last_ord = nodes_to_move[0]._ord, nodes_to_move[-1]._ord
+        all_nodes = self._root._descendants
+
+        # If there are no "gaps" in nodes_to_move (e.g. when it is projective),
+        # we can make the shifting a bit faster and simpler.
+        if last_ord - first_ord + 1 == len(nodes_to_move):
+            # First, move a node from position src_ord to position trg_ord RIGHT-ward.
+            trg_ord, src_ord = last_ord, first_ord - 1
+            while src_ord >= reference_ord:
+                all_nodes[trg_ord - 1] = all_nodes[src_ord - 1]
+                all_nodes[trg_ord-1]._ord = trg_ord
+                trg_ord, src_ord = trg_ord - 1, src_ord - 1
+            # Second, move a node from position src_ord to position trg_ord LEFT-ward.
+            trg_ord, src_ord = first_ord, last_ord + 1
+            while src_ord < reference_ord:
+                all_nodes[trg_ord - 1] = all_nodes[src_ord - 1]
+                all_nodes[trg_ord - 1]._ord = trg_ord
+                trg_ord, src_ord = trg_ord + 1, src_ord + 1
+            # Third, move nodes_to_move to trg_ord RIGHT-ward.
+            trg_ord = reference_ord if reference_ord < first_ord else trg_ord
+            for node in nodes_to_move:
+                all_nodes[trg_ord - 1], node._ord = node, trg_ord
+                trg_ord += 1
+            return
 
-        self._root._descendants.sort()
-        for (new_ord, node) in enumerate(self._root._descendants, 1):
-            node.ord = new_ord
+        # First, move a node from position src_ord to position trg_ord RIGHT-ward.
+        # src_ord iterates decreasingly over nodes which are not moving.
+        trg_ord, src_ord, mov_ord = last_ord, last_ord - 1, len(nodes_to_move) - 2
+        while src_ord >= reference_ord:
+            while all_nodes[src_ord - 1] is nodes_to_move[mov_ord]:
+                mov_ord, src_ord = mov_ord - 1, src_ord - 1
+                if src_ord < reference_ord:
+                    break
+            else:
+                all_nodes[trg_ord - 1] = all_nodes[src_ord - 1]
+                all_nodes[trg_ord - 1]._ord = trg_ord
+                trg_ord, src_ord = trg_ord - 1, src_ord - 1
+
+        # Second, move a node from position src_ord to position trg_ord LEFT-ward.
+        # src_ord iterates increasingly over nodes which are not moving.
+        trg_ord, src_ord, mov_ord = first_ord, first_ord + 1, 1
+        while src_ord < reference_ord:
+            while mov_ord < len(nodes_to_move) and all_nodes[src_ord - 1] is nodes_to_move[mov_ord]:
+                mov_ord, src_ord = mov_ord + 1, src_ord + 1
+                if src_ord >= reference_ord:
+                    break
+            else:
+                all_nodes[trg_ord - 1] = all_nodes[src_ord - 1]
+                all_nodes[trg_ord - 1]._ord = trg_ord
+                trg_ord, src_ord = trg_ord + 1, src_ord + 1
+
+        # Third, move nodes_to_move to trg_ord RIGHT-ward.
+        trg_ord = reference_ord if reference_ord < first_ord else trg_ord
+        for node in nodes_to_move:
+            all_nodes[trg_ord - 1], node._ord = node, trg_ord
+            trg_ord += 1
 
 
     # TODO add without_children kwarg

From 1fd8d643c28c79d15d6eb2f7e7f9cd17cb977ce9 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 12 Feb 2021 04:52:18 +0100
Subject: [PATCH 0310/1374] faster parent setter

---
 udapi/core/node.py | 23 ++++++++---------------
 1 file changed, 8 insertions(+), 15 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 65d050a2..fa5aa095 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -289,26 +289,19 @@ def parent(self, new_parent):
         if self._parent is new_parent:
             return
 
-        # The node itself couldn't be assigned as a parent. None cannot be used as parent.
-        if self is new_parent:
-            raise ValueError('Cannot set a node as its own parent (cycle are forbidden): %s' % self)
+        # Check for None new_parent and cycles.
         if new_parent is None:
-            raise ValueError('Cannot set None as parent: %s' % self)
-
-        # Check if the current Node is not an antecedent of the new parent.
-        climbing_node = new_parent
-        while not climbing_node.is_root():
-            if climbing_node is self:
-                raise ValueError('Setting the parent of %s to %s would lead to a cycle.'
-                                 % (self, new_parent))
-            climbing_node = climbing_node._parent
+            raise ValueError(f'Cannot set None as parent: {self}')
+        if self is new_parent:
+            raise ValueError(f'Cannot set a node as its own parent (cycle are forbidden): {self}')
+        if self._children and new_parent.is_descendant_of(self):
+            raise ValueError(f'Setting the parent of {self} to {new_parent} would lead to a cycle.')
 
         # Remove the current Node from the children of the old parent.
         # Forbid moving nodes from one tree to another using parent setter.
         if self._parent:
-            self._parent._children = [node for node in self._parent._children if node is not self]
-            old_root, new_root = self._parent._root, climbing_node
-            if old_root is not new_root:
+            self._parent._children.remove(self)
+            if self._parent._root is not new_parent._root:
                 raise ValueError('Cannot move nodes between trees with parent setter, '
                                  'use new_root.steal_nodes(nodes_to_be_moved) instead')
         # Set the new parent.

From 2813afbc6abbbd17f5177b174bafcfd9a9457bdb Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 12 Feb 2021 08:28:05 +0100
Subject: [PATCH 0311/1374] refactor shift* methods (and rename internal
 shift() to _shift_before_ord())

---
 udapi/core/node.py | 48 ++++++++++++++++++----------------------------
 1 file changed, 19 insertions(+), 29 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index fa5aa095..b5febc03 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -490,28 +490,12 @@ def remove(self, children=None):
             for (new_ord, node) in enumerate(self._root._descendants, 1):
                 node.ord = new_ord
 
-
-    # TODO: make private: _shift
-    def shift(self, reference_node, after=0, move_subtree=0, reference_subtree=0):
+    def _shift_before_ord(self, reference_ord, without_children=False):
         """Internal method for changing word order."""
-        if move_subtree:
-            nodes_to_move = self.descendants(add_self=True)
-        else:
+        if without_children:
             nodes_to_move = [self]
-
-        reference_ord = reference_node._ord
-        if reference_subtree:
-            if after:
-                for node in reference_node.unordered_descendants():
-                    if node._ord > reference_ord and node is not self:
-                        reference_ord = node._ord
-            else:
-                for node in reference_node.unordered_descendants():
-                    if node._ord < reference_ord and node is not self:
-                        reference_ord = node._ord
-
-        # convert shift_after_node to shift_before_node
-        reference_ord += 1 if after else 0
+        else:
+            nodes_to_move = self.descendants(add_self=True)
 
         first_ord, last_ord = nodes_to_move[0]._ord, nodes_to_move[-1]._ord
         all_nodes = self._root._descendants
@@ -570,23 +554,25 @@ def shift(self, reference_node, after=0, move_subtree=0, reference_subtree=0):
             all_nodes[trg_ord - 1], node._ord = node, trg_ord
             trg_ord += 1
 
-
-    # TODO add without_children kwarg
-    def shift_after_node(self, reference_node):
+    def shift_after_node(self, reference_node, without_children=False):
         """Shift this node after the reference_node."""
-        self.shift(reference_node, after=1, move_subtree=1, reference_subtree=0)
+        self._shift_before_ord(reference_node._ord + 1, without_children=without_children)
 
-    def shift_before_node(self, reference_node):
+    def shift_before_node(self, reference_node, without_children=False):
         """Shift this node after the reference_node."""
-        self.shift(reference_node, after=0, move_subtree=1, reference_subtree=0)
+        self._shift_before_ord(reference_node._ord, without_children=without_children)
 
-    def shift_after_subtree(self, reference_node, without_children=0):
+    def shift_after_subtree(self, reference_node, without_children=False):
         """Shift this node (and its subtree) after the subtree rooted by reference_node.
 
         Args:
         without_children: shift just this node without its subtree?
         """
-        self.shift(reference_node, after=1, move_subtree=not without_children, reference_subtree=1)
+        ref_ord = reference_node._ord
+        for node in reference_node.unordered_descendants():
+            if node._ord > ref_ord and node is not self:
+                ref_ord = node._ord
+        self._shift_before_ord(ref_ord + 1, without_children=without_children)
 
     def shift_before_subtree(self, reference_node, without_children=0):
         """Shift this node (and its subtree) before the subtree rooted by reference_node.
@@ -594,7 +580,11 @@ def shift_before_subtree(self, reference_node, without_children=0):
         Args:
         without_children: shift just this node without its subtree?
         """
-        self.shift(reference_node, after=0, move_subtree=not without_children, reference_subtree=1)
+        ref_ord = reference_node._ord
+        for node in reference_node.unordered_descendants():
+            if node._ord < ref_ord and node is not self:
+                ref_ord = node._ord
+        self._shift_before_ord(ref_ord, without_children=without_children)
 
     @property
     def prev_node(self):

From b9e755e14efced9ed2befebf7de650ba26059475 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 12 Feb 2021 08:49:11 +0100
Subject: [PATCH 0312/1374] faster node.remove()

---
 udapi/core/node.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index b5febc03..b21643f5 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -465,11 +465,14 @@ def remove(self, children=None):
             `warn` means to issue a warning if any children are present and delete them.
             `rehang_warn` means to rehang and warn:-).
         """
-        self._parent._children = [child for child in self._parent._children if child is not self]
+        self._parent._children.remove(self)
         if children is not None and self._children:
             if children.startswith('rehang'):
                 for child in self._children:
-                    child.parent = self._parent # TODO child._parent = self._parent
+                    child._parent = self._parent
+                self._parent._children.extend(self._children)
+                self._parent._children.sort()
+                self._children.clear()
             if children.endswith('warn'):
                 logging.warning('%s is being removed by remove(children=%s), '
                                 ' but it has (unexpected) children', self, children)

From 3409ecb17bf6b99c5c3d8b327e0b6d0bde59e74f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 12 Feb 2021 09:50:05 +0100
Subject: [PATCH 0313/1374] faster reordering of a single node, check
 reference_node.is_descendant_of(self)

---
 udapi/core/node.py | 59 +++++++++++++++++++++++++++++++++++-----------
 1 file changed, 45 insertions(+), 14 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index b21643f5..6cbf5471 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -373,11 +373,12 @@ def descendants(self):
 
     def is_descendant_of(self, node):
         """Is the current node a descendant of the node given as argument?"""
-        climber = self._parent
-        while climber:
-            if climber is node:
-                return True
-            climber = climber._parent
+        if node._children:
+            climber = self._parent
+            while climber:
+                if climber is node:
+                    return True
+                climber = climber._parent
         return False
 
     def create_child(self, **kwargs):
@@ -495,13 +496,27 @@ def remove(self, children=None):
 
     def _shift_before_ord(self, reference_ord, without_children=False):
         """Internal method for changing word order."""
-        if without_children:
-            nodes_to_move = [self]
-        else:
-            nodes_to_move = self.descendants(add_self=True)
+        all_nodes = self._root._descendants
 
+        # Moving a single node can be faster than nodes_to_move = [self]
+        if without_children or not self._children:
+            my_ord = self._ord
+            if reference_ord > my_ord + 1:
+                for i_ord in range(my_ord, reference_ord - 1):
+                    all_nodes[i_ord - 1] = all_nodes[i_ord]
+                    all_nodes[i_ord - 1]._ord = i_ord
+                all_nodes[reference_ord - 2] = self
+                self._ord = reference_ord - 1
+            elif reference_ord < my_ord:
+                for i_ord in range(my_ord, reference_ord, -1):
+                    all_nodes[i_ord - 1] = all_nodes[i_ord - 2]
+                    all_nodes[i_ord - 1]._ord = i_ord
+                all_nodes[reference_ord - 1] = self
+                self._ord = reference_ord
+            return
+
+        nodes_to_move = self.descendants(add_self=True)
         first_ord, last_ord = nodes_to_move[0]._ord, nodes_to_move[-1]._ord
-        all_nodes = self._root._descendants
 
         # If there are no "gaps" in nodes_to_move (e.g. when it is projective),
         # we can make the shifting a bit faster and simpler.
@@ -557,32 +572,48 @@ def _shift_before_ord(self, reference_ord, without_children=False):
             all_nodes[trg_ord - 1], node._ord = node, trg_ord
             trg_ord += 1
 
-    def shift_after_node(self, reference_node, without_children=False):
+    def shift_after_node(self, reference_node, without_children=False, skip_if_descendant=False):
         """Shift this node after the reference_node."""
+        if not without_children and reference_node.is_descendant_of(self):
+            if skip_if_descendant:
+                return
+            raise ValueError(f'{reference_node} is a descendant of {self}. Consider without_children=1.')
         self._shift_before_ord(reference_node._ord + 1, without_children=without_children)
 
-    def shift_before_node(self, reference_node, without_children=False):
+    def shift_before_node(self, reference_node, without_children=False, skip_if_descendant=False):
         """Shift this node after the reference_node."""
+        if not without_children and reference_node.is_descendant_of(self):
+            if skip_if_descendant:
+                return
+            raise ValueError(f'{reference_node} is a descendant of {self}. Consider without_children=1.')
         self._shift_before_ord(reference_node._ord, without_children=without_children)
 
-    def shift_after_subtree(self, reference_node, without_children=False):
+    def shift_after_subtree(self, reference_node, without_children=False, skip_if_descendant=False):
         """Shift this node (and its subtree) after the subtree rooted by reference_node.
 
         Args:
         without_children: shift just this node without its subtree?
         """
+        if not without_children and reference_node.is_descendant_of(self):
+            if skip_if_descendant:
+                return
+            raise ValueError(f'{reference_node} is a descendant of {self}. Consider without_children=1.')
         ref_ord = reference_node._ord
         for node in reference_node.unordered_descendants():
             if node._ord > ref_ord and node is not self:
                 ref_ord = node._ord
         self._shift_before_ord(ref_ord + 1, without_children=without_children)
 
-    def shift_before_subtree(self, reference_node, without_children=0):
+    def shift_before_subtree(self, reference_node, without_children=0, skip_if_descendant=False):
         """Shift this node (and its subtree) before the subtree rooted by reference_node.
 
         Args:
         without_children: shift just this node without its subtree?
         """
+        if not without_children and reference_node.is_descendant_of(self):
+            if skip_if_descendant:
+                return
+            raise ValueError(f'{reference_node} is a descendant of {self}. Consider without_children=1.')
         ref_ord = reference_node._ord
         for node in reference_node.unordered_descendants():
             if node._ord < ref_ord and node is not self:

From 6a22df0bc63f6b94db517b87f3e789ebf2d928f7 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 12 Feb 2021 18:01:58 +0100
Subject: [PATCH 0314/1374] read.Conllu is not faster, but supports just
 standard CoNLL-U

For loading CoNLL-X and CoNLL-2009 and other CoNLL-like formats,
users need to use a new subclass: read.Conll.
---
 udapi/block/read/conll.py  |  99 ++++++++++++++++++++++++++++++
 udapi/block/read/conllu.py | 120 ++++++++++++++-----------------------
 2 files changed, 144 insertions(+), 75 deletions(-)
 create mode 100644 udapi/block/read/conll.py

diff --git a/udapi/block/read/conll.py b/udapi/block/read/conll.py
new file mode 100644
index 00000000..7591f924
--- /dev/null
+++ b/udapi/block/read/conll.py
@@ -0,0 +1,99 @@
+""""Conll is a reader block for CoNLL-like files (CoNLL-U, CoNLL-X, CoNLL-2009)."""
+import json
+import logging
+import re
+
+import udapi.block.read.conllu
+from udapi.core.root import Root
+from udapi.core.node import Node
+
+
+class Conll(udapi.block.read.conllu.Conllu):
+    """A reader of the CoNLL-U files."""
+
+    def __init__(self, separator='tab',
+                 attributes='ord,form,lemma,upos,xpos,feats,head,deprel,deps,misc', **kwargs):
+        """Create the Conll reader object.
+
+        This us a subclass of udapi.block.read.conllu.Conllu,
+        which adds a support for arbitrary column names and thus supporting not only CoNLL-U,
+        but also CoNLL-X, CoNLL-2009 and many other CoNLL-like formats.
+
+        Args:
+        separator: How are the columns separated?
+            Default='tab' is the only possibility in valid CoNLL-U files.
+            'space' means one or more whitespaces (this does not allow forms with space).
+            'doublespace' means two or more spaces.
+        attributes: comma-separated list of column names in the input files
+            (default='ord,form,lemma,upos,xpos,feats,head,deprel,deps,misc')
+            Changing the default can be used for loading CoNLL-like formats (not valid CoNLL-U).
+            For ignoring a column, use "_" as its name.
+            Column "ord" marks the column with 1-based word-order number/index (usualy called ID).
+            Column "head" marks the column with dependency parent index (word-order number).
+
+            For example, for CoNLL-X which uses name1=value1|name2=value2 format of FEATS, use
+            `attributes=ord,form,lemma,upos,xpos,feats,head,deprel,_,_`
+            but note that attributes upos, feats and deprel will contain language-specific values,
+            not valid according to UD guidelines and a further conversion will be needed.
+            You will loose the projective_HEAD and projective_DEPREL attributes.
+
+            For CoNLL-2009 you can use `attributes=ord,form,lemma,_,upos,_,feats,_,head,_,deprel`.
+            You will loose the predicted_* attributes and semantic/predicate annotation.
+
+            TODO: allow storing the rest of columns in misc, e.g. `node.misc[feats]`
+            for feats which do not use the name1=value1|name2=value2 format.
+        """
+        super().__init__(**kwargs)
+        self.node_attributes = attributes.split(',')
+        self.separator = separator
+
+    # pylint: disable=too-many-locals,too-many-branches,too-many-statements
+    # Maybe the code could be refactored, but it is speed-critical,
+    # so benchmarking is needed because calling extra methods may result in slowdown.
+
+    def parse_node_line(self, line, root, nodes, parents, mwts):
+        if self.separator == 'tab':
+            fields = line.split('\t')
+        elif self.separator == 'space':
+            fields = line.split()
+        elif self.separator == 'doublespace':
+            fields = re.split('  +', line)
+        else:
+            raise ValueError('separator=%s is not valid' % self.separator)
+        if len(fields) != len(self.node_attributes):
+            if self.strict:
+                raise RuntimeError('Wrong number of columns in %r' % line)
+            fields.extend(['_'] * (len(self.node_attributes) - len(fields)))
+        # multi-word tokens will be processed later
+        if '-' in fields[0]:
+            mwts.append(fields)
+            return
+        if '.' in fields[0]:
+            empty = root.create_empty_child(form=fields[1], lemma=fields[2], upos=fields[3],
+                                            xpos=fields[4], feats=fields[5], misc=fields[9])
+            empty.ord = fields[0]
+            empty.raw_deps = fields[8]  # TODO
+            return
+
+        # This implementation is slower than in read.Conllu,
+        # but it allows for arbitrary columns
+        node = root.create_child()
+        for (n_attribute, attribute_name) in enumerate(self.node_attributes):
+            if attribute_name == 'head':
+                try:
+                    parents.append(int(fields[n_attribute]))
+                except ValueError as exception:
+                    if not self.strict and fields[n_attribute] == '_':
+                        if self.empty_parent == 'warn':
+                            logging.warning("Empty parent/head index in '%s'", line)
+                        parents.append(0)
+                    else:
+                        raise exception
+            elif attribute_name == 'ord':
+                setattr(node, 'ord', int(fields[n_attribute]))
+            elif attribute_name == 'deps':
+                setattr(node, 'raw_deps', fields[n_attribute])
+            elif attribute_name != '_':
+                setattr(node, attribute_name, fields[n_attribute])
+
+        nodes.append(node)
diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index e9adbae1..698fd0b6 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -19,41 +19,17 @@
 class Conllu(BaseReader):
     """A reader of the CoNLL-U files."""
 
-    def __init__(self, strict=False, separator='tab', empty_parent='warn', fix_cycles=False,
-                 attributes='ord,form,lemma,upos,xpos,feats,head,deprel,deps,misc', **kwargs):
+    def __init__(self, strict=False, empty_parent='warn', fix_cycles=False, **kwargs):
         """Create the Conllu reader object.
 
         Args:
         strict: raise an exception if errors found (default=False, i.e. a robust mode)
-        separator: How are the columns separated?
-            Default='tab' is the only possibility in valid CoNLL-U files.
-            'space' means one or more whitespaces (this does not allow forms with space).
-            'doublespace' means two or more spaces.
-        empty_parent: What to do if HEAD is _? Default=warn - issue a warning and attach to the root
+        empty_parent: What to do if HEAD is _? Default=warn: issue a warning and attach to the root
             or if strict=1 issue an exception. With `empty_parent=ignore` no warning is issued.
-        attributes: comma-separated list of column names in the input files
-            (default='ord,form,lemma,upos,xpos,feats,head,deprel,deps,misc')
-            Changing the default can be used for loading CoNLL-like formats (not valid CoNLL-U).
-            For ignoring a column, use "_" as its name.
-            Column "ord" marks the column with 1-based word-order number/index (usualy called ID).
-            Column "head" marks the column with dependency parent index (word-order number).
-
-            For example, for CoNLL-X which uses name1=value1|name2=value2 format of FEATS, use
-            `attributes=ord,form,lemma,upos,xpos,feats,head,deprel,_,_`
-            but note attributes that upos, feats and deprel will contain language-specific values,
-            not valid according to UD guidelines and a further conversion will be needed.
-            You will loose the projective_HEAD and projective_DEPREL attributes.
-
-            For CoNLL-2009 you can use `attributes=ord,form,lemma,_,upos,_,feats,_,head,_,deprel`.
-            You will loose the predicted_* attributes and semantic/predicate annotation.
-
-            TODO: allow storing the rest of columns in misc, e.g. `node.misc[feats]`
-            for feats which do not use the name1=value1|name2=value2 format.
+        fix_cycles: fix cycles by attaching a node in the cycle to the root
         """
         super().__init__(**kwargs)
-        self.node_attributes = attributes.split(',')
         self.strict = strict
-        self.separator = separator
         self.empty_parent = empty_parent
         self.fix_cycles = fix_cycles
 
@@ -88,9 +64,48 @@ def parse_comment_line(line, root):
                 container = root.json['__doc__']
             container[json_match.group(2)] = json.loads(json_match.group(3))
             return
-
         root.comment += line[1:] + "\n"
 
+    def parse_node_line(self, line, root, nodes, parents, mwts):
+        fields = line.split('\t')
+        if len(fields) != 10:
+            if self.strict:
+                raise RuntimeError('Wrong number of columns in %r' % line)
+            fields.extend(['_'] * (10 - len(fields)))
+        # multi-word tokens will be processed later
+        if '-' in fields[0]:
+            mwts.append(fields)
+            return
+        if '.' in fields[0]:
+            empty = root.create_empty_child(form=fields[1], lemma=fields[2], upos=fields[3],
+                                            xpos=fields[4], feats=fields[5], misc=fields[9])
+            empty.ord = fields[0]
+            empty.raw_deps = fields[8]  # TODO
+            return
+
+        for i in range(1, 10):
+            if fields[i] == '_':
+                fields[i] = None
+
+        # ord,form,lemma,upos,xpos,feats,head,deprel,deps,misc
+        node = Node(root=root, form=fields[1], lemma=fields[2], upos=fields[3],
+                    xpos=fields[4], feats=fields[5], deprel=fields[7], misc=fields[9])
+        root._descendants.append(node)
+        node._ord = int(fields[0])
+        if fields[8] is not None:
+            node.raw_deps = fields[8]
+        try:
+            parents.append(int(fields[6]))
+        except ValueError as exception:
+            if not self.strict and fields[6] == '_':
+                if self.empty_parent == 'warn':
+                    logging.warning("Empty parent/head index in '%s'", line)
+                parents.append(0)
+            else:
+                raise exception
+
+        nodes.append(node)
+
     # pylint: disable=too-many-locals,too-many-branches,too-many-statements
     # Maybe the code could be refactored, but it is speed-critical,
     # so benchmarking is needed because calling extra methods may result in slowdown.
@@ -109,52 +124,7 @@ def read_tree(self):
             if line[0] == '#':
                 self.parse_comment_line(line, root)
             else:
-                if self.separator == 'tab':
-                    fields = line.split('\t')
-                elif self.separator == 'space':
-                    fields = line.split()
-                elif self.separator == 'doublespace':
-                    fields = re.split('  +', line)
-                else:
-                    raise ValueError('separator=%s is not valid' % self.separator)
-                if len(fields) != len(self.node_attributes):
-                    if self.strict:
-                        raise RuntimeError('Wrong number of columns in %r' % line)
-                    fields.extend(['_'] * (len(self.node_attributes) - len(fields)))
-                # multi-word tokens will be processed later
-                if '-' in fields[0]:
-                    mwts.append(fields)
-                    continue
-                if '.' in fields[0]:
-                    empty = root.create_empty_child(form=fields[1], lemma=fields[2], upos=fields[3],
-                                                    xpos=fields[4], feats=fields[5], misc=fields[9])
-                    empty.ord = fields[0]
-                    empty.raw_deps = fields[8]  # TODO
-                    continue
-
-                node = Node(root=root)
-                root._descendants.append(node)
-
-                # TODO slow implementation of speed-critical loading
-                for (n_attribute, attribute_name) in enumerate(self.node_attributes):
-                    if attribute_name == 'head':
-                        try:
-                            parents.append(int(fields[n_attribute]))
-                        except ValueError as exception:
-                            if not self.strict and fields[n_attribute] == '_':
-                                if self.empty_parent == 'warn':
-                                    logging.warning("Empty parent/head index in '%s'", line)
-                                parents.append(0)
-                            else:
-                                raise exception
-                    elif attribute_name == 'ord':
-                        setattr(node, 'ord', int(fields[n_attribute]))
-                    elif attribute_name == 'deps':
-                        setattr(node, 'raw_deps', fields[n_attribute])
-                    elif attribute_name != '_':
-                        setattr(node, attribute_name, fields[n_attribute])
-
-                nodes.append(node)
+                self.parse_node_line(line, root, nodes, parents, mwts)
 
         # If no nodes were read from the filehandle (so only root remained in nodes),
         # we return None as a sign of failure (end of file or more than one empty line).
@@ -187,7 +157,7 @@ def read_tree(self):
             elif node.children:
                 climbing = parent._parent
                 while climbing:
-                    if climbing == node:
+                    if climbing is node:
                         if self.fix_cycles:
                             logging.warning("Ignoring a cycle (attaching to the root instead):\n%s", parent)
                             parent = root

From 5f77044cdda993ffb94b6c330e0d72729e0b0f3f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 12 Feb 2021 18:03:47 +0100
Subject: [PATCH 0315/1374] bugfix: empty root.text shoudl be loaded from
 CoNLL-U as well

otherwise loading and storing a CoNLL-U file with a sentence with no nodes
results in duplicating the "# text =" comment.
---
 udapi/block/read/conllu.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 698fd0b6..655146fc 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -11,7 +11,7 @@
 # The equal sign after sent_id was added to the specification in UD v2.0.
 # This reader accepts also older-style sent_id (until UD v2.0 treebanks are released).
 RE_SENT_ID = re.compile(r'^# sent_id\s*=?\s*(\S+)')
-RE_TEXT = re.compile(r'^# text\s*=\s*(.+)')
+RE_TEXT = re.compile(r'^# text\s*=\s*(.*)')
 RE_NEWPARDOC = re.compile(r'^# (newpar|newdoc)(?:\s+id\s*=\s*(.+))?')
 RE_JSON = re.compile(r'^# (doc_)?json_([^ =]+)\s*=\s*(.+)')
 

From ab651f537bfe0216d70d41bfa847da88188ccc49 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 12 Feb 2021 19:04:33 +0100
Subject: [PATCH 0316/1374] mwt.ord_range is a property, which internally sorts
 mwt.words

Preserving correct MWT and coref mentions while deleting/reordering nodes is tricky
- noting as TODOs.
---
 udapi/block/write/conllu.py |  4 ++--
 udapi/core/mwt.py           | 12 +++++++++---
 udapi/core/node.py          |  2 ++
 3 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index 50cf366d..3ef30e5f 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -64,10 +64,10 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
 
             mwt = node.multiword_token
             if mwt and node.ord > last_mwt_id:
-                last_mwt_id = mwt.words[-1].ord
-                print('\t'.join([mwt.ord_range(),
+                print('\t'.join([mwt.ord_range,
                                  mwt.form if mwt.form is not None else '_',
                                  '_\t_\t_\t_\t_\t_\t_', str(mwt.misc)]))
+                last_mwt_id = mwt.words[-1].ord
             values = [getattr(node, attr_name) for attr_name in self.node_attributes]
             values = ['_' if v is None else str(v) for v in values]
             try:
diff --git a/udapi/core/mwt.py b/udapi/core/mwt.py
index 289adcdb..dd3d4916 100644
--- a/udapi/core/mwt.py
+++ b/udapi/core/mwt.py
@@ -26,21 +26,27 @@ def misc(self):
     def misc(self, value):
         self._misc.set_mapping(value)
 
+    @property
     def ord_range(self):
         """Return a string suitable for the first column of CoNLL-U."""
+        self.words.sort()
         return "%d-%d" % (self.words[0].ord, self.words[-1].ord)
 
     def remove(self):
         """Delete this multi-word token (but keep its words)."""
         for word in self.words:
             word._mwt = None  # pylint: disable=W0212
-        self.root.multiword_tokens = [tok for tok in self.root.multiword_tokens if tok != self]
+        self.root.multiword_tokens.remove(self)
 
     def address(self):
         """Full (document-wide) id of the multi-word token."""
         return self.root.address + '#' + self.ord_range
 
 # TODO: node.remove() should check if the node is not part of any MWT
-# TODO: mwt.words.append(node) and node.shift* should check if the MWT does not contain gaps
+# TODO: Document that editing words by mwt.words.append(node), del or remove(node) is not supported
+# TODO: Make mwt._words privat and provide a setter
+# TODO: What to do when mwt.words = []? (It is allowed after mwt=MWT().)
+# TODO: words.setter and node.shift* should check if the MWT does not contain gaps
 #       and is still multi-word
-# TODO: check if one word is not included in multiple multi-word tokens
+# TODO: Make sure mwt.words are always sorted (even after node.shift*).
+# TODO: Check if one word is not included in multiple multi-word tokens.
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 6cbf5471..4ced6137 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -490,6 +490,8 @@ def remove(self, children=None):
             for (new_ord, node) in enumerate(self._root._descendants[self._ord - 1:], self._ord):
                 node.ord = new_ord
         else:
+            # TODO nodes_to_remove = self.unordered_descendants()
+            # and mark all nodes as deleted, remove them from MWT and coref mentions
             self._root._descendants = sorted(self._root.unordered_descendants())
             for (new_ord, node) in enumerate(self._root._descendants, 1):
                 node.ord = new_ord

From 812828507863b3463bdddcb74d377de25f239a79 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 12 Feb 2021 19:32:12 +0100
Subject: [PATCH 0317/1374] speedup: misc and feats (in Node and MWT) are
 stored as None if missing

---
 udapi/core/mwt.py  |  9 +++++++--
 udapi/core/node.py | 20 ++++++++++++++++----
 2 files changed, 23 insertions(+), 6 deletions(-)

diff --git a/udapi/core/mwt.py b/udapi/core/mwt.py
index dd3d4916..525b9bb0 100644
--- a/udapi/core/mwt.py
+++ b/udapi/core/mwt.py
@@ -9,7 +9,7 @@ class MWT(object):
     def __init__(self, words=None, form=None, misc=None, root=None):
         self.words = words if words is not None else []
         self.form = form
-        self._misc = DualDict(misc)
+        self._misc = DualDict(misc) if misc else None
         self.root = root
         for word in self.words:
             word._mwt = self  # pylint: disable=W0212
@@ -20,11 +20,16 @@ def misc(self):
 
         See `udapi.core.node.Node` for details.
         """
+        if self._misc is None:
+            self._misc = DualDict()
         return self._misc
 
     @misc.setter
     def misc(self, value):
-        self._misc.set_mapping(value)
+        if self._misc is None:
+            self._misc = DualDict(value)
+        else:
+            self._misc.set_mapping(value)
 
     @property
     def ord_range(self):
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 4ced6137..eae9fb70 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -93,9 +93,9 @@ def __init__(self, root, form=None, lemma=None, upos=None,  # pylint: disable=to
         self.lemma = lemma
         self.upos = upos
         self.xpos = xpos
-        self._feats = Feats(feats)
+        self._feats = Feats(feats) if feats else None
         self.deprel = deprel
-        self._misc = DualDict(misc)
+        self._misc = DualDict(misc) if misc else None
         self._raw_deps = '_'
         self._deps = None
         self._parent = None
@@ -176,11 +176,16 @@ def feats(self):
         For details about the implementation and other methods (e.g. `node.feats.is_plural()`),
         see ``udapi.core.feats.Feats`` which is a subclass of `DualDict`.
         """
+        if self._feats is None:
+            self._feats = Feats()
         return self._feats
 
     @feats.setter
     def feats(self, value):
-        self._feats.set_mapping(value)
+        if self._feats is None:
+            self._feats = Feats(value)
+        else:
+            self._feats.set_mapping(value)
 
     @property
     def misc(self):
@@ -203,11 +208,16 @@ def misc(self):
 
         For details about the implementation, see ``udapi.core.dualdict.DualDict``.
         """
+        if self._misc is None:
+            self._misc = DualDict()
         return self._misc
 
     @misc.setter
     def misc(self, value):
-        self._misc.set_mapping(value)
+        if self._misc is None:
+            self._misc = DualDict(value)
+        else:
+            self._misc.set_mapping(value)
 
     @property
     def raw_deps(self):
@@ -892,6 +902,8 @@ def parent(self, _):
         """Attempts at setting parent of EmptyNode result in AttributeError exception."""
         raise AttributeError('EmptyNode cannot have a (basic-UD) parent.')
 
+    # The ord getter is the same as in Node, but it must be defined,
+    # so that we can override the ord setter.
     @property
     def ord(self):
         return self._ord

From c46dd7ca6929246027e0ac1b563d7a0330454ce6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 12 Feb 2021 21:46:24 +0100
Subject: [PATCH 0318/1374] faster write.Conllu and node.deps + node.raw_deps

---
 udapi/block/write/conllu.py | 40 ++++++++++++++++++-------------------
 udapi/core/node.py          | 22 ++++++++++----------
 2 files changed, 32 insertions(+), 30 deletions(-)

diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index 3ef30e5f..18a696f2 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -12,10 +12,6 @@ def __init__(self, print_sent_id=True, print_text=True, print_empty_trees=True,
         self.print_text = print_text
         self.print_empty_trees = print_empty_trees
 
-        # A list of Conllu columns.
-        self.node_attributes = ["ord", "form", "lemma", "upos", "xpos",
-                                "feats", "parent", "deprel", "raw_deps", "misc"]
-
     def process_tree(self, tree):  # pylint: disable=too-many-branches
         nodes = tree.descendants
 
@@ -52,29 +48,33 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
         for node in nodes:
             # print all empty nodes which should go here
             while empty_nodes:
-                next_empty_ord = int(float(empty_nodes[0].ord))
+                next_empty_ord = empty_nodes[0]._ord
                 if next_empty_ord > last_ord:
                     break
                 empty = empty_nodes.pop(0)
-                values = [getattr(empty, attr_name) for attr_name in self.node_attributes]
-                values = ['_' if v is None else str(v) for v in values]
-                values[6] = '_'
-                values[7] = '_'
-                print('\t'.join(values))
+                print('\t'.join('_' if v is None else v for v in
+                    (str(node._ord), node.form, node.lemma, node.upos, node.xpos,
+                    '_' if node._feats is None else str(node.feats), '_\t_',
+                    node.raw_deps, '_' if node._misc is None else str(node.misc))))
 
             mwt = node.multiword_token
-            if mwt and node.ord > last_mwt_id:
-                print('\t'.join([mwt.ord_range,
-                                 mwt.form if mwt.form is not None else '_',
-                                 '_\t_\t_\t_\t_\t_\t_', str(mwt.misc)]))
-                last_mwt_id = mwt.words[-1].ord
-            values = [getattr(node, attr_name) for attr_name in self.node_attributes]
-            values = ['_' if v is None else str(v) for v in values]
+            if mwt and node._ord > last_mwt_id:
+                print('\t'.join((mwt.ord_range,
+                                 '_' if mwt.form is None else mwt.form,
+                                 '_\t_\t_\t_\t_\t_\t_',
+                                 '_' if node._misc is None else str(mwt.misc))))
+                last_mwt_id = mwt.words[-1]._ord
+
             try:
-                values[6] = str(node.parent.ord)
+                head = str(node._parent._ord)
             except AttributeError:
-                values[6] = '0'
-            print('\t'.join(values))
+                head = '0'
+
+            print('\t'.join('_' if v is None else v for v in
+                (str(node._ord), node.form, node.lemma, node.upos, node.xpos,
+                '_' if node._feats is None else str(node.feats), head, node.deprel,
+                node.raw_deps, '_' if node._misc is None else str(node.misc))))
+
             last_ord = node.ord
 
         # Empty sentences are not allowed in CoNLL-U,
diff --git a/udapi/core/node.py b/udapi/core/node.py
index eae9fb70..a89cfeae 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -226,12 +226,12 @@ def raw_deps(self):
         After the access to the raw enhanced dependencies,
         provide the serialization if they were deserialized already.
         """
-        if self._deps is not None:
-            serialized_deps = []
-            for secondary_dependence in self._deps:
-                serialized_deps.append('{}:{}'.format(secondary_dependence[
-                    'parent']._ord, secondary_dependence['deprel']))
-            self._raw_deps = '|'.join(serialized_deps)
+        if self._raw_deps is not None:
+            return self._raw_deps
+        if not self._deps:
+            self._raw_deps = '_'
+            return '_'
+        self._raw_deps = '|'.join(f"{dep['parent']._ord}:{dep['deprel']}" for dep in self._deps)
         return self._raw_deps
 
     @raw_deps.setter
@@ -239,9 +239,9 @@ def raw_deps(self, value):
         """Set serialized enhanced dependencies (the new value is a string).
 
         When updating raw secondary dependencies,
-        delete the current version of the deserialized data.
+        the current version of the deserialized data is deleted.
         """
-        self._raw_deps = str(value)
+        self._raw_deps = value
         self._deps = None
 
     @property
@@ -252,14 +252,15 @@ def deps(self):
         provide the deserialization of the raw data and save deps to the list.
         """
         if self._deps is None:
+            if self._raw_deps == '_':
+                return []
+
             # Obtain a list of all nodes in the dependency tree.
             nodes = [self._root] + self._root._descendants
 
             # Create a list of secondary dependencies.
             self._deps = list()
 
-            if self._raw_deps == '_':
-                return self._deps
 
             for raw_dependency in self._raw_deps.split('|'):
                 # Deprel itself may contain one or more ':' (subtypes).
@@ -280,6 +281,7 @@ def deps(self):
     def deps(self, value):
         """Set deserialized enhanced dependencies (the new value is a list of dicts)."""
         self._deps = value
+        self._raw_deps = None
 
     @property
     def parent(self):

From e677f85009d2a3f6213360a16f39824d12051f20 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 12 Feb 2021 23:49:49 +0100
Subject: [PATCH 0319/1374] partial revert of deps/raw_deps caching, so that
 tests pass

Tests use node.deps.append(dep)
instead of node.deps = node.deps + [dep]
---
 udapi/core/node.py | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index a89cfeae..0f094d5e 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -226,12 +226,13 @@ def raw_deps(self):
         After the access to the raw enhanced dependencies,
         provide the serialization if they were deserialized already.
         """
-        if self._raw_deps is not None:
-            return self._raw_deps
-        if not self._deps:
-            self._raw_deps = '_'
-            return '_'
-        self._raw_deps = '|'.join(f"{dep['parent']._ord}:{dep['deprel']}" for dep in self._deps)
+        # TODO: node.deps.append(dep) should be hooked and
+        # mark the serialized cache dirty, i.e. self._raw_deps = None.
+        # Afterwards, we can use the following optimization
+        #if self._raw_deps is not None:
+        #    return self._raw_deps
+        if self._deps is not None:
+            self._raw_deps = '|'.join(f"{dep['parent']._ord}:{dep['deprel']}" for dep in self._deps)
         return self._raw_deps
 
     @raw_deps.setter
@@ -252,16 +253,15 @@ def deps(self):
         provide the deserialization of the raw data and save deps to the list.
         """
         if self._deps is None:
+            # Create a list of secondary dependencies.
+            self._deps = list()
+
             if self._raw_deps == '_':
-                return []
+                return self._deps
 
             # Obtain a list of all nodes in the dependency tree.
             nodes = [self._root] + self._root._descendants
 
-            # Create a list of secondary dependencies.
-            self._deps = list()
-
-
             for raw_dependency in self._raw_deps.split('|'):
                 # Deprel itself may contain one or more ':' (subtypes).
                 head, deprel = raw_dependency.split(':', maxsplit=1)

From b7b5c6859a7d6e899a31eae29628aa02b8493f28 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 13 Feb 2021 00:05:13 +0100
Subject: [PATCH 0320/1374] faster exceptions

don't serialize node.address until we need to actually print the error message
---
 udapi/core/node.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 0f094d5e..0a3a716e 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -303,11 +303,11 @@ def parent(self, new_parent):
 
         # Check for None new_parent and cycles.
         if new_parent is None:
-            raise ValueError(f'Cannot set None as parent: {self}')
+            raise ValueError('Cannot set None as parent: %s', self)
         if self is new_parent:
-            raise ValueError(f'Cannot set a node as its own parent (cycle are forbidden): {self}')
+            raise ValueError('Cannot set a node as its own parent (cycle are forbidden): %s', self)
         if self._children and new_parent.is_descendant_of(self):
-            raise ValueError(f'Setting the parent of {self} to {new_parent} would lead to a cycle.')
+            raise ValueError('Setting the parent of %s to %s would lead to a cycle.', (self, new_parent))
 
         # Remove the current Node from the children of the old parent.
         # Forbid moving nodes from one tree to another using parent setter.

From ec5a40573263f53c42fcade67356ba5fe1eca6a0 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 13 Feb 2021 12:52:30 +0100
Subject: [PATCH 0321/1374] write.TextModeTrees should handle empty nodes even
 if drawing a subtree

---
 udapi/block/write/textmodetrees.py | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index f3dad456..c8e619b9 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -3,6 +3,7 @@
 import sys
 
 import colorama
+import collections
 from termcolor import colored
 from udapi.core.basewriter import BaseWriter
 
@@ -237,7 +238,13 @@ def should_print_tree(self, root, allnodes):
     def process_tree(self, root):
         """Print the tree to (possibly redirected) sys.stdout."""
         if self.print_empty:
-            allnodes = [root] + root.descendants_and_empty
+            if root.is_root():
+                allnodes = [root] + root.descendants_and_empty
+            else:
+                allnodes = root.descendants(add_self=1)
+                empty = [e for e in root._root.empty_nodes if e > allnodes[0] and e < allnodes[-1]]
+                allnodes.extend(empty)
+                allnodes.sort()
         else:
             allnodes = root.descendants(add_self=1)
         if not self.should_print_tree(root, allnodes):
@@ -248,7 +255,7 @@ def process_tree(self, root):
 
         # Precompute the number of non-projective gaps for each subtree
         if self.minimize_cross:
-            self._gaps = [0, ] * (1 + len(root.root.descendants))
+            self._gaps = collections.Counter()
             self._compute_gaps(root)
 
         # Precompute lines for printing

From 2356102357afa951e0191b911334eec904bc6f09 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 13 Feb 2021 14:46:05 +0100
Subject: [PATCH 0322/1374] CycleError for faster and better cycle detection
 handling

While
 logging.warning('My message: %s', node)
stringify-ies node into the message according to %s,
 raise ValueError('My message: %s', node)
does not work like this. We need our own exception class with overridden __str__.

The reason for stringifying the message only in __str__ is speed.
When users catch the exception, they may not need to print the message.
Current str(node) is relatively slow because it calls node.address(),
which calls node.root.address().
---
 udapi/__init__.py  |  1 +
 udapi/core/node.py | 24 +++++++++++++++++++-----
 2 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/udapi/__init__.py b/udapi/__init__.py
index afdd8025..6c281c0f 100644
--- a/udapi/__init__.py
+++ b/udapi/__init__.py
@@ -1,2 +1,3 @@
 from .core.document import Document
 from .core.run import create_block
+from .core.node import CycleError
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 0a3a716e..cf9a8f31 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -1,7 +1,8 @@
 """Node class and related classes and functions.
 
-In addition to class `Node`, this module contains also classes
-`EmptyNode`, `OrdTuple` and `ListOfNodes` and function `find_minimal_common_treelet`.
+In addition to class `Node`, this module contains also helper classes
+`CycleError`, `EmptyNode`, `OrdTuple` and `ListOfNodes`
+and function `find_minimal_common_treelet`.
 """
 import logging
 import functools
@@ -303,11 +304,11 @@ def parent(self, new_parent):
 
         # Check for None new_parent and cycles.
         if new_parent is None:
-            raise ValueError('Cannot set None as parent: %s', self)
+            raise ValueError(f'Cannot set None as parent: {self}')
         if self is new_parent:
-            raise ValueError('Cannot set a node as its own parent (cycle are forbidden): %s', self)
+            raise CycleError('Cannot set a node as its own parent (cycle are forbidden): %s', self)
         if self._children and new_parent.is_descendant_of(self):
-            raise ValueError('Setting the parent of %s to %s would lead to a cycle.', (self, new_parent))
+            raise CycleError('Setting the parent of %s to %s would lead to a cycle.', self, new_parent)
 
         # Remove the current Node from the children of the old parent.
         # Forbid moving nodes from one tree to another using parent setter.
@@ -888,6 +889,19 @@ def create_coref_cluster(self, **kwargs):
         return udapi.core.coref.create_coref_cluster(head=self, **kwargs)
 
 
+class CycleError(Exception):
+    '''A cycle in the dependency tree detected (or would be created).'''
+    def __init__(self, message, node1, node2=None):
+        self.message = message
+        self.node1 = node1
+        self.node2 = node2
+        super().__init__(message)
+
+    def __str__(self):
+        if self.node2 is None:
+            return self.message % self.node1
+        return self.message % (self.node1, self.node2)
+
 class EmptyNode(Node):
     """Class for representing empty nodes (for ellipsis in enhanced UD)."""
 

From 8d58745c9964a9d3b910b12b27675cd7b05fbb12 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 17 Feb 2021 01:06:24 +0100
Subject: [PATCH 0323/1374] write.Conllu prints empty nodes correctly and
 faster

---
 udapi/block/write/conllu.py | 50 ++++++++++++++-----------------------
 1 file changed, 19 insertions(+), 31 deletions(-)

diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index 18a696f2..429c2f42 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -13,7 +13,11 @@ def __init__(self, print_sent_id=True, print_text=True, print_empty_trees=True,
         self.print_empty_trees = print_empty_trees
 
     def process_tree(self, tree):  # pylint: disable=too-many-branches
-        nodes = tree.descendants
+        empty_nodes = tree.empty_nodes
+        if empty_nodes:
+            nodes = sorted(tree._descendants + empty_nodes)
+        else:
+            nodes = tree._descendants
 
         # Empty sentences are not allowed in CoNLL-U, so with print_empty_trees==0
         # we need to skip the whole tree (including possible comments).
@@ -22,42 +26,25 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
 
         if self.print_sent_id:
             if tree.newdoc:
-                value = ' id = ' + tree.newdoc if tree.newdoc is not True else ''
-                print('# newdoc' + value)
+                 print('# newdoc' + (' id = ' + tree.newdoc if tree.newdoc is not True else ''))
             if tree.newpar:
-                value = ' id = ' + tree.newpar if tree.newpar is not True else ''
-                print('# newpar' + value)
-            print('# sent_id = ' + tree.address())
+                print('# newpar' + (' id = ' + tree.newpar if tree.newpar is not True else ''))
+            print('# sent_id = ' + tree.sent_id)
 
         if self.print_text:
-            print("# text = " + tree.get_sentence())
+            print('# text = ' + (tree.text or tree.compute_text()))
 
         if tree.json:
             for key, value in sorted(tree.json.items()):
-                print("# json_%s = %s"
-                      % (key, json.dumps(value, ensure_ascii=False, sort_keys=True)))
+                print(f"# json_{key} = {json.dumps(value, ensure_ascii=False, sort_keys=True)}")
 
         comment = tree.comment
         if comment:
-            comment = comment.rstrip()
-            print('#' + comment.replace('\n', '\n#'))
+            print('#' + comment.rstrip().replace('\n', '\n#'))
 
         last_mwt_id = 0
-        last_ord = 0
-        empty_nodes = list(tree.empty_nodes)
         for node in nodes:
-            # print all empty nodes which should go here
-            while empty_nodes:
-                next_empty_ord = empty_nodes[0]._ord
-                if next_empty_ord > last_ord:
-                    break
-                empty = empty_nodes.pop(0)
-                print('\t'.join('_' if v is None else v for v in
-                    (str(node._ord), node.form, node.lemma, node.upos, node.xpos,
-                    '_' if node._feats is None else str(node.feats), '_\t_',
-                    node.raw_deps, '_' if node._misc is None else str(node.misc))))
-
-            mwt = node.multiword_token
+            mwt = node._mwt
             if mwt and node._ord > last_mwt_id:
                 print('\t'.join((mwt.ord_range,
                                  '_' if mwt.form is None else mwt.form,
@@ -65,18 +52,19 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
                                  '_' if node._misc is None else str(mwt.misc))))
                 last_mwt_id = mwt.words[-1]._ord
 
-            try:
-                head = str(node._parent._ord)
-            except AttributeError:
-                head = '0'
+            if node._parent is None:
+                head = '_' # Empty nodes
+            else:
+                try:
+                    head = str(node._parent._ord)
+                except AttributeError:
+                    head = '0'
 
             print('\t'.join('_' if v is None else v for v in
                 (str(node._ord), node.form, node.lemma, node.upos, node.xpos,
                 '_' if node._feats is None else str(node.feats), head, node.deprel,
                 node.raw_deps, '_' if node._misc is None else str(node.misc))))
 
-            last_ord = node.ord
-
         # Empty sentences are not allowed in CoNLL-U,
         # but with print_empty_trees==1 (which is the default),
         # we will print an artificial node, so we can print the comments.

From a2862496221410514b8e5290723b8b3dcd7cde5e Mon Sep 17 00:00:00 2001
From: michnov <michnov@users.noreply.github.com>
Date: Fri, 19 Feb 2021 20:50:01 +0100
Subject: [PATCH 0324/1374] Whitespaces can be stored in the conllu file, so
 that the original text can be reconstructed back (#71)

* Keep the information on spaces

The basic whitespace tokenizer keeps the extended information on whitespace from now on.
This is done in the way as UDPipe does it, i.e. using in the following MISC attributes:
- SpaceAfter=No
- SpacesAfter='\t\s\n'
- SpacesBefore='\s\s\s'

* escaping whitespaces in SpacesAfter and SpacesBefore attrs

* Whitespace filling can be enbled by a parameter

* use `fill_spaces` to fill in the extra whitespace MISC features
* its usage and combination with `read.Sentences` documented
* the init parameter `tokenizer_params` was commited by mistake => reverting

* `fill_spaces=True` -> `normalize_spaces=False`

* the parameter renamed to match the parameter in UDPipe
* fix: if normalize_spaces=True, SpaceAfter=No is never set for the last token in the sentence

* fixes after Martin's code review

* bugfix, missing self
---
 udapi/block/tokenize/onwhitespace.py | 86 ++++++++++++++++++++++------
 1 file changed, 68 insertions(+), 18 deletions(-)

diff --git a/udapi/block/tokenize/onwhitespace.py b/udapi/block/tokenize/onwhitespace.py
index 5451b3a1..b25005a9 100644
--- a/udapi/block/tokenize/onwhitespace.py
+++ b/udapi/block/tokenize/onwhitespace.py
@@ -1,9 +1,40 @@
 """Block tokenize.OnWhitespace"""
+import re
 from udapi.core.block import Block
 
 
 class OnWhitespace(Block):
-    """"Base tokenizer, splits on whitespaces, fills SpaceAfter=No."""
+    """Base tokenizer, splits on whitespaces, fills SpaceAfter=No.
+
+    Use the parameter `normalize_spaces=False` to preserve all whitespaces in the sentence
+    in the UDPipe way, i.e. using the `SpacesAfter` and `SpacesBefore` features in the MISC field.
+    It is backward compatible with CoNLL-U v2 `SpaceAfter=No` feature. That is, no following
+    whitespace is marked by `SpaceAfter=No` and a single following space results in no
+    whitespace-related markup.
+    If loading the text using `read.Sentences` and all whitespaces need to be preserved
+    (in order to be able to reconstruct the original document), the `read.Sentences` block
+    must be called with `rstrip=\n` or `rstrip=\r\n` to prevent stripping the trailing
+    whitespace, e.g.::
+        $> echo -e "Hello \t world " | udapy read.Sentences $'rstrip=\r\n' tokenize.OnWhitespace normalize_spaces=0 write.Conllu
+
+        # sent_id = 1
+        # text = Hello   world
+        1       Hello   _       _       _       _       0       _       _       SpacesAfter=\s\t\s
+        2       world   _       _       _       _       0       _       _       _
+    Note that the attribute `SpaceAfter=No` is missing for the token `world`, since it is
+    followed by a single space.
+
+    Parameters
+    ----------
+    normalize_spaces : bool
+        preserve whitespaces by filling MISC attributes `SpacesAfter` and `SpacesBefore` (by default True)
+    """
+
+    escape_whitespace_table = str.maketrans({' ':r'\s', '\t':r'\t', '\r':r'\r', '\n':r'\n'})
+
+    def __init__(self, normalize_spaces=True, **kwargs):
+        super().__init__(**kwargs)
+        self.normalize_spaces = normalize_spaces
 
     @staticmethod
     def tokenize_sentence(string):
@@ -13,24 +44,23 @@ def tokenize_sentence(string):
     def process_tree(self, root):
         if root.children:
             raise ValueError('Tree %s is already tokenized.' % root)
-        sentence = ' '.join(root.text.split())
+        #sentence = ' '.join(root.text.split())
+        sentence = root.text
         tokens = self.tokenize_sentence(sentence)
+
+        # Check if there are any spaces before the first token
+        spaces_before = ""
+        m = re.match(r'\s+', sentence)
+        if m:
+            spaces_before = m.group(0)
+            sentence = sentence[len(spaces_before):]
+
         for i, token in enumerate(tokens, 1):
-            space_after = False
+            spaces_after = ""
 
-            # Delete the token from the begining of the sentence.
-            if sentence.startswith(token):
-                sentence = sentence[len(token):]
-                # This is the expected case. The sentence starts with the token.
-                # If it is followed by a space, delete the space and set space_after=True.
-                if not len(sentence):
-                    space_after = True
-                elif sentence.startswith(' '):
-                    space_after = True
-                    sentence = sentence[1:]
-            else:
-                # The token (returned from tokenization) does not match the start of sentence.
-                # E.g. '. . . word' is tokenized as  '... word'.
+            # The token (returned from tokenization) does not match the start of sentence.
+            # E.g. '. . . word' is tokenized as  '... word'.
+            if not sentence.startswith(token):
                 # Let's delete the start of sentence anyway,
                 # using a non-greedy regex and the expected next token
                 # returned from the tokenization.
@@ -40,8 +70,28 @@ def process_tree(self, root):
                 # $sentence = $rest if (defined $rest);
                 raise ValueError('tokenization does not match: "%s" vs "%s"' % (token, sentence))
 
+            # Delete the token from the begining of the sentence.
+            sentence = sentence[len(token):]
+
+            # Set the SpaceAfter and SpacesAfter properly
+            m = re.match(r'\s+', sentence)
+            if m is not None:
+                spaces_after = m.group(0)
+                sentence = sentence[len(spaces_after):]
+
+            # normalize whitespace
+            if self.normalize_spaces:
+                spaces_before = ""
+                # spaces_after = "" <=> SpaceAfter=No is never set for the last token <=> len(sentence) = 0
+                spaces_after = "" if not len(spaces_after) and len(sentence) else " "
+
             # create a new node
             node = root.create_child(form=token)
             node.ord = i
-            if not space_after:
-                node.misc = 'SpaceAfter=No'
+
+            if i == 1 and spaces_before:
+                node.misc["SpacesBefore"] = spaces_before.translate(self.escape_whitespace_table)
+            if not spaces_after:
+                node.misc["SpaceAfter"] = 'No'
+            elif spaces_after != " ":
+                node.misc["SpacesAfter"] = spaces_after.translate(self.escape_whitespace_table)

From 014e0cffa1d64b981fd6666ad325e447fc2cec0d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 18 Feb 2021 11:32:20 +0100
Subject: [PATCH 0325/1374] disable garbage collection when using Udapi via
 udapy

---
 bin/udapy | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/bin/udapy b/bin/udapy
index eaaa00cc..c7ed8bba 100755
--- a/bin/udapy
+++ b/bin/udapy
@@ -1,5 +1,7 @@
 #!/usr/bin/env python3
-
+import os
+import gc
+import atexit
 import logging
 import argparse
 
@@ -46,6 +48,12 @@ argparser.add_argument(
     "-X", "--extra", action="append",
     help="Add a specified parameter (or a block name) to the end of the scenario\n"
          "For example 'udapy -TNX attributes=form,misc -X layout=align < my.conllu'")
+argparser.add_argument(
+    "--gc", action="store_true",
+    help="By default, udapy disables Python garbage collection and at-exit cleanup\n"
+         "to speed up everything (especially reading CoNLL-U files). In edge cases,\n"
+         "when processing many files and running out of memory, you can disable this\n"
+         "optimization (i.e. enable garbage collection) with 'udapy --gc'.")
 argparser.add_argument(
     'scenario', nargs=argparse.REMAINDER, help="A sequence of blocks and their parameters.")
 
@@ -64,6 +72,20 @@ logging.basicConfig(format='%(asctime)-15s [%(levelname)7s] %(funcName)s - %(mes
 
 # Process and provide the scenario.
 if __name__ == "__main__":
+
+    # Disabling garbage collections makes the whole processing much faster.
+    # Similarly, we can save several seconds by partially disabling the at-exit Python cleanup
+    # (atexit hooks are called in reversed order of their registration,
+    # so flushing stdio buffers etc. will be still done before the os._exit(0) call).
+    # See https://instagram-engineering.com/dismissing-python-garbage-collection-at-instagram-4dca40b29172
+    # Is it safe to disable GC?
+    # OS will free the memory allocated by this process after it ends anyway.
+    # The udapy wrapper is aimed for one-time tasks, not a long-running server,
+    # so in a typical case a document is loaded and almost no memory is freed before the end.
+    # Udapi documents have a many cyclic references, so running GC is quite slow.
+    if not args.gc:
+        gc.disable()
+        atexit.register(os._exit, 0)
     if args.save:
         args.scenario = args.scenario + ['write.Conllu']
     if args.save_text_mode_trees:

From a0e7ae535a99e4c6fd6fbeac40ae3472e1020d71 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 18 Feb 2021 11:50:24 +0100
Subject: [PATCH 0326/1374] speedup loading by 15% even when not using Udapi
 via udapy

When using Udapi via udapy, gc is disabled by default.
But even when gc is not globally disabled, we can get a big speedup:
- temporarily disabling garbage collection during CoNLL-U (or another reader) loading
- run gc.collect() after the loading is done
  (all-generation GC after loading makes future node.create_child() calls faster)
---
 udapi/core/basereader.py | 199 +++++++++++++++++++++------------------
 1 file changed, 106 insertions(+), 93 deletions(-)

diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index f1e32d18..77ebc0db 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -1,7 +1,5 @@
 """BaseReader is the base class for all reader blocks."""
-import re
-import logging
-
+import gc
 from udapi.core.block import Block
 from udapi.core.files import Files
 
@@ -91,99 +89,114 @@ def filtered_read_tree(self):
     # Maybe the code could be refactored, but it is speed-critical,
     # so benchmarking is needed because calling extra methods may result in slowdown.
     def process_document(self, document):
-        orig_bundles = document.bundles[:]
-        last_bundle_id = ''
-        bundle = None
-
-        # There may be a tree left in the buffer when reading the last doc.
-        if self._buffer:
-            root = self._buffer
-            self._buffer = None
-            if orig_bundles:
-                # TODO list.pop(0) is inefficient, use collections.deque.popleft()
-                bundle = orig_bundles.pop(0)
-            else:
-                bundle = document.create_bundle()
-                if root._sent_id is not None:
-                    bundle.bundle_id = root._sent_id.split('/', 1)[0]
-            bundle.add_tree(root)
-            if root.newdoc and root.newdoc is not True:
-                document.meta["docname"] = root.newdoc
-
-        filehandle = self.filehandle
-        if filehandle is None:
-            filehandle = self.next_filehandle()
-            if filehandle is None:
-                self.finished = True
-                return
-
-        trees_loaded = 0
-        while True:
-            root = self.filtered_read_tree()
-            if root is None:
-                if trees_loaded == 0 and self.files.has_next_file():
-                    filehandle = self.next_filehandle()
-                    continue
-                self.finished = not self.files.has_next_file()
-                break
-            if trees_loaded == 0:
-                document.meta['loaded_from'] = self.filename
-            add_to_the_last_bundle = 0
-            trees_loaded += 1
-
-            if self.ignore_sent_id:
-                root._sent_id = None
-            if root._sent_id is not None:
-                parts = root._sent_id.split('/', 1)
-                bundle_id = parts[0]
-                if len(parts) == 2:
-                    root.zone = parts[1]
-                add_to_the_last_bundle = bundle_id == last_bundle_id
-                last_bundle_id = bundle_id
-
-            if self.zone != 'keep':
-                root.zone = self.zone
-
-            # The `# newdoc` comment in CoNLL-U marks a start of a new document.
-            if root.newdoc:
-                if not bundle and root.newdoc is not True:
+        # Temporarily disabling garbage collection makes the loading much faster.
+        gc_was_enabled = gc.isenabled()
+        gc.disable()
+        try:
+            orig_bundles = document.bundles[:]
+            last_bundle_id = ''
+            bundle = None
+
+            # There may be a tree left in the buffer when reading the last doc.
+            if self._buffer:
+                root = self._buffer
+                self._buffer = None
+                if orig_bundles:
+                    # TODO list.pop(0) is inefficient, use collections.deque.popleft()
+                    bundle = orig_bundles.pop(0)
+                else:
+                    bundle = document.create_bundle()
+                    if root._sent_id is not None:
+                        bundle.bundle_id = root._sent_id.split('/', 1)[0]
+                bundle.add_tree(root)
+                if root.newdoc and root.newdoc is not True:
                     document.meta["docname"] = root.newdoc
-                if bundle and self.split_docs:
-                    self._buffer = root
-                    if orig_bundles:
-                        logging.warning("split_docs=1 but the doc had contained %d bundles",
-                                        len(orig_bundles))
-                    self.finished = False
+
+            filehandle = self.filehandle
+            if filehandle is None:
+                filehandle = self.next_filehandle()
+                if filehandle is None:
+                    self.finished = True
                     return
 
-            # assign new/next bundle to `bundle` if needed
-            if not bundle or not add_to_the_last_bundle:
-                if self.bundles_per_doc and bundle and self.bundles_per_doc == bundle.number:
-                    self._buffer = root
+            trees_loaded = 0
+            while True:
+                root = self.filtered_read_tree()
+                if root is None:
+                    if trees_loaded == 0 and self.files.has_next_file():
+                        filehandle = self.next_filehandle()
+                        continue
+                    self.finished = not self.files.has_next_file()
+                    break
+                if trees_loaded == 0:
+                    document.meta['loaded_from'] = self.filename
+                add_to_the_last_bundle = 0
+                trees_loaded += 1
+
+                if self.ignore_sent_id:
+                    root._sent_id = None
+                if root._sent_id is not None:
+                    parts = root._sent_id.split('/', 1)
+                    bundle_id = parts[0]
+                    if len(parts) == 2:
+                        root.zone = parts[1]
+                    add_to_the_last_bundle = bundle_id == last_bundle_id
+                    last_bundle_id = bundle_id
+
+                if self.zone != 'keep':
+                    root.zone = self.zone
+
+                # The `# newdoc` comment in CoNLL-U marks a start of a new document.
+                if root.newdoc:
+                    if not bundle and root.newdoc is not True:
+                        document.meta["docname"] = root.newdoc
+                    if bundle and self.split_docs:
+                        self._buffer = root
+                        if orig_bundles:
+                            logging.warning("split_docs=1 but the doc had contained %d bundles",
+                                            len(orig_bundles))
+                        self.finished = False
+                        return
+
+                # assign new/next bundle to `bundle` if needed
+                if not bundle or not add_to_the_last_bundle:
+                    if self.bundles_per_doc and bundle and self.bundles_per_doc == bundle.number:
+                        self._buffer = root
+                        if orig_bundles:
+                            logging.warning("bundles_per_doc=%d but the doc had contained %d bundles",
+                                            self.bundles_per_doc, len(orig_bundles))
+                        return
+
                     if orig_bundles:
-                        logging.warning("bundles_per_doc=%d but the doc had contained %d bundles",
-                                        self.bundles_per_doc, len(orig_bundles))
+                        # TODO list.pop(0) is inefficient, use collections.deque.popleft()
+                        bundle = orig_bundles.pop(0)
+                        if last_bundle_id and last_bundle_id != bundle.bundle_id:
+                            logging.warning('Mismatch in bundle IDs: %s vs %s. Keeping the former one.',
+                                            bundle.bundle_id, last_bundle_id)
+                    else:
+                        bundle = document.create_bundle()
+                        if last_bundle_id != '':
+                            bundle.bundle_id = last_bundle_id
+
+                bundle.add_tree(root)
+
+                # If bundles_per_doc is set and we have read the specified number of bundles,
+                # we should end the current document and return.
+                # However, if the reader supports reading multiple zones, we can never know
+                # if the current bundle has ended or there will be another tree for this bundle.
+                # So in case of multizone readers we need to read one extra tree
+                # and store it in the buffer (and include it into the next document).
+                if self.bundles_per_doc and self.bundles_per_doc == bundle.number \
+                   and not self.is_multizone_reader():
                     return
 
-                if orig_bundles:
-                    # TODO list.pop(0) is inefficient, use collections.deque.popleft()
-                    bundle = orig_bundles.pop(0)
-                    if last_bundle_id and last_bundle_id != bundle.bundle_id:
-                        logging.warning('Mismatch in bundle IDs: %s vs %s. Keeping the former one.',
-                                        bundle.bundle_id, last_bundle_id)
-                else:
-                    bundle = document.create_bundle()
-                    if last_bundle_id != '':
-                        bundle.bundle_id = last_bundle_id
-
-            bundle.add_tree(root)
-
-            # If bundles_per_doc is set and we have read the specified number of bundles,
-            # we should end the current document and return.
-            # However, if the reader supports reading multiple zones, we can never know
-            # if the current bundle has ended or there will be another tree for this bundle.
-            # So in case of multizone readers we need to read one extra tree
-            # and store it in the buffer (and include it into the next document).
-            if self.bundles_per_doc and self.bundles_per_doc == bundle.number \
-               and not self.is_multizone_reader():
-                return
+        # Running garbage collector now takes about 0.36s for a 720k-words (68MiB) conllu file
+        # but it makes further processing (where new objects are created) much faster,
+        # e.g. 0.85s when creating 65k new nodes.
+        # If garbage collection was already disabled (e.g. in udapy), everything is even faster
+        # (but no memory with cyclic references is ever freed before the process exits)
+        # and in that case we don't want to enable gc here.
+        finally:
+            if gc_was_enabled:
+                gc.enable()
+                gc.collect()

From 6ee5259b9ac87da2baed49ee4945018e50286a72 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 18 Feb 2021 12:08:14 +0100
Subject: [PATCH 0327/1374] inlined parse_node_line(): 2% faster loading

---
 udapi/block/read/conllu.py | 80 +++++++++++++++++++-------------------
 1 file changed, 39 insertions(+), 41 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 655146fc..3026c2c1 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -66,46 +66,6 @@ def parse_comment_line(line, root):
             return
         root.comment += line[1:] + "\n"
 
-    def parse_node_line(self, line, root, nodes, parents, mwts):
-        fields = line.split('\t')
-        if len(fields) != 10:
-            if self.strict:
-                raise RuntimeError('Wrong number of columns in %r' % line)
-            fields.extend(['_'] * (10 - len(fields)))
-        # multi-word tokens will be processed later
-        if '-' in fields[0]:
-            mwts.append(fields)
-            return
-        if '.' in fields[0]:
-            empty = root.create_empty_child(form=fields[1], lemma=fields[2], upos=fields[3],
-                                            xpos=fields[4], feats=fields[5], misc=fields[9])
-            empty.ord = fields[0]
-            empty.raw_deps = fields[8]  # TODO
-            return
-
-        for i in range(1, 10):
-            if fields[i] == '_':
-                fields[i] = None
-
-        # ord,form,lemma,upos,xpos,feats,head,deprel,deps,misc
-        node = Node(root=root, form=fields[1], lemma=fields[2], upos=fields[3],
-                    xpos=fields[4], feats=fields[5], deprel=fields[7], misc=fields[9])
-        root._descendants.append(node)
-        node._ord = int(fields[0])
-        if fields[8] is not None:
-            node.raw_deps = fields[8]
-        try:
-            parents.append(int(fields[6]))
-        except ValueError as exception:
-            if not self.strict and fields[6] == '_':
-                if self.empty_parent == 'warn':
-                    logging.warning("Empty parent/head index in '%s'", line)
-                parents.append(0)
-            else:
-                raise exception
-
-        nodes.append(node)
-
     # pylint: disable=too-many-locals,too-many-branches,too-many-statements
     # Maybe the code could be refactored, but it is speed-critical,
     # so benchmarking is needed because calling extra methods may result in slowdown.
@@ -124,7 +84,45 @@ def read_tree(self):
             if line[0] == '#':
                 self.parse_comment_line(line, root)
             else:
-                self.parse_node_line(line, root, nodes, parents, mwts)
+                fields = line.split('\t')
+                if len(fields) != 10:
+                    if self.strict:
+                        raise RuntimeError('Wrong number of columns in %r' % line)
+                    fields.extend(['_'] * (10 - len(fields)))
+                # multi-word tokens will be processed later
+                if '-' in fields[0]:
+                    mwts.append(fields)
+                    continue
+                if '.' in fields[0]:
+                    empty = root.create_empty_child(form=fields[1], lemma=fields[2], upos=fields[3],
+                                                    xpos=fields[4], feats=fields[5], misc=fields[9])
+                    empty.ord = fields[0]
+                    empty.raw_deps = fields[8]  # TODO
+                    continue
+
+                for i in range(1, 10):
+                    if fields[i] == '_':
+                        fields[i] = None
+
+                # ord,form,lemma,upos,xpos,feats,head,deprel,deps,misc
+                node = Node(root=root, form=fields[1], lemma=fields[2], upos=fields[3],
+                            xpos=fields[4], feats=fields[5], deprel=fields[7], misc=fields[9])
+                root._descendants.append(node)
+                node._ord = int(fields[0])
+                if fields[8] is not None:
+                    node.raw_deps = fields[8]
+                try:
+                    parents.append(int(fields[6]))
+                except ValueError as exception:
+                    if not self.strict and fields[6] == '_':
+                        if self.empty_parent == 'warn':
+                            logging.warning("Empty parent/head index in '%s'", line)
+                        parents.append(0)
+                    else:
+                        raise exception
+
+                nodes.append(node)
+
 
         # If no nodes were read from the filehandle (so only root remained in nodes),
         # we return None as a sign of failure (end of file or more than one empty line).

From 4b34090dce1719935e9f3d8ccf6d1a6d3337258c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 18 Feb 2021 12:14:52 +0100
Subject: [PATCH 0328/1374] faster conversion of '_' to None: 8% faster loading

- `for i in range(1,10)` is slower than `for i in [1,2,3,4,5,6,7,8,9]`.
- We need just some of the columns to be converted.
---
 udapi/block/read/conllu.py | 12 +++++++-----
 udapi/core/node.py         |  4 ++--
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 3026c2c1..850be530 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -100,16 +100,19 @@ def read_tree(self):
                     empty.raw_deps = fields[8]  # TODO
                     continue
 
-                for i in range(1, 10):
-                    if fields[i] == '_':
-                        fields[i] = None
+                if fields[3] == '_':
+                    fields[3] = None
+                if fields[4] == '_':
+                    fields[4] = None
+                if fields[7] == '_':
+                    fields[7] = None
 
                 # ord,form,lemma,upos,xpos,feats,head,deprel,deps,misc
                 node = Node(root=root, form=fields[1], lemma=fields[2], upos=fields[3],
                             xpos=fields[4], feats=fields[5], deprel=fields[7], misc=fields[9])
                 root._descendants.append(node)
                 node._ord = int(fields[0])
-                if fields[8] is not None:
+                if fields[8] != '_':
                     node.raw_deps = fields[8]
                 try:
                     parents.append(int(fields[6]))
@@ -123,7 +126,6 @@ def read_tree(self):
 
                 nodes.append(node)
 
-
         # If no nodes were read from the filehandle (so only root remained in nodes),
         # we return None as a sign of failure (end of file or more than one empty line).
         if len(nodes) == 1:
diff --git a/udapi/core/node.py b/udapi/core/node.py
index cf9a8f31..1b22f3dc 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -94,9 +94,9 @@ def __init__(self, root, form=None, lemma=None, upos=None,  # pylint: disable=to
         self.lemma = lemma
         self.upos = upos
         self.xpos = xpos
-        self._feats = Feats(feats) if feats else None
+        self._feats = Feats(feats) if feats and feats != '_' else None
         self.deprel = deprel
-        self._misc = DualDict(misc) if misc else None
+        self._misc = DualDict(misc) if misc and misc != '_' else None
         self._raw_deps = '_'
         self._deps = None
         self._parent = None

From 3e44b732dec082a18a2ea2a97fd3e712d0fe1d0b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 20 Feb 2021 04:03:06 +0100
Subject: [PATCH 0329/1374] 9% faster loading by reading the whole file at once

at the cost of 17% more memory and an additional method `read_trees()`
as an alternative to `read_tree()` (which needs to be implemented in all readers  anyway)
---
 udapi/block/read/conllu.py | 23 +++++++++----
 udapi/core/basereader.py   | 68 ++++++++++++++++++++++++++++++++++----
 udapi/core/document.py     |  6 ++--
 3 files changed, 79 insertions(+), 18 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 850be530..0f750bb7 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -66,21 +66,30 @@ def parse_comment_line(line, root):
             return
         root.comment += line[1:] + "\n"
 
-    # pylint: disable=too-many-locals,too-many-branches,too-many-statements
-    # Maybe the code could be refactored, but it is speed-critical,
-    # so benchmarking is needed because calling extra methods may result in slowdown.
+    def read_trees(self):
+        return [self.read_tree_from_lines(s.split('\n')) for s in
+                self.filehandle.read().split('\n\n') if s]
+
     def read_tree(self):
         if self.filehandle is None:
             return None
+        lines = []
+        for line in self.filehandle:
+            line = line.rstrip()
+            if line == '':
+                break
+            lines.append(line)
+        return self.read_tree_from_lines(lines)
 
+    # pylint: disable=too-many-locals,too-many-branches,too-many-statements
+    # Maybe the code could be refactored, but it is speed-critical,
+    # so benchmarking is needed because calling extra methods may result in slowdown.
+    def read_tree_from_lines(self, lines):
         root = Root()
         nodes = [root]
         parents = [0]
         mwts = []
-        for line in self.filehandle:
-            line = line.rstrip()
-            if line == '':
-                break
+        for line in lines:
             if line[0] == '#':
                 self.parse_comment_line(line, root)
             else:
diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 77ebc0db..4f14d32c 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -59,7 +59,7 @@ def next_filehandle(self):
         return self.files.next_filehandle()
 
     def read_tree(self):
-        """Load one (more) tree from self.files and return its root.
+        """Load one (more) tree from self.filehandle and return its root.
 
         This method must be overriden in all readers.
         Usually it is the only method that needs to be implemented.
@@ -67,6 +67,14 @@ def read_tree(self):
         """
         raise NotImplementedError("Class %s doesn't implement read_tree" % self.__class__.__name__)
 
+    def read_trees(self):
+        """Load all trees from self.filehandle and return a list of their roots.
+
+        This method may be overriden in a reader if a faster alternative to read_tree() is needed.
+        The implementation in this base clases raises `NotImplementedError`.
+        """
+        raise NotImplementedError("Class %s doesn't implement read_trees" % self.__class__.__name__)
+
     def filtered_read_tree(self):
         """Load and return one more tree matching the `sent_id_filter`.
 
@@ -85,6 +93,53 @@ def filtered_read_tree(self):
                           tree.sent_id, self.sent_id_filter)
             tree = self.read_tree()
 
+    def try_fast_load(self, document):
+        """Try to use self.read_trees() if possible and return True, otherwise False."""
+        if document.bundles or self.bundles_per_doc or self.sent_id_filter or self.split_docs:
+            return False
+        if self.filehandle is None:
+            filehandle = self.next_filehandle()
+            if filehandle is None:
+                self.finished = True
+                return True
+        try:
+            trees = self.read_trees()
+        except NotImplementedError:
+            return False
+
+        document.meta['loaded_from'] = self.filename
+        if trees and trees[0].newdoc and trees[0].newdoc is not True:
+            document.meta["docname"] = trees[0].newdoc
+
+        bundle, last_bundle_id = None, ''
+        for root in trees:
+            add_to_the_last_bundle = False
+
+            if self.ignore_sent_id:
+                root._sent_id = None
+            elif root._sent_id is not None:
+                parts = root._sent_id.split('/', 1)
+                bundle_id = parts[0]
+                if len(parts) == 2:
+                    root.zone = parts[1]
+                add_to_the_last_bundle = bundle_id == last_bundle_id
+                last_bundle_id = bundle_id
+            if self.zone != 'keep':
+                root.zone = self.zone
+
+            # assign new/next bundle to `bundle` if needed
+            if not bundle or not add_to_the_last_bundle:
+                bundle = document.create_bundle()
+                if last_bundle_id != '':
+                    bundle.bundle_id = last_bundle_id
+
+            bundle.add_tree(root)
+
+        self.next_filehandle()
+        if filehandle is None:
+            self.finished = True
+        return True
+
     # pylint: disable=too-many-branches,too-many-statements
     # Maybe the code could be refactored, but it is speed-critical,
     # so benchmarking is needed because calling extra methods may result in slowdown.
@@ -93,16 +148,16 @@ def process_document(self, document):
         gc_was_enabled = gc.isenabled()
         gc.disable()
         try:
+            if self.try_fast_load(document):
+                return
             orig_bundles = document.bundles[:]
-            last_bundle_id = ''
-            bundle = None
+            bundle, last_bundle_id = None, ''
 
             # There may be a tree left in the buffer when reading the last doc.
             if self._buffer:
                 root = self._buffer
                 self._buffer = None
                 if orig_bundles:
-                    # TODO list.pop(0) is inefficient, use collections.deque.popleft()
                     bundle = orig_bundles.pop(0)
                 else:
                     bundle = document.create_bundle()
@@ -130,12 +185,12 @@ def process_document(self, document):
                     break
                 if trees_loaded == 0:
                     document.meta['loaded_from'] = self.filename
-                add_to_the_last_bundle = 0
+                add_to_the_last_bundle = False
                 trees_loaded += 1
 
                 if self.ignore_sent_id:
                     root._sent_id = None
-                if root._sent_id is not None:
+                elif root._sent_id is not None:
                     parts = root._sent_id.split('/', 1)
                     bundle_id = parts[0]
                     if len(parts) == 2:
@@ -168,7 +223,6 @@ def process_document(self, document):
                         return
 
                     if orig_bundles:
-                        # TODO list.pop(0) is inefficient, use collections.deque.popleft()
                         bundle = orig_bundles.pop(0)
                         if last_bundle_id and last_bundle_id != bundle.bundle_id:
                             logging.warning('Mismatch in bundle IDs: %s vs %s. Keeping the former one.',
diff --git a/udapi/core/document.py b/udapi/core/document.py
index 6bf2e55d..16961975 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -61,13 +61,11 @@ def create_bundle(self):
 
     def load_conllu(self, filename=None):
         """Load a document from a conllu-formatted file."""
-        reader = ConlluReader(files=filename)
-        reader.apply_on_document(self)
+        ConlluReader(files=filename).process_document(self)
 
     def store_conllu(self, filename):
         """Store a document into a conllu-formatted file."""
-        writer = ConlluWriter(files=filename)
-        writer.apply_on_document(self)
+        ConlluWriter(files=filename).apply_on_document(self)
 
     def from_conllu_string(self, string):
         """Load a document from a conllu-formatted string."""

From d466683c947b18b5b9dd7b39f584a15a0e44b558 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 20 Feb 2021 04:12:44 +0100
Subject: [PATCH 0330/1374] util.Wc tsv=1 for easier-to-parse output

---
 udapi/block/util/wc.py | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/udapi/block/util/wc.py b/udapi/block/util/wc.py
index 403daf5f..137c95e9 100644
--- a/udapi/block/util/wc.py
+++ b/udapi/block/util/wc.py
@@ -5,10 +5,15 @@
 class Wc(Block):
     """Special block for printing statistics (word count etc)."""
 
-    def __init__(self, **kwargs):
-        """Create the Wc block object."""
+    def __init__(self, tsv=False, **kwargs):
+        """Create the Wc block object.
+
+        Params:
+        tsv: print just tab-separated-values (trees, words, tokens, MWTs, empty nodes)
+        """
         super().__init__(**kwargs)
         self.trees, self.words, self.mwts, self.tokens, self.empty = 0, 0, 0, 0, 0
+        self.tsv = tsv
 
     def process_tree(self, tree):
         self.trees += 1
@@ -19,8 +24,11 @@ def process_tree(self, tree):
         self.empty += len(tree.empty_nodes)
 
     def process_end(self):
-        print('%8d trees\n%8d words' % (self.trees, self.words))
-        if self.mwts:
-            print('%8d multi-word tokens\n%8d tokens' % (self.mwts, self.tokens))
-        if self.empty:
-            print('%8d empty nodes' % self.empty)
+        if self.tsv:
+            print('\t'.join(map(str, (self.trees, self.words, self.tokens, self.mwts, self.empty))))
+        else:
+            print('%8d trees\n%8d words' % (self.trees, self.words))
+            if self.mwts:
+                print('%8d multi-word tokens\n%8d tokens' % (self.mwts, self.tokens))
+            if self.empty:
+                print('%8d empty nodes' % self.empty)

From b6d64982756af9a071390698accfd2b37991eb37 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 20 Feb 2021 05:25:30 +0100
Subject: [PATCH 0331/1374] allow udapi.Document('my.conllu',
 empty_parent='ignore')

---
 udapi/core/document.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/core/document.py b/udapi/core/document.py
index 16961975..58b4b34e 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -31,7 +31,7 @@ def __init__(self, filename=None, **kwargs):
         self._coref_clusters = None
         if filename is not None:
             if filename.endswith(".conllu"):
-                self.load_conllu(filename)
+                self.load_conllu(filename, **kwargs)
             elif filename.endswith(".txt"):
                 reader = SentencesReader(files=filename, **kwargs)
                 reader.apply_on_document(self)
@@ -59,9 +59,9 @@ def create_bundle(self):
         bundle.number = len(self.bundles)
         return bundle
 
-    def load_conllu(self, filename=None):
+    def load_conllu(self, filename=None, **kwargs):
         """Load a document from a conllu-formatted file."""
-        ConlluReader(files=filename).process_document(self)
+        ConlluReader(files=filename, **kwargs).process_document(self)
 
     def store_conllu(self, filename):
         """Store a document into a conllu-formatted file."""

From a977dcfd6a843758bf669db5c05480a18fd97268 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 21 Feb 2021 13:00:24 +0100
Subject: [PATCH 0332/1374] bugfix

---
 udapi/core/basereader.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 4f14d32c..5d991a29 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -136,7 +136,7 @@ def try_fast_load(self, document):
             bundle.add_tree(root)
 
         self.next_filehandle()
-        if filehandle is None:
+        if self.filehandle is None:
             self.finished = True
         return True
 

From df098c35fbb5f81338ccfaf8cfbac9f3e85fdee8 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 22 Feb 2021 15:12:15 +0100
Subject: [PATCH 0333/1374] bugfix: allow (again) `n.is_descendant_of(None)`

which returns False, of course
---
 udapi/core/node.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 1b22f3dc..2640ab91 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -386,7 +386,7 @@ def descendants(self):
 
     def is_descendant_of(self, node):
         """Is the current node a descendant of the node given as argument?"""
-        if node._children:
+        if node and node._children:
             climber = self._parent
             while climber:
                 if climber is node:

From f24e9d27096074baa9710a27c78089097c985719 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 22 Feb 2021 18:30:09 +0100
Subject: [PATCH 0334/1374] deploy udapi 0.2.3

---
 CHANGES.txt | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGES.txt b/CHANGES.txt
index 73418e3b..c79a5d82 100644
--- a/CHANGES.txt
+++ b/CHANGES.txt
@@ -2,9 +2,10 @@ Udapi Change Log
 ----------------
 See https://github.com/udapi/udapi-python/commits/master for details.
 
-0.2.3 2021-02-04
+0.2.3 2021-02-22
  - support for enhanced dependencies and coreference
  - requires Python 3.6+ due to f-strings
+ - speed-up (benchmark 40.5s -> 10.4s)
 
 0.2.2 2018-01-08
  - support for loading/storing documents from/to strings

From acd214e659dc5986b42384e00d91db49b8ce86c5 Mon Sep 17 00:00:00 2001
From: Zdenek Zabokrtsky <zabokrtsky@ufal.mff.cuni.cz>
Date: Mon, 22 Feb 2021 21:19:21 +0100
Subject: [PATCH 0335/1374] a block for removing listed temporary attributes
 after primary corefud conversions

---
 udapi/block/corefud/removemisc.py | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 udapi/block/corefud/removemisc.py

diff --git a/udapi/block/corefud/removemisc.py b/udapi/block/corefud/removemisc.py
new file mode 100644
index 00000000..6ca1e87a
--- /dev/null
+++ b/udapi/block/corefud/removemisc.py
@@ -0,0 +1,17 @@
+from udapi.core.block import Block
+import re
+
+class RemoveMisc(Block):
+    """Deleting all temporary attributes after primary conversions"""
+
+    def __init__(self, attrnames='', **kwargs):
+        """ Arg: attrnames = comma-separated list of Misc attributes to be deleted"""
+        super().__init__(**kwargs)
+        self.attrs4deletion = set(attrnames.split(','))
+    
+    def process_node(self,node):
+        for attrname in list(node.misc):
+            shortattrname = re.sub(r'\[\d+\]',r'',attrname)
+            if shortattrname in self.attrs4deletion:
+                del node.misc[attrname]
+

From 09208bccd38461153652ec7321e5d7b7f62e8495 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 23 Feb 2021 02:31:04 +0100
Subject: [PATCH 0336/1374] modern Python packaging

---
 CHANGES.txt    |  2 +-
 pyproject.toml |  6 ++++++
 setup.cfg      | 29 +++++++++++++++++++++++++++++
 setup.py       | 29 +++--------------------------
 4 files changed, 39 insertions(+), 27 deletions(-)
 create mode 100644 pyproject.toml
 create mode 100644 setup.cfg

diff --git a/CHANGES.txt b/CHANGES.txt
index c79a5d82..77d72548 100644
--- a/CHANGES.txt
+++ b/CHANGES.txt
@@ -2,7 +2,7 @@ Udapi Change Log
 ----------------
 See https://github.com/udapi/udapi-python/commits/master for details.
 
-0.2.3 2021-02-22
+0.2.3 2021-02-23
  - support for enhanced dependencies and coreference
  - requires Python 3.6+ due to f-strings
  - speed-up (benchmark 40.5s -> 10.4s)
diff --git a/pyproject.toml b/pyproject.toml
new file mode 100644
index 00000000..374b58cb
--- /dev/null
+++ b/pyproject.toml
@@ -0,0 +1,6 @@
+[build-system]
+requires = [
+    "setuptools>=42",
+    "wheel"
+]
+build-backend = "setuptools.build_meta"
diff --git a/setup.cfg b/setup.cfg
new file mode 100644
index 00000000..4e96f81a
--- /dev/null
+++ b/setup.cfg
@@ -0,0 +1,29 @@
+[metadata]
+name = udapi
+version = 0.2.3
+author = Martin Popel
+author_email = popel@ufal.mff.cuni.cz
+description = Python framework for processing Universal Dependencies data
+long_description = file: README.md
+long_description_content_type = text/markdown
+url = https://github.com/udapi/udapi-python
+classifiers =
+    Programming Language :: Python :: 3
+    License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
+    Operating System :: OS Independent
+
+[options]
+packages = find:
+python_requires = >=3.6
+include_package_data = True
+scripts =
+    bin/udapy
+install_requires =
+    colorama
+    termcolor
+
+[options.extras_require]
+test =
+    pytest
+
+
diff --git a/setup.py b/setup.py
index 804ebd59..7f1a1763 100644
--- a/setup.py
+++ b/setup.py
@@ -1,27 +1,4 @@
-#!/usr/bin/env python3
+from setuptools import setup
 
-from setuptools import setup, find_packages
-
-setup(
-    name='udapi',
-    version='0.2.3',
-    description='Python framework for processing Universal Dependencies data',
-    long_description=(
-      'Udapi is an open-source framework providing API for processing '
-      'Universal Dependencies data. It is available in Python, Perl and Java. '
-      'Udapi is suitable both for full-fledged applications and fast '
-      'prototyping: visualization of dependency trees, format conversions, '
-      'querying, editing and transformations, validity tests, dependency '
-      'parsing, evaluation etc.'
-    ),
-    author='Martin Popel',
-    author_email='popel@ufal.mff.cuni.cz',
-    url='https://github.com/udapi/udapi-python',
-    packages=find_packages(),
-    scripts=['bin/udapy'],
-    tests_require=['pytest'],
-    install_requires=['colorama', 'termcolor'],
-    python_requires='>=3.6',
-    license='GPL 2 or newer',
-    platforms='any',
-)
+if __name__ == "__main__":
+    setup()

From e737b0d773eddc88f033537d4c2f103dd7f0483a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 23 Feb 2021 13:58:22 +0100
Subject: [PATCH 0337/1374] draft of coref statistics

---
 udapi/block/corefud/stats.py | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 udapi/block/corefud/stats.py

diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
new file mode 100644
index 00000000..049e6e05
--- /dev/null
+++ b/udapi/block/corefud/stats.py
@@ -0,0 +1,33 @@
+from udapi.core.block import Block
+from collections import Counter
+import pprint
+
+class Stats(Block):
+    """Block corefud.Stats prints various coreference-related statistics."""
+
+    def __init__(self, m_len_max=5, **kwargs):
+        super().__init__(**kwargs)
+        self.m_len_max = m_len_max
+
+        self.counter = Counter()
+        self.mentions = 0
+        self.clusters = 0
+        self.nodes = 0
+        self.longest_mention = 0
+
+    def process_document(self, doc):
+        self.nodes += len(list(doc.nodes))
+        for cluster in doc.coref_clusters.values():
+            self.clusters += 1
+            for mention in cluster.mentions:
+                self.mentions += 1
+                words = len(mention.words)
+                self.longest_mention = max(words, self.longest_mention)
+                self.counter[f"m_len_{min(words, self.m_len_max)}"] += 1
+
+    def process_end(self):
+        #pprint.pprint(self.counter)
+        mentions_per1k = 1000 * self.mentions / self.nodes
+        percents = [100 * self.counter[f"m_len_{i}"]/self.mentions for i in range(self.m_len_max + 1)]
+        print(f"{self.mentions:6} & {mentions_per1k:6.0f} & {self.longest_mention:6} & "
+              + " & ".join(f"{p:3.0f}" for p in percents) + r" \\")

From 449be8f4bbe542dd7a058d68f8f0f45712bc237f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 23 Feb 2021 23:32:51 +0100
Subject: [PATCH 0338/1374] forgotten import

---
 udapi/core/coref.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index e5f3d3d5..3aed44e7 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -1,6 +1,7 @@
 """Classes for handling coreference."""
 import re
 import functools
+import logging
 
 @functools.total_ordering
 class CorefMention(object):

From a69ec13d9becefa7cffc8dbf4a2d3e1dc33db209 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 24 Feb 2021 01:07:47 +0100
Subject: [PATCH 0339/1374] improved coref stats

---
 udapi/block/corefud/stats.py | 37 ++++++++++++++++++++++++------------
 1 file changed, 25 insertions(+), 12 deletions(-)

diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
index 049e6e05..a85738b1 100644
--- a/udapi/block/corefud/stats.py
+++ b/udapi/block/corefud/stats.py
@@ -1,33 +1,46 @@
 from udapi.core.block import Block
 from collections import Counter
-import pprint
 
 class Stats(Block):
     """Block corefud.Stats prints various coreference-related statistics."""
 
-    def __init__(self, m_len_max=5, **kwargs):
+    def __init__(self, m_len_max=5, focus='non-singletons', **kwargs):
         super().__init__(**kwargs)
         self.m_len_max = m_len_max
+        self.focus = focus
 
         self.counter = Counter()
         self.mentions = 0
         self.clusters = 0
-        self.nodes = 0
+        self.total_nodes = 0
         self.longest_mention = 0
+        self.m_words = 0
+        self.m_empty = 0
 
     def process_document(self, doc):
-        self.nodes += len(list(doc.nodes))
+        self.total_nodes += len(list(doc.nodes))
         for cluster in doc.coref_clusters.values():
+            if len(cluster.mentions) == 1:
+                if self.focus == 'non-singletons':
+                    continue
+            elif self.focus == 'singletons':
+                continue
+
             self.clusters += 1
             for mention in cluster.mentions:
                 self.mentions += 1
-                words = len(mention.words)
-                self.longest_mention = max(words, self.longest_mention)
-                self.counter[f"m_len_{min(words, self.m_len_max)}"] += 1
+                all_words = len(mention.words)
+                non_empty = len([w for w in mention.words if not w.is_empty()])
+                self.m_words += all_words
+                self.m_empty += all_words - non_empty
+                self.longest_mention = max(non_empty, self.longest_mention)
+                self.counter[f"m_len_{min(non_empty, self.m_len_max)}"] += 1
 
     def process_end(self):
-        #pprint.pprint(self.counter)
-        mentions_per1k = 1000 * self.mentions / self.nodes
-        percents = [100 * self.counter[f"m_len_{i}"]/self.mentions for i in range(self.m_len_max + 1)]
-        print(f"{self.mentions:6} & {mentions_per1k:6.0f} & {self.longest_mention:6} & "
-              + " & ".join(f"{p:3.0f}" for p in percents) + r" \\")
+        mentions = 1 if self.mentions == 0 else self.mentions
+        total_nodes = 1 if self.total_nodes == 0 else self.total_nodes
+        mentions_per1k = 1000 * self.mentions / total_nodes
+
+        percents = [100 * self.counter[f"m_len_{i}"] / mentions for i in range(self.m_len_max + 1)]
+        print(f"{self.mentions:7,} & {mentions_per1k:6.0f} & {self.longest_mention:6} & "
+              + " & ".join(f"{p:5.1f}" for p in percents) + r" \\")

From 7e3887eaf1cfae8ec0cd8c9796add34c38974e35 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 24 Feb 2021 01:52:25 +0100
Subject: [PATCH 0340/1374] coref cluster stats

---
 udapi/block/corefud/stats.py | 28 ++++++++++++++++++++--------
 1 file changed, 20 insertions(+), 8 deletions(-)

diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
index a85738b1..0d791969 100644
--- a/udapi/block/corefud/stats.py
+++ b/udapi/block/corefud/stats.py
@@ -4,9 +4,10 @@
 class Stats(Block):
     """Block corefud.Stats prints various coreference-related statistics."""
 
-    def __init__(self, m_len_max=5, focus='non-singletons', **kwargs):
+    def __init__(self, m_len_max=5, c_len_max=5, focus='non-singletons', **kwargs):
         super().__init__(**kwargs)
         self.m_len_max = m_len_max
+        self.c_len_max = c_len_max
         self.focus = focus
 
         self.counter = Counter()
@@ -14,16 +15,20 @@ def __init__(self, m_len_max=5, focus='non-singletons', **kwargs):
         self.clusters = 0
         self.total_nodes = 0
         self.longest_mention = 0
+        self.longest_cluster = 0
         self.m_words = 0
         self.m_empty = 0
 
     def process_document(self, doc):
         self.total_nodes += len(list(doc.nodes))
         for cluster in doc.coref_clusters.values():
-            if len(cluster.mentions) == 1:
-                if self.focus == 'non-singletons':
+            len_mentions = len(cluster.mentions)
+            self.longest_cluster = max(len_mentions, self.longest_cluster)
+            self.counter[f"c_len_{min(len_mentions, self.c_len_max)}"] += 1
+            if len_mentions == 1:
+                if self.focus.startswith('non-singletons'):
                     continue
-            elif self.focus == 'singletons':
+            elif self.focus.startswith('singletons'):
                 continue
 
             self.clusters += 1
@@ -38,9 +43,16 @@ def process_document(self, doc):
 
     def process_end(self):
         mentions = 1 if self.mentions == 0 else self.mentions
+        clusters = 1 if self.clusters == 0 else self.clusters
         total_nodes = 1 if self.total_nodes == 0 else self.total_nodes
-        mentions_per1k = 1000 * self.mentions / total_nodes
 
-        percents = [100 * self.counter[f"m_len_{i}"] / mentions for i in range(self.m_len_max + 1)]
-        print(f"{self.mentions:7,} & {mentions_per1k:6.0f} & {self.longest_mention:6} & "
-              + " & ".join(f"{p:5.1f}" for p in percents) + r" \\")
+        if 'clusters' in self.focus:
+            clusters_per1k = 1000 * self.clusters / total_nodes
+            percents = [100 * self.counter[f"c_len_{i}"] / clusters for i in range(1, self.c_len_max + 1)]
+            print(f"{self.clusters:7,} & {clusters_per1k:6.0f} & {self.longest_cluster:6} & "
+                + " & ".join(f"{p:5.1f}" for p in percents) + r" \\")
+        if self.focus != 'clusters':
+            mentions_per1k = 1000 * self.mentions / total_nodes
+            percents = [100 * self.counter[f"m_len_{i}"] / mentions for i in range(self.m_len_max + 1)]
+            print(f"{self.mentions:7,} & {mentions_per1k:6.0f} & {self.longest_mention:6} & "
+                + " & ".join(f"{p:5.1f}" for p in percents) + r" \\")

From 9161cbdec054700d6cfbb28664df720038b03363 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 24 Feb 2021 15:58:45 +0100
Subject: [PATCH 0341/1374] redesign corefud.Stats

---
 udapi/block/corefud/stats.py | 59 +++++++++++++++++++++++-------------
 1 file changed, 38 insertions(+), 21 deletions(-)

diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
index 0d791969..586c0236 100644
--- a/udapi/block/corefud/stats.py
+++ b/udapi/block/corefud/stats.py
@@ -4,11 +4,18 @@
 class Stats(Block):
     """Block corefud.Stats prints various coreference-related statistics."""
 
-    def __init__(self, m_len_max=5, c_len_max=5, focus='non-singletons', **kwargs):
+    def __init__(self, m_len_max=5, c_len_max=5, report_mentions=True, report_clusters=True,
+                 exclude_singletons=False, exclude_nonsingletons=False, style='human', **kwargs):
         super().__init__(**kwargs)
         self.m_len_max = m_len_max
         self.c_len_max = c_len_max
-        self.focus = focus
+        self.report_mentions = report_mentions
+        self.report_clusters = report_clusters
+        self.exclude_singletons = exclude_singletons
+        self.exclude_nonsingletons = exclude_nonsingletons
+        self.style = style
+        if style not in 'tex human'.split():
+            raise ValueError(f'Unknown style f{style}')
 
         self.counter = Counter()
         self.mentions = 0
@@ -23,13 +30,12 @@ def process_document(self, doc):
         self.total_nodes += len(list(doc.nodes))
         for cluster in doc.coref_clusters.values():
             len_mentions = len(cluster.mentions)
+            if len_mentions == 1 and self.exclude_singletons:
+                continue
+            elif len_mentions > 1 and self.exclude_nonsingletons:
+                continue
             self.longest_cluster = max(len_mentions, self.longest_cluster)
             self.counter[f"c_len_{min(len_mentions, self.c_len_max)}"] += 1
-            if len_mentions == 1:
-                if self.focus.startswith('non-singletons'):
-                    continue
-            elif self.focus.startswith('singletons'):
-                continue
 
             self.clusters += 1
             for mention in cluster.mentions:
@@ -42,17 +48,28 @@ def process_document(self, doc):
                 self.counter[f"m_len_{min(non_empty, self.m_len_max)}"] += 1
 
     def process_end(self):
-        mentions = 1 if self.mentions == 0 else self.mentions
-        clusters = 1 if self.clusters == 0 else self.clusters
-        total_nodes = 1 if self.total_nodes == 0 else self.total_nodes
-
-        if 'clusters' in self.focus:
-            clusters_per1k = 1000 * self.clusters / total_nodes
-            percents = [100 * self.counter[f"c_len_{i}"] / clusters for i in range(1, self.c_len_max + 1)]
-            print(f"{self.clusters:7,} & {clusters_per1k:6.0f} & {self.longest_cluster:6} & "
-                + " & ".join(f"{p:5.1f}" for p in percents) + r" \\")
-        if self.focus != 'clusters':
-            mentions_per1k = 1000 * self.mentions / total_nodes
-            percents = [100 * self.counter[f"m_len_{i}"] / mentions for i in range(self.m_len_max + 1)]
-            print(f"{self.mentions:7,} & {mentions_per1k:6.0f} & {self.longest_mention:6} & "
-                + " & ".join(f"{p:5.1f}" for p in percents) + r" \\")
+        mentions_nonzero = 1 if self.mentions == 0 else self.mentions
+        clusters_nonzero = 1 if self.clusters == 0 else self.clusters
+        total_nodes_nonzero = 1 if self.total_nodes == 0 else self.total_nodes
+
+        columns =[ ]
+        if self.report_clusters:
+            columns += [('clusters', f"{self.clusters:7,}"),
+                        ('clusters_per1k', f"{1000 * self.clusters / total_nodes_nonzero:6.0f}"),
+                        ('longest_cluster', f"{self.longest_cluster:6}")]
+            for i in range(1, self.c_len_max + 1):
+                percent = 100 * self.counter[f"c_len_{i}"] / clusters_nonzero
+                columns.append((f"c_len_{i}{'' if i < self.c_len_max else '+'}", f"{percent:5.1f}"))
+        if self.report_mentions:
+            columns += [('mentions', f"{self.mentions:7,}"),
+                        ('mentions_per1k', f"{1000 * self.mentions / total_nodes_nonzero:6.0f}"),
+                        ('longest_mention', f"{self.longest_mention:6}")]
+            for i in range(0, self.m_len_max + 1):
+                percent = 100 * self.counter[f"m_len_{i}"] / mentions_nonzero
+                columns.append((f"m_len_{i}{'' if i < self.m_len_max else '+'}", f"{percent:5.1f}"))
+
+        if self.style == 'tex':
+            print(" & ".join(c[1] for c in columns))
+        elif self.style == 'human':
+            for c in columns:
+                print(f"{c[0]:>15} = {c[1].strip():>10}")

From f0252f7d4e67dfe4a9f5e236f66000ff33a3b6ae Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Wed, 24 Feb 2021 02:33:51 +0100
Subject: [PATCH 0342/1374] Improvements in Simple segmenter

1. deal with multiple consecutive spaces in input sentences or the space at the start/end of the sentence
    => no sentence boundary
2. if an abbreviation of the first name is a first word of a quoted segment, delete the starting quotation mark to find out if the word consists of two chars
---
 udapi/block/segment/simple.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/udapi/block/segment/simple.py b/udapi/block/segment/simple.py
index b4f2bbe4..8e4c38f9 100644
--- a/udapi/block/segment/simple.py
+++ b/udapi/block/segment/simple.py
@@ -16,6 +16,8 @@ def is_nonfinal_abbrev(token):
 
     def is_boundary(self, first, second):
         """Is there a sentence boundary between the first and second token?"""
+        if not first or not second:
+            return False
         if first[-1] in '"“»›)':
             first = first[:-1]
         if second[0] in '"„«¿¡‹(':
@@ -25,6 +27,9 @@ def is_boundary(self, first, second):
         if not first[-1] in '.!?':
             return False
         if first[-1] == '.':
+            # correctly count length in "„A. Merkel"
+            if first[0] in '"„«¿¡‹(':
+                first = first[1:]
             if len(first) == 2 and first[0].isupper():
                 return False
             if self.is_nonfinal_abbrev(first[:-1]):
@@ -39,6 +44,7 @@ def segment_string(self, string):
         segments = [previous]
         for token in tokens[1:]:
             if self.is_boundary(previous, token):
+                segments[-1] += ' '
                 segments.append(token)
             else:
                 segments[-1] += ' ' + token
@@ -64,4 +70,4 @@ def process_document(self, doc):
                             new_bundle = Bundle(document=doc, bundle_id=orig_bundle_id + '-' + str(i))
                             new_bundle.create_tree(tree.zone).text = sentence
                             new_bundles.append(new_bundle)
-        doc.bundles = new_bundles
\ No newline at end of file
+        doc.bundles = new_bundles

From 7cb814e7ded1418a6f82d1d299052322e8ddfdf7 Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Thu, 25 Feb 2021 16:58:59 +0100
Subject: [PATCH 0343/1374] added the keep_spaces parameter + doc extended

---
 udapi/block/segment/simple.py | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/udapi/block/segment/simple.py b/udapi/block/segment/simple.py
index 8e4c38f9..5f4a8423 100644
--- a/udapi/block/segment/simple.py
+++ b/udapi/block/segment/simple.py
@@ -4,7 +4,20 @@
 import re
 
 class Simple(Block):
-    """"Heuristic segmenter, splits on sentence-final segmentation followed by uppercase."""
+    """"Heuristic segmenter, splits on sentence-final segmentation followed by uppercase.
+        The exceptions are:
+            1) abbreviations of names, e.g. "A. Merkel"
+            2) predefined list of nonfinal abbreviations, e.g. "e.g."
+
+        Parameters
+        ----------
+        keep_spaces : bool
+            do not strip whitespaces from the `text` attribute of the sentences created by segmentation
+    """
+    
+    def __init__(self, keep_spaces=False, **kwargs):
+        super().__init__(**kwargs)
+        self.keep_spaces = keep_spaces
 
     @staticmethod
     def is_nonfinal_abbrev(token):
@@ -44,7 +57,8 @@ def segment_string(self, string):
         segments = [previous]
         for token in tokens[1:]:
             if self.is_boundary(previous, token):
-                segments[-1] += ' '
+                if self.keep_spaces:
+                    segments[-1] += ' '
                 segments.append(token)
             else:
                 segments[-1] += ' ' + token

From cc43b199140378759f3d9d69661bf6f26af562f5 Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Thu, 25 Feb 2021 11:48:59 +0100
Subject: [PATCH 0344/1374] preventing the text attribute from being invalid

* removing \r and \n from anywhere in the text attribute
* stripping all whitespace from the end of the text attribute
---
 udapi/block/write/conllu.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index 429c2f42..d8ca1001 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -2,6 +2,7 @@
 import json
 from udapi.core.basewriter import BaseWriter
 
+escape_whitespace_table = str.maketrans({'\r':'', '\n':''})
 
 class Conllu(BaseWriter):
     """A writer of files in the CoNLL-U format."""
@@ -32,7 +33,7 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
             print('# sent_id = ' + tree.sent_id)
 
         if self.print_text:
-            print('# text = ' + (tree.text or tree.compute_text()))
+            print('# text = ' + (tree.compute_text() if tree.text is None else tree.text.translate(escape_whitespace_table).rstrip()))
 
         if tree.json:
             for key, value in sorted(tree.json.items()):

From 26105f8d8d371437a85307d230c54c687ace354e Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Thu, 25 Feb 2021 12:52:06 +0100
Subject: [PATCH 0345/1374] faster

---
 udapi/block/write/conllu.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index d8ca1001..df3adce6 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -2,8 +2,6 @@
 import json
 from udapi.core.basewriter import BaseWriter
 
-escape_whitespace_table = str.maketrans({'\r':'', '\n':''})
-
 class Conllu(BaseWriter):
     """A writer of files in the CoNLL-U format."""
 
@@ -33,7 +31,7 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
             print('# sent_id = ' + tree.sent_id)
 
         if self.print_text:
-            print('# text = ' + (tree.compute_text() if tree.text is None else tree.text.translate(escape_whitespace_table).rstrip()))
+            print('# text = ' + (tree.compute_text() if tree.text is None else tree.text.replace('\n', '').replace('\r', '').rstrip()))
 
         if tree.json:
             for key, value in sorted(tree.json.items()):

From 0c7918c70018033351ec220ccde9fbc49859957e Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Thu, 25 Feb 2021 16:11:27 +0100
Subject: [PATCH 0346/1374] warning for using read.Sentences rstrip=''

---
 udapi/block/read/sentences.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/read/sentences.py b/udapi/block/read/sentences.py
index 758b4980..356e196f 100644
--- a/udapi/block/read/sentences.py
+++ b/udapi/block/read/sentences.py
@@ -12,7 +12,9 @@ class Sentences(BaseReader):
     rstrip: a set of characters to be stripped from the end of each line.
         Default='\r\n '. You can use rstrip='\n' if you want to preserve
         any space or '\r' (Carriage Return) at end of line,
-        so that `udpipe.Base resegment=1` keeps these characters in `SpacesAfter`.
+        so that `udpipe.Base` keeps these characters in `SpacesAfter`.
+        As most blocks do not expect whitespace other than a space to appear
+        in the processed text, using this feature is at your own risk.
     """
     def __init__(self, ignore_empty_lines=False, rstrip='\r\n ', **kwargs):
         self.ignore_empty_lines = ignore_empty_lines

From 6868f58ab7773b1c5fb3815bdfed0af39b3ffab5 Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Thu, 25 Feb 2021 16:12:51 +0100
Subject: [PATCH 0347/1374] normalize_spaces=False -> keep_spaces=True

---
 udapi/block/tokenize/onwhitespace.py | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/udapi/block/tokenize/onwhitespace.py b/udapi/block/tokenize/onwhitespace.py
index b25005a9..6ca412a8 100644
--- a/udapi/block/tokenize/onwhitespace.py
+++ b/udapi/block/tokenize/onwhitespace.py
@@ -6,16 +6,16 @@
 class OnWhitespace(Block):
     """Base tokenizer, splits on whitespaces, fills SpaceAfter=No.
 
-    Use the parameter `normalize_spaces=False` to preserve all whitespaces in the sentence
+    Use the parameter `keep_spaces=True` to preserve all whitespaces in the sentence
     in the UDPipe way, i.e. using the `SpacesAfter` and `SpacesBefore` features in the MISC field.
     It is backward compatible with CoNLL-U v2 `SpaceAfter=No` feature. That is, no following
     whitespace is marked by `SpaceAfter=No` and a single following space results in no
     whitespace-related markup.
     If loading the text using `read.Sentences` and all whitespaces need to be preserved
     (in order to be able to reconstruct the original document), the `read.Sentences` block
-    must be called with `rstrip=\n` or `rstrip=\r\n` to prevent stripping the trailing
-    whitespace, e.g.::
-        $> echo -e "Hello \t world " | udapy read.Sentences $'rstrip=\r\n' tokenize.OnWhitespace normalize_spaces=0 write.Conllu
+    must be called with `rstrip=''`, `rstrip=\n` or `rstrip=\r\n` to prevent stripping the
+    trailing whitespace, e.g.::
+        $> echo -e "Hello \t world " | udapy read.Sentences $'rstrip=\r\n' tokenize.OnWhitespace keep_spaces=1 write.Conllu
 
         # sent_id = 1
         # text = Hello   world
@@ -26,15 +26,15 @@ class OnWhitespace(Block):
 
     Parameters
     ----------
-    normalize_spaces : bool
-        preserve whitespaces by filling MISC attributes `SpacesAfter` and `SpacesBefore` (by default True)
+    keep_spaces : bool
+        preserve whitespaces by filling MISC attributes `SpacesAfter` and `SpacesBefore` (by default False)
     """
 
     escape_whitespace_table = str.maketrans({' ':r'\s', '\t':r'\t', '\r':r'\r', '\n':r'\n'})
 
-    def __init__(self, normalize_spaces=True, **kwargs):
+    def __init__(self, keep_spaces=True, **kwargs):
         super().__init__(**kwargs)
-        self.normalize_spaces = normalize_spaces
+        self.keep_spaces = keep_spaces
 
     @staticmethod
     def tokenize_sentence(string):
@@ -80,7 +80,7 @@ def process_tree(self, root):
                 sentence = sentence[len(spaces_after):]
 
             # normalize whitespace
-            if self.normalize_spaces:
+            if not self.keep_spaces:
                 spaces_before = ""
                 # spaces_after = "" <=> SpaceAfter=No is never set for the last token <=> len(sentence) = 0
                 spaces_after = "" if not len(spaces_after) and len(sentence) else " "

From e2fe7e03eb0dc809a77010be58f10e42c1ce881e Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Thu, 25 Feb 2021 18:47:03 +0100
Subject: [PATCH 0348/1374] bugfix

---
 udapi/block/tokenize/onwhitespace.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/tokenize/onwhitespace.py b/udapi/block/tokenize/onwhitespace.py
index 6ca412a8..913dae61 100644
--- a/udapi/block/tokenize/onwhitespace.py
+++ b/udapi/block/tokenize/onwhitespace.py
@@ -32,7 +32,7 @@ class OnWhitespace(Block):
 
     escape_whitespace_table = str.maketrans({' ':r'\s', '\t':r'\t', '\r':r'\r', '\n':r'\n'})
 
-    def __init__(self, keep_spaces=True, **kwargs):
+    def __init__(self, keep_spaces=False, **kwargs):
         super().__init__(**kwargs)
         self.keep_spaces = keep_spaces
 

From e8e3824b20b96927b1ca0d4272b0afc330a97c23 Mon Sep 17 00:00:00 2001
From: Zdenek Zabokrtsky <zabokrtsky@ufal.mff.cuni.cz>
Date: Fri, 26 Feb 2021 22:03:21 +0100
Subject: [PATCH 0349/1374] a block for generating latex-formatted statistic of
 distributions of values of misc attributes

---
 udapi/block/corefud/miscstats.py    |  7 +++--
 udapi/block/corefud/miscstatstex.py | 44 +++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+), 2 deletions(-)
 create mode 100644 udapi/block/corefud/miscstatstex.py

diff --git a/udapi/block/corefud/miscstats.py b/udapi/block/corefud/miscstats.py
index e7aabc03..dee358d6 100644
--- a/udapi/block/corefud/miscstats.py
+++ b/udapi/block/corefud/miscstats.py
@@ -17,6 +17,7 @@ def __init__(self, maxvalues=10, **kwargs):
         super().__init__(**kwargs)
         self.maxvalues = maxvalues
         self.valuecounter = {}
+        self.totalcounter = Counter()
 
     def process_node(self,node):
         for attrname in node.misc:
@@ -24,9 +25,11 @@ def process_node(self,node):
             if not shortattrname in self.valuecounter:
                 self.valuecounter[shortattrname] = Counter()
             self.valuecounter[shortattrname][node.misc[attrname]] += 1
+            self.totalcounter[shortattrname] += 1
 
     def process_end(self):
         for attrname in self.valuecounter:
-            print("MISC attribute: "+attrname)
+            print()
+            print(attrname+"\t"+str(self.totalcounter[attrname]))
             for value,freq in self.valuecounter[attrname].most_common(self.maxvalues):
-                print("    "+str(value)+"   "+str(freq))
+                print("\t"+str(value)+"\t"+str(freq))
diff --git a/udapi/block/corefud/miscstatstex.py b/udapi/block/corefud/miscstatstex.py
new file mode 100644
index 00000000..25d3751a
--- /dev/null
+++ b/udapi/block/corefud/miscstatstex.py
@@ -0,0 +1,44 @@
+from udapi.core.block import Block
+from collections import Counter
+import re
+
+class MiscStatsTex(Block):
+    """Block corefud.MiscStats prints 10 most frequent values of each attribute stored in the MISC field"""
+
+    def __init__(self, maxvalues=10, **kwargs):
+        
+        """Create the corefud.MiscStats
+
+        Args:
+        maxvalues: the number of most frequent values
+                   to be printed for each attribute.
+
+        """
+        super().__init__(**kwargs)
+        self.maxvalues = maxvalues
+        self.valuecounter = {}
+        self.totalcounter = Counter()
+
+    def process_node(self,node):
+        for attrname in node.misc:
+            shortattrname = re.sub(r'\[\d+\]',r'',attrname)
+            if not shortattrname in self.valuecounter:
+                self.valuecounter[shortattrname] = Counter()
+            self.valuecounter[shortattrname][node.misc[attrname]] += 1
+            self.totalcounter[shortattrname] += 1
+
+    def process_end(self):
+        for attrname in self.valuecounter:
+
+            total = self.totalcounter[attrname]
+            distrvalues = []
+            
+            for value,freq in self.valuecounter[attrname].most_common(self.maxvalues):
+                value = re.sub(r'_',r'\\_',value)
+                distrvalues.append(f'\\attr{{{str(value)}}} {100*freq/total:2.1f}~\\%')
+
+            attrname = re.sub(r'_',r'\\_',attrname)
+            print(f" \\item attribute \\attr{{{attrname}}}, {total:,} occurrences, values: "+", ".join(distrvalues))     
+#            print(f" \\item attribute \\attr\{{attrname}\}, {str(total)} occurrences, distribution of values: "+", ".join(distrvalues))
+
+                

From 95b7d1e4dee939bb67744098ec6e5e3377e62bd0 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 27 Feb 2021 14:48:59 +0100
Subject: [PATCH 0350/1374] overload Node.__repr__, so that f"{list_of_nodes}"
 works as expected

---
 udapi/core/node.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 2640ab91..c49f8128 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -105,8 +105,13 @@ def __init__(self, root, form=None, lemma=None, upos=None,  # pylint: disable=to
         self._mentions = list()
 
     def __str__(self):
-        """Pretty print of the Node object."""
-        return "node<%s, %s>" % (self.address(), self.form)
+        """String representation of the Node object: <n.address(), n.form>."""
+        return f"<{self.address()}, {self.form}>"
+
+    def __repr__(self):
+        """String representation of the Node object: Node<n.address(), n.form>."""
+        return f"Node<{self.address()}, {self.form}>"
+
 
     @property
     def root(self):

From 8e3b614709f18424a8cb8b00cc98645b277d895a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 27 Feb 2021 14:50:36 +0100
Subject: [PATCH 0351/1374] allow loading conllu files, where MentionSpan is
 not sorted

---
 udapi/core/coref.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 3aed44e7..be8f6883 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -69,7 +69,7 @@ def words(self):
     @words.setter
     def words(self, new_words):
         if new_words and self.head not in new_words:
-            raise ValueError(f"Head {self.head} not in new_words")
+            raise ValueError(f"Head {self.head} not in new_words {new_words}")
         kept_words = []
         for old_word in self._words:
             if old_word in new_words:
@@ -250,6 +250,7 @@ def span_to_nodes(root, span):
         except ValueError as e:
             raise ValueError(f"Cannot parse '{span}': {e}")
         ranges.append((lo, hi))
+    ranges.sort()
 
     def _num_in_ranges(num):
         for (lo, hi) in ranges:

From c627846c40fc8f99cf68cb91662bd7b512b6dfd2 Mon Sep 17 00:00:00 2001
From: Zdenek Zabokrtsky <zabokrtsky@ufal.mff.cuni.cz>
Date: Sat, 27 Feb 2021 23:56:55 +0100
Subject: [PATCH 0352/1374] a block for concatenating all MISC attributes named
 MentionMisc_... into a single value of MentionMisc

---
 udapi/block/corefud/concatmentionmisc.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 udapi/block/corefud/concatmentionmisc.py

diff --git a/udapi/block/corefud/concatmentionmisc.py b/udapi/block/corefud/concatmentionmisc.py
new file mode 100644
index 00000000..28be34cf
--- /dev/null
+++ b/udapi/block/corefud/concatmentionmisc.py
@@ -0,0 +1,23 @@
+from udapi.core.block import Block
+from collections import Counter
+import re
+
+class ConcatMentionMisc(Block):
+    """All MISC attributes named MentionMisc_... are concatenated into MentionMisc"""
+
+    def process_node(self,node):
+        for attrname in list(node.misc):
+            matchObj = re.match('MentionMisc_([^[]+)((\[\d+\])?)',attrname)
+            if matchObj:
+                innerattrib = matchObj.group(1)
+                index = matchObj.group(2)
+
+                finalattr = 'MentionMisc'+index
+                value = node.misc[attrname]
+                
+                if finalattr not in node.misc:
+                    node.misc[finalattr] = f'{innerattrib}:{value}'
+                else:
+                    node.misc[finalattr] += f' {innerattrib}:{value}'
+                del node.misc[attrname]
+

From 84320e8299b8efabcd58af110d59ecc5509caf07 Mon Sep 17 00:00:00 2001
From: Zdenek Zabokrtsky <zabokrtsky@ufal.mff.cuni.cz>
Date: Sun, 28 Feb 2021 00:14:33 +0100
Subject: [PATCH 0353/1374] including empty nodes in corefud blocks

---
 udapi/block/corefud/concatmentionmisc.py | 27 ++++++++++++------------
 udapi/block/corefud/removemisc.py        | 11 +++++-----
 2 files changed, 20 insertions(+), 18 deletions(-)

diff --git a/udapi/block/corefud/concatmentionmisc.py b/udapi/block/corefud/concatmentionmisc.py
index 28be34cf..aeb945a8 100644
--- a/udapi/block/corefud/concatmentionmisc.py
+++ b/udapi/block/corefud/concatmentionmisc.py
@@ -5,19 +5,20 @@
 class ConcatMentionMisc(Block):
     """All MISC attributes named MentionMisc_... are concatenated into MentionMisc"""
 
-    def process_node(self,node):
-        for attrname in list(node.misc):
-            matchObj = re.match('MentionMisc_([^[]+)((\[\d+\])?)',attrname)
-            if matchObj:
-                innerattrib = matchObj.group(1)
-                index = matchObj.group(2)
+    def process_tree(self,root):
+        for node in root.descendants_and_empty:
+            for attrname in list(node.misc):
+                matchObj = re.match('MentionMisc_([^[]+)((\[\d+\])?)',attrname)
+                if matchObj:
+                    innerattrib = matchObj.group(1)
+                    index = matchObj.group(2)
 
-                finalattr = 'MentionMisc'+index
-                value = node.misc[attrname]
+                    finalattr = 'MentionMisc'+index
+                    value = node.misc[attrname]
                 
-                if finalattr not in node.misc:
-                    node.misc[finalattr] = f'{innerattrib}:{value}'
-                else:
-                    node.misc[finalattr] += f' {innerattrib}:{value}'
-                del node.misc[attrname]
+                    if finalattr not in node.misc:
+                        node.misc[finalattr] = f'{innerattrib}:{value}'
+                    else:
+                        node.misc[finalattr] += f' {innerattrib}:{value}'
+                    del node.misc[attrname]
 
diff --git a/udapi/block/corefud/removemisc.py b/udapi/block/corefud/removemisc.py
index 6ca1e87a..f132aaed 100644
--- a/udapi/block/corefud/removemisc.py
+++ b/udapi/block/corefud/removemisc.py
@@ -9,9 +9,10 @@ def __init__(self, attrnames='', **kwargs):
         super().__init__(**kwargs)
         self.attrs4deletion = set(attrnames.split(','))
     
-    def process_node(self,node):
-        for attrname in list(node.misc):
-            shortattrname = re.sub(r'\[\d+\]',r'',attrname)
-            if shortattrname in self.attrs4deletion:
-                del node.misc[attrname]
+    def process_tree(self,root):
+        for node in root.descendants_and_empty:
+            for attrname in list(node.misc):
+                shortattrname = re.sub(r'\[\d+\]',r'',attrname)
+                if shortattrname in self.attrs4deletion:
+                    del node.misc[attrname]
 

From a66a530eb07c38d38a4c98a6f0b14ea62dbf6d06 Mon Sep 17 00:00:00 2001
From: Zdenek Zabokrtsky <zabokrtsky@ufal.mff.cuni.cz>
Date: Sun, 28 Feb 2021 00:30:44 +0100
Subject: [PATCH 0354/1374] forgotten commit

---
 udapi/block/corefud/bridgingclusters.py | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 udapi/block/corefud/bridgingclusters.py

diff --git a/udapi/block/corefud/bridgingclusters.py b/udapi/block/corefud/bridgingclusters.py
new file mode 100644
index 00000000..30ac49a7
--- /dev/null
+++ b/udapi/block/corefud/bridgingclusters.py
@@ -0,0 +1,17 @@
+from udapi.core.block import Block
+from collections import Counter
+import re
+
+class BridgingClusters(Block):
+
+    def process_node(self,node):
+
+        if 'Bridging' in node.misc and "+" in node.misc['BridgingAllTargetClusterTexts']:
+            print("SENTENCE      : "+node.root.get_sentence())
+            print("SOURCE MENTION: "+node.misc['MentionText'])
+            print("RELATION:       "+node.misc['Bridging'])
+            print("TARGET MENTION: "+node.misc['BridgingTargetMentionText'])
+            print("TARGET CLUSTER: "+node.misc['BridgingAllTargetClusterTexts'])
+            print()
+
+

From 8ea1e4c76f230fba0282f5dcc071d46608b70e16 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 26 Feb 2021 00:15:54 +0100
Subject: [PATCH 0355/1374] If MentionSpan is not provided, suppose only the
 head is in the span

Otherwise, the mention is not reachable via `head.coref_mentions`
and `len(mention.words) == 0`, which is both misleading.
---
 udapi/core/coref.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index be8f6883..1e2df00b 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -194,6 +194,8 @@ def load_coref_from_misc(doc):
             mention = CorefMention(node, cluster)
             if node.misc["MentionSpan" + index_str]:
                 mention.span = node.misc["MentionSpan" + index_str]
+            else:
+                mentions.words = [node]
             cluster_type = node.misc["ClusterType" + index_str]
             if cluster_type is not None:
                 if cluster.cluster_type is not None and cluster_type != cluster.cluster_type:

From ba53c9a8dfea2ce565624ceb4f3d294075e50412 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 26 Feb 2021 00:26:31 +0100
Subject: [PATCH 0356/1374] MentionMisc

---
 udapi/core/coref.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 1e2df00b..793dd4d0 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -6,7 +6,7 @@
 @functools.total_ordering
 class CorefMention(object):
     """Class for representing a mention (instance of an entity)."""
-    __slots__ = ['_head', '_cluster', '_bridging', '_words']
+    __slots__ = ['_head', '_cluster', '_bridging', '_words', 'misc']
 
     def __init__(self, head, cluster=None):
         self._head = head
@@ -15,6 +15,7 @@ def __init__(self, head, cluster=None):
             cluster._mentions.append(self)
         self._bridging = None
         self._words = []
+        self.misc = None
 
     def __lt__(self, other):
         """Does this mention precedes (word-order wise) the `other` mention?
@@ -195,7 +196,7 @@ def load_coref_from_misc(doc):
             if node.misc["MentionSpan" + index_str]:
                 mention.span = node.misc["MentionSpan" + index_str]
             else:
-                mentions.words = [node]
+                mention.words = [node]
             cluster_type = node.misc["ClusterType" + index_str]
             if cluster_type is not None:
                 if cluster.cluster_type is not None and cluster_type != cluster.cluster_type:
@@ -204,6 +205,7 @@ def load_coref_from_misc(doc):
             # TODO deserialize Bridging and SplitAnte
             mention._bridging = node.misc["Bridging" + index_str]
             cluster._split_ante = node.misc["SplitAnte" + index_str]
+            mention.misc = node.misc["MentionMisc" + index_str]
             index += 1
             index_str = f"[{index}]"
             cluster_id = node.misc["ClusterId" + index_str]
@@ -239,6 +241,8 @@ def store_coref_to_misc(doc):
             head.misc["ClusterType" + index_str] = cluster.cluster_type
             head.misc["Bridging" + index_str] = mention.bridging
             head.misc["SplitAnte" + index_str] = cluster.split_ante
+            if mention.misc:
+                head.misc["MentionMisc" + index_str] = mention.misc
 
 
 def span_to_nodes(root, span):

From 15aa680241e033b824cafe5a24a7a2d737bfdceb Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 26 Feb 2021 18:43:18 +0100
Subject: [PATCH 0357/1374] support for Bridging

---
 udapi/core/coref.py | 84 ++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 80 insertions(+), 4 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 793dd4d0..46d42e95 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -1,6 +1,7 @@
 """Classes for handling coreference."""
 import re
 import functools
+import collections
 import logging
 
 @functools.total_ordering
@@ -59,6 +60,9 @@ def cluster(self, new_cluster):
 
     @property
     def bridging(self):
+        if self._bridging:
+            return self._bridging
+        self._bridging = BridgingLinks(self)
         return self._bridging
 
     # TODO add/edit bridging
@@ -156,7 +160,7 @@ def split_ante(self):
 
     # TODO add/edit split_ante
 
-    # TODO adapt depending on how mention.bridging is implemented (callable list subclass)
+    # TODO or should we create a BridgingLinks instance with a fake src_mention?
     def all_bridging(self):
         for m in self._mentions:
             if m._bridging:
@@ -164,6 +168,75 @@ def all_bridging(self):
                     yield b
 
 
+BridgingLink = collections.namedtuple('BridgingLink', 'target relation')
+
+
+class BridgingLinks(collections.abc.MutableSequence):
+    """BridgingLinks class serves as a list of BridgingLinks tuples with additional methods.
+
+    Example usage:
+    >>> bl = BridgingLinks(src_mention)                                   # empty links
+    >>> bl = BridgingLinks(src_mention, [(c12, 'Part'), (c56, 'Subset')]) # from a list of tuples
+    >>> bl = BridgingLinks(src_mention, 'c12:Part,c56:Subset')            # from a string
+    >>> for cluster, relation in bl:
+    >>>     print(f"{bl.src_mention} ->{relation}-> {cluster.cluster_id}")
+    >>> print(str(bl)) # c12:Part,c56:Subset
+    >>> bl('Part').targets == [c12]
+    >>> bl('Part|Subset').targets == [c12, c56]
+    >>> bl.append((c89, 'Funct'))
+    """
+    def __init__(self, src_mention, value=None):
+        self.src_mention = src_mention
+        self._data = []
+        if value is not None:
+            if isinstance(value, str):
+                self._from_string(string)
+            elif isinstance(value, collections.abc.Sequence):
+                for v in value:
+                    self._data.append(BridgingLink(v[0], v[1]))
+        super().__init__()
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+    def __len__(self):
+        return len(self._data)
+
+    # TODO delete backlinks of old links
+    def __setitem__(self, key, new_value):
+        self._data[key] = BridgingLink(new_value[0], new_value[1])
+
+    def __delitem__(self, key):
+        del self._data[key]
+
+    def insert(self, key, new_value):
+        self._data.insert(key, BridgingLink(new_value[0], new_value[1]))
+
+    def __str__(self):
+        return ','.join(f'{l.target._cluster_id}:{l.relation}' for l in self)
+
+    def _from_string(self, string):
+        self._data.clear()
+        clusters = self.src_mention.head.root.coref_clusters
+        for link_str in string.split(','):
+            target, relation = link_str.split(':')
+            self._data.append(BridgingLink(clusters[target], relation))
+
+    def __call__(self, relations_re=None):
+        """Return a subset of links contained in this list as specified by the args.
+        Args:
+        relations: only links with a relation matching this regular expression will be returned
+        """
+        if relations_re is None:
+            return self
+        return Links(self.src_mention, [l for l in self._data if re.match(relations_re, l.relation)])
+
+    @property
+    def targets(self):
+        """Return a list of the target clusters (without relations)."""
+        return [link.target for link in self._data]
+
+
 def create_coref_cluster(head, cluster_id=None, cluster_type=None, **kwargs):
     clusters = head.root.bundle.document.coref_clusters
     if not cluster_id:
@@ -202,8 +275,10 @@ def load_coref_from_misc(doc):
                 if cluster.cluster_type is not None and cluster_type != cluster.cluster_type:
                     logging.warning(f"cluster_type mismatch in {node}: {cluster.cluster_type} != {cluster_type}")
                 cluster.cluster_type = cluster_type
-            # TODO deserialize Bridging and SplitAnte
-            mention._bridging = node.misc["Bridging" + index_str]
+            bridging_str = node.misc["Bridging" + index_str]
+            if bridging_str:
+                mention._bridging = BridgingLinks(mention, bridging_str)
+            # TODO deserialize SplitAnte
             cluster._split_ante = node.misc["SplitAnte" + index_str]
             mention.misc = node.misc["MentionMisc" + index_str]
             index += 1
@@ -239,7 +314,8 @@ def store_coref_to_misc(doc):
             head.misc["ClusterId" + index_str] = cluster.cluster_id
             head.misc["MentionSpan" + index_str] = mention.span
             head.misc["ClusterType" + index_str] = cluster.cluster_type
-            head.misc["Bridging" + index_str] = mention.bridging
+            if mention._bridging:
+                head.misc["Bridging" + index_str] = str(mention.bridging)
             head.misc["SplitAnte" + index_str] = cluster.split_ante
             if mention.misc:
                 head.misc["MentionMisc" + index_str] = mention.misc

From fdf5604428fd87890f8cb22038ccce3c8d645650 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 26 Feb 2021 21:24:18 +0100
Subject: [PATCH 0358/1374] handle SplitAnte

---
 udapi/core/coref.py | 33 +++++++++++++++++++++------------
 1 file changed, 21 insertions(+), 12 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 46d42e95..5c8f5b89 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -102,13 +102,13 @@ def span(self, new_span):
 
 class CorefCluster(object):
     """Class for representing all mentions of a given entity."""
-    __slots__ = ['_cluster_id', '_mentions', 'cluster_type', '_split_ante']
+    __slots__ = ['_cluster_id', '_mentions', 'cluster_type', 'split_ante']
 
     def __init__(self, cluster_id, cluster_type=None):
         self._cluster_id = cluster_id
         self._mentions = []
         self.cluster_type = cluster_type
-        self._split_ante = None
+        self.split_ante = []
 
     @property
     def cluster_id(self):
@@ -154,12 +154,6 @@ def create_mention(self, head=None, mention_words=None, mention_span=None):
             mention.span = mention_span
         return mention
 
-    @property
-    def split_ante(self):
-        return self._split_ante
-
-    # TODO add/edit split_ante
-
     # TODO or should we create a BridgingLinks instance with a fake src_mention?
     def all_bridging(self):
         for m in self._mentions:
@@ -202,7 +196,7 @@ def __getitem__(self, key):
     def __len__(self):
         return len(self._data)
 
-    # TODO delete backlinks of old links
+    # TODO delete backlinks of old links, dtto for SplitAnte
     def __setitem__(self, key, new_value):
         self._data[key] = BridgingLink(new_value[0], new_value[1])
 
@@ -275,11 +269,24 @@ def load_coref_from_misc(doc):
                 if cluster.cluster_type is not None and cluster_type != cluster.cluster_type:
                     logging.warning(f"cluster_type mismatch in {node}: {cluster.cluster_type} != {cluster_type}")
                 cluster.cluster_type = cluster_type
+
             bridging_str = node.misc["Bridging" + index_str]
             if bridging_str:
                 mention._bridging = BridgingLinks(mention, bridging_str)
-            # TODO deserialize SplitAnte
-            cluster._split_ante = node.misc["SplitAnte" + index_str]
+
+            split_ante_str = node.misc["SplitAnte" + index_str]
+            if split_ante_str:
+                split_antes = []
+                for ante_str in split_ante_str.split('+'):
+                    if ante_str in clusters:
+                        split_antes.append(clusters[ante_str])
+                    else:
+                        # split cataphora, e.g. "We, that is you and me..."
+                        cluster = CorefCluster(ante_str)
+                        clusters[ante_str] = cluster
+                        split_antes.append(cluster)
+                cluster.split_ante = split_antes
+
             mention.misc = node.misc["MentionMisc" + index_str]
             index += 1
             index_str = f"[{index}]"
@@ -316,7 +323,9 @@ def store_coref_to_misc(doc):
             head.misc["ClusterType" + index_str] = cluster.cluster_type
             if mention._bridging:
                 head.misc["Bridging" + index_str] = str(mention.bridging)
-            head.misc["SplitAnte" + index_str] = cluster.split_ante
+            if cluster.split_ante:
+                serialized = '+'.join((c.cluster_id for c in cluster.split_ante))
+                head.misc["SplitAnte" + index_str] = serialized
             if mention.misc:
                 head.misc["MentionMisc" + index_str] = mention.misc
 

From cb75f9e9cc04e87229a53e08a3216dd43b620a03 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 27 Feb 2021 13:09:24 +0100
Subject: [PATCH 0359/1374] bugfix: prevent infinite recursion when loading
 coref_clusters from MISC

We cannot access src_mention.head.root.coref_clusters when loading Bridging
because these are not ready yet.
---
 udapi/core/coref.py | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 5c8f5b89..818bb248 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -171,7 +171,7 @@ class BridgingLinks(collections.abc.MutableSequence):
     Example usage:
     >>> bl = BridgingLinks(src_mention)                                   # empty links
     >>> bl = BridgingLinks(src_mention, [(c12, 'Part'), (c56, 'Subset')]) # from a list of tuples
-    >>> bl = BridgingLinks(src_mention, 'c12:Part,c56:Subset')            # from a string
+    >>> bl = BridgingLinks(src_mention, 'c12:Part,c56:Subset', clusters)  # from a string
     >>> for cluster, relation in bl:
     >>>     print(f"{bl.src_mention} ->{relation}-> {cluster.cluster_id}")
     >>> print(str(bl)) # c12:Part,c56:Subset
@@ -179,12 +179,18 @@ class BridgingLinks(collections.abc.MutableSequence):
     >>> bl('Part|Subset').targets == [c12, c56]
     >>> bl.append((c89, 'Funct'))
     """
-    def __init__(self, src_mention, value=None):
+    def __init__(self, src_mention, value=None, clusters=None):
         self.src_mention = src_mention
         self._data = []
         if value is not None:
             if isinstance(value, str):
-                self._from_string(string)
+                if clusters is None:
+                    raise ValueError('BridgingClusters: clusters must be provided if initializing with a string')
+                try:
+                    self._from_string(value, clusters)
+                except ValueError:
+                    logging.error(f"Problem when parsing {value} in {src_mention.words[0]}:\n")
+                    raise
             elif isinstance(value, collections.abc.Sequence):
                 for v in value:
                     self._data.append(BridgingLink(v[0], v[1]))
@@ -209,9 +215,8 @@ def insert(self, key, new_value):
     def __str__(self):
         return ','.join(f'{l.target._cluster_id}:{l.relation}' for l in self)
 
-    def _from_string(self, string):
+    def _from_string(self, string, clusters):
         self._data.clear()
-        clusters = self.src_mention.head.root.coref_clusters
         for link_str in string.split(','):
             target, relation = link_str.split(':')
             self._data.append(BridgingLink(clusters[target], relation))
@@ -272,7 +277,7 @@ def load_coref_from_misc(doc):
 
             bridging_str = node.misc["Bridging" + index_str]
             if bridging_str:
-                mention._bridging = BridgingLinks(mention, bridging_str)
+                mention._bridging = BridgingLinks(mention, bridging_str, clusters)
 
             split_ante_str = node.misc["SplitAnte" + index_str]
             if split_ante_str:

From 27d2ed3ea6d4c3f9fe5a50cce78d5370009aee3e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 27 Feb 2021 15:18:27 +0100
Subject: [PATCH 0360/1374] corefud.PrintCluster for revealing cluster_id used
 in several documents

---
 udapi/block/corefud/printcluster.py | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 udapi/block/corefud/printcluster.py

diff --git a/udapi/block/corefud/printcluster.py b/udapi/block/corefud/printcluster.py
new file mode 100644
index 00000000..5f44fab2
--- /dev/null
+++ b/udapi/block/corefud/printcluster.py
@@ -0,0 +1,19 @@
+from udapi.core.block import Block
+from collections import Counter
+
+class PrintCluster(Block):
+    """Block corefud.PrintCluster prints all mentions of a given cluster."""
+
+    def __init__(self, cluster_id, **kwargs):
+        super().__init__(**kwargs)
+        self.cluster_id = cluster_id
+
+    def process_document(self, doc):
+        cluster = doc.coref_clusters.get(self.cluster_id)
+        if cluster and cluster.mentions:
+            print(f"Coref cluster {self.cluster_id} has {len(cluster.mentions)} mentions in document {doc.meta['docname']}:")
+            counter = Counter()
+            for mention in cluster.mentions:
+                counter[' '.join([w.form for w in mention.words])] += 1
+            for form, count in counter.most_common():
+                print(f"{count:4}: {form}")

From fd86474fd17a73fb237e24ac206ef5c4b8eabd2c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 28 Feb 2021 13:50:27 +0100
Subject: [PATCH 0361/1374] fixing typo found in the review

---
 udapi/core/coref.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 818bb248..41ba5a41 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -60,9 +60,8 @@ def cluster(self, new_cluster):
 
     @property
     def bridging(self):
-        if self._bridging:
-            return self._bridging
-        self._bridging = BridgingLinks(self)
+        if not self._bridging:
+            self._bridging = BridgingLinks(self)
         return self._bridging
 
     # TODO add/edit bridging
@@ -166,7 +165,7 @@ def all_bridging(self):
 
 
 class BridgingLinks(collections.abc.MutableSequence):
-    """BridgingLinks class serves as a list of BridgingLinks tuples with additional methods.
+    """BridgingLinks class serves as a list of BridgingLink tuples with additional methods.
 
     Example usage:
     >>> bl = BridgingLinks(src_mention)                                   # empty links

From 0e27217072e62cfc6a16db69e3b8fd6b22104863 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 28 Feb 2021 13:56:43 +0100
Subject: [PATCH 0362/1374] coref must be loaded also from empty nodes

An alternative to #77
---
 udapi/core/coref.py    |  4 ++--
 udapi/core/document.py | 10 +++++++++-
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 41ba5a41..143e50ff 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -252,7 +252,7 @@ def create_coref_cluster(head, cluster_id=None, cluster_type=None, **kwargs):
 
 def load_coref_from_misc(doc):
     clusters = {}
-    for node in doc.nodes:
+    for node in doc.nodes_and_empty:
         index, index_str = 0, ""
         cluster_id = node.misc["ClusterId"]
         if not cluster_id:
@@ -302,7 +302,7 @@ def store_coref_to_misc(doc):
     if not doc._coref_clusters:
         return
     attrs = ("ClusterId", "MentionSpan", "ClusterType", "Bridging", "SplitAnte")
-    for node in doc.nodes:
+    for node in doc.nodes_and_empty:
         for key in list(node.misc):
             if any(re.match(attr + r'(\[\d+\])?$', key) for attr in attrs):
                 del node.misc[key]
diff --git a/udapi/core/document.py b/udapi/core/document.py
index 58b4b34e..f02f831e 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -88,12 +88,20 @@ def trees(self):
 
     @property
     def nodes(self):
-        """An iterator over all nodes in the document."""
+        """An iterator over all nodes (excluding empty nodes) in the document."""
         for bundle in self:
             for tree in bundle:
                 for node in tree._descendants:
                     yield node
 
+    @property
+    def nodes_and_empty(self):
+        """An iterator over all nodes and empty nodes in the document."""
+        for bundle in self:
+            for tree in bundle:
+                for node in tree.descendants_and_empty:
+                    yield node
+
     def draw(self, **kwargs):
         """Pretty print the trees using TextModeTrees."""
         TextModeTrees(**kwargs).run(self)

From 44def37aad48996d8671a1c3b49f371f6edb4ec0 Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Fri, 26 Feb 2021 11:38:55 +0100
Subject: [PATCH 0363/1374] a block for cluster re-indexing

---
 udapi/block/corefud/indexclusters.py | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 udapi/block/corefud/indexclusters.py

diff --git a/udapi/block/corefud/indexclusters.py b/udapi/block/corefud/indexclusters.py
new file mode 100644
index 00000000..f602b93a
--- /dev/null
+++ b/udapi/block/corefud/indexclusters.py
@@ -0,0 +1,26 @@
+"""Block corefud.IndexClusters"""
+from udapi.core.block import Block
+
+
+class IndexClusters(Block):
+    """Re-index the coreference cluster IDs. The final cluster IDs are of the "c<ID>" form,
+       where <ID> are ordinal numbers starting from the one specified by the `start` parameter.
+       
+       Parameters:
+       -----------
+       start : int
+            the starting index (by default 1)
+    """
+
+    def __init__(self, start=1):
+        self.start = start
+
+    def process_document(self, doc):
+        clusters = doc.coref_clusters
+        new_clusters = {}
+        for idx, cid in enumerate(clusters, self.start):
+            cluster = clusters[cid]
+            new_cid = "c" + str(idx)
+            # need to change private variable
+            cluster._cluster_id = new_cid 
+            new_clusters[new_cid] = cluster

From 0760a2b12e92824b8dc5c46ba0c4fc688cf211de Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 28 Feb 2021 16:24:09 +0100
Subject: [PATCH 0364/1374] bugfix: empty_node.org cannot be printed with %d

---
 udapi/core/node.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index c49f8128..7fa4ec0c 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -803,7 +803,7 @@ def address(self):
         e.g. s123/en_udpipe#4. If zone is empty, the slash is excluded as well,
         e.g. s123#4.
         """
-        return '%s#%d' % (self._root.address() if self._root else '?', self._ord)
+        return f"{self._root.address() if self._root else '?'}#{self._ord}"
 
     @property
     def multiword_token(self):

From f2bedb6804d24eaaae6b7de0cf19ebae87942e97 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 28 Feb 2021 16:51:59 +0100
Subject: [PATCH 0365/1374] bugfix: Bridging can refer to clusters which are
 not defined yet

---
 udapi/core/coref.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 143e50ff..b1348067 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -187,7 +187,7 @@ def __init__(self, src_mention, value=None, clusters=None):
                     raise ValueError('BridgingClusters: clusters must be provided if initializing with a string')
                 try:
                     self._from_string(value, clusters)
-                except ValueError:
+                except Exception:
                     logging.error(f"Problem when parsing {value} in {src_mention.words[0]}:\n")
                     raise
             elif isinstance(value, collections.abc.Sequence):
@@ -218,6 +218,8 @@ def _from_string(self, string, clusters):
         self._data.clear()
         for link_str in string.split(','):
             target, relation = link_str.split(':')
+            if target not in clusters:
+                clusters[target] = CorefCluster(target)
             self._data.append(BridgingLink(clusters[target], relation))
 
     def __call__(self, relations_re=None):

From 5fe2ab7829f8d2b5895ca714fb5312925e0655ab Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 28 Feb 2021 21:41:50 +0100
Subject: [PATCH 0366/1374] `write.Conllu overwrite=1` will overwrite the input
 files

as stored in `doc.meta["loaded_from"]`
---
 udapi/core/basewriter.py | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/udapi/core/basewriter.py b/udapi/core/basewriter.py
index 3f28d155..0db348a8 100644
--- a/udapi/core/basewriter.py
+++ b/udapi/core/basewriter.py
@@ -11,7 +11,7 @@ class BaseWriter(Block):
     """Base class for all reader blocks."""
 
     def __init__(self, files='-', filehandle=None, docname_as_file=False, encoding='utf-8',
-                 newline='\n', **kwargs):
+                 newline='\n', overwrite=False, **kwargs):
         super().__init__(**kwargs)
         self.orig_files = files
         self.orig_stdout = sys.stdout
@@ -24,6 +24,11 @@ def __init__(self, files='-', filehandle=None, docname_as_file=False, encoding='
         self.docname_as_file = docname_as_file
         if docname_as_file and files != '-':
             raise ValueError("docname_as_file=1 is not compatible with files=" + files)
+        self.overwrite = overwrite
+        if overwrite and files != '-':
+            raise ValueError("overwrite=1 is not compatible with files=" + files)
+        if overwrite and docname_as_file:
+            raise ValueError("overwrite=1 is not compatible with docname_as_file=1")
 
     @property
     def filename(self):
@@ -54,6 +59,13 @@ def before_process_document(self, document):
                     sys.stdout = open(docname, 'wt', encoding=self.encoding, newline=self.newline)
                 else:
                     logging.warning('docname_as_file=1 but the document contains no docname')
+            elif self.overwrite:
+                docname = document.meta.get('loaded_from', None)
+                if docname is not None:
+                    logging.info('Writing to file %s.', docname)
+                    sys.stdout = open(docname, 'wt', encoding=self.encoding, newline=self.newline)
+                else:
+                    logging.warning('overwrite=1 but documet.meta["loaded_from"] is None')
             else:
                 sys.stdout = self.orig_stdout
         else:

From 67b303d666f93c87e3bbbbeb491b681f0ed829f9 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 28 Feb 2021 21:43:15 +0100
Subject: [PATCH 0367/1374] Make cluster IDs unique across all documents
 processed

---
 udapi/block/corefud/indexclusters.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/udapi/block/corefud/indexclusters.py b/udapi/block/corefud/indexclusters.py
index f602b93a..6c0e9242 100644
--- a/udapi/block/corefud/indexclusters.py
+++ b/udapi/block/corefud/indexclusters.py
@@ -5,7 +5,11 @@
 class IndexClusters(Block):
     """Re-index the coreference cluster IDs. The final cluster IDs are of the "c<ID>" form,
        where <ID> are ordinal numbers starting from the one specified by the `start` parameter.
-       
+       This block can be applied on multiple documents within one udapy call.
+       For example, to re-index ClusterId in all conllu files in the current directory
+       (keeping the IDs unique across all the files), use:
+       `udapy read.Conllu files='!*.conllu' corefud.IndexClusters write.Conllu overwrite=1`
+
        Parameters:
        -----------
        start : int
@@ -22,5 +26,6 @@ def process_document(self, doc):
             cluster = clusters[cid]
             new_cid = "c" + str(idx)
             # need to change private variable
-            cluster._cluster_id = new_cid 
+            cluster._cluster_id = new_cid
             new_clusters[new_cid] = cluster
+        self.start = idx + 1

From 49e94345d6ab84d36478d687262906cf0672513c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 1 Mar 2021 18:34:00 +0100
Subject: [PATCH 0368/1374] bugfix: MentionMisc was not properly updated in
 write.Conllu

---
 udapi/core/coref.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index b1348067..0f9df0d1 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -303,7 +303,7 @@ def load_coref_from_misc(doc):
 def store_coref_to_misc(doc):
     if not doc._coref_clusters:
         return
-    attrs = ("ClusterId", "MentionSpan", "ClusterType", "Bridging", "SplitAnte")
+    attrs = ("ClusterId", "MentionSpan", "ClusterType", "Bridging", "SplitAnte", "MentionMisc")
     for node in doc.nodes_and_empty:
         for key in list(node.misc):
             if any(re.match(attr + r'(\[\d+\])?$', key) for attr in attrs):

From 66ae04a5aa8c02afbaa54bff7014af007d768e82 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 1 Mar 2021 18:53:14 +0100
Subject: [PATCH 0369/1374] new_clusters not needed, idx not defined if there
 are no clusters

---
 udapi/block/corefud/indexclusters.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/corefud/indexclusters.py b/udapi/block/corefud/indexclusters.py
index 6c0e9242..2c5d8162 100644
--- a/udapi/block/corefud/indexclusters.py
+++ b/udapi/block/corefud/indexclusters.py
@@ -21,11 +21,11 @@ def __init__(self, start=1):
 
     def process_document(self, doc):
         clusters = doc.coref_clusters
-        new_clusters = {}
+        if not clusters:
+            return
         for idx, cid in enumerate(clusters, self.start):
             cluster = clusters[cid]
             new_cid = "c" + str(idx)
             # need to change private variable
             cluster._cluster_id = new_cid
-            new_clusters[new_cid] = cluster
         self.start = idx + 1

From 65dd375f527a5062a13e131090f84f85cf6b989f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 1 Mar 2021 19:55:22 +0100
Subject: [PATCH 0370/1374] first version of corefud.MoveHead

---
 udapi/block/corefud/movehead.py | 61 +++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 udapi/block/corefud/movehead.py

diff --git a/udapi/block/corefud/movehead.py b/udapi/block/corefud/movehead.py
new file mode 100644
index 00000000..f2e0bea2
--- /dev/null
+++ b/udapi/block/corefud/movehead.py
@@ -0,0 +1,61 @@
+import logging
+from collections import Counter
+from udapi.core.block import Block
+from udapi.core.node import find_minimal_common_treelet
+
+class MoveHead(Block):
+    """Block corefud.MoveHead moves the head to the highest node in each mention."""
+
+    def __init__(self, nontreelet='fix', **kwargs):
+        self.counter = Counter()
+        self.nontreelet = nontreelet
+        super().__init__(**kwargs)
+
+    def find_head(self, mention):
+        empty_nodes, non_empty = [], []
+        for w in mention.words:
+            (empty_nodes if w.is_empty() else non_empty).append(w)
+        if empty_nodes:
+            self.counter['with_empty'] += 1
+            for empty_node in empty_nodes:
+                parents = [d['parent'] for d in empty_node.deps if not d['parent'].is_empty()]
+                if parents and parents[0] not in non_empty:
+                    non_empty.append(parents[0])
+                else:
+                    # TODO we should climb up, but preventing cycles
+                    # We could also introduce empty_node.nonempty_ancestor
+                    logging.warning(f"could not find non-empty parent of {empty_node} for mention {mention.head}")
+            non_empty.sort()
+
+        (highest, added_nodes) = find_minimal_common_treelet(*non_empty)
+        if highest in mention.words:
+            return highest, 'treelet'
+
+        if 'warn' in self.nontreelet:
+            logging.warning(f"Non-treelet mention in {mention.head} (nearest common antecedent={highest})")
+        if 'mark' in self.nontreelet:
+            node.misc['Mark'] = 'non-treelet-mention'
+        for word in mention.words:
+            if not word.is_empty() and word.parent not in non_empty:
+                return word, 'nontreelet'
+        return mention.head, 'bug'
+
+    def process_document(self, doc):
+        for cluster in doc.coref_clusters.values():
+            for mention in cluster.mentions:
+                self.counter['total'] += 1
+                if len(mention.words) < 2:
+                    self.counter['single-word'] += 1
+                else:
+                    new_head, category = self.find_head(mention)
+                    if new_head is mention.head:
+                        self.counter[category + '-kept'] += 1
+                    else:
+                        self.counter[category + '-moved'] += 1
+                        mention.head = new_head
+
+    def process_end(self):
+        logging.info("corefud.MoveHead overview of mentions:")
+        total = self.counter['total']
+        for key, value in self.counter.most_common():
+            logging.info(f"{key:>16} = {value:6} ({100*value/total:5.1f}%)")

From 740f9126c0036a0ba808d0559425eca40e2ddc7f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 2 Mar 2021 09:30:23 +0100
Subject: [PATCH 0371/1374] doc.coref_clusters should be updated after
 corefud.IndexClusters

Thanks, @michnov, for reminding me.
---
 udapi/block/corefud/indexclusters.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/corefud/indexclusters.py b/udapi/block/corefud/indexclusters.py
index 2c5d8162..dee45544 100644
--- a/udapi/block/corefud/indexclusters.py
+++ b/udapi/block/corefud/indexclusters.py
@@ -23,9 +23,12 @@ def process_document(self, doc):
         clusters = doc.coref_clusters
         if not clusters:
             return
+        new_clusters = {}
         for idx, cid in enumerate(clusters, self.start):
             cluster = clusters[cid]
             new_cid = "c" + str(idx)
             # need to change private variable
             cluster._cluster_id = new_cid
+            new_clusters[new_cid] = cluster
         self.start = idx + 1
+        doc._coref_clusters = new_clusters

From 5e5ef50e261ac791646fcf2f8b36ee489988bd24 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 Mar 2021 11:37:26 +0100
Subject: [PATCH 0372/1374] be consistent and require the regex parameter to
 include () if needed

Before this commit, `udapy -TM` matched also nodes with MISC `Bugwhatever=1`.
The intend is that only nodes with MISC containing `Bug=` are matched.
---
 udapi/block/write/textmodetrees.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index c8e619b9..fb38c22a 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -134,7 +134,7 @@ class TextModeTrees(BaseWriter):
     def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
                  minimize_cross=True, color='auto', attributes='form,upos,deprel',
                  print_undef_as='_', print_doc_meta=True, print_comments=False, print_empty=True,
-                 mark='ToDo|ToDoOrigText|Bug|Mark', marked_only=False, hints=True,
+                 mark='(ToDo|ToDoOrigText|Bug|Mark)', marked_only=False, hints=True,
                  layout='classic', **kwargs):
         """Create new TextModeTrees block object.
 
@@ -159,7 +159,7 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         print_comments: Print comments (other than sent_id and text)?
         print_empty: Print empty nodes?
         mark: a regex. If `re.search(mark + '=', str(node.misc))` the node is highlighted.
-            If `print_comments and re.search(r'^ (%s) = ' % mark, root.comment, re.M)`
+            If `print_comments and re.search(r'^ %s = ' % mark, root.comment, re.M)`
             the comment is highlighted.
             Empty string means no highlighting. Default = 'ToDo|ToDoOrigText|Bug|Mark'.
         marked_only: print only trees containing one or more marked nodes/comments. Default=False.
@@ -203,7 +203,7 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         self.mark_re, self.comment_mark_re = None, None
         if mark is not None and mark != '':
             self.mark_re = re.compile(mark + '=')
-            self.comment_mark_re = re.compile(r'^ (%s) = ' % mark, re.M)
+            self.comment_mark_re = re.compile(r'^ %s = ' % mark, re.M)
         self._index_of = []
         self._gaps = []
         self.lines = []

From 3ea67d43143f29f4ec586fc7b0944a763bad1a2f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 Mar 2021 11:44:52 +0100
Subject: [PATCH 0373/1374] tool.morphodita should wrap not only `generate`,
 but also `analyze`

---
 udapi/tool/morphodita.py | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/udapi/tool/morphodita.py b/udapi/tool/morphodita.py
index 656c6acb..326bee46 100644
--- a/udapi/tool/morphodita.py
+++ b/udapi/tool/morphodita.py
@@ -1,7 +1,7 @@
 """Wrapper for MorphoDiTa (more pythonic than ufal.morphodita)."""
 from collections import namedtuple
 
-from ufal.morphodita import Morpho, TaggedLemmasForms  # pylint: disable=no-name-in-module
+from ufal.morphodita import Morpho, TaggedLemmasForms, TaggedLemmas  # pylint: disable=no-name-in-module
 from udapi.core.resource import require_file
 
 FormInfo = namedtuple('FormInfo', 'form lemma tag guesser')
@@ -19,8 +19,7 @@ def __init__(self, model):
             raise IOError("Cannot load model from file '%s'" % path)
 
     def forms_of_lemma(self, lemma, tag_wildcard='?', guesser=True):
-        """Return all forms of a given lemma matching a given tag wildcard."""
-
+        """Return all forms (a list of FormInfo tuples) of a given lemma matching a given tag wildcard."""
         use_guesser = 1 if guesser else 0
         lemmas_forms = TaggedLemmasForms()
         used_guesser = self.tool.generate(lemma, tag_wildcard, use_guesser, lemmas_forms)
@@ -29,3 +28,13 @@ def forms_of_lemma(self, lemma, tag_wildcard='?', guesser=True):
             for form in lemma_forms.forms:
                 forms.append(FormInfo(form.form, lemma_forms.lemma, form.tag, used_guesser))
         return forms
+
+    def analyze_form(self, form, guesser=True):
+        """Return all lemma-tag analyses (a list of FormInfo tuples) of a given form."""
+        use_guesser = 1 if guesser else 0
+        tagged_lemmas = TaggedLemmas()
+        used_guesser = self.tool.analyze(form, use_guesser, tagged_lemmas)
+        result = []
+        for tl in tagged_lemmas:
+            result.append(FormInfo(form, tl.lemma, tl.tag, used_guesser))
+        return result

From d5fa1b6d21b0d4ba80b55cf932fae3588486c669 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 Mar 2021 11:58:11 +0100
Subject: [PATCH 0374/1374] change the SplitAnte separator from plus to comma

---
 udapi/core/coref.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 0f9df0d1..8d4cd4da 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -283,7 +283,9 @@ def load_coref_from_misc(doc):
             split_ante_str = node.misc["SplitAnte" + index_str]
             if split_ante_str:
                 split_antes = []
-                for ante_str in split_ante_str.split('+'):
+                # TODO in CorefUD draft "+" was used as the separator, but it was changed to comma.
+                # We can delete `.replace('+', ',')` once there are no more data with the legacy plus separator.
+                for ante_str in split_ante_str.replace('+', ',').split(','):
                     if ante_str in clusters:
                         split_antes.append(clusters[ante_str])
                     else:
@@ -330,7 +332,7 @@ def store_coref_to_misc(doc):
             if mention._bridging:
                 head.misc["Bridging" + index_str] = str(mention.bridging)
             if cluster.split_ante:
-                serialized = '+'.join((c.cluster_id for c in cluster.split_ante))
+                serialized = ','.join((c.cluster_id for c in cluster.split_ante))
                 head.misc["SplitAnte" + index_str] = serialized
             if mention.misc:
                 head.misc["MentionMisc" + index_str] = mention.misc

From 7912ac805e0d76e85f4672a5087f5b62a4846953 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 3 Mar 2021 17:48:10 +0100
Subject: [PATCH 0375/1374] define ordering of clusters

---
 udapi/core/coref.py | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 8d4cd4da..c3c4acf5 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -99,6 +99,7 @@ def span(self, new_span):
         self.words = span_to_nodes(self._head.root, new_span)
 
 
+@functools.total_ordering
 class CorefCluster(object):
     """Class for representing all mentions of a given entity."""
     __slots__ = ['_cluster_id', '_mentions', 'cluster_type', 'split_ante']
@@ -109,6 +110,20 @@ def __init__(self, cluster_id, cluster_type=None):
         self.cluster_type = cluster_type
         self.split_ante = []
 
+    def __lt__(self, other):
+        """Does this CorefCluster precedes (word-order wise) the `other` cluster?
+
+        This method defines a total ordering of all clusters
+        by the first mention of each cluster (see `CorefMention.__lt__`).
+        Only if one of the clusters has no mentions (which should not happen normally),
+        the ordering is defined by the `cluster_id` (lexicographically).
+        If cluster IDs are not important, it is recommended to use block
+        `corefud.IndexClusters` to re-name cluster IDs in accordance with this cluster ordering.
+        """
+        if not self.mentions or not other.mentions:
+            return self._cluster_id < other._cluster_id
+        return self.mentions[0] < other.mentions[0]
+
     @property
     def cluster_id(self):
         return self._cluster_id
@@ -299,7 +314,7 @@ def load_coref_from_misc(doc):
             index += 1
             index_str = f"[{index}]"
             cluster_id = node.misc["ClusterId" + index_str]
-    doc._coref_clusters = clusters
+    doc._coref_clusters = {k: clusters[k] for k in sorted(clusters)}
 
 
 def store_coref_to_misc(doc):
@@ -310,7 +325,7 @@ def store_coref_to_misc(doc):
         for key in list(node.misc):
             if any(re.match(attr + r'(\[\d+\])?$', key) for attr in attrs):
                 del node.misc[key]
-    for cluster in doc._coref_clusters.values():
+    for cluster in sorted(doc._coref_clusters.values()):
         for mention in cluster.mentions:
             head = mention.head
             if head.misc["ClusterId"]:

From 6ef20d80d10850290a6faf3c8e854304036c833f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 Mar 2021 00:33:35 +0100
Subject: [PATCH 0376/1374] improved and renames corefud.PrintClusters

---
 udapi/block/corefud/printcluster.py  | 19 ------------
 udapi/block/corefud/printclusters.py | 44 ++++++++++++++++++++++++++++
 2 files changed, 44 insertions(+), 19 deletions(-)
 delete mode 100644 udapi/block/corefud/printcluster.py
 create mode 100644 udapi/block/corefud/printclusters.py

diff --git a/udapi/block/corefud/printcluster.py b/udapi/block/corefud/printcluster.py
deleted file mode 100644
index 5f44fab2..00000000
--- a/udapi/block/corefud/printcluster.py
+++ /dev/null
@@ -1,19 +0,0 @@
-from udapi.core.block import Block
-from collections import Counter
-
-class PrintCluster(Block):
-    """Block corefud.PrintCluster prints all mentions of a given cluster."""
-
-    def __init__(self, cluster_id, **kwargs):
-        super().__init__(**kwargs)
-        self.cluster_id = cluster_id
-
-    def process_document(self, doc):
-        cluster = doc.coref_clusters.get(self.cluster_id)
-        if cluster and cluster.mentions:
-            print(f"Coref cluster {self.cluster_id} has {len(cluster.mentions)} mentions in document {doc.meta['docname']}:")
-            counter = Counter()
-            for mention in cluster.mentions:
-                counter[' '.join([w.form for w in mention.words])] += 1
-            for form, count in counter.most_common():
-                print(f"{count:4}: {form}")
diff --git a/udapi/block/corefud/printclusters.py b/udapi/block/corefud/printclusters.py
new file mode 100644
index 00000000..274aebe5
--- /dev/null
+++ b/udapi/block/corefud/printclusters.py
@@ -0,0 +1,44 @@
+import re
+import os.path
+from udapi.core.block import Block
+from collections import Counter, defaultdict
+
+class PrintClusters(Block):
+    """Block corefud.PrintClusters prints all mentions of a given cluster."""
+
+    def __init__(self, id_re=None, min_mentions=0, print_ranges=True, **kwargs):
+        """Params:
+        id_re: regular expression constraining ClusterId of the clusters to be printed
+        min_mentions: print only clusters with with at least N mentions
+        print_ranges: print also addressess of all mentions
+                      (compactly, using the longest common prefix of sent_id)
+        """
+        super().__init__(**kwargs)
+        self.id_re = re.compile(str(id_re)) if id_re else None
+        self.min_mentions = min_mentions
+        self.print_ranges = print_ranges
+
+    def process_document(self, doc):
+        if 'docname' in doc.meta:
+            print(f"Coref clusters in document {doc.meta['docname']}:")
+        for cluster in doc.coref_clusters.values():
+            if self.id_re and not self.id_re.match(cluster.cluster_id):
+                continue
+            if len(cluster.mentions) < self.min_mentions:
+                continue
+            print(f"{cluster.cluster_id} has {len(cluster.mentions)} mentions:")
+            counter = Counter()
+            ranges = defaultdict(list)
+            for mention in cluster.mentions:
+                forms = ' '.join([w.form for w in mention.words])
+                counter[forms] += 1
+                if self.print_ranges:
+                    ranges[forms].append(mention.head.root.address() + ':' +mention.span)
+            for form, count in counter.most_common():
+                print(f"{count:4}: {form}")
+                if self.print_ranges:
+                    if count == 1:
+                        print('      ' + ranges[form][0])
+                    else:
+                        prefix = os.path.commonprefix(ranges[form])
+                        print(f'      {prefix} ({" ".join(f[len(prefix):] for f in ranges[form])})')

From 0a107692d6bbf081c943e162abc124a794ca9f88 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 Mar 2021 00:36:55 +0100
Subject: [PATCH 0377/1374] cluster+mention ordering bug fixes

* If two mentions start at the same word, the shorter one should go first.
* `doc.coref_clusters` dict should be sorted by the values (clusters),
  not keys (cluster_id).
---
 udapi/core/coref.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index c3c4acf5..13ac3fd4 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -34,7 +34,7 @@ def __lt__(self, other):
         if node1 is node2:
             node1 = self._words[-1] if self._words else self._head
             node2 = other._words[-1] if other._words else other._head
-            return node1 > node2
+            return node1 < node2
         return node1 < node2
 
     @property
@@ -314,7 +314,11 @@ def load_coref_from_misc(doc):
             index += 1
             index_str = f"[{index}]"
             cluster_id = node.misc["ClusterId" + index_str]
-    doc._coref_clusters = {k: clusters[k] for k in sorted(clusters)}
+    # c=doc.coref_clusters should be sorted, so that c[0] < c[1] etc.
+    # In other words, the dict should be sorted by the values (according to CorefCluster.__lt__),
+    # not by the keys (cluster_id).
+    # In Python 3.7+ (3.6+ in CPython), dicts are guaranteed to be insertion order.
+    doc._coref_clusters = {c._cluster_id: c for c in sorted(clusters.values())}
 
 
 def store_coref_to_misc(doc):

From 5ccb76b819bd9b66a70f5c7d471f06f66ea7772d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 Mar 2021 14:03:42 +0100
Subject: [PATCH 0378/1374] missing imports

---
 udapi/core/basereader.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 5d991a29..05f204b9 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -1,5 +1,7 @@
 """BaseReader is the base class for all reader blocks."""
 import gc
+import re
+import logging
 from udapi.core.block import Block
 from udapi.core.files import Files
 

From a879b2dab675a628e590dce26a8aca636cee67c6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 5 Mar 2021 14:04:28 +0100
Subject: [PATCH 0379/1374] allow corefud.PrintClusters agregate_mentions=0

if you want to inspect the ordering of the mentions
---
 udapi/block/corefud/printclusters.py | 41 ++++++++++++++++------------
 1 file changed, 24 insertions(+), 17 deletions(-)

diff --git a/udapi/block/corefud/printclusters.py b/udapi/block/corefud/printclusters.py
index 274aebe5..163fa1a7 100644
--- a/udapi/block/corefud/printclusters.py
+++ b/udapi/block/corefud/printclusters.py
@@ -6,7 +6,7 @@
 class PrintClusters(Block):
     """Block corefud.PrintClusters prints all mentions of a given cluster."""
 
-    def __init__(self, id_re=None, min_mentions=0, print_ranges=True, **kwargs):
+    def __init__(self, id_re=None, min_mentions=0, print_ranges=True, agregate_mentions=True, **kwargs):
         """Params:
         id_re: regular expression constraining ClusterId of the clusters to be printed
         min_mentions: print only clusters with with at least N mentions
@@ -17,6 +17,7 @@ def __init__(self, id_re=None, min_mentions=0, print_ranges=True, **kwargs):
         self.id_re = re.compile(str(id_re)) if id_re else None
         self.min_mentions = min_mentions
         self.print_ranges = print_ranges
+        self.agregate_mentions = agregate_mentions
 
     def process_document(self, doc):
         if 'docname' in doc.meta:
@@ -26,19 +27,25 @@ def process_document(self, doc):
                 continue
             if len(cluster.mentions) < self.min_mentions:
                 continue
-            print(f"{cluster.cluster_id} has {len(cluster.mentions)} mentions:")
-            counter = Counter()
-            ranges = defaultdict(list)
-            for mention in cluster.mentions:
-                forms = ' '.join([w.form for w in mention.words])
-                counter[forms] += 1
-                if self.print_ranges:
-                    ranges[forms].append(mention.head.root.address() + ':' +mention.span)
-            for form, count in counter.most_common():
-                print(f"{count:4}: {form}")
-                if self.print_ranges:
-                    if count == 1:
-                        print('      ' + ranges[form][0])
-                    else:
-                        prefix = os.path.commonprefix(ranges[form])
-                        print(f'      {prefix} ({" ".join(f[len(prefix):] for f in ranges[form])})')
+            print(f" {cluster.cluster_id} has {len(cluster.mentions)} mentions:")
+            if self.agregate_mentions:
+                counter = Counter()
+                ranges = defaultdict(list)
+                for mention in cluster.mentions:
+                    forms = ' '.join([w.form for w in mention.words])
+                    counter[forms] += 1
+                    if self.print_ranges:
+                        ranges[forms].append(mention.head.root.address() + ':' +mention.span)
+                for form, count in counter.most_common():
+                    print(f"{count:4}: {form}")
+                    if self.print_ranges:
+                        if count == 1:
+                            print('        ' + ranges[form][0])
+                        else:
+                            prefix = os.path.commonprefix(ranges[form])
+                            print(f'        {prefix} ({" ".join(f[len(prefix):] for f in ranges[form])})')
+            else:
+                for mention in cluster.mentions:
+                    print('   ' + ' '.join([w.form for w in mention.words]))
+                    if self.print_ranges:
+                        print(f"     {mention.head.root.address()}:{mention.span}")

From 8dd20467c3bc97052c8c107ea8f2a8769b599f9e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 6 Mar 2021 12:04:32 +0100
Subject: [PATCH 0380/1374] node.precedes(n) now works across trees and is used
 in mentionA < mentionB

---
 udapi/core/coref.py |  4 ++--
 udapi/core/node.py  | 20 ++++++++++++++++++--
 2 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 13ac3fd4..0cb55e65 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -34,8 +34,8 @@ def __lt__(self, other):
         if node1 is node2:
             node1 = self._words[-1] if self._words else self._head
             node2 = other._words[-1] if other._words else other._head
-            return node1 < node2
-        return node1 < node2
+            return node1.precedes(node2)
+        return node1.precedes(node2)
 
     @property
     def head(self):
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 7fa4ec0c..1f038087 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -127,6 +127,12 @@ def ord(self, new_ord):
         self._ord = new_ord
 
     def __lt__(self, other):
+        """Calling `nodeA < nodeB` is equivalent to `nodeA.ord < nodeB.ord`.
+
+        Note that this does not work as expected for nodes from different trees
+        because `ord` is the word order within each sentence.
+        For comparing the word order across trees, use `nodeA.precedes(nodeB)` instead.
+        """
         return self._ord < other._ord
 
     @property
@@ -660,8 +666,18 @@ def next_node(self):
             return None
 
     def precedes(self, node):
-        """Does this node precedes another `node` in word order (`self.ord < node.ord`)?"""
-        return self._ord < node._ord
+        """Does this node precedes another `node` in word order?
+
+        This method handles correctly also nodes from different trees (but the same zone).
+        If you have nodes from the same tree, it is faster and more elegant to use just `nodeA < nodeB`,
+        which is equivalent to calling `nodeA.ord < nodeB.ord`.
+        For sorting nodes from the same tree, you can use `nodes.sort()` or `sorted(nodes)`.
+        """
+        if self._root is node._root:
+            return self._ord < node._ord
+        if self._root._zone != node._root._zone:
+            raise ValueError(f"Cannot compare word order across zones: {self} {node}")
+        return self._root._bundle.number < node._root._bundle.number
 
     def is_leaf(self):
         """Is this node a leaf, ie. a node without any children?"""

From 07ff9d5e3e87d1d0d24fa6e9905e40458871eb76 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 6 Mar 2021 12:58:47 +0100
Subject: [PATCH 0381/1374] ud.Basic2Enhanced for copying basic deps to
 enhanced deps

---
 udapi/block/ud/basic2enhanced.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 udapi/block/ud/basic2enhanced.py

diff --git a/udapi/block/ud/basic2enhanced.py b/udapi/block/ud/basic2enhanced.py
new file mode 100644
index 00000000..bc5c8b25
--- /dev/null
+++ b/udapi/block/ud/basic2enhanced.py
@@ -0,0 +1,23 @@
+"""Block ud.Basic2Enhanced for copying basic dependencies to enhanced where missing.
+
+UD treebanks are not required to have enhanced dependencies (https://universaldependencies.org/u/overview/enhanced-syntax.html).
+However, if such annotation is present (in the DEPS column of CoNLL-U),
+it must be present in all nodes and all nodes must be reachable from the root
+in the enhanced-deps graph (as checked by the validator).
+There may be use cases where enhanced deps are annotated only in some kinds of nodes (e.g. empty nodes)
+and the rest of nodes is expected to be the same as in the basic dependencies.
+To make such file valid, one can use this block.
+
+This block should not be used on a file with no enhanced dependencies:
+It makes no sense to just duplicate the HEAD+DEPREL information also in the DEPS column.
+"""
+from udapi.core.block import Block
+
+
+class Basic2Enhanced(Block):
+    """Make sure DEPS column is always filled."""
+
+    def process_tree(self, tree):
+        for node in tree.descendants_and_empty:
+            if node.raw_deps == "_":
+                node.raw_deps = f"{node.parent.ord}:{node.deprel}"

From abd220953e088b59f08cc2ce4cf97c3c00b2b68f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 8 Mar 2021 09:56:03 +0100
Subject: [PATCH 0382/1374] better corefud.MoveHead: less warnings, possibility
 to store all bugs in misc['Bug']

---
 udapi/block/corefud/movehead.py | 25 +++++++++++++++++--------
 1 file changed, 17 insertions(+), 8 deletions(-)

diff --git a/udapi/block/corefud/movehead.py b/udapi/block/corefud/movehead.py
index f2e0bea2..50ef1480 100644
--- a/udapi/block/corefud/movehead.py
+++ b/udapi/block/corefud/movehead.py
@@ -6,9 +6,9 @@
 class MoveHead(Block):
     """Block corefud.MoveHead moves the head to the highest node in each mention."""
 
-    def __init__(self, nontreelet='fix', **kwargs):
+    def __init__(self, bugs='warn', **kwargs):
         self.counter = Counter()
-        self.nontreelet = nontreelet
+        self.bugs = bugs
         super().__init__(**kwargs)
 
     def find_head(self, mention):
@@ -19,25 +19,34 @@ def find_head(self, mention):
             self.counter['with_empty'] += 1
             for empty_node in empty_nodes:
                 parents = [d['parent'] for d in empty_node.deps if not d['parent'].is_empty()]
-                if parents and parents[0] not in non_empty:
-                    non_empty.append(parents[0])
+                if parents:
+                    if parents[0] not in non_empty:
+                        non_empty.append(parents[0])
                 else:
                     # TODO we should climb up, but preventing cycles
                     # We could also introduce empty_node.nonempty_ancestor
-                    logging.warning(f"could not find non-empty parent of {empty_node} for mention {mention.head}")
+                    if 'warn' in self.bugs:
+                        logging.warning(f"could not find non-empty parent of {empty_node} for mention {mention.head}")
+                    if 'mark' in self.bugs:
+                        node.misc['Bug'] = 'no-parent-of-empty'
             non_empty.sort()
 
         (highest, added_nodes) = find_minimal_common_treelet(*non_empty)
         if highest in mention.words:
             return highest, 'treelet'
 
-        if 'warn' in self.nontreelet:
+        if 'warn' in self.bugs:
             logging.warning(f"Non-treelet mention in {mention.head} (nearest common antecedent={highest})")
-        if 'mark' in self.nontreelet:
-            node.misc['Mark'] = 'non-treelet-mention'
+        if 'mark' in self.bugs:
+            mention.head.misc['Bug'] = 'non-treelet-mention'
         for word in mention.words:
             if not word.is_empty() and word.parent not in non_empty:
                 return word, 'nontreelet'
+
+        if 'warn' in self.bugs:
+            logging.warning(f"Strange mention {mention.head} (nearest common antecedent={highest})")
+        if 'mark' in self.bugs:
+            mention.head.misc['Bug'] = 'strange-mention'
         return mention.head, 'bug'
 
     def process_document(self, doc):

From dfe8343042b689b9b5ade9f856c6977f994d7726 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 9 Mar 2021 14:51:03 +0100
Subject: [PATCH 0383/1374] printo also average cluster/mention length

---
 udapi/block/corefud/stats.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
index 586c0236..8b919005 100644
--- a/udapi/block/corefud/stats.py
+++ b/udapi/block/corefud/stats.py
@@ -35,6 +35,7 @@ def process_document(self, doc):
             elif len_mentions > 1 and self.exclude_nonsingletons:
                 continue
             self.longest_cluster = max(len_mentions, self.longest_cluster)
+            self.counter['c_total_len'] += len_mentions
             self.counter[f"c_len_{min(len_mentions, self.c_len_max)}"] += 1
 
             self.clusters += 1
@@ -45,6 +46,7 @@ def process_document(self, doc):
                 self.m_words += all_words
                 self.m_empty += all_words - non_empty
                 self.longest_mention = max(non_empty, self.longest_mention)
+                self.counter['m_total_len'] += non_empty
                 self.counter[f"m_len_{min(non_empty, self.m_len_max)}"] += 1
 
     def process_end(self):
@@ -56,14 +58,16 @@ def process_end(self):
         if self.report_clusters:
             columns += [('clusters', f"{self.clusters:7,}"),
                         ('clusters_per1k', f"{1000 * self.clusters / total_nodes_nonzero:6.0f}"),
-                        ('longest_cluster', f"{self.longest_cluster:6}")]
+                        ('longest_cluster', f"{self.longest_cluster:6}"),
+                        ('avg_cluster', f"{self.counter['c_total_len'] / self.clusters:5.1f}")]
             for i in range(1, self.c_len_max + 1):
                 percent = 100 * self.counter[f"c_len_{i}"] / clusters_nonzero
                 columns.append((f"c_len_{i}{'' if i < self.c_len_max else '+'}", f"{percent:5.1f}"))
         if self.report_mentions:
             columns += [('mentions', f"{self.mentions:7,}"),
                         ('mentions_per1k', f"{1000 * self.mentions / total_nodes_nonzero:6.0f}"),
-                        ('longest_mention', f"{self.longest_mention:6}")]
+                        ('longest_mention', f"{self.longest_mention:6}"),
+                        ('avg_mention', f"{self.counter['m_total_len'] / self.mentions:5.1f}")]
             for i in range(0, self.m_len_max + 1):
                 percent = 100 * self.counter[f"m_len_{i}"] / mentions_nonzero
                 columns.append((f"m_len_{i}{'' if i < self.m_len_max else '+'}", f"{percent:5.1f}"))

From 33065f2f771f37a4495aed1e161f1de10ec158ec Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 9 Mar 2021 16:03:50 +0100
Subject: [PATCH 0384/1374] define ordering of mentions with the same first and
 last word

---
 udapi/core/coref.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 0cb55e65..351561ea 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -34,7 +34,8 @@ def __lt__(self, other):
         if node1 is node2:
             node1 = self._words[-1] if self._words else self._head
             node2 = other._words[-1] if other._words else other._head
-            return node1.precedes(node2)
+            if node1 is node2:
+                return len(self._words) < len(other._words)
         return node1.precedes(node2)
 
     @property

From a559ea271a18d5fd9f2fb6069eb8180d530cb360 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 9 Mar 2021 16:16:14 +0100
Subject: [PATCH 0385/1374] don't warn about Non-treelet mention

---
 udapi/block/corefud/movehead.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/corefud/movehead.py b/udapi/block/corefud/movehead.py
index 50ef1480..a0326d98 100644
--- a/udapi/block/corefud/movehead.py
+++ b/udapi/block/corefud/movehead.py
@@ -35,8 +35,8 @@ def find_head(self, mention):
         if highest in mention.words:
             return highest, 'treelet'
 
-        if 'warn' in self.bugs:
-            logging.warning(f"Non-treelet mention in {mention.head} (nearest common antecedent={highest})")
+        #if 'warn' in self.bugs:
+        #    logging.warning(f"Non-treelet mention in {mention.head} (nearest common antecedent={highest})")
         if 'mark' in self.bugs:
             mention.head.misc['Bug'] = 'non-treelet-mention'
         for word in mention.words:

From f0af0dd49dae2bec0f9978e5bffa703977e2bf74 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 10 Mar 2021 12:30:19 +0100
Subject: [PATCH 0386/1374] cluster.mentions should be sorted

at least after loading and before storing to CoNLL-U
because guaranteeing always-sorted mentions would be too difficult.
---
 udapi/core/coref.py | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 351561ea..7d9229bf 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -131,7 +131,6 @@ def cluster_id(self):
 
     @property
     def mentions(self):
-        #TODO return sorted(self._mentions, key=lambda x:...
         return self._mentions
 
     def create_mention(self, head=None, mention_words=None, mention_span=None):
@@ -167,6 +166,7 @@ def create_mention(self, head=None, mention_words=None, mention_span=None):
             mention.words = mention_words
         if mention_span:
             mention.span = mention_span
+        self._mentions.sort()
         return mention
 
     # TODO or should we create a BridgingLinks instance with a fake src_mention?
@@ -330,6 +330,17 @@ def store_coref_to_misc(doc):
         for key in list(node.misc):
             if any(re.match(attr + r'(\[\d+\])?$', key) for attr in attrs):
                 del node.misc[key]
+    # doc._coref_clusters is a dict, which is insertion ordered in Python 3.7+.
+    # The insertion order is sorted according to CorefCluster.__lt__ (see few lines above).
+    # However, new clusters could be added meanwhile or some clusters edited,
+    # so we need to sort the clusters again before storing to MISC.
+    # We also need to mare sure cluster.mentions are sorted in each cluster
+    # because the ordering of clusters is defined by the first mention in each cluster.
+    # Ordering of mentions within a cluster can be changed when e.g. changing the span
+    # of a given mention or reordering words within a sentence and in such events
+    # Udapi currently does not automatically update the ordering of clusters.
+    for cluster in doc._coref_clusters.values():
+        cluster._mentions.sort()
     for cluster in sorted(doc._coref_clusters.values()):
         for mention in cluster.mentions:
             head = mention.head

From aba224bc4493912966fe228e179e1715feb12abe Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 10 Mar 2021 14:41:20 +0100
Subject: [PATCH 0387/1374] stderr was not flushed if redirected to a file

---
 bin/udapy | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/bin/udapy b/bin/udapy
index c7ed8bba..528e3577 100755
--- a/bin/udapy
+++ b/bin/udapy
@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
 import os
 import gc
+import sys
 import atexit
 import logging
 import argparse
@@ -86,6 +87,7 @@ if __name__ == "__main__":
     if not args.gc:
         gc.disable()
         atexit.register(os._exit, 0)
+        atexit.register(sys.stderr.flush)
     if args.save:
         args.scenario = args.scenario + ['write.Conllu']
     if args.save_text_mode_trees:

From bfaf062db53b54cf97a3457c5fc52e8737e9ff45 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 10 Mar 2021 16:30:57 +0100
Subject: [PATCH 0388/1374] typo

---
 udapi/block/corefud/printclusters.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/corefud/printclusters.py b/udapi/block/corefud/printclusters.py
index 163fa1a7..a9a03f5e 100644
--- a/udapi/block/corefud/printclusters.py
+++ b/udapi/block/corefud/printclusters.py
@@ -6,7 +6,7 @@
 class PrintClusters(Block):
     """Block corefud.PrintClusters prints all mentions of a given cluster."""
 
-    def __init__(self, id_re=None, min_mentions=0, print_ranges=True, agregate_mentions=True, **kwargs):
+    def __init__(self, id_re=None, min_mentions=0, print_ranges=True, aggregate_mentions=True, **kwargs):
         """Params:
         id_re: regular expression constraining ClusterId of the clusters to be printed
         min_mentions: print only clusters with with at least N mentions
@@ -17,7 +17,7 @@ def __init__(self, id_re=None, min_mentions=0, print_ranges=True, agregate_menti
         self.id_re = re.compile(str(id_re)) if id_re else None
         self.min_mentions = min_mentions
         self.print_ranges = print_ranges
-        self.agregate_mentions = agregate_mentions
+        self.aggregate_mentions = aggregate_mentions
 
     def process_document(self, doc):
         if 'docname' in doc.meta:
@@ -28,7 +28,7 @@ def process_document(self, doc):
             if len(cluster.mentions) < self.min_mentions:
                 continue
             print(f" {cluster.cluster_id} has {len(cluster.mentions)} mentions:")
-            if self.agregate_mentions:
+            if self.aggregate_mentions:
                 counter = Counter()
                 ranges = defaultdict(list)
                 for mention in cluster.mentions:

From ccc47433cc4f22a67a2a082557c482bfd5603f2b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 10 Mar 2021 18:15:42 +0100
Subject: [PATCH 0389/1374] fail if non-existing ClusterId referenced in
 SplitAnte or Bridging

---
 udapi/core/coref.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 7d9229bf..95260b4b 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -121,9 +121,9 @@ def __lt__(self, other):
         If cluster IDs are not important, it is recommended to use block
         `corefud.IndexClusters` to re-name cluster IDs in accordance with this cluster ordering.
         """
-        if not self.mentions or not other.mentions:
+        if not self._mentions or not other._mentions:
             return self._cluster_id < other._cluster_id
-        return self.mentions[0] < other.mentions[0]
+        return self._mentions[0] < other._mentions[0]
 
     @property
     def cluster_id(self):
@@ -319,6 +319,10 @@ def load_coref_from_misc(doc):
     # In other words, the dict should be sorted by the values (according to CorefCluster.__lt__),
     # not by the keys (cluster_id).
     # In Python 3.7+ (3.6+ in CPython), dicts are guaranteed to be insertion order.
+    for cluster in clusters.values():
+        if not cluster._mentions:
+            raise ValueError(f"Cluster {cluster.cluster_id} referenced in SplitAnte or Bridging, but not defined with ClusterId")
+        cluster._mentions.sort()
     doc._coref_clusters = {c._cluster_id: c for c in sorted(clusters.values())}
 
 

From 9ce505fe51ea98fc91778ca4ea0890df543a9e5b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 10 Mar 2021 18:36:40 +0100
Subject: [PATCH 0390/1374] ordering of clusters should be total even if some
 clusters have no mentions

We want to prevent clusters with no mentions, but that's another issue.
When the ordering is not total, Udapi gives unpredicable and hard-to-debug results.
E.g. when c6 has no mentions, sorted(doc.coref_clusters.values()) gives
c22
c6
c7
c17
although c17 < c22, but this is never tested within sorted.
We can see that c22 < c6 because c6 has no mentions and this comparison
was thus driven by "c22" < "c6" (lexicographically).
c6 < c7, also lexicographically by the cluster_id.
c7 < c17 by their position in the data.
---
 udapi/core/coref.py | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 95260b4b..4e246783 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -116,13 +116,17 @@ def __lt__(self, other):
 
         This method defines a total ordering of all clusters
         by the first mention of each cluster (see `CorefMention.__lt__`).
-        Only if one of the clusters has no mentions (which should not happen normally),
-        the ordering is defined by the `cluster_id` (lexicographically).
+        If one of the clusters has no mentions (which should not happen normally),
+        there is a backup solution (see the source code).
         If cluster IDs are not important, it is recommended to use block
         `corefud.IndexClusters` to re-name cluster IDs in accordance with this cluster ordering.
         """
         if not self._mentions or not other._mentions:
-            return self._cluster_id < other._cluster_id
+            # Clusters without mentions should go first, so the ordering is total.
+            # If both clusters are missing mentions, let's use cluster_id, so the ordering is stable.
+            if not self._mentions and not other._mentions:
+                return self._cluster_id < other._cluster_id
+            return not self._mentions
         return self._mentions[0] < other._mentions[0]
 
     @property

From 6cddc1f3e6e72eaedd48b090d0409375d04f6e51 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 10 Mar 2021 19:14:12 +0100
Subject: [PATCH 0391/1374] bugfix: parsing SplitAnte

---
 udapi/core/coref.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 4e246783..110b1ef1 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -310,9 +310,9 @@ def load_coref_from_misc(doc):
                         split_antes.append(clusters[ante_str])
                     else:
                         # split cataphora, e.g. "We, that is you and me..."
-                        cluster = CorefCluster(ante_str)
-                        clusters[ante_str] = cluster
-                        split_antes.append(cluster)
+                        ante_cl = CorefCluster(ante_str)
+                        clusters[ante_str] = ante_cl
+                        split_antes.append(ante_cl)
                 cluster.split_ante = split_antes
 
             mention.misc = node.misc["MentionMisc" + index_str]

From 5bb27398297bfb5b6bc01933d15815410be7ab7b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 10 Mar 2021 19:42:50 +0100
Subject: [PATCH 0392/1374] keep SplitAnte and Bridging sorted both after
 loading and before saving

---
 udapi/core/coref.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 110b1ef1..243cac63 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -232,7 +232,7 @@ def insert(self, key, new_value):
         self._data.insert(key, BridgingLink(new_value[0], new_value[1]))
 
     def __str__(self):
-        return ','.join(f'{l.target._cluster_id}:{l.relation}' for l in self)
+        return ','.join(f'{l.target._cluster_id}:{l.relation}' for l in sorted(self._data))
 
     def _from_string(self, string, clusters):
         self._data.clear()
@@ -241,6 +241,7 @@ def _from_string(self, string, clusters):
             if target not in clusters:
                 clusters[target] = CorefCluster(target)
             self._data.append(BridgingLink(clusters[target], relation))
+        self._data.sort()
 
     def __call__(self, relations_re=None):
         """Return a subset of links contained in this list as specified by the args.
@@ -313,7 +314,7 @@ def load_coref_from_misc(doc):
                         ante_cl = CorefCluster(ante_str)
                         clusters[ante_str] = ante_cl
                         split_antes.append(ante_cl)
-                cluster.split_ante = split_antes
+                cluster.split_ante = sorted(split_antes)
 
             mention.misc = node.misc["MentionMisc" + index_str]
             index += 1
@@ -371,7 +372,7 @@ def store_coref_to_misc(doc):
             if mention._bridging:
                 head.misc["Bridging" + index_str] = str(mention.bridging)
             if cluster.split_ante:
-                serialized = ','.join((c.cluster_id for c in cluster.split_ante))
+                serialized = ','.join((c.cluster_id for c in sorted(cluster.split_ante)))
                 head.misc["SplitAnte" + index_str] = serialized
             if mention.misc:
                 head.misc["MentionMisc" + index_str] = mention.misc

From 2cade18ac39f7e3a85d5f8aa94dc573e20841657 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 10 Mar 2021 20:18:17 +0100
Subject: [PATCH 0393/1374] fail if loading self-referencing SplitAnte or
 Bridging

---
 udapi/core/coref.py | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 243cac63..8118d905 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -212,6 +212,8 @@ def __init__(self, src_mention, value=None, clusters=None):
                     raise
             elif isinstance(value, collections.abc.Sequence):
                 for v in value:
+                    if v[0] is src_mention._cluster:
+                        raise ValueError("Bridging cannot self-reference the same cluster: " + v[0].cluster_id)
                     self._data.append(BridgingLink(v[0], v[1]))
         super().__init__()
 
@@ -223,12 +225,16 @@ def __len__(self):
 
     # TODO delete backlinks of old links, dtto for SplitAnte
     def __setitem__(self, key, new_value):
+        if new_value[0] is self.src_mention._cluster:
+            raise ValueError("Bridging cannot self-reference the same cluster: " + new_value[0].cluster_id)
         self._data[key] = BridgingLink(new_value[0], new_value[1])
 
     def __delitem__(self, key):
         del self._data[key]
 
     def insert(self, key, new_value):
+        if new_value[0] is self.src_mention._cluster:
+            raise ValueError("Bridging cannot self-reference the same cluster: " + new_value[0].cluster_id)
         self._data.insert(key, BridgingLink(new_value[0], new_value[1]))
 
     def __str__(self):
@@ -238,6 +244,8 @@ def _from_string(self, string, clusters):
         self._data.clear()
         for link_str in string.split(','):
             target, relation = link_str.split(':')
+            if target == self.src_mention._cluster._cluster_id:
+                raise ValueError("Bridging cannot self-reference the same cluster: " + target)
             if target not in clusters:
                 clusters[target] = CorefCluster(target)
             self._data.append(BridgingLink(clusters[target], relation))
@@ -308,6 +316,8 @@ def load_coref_from_misc(doc):
                 # We can delete `.replace('+', ',')` once there are no more data with the legacy plus separator.
                 for ante_str in split_ante_str.replace('+', ',').split(','):
                     if ante_str in clusters:
+                        if ante_str == cluster_id:
+                            raise ValueError("SplitAnte cannot self-reference the same cluster: " + cluster_id)
                         split_antes.append(clusters[ante_str])
                     else:
                         # split cataphora, e.g. "We, that is you and me..."

From 3c25693622ae8158aa1299661809e12c9df93255 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 10 Mar 2021 20:34:57 +0100
Subject: [PATCH 0394/1374] more helpful error msg when calling read.Conllu
 files=""

---
 udapi/core/files.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/core/files.py b/udapi/core/files.py
index 3a13f230..7fcd9149 100644
--- a/udapi/core/files.py
+++ b/udapi/core/files.py
@@ -43,6 +43,8 @@ def __init__(self, filenames=None, filehandle=None, encoding='utf-8'):
         elif isinstance(filenames, list):
             self.filenames = filenames
         elif isinstance(filenames, str):
+            if filenames == '':
+                raise ValueError('Filenames (files=) cannot be an empty string')
             self.filenames = self.string_to_filenames(filenames)
         else:
             raise ValueError('Parameter "filenames" must be a list or str')

From a0568538f435faf1c4924f12766668e0d0a5499a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 11 Mar 2021 04:10:35 +0100
Subject: [PATCH 0395/1374] better corefud.MoveHead implementation (and less
 warnings)

---
 udapi/block/corefud/movehead.py | 53 +++++++++++++++++++++++----------
 1 file changed, 37 insertions(+), 16 deletions(-)

diff --git a/udapi/block/corefud/movehead.py b/udapi/block/corefud/movehead.py
index a0326d98..1cba3e68 100644
--- a/udapi/block/corefud/movehead.py
+++ b/udapi/block/corefud/movehead.py
@@ -11,12 +11,36 @@ def __init__(self, bugs='warn', **kwargs):
         self.bugs = bugs
         super().__init__(**kwargs)
 
+    def _eparents(self, node):
+        if node.deps:
+            return [d['parent'] for d in node.deps]
+        if node.parent:
+            return [node.parent]
+        return []
+
     def find_head(self, mention):
+        mwords = set(mention.words)
+
+        # First, check the simplest case: no empty words and a treelet in basic dependencies.
+        basic_heads = [w for w in mention.words if not w.parent or not w.parent in mwords]
+        assert basic_heads
+        if len(basic_heads) == 1:
+            return basic_heads[0], 'treelet'
+
+        # Second, check also enhanced dependencies (but only within basic_heads for simplicity).
+        enh_heads = [w for w in basic_heads if not any(p in mwords for p in self._eparents(w))]
+        if not enh_heads:
+            enh_heads = [w for w in basic_heads if not all(p in mwords for p in self._eparents(w))]
+            if not enh_heads:
+                return mention.head, 'cycle'
+        if len(enh_heads) == 1:
+            return enh_heads[0], 'treelet'
+
+        # Third, find non-empty parents (ancestors in future) of empty nodes.
         empty_nodes, non_empty = [], []
-        for w in mention.words:
+        for w in enh_heads:
             (empty_nodes if w.is_empty() else non_empty).append(w)
         if empty_nodes:
-            self.counter['with_empty'] += 1
             for empty_node in empty_nodes:
                 parents = [d['parent'] for d in empty_node.deps if not d['parent'].is_empty()]
                 if parents:
@@ -31,23 +55,19 @@ def find_head(self, mention):
                         node.misc['Bug'] = 'no-parent-of-empty'
             non_empty.sort()
 
+        # Fourth, check if there is a node within the enh_heads governing all the mention nodes
+        # and forming thus a "gappy treelet", where the head is clearly the "highest" node.
         (highest, added_nodes) = find_minimal_common_treelet(*non_empty)
-        if highest in mention.words:
-            return highest, 'treelet'
+        if highest in enh_heads:
+            return highest, 'gappy'
+        assert highest not in mwords
 
-        #if 'warn' in self.bugs:
-        #    logging.warning(f"Non-treelet mention in {mention.head} (nearest common antecedent={highest})")
-        if 'mark' in self.bugs:
-            mention.head.misc['Bug'] = 'non-treelet-mention'
-        for word in mention.words:
-            if not word.is_empty() and word.parent not in non_empty:
-                return word, 'nontreelet'
+        # Fifth, try to convervatively preserve the original head, if it is one of the possible heads.
+        if mention.head in enh_heads:
+            return mention.head, 'nontreelet'
 
-        if 'warn' in self.bugs:
-            logging.warning(f"Strange mention {mention.head} (nearest common antecedent={highest})")
-        if 'mark' in self.bugs:
-            mention.head.misc['Bug'] = 'strange-mention'
-        return mention.head, 'bug'
+        # Finally, return the word-order-wise first head candidate as the head.
+        return enh_heads[0], 'nontreelet'
 
     def process_document(self, doc):
         for cluster in doc.coref_clusters.values():
@@ -57,6 +77,7 @@ def process_document(self, doc):
                     self.counter['single-word'] += 1
                 else:
                     new_head, category = self.find_head(mention)
+                    self.counter[category] += 1
                     if new_head is mention.head:
                         self.counter[category + '-kept'] += 1
                     else:

From 720f35d1324d91b425dfb55627bc7836f7dfe197 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 11 Mar 2021 04:42:29 +0100
Subject: [PATCH 0396/1374] when accessing node.deps which were empty, _ was
 changed to an empty string

---
 udapi/block/corefud/movehead.py | 2 +-
 udapi/core/node.py              | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/corefud/movehead.py b/udapi/block/corefud/movehead.py
index 1cba3e68..fc2c8970 100644
--- a/udapi/block/corefud/movehead.py
+++ b/udapi/block/corefud/movehead.py
@@ -12,7 +12,7 @@ def __init__(self, bugs='warn', **kwargs):
         super().__init__(**kwargs)
 
     def _eparents(self, node):
-        if node.deps:
+        if node._raw_deps != '_':
             return [d['parent'] for d in node.deps]
         if node.parent:
             return [node.parent]
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 1f038087..5225724e 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -243,7 +243,7 @@ def raw_deps(self):
         # Afterwards, we can use the following optimization
         #if self._raw_deps is not None:
         #    return self._raw_deps
-        if self._deps is not None:
+        if self._deps:
             self._raw_deps = '|'.join(f"{dep['parent']._ord}:{dep['deprel']}" for dep in self._deps)
         return self._raw_deps
 

From 46ee386b36a86e23c8002c93a15a5d4555788f64 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 11 Mar 2021 12:49:59 +0100
Subject: [PATCH 0397/1374] corefud.MoveHead change assertion to a warning

---
 udapi/block/corefud/movehead.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/udapi/block/corefud/movehead.py b/udapi/block/corefud/movehead.py
index fc2c8970..e9034a22 100644
--- a/udapi/block/corefud/movehead.py
+++ b/udapi/block/corefud/movehead.py
@@ -60,7 +60,12 @@ def find_head(self, mention):
         (highest, added_nodes) = find_minimal_common_treelet(*non_empty)
         if highest in enh_heads:
             return highest, 'gappy'
-        assert highest not in mwords
+        if highest in mwords:
+            if 'warn' in self.bugs:
+                logging.warning(f"Strange mention {mention.head} with highest node {highest}")
+            if 'mark' in self.bugs:
+                highest.misc['Bug'] = 'highest-in-mwords'
+                mention.head.misc['Bug'] = 'highest-head'
 
         # Fifth, try to convervatively preserve the original head, if it is one of the possible heads.
         if mention.head in enh_heads:

From f0efeab769c45ea8966ee3aaad12163a667d4fd4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 11 Mar 2021 17:45:54 +0100
Subject: [PATCH 0398/1374] allow `udapy corefud.Load strict=0 ...` for not
 failing on some errors

Errors, such as
 Cluster {} referenced in SplitAnte or Bridging, but not defined with ClusterId
 SplitAnte cannot self-reference the same cluster
will be only printed to stderr using logging.error,
but no exception will be raised.

You can also use
 udapy -s corefud.Load < in.conllu > out.conllu && diff {in,out}.conllu
---
 udapi/block/corefud/load.py | 12 ++++++++++++
 udapi/core/coref.py         | 23 ++++++++++++++---------
 2 files changed, 26 insertions(+), 9 deletions(-)
 create mode 100644 udapi/block/corefud/load.py

diff --git a/udapi/block/corefud/load.py b/udapi/block/corefud/load.py
new file mode 100644
index 00000000..3b2534bc
--- /dev/null
+++ b/udapi/block/corefud/load.py
@@ -0,0 +1,12 @@
+from udapi.core.block import Block
+import udapi.core.coref
+
+class Load(Block):
+    """Load coreference-related MISC attributes into memory. Allow lenient mode by strict=0."""
+
+    def __init__(self, strict=True):
+        self.strict = strict
+
+    def process_document(self, doc):
+        if doc._coref_clusters is None:
+            udapi.core.coref.load_coref_from_misc(doc, self.strict)
diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 8118d905..6236e4cf 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -198,9 +198,10 @@ class BridgingLinks(collections.abc.MutableSequence):
     >>> bl('Part|Subset').targets == [c12, c56]
     >>> bl.append((c89, 'Funct'))
     """
-    def __init__(self, src_mention, value=None, clusters=None):
+    def __init__(self, src_mention, value=None, clusters=None, strict=True):
         self.src_mention = src_mention
         self._data = []
+        self.strict = strict
         if value is not None:
             if isinstance(value, str):
                 if clusters is None:
@@ -213,7 +214,7 @@ def __init__(self, src_mention, value=None, clusters=None):
             elif isinstance(value, collections.abc.Sequence):
                 for v in value:
                     if v[0] is src_mention._cluster:
-                        raise ValueError("Bridging cannot self-reference the same cluster: " + v[0].cluster_id)
+                        _error("Bridging cannot self-reference the same cluster: " + v[0].cluster_id, strict)
                     self._data.append(BridgingLink(v[0], v[1]))
         super().__init__()
 
@@ -226,7 +227,7 @@ def __len__(self):
     # TODO delete backlinks of old links, dtto for SplitAnte
     def __setitem__(self, key, new_value):
         if new_value[0] is self.src_mention._cluster:
-            raise ValueError("Bridging cannot self-reference the same cluster: " + new_value[0].cluster_id)
+            _error("Bridging cannot self-reference the same cluster: " + new_value[0].cluster_id, self.strict)
         self._data[key] = BridgingLink(new_value[0], new_value[1])
 
     def __delitem__(self, key):
@@ -234,7 +235,7 @@ def __delitem__(self, key):
 
     def insert(self, key, new_value):
         if new_value[0] is self.src_mention._cluster:
-            raise ValueError("Bridging cannot self-reference the same cluster: " + new_value[0].cluster_id)
+            _error("Bridging cannot self-reference the same cluster: " + new_value[0].cluster_id, self.strict)
         self._data.insert(key, BridgingLink(new_value[0], new_value[1]))
 
     def __str__(self):
@@ -245,7 +246,7 @@ def _from_string(self, string, clusters):
         for link_str in string.split(','):
             target, relation = link_str.split(':')
             if target == self.src_mention._cluster._cluster_id:
-                raise ValueError("Bridging cannot self-reference the same cluster: " + target)
+                _error("Bridging cannot self-reference the same cluster: " + target, self.strict)
             if target not in clusters:
                 clusters[target] = CorefCluster(target)
             self._data.append(BridgingLink(clusters[target], relation))
@@ -280,8 +281,12 @@ def create_coref_cluster(head, cluster_id=None, cluster_type=None, **kwargs):
     clusters[cluster_id] = cluster
     return cluster
 
+def _error(msg, strict):
+    if strict:
+        raise ValueError(msg)
+    logging.error(msg)
 
-def load_coref_from_misc(doc):
+def load_coref_from_misc(doc, strict=True):
     clusters = {}
     for node in doc.nodes_and_empty:
         index, index_str = 0, ""
@@ -307,7 +312,7 @@ def load_coref_from_misc(doc):
 
             bridging_str = node.misc["Bridging" + index_str]
             if bridging_str:
-                mention._bridging = BridgingLinks(mention, bridging_str, clusters)
+                mention._bridging = BridgingLinks(mention, bridging_str, clusters, strict)
 
             split_ante_str = node.misc["SplitAnte" + index_str]
             if split_ante_str:
@@ -317,7 +322,7 @@ def load_coref_from_misc(doc):
                 for ante_str in split_ante_str.replace('+', ',').split(','):
                     if ante_str in clusters:
                         if ante_str == cluster_id:
-                            raise ValueError("SplitAnte cannot self-reference the same cluster: " + cluster_id)
+                            _error("SplitAnte cannot self-reference the same cluster: " + cluster_id, strict)
                         split_antes.append(clusters[ante_str])
                     else:
                         # split cataphora, e.g. "We, that is you and me..."
@@ -336,7 +341,7 @@ def load_coref_from_misc(doc):
     # In Python 3.7+ (3.6+ in CPython), dicts are guaranteed to be insertion order.
     for cluster in clusters.values():
         if not cluster._mentions:
-            raise ValueError(f"Cluster {cluster.cluster_id} referenced in SplitAnte or Bridging, but not defined with ClusterId")
+            _error(f"Cluster {cluster.cluster_id} referenced in SplitAnte or Bridging, but not defined with ClusterId", strict)
         cluster._mentions.sort()
     doc._coref_clusters = {c._cluster_id: c for c in sorted(clusters.values())}
 

From c7e16c077618c611b1fcdbdf844d57b60e6a1276 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 13 Mar 2021 02:10:50 +0100
Subject: [PATCH 0399/1374] corefud.Stats now can report also about
 discountinous/non-treelet mentions and head UPOS distribution

---
 udapi/block/corefud/stats.py | 31 +++++++++++++++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
index 8b919005..f07c2a27 100644
--- a/udapi/block/corefud/stats.py
+++ b/udapi/block/corefud/stats.py
@@ -5,12 +5,14 @@ class Stats(Block):
     """Block corefud.Stats prints various coreference-related statistics."""
 
     def __init__(self, m_len_max=5, c_len_max=5, report_mentions=True, report_clusters=True,
+                 report_details=True, selected_upos='NOUN PRON PROPN DET ADJ VERB ADV NUM',
                  exclude_singletons=False, exclude_nonsingletons=False, style='human', **kwargs):
         super().__init__(**kwargs)
         self.m_len_max = m_len_max
         self.c_len_max = c_len_max
         self.report_mentions = report_mentions
         self.report_clusters = report_clusters
+        self.report_details = report_details
         self.exclude_singletons = exclude_singletons
         self.exclude_nonsingletons = exclude_nonsingletons
         self.style = style
@@ -24,7 +26,7 @@ def __init__(self, m_len_max=5, c_len_max=5, report_mentions=True, report_cluste
         self.longest_mention = 0
         self.longest_cluster = 0
         self.m_words = 0
-        self.m_empty = 0
+        self.selected_upos = None if selected_upos == 'all' else selected_upos.split()
 
     def process_document(self, doc):
         self.total_nodes += len(list(doc.nodes))
@@ -39,15 +41,30 @@ def process_document(self, doc):
             self.counter[f"c_len_{min(len_mentions, self.c_len_max)}"] += 1
 
             self.clusters += 1
+            if not self.report_mentions and not self.report_details:
+                continue
             for mention in cluster.mentions:
                 self.mentions += 1
                 all_words = len(mention.words)
                 non_empty = len([w for w in mention.words if not w.is_empty()])
                 self.m_words += all_words
-                self.m_empty += all_words - non_empty
                 self.longest_mention = max(non_empty, self.longest_mention)
                 self.counter['m_total_len'] += non_empty
                 self.counter[f"m_len_{min(non_empty, self.m_len_max)}"] += 1
+                if self.report_details:
+                    upos = 'other'
+                    if not self.selected_upos or mention.head.upos in self.selected_upos:
+                        upos = mention.head.upos
+                    self.counter['m_head_upos_' + upos] += 1
+                    self.counter['m_with_empty'] += 1 if all_words > non_empty else 0
+                    self.counter['m_with_gaps'] += 1 if ',' in mention.span else 0
+                    heads, mwords = 0, set(mention.words)
+                    for w in mention.words:
+                        if w.parent:
+                            heads += 0 if w.parent in mwords else 1
+                        else:
+                            heads += 0 if any(d['parent'] in mwords for d in w.deps) else 1
+                    self.counter['m_nontreelet'] += 1 if heads > 1 else 0
 
     def process_end(self):
         mentions_nonzero = 1 if self.mentions == 0 else self.mentions
@@ -71,6 +88,16 @@ def process_end(self):
             for i in range(0, self.m_len_max + 1):
                 percent = 100 * self.counter[f"m_len_{i}"] / mentions_nonzero
                 columns.append((f"m_len_{i}{'' if i < self.m_len_max else '+'}", f"{percent:5.1f}"))
+        if self.report_details:
+            columns += [('with_empty', f"{100 * self.counter['m_with_empty'] / mentions_nonzero:5.1f}"),
+                        ('with_gaps', f"{100 * self.counter['m_with_gaps'] / mentions_nonzero:5.1f}"),
+                        ('nontreelet', f"{100 * self.counter['m_nontreelet'] / mentions_nonzero:5.1f}"),]
+            if self.selected_upos:
+                upos_list = self.selected_upos + ['other']
+            else:
+                upos_list = [x[12:] for x in self.counter if x.startswith('m_head_upos_')]
+            for upos in upos_list:
+                columns.append(('head_upos=' + upos, f"{100 * self.counter['m_head_upos_' + upos] / mentions_nonzero:5.1f}"))
 
         if self.style == 'tex':
             print(" & ".join(c[1] for c in columns))

From e38fdd7773737776b26bc097a88f3f1e3f4e6bb5 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 25 Mar 2021 14:07:54 +0100
Subject: [PATCH 0400/1374] keep the order of CoNLL-U comment lines using
 placeholders

---
 udapi/block/read/conllu.py  |  4 +++
 udapi/block/write/conllu.py | 72 ++++++++++++++++++++++++++++++++-----
 2 files changed, 67 insertions(+), 9 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 0f750bb7..71886752 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -39,11 +39,13 @@ def parse_comment_line(line, root):
         sent_id_match = RE_SENT_ID.match(line)
         if sent_id_match is not None:
             root.sent_id = sent_id_match.group(1)
+            root.comment += '$SENT_ID\n'
             return
 
         text_match = RE_TEXT.match(line)
         if text_match is not None:
             root.text = text_match.group(1)
+            root.comment += '$TEXT\n'
             return
 
         pardoc_match = RE_NEWPARDOC.match(line)
@@ -51,8 +53,10 @@ def parse_comment_line(line, root):
             value = True if pardoc_match.group(2) is None else pardoc_match.group(2)
             if pardoc_match.group(1) == 'newpar':
                 root.newpar = value
+                root.comment += '$NEWPAR\n'
             else:
                 root.newdoc = value
+                root.comment += '$NEWDOC\n'
             return
 
         json_match = RE_JSON.match(line)
diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index df3adce6..bcdf5e21 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -23,24 +23,78 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
         if not nodes and not self.print_empty_trees:
             return
 
+        # If tree.comment contains placeholders $NEWDOC,...$TEXT, replace them with the actual
+        # value of the attribute and make note on which line (i_*) they were present.
+        comment_lines = tree.comment.splitlines()
+        i_newdoc, i_newpar, i_sent_id, i_text = -1, -1, -1, -1
+        for i, c_line in enumerate(comment_lines):
+            if c_line == '$SENT_ID':
+                i_sent_id = i
+                comment_lines[i] = ' sent_id = ' + tree.sent_id if self.print_sent_id else None
+            elif c_line == '$TEXT':
+                i_text = i
+                if self.print_text:
+                    if tree.text is None:
+                        comment_lines[i] = ' text = ' + tree.compute_text()
+                    else:
+                        comment_lines[i] = ' text = ' + tree.text.replace('\n', '').replace('\r', '').rstrip()
+            elif c_line == '$NEWDOC':
+                i_newdoc = i
+                if self.print_sent_id and tree.newdoc:
+                    comment_lines[i] = ' newdoc' + (' id = ' + tree.newdoc if tree.newdoc is not True else '')
+                else:
+                    comment_lines[i] = None
+            elif c_line == '$NEWPAR':
+                i_newpar = i
+                if self.print_sent_id and tree.newpar:
+                    comment_lines[i] = ' newpar' + (' id = ' + tree.newpar if tree.newpar is not True else '')
+                else:
+                    comment_lines[i] = None
+
+        # Now print the special comments: global.columns, newdoc, newpar, sent_id and text.
+        # If these comments were already present in tree.comment (as marked with the placeholders),
+        # keep them at their original position and print also all comment lines preceding them.
+        # It they were missing, try to print them at the correct position.
+        printed_i = -1
+        if comment_lines and comment_lines[0].startswith(' global.columns'):
+            printed_i += 1
+            print('#' + comment_lines[printed_i])
         if self.print_sent_id:
             if tree.newdoc:
-                 print('# newdoc' + (' id = ' + tree.newdoc if tree.newdoc is not True else ''))
+                if i_newdoc == -1:
+                    print('# newdoc' + (' id = ' + tree.newdoc if tree.newdoc is not True else ''))
+                else:
+                    while printed_i < i_newdoc:
+                        printed_i += 1
+                        if comment_lines[printed_i]:
+                            print('#' + comment_lines[printed_i])
             if tree.newpar:
-                print('# newpar' + (' id = ' + tree.newpar if tree.newpar is not True else ''))
-            print('# sent_id = ' + tree.sent_id)
-
-        if self.print_text:
+                if i_newpar == -1:
+                    print('# newpar' + (' id = ' + tree.newpar if tree.newpar is not True else ''))
+                else:
+                    while printed_i < i_newpar:
+                        printed_i += 1
+                        if comment_lines[printed_i]:
+                            print('#' + comment_lines[printed_i])
+            if i_sent_id == -1:
+                print('# sent_id = ' + tree.sent_id)
+            else:
+                while printed_i < i_sent_id:
+                    printed_i += 1
+                    if comment_lines[printed_i]:
+                        print('#' + comment_lines[printed_i])
+        if self.print_text and i_text == -1:
             print('# text = ' + (tree.compute_text() if tree.text is None else tree.text.replace('\n', '').replace('\r', '').rstrip()))
 
+        for c_line in comment_lines[printed_i + 1:]:
+            if c_line:
+                print('#' + c_line)
+
+        # Special-purpose json_* comments should always be at the end of the comment block.
         if tree.json:
             for key, value in sorted(tree.json.items()):
                 print(f"# json_{key} = {json.dumps(value, ensure_ascii=False, sort_keys=True)}")
 
-        comment = tree.comment
-        if comment:
-            print('#' + comment.rstrip().replace('\n', '\n#'))
-
         last_mwt_id = 0
         for node in nodes:
             mwt = node._mwt

From ddf9bc6f9aa59b5d0e46f8fa9835348bc4f96779 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 26 Mar 2021 19:17:31 +0100
Subject: [PATCH 0401/1374] bugfix fixes #82

---
 udapi/block/write/conllu.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index bcdf5e21..66ae320b 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -102,7 +102,7 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
                 print('\t'.join((mwt.ord_range,
                                  '_' if mwt.form is None else mwt.form,
                                  '_\t_\t_\t_\t_\t_\t_',
-                                 '_' if node._misc is None else str(mwt.misc))))
+                                 '_' if mwt._misc is None else str(mwt.misc))))
                 last_mwt_id = mwt.words[-1]._ord
 
             if node._parent is None:

From cd7523a794dce3048d3578c8984ccd453246406d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 26 Mar 2021 19:18:42 +0100
Subject: [PATCH 0402/1374] bugfix: read.Conll has to reimplement
 read_tree_from_lines()

because read.Conllu does not call parse_node_line() anymore (for speed reasons)
---
 udapi/block/read/conll.py | 64 ++++++++++++++++++++++++++++++++++++++-
 udapi/core/mwt.py         |  4 +--
 2 files changed, 65 insertions(+), 3 deletions(-)

diff --git a/udapi/block/read/conll.py b/udapi/block/read/conll.py
index 7591f924..f64cd9ff 100644
--- a/udapi/block/read/conll.py
+++ b/udapi/block/read/conll.py
@@ -93,7 +93,69 @@ def parse_node_line(self, line, root, nodes, parents, mwts):
                 setattr(node, 'ord', int(fields[n_attribute]))
             elif attribute_name == 'deps':
                 setattr(node, 'raw_deps', fields[n_attribute])
-            elif attribute_name != '_':
+            elif attribute_name != '_' and fields[n_attribute] != '_':
                 setattr(node, attribute_name, fields[n_attribute])
 
         nodes.append(node)
+
+    # Acknowledged code duplication with read.Conllu
+    def read_tree_from_lines(self, lines):
+        root = Root()
+        nodes = [root]
+        parents = [0]
+        mwts = []
+        for line in lines:
+            if line[0] == '#':
+                self.parse_comment_line(line, root)
+            else:
+                self.parse_node_line(line, root, nodes, parents, mwts)
+
+        # If no nodes were read from the filehandle (so only root remained in nodes),
+        # we return None as a sign of failure (end of file or more than one empty line).
+        if len(nodes) == 1:
+            return None
+
+        # Empty sentences are not allowed in CoNLL-U,
+        # but if the users want to save just the sentence string and/or sent_id
+        # they need to create one artificial node and mark it with Empty=Yes.
+        # In that case, we will delete this node, so the tree will have just the (technical) root.
+        # See also udapi.block.write.Conllu, which is compatible with this trick.
+        if len(nodes) == 2 and str(nodes[1].misc) == 'Empty=Yes':
+            nodes.pop()
+            root._children = []
+            root._descendants = []
+
+        # Set dependency parents (now, all nodes of the tree are created).
+        for node_ord, node in enumerate(nodes[1:], 1):
+            try:
+                parent = nodes[parents[node_ord]]
+            except IndexError:
+                raise ValueError("Node %s HEAD is out of range (%d)" % (node, parents[node_ord]))
+            if node is parent:
+                if self.fix_cycles:
+                    logging.warning("Ignoring a cycle (attaching to the root instead):\n%s", node)
+                    node._parent = root
+                    root._children.append(node)
+                else:
+                    raise ValueError(f"Detected a cycle: {node} attached to itself")
+            elif node.children:
+                climbing = parent._parent
+                while climbing:
+                    if climbing is node:
+                        if self.fix_cycles:
+                            logging.warning("Ignoring a cycle (attaching to the root instead):\n%s", parent)
+                            parent = root
+                            break
+                        else:
+                            raise ValueError(f"Detected a cycle: {node}")
+                    climbing = climbing._parent
+            node._parent = parent
+            parent._children.append(node)
+
+        # Create multi-word tokens.
+        for fields in mwts:
+            range_start, range_end = fields[0].split('-')
+            words = nodes[int(range_start):int(range_end) + 1]
+            root.create_multiword_token(words, form=fields[1], misc=fields[-1])
+
+        return root
diff --git a/udapi/core/mwt.py b/udapi/core/mwt.py
index 525b9bb0..684adfaf 100644
--- a/udapi/core/mwt.py
+++ b/udapi/core/mwt.py
@@ -9,7 +9,7 @@ class MWT(object):
     def __init__(self, words=None, form=None, misc=None, root=None):
         self.words = words if words is not None else []
         self.form = form
-        self._misc = DualDict(misc) if misc else None
+        self._misc = DualDict(misc) if misc and misc != '_' else None
         self.root = root
         for word in self.words:
             word._mwt = self  # pylint: disable=W0212
@@ -49,7 +49,7 @@ def address(self):
 
 # TODO: node.remove() should check if the node is not part of any MWT
 # TODO: Document that editing words by mwt.words.append(node), del or remove(node) is not supported
-# TODO: Make mwt._words privat and provide a setter
+# TODO: Make mwt._words private and provide a setter
 # TODO: What to do when mwt.words = []? (It is allowed after mwt=MWT().)
 # TODO: words.setter and node.shift* should check if the MWT does not contain gaps
 #       and is still multi-word

From fd11aa4ca18a31e1e9815ad975f1715555f6a888 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 31 Mar 2021 10:42:18 +0200
Subject: [PATCH 0403/1374] try travis-CI with Windows

---
 .travis.yml | 25 +++++++++++++++++++------
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 92714116..076505dc 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -4,13 +4,26 @@ python:
   - "3.7"
   - "3.8"
   - "3.9"
-before_install:
-  - sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
-  - sudo apt-get update -qq
-  - sudo apt-get install -qq gcc-4.8 g++-4.8
-  - CC=g++-4.8 pip install ufal.udpipe
+#before_install:
+#  - sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
+#  - sudo apt-get update -qq
+#  - sudo apt-get install -qq gcc-4.8 g++-4.8
+#  - CC=g++-4.8 pip install ufal.udpipe
+#install:
+#  - python setup.py install
 install:
-  - python setup.py install
+  - pip install ".[test]"
 script:
   - python -m pytest
   - cd udapi/core/tests && ./external_tests.sh
+matrix:
+  include:
+  - name: "Python 3.7.4 on Windows"
+      os: windows           # Windows 10.0.17134 N/A Build 17134
+      language: shell       # 'language: python' is an error on Travis CI Windows
+      before_install:
+        - choco install python --version 3.7.4
+        - python --version
+        - python -m pip install --upgrade pip
+        - pip3 install --upgrade pytest
+      env: PATH=/c/Python37:/c/Python37/Scripts:$PATH

From 4d074c4d1ba158f5896006a5895b52e1b8988cb3 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 31 Mar 2021 15:39:51 +0200
Subject: [PATCH 0404/1374] Travis-CI for Windows (#84)

---
 .travis.yml | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 076505dc..417e39fb 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -12,18 +12,23 @@ python:
 #install:
 #  - python setup.py install
 install:
-  - pip install ".[test]"
+  - pip3 install ".[test]"
 script:
   - python -m pytest
+  - udapy read.Conllu files=udapi/core/tests/data/babinsky.conllu write.TextModeTrees color=1
   - cd udapi/core/tests && ./external_tests.sh
-matrix:
+jobs:
   include:
-  - name: "Python 3.7.4 on Windows"
-      os: windows           # Windows 10.0.17134 N/A Build 17134
-      language: shell       # 'language: python' is an error on Travis CI Windows
+    - name: "Python 3.9 on Windows"
+      os: windows
+      language: shell
       before_install:
-        - choco install python --version 3.7.4
+        - choco install python
         - python --version
         - python -m pip install --upgrade pip
         - pip3 install --upgrade pytest
-      env: PATH=/c/Python37:/c/Python37/Scripts:$PATH
+      env: PATH=/c/Python39:/c/Python39/Scripts:$PATH
+      script:
+        - python -c 'import colorama;print("\033[31m some red text")'
+        - python -Xutf8 -c 'import udapi;udapi.Document("udapi/core/tests/data/babinsky.conllu").draw(color=1)'
+        - python -m pytest

From af9801167fbf99364b0cd2acb0382137f9c0afc3 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 9 Apr 2021 16:08:30 +0200
Subject: [PATCH 0405/1374] let's version corefud.Gum2CorefUD block in the
 Udapi repo

so it can be used also by users without access to the private CorefUD repo
---
 udapi/block/corefud/gum2corefud.py | 99 ++++++++++++++++++++++++++++++
 1 file changed, 99 insertions(+)
 create mode 100644 udapi/block/corefud/gum2corefud.py

diff --git a/udapi/block/corefud/gum2corefud.py b/udapi/block/corefud/gum2corefud.py
new file mode 100644
index 00000000..95be6ce0
--- /dev/null
+++ b/udapi/block/corefud/gum2corefud.py
@@ -0,0 +1,99 @@
+import re
+import logging
+from collections import defaultdict
+from udapi.core.block import Block
+
+class Gum2CorefUD(Block):
+
+    def process_tree(self, tree):
+        docname = tree.bundle.document.meta['docname'] + '_'
+
+        def entity2cluster_id(name):
+            return docname + name.strip('()').replace(',','').replace('+','')
+
+        clusters = tree.bundle.document.coref_clusters
+        unfinished_mentions = defaultdict(list)
+        for node in tree.descendants:
+            entity = node.misc['Entity']
+            if not entity:
+                continue
+            parts = [x for x in re.split('(\([^())]+\)?|[^())]+\))', entity) if x]
+            for part in parts:
+                # GUM entity name could be e.g.
+                # abstract-173 or place-1-Coron,_Palawan or place-77-Sub-Saharan_Africa.
+                # Note that the wikification part of the name may contain commas and dashes.
+                # Let's take the whole name as cluster_id, which will be normalized later on.
+                # We just need to remove commas and plus signs which are forbidden in cluster_id
+                # because they are used as separators in Bridging and SplitAnte, respectively.
+                # Let's store the type in cluster.cluster_type and Wikification in mention.misc.
+                name = entity2cluster_id(part)
+                if part[0] == '(':
+                    cluster = clusters.get(name)
+                    if cluster is None:
+                        chunks = part.strip('()').split('-', maxsplit=2)
+                        if len(chunks) == 3:
+                            ctype, _, wiki = chunks
+                        elif len(chunks) == 2:
+                            ctype, _, wiki = chunks[0], None, None
+                        else:
+                            raise ValueError(f"Unexpected entity {part} at {node}")
+                        cluster = node.create_coref_cluster(cluster_id=name, cluster_type=ctype)
+                        mention = cluster.mentions[0]
+                        if wiki:
+                            mention.misc = 'Wikification:' + wiki.replace(',', '%2C')
+                    else:
+                        mention = cluster.create_mention(head=node)
+                    if part[-1] == ')':
+                        mention.words = [node]
+                    else:
+                        unfinished_mentions[name].append(mention)
+                elif part[-1] == ')':
+                    if not unfinished_mentions[name]:
+                        logging.warning(f"Mention {name} closed at {node}, but not opened in the same tree.")
+                    else:
+                        mention = unfinished_mentions[name].pop()
+                        mention.span = f'{mention.head.ord}-{node.ord}'
+            del node.misc['Entity']
+
+            misc_bridge = node.misc['Bridge']
+            if misc_bridge:
+                # E.g. Entity=event-23|Bridge=time-23<event-28
+                trg_str, src_str = (entity2cluster_id(x) for x in misc_bridge.split('<'))
+                try:
+                    trg_cluster = clusters[trg_str]
+                    src_cluster = clusters[src_str]
+                except KeyError as err:
+                    logging.warning(f"{node}: Cannot find cluster {err}")
+                else:
+                    mention = src_cluster.mentions[-1]
+                    # TODO: what relation should we choose for Bridging?
+                    # relation = f"{src_str.split('-')[0]}-{trg_str.split('-')[0]}"
+                    relation = '_'
+                    mention.bridging.append((trg_cluster, relation))
+                del node.misc['Bridge']
+
+            misc_split = node.misc['Split']
+            if misc_split:
+                # E.g. Entity=(person-54)|Split=person-4<person-54,person-9<person-54
+                src_str = entity2cluster_id(misc_split.split('<')[-1])
+                ante_clusters = []
+                for x in misc_split.split(','):
+                    ante_str, this_str = (entity2cluster_id(y) for y in x.split('<'))
+                    if this_str != src_str:
+                        logging.warning(f'{node} invalid Split: {this_str} != {src_str}')
+                        # There are just three such cases in GUM and all are bugs,
+                        # so let's ignore them entirely (the `else` clause will be skipped if exiting `for` w/ `break`).
+                        break
+                    ante_clusters.append(clusters[ante_str])
+                else:
+                    clusters[src_str].split_ante = ante_clusters
+                del node.misc['Split']
+
+        for cluster_name, mentions in unfinished_mentions.items():
+            for mention in mentions:
+                logging.warning(f"Mention {name} opened at {mention.head}, but not closed in the same tree. Deleting.")
+                cluster = mention.cluster
+                mention.words = []
+                cluster._mentions.remove(mention)
+                if not cluster._mentions:
+                    del clusters[name]

From 267e5faad06bbe19d36b10588ea4e861efe5071b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 16 Apr 2021 18:04:31 +0200
Subject: [PATCH 0406/1374] Portuguese "no" can be a pronoun as well

fixes #85
---
 udapi/block/ud/pt/addmwt.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/pt/addmwt.py b/udapi/block/ud/pt/addmwt.py
index 11ebfbbf..daa605b2 100644
--- a/udapi/block/ud/pt/addmwt.py
+++ b/udapi/block/ud/pt/addmwt.py
@@ -39,8 +39,8 @@
     'nisso':   {'form': 'em isso', 'lemma': 'em este'},
     'nisto':   {'form': 'em isto', 'lemma': 'em este',
                 'upos': 'ADP PRON', 'main': 1, 'shape': 'subtree'},
-    'no':      {'form': 'em o', 'lemma': 'em o'},
-    'nos':     {'form': 'em os', 'lemma': 'em o'},
+    'no':      {'form': 'em o', 'lemma': 'em o'}, # PRON cases are excluded below
+    'nos':     {'form': 'em os', 'lemma': 'em o'}, # PRON cases are excluded below
     'num':     {'form': 'em um', 'lemma': 'em um'},
     'numa':    {'form': 'em uma', 'lemma': 'em um'},
     'numas':   {'form': 'em umas', 'lemma': 'em um'},
@@ -79,6 +79,11 @@ class AddMwt(udapi.block.ud.addmwt.AddMwt):
 
     def multiword_analysis(self, node):
         """Return a dict with MWT info or None if `node` does not represent a multiword token."""
+
+        # "no" can be either a contraction of "em o", or a pronoun
+        if node.form.lower() in ('no', 'nos') and node.upos == 'PRON':
+            return
+
         analysis = MWTS.get(node.form.lower(), None)
 
         # If the input is e.g.:

From 68b3eab8d2ad0294cc54f94b3298084105654327 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 24 Apr 2021 11:47:40 +0200
Subject: [PATCH 0407/1374] udapy -TMX attributes=ord,form,misc
 corefud.MarkCrossing < in.conllu

---
 udapi/block/corefud/markcrossing.py | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 udapi/block/corefud/markcrossing.py

diff --git a/udapi/block/corefud/markcrossing.py b/udapi/block/corefud/markcrossing.py
new file mode 100644
index 00000000..81136ec9
--- /dev/null
+++ b/udapi/block/corefud/markcrossing.py
@@ -0,0 +1,28 @@
+from udapi.core.block import Block
+import udapi.core.coref
+import itertools
+
+class MarkCrossing(Block):
+    """Find mentions with crossing spans."""
+
+    def __init__(self, same_cluster_only=False, continuous_only=False, print_form=False, **kwargs):
+        super().__init__(**kwargs)
+        self.same_cluster_only = same_cluster_only
+        self.continuous_only = continuous_only
+        self.print_form = print_form
+
+    def _print(self, mention):
+        if self.print_form:
+            return ' '.join([w.form for w in mention.words])
+        else:
+            return mention.span
+
+    def process_node(self, node):
+        if len(node.coref_mentions) > 1:
+            for mA, mB in itertools.combinations(node.coref_mentions, 2):
+                if not (set(mA.words) <= set(mB.words)) and not (set(mB.words) <= set(mA.words)):
+                    if self.same_cluster_only and mA.cluster != mB.cluster:
+                        continue
+                    if self.continuous_only and (',' in mA.span or ',' in mB.span):
+                        continue
+                    node.misc['Mark'] = f'cross:{self._print(mA)}+{self._print(mB)}'

From bf866b26a40da205ea71119e7fca130ed965ffe1 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 2 May 2021 14:16:51 +0200
Subject: [PATCH 0408/1374] prevent creating a cycle in case of ()

i.e. paired punctuation with no words between,
which is causing a non-projective gap.
Fix #90
---
 udapi/block/ud/fixpunct.py | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index cc34a0d0..6fa2da8f 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -232,16 +232,19 @@ def _fix_pair(self, root, opening_node, closing_node):
         # let's break this rule.
         if len(heads) == 0:
             heads = punct_heads
-        if len(heads) == 1:
+        # If there are no nodes between the opening and closing mark (),
+        # let's treat the marks as any other (non-pair) punctuation.
+        if len(heads) == 0:
+            return
+        elif len(heads) == 1:
             opening_node.parent = heads[0]
             closing_node.parent = heads[0]
-            self._punct_type[opening_node.ord] = 'opening'
-            self._punct_type[closing_node.ord] = 'closing'
-        elif len(heads) > 1:
+        else:
             opening_node.parent = sorted(heads, key=lambda n: n.descendants(add_self=1)[0].ord)[0]
             closing_node.parent = sorted(heads, key=lambda n: -n.descendants(add_self=1)[-1].ord)[0]
-            self._punct_type[opening_node.ord] = 'opening'
-            self._punct_type[closing_node.ord] = 'closing'
+
+        self._punct_type[opening_node.ord] = 'opening'
+        self._punct_type[closing_node.ord] = 'closing'
 
         # In rare cases, non-projective gaps may remain. Let's dirty fix these!
         # E.g. in "the (lack of) reproducibility", the closing parenthesis

From 8327a45c81317d61bae945acfab743b01d5693df Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 11 May 2021 09:49:28 +0200
Subject: [PATCH 0409/1374] other characters need to be escaped in TeX

---
 udapi/block/write/tikz.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/write/tikz.py b/udapi/block/write/tikz.py
index 58f53a3d..43417c61 100644
--- a/udapi/block/write/tikz.py
+++ b/udapi/block/write/tikz.py
@@ -91,6 +91,9 @@ def after_process_document(self, doc):
         logging.info('Use pdflatex to compile the output')
         super().after_process_document(doc)
 
+    def _tex_escape(self, string):
+        return string.replace('_', r'\_').replace('$', '\$').replace('[', '$[$').replace(']', '$]$')
+
     def process_tree(self, tree):
         print(r'\begin{dependency}')
         print(r'\begin{deptext}')
@@ -109,7 +112,7 @@ def process_tree(self, tree):
 
         lines = ['' for _ in self.node_attributes]
         for node in nodes:
-            values = [v.replace('_', r'\_') for v in node.get_attrs(self.node_attributes)]
+            values = [self._tex_escape(v) for v in node.get_attrs(self.node_attributes)]
             max_len = max(len(value) for value in values)
             for index, value in enumerate(values):
                 if node.ord > 1:

From 6bbdfc30b5f042f28bbdb19a92713e03707cc26b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 11 May 2021 09:51:14 +0200
Subject: [PATCH 0410/1374] document how to use write.TextModeTrees in LaTeX &
 tiny improvements

---
 udapi/block/write/textmodetrees.py | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index fb38c22a..be2f999d 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -127,6 +127,14 @@ class TextModeTrees(BaseWriter):
     which is useful for printing subtrees using ``node.draw()``,
     which is internally implemented using this block.
 
+    For use in LaTeX, you can insert the output of this block (without colors)
+    into \begin{verbatim}...\end{verbatim}, but you need to compile with pdflatex (xelatex not supported)
+    and you must add the following code into the preambule::
+
+      \\usepackage{pmboxdraw}
+      \DeclareUnicodeCharacter{256D}{\textSFi}  %╭
+      \DeclareUnicodeCharacter{2570}{\textSFii} %╰
+
     SEE ALSO
     :py:class:`.TextModeTreesHtml`
     """
@@ -205,7 +213,7 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
             self.mark_re = re.compile(mark + '=')
             self.comment_mark_re = re.compile(r'^ %s = ' % mark, re.M)
         self._index_of = []
-        self._gaps = []
+        self._gaps = collections.Counter()
         self.lines = []
         self.lengths = []
 
@@ -255,7 +263,6 @@ def process_tree(self, root):
 
         # Precompute the number of non-projective gaps for each subtree
         if self.minimize_cross:
-            self._gaps = collections.Counter()
             self._compute_gaps(root)
 
         # Precompute lines for printing
@@ -291,7 +298,7 @@ def process_tree(self, root):
 
             # sorting the stack to minimize crossings of edges
             if self.minimize_cross:
-                stack = sorted(stack, key=lambda x: -self._gaps[x.ord])
+                stack.sort(key=lambda x: -self._gaps[x.ord])
 
         if self.layout == 'classic':
             for idx, node in enumerate(allnodes):

From 4a8e21aa7c920f91214010781dafe61e5567d297 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 11 May 2021 12:01:22 +0200
Subject: [PATCH 0411/1374] corefud.PrintMentions for printing mentions with
 various properties

always highlighting just a single mention per tree
---
 udapi/block/corefud/printmentions.py | 55 ++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 udapi/block/corefud/printmentions.py

diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
new file mode 100644
index 00000000..250474ce
--- /dev/null
+++ b/udapi/block/corefud/printmentions.py
@@ -0,0 +1,55 @@
+from udapi.core.block import Block
+import udapi.core.coref
+
+class PrintMentions(Block):
+    """Print mentions with various properties."""
+
+    def __init__(self, continuous='include', treelet='include',
+                 oneword='include', singleton='include', **kwargs):
+        super().__init__(**kwargs)
+        self.continuous = self._convert(continuous)
+        self.treelet = self._convert(treelet)
+        self.oneword = self._convert(oneword)
+        self.singleton = self._convert(singleton)
+
+
+    def _convert(self, value):
+        if value in {'include', 'exclude', 'only'}:
+            return value
+        if value == 1:
+            return 'only'
+        if value == 0:
+            return 'exclude'
+        raise ValueError('unknown value ' + value)
+
+    def _ok(self, condition, value):
+        if value == 'include':
+            return True
+        return (condition and value == 'only') or (not condition and value=='exclude')
+
+    def process_document(self, doc):
+        for cluster in doc.coref_clusters.values():
+            if not self._ok(len(cluster.mentions) == 1, self.singleton):
+                continue
+
+            for mention in cluster.mentions:
+                if not self._ok(len(mention.words) == 1, self.oneword):
+                    continue
+                if not self._ok(',' in mention.span, self.continuous):
+                    continue
+
+                heads, mwords = 0, set(mention.words)
+                for w in mention.words:
+                    if w.parent:
+                        heads += 0 if w.parent in mwords else 1
+                    else:
+                        heads += 0 if any(d['parent'] in mwords for d in w.deps) else 1
+                if not self._ok(heads <= 1, self.treelet):
+                    continue
+
+                for w in mention.words:
+                    w.misc['Mark'] = 1
+                mention.head.root.draw()
+                for w in mention.words:
+                    del w.misc['Mark']
+

From 3c995ce236e103d26f6dcadda4535e6d4f758d7b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 11 May 2021 12:06:44 +0200
Subject: [PATCH 0412/1374] oops, continuous == no comma in span

---
 udapi/block/corefud/printmentions.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
index 250474ce..b226d909 100644
--- a/udapi/block/corefud/printmentions.py
+++ b/udapi/block/corefud/printmentions.py
@@ -35,7 +35,7 @@ def process_document(self, doc):
             for mention in cluster.mentions:
                 if not self._ok(len(mention.words) == 1, self.oneword):
                     continue
-                if not self._ok(',' in mention.span, self.continuous):
+                if not self._ok(',' not in mention.span, self.continuous):
                     continue
 
                 heads, mwords = 0, set(mention.words)

From 77ed69c83c4af449970c24ddefee1b14b908dca8 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 11 May 2021 13:25:24 +0200
Subject: [PATCH 0413/1374] html output and other options

---
 udapi/block/corefud/printmentions.py | 51 +++++++++++++++++++++++++---
 1 file changed, 47 insertions(+), 4 deletions(-)

diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
index b226d909..3dd0e51d 100644
--- a/udapi/block/corefud/printmentions.py
+++ b/udapi/block/corefud/printmentions.py
@@ -1,17 +1,35 @@
 from udapi.core.block import Block
 import udapi.core.coref
+from udapi.block.write.textmodetreeshtml import TextModeTreesHtml
+from udapi.block.write.textmodetrees import TextModeTrees
 
 class PrintMentions(Block):
     """Print mentions with various properties."""
 
-    def __init__(self, continuous='include', treelet='include',
-                 oneword='include', singleton='include', **kwargs):
+    def __init__(self, continuous='include', treelet='include', forest='include',
+                 almost_forest='include', oneword='include', singleton='include',
+                 max_trees=100, html=False,
+                 print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
+                 minimize_cross=True, color=True, attributes='form,upos,deprel',
+                 print_undef_as='_', print_doc_meta=True, print_comments=False,
+                 mark='(Mark)', hints=True, layout='classic',
+                 **kwargs):
         super().__init__(**kwargs)
         self.continuous = self._convert(continuous)
         self.treelet = self._convert(treelet)
+        self.forest = self._convert(forest)
+        self.almost_forest = self._convert(almost_forest)
         self.oneword = self._convert(oneword)
         self.singleton = self._convert(singleton)
 
+        self.max_trees = max_trees
+        self.html = html
+        print_class = TextModeTreesHtml if html else TextModeTrees
+        self.print_block = print_class(
+                print_sent_id=print_sent_id, print_text=print_text, add_empty_line=add_empty_line, indent=indent,
+                minimize_cross=minimize_cross, color=color, attributes=attributes,
+                print_undef_as=print_undef_as, print_doc_meta=print_doc_meta, print_comments=print_comments,
+                mark=mark, hints=hints, layout=layout)
 
     def _convert(self, value):
         if value in {'include', 'exclude', 'only'}:
@@ -22,12 +40,29 @@ def _convert(self, value):
             return 'exclude'
         raise ValueError('unknown value ' + value)
 
+    def before_process_document(self, document):
+        self.print_block.before_process_document(document)
+
+    def after_process_document(self, document):
+        self.print_block.after_process_document(document)
+
     def _ok(self, condition, value):
         if value == 'include':
             return True
         return (condition and value == 'only') or (not condition and value=='exclude')
 
+    def _is_forest(self, mention, mwords, almost):
+        for w in mention.words:
+            for ch in w.children():
+                if ch not in mwords:
+                    if not almost:
+                        return False
+                    if not w.parent or w.parent in mwords or ch.udeprel not in {'case', 'cc', 'punct', 'conj'}:
+                        return False
+        return True
+
     def process_document(self, doc):
+        printed_trees = 0
         for cluster in doc.coref_clusters.values():
             if not self._ok(len(cluster.mentions) == 1, self.singleton):
                 continue
@@ -46,10 +81,18 @@ def process_document(self, doc):
                         heads += 0 if any(d['parent'] in mwords for d in w.deps) else 1
                 if not self._ok(heads <= 1, self.treelet):
                     continue
+                if self.forest != 'include' and not self._ok(self._is_forest(mention, mwords, False), self.forest):
+                    continue
+                if self.almost_forest != 'include' and not self._ok(self._is_forest(mention, mwords, True), self.almost_forest):
+                    continue
 
                 for w in mention.words:
                     w.misc['Mark'] = 1
-                mention.head.root.draw()
+                if self.max_trees:
+                    printed_trees += 1
+                    if printed_trees > self.max_trees:
+                        return
+                    #print(f"{printed_trees}/{self.max_trees}")
+                self.print_block.process_tree(mention.head.root)
                 for w in mention.words:
                     del w.misc['Mark']
-

From c6c57ecfb0ee0009e3ee9dbcce900cd6c4df6ddf Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 11 May 2021 13:44:41 +0200
Subject: [PATCH 0414/1374] more exceptions

---
 udapi/block/corefud/printmentions.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
index 3dd0e51d..5146a34e 100644
--- a/udapi/block/corefud/printmentions.py
+++ b/udapi/block/corefud/printmentions.py
@@ -57,7 +57,7 @@ def _is_forest(self, mention, mwords, almost):
                 if ch not in mwords:
                     if not almost:
                         return False
-                    if not w.parent or w.parent in mwords or ch.udeprel not in {'case', 'cc', 'punct', 'conj'}:
+                    if not w.parent or w.parent in mwords or ch.udeprel not in {'case', 'cc', 'punct', 'conj', 'appos', 'cop', 'aux'}:
                         return False
         return True
 

From 45a6fe46f3fb6f9e3bcc9a43f3b2ab3d3b796fb7 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 11 May 2021 15:40:12 +0200
Subject: [PATCH 0415/1374] option "empty"

---
 udapi/block/corefud/printmentions.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
index 5146a34e..08fef23c 100644
--- a/udapi/block/corefud/printmentions.py
+++ b/udapi/block/corefud/printmentions.py
@@ -8,7 +8,7 @@ class PrintMentions(Block):
 
     def __init__(self, continuous='include', treelet='include', forest='include',
                  almost_forest='include', oneword='include', singleton='include',
-                 max_trees=100, html=False,
+                 empty='include', max_trees=100, html=False,
                  print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
                  minimize_cross=True, color=True, attributes='form,upos,deprel',
                  print_undef_as='_', print_doc_meta=True, print_comments=False,
@@ -21,6 +21,7 @@ def __init__(self, continuous='include', treelet='include', forest='include',
         self.almost_forest = self._convert(almost_forest)
         self.oneword = self._convert(oneword)
         self.singleton = self._convert(singleton)
+        self.empty = self._convert(empty)
 
         self.max_trees = max_trees
         self.html = html
@@ -73,6 +74,10 @@ def process_document(self, doc):
                 if not self._ok(',' not in mention.span, self.continuous):
                     continue
 
+                empty_mwords = [w for w in mention.words if w.is_empty()]
+                if not self._ok(len(empty_mwords) > 0, self.empty):
+                    continue
+
                 heads, mwords = 0, set(mention.words)
                 for w in mention.words:
                     if w.parent:

From 996517090e9c3d2da2757cf76c9e52bd880ec04a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 11 May 2021 17:09:23 +0200
Subject: [PATCH 0416/1374] AnCora in CorefUD has all deprels=dep, so use upos
 instead

---
 udapi/block/corefud/printmentions.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
index 08fef23c..521b4cc6 100644
--- a/udapi/block/corefud/printmentions.py
+++ b/udapi/block/corefud/printmentions.py
@@ -52,13 +52,20 @@ def _ok(self, condition, value):
             return True
         return (condition and value == 'only') or (not condition and value=='exclude')
 
+    def _is_auxiliary(self, node):
+        if node.udeprel in {'case', 'cc', 'punct', 'conj', 'mark', 'appos', 'cop', 'aux'}:
+            return True
+        if node.udeprel == 'dep' and node.upos in {'ADP', 'SCONJ', 'CCONJ'}:
+            return True
+        return False
+
     def _is_forest(self, mention, mwords, almost):
         for w in mention.words:
             for ch in w.children():
                 if ch not in mwords:
                     if not almost:
                         return False
-                    if not w.parent or w.parent in mwords or ch.udeprel not in {'case', 'cc', 'punct', 'conj', 'appos', 'cop', 'aux'}:
+                    if not (w.parent and w.parent not in mwords and self._is_auxiliary(ch)):
                         return False
         return True
 

From d4bbdfd232bbf52562f389a8e39c8bd9709834bb Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 13 May 2021 12:38:22 +0200
Subject: [PATCH 0417/1374] corefud.PrintMentions almost_continuous

---
 udapi/block/corefud/printmentions.py | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
index 521b4cc6..60de30eb 100644
--- a/udapi/block/corefud/printmentions.py
+++ b/udapi/block/corefud/printmentions.py
@@ -6,8 +6,8 @@
 class PrintMentions(Block):
     """Print mentions with various properties."""
 
-    def __init__(self, continuous='include', treelet='include', forest='include',
-                 almost_forest='include', oneword='include', singleton='include',
+    def __init__(self, continuous='include', almost_continuous='include', treelet='include',
+                 forest='include', almost_forest='include', oneword='include', singleton='include',
                  empty='include', max_trees=100, html=False,
                  print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
                  minimize_cross=True, color=True, attributes='form,upos,deprel',
@@ -16,6 +16,7 @@ def __init__(self, continuous='include', treelet='include', forest='include',
                  **kwargs):
         super().__init__(**kwargs)
         self.continuous = self._convert(continuous)
+        self.almost_continuous = self._convert(almost_continuous)
         self.treelet = self._convert(treelet)
         self.forest = self._convert(forest)
         self.almost_forest = self._convert(almost_forest)
@@ -69,6 +70,19 @@ def _is_forest(self, mention, mwords, almost):
                         return False
         return True
 
+    def _is_almost_continuous(self, mention):
+        if ',' not in mention.span:
+            return True
+        nonempty = [w for w in mention.words if not w.is_empty()]
+        if not nonempty:
+            return True
+        mwords = set(mention.words)
+        gap_nodes = [w for w in mention.head.root.descendants if w > nonempty[0] and w < nonempty[-1] and not w in mwords]
+        for gap_node in gap_nodes:
+            if not gap_node.is_empty():
+                return False
+        return True
+
     def process_document(self, doc):
         printed_trees = 0
         for cluster in doc.coref_clusters.values():
@@ -80,6 +94,8 @@ def process_document(self, doc):
                     continue
                 if not self._ok(',' not in mention.span, self.continuous):
                     continue
+                if self.almost_continuous != 'include' and not self._ok(self._is_almost_continuous(mention), self.almost_continuous):
+                    continue
 
                 empty_mwords = [w for w in mention.words if w.is_empty()]
                 if not self._ok(len(empty_mwords) > 0, self.empty):

From 21c6a7f07c000430d02d8b58b739f53825085a06 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 13 May 2021 18:21:01 +0200
Subject: [PATCH 0418/1374] TextModeTrees color=0 now highlights marked nodes
 with **asterisks**

---
 udapi/block/write/textmodetrees.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index be2f999d..d427098a 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -359,11 +359,14 @@ def add_node(self, idx, node):
         if not node.is_root():
             values = node.get_attrs(self.attrs, undefs=self.print_undef_as)
             self.lengths[idx] += 1 + len(' '.join(values))
+            marked = self.is_marked(node)
             if self.color:
-                marked = self.is_marked(node)
                 for i, attr in enumerate(self.attrs):
                     values[i] = self.colorize_attr(attr, values[i], marked)
-            self.lines[idx] += ' ' + ' '.join(values)
+            if not self.color and marked:
+                self.lines[idx] += ' **' + ' '.join(values) + '**'
+            else:
+                self.lines[idx] += ' ' + ' '.join(values)
 
     def is_marked(self, node):
         """Should a given node be highlighted?"""

From ac7360d47428e296d462c89973a9282f2bb1f84e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 13 May 2021 18:59:31 +0200
Subject: [PATCH 0419/1374] PrintMentions shuffle=1 by default (and shuffle=0
 sorts mentions)

---
 udapi/block/corefud/printmentions.py | 82 +++++++++++++++-------------
 udapi/block/write/textmodetrees.py   |  1 +
 2 files changed, 46 insertions(+), 37 deletions(-)

diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
index 60de30eb..0c1d4e79 100644
--- a/udapi/block/corefud/printmentions.py
+++ b/udapi/block/corefud/printmentions.py
@@ -1,5 +1,5 @@
+import random
 from udapi.core.block import Block
-import udapi.core.coref
 from udapi.block.write.textmodetreeshtml import TextModeTreesHtml
 from udapi.block.write.textmodetrees import TextModeTrees
 
@@ -8,7 +8,7 @@ class PrintMentions(Block):
 
     def __init__(self, continuous='include', almost_continuous='include', treelet='include',
                  forest='include', almost_forest='include', oneword='include', singleton='include',
-                 empty='include', max_trees=100, html=False,
+                 empty='include', max_trees=0, html=False, shuffle=True,
                  print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
                  minimize_cross=True, color=True, attributes='form,upos,deprel',
                  print_undef_as='_', print_doc_meta=True, print_comments=False,
@@ -26,6 +26,9 @@ def __init__(self, continuous='include', almost_continuous='include', treelet='i
 
         self.max_trees = max_trees
         self.html = html
+        self.shuffle = shuffle
+        if shuffle:
+            random.seed(42)
         print_class = TextModeTreesHtml if html else TextModeTrees
         self.print_block = print_class(
                 print_sent_id=print_sent_id, print_text=print_text, add_empty_line=add_empty_line, indent=indent,
@@ -84,43 +87,48 @@ def _is_almost_continuous(self, mention):
         return True
 
     def process_document(self, doc):
-        printed_trees = 0
+        mentions = []
         for cluster in doc.coref_clusters.values():
-            if not self._ok(len(cluster.mentions) == 1, self.singleton):
-                continue
+            if self._ok(len(cluster.mentions) == 1, self.singleton):
+                mentions.extend(cluster.mentions)
+        if self.shuffle:
+            random.shuffle(mentions)
+        else:
+            mentions.sort()
 
-            for mention in cluster.mentions:
-                if not self._ok(len(mention.words) == 1, self.oneword):
-                    continue
-                if not self._ok(',' not in mention.span, self.continuous):
-                    continue
-                if self.almost_continuous != 'include' and not self._ok(self._is_almost_continuous(mention), self.almost_continuous):
-                    continue
+        printed_trees = 0
+        for mention in mentions:
+            if not self._ok(len(mention.words) == 1, self.oneword):
+                continue
+            if not self._ok(',' not in mention.span, self.continuous):
+                continue
+            if self.almost_continuous != 'include' and not self._ok(self._is_almost_continuous(mention), self.almost_continuous):
+                continue
 
-                empty_mwords = [w for w in mention.words if w.is_empty()]
-                if not self._ok(len(empty_mwords) > 0, self.empty):
-                    continue
+            empty_mwords = [w for w in mention.words if w.is_empty()]
+            if not self._ok(len(empty_mwords) > 0, self.empty):
+                continue
 
-                heads, mwords = 0, set(mention.words)
-                for w in mention.words:
-                    if w.parent:
-                        heads += 0 if w.parent in mwords else 1
-                    else:
-                        heads += 0 if any(d['parent'] in mwords for d in w.deps) else 1
-                if not self._ok(heads <= 1, self.treelet):
-                    continue
-                if self.forest != 'include' and not self._ok(self._is_forest(mention, mwords, False), self.forest):
-                    continue
-                if self.almost_forest != 'include' and not self._ok(self._is_forest(mention, mwords, True), self.almost_forest):
-                    continue
+            heads, mwords = 0, set(mention.words)
+            for w in mention.words:
+                if w.parent:
+                    heads += 0 if w.parent in mwords else 1
+                else:
+                    heads += 0 if any(d['parent'] in mwords for d in w.deps) else 1
+            if not self._ok(heads <= 1, self.treelet):
+                continue
+            if self.forest != 'include' and not self._ok(self._is_forest(mention, mwords, False), self.forest):
+                continue
+            if self.almost_forest != 'include' and not self._ok(self._is_forest(mention, mwords, True), self.almost_forest):
+                continue
 
-                for w in mention.words:
-                    w.misc['Mark'] = 1
-                if self.max_trees:
-                    printed_trees += 1
-                    if printed_trees > self.max_trees:
-                        return
-                    #print(f"{printed_trees}/{self.max_trees}")
-                self.print_block.process_tree(mention.head.root)
-                for w in mention.words:
-                    del w.misc['Mark']
+            for w in mention.words:
+                w.misc['Mark'] = 1
+            if self.max_trees:
+                printed_trees += 1
+                if printed_trees > self.max_trees:
+                    print(f'######## Only first {self.max_trees} trees printed. Use max_trees=0 to see all.')
+                    return
+            self.print_block.process_tree(mention.head.root)
+            for w in mention.words:
+                del w.misc['Mark']
diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index d427098a..f3f6e007 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -365,6 +365,7 @@ def add_node(self, idx, node):
                     values[i] = self.colorize_attr(attr, values[i], marked)
             if not self.color and marked:
                 self.lines[idx] += ' **' + ' '.join(values) + '**'
+                self.lengths[idx] += 4
             else:
                 self.lines[idx] += ' ' + ' '.join(values)
 

From 93269127f43089e79dc250cfd4968bf0d3aff811 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 13 May 2021 19:20:46 +0200
Subject: [PATCH 0420/1374] printMentions print_other_forms=5 by default

---
 udapi/block/corefud/printmentions.py | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
index 0c1d4e79..4a122ccb 100644
--- a/udapi/block/corefud/printmentions.py
+++ b/udapi/block/corefud/printmentions.py
@@ -1,4 +1,5 @@
 import random
+from collections import Counter
 from udapi.core.block import Block
 from udapi.block.write.textmodetreeshtml import TextModeTreesHtml
 from udapi.block.write.textmodetrees import TextModeTrees
@@ -8,7 +9,7 @@ class PrintMentions(Block):
 
     def __init__(self, continuous='include', almost_continuous='include', treelet='include',
                  forest='include', almost_forest='include', oneword='include', singleton='include',
-                 empty='include', max_trees=0, html=False, shuffle=True,
+                 empty='include', max_trees=0, html=False, shuffle=True, print_other_forms=5,
                  print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
                  minimize_cross=True, color=True, attributes='form,upos,deprel',
                  print_undef_as='_', print_doc_meta=True, print_comments=False,
@@ -29,6 +30,7 @@ def __init__(self, continuous='include', almost_continuous='include', treelet='i
         self.shuffle = shuffle
         if shuffle:
             random.seed(42)
+        self.print_other_forms = print_other_forms
         print_class = TextModeTreesHtml if html else TextModeTrees
         self.print_block = print_class(
                 print_sent_id=print_sent_id, print_text=print_text, add_empty_line=add_empty_line, indent=indent,
@@ -129,6 +131,20 @@ def process_document(self, doc):
                 if printed_trees > self.max_trees:
                     print(f'######## Only first {self.max_trees} trees printed. Use max_trees=0 to see all.')
                     return
+
+            this_form = ' '.join([w.form for w in mention.words])
+            print("# Mention = " + this_form)
+            if self.print_other_forms:
+                counter = Counter()
+                for m in mention.cluster.mentions:
+                    forms = ' '.join([w.form for w in m.words])
+                    if forms != this_form:
+                        counter[forms] += 1
+                if counter:
+                    print(f"# {min(len(counter), self.print_other_forms)} other forms:", end='')
+                    for form, count in counter.most_common(self.print_other_forms):
+                        print(f' "{form}"({count})', end='')
+                    print()
             self.print_block.process_tree(mention.head.root)
             for w in mention.words:
                 del w.misc['Mark']

From 61ba542511507546d0a718458ebf3f1ac85eb903 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 14 May 2021 14:03:21 +0200
Subject: [PATCH 0421/1374] better copula handling

---
 udapi/block/corefud/printmentions.py | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
index 4a122ccb..e4c4cd5d 100644
--- a/udapi/block/corefud/printmentions.py
+++ b/udapi/block/corefud/printmentions.py
@@ -58,20 +58,27 @@ def _ok(self, condition, value):
             return True
         return (condition and value == 'only') or (not condition and value=='exclude')
 
-    def _is_auxiliary(self, node):
-        if node.udeprel in {'case', 'cc', 'punct', 'conj', 'mark', 'appos', 'cop', 'aux'}:
+    def _is_auxiliary_etc(self, node):
+        if node.udeprel in {'case', 'cc', 'punct', 'conj', 'mark', 'appos', 'aux', 'vocative'}:
             return True
-        if node.udeprel == 'dep' and node.upos in {'ADP', 'SCONJ', 'CCONJ'}:
+        if node.udeprel == 'dep' and node.upos in {'ADP', 'SCONJ', 'CCONJ', 'PUNCT'}:
             return True
         return False
 
     def _is_forest(self, mention, mwords, almost):
         for w in mention.words:
-            for ch in w.children():
+            # UD unfortunatelly does not use the copula-as-head style for copula construction,
+            # so e.g. in "It is my fault", "fault" is the root of the tree and all other words its children.
+            # However, in the cop-as-head stule, only "my" would depend on "fault" (and should be part of the mention).
+            # It is difficult to tell apart which w.children are related to w and which to the copula.
+            # We thus ignore these cases completely (we expect any child is potentially related to the copula).
+            if any(ch.udeprel == 'cop' for ch in w.children):
+                continue
+            for ch in w.children:
                 if ch not in mwords:
                     if not almost:
                         return False
-                    if not (w.parent and w.parent not in mwords and self._is_auxiliary(ch)):
+                    if not (w.parent and w.parent not in mwords and self._is_auxiliary_etc(ch)):
                         return False
         return True
 

From b08bfdfa6c2ec1759d13f49b45e3c59e74fdcfff Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 14 May 2021 14:16:13 +0200
Subject: [PATCH 0422/1374] aux should not be in the list when copula
 constructions are handled elsewhere

---
 udapi/block/corefud/printmentions.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
index e4c4cd5d..33efdd66 100644
--- a/udapi/block/corefud/printmentions.py
+++ b/udapi/block/corefud/printmentions.py
@@ -59,7 +59,7 @@ def _ok(self, condition, value):
         return (condition and value == 'only') or (not condition and value=='exclude')
 
     def _is_auxiliary_etc(self, node):
-        if node.udeprel in {'case', 'cc', 'punct', 'conj', 'mark', 'appos', 'aux', 'vocative'}:
+        if node.udeprel in {'case', 'cc', 'punct', 'conj', 'mark', 'appos', 'vocative'}:
             return True
         if node.udeprel == 'dep' and node.upos in {'ADP', 'SCONJ', 'CCONJ', 'PUNCT'}:
             return True

From 39134031a5c5e7544dab32f7ec83875dfde35f01 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 18 May 2021 04:07:12 +0200
Subject: [PATCH 0423/1374] corefud.PrintMentions print_total=1

---
 udapi/block/corefud/printmentions.py | 51 ++++++++++++++++------------
 1 file changed, 30 insertions(+), 21 deletions(-)

diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
index 33efdd66..e26ee6e2 100644
--- a/udapi/block/corefud/printmentions.py
+++ b/udapi/block/corefud/printmentions.py
@@ -10,6 +10,7 @@ class PrintMentions(Block):
     def __init__(self, continuous='include', almost_continuous='include', treelet='include',
                  forest='include', almost_forest='include', oneword='include', singleton='include',
                  empty='include', max_trees=0, html=False, shuffle=True, print_other_forms=5,
+                 print_total=True,
                  print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
                  minimize_cross=True, color=True, attributes='form,upos,deprel',
                  print_undef_as='_', print_doc_meta=True, print_comments=False,
@@ -31,6 +32,7 @@ def __init__(self, continuous='include', almost_continuous='include', treelet='i
         if shuffle:
             random.seed(42)
         self.print_other_forms = print_other_forms
+        self.print_total = print_total,
         print_class = TextModeTreesHtml if html else TextModeTrees
         self.print_block = print_class(
                 print_sent_id=print_sent_id, print_text=print_text, add_empty_line=add_empty_line, indent=indent,
@@ -105,7 +107,7 @@ def process_document(self, doc):
         else:
             mentions.sort()
 
-        printed_trees = 0
+        seen_trees = 0
         for mention in mentions:
             if not self._ok(len(mention.words) == 1, self.oneword):
                 continue
@@ -133,25 +135,32 @@ def process_document(self, doc):
 
             for w in mention.words:
                 w.misc['Mark'] = 1
-            if self.max_trees:
-                printed_trees += 1
-                if printed_trees > self.max_trees:
-                    print(f'######## Only first {self.max_trees} trees printed. Use max_trees=0 to see all.')
+
+            seen_trees += 1
+            if self.max_trees and seen_trees > self.max_trees:
+                if not self.print_total:
+                    print(f'######## Only first {self.max_trees} matching mentions printed. Use max_trees=0 to see all.')
                     return
+            else:
+                this_form = ' '.join([w.form for w in mention.words])
+                print("# Mention = " + this_form)
+                if self.print_other_forms:
+                    counter = Counter()
+                    for m in mention.cluster.mentions:
+                        forms = ' '.join([w.form for w in m.words])
+                        if forms != this_form:
+                            counter[forms] += 1
+                    if counter:
+                        print(f"# {min(len(counter), self.print_other_forms)} other forms:", end='')
+                        for form, count in counter.most_common(self.print_other_forms):
+                            print(f' "{form}"({count})', end='')
+                        print()
+                self.print_block.process_tree(mention.head.root)
+                for w in mention.words:
+                    del w.misc['Mark']
+
+        if self.print_total:
+            if self.max_trees and seen_trees > self.max_trees:
+                print(f'######## Only first {self.max_trees} matching mentions printed. Use max_trees=0 to see all.')
+            print(f'######## Total matching/all mentions = {seen_trees} / {len(mentions)}')
 
-            this_form = ' '.join([w.form for w in mention.words])
-            print("# Mention = " + this_form)
-            if self.print_other_forms:
-                counter = Counter()
-                for m in mention.cluster.mentions:
-                    forms = ' '.join([w.form for w in m.words])
-                    if forms != this_form:
-                        counter[forms] += 1
-                if counter:
-                    print(f"# {min(len(counter), self.print_other_forms)} other forms:", end='')
-                    for form, count in counter.most_common(self.print_other_forms):
-                        print(f' "{form}"({count})', end='')
-                    print()
-            self.print_block.process_tree(mention.head.root)
-            for w in mention.words:
-                del w.misc['Mark']

From 0d98b5fa5ddeefd991f79482cfcf20e1657dab9b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 21 May 2021 19:08:14 +0200
Subject: [PATCH 0424/1374] prevent paired punct attached non-projectively

fixes #87
---
 udapi/block/ud/fixpunct.py | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 6fa2da8f..95cb40d0 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -2,7 +2,7 @@
 
 Punctuation in Universal Dependencies has the tag PUNCT, dependency relation punct,
 and is always attached projectively, usually to the head of a neighboring subtree
-to its left or right.
+to its left or right (see https://universaldependencies.org/u/dep/punct.html).
 Punctuation normally does not have children. If it does, we will fix it first.
 
 This block tries to re-attach punctuation projectively and according to the guidelines.
@@ -236,12 +236,18 @@ def _fix_pair(self, root, opening_node, closing_node):
         # let's treat the marks as any other (non-pair) punctuation.
         if len(heads) == 0:
             return
-        elif len(heads) == 1:
-            opening_node.parent = heads[0]
-            closing_node.parent = heads[0]
         else:
-            opening_node.parent = sorted(heads, key=lambda n: n.descendants(add_self=1)[0].ord)[0]
-            closing_node.parent = sorted(heads, key=lambda n: -n.descendants(add_self=1)[-1].ord)[0]
+            # Ideally, there should be only a single head.
+            # If not, we could try e.g. to choose the "widests-span head":
+            #  opening_node.parent = sorted(heads, key=lambda n: n.descendants(add_self=1)[0].ord)[0]
+            #  closing_node.parent = sorted(heads, key=lambda n: -n.descendants(add_self=1)[-1].ord)[0]
+            # which often leads to selecting the same head for the opening and closing punctuation
+            # ignoring single words inside the paired punct which are non-projectively attached outside.
+            # However, this means that the paired punctuation will be attached non-projectively,
+            # which is forbidden by the UD guidelines.
+            # Thus, we will choose the nearest head, which is the only way how to prevent non-projectivities.
+            opening_node.parent = heads[0]
+            closing_node.parent = heads[-1]
 
         self._punct_type[opening_node.ord] = 'opening'
         self._punct_type[closing_node.ord] = 'closing'

From 1eee540ad18c00525941cebc814a76c88550c027 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 24 Jun 2021 17:52:46 +0200
Subject: [PATCH 0425/1374] util.MarkDiff print_stats=6 prints top 6 changes

---
 udapi/block/util/markdiff.py | 43 ++++++++++++++++++++++++++++++++++--
 1 file changed, 41 insertions(+), 2 deletions(-)

diff --git a/udapi/block/util/markdiff.py b/udapi/block/util/markdiff.py
index 22a7a03e..3d183f57 100644
--- a/udapi/block/util/markdiff.py
+++ b/udapi/block/util/markdiff.py
@@ -1,5 +1,7 @@
 """util.MarkDiff is a special block for marking differences between parallel trees."""
+import collections
 import difflib
+import pprint
 from udapi.core.block import Block
 
 
@@ -7,13 +9,25 @@ class MarkDiff(Block):
     """Mark differences between parallel trees."""
 
     def __init__(self, gold_zone, attributes='form,lemma,upos,xpos,deprel,feats,misc',
-                 mark=1, add=False, **kwargs):
-        """Create the Mark block object."""
+                 mark=1, add=False, print_stats=0, **kwargs):
+        """Create the Mark block object.
+        Params:
+        gold_zone: Which of the zones should be treated as gold?
+            (The changes are interpreted as from a "pred"=predicted zone into the gold zone.)
+        attributes: Which node attributes should be considered when searching for diffs?
+            The tree topology, i.e. node parent is always considered.
+        mark: What value should be used in `node.misc['Mark']` of the differing nodes?
+        add: If False, node.misc attributes Mark, ToDo and Bug will be deleted before running this block,
+            so that the marked_only option (e.g. via `udapy -TM`) prints only nodes marked by this block.
+        print_stats: How many lines of statistics should be printed? -1 means all.
+        """
         super().__init__(**kwargs)
         self.gold_zone = gold_zone
         self.attrs = attributes.split(',')
         self.mark = mark
         self.add = add
+        self.print_stats = print_stats
+        self.stats = collections.Counter()
 
     def process_tree(self, tree):
         gold_tree = tree.bundle.get_tree(self.gold_zone)
@@ -49,6 +63,31 @@ def process_tree(self, tree):
                     if alignment.get(p_node.parent.ord - 1) != g_node.parent.ord - 1:
                         p_node.misc['Mark'] = self.mark
                         g_node.misc['Mark'] = self.mark
+                        self.stats['ONLY-PARENT-CHANGED'] += 1
             else:
                 for node in pred_nodes[pred_lo:pred_hi] + gold_nodes[gold_lo:gold_hi]:
                     node.misc['Mark'] = self.mark
+                if self.print_stats:
+                    if edit == 'replace':
+                        # first n nodes are treated as aligned, the rest is treated as ADDED/DELETED
+                        n = min(pred_hi - pred_lo, gold_hi - gold_lo)
+                        for p_node, g_node in zip(pred_nodes[pred_lo:pred_lo + n], gold_nodes[gold_lo:gold_lo + n]):
+                            for attr in self.attrs:
+                                p_value, g_value = p_node._get_attr(attr), g_node._get_attr(attr)
+                                if p_value != g_value:
+                                    self.stats[f'{attr.upper()}: {p_value} -> {g_value}'] += 1
+                            if alignment.get(p_node.parent.ord - 1) != g_node.parent.ord - 1:
+                                self.stats['PARENT-CHANGED'] += 1
+                        pred_lo, gold_lo = pred_lo + n, gold_lo + n
+                    for node in gold_nodes[gold_lo:gold_hi]:
+                        self.stats['ADD-WORD'] += 1
+                        self.stats['ADD-LEMMA: ' + node.lemma] += 1
+                    for node in pred_nodes[pred_lo:pred_hi]:
+                        self.stats['DELETE-WORD'] += 1
+                        self.stats['DELETE-LEMMA: ' + node.lemma] += 1
+
+    def process_end(self):
+        if self.print_stats:
+            how_many = None if self.print_stats in (-1, '-1') else self.print_stats
+            for edit, count in self.stats.most_common(how_many):
+                print(f'{count:4} {edit}')

From 79f4cb5e1839b8250a6398f5fd00182bddb5417e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 7 Jul 2021 16:58:54 +0200
Subject: [PATCH 0426/1374] prevent fatal errors in eval.F1

`eval.F1` calls `self.before_process_document(None)`
---
 udapi/core/basewriter.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/core/basewriter.py b/udapi/core/basewriter.py
index 0db348a8..cc72c6e7 100644
--- a/udapi/core/basewriter.py
+++ b/udapi/core/basewriter.py
@@ -45,7 +45,8 @@ def next_filename(self):
         return self.files.next_filename()
 
     def before_process_document(self, document):
-        udapi.core.coref.store_coref_to_misc(document)
+        if document:
+            udapi.core.coref.store_coref_to_misc(document)
         if self.orig_files == '<filehandle>':
             logging.info('Writing to filehandle.')
             sys.stdout = self.files.filehandle

From 368349003b4388ac9217ef1f7a4e844469e933fb Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 23 Jul 2021 16:57:51 +0200
Subject: [PATCH 0427/1374] eval.F1 should not fail if some node attributes are
 None

---
 udapi/block/eval/f1.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/eval/f1.py b/udapi/block/eval/f1.py
index 982e4190..9f265ac7 100644
--- a/udapi/block/eval/f1.py
+++ b/udapi/block/eval/f1.py
@@ -110,8 +110,8 @@ def process_tree(self, tree):
             return
         self.visited_zones[tree.zone] += 1
 
-        pred_tokens = ['_'.join(n.get_attrs(self.attrs)) for n in tree.descendants]
-        gold_tokens = ['_'.join(n.get_attrs(self.attrs)) for n in gold_tree.descendants]
+        pred_tokens = ['_'.join(n.get_attrs(self.attrs, undefs='None')) for n in tree.descendants]
+        gold_tokens = ['_'.join(n.get_attrs(self.attrs, undefs='None')) for n in gold_tree.descendants]
 
         # lcs("abc", "acb") can be either "ab" or "ac".
         # We want to prefer the LCS with the highest number of non-focused tokens.

From 2fe54cde2d8465527092b8804b624d1e35bdf7cf Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 10 Sep 2021 11:41:42 +0200
Subject: [PATCH 0428/1374] Archiving work I did with German HDT between UD 2.8
 and 2.9.

I only now realize that I could have used the existing block ud.de.AddMwt. However, there are some differences, so for the time being, I am keeping both blocks.
---
 udapi/block/ud/de/fixhdt.py | 109 ++++++++++++++++++++++++++++++++++++
 1 file changed, 109 insertions(+)
 create mode 100644 udapi/block/ud/de/fixhdt.py

diff --git a/udapi/block/ud/de/fixhdt.py b/udapi/block/ud/de/fixhdt.py
new file mode 100644
index 00000000..a3792a96
--- /dev/null
+++ b/udapi/block/ud/de/fixhdt.py
@@ -0,0 +1,109 @@
+"""
+Block to fix annotation of UD German-HDT.
+
+It was created independently of ud.de.AddMwt but it aims to do essentially the
+same thing. Future work: make the two blocks converge.
+
+Currently known differences:
+- This block covers a wider range of contractions.
+- This block generates morphological features for the syntactic words.
+- This block does not touch words that look like contractions but do not have PronType=Art (this is a reliable indicator in HDT).
+- This block overrides the default attachment when the original relation is root, conj, reparandum.
+- The other block takes advantage of the generic class ud.AddMwt, so it does not have to re-invent common procedures.
+"""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixHDT(Block):
+
+    def process_node(self, node):
+        # PronType=Art with ADP is wrong. Fused prepositions and articles should be decomposed in UD.
+        # The following contractions have been observed:
+        # a. am ans aufs beim durchs fürs hinterm hinters im ins übers ums unterm unters vom vorm vors z. zum zur
+        if node.upos == 'ADP' and node.feats['PronType'] == 'Art':
+            if re.match("^(a\.|am|ans|aufs|beim|durchs|fürs|hinter[ms]|im|ins|übers|ums|unter[ms]|vom|vor[ms]|z\.|zu[mr])$", node.form, re.IGNORECASE):
+                # We need two nodes instead of one. Create a node.
+                # The parent should not be the root but unfortunately it is not guaranteed.
+                node2 = node.create_child()
+                node2.shift_after_node(node)
+                if not re.match(r"^(root|conj|reparandum)$", node.udeprel):
+                    node2.parent = node.parent
+                    node.deprel = 'case'
+                node2.deprel = 'det'
+                mwt = node.root.create_multiword_token(form=node.form, words=[node, node2], misc=node.misc)
+                node.misc['SpaceAfter'] = ''
+                # We want to respect the original letter case in the forms of the syntactic words.
+                # We can use the isupper() method to find out whether all letters are uppercase.
+                # However, detecting first-letter capitalization requires more work.
+                up = 2 if mwt.form.isupper() else 1 if mwt.form[:1].isupper() else 0
+                up2 = 2 if up == 2 else 0
+                if re.match(r"^(a\.|am|ans)$", mwt.form, re.IGNORECASE):
+                    node.form = mimic_case(up, 'an')
+                    node.lemma = 'an'
+                elif re.match(r"^aufs$", mwt.form, re.IGNORECASE):
+                    node.form = mimic_case(up, 'auf')
+                    node.lemma = 'auf'
+                elif re.match(r"^beim$", mwt.form, re.IGNORECASE):
+                    node.form = mimic_case(up, 'bei')
+                    node.lemma = 'bei'
+                elif re.match(r"^durchs$", mwt.form, re.IGNORECASE):
+                    node.form = mimic_case(up, 'durch')
+                    node.lemma = 'durch'
+                elif re.match(r"^fürs$", mwt.form, re.IGNORECASE):
+                    node.form = mimic_case(up, 'für')
+                    node.lemma = 'für'
+                elif re.match(r"^hinter[ms]$", mwt.form, re.IGNORECASE):
+                    node.form = mimic_case(up, 'hinter')
+                    node.lemma = 'hinter'
+                elif re.match(r"^(im|ins)$", mwt.form, re.IGNORECASE):
+                    node.form = mimic_case(up, 'in')
+                    node.lemma = 'in'
+                elif re.match(r"^übers$", mwt.form, re.IGNORECASE):
+                    node.form = mimic_case(up, 'über')
+                    node.lemma = 'über'
+                elif re.match(r"^ums$", mwt.form, re.IGNORECASE):
+                    node.form = mimic_case(up, 'um')
+                    node.lemma = 'um'
+                elif re.match(r"^unter[ms]$", mwt.form, re.IGNORECASE):
+                    node.form = mimic_case(up, 'unter')
+                    node.lemma = 'unter'
+                elif re.match(r"^vom$", mwt.form, re.IGNORECASE):
+                    node.form = mimic_case(up, 'von')
+                    node.lemma = 'von'
+                elif re.match(r"^vor[ms]$", mwt.form, re.IGNORECASE):
+                    node.form = mimic_case(up, 'vor')
+                    node.lemma = 'vor'
+                elif re.match(r"^(z\.|zu[mr])$", mwt.form, re.IGNORECASE):
+                    node.form = mimic_case(up, 'zu')
+                    node.lemma = 'zu'
+                node.upos = 'ADP'
+                node.xpos = 'APPR'
+                node.feats = '_'
+                node.feats['AdpType'] = 'Prep'
+                # We must use search() because match() only checks at the beginning of the string.
+                if re.search("[m\.]$", mwt.form, re.IGNORECASE):
+                    node2.form = mimic_case(up2, 'dem')
+                    node2.feats = 'Case=Dat|Definite=Def|Gender=Masc,Neut|Number=Sing|PronType=Art'
+                    node.feats['Case'] = 'Dat'
+                    node2.lemma = 'der'
+                elif re.search("s$", mwt.form, re.IGNORECASE):
+                    node2.form = mimic_case(up2, 'das')
+                    node2.feats = 'Case=Acc|Definite=Def|Gender=Neut|Number=Sing|PronType=Art'
+                    node.feats['Case'] = 'Acc'
+                    node2.lemma = 'der'
+                elif re.search("r$", mwt.form, re.IGNORECASE):
+                    node2.form = mimic_case(up2, 'der')
+                    node2.feats = 'Case=Dat|Definite=Def|Gender=Fem|Number=Sing|PronType=Art'
+                    node.feats['Case'] = 'Dat'
+                    node2.lemma = 'der'
+                node2.upos = 'DET'
+                node2.xpos = 'ART'
+
+def mimic_case(up, x):
+    if up >= 2:
+        return x.upper()
+    elif up == 1:
+        return x[:1].upper() + x[1:].lower()
+    else:
+        return x.lower()

From 33d8e1ce46c22f614e7fc451422278039dfafbb0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Sep 2021 20:15:59 +0200
Subject: [PATCH 0429/1374] German preposition-article contractions.

---
 udapi/block/ud/de/addmwt.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/de/addmwt.py b/udapi/block/ud/de/addmwt.py
index 23ac54f9..18778a4a 100644
--- a/udapi/block/ud/de/addmwt.py
+++ b/udapi/block/ud/de/addmwt.py
@@ -16,15 +16,16 @@
     'durchs':  {'form': 'durch das', },
     'fürs':    {'form': 'fürs das', },
     'hinterm': {'form': 'hinter dem', },
+    'hinters': {'form': 'hinter das', },
     'im':      {'form': 'in dem', },
     'ins':     {'form': 'in das', },
     'übers':   {'form': 'über das', },
     'ums':     {'form': 'um das', },
-    'unters':  {'form': 'unter das', },
     'unterm':  {'form': 'unter dem', },
+    'unters':  {'form': 'unter das', },
     'vom':     {'form': 'von dem', },
-    'vors':    {'form': 'vor das', },
     'vorm':    {'form': 'vor dem', },
+    'vors':    {'form': 'vor das', },
     'zum':     {'form': 'zu dem', },
     'zur':     {'form': 'zu der', },
 }

From 1487de76a72fa42b95274bf4237af6fb7d55b7e8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Sep 2021 20:52:32 +0200
Subject: [PATCH 0430/1374] Archiving my fixes for Catalan and Spanish.

---
 udapi/block/ud/ca/__init__.py |   0
 udapi/block/ud/ca/addmwt.py   | 194 ++++++++++++++++++++++++++++++++++
 udapi/block/ud/es/addmwt.py   |   9 +-
 3 files changed, 201 insertions(+), 2 deletions(-)
 create mode 100644 udapi/block/ud/ca/__init__.py
 create mode 100644 udapi/block/ud/ca/addmwt.py

diff --git a/udapi/block/ud/ca/__init__.py b/udapi/block/ud/ca/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/ud/ca/addmwt.py b/udapi/block/ud/ca/addmwt.py
new file mode 100644
index 00000000..49b79da1
--- /dev/null
+++ b/udapi/block/ud/ca/addmwt.py
@@ -0,0 +1,194 @@
+"""Block ud.ca.AddMwt for heuristic detection of Catalan contractions.
+
+According to the UD guidelines, contractions such as "del" = "de el"
+should be annotated using multi-word tokens.
+
+Note that this block should be used only for converting legacy conllu files.
+Ideally a tokenizer should have already split the MWTs.
+"""
+import re
+import udapi.block.ud.addmwt
+
+MWTS = {
+    'al':      {'form': 'a el',    'lemma': 'a el',   'feats': '_ Definite=Def|Gender=Masc|Number=Sing|PronType=Art'},
+    'als':     {'form': 'a els',   'lemma': 'a el',   'feats': '_ Definite=Def|Gender=Masc|Number=Plur|PronType=Art'},
+    'del':     {'form': 'de el',   'lemma': 'de el',  'feats': '_ Definite=Def|Gender=Masc|Number=Sing|PronType=Art'},
+    'dels':    {'form': 'de els',  'lemma': 'de el',  'feats': '_ Definite=Def|Gender=Masc|Number=Plur|PronType=Art'},
+    'pel':     {'form': 'per el',  'lemma': 'per el', 'feats': '_ Definite=Def|Gender=Masc|Number=Sing|PronType=Art'},
+    'pels':    {'form': 'per els', 'lemma': 'per el', 'feats': '_ Definite=Def|Gender=Masc|Number=Plur|PronType=Art'},
+}
+
+# shared values for all entries in MWTS
+for v in MWTS.values():
+    v['lemma'] = v['form']
+    v['upos'] = 'ADP DET'
+    v['deprel'] = '* det'
+    # The following are the default values
+    # v['main'] = 0 # which of the two words will inherit the original children (if any)
+    # v['shape'] = 'siblings', # the newly created nodes will be siblings
+
+
+class AddMwt(udapi.block.ud.addmwt.AddMwt):
+    """Detect and mark MWTs (split them into words and add the words to the tree)."""
+
+    def __init__(self, verbpron=False, **kwargs):
+        super().__init__(**kwargs)
+        self.verbpron = verbpron
+
+    def multiword_analysis(self, node):
+        """Return a dict with MWT info or None if `node` does not represent a multiword token."""
+        analysis = MWTS.get(node.form.lower(), None)
+
+        if analysis is not None:
+            # Modify the default attachment of the new syntactic words in special situations.
+            if re.match(r'^(root|conj|reparandum)$', node.udeprel):
+                # Copy the dictionary so that we do not modify the original and do not affect subsequent usages.
+                analysis = analysis.copy()
+                analysis['shape'] = 'subtree'
+            return analysis
+        return None
+
+    def fix_personal_pronoun(self, node):
+        # There is a mess in lemmas and features of personal pronouns.
+        if node.upos == 'PRON':
+            if re.match("^jo$", node.form, re.IGNORECASE):
+                node.lemma = 'jo'
+                node.feats = 'Case=Nom|Number=Sing|Person=1|PronType=Prs'
+            if re.match("^(em|m'|-me|'m|me|m)$", node.form, re.IGNORECASE):
+                node.lemma = 'jo'
+                node.feats = 'Case=Acc,Dat|Number=Sing|Person=1|PrepCase=Npr|PronType=Prs'
+            if re.match("^mi$", node.form, re.IGNORECASE):
+                node.lemma = 'jo'
+                node.feats = 'Case=Acc|Number=Sing|Person=1|PrepCase=Pre|PronType=Prs'
+            if re.match("^tu$", node.form, re.IGNORECASE):
+                node.lemma = 'tu'
+                node.feats = 'Case=Nom|Number=Sing|Person=2|Polite=Infm|PronType=Prs'
+            if re.match("^(et|t'|-te|'t|te|t)$", node.form, re.IGNORECASE):
+                node.lemma = 'tu'
+                node.feats = 'Case=Acc,Dat|Number=Sing|Person=2|Polite=Infm|PrepCase=Npr|PronType=Prs'
+            if re.match("^ti$", node.form, re.IGNORECASE):
+                node.lemma = 'tu'
+                node.feats = 'Case=Acc|Number=Sing|Person=2|Polite=Infm|PrepCase=Pre|PronType=Prs'
+            # Strong forms of third person pronouns can be used as subjects or after preposition.
+            # Do not mark them as nominative (because of the prepositions).
+            if re.match("^ell$", node.form, re.IGNORECASE):
+                node.lemma = 'ell'
+                node.feats = 'Gender=Masc|Number=Sing|Person=3|PronType=Prs'
+            if re.match("^ella$", node.form, re.IGNORECASE):
+                node.lemma = 'ell'
+                node.feats = 'Gender=Fem|Number=Sing|Person=3|PronType=Prs'
+            if re.match("^(el|-lo|'l|lo)$", node.form, re.IGNORECASE):
+                node.lemma = 'ell'
+                node.feats = 'Case=Acc|Gender=Masc|Number=Sing|Person=3|PronType=Prs'
+            if re.match("^(la|-la)$", node.form, re.IGNORECASE):
+                node.lemma = 'ell'
+                node.feats = 'Case=Acc|Gender=Fem|Number=Sing|Person=3|PronType=Prs'
+            if re.match("^(l')$", node.form, re.IGNORECASE):
+                node.lemma = 'ell'
+                node.feats = 'Case=Acc|Gender=Fem,Masc|Number=Sing|Person=3|PronType=Prs'
+            if re.match("^(ho|-ho)$", node.form, re.IGNORECASE):
+                node.lemma = 'ell'
+                node.feats = 'Case=Acc|Gender=Neut|Number=Sing|Person=3|PronType=Prs'
+            if re.match("^(li|-li)$", node.form, re.IGNORECASE):
+                node.lemma = 'ell'
+                node.feats = 'Case=Dat|Number=Sing|Person=3|PronType=Prs'
+            if re.match("^(es|s'|-se|'s|se|s)$", node.form, re.IGNORECASE):
+                node.lemma = 'ell'
+                node.feats = 'Case=Acc,Dat|Person=3|PrepCase=Npr|PronType=Prs|Reflex=Yes'
+            if re.match("^si$", node.form, re.IGNORECASE):
+                node.lemma = 'ell'
+                node.feats = 'Case=Acc|Person=3|PrepCase=Pre|PronType=Prs|Reflex=Yes'
+            # If nosaltres can be used after a preposition, we should not tag it as nominative.
+            if re.match("^nosaltres$", node.form, re.IGNORECASE):
+                node.lemma = 'jo'
+                node.feats = 'Number=Plur|Person=1|PronType=Prs'
+            # Nós is the majestic first person singular. In accusative and dative, it is identical to first person plural.
+            if re.match("^nós$", node.form, re.IGNORECASE):
+                node.lemma = 'jo'
+                node.feats = 'Number=Sing|Person=1|Polite=Form|PronType=Prs'
+            if re.match("^(ens|-nos|'ns|nos|ns)$", node.form, re.IGNORECASE):
+                node.lemma = 'jo'
+                node.feats = 'Case=Acc,Dat|Number=Plur|Person=1|PronType=Prs'
+            if re.match("^vosaltres$", node.form, re.IGNORECASE):
+                node.lemma = 'tu'
+                node.feats = 'Number=Plur|Person=2|PronType=Prs'
+            # Vós is the formal second person singular. In accusative and dative, it is identical to second person plural.
+            # Vostè is even more formal than vós. In accusative and dative, it is identical to third person singular.
+            if re.match("^(vós|vostè)$", node.form, re.IGNORECASE):
+                node.lemma = 'tu'
+                node.feats = 'Number=Sing|Person=2|Polite=Form|PronType=Prs'
+            if re.match("^vostès$", node.form, re.IGNORECASE):
+                node.lemma = 'tu'
+                node.feats = 'Number=Plur|Person=2|Polite=Form|PronType=Prs'
+            if re.match("^(us|-vos|-us|vos)$", node.form, re.IGNORECASE):
+                node.lemma = 'tu'
+                node.feats = 'Case=Acc,Dat|Number=Plur|Person=2|PronType=Prs'
+            # Strong forms of third person pronouns can be used as subjects or after preposition.
+            # Do not mark them as nominative (because of the prepositions).
+            if re.match("^ells$", node.form, re.IGNORECASE):
+                node.lemma = 'ell'
+                node.feats = 'Gender=Masc|Number=Plur|Person=3|PronType=Prs'
+            if re.match("^elles$", node.form, re.IGNORECASE):
+                node.lemma = 'ell'
+                node.feats = 'Gender=Fem|Number=Plur|Person=3|PronType=Prs'
+            # Els is masculine accusative, or dative in any gender.
+            if re.match("^(els|-los|'ls|los|ls)$", node.form, re.IGNORECASE):
+                node.lemma = 'ell'
+                node.feats = 'Case=Acc,Dat|Number=Plur|Person=3|PronType=Prs'
+            if re.match("^(les|-les)$", node.form, re.IGNORECASE):
+                node.lemma = 'ell'
+                node.feats = 'Case=Acc|Gender=Fem|Number=Plur|Person=3|PronType=Prs'
+            # There are also "adverbial" pronominal clitics that can occur at direct object positions.
+            if re.match("^(en|n'|'n|-ne|n|ne)$", node.form, re.IGNORECASE):
+                node.lemma = 'en'
+                node.feats = 'Case=Gen|Person=3|PronType=Prs'
+            if re.match("^(hi|-hi)$", node.form, re.IGNORECASE):
+                node.lemma = 'hi'
+                node.feats = 'Case=Loc|Person=3|PronType=Prs'
+
+    def report_suspicious_lemmas(self, node):
+        # There are offset issues of splitted multi_word_expressions.
+        # Sometimes a word gets the lemma of the neighboring word.
+        if node.form.lower()[:1] != node.lemma.lower()[:1]:
+            # Exclude legitimate cases where the lemma starts with a different letter.
+            hit = True
+            if node.lemma == 'jo' and re.match("(em|ens|m'|me|mi|nos|nosaltres|'ns)", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'tu' and re.match("(et|'t|us|vosaltres|vostè)", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'el' and re.match("(la|l|l'|les)", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'ell' and re.match("(hi|ho|'l|l'|la|-la|les|li|lo|-lo|los|'ls|'s|s'|se|-se|si)", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'es' and re.match("(s|se)", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'em' and re.match("('m|m|m')", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'en' and re.match("('n|n'|ne|-ne)", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'anar' and re.match("(va|van|vàrem)", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'ser' and re.match("(és|era|eren|eres|érem|essent|estat|ets|foren|fos|fossin|fou)", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'estar' and re.match("(sigut)", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'caure' and re.match("(queia|queies|quèiem|quèieu|queien)", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'ampli' and re.match("(àmplia|àmplies)", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'indi' and re.match("(índies)", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'obvi' and re.match("(òbvia)", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'ossi' and re.match("(òssies)", node.form, re.IGNORECASE):
+                hit = False
+            if node.lemma == 'ús' and re.match("(usos)", node.form, re.IGNORECASE):
+                hit = False
+            # Form = '2001/37/CE', lemma = 'CE'
+            # Form = 'nº5', lemma = '5'
+            # Form = 'kg.', lemma = 'quilogram'
+            # Form = 'un', lemma = '1'
+            if node.lemma == 'CE' or re.match("nº", node.form, re.IGNORECASE) or re.match("^quil[oò]", node.lemma, re.IGNORECASE) or re.match("^[0-9]+$", node.lemma):
+                hit = False
+            if hit:
+                print("Form = '%s', lemma = '%s', address = %s" % (node.form, node.lemma, node.address()))
diff --git a/udapi/block/ud/es/addmwt.py b/udapi/block/ud/es/addmwt.py
index ee85b1d6..92f80160 100644
--- a/udapi/block/ud/es/addmwt.py
+++ b/udapi/block/ud/es/addmwt.py
@@ -1,6 +1,6 @@
 """Block ud.es.AddMwt for heuristic detection of Spanish contractions.
 
-According to the UD guidelines, contractions such as "dele" = "de ele"
+According to the UD guidelines, contractions such as "del" = "de el"
 should be annotated using multi-word tokens.
 
 Note that this block should be used only for converting legacy conllu files.
@@ -28,7 +28,7 @@
     v['lemma'] = v['form']
     v['upos'] = 'ADP DET'
     v['deprel'] = '* det'
-    v['feats'] = '_ *'
+    v['feats'] = '_ Definite=Def|Gender=Masc|Number=Sing|PronType=Art'
     # The following are the default values
     # v['main'] = 0 # which of the two words will inherit the original children (if any)
     # v['shape'] = 'siblings', # the newly created nodes will be siblings
@@ -46,6 +46,11 @@ def multiword_analysis(self, node):
         analysis = MWTS.get(node.form.lower(), None)
 
         if analysis is not None:
+            # Modify the default attachment of the new syntactic words in special situations.
+            if re.match(r'^(root|conj|reparandum)$', node.udeprel):
+                # Copy the dictionary so that we do not modify the original and do not affect subsequent usages.
+                analysis = analysis.copy()
+                analysis['shape'] = 'subtree'
             return analysis
 
         if not self.verbpron or node.upos not in {'VERB', 'AUX'}:

From 27bf3a3b82b4a88ecaeee2bc2843efaf383bc249 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Sep 2021 21:02:48 +0200
Subject: [PATCH 0431/1374] Archiving my fixes for Indonesian GSD.

---
 udapi/block/ud/id/__init__.py |  0
 udapi/block/ud/id/fixgsd.py   | 67 +++++++++++++++++++++++++++++++++++
 2 files changed, 67 insertions(+)
 create mode 100644 udapi/block/ud/id/__init__.py
 create mode 100644 udapi/block/ud/id/fixgsd.py

diff --git a/udapi/block/ud/id/__init__.py b/udapi/block/ud/id/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
new file mode 100644
index 00000000..1ab30dd0
--- /dev/null
+++ b/udapi/block/ud/id/fixgsd.py
@@ -0,0 +1,67 @@
+"""Block to fix annotation of UD Indonesian-GSD."""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixGSD(Block):
+
+    def lemmatize_verb_from_morphind(self, node):
+        # The MISC column contains the output of MorphInd for the current word.
+        # The analysis has been interpreted wrongly for some verbs, so we need
+        # to re-interpret it and extract the correct lemma.
+        if node.upos == "VERB":
+            morphind = node.misc["MorphInd"]
+            # Remove the start and end tags from morphind.
+            morphind = re.sub(r"^\^", "", morphind)
+            morphind = re.sub(r"\$$", "", morphind)
+            # Remove the final XPOS tag from morphind.
+            morphind = re.sub(r"_VS[AP]$", "", morphind)
+            # Split morphind to prefix, stem, and suffix.
+            morphemes = re.split(r"\+", morphind)
+            # Expected suffixes are -kan, -i, -an, or no suffix at all.
+            if len(morphemes) > 1 and re.match(r"^(kan|i|an)$", morphemes[-1]):
+                del morphemes[-1]
+            # Expected prefixes are meN-, di-, ber-, peN-, ke-, ter-, se-, or no prefix at all.
+            # There can be two prefixes in a row, e.g., "ber+ke+", or "ter+peN+".
+            while len(morphemes) > 1 and re.match(r"^(meN|di|ber|peN|ke|ter|se)$", morphemes[0]):
+                del morphemes[0]
+            # Check that we are left with just one morpheme.
+            if len(morphemes) != 1:
+                logging.warning("One morpheme expected, found %d %s, morphind = '%s'" % (len(morphemes), morphemes, morphind))
+            else:
+                lemma = morphemes[0]
+                # Remove the stem POS category.
+                lemma = re.sub(r"<[a-z]+>$", "", lemma)
+                node.lemma = lemma
+
+    def merge_reduplicated_plural(self, node):
+        # Instead of compound:plur, merge the reduplicated plurals into a single token.
+        if node.deprel == "compound:plur":
+            root = node.root
+            # We assume that the previous token is a hyphen and the token before it is the parent.
+            first = node.parent
+            if first.ord == node.ord-2 and first.form.lower() == node.form.lower():
+                hyph = node.prev_node
+                if hyph.is_descendant_of(first) and re.match(r"^(-|–|--)$", hyph.form):
+                    # Neither the hyphen nor the current node should have children.
+                    # If they do, re-attach the children to the first node.
+                    for c in hyph.children:
+                        c.parent = first
+                    for c in node.children:
+                        c.parent = first
+                    # Merge the three nodes.
+                    first.form = first.form + "-" + node.form
+                    first.feats["Number"] = "Plur"
+                    if node.no_space_after:
+                        first.misc["SpaceAfter"] = "No"
+                    else:
+                        first.misc["SpaceAfter"] = ""
+                    hyph.remove()
+                    node.remove()
+                    # We cannot be sure whether the original annotation correctly said that there are no spaces around the hyphen.
+                    # If it did not, then we have a mismatch with the sentence text, which we must fix.
+                    # The following will also fix cases where there was an n-dash ('–') instead of a hyphen ('-').
+                    root.text = root.compute_text()
+
+    def process_node(self, node):
+        self.lemmatize_verb_from_morphind(node)

From 9cb18121557f553068fc4c17bd5feea16227ef96 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Sep 2021 21:05:35 +0200
Subject: [PATCH 0432/1374] "per-" is also a prefix that should be removed from
 the lemma (confirmed by Ika).

---
 udapi/block/ud/id/fixgsd.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index 1ab30dd0..a629d712 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -23,7 +23,7 @@ def lemmatize_verb_from_morphind(self, node):
                 del morphemes[-1]
             # Expected prefixes are meN-, di-, ber-, peN-, ke-, ter-, se-, or no prefix at all.
             # There can be two prefixes in a row, e.g., "ber+ke+", or "ter+peN+".
-            while len(morphemes) > 1 and re.match(r"^(meN|di|ber|peN|ke|ter|se)$", morphemes[0]):
+            while len(morphemes) > 1 and re.match(r"^(meN|di|ber|peN|ke|ter|se|per)$", morphemes[0]):
                 del morphemes[0]
             # Check that we are left with just one morpheme.
             if len(morphemes) != 1:

From e8194c4dc6726685d26eee5f9761f2ef1335fc31 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Sep 2021 21:10:26 +0200
Subject: [PATCH 0433/1374] Extended debugging message.

---
 udapi/block/ud/id/fixgsd.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index a629d712..b3328273 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -27,7 +27,7 @@ def lemmatize_verb_from_morphind(self, node):
                 del morphemes[0]
             # Check that we are left with just one morpheme.
             if len(morphemes) != 1:
-                logging.warning("One morpheme expected, found %d %s, morphind = '%s'" % (len(morphemes), morphemes, morphind))
+                logging.warning("One morpheme expected, found %d %s, morphind = '%s', form = '%s'" % (len(morphemes), morphemes, morphind, node.form))
             else:
                 lemma = morphemes[0]
                 # Remove the stem POS category.

From bc0a1d3e969698be93cd9bf8e2bd5a0aa67cad9c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Sep 2021 21:59:46 +0200
Subject: [PATCH 0434/1374] Indonesian fixes.

---
 udapi/block/ud/id/addmwt.py | 16 ++++++++++++++++
 udapi/block/ud/id/fixgsd.py |  2 +-
 2 files changed, 17 insertions(+), 1 deletion(-)
 create mode 100644 udapi/block/ud/id/addmwt.py

diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
new file mode 100644
index 00000000..3fe39dd8
--- /dev/null
+++ b/udapi/block/ud/id/addmwt.py
@@ -0,0 +1,16 @@
+"""
+Block ud.id.AddMwt cuts the clitic "-nya" in Indonesian (preprocessed with
+MorphInd whose output is stored in MISC attribute MorphInd).
+"""
+import udapi.block.ud.addmwt
+
+class AddMwt(udapi.block.ud.addmwt.AddMwt):
+    """Detect and mark MWTs (split them into words and add the words to the tree)."""
+
+    def multiword_analysis(self, node):
+        """Return a dict with MWT info or None if `node` does not represent a multiword token."""
+        if node.upos == 'VERB' and re.search(r'nya$', node.form, re.IGNORECASE):
+            splitform = re.sub(r'(nya)$', r' \1', re.IGNORECASE)
+            # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
+            return {'form': splitform, 'lemma': splitform, 'upos': 'VERB PRON', 'shape': 'subtree', 'deprel': '* obj'}
+        return None
diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index b3328273..0ec79f2e 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -27,7 +27,7 @@ def lemmatize_verb_from_morphind(self, node):
                 del morphemes[0]
             # Check that we are left with just one morpheme.
             if len(morphemes) != 1:
-                logging.warning("One morpheme expected, found %d %s, morphind = '%s', form = '%s'" % (len(morphemes), morphemes, morphind, node.form))
+                logging.warning("One morpheme expected, found %d %s, morphind = '%s', form = '%s', feats = '%s'" % (len(morphemes), morphemes, morphind, node.form, node.feats))
             else:
                 lemma = morphemes[0]
                 # Remove the stem POS category.

From 70361e213d59709d0793992b01476bf5373a6e46 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Sep 2021 22:07:29 +0200
Subject: [PATCH 0435/1374] Features of -nya.

---
 udapi/block/ud/id/addmwt.py | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
index 3fe39dd8..2d46fb67 100644
--- a/udapi/block/ud/id/addmwt.py
+++ b/udapi/block/ud/id/addmwt.py
@@ -11,6 +11,15 @@ def multiword_analysis(self, node):
         """Return a dict with MWT info or None if `node` does not represent a multiword token."""
         if node.upos == 'VERB' and re.search(r'nya$', node.form, re.IGNORECASE):
             splitform = re.sub(r'(nya)$', r' \1', re.IGNORECASE)
+            # The verb with -nya typically has Number[psor]=Sing|Person[psor]=3.
+            # Remove these features from the verb and give the pronoun normal features Number=Sing|Person=3.
+            if node.feats["Number[psor]"] != "Sing":
+                logging.warning("Verb '%s' has Number[psor]=='%s'" % (node.form, node.feats["Number[psor]"]))
+            if node.feats["Person[psor]"] != "3":
+                logging.warning("Verb '%s' has Person[psor]=='%s'" % (node.form, node.feats["Person[psor]"]))
+            node.feats["Number[psor]"] = ''
+            node.feats["Person[psor]"] = ''
+            pronfeats = 'Number=Sing|Person=3|PronType=Prs'
             # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
-            return {'form': splitform, 'lemma': splitform, 'upos': 'VERB PRON', 'shape': 'subtree', 'deprel': '* obj'}
+            return {'form': splitform, 'lemma': splitform, 'upos': 'VERB PRON', 'feats': '* '+pronfeats, 'shape': 'subtree', 'deprel': '* obj'}
         return None

From 87909af8a5ff6e4d19fcdd4640babe1f502e260e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Sep 2021 22:09:25 +0200
Subject: [PATCH 0436/1374] Bug fix.

---
 udapi/block/ud/id/addmwt.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
index 2d46fb67..4a2158c4 100644
--- a/udapi/block/ud/id/addmwt.py
+++ b/udapi/block/ud/id/addmwt.py
@@ -3,6 +3,8 @@
 MorphInd whose output is stored in MISC attribute MorphInd).
 """
 import udapi.block.ud.addmwt
+import logging
+import re
 
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
     """Detect and mark MWTs (split them into words and add the words to the tree)."""

From 0a5148670f4133505d9e0524b41cedcbec923713 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Sep 2021 22:13:05 +0200
Subject: [PATCH 0437/1374] Bug fix.

---
 udapi/block/ud/id/addmwt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
index 4a2158c4..da5219f0 100644
--- a/udapi/block/ud/id/addmwt.py
+++ b/udapi/block/ud/id/addmwt.py
@@ -12,7 +12,7 @@ class AddMwt(udapi.block.ud.addmwt.AddMwt):
     def multiword_analysis(self, node):
         """Return a dict with MWT info or None if `node` does not represent a multiword token."""
         if node.upos == 'VERB' and re.search(r'nya$', node.form, re.IGNORECASE):
-            splitform = re.sub(r'(nya)$', r' \1', re.IGNORECASE)
+            splitform = re.sub(r'(nya)$', r' \1', flags=re.IGNORECASE)
             # The verb with -nya typically has Number[psor]=Sing|Person[psor]=3.
             # Remove these features from the verb and give the pronoun normal features Number=Sing|Person=3.
             if node.feats["Number[psor]"] != "Sing":

From 141f100c71ae5ec33c3e126841d63234e3c16f1a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Sep 2021 22:14:09 +0200
Subject: [PATCH 0438/1374] Bug fix.

---
 udapi/block/ud/id/addmwt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
index da5219f0..c0c40486 100644
--- a/udapi/block/ud/id/addmwt.py
+++ b/udapi/block/ud/id/addmwt.py
@@ -12,7 +12,7 @@ class AddMwt(udapi.block.ud.addmwt.AddMwt):
     def multiword_analysis(self, node):
         """Return a dict with MWT info or None if `node` does not represent a multiword token."""
         if node.upos == 'VERB' and re.search(r'nya$', node.form, re.IGNORECASE):
-            splitform = re.sub(r'(nya)$', r' \1', flags=re.IGNORECASE)
+            splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
             # The verb with -nya typically has Number[psor]=Sing|Person[psor]=3.
             # Remove these features from the verb and give the pronoun normal features Number=Sing|Person=3.
             if node.feats["Number[psor]"] != "Sing":

From da307863288f6e9872b2f6f6ace9555f1763ecf4 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Sep 2021 22:21:20 +0200
Subject: [PATCH 0439/1374] Narrowing down the conditions for -nya.

---
 udapi/block/ud/id/addmwt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
index c0c40486..023f10fa 100644
--- a/udapi/block/ud/id/addmwt.py
+++ b/udapi/block/ud/id/addmwt.py
@@ -11,7 +11,7 @@ class AddMwt(udapi.block.ud.addmwt.AddMwt):
 
     def multiword_analysis(self, node):
         """Return a dict with MWT info or None if `node` does not represent a multiword token."""
-        if node.upos == 'VERB' and re.search(r'nya$', node.form, re.IGNORECASE):
+        if node.upos == 'VERB' and re.search(r'nya$', node.form, re.IGNORECASE) and re.search(r'\+dia<p>_PS3$', node.misc["MorphInd"]):
             splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
             # The verb with -nya typically has Number[psor]=Sing|Person[psor]=3.
             # Remove these features from the verb and give the pronoun normal features Number=Sing|Person=3.

From 0d54d60ba290b9bf3cbb0d245fed8eda923ff154 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Sep 2021 22:52:41 +0200
Subject: [PATCH 0440/1374] More refined -nya segmentation.

---
 udapi/block/ud/id/addmwt.py | 25 +++++++++++++++++--------
 1 file changed, 17 insertions(+), 8 deletions(-)

diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
index 023f10fa..6231c7e6 100644
--- a/udapi/block/ud/id/addmwt.py
+++ b/udapi/block/ud/id/addmwt.py
@@ -11,17 +11,26 @@ class AddMwt(udapi.block.ud.addmwt.AddMwt):
 
     def multiword_analysis(self, node):
         """Return a dict with MWT info or None if `node` does not represent a multiword token."""
-        if node.upos == 'VERB' and re.search(r'nya$', node.form, re.IGNORECASE) and re.search(r'\+dia<p>_PS3$', node.misc["MorphInd"]):
+        if node.upos == 'VERB' and re.search(r'nya$', node.form, re.IGNORECASE) and re.search(r'\+dia<p>_PS3\$$', node.misc['MorphInd']):
             splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
             # The verb with -nya typically has Number[psor]=Sing|Person[psor]=3.
             # Remove these features from the verb and give the pronoun normal features Number=Sing|Person=3.
-            if node.feats["Number[psor]"] != "Sing":
-                logging.warning("Verb '%s' has Number[psor]=='%s'" % (node.form, node.feats["Number[psor]"]))
-            if node.feats["Person[psor]"] != "3":
-                logging.warning("Verb '%s' has Person[psor]=='%s'" % (node.form, node.feats["Person[psor]"]))
-            node.feats["Number[psor]"] = ''
-            node.feats["Person[psor]"] = ''
+            if node.feats['Number[psor]'] != 'Sing':
+                logging.warning("Verb '%s' has Number[psor]=='%s'" % (node.form, node.feats['Number[psor]']))
+            if node.feats['Person[psor]'] != '3':
+                logging.warning("Verb '%s' has Person[psor]=='%s'" % (node.form, node.feats['Person[psor]']))
+            node.feats['Number[psor]'] = ''
+            node.feats['Person[psor]'] = ''
             pronfeats = 'Number=Sing|Person=3|PronType=Prs'
+            xpos = re.sub(r'\+', ' ', node.xpos)
+            deprel = 'obl:agent' if re.match(r'^\^di\+', node.misc['MorphInd']) else 'obj'
             # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
-            return {'form': splitform, 'lemma': splitform, 'upos': 'VERB PRON', 'feats': '* '+pronfeats, 'shape': 'subtree', 'deprel': '* obj'}
+            return {'form': splitform, 'lemma': splitform, 'upos': 'VERB PRON', 'feats': '* '+pronfeats, 'xpos': xpos, 'shape': 'subtree', 'deprel': '* '+deprel}
         return None
+
+    def postprocess_mwt(self, mwt):
+        """Distribute the MorphInd analysis to the two parts so that we can later use it to fix the lemmas of verbs."""
+        match = re.match(r'^\^(.*)\+(dia<p>_PS3)\$$', mwt.misc['MorphInd'])
+        if match:
+            mwt.words[0].misc['MorphInd'] = '^'+match.group(1)+'$'
+            mwt.words[1].misc['MorphInd'] = '^'+match.group(2)+'$'

From 1eaaebdb7311089921161e2045b407a95387d442 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 12 Sep 2021 10:46:41 +0200
Subject: [PATCH 0441/1374] Indonesian proper nouns do not form plural.

---
 udapi/block/ud/id/fixgsd.py | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index 0ec79f2e..552d6743 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -63,5 +63,17 @@ def merge_reduplicated_plural(self, node):
                     # The following will also fix cases where there was an n-dash ('–') instead of a hyphen ('-').
                     root.text = root.compute_text()
 
+    def fix_plural_propn(self, node):
+        """
+        It is unlikely that a proper noun will have a plural form in Indonesian.
+        All examples observed in GSD should actually be tagged as common nouns.
+        """
+        if node.upos == 'PROPN' and node.feats['Number'] == 'Plur':
+            node.upos = 'NOUN'
+            node.lemma = node.lemma.lower()
+        if node.upos == 'PROPN':
+            node.feats['Number'] = ''
+
     def process_node(self, node):
-        self.lemmatize_verb_from_morphind(node)
+        self.fix_plural_propn(node)
+        #self.lemmatize_verb_from_morphind(node)

From 3db7f05bf8075e81e6c274db0d22b8d8de5b4eef Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 12 Sep 2021 12:34:43 +0200
Subject: [PATCH 0442/1374] Modified splitting of VERB+nya after some more
 input from Ika.

---
 udapi/block/ud/id/addmwt.py | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
index 6231c7e6..cc3a0fee 100644
--- a/udapi/block/ud/id/addmwt.py
+++ b/udapi/block/ud/id/addmwt.py
@@ -13,6 +13,13 @@ def multiword_analysis(self, node):
         """Return a dict with MWT info or None if `node` does not represent a multiword token."""
         if node.upos == 'VERB' and re.search(r'nya$', node.form, re.IGNORECASE) and re.search(r'\+dia<p>_PS3\$$', node.misc['MorphInd']):
             splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
+            # For transitive verbs with the meN- prefix, -nya is an object clitic.
+            # For passive verbs with the di- prefix, -nya refers to a passive agent.
+            # For verbs with prefixes ber-, ter-, and verbs without prefixes, -nya is a definite article and signals nominalization.
+            # The same would hold for intransitive verbs with the meN- prefix but we cannot recognize them (we will treat all meN- verbs as transitive).
+            menverb = True if re.match(r'^\^meN\+', node.misc['MorphInd']) else False
+            diverb = True if re.match(r'^\^di\+', node.misc['MorphInd']) else False
+            nominalization = not menverb and not diverb
             # The verb with -nya typically has Number[psor]=Sing|Person[psor]=3.
             # Remove these features from the verb and give the pronoun normal features Number=Sing|Person=3.
             if node.feats['Number[psor]'] != 'Sing':
@@ -21,11 +28,19 @@ def multiword_analysis(self, node):
                 logging.warning("Verb '%s' has Person[psor]=='%s'" % (node.form, node.feats['Person[psor]']))
             node.feats['Number[psor]'] = ''
             node.feats['Person[psor]'] = ''
-            pronfeats = 'Number=Sing|Person=3|PronType=Prs'
+            if nominalization:
+                lemma = splitform.lower()
+                upos = 'VERB DET'
+                feats = '* Definite=Def|PronType=Art'
+                deprel = '* det'
+            else:
+                lemma = re.sub(r' nya$', ' dia', splitform.lower())
+                upos = 'VERB PRON'
+                feats = '* Number=Sing|Person=3|PronType=Prs'
+                deprel = '* obj:agent' if diverb else '* obj'
             xpos = re.sub(r'\+', ' ', node.xpos)
-            deprel = 'obl:agent' if re.match(r'^\^di\+', node.misc['MorphInd']) else 'obj'
             # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
-            return {'form': splitform, 'lemma': splitform, 'upos': 'VERB PRON', 'feats': '* '+pronfeats, 'xpos': xpos, 'shape': 'subtree', 'deprel': '* '+deprel}
+            return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
         return None
 
     def postprocess_mwt(self, mwt):

From ad0f1340276237b02ed2e0423147cbdb5b11a9b9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 12 Sep 2021 14:29:27 +0200
Subject: [PATCH 0443/1374] Indonesian -nya with nouns.

---
 udapi/block/ud/id/addmwt.py | 75 +++++++++++++++++++++++--------------
 1 file changed, 47 insertions(+), 28 deletions(-)

diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
index cc3a0fee..e22f27bd 100644
--- a/udapi/block/ud/id/addmwt.py
+++ b/udapi/block/ud/id/addmwt.py
@@ -11,36 +11,55 @@ class AddMwt(udapi.block.ud.addmwt.AddMwt):
 
     def multiword_analysis(self, node):
         """Return a dict with MWT info or None if `node` does not represent a multiword token."""
-        if node.upos == 'VERB' and re.search(r'nya$', node.form, re.IGNORECASE) and re.search(r'\+dia<p>_PS3\$$', node.misc['MorphInd']):
-            splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
-            # For transitive verbs with the meN- prefix, -nya is an object clitic.
-            # For passive verbs with the di- prefix, -nya refers to a passive agent.
-            # For verbs with prefixes ber-, ter-, and verbs without prefixes, -nya is a definite article and signals nominalization.
-            # The same would hold for intransitive verbs with the meN- prefix but we cannot recognize them (we will treat all meN- verbs as transitive).
-            menverb = True if re.match(r'^\^meN\+', node.misc['MorphInd']) else False
-            diverb = True if re.match(r'^\^di\+', node.misc['MorphInd']) else False
-            nominalization = not menverb and not diverb
-            # The verb with -nya typically has Number[psor]=Sing|Person[psor]=3.
-            # Remove these features from the verb and give the pronoun normal features Number=Sing|Person=3.
-            if node.feats['Number[psor]'] != 'Sing':
-                logging.warning("Verb '%s' has Number[psor]=='%s'" % (node.form, node.feats['Number[psor]']))
-            if node.feats['Person[psor]'] != '3':
-                logging.warning("Verb '%s' has Person[psor]=='%s'" % (node.form, node.feats['Person[psor]']))
-            node.feats['Number[psor]'] = ''
-            node.feats['Person[psor]'] = ''
-            if nominalization:
-                lemma = splitform.lower()
-                upos = 'VERB DET'
-                feats = '* Definite=Def|PronType=Art'
-                deprel = '* det'
-            else:
+        if re.search(r'nya$', node.form, re.IGNORECASE) and re.search(r'\+dia<p>_PS3\$$', node.misc['MorphInd']):
+            if node.upos == 'VERB':
+                splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
+                # For transitive verbs with the meN- prefix, -nya is an object clitic.
+                # For passive verbs with the di- prefix, -nya refers to a passive agent.
+                # For verbs with prefixes ber-, ter-, and verbs without prefixes, -nya is a definite article and signals nominalization.
+                # The same would hold for intransitive verbs with the meN- prefix but we cannot recognize them (we will treat all meN- verbs as transitive).
+                menverb = True if re.match(r'^\^meN\+', node.misc['MorphInd']) else False
+                diverb = True if re.match(r'^\^di\+', node.misc['MorphInd']) else False
+                nominalization = not menverb and not diverb
+                # The verb with -nya typically has Number[psor]=Sing|Person[psor]=3.
+                # Remove these features from the verb and give the pronoun normal features Number=Sing|Person=3.
+                if node.feats['Number[psor]'] != 'Sing':
+                    logging.warning("Verb '%s' has Number[psor]=='%s'" % (node.form, node.feats['Number[psor]']))
+                if node.feats['Person[psor]'] != '3':
+                    logging.warning("Verb '%s' has Person[psor]=='%s'" % (node.form, node.feats['Person[psor]']))
+                node.feats['Number[psor]'] = ''
+                node.feats['Person[psor]'] = ''
+                if nominalization:
+                    lemma = splitform.lower()
+                    upos = 'VERB DET'
+                    feats = '* Definite=Def|PronType=Art'
+                    deprel = '* det'
+                else:
+                    lemma = re.sub(r' nya$', ' dia', splitform.lower())
+                    upos = 'VERB PRON'
+                    feats = '* Number=Sing|Person=3|PronType=Prs'
+                    deprel = '* obj:agent' if diverb else '* obj'
+                xpos = re.sub(r'\+', ' ', node.xpos)
+                # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
+                return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
+            elif re.match(r'(NOUN|PROPN|X)', node.upos):
+                splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
+                # The noun with -nya typically has Number[psor]=Sing|Person[psor]=3.
+                # Remove these features from the noun and give the pronoun normal features Number=Sing|Person=3.
+                if node.feats['Number[psor]'] != 'Sing':
+                    logging.warning("Noun '%s' has Number[psor]=='%s'" % (node.form, node.feats['Number[psor]']))
+                if node.feats['Person[psor]'] != '3':
+                    logging.warning("Noun '%s' has Person[psor]=='%s'" % (node.form, node.feats['Person[psor]']))
+                node.feats['Number[psor]'] = ''
+                node.feats['Person[psor]'] = ''
                 lemma = re.sub(r' nya$', ' dia', splitform.lower())
-                upos = 'VERB PRON'
+                upos = '* PRON'
                 feats = '* Number=Sing|Person=3|PronType=Prs'
-                deprel = '* obj:agent' if diverb else '* obj'
-            xpos = re.sub(r'\+', ' ', node.xpos)
-            # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
-            return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
+                xpos = re.sub(r'\+', ' ', node.xpos)
+                deprel = '* nmod:poss'
+                # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
+                return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
+            return None
         return None
 
     def postprocess_mwt(self, mwt):

From 62b8f93d35142e36722c2fc5ed5dca1073357321 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 12 Sep 2021 14:40:31 +0200
Subject: [PATCH 0444/1374] Warn about unhandled instances of -nya.

---
 udapi/block/ud/id/addmwt.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
index e22f27bd..40421611 100644
--- a/udapi/block/ud/id/addmwt.py
+++ b/udapi/block/ud/id/addmwt.py
@@ -59,7 +59,9 @@ def multiword_analysis(self, node):
                 deprel = '* nmod:poss'
                 # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
                 return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
-            return None
+            else:
+                logging.warning("Form '%s' analyzed by MorphInd as having the -nya clitic but the UPOS is '%s'" % (node.form, node.upos))
+                return None
         return None
 
     def postprocess_mwt(self, mwt):

From f5dde932ee8348abd01078123eedf5c46f7cb4dc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 12 Sep 2021 14:56:03 +0200
Subject: [PATCH 0445/1374] Indonesian verb lemmatization turned on.

---
 udapi/block/ud/id/fixgsd.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index 552d6743..458e41db 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -31,7 +31,7 @@ def lemmatize_verb_from_morphind(self, node):
             else:
                 lemma = morphemes[0]
                 # Remove the stem POS category.
-                lemma = re.sub(r"<[a-z]+>$", "", lemma)
+                lemma = re.sub(r"<[a-z]+>(_.*)?$", "", lemma)
                 node.lemma = lemma
 
     def merge_reduplicated_plural(self, node):
@@ -76,4 +76,4 @@ def fix_plural_propn(self, node):
 
     def process_node(self, node):
         self.fix_plural_propn(node)
-        #self.lemmatize_verb_from_morphind(node)
+        self.lemmatize_verb_from_morphind(node)

From c351c00c12e75ce7cfb802599e3c02258ecb2fc0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 12 Sep 2021 22:21:54 +0200
Subject: [PATCH 0446/1374] Why we attach -nya as obl:agent.

---
 udapi/block/ud/id/addmwt.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
index 40421611..1270ba77 100644
--- a/udapi/block/ud/id/addmwt.py
+++ b/udapi/block/ud/id/addmwt.py
@@ -38,7 +38,13 @@ def multiword_analysis(self, node):
                     lemma = re.sub(r' nya$', ' dia', splitform.lower())
                     upos = 'VERB PRON'
                     feats = '* Number=Sing|Person=3|PronType=Prs'
-                    deprel = '* obj:agent' if diverb else '* obj'
+                    # The agent of the passive verb is coded like a direct object of an active verb,
+                    # so we might want to use obj:agent rather than obl:agent. However, full nominals
+                    # as passive agents can be optionally accompanied by the preposition _oleh_ "by",
+                    # which is an argument in favor of saying that they are oblique. So we currently
+                    # mark all passive agents as obliques, although it is disputable in Austronesian
+                    # languages (unlike Indo-European passives).
+                    deprel = '* obl:agent' if diverb else '* obj'
                 xpos = re.sub(r'\+', ' ', node.xpos)
                 # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
                 return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}

From ee04cdea67d1edb64d0f9573103818557204eb81 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 12 Sep 2021 22:52:40 +0200
Subject: [PATCH 0447/1374] ke-sama-an

---
 udapi/block/ud/id/fixgsd.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index 458e41db..481630fa 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -19,7 +19,10 @@ def lemmatize_verb_from_morphind(self, node):
             # Split morphind to prefix, stem, and suffix.
             morphemes = re.split(r"\+", morphind)
             # Expected suffixes are -kan, -i, -an, or no suffix at all.
-            if len(morphemes) > 1 and re.match(r"^(kan|i|an)$", morphemes[-1]):
+            # There is also the circumfix ke-...-an which seems to be nominalized adjective:
+            # "sama" = "same, similar"; "kesamaan" = "similarity", lemma is "sama";
+            # but I am not sure what is the reason that these are tagged VERB.
+            if len(morphemes) > 1 and re.match(r"^(kan|i|an(_NSD)?)$", morphemes[-1]):
                 del morphemes[-1]
             # Expected prefixes are meN-, di-, ber-, peN-, ke-, ter-, se-, or no prefix at all.
             # There can be two prefixes in a row, e.g., "ber+ke+", or "ter+peN+".

From 5659d820afe8ff2dfabf1785a4fdd3e94ab58a3a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 17 Sep 2021 16:34:22 +0200
Subject: [PATCH 0448/1374] New fixes for Indonesian.

---
 udapi/block/ud/id/addmwt.py | 73 ++++++++++++++++++++++++++++++++++---
 udapi/block/ud/id/fixgsd.py | 48 ++++++++++++++++++++++++
 2 files changed, 116 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
index 1270ba77..7e8db2f0 100644
--- a/udapi/block/ud/id/addmwt.py
+++ b/udapi/block/ud/id/addmwt.py
@@ -52,10 +52,6 @@ def multiword_analysis(self, node):
                 splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
                 # The noun with -nya typically has Number[psor]=Sing|Person[psor]=3.
                 # Remove these features from the noun and give the pronoun normal features Number=Sing|Person=3.
-                if node.feats['Number[psor]'] != 'Sing':
-                    logging.warning("Noun '%s' has Number[psor]=='%s'" % (node.form, node.feats['Number[psor]']))
-                if node.feats['Person[psor]'] != '3':
-                    logging.warning("Noun '%s' has Person[psor]=='%s'" % (node.form, node.feats['Person[psor]']))
                 node.feats['Number[psor]'] = ''
                 node.feats['Person[psor]'] = ''
                 lemma = re.sub(r' nya$', ' dia', splitform.lower())
@@ -65,8 +61,75 @@ def multiword_analysis(self, node):
                 deprel = '* nmod:poss'
                 # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
                 return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
+            elif node.upos == 'ADJ':
+                # nominalized adjective
+                splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
+                lemma = splitform.lower()
+                upos = 'ADJ DET'
+                feats = '* Definite=Def|PronType=Art'
+                xpos = re.sub(r'\+', ' ', node.xpos)
+                deprel = '* det'
+                # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
+                return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
+            elif re.match(r'^(banyak|semua)nya$', node.form, re.IGNORECASE):
+                # semua = all (DET)
+                # semuanya = nominalization of semua, i.e., 'everything' (PRON)
+                # banyak = many, much (DET)
+                # banyaknya = nominalization of banyak, i.e., 'a lot' (PRON)
+                splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
+                lemma = splitform.lower()
+                upos = 'DET DET'
+                feats = ('PronType=Tot' if lemma == 'semua nya' else 'PronType=Ind')+' Definite=Def|PronType=Art'
+                xpos = re.sub(r'\+', ' ', node.xpos)
+                deprel = '* det'
+                # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
+                return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
+            elif re.match(r'^(satu)nya$', node.form, re.IGNORECASE):
+                # satu = one (NUM)
+                # satunya = nominalization of satu, meaning 'the only one'
+                splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
+                lemma = splitform.lower()
+                upos = 'NUM DET'
+                feats = 'NumType=Card Definite=Def|PronType=Art'
+                xpos = re.sub(r'\+', ' ', node.xpos)
+                deprel = '* det'
+                # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
+                return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
+            elif node.upos == 'ADP' and node.xpos == 'R--+PS3' or re.match(r'^(bersama|dibawah|didalam|sekitar)nya$', node.form, re.IGNORECASE):
+                # Fused preposition and pronoun.
+                # Most of them are recognized as R--+PS3 by MorphInd. However, some are different:
+                # bersamanya = 'with him' = VSA+PS3
+                # dibawahnya = 'under it' = VSP+PS3
+                # didalamnya = 'inside it' = VSP+PS3
+                # sekitarnya = 'around it' = D--+PS3
+                # However:
+                # layaknya = 'like' is a derivation from 'layak' = 'worthy' (ASP+PS3)
+                splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
+                lemma = re.sub(r' nya$', ' dia', splitform.lower())
+                upos = 'ADP PRON'
+                feats = '_ Number=Sing|Person=3|PronType=Prs'
+                xpos = 'R-- PS3'
+                if node.udeprel == 'case':
+                    if re.match(r'^(NOUN|PROPN|PRON|DET|NUM|X|SYM)$', node.parent.upos):
+                        deprel = 'nmod'
+                    else:
+                        deprel = 'obl'
+                else:
+                    deprel = '*'
+                deprel = 'case '+deprel
+                return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'main': 1, 'shape': 'subtree', 'deprel': deprel}
             else:
-                logging.warning("Form '%s' analyzed by MorphInd as having the -nya clitic but the UPOS is '%s'" % (node.form, node.upos))
+                # Do not warn about instances that are known exceptions.
+                # akibatnya = as a result (SCONJ); akibat = result
+                # bukannya = instead (PART); bukan = no, not
+                # dirinya = reflexive himself/herself/itself (similarly, diriku = myself, dirimu = yourself; somewhere else we should check that they have the right features)
+                # layaknya = like (ADP); layak = worthy
+                # sebaiknya = should (AUX)
+                # sesampainya = once in / arriving at (ADP)
+                # tidaknya = whether or not (PART); tidak = no, not
+                # Adverbs are an exception, too. The -nya morpheme could be derivation. E.g., 'ironis' = 'ironic'; 'ironisnya' = 'ironically'.
+                if node.upos != 'ADV' and not re.match(r'^(akibat|bukan|diri|layak|sebaik|sesampai|tidak)nya$', node.form, re.IGNORECASE):
+                    logging.warning("Form '%s' analyzed by MorphInd as having the -nya clitic but the UPOS is '%s' and XPOS is '%s'" % (node.form, node.upos, node.xpos))
                 return None
         return None
 
diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index 481630fa..fce6e4f9 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -5,6 +5,52 @@
 
 class FixGSD(Block):
 
+    def fix_upos_based_on_morphind(self, node):
+        """
+        Example from data: ("kesamaan"), the correct UPOS is NOUN, as
+        suggested by MorphInd.
+        Based on my observation so far, if there is a different UPOS between
+        the original GSD and MorphInd, it's better to trust MorphInd
+        I found so many incorrect UPOS in GSD, especially when NOUNs become
+        VERBs and VERBs become NOUNs.
+        I suggest adding Voice=Pass when the script decides ke-xxx-an as VERB.
+        """
+        if node.upos == 'VERB' and node.xpos == 'NSD' and re.match(r'^ke.+an$', node.form, re.IGNORECASE):
+            node.upos = 'NOUN'
+            if node.udeprel == 'acl':
+                node.deprel = 'nmod'
+            elif node.udeprel == 'advcl':
+                node.deprel = 'obl'
+
+    def fix_ordinal_numerals(self, node):
+        """
+        Ordinal numerals should be ADJ NumType=Ord in UD. They have many different
+        UPOS tags in Indonesian GSD. This method harmonizes them.
+        pertama = first
+        kedua = second
+        ketiga = third
+        keempat = fourth
+        kelima = fifth
+        keenam = sixth
+        ketujuh = seventh
+        kedelapan = eighth
+        kesembilan = ninth
+        ke48 = 48th
+        """
+        # We could also check the XPOS, which is derived from MorphInd: re.match(r'^CO-', node.xpos)
+        if re.match(r'^(pertama|kedua|ketiga|keempat|kelima|keenam|ketujuh|kedelapan|kesembilan|ke-?\d+)(nya)?$', node.form, re.IGNORECASE):
+            node.upos = 'ADJ'
+            node.feats['NumType'] = 'Ord'
+            if re.match(r'^(det|nummod|nmod)$', node.udeprel):
+                node.deprel = 'amod'
+        # The following is not an ordinal numeral but I am too lazy to create a separate method for that.
+        elif node.form.lower() == 'semua':
+            # It means 'all'. Originally it was DET, PRON, or ADV.
+            node.upos = 'DET'
+            node.feats['PronType'] = 'Tot'
+            if node.udeprel == 'nmod' or node.udeprel == 'advmod':
+                node.deprel = 'det'
+
     def lemmatize_verb_from_morphind(self, node):
         # The MISC column contains the output of MorphInd for the current word.
         # The analysis has been interpreted wrongly for some verbs, so we need
@@ -79,4 +125,6 @@ def fix_plural_propn(self, node):
 
     def process_node(self, node):
         self.fix_plural_propn(node)
+        self.fix_upos_based_on_morphind(node)
+        self.fix_ordinal_numerals(node)
         self.lemmatize_verb_from_morphind(node)

From f611e3e74192cef526d7ef702faf3f6c50a7838b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 17 Sep 2021 17:55:40 +0200
Subject: [PATCH 0449/1374] Splitting -kah, -lah, -pun, -tah in Indonesian.

---
 udapi/block/ud/id/addmwt.py | 13 +++++++++-
 udapi/block/ud/id/fixgsd.py | 51 ++++++++++++++++++++-----------------
 2 files changed, 39 insertions(+), 25 deletions(-)

diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
index 7e8db2f0..65aed6dc 100644
--- a/udapi/block/ud/id/addmwt.py
+++ b/udapi/block/ud/id/addmwt.py
@@ -131,11 +131,22 @@ def multiword_analysis(self, node):
                 if node.upos != 'ADV' and not re.match(r'^(akibat|bukan|diri|layak|sebaik|sesampai|tidak)nya$', node.form, re.IGNORECASE):
                     logging.warning("Form '%s' analyzed by MorphInd as having the -nya clitic but the UPOS is '%s' and XPOS is '%s'" % (node.form, node.upos, node.xpos))
                 return None
+        elif re.search(r'(kah|lah|pun|tah)$', node.form, re.IGNORECASE) and re.search(r'\+(kah|lah|pun|tah)<t>_T--\$$', node.misc['MorphInd']):
+            splitform = re.sub(r'(kah|lah|pun|tah)$', r' \1', node.form, flags=re.IGNORECASE)
+            lemma = splitform.lower()
+            upos = '* PART'
+            feats = '* _'
+            xpos = re.sub(r'\+', ' ', node.xpos)
+            if len(xpos.split()) < 2:
+                xpos = xpos + ' T--'
+            deprel = '* advmod:emph'
+            # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
+            return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
         return None
 
     def postprocess_mwt(self, mwt):
         """Distribute the MorphInd analysis to the two parts so that we can later use it to fix the lemmas of verbs."""
-        match = re.match(r'^\^(.*)\+(dia<p>_PS3)\$$', mwt.misc['MorphInd'])
+        match = re.match(r'^\^(.*)\+(dia<p>_PS3|kah<t>_T--|lah<t>_T--|pun<t>_T--|tah<t>_T--)\$$', mwt.misc['MorphInd'])
         if match:
             mwt.words[0].misc['MorphInd'] = '^'+match.group(1)+'$'
             mwt.words[1].misc['MorphInd'] = '^'+match.group(2)+'$'
diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index fce6e4f9..4ea96968 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -57,31 +57,34 @@ def lemmatize_verb_from_morphind(self, node):
         # to re-interpret it and extract the correct lemma.
         if node.upos == "VERB":
             morphind = node.misc["MorphInd"]
-            # Remove the start and end tags from morphind.
-            morphind = re.sub(r"^\^", "", morphind)
-            morphind = re.sub(r"\$$", "", morphind)
-            # Remove the final XPOS tag from morphind.
-            morphind = re.sub(r"_VS[AP]$", "", morphind)
-            # Split morphind to prefix, stem, and suffix.
-            morphemes = re.split(r"\+", morphind)
-            # Expected suffixes are -kan, -i, -an, or no suffix at all.
-            # There is also the circumfix ke-...-an which seems to be nominalized adjective:
-            # "sama" = "same, similar"; "kesamaan" = "similarity", lemma is "sama";
-            # but I am not sure what is the reason that these are tagged VERB.
-            if len(morphemes) > 1 and re.match(r"^(kan|i|an(_NSD)?)$", morphemes[-1]):
-                del morphemes[-1]
-            # Expected prefixes are meN-, di-, ber-, peN-, ke-, ter-, se-, or no prefix at all.
-            # There can be two prefixes in a row, e.g., "ber+ke+", or "ter+peN+".
-            while len(morphemes) > 1 and re.match(r"^(meN|di|ber|peN|ke|ter|se|per)$", morphemes[0]):
-                del morphemes[0]
-            # Check that we are left with just one morpheme.
-            if len(morphemes) != 1:
-                logging.warning("One morpheme expected, found %d %s, morphind = '%s', form = '%s', feats = '%s'" % (len(morphemes), morphemes, morphind, node.form, node.feats))
+            if morphind:
+                # Remove the start and end tags from morphind.
+                morphind = re.sub(r"^\^", "", morphind)
+                morphind = re.sub(r"\$$", "", morphind)
+                # Remove the final XPOS tag from morphind.
+                morphind = re.sub(r"_VS[AP]$", "", morphind)
+                # Split morphind to prefix, stem, and suffix.
+                morphemes = re.split(r"\+", morphind)
+                # Expected suffixes are -kan, -i, -an, or no suffix at all.
+                # There is also the circumfix ke-...-an which seems to be nominalized adjective:
+                # "sama" = "same, similar"; "kesamaan" = "similarity", lemma is "sama";
+                # but I am not sure what is the reason that these are tagged VERB.
+                if len(morphemes) > 1 and re.match(r"^(kan|i|an(_NSD)?)$", morphemes[-1]):
+                    del morphemes[-1]
+                # Expected prefixes are meN-, di-, ber-, peN-, ke-, ter-, se-, or no prefix at all.
+                # There can be two prefixes in a row, e.g., "ber+ke+", or "ter+peN+".
+                while len(morphemes) > 1 and re.match(r"^(meN|di|ber|peN|ke|ter|se|per)$", morphemes[0]):
+                    del morphemes[0]
+                # Check that we are left with just one morpheme.
+                if len(morphemes) != 1:
+                    logging.warning("One morpheme expected, found %d %s, morphind = '%s', form = '%s', feats = '%s'" % (len(morphemes), morphemes, morphind, node.form, node.feats))
+                else:
+                    lemma = morphemes[0]
+                    # Remove the stem POS category.
+                    lemma = re.sub(r"<[a-z]+>(_.*)?$", "", lemma)
+                    node.lemma = lemma
             else:
-                lemma = morphemes[0]
-                # Remove the stem POS category.
-                lemma = re.sub(r"<[a-z]+>(_.*)?$", "", lemma)
-                node.lemma = lemma
+                logging.warning("No MorphInd analysis found for form '%s'" % (node.form))
 
     def merge_reduplicated_plural(self, node):
         # Instead of compound:plur, merge the reduplicated plurals into a single token.

From 9dc01a1620237e97d446782714be27343129a942 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 17 Sep 2021 21:47:21 +0200
Subject: [PATCH 0450/1374] More Indonesian clitics.

---
 udapi/block/ud/id/addmwt.py | 82 ++++++++++++++++++++++++++++---------
 udapi/block/ud/id/fixgsd.py |  2 +-
 2 files changed, 63 insertions(+), 21 deletions(-)

diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
index 65aed6dc..7f5ab271 100644
--- a/udapi/block/ud/id/addmwt.py
+++ b/udapi/block/ud/id/addmwt.py
@@ -11,9 +11,30 @@ class AddMwt(udapi.block.ud.addmwt.AddMwt):
 
     def multiword_analysis(self, node):
         """Return a dict with MWT info or None if `node` does not represent a multiword token."""
-        if re.search(r'nya$', node.form, re.IGNORECASE) and re.search(r'\+dia<p>_PS3\$$', node.misc['MorphInd']):
+        if re.search(r'^(ku|kau)', node.form, re.IGNORECASE) and re.search(r'^\^(aku<p>_PS1|kamu<p>_PS2)\+', node.misc['MorphInd']) and node.upos == 'VERB':
+            splitform = re.sub(r'^(ku|kau)', r'\1 ', node.form, flags=re.IGNORECASE)
+            # The verb with -nya typically has Number[psor]=Sing|Person[psor]=3.
+            # Remove these features from the verb and give the pronoun normal features Number=Sing|Person=3.
+            node.feats['Number[psor]'] = ''
+            node.feats['Person[psor]'] = ''
+            upos = 'PRON VERB'
+            if re.search(r'^ku ', splitform.lower()):
+                lemma = re.sub(r'^ku ', 'aku ', splitform.lower())
+                feats = 'Number=Sing|Person=1|PronType=Prs *'
+                xpos = re.sub(r'\+', ' ', node.xpos)
+                if len(xpos.split())<2:
+                    xpos = 'PS1 VSA'
+            else:
+                lemma = re.sub(r'^kau ', 'kamu ', splitform.lower())
+                feats = 'Number=Sing|Person=2|PronType=Prs *'
+                xpos = re.sub(r'\+', ' ', node.xpos)
+                if len(xpos.split())<2:
+                    xpos = 'PS2 VSA'
+            deprel = 'nsubj *'
+            return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'main': 1, 'shape': 'subtree', 'deprel': deprel}
+        elif re.search(r'(nya|ku|mu)$', node.form, re.IGNORECASE) and re.search(r'\+(dia<p>_PS3|aku<p>_PS1|kamu<p>_PS2)\$$', node.misc['MorphInd']):
             if node.upos == 'VERB':
-                splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
+                splitform = re.sub(r'(nya|ku|mu)$', r' \1', node.form, flags=re.IGNORECASE)
                 # For transitive verbs with the meN- prefix, -nya is an object clitic.
                 # For passive verbs with the di- prefix, -nya refers to a passive agent.
                 # For verbs with prefixes ber-, ter-, and verbs without prefixes, -nya is a definite article and signals nominalization.
@@ -23,10 +44,6 @@ def multiword_analysis(self, node):
                 nominalization = not menverb and not diverb
                 # The verb with -nya typically has Number[psor]=Sing|Person[psor]=3.
                 # Remove these features from the verb and give the pronoun normal features Number=Sing|Person=3.
-                if node.feats['Number[psor]'] != 'Sing':
-                    logging.warning("Verb '%s' has Number[psor]=='%s'" % (node.form, node.feats['Number[psor]']))
-                if node.feats['Person[psor]'] != '3':
-                    logging.warning("Verb '%s' has Person[psor]=='%s'" % (node.form, node.feats['Person[psor]']))
                 node.feats['Number[psor]'] = ''
                 node.feats['Person[psor]'] = ''
                 if nominalization:
@@ -35,9 +52,16 @@ def multiword_analysis(self, node):
                     feats = '* Definite=Def|PronType=Art'
                     deprel = '* det'
                 else:
-                    lemma = re.sub(r' nya$', ' dia', splitform.lower())
                     upos = 'VERB PRON'
-                    feats = '* Number=Sing|Person=3|PronType=Prs'
+                    if re.search(r' nya$', splitform.lower()):
+                        lemma = re.sub(r' nya$', ' dia', splitform.lower())
+                        feats = '* Number=Sing|Person=3|PronType=Prs'
+                    elif re.search(r' ku$', splitform.lower()):
+                        lemma = re.sub(r' ku$', ' aku', splitform.lower())
+                        feats = '* Number=Sing|Person=1|PronType=Prs'
+                    else:
+                        lemma = re.sub(r' mu$', ' kamu', splitform.lower())
+                        feats = '* Number=Sing|Person=2|PronType=Prs'
                     # The agent of the passive verb is coded like a direct object of an active verb,
                     # so we might want to use obj:agent rather than obl:agent. However, full nominals
                     # as passive agents can be optionally accompanied by the preposition _oleh_ "by",
@@ -49,19 +73,26 @@ def multiword_analysis(self, node):
                 # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
                 return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
             elif re.match(r'(NOUN|PROPN|X)', node.upos):
-                splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
+                splitform = re.sub(r'(nya|ku|mu)$', r' \1', node.form, flags=re.IGNORECASE)
                 # The noun with -nya typically has Number[psor]=Sing|Person[psor]=3.
                 # Remove these features from the noun and give the pronoun normal features Number=Sing|Person=3.
                 node.feats['Number[psor]'] = ''
                 node.feats['Person[psor]'] = ''
-                lemma = re.sub(r' nya$', ' dia', splitform.lower())
                 upos = '* PRON'
-                feats = '* Number=Sing|Person=3|PronType=Prs'
+                if re.search(r' nya$', splitform.lower()):
+                    lemma = re.sub(r' nya$', ' dia', splitform.lower())
+                    feats = '* Number=Sing|Person=3|PronType=Prs'
+                elif re.search(r' ku$', splitform.lower()):
+                    lemma = re.sub(r' ku$', ' aku', splitform.lower())
+                    feats = '* Number=Sing|Person=1|PronType=Prs'
+                else:
+                    lemma = re.sub(r' mu$', ' kamu', splitform.lower())
+                    feats = '* Number=Sing|Person=2|PronType=Prs'
                 xpos = re.sub(r'\+', ' ', node.xpos)
                 deprel = '* nmod:poss'
                 # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
                 return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
-            elif node.upos == 'ADJ':
+            elif node.upos == 'ADJ' and re.search(r'(nya)$', node.form, re.IGNORECASE):
                 # nominalized adjective
                 splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
                 lemma = splitform.lower()
@@ -95,7 +126,7 @@ def multiword_analysis(self, node):
                 deprel = '* det'
                 # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
                 return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
-            elif node.upos == 'ADP' and node.xpos == 'R--+PS3' or re.match(r'^(bersama|dibawah|didalam|sekitar)nya$', node.form, re.IGNORECASE):
+            elif node.upos == 'ADP' and re.match(r'^R--\+PS[123]$', node.xpos) or re.match(r'^(bersama|dibawah|didalam|sekitar)nya$', node.form, re.IGNORECASE):
                 # Fused preposition and pronoun.
                 # Most of them are recognized as R--+PS3 by MorphInd. However, some are different:
                 # bersamanya = 'with him' = VSA+PS3
@@ -104,11 +135,20 @@ def multiword_analysis(self, node):
                 # sekitarnya = 'around it' = D--+PS3
                 # However:
                 # layaknya = 'like' is a derivation from 'layak' = 'worthy' (ASP+PS3)
-                splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
-                lemma = re.sub(r' nya$', ' dia', splitform.lower())
+                splitform = re.sub(r'(nya|ku|mu)$', r' \1', node.form, flags=re.IGNORECASE)
                 upos = 'ADP PRON'
-                feats = '_ Number=Sing|Person=3|PronType=Prs'
-                xpos = 'R-- PS3'
+                if re.search(r' nya$', splitform.lower()):
+                    lemma = re.sub(r' nya$', ' dia', splitform.lower())
+                    feats = '* Number=Sing|Person=3|PronType=Prs'
+                    xpos = 'R-- PS3'
+                elif re.search(r' ku$', splitform.lower()):
+                    lemma = re.sub(r' ku$', ' aku', splitform.lower())
+                    feats = '* Number=Sing|Person=1|PronType=Prs'
+                    xpos = 'R-- PS1'
+                else:
+                    lemma = re.sub(r' mu$', ' kamu', splitform.lower())
+                    feats = '* Number=Sing|Person=2|PronType=Prs'
+                    xpos = 'R-- PS2'
                 if node.udeprel == 'case':
                     if re.match(r'^(NOUN|PROPN|PRON|DET|NUM|X|SYM)$', node.parent.upos):
                         deprel = 'nmod'
@@ -128,8 +168,8 @@ def multiword_analysis(self, node):
                 # sesampainya = once in / arriving at (ADP)
                 # tidaknya = whether or not (PART); tidak = no, not
                 # Adverbs are an exception, too. The -nya morpheme could be derivation. E.g., 'ironis' = 'ironic'; 'ironisnya' = 'ironically'.
-                if node.upos != 'ADV' and not re.match(r'^(akibat|bukan|diri|layak|sebaik|sesampai|tidak)nya$', node.form, re.IGNORECASE):
-                    logging.warning("Form '%s' analyzed by MorphInd as having the -nya clitic but the UPOS is '%s' and XPOS is '%s'" % (node.form, node.upos, node.xpos))
+                if node.upos != 'ADV' and not re.match(r'^(akibat|bukan|diri|layak|sebaik|sesampai|tidak)(nya|ku|mu)$', node.form, re.IGNORECASE):
+                    logging.warning("Form '%s' analyzed by MorphInd as having the -nya|-ku|-mu clitic but the UPOS is '%s' and XPOS is '%s'" % (node.form, node.upos, node.xpos))
                 return None
         elif re.search(r'(kah|lah|pun|tah)$', node.form, re.IGNORECASE) and re.search(r'\+(kah|lah|pun|tah)<t>_T--\$$', node.misc['MorphInd']):
             splitform = re.sub(r'(kah|lah|pun|tah)$', r' \1', node.form, flags=re.IGNORECASE)
@@ -146,7 +186,9 @@ def multiword_analysis(self, node):
 
     def postprocess_mwt(self, mwt):
         """Distribute the MorphInd analysis to the two parts so that we can later use it to fix the lemmas of verbs."""
-        match = re.match(r'^\^(.*)\+(dia<p>_PS3|kah<t>_T--|lah<t>_T--|pun<t>_T--|tah<t>_T--)\$$', mwt.misc['MorphInd'])
+        match = re.match(r'^\^(.*)\+(aku<p>_PS1|kamu<p>_PS2|dia<p>_PS3|kah<t>_T--|lah<t>_T--|pun<t>_T--|tah<t>_T--)\$$', mwt.misc['MorphInd'])
+        if not match:
+            match = re.match(r'^\^(aku<p>_PS1|kamu<p>_PS2)\+(.*)\$$', mwt.misc['MorphInd'])
         if match:
             mwt.words[0].misc['MorphInd'] = '^'+match.group(1)+'$'
             mwt.words[1].misc['MorphInd'] = '^'+match.group(2)+'$'
diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index 4ea96968..926bc346 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -62,7 +62,7 @@ def lemmatize_verb_from_morphind(self, node):
                 morphind = re.sub(r"^\^", "", morphind)
                 morphind = re.sub(r"\$$", "", morphind)
                 # Remove the final XPOS tag from morphind.
-                morphind = re.sub(r"_VS[AP]$", "", morphind)
+                morphind = re.sub(r"_V[SP][AP]$", "", morphind)
                 # Split morphind to prefix, stem, and suffix.
                 morphemes = re.split(r"\+", morphind)
                 # Expected suffixes are -kan, -i, -an, or no suffix at all.

From 1a95f38523b7fa3e30a9c868269f9330a740237a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 17 Sep 2021 23:12:24 +0200
Subject: [PATCH 0451/1374] More Indonesian fixes.

---
 udapi/block/ud/id/fixgsd.py | 43 +++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index 926bc346..d1c735a4 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -126,8 +126,51 @@ def fix_plural_propn(self, node):
         if node.upos == 'PROPN':
             node.feats['Number'] = ''
 
+    def fix_satu_satunya(self, node):
+        """
+        'satu' = 'one' (NUM)
+        'satu-satunya' = 'the only'
+        """
+        root = node.root
+        if node.form == 'nya' and node.parent.form.lower() == 'satu' and node.parent.udeprel == 'fixed' and node.parent.parent.form.lower() == 'satu':
+            satu0 = node.parent.parent
+            satu1 = node.parent
+            nya = node
+            dash = None
+            if satu1.ord == satu0.ord+2 and satu1.prev_node.form == '-':
+                dash = satu1.prev_node
+                satu0.misc['SpaceAfter'] = 'No'
+                dash.misc['SpaceAfter'] = 'No'
+                root.text = root.compute_text()
+            satu1.deprel = 'compound:redup'
+            nya.parent = satu0
+        # We actually cannot leave the 'compound:redup' here because it is not used in Indonesian.
+        if node.form == 'nya' and node.parent.form.lower() == 'satu':
+            satu0 = node.parent
+            nya = node
+            if satu0.next_node.form == '-':
+                dash = satu0.next_node
+                if dash.next_node.form.lower() == 'satu':
+                    satu1 = dash.next_node
+                    if satu1.ord == node.ord-1:
+                        # Merge satu0 + dash + satu1 into one node.
+                        satu0.form = satu0.form + dash.form + satu1.form
+                        dash.remove()
+                        satu1.remove()
+                        # There should be a multi-word token comprising satu1 + nya.
+                        mwt = nya.multiword_token
+                        if mwt:
+                            mwtmisc = mwt.misc.copy()
+                            mwt.remove()
+                            mwt = root.create_multiword_token([satu0, nya], satu0.form + nya.form, mwtmisc)
+                            satu0.misc['SpaceAfter'] = ''
+                        root.text = root.compute_text()
+        if node.multiword_token and node.no_space_after:
+            node.misc['SpaceAfter'] = ''
+
     def process_node(self, node):
         self.fix_plural_propn(node)
         self.fix_upos_based_on_morphind(node)
         self.fix_ordinal_numerals(node)
         self.lemmatize_verb_from_morphind(node)
+        self.fix_satu_satunya(node)

From bfada9deeb004a60438bb0b9562270f051877d3c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 19 Sep 2021 22:40:57 +0200
Subject: [PATCH 0452/1374] Distinguishing Indonesian ordinal numerals from
 total cardinal numerals.

---
 udapi/block/ud/id/fixgsd.py | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index d1c735a4..6247cba0 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -36,13 +36,32 @@ def fix_ordinal_numerals(self, node):
         kedelapan = eighth
         kesembilan = ninth
         ke48 = 48th
+
+        However! The ke- forms (i.e., not 'pertama') can also function as total
+        versions of cardinal numbers ('both', 'all three' etc.). If the numeral
+        precedes the noun, it is a total cardinal; if it follows the noun, it is
+        an ordinal. An exception is when the modified noun is 'kali' = 'time'.
+        Then the numeral is ordinal regardless where it occurs, and together
+        with 'kali' it functions as an adverbial ordinal ('for the second time').
         """
         # We could also check the XPOS, which is derived from MorphInd: re.match(r'^CO-', node.xpos)
-        if re.match(r'^(pertama|kedua|ketiga|keempat|kelima|keenam|ketujuh|kedelapan|kesembilan|ke-?\d+)(nya)?$', node.form, re.IGNORECASE):
+        if re.match(r'^pertama(nya)?$', node.form, re.IGNORECASE):
             node.upos = 'ADJ'
             node.feats['NumType'] = 'Ord'
             if re.match(r'^(det|nummod|nmod)$', node.udeprel):
                 node.deprel = 'amod'
+        elif re.match(r'^(kedua|ketiga|keempat|kelima|keenam|ketujuh|kedelapan|kesembilan|ke-?\d+)(nya)?$', node.form, re.IGNORECASE):
+            if node.parent.ord < node.ord or node.parent.lemma == 'kali':
+                node.upos = 'ADJ'
+                node.feats['NumType'] = 'Ord'
+                if re.match(r'^(det|nummod|nmod)$', node.udeprel):
+                    node.deprel = 'amod'
+            else:
+                node.upos = 'NUM'
+                node.feats['NumType'] = 'Card'
+                node.feats['PronType'] = 'Tot'
+                if re.match(r'^(det|amod|nmod)$', node.udeprel):
+                    node.deprel = 'nummod'
         # The following is not an ordinal numeral but I am too lazy to create a separate method for that.
         elif node.form.lower() == 'semua':
             # It means 'all'. Originally it was DET, PRON, or ADV.

From 12aa517448a8b5fa79af1e115f41dc8d867acbe6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 20 Sep 2021 10:53:11 +0200
Subject: [PATCH 0453/1374] Fix tokenization of ordinal numerals in Indonesian.

---
 udapi/block/ud/id/fixgsd.py | 51 +++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index 6247cba0..2296fc31 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -70,6 +70,56 @@ def fix_ordinal_numerals(self, node):
             if node.udeprel == 'nmod' or node.udeprel == 'advmod':
                 node.deprel = 'det'
 
+    def rejoin_ordinal_numerals(self, node):
+        """
+        If an ordinal numeral is spelled using digits ('ke-18'), it is often
+        tokenized as multiple tokens, which is wrong. Fix it.
+        """
+        if node.form.lower() == 'ke':
+            dash = None
+            number = None
+            if node.next_node:
+                if node.next_node.form == '-':
+                    dash = node.next_node
+                    if dash.next_node and re.match(r'^\d+$', dash.next_node.form):
+                        number = dash.next_node
+                        node.form = node.form + dash.form + number.form
+                        node.lemma = node.lemma + dash.lemma + number.lemma
+                elif re.match(r'^\d+$', node.next_node.form) and (node.parent == node.next_node or node.next_node.parent == node):
+                    number = node.next_node
+                    node.feats['Typo'] = 'Yes'
+                    node.misc['CorrectForm'] = node.form + '-' + number.form
+                    node.form = node.form + number.form
+                    node.lemma = node.lemma + '-' + number.lemma
+                if number:
+                    # Let us pretend that these forms are always ordinal numerals.
+                    # Situations where they act as total cardinals will be disambiguated
+                    # in a subsequent call to fix_ordinal_numerals().
+                    node.upos = 'ADJ'
+                    node.xpos = 'CO-'
+                    node.feats['NumType'] = 'Ord'
+                    node.misc['MorphInd'] = '^ke<r>_R--+' + number.form + '<c>_CC-$'
+                    # Find the parent node. Assume that the dash, if present, was not the head.
+                    if node.parent == number:
+                        node.parent = number.parent
+                        node.deprel = number.deprel
+                    if re.match(r'(case|mark|det|nummod|nmod)', node.udeprel):
+                        node.deprel = 'amod'
+                    # Adjust SpaceAfter.
+                    node.misc['SpaceAfter'] = 'No' if number.no_space_after else ''
+                    # Remove the separate node of the dash and the number.
+                    if dash:
+                        if len(dash.children) > 0:
+                            for c in dash.children:
+                                c.parent = node
+                        dash.remove()
+                    if len(number.children) > 0:
+                        for c in number.children:
+                            c.parent = node
+                    number.remove()
+                    # There may have been spaces around the dash, which are now gone. Recompute the sentence text.
+                    node.root.text = node.root.compute_text()
+
     def lemmatize_verb_from_morphind(self, node):
         # The MISC column contains the output of MorphInd for the current word.
         # The analysis has been interpreted wrongly for some verbs, so we need
@@ -190,6 +240,7 @@ def fix_satu_satunya(self, node):
     def process_node(self, node):
         self.fix_plural_propn(node)
         self.fix_upos_based_on_morphind(node)
+        self.rejoin_ordinal_numerals(node)
         self.fix_ordinal_numerals(node)
         self.lemmatize_verb_from_morphind(node)
         self.fix_satu_satunya(node)

From f413c812239863b9e216bf5b258496668494fff0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 20 Sep 2021 13:39:20 +0200
Subject: [PATCH 0454/1374] "ke48" is a typo (although it occurs in the
 corpus), the correct spelling is "ke-48".

---
 udapi/block/ud/id/fixgsd.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index 2296fc31..edc71142 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -35,7 +35,7 @@ def fix_ordinal_numerals(self, node):
         ketujuh = seventh
         kedelapan = eighth
         kesembilan = ninth
-        ke48 = 48th
+        ke-48 = 48th
 
         However! The ke- forms (i.e., not 'pertama') can also function as total
         versions of cardinal numbers ('both', 'all three' etc.). If the numeral

From cda5e7ade81b8d00d921e87cd52f02f6edf2c71e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 22 Sep 2021 17:42:06 +0200
Subject: [PATCH 0455/1374] after_process_document should print before
 redirecting

fixes #94
---
 udapi/block/write/textmodetreeshtml.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/write/textmodetreeshtml.py b/udapi/block/write/textmodetreeshtml.py
index 75a39a97..9f9f6aa2 100644
--- a/udapi/block/write/textmodetreeshtml.py
+++ b/udapi/block/write/textmodetreeshtml.py
@@ -53,8 +53,8 @@ def before_process_document(self, document):
                 print('%s = %s' % (key, value))
 
     def after_process_document(self, document):
-        super().after_process_document(document)
         print("</pre>\n</body>\n</html>")
+        super().after_process_document(document)
 
     def add_node(self, idx, node):
         if not node.is_root():

From 1f61ca4894179d95bea29fcf2baf8c6e44ef48d3 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 2 Oct 2021 15:30:51 +0200
Subject: [PATCH 0456/1374] Merge tokens describing decades in Indonesian.

---
 udapi/block/ud/id/fixgsd.py | 52 +++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index edc71142..9634bc2d 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -120,6 +120,57 @@ def rejoin_ordinal_numerals(self, node):
                     # There may have been spaces around the dash, which are now gone. Recompute the sentence text.
                     node.root.text = node.root.compute_text()
 
+    def rejoin_decades(self, node):
+        """
+        In Indonesian, the equivalent of English "1990s" is written as "1990-an".
+        In GSD, it is often tokenized as multiple tokens, which is wrong. Fix it.
+        """
+        if node.form.lower() == 'an':
+            dash = None
+            number = None
+            if node.prev_node:
+                if node.prev_node.form == '-':
+                    dash = node.prev_node
+                    if dash.prev_node and re.match(r'^\d+$', dash.prev_node.form):
+                        number = dash.prev_node
+                        node.form = number.form + dash.form + node.form
+                        node.lemma = number.lemma + dash.lemma + node.lemma
+                elif re.match(r'^\d+$', node.prev_node.form) and (node.parent == node.prev_node or node.prev_node.parent == node):
+                    number = node.prev_node
+                    node.feats['Typo'] = 'Yes'
+                    node.misc['CorrectForm'] = number.form + '-' + node.form
+                    node.form = number.form + node.form
+                    node.lemma = number.lemma + '-' + node.lemma
+                if number:
+                    # The combined token is no longer a numeral. It cannot quantify an entity.
+                    # Instead, it is itself something like a noun (or perhaps proper noun).
+                    node.upos = 'NOUN'
+                    node.xpos = 'NSD'
+                    node.feats['NumType'] = ''
+                    # In some cases, "-an" is labeled as foreign for no obvious reason.
+                    node.feats['Foreign'] = ''
+                    node.misc['MorphInd'] = '^' + number.form + '<c>_CC-+an<f>_F--$'
+                    # Find the parent node. Assume that the dash, if present, was not the head.
+                    if node.parent == number:
+                        node.parent = number.parent
+                        node.deprel = number.deprel
+                    if re.match(r'(case|mark|det|nummod|nmod)', node.udeprel):
+                        node.deprel = 'nmod'
+                    # No need to adjust SpaceAfter, as the 'an' node was the last one in the complex.
+                    #node.misc['SpaceAfter'] = 'No' if number.no_space_after else ''
+                    # Remove the separate node of the dash and the number.
+                    if dash:
+                        if len(dash.children) > 0:
+                            for c in dash.children:
+                                c.parent = node
+                        dash.remove()
+                    if len(number.children) > 0:
+                        for c in number.children:
+                            c.parent = node
+                    number.remove()
+                    # There may have been spaces around the dash, which are now gone. Recompute the sentence text.
+                    node.root.text = node.root.compute_text()
+
     def lemmatize_verb_from_morphind(self, node):
         # The MISC column contains the output of MorphInd for the current word.
         # The analysis has been interpreted wrongly for some verbs, so we need
@@ -242,5 +293,6 @@ def process_node(self, node):
         self.fix_upos_based_on_morphind(node)
         self.rejoin_ordinal_numerals(node)
         self.fix_ordinal_numerals(node)
+        self.rejoin_decades(node)
         self.lemmatize_verb_from_morphind(node)
         self.fix_satu_satunya(node)

From e7d7502b79a2170ecad339607d8e6b3f44dc5ba9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 2 Oct 2021 23:32:14 +0200
Subject: [PATCH 0457/1374] More fixes for Indonesian UD.

---
 udapi/block/ud/addmwt.py    |  5 ++++
 udapi/block/ud/id/addmwt.py | 31 ++++++++++++++++++--
 udapi/block/ud/id/fixgsd.py | 57 ++++++++++++++++++++++++++++++++++---
 3 files changed, 86 insertions(+), 7 deletions(-)

diff --git a/udapi/block/ud/addmwt.py b/udapi/block/ud/addmwt.py
index ffa78bbb..2d251989 100644
--- a/udapi/block/ud/addmwt.py
+++ b/udapi/block/ud/addmwt.py
@@ -1,5 +1,6 @@
 """Abstract base class ud.AddMwt for heuristic detection of multi-word tokens."""
 from udapi.core.block import Block
+import logging
 
 
 class AddMwt(Block):
@@ -40,6 +41,10 @@ def process_node(self, node):
             if attr in analysis:
                 values = analysis[attr].split()
                 for i, new_node in enumerate(nodes):
+                    if len(values) <= i:
+                        logging.warning("Attribute '%s' not supplied for word no. %d" % (attr, i))
+                        for attr in 'form lemma upos xpos feats deprel misc'.split():
+                            logging.warning("%s = %s" % (attr, analysis.get(attr, '')))
                     if values[i] == '*':
                         setattr(new_node, attr, orig_attr[attr])
                     elif attr == 'feats' and '*' in values[i]:
diff --git a/udapi/block/ud/id/addmwt.py b/udapi/block/ud/id/addmwt.py
index 7f5ab271..a8d50748 100644
--- a/udapi/block/ud/id/addmwt.py
+++ b/udapi/block/ud/id/addmwt.py
@@ -92,13 +92,39 @@ def multiword_analysis(self, node):
                 deprel = '* nmod:poss'
                 # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
                 return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
+            elif node.upos == 'PRON' and re.match(r'^diri(nya|ku|mu)$', node.form, re.IGNORECASE):
+                # dirinya = reflexive himself/herself/itself (similarly, diriku = myself, dirimu = yourself; somewhere else we should check that they have the right features)
+                splitform = re.sub(r'(nya|ku|mu)$', r' \1', node.form, flags=re.IGNORECASE)
+                # The noun with -nya typically has Number[psor]=Sing|Person[psor]=3.
+                # Remove these features from the noun and give the pronoun normal features Number=Sing|Person=3.
+                node.feats['Number[psor]'] = ''
+                node.feats['Person[psor]'] = ''
+                upos = 'PRON PRON'
+                if re.search(r' nya$', splitform.lower()):
+                    lemma = re.sub(r' nya$', ' dia', splitform.lower())
+                    feats = 'PronType=Prs|Reflex=Yes Number=Sing|Person=3|PronType=Prs'
+                    xpos = 'NSD PS3'
+                elif re.search(r' ku$', splitform.lower()):
+                    lemma = re.sub(r' ku$', ' aku', splitform.lower())
+                    feats = 'PronType=Prs|Reflex=Yes Number=Sing|Person=1|PronType=Prs'
+                    xpos = 'NSD PS1'
+                else:
+                    lemma = re.sub(r' mu$', ' kamu', splitform.lower())
+                    feats = 'PronType=Prs|Reflex=Yes Number=Sing|Person=2|PronType=Prs'
+                    xpos = 'NSD PS2'
+                deprel = '* nmod:poss'
+                # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
+                return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
             elif node.upos == 'ADJ' and re.search(r'(nya)$', node.form, re.IGNORECASE):
                 # nominalized adjective
                 splitform = re.sub(r'(nya)$', r' \1', node.form, flags=re.IGNORECASE)
                 lemma = splitform.lower()
                 upos = 'ADJ DET'
                 feats = '* Definite=Def|PronType=Art'
-                xpos = re.sub(r'\+', ' ', node.xpos)
+                if re.match(r' ', node.xpos):
+                    xpos = re.sub(r'\+', ' ', node.xpos)
+                else:
+                    xpos = 'ASP PS3'
                 deprel = '* det'
                 # 'main': 0 ... this is the default value (the first node will be the head and inherit children)
                 return {'form': splitform, 'lemma': lemma, 'upos': upos, 'feats': feats, 'xpos': xpos, 'shape': 'subtree', 'deprel': deprel}
@@ -162,13 +188,12 @@ def multiword_analysis(self, node):
                 # Do not warn about instances that are known exceptions.
                 # akibatnya = as a result (SCONJ); akibat = result
                 # bukannya = instead (PART); bukan = no, not
-                # dirinya = reflexive himself/herself/itself (similarly, diriku = myself, dirimu = yourself; somewhere else we should check that they have the right features)
                 # layaknya = like (ADP); layak = worthy
                 # sebaiknya = should (AUX)
                 # sesampainya = once in / arriving at (ADP)
                 # tidaknya = whether or not (PART); tidak = no, not
                 # Adverbs are an exception, too. The -nya morpheme could be derivation. E.g., 'ironis' = 'ironic'; 'ironisnya' = 'ironically'.
-                if node.upos != 'ADV' and not re.match(r'^(akibat|bukan|diri|layak|sebaik|sesampai|tidak)(nya|ku|mu)$', node.form, re.IGNORECASE):
+                if node.upos != 'ADV' and not re.match(r'^(akibat|bukan|layak|sebaik|sesampai|tidak)(nya|ku|mu)$', node.form, re.IGNORECASE):
                     logging.warning("Form '%s' analyzed by MorphInd as having the -nya|-ku|-mu clitic but the UPOS is '%s' and XPOS is '%s'" % (node.form, node.upos, node.xpos))
                 return None
         elif re.search(r'(kah|lah|pun|tah)$', node.form, re.IGNORECASE) and re.search(r'\+(kah|lah|pun|tah)<t>_T--\$$', node.misc['MorphInd']):
diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index 9634bc2d..1e83c6e9 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -171,12 +171,12 @@ def rejoin_decades(self, node):
                     # There may have been spaces around the dash, which are now gone. Recompute the sentence text.
                     node.root.text = node.root.compute_text()
 
-    def lemmatize_verb_from_morphind(self, node):
+    def lemmatize_from_morphind(self, node):
         # The MISC column contains the output of MorphInd for the current word.
         # The analysis has been interpreted wrongly for some verbs, so we need
         # to re-interpret it and extract the correct lemma.
-        if node.upos == "VERB":
-            morphind = node.misc["MorphInd"]
+        morphind = node.misc['MorphInd']
+        if node.upos == 'VERB':
             if morphind:
                 # Remove the start and end tags from morphind.
                 morphind = re.sub(r"^\^", "", morphind)
@@ -205,6 +205,55 @@ def lemmatize_verb_from_morphind(self, node):
                     node.lemma = lemma
             else:
                 logging.warning("No MorphInd analysis found for form '%s'" % (node.form))
+        elif node.upos == 'NOUN':
+            if morphind:
+                # Remove the start and end tags from morphind.
+                morphind = re.sub(r"^\^", "", morphind)
+                morphind = re.sub(r"\$$", "", morphind)
+                # Remove the final XPOS tag from morphind.
+                morphind = re.sub(r'_(N[SP]D|VSA)$', '', morphind)
+                # Do not proceed if there is an unexpected final XPOS tag.
+                if not re.search(r'_[A-Z][-A-Z][-A-Z]$', morphind):
+                    # Split morphind to prefix, stem, and suffix.
+                    morphemes = re.split(r'\+', morphind)
+                    # Expected prefixes are peN-, per-, ke-, ber-.
+                    # Expected suffix is -an.
+                    if len(morphemes) > 1 and re.match(r'^an$', morphemes[-1]):
+                        del morphemes[-1]
+                    if len(morphemes) > 1 and re.match(r'^(peN|per|ke|ber)$', morphemes[0]):
+                        del morphemes[0]
+                    # Check that we are left with just one morpheme.
+                    if len(morphemes) != 1:
+                        logging.warning("One morpheme expected, found %d %s, morphind = '%s', form = '%s', feats = '%s'" % (len(morphemes), morphemes, morphind, node.form, node.feats))
+                    else:
+                        lemma = morphemes[0]
+                        # Remove the stem POS category.
+                        lemma = re.sub(r'<[a-z]+>', '', lemma)
+                        node.lemma = lemma
+        elif node.upos == 'ADJ':
+            if morphind:
+                # Remove the start and end tags from morphind.
+                morphind = re.sub(r"^\^", "", morphind)
+                morphind = re.sub(r"\$$", "", morphind)
+                # Remove the final XPOS tag from morphind.
+                morphind = re.sub(r'_ASS$', '', morphind)
+                # Do not proceed if there is an unexpected final XPOS tag.
+                if not re.search(r'_[A-Z][-A-Z][-A-Z]$', morphind):
+                    # Split morphind to prefix, stem, and suffix.
+                    morphemes = re.split(r'\+', morphind)
+                    # Expected prefix is ter-.
+                    if len(morphemes) > 1 and re.match(r'^ter$', morphemes[0]):
+                        del morphemes[0]
+                    # Check that we are left with just one morpheme.
+                    if len(morphemes) != 1:
+                        logging.warning("One morpheme expected, found %d %s, morphind = '%s', form = '%s', feats = '%s'" % (len(morphemes), morphemes, morphind, node.form, node.feats))
+                    else:
+                        lemma = morphemes[0]
+                        # Remove the stem POS category.
+                        lemma = re.sub(r'<[a-z]+>', '', lemma)
+                        node.lemma = lemma
+            else:
+                logging.warning("No MorphInd analysis found for form '%s'" % (node.form))
 
     def merge_reduplicated_plural(self, node):
         # Instead of compound:plur, merge the reduplicated plurals into a single token.
@@ -294,5 +343,5 @@ def process_node(self, node):
         self.rejoin_ordinal_numerals(node)
         self.fix_ordinal_numerals(node)
         self.rejoin_decades(node)
-        self.lemmatize_verb_from_morphind(node)
+        self.lemmatize_from_morphind(node)
         self.fix_satu_satunya(node)

From a8c36e50d6a1877a102da2456126f4d5b67b59de Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 6 Oct 2021 00:00:24 +0200
Subject: [PATCH 0458/1374] prevent errors on a quote surrounded by spaces

---
 udapi/block/segment/simple.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/segment/simple.py b/udapi/block/segment/simple.py
index 5f4a8423..58be9b6d 100644
--- a/udapi/block/segment/simple.py
+++ b/udapi/block/segment/simple.py
@@ -33,8 +33,12 @@ def is_boundary(self, first, second):
             return False
         if first[-1] in '"“»›)':
             first = first[:-1]
+            if not first:
+                return False
         if second[0] in '"„«¿¡‹(':
             second = second[1:]
+            if not second:
+                return False
         if not second[0].isupper() or second[0].isdigit():
             return False
         if not first[-1] in '.!?':

From 3af3eabb17c185bc28d9fc6c4657ef384b384117 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 20 Oct 2021 18:06:52 +0200
Subject: [PATCH 0459/1374] Merge more reduplications in Indonesian.

---
 udapi/block/ud/id/fixgsd.py | 80 ++++++++++++++++++++++++++-----------
 1 file changed, 56 insertions(+), 24 deletions(-)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index 1e83c6e9..8f7ed20a 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -255,34 +255,65 @@ def lemmatize_from_morphind(self, node):
             else:
                 logging.warning("No MorphInd analysis found for form '%s'" % (node.form))
 
-    def merge_reduplicated_plural(self, node):
-        # Instead of compound:plur, merge the reduplicated plurals into a single token.
-        if node.deprel == "compound:plur":
-            root = node.root
-            # We assume that the previous token is a hyphen and the token before it is the parent.
-            first = node.parent
-            if first.ord == node.ord-2 and first.form.lower() == node.form.lower():
-                hyph = node.prev_node
-                if hyph.is_descendant_of(first) and re.match(r"^(-|–|--)$", hyph.form):
-                    # Neither the hyphen nor the current node should have children.
-                    # If they do, re-attach the children to the first node.
-                    for c in hyph.children:
-                        c.parent = first
-                    for c in node.children:
-                        c.parent = first
-                    # Merge the three nodes.
-                    first.form = first.form + "-" + node.form
-                    first.feats["Number"] = "Plur"
+    def merge_reduplication(self, node):
+        """
+        Reduplication is a common morphological device in Indonesian. Reduplicated
+        nouns signal plural but some reduplications also encode emphasis, modification
+        of meaning etc. In the previous annotation of GSD, reduplication was mostly
+        analyzed as three tokens, e.g., for plurals, the second copy would be attached
+        to the first one as compound:plur, and the hyphen would be attached to the
+        second copy as punct. We want to analyze reduplication as a single token.
+        Fix it.
+        """
+        # We assume that the previous token is a hyphen and the token before it is the parent.
+        first = node.parent
+        if first.ord == node.ord-2 and first.form.lower() == node.form.lower():
+            hyph = node.prev_node
+            if hyph.is_descendant_of(first) and re.match(r'^(-|–|--)$', hyph.form):
+                root = node.root
+                # This is specific to the reduplicated plurals. The rest will be done for any reduplications.
+                # Note that not all reduplicated plurals had compound:plur. So we will look at whether they are NOUN.
+                ###!!! Also, reduplicated plural nouns always have exact copies on both sides of the hyphen.
+                ###!!! Some other reduplications have slight modifications on one or the other side.
+                if node.upos == 'NOUN' and first.form.lower() == node.form.lower():
+                    first.feats['Number'] = 'Plur'
+                # Neither the hyphen nor the current node should have children.
+                # If they do, re-attach the children to the first node.
+                for c in hyph.children:
+                    c.parent = first
+                for c in node.children:
+                    c.parent = first
+                # Merge the three nodes.
+                # It is possible that the last token of the original annotation
+                # is included in a multi-word token. Then we must extend the
+                # multi-word token to the whole reduplication! Example:
+                # pemeran-pemerannya (the actors) ... originally 'pemeran' and '-'
+                # are tokens, 'pemerannya' is a MWT split to 'pemeran' and 'nya'.
+                mwt = node.multiword_token
+                if mwt:
+                    # We assume that the MWT has only two words. We are not prepared for other possibilities.
+                    if len(mwt.words) > 2:
+                        logging.critical('MWT of only two words is expected')
+                    mwtmisc = mwt.misc.copy()
+                    second = mwt.words[1]
+                    mwt.remove()
+                    first.form = first.form + '-' + node.form
+                    hyph.remove()
+                    node.remove()
+                    first.misc['SpaceAfter'] = ''
+                    mwt = root.create_multiword_token([first, second], first.form + second.form, mwtmisc)
+                else:
+                    first.form = first.form + '-' + node.form
                     if node.no_space_after:
-                        first.misc["SpaceAfter"] = "No"
+                        first.misc['SpaceAfter'] = 'No'
                     else:
-                        first.misc["SpaceAfter"] = ""
+                        first.misc['SpaceAfter'] = ''
                     hyph.remove()
                     node.remove()
-                    # We cannot be sure whether the original annotation correctly said that there are no spaces around the hyphen.
-                    # If it did not, then we have a mismatch with the sentence text, which we must fix.
-                    # The following will also fix cases where there was an n-dash ('–') instead of a hyphen ('-').
-                    root.text = root.compute_text()
+                # We cannot be sure whether the original annotation correctly said that there are no spaces around the hyphen.
+                # If it did not, then we have a mismatch with the sentence text, which we must fix.
+                # The following will also fix cases where there was an n-dash ('–') instead of a hyphen ('-').
+                root.text = root.compute_text()
 
     def fix_plural_propn(self, node):
         """
@@ -343,5 +374,6 @@ def process_node(self, node):
         self.rejoin_ordinal_numerals(node)
         self.fix_ordinal_numerals(node)
         self.rejoin_decades(node)
+        self.merge_reduplication(node)
         self.lemmatize_from_morphind(node)
         self.fix_satu_satunya(node)

From 78ffaef93cc8255f48685e47ccf0229a6d4c30c9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 20 Oct 2021 22:36:33 +0200
Subject: [PATCH 0460/1374] More token merging in Indonesian GSD.

---
 udapi/block/ud/id/fixgsd.py | 59 +++++++++++++++++++++++++++++++++++--
 1 file changed, 57 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index 8f7ed20a..12ca9712 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -267,16 +267,29 @@ def merge_reduplication(self, node):
         """
         # We assume that the previous token is a hyphen and the token before it is the parent.
         first = node.parent
-        if first.ord == node.ord-2 and first.form.lower() == node.form.lower():
+        root = node.root
+        # Example of identical reduplication: negara-negara = countries
+        # Example of reduplication with -an: kopi-kopian = various coffee trees
+        # Example of reduplication with vowel substitution: bolak-balik = alternating
+        # Example of reduplication with di-: disebut-sebut = mentioned (the verb sebut is reduplicated, then passivized)
+        # Example of reduplication with se-: sehari-hari = daily (hari = day)
+        # The last pattern is not reduplication but we handle it here because the procedure is very similar: non-/sub-/anti- + a word.
+        if first.ord == node.ord-2 and (first.form.lower() == node.form.lower() or first.form.lower() + 'an' == node.form.lower() or re.match(r'^(.)o(.)a(.)-\1a\2i\3$', first.form.lower() + '-' + node.form.lower()) or first.form.lower() == 'di' + node.form.lower() or first.form.lower() == 'se' + node.form.lower() or re.match(r'^(non|sub|anti)$', first.form.lower())):
             hyph = node.prev_node
             if hyph.is_descendant_of(first) and re.match(r'^(-|–|--)$', hyph.form):
-                root = node.root
                 # This is specific to the reduplicated plurals. The rest will be done for any reduplications.
                 # Note that not all reduplicated plurals had compound:plur. So we will look at whether they are NOUN.
                 ###!!! Also, reduplicated plural nouns always have exact copies on both sides of the hyphen.
                 ###!!! Some other reduplications have slight modifications on one or the other side.
                 if node.upos == 'NOUN' and first.form.lower() == node.form.lower():
                     first.feats['Number'] = 'Plur'
+                # For the non-/sub-/anti- prefix we want to take the morphology from the second word.
+                if re.match(r'^(non|sub|anti)$', first.form.lower()):
+                    first.lemma = first.lemma + '-' + node.lemma
+                    first.upos = node.upos
+                    first.xpos = node.xpos
+                    first.feats = node.feats
+                    first.misc['MorphInd'] = re.sub(r'\$\+\^', '+', first.misc['MorphInd'] + '+' + node.misc['MorphInd'])
                 # Neither the hyphen nor the current node should have children.
                 # If they do, re-attach the children to the first node.
                 for c in hyph.children:
@@ -314,6 +327,48 @@ def merge_reduplication(self, node):
                 # If it did not, then we have a mismatch with the sentence text, which we must fix.
                 # The following will also fix cases where there was an n-dash ('–') instead of a hyphen ('-').
                 root.text = root.compute_text()
+        # In some cases the non-/sub-/anti- prefix is annotated as the head of the phrase and the above pattern does not catch it.
+        elif first.ord == node.ord+2 and re.match(r'^(non|sub|anti)$', node.form.lower()):
+            prefix = node
+            stem = first # here it is not the first part at all
+            hyph = stem.prev_node
+            if hyph.is_descendant_of(first) and re.match(r'^(-|–|--)$', hyph.form):
+                # For the non-/sub-/anti- prefix we want to take the morphology from the second word.
+                stem.lemma = prefix.lemma + '-' + stem.lemma
+                stem.misc['MorphInd'] = re.sub(r'\$\+\^', '+', prefix.misc['MorphInd'] + '+' + stem.misc['MorphInd'])
+                # Neither the hyphen nor the prefix should have children.
+                # If they do, re-attach the children to the stem.
+                for c in hyph.children:
+                    c.parent = stem
+                for c in prefix.children:
+                    c.parent = stem
+                # Merge the three nodes.
+                # It is possible that the last token of the original annotation
+                # is included in a multi-word token. Then we must extend the
+                # multi-word token to the whole reduplication! Example:
+                # pemeran-pemerannya (the actors) ... originally 'pemeran' and '-'
+                # are tokens, 'pemerannya' is a MWT split to 'pemeran' and 'nya'.
+                mwt = stem.multiword_token
+                if mwt:
+                    # We assume that the MWT has only two words. We are not prepared for other possibilities.
+                    if len(mwt.words) > 2:
+                        logging.critical('MWT of only two words is expected')
+                    mwtmisc = mwt.misc.copy()
+                    second = mwt.words[1]
+                    mwt.remove()
+                    stem.form = prefix.form + '-' + stem.form
+                    prefix.remove()
+                    hyph.remove()
+                    stem.misc['SpaceAfter'] = ''
+                    mwt = root.create_multiword_token([stem, second], stem.form + second.form, mwtmisc)
+                else:
+                    stem.form = prefix.form + '-' + stem.form
+                    prefix.remove()
+                    hyph.remove()
+                # We cannot be sure whether the original annotation correctly said that there are no spaces around the hyphen.
+                # If it did not, then we have a mismatch with the sentence text, which we must fix.
+                # The following will also fix cases where there was an n-dash ('–') instead of a hyphen ('-').
+                root.text = root.compute_text()
 
     def fix_plural_propn(self, node):
         """

From 48834686d73034293c737598d6bc12ed20907503 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 21 Oct 2021 16:31:48 +0200
Subject: [PATCH 0461/1374] Multi, kontra.

---
 udapi/block/ud/id/fixgsd.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index 12ca9712..b5142040 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -274,7 +274,7 @@ def merge_reduplication(self, node):
         # Example of reduplication with di-: disebut-sebut = mentioned (the verb sebut is reduplicated, then passivized)
         # Example of reduplication with se-: sehari-hari = daily (hari = day)
         # The last pattern is not reduplication but we handle it here because the procedure is very similar: non-/sub-/anti- + a word.
-        if first.ord == node.ord-2 and (first.form.lower() == node.form.lower() or first.form.lower() + 'an' == node.form.lower() or re.match(r'^(.)o(.)a(.)-\1a\2i\3$', first.form.lower() + '-' + node.form.lower()) or first.form.lower() == 'di' + node.form.lower() or first.form.lower() == 'se' + node.form.lower() or re.match(r'^(non|sub|anti)$', first.form.lower())):
+        if first.ord == node.ord-2 and (first.form.lower() == node.form.lower() or first.form.lower() + 'an' == node.form.lower() or re.match(r'^(.)o(.)a(.)-\1a\2i\3$', first.form.lower() + '-' + node.form.lower()) or first.form.lower() == 'di' + node.form.lower() or first.form.lower() == 'se' + node.form.lower() or re.match(r'^(non|sub|anti|multi|kontra)$', first.form.lower())):
             hyph = node.prev_node
             if hyph.is_descendant_of(first) and re.match(r'^(-|–|--)$', hyph.form):
                 # This is specific to the reduplicated plurals. The rest will be done for any reduplications.
@@ -284,7 +284,7 @@ def merge_reduplication(self, node):
                 if node.upos == 'NOUN' and first.form.lower() == node.form.lower():
                     first.feats['Number'] = 'Plur'
                 # For the non-/sub-/anti- prefix we want to take the morphology from the second word.
-                if re.match(r'^(non|sub|anti)$', first.form.lower()):
+                if re.match(r'^(non|sub|anti|multi|kontra)$', first.form.lower()):
                     first.lemma = first.lemma + '-' + node.lemma
                     first.upos = node.upos
                     first.xpos = node.xpos
@@ -328,7 +328,7 @@ def merge_reduplication(self, node):
                 # The following will also fix cases where there was an n-dash ('–') instead of a hyphen ('-').
                 root.text = root.compute_text()
         # In some cases the non-/sub-/anti- prefix is annotated as the head of the phrase and the above pattern does not catch it.
-        elif first.ord == node.ord+2 and re.match(r'^(non|sub|anti)$', node.form.lower()):
+        elif first.ord == node.ord+2 and re.match(r'^(non|sub|anti|multi|kontra')$', node.form.lower()):
             prefix = node
             stem = first # here it is not the first part at all
             hyph = stem.prev_node

From 75ec0ff74ed2d28a09b514a38b2c25d9cbc779f9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 21 Oct 2021 16:33:40 +0200
Subject: [PATCH 0462/1374] Bug fix.

---
 udapi/block/ud/id/fixgsd.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index b5142040..69c785ab 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -328,7 +328,7 @@ def merge_reduplication(self, node):
                 # The following will also fix cases where there was an n-dash ('–') instead of a hyphen ('-').
                 root.text = root.compute_text()
         # In some cases the non-/sub-/anti- prefix is annotated as the head of the phrase and the above pattern does not catch it.
-        elif first.ord == node.ord+2 and re.match(r'^(non|sub|anti|multi|kontra')$', node.form.lower()):
+        elif first.ord == node.ord+2 and re.match(r'^(non|sub|anti|multi|kontra)$', node.form.lower()):
             prefix = node
             stem = first # here it is not the first part at all
             hyph = stem.prev_node

From ddbb2b0c459c6595da1ca42bd698e07b7fd245fe Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 23 Oct 2021 22:34:13 +0200
Subject: [PATCH 0463/1374] Context-based tagging of Indonesian "semua".

---
 udapi/block/ud/id/fixgsd.py | 197 +++++++++++++++++++-----------------
 1 file changed, 105 insertions(+), 92 deletions(-)

diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index 69c785ab..d328212d 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -22,6 +22,25 @@ def fix_upos_based_on_morphind(self, node):
             elif node.udeprel == 'advcl':
                 node.deprel = 'obl'
 
+    def fix_semua(self, node):
+        """
+        Indonesian "semua" means "everything, all".
+        Originally it was DET, PRON, or ADV.
+        Ika: I usually only labeled "semua" as DET only if it's followed by a
+        NOUN/PROPN. If it's followed by DET (including '-nya' as DET) or it's
+        not followed by any NOUN/DET, I labeled them as PRON.
+        """
+        if node.form.lower() == 'semua':
+            if re.match(r'^(NOUN|PROPN)$', node.parent.upos) and node.parent.ord > node.ord:
+                node.upos = 'DET'
+                if node.udeprel == 'nmod' or node.udeprel == 'advmod':
+                    node.deprel = 'det'
+            else:
+                node.upos = 'PRON'
+                if node.udeprel == 'det' or node.udeprel == 'advmod':
+                    node.deprel = 'nmod'
+            node.feats['PronType'] = 'Tot'
+
     def fix_ordinal_numerals(self, node):
         """
         Ordinal numerals should be ADJ NumType=Ord in UD. They have many different
@@ -62,13 +81,6 @@ def fix_ordinal_numerals(self, node):
                 node.feats['PronType'] = 'Tot'
                 if re.match(r'^(det|amod|nmod)$', node.udeprel):
                     node.deprel = 'nummod'
-        # The following is not an ordinal numeral but I am too lazy to create a separate method for that.
-        elif node.form.lower() == 'semua':
-            # It means 'all'. Originally it was DET, PRON, or ADV.
-            node.upos = 'DET'
-            node.feats['PronType'] = 'Tot'
-            if node.udeprel == 'nmod' or node.udeprel == 'advmod':
-                node.deprel = 'det'
 
     def rejoin_ordinal_numerals(self, node):
         """
@@ -171,90 +183,6 @@ def rejoin_decades(self, node):
                     # There may have been spaces around the dash, which are now gone. Recompute the sentence text.
                     node.root.text = node.root.compute_text()
 
-    def lemmatize_from_morphind(self, node):
-        # The MISC column contains the output of MorphInd for the current word.
-        # The analysis has been interpreted wrongly for some verbs, so we need
-        # to re-interpret it and extract the correct lemma.
-        morphind = node.misc['MorphInd']
-        if node.upos == 'VERB':
-            if morphind:
-                # Remove the start and end tags from morphind.
-                morphind = re.sub(r"^\^", "", morphind)
-                morphind = re.sub(r"\$$", "", morphind)
-                # Remove the final XPOS tag from morphind.
-                morphind = re.sub(r"_V[SP][AP]$", "", morphind)
-                # Split morphind to prefix, stem, and suffix.
-                morphemes = re.split(r"\+", morphind)
-                # Expected suffixes are -kan, -i, -an, or no suffix at all.
-                # There is also the circumfix ke-...-an which seems to be nominalized adjective:
-                # "sama" = "same, similar"; "kesamaan" = "similarity", lemma is "sama";
-                # but I am not sure what is the reason that these are tagged VERB.
-                if len(morphemes) > 1 and re.match(r"^(kan|i|an(_NSD)?)$", morphemes[-1]):
-                    del morphemes[-1]
-                # Expected prefixes are meN-, di-, ber-, peN-, ke-, ter-, se-, or no prefix at all.
-                # There can be two prefixes in a row, e.g., "ber+ke+", or "ter+peN+".
-                while len(morphemes) > 1 and re.match(r"^(meN|di|ber|peN|ke|ter|se|per)$", morphemes[0]):
-                    del morphemes[0]
-                # Check that we are left with just one morpheme.
-                if len(morphemes) != 1:
-                    logging.warning("One morpheme expected, found %d %s, morphind = '%s', form = '%s', feats = '%s'" % (len(morphemes), morphemes, morphind, node.form, node.feats))
-                else:
-                    lemma = morphemes[0]
-                    # Remove the stem POS category.
-                    lemma = re.sub(r"<[a-z]+>(_.*)?$", "", lemma)
-                    node.lemma = lemma
-            else:
-                logging.warning("No MorphInd analysis found for form '%s'" % (node.form))
-        elif node.upos == 'NOUN':
-            if morphind:
-                # Remove the start and end tags from morphind.
-                morphind = re.sub(r"^\^", "", morphind)
-                morphind = re.sub(r"\$$", "", morphind)
-                # Remove the final XPOS tag from morphind.
-                morphind = re.sub(r'_(N[SP]D|VSA)$', '', morphind)
-                # Do not proceed if there is an unexpected final XPOS tag.
-                if not re.search(r'_[A-Z][-A-Z][-A-Z]$', morphind):
-                    # Split morphind to prefix, stem, and suffix.
-                    morphemes = re.split(r'\+', morphind)
-                    # Expected prefixes are peN-, per-, ke-, ber-.
-                    # Expected suffix is -an.
-                    if len(morphemes) > 1 and re.match(r'^an$', morphemes[-1]):
-                        del morphemes[-1]
-                    if len(morphemes) > 1 and re.match(r'^(peN|per|ke|ber)$', morphemes[0]):
-                        del morphemes[0]
-                    # Check that we are left with just one morpheme.
-                    if len(morphemes) != 1:
-                        logging.warning("One morpheme expected, found %d %s, morphind = '%s', form = '%s', feats = '%s'" % (len(morphemes), morphemes, morphind, node.form, node.feats))
-                    else:
-                        lemma = morphemes[0]
-                        # Remove the stem POS category.
-                        lemma = re.sub(r'<[a-z]+>', '', lemma)
-                        node.lemma = lemma
-        elif node.upos == 'ADJ':
-            if morphind:
-                # Remove the start and end tags from morphind.
-                morphind = re.sub(r"^\^", "", morphind)
-                morphind = re.sub(r"\$$", "", morphind)
-                # Remove the final XPOS tag from morphind.
-                morphind = re.sub(r'_ASS$', '', morphind)
-                # Do not proceed if there is an unexpected final XPOS tag.
-                if not re.search(r'_[A-Z][-A-Z][-A-Z]$', morphind):
-                    # Split morphind to prefix, stem, and suffix.
-                    morphemes = re.split(r'\+', morphind)
-                    # Expected prefix is ter-.
-                    if len(morphemes) > 1 and re.match(r'^ter$', morphemes[0]):
-                        del morphemes[0]
-                    # Check that we are left with just one morpheme.
-                    if len(morphemes) != 1:
-                        logging.warning("One morpheme expected, found %d %s, morphind = '%s', form = '%s', feats = '%s'" % (len(morphemes), morphemes, morphind, node.form, node.feats))
-                    else:
-                        lemma = morphemes[0]
-                        # Remove the stem POS category.
-                        lemma = re.sub(r'<[a-z]+>', '', lemma)
-                        node.lemma = lemma
-            else:
-                logging.warning("No MorphInd analysis found for form '%s'" % (node.form))
-
     def merge_reduplication(self, node):
         """
         Reduplication is a common morphological device in Indonesian. Reduplicated
@@ -423,12 +351,97 @@ def fix_satu_satunya(self, node):
         if node.multiword_token and node.no_space_after:
             node.misc['SpaceAfter'] = ''
 
+    def lemmatize_from_morphind(self, node):
+        # The MISC column contains the output of MorphInd for the current word.
+        # The analysis has been interpreted wrongly for some verbs, so we need
+        # to re-interpret it and extract the correct lemma.
+        morphind = node.misc['MorphInd']
+        if node.upos == 'VERB':
+            if morphind:
+                # Remove the start and end tags from morphind.
+                morphind = re.sub(r"^\^", "", morphind)
+                morphind = re.sub(r"\$$", "", morphind)
+                # Remove the final XPOS tag from morphind.
+                morphind = re.sub(r"_V[SP][AP]$", "", morphind)
+                # Split morphind to prefix, stem, and suffix.
+                morphemes = re.split(r"\+", morphind)
+                # Expected suffixes are -kan, -i, -an, or no suffix at all.
+                # There is also the circumfix ke-...-an which seems to be nominalized adjective:
+                # "sama" = "same, similar"; "kesamaan" = "similarity", lemma is "sama";
+                # but I am not sure what is the reason that these are tagged VERB.
+                if len(morphemes) > 1 and re.match(r"^(kan|i|an(_NSD)?)$", morphemes[-1]):
+                    del morphemes[-1]
+                # Expected prefixes are meN-, di-, ber-, peN-, ke-, ter-, se-, or no prefix at all.
+                # There can be two prefixes in a row, e.g., "ber+ke+", or "ter+peN+".
+                while len(morphemes) > 1 and re.match(r"^(meN|di|ber|peN|ke|ter|se|per)$", morphemes[0]):
+                    del morphemes[0]
+                # Check that we are left with just one morpheme.
+                if len(morphemes) != 1:
+                    logging.warning("One morpheme expected, found %d %s, morphind = '%s', form = '%s', feats = '%s'" % (len(morphemes), morphemes, morphind, node.form, node.feats))
+                else:
+                    lemma = morphemes[0]
+                    # Remove the stem POS category.
+                    lemma = re.sub(r"<[a-z]+>(_.*)?$", "", lemma)
+                    node.lemma = lemma
+            else:
+                logging.warning("No MorphInd analysis found for form '%s'" % (node.form))
+        elif node.upos == 'NOUN':
+            if morphind:
+                # Remove the start and end tags from morphind.
+                morphind = re.sub(r"^\^", "", morphind)
+                morphind = re.sub(r"\$$", "", morphind)
+                # Remove the final XPOS tag from morphind.
+                morphind = re.sub(r'_(N[SP]D|VSA)$', '', morphind)
+                # Do not proceed if there is an unexpected final XPOS tag.
+                if not re.search(r'_[A-Z][-A-Z][-A-Z]$', morphind):
+                    # Split morphind to prefix, stem, and suffix.
+                    morphemes = re.split(r'\+', morphind)
+                    # Expected prefixes are peN-, per-, ke-, ber-.
+                    # Expected suffix is -an.
+                    if len(morphemes) > 1 and re.match(r'^an$', morphemes[-1]):
+                        del morphemes[-1]
+                    if len(morphemes) > 1 and re.match(r'^(peN|per|ke|ber)$', morphemes[0]):
+                        del morphemes[0]
+                    # Check that we are left with just one morpheme.
+                    if len(morphemes) != 1:
+                        logging.warning("One morpheme expected, found %d %s, morphind = '%s', form = '%s', feats = '%s'" % (len(morphemes), morphemes, morphind, node.form, node.feats))
+                    else:
+                        lemma = morphemes[0]
+                        # Remove the stem POS category.
+                        lemma = re.sub(r'<[a-z]+>', '', lemma)
+                        node.lemma = lemma
+        elif node.upos == 'ADJ':
+            if morphind:
+                # Remove the start and end tags from morphind.
+                morphind = re.sub(r"^\^", "", morphind)
+                morphind = re.sub(r"\$$", "", morphind)
+                # Remove the final XPOS tag from morphind.
+                morphind = re.sub(r'_ASS$', '', morphind)
+                # Do not proceed if there is an unexpected final XPOS tag.
+                if not re.search(r'_[A-Z][-A-Z][-A-Z]$', morphind):
+                    # Split morphind to prefix, stem, and suffix.
+                    morphemes = re.split(r'\+', morphind)
+                    # Expected prefix is ter-.
+                    if len(morphemes) > 1 and re.match(r'^ter$', morphemes[0]):
+                        del morphemes[0]
+                    # Check that we are left with just one morpheme.
+                    if len(morphemes) != 1:
+                        logging.warning("One morpheme expected, found %d %s, morphind = '%s', form = '%s', feats = '%s'" % (len(morphemes), morphemes, morphind, node.form, node.feats))
+                    else:
+                        lemma = morphemes[0]
+                        # Remove the stem POS category.
+                        lemma = re.sub(r'<[a-z]+>', '', lemma)
+                        node.lemma = lemma
+            else:
+                logging.warning("No MorphInd analysis found for form '%s'" % (node.form))
+
     def process_node(self, node):
         self.fix_plural_propn(node)
         self.fix_upos_based_on_morphind(node)
+        self.fix_semua(node)
         self.rejoin_ordinal_numerals(node)
         self.fix_ordinal_numerals(node)
         self.rejoin_decades(node)
         self.merge_reduplication(node)
-        self.lemmatize_from_morphind(node)
         self.fix_satu_satunya(node)
+        self.lemmatize_from_morphind(node)

From fc63be3266eccf252597383baa0687e536b0b3d1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 29 Oct 2021 22:00:20 +0200
Subject: [PATCH 0464/1374] Added a block to fix tokenization in AnCora (but
 beware of #95 until it's fixed).

---
 udapi/block/ud/es/fixexclamation.py | 47 +++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 udapi/block/ud/es/fixexclamation.py

diff --git a/udapi/block/ud/es/fixexclamation.py b/udapi/block/ud/es/fixexclamation.py
new file mode 100644
index 00000000..7dea8e0d
--- /dev/null
+++ b/udapi/block/ud/es/fixexclamation.py
@@ -0,0 +1,47 @@
+"""Block to fix tokenization of exclamation marks in UD Spanish-AnCora."""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixExclamation(Block):
+
+    def process_node(self, node):
+        """
+        In Spanish AnCora, there are things like '¡Hola!' as one token.
+        The punctuation should be separated. One may question whether this
+        should include names of companies (Yahoo!) or products (la revista
+        Hello!) but it should, as company and product names often have
+        multiple tokens (even multiple full words, not just punctuation)
+        and these are also separated in UD.
+        """
+        if re.search(r'^[¡!]\w', node.form):
+            # Separate the punctuation and attach it to the rest.
+            punct = node.create_child()
+            punct.shift_before_node(node)
+            punct.form = node.form[:1]
+            node.form = node.form[1:]
+            punct.lemma = punct.form
+            punct.upos = 'PUNCT'
+            punct.xpos = 'faa' if punct.form == '¡' else 'fat'
+            punct.feats['PunctType'] = 'Excl'
+            punct.feats['PunctSide'] = 'Ini' if punct.form == '¡' else 'Fin'
+            punct.misc['SpaceAfter'] = 'No'
+            punct.deprel = 'punct'
+            # Mark the position for manual check.
+            node.misc['Mark'] = 'PunctSep'
+        if re.search(r'\w[¡!]$', node.form):
+            # Separate the punctuation and attach it to the rest.
+            punct = node.create_child()
+            punct.shift_after_node(node)
+            punct.form = node.form[-1:]
+            node.form = node.form[:-1]
+            punct.lemma = punct.form
+            punct.upos = 'PUNCT'
+            punct.xpos = 'faa' if punct.form == '¡' else 'fat'
+            punct.feats['PunctType'] = 'Excl'
+            punct.feats['PunctSide'] = 'Ini' if punct.form == '¡' else 'Fin'
+            punct.misc['SpaceAfter'] = node.misc['SpaceAfter']
+            node.misc['SpaceAfter'] = 'No'
+            punct.deprel = 'punct'
+            # Mark the position for manual check.
+            node.misc['Mark'] = 'PunctSep'

From 49f1f4385e4006895708f4e6f22ea06c3bc3723f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 30 Oct 2021 23:17:19 +0200
Subject: [PATCH 0465/1374] Fix leaf-aux-cop.

---
 udapi/block/ud/fixleaf.py | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 udapi/block/ud/fixleaf.py

diff --git a/udapi/block/ud/fixleaf.py b/udapi/block/ud/fixleaf.py
new file mode 100644
index 00000000..4cac1175
--- /dev/null
+++ b/udapi/block/ud/fixleaf.py
@@ -0,0 +1,35 @@
+"""
+Block ud.FixLeaf checks that function word dependents are leaves.
+Certain known exceptions are observed (e.g., fixed expressions).
+"""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixLeaf(Block):
+    """
+    Make sure that aux and cop dependents are leaves unless one of the known
+    exceptions applies.
+    """
+
+    def __init__(self, deprels='aux,cop', **kwargs):
+        """
+        Args:
+        deprels: comma-separated list of deprels to be fixed. Default = aux,cop.
+        """
+        super().__init__(**kwargs)
+        self.deprels = deprels.split(',')
+
+    def process_node(self, node):
+        for deprel in self.deprels:
+            if node.udeprel == deprel:
+                children = node.children
+                # Every function dependent can have a fixed child.
+                # We will also allow conj, cc, punct, goeswith, reparandum.
+                children = [c for c in children if not re.match(r'^(fixed|conj|cc|punct|goeswith|reparandum)$', c.udeprel)]
+                # Re-attach the remaining children to an acceptable ancestor.
+                ancestor = node.parent
+                while ancestor.udeprel in self.deprels:
+                    ancestor = ancestor.parent
+                for c in children:
+                    c.parent = ancestor

From 0c09c4e666b1cc9923411492f7985ffb00fb88d2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 31 Oct 2021 09:30:20 +0100
Subject: [PATCH 0466/1374] FixLeaf must update enhanced relations, too.

---
 udapi/block/ud/fixleaf.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/ud/fixleaf.py b/udapi/block/ud/fixleaf.py
index 4cac1175..345b68f9 100644
--- a/udapi/block/ud/fixleaf.py
+++ b/udapi/block/ud/fixleaf.py
@@ -33,3 +33,8 @@ def process_node(self, node):
                     ancestor = ancestor.parent
                 for c in children:
                     c.parent = ancestor
+                    # If there are enhanced dependencies, check whether we want to redirect them too.
+                    if c.deps:
+                        for edep in c.deps:
+                            if edep['parent'] == node:
+                                edep['parent'] = ancestor

From 9528d7cf5d4927c64fba305a0ced8b32449fec4a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 3 Nov 2021 14:41:54 +0100
Subject: [PATCH 0467/1374] FixLeaf cc.

---
 udapi/block/ud/fixleaf.py | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/fixleaf.py b/udapi/block/ud/fixleaf.py
index 345b68f9..d715ec01 100644
--- a/udapi/block/ud/fixleaf.py
+++ b/udapi/block/ud/fixleaf.py
@@ -12,10 +12,10 @@ class FixLeaf(Block):
     exceptions applies.
     """
 
-    def __init__(self, deprels='aux,cop', **kwargs):
+    def __init__(self, deprels='aux,cop,cc', **kwargs):
         """
         Args:
-        deprels: comma-separated list of deprels to be fixed. Default = aux,cop.
+        deprels: comma-separated list of deprels to be fixed. Default = aux,cop,case,mark,cc.
         """
         super().__init__(**kwargs)
         self.deprels = deprels.split(',')
@@ -23,10 +23,12 @@ def __init__(self, deprels='aux,cop', **kwargs):
     def process_node(self, node):
         for deprel in self.deprels:
             if node.udeprel == deprel:
-                children = node.children
                 # Every function dependent can have a fixed child.
                 # We will also allow conj, cc, punct, goeswith, reparandum.
-                children = [c for c in children if not re.match(r'^(fixed|conj|cc|punct|goeswith|reparandum)$', c.udeprel)]
+                allowed = ['fixed', 'punct', 'goeswith', 'reparandum']
+                if deprel != 'cc':
+                    allowed += ['conj', 'cc']
+                children = [c for c in node.children if not (c.udeprel in allowed)]
                 # Re-attach the remaining children to an acceptable ancestor.
                 ancestor = node.parent
                 while ancestor.udeprel in self.deprels:

From f1028cbc26cd627308fc7f7dd14c20ed9246c114 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 28 Nov 2021 11:32:52 +0100
Subject: [PATCH 0468/1374] Javanese does not distinguish VerbForms, either.

---
 udapi/block/ud/markbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index cbd57eef..5ca0f703 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -118,7 +118,7 @@ def process_node(self, node):
             if upos == i_upos and not feats[i_feat]:
                 # Some languages do not distinguish finite and non-finite forms of verbs.
                 # The VerbForm feature is not obligatory in those languages.
-                if i_feat != "VerbForm" or not node.root.zone.split("_")[0] in {"id", "tl", "hil", "ifb"}:
+                if i_feat != 'VerbForm' or not node.root.zone.split('_')[0] in {'id', 'jv', 'tl', 'hil', 'ifb'}:
                     self.log(node, 'no-' + i_feat, 'upos=%s but %s feature is missing' % (upos, i_feat))
 
         if feats['VerbForm'] == 'Fin':

From d1da0b0a45fe37ce6715acee6a2dfbdb4591b264 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 29 Nov 2021 10:52:45 +0100
Subject: [PATCH 0469/1374] Added a block to fix German GSD.

---
 udapi/block/ud/de/fixgsd.py | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 udapi/block/ud/de/fixgsd.py

diff --git a/udapi/block/ud/de/fixgsd.py b/udapi/block/ud/de/fixgsd.py
new file mode 100644
index 00000000..d6853330
--- /dev/null
+++ b/udapi/block/ud/de/fixgsd.py
@@ -0,0 +1,37 @@
+"""
+Block to fix annotation of UD German-GSD.
+"""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixGSD(Block):
+
+    def process_node(self, node):
+        """
+        Normalizes tokenization, lemmatization and tagging of ordinal numerals
+        that are expressed using digits followed by a period.
+        https://github.com/UniversalDependencies/UD_German-GSD/issues/24
+        """
+        # Ignore periods that terminate a sentence, although they could belong
+        # to an ordinal numeral at the same time.
+        if node.form == '.' and node.next_node:
+            # Ignore number+period combinations that have an intervening space.
+            if node.prev_node and re.match('^\d+$', node.prev_node.form) and node.prev_node.no_space_after:
+                # Merge the number and the period into one token.
+                number = node.prev_node
+                period = node
+                # The period should not have any children but if it does, re-attach them to the number.
+                for c in period.children:
+                    c.parent = number
+                # The period should be followed by a space but if it isn't, mark it at the number.
+                number.misc['SpaceAfter'] = 'No' if period.no_space_after else ''
+                number.form += '.'
+                number.lemma = number.form
+                number.upos = 'ADJ'
+                number.xpos = 'ADJA'
+                number.feats = '_'
+                number.feats['NumType'] = 'Ord'
+                if number.udeprel == 'nummod':
+                    number.deprel = 'amod'
+                period.remove()

From fa25c0ed4a25026270c5a7f96287804c7a1e89cd Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 29 Nov 2021 11:44:36 +0100
Subject: [PATCH 0470/1374] More fixes of ordinals in German.

---
 udapi/block/ud/de/fixgsd.py | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/de/fixgsd.py b/udapi/block/ud/de/fixgsd.py
index d6853330..65d12681 100644
--- a/udapi/block/ud/de/fixgsd.py
+++ b/udapi/block/ud/de/fixgsd.py
@@ -17,7 +17,7 @@ def process_node(self, node):
         # to an ordinal numeral at the same time.
         if node.form == '.' and node.next_node:
             # Ignore number+period combinations that have an intervening space.
-            if node.prev_node and re.match('^\d+$', node.prev_node.form) and node.prev_node.no_space_after:
+            if node.prev_node and re.match(r'^\d+$', node.prev_node.form) and node.prev_node.no_space_after:
                 # Merge the number and the period into one token.
                 number = node.prev_node
                 period = node
@@ -35,3 +35,24 @@ def process_node(self, node):
                 if number.udeprel == 'nummod':
                     number.deprel = 'amod'
                 period.remove()
+        # Even if the digits and the period are already in one token, check their annotation.
+        if re.match(r'^\d+\.$', node.form):
+            node.lemma = node.form
+            node.upos = 'ADJ'
+            node.xpos = 'ADJA'
+            node.feats = '_'
+            node.feats['NumType'] = 'Ord'
+            if node.udeprel == 'nummod':
+                node.deprel = 'amod'
+        # Finally, make sure that ordinal numerals expressed verbosely are tagged properly.
+        # Unlike for digits, do not remove the features for Gender, Number, and Case.
+        # Skip 'acht' because we cannot reliably distinguish it from the cardinal numeral and from the verb 'achten'.
+        if re.match(r'^(erst|zweit|dritt|viert|fünft|sechst|siebt|neunt|(drei|vier|fünf|sechs|sieb|acht|neun)?zehnt|elft|zwölft)(er)?$', node.lemma, re.IGNORECASE):
+            # Skip 'erst' that is used as an adverb.
+            if node.lemma != 'erst' or node.upos != 'ADV':
+                node.lemma = re.sub(r'^(.+)er$', r'\1', node.lemma)
+                node.upos = 'ADJ'
+                node.xpos = 'ADJA'
+                node.feats['NumType'] = 'Ord'
+                if node.udeprel == 'nummod':
+                    node.deprel = 'amod'

From d7da77817a3bbda9f1b3d388232cdfcd4a734999 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 29 Nov 2021 16:34:57 +0100
Subject: [PATCH 0471/1374] Block's process_node iterates over a copy of
 descendants

This prevents an infinite loop in tutorial.AddCommas etc.
Partial revert of 44c291b930fa591477c87457a17c0e76e6ee22ea
The slowdown is acceptable (about 0.05s per iterating over 700k words).

That said, there may be usecases where iterating over _descendants is beneficial,
e.g. when deleting nodes, so that we don't iterate over an already deleted node.
---
 udapi/core/block.py    | 6 +++++-
 udapi/core/document.py | 4 +++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/udapi/core/block.py b/udapi/core/block.py
index 64b8bcc5..32033cde 100644
--- a/udapi/core/block.py
+++ b/udapi/core/block.py
@@ -29,7 +29,11 @@ def process_node(self, _):
 
     def process_tree(self, tree):
         """Process a UD tree"""
-        for node in tree._descendants:
+        # tree.descendants is slightly slower than tree._descendants (0.05s per iterating over 700k words),
+        # but it seems safer to iterate over a copy of the list of nodes.
+        # If a user calls parent.create_child().shift_before_node(parent) in process_node,
+        # it may end up in endless cycle (because the same node is processed again - Python for cycle remembers the position).
+        for node in tree.descendants:
             self.process_node(node)
 
     def process_bundle(self, bundle):
diff --git a/udapi/core/document.py b/udapi/core/document.py
index f02f831e..8f9ce3ea 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -91,7 +91,9 @@ def nodes(self):
         """An iterator over all nodes (excluding empty nodes) in the document."""
         for bundle in self:
             for tree in bundle:
-                for node in tree._descendants:
+                # tree.descendants is slightly slower than tree._descendants,
+                # but it seems safer, see the comment in udapi.core.block.Block.process.process_tree().
+                for node in tree.descendants:
                     yield node
 
     @property

From 7381264e9aafbd727de03ea25f6e1e862fdd83b9 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 1 Dec 2021 23:22:33 +0100
Subject: [PATCH 0472/1374] update the conversion block to UD_English-GUM v2.9

---
 udapi/block/corefud/gum2corefud.py | 116 ++++++++++++++++-------------
 1 file changed, 64 insertions(+), 52 deletions(-)

diff --git a/udapi/block/corefud/gum2corefud.py b/udapi/block/corefud/gum2corefud.py
index 95be6ce0..bcd24968 100644
--- a/udapi/block/corefud/gum2corefud.py
+++ b/udapi/block/corefud/gum2corefud.py
@@ -8,82 +8,94 @@ class Gum2CorefUD(Block):
     def process_tree(self, tree):
         docname = tree.bundle.document.meta['docname'] + '_'
 
-        def entity2cluster_id(name):
-            return docname + name.strip('()').replace(',','').replace('+','')
-
         clusters = tree.bundle.document.coref_clusters
         unfinished_mentions = defaultdict(list)
         for node in tree.descendants:
-            entity = node.misc['Entity']
-            if not entity:
+            misc_entity = node.misc['Entity']
+            if not misc_entity:
                 continue
-            parts = [x for x in re.split('(\([^())]+\)?|[^())]+\))', entity) if x]
-            for part in parts:
-                # GUM entity name could be e.g.
-                # abstract-173 or place-1-Coron,_Palawan or place-77-Sub-Saharan_Africa.
-                # Note that the wikification part of the name may contain commas and dashes.
-                # Let's take the whole name as cluster_id, which will be normalized later on.
-                # We just need to remove commas and plus signs which are forbidden in cluster_id
-                # because they are used as separators in Bridging and SplitAnte, respectively.
-                # Let's store the type in cluster.cluster_type and Wikification in mention.misc.
-                name = entity2cluster_id(part)
-                if part[0] == '(':
+            # Attribute Entity may contain multiple entities, e.g.
+            # Entity=(abstract-7-new-2-coref(abstract-3-giv:act-1-coref)
+            # means a start of entity id=7 and start&end (i.e. single-word mention) of entity id=3.
+            # The following re.split line splits this into
+            # entities = ["(abstract-7-new-2-coref", "(abstract-3-giv:act-1-coref)"]
+            entities = [x for x in re.split('(\([^()]+\)?|[^()]+\))', misc_entity) if x]
+            for entity in entities:
+                # GUM 2.9 uses global.Entity = entity-GRP-infstat-MIN-coref_type-identity
+                # but the closing tag is shortent just to GRP.
+                opening, closing = (entity[0] == '(', entity[-1] == ')')
+                entity = entity.strip('()')
+                if not opening and not closing:
+                    logging.warning(f"Entity {entity} at {node} has no opening nor closing bracket.")
+                elif not opening and closing:
+                    name = docname + entity
+                    if not unfinished_mentions[name]:
+                        raise ValueError(f"Mention {name} closed at {node}, but not opened in the same tree.")
+                    else:
+                        mention = unfinished_mentions[name].pop()
+                        mention.span = f'{mention.head.ord}-{node.ord}'
+                else:
+                    attrs = entity.split('-')
+                    if len(attrs) == 6:
+                        etype, grp, infstat, minspan, ctype, wiki = attrs
+                    elif len(attrs) == 5:
+                        wiki = None
+                        etype, grp, infstat, minspan, ctype = attrs
+                    elif len(attrs) > 6:
+                        logging.warning(f"Entity {entity} at {node} has more than 6 attributes.")
+                        etype, grp, infstat, minspan, ctype, wiki = entity.split('-', maxsplit=5)
+                    else:
+                        raise ValueError(f"Less than 5 attributes in {entity} at {node}")
+                    name = docname + grp
                     cluster = clusters.get(name)
                     if cluster is None:
-                        chunks = part.strip('()').split('-', maxsplit=2)
-                        if len(chunks) == 3:
-                            ctype, _, wiki = chunks
-                        elif len(chunks) == 2:
-                            ctype, _, wiki = chunks[0], None, None
-                        else:
-                            raise ValueError(f"Unexpected entity {part} at {node}")
-                        cluster = node.create_coref_cluster(cluster_id=name, cluster_type=ctype)
+                        cluster = node.create_coref_cluster(cluster_id=name, cluster_type=etype)
                         mention = cluster.mentions[0]
+                        mention.misc = f"Infstat:{infstat},MinSpan:{minspan},CorefType:{ctype}"
                         if wiki:
-                            mention.misc = 'Wikification:' + wiki.replace(',', '%2C')
+                            mention.misc += ',Wikification:' + wiki  #.replace(',', '%2C')
                     else:
                         mention = cluster.create_mention(head=node)
-                    if part[-1] == ')':
+                    if closing:
                         mention.words = [node]
                     else:
                         unfinished_mentions[name].append(mention)
-                elif part[-1] == ')':
-                    if not unfinished_mentions[name]:
-                        logging.warning(f"Mention {name} closed at {node}, but not opened in the same tree.")
-                    else:
-                        mention = unfinished_mentions[name].pop()
-                        mention.span = f'{mention.head.ord}-{node.ord}'
             del node.misc['Entity']
 
-            misc_bridge = node.misc['Bridge']
-            if misc_bridge:
-                # E.g. Entity=event-23|Bridge=time-23<event-28
-                trg_str, src_str = (entity2cluster_id(x) for x in misc_bridge.split('<'))
-                try:
-                    trg_cluster = clusters[trg_str]
-                    src_cluster = clusters[src_str]
-                except KeyError as err:
-                    logging.warning(f"{node}: Cannot find cluster {err}")
-                else:
-                    mention = src_cluster.mentions[-1]
-                    # TODO: what relation should we choose for Bridging?
-                    # relation = f"{src_str.split('-')[0]}-{trg_str.split('-')[0]}"
-                    relation = '_'
-                    mention.bridging.append((trg_cluster, relation))
+            misc_bridges = node.misc['Bridge']
+            if misc_bridges:
+                # E.g. Entity=event-12|Bridge=12<124,12<125
+                for misc_bridge in misc_bridges.split(','):
+                    try:
+                        trg_str, src_str = [docname + grp for grp in misc_bridge.split('<')]
+                    except ValueError as err:
+                        raise ValueError(f"{node}: {misc_bridge} {err}")
+                    try:
+                        trg_cluster = clusters[trg_str]
+                        src_cluster = clusters[src_str]
+                    except KeyError as err:
+                        logging.warning(f"{node}: Cannot find cluster {err}")
+                    else:
+                        mention = src_cluster.mentions[-1]
+                        # TODO: what relation should we choose for Bridging?
+                        # relation = f"{src_str.split('-')[0]}-{trg_str.split('-')[0]}"
+                        relation = '_'
+                        mention.bridging.append((trg_cluster, relation))
                 del node.misc['Bridge']
 
             misc_split = node.misc['Split']
             if misc_split:
-                # E.g. Entity=(person-54)|Split=person-4<person-54,person-9<person-54
-                src_str = entity2cluster_id(misc_split.split('<')[-1])
+                # E.g. Entity=(person-54)|Split=4<54,9<54
+                src_str = docname + misc_split.split('<')[-1]
                 ante_clusters = []
                 for x in misc_split.split(','):
-                    ante_str, this_str = (entity2cluster_id(y) for y in x.split('<'))
+                    ante_str, this_str = [docname + grp for grp in x.split('<')]
                     if this_str != src_str:
-                        logging.warning(f'{node} invalid Split: {this_str} != {src_str}')
+                        raise ValueError(f'{node} invalid Split: {this_str} != {src_str}')
+                        # logging.warning
                         # There are just three such cases in GUM and all are bugs,
                         # so let's ignore them entirely (the `else` clause will be skipped if exiting `for` w/ `break`).
-                        break
+                        # break
                     ante_clusters.append(clusters[ante_str])
                 else:
                     clusters[src_str].split_ante = ante_clusters

From 8b1f421bf43ed6e3e226bc05ade6121ffd63a94d Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Mon, 6 Dec 2021 18:23:42 +0100
Subject: [PATCH 0473/1374] Block to fix UD validation of CorefUD 0.2

- this block must be run to fix the trees in CorefUD so they pass the current UD validator
- so far it fixes the following issues:
    - the node with 0 parent must have DEPREL=root
    - there must be a space before newdoc or newpar
---
 udapi/block/corefud/fixtovalidate.py | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 udapi/block/corefud/fixtovalidate.py

diff --git a/udapi/block/corefud/fixtovalidate.py b/udapi/block/corefud/fixtovalidate.py
new file mode 100644
index 00000000..8207835e
--- /dev/null
+++ b/udapi/block/corefud/fixtovalidate.py
@@ -0,0 +1,24 @@
+from udapi.core.block import Block
+
+class FixToValidate(Block):
+    """This block fixes the CorefUD data so that the final documents are valid conllu files."""
+
+    def _set_root_deprel(self, node):
+        if node.parent == node.root and node.deprel != "root":
+            node.deprel = "root"
+            print(node)
+
+    def _space_before_pardoc(self, doc):
+        last_node = None
+        for i, tree in enumerate(doc.trees):
+            if i > 0:
+                if (tree.newdoc is not None or tree.newpar is not None) and last_node.no_space_after:
+                    del last_node.misc["SpaceAfter"]
+                    print(tree)
+            last_node = tree.descendants[-1]
+
+    def process_node(self, node):
+        self._set_root_deprel(node)
+
+    def process_document(self, doc):
+        self._space_before_pardoc(doc)

From 1b437618b1a5a40de1da261d8ed56df6a0097d86 Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Tue, 7 Dec 2021 13:53:41 +0100
Subject: [PATCH 0474/1374] forgotten commit: no debug prints, _set_root_deprel
 must be called from process_document, otherwise it's not called at all

---
 udapi/block/corefud/fixtovalidate.py | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/udapi/block/corefud/fixtovalidate.py b/udapi/block/corefud/fixtovalidate.py
index 8207835e..3af37490 100644
--- a/udapi/block/corefud/fixtovalidate.py
+++ b/udapi/block/corefud/fixtovalidate.py
@@ -3,10 +3,10 @@
 class FixToValidate(Block):
     """This block fixes the CorefUD data so that the final documents are valid conllu files."""
 
-    def _set_root_deprel(self, node):
-        if node.parent == node.root and node.deprel != "root":
-            node.deprel = "root"
-            print(node)
+    def _set_root_deprel(self, doc):
+        for node in doc.nodes:
+            if node.parent == node.root and node.deprel != "root":
+                node.deprel = "root"
 
     def _space_before_pardoc(self, doc):
         last_node = None
@@ -14,11 +14,8 @@ def _space_before_pardoc(self, doc):
             if i > 0:
                 if (tree.newdoc is not None or tree.newpar is not None) and last_node.no_space_after:
                     del last_node.misc["SpaceAfter"]
-                    print(tree)
             last_node = tree.descendants[-1]
 
-    def process_node(self, node):
-        self._set_root_deprel(node)
-
     def process_document(self, doc):
+        self._set_root_deprel(doc)
         self._space_before_pardoc(doc)

From 2f9c7e480d19b6d0e23013cbbb88b218a5aed154 Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Tue, 7 Dec 2021 18:43:11 +0100
Subject: [PATCH 0475/1374] good point by @martinpopel: iterating over root's
 children is more efficient

---
 udapi/block/corefud/fixtovalidate.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/udapi/block/corefud/fixtovalidate.py b/udapi/block/corefud/fixtovalidate.py
index 3af37490..87421688 100644
--- a/udapi/block/corefud/fixtovalidate.py
+++ b/udapi/block/corefud/fixtovalidate.py
@@ -4,9 +4,10 @@ class FixToValidate(Block):
     """This block fixes the CorefUD data so that the final documents are valid conllu files."""
 
     def _set_root_deprel(self, doc):
-        for node in doc.nodes:
-            if node.parent == node.root and node.deprel != "root":
-                node.deprel = "root"
+        for root in doc.trees:
+            for node in root.children:
+                if node.deprel != "root":
+                    node.deprel = "root"
 
     def _space_before_pardoc(self, doc):
         last_node = None

From c404eb98e7276fce10fa1c0d13569e34e69df5d4 Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Thu, 9 Dec 2021 18:35:27 +0100
Subject: [PATCH 0476/1374] fixing the root-is-not-0 UD validation errors for
 some of the automatically parsed datasets

---
 udapi/block/corefud/fixtovalidate.py | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/udapi/block/corefud/fixtovalidate.py b/udapi/block/corefud/fixtovalidate.py
index 87421688..48a3608d 100644
--- a/udapi/block/corefud/fixtovalidate.py
+++ b/udapi/block/corefud/fixtovalidate.py
@@ -9,6 +9,22 @@ def _set_root_deprel(self, doc):
                 if node.deprel != "root":
                     node.deprel = "root"
 
+    def _unset_root_deprel(self, doc):
+        for node in doc.nodes:
+            parent = node.parent
+            if node.deprel == "root" and parent is not None and not parent.is_root():
+                #print("\t".join(['Non-0-root:', node.address(), node.upos, str(node.feats), node.parent.upos, str(node.parent.feats)]))
+                if parent.upos == "PUNCT" and parent.parent is not None:
+                    node.parent = parent.parent
+                if node.upos == "CCONJ":
+                    node.deprel = "cc"
+                elif node.upos == "ADJ" and parent.upos == "PROPN":
+                    node.deprel = "amod"
+                elif node.upos == "NOUN" and parent.upos == "VERB":
+                    node.deprel = "obl"
+                else:
+                    node.deprel = "parataxis"
+
     def _space_before_pardoc(self, doc):
         last_node = None
         for i, tree in enumerate(doc.trees):
@@ -19,4 +35,5 @@ def _space_before_pardoc(self, doc):
 
     def process_document(self, doc):
         self._set_root_deprel(doc)
+        self._unset_root_deprel(doc)
         self._space_before_pardoc(doc)

From 46022c6509eebfdb71196fc9f56bfe47a2197740 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 19 Dec 2021 23:40:48 +0100
Subject: [PATCH 0477/1374] Heuristics to fix wrong edeprels in Czech.

---
 udapi/block/ud/cs/fixedeprels.py | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 udapi/block/ud/cs/fixedeprels.py

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
new file mode 100644
index 00000000..d4455235
--- /dev/null
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -0,0 +1,21 @@
+"""Block to fix case-enhanced dependency relations in Czech."""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixEdeprels(Block):
+
+    def process_node(self, node):
+        """
+        Occasionally the edeprels automatically derived from the Czech basic
+        trees do not match the whitelist. For example, the noun is an
+        abbreviation and its morphological case is unknown.
+        """
+        for edep in node.deps:
+            if edep['deprel'] eq 'nmod:na':
+                # The case is unknown. We need 'acc' or 'loc'.
+                # The locative is probably more frequent but it is not so likely with every noun.
+                if re.match(r'^(adresát|AIDS|DEM|frank|h|ha|hodina|Honolulu|jméno|koruna|litr|metr|míle|miliarda|milión|mm|MUDr|NATO|obyvatel|OSN|počet|procento|příklad|rok|SSSR|vůz)$', node.lemma):
+                    edep['deprel'] = 'nmod:na:acc'
+                else
+                    edep['deprel'] = 'nmod:na:loc'

From 0d409b6cf86a3cf5881a9dfb37e0f39fa3409cb5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 19 Dec 2021 23:42:21 +0100
Subject: [PATCH 0478/1374] Bug fix.

---
 udapi/block/ud/cs/fixedeprels.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index d4455235..9888e51f 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -12,7 +12,7 @@ def process_node(self, node):
         abbreviation and its morphological case is unknown.
         """
         for edep in node.deps:
-            if edep['deprel'] eq 'nmod:na':
+            if edep['deprel'] == 'nmod:na':
                 # The case is unknown. We need 'acc' or 'loc'.
                 # The locative is probably more frequent but it is not so likely with every noun.
                 if re.match(r'^(adresát|AIDS|DEM|frank|h|ha|hodina|Honolulu|jméno|koruna|litr|metr|míle|miliarda|milión|mm|MUDr|NATO|obyvatel|OSN|počet|procento|příklad|rok|SSSR|vůz)$', node.lemma):

From 71d8a216ba88d3af9fb05c2fe5abd224d561776d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 19 Dec 2021 23:43:24 +0100
Subject: [PATCH 0479/1374] Bug fix.

---
 udapi/block/ud/cs/fixedeprels.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 9888e51f..5c4be62e 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -17,5 +17,5 @@ def process_node(self, node):
                 # The locative is probably more frequent but it is not so likely with every noun.
                 if re.match(r'^(adresát|AIDS|DEM|frank|h|ha|hodina|Honolulu|jméno|koruna|litr|metr|míle|miliarda|milión|mm|MUDr|NATO|obyvatel|OSN|počet|procento|příklad|rok|SSSR|vůz)$', node.lemma):
                     edep['deprel'] = 'nmod:na:acc'
-                else
+                else:
                     edep['deprel'] = 'nmod:na:loc'

From 035673ea78eb5c2ec8e6fa92c1a3b8e32ca9247d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 24 Dec 2021 14:57:46 +0100
Subject: [PATCH 0480/1374] Fix Czech edeprels.

---
 udapi/block/ud/cs/fixedeprels.py | 372 ++++++++++++++++++++++++++++++-
 1 file changed, 366 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 5c4be62e..ddcdb6d3 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -12,10 +12,370 @@ def process_node(self, node):
         abbreviation and its morphological case is unknown.
         """
         for edep in node.deps:
-            if edep['deprel'] == 'nmod:na':
-                # The case is unknown. We need 'acc' or 'loc'.
-                # The locative is probably more frequent but it is not so likely with every noun.
-                if re.match(r'^(adresát|AIDS|DEM|frank|h|ha|hodina|Honolulu|jméno|koruna|litr|metr|míle|miliarda|milión|mm|MUDr|NATO|obyvatel|OSN|počet|procento|příklad|rok|SSSR|vůz)$', node.lemma):
-                    edep['deprel'] = 'nmod:na:acc'
+            if re.match(r'^(acl|advcl):', edep['deprel']):
+                edep['deprel'] = re.sub(r'^(advcl):a_jestliže$', r'\1:jestliže', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):a_pokud$', r'\1:pokud', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):ačkoliv$', r'\1:ačkoli', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl):co_když$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):jak_aby$', r'\1:jak', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):jak_ad$', r'\1:jak', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):jakkoliv$', r'\1:jakkoli', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):jen_když$', r'\1:když', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):jen_pokud$', r'\1:pokud', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):jestli_že$', r'\1:jestliže', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):jestliže_tedy$', r'\1:jestliže', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl):k$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):kdykoliv$', r'\1:kdykoli', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):když_už$', r'\1:když', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:místo$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
+                edep['deprel'] = re.sub(r'^(advcl):například_když$', r'\1:když', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):nechť$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl):od$', r'nmod:od:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):podle$', r'obl:podle:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):pokud_totiž$', r'\1:pokud', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):pokud_však$', r'\1:pokud', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):pro$', r'obl:pro:acc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):protože_pokud$', r'\1:pokud', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl):v$', r'nmod:v:loc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):v_případ_že$', r'\1:v_případě_že', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):v_duch$', r'obl:v_duchu:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):že_ať$', r'\1:ať', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):že_jako$', r'\1:že', edep['deprel'])
+                if edep['deprel'] == 'acl:v' and node.form == 'patře':
+                    edep['deprel'] = 'nmod:v:loc'
+                    node.deprel = 'nmod'
+                    node.lemma = 'patro'
+                    node.upos = 'NOUN'
+                    node.xpos = 'NNNS6-----A----'
+                    node.feats['Aspect'] = ''
+                    node.feats['Gender'] = 'Neut'
+                    node.feats['Tense'] = ''
+                    node.feats['VerbForm'] = ''
+                    node.feats['Voice'] = ''
+                edep['deprel'] = re.sub(r'^advcl:(od|do)$', r'obl:\1:gen', edep['deprel'])
+            elif re.match(r'^(nmod|obl):', edep['deprel']):
+                if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
+                    # This is a same-case noun-noun modifier, which just happens to be in the locative.
+                    # For example, 'v Ostravě-Porubě', 'Porubě' is attached to 'Ostravě', 'Ostravě' has
+                    # nmod:v:loc, which is OK, but for 'Porubě' the case does not say anything significant.
+                    edep['deprel'] = 'nmod'
+                elif edep['deprel'] == 'obl:loc':
+                    # Annotation error. The first occurrence in PDT dev:
+                    # 'V Rapaportu, ceníku Antverpské burzy i Diamantberichtu jsou uvedeny ceny...'
+                    # The preposition 'V' should modify coordination 'Rapaportu i Diamantberichtu'.
+                    # However, 'Rapaportu' is attached as 'obl' to 'Diamantberichtu'.
+                    edep['deprel'] = 'obl:v:loc'
+                elif edep['deprel'] == 'obl:arg:loc':
+                    # Annotation error. The first occurrence in PDT dev:
+                    edep['deprel'] = 'obl:arg:na:loc'
+                elif edep['deprel'] == 'nmod:loc':
+                    # 'působil v kanadském Edmontonu Oilers', 'Edmontonu' attached to 'Oilers' and not vice versa.
+                    edep['deprel'] = 'nmod:nom'
+                elif edep['deprel'] == 'obl:nom' or edep['deprel'] == 'obl:voc':
+                    # Possibly an annotation error, nominative should be accusative, and the nominal should be direct object?
+                    # However, there seems to be a great variability in the causes, some are subjects and many are really obliques, so let's go just with 'obl' for now.
+                    edep['deprel'] = 'obl'
+                elif edep['deprel'] == 'nmod:voc':
+                    # 'v 8. čísle tiskoviny Ty rudá krávo'
+                    edep['deprel'] = 'nmod:nom'
+                elif re.match(r'^(nmod|obl(:arg)?):během$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):bez$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif edep['deprel'] == 'nmod:co:nom':
+                    # Annotation error: 'kompatibilní znamená tolik co slučitelný'
+                    # 'co' should be relative pronoun rather than subordinating conjunction.
+                    edep['deprel'] = 'acl:relcl'
+                    node.deprel = 'acl:relcl'
+                elif re.match(r'^(nmod|obl(:arg)?):díky$', edep['deprel']):
+                    edep['deprel'] += ':dat'
+                elif re.match(r'^(nmod|obl(:arg)?):do$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):k(:nom)?$', edep['deprel']):
+                    edep['deprel'] = re.sub(r':nom$', '', edep['deprel']) + ':dat'
+                elif re.match(r'^(nmod|obl(:arg)?):kolem$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):kromě$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(obl(:arg)?):li$', edep['deprel']):
+                    edep['deprel'] = 'advcl:li'
+                elif re.match(r'^(nmod|obl(:arg)?):mezi$', edep['deprel']):
+                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):mimo$', edep['deprel']):
+                    edep['deprel'] += ':acc'
+                elif re.match(r'^(nmod|obl(:arg)?):místo$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^obl:místo_za:acc$', edep['deprel']):
+                    # 'chytají krávu místo za rohy spíše za ocas'
+                    # This should be treated as coordination; 'místo' and 'spíše' are adverbs (???); 'case' for 'místo' does not seem to be the optimal solution.
+                    for c in node.children:
+                        if c.form == 'místo':
+                            c.upos = 'ADV'
+                            c.deprel = 'cc'
+                    edep['deprel'] = 'obl:za:acc'
+                elif re.match(r'^(nmod|obl(:arg)?):místo[_:].+$', edep['deprel']) and not re.match(r'^(nmod|obl(:arg)?):místo_aby$', edep['deprel']):
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):místo[_:].+$', r'\1:místo:gen', edep['deprel'])
+                elif re.match(r'^(nmod|obl(:arg)?):na$', edep['deprel']):
+                    # The case is unknown. We need 'acc' or 'loc'.
+                    # The locative is probably more frequent but it is not so likely with every noun.
+                    # If there is an nummod:gov child, it must be accusative and not locative.
+                    # (The case would be taken from the number but if it is expressed as digits, it does not have the case feature.)
+                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    elif re.match(r'^(adresát|AIDS|DEM|frank|h|ha|hodina|Honolulu|jméno|koruna|litr|metr|míle|miliarda|milión|mm|MUDr|NATO|obyvatel|OSN|počet|procento|příklad|rok|SSSR|vůz)$', node.lemma):
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':loc'
+                elif re.match(r'^obl:arg:na_konec$', edep['deprel']):
+                    # Annotation error. It should have been two prepositional phrases: 'snížil na 225 tisíc koncem minulého roku'
+                    edep['deprel'] = 'obl:arg:na:acc'
+                elif re.match(r'^(nmod|obl(:arg)?):nad$', edep['deprel']):
+                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):namísto$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):navzdory$', edep['deprel']):
+                    edep['deprel'] += ':dat'
+                elif re.match(r'^(nmod|obl(:arg)?):o$', edep['deprel']):
+                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':loc'
+                elif re.match(r'^(nmod|obl(:arg)?):od$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):okolo$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):oproti$', edep['deprel']):
+                    edep['deprel'] += ':dat'
+                elif re.match(r'^nmod:pára:nom$', edep['deprel']):
+                    # Annotation error: 'par excellence'.
+                    edep['deprel'] = 'nmod'
+                    for c in node.children:
+                        if c.udeprel == 'case' and c.form.lower() == 'par':
+                            c.lemma = 'par'
+                            c.upos = 'ADP'
+                            c.xpos = 'RR--X----------'
+                            c.feats['Case'] = ''
+                            c.feats['Gender'] = ''
+                            c.feats['Number'] = ''
+                            c.feats['Polarity'] = ''
+                            c.feats['AdpType'] = 'Prep'
+                elif re.match(r'^(nmod|obl(:arg)?):po$', edep['deprel']):
+                    ###!!! Taky bychom se mohli dívat do XPOS předložky, protože tam bude pád uveden!
+                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':loc'
+                elif re.match(r'^(nmod|obl(:arg)?):poblíž$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):pod$', edep['deprel']):
+                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):podle$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):pro$', edep['deprel']):
+                    edep['deprel'] += ':acc'
+                elif re.match(r'^(nmod|obl(:arg)?):proti$', edep['deprel']):
+                    edep['deprel'] += ':dat'
+                elif re.match(r'^(nmod|obl(:arg)?):před$', edep['deprel']):
+                    # Accusative would be possible but unlikely.
+                    edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):přes$', edep['deprel']):
+                    edep['deprel'] += ':acc'
+                elif re.match(r'^(nmod|obl(:arg)?):při$', edep['deprel']):
+                    edep['deprel'] += ':loc'
+                elif re.match(r'^(nmod|obl(:arg)?):s$', edep['deprel']):
+                    # Genitive would be possible but unlikely.
+                    edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):skrz$', edep['deprel']):
+                    edep['deprel'] += ':acc'
+                elif re.match(r'^(nmod|obl(:arg)?):u$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):uprostřed$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):uvnitř$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):v(:nom)?$', edep['deprel']):
+                    # ':nom' occurs in 'karneval v Rio de Janeiro'
+                    edep['deprel'] = re.sub(r':nom$', '', edep['deprel'])
+                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':loc'
+                elif re.match(r'^obl:v_čel[eo]_s:ins$', edep['deprel']):
+                    # There is just one occurrence and it is an error:
+                    # 'Předloňský kůň roku Law Soziri šel již v Lahovickém oblouku v čele s Raddelliosem a tato dvojice také nakonec zahanbila ostatní soupeře...'
+                    # There should be two independent oblique modifiers, 'v čele' and 's Raddelliosem'.
+                    edep['deprel'] = 'obl:s:ins'
+                elif re.match(r'^(nmod|obl(:arg)?):včetně$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):vedle$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):vůči$', edep['deprel']):
+                    edep['deprel'] += ':dat'
+                elif re.match(r'^(nmod|obl(:arg)?):z$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):za$', edep['deprel']):
+                    # Instrumental would be possible but unlikely.
+                    edep['deprel'] += ':acc'
                 else:
-                    edep['deprel'] = 'nmod:na:loc'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):aby_na:loc$', r'\1:na:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ač([_:].+)?$', r'\1:ač', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ačkoliv?([_:].+)?$', r'\1:ačkoli', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(jak_)?ad([_:].+)?$', r'\1', edep['deprel']) # ad infinitum
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_v(:loc)?$', r'\1:v:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_z(:gen)?$', r'\1:z:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_ohled_na(:acc)?$', r'\1:bez_ohledu_na:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):byť[_:].+$', r'\1:byť', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):cesta:ins$', r'\1:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):cesta(:gen)?$', r'\1:cestou:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):co(:nom)?$', r'advmod', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):daleko(:nom)?$', r'\1:nedaleko:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):daleko_od(:gen)?$', r'\1:od:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):de([_:].+)?$', r'\1', edep['deprel']) # de facto
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):di([_:].+)?$', r'\1', edep['deprel']) # Lido di Jesolo
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):dík(:dat)?$', r'\1:díky:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do:nom$', r'\1:do:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_k:dat$', r'\1:k:dat', edep['deprel']) # do maloobchodní sítě (nebo k dalšímu zpracování)
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_rozpor_s(:ins)?$', r'\1:do_rozporu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_soulad_s(:ins)?$', r'\1:do_souladu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):en([_:].+)?$', r'\1', edep['deprel']) # bienvenue en France
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(ať_)?forma(:gen)?$', r'\1:formou:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):i_když[_:].+$', r'\1:i_když', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):in([_:].+)?$', r'\1', edep['deprel']) # made in NHL
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):into([_:].+)?$', r'\1', edep['deprel']) # made in NHL
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jak[_:].+$', r'\1:jak', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakkoliv?[_:].+$', r'\1:jakkoli', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jako[_:].+$', r'\1:jako', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby_pod:ins$', r'\1:pod:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno:nom$', r'\1:jménem:nom', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno(:gen)?$', r'\1:jménem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):k_konec(:gen)?$', r'\1:ke_konci:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):kol(em)?(:gen)?$', r'\1:kolem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):konec(:gen)?$', r'\1:koncem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi:(nom|dat)$', r'\1:mezi:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi_uvnitř:gen$', r'\1:uvnitř:gen', edep['deprel']) # 'nejdou mezi, ale uvnitř odvětví a oborů'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na(:gen|:nom)$', r'\1:na:acc', edep['deprel']) # 'odložit na 1. září'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_čelo(:gen)?$', r'\1:na_čele:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_mimo:loc$', r'\1:na:loc', edep['deprel']) # 'na kurtě i mimo něj'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_?rozdíl_od(:gen)?$', r'\1:na_rozdíl_od:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_úroveň(:gen)?$', r'\1:na_úrovni:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_základ(:gen)?$', r'\1:na_základě:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_závěr(:gen)?$', r'\1:na_závěr:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):namísto_do(:gen)?$', r'\1:do:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):následek(:gen)?$', r'\1:následkem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(ne)?daleko(:gen)?$', r'\1:nedaleko:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):než[_:].+$', r'\1:než', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):nežli[_:].+$', r'\1:nežli', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o:(nom|gen|dat)$', r'\1:o:acc', edep['deprel']) # 'zájem o obaly'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o_jako[_:].+$', r'\1:jako', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o_o:acc$', r'\1:o:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):od:nom$', r'\1:od:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):of([_:].+)?$', r'\1', edep['deprel']) # University of North Carolina
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ohledně(:gen)?$', r'\1:ohledně:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):per([_:].+)?$', r'\1', edep['deprel']) # per rollam
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po:nom$', r'\1:po:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_vzor(:gen)?$', r'\1:po_vzoru:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):počátek(:gen)?$', r'\1:počátkem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):počínat(:ins)?$', r'\1:počínaje:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pod_vliv(:gen)?$', r'\1:pod_vlivem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pomocí?(:gen)?$', r'\1:pomocí:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):postup(:gen)?$', r'\1:postupem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pro:nom$', r'\1:pro:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):prostřednictvím?(:gen|:ins)?$', r'\1:prostřednictvím:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):protože[_:].+$', r'\1:protože', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před:gen$', r'\1:před:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před_během:gen$', r'\1:během:gen', edep['deprel']) # 'před a během utkání'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před_po:loc$', r'\1:po:loc', edep['deprel']) # 'před a po vyloučení Schindlera'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přestože[_:].+$', r'\1:přestože', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):při_příležitost(:gen)?$', r'\1:při_příležitosti:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s:nom$', r'\1:s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_ohled_na(:acc)?$', r'\1:s_ohledem_na:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_pomoc(:gen)?$', r'\1:s_pomocí:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_přihlédnutí_k(:dat)?$', r'\1:s_přihlédnutím_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_přihlédnutí_na(:acc)?$', r'\1:s_přihlédnutím_na:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_výjimka(:gen)?$', r'\1:s_výjimkou:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_vyloučení(:gen)?$', r'\1:s_vyloučením:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_zřetel_k(:dat)?$', r'\1:se_zřetelem_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):severně_od(:gen)?$', r'\1:od:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):shoda(:gen)?$', r'\1', edep['deprel']) # 'shodou okolností' is not a prepositional phrase
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_do(:gen)?$', r'\1:směrem_do:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_k(:dat)?$', r'\1:směrem_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_na(:acc)?$', r'\1:směrem_na:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_od(:gen)?$', r'\1:směrem_od:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):společně_s(:ins)?$', r'\1:společně_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):spolu_s(:ins|:dat)?$', r'\1:spolu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):stranou(:gen|:dat)?$', r'\1:stranou:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):třebaže[_:].+$', r'\1:třebaže', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):u_příležitost(:gen)?$', r'\1:u_příležitosti:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v:gen$', r'\1:v:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_čelo(:gen)?$', r'\1:v_čele:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_duch(:gen)?$', r'\1:v_duchu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_důsledek(:gen)?$', r'\1:v_důsledku:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_forma(:gen)?$', r'\1:ve_formě:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_jméno(:gen)?$', r'\1:ve_jménu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_konfrontace_s(:ins)?$', r'\1:v_konfrontaci_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_oblast(:gen)?$', r'\1:v_oblasti:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_obor(:gen)?$', r'\1:v_oboru:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_otázka(:gen)?$', r'\1:v_otázce:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_podoba(:gen)?$', r'\1:v_podobě:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_poměr_k(:dat)?$', r'\1:v_poměru_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_proces(:gen)?$', r'\1:v_procesu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_prospěch(:gen)?$', r'\1:ve_prospěch:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_protiklad_k(:dat)?$', r'\1:v_protikladu_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_průběh(:gen)?$', r'\1:v_průběhu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_případ(:gen)?$', r'\1:v_případě:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_rámec(:gen)?$', r'\1:v_rámci:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_rozpor_s(:ins)?$', r'\1:v_rozporu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_řada(:gen)?$', r'\1:v_řadě:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_shoda_s(:ins)?$', r'\1:ve_shodě_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_služba(:gen)?$', r'\1:ve_službách:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_smysl(:gen)?$', r'\1:ve_smyslu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_souhlas_s(:ins|:nom)?$', r'\1:v_souhlasu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_soulad_s(:ins|:nom)?$', r'\1:v_souladu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_souvislost_s(:ins)?$', r'\1:v_souvislosti_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spojení_s(:ins)?$', r'\1:ve_spojení_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spojený_s(:ins)?$', r'\1:ve_spojení_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spojitost_s(:ins)?$', r'\1:ve_spojitosti_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spolupráce_s(:ins)?$', r'\1:ve_spolupráci_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_srovnání_s(:ins)?$', r'\1:ve_srovnání_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_světlo(:gen)?$', r'\1:ve_světle:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_věc(:gen)?$', r'\1:ve_věci:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_vztah_k(:dat)?$', r'\1:ve_vztahu_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_zájem(:gen)?$', r'\1:v_zájmu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_záležitost(:gen)?$', r'\1:v_záležitosti:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závěr(:gen)?$', r'\1:v_závěru:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závislost_na(:loc)?$', r'\1:v_závislosti_na:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_znamení(:gen)?$', r'\1:ve_znamení:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vina(:gen)?$', r'\1:vinou:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vliv(:gen)?$', r'\1:vlivem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vo:acc$', r'\1:o:acc', edep['deprel']) # colloquial: vo všecko
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):von([_:].+)?$', r'\1', edep['deprel']) # von Neumannem
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):voor([_:].+)?$', r'\1', edep['deprel']) # Hoge Raad voor Diamant
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vzhledem(_k)?(:dat)?$', r'\1:vzhledem_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:nom$', r'\1:z:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_důvod(:gen)?$', r'\1:z_důvodu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_hledisko(:gen)?$', r'\1:z_hlediska:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_řada(:gen)?$', r'\1:z_řad:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(ať_)?z_strana(:gen)?$', r'\1:ze_strany:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_titul(:gen)?$', r'\1:z_titulu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za:nom$', r'\1:za:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_pomoc(:gen)?$', r'\1:za_pomoci:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_účel(:gen)?$', r'\1:za_účelem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):začátek(:gen)?$', r'\1:začátkem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):zásluha(:gen)?$', r'\1:zásluhou:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):závěr(:gen)?$', r'\1:závěrem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):závisle_na(:loc)?$', r'\1:nezávisle_na:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^nmod:že:gen$', 'acl:že', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):že_za:gen$', r'\1:za:gen', edep['deprel'])

From a0c56a1307426c46bc5974cca4e3f1341da5232c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 26 Dec 2021 22:17:12 +0100
Subject: [PATCH 0481/1374] Czech enhanced case markers.

---
 udapi/block/ud/cs/fixedeprels.py | 90 ++++++++++++++++++++++++++------
 1 file changed, 73 insertions(+), 17 deletions(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index ddcdb6d3..2628f369 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -13,29 +13,26 @@ def process_node(self, node):
         """
         for edep in node.deps:
             if re.match(r'^(acl|advcl):', edep['deprel']):
-                edep['deprel'] = re.sub(r'^(advcl):a_jestliže$', r'\1:jestliže', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):a_pokud$', r'\1:pokud', edep['deprel'])
+                # We do not include 'i' in the list of redundant prefixes because we want to preserve 'i když' (but we want to discard the other combinations).
+                edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|protože|teprve|zejména)_(aby|až|jestliže|když|pokud)$', r'\1:\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|pokud)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):abi$', r'\1:aby', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):ačkoliv$', r'\1:ačkoli', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl):co_když$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):jak_aby$', r'\1:jak', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):jak_ad$', r'\1:jak', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):jakkoliv$', r'\1:jakkoli', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):jen_když$', r'\1:když', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):jen_pokud$', r'\1:pokud', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):jakoby$', r'\1:jako', edep['deprel']) # these instances in FicTree should be spelled 'jako by'
+                edep['deprel'] = re.sub(r'^(advcl):jelikož_do$', r'\1:jelikož', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):jestli_že$', r'\1:jestliže', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):jestliže_tedy$', r'\1:jestliže', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl):k$', r'\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):kdykoliv$', r'\1:kdykoli', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):když_už$', r'\1:když', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:místo$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
-                edep['deprel'] = re.sub(r'^(advcl):například_když$', r'\1:když', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):neboť$', r'\1', edep['deprel']) # 'neboť' is coordinating
                 edep['deprel'] = re.sub(r'^(advcl):nechť$', r'\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl):od$', r'nmod:od:gen', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):podle$', r'obl:podle:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):pokud_totiž$', r'\1:pokud', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):pokud_však$', r'\1:pokud', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):pro$', r'obl:pro:acc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):protože_pokud$', r'\1:pokud', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl):v$', r'nmod:v:loc', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):v_případ_že$', r'\1:v_případě_že', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):v_duch$', r'obl:v_duchu:gen', edep['deprel'])
@@ -89,6 +86,8 @@ def process_node(self, node):
                     node.deprel = 'acl:relcl'
                 elif re.match(r'^(nmod|obl(:arg)?):díky$', edep['deprel']):
                     edep['deprel'] += ':dat'
+                elif re.match(r'^(nmod|obl(:arg)?):dle$', edep['deprel']):
+                    edep['deprel'] += ':gen'
                 elif re.match(r'^(nmod|obl(:arg)?):do$', edep['deprel']):
                     edep['deprel'] += ':gen'
                 elif re.match(r'^(nmod|obl(:arg)?):k(:nom)?$', edep['deprel']):
@@ -148,6 +147,16 @@ def process_node(self, node):
                         edep['deprel'] += ':loc'
                 elif re.match(r'^(nmod|obl(:arg)?):od$', edep['deprel']):
                     edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):ohled_na:ins$', edep['deprel']):
+                    # Annotation error.
+                    if node.form == 's':
+                        ohled = node.next_node
+                        na = ohled.next_node
+                        noun = na.next_node
+                        self.set_basic_and_enhanced(noun, node.parent, 'obl', 'obl:s_ohledem_na:acc')
+                        self.set_basic_and_enhanced(ohled, node, 'fixed', 'fixed')
+                        self.set_basic_and_enhanced(na, node, 'fixed', 'fixed')
+                        self.set_basic_and_enhanced(node, noun, 'case', 'case')
                 elif re.match(r'^(nmod|obl(:arg)?):okolo$', edep['deprel']):
                     edep['deprel'] += ':gen'
                 elif re.match(r'^(nmod|obl(:arg)?):oproti$', edep['deprel']):
@@ -202,6 +211,18 @@ def process_node(self, node):
                     edep['deprel'] += ':gen'
                 elif re.match(r'^(nmod|obl(:arg)?):uvnitř$', edep['deprel']):
                     edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):v_s(:loc)?$', edep['deprel']) and node.form == 'spolupráci':
+                    # Annotation error. 'Ve spolupráci s' should be analyzed as a multi-word preposition.
+                    # Find the content nominal.
+                    cnouns = [x for x in node.children if x.ord > node.ord and re.match(r'^(nmod|obl)', x.udeprel)]
+                    vs = [x for x in node.children if x.ord < node.ord and x.lemma == 'v']
+                    if len(cnouns) > 0 and len(vs) > 0:
+                        logging.info('I am here.')
+                        cnoun = cnouns[0]
+                        v = vs[0]
+                        self.set_basic_and_enhanced(cnoun, node.parent, 'obl', 'obl:ve_spolupráci_s:ins')
+                        self.set_basic_and_enhanced(v, cnoun, 'case', 'case')
+                        self.set_basic_and_enhanced(node, v, 'fixed', 'fixed')
                 elif re.match(r'^(nmod|obl(:arg)?):v(:nom)?$', edep['deprel']):
                     # ':nom' occurs in 'karneval v Rio de Janeiro'
                     edep['deprel'] = re.sub(r':nom$', '', edep['deprel'])
@@ -235,8 +256,11 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_v(:loc)?$', r'\1:v:loc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_z(:gen)?$', r'\1:z:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_ohled_na(:acc)?$', r'\1:bez_ohledu_na:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_zřetel_k(:dat)?$', r'\1:bez_zřetele_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):blíž(:dat)?$', r'\1:blízko:dat', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):byť[_:].+$', r'\1:byť', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):cesta:ins$', r'\1:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):cesta(:gen)?$', r'\1:cestou:gen', edep['deprel'])
@@ -246,7 +270,7 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):de([_:].+)?$', r'\1', edep['deprel']) # de facto
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):di([_:].+)?$', r'\1', edep['deprel']) # Lido di Jesolo
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):dík(:dat)?$', r'\1:díky:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do:nom$', r'\1:do:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do:(nom|dat)$', r'\1:do:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_k:dat$', r'\1:k:dat', edep['deprel']) # do maloobchodní sítě (nebo k dalšímu zpracování)
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_rozpor_s(:ins)?$', r'\1:do_rozporu_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_soulad_s(:ins)?$', r'\1:do_souladu_s:ins', edep['deprel'])
@@ -258,6 +282,7 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jak[_:].+$', r'\1:jak', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakkoliv?[_:].+$', r'\1:jakkoli', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jako[_:].+$', r'\1:jako', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby[_:].+$', r'\1:jako', edep['deprel']) # these instances in FicTree should be spelled 'jako by'
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby_pod:ins$', r'\1:pod:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno:nom$', r'\1:jménem:nom', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno(:gen)?$', r'\1:jménem:gen', edep['deprel'])
@@ -269,6 +294,8 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na(:gen|:nom)$', r'\1:na:acc', edep['deprel']) # 'odložit na 1. září'
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_čelo(:gen)?$', r'\1:na_čele:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_mimo:loc$', r'\1:na:loc', edep['deprel']) # 'na kurtě i mimo něj'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_než:acc$', r'\1:na:acc', edep['deprel']) # 'na víc než čtyři a půl kilometru'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_podklad(:gen)?$', r'\1:na_podkladě:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_?rozdíl_od(:gen)?$', r'\1:na_rozdíl_od:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_úroveň(:gen)?$', r'\1:na_úrovni:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_základ(:gen)?$', r'\1:na_základě:gen', edep['deprel'])
@@ -281,26 +308,29 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o:(nom|gen|dat)$', r'\1:o:acc', edep['deprel']) # 'zájem o obaly'
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o_jako[_:].+$', r'\1:jako', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o_o:acc$', r'\1:o:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):od:nom$', r'\1:od:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):od:(nom|dat)$', r'\1:od:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):of([_:].+)?$', r'\1', edep['deprel']) # University of North Carolina
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ohledně(:gen)?$', r'\1:ohledně:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):per([_:].+)?$', r'\1', edep['deprel']) # per rollam
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po:nom$', r'\1:po:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_doba(:gen)?$', r'\1:po_dobu:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_vzor(:gen)?$', r'\1:po_vzoru:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):počátek(:gen)?$', r'\1:počátkem:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):počínat(:ins)?$', r'\1:počínaje:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pod_vliv(:gen)?$', r'\1:pod_vlivem:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pomocí?(:gen)?$', r'\1:pomocí:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):postup(:gen)?$', r'\1:postupem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pro:nom$', r'\1:pro:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pro:(nom|dat)$', r'\1:pro:acc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):prostřednictvím?(:gen|:ins)?$', r'\1:prostřednictvím:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):proti:nom$', r'\1:proti:dat', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):protože[_:].+$', r'\1:protože', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před:gen$', r'\1:před:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před_během:gen$', r'\1:během:gen', edep['deprel']) # 'před a během utkání'
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před_po:loc$', r'\1:po:loc', edep['deprel']) # 'před a po vyloučení Schindlera'
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přestože[_:].+$', r'\1:přestože', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):při_příležitost(:gen)?$', r'\1:při_příležitosti:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s:nom$', r'\1:s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):se?:(nom|acc|ins)$', r'\1:s:ins', edep['deprel']) # accusative: 'být s to' should be a fixed expression and it should be the predicate!
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_ohled_k(:dat)?$', r'\1:s_ohledem_k:dat', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_ohled_na(:acc)?$', r'\1:s_ohledem_na:acc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_pomoc(:gen)?$', r'\1:s_pomocí:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_přihlédnutí_k(:dat)?$', r'\1:s_přihlédnutím_k:dat', edep['deprel'])
@@ -308,6 +338,7 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_výjimka(:gen)?$', r'\1:s_výjimkou:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_vyloučení(:gen)?$', r'\1:s_vyloučením:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_zřetel_k(:dat)?$', r'\1:se_zřetelem_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_zřetel_na(:acc)?$', r'\1:se_zřetelem_na:acc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):severně_od(:gen)?$', r'\1:od:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):shoda(:gen)?$', r'\1', edep['deprel']) # 'shodou okolností' is not a prepositional phrase
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_do(:gen)?$', r'\1:směrem_do:gen', edep['deprel'])
@@ -315,18 +346,22 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_na(:acc)?$', r'\1:směrem_na:acc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_od(:gen)?$', r'\1:směrem_od:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):společně_s(:ins)?$', r'\1:společně_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):spolu_s(:ins|:dat)?$', r'\1:spolu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):spolu(_s)?(:ins|:dat)?$', r'\1:spolu_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):stranou(:gen|:dat)?$', r'\1:stranou:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):třebaže[_:].+$', r'\1:třebaže', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):u_příležitost(:gen)?$', r'\1:u_příležitosti:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v:gen$', r'\1:v:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_analogie_s(:ins)?$', r'\1:v_analogii_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_čelo(:gen)?$', r'\1:v_čele:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_čelo_s(:ins)?$', r'\1:v_čele_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_dohoda_s(:ins)?$', r'\1:v_dohodě_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_duch(:gen)?$', r'\1:v_duchu:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_důsledek(:gen)?$', r'\1:v_důsledku:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_forma(:gen)?$', r'\1:ve_formě:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_jméno(:gen)?$', r'\1:ve_jménu:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_konfrontace_s(:ins)?$', r'\1:v_konfrontaci_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_oblast(:gen)?$', r'\1:v_oblasti:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_oblast_s(:ins)?$', r'\1:s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_obor(:gen)?$', r'\1:v_oboru:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_otázka(:gen)?$', r'\1:v_otázce:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_podoba(:gen)?$', r'\1:v_podobě:gen', edep['deprel'])
@@ -342,6 +377,7 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_shoda_s(:ins)?$', r'\1:ve_shodě_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_služba(:gen)?$', r'\1:ve_službách:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_smysl(:gen)?$', r'\1:ve_smyslu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_součinnost_s(:ins|:nom)?$', r'\1:v_součinnosti_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_souhlas_s(:ins|:nom)?$', r'\1:v_souhlasu_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_soulad_s(:ins|:nom)?$', r'\1:v_souladu_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_souvislost_s(:ins)?$', r'\1:v_souvislosti_s:ins', edep['deprel'])
@@ -353,7 +389,7 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_světlo(:gen)?$', r'\1:ve_světle:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_věc(:gen)?$', r'\1:ve_věci:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_vztah_k(:dat)?$', r'\1:ve_vztahu_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_zájem(:gen)?$', r'\1:v_zájmu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_zájem(:gen|:loc)?$', r'\1:v_zájmu:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_záležitost(:gen)?$', r'\1:v_záležitosti:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závěr(:gen)?$', r'\1:v_závěru:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závislost_na(:loc)?$', r'\1:v_závislosti_na:loc', edep['deprel'])
@@ -367,11 +403,13 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:nom$', r'\1:z:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_důvod(:gen)?$', r'\1:z_důvodu:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_hledisko(:gen)?$', r'\1:z_hlediska:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_oblast(:gen)?$', r'\1:z_oblasti:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_řada(:gen)?$', r'\1:z_řad:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(ať_)?z_strana(:gen)?$', r'\1:ze_strany:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_titul(:gen)?$', r'\1:z_titulu:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za:nom$', r'\1:za:acc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_pomoc(:gen)?$', r'\1:za_pomoci:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_účast(:gen)?$', r'\1:za_účasti:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_účel(:gen)?$', r'\1:za_účelem:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):začátek(:gen)?$', r'\1:začátkem:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):zásluha(:gen)?$', r'\1:zásluhou:gen', edep['deprel'])
@@ -379,3 +417,21 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):závisle_na(:loc)?$', r'\1:nezávisle_na:loc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^nmod:že:gen$', 'acl:že', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):že_za:gen$', r'\1:za:gen', edep['deprel'])
+
+    def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
+        '''
+        Modifies the incoming relation of a node both in the basic tree and in
+        the enhanced graph. If the node does not yet depend in the enhanced
+        graph on the current basic parent, the new relation will be added without
+        removing any old one. If the node already depends multiple times on the
+        current basic parent in the enhanced graph, all such enhanced relations
+        will be removed before adding the new one.
+        '''
+        old_parent = node.parent
+        node.parent = parent
+        node.deprel = deprel
+        node.deps = [x for x in node.deps if x['parent'] != old_parent]
+        new_edep = {}
+        new_edep['parent'] = parent
+        new_edep['deprel'] = edeprel
+        node.deps.append(new_edep)

From a9720d16cb283eec919a4cdfa672085268665cb6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 27 Dec 2021 15:52:23 +0100
Subject: [PATCH 0482/1374] Czech enhanced case markers.

---
 udapi/block/ud/cs/fixedeprels.py | 50 +++++++++++++++++++++++++++-----
 1 file changed, 42 insertions(+), 8 deletions(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 2628f369..5a2e996d 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -14,28 +14,37 @@ def process_node(self, node):
         for edep in node.deps:
             if re.match(r'^(acl|advcl):', edep['deprel']):
                 # We do not include 'i' in the list of redundant prefixes because we want to preserve 'i když' (but we want to discard the other combinations).
-                edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|protože|teprve|zejména)_(aby|až|jestliže|když|pokud)$', r'\1:\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|pokud)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):abi$', r'\1:aby', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):ačkoliv$', r'\1:ačkoli', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):jak_aby$', r'\1:jak', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):jak_ad$', r'\1:jak', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):jakkoliv$', r'\1:jakkoli', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):jako_kupříkladu$', r'\1:jako', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):jakoby$', r'\1:jako', edep['deprel']) # these instances in FicTree should be spelled 'jako by'
                 edep['deprel'] = re.sub(r'^(advcl):jelikož_do$', r'\1:jelikož', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):jestli_že$', r'\1:jestliže', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl):k$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):kdykoliv$', r'\1:kdykoli', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:k$', r'obl:k:dat', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):kdy$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):kdykoliv$', r'\1:kdykoli', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):liž$', r'\1:li', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:místo$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
+                edep['deprel'] = re.sub(r'^acl:na_způsob$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
                 edep['deprel'] = re.sub(r'^(advcl):neboť$', r'\1', edep['deprel']) # 'neboť' is coordinating
                 edep['deprel'] = re.sub(r'^(advcl):nechť$', r'\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl):od$', r'nmod:od:gen', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):podle$', r'obl:podle:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):pro$', r'obl:pro:acc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:pro$', r'obl:pro:acc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):takže_a$', r'\1:takže', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl):v$', r'nmod:v:loc', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):v_případ_že$', r'\1:v_případě_že', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):v_duch$', r'obl:v_duchu:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:v_duch$', r'obl:v_duchu:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):zatím_co$', r'\1:zatímco', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):že_ať$', r'\1:ať', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):že_jako$', r'\1:že', edep['deprel'])
                 if edep['deprel'] == 'acl:v' and node.form == 'patře':
@@ -257,9 +266,12 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_z(:gen)?$', r'\1:z:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):až_do(:gen)?$', r'\1:do:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):až_o(:acc)?$', r'\1:o:acc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_ohled_na(:acc)?$', r'\1:bez_ohledu_na:acc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_zřetel_k(:dat)?$', r'\1:bez_zřetele_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_zřetel_na(:acc)?$', r'\1:bez_zřetele_na:acc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):blíž(:dat)?$', r'\1:blízko:dat', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):byť[_:].+$', r'\1:byť', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):cesta:ins$', r'\1:ins', edep['deprel'])
@@ -272,6 +284,7 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):dík(:dat)?$', r'\1:díky:dat', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do:(nom|dat)$', r'\1:do:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_k:dat$', r'\1:k:dat', edep['deprel']) # do maloobchodní sítě (nebo k dalšímu zpracování)
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_oblast(:gen)?$', r'\1:do_oblasti:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_rozpor_s(:ins)?$', r'\1:do_rozporu_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_soulad_s(:ins)?$', r'\1:do_souladu_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):en([_:].+)?$', r'\1', edep['deprel']) # bienvenue en France
@@ -286,19 +299,25 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby_pod:ins$', r'\1:pod:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno:nom$', r'\1:jménem:nom', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno(:gen)?$', r'\1:jménem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):k(:gen)?$', r'\1:k:dat', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):k_konec(:gen)?$', r'\1:ke_konci:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):kol(em)?(:gen)?$', r'\1:kolem:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):konec(:gen)?$', r'\1:koncem:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi:(nom|dat)$', r'\1:mezi:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi_uvnitř:gen$', r'\1:uvnitř:gen', edep['deprel']) # 'nejdou mezi, ale uvnitř odvětví a oborů'
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na(:gen|:nom)$', r'\1:na:acc', edep['deprel']) # 'odložit na 1. září'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_báze(:gen)?$', r'\1:na_bázi:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_čelo(:gen)?$', r'\1:na_čele:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_mimo:loc$', r'\1:na:loc', edep['deprel']) # 'na kurtě i mimo něj'
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_než:acc$', r'\1:na:acc', edep['deprel']) # 'na víc než čtyři a půl kilometru'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_od:acc$', r'\1:na_rozdíl_od:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_podklad(:gen)?$', r'\1:na_podkladě:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_?rozdíl_od(:gen)?$', r'\1:na_rozdíl_od:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_újma(:gen)?$', r'\1:gen', edep['deprel']) # 'nebude na újmu' is a multi-word predicate but 'na újmu' is probably not used as an independent oblique modifier
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_úroveň(:gen)?$', r'\1:na_úrovni:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_úsek(:gen)?$', r'\1:na_úseku:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_základ(:gen)?$', r'\1:na_základě:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_základna(:gen)?$', r'\1:na_základně:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_závěr(:gen)?$', r'\1:na_závěr:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):namísto_do(:gen)?$', r'\1:do:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):následek(:gen)?$', r'\1:následkem:gen', edep['deprel'])
@@ -312,14 +331,17 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):of([_:].+)?$', r'\1', edep['deprel']) # University of North Carolina
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ohledně(:gen)?$', r'\1:ohledně:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):per([_:].+)?$', r'\1', edep['deprel']) # per rollam
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po:nom$', r'\1:po:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po:(nom|gen)$', r'\1:po:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_v:loc$', r'\1:po:loc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_doba(:gen)?$', r'\1:po_dobu:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_vzor(:gen)?$', r'\1:po_vzoru:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):počátek(:gen)?$', r'\1:počátkem:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):počínat(:ins)?$', r'\1:počínaje:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pod_dojem(:gen)?$', r'\1:pod_dojmem:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pod_vliv(:gen)?$', r'\1:pod_vlivem:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pomocí?(:gen)?$', r'\1:pomocí:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):postup(:gen)?$', r'\1:postupem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pouze_v(:loc)?$', r'\1:v:loc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pro:(nom|dat)$', r'\1:pro:acc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):prostřednictvím?(:gen|:ins)?$', r'\1:prostřednictvím:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):proti:nom$', r'\1:proti:dat', edep['deprel'])
@@ -327,6 +349,7 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před:gen$', r'\1:před:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před_během:gen$', r'\1:během:gen', edep['deprel']) # 'před a během utkání'
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před_po:loc$', r'\1:po:loc', edep['deprel']) # 'před a po vyloučení Schindlera'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přes:gen$', r'\1:přes:acc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přestože[_:].+$', r'\1:přestože', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):při_příležitost(:gen)?$', r'\1:při_příležitosti:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):se?:(nom|acc|ins)$', r'\1:s:ins', edep['deprel']) # accusative: 'být s to' should be a fixed expression and it should be the predicate!
@@ -348,6 +371,7 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):společně_s(:ins)?$', r'\1:společně_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):spolu(_s)?(:ins|:dat)?$', r'\1:spolu_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):stranou(:gen|:dat)?$', r'\1:stranou:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):takže[_:].+$', r'\1:takže', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):třebaže[_:].+$', r'\1:třebaže', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):u_příležitost(:gen)?$', r'\1:u_příležitosti:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v:gen$', r'\1:v:loc', edep['deprel'])
@@ -359,7 +383,11 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_důsledek(:gen)?$', r'\1:v_důsledku:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_forma(:gen)?$', r'\1:ve_formě:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_jméno(:gen)?$', r'\1:ve_jménu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_k:dat$', r'\1:k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_kombinace_s(:ins)?$', r'\1:v_kombinaci_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_konfrontace_s(:ins)?$', r'\1:v_konfrontaci_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_kontext_s(:ins)?$', r'\1:v_kontextu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_na:loc$', r'\1:na:loc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_oblast(:gen)?$', r'\1:v_oblasti:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_oblast_s(:ins)?$', r'\1:s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_obor(:gen)?$', r'\1:v_oboru:gen', edep['deprel'])
@@ -376,6 +404,8 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_řada(:gen)?$', r'\1:v_řadě:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_shoda_s(:ins)?$', r'\1:ve_shodě_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_služba(:gen)?$', r'\1:ve_službách:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_směr(:gen)?$', r'\1:ve_směru:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_směr_k(:dat)?$', r'\1:ve_směru_k:dat', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_smysl(:gen)?$', r'\1:ve_smyslu:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_součinnost_s(:ins|:nom)?$', r'\1:v_součinnosti_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_souhlas_s(:ins|:nom)?$', r'\1:v_souhlasu_s:ins', edep['deprel'])
@@ -385,7 +415,8 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spojený_s(:ins)?$', r'\1:ve_spojení_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spojitost_s(:ins)?$', r'\1:ve_spojitosti_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spolupráce_s(:ins)?$', r'\1:ve_spolupráci_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_srovnání_s(:ins)?$', r'\1:ve_srovnání_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_s_spolupráce(:ins)?$', r'\1:ve_spolupráci_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_srovnání_se?(:ins)?$', r'\1:ve_srovnání_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_světlo(:gen)?$', r'\1:ve_světle:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_věc(:gen)?$', r'\1:ve_věci:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_vztah_k(:dat)?$', r'\1:ve_vztahu_k:dat', edep['deprel'])
@@ -393,6 +424,7 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_záležitost(:gen)?$', r'\1:v_záležitosti:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závěr(:gen)?$', r'\1:v_závěru:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závislost_na(:loc)?$', r'\1:v_závislosti_na:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závislost_s(:ins)?$', r'\1:v_závislosti_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_znamení(:gen)?$', r'\1:ve_znamení:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vina(:gen)?$', r'\1:vinou:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vliv(:gen)?$', r'\1:vlivem:gen', edep['deprel'])
@@ -401,11 +433,13 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):voor([_:].+)?$', r'\1', edep['deprel']) # Hoge Raad voor Diamant
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vzhledem(_k)?(:dat)?$', r'\1:vzhledem_k:dat', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:nom$', r'\1:z:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:ins$', r'\1:s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_důvod(:gen)?$', r'\1:z_důvodu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_hledisko(:gen)?$', r'\1:z_hlediska:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_hledisko(:gen|:nom)?$', r'\1:z_hlediska:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_oblast(:gen)?$', r'\1:z_oblasti:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_řada(:gen)?$', r'\1:z_řad:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(ať_)?z_strana(:gen)?$', r'\1:ze_strany:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_nedostatek(:gen)?$', r'\1:z_nedostatku:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_titul(:gen)?$', r'\1:z_titulu:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za:nom$', r'\1:za:acc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_pomoc(:gen)?$', r'\1:za_pomoci:gen', edep['deprel'])

From ba230a6b92cea415606a6f6acb59fc0f2793100e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 3 Jan 2022 15:15:53 +0100
Subject: [PATCH 0483/1374] adding `node.siblings`

Originally, we decided it is not worth of introducing and bloating the API,
but now I saw a usecase for `node.siblings(preceding_only=True)`
(used in a list comprehension, and I think nested list comprehensions are evil).
---
 udapi/core/node.py            | 19 +++++++++++++++++--
 udapi/core/tests/test_node.py |  2 ++
 2 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 5225724e..3d120a52 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -357,10 +357,25 @@ def children(self):
          nodes2 = [n for n in node.children if n.ord > node.ord]
          nodes3 = [n for n in node.children if n.ord < node.ord]
          nodes4 = [n for n in node.children if n.ord < node.ord] + [node]
-        See documentation of ListOfNodes for details.
+        See the documentation of ListOfNodes for details.
         """
         return ListOfNodes(self._children, origin=self)
 
+    @property
+    def siblings(self):
+        """Return a list of dependency sibling nodes.
+
+        When used as a property, `node.siblings` is just a shortcut for:
+         [n for n in node.parent.children if n!=node]
+        However, it is especially helpful when used as a method,
+        so e.g. `node.siblings(preceding_only=True)` stands for
+         [n for n in node.parent.children if n.ord < node.ord]
+        which is something else than
+         node.parent.children(preceding_only=True).
+        See the documentation of ListOfNodes for details.
+        """
+        return ListOfNodes([n for n in self._parent._children if n!=self], origin=self)
+
     @property
     def descendants(self):
         """Return a list of all descendants of the current node.
@@ -380,7 +395,7 @@ def descendants(self):
          nodes2 = [n for n in node.descendants if n.ord > node.ord]
          nodes3 = [n for n in node.descendants if n.ord < node.ord]
          nodes4 = [n for n in node.descendants if n.ord < node.ord] + [node]
-        See documentation of ListOfNodes for details.
+        See the documentation of ListOfNodes for details.
         """
         # The following code is equivalent to
         # ListOfNodes(sorted(self.unordered_descendants()), origin=self)
diff --git a/udapi/core/tests/test_node.py b/udapi/core/tests/test_node.py
index f38ca585..28a45d85 100755
--- a/udapi/core/tests/test_node.py
+++ b/udapi/core/tests/test_node.py
@@ -36,6 +36,8 @@ def test_topology(self):
         self.assertEqual(len(nodes[1].children), 3)
         self.assertEqual(len(nodes[1].children(add_self=True)), 4)
         self.assertEqual(len(nodes[1].children(add_self=1, following_only=1)), 3)
+        self.assertEqual(nodes[2].siblings, [nodes[0], nodes[3]])
+        self.assertEqual(nodes[2].siblings(following_only=True), [nodes[3]])
 
         self.assertEqual(nodes[0].next_node, nodes[1])
         self.assertEqual(nodes[2].prev_node, nodes[1])

From d69299ecc6ea0cc8be53fb4ef240665c527caf61 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 5 Jan 2022 18:45:51 +0100
Subject: [PATCH 0484/1374] fix ZeroDivisionError

---
 udapi/block/corefud/stats.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
index f07c2a27..e39195db 100644
--- a/udapi/block/corefud/stats.py
+++ b/udapi/block/corefud/stats.py
@@ -76,7 +76,7 @@ def process_end(self):
             columns += [('clusters', f"{self.clusters:7,}"),
                         ('clusters_per1k', f"{1000 * self.clusters / total_nodes_nonzero:6.0f}"),
                         ('longest_cluster', f"{self.longest_cluster:6}"),
-                        ('avg_cluster', f"{self.counter['c_total_len'] / self.clusters:5.1f}")]
+                        ('avg_cluster', f"{self.counter['c_total_len'] / clusters_nonzero:5.1f}")]
             for i in range(1, self.c_len_max + 1):
                 percent = 100 * self.counter[f"c_len_{i}"] / clusters_nonzero
                 columns.append((f"c_len_{i}{'' if i < self.c_len_max else '+'}", f"{percent:5.1f}"))
@@ -84,7 +84,7 @@ def process_end(self):
             columns += [('mentions', f"{self.mentions:7,}"),
                         ('mentions_per1k', f"{1000 * self.mentions / total_nodes_nonzero:6.0f}"),
                         ('longest_mention', f"{self.longest_mention:6}"),
-                        ('avg_mention', f"{self.counter['m_total_len'] / self.mentions:5.1f}")]
+                        ('avg_mention', f"{self.counter['m_total_len'] / mentions_nonzero:5.1f}")]
             for i in range(0, self.m_len_max + 1):
                 percent = 100 * self.counter[f"m_len_{i}"] / mentions_nonzero
                 columns.append((f"m_len_{i}{'' if i < self.m_len_max else '+'}", f"{percent:5.1f}"))

From 3d6a267123de3e505cee6a6821ffd028d8725615 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 5 Jan 2022 19:00:07 +0100
Subject: [PATCH 0485/1374] read.OldCorefUD and write.CorefUD for the old
 CorefUD 0.1 format

---
 udapi/block/read/oldcorefud.py  | 81 +++++++++++++++++++++++++++++++++
 udapi/block/write/oldcorefud.py | 58 +++++++++++++++++++++++
 2 files changed, 139 insertions(+)
 create mode 100644 udapi/block/read/oldcorefud.py
 create mode 100644 udapi/block/write/oldcorefud.py

diff --git a/udapi/block/read/oldcorefud.py b/udapi/block/read/oldcorefud.py
new file mode 100644
index 00000000..a7bc3101
--- /dev/null
+++ b/udapi/block/read/oldcorefud.py
@@ -0,0 +1,81 @@
+"""Reader for CoNLL-U files with the old CorefUD 0.1 style of coreference annotation."""
+import re
+import logging
+import udapi.block.read.conllu
+from udapi.core.coref import CorefCluster, CorefMention, BridgingLinks
+
+class OldCorefUD(udapi.block.read.conllu.Conllu):
+
+    def process_document(self, doc, strict=True):
+        super().process_document(doc)
+
+        clusters = {}
+        for node in doc.nodes_and_empty:
+            index, index_str = 0, ""
+            cluster_id = node.misc["ClusterId"]
+            if not cluster_id:
+                index, index_str = 1, "[1]"
+                cluster_id = node.misc["ClusterId[1]"]
+            while cluster_id:
+                cluster = clusters.get(cluster_id)
+                if cluster is None:
+                    cluster = CorefCluster(cluster_id)
+                    clusters[cluster_id] = cluster
+                mention = CorefMention(node, cluster)
+                if node.misc["MentionSpan" + index_str]:
+                    mention.span = node.misc["MentionSpan" + index_str]
+                else:
+                    mention.words = [node]
+                cluster_type = node.misc["ClusterType" + index_str]
+                if cluster_type is not None:
+                    if cluster.cluster_type is not None and cluster_type != cluster.cluster_type:
+                        logging.warning(f"cluster_type mismatch in {node}: {cluster.cluster_type} != {cluster_type}")
+                    cluster.cluster_type = cluster_type
+
+                bridging_str = node.misc["Bridging" + index_str]
+                if bridging_str:
+                    mention._bridging = BridgingLinks(mention, bridging_str, clusters, strict)
+
+                split_ante_str = node.misc["SplitAnte" + index_str]
+                if split_ante_str:
+                    split_antes = []
+                    # TODO in CorefUD draft "+" was used as the separator, but it was changed to comma.
+                    # We can delete `.replace('+', ',')` once there are no more data with the legacy plus separator.
+                    for ante_str in split_ante_str.replace('+', ',').split(','):
+                        if ante_str in clusters:
+                            if ante_str == cluster_id:
+                                _error("SplitAnte cannot self-reference the same cluster: " + cluster_id, strict)
+                            split_antes.append(clusters[ante_str])
+                        else:
+                            # split cataphora, e.g. "We, that is you and me..."
+                            ante_cl = CorefCluster(ante_str)
+                            clusters[ante_str] = ante_cl
+                            split_antes.append(ante_cl)
+                    cluster.split_ante = sorted(split_antes)
+
+                mention.misc = node.misc["MentionMisc" + index_str]
+                index += 1
+                index_str = f"[{index}]"
+                cluster_id = node.misc["ClusterId" + index_str]
+        # c=doc.coref_clusters should be sorted, so that c[0] < c[1] etc.
+        # In other words, the dict should be sorted by the values (according to CorefCluster.__lt__),
+        # not by the keys (cluster_id).
+        # In Python 3.7+ (3.6+ in CPython), dicts are guaranteed to be insertion order.
+        for cluster in clusters.values():
+            if not cluster._mentions:
+                _error(f"Cluster {cluster.cluster_id} referenced in SplitAnte or Bridging, but not defined with ClusterId", strict)
+            cluster._mentions.sort()
+        doc._coref_clusters = {c._cluster_id: c for c in sorted(clusters.values())}
+
+        # Delete all old-style attributes from MISC (so when converting old to new style, the old attributes are deleted).
+        attrs = "ClusterId MentionSpan ClusterType Bridging SplitAnte MentionMisc".split()
+        for node in doc.nodes_and_empty:
+            for key in list(node.misc):
+                if any(re.match(attr + r'(\[\d+\])?$', key) for attr in attrs):
+                    del node.misc[key]
+
+
+def _error(msg, strict):
+    if strict:
+        raise ValueError(msg)
+    logging.error(msg)
diff --git a/udapi/block/write/oldcorefud.py b/udapi/block/write/oldcorefud.py
new file mode 100644
index 00000000..c6c38cbe
--- /dev/null
+++ b/udapi/block/write/oldcorefud.py
@@ -0,0 +1,58 @@
+"""Writer for CoNLL-U files with the old CorefUD 0.1 style of coreference annotation."""
+import re
+import logging
+import udapi.block.write.conllu
+
+class OldCorefUD(udapi.block.write.conllu.Conllu):
+
+    def process_document(self, doc):
+        if not doc._coref_clusters:
+            logging.warning("Using write.OldCorefUD on a document without any coreference annotation")
+            doc._coref_clusters = {}
+
+        # Delete both new-style (GUM-style) and old-style (CorefUD 0.1) coreference annotations from MISC.
+        attrs = "Entity Split Bridge ClusterId MentionSpan ClusterType Bridging SplitAnte MentionMisc".split()
+        for node in doc.nodes_and_empty:
+            for key in list(node.misc):
+                if any(re.match(attr + r'(\[\d+\])?$', key) for attr in attrs):
+                    del node.misc[key]
+
+        # doc._coref_clusters is a dict, which is insertion ordered in Python 3.7+.
+        # The insertion order is sorted according to CorefCluster.__lt__ (see few lines above).
+        # However, new clusters could be added meanwhile or some clusters edited,
+        # so we need to sort the clusters again before storing to MISC.
+        # We also need to mare sure cluster.mentions are sorted in each cluster
+        # because the ordering of clusters is defined by the first mention in each cluster.
+        # Ordering of mentions within a cluster can be changed when e.g. changing the span
+        # of a given mention or reordering words within a sentence and in such events
+        # Udapi currently does not automatically update the ordering of clusters.
+        for cluster in doc._coref_clusters.values():
+            cluster._mentions.sort()
+        for cluster in sorted(doc._coref_clusters.values()):
+            for mention in cluster.mentions:
+                head = mention.head
+                if head.misc["ClusterId"]:
+                    for a in attrs:
+                        if head.misc[a]:
+                            head.misc[a + "[1]"] = head.misc[a]
+                            del head.misc[a]
+                    index_str = "[2]"
+                else:
+                    index, index_str = 1, "[1]"
+                    while(head.misc["ClusterId" + index_str]):
+                        index += 1
+                        index_str = f"[{index}]"
+                    if index == 1:
+                        index_str = ""
+                head.misc["ClusterId" + index_str] = cluster.cluster_id
+                head.misc["MentionSpan" + index_str] = mention.span
+                head.misc["ClusterType" + index_str] = cluster.cluster_type
+                if mention._bridging:
+                    head.misc["Bridging" + index_str] = str(mention.bridging)
+                if cluster.split_ante:
+                    serialized = ','.join((c.cluster_id for c in sorted(cluster.split_ante)))
+                    head.misc["SplitAnte" + index_str] = serialized
+                if mention.misc:
+                    head.misc["MentionMisc" + index_str] = mention.misc
+
+        super().process_document(doc)

From d37dd68feda69ba5d1b52de5e146bb974ee4be95 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 6 Jan 2022 22:17:51 +0100
Subject: [PATCH 0486/1374] util.Eval coref_cluster='...' coref_mention='...'

We could use `util.Eval doc='for c in doc.coref_clusters.values():...'`,
but it was difficult to fit a bit more difficult code into such oneline.
So I've added these two new parameters and now we can write e.g.

udapy \
 util.Eval coref_cluster='print($.cluster_id)' \
 coref_mention='print(" ".join(w.form for w in $.words))
---
 udapi/block/util/eval.py | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/udapi/block/util/eval.py b/udapi/block/util/eval.py
index b814b80d..07eab681 100644
--- a/udapi/block/util/eval.py
+++ b/udapi/block/util/eval.py
@@ -29,6 +29,7 @@ class Eval(Block):
     # pylint: disable=too-many-arguments,too-many-instance-attributes
     def __init__(self, doc=None, bundle=None, tree=None, node=None, start=None, end=None,
                  before_doc=None, after_doc=None, before_bundle=None, after_bundle=None,
+                 coref_mention=None, coref_cluster=None,
                  expand_code=True, **kwargs):
         super().__init__(**kwargs)
         self.doc = doc
@@ -41,6 +42,8 @@ def __init__(self, doc=None, bundle=None, tree=None, node=None, start=None, end=
         self.after_doc = after_doc
         self.before_bundle = before_bundle
         self.after_bundle = after_bundle
+        self.coref_mention = coref_mention
+        self.coref_cluster = coref_cluster
         self.expand_code = expand_code
         self.count = collections.Counter()
 
@@ -71,6 +74,16 @@ def process_document(self, document):
                 # TODO if self._should_process_bundle(bundle):
                 self.process_bundle(bundle)
 
+        if self.coref_cluster or self.coref_mention:
+            for cluster in doc.coref_clusters.values():
+                if self.coref_cluster:
+                    this = cluster
+                    exec(self.expand_eval_code(self.coref_cluster))
+                if self.coref_mention:
+                    for mention in cluster.mentions:
+                        this = mention
+                        exec(self.expand_eval_code(self.coref_mention))
+
     def process_bundle(self, bundle):
         # Extract variables, so they can be used in eval code
         document = doc = bundle.document

From f7f665e6e6868481f4f06d77b08072a134368e30 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Jan 2022 13:50:47 +0100
Subject: [PATCH 0487/1374] Same block as for Czech: fix case-enhanced deprels
 in Slovak.

---
 udapi/block/ud/sk/fixedeprels.py | 537 +++++++++++++++++++++++++++++++
 1 file changed, 537 insertions(+)
 create mode 100644 udapi/block/ud/sk/fixedeprels.py

diff --git a/udapi/block/ud/sk/fixedeprels.py b/udapi/block/ud/sk/fixedeprels.py
new file mode 100644
index 00000000..6144a29b
--- /dev/null
+++ b/udapi/block/ud/sk/fixedeprels.py
@@ -0,0 +1,537 @@
+"""Block to fix case-enhanced dependency relations in Slovak."""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixEdeprels(Block):
+
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):aby_na:loc$', r'\1:na:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ač([_:].+)?$', r'\1:ač', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ačkoliv?([_:].+)?$', r'\1:ačkoli', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(jak_)?ad([_:].+)?$', r'\1', edep['deprel']) # ad infinitum
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_v(:loc)?$', r'\1:v:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_z(:gen)?$', r'\1:z:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):až_do(:gen)?$', r'\1:do:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):až_o(:acc)?$', r'\1:o:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_ohled_na(:acc)?$', r'\1:bez_ohledu_na:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_zřetel_k(:dat)?$', r'\1:bez_zřetele_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_zřetel_na(:acc)?$', r'\1:bez_zřetele_na:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):blíž(:dat)?$', r'\1:blízko:dat', edep['deprel'])
+
+    # Secondary prepositions sometimes have the lemma of the original part of
+    # speech. We want the grammaticalized form instead. List even those that
+    # will have the same lexical form, as we also want to check the morphological
+    # case. And include all other prepositions that have unambiguous morphological
+    # case, even if they are not secondary.
+    unambiguous = {
+        'do':              'do:gen',
+        'k':               'k:dat',
+        'mimo':            'mimo:gen',
+        'na_rozdiel_od':   'na_rozdiel_od:gen',
+        'na_základ':       'na_základe:gen',
+        'pomoc':           'pomocou:gen',
+        'pre':             'pre:acc',
+        'prostredníctvom': 'prostredníctvom:gen',
+        's':               's:ins',
+        's_dôraz_na':      's_dôrazom_na:acc',
+        's_ohľad_na':      's_ohľadom_na:acc',
+        's_pomoc':         's_pomocou:gen',
+        'smer_k':          'smerom_k:dat',
+        'spoločne_s':      'spoločne_s:ins',
+        'spolu_s':         'spolu_s:ins',
+        'v_dôsledok':      'v_dôsledku:gen',
+        'v_meno':          'v_mene:gen',
+        'v_oblasť':        'v_oblasti:gen',
+        'v_porovnanie_s':  'v_porovnaniu_s:ins',
+        'v_priebeh':       'v_priebehu:gen',
+        'v_prípad':        'v_prípade:gen',
+        'v_prospech':      'v_prospech:gen',
+        'v_rámec':         'v_rámci:gen',
+        'v_spolupráca_s':  'v_spolupráci_s:ins',
+        'v_súlad_s':       'v_súlade_s:ins',
+        'v_súvislosť_s':   'v_súvislosti_s:ins',
+        'v_ústrety':       'v_ústrety:dat',
+        'v_vzťah_k':       'vo_vzťahu_k:dat',
+        'v_závislosť_na':  'v_závislosti_na:loc',
+        'vzhľad_na':       'vzhľadom_na:acc',
+        'z':               'z:gen',
+        'z_hľadisko':      'z_hľadiska:gen',
+        'začiatkom':       'začiatkom:gen'
+    }
+
+    def process_node(self, node):
+        """
+        Occasionally the edeprels automatically derived from the Slovak basic
+        trees do not match the whitelist. For example, the noun is an
+        abbreviation and its morphological case is unknown.
+        """
+        for edep in node.deps:
+            for x, xnorm in unambiguous:
+                # All secondary prepositions have only one fixed morphological case
+                # they appear with, so we can replace whatever case we encounter with the correct one.
+                m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl):'+x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?$', edep['deprel'])
+                if m:
+                    edep['deprel'] = m.group(0)+':'+xnorm
+                    break
+            if re.match(r'^(acl|advcl):', edep['deprel']):
+                # We do not include 'i' in the list of redundant prefixes because we want to preserve 'i když' (but we want to discard the other combinations).
+                edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):abi$', r'\1:aby', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):ačkoliv$', r'\1:ačkoli', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):jak_aby$', r'\1:jak', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):jak_ad$', r'\1:jak', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):jakkoliv$', r'\1:jakkoli', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):jako_kupříkladu$', r'\1:jako', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):jakoby$', r'\1:jako', edep['deprel']) # these instances in FicTree should be spelled 'jako by'
+                edep['deprel'] = re.sub(r'^(advcl):jelikož_do$', r'\1:jelikož', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):jestli_že$', r'\1:jestliže', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl):k$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:k$', r'obl:k:dat', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):kdy$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):kdykoliv$', r'\1:kdykoli', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):liž$', r'\1:li', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:místo$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
+                edep['deprel'] = re.sub(r'^acl:na_způsob$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
+                edep['deprel'] = re.sub(r'^(advcl):neboť$', r'\1', edep['deprel']) # 'neboť' is coordinating
+                edep['deprel'] = re.sub(r'^(advcl):nechť$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl):od$', r'nmod:od:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):podle$', r'obl:podle:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:pro$', r'obl:pro:acc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):takže_a$', r'\1:takže', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl):v$', r'nmod:v:loc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):v_případ_že$', r'\1:v_případě_že', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:v_duch$', r'obl:v_duchu:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):zatím_co$', r'\1:zatímco', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):že_ať$', r'\1:ať', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):že_jako$', r'\1:že', edep['deprel'])
+                if edep['deprel'] == 'acl:v' and node.form == 'patře':
+                    edep['deprel'] = 'nmod:v:loc'
+                    node.deprel = 'nmod'
+                    node.lemma = 'patro'
+                    node.upos = 'NOUN'
+                    node.xpos = 'NNNS6-----A----'
+                    node.feats['Aspect'] = ''
+                    node.feats['Gender'] = 'Neut'
+                    node.feats['Tense'] = ''
+                    node.feats['VerbForm'] = ''
+                    node.feats['Voice'] = ''
+                edep['deprel'] = re.sub(r'^advcl:(od|do)$', r'obl:\1:gen', edep['deprel'])
+            elif re.match(r'^(nmod|obl):', edep['deprel']):
+                if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
+                    # This is a same-case noun-noun modifier, which just happens to be in the locative.
+                    # For example, 'v Ostravě-Porubě', 'Porubě' is attached to 'Ostravě', 'Ostravě' has
+                    # nmod:v:loc, which is OK, but for 'Porubě' the case does not say anything significant.
+                    edep['deprel'] = 'nmod'
+                elif edep['deprel'] == 'obl:loc':
+                    # Annotation error. The first occurrence in PDT dev:
+                    # 'V Rapaportu, ceníku Antverpské burzy i Diamantberichtu jsou uvedeny ceny...'
+                    # The preposition 'V' should modify coordination 'Rapaportu i Diamantberichtu'.
+                    # However, 'Rapaportu' is attached as 'obl' to 'Diamantberichtu'.
+                    edep['deprel'] = 'obl:v:loc'
+                elif edep['deprel'] == 'obl:arg:loc':
+                    # Annotation error. The first occurrence in PDT dev:
+                    edep['deprel'] = 'obl:arg:na:loc'
+                elif edep['deprel'] == 'nmod:loc':
+                    # 'působil v kanadském Edmontonu Oilers', 'Edmontonu' attached to 'Oilers' and not vice versa.
+                    edep['deprel'] = 'nmod:nom'
+                elif edep['deprel'] == 'obl:nom' or edep['deprel'] == 'obl:voc':
+                    # Possibly an annotation error, nominative should be accusative, and the nominal should be direct object?
+                    # However, there seems to be a great variability in the causes, some are subjects and many are really obliques, so let's go just with 'obl' for now.
+                    edep['deprel'] = 'obl'
+                elif edep['deprel'] == 'nmod:voc':
+                    # 'v 8. čísle tiskoviny Ty rudá krávo'
+                    edep['deprel'] = 'nmod:nom'
+                elif re.match(r'^(nmod|obl(:arg)?):během$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):bez$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif edep['deprel'] == 'nmod:co:nom':
+                    # Annotation error: 'kompatibilní znamená tolik co slučitelný'
+                    # 'co' should be relative pronoun rather than subordinating conjunction.
+                    edep['deprel'] = 'acl:relcl'
+                    node.deprel = 'acl:relcl'
+                elif re.match(r'^(nmod|obl(:arg)?):díky$', edep['deprel']):
+                    edep['deprel'] += ':dat'
+                elif re.match(r'^(nmod|obl(:arg)?):dle$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):do$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):k(:nom)?$', edep['deprel']):
+                    edep['deprel'] = re.sub(r':nom$', '', edep['deprel']) + ':dat'
+                elif re.match(r'^(nmod|obl(:arg)?):kolem$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):kromě$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(obl(:arg)?):li$', edep['deprel']):
+                    edep['deprel'] = 'advcl:li'
+                elif re.match(r'^(nmod|obl(:arg)?):mezi$', edep['deprel']):
+                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):mimo$', edep['deprel']):
+                    edep['deprel'] += ':acc'
+                elif re.match(r'^(nmod|obl(:arg)?):místo$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^obl:místo_za:acc$', edep['deprel']):
+                    # 'chytají krávu místo za rohy spíše za ocas'
+                    # This should be treated as coordination; 'místo' and 'spíše' are adverbs (???); 'case' for 'místo' does not seem to be the optimal solution.
+                    for c in node.children:
+                        if c.form == 'místo':
+                            c.upos = 'ADV'
+                            c.deprel = 'cc'
+                    edep['deprel'] = 'obl:za:acc'
+                elif re.match(r'^(nmod|obl(:arg)?):místo[_:].+$', edep['deprel']) and not re.match(r'^(nmod|obl(:arg)?):místo_aby$', edep['deprel']):
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):místo[_:].+$', r'\1:místo:gen', edep['deprel'])
+                elif re.match(r'^(nmod|obl(:arg)?):na$', edep['deprel']):
+                    # The case is unknown. We need 'acc' or 'loc'.
+                    # The locative is probably more frequent but it is not so likely with every noun.
+                    # If there is an nummod:gov child, it must be accusative and not locative.
+                    # (The case would be taken from the number but if it is expressed as digits, it does not have the case feature.)
+                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    elif re.match(r'^(adresát|AIDS|DEM|frank|h|ha|hodina|Honolulu|jméno|koruna|litr|metr|míle|miliarda|milión|mm|MUDr|NATO|obyvatel|OSN|počet|procento|příklad|rok|SSSR|vůz)$', node.lemma):
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':loc'
+                elif re.match(r'^obl:arg:na_konec$', edep['deprel']):
+                    # Annotation error. It should have been two prepositional phrases: 'snížil na 225 tisíc koncem minulého roku'
+                    edep['deprel'] = 'obl:arg:na:acc'
+                elif re.match(r'^(nmod|obl(:arg)?):nad$', edep['deprel']):
+                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):namísto$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):navzdory$', edep['deprel']):
+                    edep['deprel'] += ':dat'
+                elif re.match(r'^(nmod|obl(:arg)?):o$', edep['deprel']):
+                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':loc'
+                elif re.match(r'^(nmod|obl(:arg)?):od$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):ohled_na:ins$', edep['deprel']):
+                    # Annotation error.
+                    if node.form == 's':
+                        ohled = node.next_node
+                        na = ohled.next_node
+                        noun = na.next_node
+                        self.set_basic_and_enhanced(noun, node.parent, 'obl', 'obl:s_ohledem_na:acc')
+                        self.set_basic_and_enhanced(ohled, node, 'fixed', 'fixed')
+                        self.set_basic_and_enhanced(na, node, 'fixed', 'fixed')
+                        self.set_basic_and_enhanced(node, noun, 'case', 'case')
+                elif re.match(r'^(nmod|obl(:arg)?):okolo$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):oproti$', edep['deprel']):
+                    edep['deprel'] += ':dat'
+                elif re.match(r'^nmod:pára:nom$', edep['deprel']):
+                    # Annotation error: 'par excellence'.
+                    edep['deprel'] = 'nmod'
+                    for c in node.children:
+                        if c.udeprel == 'case' and c.form.lower() == 'par':
+                            c.lemma = 'par'
+                            c.upos = 'ADP'
+                            c.xpos = 'RR--X----------'
+                            c.feats['Case'] = ''
+                            c.feats['Gender'] = ''
+                            c.feats['Number'] = ''
+                            c.feats['Polarity'] = ''
+                            c.feats['AdpType'] = 'Prep'
+                elif re.match(r'^(nmod|obl(:arg)?):po$', edep['deprel']):
+                    ###!!! Taky bychom se mohli dívat do XPOS předložky, protože tam bude pád uveden!
+                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':loc'
+                elif re.match(r'^(nmod|obl(:arg)?):poblíž$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):pod$', edep['deprel']):
+                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):podle$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):pro$', edep['deprel']):
+                    edep['deprel'] += ':acc'
+                elif re.match(r'^(nmod|obl(:arg)?):proti$', edep['deprel']):
+                    edep['deprel'] += ':dat'
+                elif re.match(r'^(nmod|obl(:arg)?):před$', edep['deprel']):
+                    # Accusative would be possible but unlikely.
+                    edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):přes$', edep['deprel']):
+                    edep['deprel'] += ':acc'
+                elif re.match(r'^(nmod|obl(:arg)?):při$', edep['deprel']):
+                    edep['deprel'] += ':loc'
+                elif re.match(r'^(nmod|obl(:arg)?):s$', edep['deprel']):
+                    # Genitive would be possible but unlikely.
+                    edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):skrz$', edep['deprel']):
+                    edep['deprel'] += ':acc'
+                elif re.match(r'^(nmod|obl(:arg)?):u$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):uprostřed$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):uvnitř$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):v_s(:loc)?$', edep['deprel']) and node.form == 'spolupráci':
+                    # Annotation error. 'Ve spolupráci s' should be analyzed as a multi-word preposition.
+                    # Find the content nominal.
+                    cnouns = [x for x in node.children if x.ord > node.ord and re.match(r'^(nmod|obl)', x.udeprel)]
+                    vs = [x for x in node.children if x.ord < node.ord and x.lemma == 'v']
+                    if len(cnouns) > 0 and len(vs) > 0:
+                        logging.info('I am here.')
+                        cnoun = cnouns[0]
+                        v = vs[0]
+                        self.set_basic_and_enhanced(cnoun, node.parent, 'obl', 'obl:ve_spolupráci_s:ins')
+                        self.set_basic_and_enhanced(v, cnoun, 'case', 'case')
+                        self.set_basic_and_enhanced(node, v, 'fixed', 'fixed')
+                elif re.match(r'^(nmod|obl(:arg)?):v(:nom)?$', edep['deprel']):
+                    # ':nom' occurs in 'karneval v Rio de Janeiro'
+                    edep['deprel'] = re.sub(r':nom$', '', edep['deprel'])
+                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':loc'
+                elif re.match(r'^obl:v_čel[eo]_s:ins$', edep['deprel']):
+                    # There is just one occurrence and it is an error:
+                    # 'Předloňský kůň roku Law Soziri šel již v Lahovickém oblouku v čele s Raddelliosem a tato dvojice také nakonec zahanbila ostatní soupeře...'
+                    # There should be two independent oblique modifiers, 'v čele' and 's Raddelliosem'.
+                    edep['deprel'] = 'obl:s:ins'
+                elif re.match(r'^(nmod|obl(:arg)?):včetně$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):vedle$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):vůči$', edep['deprel']):
+                    edep['deprel'] += ':dat'
+                elif re.match(r'^(nmod|obl(:arg)?):z$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^(nmod|obl(:arg)?):za$', edep['deprel']):
+                    # Instrumental would be possible but unlikely.
+                    edep['deprel'] += ':acc'
+                else:
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):aby_na:loc$', r'\1:na:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ač([_:].+)?$', r'\1:ač', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ačkoliv?([_:].+)?$', r'\1:ačkoli', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(jak_)?ad([_:].+)?$', r'\1', edep['deprel']) # ad infinitum
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_v(:loc)?$', r'\1:v:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_z(:gen)?$', r'\1:z:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):až_do(:gen)?$', r'\1:do:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):až_o(:acc)?$', r'\1:o:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_ohled_na(:acc)?$', r'\1:bez_ohledu_na:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_zřetel_k(:dat)?$', r'\1:bez_zřetele_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_zřetel_na(:acc)?$', r'\1:bez_zřetele_na:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):blíž(:dat)?$', r'\1:blízko:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):byť[_:].+$', r'\1:byť', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):cesta:ins$', r'\1:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):cesta(:gen)?$', r'\1:cestou:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):co(:nom)?$', r'advmod', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):daleko(:nom)?$', r'\1:nedaleko:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):daleko_od(:gen)?$', r'\1:od:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):de([_:].+)?$', r'\1', edep['deprel']) # de facto
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):di([_:].+)?$', r'\1', edep['deprel']) # Lido di Jesolo
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):dík(:dat)?$', r'\1:díky:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do:(nom|dat)$', r'\1:do:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_k:dat$', r'\1:k:dat', edep['deprel']) # do maloobchodní sítě (nebo k dalšímu zpracování)
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_oblast(:gen)?$', r'\1:do_oblasti:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_rozpor_s(:ins)?$', r'\1:do_rozporu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_soulad_s(:ins)?$', r'\1:do_souladu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):en([_:].+)?$', r'\1', edep['deprel']) # bienvenue en France
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(ať_)?forma(:gen)?$', r'\1:formou:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):i_když[_:].+$', r'\1:i_když', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):in([_:].+)?$', r'\1', edep['deprel']) # made in NHL
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):into([_:].+)?$', r'\1', edep['deprel']) # made in NHL
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jak[_:].+$', r'\1:jak', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakkoliv?[_:].+$', r'\1:jakkoli', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jako[_:].+$', r'\1:jako', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby[_:].+$', r'\1:jako', edep['deprel']) # these instances in FicTree should be spelled 'jako by'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby_pod:ins$', r'\1:pod:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno:nom$', r'\1:jménem:nom', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno(:gen)?$', r'\1:jménem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):k(:gen)?$', r'\1:k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):k_konec(:gen)?$', r'\1:ke_konci:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):kol(em)?(:gen)?$', r'\1:kolem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):konec(:gen)?$', r'\1:koncem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi:(nom|dat)$', r'\1:mezi:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi_uvnitř:gen$', r'\1:uvnitř:gen', edep['deprel']) # 'nejdou mezi, ale uvnitř odvětví a oborů'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na(:gen|:nom)$', r'\1:na:acc', edep['deprel']) # 'odložit na 1. září'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_báze(:gen)?$', r'\1:na_bázi:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_čelo(:gen)?$', r'\1:na_čele:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_mimo:loc$', r'\1:na:loc', edep['deprel']) # 'na kurtě i mimo něj'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_než:acc$', r'\1:na:acc', edep['deprel']) # 'na víc než čtyři a půl kilometru'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_od:acc$', r'\1:na_rozdíl_od:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_podklad(:gen)?$', r'\1:na_podkladě:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_?rozdíl_od(:gen)?$', r'\1:na_rozdíl_od:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_újma(:gen)?$', r'\1:gen', edep['deprel']) # 'nebude na újmu' is a multi-word predicate but 'na újmu' is probably not used as an independent oblique modifier
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_úroveň(:gen)?$', r'\1:na_úrovni:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_úsek(:gen)?$', r'\1:na_úseku:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_základ(:gen)?$', r'\1:na_základě:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_základna(:gen)?$', r'\1:na_základně:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_závěr(:gen)?$', r'\1:na_závěr:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):namísto_do(:gen)?$', r'\1:do:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):následek(:gen)?$', r'\1:následkem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(ne)?daleko(:gen)?$', r'\1:nedaleko:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):než[_:].+$', r'\1:než', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):nežli[_:].+$', r'\1:nežli', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o:(nom|gen|dat)$', r'\1:o:acc', edep['deprel']) # 'zájem o obaly'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o_jako[_:].+$', r'\1:jako', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o_o:acc$', r'\1:o:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):od:(nom|dat)$', r'\1:od:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):of([_:].+)?$', r'\1', edep['deprel']) # University of North Carolina
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ohledně(:gen)?$', r'\1:ohledně:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):per([_:].+)?$', r'\1', edep['deprel']) # per rollam
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po:(nom|gen)$', r'\1:po:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_v:loc$', r'\1:po:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_doba(:gen)?$', r'\1:po_dobu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_vzor(:gen)?$', r'\1:po_vzoru:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):počátek(:gen)?$', r'\1:počátkem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):počínat(:ins)?$', r'\1:počínaje:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pod_dojem(:gen)?$', r'\1:pod_dojmem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pod_vliv(:gen)?$', r'\1:pod_vlivem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pomocí?(:gen)?$', r'\1:pomocí:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):postup(:gen)?$', r'\1:postupem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pouze_v(:loc)?$', r'\1:v:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pro:(nom|dat)$', r'\1:pro:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):prostřednictvím?(:gen|:ins)?$', r'\1:prostřednictvím:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):proti:nom$', r'\1:proti:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):protože[_:].+$', r'\1:protože', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před:gen$', r'\1:před:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před_během:gen$', r'\1:během:gen', edep['deprel']) # 'před a během utkání'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před_po:loc$', r'\1:po:loc', edep['deprel']) # 'před a po vyloučení Schindlera'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přes:gen$', r'\1:přes:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přestože[_:].+$', r'\1:přestože', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):při_příležitost(:gen)?$', r'\1:při_příležitosti:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):se?:(nom|acc|ins)$', r'\1:s:ins', edep['deprel']) # accusative: 'být s to' should be a fixed expression and it should be the predicate!
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_ohled_k(:dat)?$', r'\1:s_ohledem_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_ohled_na(:acc)?$', r'\1:s_ohledem_na:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_pomoc(:gen)?$', r'\1:s_pomocí:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_přihlédnutí_k(:dat)?$', r'\1:s_přihlédnutím_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_přihlédnutí_na(:acc)?$', r'\1:s_přihlédnutím_na:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_výjimka(:gen)?$', r'\1:s_výjimkou:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_vyloučení(:gen)?$', r'\1:s_vyloučením:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_zřetel_k(:dat)?$', r'\1:se_zřetelem_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_zřetel_na(:acc)?$', r'\1:se_zřetelem_na:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):severně_od(:gen)?$', r'\1:od:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):shoda(:gen)?$', r'\1', edep['deprel']) # 'shodou okolností' is not a prepositional phrase
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_do(:gen)?$', r'\1:směrem_do:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_k(:dat)?$', r'\1:směrem_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_na(:acc)?$', r'\1:směrem_na:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_od(:gen)?$', r'\1:směrem_od:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):společně_s(:ins)?$', r'\1:společně_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):spolu(_s)?(:ins|:dat)?$', r'\1:spolu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):stranou(:gen|:dat)?$', r'\1:stranou:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):takže[_:].+$', r'\1:takže', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):třebaže[_:].+$', r'\1:třebaže', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):u_příležitost(:gen)?$', r'\1:u_příležitosti:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v:gen$', r'\1:v:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_analogie_s(:ins)?$', r'\1:v_analogii_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_čelo(:gen)?$', r'\1:v_čele:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_čelo_s(:ins)?$', r'\1:v_čele_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_dohoda_s(:ins)?$', r'\1:v_dohodě_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_duch(:gen)?$', r'\1:v_duchu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_důsledek(:gen)?$', r'\1:v_důsledku:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_forma(:gen)?$', r'\1:ve_formě:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_jméno(:gen)?$', r'\1:ve_jménu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_k:dat$', r'\1:k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_kombinace_s(:ins)?$', r'\1:v_kombinaci_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_konfrontace_s(:ins)?$', r'\1:v_konfrontaci_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_kontext_s(:ins)?$', r'\1:v_kontextu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_na:loc$', r'\1:na:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_oblast(:gen)?$', r'\1:v_oblasti:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_oblast_s(:ins)?$', r'\1:s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_obor(:gen)?$', r'\1:v_oboru:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_otázka(:gen)?$', r'\1:v_otázce:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_podoba(:gen)?$', r'\1:v_podobě:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_poměr_k(:dat)?$', r'\1:v_poměru_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_proces(:gen)?$', r'\1:v_procesu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_prospěch(:gen)?$', r'\1:ve_prospěch:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_protiklad_k(:dat)?$', r'\1:v_protikladu_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_průběh(:gen)?$', r'\1:v_průběhu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_případ(:gen)?$', r'\1:v_případě:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_rámec(:gen)?$', r'\1:v_rámci:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_rozpor_s(:ins)?$', r'\1:v_rozporu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_řada(:gen)?$', r'\1:v_řadě:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_shoda_s(:ins)?$', r'\1:ve_shodě_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_služba(:gen)?$', r'\1:ve_službách:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_směr(:gen)?$', r'\1:ve_směru:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_směr_k(:dat)?$', r'\1:ve_směru_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_smysl(:gen)?$', r'\1:ve_smyslu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_součinnost_s(:ins|:nom)?$', r'\1:v_součinnosti_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_souhlas_s(:ins|:nom)?$', r'\1:v_souhlasu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_soulad_s(:ins|:nom)?$', r'\1:v_souladu_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_souvislost_s(:ins)?$', r'\1:v_souvislosti_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spojení_s(:ins)?$', r'\1:ve_spojení_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spojený_s(:ins)?$', r'\1:ve_spojení_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spojitost_s(:ins)?$', r'\1:ve_spojitosti_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spolupráce_s(:ins)?$', r'\1:ve_spolupráci_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_s_spolupráce(:ins)?$', r'\1:ve_spolupráci_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_srovnání_se?(:ins)?$', r'\1:ve_srovnání_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_světlo(:gen)?$', r'\1:ve_světle:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_věc(:gen)?$', r'\1:ve_věci:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_vztah_k(:dat)?$', r'\1:ve_vztahu_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_zájem(:gen|:loc)?$', r'\1:v_zájmu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_záležitost(:gen)?$', r'\1:v_záležitosti:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závěr(:gen)?$', r'\1:v_závěru:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závislost_na(:loc)?$', r'\1:v_závislosti_na:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závislost_s(:ins)?$', r'\1:v_závislosti_s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_znamení(:gen)?$', r'\1:ve_znamení:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vina(:gen)?$', r'\1:vinou:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vliv(:gen)?$', r'\1:vlivem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vo:acc$', r'\1:o:acc', edep['deprel']) # colloquial: vo všecko
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):von([_:].+)?$', r'\1', edep['deprel']) # von Neumannem
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):voor([_:].+)?$', r'\1', edep['deprel']) # Hoge Raad voor Diamant
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vzhledem(_k)?(:dat)?$', r'\1:vzhledem_k:dat', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:nom$', r'\1:z:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:ins$', r'\1:s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_důvod(:gen)?$', r'\1:z_důvodu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_hledisko(:gen|:nom)?$', r'\1:z_hlediska:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_oblast(:gen)?$', r'\1:z_oblasti:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_řada(:gen)?$', r'\1:z_řad:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(ať_)?z_strana(:gen)?$', r'\1:ze_strany:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_nedostatek(:gen)?$', r'\1:z_nedostatku:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_titul(:gen)?$', r'\1:z_titulu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za:nom$', r'\1:za:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_pomoc(:gen)?$', r'\1:za_pomoci:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_účast(:gen)?$', r'\1:za_účasti:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_účel(:gen)?$', r'\1:za_účelem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):začátek(:gen)?$', r'\1:začátkem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):zásluha(:gen)?$', r'\1:zásluhou:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):závěr(:gen)?$', r'\1:závěrem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):závisle_na(:loc)?$', r'\1:nezávisle_na:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^nmod:že:gen$', 'acl:že', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):že_za:gen$', r'\1:za:gen', edep['deprel'])
+
+    def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
+        '''
+        Modifies the incoming relation of a node both in the basic tree and in
+        the enhanced graph. If the node does not yet depend in the enhanced
+        graph on the current basic parent, the new relation will be added without
+        removing any old one. If the node already depends multiple times on the
+        current basic parent in the enhanced graph, all such enhanced relations
+        will be removed before adding the new one.
+        '''
+        old_parent = node.parent
+        node.parent = parent
+        node.deprel = deprel
+        node.deps = [x for x in node.deps if x['parent'] != old_parent]
+        new_edep = {}
+        new_edep['parent'] = parent
+        new_edep['deprel'] = edeprel
+        node.deps.append(new_edep)

From 830b2fb6a3d2d7e09773842bf4f7d0994bbb5e02 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Jan 2022 13:55:31 +0100
Subject: [PATCH 0488/1374] Removed spurious code.

---
 udapi/block/ud/sk/fixedeprels.py | 458 +------------------------------
 1 file changed, 1 insertion(+), 457 deletions(-)

diff --git a/udapi/block/ud/sk/fixedeprels.py b/udapi/block/ud/sk/fixedeprels.py
index 6144a29b..c235ee78 100644
--- a/udapi/block/ud/sk/fixedeprels.py
+++ b/udapi/block/ud/sk/fixedeprels.py
@@ -5,24 +5,6 @@
 
 class FixEdeprels(Block):
 
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):aby_na:loc$', r'\1:na:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ač([_:].+)?$', r'\1:ač', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ačkoliv?([_:].+)?$', r'\1:ačkoli', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(jak_)?ad([_:].+)?$', r'\1', edep['deprel']) # ad infinitum
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_v(:loc)?$', r'\1:v:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_z(:gen)?$', r'\1:z:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):až_do(:gen)?$', r'\1:do:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):až_o(:acc)?$', r'\1:o:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_ohled_na(:acc)?$', r'\1:bez_ohledu_na:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_zřetel_k(:dat)?$', r'\1:bez_zřetele_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_zřetel_na(:acc)?$', r'\1:bez_zřetele_na:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):blíž(:dat)?$', r'\1:blízko:dat', edep['deprel'])
-
     # Secondary prepositions sometimes have the lemma of the original part of
     # speech. We want the grammaticalized form instead. List even those that
     # will have the same lexical form, as we also want to check the morphological
@@ -34,6 +16,7 @@ class FixEdeprels(Block):
         'mimo':            'mimo:gen',
         'na_rozdiel_od':   'na_rozdiel_od:gen',
         'na_základ':       'na_základe:gen',
+        'od':              'od:gen',
         'pomoc':           'pomocou:gen',
         'pre':             'pre:acc',
         'prostredníctvom': 'prostredníctvom:gen',
@@ -78,445 +61,6 @@ def process_node(self, node):
                 if m:
                     edep['deprel'] = m.group(0)+':'+xnorm
                     break
-            if re.match(r'^(acl|advcl):', edep['deprel']):
-                # We do not include 'i' in the list of redundant prefixes because we want to preserve 'i když' (but we want to discard the other combinations).
-                edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):abi$', r'\1:aby', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):ačkoliv$', r'\1:ačkoli', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):jak_aby$', r'\1:jak', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):jak_ad$', r'\1:jak', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):jakkoliv$', r'\1:jakkoli', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):jako_kupříkladu$', r'\1:jako', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):jakoby$', r'\1:jako', edep['deprel']) # these instances in FicTree should be spelled 'jako by'
-                edep['deprel'] = re.sub(r'^(advcl):jelikož_do$', r'\1:jelikož', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):jestli_že$', r'\1:jestliže', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl):k$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:k$', r'obl:k:dat', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):kdy$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):kdykoliv$', r'\1:kdykoli', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):liž$', r'\1:li', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:místo$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
-                edep['deprel'] = re.sub(r'^acl:na_způsob$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
-                edep['deprel'] = re.sub(r'^(advcl):neboť$', r'\1', edep['deprel']) # 'neboť' is coordinating
-                edep['deprel'] = re.sub(r'^(advcl):nechť$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl):od$', r'nmod:od:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):podle$', r'obl:podle:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:pro$', r'obl:pro:acc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):takže_a$', r'\1:takže', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl):v$', r'nmod:v:loc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):v_případ_že$', r'\1:v_případě_že', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:v_duch$', r'obl:v_duchu:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):zatím_co$', r'\1:zatímco', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):že_ať$', r'\1:ať', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):že_jako$', r'\1:že', edep['deprel'])
-                if edep['deprel'] == 'acl:v' and node.form == 'patře':
-                    edep['deprel'] = 'nmod:v:loc'
-                    node.deprel = 'nmod'
-                    node.lemma = 'patro'
-                    node.upos = 'NOUN'
-                    node.xpos = 'NNNS6-----A----'
-                    node.feats['Aspect'] = ''
-                    node.feats['Gender'] = 'Neut'
-                    node.feats['Tense'] = ''
-                    node.feats['VerbForm'] = ''
-                    node.feats['Voice'] = ''
-                edep['deprel'] = re.sub(r'^advcl:(od|do)$', r'obl:\1:gen', edep['deprel'])
-            elif re.match(r'^(nmod|obl):', edep['deprel']):
-                if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
-                    # This is a same-case noun-noun modifier, which just happens to be in the locative.
-                    # For example, 'v Ostravě-Porubě', 'Porubě' is attached to 'Ostravě', 'Ostravě' has
-                    # nmod:v:loc, which is OK, but for 'Porubě' the case does not say anything significant.
-                    edep['deprel'] = 'nmod'
-                elif edep['deprel'] == 'obl:loc':
-                    # Annotation error. The first occurrence in PDT dev:
-                    # 'V Rapaportu, ceníku Antverpské burzy i Diamantberichtu jsou uvedeny ceny...'
-                    # The preposition 'V' should modify coordination 'Rapaportu i Diamantberichtu'.
-                    # However, 'Rapaportu' is attached as 'obl' to 'Diamantberichtu'.
-                    edep['deprel'] = 'obl:v:loc'
-                elif edep['deprel'] == 'obl:arg:loc':
-                    # Annotation error. The first occurrence in PDT dev:
-                    edep['deprel'] = 'obl:arg:na:loc'
-                elif edep['deprel'] == 'nmod:loc':
-                    # 'působil v kanadském Edmontonu Oilers', 'Edmontonu' attached to 'Oilers' and not vice versa.
-                    edep['deprel'] = 'nmod:nom'
-                elif edep['deprel'] == 'obl:nom' or edep['deprel'] == 'obl:voc':
-                    # Possibly an annotation error, nominative should be accusative, and the nominal should be direct object?
-                    # However, there seems to be a great variability in the causes, some are subjects and many are really obliques, so let's go just with 'obl' for now.
-                    edep['deprel'] = 'obl'
-                elif edep['deprel'] == 'nmod:voc':
-                    # 'v 8. čísle tiskoviny Ty rudá krávo'
-                    edep['deprel'] = 'nmod:nom'
-                elif re.match(r'^(nmod|obl(:arg)?):během$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):bez$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif edep['deprel'] == 'nmod:co:nom':
-                    # Annotation error: 'kompatibilní znamená tolik co slučitelný'
-                    # 'co' should be relative pronoun rather than subordinating conjunction.
-                    edep['deprel'] = 'acl:relcl'
-                    node.deprel = 'acl:relcl'
-                elif re.match(r'^(nmod|obl(:arg)?):díky$', edep['deprel']):
-                    edep['deprel'] += ':dat'
-                elif re.match(r'^(nmod|obl(:arg)?):dle$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):do$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):k(:nom)?$', edep['deprel']):
-                    edep['deprel'] = re.sub(r':nom$', '', edep['deprel']) + ':dat'
-                elif re.match(r'^(nmod|obl(:arg)?):kolem$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):kromě$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(obl(:arg)?):li$', edep['deprel']):
-                    edep['deprel'] = 'advcl:li'
-                elif re.match(r'^(nmod|obl(:arg)?):mezi$', edep['deprel']):
-                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):mimo$', edep['deprel']):
-                    edep['deprel'] += ':acc'
-                elif re.match(r'^(nmod|obl(:arg)?):místo$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^obl:místo_za:acc$', edep['deprel']):
-                    # 'chytají krávu místo za rohy spíše za ocas'
-                    # This should be treated as coordination; 'místo' and 'spíše' are adverbs (???); 'case' for 'místo' does not seem to be the optimal solution.
-                    for c in node.children:
-                        if c.form == 'místo':
-                            c.upos = 'ADV'
-                            c.deprel = 'cc'
-                    edep['deprel'] = 'obl:za:acc'
-                elif re.match(r'^(nmod|obl(:arg)?):místo[_:].+$', edep['deprel']) and not re.match(r'^(nmod|obl(:arg)?):místo_aby$', edep['deprel']):
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):místo[_:].+$', r'\1:místo:gen', edep['deprel'])
-                elif re.match(r'^(nmod|obl(:arg)?):na$', edep['deprel']):
-                    # The case is unknown. We need 'acc' or 'loc'.
-                    # The locative is probably more frequent but it is not so likely with every noun.
-                    # If there is an nummod:gov child, it must be accusative and not locative.
-                    # (The case would be taken from the number but if it is expressed as digits, it does not have the case feature.)
-                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    elif re.match(r'^(adresát|AIDS|DEM|frank|h|ha|hodina|Honolulu|jméno|koruna|litr|metr|míle|miliarda|milión|mm|MUDr|NATO|obyvatel|OSN|počet|procento|příklad|rok|SSSR|vůz)$', node.lemma):
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':loc'
-                elif re.match(r'^obl:arg:na_konec$', edep['deprel']):
-                    # Annotation error. It should have been two prepositional phrases: 'snížil na 225 tisíc koncem minulého roku'
-                    edep['deprel'] = 'obl:arg:na:acc'
-                elif re.match(r'^(nmod|obl(:arg)?):nad$', edep['deprel']):
-                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):namísto$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):navzdory$', edep['deprel']):
-                    edep['deprel'] += ':dat'
-                elif re.match(r'^(nmod|obl(:arg)?):o$', edep['deprel']):
-                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':loc'
-                elif re.match(r'^(nmod|obl(:arg)?):od$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):ohled_na:ins$', edep['deprel']):
-                    # Annotation error.
-                    if node.form == 's':
-                        ohled = node.next_node
-                        na = ohled.next_node
-                        noun = na.next_node
-                        self.set_basic_and_enhanced(noun, node.parent, 'obl', 'obl:s_ohledem_na:acc')
-                        self.set_basic_and_enhanced(ohled, node, 'fixed', 'fixed')
-                        self.set_basic_and_enhanced(na, node, 'fixed', 'fixed')
-                        self.set_basic_and_enhanced(node, noun, 'case', 'case')
-                elif re.match(r'^(nmod|obl(:arg)?):okolo$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):oproti$', edep['deprel']):
-                    edep['deprel'] += ':dat'
-                elif re.match(r'^nmod:pára:nom$', edep['deprel']):
-                    # Annotation error: 'par excellence'.
-                    edep['deprel'] = 'nmod'
-                    for c in node.children:
-                        if c.udeprel == 'case' and c.form.lower() == 'par':
-                            c.lemma = 'par'
-                            c.upos = 'ADP'
-                            c.xpos = 'RR--X----------'
-                            c.feats['Case'] = ''
-                            c.feats['Gender'] = ''
-                            c.feats['Number'] = ''
-                            c.feats['Polarity'] = ''
-                            c.feats['AdpType'] = 'Prep'
-                elif re.match(r'^(nmod|obl(:arg)?):po$', edep['deprel']):
-                    ###!!! Taky bychom se mohli dívat do XPOS předložky, protože tam bude pád uveden!
-                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':loc'
-                elif re.match(r'^(nmod|obl(:arg)?):poblíž$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):pod$', edep['deprel']):
-                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):podle$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):pro$', edep['deprel']):
-                    edep['deprel'] += ':acc'
-                elif re.match(r'^(nmod|obl(:arg)?):proti$', edep['deprel']):
-                    edep['deprel'] += ':dat'
-                elif re.match(r'^(nmod|obl(:arg)?):před$', edep['deprel']):
-                    # Accusative would be possible but unlikely.
-                    edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):přes$', edep['deprel']):
-                    edep['deprel'] += ':acc'
-                elif re.match(r'^(nmod|obl(:arg)?):při$', edep['deprel']):
-                    edep['deprel'] += ':loc'
-                elif re.match(r'^(nmod|obl(:arg)?):s$', edep['deprel']):
-                    # Genitive would be possible but unlikely.
-                    edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):skrz$', edep['deprel']):
-                    edep['deprel'] += ':acc'
-                elif re.match(r'^(nmod|obl(:arg)?):u$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):uprostřed$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):uvnitř$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):v_s(:loc)?$', edep['deprel']) and node.form == 'spolupráci':
-                    # Annotation error. 'Ve spolupráci s' should be analyzed as a multi-word preposition.
-                    # Find the content nominal.
-                    cnouns = [x for x in node.children if x.ord > node.ord and re.match(r'^(nmod|obl)', x.udeprel)]
-                    vs = [x for x in node.children if x.ord < node.ord and x.lemma == 'v']
-                    if len(cnouns) > 0 and len(vs) > 0:
-                        logging.info('I am here.')
-                        cnoun = cnouns[0]
-                        v = vs[0]
-                        self.set_basic_and_enhanced(cnoun, node.parent, 'obl', 'obl:ve_spolupráci_s:ins')
-                        self.set_basic_and_enhanced(v, cnoun, 'case', 'case')
-                        self.set_basic_and_enhanced(node, v, 'fixed', 'fixed')
-                elif re.match(r'^(nmod|obl(:arg)?):v(:nom)?$', edep['deprel']):
-                    # ':nom' occurs in 'karneval v Rio de Janeiro'
-                    edep['deprel'] = re.sub(r':nom$', '', edep['deprel'])
-                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':loc'
-                elif re.match(r'^obl:v_čel[eo]_s:ins$', edep['deprel']):
-                    # There is just one occurrence and it is an error:
-                    # 'Předloňský kůň roku Law Soziri šel již v Lahovickém oblouku v čele s Raddelliosem a tato dvojice také nakonec zahanbila ostatní soupeře...'
-                    # There should be two independent oblique modifiers, 'v čele' and 's Raddelliosem'.
-                    edep['deprel'] = 'obl:s:ins'
-                elif re.match(r'^(nmod|obl(:arg)?):včetně$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):vedle$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):vůči$', edep['deprel']):
-                    edep['deprel'] += ':dat'
-                elif re.match(r'^(nmod|obl(:arg)?):z$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):za$', edep['deprel']):
-                    # Instrumental would be possible but unlikely.
-                    edep['deprel'] += ':acc'
-                else:
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):aby_na:loc$', r'\1:na:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ač([_:].+)?$', r'\1:ač', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ačkoliv?([_:].+)?$', r'\1:ačkoli', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(jak_)?ad([_:].+)?$', r'\1', edep['deprel']) # ad infinitum
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_v(:loc)?$', r'\1:v:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_z(:gen)?$', r'\1:z:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):až_do(:gen)?$', r'\1:do:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):až_o(:acc)?$', r'\1:o:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_ohled_na(:acc)?$', r'\1:bez_ohledu_na:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_zřetel_k(:dat)?$', r'\1:bez_zřetele_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_zřetel_na(:acc)?$', r'\1:bez_zřetele_na:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):blíž(:dat)?$', r'\1:blízko:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):byť[_:].+$', r'\1:byť', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):cesta:ins$', r'\1:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):cesta(:gen)?$', r'\1:cestou:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):co(:nom)?$', r'advmod', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):daleko(:nom)?$', r'\1:nedaleko:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):daleko_od(:gen)?$', r'\1:od:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):de([_:].+)?$', r'\1', edep['deprel']) # de facto
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):di([_:].+)?$', r'\1', edep['deprel']) # Lido di Jesolo
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):dík(:dat)?$', r'\1:díky:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do:(nom|dat)$', r'\1:do:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_k:dat$', r'\1:k:dat', edep['deprel']) # do maloobchodní sítě (nebo k dalšímu zpracování)
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_oblast(:gen)?$', r'\1:do_oblasti:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_rozpor_s(:ins)?$', r'\1:do_rozporu_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_soulad_s(:ins)?$', r'\1:do_souladu_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):en([_:].+)?$', r'\1', edep['deprel']) # bienvenue en France
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(ať_)?forma(:gen)?$', r'\1:formou:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):i_když[_:].+$', r'\1:i_když', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):in([_:].+)?$', r'\1', edep['deprel']) # made in NHL
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):into([_:].+)?$', r'\1', edep['deprel']) # made in NHL
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jak[_:].+$', r'\1:jak', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakkoliv?[_:].+$', r'\1:jakkoli', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jako[_:].+$', r'\1:jako', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby[_:].+$', r'\1:jako', edep['deprel']) # these instances in FicTree should be spelled 'jako by'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby_pod:ins$', r'\1:pod:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno:nom$', r'\1:jménem:nom', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno(:gen)?$', r'\1:jménem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):k(:gen)?$', r'\1:k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):k_konec(:gen)?$', r'\1:ke_konci:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):kol(em)?(:gen)?$', r'\1:kolem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):konec(:gen)?$', r'\1:koncem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi:(nom|dat)$', r'\1:mezi:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi_uvnitř:gen$', r'\1:uvnitř:gen', edep['deprel']) # 'nejdou mezi, ale uvnitř odvětví a oborů'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na(:gen|:nom)$', r'\1:na:acc', edep['deprel']) # 'odložit na 1. září'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_báze(:gen)?$', r'\1:na_bázi:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_čelo(:gen)?$', r'\1:na_čele:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_mimo:loc$', r'\1:na:loc', edep['deprel']) # 'na kurtě i mimo něj'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_než:acc$', r'\1:na:acc', edep['deprel']) # 'na víc než čtyři a půl kilometru'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_od:acc$', r'\1:na_rozdíl_od:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_podklad(:gen)?$', r'\1:na_podkladě:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_?rozdíl_od(:gen)?$', r'\1:na_rozdíl_od:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_újma(:gen)?$', r'\1:gen', edep['deprel']) # 'nebude na újmu' is a multi-word predicate but 'na újmu' is probably not used as an independent oblique modifier
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_úroveň(:gen)?$', r'\1:na_úrovni:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_úsek(:gen)?$', r'\1:na_úseku:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_základ(:gen)?$', r'\1:na_základě:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_základna(:gen)?$', r'\1:na_základně:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_závěr(:gen)?$', r'\1:na_závěr:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):namísto_do(:gen)?$', r'\1:do:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):následek(:gen)?$', r'\1:následkem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(ne)?daleko(:gen)?$', r'\1:nedaleko:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):než[_:].+$', r'\1:než', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):nežli[_:].+$', r'\1:nežli', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o:(nom|gen|dat)$', r'\1:o:acc', edep['deprel']) # 'zájem o obaly'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o_jako[_:].+$', r'\1:jako', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o_o:acc$', r'\1:o:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):od:(nom|dat)$', r'\1:od:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):of([_:].+)?$', r'\1', edep['deprel']) # University of North Carolina
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ohledně(:gen)?$', r'\1:ohledně:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):per([_:].+)?$', r'\1', edep['deprel']) # per rollam
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po:(nom|gen)$', r'\1:po:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_v:loc$', r'\1:po:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_doba(:gen)?$', r'\1:po_dobu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_vzor(:gen)?$', r'\1:po_vzoru:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):počátek(:gen)?$', r'\1:počátkem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):počínat(:ins)?$', r'\1:počínaje:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pod_dojem(:gen)?$', r'\1:pod_dojmem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pod_vliv(:gen)?$', r'\1:pod_vlivem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pomocí?(:gen)?$', r'\1:pomocí:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):postup(:gen)?$', r'\1:postupem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pouze_v(:loc)?$', r'\1:v:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pro:(nom|dat)$', r'\1:pro:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):prostřednictvím?(:gen|:ins)?$', r'\1:prostřednictvím:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):proti:nom$', r'\1:proti:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):protože[_:].+$', r'\1:protože', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před:gen$', r'\1:před:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před_během:gen$', r'\1:během:gen', edep['deprel']) # 'před a během utkání'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před_po:loc$', r'\1:po:loc', edep['deprel']) # 'před a po vyloučení Schindlera'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přes:gen$', r'\1:přes:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přestože[_:].+$', r'\1:přestože', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):při_příležitost(:gen)?$', r'\1:při_příležitosti:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):se?:(nom|acc|ins)$', r'\1:s:ins', edep['deprel']) # accusative: 'být s to' should be a fixed expression and it should be the predicate!
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_ohled_k(:dat)?$', r'\1:s_ohledem_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_ohled_na(:acc)?$', r'\1:s_ohledem_na:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_pomoc(:gen)?$', r'\1:s_pomocí:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_přihlédnutí_k(:dat)?$', r'\1:s_přihlédnutím_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_přihlédnutí_na(:acc)?$', r'\1:s_přihlédnutím_na:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_výjimka(:gen)?$', r'\1:s_výjimkou:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_vyloučení(:gen)?$', r'\1:s_vyloučením:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_zřetel_k(:dat)?$', r'\1:se_zřetelem_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_zřetel_na(:acc)?$', r'\1:se_zřetelem_na:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):severně_od(:gen)?$', r'\1:od:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):shoda(:gen)?$', r'\1', edep['deprel']) # 'shodou okolností' is not a prepositional phrase
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_do(:gen)?$', r'\1:směrem_do:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_k(:dat)?$', r'\1:směrem_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_na(:acc)?$', r'\1:směrem_na:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_od(:gen)?$', r'\1:směrem_od:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):společně_s(:ins)?$', r'\1:společně_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):spolu(_s)?(:ins|:dat)?$', r'\1:spolu_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):stranou(:gen|:dat)?$', r'\1:stranou:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):takže[_:].+$', r'\1:takže', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):třebaže[_:].+$', r'\1:třebaže', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):u_příležitost(:gen)?$', r'\1:u_příležitosti:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v:gen$', r'\1:v:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_analogie_s(:ins)?$', r'\1:v_analogii_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_čelo(:gen)?$', r'\1:v_čele:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_čelo_s(:ins)?$', r'\1:v_čele_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_dohoda_s(:ins)?$', r'\1:v_dohodě_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_duch(:gen)?$', r'\1:v_duchu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_důsledek(:gen)?$', r'\1:v_důsledku:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_forma(:gen)?$', r'\1:ve_formě:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_jméno(:gen)?$', r'\1:ve_jménu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_k:dat$', r'\1:k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_kombinace_s(:ins)?$', r'\1:v_kombinaci_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_konfrontace_s(:ins)?$', r'\1:v_konfrontaci_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_kontext_s(:ins)?$', r'\1:v_kontextu_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_na:loc$', r'\1:na:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_oblast(:gen)?$', r'\1:v_oblasti:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_oblast_s(:ins)?$', r'\1:s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_obor(:gen)?$', r'\1:v_oboru:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_otázka(:gen)?$', r'\1:v_otázce:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_podoba(:gen)?$', r'\1:v_podobě:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_poměr_k(:dat)?$', r'\1:v_poměru_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_proces(:gen)?$', r'\1:v_procesu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_prospěch(:gen)?$', r'\1:ve_prospěch:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_protiklad_k(:dat)?$', r'\1:v_protikladu_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_průběh(:gen)?$', r'\1:v_průběhu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_případ(:gen)?$', r'\1:v_případě:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_rámec(:gen)?$', r'\1:v_rámci:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_rozpor_s(:ins)?$', r'\1:v_rozporu_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_řada(:gen)?$', r'\1:v_řadě:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_shoda_s(:ins)?$', r'\1:ve_shodě_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_služba(:gen)?$', r'\1:ve_službách:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_směr(:gen)?$', r'\1:ve_směru:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_směr_k(:dat)?$', r'\1:ve_směru_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_smysl(:gen)?$', r'\1:ve_smyslu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_součinnost_s(:ins|:nom)?$', r'\1:v_součinnosti_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_souhlas_s(:ins|:nom)?$', r'\1:v_souhlasu_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_soulad_s(:ins|:nom)?$', r'\1:v_souladu_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_souvislost_s(:ins)?$', r'\1:v_souvislosti_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spojení_s(:ins)?$', r'\1:ve_spojení_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spojený_s(:ins)?$', r'\1:ve_spojení_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spojitost_s(:ins)?$', r'\1:ve_spojitosti_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spolupráce_s(:ins)?$', r'\1:ve_spolupráci_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_s_spolupráce(:ins)?$', r'\1:ve_spolupráci_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_srovnání_se?(:ins)?$', r'\1:ve_srovnání_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_světlo(:gen)?$', r'\1:ve_světle:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_věc(:gen)?$', r'\1:ve_věci:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_vztah_k(:dat)?$', r'\1:ve_vztahu_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_zájem(:gen|:loc)?$', r'\1:v_zájmu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_záležitost(:gen)?$', r'\1:v_záležitosti:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závěr(:gen)?$', r'\1:v_závěru:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závislost_na(:loc)?$', r'\1:v_závislosti_na:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závislost_s(:ins)?$', r'\1:v_závislosti_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_znamení(:gen)?$', r'\1:ve_znamení:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vina(:gen)?$', r'\1:vinou:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vliv(:gen)?$', r'\1:vlivem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vo:acc$', r'\1:o:acc', edep['deprel']) # colloquial: vo všecko
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):von([_:].+)?$', r'\1', edep['deprel']) # von Neumannem
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):voor([_:].+)?$', r'\1', edep['deprel']) # Hoge Raad voor Diamant
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vzhledem(_k)?(:dat)?$', r'\1:vzhledem_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:nom$', r'\1:z:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:ins$', r'\1:s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_důvod(:gen)?$', r'\1:z_důvodu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_hledisko(:gen|:nom)?$', r'\1:z_hlediska:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_oblast(:gen)?$', r'\1:z_oblasti:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_řada(:gen)?$', r'\1:z_řad:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(ať_)?z_strana(:gen)?$', r'\1:ze_strany:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_nedostatek(:gen)?$', r'\1:z_nedostatku:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_titul(:gen)?$', r'\1:z_titulu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za:nom$', r'\1:za:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_pomoc(:gen)?$', r'\1:za_pomoci:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_účast(:gen)?$', r'\1:za_účasti:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_účel(:gen)?$', r'\1:za_účelem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):začátek(:gen)?$', r'\1:začátkem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):zásluha(:gen)?$', r'\1:zásluhou:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):závěr(:gen)?$', r'\1:závěrem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):závisle_na(:loc)?$', r'\1:nezávisle_na:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^nmod:že:gen$', 'acl:že', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):že_za:gen$', r'\1:za:gen', edep['deprel'])
 
     def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
         '''

From 46819d52b6949d7ac0ddb4dc5c7dc6f84be7469b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Jan 2022 15:27:10 +0100
Subject: [PATCH 0489/1374] Refined processing of Slovak edeprels.

---
 udapi/block/ud/sk/fixedeprels.py | 56 +++++++++++++++++++++++++++-----
 1 file changed, 48 insertions(+), 8 deletions(-)

diff --git a/udapi/block/ud/sk/fixedeprels.py b/udapi/block/ud/sk/fixedeprels.py
index c235ee78..d029a031 100644
--- a/udapi/block/ud/sk/fixedeprels.py
+++ b/udapi/block/ud/sk/fixedeprels.py
@@ -21,6 +21,7 @@ class FixEdeprels(Block):
         'pre':             'pre:acc',
         'prostredníctvom': 'prostredníctvom:gen',
         's':               's:ins',
+        's_cieľ':          's_cieľom', # no case, used with infinitives (advcl)
         's_dôraz_na':      's_dôrazom_na:acc',
         's_ohľad_na':      's_ohľadom_na:acc',
         's_pomoc':         's_pomocou:gen',
@@ -30,7 +31,8 @@ class FixEdeprels(Block):
         'v_dôsledok':      'v_dôsledku:gen',
         'v_meno':          'v_mene:gen',
         'v_oblasť':        'v_oblasti:gen',
-        'v_porovnanie_s':  'v_porovnaniu_s:ins',
+        'v_porovnanie_s':  'v_porovnaní_s:ins',
+        'v_porovnaniu_s':  'v_porovnaní_s:ins',
         'v_priebeh':       'v_priebehu:gen',
         'v_prípad':        'v_prípade:gen',
         'v_prospech':      'v_prospech:gen',
@@ -54,13 +56,51 @@ def process_node(self, node):
         abbreviation and its morphological case is unknown.
         """
         for edep in node.deps:
-            for x, xnorm in unambiguous:
-                # All secondary prepositions have only one fixed morphological case
-                # they appear with, so we can replace whatever case we encounter with the correct one.
-                m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl):'+x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?$', edep['deprel'])
-                if m:
-                    edep['deprel'] = m.group(0)+':'+xnorm
-                    break
+            m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl):', edep['deprel'])
+            if m:
+                bdeprel = m.group(1)
+                solved = False
+                for x in self.unambiguous:
+                    # All secondary prepositions have only one fixed morphological case
+                    # they appear with, so we can replace whatever case we encounter with the correct one.
+                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl):'+x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?$', edep['deprel'])
+                    if m:
+                        edep['deprel'] = m.group(1)+':'+self.unambiguous[x]
+                        solved = True
+                        break
+                if not solved:
+                    # The following prepositions have more than one morphological case
+                    # available. Thanks to the Case feature on prepositions, we can
+                    # identify the correct one.
+                    m = re.match(r'^(obl(?::arg)?|nmod):(medzi|na|o|po|pred|v|za)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
+                    if m:
+                        # The following is only partial solution. We will not see
+                        # some children because they may be shared children of coordination.
+                        prepchildren = [x for x in node.children if x.lemma == m.group(2)]
+                        if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
+                            edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
+                            solved = True
+                if not solved:
+                    # If we failed to identify the case of the preposition in the
+                    # preceding steps, pick a default. It applies mostly to 'o'
+                    # with wrongly split time values.
+                    m = re.match(r'^(obl(?::arg)?|nmod):o$', edep['deprel'])
+                    if m:
+                        edep['deprel'] = m.group(1)+':o:acc'
+                        solved = True
+                    m = re.match(r'^(obl(?::arg)?|nmod):(po|v)$', edep['deprel'])
+                    if m:
+                        edep['deprel'] = m.group(1)+':'+m.group(2)+':loc'
+                        solved = True
+                if not solved:
+                    # Some cases do not occur with nominal modifiers without preposition.
+                    # If we see them, chances are that it is the same-case modifier,
+                    # and the same case just happens to be the one we see. For vocatives,
+                    # it is also possible that they have been confused with nominatives.
+                    m = re.match(r'^(obl(?::arg)?|nmod):(voc|loc)$', edep['deprel'])
+                    if m:
+                        edep['deprel'] = m.group(1)
+                        solved = True
 
     def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
         '''

From 05625f09c8a503d805644d1c31f988b6fbdbe81c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Jan 2022 16:43:36 +0100
Subject: [PATCH 0490/1374] Refined processing of Slovak edeprels.

---
 udapi/block/ud/sk/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/sk/fixedeprels.py b/udapi/block/ud/sk/fixedeprels.py
index d029a031..4c19be89 100644
--- a/udapi/block/ud/sk/fixedeprels.py
+++ b/udapi/block/ud/sk/fixedeprels.py
@@ -17,6 +17,7 @@ class FixEdeprels(Block):
         'na_rozdiel_od':   'na_rozdiel_od:gen',
         'na_základ':       'na_základe:gen',
         'od':              'od:gen',
+        'pod_vplyv':       'pod_vplyvom:gen',
         'pomoc':           'pomocou:gen',
         'pre':             'pre:acc',
         'prostredníctvom': 'prostredníctvom:gen',

From 891cf8966a98d4fc3dc781036aa26e7a652fa316 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jan 2022 11:04:09 +0100
Subject: [PATCH 0491/1374] Slovak cased edeprels.

---
 udapi/block/ud/sk/fixedeprels.py | 35 +++++++++++++++++++++++---------
 1 file changed, 25 insertions(+), 10 deletions(-)

diff --git a/udapi/block/ud/sk/fixedeprels.py b/udapi/block/ud/sk/fixedeprels.py
index 4c19be89..7208b6ef 100644
--- a/udapi/block/ud/sk/fixedeprels.py
+++ b/udapi/block/ud/sk/fixedeprels.py
@@ -11,8 +11,16 @@ class FixEdeprels(Block):
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
+        'a_hoci':          'hoci',
+        'ako':             'ako', # remove morphological case
+        'ako_na':          'ako',
+        'akoby_z':         'z:gen',
+        'akže':            'ak',
+        'ani_keby':        'keby',
+        'až_keď':          'keď',
         'do':              'do:gen',
         'k':               'k:dat',
+        'kto':             'kým', ###!!! The lemma should be fixed! The pronoun has grammaticalized as a subordinator.
         'mimo':            'mimo:gen',
         'na_rozdiel_od':   'na_rozdiel_od:gen',
         'na_základ':       'na_základe:gen',
@@ -21,6 +29,7 @@ class FixEdeprels(Block):
         'pomoc':           'pomocou:gen',
         'pre':             'pre:acc',
         'prostredníctvom': 'prostredníctvom:gen',
+        'prv_ako':         'ako',
         's':               's:ins',
         's_cieľ':          's_cieľom', # no case, used with infinitives (advcl)
         's_dôraz_na':      's_dôrazom_na:acc',
@@ -69,10 +78,10 @@ def process_node(self, node):
                         edep['deprel'] = m.group(1)+':'+self.unambiguous[x]
                         solved = True
                         break
+                # The following prepositions have more than one morphological case
+                # available. Thanks to the Case feature on prepositions, we can
+                # identify the correct one.
                 if not solved:
-                    # The following prepositions have more than one morphological case
-                    # available. Thanks to the Case feature on prepositions, we can
-                    # identify the correct one.
                     m = re.match(r'^(obl(?::arg)?|nmod):(medzi|na|o|po|pred|v|za)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
                     if m:
                         # The following is only partial solution. We will not see
@@ -81,10 +90,10 @@ def process_node(self, node):
                         if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
                             edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
                             solved = True
+                # If we failed to identify the case of the preposition in the
+                # preceding steps, pick a default. It applies mostly to 'o'
+                # with wrongly split time values.
                 if not solved:
-                    # If we failed to identify the case of the preposition in the
-                    # preceding steps, pick a default. It applies mostly to 'o'
-                    # with wrongly split time values.
                     m = re.match(r'^(obl(?::arg)?|nmod):o$', edep['deprel'])
                     if m:
                         edep['deprel'] = m.group(1)+':o:acc'
@@ -93,15 +102,21 @@ def process_node(self, node):
                     if m:
                         edep['deprel'] = m.group(1)+':'+m.group(2)+':loc'
                         solved = True
+                # Some cases do not occur with nominal modifiers without preposition.
+                # If we see them, chances are that it is the same-case modifier,
+                # and the same case just happens to be the one we see. For vocatives,
+                # it is also possible that they have been confused with nominatives.
                 if not solved:
-                    # Some cases do not occur with nominal modifiers without preposition.
-                    # If we see them, chances are that it is the same-case modifier,
-                    # and the same case just happens to be the one we see. For vocatives,
-                    # it is also possible that they have been confused with nominatives.
                     m = re.match(r'^(obl(?::arg)?|nmod):(voc|loc)$', edep['deprel'])
                     if m:
                         edep['deprel'] = m.group(1)
                         solved = True
+                # Annotation and conversion errors.
+                if not solved:
+                    # Povedal som jej „na zdorovie“.
+                    if edep['deprel'] == 'obl:arg:na' and node.form == 'zdorovie':
+                        self.set_basic_and_enhanced(node, edep['parent'], 'ccomp', 'ccomp')
+                        solved = True
 
     def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
         '''

From a2e91a334e98fd4abe2bdc71b7e35ba314008399 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 17 Jan 2022 02:37:44 +0100
Subject: [PATCH 0492/1374] more params for corefud.MarkCrossing

---
 udapi/block/corefud/markcrossing.py | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/udapi/block/corefud/markcrossing.py b/udapi/block/corefud/markcrossing.py
index 81136ec9..f357e7cc 100644
--- a/udapi/block/corefud/markcrossing.py
+++ b/udapi/block/corefud/markcrossing.py
@@ -1,15 +1,19 @@
 from udapi.core.block import Block
 import udapi.core.coref
 import itertools
+import logging
 
 class MarkCrossing(Block):
     """Find mentions with crossing spans."""
 
-    def __init__(self, same_cluster_only=False, continuous_only=False, print_form=False, **kwargs):
+    def __init__(self, same_cluster_only=False, continuous_only=False, print_form=False,
+                 log=True, mark=True, **kwargs):
         super().__init__(**kwargs)
         self.same_cluster_only = same_cluster_only
         self.continuous_only = continuous_only
         self.print_form = print_form
+        self.log = log
+        self.mark = mark
 
     def _print(self, mention):
         if self.print_form:
@@ -25,4 +29,8 @@ def process_node(self, node):
                         continue
                     if self.continuous_only and (',' in mA.span or ',' in mB.span):
                         continue
-                    node.misc['Mark'] = f'cross:{self._print(mA)}+{self._print(mB)}'
+                    msg = f'cross:{self._print(mA)}+{self._print(mB)}'
+                    if self.mark:
+                        node.misc['Mark'] = msg
+                    if self.log:
+                        print(msg)

From 136ef06885b66eb68ea06d6a14d26e7d428c0354 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 18 Jan 2022 14:31:59 +0100
Subject: [PATCH 0493/1374] log each crossing just once (not for each node in
 the intersection)

---
 udapi/block/corefud/markcrossing.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/udapi/block/corefud/markcrossing.py b/udapi/block/corefud/markcrossing.py
index f357e7cc..a6d9346a 100644
--- a/udapi/block/corefud/markcrossing.py
+++ b/udapi/block/corefud/markcrossing.py
@@ -14,6 +14,7 @@ def __init__(self, same_cluster_only=False, continuous_only=False, print_form=Fa
         self.print_form = print_form
         self.log = log
         self.mark = mark
+        self._logged = {}
 
     def _print(self, mention):
         if self.print_form:
@@ -29,8 +30,10 @@ def process_node(self, node):
                         continue
                     if self.continuous_only and (',' in mA.span or ',' in mB.span):
                         continue
-                    msg = f'cross:{self._print(mA)}+{self._print(mB)}'
                     if self.mark:
-                        node.misc['Mark'] = msg
+                        node.misc['Mark'] = f"{self._print(mA)}+{self._print(mB)}"
                     if self.log:
-                        print(msg)
+                        cross_id = node.root.sent_id + mA.span + mB.span
+                        if cross_id not in self._logged:
+                            self._logged[cross_id] = True
+                            print(f"crossing mentions at {node}: {self._print(mA)} + {self._print(mB)}")

From f0e76516eb0376493486db66e408dc2995f9acbc Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 19 Jan 2022 22:05:21 +0100
Subject: [PATCH 0494/1374] util.FindBug can take any params

so e.g. `util.FindBug block=eval.F1 focus=NOUN`
will result in inspecting `eval.F1 focus=NOUN`.
---
 udapi/block/util/findbug.py | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/udapi/block/util/findbug.py b/udapi/block/util/findbug.py
index e05afe76..e1ea838c 100644
--- a/udapi/block/util/findbug.py
+++ b/udapi/block/util/findbug.py
@@ -5,9 +5,12 @@
 insert "util.FindBug block=" into the scenario,
 e.g. to debug ``second.Block``, use
 
-udapy first.Block util.FindBug block=second.Block > bug.conllu
+  udapy first.Block util.FindBug block=second.Block > bug.conllu
 
 This will create the file bug.conllu with the bundle, which caused the bug.
+
+The second.Block can have any parameters, e.g.
+  udapy first.Block util.FindBug block=second.Block param1=value1 param2=value2 > bug.conllu
 """
 import copy
 import logging
@@ -20,24 +23,31 @@
 class FindBug(BaseWriter):
     """Debug another block by finding a minimal testcase conllu file."""
 
-    def __init__(self, block, first_error_only=True, **kwargs):
-        """Args: block, first_error_only"""
-        super().__init__(**kwargs)
+    def __init__(self, block, first_error_only=True,
+                 files='-', filehandle=None, docname_as_file=False, encoding='utf-8',
+                 newline='\n', overwrite=False,
+                 **kwargs):
+        """Args: block, first_error_only.
+        All other parameters (which are not parameters of BaseWriter)
+        will be passed to the block being inspected.
+        """
+        super().__init__(files, filehandle, docname_as_file, encoding, newline, overwrite)
         self.block = block
         self.first_error_only = first_error_only
+        self._kwargs = kwargs
 
     def process_document(self, document):
         sub_path, class_name = _parse_block_name(self.block)
         module = "udapi.block." + sub_path + "." + class_name.lower()
         try:
-            command = "from " + module + " import " + class_name + " as b"
+            command = "from " + module + " import " + class_name + " as B"
             logging.debug("Trying to run command: %s", command)
             exec(command)  # pylint: disable=exec-used
         except Exception:
             logging.warning("Error when trying import the block %s", self.block)
             raise
 
-        command = "b()"  # TODO params as kwargs
+        command = "B(**self._kwargs)"
         logging.debug("Trying to evaluate this: %s", command)
         new_block = eval(command)  # pylint: disable=eval-used
 

From 6e64786578eab324257dae04a3036c29e4d42a7e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 19 Jan 2022 22:37:16 +0100
Subject: [PATCH 0495/1374] bugfix in eval.F1

When a pair of sentences contains no non-focused tokens,
`nf_common == []` and we cannot use `while nf_common[c] != pred_tokens[i]`.
---
 udapi/block/eval/f1.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/eval/f1.py b/udapi/block/eval/f1.py
index 9f265ac7..ca5510e4 100644
--- a/udapi/block/eval/f1.py
+++ b/udapi/block/eval/f1.py
@@ -125,6 +125,9 @@ def process_tree(self, tree):
             nf_common = find_lcs(nf_pred_tokens, nf_gold_tokens)
             i, j, c, un_pred, un_gold, common  = 0, 0, 0, [], [], []
             while i < len(pred_tokens) and j < len(gold_tokens):
+                if c == len(nf_common):
+                    common += find_lcs(pred_tokens[i+1:], gold_tokens[j+1:])
+                    break
                 while nf_common[c] != pred_tokens[i]:
                     un_pred.append(pred_tokens[i])
                     i += 1
@@ -135,9 +138,6 @@ def process_tree(self, tree):
                 un_pred, un_gold  = [], []
                 while c < len(nf_common) and nf_common[c] == pred_tokens[i] and nf_common[c] == gold_tokens[j]:
                     i, j, c = i+1, j+1, c+1
-                if c == len(nf_common):
-                    common += find_lcs(pred_tokens[i+1:], gold_tokens[j+1:])
-                    break
             common = [x for x in common if self.focus.fullmatch(x)]
             pred_tokens = [x for x in pred_tokens if self.focus.fullmatch(x)]
             gold_tokens = [x for x in gold_tokens if self.focus.fullmatch(x)]

From 7bcde4d7cb1adf8a4fc02882504fa0ff7a22654e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 9 Feb 2022 11:18:19 +0100
Subject: [PATCH 0496/1374] Reorganized the Czech block following Slovak, so it
 is more readable.

---
 udapi/block/ud/cs/fixedeprels.py | 460 ++++++++++++++++---------------
 1 file changed, 235 insertions(+), 225 deletions(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 5a2e996d..ac2653c3 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -5,6 +5,217 @@
 
 class FixEdeprels(Block):
 
+    # Secondary prepositions sometimes have the lemma of the original part of
+    # speech. We want the grammaticalized form instead. List even those that
+    # will have the same lexical form, as we also want to check the morphological
+    # case. And include all other prepositions that have unambiguous morphological
+    # case, even if they are not secondary.
+    unambiguous = {
+        'abi':              'aby',
+        'aby_na':           'na',
+        'ačkoliv':          'ačkoli',
+        'ať':               'ať', # remove morphological case
+        'ať_forma':         'formou:gen',
+        'ať_v':             'v:loc',
+        'ať_z':             'z:gen',
+        'ať_z_strana':      'ze_strany:gen',
+        'až_do':            'do:gen',
+        'až_o':             'o:acc',
+        'během':            'během:gen',
+        'bez':              'bez:gen',
+        'bez_ohled_na':     'bez_ohledu_na:acc',
+        'bez_zřetel_k':     'bez_zřetele_k:dat',
+        'bez_zřetel_na':    'bez_zřetele_na:acc',
+        'blíž':             'blízko:dat',
+        'cesta':            'cestou:gen',
+        'daleko':           'nedaleko:gen',
+        'daleko_od':        'od:gen',
+        'dík':              'díky:dat',
+        'díky':             'díky:dat',
+        'dle':              'dle:gen',
+        'do':               'do:gen',
+        'do_k':             'k:dat',
+        'do_oblast':        'do_oblasti:gen',
+        'do_rozpor_s':      'do_rozporu_s:ins',
+        'do_soulad_s':      'do_souladu_s:ins',
+        'forma':            'formou:gen',
+        'i_když':           'i_když', # remove morphological case
+        'jak_aby':          'jak',
+        'jak_ad':           'jak',
+        'jakkoliv':         'jakkoli',
+        'jako':             'jako', # remove morphological case
+        'jako_kupříkladu':  'jako',
+        'jakoby':           'jako',
+        'jakoby_pod':       'pod:ins',
+        'jelikož_do':       'jelikož',
+        'jestli_že':        'jestliže',
+        'k':                'k:dat',
+        'k_konec':          'ke_konci:gen',
+        'kdykoliv':         'kdykoli',
+        'kol':              'kolem:gen',
+        'kolem':            'kolem:gen',
+        'konec':            'koncem:gen',
+        'kromě':            'kromě:gen',
+        'liž':              'li',
+        'mezi_uvnitř':      'uvnitř:gen',
+        'na_báze':          'na_bázi:gen',
+        'na_čelo':          'na_čele:gen',
+        'na_mimo':          'na:loc', # na kurtě i mimo něj
+        'na_než':           'na:acc', # na víc než čtyři a půl kilometru
+        'na_od':            'na_rozdíl_od:gen',
+        'na_podklad':       'na_podkladě:gen',
+        'na_rozdíl_od':     'na_rozdíl_od:gen',
+        'na_újma':          'gen', # 'nebude na újmu' is a multi-word predicate but 'na újmu' is probably not used as an independent oblique modifier
+        'na_úroveň':        'na_úrovni:gen',
+        'na_úsek':          'na_úseku:gen',
+        'na_základ':        'na_základě:gen',
+        'na_základna':      'na_základně:gen',
+        'na_závěr':         'na_závěr:gen',
+        'namísto':          'namísto:gen',
+        'namísto_do':       'do:gen',
+        'narozdíl_od':      'na_rozdíl_od:gen',
+        'následek':         'následkem:gen',
+        'navzdory':         'navzdory:dat',
+        'nedaleko':         'nedaleko:gen',
+        'než':              'než', # remove morphological case
+        'nežli':            'nežli', # remove morphological case
+        'o_jako':           'jako',
+        'o_o':              'o:acc',
+        'od':               'od:gen',
+        'ohledně':          'ohledně:gen',
+        'okolo':            'okolo:gen',
+        'oproti':           'oproti:dat',
+        'po_v':             'po:loc',
+        'po_doba':          'po_dobu:gen',
+        'po_vzor':          'po_vzoru:gen',
+        'poblíž':           'poblíž:gen',
+        'počátek':          'počátkem:gen',
+        'počínat':          'počínaje:ins',
+        'pod_dojem':        'pod_dojmem:gen',
+        'pod_vliv':         'pod_vlivem:gen',
+        'podle':            'podle:gen',
+        'pomoc':            'pomocí:gen',
+        'pomocí':           'pomocí:gen',
+        'postup':           'postupem:gen',
+        'pouze_v':          'v:loc',
+        'pro':              'pro:acc',
+        'prostřednictví':   'prostřednictvím:gen',
+        'prostřednictvím':  'prostřednictvím:gen',
+        'proti':            'proti:dat',
+        'protože':          'protože', # remove morphological case
+        'před_během':       'během:gen', # před a během utkání
+        'před_po':          'po:loc', # před a po vyloučení Schindlera
+        'přes':             'přes:acc',
+        'přestože':         'přestože', # remove morphological case
+        'při':              'při:loc',
+        'při_příležitost':  'při_příležitosti:gen',
+        's_ohled_k':        's_ohledem_k:dat',
+        's_ohled_na':       's_ohledem_na:acc',
+        's_pomoc':          's_pomocí:gen',
+        's_přihlédnutí_k':  's_přihlédnutím_k:dat',
+        's_přihlédnutí_na': 's_přihlédnutím_na:acc',
+        's_výjimka':        's_výjimkou:gen',
+        's_vyloučení':      's_vyloučením:gen',
+        's_zřetel_k':       'se_zřetelem_k:dat',
+        's_zřetel_na':      'se_zřetelem_na:acc',
+        'severně_od':       'od:gen',
+        'skrz':             'skrz:acc',
+        'směr_do':          'směrem_do:gen',
+        'směr_k':           'směrem_k:dat',
+        'směr_na':          'směrem_na:acc',
+        'směr_od':          'směrem_od:gen',
+        'společně_s':       'společně_s:ins',
+        'spolu':            'spolu_s:ins',
+        'spolu_s':          'spolu_s:ins',
+        'stranou':          'stranou:gen',
+        'takže':            'takže', # remove morphological case
+        'takže_a':          'takže',
+        'třebaže':          'třebaže', # remove morphological case
+        'u':                'u:gen',
+        'u_příležitost':    'u_příležitosti:gen',
+        'uprostřed':        'uprostřed:gen',
+        'uvnitř':           'uvnitř:gen',
+        'v_analogie_s':     'v_analogii_s:ins',
+        'v_čelo':           'v_čele:gen',
+        'v_čelo_s':         'v_čele_s:ins',
+        'v_dohoda_s':       'v_dohodě_s:ins',
+        'v_duch':           'v_duchu:gen',
+        'v_důsledek':       'v_důsledku:gen',
+        'v_forma':          've_formě:gen',
+        'v_jméno':          've_jménu:gen',
+        'v_k':              'k:dat',
+        'v_kombinace_s':    'v_kombinaci_s:ins',
+        'v_konfrontace_s':  'v_konfrontaci_s:ins',
+        'v_kontext_s':      'v_kontextu_s:ins',
+        'v_na':             'na:loc',
+        'v_oblast':         'v_oblasti:gen',
+        'v_oblast_s':       's:ins',
+        'v_obor':           'v_oboru:gen',
+        'v_otázka':         'v_otázce:gen',
+        'v_podoba':         'v_podobě:gen',
+        'v_poměr_k':        'v_poměru_k:dat',
+        'v_proces':         'v_procesu:gen',
+        'v_prospěch':       've_prospěch:gen',
+        'v_protiklad_k':    'v_protikladu_k:dat',
+        'v_průběh':         'v_průběhu:gen',
+        'v_případ':         'v_případě:gen',
+        'v_případ_že':      'v_případě_že',
+        'v_rámec':          'v_rámci:gen',
+        'v_rozpor_s':       'v_rozporu_s:ins',
+        'v_řada':           'v_řadě:gen',
+        'v_shoda_s':        've_shodě_s:ins',
+        'v_služba':         've_službách:gen',
+        'v_směr':           've_směru:gen',
+        'v_směr_k':         've_směru_k:dat',
+        'v_smysl':          've_smyslu:gen',
+        'v_součinnost_s':   'v_součinnosti_s:ins',
+        'v_souhlas_s':      'v_souhlasu_s:ins',
+        'v_soulad_s':       'v_souladu_s:ins',
+        'v_souvislost_s':   'v_souvislosti_s:ins',
+        'v_spojení_s':      've_spojení_s:ins',
+        'v_spojený_s':      've_spojení_s:ins',
+        'v_spojitost_s':    've_spojitosti_s:ins',
+        'v_spolupráce_s':   've_spolupráci_s:ins',
+        'v_s_spolupráce':   've_spolupráci_s:ins',
+        'v_srovnání_s':     've_srovnání_s:ins',
+        'v_srovnání_se':    've_srovnání_s:ins',
+        'v_světlo':         've_světle:gen',
+        'v_věc':            've_věci:gen',
+        'v_vztah_k':        've_vztahu_k:dat',
+        'v_zájem':          'v_zájmu:gen',
+        'v_záležitost':     'v_záležitosti:gen',
+        'v_závěr':          'v_závěru:gen',
+        'v_závislost_na':   'v_závislosti_na:loc',
+        'v_závislost_s':    'v_závislosti_s:ins',
+        'v_znamení':        've_znamení:gen',
+        'včetně':           'včetně:gen',
+        'vedle':            'vedle:gen',
+        'vina':             'vinou:gen',
+        'vliv':             'vlivem:gen',
+        'vůči':             'vůči:dat',
+        'vzhledem':         'vzhledem_k:dat',
+        'vzhledem_k':       'vzhledem_k:dat',
+        'z':                'z:gen',
+        'z_důvod':          'z_důvodu:gen',
+        'z_hledisko':       'z_hlediska:gen',
+        'z_oblast':         'z_oblasti:gen',
+        'z_řada':           'z_řad:gen',
+        'z_strana':         'ze_strany:gen',
+        'z_nedostatek':     'z_nedostatku:gen',
+        'z_titul':          'z_titulu:gen',
+        'za_pomoc':         'za_pomoci:gen',
+        'za_účast':         'za_účasti:gen',
+        'za_účel':          'za_účelem:gen',
+        'začátek':          'začátkem:gen',
+        'zásluha':          'zásluhou:gen',
+        'zatím_co':         'zatímco',
+        'závěr':            'závěrem:gen',
+        'závisle_na':       'nezávisle_na:loc',
+        'že_ať':            'ať',
+        'že_jako':          'že',
+        'že_za':            'za:gen'
+    }
+
     def process_node(self, node):
         """
         Occasionally the edeprels automatically derived from the Czech basic
@@ -12,26 +223,39 @@ def process_node(self, node):
         abbreviation and its morphological case is unknown.
         """
         for edep in node.deps:
+            m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl):', edep['deprel'])
+            if m:
+                bdeprel = m.group(1)
+                solved = False
+                for x in self.unambiguous:
+                    # All secondary prepositions have only one fixed morphological case
+                    # they appear with, so we can replace whatever case we encounter with the correct one.
+                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl):'+x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?$', edep['deprel'])
+                    if m:
+                        edep['deprel'] = m.group(1)+':'+self.unambiguous[x]
+                        solved = True
+                        break
+                # The following prepositions have more than one morphological case
+                # available. Thanks to the Case feature on prepositions, we can
+                # identify the correct one.
+                if not solved:
+                    m = re.match(r'^(obl(?::arg)?|nmod):(mezi|na|nad|o|po|pod|před|v|za)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
+                    if m:
+                        # The following is only partial solution. We will not see
+                        # some children because they may be shared children of coordination.
+                        prepchildren = [x for x in node.children if x.lemma == m.group(2)]
+                        if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
+                            edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
+                            solved = True
             if re.match(r'^(acl|advcl):', edep['deprel']):
                 # We do not include 'i' in the list of redundant prefixes because we want to preserve 'i když' (but we want to discard the other combinations).
                 edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):abi$', r'\1:aby', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):ačkoliv$', r'\1:ačkoli', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):jak_aby$', r'\1:jak', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):jak_ad$', r'\1:jak', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):jakkoliv$', r'\1:jakkoli', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):jako_kupříkladu$', r'\1:jako', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):jakoby$', r'\1:jako', edep['deprel']) # these instances in FicTree should be spelled 'jako by'
-                edep['deprel'] = re.sub(r'^(advcl):jelikož_do$', r'\1:jelikož', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):jestli_že$', r'\1:jestliže', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl):k$', r'\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:k$', r'obl:k:dat', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):kdy$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):kdykoliv$', r'\1:kdykoli', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):liž$', r'\1:li', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:místo$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
                 edep['deprel'] = re.sub(r'^acl:na_způsob$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
                 edep['deprel'] = re.sub(r'^(advcl):neboť$', r'\1', edep['deprel']) # 'neboť' is coordinating
@@ -39,14 +263,9 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^(acl):od$', r'nmod:od:gen', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(advcl):podle$', r'obl:podle:gen', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:pro$', r'obl:pro:acc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):takže_a$', r'\1:takže', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl):v$', r'nmod:v:loc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):v_případ_že$', r'\1:v_případě_že', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:v_duch$', r'obl:v_duchu:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):zatím_co$', r'\1:zatímco', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):že_ať$', r'\1:ať', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):že_jako$', r'\1:že', edep['deprel'])
                 if edep['deprel'] == 'acl:v' and node.form == 'patře':
                     edep['deprel'] = 'nmod:v:loc'
                     node.deprel = 'nmod'
@@ -84,27 +303,11 @@ def process_node(self, node):
                 elif edep['deprel'] == 'nmod:voc':
                     # 'v 8. čísle tiskoviny Ty rudá krávo'
                     edep['deprel'] = 'nmod:nom'
-                elif re.match(r'^(nmod|obl(:arg)?):během$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):bez$', edep['deprel']):
-                    edep['deprel'] += ':gen'
                 elif edep['deprel'] == 'nmod:co:nom':
                     # Annotation error: 'kompatibilní znamená tolik co slučitelný'
                     # 'co' should be relative pronoun rather than subordinating conjunction.
                     edep['deprel'] = 'acl:relcl'
                     node.deprel = 'acl:relcl'
-                elif re.match(r'^(nmod|obl(:arg)?):díky$', edep['deprel']):
-                    edep['deprel'] += ':dat'
-                elif re.match(r'^(nmod|obl(:arg)?):dle$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):do$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):k(:nom)?$', edep['deprel']):
-                    edep['deprel'] = re.sub(r':nom$', '', edep['deprel']) + ':dat'
-                elif re.match(r'^(nmod|obl(:arg)?):kolem$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):kromě$', edep['deprel']):
-                    edep['deprel'] += ':gen'
                 elif re.match(r'^(obl(:arg)?):li$', edep['deprel']):
                     edep['deprel'] = 'advcl:li'
                 elif re.match(r'^(nmod|obl(:arg)?):mezi$', edep['deprel']):
@@ -145,17 +348,11 @@ def process_node(self, node):
                         edep['deprel'] += ':acc'
                     else:
                         edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):namísto$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):navzdory$', edep['deprel']):
-                    edep['deprel'] += ':dat'
                 elif re.match(r'^(nmod|obl(:arg)?):o$', edep['deprel']):
                     if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
                         edep['deprel'] += ':acc'
                     else:
                         edep['deprel'] += ':loc'
-                elif re.match(r'^(nmod|obl(:arg)?):od$', edep['deprel']):
-                    edep['deprel'] += ':gen'
                 elif re.match(r'^(nmod|obl(:arg)?):ohled_na:ins$', edep['deprel']):
                     # Annotation error.
                     if node.form == 's':
@@ -166,10 +363,6 @@ def process_node(self, node):
                         self.set_basic_and_enhanced(ohled, node, 'fixed', 'fixed')
                         self.set_basic_and_enhanced(na, node, 'fixed', 'fixed')
                         self.set_basic_and_enhanced(node, noun, 'case', 'case')
-                elif re.match(r'^(nmod|obl(:arg)?):okolo$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):oproti$', edep['deprel']):
-                    edep['deprel'] += ':dat'
                 elif re.match(r'^nmod:pára:nom$', edep['deprel']):
                     # Annotation error: 'par excellence'.
                     edep['deprel'] = 'nmod'
@@ -184,42 +377,21 @@ def process_node(self, node):
                             c.feats['Polarity'] = ''
                             c.feats['AdpType'] = 'Prep'
                 elif re.match(r'^(nmod|obl(:arg)?):po$', edep['deprel']):
-                    ###!!! Taky bychom se mohli dívat do XPOS předložky, protože tam bude pád uveden!
                     if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
                         edep['deprel'] += ':acc'
                     else:
                         edep['deprel'] += ':loc'
-                elif re.match(r'^(nmod|obl(:arg)?):poblíž$', edep['deprel']):
-                    edep['deprel'] += ':gen'
                 elif re.match(r'^(nmod|obl(:arg)?):pod$', edep['deprel']):
                     if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
                         edep['deprel'] += ':acc'
                     else:
                         edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):podle$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):pro$', edep['deprel']):
-                    edep['deprel'] += ':acc'
-                elif re.match(r'^(nmod|obl(:arg)?):proti$', edep['deprel']):
-                    edep['deprel'] += ':dat'
                 elif re.match(r'^(nmod|obl(:arg)?):před$', edep['deprel']):
                     # Accusative would be possible but unlikely.
                     edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):přes$', edep['deprel']):
-                    edep['deprel'] += ':acc'
-                elif re.match(r'^(nmod|obl(:arg)?):při$', edep['deprel']):
-                    edep['deprel'] += ':loc'
                 elif re.match(r'^(nmod|obl(:arg)?):s$', edep['deprel']):
                     # Genitive would be possible but unlikely.
                     edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):skrz$', edep['deprel']):
-                    edep['deprel'] += ':acc'
-                elif re.match(r'^(nmod|obl(:arg)?):u$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):uprostřed$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):uvnitř$', edep['deprel']):
-                    edep['deprel'] += ':gen'
                 elif re.match(r'^(nmod|obl(:arg)?):v_s(:loc)?$', edep['deprel']) and node.form == 'spolupráci':
                     # Annotation error. 'Ve spolupráci s' should be analyzed as a multi-word preposition.
                     # Find the content nominal.
@@ -244,51 +416,23 @@ def process_node(self, node):
                     # 'Předloňský kůň roku Law Soziri šel již v Lahovickém oblouku v čele s Raddelliosem a tato dvojice také nakonec zahanbila ostatní soupeře...'
                     # There should be two independent oblique modifiers, 'v čele' and 's Raddelliosem'.
                     edep['deprel'] = 'obl:s:ins'
-                elif re.match(r'^(nmod|obl(:arg)?):včetně$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):vedle$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^(nmod|obl(:arg)?):vůči$', edep['deprel']):
-                    edep['deprel'] += ':dat'
-                elif re.match(r'^(nmod|obl(:arg)?):z$', edep['deprel']):
-                    edep['deprel'] += ':gen'
                 elif re.match(r'^(nmod|obl(:arg)?):za$', edep['deprel']):
                     # Instrumental would be possible but unlikely.
                     edep['deprel'] += ':acc'
                 else:
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):aby_na:loc$', r'\1:na:loc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ač([_:].+)?$', r'\1:ač', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ačkoliv?([_:].+)?$', r'\1:ačkoli', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(jak_)?ad([_:].+)?$', r'\1', edep['deprel']) # ad infinitum
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_v(:loc)?$', r'\1:v:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať_z(:gen)?$', r'\1:z:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):až_do(:gen)?$', r'\1:do:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):až_o(:acc)?$', r'\1:o:acc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_ohled_na(:acc)?$', r'\1:bez_ohledu_na:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_zřetel_k(:dat)?$', r'\1:bez_zřetele_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):bez_zřetel_na(:acc)?$', r'\1:bez_zřetele_na:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):blíž(:dat)?$', r'\1:blízko:dat', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):byť[_:].+$', r'\1:byť', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):cesta:ins$', r'\1:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):cesta(:gen)?$', r'\1:cestou:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):co(:nom)?$', r'advmod', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):daleko(:nom)?$', r'\1:nedaleko:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):daleko_od(:gen)?$', r'\1:od:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):de([_:].+)?$', r'\1', edep['deprel']) # de facto
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):di([_:].+)?$', r'\1', edep['deprel']) # Lido di Jesolo
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):dík(:dat)?$', r'\1:díky:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do:(nom|dat)$', r'\1:do:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_k:dat$', r'\1:k:dat', edep['deprel']) # do maloobchodní sítě (nebo k dalšímu zpracování)
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_oblast(:gen)?$', r'\1:do_oblasti:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_rozpor_s(:ins)?$', r'\1:do_rozporu_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):do_soulad_s(:ins)?$', r'\1:do_souladu_s:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):en([_:].+)?$', r'\1', edep['deprel']) # bienvenue en France
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(ať_)?forma(:gen)?$', r'\1:formou:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):i_když[_:].+$', r'\1:i_když', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):in([_:].+)?$', r'\1', edep['deprel']) # made in NHL
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):into([_:].+)?$', r'\1', edep['deprel']) # made in NHL
@@ -296,161 +440,27 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakkoliv?[_:].+$', r'\1:jakkoli', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jako[_:].+$', r'\1:jako', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby[_:].+$', r'\1:jako', edep['deprel']) # these instances in FicTree should be spelled 'jako by'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby_pod:ins$', r'\1:pod:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno:nom$', r'\1:jménem:nom', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno(:gen)?$', r'\1:jménem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):k(:gen)?$', r'\1:k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):k_konec(:gen)?$', r'\1:ke_konci:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):kol(em)?(:gen)?$', r'\1:kolem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):konec(:gen)?$', r'\1:koncem:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi:(nom|dat)$', r'\1:mezi:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi_uvnitř:gen$', r'\1:uvnitř:gen', edep['deprel']) # 'nejdou mezi, ale uvnitř odvětví a oborů'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na(:gen|:nom)$', r'\1:na:acc', edep['deprel']) # 'odložit na 1. září'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_báze(:gen)?$', r'\1:na_bázi:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_čelo(:gen)?$', r'\1:na_čele:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_mimo:loc$', r'\1:na:loc', edep['deprel']) # 'na kurtě i mimo něj'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_než:acc$', r'\1:na:acc', edep['deprel']) # 'na víc než čtyři a půl kilometru'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_od:acc$', r'\1:na_rozdíl_od:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_podklad(:gen)?$', r'\1:na_podkladě:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_?rozdíl_od(:gen)?$', r'\1:na_rozdíl_od:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_újma(:gen)?$', r'\1:gen', edep['deprel']) # 'nebude na újmu' is a multi-word predicate but 'na újmu' is probably not used as an independent oblique modifier
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_úroveň(:gen)?$', r'\1:na_úrovni:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_úsek(:gen)?$', r'\1:na_úseku:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_základ(:gen)?$', r'\1:na_základě:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_základna(:gen)?$', r'\1:na_základně:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):na_závěr(:gen)?$', r'\1:na_závěr:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):namísto_do(:gen)?$', r'\1:do:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):následek(:gen)?$', r'\1:následkem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(ne)?daleko(:gen)?$', r'\1:nedaleko:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):než[_:].+$', r'\1:než', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):nežli[_:].+$', r'\1:nežli', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o:(nom|gen|dat)$', r'\1:o:acc', edep['deprel']) # 'zájem o obaly'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o_jako[_:].+$', r'\1:jako', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o_o:acc$', r'\1:o:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):od:(nom|dat)$', r'\1:od:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):of([_:].+)?$', r'\1', edep['deprel']) # University of North Carolina
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ohledně(:gen)?$', r'\1:ohledně:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):per([_:].+)?$', r'\1', edep['deprel']) # per rollam
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po:(nom|gen)$', r'\1:po:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_v:loc$', r'\1:po:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_doba(:gen)?$', r'\1:po_dobu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po_vzor(:gen)?$', r'\1:po_vzoru:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):počátek(:gen)?$', r'\1:počátkem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):počínat(:ins)?$', r'\1:počínaje:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pod_dojem(:gen)?$', r'\1:pod_dojmem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pod_vliv(:gen)?$', r'\1:pod_vlivem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pomocí?(:gen)?$', r'\1:pomocí:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):postup(:gen)?$', r'\1:postupem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pouze_v(:loc)?$', r'\1:v:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):pro:(nom|dat)$', r'\1:pro:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):prostřednictvím?(:gen|:ins)?$', r'\1:prostřednictvím:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):proti:nom$', r'\1:proti:dat', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):protože[_:].+$', r'\1:protože', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před:gen$', r'\1:před:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před_během:gen$', r'\1:během:gen', edep['deprel']) # 'před a během utkání'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před_po:loc$', r'\1:po:loc', edep['deprel']) # 'před a po vyloučení Schindlera'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přes:gen$', r'\1:přes:acc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přestože[_:].+$', r'\1:přestože', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):při_příležitost(:gen)?$', r'\1:při_příležitosti:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):se?:(nom|acc|ins)$', r'\1:s:ins', edep['deprel']) # accusative: 'být s to' should be a fixed expression and it should be the predicate!
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_ohled_k(:dat)?$', r'\1:s_ohledem_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_ohled_na(:acc)?$', r'\1:s_ohledem_na:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_pomoc(:gen)?$', r'\1:s_pomocí:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_přihlédnutí_k(:dat)?$', r'\1:s_přihlédnutím_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_přihlédnutí_na(:acc)?$', r'\1:s_přihlédnutím_na:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_výjimka(:gen)?$', r'\1:s_výjimkou:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_vyloučení(:gen)?$', r'\1:s_vyloučením:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_zřetel_k(:dat)?$', r'\1:se_zřetelem_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):s_zřetel_na(:acc)?$', r'\1:se_zřetelem_na:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):severně_od(:gen)?$', r'\1:od:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):shoda(:gen)?$', r'\1', edep['deprel']) # 'shodou okolností' is not a prepositional phrase
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_do(:gen)?$', r'\1:směrem_do:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_k(:dat)?$', r'\1:směrem_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_na(:acc)?$', r'\1:směrem_na:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):směr_od(:gen)?$', r'\1:směrem_od:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):společně_s(:ins)?$', r'\1:společně_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):spolu(_s)?(:ins|:dat)?$', r'\1:spolu_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):stranou(:gen|:dat)?$', r'\1:stranou:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):takže[_:].+$', r'\1:takže', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):třebaže[_:].+$', r'\1:třebaže', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):u_příležitost(:gen)?$', r'\1:u_příležitosti:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v:gen$', r'\1:v:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_analogie_s(:ins)?$', r'\1:v_analogii_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_čelo(:gen)?$', r'\1:v_čele:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_čelo_s(:ins)?$', r'\1:v_čele_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_dohoda_s(:ins)?$', r'\1:v_dohodě_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_duch(:gen)?$', r'\1:v_duchu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_důsledek(:gen)?$', r'\1:v_důsledku:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_forma(:gen)?$', r'\1:ve_formě:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_jméno(:gen)?$', r'\1:ve_jménu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_k:dat$', r'\1:k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_kombinace_s(:ins)?$', r'\1:v_kombinaci_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_konfrontace_s(:ins)?$', r'\1:v_konfrontaci_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_kontext_s(:ins)?$', r'\1:v_kontextu_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_na:loc$', r'\1:na:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_oblast(:gen)?$', r'\1:v_oblasti:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_oblast_s(:ins)?$', r'\1:s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_obor(:gen)?$', r'\1:v_oboru:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_otázka(:gen)?$', r'\1:v_otázce:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_podoba(:gen)?$', r'\1:v_podobě:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_poměr_k(:dat)?$', r'\1:v_poměru_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_proces(:gen)?$', r'\1:v_procesu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_prospěch(:gen)?$', r'\1:ve_prospěch:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_protiklad_k(:dat)?$', r'\1:v_protikladu_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_průběh(:gen)?$', r'\1:v_průběhu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_případ(:gen)?$', r'\1:v_případě:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_rámec(:gen)?$', r'\1:v_rámci:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_rozpor_s(:ins)?$', r'\1:v_rozporu_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_řada(:gen)?$', r'\1:v_řadě:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_shoda_s(:ins)?$', r'\1:ve_shodě_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_služba(:gen)?$', r'\1:ve_službách:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_směr(:gen)?$', r'\1:ve_směru:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_směr_k(:dat)?$', r'\1:ve_směru_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_smysl(:gen)?$', r'\1:ve_smyslu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_součinnost_s(:ins|:nom)?$', r'\1:v_součinnosti_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_souhlas_s(:ins|:nom)?$', r'\1:v_souhlasu_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_soulad_s(:ins|:nom)?$', r'\1:v_souladu_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_souvislost_s(:ins)?$', r'\1:v_souvislosti_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spojení_s(:ins)?$', r'\1:ve_spojení_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spojený_s(:ins)?$', r'\1:ve_spojení_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spojitost_s(:ins)?$', r'\1:ve_spojitosti_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_spolupráce_s(:ins)?$', r'\1:ve_spolupráci_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_s_spolupráce(:ins)?$', r'\1:ve_spolupráci_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_srovnání_se?(:ins)?$', r'\1:ve_srovnání_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_světlo(:gen)?$', r'\1:ve_světle:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_věc(:gen)?$', r'\1:ve_věci:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_vztah_k(:dat)?$', r'\1:ve_vztahu_k:dat', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_zájem(:gen|:loc)?$', r'\1:v_zájmu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_záležitost(:gen)?$', r'\1:v_záležitosti:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závěr(:gen)?$', r'\1:v_závěru:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závislost_na(:loc)?$', r'\1:v_závislosti_na:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_závislost_s(:ins)?$', r'\1:v_závislosti_s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v_znamení(:gen)?$', r'\1:ve_znamení:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vina(:gen)?$', r'\1:vinou:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vliv(:gen)?$', r'\1:vlivem:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vo:acc$', r'\1:o:acc', edep['deprel']) # colloquial: vo všecko
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):von([_:].+)?$', r'\1', edep['deprel']) # von Neumannem
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):voor([_:].+)?$', r'\1', edep['deprel']) # Hoge Raad voor Diamant
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vzhledem(_k)?(:dat)?$', r'\1:vzhledem_k:dat', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:nom$', r'\1:z:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:ins$', r'\1:s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_důvod(:gen)?$', r'\1:z_důvodu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_hledisko(:gen|:nom)?$', r'\1:z_hlediska:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_oblast(:gen)?$', r'\1:z_oblasti:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_řada(:gen)?$', r'\1:z_řad:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(ať_)?z_strana(:gen)?$', r'\1:ze_strany:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_nedostatek(:gen)?$', r'\1:z_nedostatku:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z_titul(:gen)?$', r'\1:z_titulu:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za:nom$', r'\1:za:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_pomoc(:gen)?$', r'\1:za_pomoci:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_účast(:gen)?$', r'\1:za_účasti:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za_účel(:gen)?$', r'\1:za_účelem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):začátek(:gen)?$', r'\1:začátkem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):zásluha(:gen)?$', r'\1:zásluhou:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):závěr(:gen)?$', r'\1:závěrem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):závisle_na(:loc)?$', r'\1:nezávisle_na:loc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^nmod:že:gen$', 'acl:že', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):že_za:gen$', r'\1:za:gen', edep['deprel'])
 
     def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
         '''

From 613b26373af4fad9e28cc7186c82f1f171038901 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 9 Feb 2022 20:20:34 +0100
Subject: [PATCH 0497/1374] Manually synchronized fixedeprels.py in master with
 the changes done in gum-format.

---
 udapi/block/ud/cs/fixedeprels.py | 56 +++++++++++++++++++-------------
 1 file changed, 33 insertions(+), 23 deletions(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index ac2653c3..b3e551e5 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -55,6 +55,7 @@ class FixEdeprels(Block):
         'kol':              'kolem:gen',
         'kolem':            'kolem:gen',
         'konec':            'koncem:gen',
+        'krom':             'kromě:gen',
         'kromě':            'kromě:gen',
         'liž':              'li',
         'mezi_uvnitř':      'uvnitř:gen',
@@ -211,8 +212,10 @@ class FixEdeprels(Block):
         'zatím_co':         'zatímco',
         'závěr':            'závěrem:gen',
         'závisle_na':       'nezávisle_na:loc',
+        'že':               'že', # remove morphological case
         'že_ať':            'ať',
         'že_jako':          'že',
+        'že_jakoby':        'že',
         'že_za':            'za:gen'
     }
 
@@ -223,14 +226,14 @@ def process_node(self, node):
         abbreviation and its morphological case is unknown.
         """
         for edep in node.deps:
-            m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl):', edep['deprel'])
+            m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):', edep['deprel'])
             if m:
                 bdeprel = m.group(1)
                 solved = False
                 for x in self.unambiguous:
                     # All secondary prepositions have only one fixed morphological case
                     # they appear with, so we can replace whatever case we encounter with the correct one.
-                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl):'+x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?$', edep['deprel'])
+                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?$', edep['deprel'])
                     if m:
                         edep['deprel'] = m.group(1)+':'+self.unambiguous[x]
                         solved = True
@@ -253,19 +256,19 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl):k$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:k$', r'obl:k:dat', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl):k:dat$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:k:dat$', r'obl:k:dat', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):kdy$', r'\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:místo$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
-                edep['deprel'] = re.sub(r'^acl:na_způsob$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
+                edep['deprel'] = re.sub(r'^acl:na_způsob:gen$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
                 edep['deprel'] = re.sub(r'^(advcl):neboť$', r'\1', edep['deprel']) # 'neboť' is coordinating
                 edep['deprel'] = re.sub(r'^(advcl):nechť$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl):od$', r'nmod:od:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):podle$', r'obl:podle:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:pro$', r'obl:pro:acc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl):v$', r'nmod:v:loc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^acl:od:gen$', r'nmod:od:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:podle:gen$', r'obl:podle:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:pro:acc$', r'obl:pro:acc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^acl:v$', r'nmod:v:loc', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:v_duch$', r'obl:v_duchu:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:v_duchu:gen$', r'obl:v_duchu:gen', edep['deprel'])
                 if edep['deprel'] == 'acl:v' and node.form == 'patře':
                     edep['deprel'] = 'nmod:v:loc'
                     node.deprel = 'nmod'
@@ -310,6 +313,8 @@ def process_node(self, node):
                     node.deprel = 'acl:relcl'
                 elif re.match(r'^(obl(:arg)?):li$', edep['deprel']):
                     edep['deprel'] = 'advcl:li'
+                elif re.match(r'^(nmod|obl(:arg)?):mezi:voc$', edep['deprel']):
+                    edep['deprel'] = re.sub(r':voc$', r':acc', edep['deprel'])
                 elif re.match(r'^(nmod|obl(:arg)?):mezi$', edep['deprel']):
                     if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
                         edep['deprel'] += ':acc'
@@ -329,7 +334,8 @@ def process_node(self, node):
                     edep['deprel'] = 'obl:za:acc'
                 elif re.match(r'^(nmod|obl(:arg)?):místo[_:].+$', edep['deprel']) and not re.match(r'^(nmod|obl(:arg)?):místo_aby$', edep['deprel']):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):místo[_:].+$', r'\1:místo:gen', edep['deprel'])
-                elif re.match(r'^(nmod|obl(:arg)?):na$', edep['deprel']):
+                elif re.match(r'^(nmod|obl(:arg)?):na(:gen)?$', edep['deprel']):
+                    edep['deprel'] = re.sub(r':gen$', '', edep['deprel'])
                     # The case is unknown. We need 'acc' or 'loc'.
                     # The locative is probably more frequent but it is not so likely with every noun.
                     # If there is an nummod:gov child, it must be accusative and not locative.
@@ -398,7 +404,6 @@ def process_node(self, node):
                     cnouns = [x for x in node.children if x.ord > node.ord and re.match(r'^(nmod|obl)', x.udeprel)]
                     vs = [x for x in node.children if x.ord < node.ord and x.lemma == 'v']
                     if len(cnouns) > 0 and len(vs) > 0:
-                        logging.info('I am here.')
                         cnoun = cnouns[0]
                         v = vs[0]
                         self.set_basic_and_enhanced(cnoun, node.parent, 'obl', 'obl:ve_spolupráci_s:ins')
@@ -420,26 +425,33 @@ def process_node(self, node):
                     # Instrumental would be possible but unlikely.
                     edep['deprel'] += ':acc'
                 else:
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
+                    # If one of the following expressions occurs followed by another preposition,
+                    # remove the additional preposition. For example, 'i_když_s' becomes just 'i_když'.
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ač([_:].+)?$', r'\1:ač', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ačkoliv?([_:].+)?$', r'\1:ačkoli', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):byť[_:].+$', r'\1:byť', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):i_když[_:].+$', r'\1:i_když', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jak[_:].+$', r'\1:jak', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakkoliv?[_:].+$', r'\1:jakkoli', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jako[_:].+$', r'\1:jako', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby[_:].+$', r'\1:jako', edep['deprel']) # these instances in FicTree should be spelled 'jako by'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):než[_:].+$', r'\1:než', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):protože[_:].+$', r'\1:protože', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):takže[_:].+$', r'\1:takže', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):třebaže[_:].+$', r'\1:třebaže', edep['deprel'])
+                    #
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_?l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(jak_)?ad([_:].+)?$', r'\1', edep['deprel']) # ad infinitum
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):byť[_:].+$', r'\1:byť', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):co(:nom)?$', r'advmod', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):de([_:].+)?$', r'\1', edep['deprel']) # de facto
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):di([_:].+)?$', r'\1', edep['deprel']) # Lido di Jesolo
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):en([_:].+)?$', r'\1', edep['deprel']) # bienvenue en France
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):i_když[_:].+$', r'\1:i_když', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):in([_:].+)?$', r'\1', edep['deprel']) # made in NHL
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):into([_:].+)?$', r'\1', edep['deprel']) # made in NHL
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jak[_:].+$', r'\1:jak', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakkoliv?[_:].+$', r'\1:jakkoli', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jako[_:].+$', r'\1:jako', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby[_:].+$', r'\1:jako', edep['deprel']) # these instances in FicTree should be spelled 'jako by'
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno:nom$', r'\1:jménem:nom', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno(:gen)?$', r'\1:jménem:gen', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi:(nom|dat)$', r'\1:mezi:ins', edep['deprel'])
@@ -447,12 +459,10 @@ def process_node(self, node):
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):of([_:].+)?$', r'\1', edep['deprel']) # University of North Carolina
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):per([_:].+)?$', r'\1', edep['deprel']) # per rollam
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po:(nom|gen)$', r'\1:po:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):protože[_:].+$', r'\1:protože', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před:gen$', r'\1:před:ins', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přestože[_:].+$', r'\1:přestože', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):se?:(nom|acc|ins)$', r'\1:s:ins', edep['deprel']) # accusative: 'být s to' should be a fixed expression and it should be the predicate!
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):takže[_:].+$', r'\1:takže', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):třebaže[_:].+$', r'\1:třebaže', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):shoda(:gen)?$', r'\1', edep['deprel']) # 'shodou okolností' is not a prepositional phrase
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v:gen$', r'\1:v:loc', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vo:acc$', r'\1:o:acc', edep['deprel']) # colloquial: vo všecko
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):von([_:].+)?$', r'\1', edep['deprel']) # von Neumannem

From c691804af00366f60af2cac8fd5823404e1f83bc Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 10 Feb 2022 10:22:33 +0100
Subject: [PATCH 0498/1374] GUM format support (#96)

* global.Entity support

* shortcuts: doc.coref_mentions and tree.document

* reading and writing new (CorefUD 1.0) format of coreference

* oops, bug in detecting discontinuous mentions

* fix ordering of brackets in serialization for crossing mention spans

* change CorefMention.__lt__, document rules for serialization

If two mentions start at the same word,
the longer must be saved first, in the new format.
However, we cannot cycle through `reversed(doc.coref_mentions)`
because that would break the ordering of closing brackets.
The easiest solution seems to be to redefine `CorefMention.__lt__`,
so that it follows the order in which mentions must be stored
in the new format.

* BridgingLinks string represenation now follows the new format

but we can have multiple src mentions in a single `Bridge=` annotation,
e.g. `Entity=(e5(e6|Bridge=e1<e5,e2<e5,e3<e6`,
so instead of `bl=BridgingLinks(src_mention, string, clusters)`,
we need to use a factory method which returns a **list** of BridgingLinks:
`(bl5, bl6) = BridgingLinks.from_string("e1<e5,e2<e5,e3<e6", clusters)`.

Cataphora SplitAnte and Brige are allowed again.

* parsing discontinuous mentions

* bugfix in discontinuous mention parsing

`mention.words += span_to_nodes(mention.head.root, f'{mention.words[-1].ord + 1}-{node.ord}')`
This is slow, but also buggy because if `ord == "20.1"`
then the following ord is not `ord + 1`.

* bugfix in head assignment in discontinuous mentions

if they end with a single-word part

* corefud.PrintClusters mark_head=1

by default, mark the **head** in the sequence of forms

* CorefMention.__init__ now requires words to be specified

* corefud.MarkInterleaved

see #25

* fix bridging serialization

* corefud.FixInterleaved

* use empty string as etype instead of "unk"

If no etype is present, it will be None in the API and an empty string in the serialization

When loading a file where a CorefCluster is created first when being part of `Bridge=`,
it is crated with cluster_type None, but when loading a line with `Entity=`,
its correct cluster_type is loaded.

* BridgingLink should be mutable

so that we can do e.g. `bridge.relation = bridge.relation.lower()`

* fix serialization of discontinuous mentions

We need to break them into (continuous) subspans,
treat each as a fake CorefMention
and sort all mentions (real and fake),
so that they are stored in the correct order.

* corefud.FixInterleaved now fixes also "same-cluster same-subspan"

corefud.MarkSameSubSpan detects such mentions
see https://github.com/ufal/corefUD/issues/26 for details

* don't repeat Bridge for each subspan

* fix Discontinuous nested mention

see https://github.com/ufal/corefUD/issues/28
We need to
* `discontinuous_mentions[eid].pop()` when closing the last subspan
* find the correct mention from `discontinuous_mentions[eid]`
  when opening non-first subspan.
  It does not need to be the top of the stack.
  It is the first opened (i.e. unfinished) mention in `discontinuous_mentions[eid]`, i.e.
```python
opened = [pair[0] for pair in unfinished_mentions[eid]]
mention = next(m for m in discontinuous_mentions[eid] if m not in opened)
```
* We forbid discontinuous crossing same-cluster spans, so we can throw an exception
when closing the last subspan of a mention which is not at the top of the stack
(`_error(f"Closing mention {mention} at {node}, but it has unfinished nested mentions ({m})", 1)`).
See https://github.com/ufal/corefUD/issues/27

* keep node._mentions updated

* fix serialization ordering of single-word mentions

* report whole block name in `logging.info(f"Executing block {bname}")`

* don't allow hyphens and other forbidden chars in cluster IDs

fixes #97

* more elegant implementation of chars forbidden in ID

* escape also round brackets in MentionMisc values

* use empty string for missing/unknown bridging relations

as suggested in #29

This will also prevent `Bridge=c1<c2:|Entity=...`,
i.e. a colon not followed by a label,
which is forbidden by validate.py.

* block corefud.FixCorefUD02 for converting CorefUD 0.2 to 1.0

i.e. fixing various bugs other than corefud.FixInterleaved
and the very format conversion

* rename bridging relations as suggested by @dan-zeman

in https://github.com/ufal/corefUD/issues/29#issuecomment-1032004247

* harmonize etype and gstype

as agreed in
https://github.com/ufal/corefUD/issues/13 and
https://github.com/ufal/corefUD/issues/30.

* This new block could help solve #98.

* We probably do not have to report every instance.

* allow infstat-minspan-identity as extra positional attributes in GUM

* global.Entity won't be written without newdoc

* don't introduce same-span mentions

fixes #98

* allow corefud.MoveHead keep_head_if_possible=0

so that even with non-deterministic heads on the input,
the output will be always the same
Fixes #100

* Selectively propagating changes in one file from master to gum_format.

This block is needed for the conversion of the Czech data, together with the new stuff in gum_format.

* Fixing enhanced dependency labels.

* fix corefud.FixInterleaved so it does not merge an already deleted mention

* If two mentions start in the same node, both can have SplitAnte.

So we need to skipt the test that all SplitAnte links have the same source.
Adding an example:

 `Entity=(e11-person(e12-person)|SplitAnte=e3<e11,e4<e11,e6<e12,e7<e12`
 which means that both e11 and e12 have split antecedents (e11=e3+e4, e12=e6+e7).

* DualDict supports only str values

* Bug fix.

* Another edeprel fix rule.

* thanks @michnov for the review

Co-authored-by: Dan Zeman <zeman@ufal.mff.cuni.cz>
---
 udapi/block/corefud/fixcorefud02.py    |  56 ++
 udapi/block/corefud/fixinterleaved.py  |  82 +++
 udapi/block/corefud/indexclusters.py   |   3 +-
 udapi/block/corefud/markinterleaved.py |  45 ++
 udapi/block/corefud/marksamesubspan.py |  45 ++
 udapi/block/corefud/mergesamespan.py   |  51 ++
 udapi/block/corefud/movehead.py        |   5 +-
 udapi/block/corefud/printclusters.py   |  10 +-
 udapi/block/read/conllu.py             |  14 +-
 udapi/block/read/oldcorefud.py         |  52 +-
 udapi/block/write/conllu.py            |  18 +-
 udapi/block/write/oldcorefud.py        |  10 +-
 udapi/core/basereader.py               |   3 +
 udapi/core/coref.py                    | 796 ++++++++++++++++++++-----
 udapi/core/document.py                 |  10 +
 udapi/core/dualdict.py                 |   2 +-
 udapi/core/root.py                     |   4 +
 udapi/core/run.py                      |  14 +-
 18 files changed, 1046 insertions(+), 174 deletions(-)
 create mode 100644 udapi/block/corefud/fixcorefud02.py
 create mode 100644 udapi/block/corefud/fixinterleaved.py
 create mode 100644 udapi/block/corefud/markinterleaved.py
 create mode 100644 udapi/block/corefud/marksamesubspan.py
 create mode 100644 udapi/block/corefud/mergesamespan.py

diff --git a/udapi/block/corefud/fixcorefud02.py b/udapi/block/corefud/fixcorefud02.py
new file mode 100644
index 00000000..b8fe44f7
--- /dev/null
+++ b/udapi/block/corefud/fixcorefud02.py
@@ -0,0 +1,56 @@
+from udapi.core.block import Block
+import udapi.core.coref
+import itertools
+
+NEW_ETYPE = {
+    "misc": "other",
+    "date": "time",
+    "loc": "place",
+    "location": "place",
+    "per": "person",
+    "org": "organization",
+    "_": "",
+    }
+
+class FixCorefUD02(Block):
+    """Fix errors in CorefUD 0.2 for release of CorefUD 1.0."""
+
+    def process_document(self, doc):
+        # For GUM
+        if doc.meta['global.Entity'] == 'entity-GRP-infstat-MIN-coref_type-identity':
+            doc.meta['global.Entity'] = 'eid-etype-head-other-infstat-minspan-identity'
+
+        for cluster in doc.coref_clusters.values():
+            if cluster.cluster_type:
+                # Harmonize etype.
+                # If gen/spec is distinguished, store it in all mentions' other['gstype'].
+                etype = cluster.cluster_type.lower()
+                if etype.startswith('spec') or etype.startswith('gen'):
+                    gstype = 'gen' if etype.startswith('gen') else 'spec'
+                    for m in cluster.mentions:
+                        m.other['gstype'] = gstype
+                    if etype == 'spec':
+                        etype = 'other'
+                    etype = etype.replace('gen', '').replace('spec', '').replace('.', '')
+                etype = NEW_ETYPE.get(etype, etype)
+                
+                # cluster_type="APPOS" is used only in NONPUBL-CorefUD_English-OntoNotes.
+                # Apposition is a mention-based rather than cluster-based attribute.
+                # We don't know which of the mentions it should be assigned, but let's expect all non-first.
+                # UD marks appositions with deprel appos, so once someone checks it is really redunant,
+                # TODO we can delete the appos mention attribute.
+                if etype == 'appos':
+                    etype = ''
+                    for mention in cluster.mentions[1:]:
+                        mention.other['appos'] = '1'
+                cluster.cluster_type = etype
+
+            for mention in cluster.mentions:
+                # Harmonize bridge relation labels
+                for bridge in mention.bridging:
+                    rel = bridge.relation.lower()
+                    if rel.endswith('-inv'):
+                        rel = 'i' + rel.replace('-inv', '')
+                    rel = rel.replace('-', '')
+                    rel = rel.replace('indirect_', '')
+                    bridge.relation = rel
diff --git a/udapi/block/corefud/fixinterleaved.py b/udapi/block/corefud/fixinterleaved.py
new file mode 100644
index 00000000..6921c680
--- /dev/null
+++ b/udapi/block/corefud/fixinterleaved.py
@@ -0,0 +1,82 @@
+from udapi.core.block import Block
+import udapi.core.coref
+import itertools
+
+class FixInterleaved(Block):
+    """Fix mentions with interleaved or crossing spans."""
+
+    def __init__(self, same_cluster_only=True, both_discontinuous=False,
+                 crossing_only=False, nested_same_subspan=True, **kwargs):
+        super().__init__(**kwargs)
+        self.same_cluster_only = same_cluster_only
+        self.both_discontinuous = both_discontinuous
+        self.crossing_only = crossing_only
+        self.nested_same_subspan = nested_same_subspan
+
+    def process_tree(self, tree):
+        mentions, deleted = set(), set()
+        for node in tree.descendants_and_empty:
+            for m in node.coref_mentions:
+                mentions.add(m)
+
+        for mA, mB in itertools.combinations(mentions, 2):
+            if mA in deleted or mB in deleted:
+                continue
+            if self.same_cluster_only and mA.cluster != mB.cluster:
+                continue
+
+            # Fully nested spans are OK, expect for same-subspan
+            sA, sB = set(mA.words), set(mB.words)
+            if (sA <= sB) or (sB <= sA):
+                if not self.nested_same_subspan:
+                    continue
+                elif not set(mA.span.split(',')).intersection(set(mB.span.split(','))):
+                    continue
+
+            # Crossing or interleaved+crossing?
+            elif self.crossing_only:
+                if not sA.intersection(sB):
+                    continue
+            else:
+                if mA.words[0] < mB.words[0] and mA.words[-1] < mB.words[0]:
+                    continue
+                if mB.words[0] < mA.words[0] and mB.words[-1] < mA.words[0]:
+                    continue
+
+            if self.both_discontinuous and (',' not in mA.span or ',' not in mB.span):
+                continue
+
+            mA.words = list(sA.union(sB))
+            for wb in sB:
+                try:
+                    wb._mentions.remove(mB)
+                except ValueError:
+                    pass
+            try:
+                mB.cluster.mentions.remove(mB)
+            except ValueError:
+                pass
+            deleted.add(mB)
+
+            # By changing the mA.words, we could have create another error:
+            # making the span same as another mention. Let's fix it
+            sA = set(mA.words)
+            for mC in mentions:
+                if mC in deleted or mC is mA or mC is mB:
+                    continue
+                if sA != set(mC.words):
+                    continue
+                # So mA and mC have the same span and we need to delete one of them to fix it.
+                # We will delete mA because it has the artificially enlarged span,
+                # while mC is from the original annotation.
+                for wa in sA:
+                    try:
+                        wa._mentions.remove(mA)
+                    except ValueError:
+                        pass
+                try:
+                    mA.cluster.mentions.remove(mA)
+                except ValueError:
+                    pass
+                break
+                deleted.add(mA)
diff --git a/udapi/block/corefud/indexclusters.py b/udapi/block/corefud/indexclusters.py
index dee45544..1496c11c 100644
--- a/udapi/block/corefud/indexclusters.py
+++ b/udapi/block/corefud/indexclusters.py
@@ -27,8 +27,7 @@ def process_document(self, doc):
         for idx, cid in enumerate(clusters, self.start):
             cluster = clusters[cid]
             new_cid = "c" + str(idx)
-            # need to change private variable
-            cluster._cluster_id = new_cid
+            cluster.cluster_id = new_cid
             new_clusters[new_cid] = cluster
         self.start = idx + 1
         doc._coref_clusters = new_clusters
diff --git a/udapi/block/corefud/markinterleaved.py b/udapi/block/corefud/markinterleaved.py
new file mode 100644
index 00000000..ac4d9438
--- /dev/null
+++ b/udapi/block/corefud/markinterleaved.py
@@ -0,0 +1,45 @@
+from udapi.core.block import Block
+import udapi.core.coref
+import itertools
+
+class MarkInterleaved(Block):
+    """Find mentions with interleaved spans."""
+
+    def __init__(self, same_cluster_only=False, both_discontinuous=False, print_form=False,
+                 log=True, mark=True, **kwargs):
+        super().__init__(**kwargs)
+        self.same_cluster_only = same_cluster_only
+        self.both_discontinuous = both_discontinuous
+        self.print_form = print_form
+        self.log = log
+        self.mark = mark
+
+    def _print(self, mention):
+        if self.print_form:
+            return mention.cluster.cluster_id + ':' + ' '.join([w.form for w in mention.words])
+        else:
+            return mention.cluster.cluster_id + ':' + mention.span
+
+    def process_tree(self, tree):
+        mentions = set()
+        for node in tree.descendants_and_empty:
+            for m in node.coref_mentions:
+                mentions.add(m)
+        if len(mentions) > 1:
+            for mA, mB in itertools.combinations(mentions, 2):
+                if set(mA.words).intersection(set(mB.words)):
+                    continue
+                if mA.words[0] < mB.words[0] and mA.words[-1] < mB.words[0]:
+                    continue
+                if mB.words[0] < mA.words[0] and mB.words[-1] < mA.words[0]:
+                    continue
+                if self.same_cluster_only and mA.cluster != mB.cluster:
+                    continue
+                if self.both_discontinuous and (',' not in mA.span or ',' not in mB.span):
+                    continue
+                if self.mark:
+                    for w in mA.words + mB.words:
+                        w.misc['Mark'] = 1
+                    mA.words[0].misc['Mark'] = f"{self._print(mA)}+{self._print(mB)}"
+                if self.log:
+                    print(f"interleaved mentions at {tree.sent_id}: {self._print(mA)} + {self._print(mB)}")
diff --git a/udapi/block/corefud/marksamesubspan.py b/udapi/block/corefud/marksamesubspan.py
new file mode 100644
index 00000000..f99e0e13
--- /dev/null
+++ b/udapi/block/corefud/marksamesubspan.py
@@ -0,0 +1,45 @@
+from udapi.core.block import Block
+import udapi.core.coref
+import itertools
+
+class MarkSameSubSpan(Block):
+    """Find mentions with the same subspan."""
+
+    def __init__(self, same_cluster_only=False, both_discontinuous=False, print_form=False, nested_only=False,
+                 log=True, mark=True, **kwargs):
+        super().__init__(**kwargs)
+        self.same_cluster_only = same_cluster_only
+        self.both_discontinuous = both_discontinuous
+        self.nested_only = nested_only
+        self.print_form = print_form
+        self.log = log
+        self.mark = mark
+
+    def _print(self, mention):
+        if self.print_form:
+            return mention.cluster.cluster_id + ':' + ' '.join([w.form for w in mention.words])
+        else:
+            return mention.cluster.cluster_id + ':' + mention.span
+
+    def process_tree(self, tree):
+        mentions = set()
+        for node in tree.descendants_and_empty:
+            for m in node.coref_mentions:
+                mentions.add(m)
+        if len(mentions) > 1:
+            for mA, mB in itertools.combinations(mentions, 2):
+                if self.same_cluster_only and mA.cluster != mB.cluster:
+                    continue
+                if self.both_discontinuous and (',' not in mA.span or ',' not in mB.span):
+                    continue
+                sA, sB = set(mA.words), set(mB.words)
+                if self.nested_only and not (sA <= sB) and not (sB <= sA):
+                    continue
+                if not set(mA.span.split(',')).intersection(set(mB.span.split(','))):
+                    continue
+                if self.mark:
+                    for w in mA.words + mB.words:
+                        w.misc['Mark'] = 1
+                    mA.words[0].misc['Mark'] = f"{self._print(mA)}+{self._print(mB)}"
+                if self.log:
+                    print(f"same-subspan mentions at {tree.sent_id}: {self._print(mA)} + {self._print(mB)}")
diff --git a/udapi/block/corefud/mergesamespan.py b/udapi/block/corefud/mergesamespan.py
new file mode 100644
index 00000000..d5a46d25
--- /dev/null
+++ b/udapi/block/corefud/mergesamespan.py
@@ -0,0 +1,51 @@
+from udapi.core.block import Block
+import udapi.core.coref
+import itertools
+import logging
+
+class MergeSameSpan(Block):
+    """
+    Multiple same-span mentions are considered invalid in CoNLL-U, whether they
+    belong to the same entity or not. If they occur, merge them into one.
+    Note: We currently do not have mentions across sentence boundaries in the
+    CorefUD data, so this block processes one sentence at a time.
+    """
+
+    def __init__(self, same_cluster_only=False, **kwargs):
+        super().__init__(**kwargs)
+        self.same_cluster_only = same_cluster_only
+
+    def process_tree(self, tree):
+        mentions = set()
+        for node in tree.descendants_and_empty:
+            for m in node.coref_mentions:
+                mentions.add(m)
+
+        for mA, mB in itertools.combinations(mentions, 2):
+            if self.same_cluster_only and mA.cluster != mB.cluster:
+                continue
+
+            sA, sB = set(mA.words), set(mB.words)
+            if sA != sB:
+                continue
+
+            # If the mentions belong to different clusters, we should merge the
+            # clusters first, i.e., pick one cluster as the survivor, move the
+            # mentions from the other cluster to this cluster, and remove the
+            # other cluster.
+            if mA.cluster != mB.cluster:
+                logging.warning("Merging same-span mentions that belong to different entities: '%s' vs. '%s'." % (mA.cluster.cluster_id, mB.cluster.cluster_id))
+                ###!!! TODO: As of now, changing the cluster of a mention is not supported in the API.
+                #for m in mB.cluster.mentions:
+                #    m.cluster = mA.cluster
+            # Remove mention B. It may have been removed earlier because of
+            # another duplicate, that is the purpose of try-except.
+            for wb in sB:
+                try:
+                    wb._mentions.remove(mB)
+                except ValueError:
+                    pass
+            try:
+                mB.cluster.mentions.remove(mB)
+            except ValueError:
+                pass
diff --git a/udapi/block/corefud/movehead.py b/udapi/block/corefud/movehead.py
index e9034a22..2a38bd82 100644
--- a/udapi/block/corefud/movehead.py
+++ b/udapi/block/corefud/movehead.py
@@ -6,9 +6,10 @@
 class MoveHead(Block):
     """Block corefud.MoveHead moves the head to the highest node in each mention."""
 
-    def __init__(self, bugs='warn', **kwargs):
+    def __init__(self, bugs='warn', keep_head_if_possible=True, **kwargs):
         self.counter = Counter()
         self.bugs = bugs
+        self.keep_head_if_possible = keep_head_if_possible
         super().__init__(**kwargs)
 
     def _eparents(self, node):
@@ -68,7 +69,7 @@ def find_head(self, mention):
                 mention.head.misc['Bug'] = 'highest-head'
 
         # Fifth, try to convervatively preserve the original head, if it is one of the possible heads.
-        if mention.head in enh_heads:
+        if self.keep_head_if_possible and mention.head in enh_heads:
             return mention.head, 'nontreelet'
 
         # Finally, return the word-order-wise first head candidate as the head.
diff --git a/udapi/block/corefud/printclusters.py b/udapi/block/corefud/printclusters.py
index a9a03f5e..7271ae78 100644
--- a/udapi/block/corefud/printclusters.py
+++ b/udapi/block/corefud/printclusters.py
@@ -6,17 +6,20 @@
 class PrintClusters(Block):
     """Block corefud.PrintClusters prints all mentions of a given cluster."""
 
-    def __init__(self, id_re=None, min_mentions=0, print_ranges=True, aggregate_mentions=True, **kwargs):
+    def __init__(self, id_re=None, min_mentions=0, print_ranges=True, mark_head=True,
+                 aggregate_mentions=True, **kwargs):
         """Params:
         id_re: regular expression constraining ClusterId of the clusters to be printed
         min_mentions: print only clusters with with at least N mentions
         print_ranges: print also addressess of all mentions
                       (compactly, using the longest common prefix of sent_id)
+        mark_head: mark the head (e.g. as "red **car**")
         """
         super().__init__(**kwargs)
         self.id_re = re.compile(str(id_re)) if id_re else None
         self.min_mentions = min_mentions
         self.print_ranges = print_ranges
+        self.mark_head = mark_head
         self.aggregate_mentions = aggregate_mentions
 
     def process_document(self, doc):
@@ -32,7 +35,7 @@ def process_document(self, doc):
                 counter = Counter()
                 ranges = defaultdict(list)
                 for mention in cluster.mentions:
-                    forms = ' '.join([w.form for w in mention.words])
+                    forms = ' '.join([f"**{w.form}**" if self.mark_head and w is mention.head else w.form for w in mention.words])
                     counter[forms] += 1
                     if self.print_ranges:
                         ranges[forms].append(mention.head.root.address() + ':' +mention.span)
@@ -46,6 +49,7 @@ def process_document(self, doc):
                             print(f'        {prefix} ({" ".join(f[len(prefix):] for f in ranges[form])})')
             else:
                 for mention in cluster.mentions:
-                    print('   ' + ' '.join([w.form for w in mention.words]))
+                    forms = ' '.join([f"**{w.form}**" if self.mark_head and w is mention.head else w.form for w in mention.words])
+                    print('   ' + forms)
                     if self.print_ranges:
                         print(f"     {mention.head.root.address()}:{mention.span}")
diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 71886752..97e39970 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -14,6 +14,7 @@
 RE_TEXT = re.compile(r'^# text\s*=\s*(.*)')
 RE_NEWPARDOC = re.compile(r'^# (newpar|newdoc)(?:\s+id\s*=\s*(.+))?')
 RE_JSON = re.compile(r'^# (doc_)?json_([^ =]+)\s*=\s*(.+)')
+RE_GLOBAL_ENTITY = re.compile(r'^# global.Entity\s*=\s*(\S+)')
 
 
 class Conllu(BaseReader):
@@ -33,8 +34,7 @@ def __init__(self, strict=False, empty_parent='warn', fix_cycles=False, **kwargs
         self.empty_parent = empty_parent
         self.fix_cycles = fix_cycles
 
-    @staticmethod
-    def parse_comment_line(line, root):
+    def parse_comment_line(self, line, root):
         """Parse one line of CoNLL-U and fill sent_id, text, newpar, newdoc in root."""
         sent_id_match = RE_SENT_ID.match(line)
         if sent_id_match is not None:
@@ -68,6 +68,16 @@ def parse_comment_line(line, root):
                 container = root.json['__doc__']
             container[json_match.group(2)] = json.loads(json_match.group(3))
             return
+
+        entity_match = RE_GLOBAL_ENTITY.match(line)
+        if entity_match is not None:
+            global_entity = entity_match.group(1)
+            if self._global_entity and self._global_entity != global_entity:
+                logging.warning("Mismatch in global.Entity: %s != %s", (self._global_entity, global_entity))
+            self._global_entity = global_entity
+            root.comment += '$GLOBAL.ENTITY\n'
+            return
+
         root.comment += line[1:] + "\n"
 
     def read_trees(self):
diff --git a/udapi/block/read/oldcorefud.py b/udapi/block/read/oldcorefud.py
index a7bc3101..539d5036 100644
--- a/udapi/block/read/oldcorefud.py
+++ b/udapi/block/read/oldcorefud.py
@@ -6,6 +6,33 @@
 
 class OldCorefUD(udapi.block.read.conllu.Conllu):
 
+    def __init__(self, replace_hyphen_in_id_with='', **kwargs):
+        """Create the read.OldCorefUD reader object.
+
+        Args:
+        substitute_hyphen_in_id_for: string to use as a replacement for hyphens in ClusterId
+          The new format does not allow hyphens in eid (IDs of entity clusters),
+          so we need to replace them.
+        """
+        super().__init__(**kwargs)
+        self.replace_hyphen_in_id_with = replace_hyphen_in_id_with
+        self.orig2new = {}
+        self.new2orig = {}
+
+    def _fix_id(self, cid):
+        if not cid or '-' not in cid:
+            return cid
+        new_cid = self.orig2new.get(cid)
+        if new_cid is None:
+            new_cid = cid.replace('-', self.replace_hyphen_in_id_with)
+            base, counter = new_cid, 1
+            while new_cid in self.new2orig:
+                counter += 1
+                new_cid = f"{base}{counter}"
+            self.new2orig[new_cid] = cid
+            self.orig2new[cid] = new_cid
+        return new_cid
+
     def process_document(self, doc, strict=True):
         super().process_document(doc)
 
@@ -16,25 +43,32 @@ def process_document(self, doc, strict=True):
             if not cluster_id:
                 index, index_str = 1, "[1]"
                 cluster_id = node.misc["ClusterId[1]"]
+            cluster_id = self._fix_id(cluster_id)
             while cluster_id:
                 cluster = clusters.get(cluster_id)
                 if cluster is None:
                     cluster = CorefCluster(cluster_id)
                     clusters[cluster_id] = cluster
-                mention = CorefMention(node, cluster)
+                mention = CorefMention(words=[node], cluster=cluster)
                 if node.misc["MentionSpan" + index_str]:
                     mention.span = node.misc["MentionSpan" + index_str]
-                else:
-                    mention.words = [node]
                 cluster_type = node.misc["ClusterType" + index_str]
-                if cluster_type is not None:
+                if cluster_type:
                     if cluster.cluster_type is not None and cluster_type != cluster.cluster_type:
                         logging.warning(f"cluster_type mismatch in {node}: {cluster.cluster_type} != {cluster_type}")
                     cluster.cluster_type = cluster_type
 
                 bridging_str = node.misc["Bridging" + index_str]
                 if bridging_str:
-                    mention._bridging = BridgingLinks(mention, bridging_str, clusters, strict)
+                    mention._bridging = BridgingLinks(mention)
+                    for link_str in bridging_str.split(','):
+                        target, relation = link_str.split(':')
+                        target = self._fix_id(target)
+                        if target == cluster_id:
+                            _error("Bridging cannot self-reference the same cluster: " + target, strict)
+                        if target not in clusters:
+                            clusters[target] = CorefCluster(target)
+                        mention._bridging.append((clusters[target], relation))
 
                 split_ante_str = node.misc["SplitAnte" + index_str]
                 if split_ante_str:
@@ -42,6 +76,7 @@ def process_document(self, doc, strict=True):
                     # TODO in CorefUD draft "+" was used as the separator, but it was changed to comma.
                     # We can delete `.replace('+', ',')` once there are no more data with the legacy plus separator.
                     for ante_str in split_ante_str.replace('+', ',').split(','):
+                        ante_str = self._fix_id(ante_str)
                         if ante_str in clusters:
                             if ante_str == cluster_id:
                                 _error("SplitAnte cannot self-reference the same cluster: " + cluster_id, strict)
@@ -53,10 +88,13 @@ def process_document(self, doc, strict=True):
                             split_antes.append(ante_cl)
                     cluster.split_ante = sorted(split_antes)
 
-                mention.misc = node.misc["MentionMisc" + index_str]
+                # Some CorefUD 0.2 datasets (e.g. ARRAU) separate key-value pairs with spaces instead of commas.
+                # We also need to escape forbidden characters.
+                mmisc = node.misc["MentionMisc" + index_str].replace(' ', ',')
+                mention.other = mmisc.replace('-', '%2D').replace('(', '%28').replace(')', '%29')
                 index += 1
                 index_str = f"[{index}]"
-                cluster_id = node.misc["ClusterId" + index_str]
+                cluster_id = self._fix_id(node.misc["ClusterId" + index_str])
         # c=doc.coref_clusters should be sorted, so that c[0] < c[1] etc.
         # In other words, the dict should be sorted by the values (according to CorefCluster.__lt__),
         # not by the keys (cluster_id).
diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index 66ae320b..abe20963 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -26,7 +26,7 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
         # If tree.comment contains placeholders $NEWDOC,...$TEXT, replace them with the actual
         # value of the attribute and make note on which line (i_*) they were present.
         comment_lines = tree.comment.splitlines()
-        i_newdoc, i_newpar, i_sent_id, i_text = -1, -1, -1, -1
+        i_newdoc, i_newpar, i_sent_id, i_text, i_global_entity = -1, -1, -1, -1, -1
         for i, c_line in enumerate(comment_lines):
             if c_line == '$SENT_ID':
                 i_sent_id = i
@@ -50,6 +50,13 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
                     comment_lines[i] = ' newpar' + (' id = ' + tree.newpar if tree.newpar is not True else '')
                 else:
                     comment_lines[i] = None
+            elif c_line == '$GLOBAL.ENTITY':
+                i_global_entity = i
+                ge = tree.document.meta.get('global.Entity')
+                if ge:
+                    comment_lines[i] = ' global.Entity = ' + ge
+                else:
+                    comment_lines[i] = None
 
         # Now print the special comments: global.columns, newdoc, newpar, sent_id and text.
         # If these comments were already present in tree.comment (as marked with the placeholders),
@@ -68,6 +75,15 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
                         printed_i += 1
                         if comment_lines[printed_i]:
                             print('#' + comment_lines[printed_i])
+                ge = tree.document.meta.get('global.Entity')
+                if ge:
+                    if i_global_entity == -1:
+                        print('# global.Entity = ' + ge)
+                    else:
+                        while printed_i < i_global_entity:
+                            printed_i += 1
+                            if comment_lines[printed_i]:
+                                print('#' + comment_lines[printed_i])
             if tree.newpar:
                 if i_newpar == -1:
                     print('# newpar' + (' id = ' + tree.newpar if tree.newpar is not True else ''))
diff --git a/udapi/block/write/oldcorefud.py b/udapi/block/write/oldcorefud.py
index c6c38cbe..4eb316bb 100644
--- a/udapi/block/write/oldcorefud.py
+++ b/udapi/block/write/oldcorefud.py
@@ -6,9 +6,8 @@
 class OldCorefUD(udapi.block.write.conllu.Conllu):
 
     def process_document(self, doc):
-        if not doc._coref_clusters:
+        if not doc.coref_clusters:
             logging.warning("Using write.OldCorefUD on a document without any coreference annotation")
-            doc._coref_clusters = {}
 
         # Delete both new-style (GUM-style) and old-style (CorefUD 0.1) coreference annotations from MISC.
         attrs = "Entity Split Bridge ClusterId MentionSpan ClusterType Bridging SplitAnte MentionMisc".split()
@@ -16,6 +15,7 @@ def process_document(self, doc):
             for key in list(node.misc):
                 if any(re.match(attr + r'(\[\d+\])?$', key) for attr in attrs):
                     del node.misc[key]
+        del doc.meta['global.Entity']
 
         # doc._coref_clusters is a dict, which is insertion ordered in Python 3.7+.
         # The insertion order is sorted according to CorefCluster.__lt__ (see few lines above).
@@ -48,11 +48,11 @@ def process_document(self, doc):
                 head.misc["MentionSpan" + index_str] = mention.span
                 head.misc["ClusterType" + index_str] = cluster.cluster_type
                 if mention._bridging:
-                    head.misc["Bridging" + index_str] = str(mention.bridging)
+                    head.misc["Bridging" + index_str] = ','.join(f'{l.target.cluster_id}:{l.relation}' for l in sorted(mention.bridging))
                 if cluster.split_ante:
                     serialized = ','.join((c.cluster_id for c in sorted(cluster.split_ante)))
                     head.misc["SplitAnte" + index_str] = serialized
-                if mention.misc:
-                    head.misc["MentionMisc" + index_str] = mention.misc
+                if mention.other:
+                    head.misc["MentionMisc" + index_str] = str(mention.other).replace('%2D', '-')
 
         super().process_document(doc)
diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 05f204b9..fee9da4c 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -28,6 +28,7 @@ def __init__(self, files='-', filehandle=None, zone='keep', bundles_per_doc=0, e
             logging.debug('Using sent_id_filter=%s', sent_id_filter)
         self.split_docs = split_docs
         self.ignore_sent_id = ignore_sent_id
+        self._global_entity = None
 
     @staticmethod
     def is_multizone_reader():
@@ -110,6 +111,7 @@ def try_fast_load(self, document):
             return False
 
         document.meta['loaded_from'] = self.filename
+        document.meta['global.Entity'] = self._global_entity
         if trees and trees[0].newdoc and trees[0].newdoc is not True:
             document.meta["docname"] = trees[0].newdoc
 
@@ -187,6 +189,7 @@ def process_document(self, document):
                     break
                 if trees_loaded == 0:
                     document.meta['loaded_from'] = self.filename
+                    document.meta['global.Entity'] = self._global_entity
                 add_to_the_last_bundle = False
                 trees_loaded += 1
 
diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 6236e4cf..aaaa07f0 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -1,42 +1,172 @@
-"""Classes for handling coreference."""
+"""Classes for handling coreference.
+
+# CorefUD 1.0 format implementation details
+
+## Rules for ordering "chunks" within `node.misc['Entity']`
+Entity mentions are annotated using "chunks" stored in `misc['Entity']`.
+Chunks are of three types:
+1. opening bracket, e.g. `(e1-person`
+2. closing bracket, e.g. `e1-person)`
+3. single-word span (both opening and closing), e.g. `(e1-person)`
+
+The `Entity` MISC attribute contains a sequence of chunks
+without any separators, e.g. `Entity=(e1-person(e2-place)`
+means opening `e1` mention and single-word `e2` mention
+starting on a given node.
+
+### Crossing mentions
+Two mentions are crossing iff their spans have non-empty intersection,
+but neither is a subset of the other, e.g. `e1` spanning nodes 1-3
+and `e2` spanning 2-4 would be represented as:
+```
+1 ... Entity=(e1
+2 ... Entity=(e2
+3 ... Entity=e1)
+4 ... Entity=e2)
+```
+This may be an annotation error and we may forbid such cases in future annotation guidelines,
+but in CorefUD 0.2, there are thousands of such cases (see https://github.com/ufal/corefUD/issues/23).
+
+It can even happen that one entity ends and another starts at the same node: `Entity=e1)(e2`
+For this reason, we need
+
+**Rule1**: closing brackets MUST always precede opening brackets.
+Otherwise, we would get `Entity=(e2e1)`, which could not be parsed.
+
+Note that we cannot have same-entity crossing mentions in the CorefUD 1.0 format,
+so e.g. if we substitute `e2` with `e1` in the example above, we'll get
+`(e1`, `e1)`, `(e1`, `e1)`, which will be interpreted as two non-overlapping mentions of the same entity.
+
+### Nested mentions
+One mention (span) can be often embedded within another mention (span).
+It can happen that both these mentions correspond to the same entity (i.e. are in the same cluster),
+for example, "`<the man <who> sold the world>`".
+It can even happen that both mentions start at the same node, e.g. "`<<w1 w2> w3>`" (TODO: find nice real-world examples).
+In such cases, we need to make sure the brackets are well-nested:
+
+**Rule2**: when opening multiple brackets at the same node, longer mentions MUST be opened first.
+
+This is important because
+- The closing bracket has the same form for both mentions of the same entity - it includes just the entity ID (`eid`).
+- The opening-bracket annotation contains other mention attributes, e.g. head index.
+- The two mentions may differ in these attributes, e.g. the "`<w1 w2 w3>`" mention's head may be w3.
+- When breaking Rule2, we would get
+```
+1 w1 ... Entity=(e1-person-1(e1-person-3
+2 w2 ... Entity=e1)
+3 w3 ... Entity=e1)
+```
+which would be interpreted as if the head of the "`<w1 w2>`" mention is its third word, which is invalid.
+
+### Other rules
+
+**Rule3**: when closing multiple brackets at the same node, shorter mentions SHOULD be closed first.
+See Rule4 for a single exception from this rule regarding crossing mentions.
+I'm not aware of any problems when breaking this rule, but it seems intuitive
+(to make the annotation well-nested if possible) and we want to define some canonical ordering anyway.
+The API should be able to load even files breaking Rule3.
+
+**Rule4**: single-word chunks SHOULD follow all opening brackets and precede all closing brackets if possible.
+When considering single-word chunks as a subtype of both opening and closing brackets,
+this rule follows from the well-nestedness (and Rule2).
+So we should have `Entity=(e1(e2)` and `Entity=(e3)e1)`,
+but the API should be able to load even `Entity=(e2)(e1` and `Entity=e1)(e3)`.
+
+In case of crossing mentions (annotated following Rule1), we cannot follow Rule4.
+If we want to add a single-word mention `e2` to a node with `Entity=e1)(e3`,
+it seems intuitive to prefer Rule2 over Rule3, which results in `Entity=e1)(e3(e2)`.
+So the canonical ordering will be achieved by placing single-word chunks after all opening brackets.
+The API should be able to load even `Entity=(e2)e1)(e3` and `Entity=e1)(e2)(e3`.
+
+**Rule5**: ordering of same-span single-word mentions
+TODO: I am not sure here. We may want to forbid such cases or define canonical ordering even for them.
+E.g. `Entity=(e1)(e2)` vs. `Entity=(e2)(e1)`.
+
+**Rule6**: ordering of same-start same-end multiword mentions
+TODO: I am not sure here.
+These can be either same-span multiword mentions (which may be forbidden)
+or something like
+```
+1 w1 ... Entity=(e1(e2[1/2])
+2 w2 ...
+3 w3 ... Entity=(e2[2/2])e1)
+```
+where both `e1` and `e2` start at w1 and end at w3, but `e2` is discontinuous and does not contain w2.
+If we interpret "shorter" and "longer" in Rule2 and Rule3 as `len(mention.words)`
+(and not as `mention.words[-1].ord - mention.words[0].ord`),
+we get the canonical ordering as in the example above.
+
+"""
 import re
 import functools
 import collections
+import collections.abc
+import copy
 import logging
 
 @functools.total_ordering
 class CorefMention(object):
     """Class for representing a mention (instance of an entity)."""
-    __slots__ = ['_head', '_cluster', '_bridging', '_words', 'misc']
+    __slots__ = ['_head', '_cluster', '_bridging', '_words', '_other']
 
-    def __init__(self, head, cluster=None):
-        self._head = head
+    def __init__(self, words, head=None, cluster=None):
+        if not words:
+            raise ValueError("mention.words must be non-empty")
+        self._words = words
+        self._head = head if head else words[0]
         self._cluster = cluster
         if cluster is not None:
             cluster._mentions.append(self)
         self._bridging = None
-        self._words = []
-        self.misc = None
+        self._other = None
 
-    def __lt__(self, other):
-        """Does this mention precedes (word-order wise) the `other` mention?
+    def __lt__(self, another):
+        """Does this mention precedes (word-order wise) `another` mention?
 
         This method defines a total ordering of all mentions
-        (within one cluster or across different clusters).
-        The position is primarily defined by the first word in each mention
-        (or by the head if mention.words are missing).
+        (within one entity or across different entities).
+        The position is primarily defined by the first word in each mention.
         If two mentions start at the same word,
-        their order is defined by the last word in their span
-        -- the shorter mention precedes the longer one.
+        their order is defined by their length (i.e. number of words)
+        -- the shorter mention follows the longer one.
+
+        In the rare case of two same-length mentions starting at the same word, but having different spans,
+        their order is defined by the order of the last word in their span.
+        For example <w1, w2> precedes <w1, w3>.
+
+        The order of two same-span mentions is currently defined by their cluster_id.
+        There should be no same-span (or same-subspan) same-cluster mentions.
         """
-        node1 = self._words[0] if self._words else self._head
-        node2 = other._words[0] if other._words else other._head
-        if node1 is node2:
-            node1 = self._words[-1] if self._words else self._head
-            node2 = other._words[-1] if other._words else other._head
-            if node1 is node2:
-                return len(self._words) < len(other._words)
-        return node1.precedes(node2)
+        #TODO: no mention.words should be handled already when loading
+        if not self._words:
+            self._words = [self._head]
+        if not another._words:
+            another._words = [another._head]
+
+        if self._words[0] is another._words[0]:
+            if len(self._words) > len(another._words):
+                return True
+            if  len(self._words) < len(another._words):
+                return False
+            if self._words[-1].precedes(another._words[-1]):
+                return True
+            if another._words[-1].precedes(self._words[-1]):
+                return False
+            return self._cluster.cluster_id < another._cluster.cluster_id
+        return self._words[0].precedes(another._words[0])
+
+    @property
+    def other(self):
+        if self._other is None:
+            self._other = OtherDualDict()
+        return self._other
+
+    @other.setter
+    def other(self, value):
+        if self._other is None:
+            self._other = OtherDualDict(value)
+        else:
+            self._other.set_mapping(value)
 
     @property
     def head(self):
@@ -74,7 +204,7 @@ def words(self):
     @words.setter
     def words(self, new_words):
         if new_words and self.head not in new_words:
-            raise ValueError(f"Head {self.head} not in new_words {new_words}")
+            raise ValueError(f"Head {self.head} not in new_words {new_words} for {self._cluster.cluster_id}")
         kept_words = []
         for old_word in self._words:
             if old_word in new_words:
@@ -100,19 +230,24 @@ def span(self, new_span):
         self.words = span_to_nodes(self._head.root, new_span)
 
 
+CHARS_FORBIDDEN_IN_ID = "-=| \t()"
+
+
 @functools.total_ordering
 class CorefCluster(object):
     """Class for representing all mentions of a given entity."""
     __slots__ = ['_cluster_id', '_mentions', 'cluster_type', 'split_ante']
 
     def __init__(self, cluster_id, cluster_type=None):
+        if any(x in cluster_id for x in CHARS_FORBIDDEN_IN_ID):
+            raise ValueError(f"{cluster_id} contains forbidden characters [{CHARS_FORBIDDEN_IN_ID}]")
         self._cluster_id = cluster_id
         self._mentions = []
         self.cluster_type = cluster_type
         self.split_ante = []
 
-    def __lt__(self, other):
-        """Does this CorefCluster precedes (word-order wise) the `other` cluster?
+    def __lt__(self, another):
+        """Does this CorefCluster precedes (word-order wise) `another` cluster?
 
         This method defines a total ordering of all clusters
         by the first mention of each cluster (see `CorefMention.__lt__`).
@@ -121,18 +256,24 @@ def __lt__(self, other):
         If cluster IDs are not important, it is recommended to use block
         `corefud.IndexClusters` to re-name cluster IDs in accordance with this cluster ordering.
         """
-        if not self._mentions or not other._mentions:
+        if not self._mentions or not another._mentions:
             # Clusters without mentions should go first, so the ordering is total.
             # If both clusters are missing mentions, let's use cluster_id, so the ordering is stable.
-            if not self._mentions and not other._mentions:
-                return self._cluster_id < other._cluster_id
+            if not self._mentions and not another._mentions:
+                return self._cluster_id < another._cluster_id
             return not self._mentions
-        return self._mentions[0] < other._mentions[0]
+        return self._mentions[0] < another._mentions[0]
 
     @property
     def cluster_id(self):
         return self._cluster_id
 
+    @cluster_id.setter
+    def cluster_id(self, new_cluster_id):
+        if any(x in new_cluster_id for x in "-=| \t"):
+            raise ValueError(f"{new_cluster_id} contains forbidden characters [-=| \\t]")
+        self._cluster_id = new_cluster_id
+
     @property
     def mentions(self):
         return self._mentions
@@ -181,7 +322,26 @@ def all_bridging(self):
                     yield b
 
 
-BridgingLink = collections.namedtuple('BridgingLink', 'target relation')
+# BridgingLink
+# Especially the relation should be mutable, so we cannot use
+#   BridgingLink = collections.namedtuple('BridgingLink', 'target relation')
+# TODO once dropping support for Python 3.6, we could use
+#   from dataclasses import dataclass
+#   @dataclass
+#   class DataClassCard:
+#      target: CorefCluster
+#      relation: str
+class BridgingLink:
+    __slots__ = ['target', 'relation']
+
+    def __init__(self, target, relation=''):
+        self.target = target
+        self.relation = '' if relation is None else relation
+
+    def __lt__(self, another):
+        if self.target == another.target:
+            return self.relation < another.relation
+        return self.target < another.target
 
 
 class BridgingLinks(collections.abc.MutableSequence):
@@ -189,33 +349,52 @@ class BridgingLinks(collections.abc.MutableSequence):
 
     Example usage:
     >>> bl = BridgingLinks(src_mention)                                   # empty links
-    >>> bl = BridgingLinks(src_mention, [(c12, 'Part'), (c56, 'Subset')]) # from a list of tuples
-    >>> bl = BridgingLinks(src_mention, 'c12:Part,c56:Subset', clusters)  # from a string
+    >>> bl = BridgingLinks(src_mention, [(c12, 'part'), (c56, 'subset')]) # from a list of tuples
+    >>> (bl8, bl9) = BridgingLinks.from_string('c12<c8:part,c56<c8:subset,c5<c9', clusters)
     >>> for cluster, relation in bl:
     >>>     print(f"{bl.src_mention} ->{relation}-> {cluster.cluster_id}")
-    >>> print(str(bl)) # c12:Part,c56:Subset
-    >>> bl('Part').targets == [c12]
-    >>> bl('Part|Subset').targets == [c12, c56]
-    >>> bl.append((c89, 'Funct'))
+    >>> print(str(bl)) # c12<c8:part,c56<c8:subset
+    >>> bl('part').targets == [c12]
+    >>> bl('part|subset').targets == [c12, c56]
+    >>> bl.append((c57, 'funct'))
     """
-    def __init__(self, src_mention, value=None, clusters=None, strict=True):
+
+    @classmethod
+    def from_string(cls, string, clusters, strict=True):
+        src_str2bl = {}
+        for link_str in string.split(','):
+            try:
+                trg_str, src_str = link_str.split('<')
+            except ValueError as err:
+                _error(f"invalid Bridge {link_str} {err} at {node}", strict)
+                continue
+            relation = ''
+            if ':' in src_str:
+                src_str, relation = src_str.split(':', 1)
+            if trg_str == src_str:
+                _error("Bridge cannot self-reference the same cluster: " + trg_str, strict)
+            bl = src_str2bl.get(src_str)
+            if not bl:
+                bl = clusters[src_str].mentions[-1].bridging
+                src_str2bl[src_str] = bl
+            if trg_str not in clusters:
+                clusters[trg_str] = CorefCluster(trg_str)
+            bl._data.append(BridgingLink(clusters[trg_str], relation))
+        return src_str2bl.values()
+
+    def __init__(self, src_mention, value=None, strict=True):
         self.src_mention = src_mention
         self._data = []
         self.strict = strict
         if value is not None:
-            if isinstance(value, str):
-                if clusters is None:
-                    raise ValueError('BridgingClusters: clusters must be provided if initializing with a string')
-                try:
-                    self._from_string(value, clusters)
-                except Exception:
-                    logging.error(f"Problem when parsing {value} in {src_mention.words[0]}:\n")
-                    raise
-            elif isinstance(value, collections.abc.Sequence):
+            if isinstance(value, collections.abc.Sequence):
                 for v in value:
                     if v[0] is src_mention._cluster:
                         _error("Bridging cannot self-reference the same cluster: " + v[0].cluster_id, strict)
                     self._data.append(BridgingLink(v[0], v[1]))
+            else:
+                raise ValueError(f"Unknown value type: {type(value)}")
+        self.src_mention._bridging = self
         super().__init__()
 
     def __getitem__(self, key):
@@ -239,18 +418,8 @@ def insert(self, key, new_value):
         self._data.insert(key, BridgingLink(new_value[0], new_value[1]))
 
     def __str__(self):
-        return ','.join(f'{l.target._cluster_id}:{l.relation}' for l in sorted(self._data))
-
-    def _from_string(self, string, clusters):
-        self._data.clear()
-        for link_str in string.split(','):
-            target, relation = link_str.split(':')
-            if target == self.src_mention._cluster._cluster_id:
-                _error("Bridging cannot self-reference the same cluster: " + target, self.strict)
-            if target not in clusters:
-                clusters[target] = CorefCluster(target)
-            self._data.append(BridgingLink(clusters[target], relation))
-        self._data.sort()
+        # TODO in future link.relation should never be None, 0 nor "_", so we could delete the <not in (None, "_", "")> below.
+        return ','.join(f'{l.target._cluster_id}<{self.src_mention.cluster.cluster_id}{":" + l.relation if l.relation not in (None, "_", "") else ""}' for l in sorted(self._data))
 
     def __call__(self, relations_re=None):
         """Return a subset of links contained in this list as specified by the args.
@@ -259,7 +428,7 @@ def __call__(self, relations_re=None):
         """
         if relations_re is None:
             return self
-        return Links(self.src_mention, [l for l in self._data if re.match(relations_re, l.relation)])
+        return BridgingLinks(self.src_mention, [l for l in self._data if re.match(relations_re, l.relation)])
 
     @property
     def targets(self):
@@ -286,112 +455,332 @@ def _error(msg, strict):
         raise ValueError(msg)
     logging.error(msg)
 
+
+RE_DISCONTINUOUS = re.compile(r'^([^[]+)\[(\d+)/(\d+)\]')
+
 def load_coref_from_misc(doc, strict=True):
     clusters = {}
+    unfinished_mentions = collections.defaultdict(list)
+    discontinuous_mentions = collections.defaultdict(list)
+    global_entity = doc.meta.get('global.Entity')
+    was_global_entity = True
+    if not global_entity:
+        was_global_entity = False
+        global_entity = 'eid-etype-head-other'
+        doc.meta['global.Entity'] = global_entity
+    # backward compatibility
+    if global_entity == 'entity-GRP-infstat-MIN-coref_type-identity':
+        global_entity = 'etype-eid-infstat-minspan-link-identity'
+        # Which global.Entity should be used for serialization?
+        doc.meta['global.Entity'] = global_entity
+        #doc.meta['global.Entity'] = 'eid-etype-head-other'
+    if 'eid' not in global_entity:
+        raise ValueError("No eid in global.Entity = " + global_entity)
+    fields = global_entity.split('-')
+
     for node in doc.nodes_and_empty:
-        index, index_str = 0, ""
-        cluster_id = node.misc["ClusterId"]
-        if not cluster_id:
-            index, index_str = 1, "[1]"
-            cluster_id = node.misc["ClusterId[1]"]
-        while cluster_id:
-            cluster = clusters.get(cluster_id)
-            if cluster is None:
-                cluster = CorefCluster(cluster_id)
-                clusters[cluster_id] = cluster
-            mention = CorefMention(node, cluster)
-            if node.misc["MentionSpan" + index_str]:
-                mention.span = node.misc["MentionSpan" + index_str]
+        misc_entity = node.misc["Entity"]
+        if not misc_entity:
+            continue
+
+        if not was_global_entity:
+            raise ValueError(f"No global.Entity header found, but Entity= annotations are presents")
+
+        # The Entity attribute may contain multiple entities, e.g.
+        # Entity=(abstract-7-new-2-coref(abstract-3-giv:act-1-coref)
+        # means a start of entity id=7 and start&end (i.e. single-word mention) of entity id=3.
+        # The following re.split line splits this into
+        # chunks = ["(abstract-7-new-2-coref", "(abstract-3-giv:act-1-coref)"]
+        chunks = [x for x in re.split('(\([^()]+\)?|[^()]+\))', misc_entity) if x]
+        for chunk in chunks:
+            opening, closing = (chunk[0] == '(', chunk[-1] == ')')
+            chunk = chunk.strip('()')
+            # 1. invalid
+            if not opening and not closing:
+                logging.warning(f"Entity {chunk} at {node} has no opening nor closing bracket.")
+            # 2. closing bracket
+            elif not opening and closing:
+                # closing brackets should include just the ID,
+                # but older GUM versions repeated all the fields
+                if '-' in chunk:
+                    # TODO delete this legacy hack once we don't need to load UD GUM v2.8 anymore
+                    if not strict and global_entity.startswith('etype-eid'):
+                        chunk = chunk.split('-')[1]
+                    else:
+                        _error("Unexpected closing eid " + chunk, strict)
+
+                # closing discontinuous mentions
+                eid, subspan_idx = chunk, None
+                if chunk not in unfinished_mentions:
+                    m = RE_DISCONTINUOUS.match(chunk)
+                    if not m:
+                        raise ValueError(f"Mention {chunk} closed at {node}, but not opened.")
+                    eid, subspan_idx, total_subspans = m.group(1, 2, 3)
+
+                mention, head_idx = unfinished_mentions[eid].pop()
+                last_word = mention.words[-1]
+                if node.root is not last_word.root:
+                    # TODO cross-sentence mentions
+                    raise ValueError(f"Cross-sentence mentions not supported yet: {chunk} at {node}")
+                for w in node.root.descendants_and_empty:
+                    if last_word.precedes(w):
+                        mention._words.append(w)
+                        w._mentions.append(mention)
+                        if w is node:
+                            break
+                if head_idx and (subspan_idx is None or subspan_idx == total_subspans):
+                    try:
+                        mention.head = mention.words[head_idx - 1]
+                    except IndexError as err:
+                        _error(f"Invalid head_idx={head_idx} for {mention.cluster.cluster_id} "
+                                f"closed at {node} with words={mention.words}", 1)
+                if subspan_idx and subspan_idx == total_subspans:
+                    m = discontinuous_mentions[eid].pop()
+                    if m is not mention:
+                        _error(f"Closing mention {mention.cluster.cluster_id} at {node}, but it has unfinished nested mentions ({m.words})", 1)
+
+            # 3. opening or single-word
             else:
-                mention.words = [node]
-            cluster_type = node.misc["ClusterType" + index_str]
-            if cluster_type is not None:
-                if cluster.cluster_type is not None and cluster_type != cluster.cluster_type:
-                    logging.warning(f"cluster_type mismatch in {node}: {cluster.cluster_type} != {cluster_type}")
-                cluster.cluster_type = cluster_type
-
-            bridging_str = node.misc["Bridging" + index_str]
-            if bridging_str:
-                mention._bridging = BridgingLinks(mention, bridging_str, clusters, strict)
-
-            split_ante_str = node.misc["SplitAnte" + index_str]
-            if split_ante_str:
-                split_antes = []
-                # TODO in CorefUD draft "+" was used as the separator, but it was changed to comma.
-                # We can delete `.replace('+', ',')` once there are no more data with the legacy plus separator.
-                for ante_str in split_ante_str.replace('+', ',').split(','):
-                    if ante_str in clusters:
-                        if ante_str == cluster_id:
-                            _error("SplitAnte cannot self-reference the same cluster: " + cluster_id, strict)
-                        split_antes.append(clusters[ante_str])
+                eid, etype, head_idx, other = None, None, None, OtherDualDict()
+                for name, value in zip(fields, chunk.split('-')):
+                    if name == 'eid':
+                        eid = value
+                    elif name == 'etype':
+                        etype = value
+                    elif name == 'head':
+                        try:
+                            head_idx = int(value)
+                        except ValueError as err:
+                            raise ValueError(f"Non-integer {value} as head index in {chunk} in {node}: {err}")
+                    elif name == 'other':
+                        if other:
+                            new_other = OtherDualDict(value)
+                            for k,v in other.values():
+                                new_other[k] = v
+                            other = new_other
+                        else:
+                            other = OtherDualDict(value)
                     else:
-                        # split cataphora, e.g. "We, that is you and me..."
-                        ante_cl = CorefCluster(ante_str)
-                        clusters[ante_str] = ante_cl
-                        split_antes.append(ante_cl)
-                cluster.split_ante = sorted(split_antes)
-
-            mention.misc = node.misc["MentionMisc" + index_str]
-            index += 1
-            index_str = f"[{index}]"
-            cluster_id = node.misc["ClusterId" + index_str]
+                        other[name] = value
+                if eid is None:
+                    raise ValueError("No eid in " + chunk)
+                subspan_idx, total_subspans = None, '0'
+                if eid[-1] == ']':
+                    m = RE_DISCONTINUOUS.match(eid)
+                    if not m:
+                        _error(f"eid={eid} ending with ], but not valid discontinuous mention ID ", strict)
+                    else:
+                        eid, subspan_idx, total_subspans = m.group(1, 2, 3)
+
+                cluster = clusters.get(eid)
+                if cluster is None:
+                    if subspan_idx and subspan_idx != '1':
+                        _error(f'Non-first subspan of a discontinuous mention {eid} at {node} does not have any previous mention.', 1)
+                    cluster = CorefCluster(eid)
+                    clusters[eid] = cluster
+                    cluster.cluster_type = etype
+                elif etype and cluster.cluster_type and cluster.cluster_type != etype:
+                    logging.warning(f"etype mismatch in {node}: {cluster.cluster_type} != {etype}")
+                # CorefCluster could be created first with "Bridge=" without any type
+                elif etype and cluster.cluster_type is None:
+                    cluster.cluster_type = etype
+
+                if subspan_idx and subspan_idx != '1':
+                    opened = [pair[0] for pair in unfinished_mentions[eid]]
+                    mention = next(m for m in discontinuous_mentions[eid] if m not in opened)
+                    mention._words.append(node)
+                    if closing and subspan_idx == total_subspans:
+                        m = discontinuous_mentions[eid].pop()
+                        if m is not mention:
+                            _error(f"{node}: closing mention {mention.cluster.cluster_id} ({mention.words}), but it has an unfinished nested mention ({m.words})", 1)
+                        try:
+                            mention.head = mention._words[head_idx - 1]
+                        except IndexError as err:
+                            _error(f"Invalid head_idx={head_idx} for {mention.cluster.cluster_id} "
+                                    f"closed at {node} with words={mention._words}", 1)
+                else:
+                    mention = CorefMention(words=[node], cluster=cluster)
+                    if other:
+                        mention._other = other
+                    if subspan_idx:
+                        discontinuous_mentions[eid].append(mention)
+                node._mentions.append(mention)
+
+                if not closing:
+                    unfinished_mentions[eid].append((mention, head_idx))
+
+
+        # Bridge, e.g. Entity=(e12-event|Bridge=e12<e124,e12<e125
+        # or with relations Bridge=c173<c188:subset,c174<c188:part
+        misc_bridge = node.misc['Bridge']
+        if misc_bridge:
+            BridgingLinks.from_string(misc_bridge, clusters, strict)
+
+        # SplitAnte, e.g. Entity=(e11-person(e12-person)|SplitAnte=e3<e11,e4<e11,e6<e12,e7<e12
+        # which means that both e11 and e12 have split antecedents (e11=e3+e4, e12=e6+e7).
+        misc_split = node.misc['SplitAnte']
+        if not misc_split and 'Split' in node.misc:
+            misc_split = node.misc.pop('Split')
+        if misc_split:
+            ante_clusters = []
+            for x in misc_split.split(','):
+                ante_str, this_str = x.split('<')
+                if ante_str == this_str:
+                    _error("SplitAnte cannot self-reference the same cluster: " + this_str, strict)
+                # split cataphora, e.g. "We, that is you and me..."
+                if ante_str not in clusters:
+                    clusters[ante_str] = CorefCluster(ante_str)
+                clusters[this_str].split_ante.append(clusters[ante_str])
+
+    for cluster_name, mentions in unfinished_mentions.items():
+        for mention in mentions:
+            logging.warning(f"Mention {cluster_name} opened at {mention.head}, but not closed. Deleting.")
+            cluster = mention.cluster
+            mention.words = []
+            cluster._mentions.remove(mention)
+            if not cluster._mentions:
+                del clusters[name]
+
     # c=doc.coref_clusters should be sorted, so that c[0] < c[1] etc.
     # In other words, the dict should be sorted by the values (according to CorefCluster.__lt__),
     # not by the keys (cluster_id).
     # In Python 3.7+ (3.6+ in CPython), dicts are guaranteed to be insertion order.
     for cluster in clusters.values():
         if not cluster._mentions:
-            _error(f"Cluster {cluster.cluster_id} referenced in SplitAnte or Bridging, but not defined with ClusterId", strict)
+            _error(f"Cluster {cluster.cluster_id} referenced in SplitAnte or Bridge, but not defined with Entity", strict)
         cluster._mentions.sort()
+        for mention in cluster._mentions:
+            for node in mention._words:
+                node._mentions.sort()
     doc._coref_clusters = {c._cluster_id: c for c in sorted(clusters.values())}
 
 
 def store_coref_to_misc(doc):
     if not doc._coref_clusters:
         return
-    attrs = ("ClusterId", "MentionSpan", "ClusterType", "Bridging", "SplitAnte", "MentionMisc")
+
+    global_entity = doc.meta.get('global.Entity')
+    if not global_entity:
+        global_entity = 'eid-etype-head-other'
+        doc.meta['global.Entity'] = global_entity
+
+    # global.Entity won't be written without newdoc
+    if not doc[0].trees[0].newdoc:
+        doc[0].trees[0].newdoc = True
+
+    fields = global_entity.split('-')
+    # GRP and entity are legacy names for eid and etype, respectively.
+    other_fields = [f for f in fields if f not in ('eid etype head other GRP entity'.split(), )]
+
+    attrs = "Entity SplitAnte Bridge".split()
     for node in doc.nodes_and_empty:
-        for key in list(node.misc):
-            if any(re.match(attr + r'(\[\d+\])?$', key) for attr in attrs):
-                del node.misc[key]
-    # doc._coref_clusters is a dict, which is insertion ordered in Python 3.7+.
-    # The insertion order is sorted according to CorefCluster.__lt__ (see few lines above).
-    # However, new clusters could be added meanwhile or some clusters edited,
-    # so we need to sort the clusters again before storing to MISC.
-    # We also need to mare sure cluster.mentions are sorted in each cluster
-    # because the ordering of clusters is defined by the first mention in each cluster.
-    # Ordering of mentions within a cluster can be changed when e.g. changing the span
-    # of a given mention or reordering words within a sentence and in such events
-    # Udapi currently does not automatically update the ordering of clusters.
-    for cluster in doc._coref_clusters.values():
-        cluster._mentions.sort()
-    for cluster in sorted(doc._coref_clusters.values()):
-        for mention in cluster.mentions:
-            head = mention.head
-            if head.misc["ClusterId"]:
-                for a in attrs:
-                    if head.misc[a]:
-                        head.misc[a + "[1]"] = head.misc[a]
-                        del head.misc[a]
-                index_str = "[2]"
+        for attr in attrs:
+            del node.misc[attr]
+
+    # Convert each subspan of each discontinuous mention into a fake CorefMention instance,
+    # so that we can sort both real and fake mentions and process them in the correct order.
+    doc_mentions = []
+    for mention in doc.coref_mentions:
+        if ',' not in mention.span:
+            doc_mentions.append(mention)
+        else:
+            cluster = mention.cluster
+            head_str = str(mention.words.index(mention.head) + 1)
+            subspans = mention.span.split(',')
+            root = mention.words[0].root
+            for idx,subspan in enumerate(subspans, 1):
+                subspan_eid = f'{cluster.cluster_id}[{idx}/{len(subspans)}]'
+                subspan_words = span_to_nodes(root, subspan)
+                fake_cluster = CorefCluster(subspan_eid, cluster.cluster_type)
+                fake_mention = CorefMention(subspan_words, head_str, fake_cluster)
+                if mention._other:
+                    fake_mention._other = mention._other
+                if mention._bridging and idx == 1:
+                    fake_mention._bridging = mention._bridging
+                doc_mentions.append(fake_mention)
+    doc_mentions.sort()
+
+    for mention in doc_mentions:
+        cluster = mention.cluster
+        values = []
+        for field in fields:
+            if field == 'eid' or field == 'GRP':
+                eid = cluster.cluster_id
+                if any(x in eid for x in CHARS_FORBIDDEN_IN_ID):
+                    _error(f"{eid} contains forbidden characters [{CHARS_FORBIDDEN_IN_ID}]", strict)
+                    for c in CHARS_FORBIDDEN_IN_ID:
+                        eid = eid.replace(c, '')
+                values.append(eid)
+            elif field == 'etype' or field == 'entity':
+                if not cluster.cluster_type:
+                    values.append('')
+                else:
+                    values.append(cluster.cluster_type)
+            elif field == 'head':
+                if isinstance(mention.head, str):
+                    values.append(mention.head) # fake mention for discontinuous spans
+                else:
+                    values.append(str(mention.words.index(mention.head) + 1))
+            elif field == 'other':
+                if not mention._other:
+                    values.append('')
+                elif not other_fields:
+                    values.append(str(mention.other))
+                else:
+                    other_copy = OtherDualDict(mention.other)
+                    for other_field in other_fields:
+                        del other_copy[other_field]
+                    values.append(str(other_copy))
             else:
-                index, index_str = 1, "[1]"
-                while(head.misc["ClusterId" + index_str]):
-                    index += 1
-                    index_str = f"[{index}]"
-                if index == 1:
-                    index_str = ""
-            head.misc["ClusterId" + index_str] = cluster.cluster_id
-            head.misc["MentionSpan" + index_str] = mention.span
-            head.misc["ClusterType" + index_str] = cluster.cluster_type
-            if mention._bridging:
-                head.misc["Bridging" + index_str] = str(mention.bridging)
-            if cluster.split_ante:
-                serialized = ','.join((c.cluster_id for c in sorted(cluster.split_ante)))
-                head.misc["SplitAnte" + index_str] = serialized
-            if mention.misc:
-                head.misc["MentionMisc" + index_str] = mention.misc
-
+                values.append(mention.other[field].replace('%2C', ','))
+        # optional fields
+        while values and values[-1] == '':
+            del values[-1]
+        mention_str = '(' + '-'.join(values)
+
+        # First, handle single-word mentions.
+        # If there are no opening brackets (except for single-word),
+        # single-word mentions should precede all closing brackets, e.g. `Entity=(e10)(e9)e4)e3)`.
+        # Otherwise, single-word mentions should follow all opening brackets,
+        # e.g. `Entity=(e1(e2(e9)(e10)` or `Entity=e4)e3)(e1(e2(e9)(e10)`.
+        firstword = mention.words[0]
+        if len(mention.words) == 1:
+            orig_entity = firstword.misc['Entity']
+            # empty     --> (e10)
+            # (e1(e2    --> (e1(e2(e10)
+            # e3)(e1(e2 --> e3)(e1(e2(e10)
+            if not orig_entity or orig_entity[-1] != ')':
+                firstword.misc['Entity'] += mention_str + ')'
+            # e4)e3)    --> (e10)e4)e3)
+            elif '(' not in orig_entity:
+                firstword.misc['Entity'] = mention_str + ')' + orig_entity
+            # (e9)e4)e3) --> (e10)(e9)e4)e3)
+            elif any(c and c[0] == '(' and c[-1] != ')' for c in re.split('(\([^()]+\)?|[^()]+\))', orig_entity)):
+                firstword.misc['Entity'] += mention_str + ')'
+            # (e1(e2(e9)   --> (e1(e2(e9)(e10)
+            # e3)(e1(e2(e9)--> e3)(e1(e2(e9)(e10)
+            else:
+                firstword.misc['Entity'] = mention_str + ')' + orig_entity
+        # Second, multi-word mentions. Opening brackets should follow closing brackets.
+        else:
+            firstword.misc['Entity'] += mention_str
+            mention.words[-1].misc['Entity'] = cluster.cluster_id + ')' + mention.words[-1].misc['Entity']
+
+        # Bridge=e1<e5:subset,e2<e6:subset|Entity=(e5(e6
+        if mention._bridging:
+            str_bridge = str(mention._bridging)
+            if firstword.misc['Bridge']:
+                str_bridge = firstword.misc['Bridge'] + ',' + str_bridge
+            firstword.misc['Bridge'] = str_bridge
+
+    # SplitAnte=e5<e61,e10<e61
+    for cluster in doc.coref_clusters.values():
+        if cluster.split_ante:
+            first_word = cluster.mentions[0].words[0]
+            strs = ','.join(f'{sa.cluster_id}<{cluster.cluster_id}' for sa in cluster.split_ante)
+            if first_word.misc['SplitAnte']:
+                strs = first_word.misc['SplitAnte'] + ',' + strs
+            first_word.misc['SplitAnte'] = strs
 
 def span_to_nodes(root, span):
     ranges = []
@@ -441,3 +830,122 @@ def nodes_to_span(nodes):
             hi = all_nodes[i - 1].ord
             ranges.append(f"{lo}-{hi}" if hi > lo else f"{lo}")
     return ','.join(ranges)
+
+
+# TODO fix code duplication with udapi.core.dualdict after making sure benchmarks are not slower
+class OtherDualDict(collections.abc.MutableMapping):
+    """OtherDualDict class serves as dict with lazily synchronized string representation.
+
+    >>> ddict = OtherDualDict('anacata:anaphoric,antetype:entity,nptype:np')
+    >>> ddict['mention'] = 'np'
+    >>> str(ddict)
+    'anacata:anaphoric,antetype:entity,mention:np,nptype:np'
+    >>> ddict['NonExistent']
+    ''
+
+    This class provides access to both
+    * a structured (dict-based, deserialized) representation,
+      e.g. {'anacata': 'anaphoric', 'antetype': 'entity'}, and
+    * a string (serialized) representation of the mapping, e.g. `anacata:anaphoric,antetype:entity`.
+    There is a clever mechanism that makes sure that users can read and write
+    both of the representations which are always kept synchronized.
+    Moreover, the synchronization is lazy, so the serialization and deserialization
+    is done only when needed. This speeds up scenarios where access to dict is not needed.
+
+    A value can be deleted with any of the following three ways:
+    >>> del ddict['nptype']
+    >>> ddict['nptype'] = None
+    >>> ddict['nptype'] = ''
+    and it works even if the value was already missing.
+    """
+    __slots__ = ['_string', '_dict']
+
+    def __init__(self, value=None, **kwargs):
+        if value is not None and kwargs:
+            raise ValueError('If value is specified, no other kwarg is allowed ' + str(kwargs))
+        self._dict = dict(**kwargs)
+        self._string = None
+        if value is not None:
+            self.set_mapping(value)
+
+    def __str__(self):
+        if self._string is None:
+            serialized = []
+            for name, value in sorted(self._dict.items(), key=lambda s: s[0].lower()):
+                if value is True:
+                    serialized.append(name)
+                else:
+                    serialized.append(f"{name}:{value}")
+            self._string = ','.join(serialized) if serialized else ''
+        return self._string
+
+    def _deserialize_if_empty(self):
+        if not self._dict and self._string is not None and self._string != '':
+            for raw_feature in self._string.split(','):
+                namevalue = raw_feature.split(':', 1)
+                if len(namevalue) == 2:
+                    name, value = namevalue
+                else:
+                    name, value = namevalue[0], True
+                self._dict[name] = value
+
+    def __getitem__(self, key):
+        self._deserialize_if_empty()
+        return self._dict.get(key, '')
+
+    def __setitem__(self, key, value):
+        self._deserialize_if_empty()
+        self._string = None
+        if value is None or value == '':
+            self.__delitem__(key)
+        else:
+            value = value.replace(',', '%2C') # TODO report a warning? Escape also '|' and '-'?
+            self._dict[key] = value
+
+    def __delitem__(self, key):
+        self._deserialize_if_empty()
+        try:
+            del self._dict[key]
+            self._string = None
+        except KeyError:
+            pass
+
+    def __iter__(self):
+        self._deserialize_if_empty()
+        return self._dict.__iter__()
+
+    def __len__(self):
+        self._deserialize_if_empty()
+        return len(self._dict)
+
+    def __contains__(self, key):
+        self._deserialize_if_empty()
+        return self._dict.__contains__(key)
+
+    def clear(self):
+        self._string = '_'
+        self._dict.clear()
+
+    def copy(self):
+        """Return a deep copy of this instance."""
+        return copy.deepcopy(self)
+
+    def set_mapping(self, value):
+        """Set the mapping from a dict or string.
+
+        If the `value` is None, it is converted to storing an empty string.
+        If the `value` is a string, it is stored as is.
+        If the `value` is a dict (or any instance of `collections.abc.Mapping`),
+        its copy is stored.
+        Other types of `value` raise an `ValueError` exception.
+        """
+        if value is None:
+            self.clear()
+        elif isinstance(value, str):
+            self._dict.clear()
+            self._string = value
+        elif isinstance(value, collections.abc.Mapping):
+            self._string = None
+            self._dict = dict(value)
+        else:
+            raise ValueError("Unsupported value type " + str(value))
diff --git a/udapi/core/document.py b/udapi/core/document.py
index 8f9ce3ea..aceeafdf 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -123,3 +123,13 @@ def coref_clusters(self):
         """A dict mapping ClusterId to a CorefCluster object."""
         self._load_coref()
         return self._coref_clusters
+
+    @property
+    def coref_mentions(self):
+        """A sorted list of all CorefMention objects in the document."""
+        self._load_coref()
+        all_mentions = []
+        for cluster in self._coref_clusters.values():
+            all_mentions.extend(cluster.mentions)
+        all_mentions.sort()
+        return all_mentions
diff --git a/udapi/core/dualdict.py b/udapi/core/dualdict.py
index a79c0610..540006ea 100644
--- a/udapi/core/dualdict.py
+++ b/udapi/core/dualdict.py
@@ -45,7 +45,7 @@ def __str__(self):
                 if value is True:
                     serialized.append(name)
                 else:
-                    serialized.append('%s=%s' % (name, value))
+                    serialized.append(f"{name}:{value}")
             self._string = '|'.join(serialized) if serialized else '_'
         return self._string
 
diff --git a/udapi/core/root.py b/udapi/core/root.py
index 3fbe5fca..0132566a 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -71,6 +71,10 @@ def address(self):
         """
         return self.sent_id
 
+    @property
+    def document(self):
+        return self._bundle._document
+
     @property
     def bundle(self):
         """Return the bundle which this tree belongs to."""
diff --git a/udapi/core/run.py b/udapi/core/run.py
index 0a08504c..c3a4ca6f 100644
--- a/udapi/core/run.py
+++ b/udapi/core/run.py
@@ -101,7 +101,7 @@ def _import_blocks(block_names, block_args):
         command = "b%s(**kwargs)" % block_id
         logging.debug("Trying to evaluate this: %s", command)
         new_block_instance = eval(command)  # pylint: disable=eval-used
-        blocks.append(new_block_instance)
+        blocks.append((block_name, new_block_instance))
 
     return blocks
 
@@ -133,11 +133,11 @@ def execute(self):
         blocks = _import_blocks(block_names, block_args)
 
         # Initialize blocks (process_start).
-        for block in blocks:
+        for bname, block in blocks:
             block.process_start()
 
         readers = []
-        for block in blocks:
+        for bname, block in blocks:
             try:
                 block.finished  # pylint: disable=pointless-statement
                 readers.append(block)
@@ -147,15 +147,15 @@ def execute(self):
             logging.info('No reader specified, using read.Conllu')
             conllu_reader = Conllu()
             readers = [conllu_reader]
-            blocks = readers + blocks
+            blocks = [('read.Conllu', conllu_reader)] + blocks
 
         # Apply blocks on the data.
         finished = False
         while not finished:
             document = Document()
             logging.info(" ---- ROUND ----")
-            for block in blocks:
-                logging.info("Executing block " + block.__class__.__name__)
+            for bname, block in blocks:
+                logging.info(f"Executing block {bname}")
                 block.apply_on_document(document)
 
             finished = True
@@ -164,7 +164,7 @@ def execute(self):
                 finished = finished and reader.finished
 
         # 6. close blocks (process_end)
-        for block in blocks:
+        for bname, block in blocks:
             block.process_end()
 
     # TODO: better implementation, included Scen

From 276529ca0daa4dbbfd8e74f87592028b8ecb88bc Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 10 Feb 2022 11:00:18 +0100
Subject: [PATCH 0499/1374] oops, partial revert of the last commit

---
 udapi/core/dualdict.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/core/dualdict.py b/udapi/core/dualdict.py
index 540006ea..ba0129ed 100644
--- a/udapi/core/dualdict.py
+++ b/udapi/core/dualdict.py
@@ -45,7 +45,7 @@ def __str__(self):
                 if value is True:
                     serialized.append(name)
                 else:
-                    serialized.append(f"{name}:{value}")
+                    serialized.append(f"{name}={value}")
             self._string = '|'.join(serialized) if serialized else '_'
         return self._string
 

From 81a65bf8a192aaf2bfdb9fa233b71b5a1c268d8f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 10 Feb 2022 12:24:15 +0100
Subject: [PATCH 0500/1374] corefud.MarkNested

in future, I would like to merge all the corefud.Mark* blocks
into one universal block, but for now, let's archive this one
---
 udapi/block/corefud/marknested.py | 44 +++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 udapi/block/corefud/marknested.py

diff --git a/udapi/block/corefud/marknested.py b/udapi/block/corefud/marknested.py
new file mode 100644
index 00000000..656111c6
--- /dev/null
+++ b/udapi/block/corefud/marknested.py
@@ -0,0 +1,44 @@
+from udapi.core.block import Block
+import udapi.core.coref
+import itertools
+
+class MarkNested(Block):
+    """Find nested mentions."""
+
+    def __init__(self, same_cluster_only=True, both_discontinuous=False, multiword_only=False,
+                 print_form=False, log=True, mark=True, **kwargs):
+        super().__init__(**kwargs)
+        self.same_cluster_only = same_cluster_only
+        self.both_discontinuous = both_discontinuous
+        self.multiword_only = multiword_only
+        self.print_form = print_form
+        self.log = log
+        self.mark = mark
+
+    def _print(self, mention):
+        if self.print_form:
+            return mention.cluster.cluster_id + ':' + ' '.join([w.form for w in mention.words])
+        else:
+            return mention.cluster.cluster_id + ':' + mention.span
+
+    def process_tree(self, tree):
+        mentions = set()
+        for node in tree.descendants_and_empty:
+            for m in node.coref_mentions:
+                mentions.add(m)
+        for mA, mB in itertools.combinations(mentions, 2):
+            if self.same_cluster_only and mA.cluster != mB.cluster:
+                continue
+            if self.both_discontinuous and (',' not in mA.span or ',' not in mB.span):
+                continue
+            sA, sB = set(mA.words), set(mB.words)
+            if not (sA <= sB) and not (sB <= sA):
+                continue
+            if self.multiword_only and (len(sA) == 1 or len(sB) == 1):
+                continue
+            if self.mark:
+                for w in mA.words + mB.words:
+                    w.misc['Mark'] = 1
+                mA.words[0].misc['Mark'] = f"{self._print(mA)}+{self._print(mB)}"
+            if self.log:
+                print(f"nested mentions at {tree.sent_id}: {self._print(mA)} + {self._print(mB)}")

From b38e7e4312d373fc28995ca37ca7ce2d25363f8c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 10 Feb 2022 14:54:07 +0100
Subject: [PATCH 0501/1374] CorefMention(words=[w1,w2]) should create backlinks
 from w1 and w2

The only case when we don't want these backlinks
is "fake mentions" needed for serialization of discontinuous mentions,
but that should be solved with a special parameter in `__init__`.

Fixes #101
---
 udapi/core/coref.py | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index aaaa07f0..3f54d9a9 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -109,16 +109,23 @@ class CorefMention(object):
     """Class for representing a mention (instance of an entity)."""
     __slots__ = ['_head', '_cluster', '_bridging', '_words', '_other']
 
-    def __init__(self, words, head=None, cluster=None):
+    def __init__(self, words, head=None, cluster=None, add_word_backlinks=True):
         if not words:
             raise ValueError("mention.words must be non-empty")
-        self._words = words
         self._head = head if head else words[0]
         self._cluster = cluster
         if cluster is not None:
             cluster._mentions.append(self)
         self._bridging = None
         self._other = None
+        self._words = words
+        if add_word_backlinks:
+            for new_word in words:
+                if not new_word._mentions or not cluster or self > new_word._mentions[-1]:
+                    new_word._mentions.append(self)
+                else:
+                    new_word._mentions.append(self)
+                    new_word._mentions.sort()
 
     def __lt__(self, another):
         """Does this mention precedes (word-order wise) `another` mention?
@@ -692,7 +699,7 @@ def store_coref_to_misc(doc):
                 subspan_eid = f'{cluster.cluster_id}[{idx}/{len(subspans)}]'
                 subspan_words = span_to_nodes(root, subspan)
                 fake_cluster = CorefCluster(subspan_eid, cluster.cluster_type)
-                fake_mention = CorefMention(subspan_words, head_str, fake_cluster)
+                fake_mention = CorefMention(subspan_words, head_str, fake_cluster, add_word_backlinks=False)
                 if mention._other:
                     fake_mention._other = mention._other
                 if mention._bridging and idx == 1:

From fe4dfcf110dac83608af2d3f8ad944840a0aee1c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 11 Feb 2022 01:30:46 +0100
Subject: [PATCH 0502/1374] corefud.IndexClusters will use prefix=e by default

---
 udapi/block/corefud/indexclusters.py | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/udapi/block/corefud/indexclusters.py b/udapi/block/corefud/indexclusters.py
index 1496c11c..14cf778d 100644
--- a/udapi/block/corefud/indexclusters.py
+++ b/udapi/block/corefud/indexclusters.py
@@ -3,7 +3,7 @@
 
 
 class IndexClusters(Block):
-    """Re-index the coreference cluster IDs. The final cluster IDs are of the "c<ID>" form,
+    """Re-index the coreference cluster IDs. The final cluster IDs are of the "e<ID>" form,
        where <ID> are ordinal numbers starting from the one specified by the `start` parameter.
        This block can be applied on multiple documents within one udapy call.
        For example, to re-index ClusterId in all conllu files in the current directory
@@ -13,11 +13,14 @@ class IndexClusters(Block):
        Parameters:
        -----------
        start : int
-            the starting index (by default 1)
+            the starting index (default=1)
+       prefix : str
+            prefix of the IDs before the number (default="e")
     """
 
-    def __init__(self, start=1):
+    def __init__(self, start=1, prefix='e'):
         self.start = start
+        self.prefix = prefix
 
     def process_document(self, doc):
         clusters = doc.coref_clusters
@@ -26,7 +29,7 @@ def process_document(self, doc):
         new_clusters = {}
         for idx, cid in enumerate(clusters, self.start):
             cluster = clusters[cid]
-            new_cid = "c" + str(idx)
+            new_cid = self.prefix + str(idx)
             cluster.cluster_id = new_cid
             new_clusters[new_cid] = cluster
         self.start = idx + 1

From ecee32956bc33cdbf20944768f9f9b059340edd8 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 11 Feb 2022 10:15:37 +0100
Subject: [PATCH 0503/1374] prevent code duplication when setting cluster IDs

---
 udapi/core/coref.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 3f54d9a9..022953a4 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -246,9 +246,8 @@ class CorefCluster(object):
     __slots__ = ['_cluster_id', '_mentions', 'cluster_type', 'split_ante']
 
     def __init__(self, cluster_id, cluster_type=None):
-        if any(x in cluster_id for x in CHARS_FORBIDDEN_IN_ID):
-            raise ValueError(f"{cluster_id} contains forbidden characters [{CHARS_FORBIDDEN_IN_ID}]")
-        self._cluster_id = cluster_id
+        self._cluster_id = None # prepare the _cluster_id slot
+        self.cluster_id = cluster_id # call the setter and check the ID is valid
         self._mentions = []
         self.cluster_type = cluster_type
         self.split_ante = []
@@ -277,8 +276,8 @@ def cluster_id(self):
 
     @cluster_id.setter
     def cluster_id(self, new_cluster_id):
-        if any(x in new_cluster_id for x in "-=| \t"):
-            raise ValueError(f"{new_cluster_id} contains forbidden characters [-=| \\t]")
+        if any(x in new_cluster_id for x in CHARS_FORBIDDEN_IN_ID):
+            raise ValueError(f"{new_cluster_id} contains forbidden characters [{CHARS_FORBIDDEN_IN_ID}]")
         self._cluster_id = new_cluster_id
 
     @property

From ee89d8fbd37dee421ebbbc1d64ecfd7bbc604eab Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 11 Feb 2022 16:27:33 +0100
Subject: [PATCH 0504/1374] newpar_block (used in the newest GUM) should not be
 treated as newpar

---
 udapi/block/read/conllu.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 97e39970..d703fb26 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -12,7 +12,7 @@
 # This reader accepts also older-style sent_id (until UD v2.0 treebanks are released).
 RE_SENT_ID = re.compile(r'^# sent_id\s*=?\s*(\S+)')
 RE_TEXT = re.compile(r'^# text\s*=\s*(.*)')
-RE_NEWPARDOC = re.compile(r'^# (newpar|newdoc)(?:\s+id\s*=\s*(.+))?')
+RE_NEWPARDOC = re.compile(r'^# (newpar|newdoc)(?:\s+id\s*=\s*(.+))?$')
 RE_JSON = re.compile(r'^# (doc_)?json_([^ =]+)\s*=\s*(.+)')
 RE_GLOBAL_ENTITY = re.compile(r'^# global.Entity\s*=\s*(\S+)')
 

From eab9a7890e37924d1a402eac0ddb99562f143f35 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 11 Feb 2022 20:16:15 +0100
Subject: [PATCH 0505/1374] convert (doc-level) GRP to (corpus-level) eid
 transparently

So GRP can be in global.Entity, both for reading and writing.
---
 udapi/core/coref.py | 100 +++++++++++++++++++++++++++++++++-----------
 1 file changed, 76 insertions(+), 24 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 022953a4..7b205d3c 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -280,6 +280,18 @@ def cluster_id(self, new_cluster_id):
             raise ValueError(f"{new_cluster_id} contains forbidden characters [{CHARS_FORBIDDEN_IN_ID}]")
         self._cluster_id = new_cluster_id
 
+    @property
+    def eid_or_grp(self):
+        root = self._mentions[0].head.root
+        meta = root.document.meta
+        if 'GRP' in meta['global.Entity'] and meta['tree2docid']:
+            docid = meta['tree2docid'][root]
+            if self._cluster_id.startswith(docid):
+                return self._cluster_id.replace(docid, '', 1)
+            else:
+                logging.warning(f"GRP in global.Entity, but eid={self._cluster_id} does not start with docid={docid}")
+        return self._cluster_id
+
     @property
     def mentions(self):
         return self._mentions
@@ -366,7 +378,14 @@ class BridgingLinks(collections.abc.MutableSequence):
     """
 
     @classmethod
-    def from_string(cls, string, clusters, strict=True):
+    def from_string(cls, string, clusters, node, strict=True, tree2docid=None):
+        """Return a sequence of BridgingLink objects representing a given string serialization.
+        The bridging links are also added to the mentions (`mention.bridging`) in the supplied `clusters`,
+        so the returned sequence can be usually ignored.
+        If `tree2docid` parameter is provided (mapping trees to document IDs used as prefixes in eid),
+        the entity IDs in the provided string are interpreted as "GRP", i.e. as document-wide IDs,
+        which need to be prefixed by the document IDs, to get corpus-wide unique "eid".
+        """
         src_str2bl = {}
         for link_str in string.split(','):
             try:
@@ -378,7 +397,10 @@ def from_string(cls, string, clusters, strict=True):
             if ':' in src_str:
                 src_str, relation = src_str.split(':', 1)
             if trg_str == src_str:
-                _error("Bridge cannot self-reference the same cluster: " + trg_str, strict)
+                _error(f"Bridge cannot self-reference the same cluster {trg_str} at {node}", strict)
+            if tree2docid:
+                src_str = tree2docid[node.root] + src_str
+                trg_str = tree2docid[node.root] + trg_str
             bl = src_str2bl.get(src_str)
             if not bl:
                 bl = clusters[src_str].mentions[-1].bridging
@@ -425,7 +447,7 @@ def insert(self, key, new_value):
 
     def __str__(self):
         # TODO in future link.relation should never be None, 0 nor "_", so we could delete the <not in (None, "_", "")> below.
-        return ','.join(f'{l.target._cluster_id}<{self.src_mention.cluster.cluster_id}{":" + l.relation if l.relation not in (None, "_", "") else ""}' for l in sorted(self._data))
+        return ','.join(f'{l.target.eid_or_grp}<{self.src_mention.cluster.eid_or_grp}{":" + l.relation if l.relation not in (None, "_", "") else ""}' for l in sorted(self._data))
 
     def __call__(self, relations_re=None):
         """Return a subset of links contained in this list as specified by the args.
@@ -463,8 +485,14 @@ def _error(msg, strict):
 
 
 RE_DISCONTINUOUS = re.compile(r'^([^[]+)\[(\d+)/(\d+)\]')
+# When converting doc-level GRP IDs to corpus-level eid IDs,
+# we need to assign each document a short ID/number (document names are too long).
+# These document numbers must be unique even when loading multiple files,
+# so we need to store the highest number generated so far here, at the Python module level.
+highest_doc_n = 0
 
 def load_coref_from_misc(doc, strict=True):
+    global highest_doc_n
     clusters = {}
     unfinished_mentions = collections.defaultdict(list)
     discontinuous_mentions = collections.defaultdict(list)
@@ -474,13 +502,17 @@ def load_coref_from_misc(doc, strict=True):
         was_global_entity = False
         global_entity = 'eid-etype-head-other'
         doc.meta['global.Entity'] = global_entity
-    # backward compatibility
-    if global_entity == 'entity-GRP-infstat-MIN-coref_type-identity':
-        global_entity = 'etype-eid-infstat-minspan-link-identity'
-        # Which global.Entity should be used for serialization?
-        doc.meta['global.Entity'] = global_entity
-        #doc.meta['global.Entity'] = 'eid-etype-head-other'
-    if 'eid' not in global_entity:
+    tree2docid = None
+    if 'GRP' in global_entity:
+        tree2docid, docid = {}, ""
+        for bundle in doc:
+            for tree in bundle:
+                if tree.newdoc or docid == "":
+                    highest_doc_n += 1
+                    docid = f"d{highest_doc_n}."
+                tree2docid[tree] = docid
+        doc.meta['tree2docid'] = tree2docid
+    elif 'eid' not in global_entity:
         raise ValueError("No eid in global.Entity = " + global_entity)
     fields = global_entity.split('-')
 
@@ -506,14 +538,15 @@ def load_coref_from_misc(doc, strict=True):
                 logging.warning(f"Entity {chunk} at {node} has no opening nor closing bracket.")
             # 2. closing bracket
             elif not opening and closing:
-                # closing brackets should include just the ID,
-                # but older GUM versions repeated all the fields
-                if '-' in chunk:
+                # closing brackets should include just the ID, but GRP needs to be converted to eid
+                if tree2docid:
                     # TODO delete this legacy hack once we don't need to load UD GUM v2.8 anymore
-                    if not strict and global_entity.startswith('etype-eid'):
-                        chunk = chunk.split('-')[1]
-                    else:
-                        _error("Unexpected closing eid " + chunk, strict)
+                    if '-' in chunk:
+                        if not strict and global_entity.startswith('entity-GRP'):
+                            chunk = chunk.split('-')[1]
+                        else:
+                            _error("Unexpected closing eid " + chunk, strict)
+                    chunk = tree2docid[node.root] + chunk
 
                 # closing discontinuous mentions
                 eid, subspan_idx = chunk, None
@@ -551,7 +584,9 @@ def load_coref_from_misc(doc, strict=True):
                 for name, value in zip(fields, chunk.split('-')):
                     if name == 'eid':
                         eid = value
-                    elif name == 'etype':
+                    elif name == 'GRP':
+                        eid = tree2docid[node.root] + value
+                    elif name == 'etype' or name == 'entity': # entity is an old name for etype used in UD GUM 2.8 and 2.9
                         etype = value
                     elif name == 'head':
                         try:
@@ -617,10 +652,10 @@ def load_coref_from_misc(doc, strict=True):
 
 
         # Bridge, e.g. Entity=(e12-event|Bridge=e12<e124,e12<e125
-        # or with relations Bridge=c173<c188:subset,c174<c188:part
+        # or with relations Bridge=e173<c188:subset,e174<e188:part
         misc_bridge = node.misc['Bridge']
         if misc_bridge:
-            BridgingLinks.from_string(misc_bridge, clusters, strict)
+            BridgingLinks.from_string(misc_bridge, clusters, node, strict, tree2docid)
 
         # SplitAnte, e.g. Entity=(e11-person(e12-person)|SplitAnte=e3<e11,e4<e11,e6<e12,e7<e12
         # which means that both e11 and e12 have split antecedents (e11=e3+e4, e12=e6+e7).
@@ -633,6 +668,9 @@ def load_coref_from_misc(doc, strict=True):
                 ante_str, this_str = x.split('<')
                 if ante_str == this_str:
                     _error("SplitAnte cannot self-reference the same cluster: " + this_str, strict)
+                if tree2docid:
+                    ante_str = tree2docid[node.root] + ante_str
+                    this_str = tree2docid[node.root] + this_str
                 # split cataphora, e.g. "We, that is you and me..."
                 if ante_str not in clusters:
                     clusters[ante_str] = CorefCluster(ante_str)
@@ -665,6 +703,7 @@ def store_coref_to_misc(doc):
     if not doc._coref_clusters:
         return
 
+    tree2docid = doc.meta.get('tree2docid')
     global_entity = doc.meta.get('global.Entity')
     if not global_entity:
         global_entity = 'eid-etype-head-other'
@@ -695,7 +734,10 @@ def store_coref_to_misc(doc):
             subspans = mention.span.split(',')
             root = mention.words[0].root
             for idx,subspan in enumerate(subspans, 1):
-                subspan_eid = f'{cluster.cluster_id}[{idx}/{len(subspans)}]'
+                eid = cluster.cluster_id
+                if tree2docid and 'GRP' in fields:
+                    eid = re.sub('^d\d+\.', '', eid) # TODO or "eid = cluster.eid_or_grp"?
+                subspan_eid = f'{eid}[{idx}/{len(subspans)}]'
                 subspan_words = span_to_nodes(root, subspan)
                 fake_cluster = CorefCluster(subspan_eid, cluster.cluster_type)
                 fake_mention = CorefMention(subspan_words, head_str, fake_cluster, add_word_backlinks=False)
@@ -712,6 +754,8 @@ def store_coref_to_misc(doc):
         for field in fields:
             if field == 'eid' or field == 'GRP':
                 eid = cluster.cluster_id
+                if field == 'GRP':
+                    eid = re.sub('^d\d+\.', '', eid)
                 if any(x in eid for x in CHARS_FORBIDDEN_IN_ID):
                     _error(f"{eid} contains forbidden characters [{CHARS_FORBIDDEN_IN_ID}]", strict)
                     for c in CHARS_FORBIDDEN_IN_ID:
@@ -737,8 +781,10 @@ def store_coref_to_misc(doc):
                     for other_field in other_fields:
                         del other_copy[other_field]
                     values.append(str(other_copy))
+            elif field == 'identity':
+                values.append(mention.other[field]) # don't replace('%2C', ',') in wikification
             else:
-                values.append(mention.other[field].replace('%2C', ','))
+                values.append(mention.other[field].replace('%2C', ',')) # but de-escape commas e.g. in minspan
         # optional fields
         while values and values[-1] == '':
             del values[-1]
@@ -770,7 +816,10 @@ def store_coref_to_misc(doc):
         # Second, multi-word mentions. Opening brackets should follow closing brackets.
         else:
             firstword.misc['Entity'] += mention_str
-            mention.words[-1].misc['Entity'] = cluster.cluster_id + ')' + mention.words[-1].misc['Entity']
+            eid = cluster.cluster_id
+            if tree2docid and 'GRP' in fields:
+                eid = re.sub('^d\d+\.', '', eid)
+            mention.words[-1].misc['Entity'] = eid + ')' + mention.words[-1].misc['Entity']
 
         # Bridge=e1<e5:subset,e2<e6:subset|Entity=(e5(e6
         if mention._bridging:
@@ -783,7 +832,10 @@ def store_coref_to_misc(doc):
     for cluster in doc.coref_clusters.values():
         if cluster.split_ante:
             first_word = cluster.mentions[0].words[0]
-            strs = ','.join(f'{sa.cluster_id}<{cluster.cluster_id}' for sa in cluster.split_ante)
+            if tree2docid:
+                strs = ','.join(f'{sa.eid_or_grp}<{cluster.eid_or_grp}' for sa in cluster.split_ante)
+            else:
+                strs = ','.join(f'{sa.cluster_id}<{cluster.cluster_id}' for sa in cluster.split_ante)
             if first_word.misc['SplitAnte']:
                 strs = first_word.misc['SplitAnte'] + ',' + strs
             first_word.misc['SplitAnte'] = strs

From 335c7d6f64edd9c4c396d871902d13d3efae57db Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 15 Feb 2022 13:40:09 +0100
Subject: [PATCH 0506/1374] make sure mention.words are sorted even when
 reordering/deleting nodes

---
 udapi/core/coref.py | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 7b205d3c..cb865a31 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -206,6 +206,11 @@ def bridging(self):
 
     @property
     def words(self):
+        # Words in a sentence could have been reordered, so we cannot rely on sorting self._words in the setter.
+        # The serialization relies on storing the opening bracket in the first word (and closing in the last),
+        # so we need to make sure the words are always returned sorted.
+        # TODO: benchmark updating the order of mention._words in node.shift_*() and node.remove().
+        self._words.sort()
         return self._words
 
     @words.setter
@@ -213,12 +218,13 @@ def words(self, new_words):
         if new_words and self.head not in new_words:
             raise ValueError(f"Head {self.head} not in new_words {new_words} for {self._cluster.cluster_id}")
         kept_words = []
+        # Make sure each word is included just once and they are in the correct order.
+        new_words = sorted(list(set(new_words)))
         for old_word in self._words:
             if old_word in new_words:
                 kept_words.append(old_word)
             else:
                 old_word._mentions.remove(self)
-        new_words.sort()
         self._words = new_words
         for new_word in new_words:
             if new_word not in kept_words:
@@ -556,7 +562,10 @@ def load_coref_from_misc(doc, strict=True):
                         raise ValueError(f"Mention {chunk} closed at {node}, but not opened.")
                     eid, subspan_idx, total_subspans = m.group(1, 2, 3)
 
-                mention, head_idx = unfinished_mentions[eid].pop()
+                try:
+                    mention, head_idx = unfinished_mentions[eid].pop()
+                except IndexError as err:
+                    raise ValueError(f"Mention {chunk} closed at {node}, but not opened.")
                 last_word = mention.words[-1]
                 if node.root is not last_word.root:
                     # TODO cross-sentence mentions

From 7772c398998af5c25e89c12f11da26099d38d1bb Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Feb 2022 21:57:47 +0100
Subject: [PATCH 0507/1374] Debugging corefud.MergeSameSpan.

---
 udapi/block/corefud/mergesamespan.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/udapi/block/corefud/mergesamespan.py b/udapi/block/corefud/mergesamespan.py
index d5a46d25..802285af 100644
--- a/udapi/block/corefud/mergesamespan.py
+++ b/udapi/block/corefud/mergesamespan.py
@@ -24,6 +24,12 @@ def process_tree(self, tree):
         for mA, mB in itertools.combinations(mentions, 2):
             if self.same_cluster_only and mA.cluster != mB.cluster:
                 continue
+            # Reduce non-determinism in which mention is removed:
+            # If the mentions belong to different entities, sort them by entity (cluster) ids.
+            if mA.cluster.cluster_id > mB.cluster.cluster_id:
+                mX = mA
+                mA = mB
+                mB = mX
 
             sA, sB = set(mA.words), set(mB.words)
             if sA != sB:
@@ -40,6 +46,7 @@ def process_tree(self, tree):
                 #    m.cluster = mA.cluster
             # Remove mention B. It may have been removed earlier because of
             # another duplicate, that is the purpose of try-except.
+            ###!!! TODO: If we remove a singleton, we are destroying the cluster. Then we must also handle possible bridging and split antecedents pointing to that cluster!
             for wb in sB:
                 try:
                     wb._mentions.remove(mB)

From 90ac47a28aae22ba5ae946698b0ca5e1a0ba3e53 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 16 Feb 2022 02:59:03 +0100
Subject: [PATCH 0508/1374] don't store Bridge or SplitAnte links to already
 deleted clusters

fixes #102
A better solution would be to delete links to deleted clusters immediately,
but it is tricky to make this fast (we would need backlinks)
and in some scenarios we need links to clusters without any mentions
(e.g. when loading a file with cataphora SplitAnte/Bridge).
---
 udapi/core/coref.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index cb865a31..9e3e97ee 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -469,6 +469,13 @@ def targets(self):
         """Return a list of the target clusters (without relations)."""
         return [link.target for link in self._data]
 
+    def _delete_targets_without_mentions(self, warn=True):
+        for link in self._data:
+            if not link.target.mentions:
+                if warn:
+                    logging.warning(f"Cluster {link.target.cluster_id} has no mentions, but is referred to in bridging of {self.src_mention.cluster.cluster_id}")
+                self._data.remove(link)
+
 
 def create_coref_cluster(head, cluster_id=None, cluster_type=None, **kwargs):
     clusters = head.root.bundle.document.coref_clusters
@@ -832,6 +839,7 @@ def store_coref_to_misc(doc):
 
         # Bridge=e1<e5:subset,e2<e6:subset|Entity=(e5(e6
         if mention._bridging:
+            mention._bridging._delete_targets_without_mentions()
             str_bridge = str(mention._bridging)
             if firstword.misc['Bridge']:
                 str_bridge = firstword.misc['Bridge'] + ',' + str_bridge
@@ -840,6 +848,13 @@ def store_coref_to_misc(doc):
     # SplitAnte=e5<e61,e10<e61
     for cluster in doc.coref_clusters.values():
         if cluster.split_ante:
+            for ante_entity in cluster.split_ante:
+                if not ante_entity.mentions:
+                    logging.warning(f"Cluster {ante_entity.cluster_id} has no mentions, but is referred to in SplitAnte of {cluster.cluster_id}")
+                    cluster.split_ante.remove(ante_entity)
+            if not cluster.split_ante or len(cluster.split_ante) < 2:
+                logging.warning(f"SplitAnte of {cluster.cluster_id} has less than two antecedents, omitting")
+                continue
             first_word = cluster.mentions[0].words[0]
             if tree2docid:
                 strs = ','.join(f'{sa.eid_or_grp}<{cluster.eid_or_grp}' for sa in cluster.split_ante)

From 1445b3afed38d8ce0428caca32446934e0655ea6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 16 Feb 2022 03:02:11 +0100
Subject: [PATCH 0509/1374] `mention.words = []` takes care about deleting
 backlinks from words

---
 udapi/block/corefud/mergesamespan.py | 12 +++---------
 1 file changed, 3 insertions(+), 9 deletions(-)

diff --git a/udapi/block/corefud/mergesamespan.py b/udapi/block/corefud/mergesamespan.py
index 802285af..bdeefd7c 100644
--- a/udapi/block/corefud/mergesamespan.py
+++ b/udapi/block/corefud/mergesamespan.py
@@ -27,9 +27,7 @@ def process_tree(self, tree):
             # Reduce non-determinism in which mention is removed:
             # If the mentions belong to different entities, sort them by entity (cluster) ids.
             if mA.cluster.cluster_id > mB.cluster.cluster_id:
-                mX = mA
-                mA = mB
-                mB = mX
+                mA, mB = mB, mA
 
             sA, sB = set(mA.words), set(mB.words)
             if sA != sB:
@@ -40,18 +38,14 @@ def process_tree(self, tree):
             # mentions from the other cluster to this cluster, and remove the
             # other cluster.
             if mA.cluster != mB.cluster:
-                logging.warning("Merging same-span mentions that belong to different entities: '%s' vs. '%s'." % (mA.cluster.cluster_id, mB.cluster.cluster_id))
+                logging.warning(f"Merging same-span mentions that belong to different entities: {mA.cluster.cluster_id} vs. {mB.cluster.cluster_id}")
                 ###!!! TODO: As of now, changing the cluster of a mention is not supported in the API.
                 #for m in mB.cluster.mentions:
                 #    m.cluster = mA.cluster
             # Remove mention B. It may have been removed earlier because of
             # another duplicate, that is the purpose of try-except.
             ###!!! TODO: If we remove a singleton, we are destroying the cluster. Then we must also handle possible bridging and split antecedents pointing to that cluster!
-            for wb in sB:
-                try:
-                    wb._mentions.remove(mB)
-                except ValueError:
-                    pass
+            mB.words = []
             try:
                 mB.cluster.mentions.remove(mB)
             except ValueError:

From f7e82090b443c7fd59557255e30e6fd5a6fc30e7 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 22 Feb 2022 16:10:25 +0100
Subject: [PATCH 0510/1374] Russian block cloned from Czech.

---
 udapi/block/ud/ru/fixedeprels.py | 113 +++++++++++++++++++++++++++++++
 1 file changed, 113 insertions(+)
 create mode 100644 udapi/block/ud/ru/fixedeprels.py

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
new file mode 100644
index 00000000..54076b68
--- /dev/null
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -0,0 +1,113 @@
+"""Block to fix case-enhanced dependency relations in Russian."""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixEdeprels(Block):
+
+    # Secondary prepositions sometimes have the lemma of the original part of
+    # speech. We want the grammaticalized form instead. List even those that
+    # will have the same lexical form, as we also want to check the morphological
+    # case. And include all other prepositions that have unambiguous morphological
+    # case, even if they are not secondary.
+    unambiguous = {
+        'как':              'как' # remove morphological case
+    }
+
+    def process_node(self, node):
+        """
+        Occasionally the edeprels automatically derived from the Russian basic
+        trees do not match the whitelist. For example, the noun is an
+        abbreviation and its morphological case is unknown.
+        """
+        for edep in node.deps:
+            m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):', edep['deprel'])
+            if m:
+                bdeprel = m.group(1)
+                solved = False
+                for x in self.unambiguous:
+                    # All secondary prepositions have only one fixed morphological case
+                    # they appear with, so we can replace whatever case we encounter with the correct one.
+                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?$', edep['deprel'])
+                    if m:
+                        edep['deprel'] = m.group(1)+':'+self.unambiguous[x]
+                        solved = True
+                        break
+                # The following prepositions have more than one morphological case
+                # available. Thanks to the Case feature on prepositions, we can
+                # identify the correct one.
+                if not solved:
+                    m = re.match(r'^(obl(?::arg)?|nmod):(mezi|na|nad|o|po|pod|před|v|za)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
+                    if m:
+                        # The following is only partial solution. We will not see
+                        # some children because they may be shared children of coordination.
+                        prepchildren = [x for x in node.children if x.lemma == m.group(2)]
+                        if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
+                            edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
+                            solved = True
+            if re.match(r'^(acl|advcl):', edep['deprel']):
+                edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl):k:dat$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:(od|do)$', r'obl:\1:gen', edep['deprel'])
+            elif re.match(r'^(nmod|obl):', edep['deprel']):
+                if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
+                    # This is a same-case noun-noun modifier, which just happens to be in the locative.
+                    # For example, 'v Ostravě-Porubě', 'Porubě' is attached to 'Ostravě', 'Ostravě' has
+                    # nmod:v:loc, which is OK, but for 'Porubě' the case does not say anything significant.
+                    edep['deprel'] = 'nmod'
+                elif edep['deprel'] == 'obl:loc':
+                    # Annotation error. The first occurrence in PDT dev:
+                    # 'V Rapaportu, ceníku Antverpské burzy i Diamantberichtu jsou uvedeny ceny...'
+                    # The preposition 'V' should modify coordination 'Rapaportu i Diamantberichtu'.
+                    # However, 'Rapaportu' is attached as 'obl' to 'Diamantberichtu'.
+                    edep['deprel'] = 'obl:v:loc'
+                elif edep['deprel'] == 'obl:arg:loc':
+                    # Annotation error. The first occurrence in PDT dev:
+                    edep['deprel'] = 'obl:arg:na:loc'
+                elif edep['deprel'] == 'nmod:loc':
+                    # 'působil v kanadském Edmontonu Oilers', 'Edmontonu' attached to 'Oilers' and not vice versa.
+                    edep['deprel'] = 'nmod:nom'
+                elif edep['deprel'] == 'obl:nom' or edep['deprel'] == 'obl:voc':
+                    # Possibly an annotation error, nominative should be accusative, and the nominal should be direct object?
+                    # However, there seems to be a great variability in the causes, some are subjects and many are really obliques, so let's go just with 'obl' for now.
+                    edep['deprel'] = 'obl'
+                elif edep['deprel'] == 'nmod:voc':
+                    # 'v 8. čísle tiskoviny Ty rudá krávo'
+                    edep['deprel'] = 'nmod:nom'
+                elif re.match(r'^(nmod|obl(:arg)?):o$', edep['deprel']):
+                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':loc'
+                else:
+                    # If one of the following expressions occurs followed by another preposition,
+                    # remove the additional preposition. For example, 'i_když_s' becomes just 'i_když'.
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ač([_:].+)?$', r'\1:ač', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ačkoliv?([_:].+)?$', r'\1:ačkoli', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):byť[_:].+$', r'\1:byť', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):i_když[_:].+$', r'\1:i_když', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jak[_:].+$', r'\1:jak', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakkoliv?[_:].+$', r'\1:jakkoli', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jako[_:].+$', r'\1:jako', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby[_:].+$', r'\1:jako', edep['deprel']) # these instances in FicTree should be spelled 'jako by'
+
+    def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
+        '''
+        Modifies the incoming relation of a node both in the basic tree and in
+        the enhanced graph. If the node does not yet depend in the enhanced
+        graph on the current basic parent, the new relation will be added without
+        removing any old one. If the node already depends multiple times on the
+        current basic parent in the enhanced graph, all such enhanced relations
+        will be removed before adding the new one.
+        '''
+        old_parent = node.parent
+        node.parent = parent
+        node.deprel = deprel
+        node.deps = [x for x in node.deps if x['parent'] != old_parent]
+        new_edep = {}
+        new_edep['parent'] = parent
+        new_edep['deprel'] = edeprel
+        node.deps.append(new_edep)

From c673bd5e90bc64f0c4f3db68e2e424ddcdb94567 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 22 Feb 2022 16:20:37 +0100
Subject: [PATCH 0511/1374] Removed some Czech-specific rules.

---
 udapi/block/ud/ru/fixedeprels.py | 23 -----------------------
 1 file changed, 23 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 54076b68..48febee5 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -49,39 +49,16 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl):k:dat$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:(od|do)$', r'obl:\1:gen', edep['deprel'])
             elif re.match(r'^(nmod|obl):', edep['deprel']):
                 if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
                     # This is a same-case noun-noun modifier, which just happens to be in the locative.
                     # For example, 'v Ostravě-Porubě', 'Porubě' is attached to 'Ostravě', 'Ostravě' has
                     # nmod:v:loc, which is OK, but for 'Porubě' the case does not say anything significant.
                     edep['deprel'] = 'nmod'
-                elif edep['deprel'] == 'obl:loc':
-                    # Annotation error. The first occurrence in PDT dev:
-                    # 'V Rapaportu, ceníku Antverpské burzy i Diamantberichtu jsou uvedeny ceny...'
-                    # The preposition 'V' should modify coordination 'Rapaportu i Diamantberichtu'.
-                    # However, 'Rapaportu' is attached as 'obl' to 'Diamantberichtu'.
-                    edep['deprel'] = 'obl:v:loc'
-                elif edep['deprel'] == 'obl:arg:loc':
-                    # Annotation error. The first occurrence in PDT dev:
-                    edep['deprel'] = 'obl:arg:na:loc'
                 elif edep['deprel'] == 'nmod:loc':
-                    # 'působil v kanadském Edmontonu Oilers', 'Edmontonu' attached to 'Oilers' and not vice versa.
                     edep['deprel'] = 'nmod:nom'
-                elif edep['deprel'] == 'obl:nom' or edep['deprel'] == 'obl:voc':
-                    # Possibly an annotation error, nominative should be accusative, and the nominal should be direct object?
-                    # However, there seems to be a great variability in the causes, some are subjects and many are really obliques, so let's go just with 'obl' for now.
-                    edep['deprel'] = 'obl'
                 elif edep['deprel'] == 'nmod:voc':
-                    # 'v 8. čísle tiskoviny Ty rudá krávo'
                     edep['deprel'] = 'nmod:nom'
-                elif re.match(r'^(nmod|obl(:arg)?):o$', edep['deprel']):
-                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':loc'
                 else:
                     # If one of the following expressions occurs followed by another preposition,
                     # remove the additional preposition. For example, 'i_když_s' becomes just 'i_když'.

From ff0d5c915064a5b07977fe15cdc1858bf49fe786 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 22 Feb 2022 17:35:09 +0100
Subject: [PATCH 0512/1374] Circleci project setup (#103)

* Add .circleci/config.yml

* CircleCI debugging

* CircleCI debug

* regexes need \r""

* allow len(document)

Users may expect this to work, when document[i] works.

* reader.read_documents()

* add a comment explaining the hack from #96

* add a first test for coreference API

* fix the bug revealed in test_coref.py thanks to @ondfa

* switch from TravisCI to CircleCI
---
 .circleci/config.yml                          | 57 ++++++++++++++++++
 .travis.yml                                   | 34 -----------
 README.md                                     |  2 +-
 test-requirements.txt                         |  1 +
 udapi/core/basereader.py                      | 20 +++++++
 udapi/core/coref.py                           | 10 ++--
 udapi/core/document.py                        |  3 +
 udapi/core/tests/__init__.py                  |  0
 .../tests/data/fr-democrat-dev-sample.conllu  | 60 +++++++++++++++++++
 udapi/core/tests/test_coref.py                | 23 +++++++
 10 files changed, 170 insertions(+), 40 deletions(-)
 create mode 100644 .circleci/config.yml
 delete mode 100644 .travis.yml
 create mode 100644 test-requirements.txt
 create mode 100644 udapi/core/tests/__init__.py
 create mode 100644 udapi/core/tests/data/fr-democrat-dev-sample.conllu
 create mode 100755 udapi/core/tests/test_coref.py

diff --git a/.circleci/config.yml b/.circleci/config.yml
new file mode 100644
index 00000000..7be539d2
--- /dev/null
+++ b/.circleci/config.yml
@@ -0,0 +1,57 @@
+# Use the latest 2.1 version of CircleCI pipeline process engine.
+# See: https://circleci.com/docs/2.0/configuration-reference
+version: 2.1
+
+# Orbs are reusable packages of CircleCI configuration that you may share across projects, enabling you to create encapsulated, parameterized commands, jobs, and executors that can be used across multiple projects.
+# See: https://circleci.com/docs/2.0/orb-intro/
+orbs:
+  # The python orb contains a set of prepackaged CircleCI configuration you can use repeatedly in your configuration files
+  # Orb commands and jobs help you with common scripting around a language/tool
+  # so you dont have to copy and paste it everywhere.
+  # See the orb documentation here: https://circleci.com/developer/orbs/orb/circleci/python
+  python: circleci/python@1.5.0
+
+# Define a job to be invoked later in a workflow.
+# See: https://circleci.com/docs/2.0/configuration-reference/#jobs
+jobs:
+  build-and-test: # This is the name of the job, feel free to change it to better match what you're trying to do!
+    # These next lines defines a Docker executors: https://circleci.com/docs/2.0/executor-types/
+    # You can specify an image from Dockerhub or use one of the convenience images from CircleCI's Developer Hub
+    # A list of available CircleCI Docker convenience images are available here: https://circleci.com/developer/images/image/cimg/python
+    # The executor is the environment in which the steps below will be executed - below will use a python 3.10.2 container
+    # Change the version below to your required version of python
+    docker:
+      - image: cimg/python:3.9
+    # Checkout the code as the first step. This is a dedicated CircleCI step.
+    # The python orb's install-packages step will install the dependencies from a Pipfile via Pipenv by default.
+    # Here we're making sure we use just use the system-wide pip. By default it uses the project root's requirements.txt.
+    # Then run your tests!
+    # CircleCI will report the results back to your VCS provider.
+    steps:
+      - checkout
+      - python/install-packages:
+          pkg-manager: pip
+          # app-dir: ~/project/package-directory/  # If you're requirements.txt isn't in the root directory.
+          # pip-dependency-file: test-requirements.txt  # if you have a different name for your requirements file, maybe one that combines your runtime and test requirements.
+      - run:
+          name: Install Udapi
+          command: pip install --use-feature=in-tree-build ".[test]"
+      - run:
+          name: Run pytest tests
+          # This assumes pytest is installed via the install-package step above
+          command: pytest
+      - run:
+          name: Color TextModeTrees
+          command: udapy read.Conllu files=udapi/core/tests/data/babinsky.conllu write.TextModeTrees color=1
+      - run:
+          name: External tests
+          command: cd udapi/core/tests && ./external_tests.sh
+
+
+# Invoke jobs via workflows
+# See: https://circleci.com/docs/2.0/configuration-reference/#workflows
+workflows:
+  sample: # This is the name of the workflow, feel free to change it to better match your workflow.
+    # Inside the workflow, you define the jobs you want to run.
+    jobs:
+      - build-and-test
diff --git a/.travis.yml b/.travis.yml
deleted file mode 100644
index 417e39fb..00000000
--- a/.travis.yml
+++ /dev/null
@@ -1,34 +0,0 @@
-language: python
-python:
-  - "3.6"
-  - "3.7"
-  - "3.8"
-  - "3.9"
-#before_install:
-#  - sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
-#  - sudo apt-get update -qq
-#  - sudo apt-get install -qq gcc-4.8 g++-4.8
-#  - CC=g++-4.8 pip install ufal.udpipe
-#install:
-#  - python setup.py install
-install:
-  - pip3 install ".[test]"
-script:
-  - python -m pytest
-  - udapy read.Conllu files=udapi/core/tests/data/babinsky.conllu write.TextModeTrees color=1
-  - cd udapi/core/tests && ./external_tests.sh
-jobs:
-  include:
-    - name: "Python 3.9 on Windows"
-      os: windows
-      language: shell
-      before_install:
-        - choco install python
-        - python --version
-        - python -m pip install --upgrade pip
-        - pip3 install --upgrade pytest
-      env: PATH=/c/Python39:/c/Python39/Scripts:$PATH
-      script:
-        - python -c 'import colorama;print("\033[31m some red text")'
-        - python -Xutf8 -c 'import udapi;udapi.Document("udapi/core/tests/data/babinsky.conllu").draw(color=1)'
-        - python -m pytest
diff --git a/README.md b/README.md
index 3bf52eec..11b689dc 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 # udapi-python
 Python framework for processing Universal Dependencies data
 
-[![Build Status](https://travis-ci.org/udapi/udapi-python.svg?branch=master)](https://travis-ci.org/udapi/udapi-python)
+[![Build Status](https://circleci.com/gh/udapi/udapi-python.svg?style=svg)](https://circleci.com/gh/udapi/udapi-python)
 [![Website](https://img.shields.io/website-up-down-green-red/http/udapi.github.io.svg)](http://udapi.github.io)
 [![Documentation Status](https://readthedocs.org/projects/udapi/badge/)](http://udapi.readthedocs.io)
 
diff --git a/test-requirements.txt b/test-requirements.txt
new file mode 100644
index 00000000..e079f8a6
--- /dev/null
+++ b/test-requirements.txt
@@ -0,0 +1 @@
+pytest
diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index fee9da4c..9210b910 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -28,6 +28,12 @@ def __init__(self, files='-', filehandle=None, zone='keep', bundles_per_doc=0, e
             logging.debug('Using sent_id_filter=%s', sent_id_filter)
         self.split_docs = split_docs
         self.ignore_sent_id = ignore_sent_id
+        # `global.Entity` is a header stored in a comment before the first tree of each document in a given CoNLL-U file.
+        # In Udapi, it is stored in `document.meta['global.Entity']`, but for technical reasons, we need to temporarily store it in here, the reader.
+        # The reason is that `read.Conllu` uses a fast loading interface with `read_trees()`,
+        # which reads all the trees in a file at once, but it does not have access to the document instance,
+        # it just returns a sequence of trees (which may be split into multiple documents if `bundles_per_doc` is set).
+        # So `read.Conllu` cannot store the `global.Entity` in `document.meta['global.Entity']` where it belongs.
         self._global_entity = None
 
     @staticmethod
@@ -170,6 +176,7 @@ def process_document(self, document):
                 bundle.add_tree(root)
                 if root.newdoc and root.newdoc is not True:
                     document.meta["docname"] = root.newdoc
+                document.meta['global.Entity'] = self._global_entity
 
             filehandle = self.filehandle
             if filehandle is None:
@@ -259,3 +266,16 @@ def process_document(self, document):
             if gc_was_enabled:
                 gc.enable()
                 gc.collect()
+
+    def read_documents(self):
+        """Load all documents of this reader and return them as a list."""
+        # udapi.core.document imports udapi.block.read.conllu because of doc.load_conllu(filename)
+        # and udapi.block.read.conllu loads this module (udapi.core.basereader),
+        # so we cannot load udapi.core.document at the beginning of this module.
+        from udapi.core.document import Document
+        docs = []
+        while not self.finished:
+            doc = Document()
+            self.process_document(doc)
+            docs.append(doc)
+        return docs
diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 9e3e97ee..9eedeeb6 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -542,7 +542,7 @@ def load_coref_from_misc(doc, strict=True):
         # means a start of entity id=7 and start&end (i.e. single-word mention) of entity id=3.
         # The following re.split line splits this into
         # chunks = ["(abstract-7-new-2-coref", "(abstract-3-giv:act-1-coref)"]
-        chunks = [x for x in re.split('(\([^()]+\)?|[^()]+\))', misc_entity) if x]
+        chunks = [x for x in re.split(r'(\([^()]+\)?|[^()]+\))', misc_entity) if x]
         for chunk in chunks:
             opening, closing = (chunk[0] == '(', chunk[-1] == ')')
             chunk = chunk.strip('()')
@@ -752,7 +752,7 @@ def store_coref_to_misc(doc):
             for idx,subspan in enumerate(subspans, 1):
                 eid = cluster.cluster_id
                 if tree2docid and 'GRP' in fields:
-                    eid = re.sub('^d\d+\.', '', eid) # TODO or "eid = cluster.eid_or_grp"?
+                    eid = re.sub(r'^d\d+\.', '', eid) # TODO or "eid = cluster.eid_or_grp"?
                 subspan_eid = f'{eid}[{idx}/{len(subspans)}]'
                 subspan_words = span_to_nodes(root, subspan)
                 fake_cluster = CorefCluster(subspan_eid, cluster.cluster_type)
@@ -771,7 +771,7 @@ def store_coref_to_misc(doc):
             if field == 'eid' or field == 'GRP':
                 eid = cluster.cluster_id
                 if field == 'GRP':
-                    eid = re.sub('^d\d+\.', '', eid)
+                    eid = re.sub(r'^d\d+\.', '', eid)
                 if any(x in eid for x in CHARS_FORBIDDEN_IN_ID):
                     _error(f"{eid} contains forbidden characters [{CHARS_FORBIDDEN_IN_ID}]", strict)
                     for c in CHARS_FORBIDDEN_IN_ID:
@@ -823,7 +823,7 @@ def store_coref_to_misc(doc):
             elif '(' not in orig_entity:
                 firstword.misc['Entity'] = mention_str + ')' + orig_entity
             # (e9)e4)e3) --> (e10)(e9)e4)e3)
-            elif any(c and c[0] == '(' and c[-1] != ')' for c in re.split('(\([^()]+\)?|[^()]+\))', orig_entity)):
+            elif any(c and c[0] == '(' and c[-1] != ')' for c in re.split(r'(\([^()]+\)?|[^()]+\))', orig_entity)):
                 firstword.misc['Entity'] += mention_str + ')'
             # (e1(e2(e9)   --> (e1(e2(e9)(e10)
             # e3)(e1(e2(e9)--> e3)(e1(e2(e9)(e10)
@@ -834,7 +834,7 @@ def store_coref_to_misc(doc):
             firstword.misc['Entity'] += mention_str
             eid = cluster.cluster_id
             if tree2docid and 'GRP' in fields:
-                eid = re.sub('^d\d+\.', '', eid)
+                eid = re.sub(r'^d\d+\.', '', eid)
             mention.words[-1].misc['Entity'] = eid + ')' + mention.words[-1].misc['Entity']
 
         # Bridge=e1<e5:subset,e2<e6:subset|Entity=(e5(e6
diff --git a/udapi/core/document.py b/udapi/core/document.py
index aceeafdf..c50f8e43 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -44,6 +44,9 @@ def __iter__(self):
     def __getitem__(self, key):
         return self.bundles[key]
 
+    def __len__(self):
+        return len(self.bundles)
+
     def __str__(self):
         """Pretty print the whole document using write.TextModeTrees."""
         fh = io.StringIO()
diff --git a/udapi/core/tests/__init__.py b/udapi/core/tests/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/udapi/core/tests/data/fr-democrat-dev-sample.conllu b/udapi/core/tests/data/fr-democrat-dev-sample.conllu
new file mode 100644
index 00000000..b3a85f80
--- /dev/null
+++ b/udapi/core/tests/data/fr-democrat-dev-sample.conllu
@@ -0,0 +1,60 @@
+# newdoc id = ungroupped-estrepublicain-2-066
+# global.Entity = eid-etype-head-other
+# newpar id = ungroupped-estrepublicain-2-066-p0
+# sent_id = ungroupped-estrepublicain-2-066-p0-s1
+# text = Les allocations de décembre arrivent !
+1	Les	le	DET	_	Definite=Def|Gender=Fem|Number=Plur|PronType=Art	2	det	_	Entity=(e36772--2
+2	allocations	allocation	NOUN	_	Gender=Fem|Number=Plur	5	nsubj	_	_
+3	de	de	ADP	_	_	4	case	_	_
+4	décembre	décembre	NOUN	_	Gender=Masc|Number=Sing	2	nmod	_	Entity=e36772)
+5	arrivent	arriver	VERB	_	Mood=Ind|Number=Plur|Person=3|Tense=Pres|VerbForm=Fin	0	root	_	_
+6	!	!	PUNCT	_	_	5	punct	_	_
+
+# newpar id = ungroupped-estrepublicain-2-066-p1
+# sent_id = ungroupped-estrepublicain-2-066-p1-s1
+# text = La Caisse d' Allocations familiales du Territoire de Belfort informe ses allocataires que le montant des prestations sera disponible sur les comptes bancaires ou postaux à partir du 8 janvier .
+1	La	le	DET	_	Definite=Def|Gender=Fem|Number=Sing|PronType=Art	2	det	_	Entity=(e36773--2
+2	Caisse	caisse	NOUN	_	Gender=Fem|Number=Sing	11	nsubj	_	Entity=(e36774-organization-1
+3	d'	de	ADP	_	_	4	case	_	_
+4	Allocations	Allocations	NOUN	_	Gender=Fem|Number=Plur	2	nmod	_	_
+5	familiales	familial	ADJ	_	Gender=Fem|Number=Plur	4	amod	_	_
+6-7	du	_	_	_	_	_	_	_	_
+6	de	de	ADP	_	_	8	case	_	_
+7	le	le	DET	_	Definite=Def|Gender=Masc|Number=Sing|PronType=Art	8	det	_	Entity=(e36775--2
+8	Territoire	territoire	NOUN	_	Gender=Masc|Number=Sing	2	nmod	_	_
+9	de	de	ADP	_	_	10	case	_	_
+10	Belfort	Belfort	PROPN	_	_	8	nmod	_	Entity=e36775)e36774)e36773)
+11	informe	informer	VERB	_	Mood=Ind|Number=Sing|Person=3|Tense=Pres|VerbForm=Fin	0	root	_	_
+12	ses	son	DET	_	Gender=Masc|Number=Plur|Poss=Yes|PronType=Prs	13	det	_	Entity=(e36776--2(e36773--1)
+13	allocataires	allocataire	NOUN	_	Gender=Masc|Number=Plur	11	obj	_	Entity=e36776)
+14	que	que	PRON	_	PronType=Rel	21	mark	_	_
+15	le	le	DET	_	Definite=Def|Gender=Masc|Number=Sing|PronType=Art	16	det	_	Entity=(e36777--2
+16	montant	montant	NOUN	_	Gender=Masc|Number=Sing	21	nsubj	_	_
+17-18	des	_	_	_	_	_	_	_	_
+17	de	de	ADP	_	_	19	case	_	_
+18	les	le	DET	_	Definite=Def|Gender=Fem|Number=Plur|PronType=Art	19	det	_	Entity=(e36778--2
+19	prestations	prestation	NOUN	_	Gender=Fem|Number=Plur	16	nmod	_	Entity=e36778)e36777)
+20	sera	être	AUX	_	Mood=Ind|Number=Sing|Person=3|Tense=Fut|VerbForm=Fin	21	cop	_	_
+21	disponible	disponible	ADJ	_	Gender=Fem|Number=Sing	11	advcl	_	_
+22	sur	sur	ADP	_	_	24	case	_	_
+23	les	le	DET	_	Definite=Def|Gender=Masc|Number=Plur|PronType=Art	24	det	_	Entity=(e36779--2
+24	comptes	compte	NOUN	_	Gender=Masc|Number=Plur	21	obl	_	_
+25	bancaires	bancaire	ADJ	_	Gender=Masc|Number=Plur	24	amod	_	_
+26	ou	ou	CCONJ	_	_	27	cc	_	_
+27	postaux	postal	ADJ	_	Gender=Masc|Number=Plur	25	conj	_	Entity=e36779)
+28	à	à	ADP	_	_	33	case	_	_
+29	partir	partir	VERB	_	VerbForm=Inf	28	fixed	_	_
+30-31	du	_	_	_	_	_	_	_	_
+30	de	de	ADP	_	_	28	fixed	_	_
+31	le	le	DET	_	Definite=Def|Gender=Masc|Number=Sing|PronType=Art	33	det	_	Entity=(e36780--3
+32	8	8	NUM	_	_	33	nummod	_	_
+33	janvier	janvier	NOUN	_	Gender=Masc|Number=Sing	21	obl	_	Entity=e36780)
+34	.	.	PUNCT	_	_	11	punct	_	_
+
+# newdoc id = ungroupped-estrepublicain-2-005
+# global.Entity = eid-etype-head-other
+# newpar id = ungroupped-estrepublicain-2-005-p0
+# sent_id = ungroupped-estrepublicain-2-005-p0-s1
+# text = Vitry-le-François
+1	Vitry-le-François	Vitry-le-François	PROPN	_	_	0	root	_	Entity=(e36781-place-1)
+
diff --git a/udapi/core/tests/test_coref.py b/udapi/core/tests/test_coref.py
new file mode 100755
index 00000000..855a338e
--- /dev/null
+++ b/udapi/core/tests/test_coref.py
@@ -0,0 +1,23 @@
+#!/usr/bin/env python3
+
+import os
+import unittest
+import udapi
+from udapi.block.read.conllu import Conllu as ConlluReader
+
+
+class TestCoref(unittest.TestCase):
+
+    def test_load(self):
+        data_filename = os.path.join(os.path.dirname(__file__), 'data', 'fr-democrat-dev-sample.conllu')
+        reader = ConlluReader(files=data_filename, split_docs=True)
+        docs = reader.read_documents()
+        self.assertEqual(len(docs), 2)
+        docs[-1].draw()
+        coref_entities = list(docs[-1].coref_clusters.values())
+        self.assertEqual(len(coref_entities), 1)
+        self.assertEqual(coref_entities[0].cluster_id, 'e36781')
+
+
+if __name__ == "__main__":
+    unittest.main()

From b04dd2fcf860cc412b93e0dfdd6720ae09153b7c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Feb 2022 23:16:53 +0100
Subject: [PATCH 0513/1374] =?UTF-8?q?'=D1=81=5F=D0=BF=D0=BE=D0=BC=D0=BE?=
 =?UTF-8?q?=D1=89=D1=8C=D1=8E:gen'?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ru/fixedeprels.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 48febee5..675e9eac 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -11,7 +11,8 @@ class FixEdeprels(Block):
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
-        'как':              'как' # remove morphological case
+        'как':              'как', # remove morphological case
+        'с_помощь':         'с_помощью:gen'
     }
 
     def process_node(self, node):

From e3dbb514d734e96000d10e23a402a6aabd982e8d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 3 Mar 2022 11:13:50 +0100
Subject: [PATCH 0514/1374] CircleCI icon matching the style of other icons

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 11b689dc..0b41297f 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 # udapi-python
 Python framework for processing Universal Dependencies data
 
-[![Build Status](https://circleci.com/gh/udapi/udapi-python.svg?style=svg)](https://circleci.com/gh/udapi/udapi-python)
+[![Build Status](https://circleci.com/gh/udapi/udapi-python.svg?style=shield)](https://circleci.com/gh/udapi/udapi-python)
 [![Website](https://img.shields.io/website-up-down-green-red/http/udapi.github.io.svg)](http://udapi.github.io)
 [![Documentation Status](https://readthedocs.org/projects/udapi/badge/)](http://udapi.readthedocs.io)
 

From d1db476c8dbd2d52a89c42da0f4175e03baf528b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 3 Mar 2022 15:14:46 +0100
Subject: [PATCH 0515/1374] fix `entity.create_mention()` and add a test

---
 udapi/core/coref.py            |  2 +-
 udapi/core/tests/test_coref.py | 25 +++++++++++++++++++++++++
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 9eedeeb6..35c66d83 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -330,7 +330,7 @@ def create_mention(self, head=None, mention_words=None, mention_span=None):
         if head is None:
             head = mention_words[0]
 
-        mention = CorefMention(head, self)
+        mention = CorefMention(words=[head], head=head, cluster=self)
         if mention_words:
             mention.words = mention_words
         if mention_span:
diff --git a/udapi/core/tests/test_coref.py b/udapi/core/tests/test_coref.py
index 855a338e..6a77e886 100755
--- a/udapi/core/tests/test_coref.py
+++ b/udapi/core/tests/test_coref.py
@@ -18,6 +18,31 @@ def test_load(self):
         self.assertEqual(len(coref_entities), 1)
         self.assertEqual(coref_entities[0].cluster_id, 'e36781')
 
+    def test_edits(self):
+        data_filename = os.path.join(os.path.dirname(__file__), 'data', 'fr-democrat-dev-sample.conllu')
+        doc = udapi.Document(data_filename)
+        first_node = next(doc.nodes)
+        second_node = first_node.next_node
+        new_entity = first_node.create_coref_cluster(cluster_type='person')
+        self.assertEqual(new_entity.cluster_type, 'person')
+        self.assertEqual(len(new_entity.mentions), 1)
+        m1 = new_entity.mentions[0]
+        self.assertEqual(m1.cluster, new_entity)
+        self.assertEqual(m1.head, first_node)
+        self.assertEqual(m1.words, [first_node])
+        self.assertEqual(m1.span, '1')
+        m1.words = [second_node, first_node, first_node] # intentional duplicates and wrong order
+        self.assertEqual(m1.words, [first_node, second_node])
+        self.assertEqual(m1.span, '1-2')
+        m1.head = second_node
+        self.assertEqual(m1.head, second_node)
+        m2 = new_entity.create_mention(head=second_node, mention_span='1-3')
+        self.assertEqual(len(new_entity.mentions), 2)
+        self.assertEqual(new_entity.mentions[0], m2) # 1-3 should go before 1-2
+        self.assertEqual(new_entity.mentions[1], m1)
+        self.assertTrue(m2 < m1)
+        self.assertEqual(m2.words, [first_node, second_node, second_node.next_node])
+
 
 if __name__ == "__main__":
     unittest.main()

From 1ffb06789175aa5bf9ee546df7ae2624bb42acde Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 3 Mar 2022 19:51:23 +0100
Subject: [PATCH 0516/1374] add `doc.create_coref_cluster()`, rename params of
 `cluster.create_mention()`

`doc.create_coref_cluster()` allows to create a new cluster
without any mentions, which seems to be practical in real use cases.

`m = cluster.create_mention(mention_words=[w1, w2])` seems redunant,
`m = cluster.create_mention(words=[w1, w2])` looks better.
Similarly with `mention_span` -> `span`.
It will be consistent with `m.words` and `m.span`.

TODO: consider removing `new_cluster = node.create_coref_cluster()`
which creates both a cluster and a new mention, but does not return the mention
(it can be accessed with `new_cluster.mentions[0]`, of course).
So far, I've just remove it from the tests.
---
 udapi/core/coref.py            | 48 ++++++++++++----------------------
 udapi/core/document.py         | 13 +++++++++
 udapi/core/node.py             |  8 ++++--
 udapi/core/tests/test_coref.py |  8 +++---
 4 files changed, 41 insertions(+), 36 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 35c66d83..eef25dd2 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -302,7 +302,7 @@ def eid_or_grp(self):
     def mentions(self):
         return self._mentions
 
-    def create_mention(self, head=None, mention_words=None, mention_span=None):
+    def create_mention(self, head=None, words=None, span=None):
         """Create a new CoreferenceMention object within this CorefCluster.
 
         Args:
@@ -310,31 +310,31 @@ def create_mention(self, head=None, mention_words=None, mention_span=None):
             The head is supposed to be the linguistic head of the mention,
             i.e. the highest node in the dependency tree,
             but if such information is not available (yet),
-            it can be any node within the mention_words.
-            If no head is specified, the first word from mention_words will be used instead.
-        mention_words: a list of nodes of the mention.
+            it can be any node within the `words`.
+            If no head is specified, the first word from `words` will be used instead.
+        words: a list of nodes of the mention.
             This argument is optional, but if provided, it must contain the head.
             The nodes can be both normal nodes or empty nodes.
-        mention_span: an alternative way how to specify mention_words
+        span: an alternative way how to specify `words`
             using a string such as "3-5,6,7.1-7.2".
             (which means, there is an empty node 5.1 and normal node 7,
             which are not part of the mention).
-            At most one of the args mention_words and mention_span can be specified.
+            At most one of the args `words` and `span` can be specified.
         """
-        if mention_words and mention_span:
-            raise ValueError("Cannot specify both mention_words and mention_span")
-        if head and mention_words and head not in mention_words:
-            raise ValueError(f"Head {head} is not among the specified mention_words")
-        if head is None and mention_words is None:
-            raise ValueError("Either head or mention_words must be specified")
+        if words and span:
+            raise ValueError("Cannot specify both words and span")
+        if head and words and head not in words:
+            raise ValueError(f"Head {head} is not among the specified words")
+        if head is None and words is None:
+            raise ValueError("Either head or words must be specified")
         if head is None:
-            head = mention_words[0]
+            head = words[0]
 
         mention = CorefMention(words=[head], head=head, cluster=self)
-        if mention_words:
-            mention.words = mention_words
-        if mention_span:
-            mention.span = mention_span
+        if words:
+            mention.words = words
+        if span:
+            mention.span = span
         self._mentions.sort()
         return mention
 
@@ -477,20 +477,6 @@ def _delete_targets_without_mentions(self, warn=True):
                 self._data.remove(link)
 
 
-def create_coref_cluster(head, cluster_id=None, cluster_type=None, **kwargs):
-    clusters = head.root.bundle.document.coref_clusters
-    if not cluster_id:
-        counter = 1
-        while clusters.get('c%d' % counter):
-            counter += 1
-        cluster_id = 'c%d' % counter
-    elif clusters.get(cluster_id):
-        raise ValueError("Cluster with a id %s already exists", cluster_id)
-    cluster = CorefCluster(cluster_id, cluster_type)
-    cluster.create_mention(head, **kwargs)
-    clusters[cluster_id] = cluster
-    return cluster
-
 def _error(msg, strict):
     if strict:
         raise ValueError(msg)
diff --git a/udapi/core/document.py b/udapi/core/document.py
index c50f8e43..8e33c8d6 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -136,3 +136,16 @@ def coref_mentions(self):
             all_mentions.extend(cluster.mentions)
         all_mentions.sort()
         return all_mentions
+
+    def create_coref_cluster(self, cluster_id=None, cluster_type=None):
+        self._load_coref()
+        if not cluster_id:
+            counter = 1
+            while self._coref_clusters.get(f'c{counter}'):
+                counter += 1
+            cluster_id = f'c{counter}'
+        elif clusters.get(cluster_id):
+            raise ValueError("Cluster with a id %s already exists", cluster_id)
+        cluster = udapi.core.coref.CorefCluster(cluster_id, cluster_type)
+        self._coref_clusters[cluster_id] = cluster
+        return cluster
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 3d120a52..4524c119 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -921,8 +921,12 @@ def coref_clusters(self):
         self._root.bundle.document._load_coref()
         return [m.cluster for m in self._mentions if m.cluster is not None]
 
-    def create_coref_cluster(self, **kwargs):
-        return udapi.core.coref.create_coref_cluster(head=self, **kwargs)
+    # TODO: is this method useful?
+    def create_coref_cluster(self, cluster_id=None, cluster_type=None, **kwargs):
+        doc = self._root.bundle.document
+        cluster = doc.create_coref_cluster(cluster_id, cluster_type)
+        cluster.create_mention(head=self, **kwargs)
+        return cluster
 
 
 class CycleError(Exception):
diff --git a/udapi/core/tests/test_coref.py b/udapi/core/tests/test_coref.py
index 6a77e886..8eab1436 100755
--- a/udapi/core/tests/test_coref.py
+++ b/udapi/core/tests/test_coref.py
@@ -23,10 +23,12 @@ def test_edits(self):
         doc = udapi.Document(data_filename)
         first_node = next(doc.nodes)
         second_node = first_node.next_node
-        new_entity = first_node.create_coref_cluster(cluster_type='person')
+        new_entity = doc.create_coref_cluster(cluster_type='person')
         self.assertEqual(new_entity.cluster_type, 'person')
+        self.assertEqual(len(new_entity.mentions), 0)
+        m1 = new_entity.create_mention(words=[first_node]) # head will be automatically set to words[0]
         self.assertEqual(len(new_entity.mentions), 1)
-        m1 = new_entity.mentions[0]
+        self.assertEqual(m1, new_entity.mentions[0])
         self.assertEqual(m1.cluster, new_entity)
         self.assertEqual(m1.head, first_node)
         self.assertEqual(m1.words, [first_node])
@@ -36,7 +38,7 @@ def test_edits(self):
         self.assertEqual(m1.span, '1-2')
         m1.head = second_node
         self.assertEqual(m1.head, second_node)
-        m2 = new_entity.create_mention(head=second_node, mention_span='1-3')
+        m2 = new_entity.create_mention(head=second_node, span='1-3') # mention.words will be filled according to the span
         self.assertEqual(len(new_entity.mentions), 2)
         self.assertEqual(new_entity.mentions[0], m2) # 1-3 should go before 1-2
         self.assertEqual(new_entity.mentions[1], m1)

From d025550b1102fa0fa2546e9d0e8cc9de0165498a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 9 Mar 2022 09:48:16 +0100
Subject: [PATCH 0517/1374] Some more Russian prepositions.

---
 udapi/block/ud/ru/fixedeprels.py | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 675e9eac..440cfd0b 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -11,8 +11,12 @@ class FixEdeprels(Block):
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
+        'в_качество':       'в_качестве:gen',
+        'в_течение':        'в_течение:gen',
         'как':              'как', # remove morphological case
-        'с_помощь':         'с_помощью:gen'
+        'несмотря_на':      'несмотря_на:acc',
+        'с_помощь':         'с_помощью:gen',
+        'чем':              'чем' # remove morphological case
     }
 
     def process_node(self, node):
@@ -38,7 +42,7 @@ def process_node(self, node):
                 # available. Thanks to the Case feature on prepositions, we can
                 # identify the correct one.
                 if not solved:
-                    m = re.match(r'^(obl(?::arg)?|nmod):(mezi|na|nad|o|po|pod|před|v|za)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
+                    m = re.match(r'^(obl(?::arg)?|nmod):(на)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
                     if m:
                         # The following is only partial solution. We will not see
                         # some children because they may be shared children of coordination.
@@ -46,6 +50,9 @@ def process_node(self, node):
                         if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
                             edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
                             solved = True
+                        else:
+                            # Accusative or locative are possible. Pick locative.
+                            edep['deprel'] = m.group(1)+':'+m.group(2)+':loc'
             if re.match(r'^(acl|advcl):', edep['deprel']):
                 edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])

From c6893e678e637121b5413b5322e41eb6fca868e7 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 10 Mar 2022 17:25:34 +0100
Subject: [PATCH 0518/1374] Russian prepositions with morphological case.

---
 udapi/block/ud/ru/fixedeprels.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 440cfd0b..e96fd8d1 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -42,7 +42,9 @@ def process_node(self, node):
                 # available. Thanks to the Case feature on prepositions, we can
                 # identify the correct one.
                 if not solved:
-                    m = re.match(r'^(obl(?::arg)?|nmod):(на)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
+                    ###!!! Both "на" and "в" seem to also occur with genitive.
+                    ###!!! I don't think it is valid but let's see some examples before we ban it.
+                    m = re.match(r'^(obl(?::arg)?|nmod):(в|на)(?::(?:nom|dat|voc))?$', edep['deprel'])
                     if m:
                         # The following is only partial solution. We will not see
                         # some children because they may be shared children of coordination.

From 51cd1b134bac365139ca0841d01aebd22794b247 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 11 Mar 2022 11:06:32 +0100
Subject: [PATCH 0519/1374] Russian prepositions with morphological case.

---
 udapi/block/ud/ru/fixedeprels.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index e96fd8d1..d9c539d5 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -13,6 +13,7 @@ class FixEdeprels(Block):
     unambiguous = {
         'в_качество':       'в_качестве:gen',
         'в_течение':        'в_течение:gen',
+        'в_ход':            'в_ходе:gen',
         'как':              'как', # remove morphological case
         'несмотря_на':      'несмотря_на:acc',
         'с_помощь':         'с_помощью:gen',
@@ -42,9 +43,10 @@ def process_node(self, node):
                 # available. Thanks to the Case feature on prepositions, we can
                 # identify the correct one.
                 if not solved:
-                    ###!!! Both "на" and "в" seem to also occur with genitive.
-                    ###!!! I don't think it is valid but let's see some examples before we ban it.
-                    m = re.match(r'^(obl(?::arg)?|nmod):(в|на)(?::(?:nom|dat|voc))?$', edep['deprel'])
+                    # Both "на" and "в" also occur with genitive. However, this
+                    # is only because there are numerals in the phrase ("в 9 случаев из 10")
+                    # and the whole phrase should not be analyzed as genitive.
+                    m = re.match(r'^(obl(?::arg)?|nmod):(в|на)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
                     if m:
                         # The following is only partial solution. We will not see
                         # some children because they may be shared children of coordination.

From 71899a4bfddeafe870d4a18c403042c2f980c678 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 12 Mar 2022 13:42:27 +0100
Subject: [PATCH 0520/1374] Russian prepositions with morphological cases.

---
 udapi/block/ud/ru/fixedeprels.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index d9c539d5..cc21ec33 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -12,10 +12,13 @@ class FixEdeprels(Block):
     # case, even if they are not secondary.
     unambiguous = {
         'в_качество':       'в_качестве:gen',
+        'в_связь_с':        'в_связи_с:ins',
         'в_течение':        'в_течение:gen',
         'в_ход':            'в_ходе:gen',
         'как':              'как', # remove morphological case
         'несмотря_на':      'несмотря_на:acc',
+        'помимо':           'помимо:gen',
+        'со_сторона':       'со_стороны:gen',
         'с_помощь':         'с_помощью:gen',
         'чем':              'чем' # remove morphological case
     }

From 094a2b982cc7575ab7b3c5d22d103b08e6343ece Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 13 Mar 2022 11:05:26 +0100
Subject: [PATCH 0521/1374] Russian prepositions.

---
 udapi/block/ud/ru/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index cc21ec33..eb8292ae 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -15,11 +15,13 @@ class FixEdeprels(Block):
         'в_связь_с':        'в_связи_с:ins',
         'в_течение':        'в_течение:gen',
         'в_ход':            'в_ходе:gen',
+        'до':               'до:gen',
         'как':              'как', # remove morphological case
         'несмотря_на':      'несмотря_на:acc',
         'помимо':           'помимо:gen',
         'со_сторона':       'со_стороны:gen',
         'с_помощь':         'с_помощью:gen',
+        'так_что':          'так_что', # remove morphological case
         'чем':              'чем' # remove morphological case
     }
 

From 3b6748be36653e917420d44a6c8d7d8a65782aa0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 24 Mar 2022 15:04:17 +0100
Subject: [PATCH 0522/1374] =?UTF-8?q?Rusk=C3=A9=20p=C5=99edlo=C5=BEky.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ru/fixedeprels.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index eb8292ae..c4906053 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -12,15 +12,19 @@ class FixEdeprels(Block):
     # case, even if they are not secondary.
     unambiguous = {
         'в_качество':       'в_качестве:gen',
+        'в_отношение':      'в_отношении:gen',
         'в_связь_с':        'в_связи_с:ins',
         'в_течение':        'в_течение:gen',
         'в_ход':            'в_ходе:gen',
+        'ведь':             'ведь', # remove morphological case
         'до':               'до:gen',
         'как':              'как', # remove morphological case
         'несмотря_на':      'несмотря_на:acc',
         'помимо':           'помимо:gen',
+        'согласно':         'согласно:dat',
         'со_сторона':       'со_стороны:gen',
         'с_помощь':         'с_помощью:gen',
+        'спустя':           'спустя:acc',
         'так_что':          'так_что', # remove morphological case
         'чем':              'чем' # remove morphological case
     }

From c513f676363cf0b901af67f1840f184f7361a9b7 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 24 Mar 2022 16:15:41 +0100
Subject: [PATCH 0523/1374] =?UTF-8?q?=D0=B7=D0=B0:gen?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ru/fixedeprels.py | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index c4906053..7a5a0dc1 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -66,6 +66,20 @@ def process_node(self, node):
                         else:
                             # Accusative or locative are possible. Pick locative.
                             edep['deprel'] = m.group(1)+':'+m.group(2)+':loc'
+                    # Both "за" and "" also occur with instrumental. However, this
+                    # is only because there are numerals in the phrase ("за последние 20 лет")
+                    # and the whole phrase should be usually analyzed as accusative.
+                    m = re.match(r'^(obl(?::arg)?|nmod):(за)(?::(?:nom|gen|dat|voc|loc))?$', edep['deprel'])
+                    if m:
+                        # The following is only partial solution. We will not see
+                        # some children because they may be shared children of coordination.
+                        prepchildren = [x for x in node.children if x.lemma == m.group(2)]
+                        if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
+                            edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
+                            solved = True
+                        else:
+                            # Accusative or instrumental are possible. Pick accusative.
+                            edep['deprel'] = m.group(1)+':'+m.group(2)+':acc'
             if re.match(r'^(acl|advcl):', edep['deprel']):
                 edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])

From 5f7d17f6db8263c062b5f8902c35e7a3baa7ce9f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Mar 2022 12:46:30 +0100
Subject: [PATCH 0524/1374] =?UTF-8?q?=D1=81=D0=BB=D0=BE=D0=B2=D0=BD=D0=BE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ru/fixedeprels.py | 82 ++++++++++++++++----------------
 1 file changed, 40 insertions(+), 42 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 7a5a0dc1..5aaf6308 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -21,9 +21,10 @@ class FixEdeprels(Block):
         'как':              'как', # remove morphological case
         'несмотря_на':      'несмотря_на:acc',
         'помимо':           'помимо:gen',
-        'согласно':         'согласно:dat',
-        'со_сторона':       'со_стороны:gen',
         'с_помощь':         'с_помощью:gen',
+        'словно':           'словно', # remove morphological case
+        'со_сторона':       'со_стороны:gen',
+        'согласно':         'согласно:dat',
         'спустя':           'спустя:acc',
         'так_что':          'так_что', # remove morphological case
         'чем':              'чем' # remove morphological case
@@ -48,38 +49,46 @@ def process_node(self, node):
                         edep['deprel'] = m.group(1)+':'+self.unambiguous[x]
                         solved = True
                         break
+                if solved:
+                    break
+                # If one of the following expressions occurs followed by another preposition
+                # or by morphological case, remove the additional case marking. For example,
+                # 'словно_у' becomes just 'словно'.
+                m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):словно([_:].+)?$', edep['deprel'])
+                if m:
+                    edep['deprel'] = m.group(1)+':словно'
+                    break
                 # The following prepositions have more than one morphological case
                 # available. Thanks to the Case feature on prepositions, we can
                 # identify the correct one.
-                if not solved:
-                    # Both "на" and "в" also occur with genitive. However, this
-                    # is only because there are numerals in the phrase ("в 9 случаев из 10")
-                    # and the whole phrase should not be analyzed as genitive.
-                    m = re.match(r'^(obl(?::arg)?|nmod):(в|на)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
-                    if m:
-                        # The following is only partial solution. We will not see
-                        # some children because they may be shared children of coordination.
-                        prepchildren = [x for x in node.children if x.lemma == m.group(2)]
-                        if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
-                            edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
-                            solved = True
-                        else:
-                            # Accusative or locative are possible. Pick locative.
-                            edep['deprel'] = m.group(1)+':'+m.group(2)+':loc'
-                    # Both "за" and "" also occur with instrumental. However, this
-                    # is only because there are numerals in the phrase ("за последние 20 лет")
-                    # and the whole phrase should be usually analyzed as accusative.
-                    m = re.match(r'^(obl(?::arg)?|nmod):(за)(?::(?:nom|gen|dat|voc|loc))?$', edep['deprel'])
-                    if m:
-                        # The following is only partial solution. We will not see
-                        # some children because they may be shared children of coordination.
-                        prepchildren = [x for x in node.children if x.lemma == m.group(2)]
-                        if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
-                            edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
-                            solved = True
-                        else:
-                            # Accusative or instrumental are possible. Pick accusative.
-                            edep['deprel'] = m.group(1)+':'+m.group(2)+':acc'
+                # Both "на" and "в" also occur with genitive. However, this
+                # is only because there are numerals in the phrase ("в 9 случаев из 10")
+                # and the whole phrase should not be analyzed as genitive.
+                m = re.match(r'^(obl(?::arg)?|nmod):(в|на)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
+                if m:
+                    # The following is only partial solution. We will not see
+                    # some children because they may be shared children of coordination.
+                    prepchildren = [x for x in node.children if x.lemma == m.group(2)]
+                    if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
+                        edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
+                        solved = True
+                    else:
+                        # Accusative or locative are possible. Pick locative.
+                        edep['deprel'] = m.group(1)+':'+m.group(2)+':loc'
+                # Both "за" and "" also occur with instrumental. However, this
+                # is only because there are numerals in the phrase ("за последние 20 лет")
+                # and the whole phrase should be usually analyzed as accusative.
+                m = re.match(r'^(obl(?::arg)?|nmod):(за)(?::(?:nom|gen|dat|voc|loc))?$', edep['deprel'])
+                if m:
+                    # The following is only partial solution. We will not see
+                    # some children because they may be shared children of coordination.
+                    prepchildren = [x for x in node.children if x.lemma == m.group(2)]
+                    if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
+                        edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
+                        solved = True
+                    else:
+                        # Accusative or instrumental are possible. Pick accusative.
+                        edep['deprel'] = m.group(1)+':'+m.group(2)+':acc'
             if re.match(r'^(acl|advcl):', edep['deprel']):
                 edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
@@ -94,17 +103,6 @@ def process_node(self, node):
                     edep['deprel'] = 'nmod:nom'
                 elif edep['deprel'] == 'nmod:voc':
                     edep['deprel'] = 'nmod:nom'
-                else:
-                    # If one of the following expressions occurs followed by another preposition,
-                    # remove the additional preposition. For example, 'i_když_s' becomes just 'i_když'.
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ač([_:].+)?$', r'\1:ač', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ačkoliv?([_:].+)?$', r'\1:ačkoli', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):byť[_:].+$', r'\1:byť', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):i_když[_:].+$', r'\1:i_když', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jak[_:].+$', r'\1:jak', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakkoliv?[_:].+$', r'\1:jakkoli', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jako[_:].+$', r'\1:jako', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby[_:].+$', r'\1:jako', edep['deprel']) # these instances in FicTree should be spelled 'jako by'
 
     def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
         '''

From 0cc70536aff35dc62fa3a22a904b6a3016caa3ae Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Mar 2022 15:20:05 +0100
Subject: [PATCH 0525/1374] =?UTF-8?q?=D0=BF=D1=80=D0=B8=5F=D0=BF=D0=BE?=
 =?UTF-8?q?=D0=BC=D0=BE=D1=89=D0=B8:gen?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ru/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 5aaf6308..74b919fb 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -20,7 +20,9 @@ class FixEdeprels(Block):
         'до':               'до:gen',
         'как':              'как', # remove morphological case
         'несмотря_на':      'несмотря_на:acc',
+        'по_повод':         'по_поводу:gen',
         'помимо':           'помимо:gen',
+        'при_помощь':       'при_помощи:gen',
         'с_помощь':         'с_помощью:gen',
         'словно':           'словно', # remove morphological case
         'со_сторона':       'со_стороны:gen',

From dc0cd7d432af92e86c476d44c46e510a07a5aae5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Mar 2022 16:40:00 +0100
Subject: [PATCH 0526/1374] More systematic processing of outermost case
 markers.

---
 udapi/block/ud/ru/fixedeprels.py | 39 +++++++++++++++++++++-----------
 1 file changed, 26 insertions(+), 13 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 74b919fb..c357fa49 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -5,31 +5,40 @@
 
 class FixEdeprels(Block):
 
+    # Sometimes there are multiple layers of case marking and only the outermost
+    # layer should be reflected in the relation. For example, the semblative 'как'
+    # is used with the same case (preposition + morphology) as the nominal that
+    # is being compared ('как_в:loc' etc.) We do not want to multiply the relations
+    # by all the inner cases.
+    outermost = [
+        'ведь',
+        'как',
+        'словно',
+        'так_что',
+        'чем'
+    ]
+
     # Secondary prepositions sometimes have the lemma of the original part of
     # speech. We want the grammaticalized form instead. List even those that
     # will have the same lexical form, as we also want to check the morphological
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
+        'в_вид':            'в_виде:gen',
         'в_качество':       'в_качестве:gen',
         'в_отношение':      'в_отношении:gen',
         'в_связь_с':        'в_связи_с:ins',
         'в_течение':        'в_течение:gen',
         'в_ход':            'в_ходе:gen',
-        'ведь':             'ведь', # remove morphological case
         'до':               'до:gen',
-        'как':              'как', # remove morphological case
         'несмотря_на':      'несмотря_на:acc',
         'по_повод':         'по_поводу:gen',
         'помимо':           'помимо:gen',
         'при_помощь':       'при_помощи:gen',
         'с_помощь':         'с_помощью:gen',
-        'словно':           'словно', # remove morphological case
         'со_сторона':       'со_стороны:gen',
         'согласно':         'согласно:dat',
-        'спустя':           'спустя:acc',
-        'так_что':          'так_что', # remove morphological case
-        'чем':              'чем' # remove morphological case
+        'спустя':           'спустя:acc'
     }
 
     def process_node(self, node):
@@ -43,6 +52,17 @@ def process_node(self, node):
             if m:
                 bdeprel = m.group(1)
                 solved = False
+                # If one of the following expressions occurs followed by another preposition
+                # or by morphological case, remove the additional case marking. For example,
+                # 'словно_у' becomes just 'словно'.
+                for x in self.outermost:
+                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'([_:].+)?$', edep['deprel'])
+                    if m:
+                        edep['deprel'] = m.group(1)+':'+x
+                        solved = True
+                        break
+                if solved:
+                    break
                 for x in self.unambiguous:
                     # All secondary prepositions have only one fixed morphological case
                     # they appear with, so we can replace whatever case we encounter with the correct one.
@@ -53,13 +73,6 @@ def process_node(self, node):
                         break
                 if solved:
                     break
-                # If one of the following expressions occurs followed by another preposition
-                # or by morphological case, remove the additional case marking. For example,
-                # 'словно_у' becomes just 'словно'.
-                m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):словно([_:].+)?$', edep['deprel'])
-                if m:
-                    edep['deprel'] = m.group(1)+':словно'
-                    break
                 # The following prepositions have more than one morphological case
                 # available. Thanks to the Case feature on prepositions, we can
                 # identify the correct one.

From b3e97c3b107e66d6f3c62549e3e000b8cfa2890e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Mar 2022 17:51:37 +0100
Subject: [PATCH 0527/1374] It is now possible to define exceptions to the
 rule.

---
 udapi/block/ud/ru/fixedeprels.py | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index c357fa49..6a1b001e 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -10,13 +10,14 @@ class FixEdeprels(Block):
     # is used with the same case (preposition + morphology) as the nominal that
     # is being compared ('как_в:loc' etc.) We do not want to multiply the relations
     # by all the inner cases.
-    outermost = [
-        'ведь',
-        'как',
-        'словно',
-        'так_что',
-        'чем'
-    ]
+    # The list in the value contains exceptions that should be left intact.
+    outermost = {
+        'ведь':    [],
+        'как':     ['как_только'],
+        'словно':  [],
+        'так_что': [],
+        'чем':     []
+    }
 
     # Secondary prepositions sometimes have the lemma of the original part of
     # speech. We want the grammaticalized form instead. List even those that
@@ -56,8 +57,9 @@ def process_node(self, node):
                 # or by morphological case, remove the additional case marking. For example,
                 # 'словно_у' becomes just 'словно'.
                 for x in self.outermost:
+                    exceptions = self.outermost[x]
                     m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'([_:].+)?$', edep['deprel'])
-                    if m:
+                    if m and not x+m.group(2) in exceptions:
                         edep['deprel'] = m.group(1)+':'+x
                         solved = True
                         break

From 052ab6c68235cb15fcc4c7f69718bb03e290a7ab Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Mar 2022 17:54:37 +0100
Subject: [PATCH 0528/1374] Fix?

---
 udapi/block/ud/ru/fixedeprels.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 6a1b001e..ab706346 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -59,7 +59,7 @@ def process_node(self, node):
                 for x in self.outermost:
                     exceptions = self.outermost[x]
                     m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'([_:].+)?$', edep['deprel'])
-                    if m and not x+m.group(2) in exceptions:
+                    if m and m.group(2) and not x+m.group(2) in exceptions:
                         edep['deprel'] = m.group(1)+':'+x
                         solved = True
                         break

From 61845025b063ce51a96384a59b8caaf4c67fd26f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Mar 2022 18:16:25 +0100
Subject: [PATCH 0529/1374] =?UTF-8?q?=D0=BA:dat?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ru/fixedeprels.py | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index ab706346..43ad5f3a 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -12,6 +12,7 @@ class FixEdeprels(Block):
     # by all the inner cases.
     # The list in the value contains exceptions that should be left intact.
     outermost = {
+        'будто':   [],
         'ведь':    [],
         'как':     ['как_только'],
         'словно':  [],
@@ -32,6 +33,7 @@ class FixEdeprels(Block):
         'в_течение':        'в_течение:gen',
         'в_ход':            'в_ходе:gen',
         'до':               'до:gen',
+        'к':                'к:dat',
         'несмотря_на':      'несмотря_на:acc',
         'по_повод':         'по_поводу:gen',
         'помимо':           'помимо:gen',
@@ -106,11 +108,7 @@ def process_node(self, node):
                     else:
                         # Accusative or instrumental are possible. Pick accusative.
                         edep['deprel'] = m.group(1)+':'+m.group(2)+':acc'
-            if re.match(r'^(acl|advcl):', edep['deprel']):
-                edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
-            elif re.match(r'^(nmod|obl):', edep['deprel']):
+            if re.match(r'^(nmod|obl):', edep['deprel']):
                 if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
                     # This is a same-case noun-noun modifier, which just happens to be in the locative.
                     # For example, 'v Ostravě-Porubě', 'Porubě' is attached to 'Ostravě', 'Ostravě' has

From 9c003aa06b289a21db51d612e4298b2d64632773 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Mar 2022 18:56:34 +0100
Subject: [PATCH 0530/1374] Fix advcl:(od|do):gen.

---
 udapi/block/ud/cs/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index b3e551e5..feed707d 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -256,6 +256,7 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:do:gen$', r'obl:do:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
                 edep['deprel'] = re.sub(r'^(acl):k:dat$', r'\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:k:dat$', r'obl:k:dat', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):kdy$', r'\1', edep['deprel'])
@@ -264,6 +265,7 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^(advcl):neboť$', r'\1', edep['deprel']) # 'neboť' is coordinating
                 edep['deprel'] = re.sub(r'^(advcl):nechť$', r'\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^acl:od:gen$', r'nmod:od:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:od:gen$', r'obl:od:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
                 edep['deprel'] = re.sub(r'^advcl:podle:gen$', r'obl:podle:gen', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:pro:acc$', r'obl:pro:acc', edep['deprel'])
                 edep['deprel'] = re.sub(r'^acl:v$', r'nmod:v:loc', edep['deprel'])

From f66340342ee7443e85956d35e4302164fa154c9b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Mar 2022 20:57:56 +0100
Subject: [PATCH 0531/1374] Minor fixes in Czech.

---
 udapi/block/ud/cs/fixedeprels.py | 73 ++++++++++++++++++++------------
 1 file changed, 47 insertions(+), 26 deletions(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index feed707d..871939a8 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -5,6 +5,27 @@
 
 class FixEdeprels(Block):
 
+    # Sometimes there are multiple layers of case marking and only the outermost
+    # layer should be reflected in the relation. For example, the semblative 'jako'
+    # is used with the same case (preposition + morphology) as the nominal that
+    # is being compared ('jako_v:loc' etc.) We do not want to multiply the relations
+    # by all the inner cases.
+    # The list in the value contains exceptions that should be left intact.
+    outermost = {
+        'ač':      [],
+        'ačkoli':  [], # 'ačkoliv' se převede na 'ačkoli' dole
+        'byť':     [],
+        'i_když':  [],
+        'jak':     [],
+        'jakkoli': [], # 'jakkoliv' se převede na 'jakkoli' dole
+        'jako':    [],
+        'jakoby':  [], # these instances in FicTree should be spelled 'jako by'
+        'než':     [],
+        'protože': [],
+        'takže':   [],
+        'třebaže': []
+    }
+
     # Secondary prepositions sometimes have the lemma of the original part of
     # speech. We want the grammaticalized form instead. List even those that
     # will have the same lexical form, as we also want to check the morphological
@@ -230,6 +251,21 @@ def process_node(self, node):
             if m:
                 bdeprel = m.group(1)
                 solved = False
+                # Removing 'až' must be done early. The remainder may be 'počátek'
+                # and we will want to convert it to 'počátkem:gen'.
+                edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
+                # If one of the following expressions occurs followed by another preposition
+                # or by morphological case, remove the additional case marking. For example,
+                # 'jako_v' becomes just 'jako'.
+                for x in self.outermost:
+                    exceptions = self.outermost[x]
+                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'([_:].+)?$', edep['deprel'])
+                    if m and m.group(2) and not x+m.group(2) in exceptions:
+                        edep['deprel'] = m.group(1)+':'+x
+                        solved = True
+                        break
+                if solved:
+                    break
                 for x in self.unambiguous:
                     # All secondary prepositions have only one fixed morphological case
                     # they appear with, so we can replace whatever case we encounter with the correct one.
@@ -238,18 +274,19 @@ def process_node(self, node):
                         edep['deprel'] = m.group(1)+':'+self.unambiguous[x]
                         solved = True
                         break
+                if solved:
+                    break
                 # The following prepositions have more than one morphological case
                 # available. Thanks to the Case feature on prepositions, we can
                 # identify the correct one.
-                if not solved:
-                    m = re.match(r'^(obl(?::arg)?|nmod):(mezi|na|nad|o|po|pod|před|v|za)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
-                    if m:
-                        # The following is only partial solution. We will not see
-                        # some children because they may be shared children of coordination.
-                        prepchildren = [x for x in node.children if x.lemma == m.group(2)]
-                        if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
-                            edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
-                            solved = True
+                m = re.match(r'^(obl(?::arg)?|nmod):(mezi|na|nad|o|po|pod|před|v|za)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
+                if m:
+                    # The following is only partial solution. We will not see
+                    # some children because they may be shared children of coordination.
+                    prepchildren = [x for x in node.children if x.lemma == m.group(2)]
+                    if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
+                        edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
+                        solved = True
             if re.match(r'^(acl|advcl):', edep['deprel']):
                 # We do not include 'i' in the list of redundant prefixes because we want to preserve 'i když' (but we want to discard the other combinations).
                 edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
@@ -261,7 +298,7 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^advcl:k:dat$', r'obl:k:dat', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):kdy$', r'\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:místo$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
-                edep['deprel'] = re.sub(r'^acl:na_způsob:gen$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
+                edep['deprel'] = re.sub(r'^acl:na_způsob(?::gen)?$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
                 edep['deprel'] = re.sub(r'^(advcl):neboť$', r'\1', edep['deprel']) # 'neboť' is coordinating
                 edep['deprel'] = re.sub(r'^(advcl):nechť$', r'\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^acl:od:gen$', r'nmod:od:gen', edep['deprel'])
@@ -427,26 +464,10 @@ def process_node(self, node):
                     # Instrumental would be possible but unlikely.
                     edep['deprel'] += ':acc'
                 else:
-                    # If one of the following expressions occurs followed by another preposition,
-                    # remove the additional preposition. For example, 'i_když_s' becomes just 'i_když'.
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ač([_:].+)?$', r'\1:ač', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ačkoliv?([_:].+)?$', r'\1:ačkoli', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):byť[_:].+$', r'\1:byť', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):i_když[_:].+$', r'\1:i_když', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jak[_:].+$', r'\1:jak', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakkoliv?[_:].+$', r'\1:jakkoli', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jako[_:].+$', r'\1:jako', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jakoby[_:].+$', r'\1:jako', edep['deprel']) # these instances in FicTree should be spelled 'jako by'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):než[_:].+$', r'\1:než', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):protože[_:].+$', r'\1:protože', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):takže[_:].+$', r'\1:takže', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):třebaže[_:].+$', r'\1:třebaže', edep['deprel'])
-                    #
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_?l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(jak_)?ad([_:].+)?$', r'\1', edep['deprel']) # ad infinitum
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):co(:nom)?$', r'advmod', edep['deprel'])
                     edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):de([_:].+)?$', r'\1', edep['deprel']) # de facto

From 5adadf475c66727f67b6bc866e7f9f18a8ef4984 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Mar 2022 21:41:29 +0100
Subject: [PATCH 0532/1374] Bug fix.

---
 udapi/block/ud/cs/fixedeprels.py | 5 ++---
 udapi/block/ud/ru/fixedeprels.py | 4 ++--
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 871939a8..019dd35b 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -265,7 +265,7 @@ def process_node(self, node):
                         solved = True
                         break
                 if solved:
-                    break
+                    continue
                 for x in self.unambiguous:
                     # All secondary prepositions have only one fixed morphological case
                     # they appear with, so we can replace whatever case we encounter with the correct one.
@@ -275,7 +275,7 @@ def process_node(self, node):
                         solved = True
                         break
                 if solved:
-                    break
+                    continue
                 # The following prepositions have more than one morphological case
                 # available. Thanks to the Case feature on prepositions, we can
                 # identify the correct one.
@@ -319,7 +319,6 @@ def process_node(self, node):
                     node.feats['Tense'] = ''
                     node.feats['VerbForm'] = ''
                     node.feats['Voice'] = ''
-                edep['deprel'] = re.sub(r'^advcl:(od|do)$', r'obl:\1:gen', edep['deprel'])
             elif re.match(r'^(nmod|obl):', edep['deprel']):
                 if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
                     # This is a same-case noun-noun modifier, which just happens to be in the locative.
diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 43ad5f3a..fba30571 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -66,7 +66,7 @@ def process_node(self, node):
                         solved = True
                         break
                 if solved:
-                    break
+                    continue
                 for x in self.unambiguous:
                     # All secondary prepositions have only one fixed morphological case
                     # they appear with, so we can replace whatever case we encounter with the correct one.
@@ -76,7 +76,7 @@ def process_node(self, node):
                         solved = True
                         break
                 if solved:
-                    break
+                    continue
                 # The following prepositions have more than one morphological case
                 # available. Thanks to the Case feature on prepositions, we can
                 # identify the correct one.

From 75d5ea22d23fdf2cadb16991a0b44ee83e5fddc3 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Mar 2022 22:03:40 +0100
Subject: [PATCH 0533/1374] advcl:k:dat

---
 udapi/block/ud/cs/fixedeprels.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 019dd35b..53337763 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -295,7 +295,7 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:do:gen$', r'obl:do:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
                 edep['deprel'] = re.sub(r'^(acl):k:dat$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:k:dat$', r'obl:k:dat', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:k(?::dat)?$', r'obl:k:dat', edep['deprel']) ###!!! Ale měli bychom opravit i závislost v základním stromu!
                 edep['deprel'] = re.sub(r'^(acl|advcl):kdy$', r'\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:místo$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
                 edep['deprel'] = re.sub(r'^acl:na_způsob(?::gen)?$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'

From fea338fec4872aa320dadb29313bb8d9392f6477 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Mar 2022 22:31:41 +0100
Subject: [PATCH 0534/1374] Another attempt to fix all Czech edeprels.

---
 udapi/block/ud/cs/fixedeprels.py | 28 ++++++++++++++++------------
 1 file changed, 16 insertions(+), 12 deletions(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 53337763..5be99867 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -251,6 +251,22 @@ def process_node(self, node):
             if m:
                 bdeprel = m.group(1)
                 solved = False
+                # Issues caused by errors in the original annotation must be fixed early.
+                # Especially if acl|advcl occurs with a preposition that unambiguously
+                # receives a morphological case in the subsequent steps, and then gets
+                # flagged as solved.
+                edep['deprel'] = re.sub(r'^advcl:do(?::gen)?$', r'obl:do:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
+                edep['deprel'] = re.sub(r'^acl:k(?::dat)?$', r'acl', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:k(?::dat)?$', r'obl:k:dat', edep['deprel']) ###!!! Ale měli bychom opravit i závislost v základním stromu!
+                edep['deprel'] = re.sub(r'^advcl:místo(?::gen)?$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
+                edep['deprel'] = re.sub(r'^acl:na_způsob(?::gen)?$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
+                edep['deprel'] = re.sub(r'^acl:od(?::gen)?$', r'nmod:od:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:od(?::gen)?$', r'obl:od:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
+                edep['deprel'] = re.sub(r'^advcl:podle(?::gen)?$', r'obl:podle:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:pro(?::acc)?$', r'obl:pro:acc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^acl:v$', r'nmod:v:loc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:v_duchu(?::gen)?$', r'obl:v_duchu:gen', edep['deprel'])
                 # Removing 'až' must be done early. The remainder may be 'počátek'
                 # and we will want to convert it to 'počátkem:gen'.
                 edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
@@ -293,21 +309,9 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:do:gen$', r'obl:do:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
-                edep['deprel'] = re.sub(r'^(acl):k:dat$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:k(?::dat)?$', r'obl:k:dat', edep['deprel']) ###!!! Ale měli bychom opravit i závislost v základním stromu!
                 edep['deprel'] = re.sub(r'^(acl|advcl):kdy$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:místo$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
-                edep['deprel'] = re.sub(r'^acl:na_způsob(?::gen)?$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
                 edep['deprel'] = re.sub(r'^(advcl):neboť$', r'\1', edep['deprel']) # 'neboť' is coordinating
                 edep['deprel'] = re.sub(r'^(advcl):nechť$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^acl:od:gen$', r'nmod:od:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:od:gen$', r'obl:od:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
-                edep['deprel'] = re.sub(r'^advcl:podle:gen$', r'obl:podle:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:pro:acc$', r'obl:pro:acc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^acl:v$', r'nmod:v:loc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:v_duchu:gen$', r'obl:v_duchu:gen', edep['deprel'])
                 if edep['deprel'] == 'acl:v' and node.form == 'patře':
                     edep['deprel'] = 'nmod:v:loc'
                     node.deprel = 'nmod'

From f2c64f8083dc278ba338115625d6d422a954f1e8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Mar 2022 23:18:35 +0100
Subject: [PATCH 0535/1374] =?UTF-8?q?59=20obl:=D0=B2=5F=D1=81=D0=BE=D0=BE?=
 =?UTF-8?q?=D1=82=D0=B2=D0=B5=D1=82=D1=81=D1=82=D0=B2=D0=B8=D0=B5=5F=D1=81?=
 =?UTF-8?q?:ins=20=20=20=20=20=2058=20obl:=D1=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ru/fixedeprels.py | 46 +++++++++++++++++++++-----------
 1 file changed, 31 insertions(+), 15 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index fba30571..91046131 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -30,6 +30,7 @@ class FixEdeprels(Block):
         'в_качество':       'в_качестве:gen',
         'в_отношение':      'в_отношении:gen',
         'в_связь_с':        'в_связи_с:ins',
+        'в_соответствие_с': 'в_соответствии_с:ins',
         'в_течение':        'в_течение:gen',
         'в_ход':            'в_ходе:gen',
         'до':               'до:gen',
@@ -44,6 +45,19 @@ class FixEdeprels(Block):
         'спустя':           'спустя:acc'
     }
 
+    def copy_case_from_adposition(self, node, adposition):
+        """
+        In some treebanks, adpositions have the Case feature and it denotes the
+        valency case that the preposition's nominal must be in.
+        """
+        # The following is only partial solution. We will not see
+        # some children because they may be shared children of coordination.
+        prepchildren = [x for x in node.children if x.lemma == adposition]
+        if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
+            return adposition+':'+prepchildren[0].feats['Case'].lower()
+        else:
+            return None
+
     def process_node(self, node):
         """
         Occasionally the edeprels automatically derived from the Russian basic
@@ -85,29 +99,31 @@ def process_node(self, node):
                 # and the whole phrase should not be analyzed as genitive.
                 m = re.match(r'^(obl(?::arg)?|nmod):(в|на)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
                 if m:
-                    # The following is only partial solution. We will not see
-                    # some children because they may be shared children of coordination.
-                    prepchildren = [x for x in node.children if x.lemma == m.group(2)]
-                    if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
-                        edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
-                        solved = True
+                    adpcase = copy_case_from_adposition(self, node, m.group(2))
+                    if adpcase:
+                        edep['deprel'] = m.group(1)+':'+adpcase
                     else:
                         # Accusative or locative are possible. Pick locative.
                         edep['deprel'] = m.group(1)+':'+m.group(2)+':loc'
-                # Both "за" and "" also occur with instrumental. However, this
-                # is only because there are numerals in the phrase ("за последние 20 лет")
-                # and the whole phrase should be usually analyzed as accusative.
+                    continue
                 m = re.match(r'^(obl(?::arg)?|nmod):(за)(?::(?:nom|gen|dat|voc|loc))?$', edep['deprel'])
                 if m:
-                    # The following is only partial solution. We will not see
-                    # some children because they may be shared children of coordination.
-                    prepchildren = [x for x in node.children if x.lemma == m.group(2)]
-                    if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
-                        edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
-                        solved = True
+                    adpcase = copy_case_from_adposition(self, node, m.group(2))
+                    if adpcase:
+                        edep['deprel'] = m.group(1)+':'+adpcase
                     else:
                         # Accusative or instrumental are possible. Pick accusative.
                         edep['deprel'] = m.group(1)+':'+m.group(2)+':acc'
+                    continue
+                m = re.match(r'^(obl(?::arg)?|nmod):(с)(?::(?:nom|dat|acc|voc|loc))?$', edep['deprel'])
+                if m:
+                    adpcase = copy_case_from_adposition(self, node, m.group(2))
+                    if adpcase:
+                        edep['deprel'] = m.group(1)+':'+adpcase
+                    else:
+                        # Genitive or instrumental are possible. Pick instrumental.
+                        edep['deprel'] = m.group(1)+':'+m.group(2)+':acc'
+                    continue
             if re.match(r'^(nmod|obl):', edep['deprel']):
                 if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
                     # This is a same-case noun-noun modifier, which just happens to be in the locative.

From 8a998468cf7524e267d95b5e987a06477bc14436 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Mar 2022 23:21:28 +0100
Subject: [PATCH 0536/1374] Bug fix.

---
 udapi/block/ud/ru/fixedeprels.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 91046131..96831746 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -99,7 +99,7 @@ def process_node(self, node):
                 # and the whole phrase should not be analyzed as genitive.
                 m = re.match(r'^(obl(?::arg)?|nmod):(в|на)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
                 if m:
-                    adpcase = copy_case_from_adposition(self, node, m.group(2))
+                    adpcase = self.copy_case_from_adposition(node, m.group(2))
                     if adpcase:
                         edep['deprel'] = m.group(1)+':'+adpcase
                     else:
@@ -108,7 +108,7 @@ def process_node(self, node):
                     continue
                 m = re.match(r'^(obl(?::arg)?|nmod):(за)(?::(?:nom|gen|dat|voc|loc))?$', edep['deprel'])
                 if m:
-                    adpcase = copy_case_from_adposition(self, node, m.group(2))
+                    adpcase = self.copy_case_from_adposition(node, m.group(2))
                     if adpcase:
                         edep['deprel'] = m.group(1)+':'+adpcase
                     else:
@@ -117,7 +117,7 @@ def process_node(self, node):
                     continue
                 m = re.match(r'^(obl(?::arg)?|nmod):(с)(?::(?:nom|dat|acc|voc|loc))?$', edep['deprel'])
                 if m:
-                    adpcase = copy_case_from_adposition(self, node, m.group(2))
+                    adpcase = self.copy_case_from_adposition(node, m.group(2))
                     if adpcase:
                         edep['deprel'] = m.group(1)+':'+adpcase
                     else:

From 1131de3720d176eac151afd4139ae822088542f7 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 26 Mar 2022 10:46:02 +0100
Subject: [PATCH 0537/1374] Bug fix.

---
 udapi/block/ud/cs/fixedeprels.py | 31 +++++++++++++++++++++----------
 1 file changed, 21 insertions(+), 10 deletions(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 5be99867..57e2bfb0 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -19,7 +19,7 @@ class FixEdeprels(Block):
         'jak':     [],
         'jakkoli': [], # 'jakkoliv' se převede na 'jakkoli' dole
         'jako':    [],
-        'jakoby':  [], # these instances in FicTree should be spelled 'jako by'
+        'jakoby':  ['jakoby_pod'], # these instances in FicTree should be spelled 'jako by'
         'než':     [],
         'protože': [],
         'takže':   [],
@@ -33,7 +33,7 @@ class FixEdeprels(Block):
     # case, even if they are not secondary.
     unambiguous = {
         'abi':              'aby',
-        'aby_na':           'na',
+        'aby_na':           'na:loc',
         'ačkoliv':          'ačkoli',
         'ať':               'ať', # remove morphological case
         'ať_forma':         'formou:gen',
@@ -240,6 +240,19 @@ class FixEdeprels(Block):
         'že_za':            'za:gen'
     }
 
+    def copy_case_from_adposition(self, node, adposition):
+        """
+        In some treebanks, adpositions have the Case feature and it denotes the
+        valency case that the preposition's nominal must be in.
+        """
+        # The following is only partial solution. We will not see
+        # some children because they may be shared children of coordination.
+        prepchildren = [x for x in node.children if x.lemma == adposition]
+        if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
+            return adposition+':'+prepchildren[0].feats['Case'].lower()
+        else:
+            return None
+
     def process_node(self, node):
         """
         Occasionally the edeprels automatically derived from the Czech basic
@@ -266,7 +279,7 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^advcl:pro(?::acc)?$', r'obl:pro:acc', edep['deprel'])
                 edep['deprel'] = re.sub(r'^acl:v$', r'nmod:v:loc', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:v_duchu(?::gen)?$', r'obl:v_duchu:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:v_duchu?(?::gen)?$', r'obl:v_duchu:gen', edep['deprel'])
                 # Removing 'až' must be done early. The remainder may be 'počátek'
                 # and we will want to convert it to 'počátkem:gen'.
                 edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
@@ -297,12 +310,10 @@ def process_node(self, node):
                 # identify the correct one.
                 m = re.match(r'^(obl(?::arg)?|nmod):(mezi|na|nad|o|po|pod|před|v|za)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
                 if m:
-                    # The following is only partial solution. We will not see
-                    # some children because they may be shared children of coordination.
-                    prepchildren = [x for x in node.children if x.lemma == m.group(2)]
-                    if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
-                        edep['deprel'] = m.group(1)+':'+m.group(2)+':'+prepchildren[0].feats['Case'].lower()
-                        solved = True
+                    adpcase = self.copy_case_from_adposition(node, m.group(2))
+                    if adpcase:
+                        edep['deprel'] = m.group(1)+':'+adpcase
+                        continue
             if re.match(r'^(acl|advcl):', edep['deprel']):
                 # We do not include 'i' in the list of redundant prefixes because we want to preserve 'i když' (but we want to discard the other combinations).
                 edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
@@ -323,7 +334,7 @@ def process_node(self, node):
                     node.feats['Tense'] = ''
                     node.feats['VerbForm'] = ''
                     node.feats['Voice'] = ''
-            elif re.match(r'^(nmod|obl):', edep['deprel']):
+            elif re.match(r'^(nmod|obl(:arg)?):', edep['deprel']):
                 if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
                     # This is a same-case noun-noun modifier, which just happens to be in the locative.
                     # For example, 'v Ostravě-Porubě', 'Porubě' is attached to 'Ostravě', 'Ostravě' has

From 8d4a6e8800dc593a0d30558f794f650ff88b84e8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 26 Mar 2022 11:46:58 +0100
Subject: [PATCH 0538/1374] More fixes to edeprels.

---
 udapi/block/ud/cs/fixedeprels.py | 2 +-
 udapi/block/ud/ru/fixedeprels.py | 6 ++++++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 57e2bfb0..7a49bb87 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -19,7 +19,7 @@ class FixEdeprels(Block):
         'jak':     [],
         'jakkoli': [], # 'jakkoliv' se převede na 'jakkoli' dole
         'jako':    [],
-        'jakoby':  ['jakoby_pod'], # these instances in FicTree should be spelled 'jako by'
+        'jakoby':  ['jakoby_pod:ins'], # these instances in FicTree should be spelled 'jako by'
         'než':     [],
         'protože': [],
         'takže':   [],
diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 96831746..a5560121 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -15,6 +15,7 @@ class FixEdeprels(Block):
         'будто':   [],
         'ведь':    [],
         'как':     ['как_только'],
+        'раз':     [],
         'словно':  [],
         'так_что': [],
         'чем':     []
@@ -33,10 +34,15 @@ class FixEdeprels(Block):
         'в_соответствие_с': 'в_соответствии_с:ins',
         'в_течение':        'в_течение:gen',
         'в_ход':            'в_ходе:gen',
+        'возле':            'возле:gen',
         'до':               'до:gen',
         'к':                'к:dat',
         'несмотря_на':      'несмотря_на:acc',
+        'относительно':     'относительно:gen',
+        'по_мера':          'по_мере:gen',
+        'по_отношение_ко?': 'по_отношению_к:dat',
         'по_повод':         'по_поводу:gen',
+        'по_сравнение_с':   'по_сравнению_с:ins',
         'помимо':           'помимо:gen',
         'при_помощь':       'при_помощи:gen',
         'с_помощь':         'с_помощью:gen',

From dffc958c983bd1563ce421822a6f900511aed7b9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 27 Mar 2022 18:40:36 +0200
Subject: [PATCH 0539/1374] Fix edeprels.

---
 udapi/block/ud/cs/fixedeprels.py | 2 +-
 udapi/block/ud/ru/fixedeprels.py | 6 +++++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 7a49bb87..6f0258ed 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -20,7 +20,7 @@ class FixEdeprels(Block):
         'jakkoli': [], # 'jakkoliv' se převede na 'jakkoli' dole
         'jako':    [],
         'jakoby':  ['jakoby_pod:ins'], # these instances in FicTree should be spelled 'jako by'
-        'než':     [],
+        'než':     ['než_aby'],
         'protože': [],
         'takže':   [],
         'třebaže': []
diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index a5560121..79669d63 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -14,7 +14,9 @@ class FixEdeprels(Block):
     outermost = {
         'будто':   [],
         'ведь':    [],
+        'если':    [],
         'как':     ['как_только'],
+        'нежели':  [],
         'раз':     [],
         'словно':  [],
         'так_что': [],
@@ -35,6 +37,7 @@ class FixEdeprels(Block):
         'в_течение':        'в_течение:gen',
         'в_ход':            'в_ходе:gen',
         'возле':            'возле:gen',
+        'вплоть_до':        'вплоть_до:gen',
         'до':               'до:gen',
         'к':                'к:dat',
         'несмотря_на':      'несмотря_на:acc',
@@ -48,7 +51,8 @@ class FixEdeprels(Block):
         'с_помощь':         'с_помощью:gen',
         'со_сторона':       'со_стороны:gen',
         'согласно':         'согласно:dat',
-        'спустя':           'спустя:acc'
+        'спустя':           'спустя:acc',
+        'через':            'через:acc'
     }
 
     def copy_case_from_adposition(self, node, adposition):

From 283fd9e7d0ef98f68626ca59b0a36e185539fca4 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 4 Apr 2022 14:53:40 +0200
Subject: [PATCH 0540/1374] Czech o:gen is wrong.

---
 udapi/block/ud/cs/fixedeprels.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 6f0258ed..a7158d6b 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -312,6 +312,9 @@ def process_node(self, node):
                 if m:
                     adpcase = self.copy_case_from_adposition(node, m.group(2))
                     if adpcase:
+                        ###!!! CAC contains 'o' with genitive, which is wrong!
+                        if m.group(1) == 'o' and adpcase == 'gen':
+                            adpcase = 'acc'
                         edep['deprel'] = m.group(1)+':'+adpcase
                         continue
             if re.match(r'^(acl|advcl):', edep['deprel']):

From f1a1d537e8637a51dc00a6d06e01cccf6898556b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 4 Apr 2022 15:24:37 +0200
Subject: [PATCH 0541/1374] Bug fix.

---
 udapi/block/ud/cs/fixedeprels.py | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index a7158d6b..f2f76b4b 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -311,10 +311,7 @@ def process_node(self, node):
                 m = re.match(r'^(obl(?::arg)?|nmod):(mezi|na|nad|o|po|pod|před|v|za)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
                 if m:
                     adpcase = self.copy_case_from_adposition(node, m.group(2))
-                    if adpcase:
-                        ###!!! CAC contains 'o' with genitive, which is wrong!
-                        if m.group(1) == 'o' and adpcase == 'gen':
-                            adpcase = 'acc'
+                    if adpcase and not re.search(r':(nom|gen|dat|voc)$', adpcase):
                         edep['deprel'] = m.group(1)+':'+adpcase
                         continue
             if re.match(r'^(acl|advcl):', edep['deprel']):

From 702e9b138de59d3d8cc7267d205361cad5b34d65 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 6 Apr 2022 05:27:31 +0200
Subject: [PATCH 0542/1374] Rename cluster to entity (#104)

* `CorefCluster` -> `CorefEntity`
* `mention.cluster` -> `mention.entity`
* `cluster.cluster_id` -> `entity.eid`
* `cluster.cluster_type` -> `entity.etype`
* `for cluster in doc.coref_clusters.values():` -> `for entity in doc.coref_entities:`
* `for cluster_id, cluster in data.coref_clusters.items():` -> `for eid, entity in doc.eid_to_entity:`
* `doc.coref_clusters` kept, but deprecated
* rename also clusters/cluster -> entities/entity almost everywhere else (variable and parameter names, comments,...)
* new udapi.core.block methods `process_coref_mention` and `process_coref_entity`
---
 udapi/block/corefud/fixcorefud02.py           |  18 +-
 udapi/block/corefud/fixinterleaved.py         |  10 +-
 udapi/block/corefud/gum2corefud.py            |  38 +--
 udapi/block/corefud/indexclusters.py          |  21 +-
 udapi/block/corefud/load.py                   |   2 +-
 udapi/block/corefud/markcrossing.py           |   6 +-
 udapi/block/corefud/markinterleaved.py        |  10 +-
 udapi/block/corefud/marknested.py             |  10 +-
 udapi/block/corefud/marksamesubspan.py        |  10 +-
 udapi/block/corefud/mergesamespan.py          |  32 +--
 udapi/block/corefud/movehead.py               |  26 +-
 .../{printclusters.py => printentities.py}    |  26 +-
 udapi/block/corefud/printmentions.py          |   8 +-
 udapi/block/corefud/stats.py                  |  32 +--
 udapi/block/read/oldcorefud.py                |  78 +++---
 udapi/block/util/eval.py                      |  16 +-
 udapi/block/write/oldcorefud.py               |  36 +--
 udapi/core/block.py                           |  60 ++++-
 udapi/core/coref.py                           | 248 +++++++++---------
 udapi/core/document.py                        |  52 ++--
 udapi/core/node.py                            |  12 +-
 udapi/core/tests/test_coref.py                |  10 +-
 22 files changed, 413 insertions(+), 348 deletions(-)
 rename udapi/block/corefud/{printclusters.py => printentities.py} (69%)

diff --git a/udapi/block/corefud/fixcorefud02.py b/udapi/block/corefud/fixcorefud02.py
index b8fe44f7..1575cea6 100644
--- a/udapi/block/corefud/fixcorefud02.py
+++ b/udapi/block/corefud/fixcorefud02.py
@@ -20,32 +20,32 @@ def process_document(self, doc):
         if doc.meta['global.Entity'] == 'entity-GRP-infstat-MIN-coref_type-identity':
             doc.meta['global.Entity'] = 'eid-etype-head-other-infstat-minspan-identity'
 
-        for cluster in doc.coref_clusters.values():
-            if cluster.cluster_type:
+        for entity in doc.coref_entities:
+            if entity.etype:
                 # Harmonize etype.
                 # If gen/spec is distinguished, store it in all mentions' other['gstype'].
-                etype = cluster.cluster_type.lower()
+                etype = entity.etype.lower()
                 if etype.startswith('spec') or etype.startswith('gen'):
                     gstype = 'gen' if etype.startswith('gen') else 'spec'
-                    for m in cluster.mentions:
+                    for m in entity.mentions:
                         m.other['gstype'] = gstype
                     if etype == 'spec':
                         etype = 'other'
                     etype = etype.replace('gen', '').replace('spec', '').replace('.', '')
                 etype = NEW_ETYPE.get(etype, etype)
                 
-                # cluster_type="APPOS" is used only in NONPUBL-CorefUD_English-OntoNotes.
-                # Apposition is a mention-based rather than cluster-based attribute.
+                # etype="APPOS" is used only in NONPUBL-CorefUD_English-OntoNotes.
+                # Apposition is a mention-based rather than entity-based attribute.
                 # We don't know which of the mentions it should be assigned, but let's expect all non-first.
                 # UD marks appositions with deprel appos, so once someone checks it is really redunant,
                 # TODO we can delete the appos mention attribute.
                 if etype == 'appos':
                     etype = ''
-                    for mention in cluster.mentions[1:]:
+                    for mention in entity.mentions[1:]:
                         mention.other['appos'] = '1'
-                cluster.cluster_type = etype
+                entity.etype = etype
 
-            for mention in cluster.mentions:
+            for mention in entity.mentions:
                 # Harmonize bridge relation labels
                 for bridge in mention.bridging:
                     rel = bridge.relation.lower()
diff --git a/udapi/block/corefud/fixinterleaved.py b/udapi/block/corefud/fixinterleaved.py
index 6921c680..c5a1b3ed 100644
--- a/udapi/block/corefud/fixinterleaved.py
+++ b/udapi/block/corefud/fixinterleaved.py
@@ -5,10 +5,10 @@
 class FixInterleaved(Block):
     """Fix mentions with interleaved or crossing spans."""
 
-    def __init__(self, same_cluster_only=True, both_discontinuous=False,
+    def __init__(self, same_entity_only=True, both_discontinuous=False,
                  crossing_only=False, nested_same_subspan=True, **kwargs):
         super().__init__(**kwargs)
-        self.same_cluster_only = same_cluster_only
+        self.same_entity_only = same_entity_only
         self.both_discontinuous = both_discontinuous
         self.crossing_only = crossing_only
         self.nested_same_subspan = nested_same_subspan
@@ -22,7 +22,7 @@ def process_tree(self, tree):
         for mA, mB in itertools.combinations(mentions, 2):
             if mA in deleted or mB in deleted:
                 continue
-            if self.same_cluster_only and mA.cluster != mB.cluster:
+            if self.same_entity_only and mA.entity != mB.entity:
                 continue
 
             # Fully nested spans are OK, expect for same-subspan
@@ -53,7 +53,7 @@ def process_tree(self, tree):
                 except ValueError:
                     pass
             try:
-                mB.cluster.mentions.remove(mB)
+                mB.entity.mentions.remove(mB)
             except ValueError:
                 pass
             deleted.add(mB)
@@ -75,7 +75,7 @@ def process_tree(self, tree):
                     except ValueError:
                         pass
                 try:
-                    mA.cluster.mentions.remove(mA)
+                    mA.entity.mentions.remove(mA)
                 except ValueError:
                     pass
                 break
diff --git a/udapi/block/corefud/gum2corefud.py b/udapi/block/corefud/gum2corefud.py
index bcd24968..bf6d798d 100644
--- a/udapi/block/corefud/gum2corefud.py
+++ b/udapi/block/corefud/gum2corefud.py
@@ -8,7 +8,7 @@ class Gum2CorefUD(Block):
     def process_tree(self, tree):
         docname = tree.bundle.document.meta['docname'] + '_'
 
-        clusters = tree.bundle.document.coref_clusters
+        eid_to_entity = tree.bundle.document._eid_to_entity
         unfinished_mentions = defaultdict(list)
         for node in tree.descendants:
             misc_entity = node.misc['Entity']
@@ -47,15 +47,15 @@ def process_tree(self, tree):
                     else:
                         raise ValueError(f"Less than 5 attributes in {entity} at {node}")
                     name = docname + grp
-                    cluster = clusters.get(name)
-                    if cluster is None:
-                        cluster = node.create_coref_cluster(cluster_id=name, cluster_type=etype)
-                        mention = cluster.mentions[0]
+                    entity = eid_to_entity.get(name)
+                    if entity is None:
+                        entity = node.create_coref_entity(eid=name, etype=etype)
+                        mention = entity.mentions[0]
                         mention.misc = f"Infstat:{infstat},MinSpan:{minspan},CorefType:{ctype}"
                         if wiki:
                             mention.misc += ',Wikification:' + wiki  #.replace(',', '%2C')
                     else:
-                        mention = cluster.create_mention(head=node)
+                        mention = entity.create_mention(head=node)
                     if closing:
                         mention.words = [node]
                     else:
@@ -71,23 +71,23 @@ def process_tree(self, tree):
                     except ValueError as err:
                         raise ValueError(f"{node}: {misc_bridge} {err}")
                     try:
-                        trg_cluster = clusters[trg_str]
-                        src_cluster = clusters[src_str]
+                        trg_entity = eid_to_entity[trg_str]
+                        src_entity = eid_to_entity[src_str]
                     except KeyError as err:
-                        logging.warning(f"{node}: Cannot find cluster {err}")
+                        logging.warning(f"{node}: Cannot find entity {err}")
                     else:
-                        mention = src_cluster.mentions[-1]
+                        mention = src_entity.mentions[-1]
                         # TODO: what relation should we choose for Bridging?
                         # relation = f"{src_str.split('-')[0]}-{trg_str.split('-')[0]}"
                         relation = '_'
-                        mention.bridging.append((trg_cluster, relation))
+                        mention.bridging.append((trg_entity, relation))
                 del node.misc['Bridge']
 
             misc_split = node.misc['Split']
             if misc_split:
                 # E.g. Entity=(person-54)|Split=4<54,9<54
                 src_str = docname + misc_split.split('<')[-1]
-                ante_clusters = []
+                ante_entities = []
                 for x in misc_split.split(','):
                     ante_str, this_str = [docname + grp for grp in x.split('<')]
                     if this_str != src_str:
@@ -96,16 +96,16 @@ def process_tree(self, tree):
                         # There are just three such cases in GUM and all are bugs,
                         # so let's ignore them entirely (the `else` clause will be skipped if exiting `for` w/ `break`).
                         # break
-                    ante_clusters.append(clusters[ante_str])
+                    ante_entities.append(eid_to_entity[ante_str])
                 else:
-                    clusters[src_str].split_ante = ante_clusters
+                    eid_to_entity[src_str].split_ante = ante_entities
                 del node.misc['Split']
 
-        for cluster_name, mentions in unfinished_mentions.items():
+        for entity_name, mentions in unfinished_mentions.items():
             for mention in mentions:
                 logging.warning(f"Mention {name} opened at {mention.head}, but not closed in the same tree. Deleting.")
-                cluster = mention.cluster
+                entity = mention.entity
                 mention.words = []
-                cluster._mentions.remove(mention)
-                if not cluster._mentions:
-                    del clusters[name]
+                entity._mentions.remove(mention)
+                if not entity._mentions:
+                    del eid_to_entity[name]
diff --git a/udapi/block/corefud/indexclusters.py b/udapi/block/corefud/indexclusters.py
index 14cf778d..3f5d74d8 100644
--- a/udapi/block/corefud/indexclusters.py
+++ b/udapi/block/corefud/indexclusters.py
@@ -3,10 +3,10 @@
 
 
 class IndexClusters(Block):
-    """Re-index the coreference cluster IDs. The final cluster IDs are of the "e<ID>" form,
+    """Re-index the coreference entity IDs (eid). The final entity IDs are of the "e<ID>" form,
        where <ID> are ordinal numbers starting from the one specified by the `start` parameter.
        This block can be applied on multiple documents within one udapy call.
-       For example, to re-index ClusterId in all conllu files in the current directory
+       For example, to re-index eid in all conllu files in the current directory
        (keeping the IDs unique across all the files), use:
        `udapy read.Conllu files='!*.conllu' corefud.IndexClusters write.Conllu overwrite=1`
 
@@ -23,14 +23,13 @@ def __init__(self, start=1, prefix='e'):
         self.prefix = prefix
 
     def process_document(self, doc):
-        clusters = doc.coref_clusters
-        if not clusters:
+        entities = doc.coref_entities
+        if not entities:
             return
-        new_clusters = {}
-        for idx, cid in enumerate(clusters, self.start):
-            cluster = clusters[cid]
-            new_cid = self.prefix + str(idx)
-            cluster.cluster_id = new_cid
-            new_clusters[new_cid] = cluster
+        new_eid_to_entity = {}
+        for idx, entity in enumerate(entities, self.start):
+            new_eid = self.prefix + str(idx)
+            entity.eid = new_eid
+            new_eid_to_entity[new_eid] = entity
         self.start = idx + 1
-        doc._coref_clusters = new_clusters
+        doc._eid_to_entity = new_eid_to_entity
diff --git a/udapi/block/corefud/load.py b/udapi/block/corefud/load.py
index 3b2534bc..92773dc2 100644
--- a/udapi/block/corefud/load.py
+++ b/udapi/block/corefud/load.py
@@ -8,5 +8,5 @@ def __init__(self, strict=True):
         self.strict = strict
 
     def process_document(self, doc):
-        if doc._coref_clusters is None:
+        if doc._eid_to_entity is None:
             udapi.core.coref.load_coref_from_misc(doc, self.strict)
diff --git a/udapi/block/corefud/markcrossing.py b/udapi/block/corefud/markcrossing.py
index a6d9346a..8064e67f 100644
--- a/udapi/block/corefud/markcrossing.py
+++ b/udapi/block/corefud/markcrossing.py
@@ -6,10 +6,10 @@
 class MarkCrossing(Block):
     """Find mentions with crossing spans."""
 
-    def __init__(self, same_cluster_only=False, continuous_only=False, print_form=False,
+    def __init__(self, same_entity_only=False, continuous_only=False, print_form=False,
                  log=True, mark=True, **kwargs):
         super().__init__(**kwargs)
-        self.same_cluster_only = same_cluster_only
+        self.same_entity_only = same_entity_only
         self.continuous_only = continuous_only
         self.print_form = print_form
         self.log = log
@@ -26,7 +26,7 @@ def process_node(self, node):
         if len(node.coref_mentions) > 1:
             for mA, mB in itertools.combinations(node.coref_mentions, 2):
                 if not (set(mA.words) <= set(mB.words)) and not (set(mB.words) <= set(mA.words)):
-                    if self.same_cluster_only and mA.cluster != mB.cluster:
+                    if self.same_entity_only and mA.entity != mB.entity:
                         continue
                     if self.continuous_only and (',' in mA.span or ',' in mB.span):
                         continue
diff --git a/udapi/block/corefud/markinterleaved.py b/udapi/block/corefud/markinterleaved.py
index ac4d9438..c00f73b1 100644
--- a/udapi/block/corefud/markinterleaved.py
+++ b/udapi/block/corefud/markinterleaved.py
@@ -5,10 +5,10 @@
 class MarkInterleaved(Block):
     """Find mentions with interleaved spans."""
 
-    def __init__(self, same_cluster_only=False, both_discontinuous=False, print_form=False,
+    def __init__(self, same_entity_only=False, both_discontinuous=False, print_form=False,
                  log=True, mark=True, **kwargs):
         super().__init__(**kwargs)
-        self.same_cluster_only = same_cluster_only
+        self.same_entity_only = same_entity_only
         self.both_discontinuous = both_discontinuous
         self.print_form = print_form
         self.log = log
@@ -16,9 +16,9 @@ def __init__(self, same_cluster_only=False, both_discontinuous=False, print_form
 
     def _print(self, mention):
         if self.print_form:
-            return mention.cluster.cluster_id + ':' + ' '.join([w.form for w in mention.words])
+            return mention.entity.eid + ':' + ' '.join([w.form for w in mention.words])
         else:
-            return mention.cluster.cluster_id + ':' + mention.span
+            return mention.entity.eid + ':' + mention.span
 
     def process_tree(self, tree):
         mentions = set()
@@ -33,7 +33,7 @@ def process_tree(self, tree):
                     continue
                 if mB.words[0] < mA.words[0] and mB.words[-1] < mA.words[0]:
                     continue
-                if self.same_cluster_only and mA.cluster != mB.cluster:
+                if self.same_entity_only and mA.entity != mB.entity:
                     continue
                 if self.both_discontinuous and (',' not in mA.span or ',' not in mB.span):
                     continue
diff --git a/udapi/block/corefud/marknested.py b/udapi/block/corefud/marknested.py
index 656111c6..8db8a657 100644
--- a/udapi/block/corefud/marknested.py
+++ b/udapi/block/corefud/marknested.py
@@ -5,10 +5,10 @@
 class MarkNested(Block):
     """Find nested mentions."""
 
-    def __init__(self, same_cluster_only=True, both_discontinuous=False, multiword_only=False,
+    def __init__(self, same_entity_only=True, both_discontinuous=False, multiword_only=False,
                  print_form=False, log=True, mark=True, **kwargs):
         super().__init__(**kwargs)
-        self.same_cluster_only = same_cluster_only
+        self.same_entity_only = same_entity_only
         self.both_discontinuous = both_discontinuous
         self.multiword_only = multiword_only
         self.print_form = print_form
@@ -17,9 +17,9 @@ def __init__(self, same_cluster_only=True, both_discontinuous=False, multiword_o
 
     def _print(self, mention):
         if self.print_form:
-            return mention.cluster.cluster_id + ':' + ' '.join([w.form for w in mention.words])
+            return mention.entity.eid + ':' + ' '.join([w.form for w in mention.words])
         else:
-            return mention.cluster.cluster_id + ':' + mention.span
+            return mention.entity.eid + ':' + mention.span
 
     def process_tree(self, tree):
         mentions = set()
@@ -27,7 +27,7 @@ def process_tree(self, tree):
             for m in node.coref_mentions:
                 mentions.add(m)
         for mA, mB in itertools.combinations(mentions, 2):
-            if self.same_cluster_only and mA.cluster != mB.cluster:
+            if self.same_entity_only and mA.entity != mB.entity:
                 continue
             if self.both_discontinuous and (',' not in mA.span or ',' not in mB.span):
                 continue
diff --git a/udapi/block/corefud/marksamesubspan.py b/udapi/block/corefud/marksamesubspan.py
index f99e0e13..f3cfd7b3 100644
--- a/udapi/block/corefud/marksamesubspan.py
+++ b/udapi/block/corefud/marksamesubspan.py
@@ -5,10 +5,10 @@
 class MarkSameSubSpan(Block):
     """Find mentions with the same subspan."""
 
-    def __init__(self, same_cluster_only=False, both_discontinuous=False, print_form=False, nested_only=False,
+    def __init__(self, same_entity_only=False, both_discontinuous=False, print_form=False, nested_only=False,
                  log=True, mark=True, **kwargs):
         super().__init__(**kwargs)
-        self.same_cluster_only = same_cluster_only
+        self.same_entity_only = same_entity_only
         self.both_discontinuous = both_discontinuous
         self.nested_only = nested_only
         self.print_form = print_form
@@ -17,9 +17,9 @@ def __init__(self, same_cluster_only=False, both_discontinuous=False, print_form
 
     def _print(self, mention):
         if self.print_form:
-            return mention.cluster.cluster_id + ':' + ' '.join([w.form for w in mention.words])
+            return mention.entity.eid + ':' + ' '.join([w.form for w in mention.words])
         else:
-            return mention.cluster.cluster_id + ':' + mention.span
+            return mention.entity.eid + ':' + mention.span
 
     def process_tree(self, tree):
         mentions = set()
@@ -28,7 +28,7 @@ def process_tree(self, tree):
                 mentions.add(m)
         if len(mentions) > 1:
             for mA, mB in itertools.combinations(mentions, 2):
-                if self.same_cluster_only and mA.cluster != mB.cluster:
+                if self.same_entity_only and mA.entity != mB.entity:
                     continue
                 if self.both_discontinuous and (',' not in mA.span or ',' not in mB.span):
                     continue
diff --git a/udapi/block/corefud/mergesamespan.py b/udapi/block/corefud/mergesamespan.py
index bdeefd7c..61b613cb 100644
--- a/udapi/block/corefud/mergesamespan.py
+++ b/udapi/block/corefud/mergesamespan.py
@@ -11,9 +11,9 @@ class MergeSameSpan(Block):
     CorefUD data, so this block processes one sentence at a time.
     """
 
-    def __init__(self, same_cluster_only=False, **kwargs):
+    def __init__(self, same_entity_only=False, **kwargs):
         super().__init__(**kwargs)
-        self.same_cluster_only = same_cluster_only
+        self.same_entity_only = same_entity_only
 
     def process_tree(self, tree):
         mentions = set()
@@ -22,31 +22,31 @@ def process_tree(self, tree):
                 mentions.add(m)
 
         for mA, mB in itertools.combinations(mentions, 2):
-            if self.same_cluster_only and mA.cluster != mB.cluster:
+            if self.same_entity_only and mA.entity != mB.entity:
                 continue
             # Reduce non-determinism in which mention is removed:
-            # If the mentions belong to different entities, sort them by entity (cluster) ids.
-            if mA.cluster.cluster_id > mB.cluster.cluster_id:
+            # If the mentions belong to different entities, sort them by entity (entity) ids.
+            if mA.entity.eid > mB.entity.eid:
                 mA, mB = mB, mA
 
             sA, sB = set(mA.words), set(mB.words)
             if sA != sB:
                 continue
 
-            # If the mentions belong to different clusters, we should merge the
-            # clusters first, i.e., pick one cluster as the survivor, move the
-            # mentions from the other cluster to this cluster, and remove the
-            # other cluster.
-            if mA.cluster != mB.cluster:
-                logging.warning(f"Merging same-span mentions that belong to different entities: {mA.cluster.cluster_id} vs. {mB.cluster.cluster_id}")
-                ###!!! TODO: As of now, changing the cluster of a mention is not supported in the API.
-                #for m in mB.cluster.mentions:
-                #    m.cluster = mA.cluster
+            # If the mentions belong to different entities, we should merge the
+            # entities first, i.e., pick one entity as the survivor, move the
+            # mentions from the other entity to this entity, and remove the
+            # other entity.
+            if mA.entity != mB.entity:
+                logging.warning(f"Merging same-span mentions that belong to different entities: {mA.entity.eid} vs. {mB.entity.eid}")
+                ###!!! TODO: As of now, changing the entity of a mention is not supported in the API.
+                #for m in mB.entity.mentions:
+                #    m.entity = mA.entity
             # Remove mention B. It may have been removed earlier because of
             # another duplicate, that is the purpose of try-except.
-            ###!!! TODO: If we remove a singleton, we are destroying the cluster. Then we must also handle possible bridging and split antecedents pointing to that cluster!
+            ###!!! TODO: If we remove a singleton, we are destroying the entity. Then we must also handle possible bridging and split antecedents pointing to that entity!
             mB.words = []
             try:
-                mB.cluster.mentions.remove(mB)
+                mB.entity.mentions.remove(mB)
             except ValueError:
                 pass
diff --git a/udapi/block/corefud/movehead.py b/udapi/block/corefud/movehead.py
index 2a38bd82..00a32e9f 100644
--- a/udapi/block/corefud/movehead.py
+++ b/udapi/block/corefud/movehead.py
@@ -75,20 +75,18 @@ def find_head(self, mention):
         # Finally, return the word-order-wise first head candidate as the head.
         return enh_heads[0], 'nontreelet'
 
-    def process_document(self, doc):
-        for cluster in doc.coref_clusters.values():
-            for mention in cluster.mentions:
-                self.counter['total'] += 1
-                if len(mention.words) < 2:
-                    self.counter['single-word'] += 1
-                else:
-                    new_head, category = self.find_head(mention)
-                    self.counter[category] += 1
-                    if new_head is mention.head:
-                        self.counter[category + '-kept'] += 1
-                    else:
-                        self.counter[category + '-moved'] += 1
-                        mention.head = new_head
+    def process_coref_mention(self, mention):
+        self.counter['total'] += 1
+        if len(mention.words) < 2:
+            self.counter['single-word'] += 1
+        else:
+            new_head, category = self.find_head(mention)
+            self.counter[category] += 1
+            if new_head is mention.head:
+                self.counter[category + '-kept'] += 1
+            else:
+                self.counter[category + '-moved'] += 1
+                mention.head = new_head
 
     def process_end(self):
         logging.info("corefud.MoveHead overview of mentions:")
diff --git a/udapi/block/corefud/printclusters.py b/udapi/block/corefud/printentities.py
similarity index 69%
rename from udapi/block/corefud/printclusters.py
rename to udapi/block/corefud/printentities.py
index 7271ae78..7230c6a5 100644
--- a/udapi/block/corefud/printclusters.py
+++ b/udapi/block/corefud/printentities.py
@@ -3,20 +3,20 @@
 from udapi.core.block import Block
 from collections import Counter, defaultdict
 
-class PrintClusters(Block):
-    """Block corefud.PrintClusters prints all mentions of a given cluster."""
+class PrintEntities(Block):
+    """Block corefud.PrintEntities prints all mentions of a given entity."""
 
-    def __init__(self, id_re=None, min_mentions=0, print_ranges=True, mark_head=True,
+    def __init__(self, eid_re=None, min_mentions=0, print_ranges=True, mark_head=True,
                  aggregate_mentions=True, **kwargs):
         """Params:
-        id_re: regular expression constraining ClusterId of the clusters to be printed
-        min_mentions: print only clusters with with at least N mentions
+        eid_re: regular expression constraining ID of the entities to be printed
+        min_mentions: print only entities with with at least N mentions
         print_ranges: print also addressess of all mentions
                       (compactly, using the longest common prefix of sent_id)
         mark_head: mark the head (e.g. as "red **car**")
         """
         super().__init__(**kwargs)
-        self.id_re = re.compile(str(id_re)) if id_re else None
+        self.eid_re = re.compile(str(eid_re)) if eid_re else None
         self.min_mentions = min_mentions
         self.print_ranges = print_ranges
         self.mark_head = mark_head
@@ -24,17 +24,17 @@ def __init__(self, id_re=None, min_mentions=0, print_ranges=True, mark_head=True
 
     def process_document(self, doc):
         if 'docname' in doc.meta:
-            print(f"Coref clusters in document {doc.meta['docname']}:")
-        for cluster in doc.coref_clusters.values():
-            if self.id_re and not self.id_re.match(cluster.cluster_id):
+            print(f"Coref entities in document {doc.meta['docname']}:")
+        for entity in doc.coref_entities:
+            if self.eid_re and not self.eid_re.match(entity.eid):
                 continue
-            if len(cluster.mentions) < self.min_mentions:
+            if len(entity.mentions) < self.min_mentions:
                 continue
-            print(f" {cluster.cluster_id} has {len(cluster.mentions)} mentions:")
+            print(f" {entity.eid} has {len(entity.mentions)} mentions:")
             if self.aggregate_mentions:
                 counter = Counter()
                 ranges = defaultdict(list)
-                for mention in cluster.mentions:
+                for mention in entity.mentions:
                     forms = ' '.join([f"**{w.form}**" if self.mark_head and w is mention.head else w.form for w in mention.words])
                     counter[forms] += 1
                     if self.print_ranges:
@@ -48,7 +48,7 @@ def process_document(self, doc):
                             prefix = os.path.commonprefix(ranges[form])
                             print(f'        {prefix} ({" ".join(f[len(prefix):] for f in ranges[form])})')
             else:
-                for mention in cluster.mentions:
+                for mention in entity.mentions:
                     forms = ' '.join([f"**{w.form}**" if self.mark_head and w is mention.head else w.form for w in mention.words])
                     print('   ' + forms)
                     if self.print_ranges:
diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
index e26ee6e2..7ed31b0d 100644
--- a/udapi/block/corefud/printmentions.py
+++ b/udapi/block/corefud/printmentions.py
@@ -99,9 +99,9 @@ def _is_almost_continuous(self, mention):
 
     def process_document(self, doc):
         mentions = []
-        for cluster in doc.coref_clusters.values():
-            if self._ok(len(cluster.mentions) == 1, self.singleton):
-                mentions.extend(cluster.mentions)
+        for entity in doc.coref_entities:
+            if self._ok(len(entity.mentions) == 1, self.singleton):
+                mentions.extend(entity.mentions)
         if self.shuffle:
             random.shuffle(mentions)
         else:
@@ -146,7 +146,7 @@ def process_document(self, doc):
                 print("# Mention = " + this_form)
                 if self.print_other_forms:
                     counter = Counter()
-                    for m in mention.cluster.mentions:
+                    for m in mention.entity.mentions:
                         forms = ' '.join([w.form for w in m.words])
                         if forms != this_form:
                             counter[forms] += 1
diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
index e39195db..cdd84e7a 100644
--- a/udapi/block/corefud/stats.py
+++ b/udapi/block/corefud/stats.py
@@ -4,14 +4,14 @@
 class Stats(Block):
     """Block corefud.Stats prints various coreference-related statistics."""
 
-    def __init__(self, m_len_max=5, c_len_max=5, report_mentions=True, report_clusters=True,
+    def __init__(self, m_len_max=5, c_len_max=5, report_mentions=True, report_entities=True,
                  report_details=True, selected_upos='NOUN PRON PROPN DET ADJ VERB ADV NUM',
                  exclude_singletons=False, exclude_nonsingletons=False, style='human', **kwargs):
         super().__init__(**kwargs)
         self.m_len_max = m_len_max
         self.c_len_max = c_len_max
         self.report_mentions = report_mentions
-        self.report_clusters = report_clusters
+        self.report_entities = report_entities
         self.report_details = report_details
         self.exclude_singletons = exclude_singletons
         self.exclude_nonsingletons = exclude_nonsingletons
@@ -21,29 +21,29 @@ def __init__(self, m_len_max=5, c_len_max=5, report_mentions=True, report_cluste
 
         self.counter = Counter()
         self.mentions = 0
-        self.clusters = 0
+        self.entities = 0
         self.total_nodes = 0
         self.longest_mention = 0
-        self.longest_cluster = 0
+        self.longest_entity = 0
         self.m_words = 0
         self.selected_upos = None if selected_upos == 'all' else selected_upos.split()
 
     def process_document(self, doc):
         self.total_nodes += len(list(doc.nodes))
-        for cluster in doc.coref_clusters.values():
-            len_mentions = len(cluster.mentions)
+        for entity in doc.coref_entities:
+            len_mentions = len(entity.mentions)
             if len_mentions == 1 and self.exclude_singletons:
                 continue
             elif len_mentions > 1 and self.exclude_nonsingletons:
                 continue
-            self.longest_cluster = max(len_mentions, self.longest_cluster)
+            self.longest_entity = max(len_mentions, self.longest_entity)
             self.counter['c_total_len'] += len_mentions
             self.counter[f"c_len_{min(len_mentions, self.c_len_max)}"] += 1
 
-            self.clusters += 1
+            self.entities += 1
             if not self.report_mentions and not self.report_details:
                 continue
-            for mention in cluster.mentions:
+            for mention in entity.mentions:
                 self.mentions += 1
                 all_words = len(mention.words)
                 non_empty = len([w for w in mention.words if not w.is_empty()])
@@ -68,17 +68,17 @@ def process_document(self, doc):
 
     def process_end(self):
         mentions_nonzero = 1 if self.mentions == 0 else self.mentions
-        clusters_nonzero = 1 if self.clusters == 0 else self.clusters
+        entities_nonzero = 1 if self.entities == 0 else self.entities
         total_nodes_nonzero = 1 if self.total_nodes == 0 else self.total_nodes
 
         columns =[ ]
-        if self.report_clusters:
-            columns += [('clusters', f"{self.clusters:7,}"),
-                        ('clusters_per1k', f"{1000 * self.clusters / total_nodes_nonzero:6.0f}"),
-                        ('longest_cluster', f"{self.longest_cluster:6}"),
-                        ('avg_cluster', f"{self.counter['c_total_len'] / clusters_nonzero:5.1f}")]
+        if self.report_entities:
+            columns += [('entities', f"{self.entities:7,}"),
+                        ('entities_per1k', f"{1000 * self.entities / total_nodes_nonzero:6.0f}"),
+                        ('longest_entity', f"{self.longest_entity:6}"),
+                        ('avg_entity', f"{self.counter['c_total_len'] / entities_nonzero:5.1f}")]
             for i in range(1, self.c_len_max + 1):
-                percent = 100 * self.counter[f"c_len_{i}"] / clusters_nonzero
+                percent = 100 * self.counter[f"c_len_{i}"] / entities_nonzero
                 columns.append((f"c_len_{i}{'' if i < self.c_len_max else '+'}", f"{percent:5.1f}"))
         if self.report_mentions:
             columns += [('mentions', f"{self.mentions:7,}"),
diff --git a/udapi/block/read/oldcorefud.py b/udapi/block/read/oldcorefud.py
index 539d5036..73e05f3b 100644
--- a/udapi/block/read/oldcorefud.py
+++ b/udapi/block/read/oldcorefud.py
@@ -2,7 +2,7 @@
 import re
 import logging
 import udapi.block.read.conllu
-from udapi.core.coref import CorefCluster, CorefMention, BridgingLinks
+from udapi.core.coref import CorefEntity, CorefMention, BridgingLinks
 
 class OldCorefUD(udapi.block.read.conllu.Conllu):
 
@@ -11,7 +11,7 @@ def __init__(self, replace_hyphen_in_id_with='', **kwargs):
 
         Args:
         substitute_hyphen_in_id_for: string to use as a replacement for hyphens in ClusterId
-          The new format does not allow hyphens in eid (IDs of entity clusters),
+          The new format does not allow hyphens in eid (IDs of entity entities),
           so we need to replace them.
         """
         super().__init__(**kwargs)
@@ -36,27 +36,27 @@ def _fix_id(self, cid):
     def process_document(self, doc, strict=True):
         super().process_document(doc)
 
-        clusters = {}
+        eid_to_entity = {}
         for node in doc.nodes_and_empty:
             index, index_str = 0, ""
-            cluster_id = node.misc["ClusterId"]
-            if not cluster_id:
+            eid = node.misc["ClusterId"]
+            if not eid:
                 index, index_str = 1, "[1]"
-                cluster_id = node.misc["ClusterId[1]"]
-            cluster_id = self._fix_id(cluster_id)
-            while cluster_id:
-                cluster = clusters.get(cluster_id)
-                if cluster is None:
-                    cluster = CorefCluster(cluster_id)
-                    clusters[cluster_id] = cluster
-                mention = CorefMention(words=[node], cluster=cluster)
+                eid = node.misc["ClusterId[1]"]
+            eid = self._fix_id(eid)
+            while eid:
+                entity = eid_to_entity.get(eid)
+                if entity is None:
+                    entity = CorefEntity(eid)
+                    eid_to_entity[eid] = entity
+                mention = CorefMention(words=[node], entity=entity)
                 if node.misc["MentionSpan" + index_str]:
                     mention.span = node.misc["MentionSpan" + index_str]
-                cluster_type = node.misc["ClusterType" + index_str]
-                if cluster_type:
-                    if cluster.cluster_type is not None and cluster_type != cluster.cluster_type:
-                        logging.warning(f"cluster_type mismatch in {node}: {cluster.cluster_type} != {cluster_type}")
-                    cluster.cluster_type = cluster_type
+                etype = node.misc["ClusterType" + index_str]
+                if etype:
+                    if entity.etype is not None and etype != entity.etype:
+                        logging.warning(f"etype mismatch in {node}: {entity.etype} != {etype}")
+                    entity.etype = etype
 
                 bridging_str = node.misc["Bridging" + index_str]
                 if bridging_str:
@@ -64,11 +64,11 @@ def process_document(self, doc, strict=True):
                     for link_str in bridging_str.split(','):
                         target, relation = link_str.split(':')
                         target = self._fix_id(target)
-                        if target == cluster_id:
-                            _error("Bridging cannot self-reference the same cluster: " + target, strict)
-                        if target not in clusters:
-                            clusters[target] = CorefCluster(target)
-                        mention._bridging.append((clusters[target], relation))
+                        if target == eid:
+                            _error("Bridging cannot self-reference the same entity: " + target, strict)
+                        if target not in eid_to_entity:
+                            eid_to_entity[target] = CorefEntity(target)
+                        mention._bridging.append((eid_to_entity[target], relation))
 
                 split_ante_str = node.misc["SplitAnte" + index_str]
                 if split_ante_str:
@@ -77,16 +77,16 @@ def process_document(self, doc, strict=True):
                     # We can delete `.replace('+', ',')` once there are no more data with the legacy plus separator.
                     for ante_str in split_ante_str.replace('+', ',').split(','):
                         ante_str = self._fix_id(ante_str)
-                        if ante_str in clusters:
-                            if ante_str == cluster_id:
-                                _error("SplitAnte cannot self-reference the same cluster: " + cluster_id, strict)
-                            split_antes.append(clusters[ante_str])
+                        if ante_str in eid_to_entity:
+                            if ante_str == eid:
+                                _error("SplitAnte cannot self-reference the same entity: " + eid, strict)
+                            split_antes.append(eid_to_entity[ante_str])
                         else:
                             # split cataphora, e.g. "We, that is you and me..."
-                            ante_cl = CorefCluster(ante_str)
-                            clusters[ante_str] = ante_cl
+                            ante_cl = CorefEntity(ante_str)
+                            eid_to_entity[ante_str] = ante_cl
                             split_antes.append(ante_cl)
-                    cluster.split_ante = sorted(split_antes)
+                    entity.split_ante = sorted(split_antes)
 
                 # Some CorefUD 0.2 datasets (e.g. ARRAU) separate key-value pairs with spaces instead of commas.
                 # We also need to escape forbidden characters.
@@ -94,16 +94,16 @@ def process_document(self, doc, strict=True):
                 mention.other = mmisc.replace('-', '%2D').replace('(', '%28').replace(')', '%29')
                 index += 1
                 index_str = f"[{index}]"
-                cluster_id = self._fix_id(node.misc["ClusterId" + index_str])
-        # c=doc.coref_clusters should be sorted, so that c[0] < c[1] etc.
-        # In other words, the dict should be sorted by the values (according to CorefCluster.__lt__),
-        # not by the keys (cluster_id).
+                eid = self._fix_id(node.misc["ClusterId" + index_str])
+        # c=doc.coref_entities should be sorted, so that c[0] < c[1] etc.
+        # In other words, the dict should be sorted by the values (according to CorefEntity.__lt__),
+        # not by the keys (eid).
         # In Python 3.7+ (3.6+ in CPython), dicts are guaranteed to be insertion order.
-        for cluster in clusters.values():
-            if not cluster._mentions:
-                _error(f"Cluster {cluster.cluster_id} referenced in SplitAnte or Bridging, but not defined with ClusterId", strict)
-            cluster._mentions.sort()
-        doc._coref_clusters = {c._cluster_id: c for c in sorted(clusters.values())}
+        for entity in eid_to_entity.values():
+            if not entity._mentions:
+                _error(f"Entity {entity.eid} referenced in SplitAnte or Bridging, but not defined with ClusterId", strict)
+            entity._mentions.sort()
+        doc._eid_to_entity = {c._eid: c for c in sorted(eid_to_entity.values())}
 
         # Delete all old-style attributes from MISC (so when converting old to new style, the old attributes are deleted).
         attrs = "ClusterId MentionSpan ClusterType Bridging SplitAnte MentionMisc".split()
diff --git a/udapi/block/util/eval.py b/udapi/block/util/eval.py
index 07eab681..0f80d018 100644
--- a/udapi/block/util/eval.py
+++ b/udapi/block/util/eval.py
@@ -29,7 +29,7 @@ class Eval(Block):
     # pylint: disable=too-many-arguments,too-many-instance-attributes
     def __init__(self, doc=None, bundle=None, tree=None, node=None, start=None, end=None,
                  before_doc=None, after_doc=None, before_bundle=None, after_bundle=None,
-                 coref_mention=None, coref_cluster=None,
+                 coref_mention=None, coref_entity=None,
                  expand_code=True, **kwargs):
         super().__init__(**kwargs)
         self.doc = doc
@@ -43,7 +43,7 @@ def __init__(self, doc=None, bundle=None, tree=None, node=None, start=None, end=
         self.before_bundle = before_bundle
         self.after_bundle = after_bundle
         self.coref_mention = coref_mention
-        self.coref_cluster = coref_cluster
+        self.coref_entity = coref_entity
         self.expand_code = expand_code
         self.count = collections.Counter()
 
@@ -74,13 +74,13 @@ def process_document(self, document):
                 # TODO if self._should_process_bundle(bundle):
                 self.process_bundle(bundle)
 
-        if self.coref_cluster or self.coref_mention:
-            for cluster in doc.coref_clusters.values():
-                if self.coref_cluster:
-                    this = cluster
-                    exec(self.expand_eval_code(self.coref_cluster))
+        if self.coref_entity or self.coref_mention:
+            for entity in doc.coref_entities:
+                if self.coref_entity:
+                    this = entity
+                    exec(self.expand_eval_code(self.coref_entity))
                 if self.coref_mention:
-                    for mention in cluster.mentions:
+                    for mention in entity.mentions:
                         this = mention
                         exec(self.expand_eval_code(self.coref_mention))
 
diff --git a/udapi/block/write/oldcorefud.py b/udapi/block/write/oldcorefud.py
index 4eb316bb..49f9beb0 100644
--- a/udapi/block/write/oldcorefud.py
+++ b/udapi/block/write/oldcorefud.py
@@ -6,7 +6,7 @@
 class OldCorefUD(udapi.block.write.conllu.Conllu):
 
     def process_document(self, doc):
-        if not doc.coref_clusters:
+        if not doc.coref_entities:
             logging.warning("Using write.OldCorefUD on a document without any coreference annotation")
 
         # Delete both new-style (GUM-style) and old-style (CorefUD 0.1) coreference annotations from MISC.
@@ -17,19 +17,19 @@ def process_document(self, doc):
                     del node.misc[key]
         del doc.meta['global.Entity']
 
-        # doc._coref_clusters is a dict, which is insertion ordered in Python 3.7+.
-        # The insertion order is sorted according to CorefCluster.__lt__ (see few lines above).
-        # However, new clusters could be added meanwhile or some clusters edited,
-        # so we need to sort the clusters again before storing to MISC.
-        # We also need to mare sure cluster.mentions are sorted in each cluster
-        # because the ordering of clusters is defined by the first mention in each cluster.
-        # Ordering of mentions within a cluster can be changed when e.g. changing the span
+        # doc._eid_to_entity is a dict, which is insertion ordered in Python 3.7+.
+        # The insertion order is sorted according to CorefEntity.__lt__ (see few lines above).
+        # However, new entities could be added meanwhile or some entities edited,
+        # so we need to sort the entities again before storing to MISC.
+        # We also need to mare sure entity.mentions are sorted in each entity
+        # because the ordering of entities is defined by the first mention in each entity.
+        # Ordering of mentions within a entity can be changed when e.g. changing the span
         # of a given mention or reordering words within a sentence and in such events
-        # Udapi currently does not automatically update the ordering of clusters.
-        for cluster in doc._coref_clusters.values():
-            cluster._mentions.sort()
-        for cluster in sorted(doc._coref_clusters.values()):
-            for mention in cluster.mentions:
+        # Udapi currently does not automatically update the ordering of entities.
+        for entity in doc.coref_entities:
+            entity._mentions.sort()
+        for entity in sorted(doc.coref_entities):
+            for mention in entity.mentions:
                 head = mention.head
                 if head.misc["ClusterId"]:
                     for a in attrs:
@@ -44,13 +44,13 @@ def process_document(self, doc):
                         index_str = f"[{index}]"
                     if index == 1:
                         index_str = ""
-                head.misc["ClusterId" + index_str] = cluster.cluster_id
+                head.misc["ClusterId" + index_str] = entity.eid
                 head.misc["MentionSpan" + index_str] = mention.span
-                head.misc["ClusterType" + index_str] = cluster.cluster_type
+                head.misc["ClusterType" + index_str] = entity.etype
                 if mention._bridging:
-                    head.misc["Bridging" + index_str] = ','.join(f'{l.target.cluster_id}:{l.relation}' for l in sorted(mention.bridging))
-                if cluster.split_ante:
-                    serialized = ','.join((c.cluster_id for c in sorted(cluster.split_ante)))
+                    head.misc["Bridging" + index_str] = ','.join(f'{l.target.eid}:{l.relation}' for l in sorted(mention.bridging))
+                if entity.split_ante:
+                    serialized = ','.join((c.eid for c in sorted(entity.split_ante)))
                     head.misc["SplitAnte" + index_str] = serialized
                 if mention.other:
                     head.misc["MentionMisc" + index_str] = str(mention.other).replace('%2D', '-')
diff --git a/udapi/core/block.py b/udapi/core/block.py
index 32033cde..f039abce 100644
--- a/udapi/core/block.py
+++ b/udapi/core/block.py
@@ -1,6 +1,9 @@
 """Block class represents the basic Udapi processing unit."""
 import logging
 
+def not_overridden(method):
+  method.is_not_overridden = True
+  return method
 
 class Block(object):
     """The smallest processing unit for processing Universal Dependencies data.
@@ -23,10 +26,12 @@ def process_end(self):
         """A hook method that is executed after processing all UD data"""
         pass
 
+    @not_overridden
     def process_node(self, _):
         """Process a UD node"""
-        raise Exception("No processing activity defined in block " + str(self))
+        pass
 
+    @not_overridden
     def process_tree(self, tree):
         """Process a UD tree"""
         # tree.descendants is slightly slower than tree._descendants (0.05s per iterating over 700k words),
@@ -36,6 +41,7 @@ def process_tree(self, tree):
         for node in tree.descendants:
             self.process_node(node)
 
+    @not_overridden
     def process_bundle(self, bundle):
         """Process a UD bundle"""
         for tree in bundle:
@@ -54,10 +60,54 @@ def apply_on_document(self, document):
 
     def process_document(self, document):
         """Process a UD document"""
-        for bundle_no, bundle in enumerate(document.bundles, 1):
-            logging.debug('Block %s processing bundle #%d (id=%s)',
-                          self.__class__.__name__, bundle_no, bundle.bundle_id)
-            self.process_bundle(bundle)
+        # Calling document.coref_entities is expensive because
+        # it needs to deserialize coref_entities from the MISC attributes.
+        # If no block in a scenario needs to process coreference entities/mentions,
+        # the deserialization does not need to be done.
+        # So we need to detect if any of the methods process_coref_entity and process_coref_mention
+        # has been overriden (without calling them, which could have adverse side effects).
+        # Let's use method annotations for this.
+        p_entity = not hasattr(self.process_coref_entity, 'is_not_overridden')
+        p_mention = not hasattr(self.process_coref_mention, 'is_not_overridden')
+        p_bundle = not hasattr(self.process_bundle, 'is_not_overridden')
+        p_tree = not hasattr(self.process_tree, 'is_not_overridden')
+        p_node = not hasattr(self.process_node, 'is_not_overridden')
+        if not any((p_entity, p_mention, p_bundle, p_tree, p_node)):
+            raise Exception("No processing activity defined in block " + str(self))
+
+        if p_entity or p_mention:
+            for entity in document.coref_entities:
+                if p_entity:
+                    self.process_coref_entity(entity)
+                else:
+                    for mention in entity.mentions:
+                        self.process_coref_mention(mention)
+
+        if p_bundle or p_tree or p_node:
+            for bundle_no, bundle in enumerate(document.bundles, 1):
+                logging.debug('Block %s processing bundle #%d (id=%s)',
+                            self.__class__.__name__, bundle_no, bundle.bundle_id)
+                if p_bundle:
+                    self.process_bundle(bundle)
+                else:
+                    for tree in bundle:
+                        if self._should_process_tree(tree):
+                            if p_tree:
+                                self.process_tree(tree)
+                            else:
+                                for node in tree.descendants:
+                                    self.process_node(node)
+
+    @not_overridden
+    def process_coref_entity(self, entity):
+        """This method is called on each coreference entity in the document."""
+        for mention in entity.mentions:
+            self.process_coref_mention(mention)
+
+    @not_overridden
+    def process_coref_mention(self, mention):
+        """This method is called on each coreference mention in the document."""
+        pass
 
     def before_process_document(self, document):
         """This method is called before each process_document."""
diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index eef25dd2..ff66c77f 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -107,21 +107,21 @@
 @functools.total_ordering
 class CorefMention(object):
     """Class for representing a mention (instance of an entity)."""
-    __slots__ = ['_head', '_cluster', '_bridging', '_words', '_other']
+    __slots__ = ['_head', '_entity', '_bridging', '_words', '_other']
 
-    def __init__(self, words, head=None, cluster=None, add_word_backlinks=True):
+    def __init__(self, words, head=None, entity=None, add_word_backlinks=True):
         if not words:
             raise ValueError("mention.words must be non-empty")
         self._head = head if head else words[0]
-        self._cluster = cluster
-        if cluster is not None:
-            cluster._mentions.append(self)
+        self._entity = entity
+        if entity is not None:
+            entity._mentions.append(self)
         self._bridging = None
         self._other = None
         self._words = words
         if add_word_backlinks:
             for new_word in words:
-                if not new_word._mentions or not cluster or self > new_word._mentions[-1]:
+                if not new_word._mentions or not entity or self > new_word._mentions[-1]:
                     new_word._mentions.append(self)
                 else:
                     new_word._mentions.append(self)
@@ -141,8 +141,8 @@ def __lt__(self, another):
         their order is defined by the order of the last word in their span.
         For example <w1, w2> precedes <w1, w3>.
 
-        The order of two same-span mentions is currently defined by their cluster_id.
-        There should be no same-span (or same-subspan) same-cluster mentions.
+        The order of two same-span mentions is currently defined by their eid.
+        There should be no same-span (or same-subspan) same-entity mentions.
         """
         #TODO: no mention.words should be handled already when loading
         if not self._words:
@@ -159,7 +159,7 @@ def __lt__(self, another):
                 return True
             if another._words[-1].precedes(self._words[-1]):
                 return False
-            return self._cluster.cluster_id < another._cluster.cluster_id
+            return self._entity.eid < another._entity.eid
         return self._words[0].precedes(another._words[0])
 
     @property
@@ -186,15 +186,15 @@ def head(self, new_head):
         self._head = new_head
 
     @property
-    def cluster(self):
-        return self._cluster
+    def entity(self):
+        return self._entity
 
-    @cluster.setter
-    def cluster(self, new_cluster):
-        if self._cluster is not None:
-            raise NotImplementedError('changing the cluster of a mention not supported yet')
-        self._cluster = new_cluster
-        new_cluster._mentions.append(new_cluster)
+    @entity.setter
+    def entity(self, new_entity):
+        if self._entity is not None:
+            raise NotImplementedError('changing the entity of a mention not supported yet')
+        self._entity = new_entity
+        new_entity._mentions.append(new_entity)
 
     @property
     def bridging(self):
@@ -216,7 +216,7 @@ def words(self):
     @words.setter
     def words(self, new_words):
         if new_words and self.head not in new_words:
-            raise ValueError(f"Head {self.head} not in new_words {new_words} for {self._cluster.cluster_id}")
+            raise ValueError(f"Head {self.head} not in new_words {new_words} for {self._entity.eid}")
         kept_words = []
         # Make sure each word is included just once and they are in the correct order.
         new_words = sorted(list(set(new_words)))
@@ -247,44 +247,44 @@ def span(self, new_span):
 
 
 @functools.total_ordering
-class CorefCluster(object):
+class CorefEntity(object):
     """Class for representing all mentions of a given entity."""
-    __slots__ = ['_cluster_id', '_mentions', 'cluster_type', 'split_ante']
+    __slots__ = ['_eid', '_mentions', 'etype', 'split_ante']
 
-    def __init__(self, cluster_id, cluster_type=None):
-        self._cluster_id = None # prepare the _cluster_id slot
-        self.cluster_id = cluster_id # call the setter and check the ID is valid
+    def __init__(self, eid, etype=None):
+        self._eid = None # prepare the _eid slot
+        self.eid = eid # call the setter and check the ID is valid
         self._mentions = []
-        self.cluster_type = cluster_type
+        self.etype = etype
         self.split_ante = []
 
     def __lt__(self, another):
-        """Does this CorefCluster precedes (word-order wise) `another` cluster?
+        """Does this CorefEntity precedes (word-order wise) `another` entity?
 
-        This method defines a total ordering of all clusters
-        by the first mention of each cluster (see `CorefMention.__lt__`).
-        If one of the clusters has no mentions (which should not happen normally),
+        This method defines a total ordering of all entities
+        by the first mention of each entity (see `CorefMention.__lt__`).
+        If one of the entities has no mentions (which should not happen normally),
         there is a backup solution (see the source code).
-        If cluster IDs are not important, it is recommended to use block
-        `corefud.IndexClusters` to re-name cluster IDs in accordance with this cluster ordering.
+        If entity IDs are not important, it is recommended to use block
+        `corefud.IndexClusters` to re-name entity IDs in accordance with this entity ordering.
         """
         if not self._mentions or not another._mentions:
-            # Clusters without mentions should go first, so the ordering is total.
-            # If both clusters are missing mentions, let's use cluster_id, so the ordering is stable.
+            # Entities without mentions should go first, so the ordering is total.
+            # If both entities are missing mentions, let's use eid, so the ordering is stable.
             if not self._mentions and not another._mentions:
-                return self._cluster_id < another._cluster_id
+                return self._eid < another._eid
             return not self._mentions
         return self._mentions[0] < another._mentions[0]
 
     @property
-    def cluster_id(self):
-        return self._cluster_id
+    def eid(self):
+        return self._eid
 
-    @cluster_id.setter
-    def cluster_id(self, new_cluster_id):
-        if any(x in new_cluster_id for x in CHARS_FORBIDDEN_IN_ID):
-            raise ValueError(f"{new_cluster_id} contains forbidden characters [{CHARS_FORBIDDEN_IN_ID}]")
-        self._cluster_id = new_cluster_id
+    @eid.setter
+    def eid(self, new_eid):
+        if any(x in new_eid for x in CHARS_FORBIDDEN_IN_ID):
+            raise ValueError(f"{new_eid} contains forbidden characters [{CHARS_FORBIDDEN_IN_ID}]")
+        self._eid = new_eid
 
     @property
     def eid_or_grp(self):
@@ -292,18 +292,18 @@ def eid_or_grp(self):
         meta = root.document.meta
         if 'GRP' in meta['global.Entity'] and meta['tree2docid']:
             docid = meta['tree2docid'][root]
-            if self._cluster_id.startswith(docid):
-                return self._cluster_id.replace(docid, '', 1)
+            if self._eid.startswith(docid):
+                return self._eid.replace(docid, '', 1)
             else:
-                logging.warning(f"GRP in global.Entity, but eid={self._cluster_id} does not start with docid={docid}")
-        return self._cluster_id
+                logging.warning(f"GRP in global.Entity, but eid={self._eid} does not start with docid={docid}")
+        return self._eid
 
     @property
     def mentions(self):
         return self._mentions
 
     def create_mention(self, head=None, words=None, span=None):
-        """Create a new CoreferenceMention object within this CorefCluster.
+        """Create a new CoreferenceMention object within this CorefEntity.
 
         Args:
         head: a node where the annotation about this CorefMention will be stored in MISC.
@@ -330,7 +330,7 @@ def create_mention(self, head=None, words=None, span=None):
         if head is None:
             head = words[0]
 
-        mention = CorefMention(words=[head], head=head, cluster=self)
+        mention = CorefMention(words=[head], head=head, entity=self)
         if words:
             mention.words = words
         if span:
@@ -353,7 +353,7 @@ def all_bridging(self):
 #   from dataclasses import dataclass
 #   @dataclass
 #   class DataClassCard:
-#      target: CorefCluster
+#      target: CorefEntity
 #      relation: str
 class BridgingLink:
     __slots__ = ['target', 'relation']
@@ -374,9 +374,9 @@ class BridgingLinks(collections.abc.MutableSequence):
     Example usage:
     >>> bl = BridgingLinks(src_mention)                                   # empty links
     >>> bl = BridgingLinks(src_mention, [(c12, 'part'), (c56, 'subset')]) # from a list of tuples
-    >>> (bl8, bl9) = BridgingLinks.from_string('c12<c8:part,c56<c8:subset,c5<c9', clusters)
-    >>> for cluster, relation in bl:
-    >>>     print(f"{bl.src_mention} ->{relation}-> {cluster.cluster_id}")
+    >>> (bl8, bl9) = BridgingLinks.from_string('c12<c8:part,c56<c8:subset,c5<c9', entities)
+    >>> for entity, relation in bl:
+    >>>     print(f"{bl.src_mention} ->{relation}-> {entity.eid}")
     >>> print(str(bl)) # c12<c8:part,c56<c8:subset
     >>> bl('part').targets == [c12]
     >>> bl('part|subset').targets == [c12, c56]
@@ -384,9 +384,9 @@ class BridgingLinks(collections.abc.MutableSequence):
     """
 
     @classmethod
-    def from_string(cls, string, clusters, node, strict=True, tree2docid=None):
+    def from_string(cls, string, entities, node, strict=True, tree2docid=None):
         """Return a sequence of BridgingLink objects representing a given string serialization.
-        The bridging links are also added to the mentions (`mention.bridging`) in the supplied `clusters`,
+        The bridging links are also added to the mentions (`mention.bridging`) in the supplied `entities`,
         so the returned sequence can be usually ignored.
         If `tree2docid` parameter is provided (mapping trees to document IDs used as prefixes in eid),
         the entity IDs in the provided string are interpreted as "GRP", i.e. as document-wide IDs,
@@ -403,17 +403,17 @@ def from_string(cls, string, clusters, node, strict=True, tree2docid=None):
             if ':' in src_str:
                 src_str, relation = src_str.split(':', 1)
             if trg_str == src_str:
-                _error(f"Bridge cannot self-reference the same cluster {trg_str} at {node}", strict)
+                _error(f"Bridge cannot self-reference the same entity {trg_str} at {node}", strict)
             if tree2docid:
                 src_str = tree2docid[node.root] + src_str
                 trg_str = tree2docid[node.root] + trg_str
             bl = src_str2bl.get(src_str)
             if not bl:
-                bl = clusters[src_str].mentions[-1].bridging
+                bl = entities[src_str].mentions[-1].bridging
                 src_str2bl[src_str] = bl
-            if trg_str not in clusters:
-                clusters[trg_str] = CorefCluster(trg_str)
-            bl._data.append(BridgingLink(clusters[trg_str], relation))
+            if trg_str not in entities:
+                entities[trg_str] = CorefEntity(trg_str)
+            bl._data.append(BridgingLink(entities[trg_str], relation))
         return src_str2bl.values()
 
     def __init__(self, src_mention, value=None, strict=True):
@@ -423,8 +423,8 @@ def __init__(self, src_mention, value=None, strict=True):
         if value is not None:
             if isinstance(value, collections.abc.Sequence):
                 for v in value:
-                    if v[0] is src_mention._cluster:
-                        _error("Bridging cannot self-reference the same cluster: " + v[0].cluster_id, strict)
+                    if v[0] is src_mention._entity:
+                        _error("Bridging cannot self-reference the same entity: " + v[0].eid, strict)
                     self._data.append(BridgingLink(v[0], v[1]))
             else:
                 raise ValueError(f"Unknown value type: {type(value)}")
@@ -439,21 +439,21 @@ def __len__(self):
 
     # TODO delete backlinks of old links, dtto for SplitAnte
     def __setitem__(self, key, new_value):
-        if new_value[0] is self.src_mention._cluster:
-            _error("Bridging cannot self-reference the same cluster: " + new_value[0].cluster_id, self.strict)
+        if new_value[0] is self.src_mention._entity:
+            _error("Bridging cannot self-reference the same entity: " + new_value[0].eid, self.strict)
         self._data[key] = BridgingLink(new_value[0], new_value[1])
 
     def __delitem__(self, key):
         del self._data[key]
 
     def insert(self, key, new_value):
-        if new_value[0] is self.src_mention._cluster:
-            _error("Bridging cannot self-reference the same cluster: " + new_value[0].cluster_id, self.strict)
+        if new_value[0] is self.src_mention._entity:
+            _error("Bridging cannot self-reference the same entity: " + new_value[0].eid, self.strict)
         self._data.insert(key, BridgingLink(new_value[0], new_value[1]))
 
     def __str__(self):
         # TODO in future link.relation should never be None, 0 nor "_", so we could delete the <not in (None, "_", "")> below.
-        return ','.join(f'{l.target.eid_or_grp}<{self.src_mention.cluster.eid_or_grp}{":" + l.relation if l.relation not in (None, "_", "") else ""}' for l in sorted(self._data))
+        return ','.join(f'{l.target.eid_or_grp}<{self.src_mention.entity.eid_or_grp}{":" + l.relation if l.relation not in (None, "_", "") else ""}' for l in sorted(self._data))
 
     def __call__(self, relations_re=None):
         """Return a subset of links contained in this list as specified by the args.
@@ -466,14 +466,14 @@ def __call__(self, relations_re=None):
 
     @property
     def targets(self):
-        """Return a list of the target clusters (without relations)."""
+        """Return a list of the target entities (without relations)."""
         return [link.target for link in self._data]
 
     def _delete_targets_without_mentions(self, warn=True):
         for link in self._data:
             if not link.target.mentions:
                 if warn:
-                    logging.warning(f"Cluster {link.target.cluster_id} has no mentions, but is referred to in bridging of {self.src_mention.cluster.cluster_id}")
+                    logging.warning(f"Entity {link.target.eid} has no mentions, but is referred to in bridging of {self.src_mention.entity.eid}")
                 self._data.remove(link)
 
 
@@ -492,7 +492,7 @@ def _error(msg, strict):
 
 def load_coref_from_misc(doc, strict=True):
     global highest_doc_n
-    clusters = {}
+    entities = {}
     unfinished_mentions = collections.defaultdict(list)
     discontinuous_mentions = collections.defaultdict(list)
     global_entity = doc.meta.get('global.Entity')
@@ -573,12 +573,12 @@ def load_coref_from_misc(doc, strict=True):
                     try:
                         mention.head = mention.words[head_idx - 1]
                     except IndexError as err:
-                        _error(f"Invalid head_idx={head_idx} for {mention.cluster.cluster_id} "
+                        _error(f"Invalid head_idx={head_idx} for {mention.entity.eid} "
                                 f"closed at {node} with words={mention.words}", 1)
                 if subspan_idx and subspan_idx == total_subspans:
                     m = discontinuous_mentions[eid].pop()
                     if m is not mention:
-                        _error(f"Closing mention {mention.cluster.cluster_id} at {node}, but it has unfinished nested mentions ({m.words})", 1)
+                        _error(f"Closing mention {mention.entity.eid} at {node}, but it has unfinished nested mentions ({m.words})", 1)
 
             # 3. opening or single-word
             else:
@@ -615,18 +615,18 @@ def load_coref_from_misc(doc, strict=True):
                     else:
                         eid, subspan_idx, total_subspans = m.group(1, 2, 3)
 
-                cluster = clusters.get(eid)
-                if cluster is None:
+                entity = entities.get(eid)
+                if entity is None:
                     if subspan_idx and subspan_idx != '1':
                         _error(f'Non-first subspan of a discontinuous mention {eid} at {node} does not have any previous mention.', 1)
-                    cluster = CorefCluster(eid)
-                    clusters[eid] = cluster
-                    cluster.cluster_type = etype
-                elif etype and cluster.cluster_type and cluster.cluster_type != etype:
-                    logging.warning(f"etype mismatch in {node}: {cluster.cluster_type} != {etype}")
-                # CorefCluster could be created first with "Bridge=" without any type
-                elif etype and cluster.cluster_type is None:
-                    cluster.cluster_type = etype
+                    entity = CorefEntity(eid)
+                    entities[eid] = entity
+                    entity.etype = etype
+                elif etype and entity.etype and entity.etype != etype:
+                    logging.warning(f"etype mismatch in {node}: {entity.etype} != {etype}")
+                # CorefEntity could be created first with "Bridge=" without any type
+                elif etype and entity.etype is None:
+                    entity.etype = etype
 
                 if subspan_idx and subspan_idx != '1':
                     opened = [pair[0] for pair in unfinished_mentions[eid]]
@@ -635,14 +635,14 @@ def load_coref_from_misc(doc, strict=True):
                     if closing and subspan_idx == total_subspans:
                         m = discontinuous_mentions[eid].pop()
                         if m is not mention:
-                            _error(f"{node}: closing mention {mention.cluster.cluster_id} ({mention.words}), but it has an unfinished nested mention ({m.words})", 1)
+                            _error(f"{node}: closing mention {mention.entity.eid} ({mention.words}), but it has an unfinished nested mention ({m.words})", 1)
                         try:
                             mention.head = mention._words[head_idx - 1]
                         except IndexError as err:
-                            _error(f"Invalid head_idx={head_idx} for {mention.cluster.cluster_id} "
+                            _error(f"Invalid head_idx={head_idx} for {mention.entity.eid} "
                                     f"closed at {node} with words={mention._words}", 1)
                 else:
-                    mention = CorefMention(words=[node], cluster=cluster)
+                    mention = CorefMention(words=[node], entity=entity)
                     if other:
                         mention._other = other
                     if subspan_idx:
@@ -657,7 +657,7 @@ def load_coref_from_misc(doc, strict=True):
         # or with relations Bridge=e173<c188:subset,e174<e188:part
         misc_bridge = node.misc['Bridge']
         if misc_bridge:
-            BridgingLinks.from_string(misc_bridge, clusters, node, strict, tree2docid)
+            BridgingLinks.from_string(misc_bridge, entities, node, strict, tree2docid)
 
         # SplitAnte, e.g. Entity=(e11-person(e12-person)|SplitAnte=e3<e11,e4<e11,e6<e12,e7<e12
         # which means that both e11 and e12 have split antecedents (e11=e3+e4, e12=e6+e7).
@@ -665,44 +665,44 @@ def load_coref_from_misc(doc, strict=True):
         if not misc_split and 'Split' in node.misc:
             misc_split = node.misc.pop('Split')
         if misc_split:
-            ante_clusters = []
+            ante_entities = []
             for x in misc_split.split(','):
                 ante_str, this_str = x.split('<')
                 if ante_str == this_str:
-                    _error("SplitAnte cannot self-reference the same cluster: " + this_str, strict)
+                    _error("SplitAnte cannot self-reference the same entity: " + this_str, strict)
                 if tree2docid:
                     ante_str = tree2docid[node.root] + ante_str
                     this_str = tree2docid[node.root] + this_str
                 # split cataphora, e.g. "We, that is you and me..."
-                if ante_str not in clusters:
-                    clusters[ante_str] = CorefCluster(ante_str)
-                clusters[this_str].split_ante.append(clusters[ante_str])
+                if ante_str not in entities:
+                    entities[ante_str] = CorefEntity(ante_str)
+                entities[this_str].split_ante.append(entities[ante_str])
 
-    for cluster_name, mentions in unfinished_mentions.items():
+    for entity_name, mentions in unfinished_mentions.items():
         for mention in mentions:
-            logging.warning(f"Mention {cluster_name} opened at {mention.head}, but not closed. Deleting.")
-            cluster = mention.cluster
+            logging.warning(f"Mention {entity_name} opened at {mention.head}, but not closed. Deleting.")
+            entity = mention.entity
             mention.words = []
-            cluster._mentions.remove(mention)
-            if not cluster._mentions:
-                del clusters[name]
+            entity._mentions.remove(mention)
+            if not entity._mentions:
+                del entities[name]
 
-    # c=doc.coref_clusters should be sorted, so that c[0] < c[1] etc.
-    # In other words, the dict should be sorted by the values (according to CorefCluster.__lt__),
-    # not by the keys (cluster_id).
+    # c=doc.coref_entities should be sorted, so that c[0] < c[1] etc.
+    # In other words, the dict should be sorted by the values (according to CorefEntity.__lt__),
+    # not by the keys (eid).
     # In Python 3.7+ (3.6+ in CPython), dicts are guaranteed to be insertion order.
-    for cluster in clusters.values():
-        if not cluster._mentions:
-            _error(f"Cluster {cluster.cluster_id} referenced in SplitAnte or Bridge, but not defined with Entity", strict)
-        cluster._mentions.sort()
-        for mention in cluster._mentions:
+    for entity in entities.values():
+        if not entity._mentions:
+            _error(f"Entity {entity.eid} referenced in SplitAnte or Bridge, but not defined with Entity", strict)
+        entity._mentions.sort()
+        for mention in entity._mentions:
             for node in mention._words:
                 node._mentions.sort()
-    doc._coref_clusters = {c._cluster_id: c for c in sorted(clusters.values())}
+    doc._eid_to_entity = {c._eid: c for c in sorted(entities.values())}
 
 
 def store_coref_to_misc(doc):
-    if not doc._coref_clusters:
+    if not doc._eid_to_entity:
         return
 
     tree2docid = doc.meta.get('tree2docid')
@@ -731,18 +731,18 @@ def store_coref_to_misc(doc):
         if ',' not in mention.span:
             doc_mentions.append(mention)
         else:
-            cluster = mention.cluster
+            entity = mention.entity
             head_str = str(mention.words.index(mention.head) + 1)
             subspans = mention.span.split(',')
             root = mention.words[0].root
             for idx,subspan in enumerate(subspans, 1):
-                eid = cluster.cluster_id
+                eid = entity.eid
                 if tree2docid and 'GRP' in fields:
-                    eid = re.sub(r'^d\d+\.', '', eid) # TODO or "eid = cluster.eid_or_grp"?
+                    eid = re.sub(r'^d\d+\.', '', eid) # TODO or "eid = entity.eid_or_grp"?
                 subspan_eid = f'{eid}[{idx}/{len(subspans)}]'
                 subspan_words = span_to_nodes(root, subspan)
-                fake_cluster = CorefCluster(subspan_eid, cluster.cluster_type)
-                fake_mention = CorefMention(subspan_words, head_str, fake_cluster, add_word_backlinks=False)
+                fake_entity = CorefEntity(subspan_eid, entity.etype)
+                fake_mention = CorefMention(subspan_words, head_str, fake_entity, add_word_backlinks=False)
                 if mention._other:
                     fake_mention._other = mention._other
                 if mention._bridging and idx == 1:
@@ -751,11 +751,11 @@ def store_coref_to_misc(doc):
     doc_mentions.sort()
 
     for mention in doc_mentions:
-        cluster = mention.cluster
+        entity = mention.entity
         values = []
         for field in fields:
             if field == 'eid' or field == 'GRP':
-                eid = cluster.cluster_id
+                eid = entity.eid
                 if field == 'GRP':
                     eid = re.sub(r'^d\d+\.', '', eid)
                 if any(x in eid for x in CHARS_FORBIDDEN_IN_ID):
@@ -764,10 +764,10 @@ def store_coref_to_misc(doc):
                         eid = eid.replace(c, '')
                 values.append(eid)
             elif field == 'etype' or field == 'entity':
-                if not cluster.cluster_type:
+                if not entity.etype:
                     values.append('')
                 else:
-                    values.append(cluster.cluster_type)
+                    values.append(entity.etype)
             elif field == 'head':
                 if isinstance(mention.head, str):
                     values.append(mention.head) # fake mention for discontinuous spans
@@ -818,7 +818,7 @@ def store_coref_to_misc(doc):
         # Second, multi-word mentions. Opening brackets should follow closing brackets.
         else:
             firstword.misc['Entity'] += mention_str
-            eid = cluster.cluster_id
+            eid = entity.eid
             if tree2docid and 'GRP' in fields:
                 eid = re.sub(r'^d\d+\.', '', eid)
             mention.words[-1].misc['Entity'] = eid + ')' + mention.words[-1].misc['Entity']
@@ -832,20 +832,20 @@ def store_coref_to_misc(doc):
             firstword.misc['Bridge'] = str_bridge
 
     # SplitAnte=e5<e61,e10<e61
-    for cluster in doc.coref_clusters.values():
-        if cluster.split_ante:
-            for ante_entity in cluster.split_ante:
+    for entity in doc.coref_entities:
+        if entity.split_ante:
+            for ante_entity in entity.split_ante:
                 if not ante_entity.mentions:
-                    logging.warning(f"Cluster {ante_entity.cluster_id} has no mentions, but is referred to in SplitAnte of {cluster.cluster_id}")
-                    cluster.split_ante.remove(ante_entity)
-            if not cluster.split_ante or len(cluster.split_ante) < 2:
-                logging.warning(f"SplitAnte of {cluster.cluster_id} has less than two antecedents, omitting")
+                    logging.warning(f"Entity {ante_entity.eid} has no mentions, but is referred to in SplitAnte of {entity.eid}")
+                    entity.split_ante.remove(ante_entity)
+            if not entity.split_ante or len(entity.split_ante) < 2:
+                logging.warning(f"SplitAnte of {entity.eid} has less than two antecedents, omitting")
                 continue
-            first_word = cluster.mentions[0].words[0]
+            first_word = entity.mentions[0].words[0]
             if tree2docid:
-                strs = ','.join(f'{sa.eid_or_grp}<{cluster.eid_or_grp}' for sa in cluster.split_ante)
+                strs = ','.join(f'{sa.eid_or_grp}<{entity.eid_or_grp}' for sa in entity.split_ante)
             else:
-                strs = ','.join(f'{sa.cluster_id}<{cluster.cluster_id}' for sa in cluster.split_ante)
+                strs = ','.join(f'{sa.eid}<{entity.eid}' for sa in entity.split_ante)
             if first_word.misc['SplitAnte']:
                 strs = first_word.misc['SplitAnte'] + ',' + strs
             first_word.misc['SplitAnte'] = strs
diff --git a/udapi/core/document.py b/udapi/core/document.py
index 8e33c8d6..dcf146ea 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -2,6 +2,7 @@
 
 import io
 import contextlib
+import logging
 import udapi.core.coref
 from udapi.core.bundle import Bundle
 from udapi.block.read.conllu import Conllu as ConlluReader
@@ -28,7 +29,7 @@ def __init__(self, filename=None, **kwargs):
         self._highest_bundle_id = 0
         self.meta = {}
         self.json = {}
-        self._coref_clusters = None
+        self._eid_to_entity = None
         if filename is not None:
             if filename.endswith(".conllu"):
                 self.load_conllu(filename, **kwargs)
@@ -112,40 +113,57 @@ def draw(self, **kwargs):
         TextModeTrees(**kwargs).run(self)
 
     def _load_coref(self):
-        """De-serialize coreference-related objects (CorefMention, CorefCluster).
+        """De-serialize coreference-related objects (CorefMention, CorefEntity).
 
         This internal method will be called automatically whenever any coref-related method is called.
         It iterates through all nodes in the document and creates the objects based on the info in MISC
-        (stored in attributes ClusterId, MentionSpan, ClusterType, Split, Bridging).
+        (stored in attributes Entity, SplitAnte, Bridge).
         """
-        if self._coref_clusters is None:
+        if self._eid_to_entity is None:
             udapi.core.coref.load_coref_from_misc(self)
 
+    @property
+    def eid_to_entity(self):
+        """A dict mapping each eid (entity ID) to a CorefEntity object."""
+        self._load_coref()
+        return self._eid_to_entity
+
     @property
     def coref_clusters(self):
-        """A dict mapping ClusterId to a CorefCluster object."""
+        """DEPRECATED: A dict mapping eid to a CorefEntity object.
+
+        Substitute `doc.coref_clusters.values()` and `list(doc.coref_clusters.values())`
+        with `doc.coref_entities`.
+        Otherwise, substitute `doc.coref_clusters` with `doc.eid_to_entity`.
+        """
+        logging.warning("coref_clusters is deprecated, use coref_entities or eid_to_entity instead.")
+        return self.eid_to_entity
+
+    @property
+    def coref_entities(self):
+        """A list of all CorefEntity objects in the document."""
         self._load_coref()
-        return self._coref_clusters
+        return list(self._eid_to_entity.values())
 
     @property
     def coref_mentions(self):
         """A sorted list of all CorefMention objects in the document."""
         self._load_coref()
         all_mentions = []
-        for cluster in self._coref_clusters.values():
-            all_mentions.extend(cluster.mentions)
+        for entity in self._eid_to_entity.values():
+            all_mentions.extend(entity.mentions)
         all_mentions.sort()
         return all_mentions
 
-    def create_coref_cluster(self, cluster_id=None, cluster_type=None):
+    def create_coref_entity(self, eid=None, etype=None):
         self._load_coref()
-        if not cluster_id:
+        if not eid:
             counter = 1
-            while self._coref_clusters.get(f'c{counter}'):
+            while self._eid_to_entity.get(f'c{counter}'):
                 counter += 1
-            cluster_id = f'c{counter}'
-        elif clusters.get(cluster_id):
-            raise ValueError("Cluster with a id %s already exists", cluster_id)
-        cluster = udapi.core.coref.CorefCluster(cluster_id, cluster_type)
-        self._coref_clusters[cluster_id] = cluster
-        return cluster
+            eid = f'c{counter}'
+        elif self._eid_to_entity.get(eid):
+            raise ValueError("Entity with eid=%s already exists", eid)
+        entity = udapi.core.coref.CorefEntity(eid, etype)
+        self._eid_to_entity[eid] = entity
+        return entity
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 4524c119..732ef7f4 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -917,16 +917,16 @@ def coref_mentions(self):
         return self._mentions
 
     @property
-    def coref_clusters(self):
+    def coref_entities(self):
         self._root.bundle.document._load_coref()
-        return [m.cluster for m in self._mentions if m.cluster is not None]
+        return [m.entity for m in self._mentions if m.entity is not None]
 
     # TODO: is this method useful?
-    def create_coref_cluster(self, cluster_id=None, cluster_type=None, **kwargs):
+    def create_coref_entity(self, eid=None, etype=None, **kwargs):
         doc = self._root.bundle.document
-        cluster = doc.create_coref_cluster(cluster_id, cluster_type)
-        cluster.create_mention(head=self, **kwargs)
-        return cluster
+        entity = doc.create_coref_entity(eid, etype)
+        entity.create_mention(head=self, **kwargs)
+        return entity
 
 
 class CycleError(Exception):
diff --git a/udapi/core/tests/test_coref.py b/udapi/core/tests/test_coref.py
index 8eab1436..6142d1f8 100755
--- a/udapi/core/tests/test_coref.py
+++ b/udapi/core/tests/test_coref.py
@@ -14,22 +14,22 @@ def test_load(self):
         docs = reader.read_documents()
         self.assertEqual(len(docs), 2)
         docs[-1].draw()
-        coref_entities = list(docs[-1].coref_clusters.values())
+        coref_entities = docs[-1].coref_entities
         self.assertEqual(len(coref_entities), 1)
-        self.assertEqual(coref_entities[0].cluster_id, 'e36781')
+        self.assertEqual(coref_entities[0].eid, 'e36781')
 
     def test_edits(self):
         data_filename = os.path.join(os.path.dirname(__file__), 'data', 'fr-democrat-dev-sample.conllu')
         doc = udapi.Document(data_filename)
         first_node = next(doc.nodes)
         second_node = first_node.next_node
-        new_entity = doc.create_coref_cluster(cluster_type='person')
-        self.assertEqual(new_entity.cluster_type, 'person')
+        new_entity = doc.create_coref_entity(etype='person')
+        self.assertEqual(new_entity.etype, 'person')
         self.assertEqual(len(new_entity.mentions), 0)
         m1 = new_entity.create_mention(words=[first_node]) # head will be automatically set to words[0]
         self.assertEqual(len(new_entity.mentions), 1)
         self.assertEqual(m1, new_entity.mentions[0])
-        self.assertEqual(m1.cluster, new_entity)
+        self.assertEqual(m1.entity, new_entity)
         self.assertEqual(m1.head, first_node)
         self.assertEqual(m1.words, [first_node])
         self.assertEqual(m1.span, '1')

From b085e99789e2a89a79779493cfa470eb128b8a3b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 6 Apr 2022 05:50:19 +0200
Subject: [PATCH 0543/1374] preparing PyPI release 0.3.0

---
 CHANGES.txt | 5 +++++
 setup.cfg   | 2 +-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/CHANGES.txt b/CHANGES.txt
index 77d72548..67ced748 100644
--- a/CHANGES.txt
+++ b/CHANGES.txt
@@ -2,6 +2,11 @@ Udapi Change Log
 ----------------
 See https://github.com/udapi/udapi-python/commits/master for details.
 
+0.3.0 2022-04-06
+ - support for CorefUD 1.0 (new CoNLL-U format for coreference annotation)
+ - edits by Dan Zeman in block.ud.*
+ - Circle-CI (instead of Travis-CI)
+
 0.2.3 2021-02-23
  - support for enhanced dependencies and coreference
  - requires Python 3.6+ due to f-strings
diff --git a/setup.cfg b/setup.cfg
index 4e96f81a..a14145ab 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -1,6 +1,6 @@
 [metadata]
 name = udapi
-version = 0.2.3
+version = 0.3.0
 author = Martin Popel
 author_email = popel@ufal.mff.cuni.cz
 description = Python framework for processing Universal Dependencies data

From 36aae5882fe29a435721ea261f1156437c8e0e0c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 6 Apr 2022 10:22:32 +0200
Subject: [PATCH 0544/1374] MentionMisc in the OldCorefUD format should have
 been comma-separated, not space-separated

We still use the old format during the CorefUD 1.0 conversion.
Ideally, we should rewrite all the import scripts and get rid of the intermediate old-format step.
---
 udapi/block/corefud/concatmentionmisc.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/corefud/concatmentionmisc.py b/udapi/block/corefud/concatmentionmisc.py
index aeb945a8..74483368 100644
--- a/udapi/block/corefud/concatmentionmisc.py
+++ b/udapi/block/corefud/concatmentionmisc.py
@@ -14,11 +14,11 @@ def process_tree(self,root):
                     index = matchObj.group(2)
 
                     finalattr = 'MentionMisc'+index
-                    value = node.misc[attrname]
-                
+                    value = node.misc[attrname].replace(",", "%2C")
+
                     if finalattr not in node.misc:
                         node.misc[finalattr] = f'{innerattrib}:{value}'
                     else:
-                        node.misc[finalattr] += f' {innerattrib}:{value}'
+                        node.misc[finalattr] += f',{innerattrib}:{value}'
                     del node.misc[attrname]
 

From d57eb3b8b45b1e89a4b9b95ab264ce917357b5f6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 7 Apr 2022 16:13:35 +0200
Subject: [PATCH 0545/1374] =?UTF-8?q?"=D0=BF=D0=BB=D1=8E=D1=81".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ru/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 79669d63..469c9173 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -17,6 +17,7 @@ class FixEdeprels(Block):
         'если':    [],
         'как':     ['как_только'],
         'нежели':  [],
+        'плюс':    [],
         'раз':     [],
         'словно':  [],
         'так_что': [],

From 73b9f54b4deb39945ebb04c9b9d83dc677fea3f9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 7 Apr 2022 21:10:50 +0200
Subject: [PATCH 0546/1374] Russian case markers.

---
 udapi/block/ud/ru/fixedeprels.py | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 469c9173..e5bab63b 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -21,6 +21,7 @@ class FixEdeprels(Block):
         'раз':     [],
         'словно':  [],
         'так_что': [],
+        'хоть':    [],
         'чем':     []
     }
 
@@ -40,19 +41,25 @@ class FixEdeprels(Block):
         'возле':            'возле:gen',
         'вплоть_до':        'вплоть_до:gen',
         'до':               'до:gen',
+        'из':               'из:gen',
         'к':                'к:dat',
         'несмотря_на':      'несмотря_на:acc',
+        'около':            'около:gen',
         'относительно':     'относительно:gen',
         'по_мера':          'по_мере:gen',
+        'по_мера_то_как':   'по_мере_того_как',
         'по_отношение_ко?': 'по_отношению_к:dat',
         'по_повод':         'по_поводу:gen',
         'по_сравнение_с':   'по_сравнению_с:ins',
         'помимо':           'помимо:gen',
+        'порядка':          'порядка:gen',
         'при_помощь':       'при_помощи:gen',
         'с_помощь':         'с_помощью:gen',
+        'с_тот_пора_как':   'с_тех_пор_как',
         'со_сторона':       'со_стороны:gen',
         'согласно':         'согласно:dat',
         'спустя':           'спустя:acc',
+        'у':                'у:gen',
         'через':            'через:acc'
     }
 
@@ -126,6 +133,15 @@ def process_node(self, node):
                         # Accusative or instrumental are possible. Pick accusative.
                         edep['deprel'] = m.group(1)+':'+m.group(2)+':acc'
                     continue
+                m = re.match(r'^(obl(?::arg)?|nmod):(по)(?::(?:nom|gen|voc|ins))?$', edep['deprel'])
+                if m:
+                    adpcase = self.copy_case_from_adposition(node, m.group(2))
+                    if adpcase:
+                        edep['deprel'] = m.group(1)+':'+adpcase
+                    else:
+                        # Dative, accusative or locative are possible. Pick dative.
+                        edep['deprel'] = m.group(1)+':'+m.group(2)+':dat'
+                    continue
                 m = re.match(r'^(obl(?::arg)?|nmod):(с)(?::(?:nom|dat|acc|voc|loc))?$', edep['deprel'])
                 if m:
                     adpcase = self.copy_case_from_adposition(node, m.group(2))

From a9b3a82baaf6283c4d47a13d4326c9f7807bccc6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 9 Apr 2022 21:35:57 +0200
Subject: [PATCH 0547/1374] Russian edeprels.

---
 udapi/block/ud/ru/fixedeprels.py | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index e5bab63b..c7293d69 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -22,7 +22,8 @@ class FixEdeprels(Block):
         'словно':  [],
         'так_что': [],
         'хоть':    [],
-        'чем':     []
+        'чем':     [],
+        'что':     []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -35,16 +36,21 @@ class FixEdeprels(Block):
         'в_качество':       'в_качестве:gen',
         'в_отношение':      'в_отношении:gen',
         'в_связь_с':        'в_связи_с:ins',
+        'в_случай_если':    'в_случае_если',
         'в_соответствие_с': 'в_соответствии_с:ins',
         'в_течение':        'в_течение:gen',
         'в_ход':            'в_ходе:gen',
         'возле':            'возле:gen',
         'вплоть_до':        'вплоть_до:gen',
+        'вроде':            'вроде:gen',
+        'для':              'для:gen',
         'до':               'до:gen',
+        'за_исключение':    'за_исключением:gen',
         'из':               'из:gen',
         'к':                'к:dat',
         'несмотря_на':      'несмотря_на:acc',
         'около':            'около:gen',
+        'от':               'от:gen',
         'относительно':     'относительно:gen',
         'по_мера':          'по_мере:gen',
         'по_мера_то_как':   'по_мере_того_как',
@@ -87,6 +93,10 @@ def process_node(self, node):
             if m:
                 bdeprel = m.group(1)
                 solved = False
+                # If the case marker starts with 'столько', remove this part.
+                # It occurs in the expressions of the type 'сколько...столько' but the real case marker of the modifier is something else.
+                # Similarly, 'то' occurs in 'то...то' and should be removed.
+                edep['deprel'] = re.sub(r':(столько|то|точно)[_:]', ':', edep['deprel'])
                 # If one of the following expressions occurs followed by another preposition
                 # or by morphological case, remove the additional case marking. For example,
                 # 'словно_у' becomes just 'словно'.
@@ -124,7 +134,7 @@ def process_node(self, node):
                         # Accusative or locative are possible. Pick locative.
                         edep['deprel'] = m.group(1)+':'+m.group(2)+':loc'
                     continue
-                m = re.match(r'^(obl(?::arg)?|nmod):(за)(?::(?:nom|gen|dat|voc|loc))?$', edep['deprel'])
+                m = re.match(r'^(obl(?::arg)?|nmod):(за|между|под)(?::(?:nom|gen|dat|voc|loc))?$', edep['deprel'])
                 if m:
                     adpcase = self.copy_case_from_adposition(node, m.group(2))
                     if adpcase:

From 4f2eb09306121425ece1dc0717f92f1f8a5d4a74 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 10 Apr 2022 09:06:21 +0200
Subject: [PATCH 0548/1374] Russian edeprels.

---
 udapi/block/ud/ru/fixedeprels.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index c7293d69..0fc90641 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -40,11 +40,14 @@ class FixEdeprels(Block):
         'в_соответствие_с': 'в_соответствии_с:ins',
         'в_течение':        'в_течение:gen',
         'в_ход':            'в_ходе:gen',
+        'во_глава':         'во_главе_с:ins',
+        'во_глава_с':       'во_главе_с:ins',
         'возле':            'возле:gen',
         'вплоть_до':        'вплоть_до:gen',
         'вроде':            'вроде:gen',
         'для':              'для:gen',
         'до':               'до:gen',
+        'до_то_как':        'до:gen', # до того, как ...
         'за_исключение':    'за_исключением:gen',
         'из':               'из:gen',
         'к':                'к:dat',
@@ -62,6 +65,7 @@ class FixEdeprels(Block):
         'при_помощь':       'при_помощи:gen',
         'с_помощь':         'с_помощью:gen',
         'с_тот_пора_как':   'с_тех_пор_как',
+        'свыше':            'свыше:gen',
         'со_сторона':       'со_стороны:gen',
         'согласно':         'согласно:dat',
         'спустя':           'спустя:acc',
@@ -125,7 +129,7 @@ def process_node(self, node):
                 # Both "на" and "в" also occur with genitive. However, this
                 # is only because there are numerals in the phrase ("в 9 случаев из 10")
                 # and the whole phrase should not be analyzed as genitive.
-                m = re.match(r'^(obl(?::arg)?|nmod):(в|на)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
+                m = re.match(r'^(obl(?::arg)?|nmod):(в|на|о)(?::(?:nom|gen|dat|voc|ins))?$', edep['deprel'])
                 if m:
                     adpcase = self.copy_case_from_adposition(node, m.group(2))
                     if adpcase:

From 3f399af0e1b88b3eb3e63f1496f6c52e478cf15f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 11 Apr 2022 10:29:14 +0200
Subject: [PATCH 0549/1374] Fixed Russian edeprels.

---
 udapi/block/ud/ru/fixedeprels.py | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 0fc90641..fd24be5a 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -18,6 +18,7 @@ class FixEdeprels(Block):
         'как':     ['как_только'],
         'нежели':  [],
         'плюс':    [],
+        'пусть':   [],
         'раз':     [],
         'словно':  [],
         'так_что': [],
@@ -62,6 +63,7 @@ class FixEdeprels(Block):
         'по_сравнение_с':   'по_сравнению_с:ins',
         'помимо':           'помимо:gen',
         'порядка':          'порядка:gen',
+        'после':            'после:gen',
         'при_помощь':       'при_помощи:gen',
         'с_помощь':         'с_помощью:gen',
         'с_тот_пора_как':   'с_тех_пор_как',
@@ -70,7 +72,8 @@ class FixEdeprels(Block):
         'согласно':         'согласно:dat',
         'спустя':           'спустя:acc',
         'у':                'у:gen',
-        'через':            'через:acc'
+        'через':            'через:acc',
+        'чтоб':             'чтобы'
     }
 
     def copy_case_from_adposition(self, node, adposition):
@@ -138,7 +141,7 @@ def process_node(self, node):
                         # Accusative or locative are possible. Pick locative.
                         edep['deprel'] = m.group(1)+':'+m.group(2)+':loc'
                     continue
-                m = re.match(r'^(obl(?::arg)?|nmod):(за|между|под)(?::(?:nom|gen|dat|voc|loc))?$', edep['deprel'])
+                m = re.match(r'^(obl(?::arg)?|nmod):(за|под)(?::(?:nom|gen|dat|voc|loc))?$', edep['deprel'])
                 if m:
                     adpcase = self.copy_case_from_adposition(node, m.group(2))
                     if adpcase:
@@ -147,6 +150,15 @@ def process_node(self, node):
                         # Accusative or instrumental are possible. Pick accusative.
                         edep['deprel'] = m.group(1)+':'+m.group(2)+':acc'
                     continue
+                m = re.match(r'^(obl(?::arg)?|nmod):(между)(?::(?:nom|dat|acc|voc|loc))?$', edep['deprel'])
+                if m:
+                    adpcase = self.copy_case_from_adposition(node, m.group(2))
+                    if adpcase:
+                        edep['deprel'] = m.group(1)+':'+adpcase
+                    else:
+                        # Genitive or instrumental are possible. Pick genitive.
+                        edep['deprel'] = m.group(1)+':'+m.group(2)+':gen'
+                    continue
                 m = re.match(r'^(obl(?::arg)?|nmod):(по)(?::(?:nom|gen|voc|ins))?$', edep['deprel'])
                 if m:
                     adpcase = self.copy_case_from_adposition(node, m.group(2))

From 8d0caaea2a7c491ee5787d090e612822da0d2295 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 11 Apr 2022 22:57:47 +0200
Subject: [PATCH 0550/1374] Fixed Russian edeprels.

---
 udapi/block/ud/ru/fixedeprels.py | 32 +++++++++++++++++++-------------
 1 file changed, 19 insertions(+), 13 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index fd24be5a..4e4892e4 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -12,19 +12,20 @@ class FixEdeprels(Block):
     # by all the inner cases.
     # The list in the value contains exceptions that should be left intact.
     outermost = {
-        'будто':   [],
-        'ведь':    [],
-        'если':    [],
-        'как':     ['как_только'],
-        'нежели':  [],
-        'плюс':    [],
-        'пусть':   [],
-        'раз':     [],
-        'словно':  [],
-        'так_что': [],
-        'хоть':    [],
-        'чем':     [],
-        'что':     []
+        'более_чем': [],
+        'будто':     [],
+        'ведь':      [],
+        'если':      [],
+        'как':       ['как_только'],
+        'нежели':    [],
+        'плюс':      [],
+        'пусть':     [],
+        'раз':       [],
+        'словно':    [],
+        'так_что':   [],
+        'хоть':      [],
+        'чем':       [],
+        'что':       []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -33,6 +34,7 @@ class FixEdeprels(Block):
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
+        'loc':              'в:loc',
         'в_вид':            'в_виде:gen',
         'в_качество':       'в_качестве:gen',
         'в_отношение':      'в_отношении:gen',
@@ -40,9 +42,11 @@ class FixEdeprels(Block):
         'в_случай_если':    'в_случае_если',
         'в_соответствие_с': 'в_соответствии_с:ins',
         'в_течение':        'в_течение:gen',
+        'в_тот_время_как':  'в_то_время_как',
         'в_ход':            'в_ходе:gen',
         'во_глава':         'во_главе_с:ins',
         'во_глава_с':       'во_главе_с:ins',
+        'во_избежание':     'во_избежание:gen',
         'возле':            'возле:gen',
         'вплоть_до':        'вплоть_до:gen',
         'вроде':            'вроде:gen',
@@ -65,6 +69,8 @@ class FixEdeprels(Block):
         'порядка':          'порядка:gen',
         'после':            'после:gen',
         'при_помощь':       'при_помощи:gen',
+        'при_условие_что':  'при_условии_что',
+        'против':           'против:gen',
         'с_помощь':         'с_помощью:gen',
         'с_тот_пора_как':   'с_тех_пор_как',
         'свыше':            'свыше:gen',

From fdaa4480ac29eba170ba66f8bc6916f1805044bc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 12 Apr 2022 12:25:38 +0200
Subject: [PATCH 0551/1374] Fixed Russian edeprels.

---
 udapi/block/ud/ru/fixedeprels.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 4e4892e4..b243ed0b 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -24,6 +24,7 @@ class FixEdeprels(Block):
         'словно':    [],
         'так_что':   [],
         'хоть':      [],
+        'хотя':      [],
         'чем':       [],
         'что':       []
     }
@@ -44,19 +45,23 @@ class FixEdeprels(Block):
         'в_течение':        'в_течение:gen',
         'в_тот_время_как':  'в_то_время_как',
         'в_ход':            'в_ходе:gen',
+        'вместо':           'вместо:gen',
         'во_глава':         'во_главе_с:ins',
         'во_глава_с':       'во_главе_с:ins',
         'во_избежание':     'во_избежание:gen',
         'возле':            'возле:gen',
         'вплоть_до':        'вплоть_до:gen',
         'вроде':            'вроде:gen',
+        'выше':             'выше:gen',
         'для':              'для:gen',
         'до':               'до:gen',
         'до_то_как':        'до:gen', # до того, как ...
         'за_исключение':    'за_исключением:gen',
         'из':               'из:gen',
         'к':                'к:dat',
+        'ко':               'ко:dat',
         'несмотря_на':      'несмотря_на:acc',
+        'ниже':             'ниже:gen',
         'около':            'около:gen',
         'от':               'от:gen',
         'относительно':     'относительно:gen',
@@ -106,6 +111,10 @@ def process_node(self, node):
             if m:
                 bdeprel = m.group(1)
                 solved = False
+                # If the marker is 'быть', discard it. It represents the phrase 'то есть', which should not be analyzed as introducing a subordinate clause.
+                edep['deprel'] = re.sub(r':быть.*', '', edep['deprel'])
+                # Some markers should be discarded only if they occur as clause markers (acl, advcl).
+                edep['deprel'] = re.sub(r'^(advcl|acl(?::relcl)?):(в|вместо|при)$', r'\1', edep['deprel'])
                 # If the case marker starts with 'столько', remove this part.
                 # It occurs in the expressions of the type 'сколько...столько' but the real case marker of the modifier is something else.
                 # Similarly, 'то' occurs in 'то...то' and should be removed.

From 0bc4776db98d580fe41e8a01d167726018761510 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 12 Apr 2022 15:02:00 +0200
Subject: [PATCH 0552/1374] Bug fix.

---
 udapi/block/ud/ru/fixedeprels.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index b243ed0b..f3d9c4ea 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -190,7 +190,7 @@ def process_node(self, node):
                         edep['deprel'] = m.group(1)+':'+adpcase
                     else:
                         # Genitive or instrumental are possible. Pick instrumental.
-                        edep['deprel'] = m.group(1)+':'+m.group(2)+':acc'
+                        edep['deprel'] = m.group(1)+':'+m.group(2)+':ins'
                     continue
             if re.match(r'^(nmod|obl):', edep['deprel']):
                 if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':

From 96e7265547073a4f2bce83699afd1b45ebab45de Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 12 Apr 2022 21:16:22 +0200
Subject: [PATCH 0553/1374] =?UTF-8?q?"=D1=81=D1=82=D0=BE=D0=BB=D1=8C=D0=BA?=
 =?UTF-8?q?=D0=BE"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ru/fixedeprels.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index f3d9c4ea..3ed1d91e 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -112,7 +112,7 @@ def process_node(self, node):
                 bdeprel = m.group(1)
                 solved = False
                 # If the marker is 'быть', discard it. It represents the phrase 'то есть', which should not be analyzed as introducing a subordinate clause.
-                edep['deprel'] = re.sub(r':быть.*', '', edep['deprel'])
+                edep['deprel'] = re.sub(r':(быть|столько).*', '', edep['deprel'])
                 # Some markers should be discarded only if they occur as clause markers (acl, advcl).
                 edep['deprel'] = re.sub(r'^(advcl|acl(?::relcl)?):(в|вместо|при)$', r'\1', edep['deprel'])
                 # If the case marker starts with 'столько', remove this part.

From 5c0271d2e0cd204e6a3ac1a45eef30c2c82a7a31 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 13 Apr 2022 08:31:25 +0200
Subject: [PATCH 0554/1374] Fixed Russian edeprels.

---
 udapi/block/ud/ru/fixedeprels.py | 41 +++++++++++++++++++-------------
 1 file changed, 24 insertions(+), 17 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 3ed1d91e..bdd4aa9b 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -12,21 +12,23 @@ class FixEdeprels(Block):
     # by all the inner cases.
     # The list in the value contains exceptions that should be left intact.
     outermost = {
-        'более_чем': [],
-        'будто':     [],
-        'ведь':      [],
-        'если':      [],
-        'как':       ['как_только'],
-        'нежели':    [],
-        'плюс':      [],
-        'пусть':     [],
-        'раз':       [],
-        'словно':    [],
-        'так_что':   [],
-        'хоть':      [],
-        'хотя':      [],
-        'чем':       [],
-        'что':       []
+        'более_чем':  [],
+        'будто':      [],
+        'ведь':       [],
+        'если':       [],
+        'как':        ['как_только'],
+        'когда':      [],
+        'нежели':     [],
+        'плюс':       [],
+        'потому_что': [],
+        'пусть':      [],
+        'раз':        [],
+        'словно':     [],
+        'так_что':    [],
+        'хоть':       [],
+        'хотя':       [],
+        'чем':        [],
+        'что':        []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -45,11 +47,13 @@ class FixEdeprels(Block):
         'в_течение':        'в_течение:gen',
         'в_тот_время_как':  'в_то_время_как',
         'в_ход':            'в_ходе:gen',
+        'вблизи':           'вблизи:gen',
         'вместо':           'вместо:gen',
         'во_глава':         'во_главе_с:ins',
         'во_глава_с':       'во_главе_с:ins',
         'во_избежание':     'во_избежание:gen',
         'возле':            'возле:gen',
+        'вокруг':           'вокруг:gen',
         'вплоть_до':        'вплоть_до:gen',
         'вроде':            'вроде:gen',
         'выше':             'выше:gen',
@@ -60,6 +64,7 @@ class FixEdeprels(Block):
         'из':               'из:gen',
         'к':                'к:dat',
         'ко':               'ко:dat',
+        'кроме':            'кроме:gen',
         'несмотря_на':      'несмотря_на:acc',
         'ниже':             'ниже:gen',
         'около':            'около:gen',
@@ -73,8 +78,10 @@ class FixEdeprels(Block):
         'помимо':           'помимо:gen',
         'порядка':          'порядка:gen',
         'после':            'после:gen',
+        'при':              'при:loc',
         'при_помощь':       'при_помощи:gen',
         'при_условие_что':  'при_условии_что',
+        'про':              'про:acc',
         'против':           'против:gen',
         'с_помощь':         'с_помощью:gen',
         'с_тот_пора_как':   'с_тех_пор_как',
@@ -147,7 +154,7 @@ def process_node(self, node):
                 # Both "на" and "в" also occur with genitive. However, this
                 # is only because there are numerals in the phrase ("в 9 случаев из 10")
                 # and the whole phrase should not be analyzed as genitive.
-                m = re.match(r'^(obl(?::arg)?|nmod):(в|на|о)(?::(?:nom|gen|dat|voc|ins))?$', edep['deprel'])
+                m = re.match(r'^(obl(?::arg)?|nmod):(в|во|на|о)(?::(?:nom|gen|dat|voc|ins))?$', edep['deprel'])
                 if m:
                     adpcase = self.copy_case_from_adposition(node, m.group(2))
                     if adpcase:
@@ -156,7 +163,7 @@ def process_node(self, node):
                         # Accusative or locative are possible. Pick locative.
                         edep['deprel'] = m.group(1)+':'+m.group(2)+':loc'
                     continue
-                m = re.match(r'^(obl(?::arg)?|nmod):(за|под)(?::(?:nom|gen|dat|voc|loc))?$', edep['deprel'])
+                m = re.match(r'^(obl(?::arg)?|nmod):(за|над|под)(?::(?:nom|gen|dat|voc|loc))?$', edep['deprel'])
                 if m:
                     adpcase = self.copy_case_from_adposition(node, m.group(2))
                     if adpcase:

From bde48872deeeae30b9f797974e30eb67211f9dbc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 13 Apr 2022 08:45:05 +0200
Subject: [PATCH 0555/1374] =?UTF-8?q?Russian=20"=D0=BD=D0=B0=D0=B4"=20does?=
 =?UTF-8?q?=20not=20seem=20to=20allow=20accusative.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ru/fixedeprels.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index bdd4aa9b..887b5e58 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -65,6 +65,7 @@ class FixEdeprels(Block):
         'к':                'к:dat',
         'ко':               'ко:dat',
         'кроме':            'кроме:gen',
+        'над':              'над:ins', # at least I have not encountered any genuine example of accusative
         'несмотря_на':      'несмотря_на:acc',
         'ниже':             'ниже:gen',
         'около':            'около:gen',
@@ -163,7 +164,8 @@ def process_node(self, node):
                         # Accusative or locative are possible. Pick locative.
                         edep['deprel'] = m.group(1)+':'+m.group(2)+':loc'
                     continue
-                m = re.match(r'^(obl(?::arg)?|nmod):(за|над|под)(?::(?:nom|gen|dat|voc|loc))?$', edep['deprel'])
+                # Unlike in Czech, 'над' seems to allow only instrumental and not accusative.
+                m = re.match(r'^(obl(?::arg)?|nmod):(за|под)(?::(?:nom|gen|dat|voc|loc))?$', edep['deprel'])
                 if m:
                     adpcase = self.copy_case_from_adposition(node, m.group(2))
                     if adpcase:

From 322695329bd8426045bae49298a00b9e0179fe66 Mon Sep 17 00:00:00 2001
From: Mehmet Oguz Derin <mehmetoguzderin@mehmetoguzderin.com>
Date: Tue, 19 Apr 2022 14:24:28 +0300
Subject: [PATCH 0556/1374] Fix a tiny typo (#105)

fix documentation of shift_before_node
---
 udapi/core/node.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 732ef7f4..ad36aa0a 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -622,7 +622,7 @@ def shift_after_node(self, reference_node, without_children=False, skip_if_desce
         self._shift_before_ord(reference_node._ord + 1, without_children=without_children)
 
     def shift_before_node(self, reference_node, without_children=False, skip_if_descendant=False):
-        """Shift this node after the reference_node."""
+        """Shift this node before the reference_node."""
         if not without_children and reference_node.is_descendant_of(self):
             if skip_if_descendant:
                 return

From 87003818c9f906415a402d1f67caf601f6c5380c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 20 Apr 2022 21:19:32 +0200
Subject: [PATCH 0557/1374] Added a block to fix spurious Spanish auxiliary
 "tener que".

---
 udapi/block/ud/es/fixtenerque.py | 33 ++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 udapi/block/ud/es/fixtenerque.py

diff --git a/udapi/block/ud/es/fixtenerque.py b/udapi/block/ud/es/fixtenerque.py
new file mode 100644
index 00000000..bce0b731
--- /dev/null
+++ b/udapi/block/ud/es/fixtenerque.py
@@ -0,0 +1,33 @@
+"""Block to fix spurious auxiliary verbs in UD Spanish-AnCora."""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixTenerQue(Block):
+
+    def process_node(self, node):
+        """
+        Some Spanish treebanks treat the verb 'tener' in constructions such as
+        'tener que comer' as auxiliary. This is wrong and the validator will
+        flag it as an error. This block fixes such annotations.
+        """
+        if node.lemma == 'tener' and node.upos == 'AUX':
+            node.upos = 'VERB'
+            # In rare cases the auxiliary may have been promoted due to ellipsis.
+            # Most of the time however, it is attached as 'aux' to the main verb.
+            if node.udeprel == 'aux':
+                mainverb = node.parent
+                node.parent = mainverb.parent
+                node.deprel = mainverb.deprel
+                mainverb.parent = node
+                mainverb.deprel = 'xcomp'
+                # Some children of the former main verb should be reattached to 'tener'.
+                # Others (especially a direct object) should stay with the former main verb.
+                for c in mainverb.children:
+                    if not re.match(r'^(obj|iobj|obl|conj|list|flat|fixed|goeswith|reparandum)$', c.udeprel):
+                        c.parent = node
+                # On the other hand, the conjunction 'que' may have been wrongly attached as 'fixed' to 'tener'.
+                for c in node.children:
+                    if c.form.lower() eq 'que' and c.ord > node.ord and c.ord < mainverb.ord:
+                        c.parent = mainverb
+                        c.deprel = 'mark'

From 41e22c90061454851e8170b7f2b7217dda1b95aa Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 20 Apr 2022 21:22:21 +0200
Subject: [PATCH 0558/1374] Bug fix.

---
 udapi/block/ud/es/fixtenerque.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/es/fixtenerque.py b/udapi/block/ud/es/fixtenerque.py
index bce0b731..ba6691c2 100644
--- a/udapi/block/ud/es/fixtenerque.py
+++ b/udapi/block/ud/es/fixtenerque.py
@@ -28,6 +28,6 @@ def process_node(self, node):
                         c.parent = node
                 # On the other hand, the conjunction 'que' may have been wrongly attached as 'fixed' to 'tener'.
                 for c in node.children:
-                    if c.form.lower() eq 'que' and c.ord > node.ord and c.ord < mainverb.ord:
+                    if c.form.lower() == 'que' and c.ord > node.ord and c.ord < mainverb.ord:
                         c.parent = mainverb
                         c.deprel = 'mark'

From 738980ec8820a6429235243eed2266cf27e17089 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 20 Apr 2022 21:38:13 +0200
Subject: [PATCH 0559/1374] Refined the reattachment so that it is mirrored in
 the enhanced graph.

---
 udapi/block/ud/es/fixtenerque.py | 26 +++++++++++++++++++-------
 1 file changed, 19 insertions(+), 7 deletions(-)

diff --git a/udapi/block/ud/es/fixtenerque.py b/udapi/block/ud/es/fixtenerque.py
index ba6691c2..f287051c 100644
--- a/udapi/block/ud/es/fixtenerque.py
+++ b/udapi/block/ud/es/fixtenerque.py
@@ -17,17 +17,29 @@ def process_node(self, node):
             # Most of the time however, it is attached as 'aux' to the main verb.
             if node.udeprel == 'aux':
                 mainverb = node.parent
-                node.parent = mainverb.parent
-                node.deprel = mainverb.deprel
-                mainverb.parent = node
-                mainverb.deprel = 'xcomp'
+                self.reattach(node, mainverb.parent, mainverb.deprel)
+                self.reattach(mainverb, node, 'xcomp')
                 # Some children of the former main verb should be reattached to 'tener'.
                 # Others (especially a direct object) should stay with the former main verb.
                 for c in mainverb.children:
                     if not re.match(r'^(obj|iobj|obl|conj|list|flat|fixed|goeswith|reparandum)$', c.udeprel):
-                        c.parent = node
+                        self.reattach(c, node, c.deprel)
                 # On the other hand, the conjunction 'que' may have been wrongly attached as 'fixed' to 'tener'.
                 for c in node.children:
                     if c.form.lower() == 'que' and c.ord > node.ord and c.ord < mainverb.ord:
-                        c.parent = mainverb
-                        c.deprel = 'mark'
+                        self.reattach(c, mainverb, 'mark')
+
+    def reattach(self, node, parent, deprel):
+        """
+        Changes the incoming dependency relation to a node. Makes sure that the
+        same change is done in the basic tree and in the enhanced graph.
+        """
+        if node.deps:
+            # If the enhanced graph contains the current basic relation, remove it.
+            orig_n_deps = len(node.deps)
+            node.deps = [x for x in node.deps if x['parent'] != node.parent or re.sub(r':.*', '', x['deprel']) != node.udeprel]
+            # Add the new basic relation to the enhanced graph only if the original one was there.
+            if len(node.deps) < orig_n_deps:
+                node.deps.append({'parent': parent, 'deprel': deprel})
+        node.parent = parent
+        node.deprel = deprel

From d2212f7854efad2337d11a94019bb97cd627d73c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 20 Apr 2022 22:06:32 +0200
Subject: [PATCH 0560/1374] Fix: "tener que" and "ir a" both analyzed as xcomp
 rather than aux.

---
 udapi/block/ud/es/fixtenerque.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/es/fixtenerque.py b/udapi/block/ud/es/fixtenerque.py
index f287051c..5fc4c11e 100644
--- a/udapi/block/ud/es/fixtenerque.py
+++ b/udapi/block/ud/es/fixtenerque.py
@@ -10,8 +10,10 @@ def process_node(self, node):
         Some Spanish treebanks treat the verb 'tener' in constructions such as
         'tener que comer' as auxiliary. This is wrong and the validator will
         flag it as an error. This block fixes such annotations.
+
+        EDIT: 'ir a comer' is processed the same way.
         """
-        if node.lemma == 'tener' and node.upos == 'AUX':
+        if re.match(r'^(tener|ir)$', node.lemma) and node.upos == 'AUX':
             node.upos = 'VERB'
             # In rare cases the auxiliary may have been promoted due to ellipsis.
             # Most of the time however, it is attached as 'aux' to the main verb.
@@ -26,7 +28,7 @@ def process_node(self, node):
                         self.reattach(c, node, c.deprel)
                 # On the other hand, the conjunction 'que' may have been wrongly attached as 'fixed' to 'tener'.
                 for c in node.children:
-                    if c.form.lower() == 'que' and c.ord > node.ord and c.ord < mainverb.ord:
+                    if re.match(r'^(que|a)$', c.form.lower()) and c.ord > node.ord and c.ord < mainverb.ord:
                         self.reattach(c, mainverb, 'mark')
 
     def reattach(self, node, parent, deprel):

From 3ed1fecf434a0dc19c0777195d9b2b020d1d8d13 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 20 Apr 2022 23:16:42 +0200
Subject: [PATCH 0561/1374] Refined list of deprels of children that should not
 be re-attached.

---
 udapi/block/ud/es/fixtenerque.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/es/fixtenerque.py b/udapi/block/ud/es/fixtenerque.py
index 5fc4c11e..62fa0f4d 100644
--- a/udapi/block/ud/es/fixtenerque.py
+++ b/udapi/block/ud/es/fixtenerque.py
@@ -24,7 +24,7 @@ def process_node(self, node):
                 # Some children of the former main verb should be reattached to 'tener'.
                 # Others (especially a direct object) should stay with the former main verb.
                 for c in mainverb.children:
-                    if not re.match(r'^(obj|iobj|obl|conj|list|flat|fixed|goeswith|reparandum)$', c.udeprel):
+                    if not re.match(r'^(obj|iobj|obl|ccomp|xcomp|conj|list|compound|flat|fixed|goeswith|reparandum)$', c.udeprel):
                         self.reattach(c, node, c.deprel)
                 # On the other hand, the conjunction 'que' may have been wrongly attached as 'fixed' to 'tener'.
                 for c in node.children:

From 74c0a91d1f2a3b3a7d56f54a33b98658831eff70 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 21 Apr 2022 14:11:09 +0200
Subject: [PATCH 0562/1374] A new block to fill out obvious lemma candidates,
 based on features!

---
 udapi/block/ud/lemmatize.py | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 udapi/block/ud/lemmatize.py

diff --git a/udapi/block/ud/lemmatize.py b/udapi/block/ud/lemmatize.py
new file mode 100644
index 00000000..49aa5fbf
--- /dev/null
+++ b/udapi/block/ud/lemmatize.py
@@ -0,0 +1,36 @@
+"""Block to add missing lemmas in cases where it seems obvious what the lemma should be."""
+from udapi.core.block import Block
+import logging
+import re
+
+class Lemmatize(Block):
+
+    def process_node(self, node):
+        """
+        Some treebanks lack lemmas for some or all words. Occasionally we may be
+        able to guess that the lemma is identical to the word form. This block
+        will then fill out the lemma.
+
+        For some parts of speech, we can only say that the form is the lemma if
+        we have morphological features that will confirm it is the right form.
+        """
+        if node.lemma == '' or node.lemma == '_' and node.form != '_' and node.feats['Typo'] != 'Yes':
+            # Many closed classes do not inflect and have the same lemma as the form (just lowercased).
+            if re.match(r'^(PUNCT|SYM|ADV|ADP|CCONJ|SCONJ|PART|INTJ|X)$', node.upos):
+                node.lemma = node.form.lower()
+            # NOUN PROPN ADJ PRON DET NUM VERB AUX
+            # VERB and AUX: use the infinitive
+            elif re.match(r'^(VERB|AUX)$', node.upos) and node.feats['VerbForm'] == 'Inf':
+                node.lemma = node.form.lower()
+            # NOUN and PROPN: use singular nominative (but do not lowercase for PROPN)
+            # Note: This rule is wrong in German, where no nouns should be lowercased.
+            elif re.match(r'^(NOUN)$', node.upos) and re.match(r'^(Sing)?$', node.feats['Number']) and re.match(r'^(Nom)?$', node.feats['Case']):
+                node.lemma = node.form.lower()
+            elif re.match(r'^(PROPN)$', node.upos) and re.match(r'^(Sing)?$', node.feats['Number']) and re.match(r'^(Nom)?$', node.feats['Case']):
+                node.lemma = node.form
+            # ADJ, PRON, DET: use masculine singular nominative (pronouns: each person has its own lemma)
+            elif re.match(r'^(ADJ|PRON|DET)$', node.upos) and re.match(r'^(Masc)?$', node.feats['Gender']) and re.match(r'^(Sing)?$', node.feats['Number']) and re.match(r'^(Nom)?$', node.feats['Case']):
+                node.lemma = node.form.lower()
+            # NUM: use masculine nominative (number, if present at all, is lexical)
+            elif re.match(r'^(NUM)$', node.upos) and re.match(r'^(Masc)?$', node.feats['Gender']) and re.match(r'^(Nom)?$', node.feats['Case']):
+                node.lemma = node.form.lower()

From b0b483d7fb699b6f1049ae796e697142288dbff5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 21 Apr 2022 14:18:06 +0200
Subject: [PATCH 0563/1374] Polarity and degree.

---
 udapi/block/ud/lemmatize.py | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/lemmatize.py b/udapi/block/ud/lemmatize.py
index 49aa5fbf..a234256f 100644
--- a/udapi/block/ud/lemmatize.py
+++ b/udapi/block/ud/lemmatize.py
@@ -16,18 +16,24 @@ def process_node(self, node):
         """
         if node.lemma == '' or node.lemma == '_' and node.form != '_' and node.feats['Typo'] != 'Yes':
             # Many closed classes do not inflect and have the same lemma as the form (just lowercased).
-            if re.match(r'^(PUNCT|SYM|ADV|ADP|CCONJ|SCONJ|PART|INTJ|X)$', node.upos):
+            if re.match(r'^(PUNCT|SYM|ADP|CCONJ|SCONJ|PART|INTJ|X)$', node.upos):
+                node.lemma = node.form.lower()
+            # NOUN PROPN ADJ PRON DET NUM VERB AUX ADV
+            # ADV: use positive affirmative
+            elif re.match(r'^(ADV)$', node.upos) and re.match(r'^(Pos)?$', node.feats['Degree']) and re.match(r'^(Pos)?$', node.feats['Polarity']):
                 node.lemma = node.form.lower()
-            # NOUN PROPN ADJ PRON DET NUM VERB AUX
             # VERB and AUX: use the infinitive
-            elif re.match(r'^(VERB|AUX)$', node.upos) and node.feats['VerbForm'] == 'Inf':
+            elif re.match(r'^(VERB|AUX)$', node.upos) and node.feats['VerbForm'] == 'Inf' and re.match(r'^(Pos)?$', node.feats['Polarity']):
                 node.lemma = node.form.lower()
             # NOUN and PROPN: use singular nominative (but do not lowercase for PROPN)
             # Note: This rule is wrong in German, where no nouns should be lowercased.
-            elif re.match(r'^(NOUN)$', node.upos) and re.match(r'^(Sing)?$', node.feats['Number']) and re.match(r'^(Nom)?$', node.feats['Case']):
+            elif re.match(r'^(NOUN)$', node.upos) and re.match(r'^(Sing)?$', node.feats['Number']) and re.match(r'^(Nom)?$', node.feats['Case']) and re.match(r'^(Pos)?$', node.feats['Polarity']):
                 node.lemma = node.form.lower()
-            elif re.match(r'^(PROPN)$', node.upos) and re.match(r'^(Sing)?$', node.feats['Number']) and re.match(r'^(Nom)?$', node.feats['Case']):
+            elif re.match(r'^(PROPN)$', node.upos) and re.match(r'^(Sing)?$', node.feats['Number']) and re.match(r'^(Nom)?$', node.feats['Case']) and re.match(r'^(Pos)?$', node.feats['Polarity']):
                 node.lemma = node.form
+            # ADJ: use masculine singular nominative positive affirmative
+            elif re.match(r'^(ADJ)$', node.upos) and re.match(r'^(Masc)?$', node.feats['Gender']) and re.match(r'^(Sing)?$', node.feats['Number']) and re.match(r'^(Nom)?$', node.feats['Case']) and re.match(r'^(Pos)?$', node.feats['Degree']) and re.match(r'^(Pos)?$', node.feats['Polarity']):
+                node.lemma = node.form.lower()
             # ADJ, PRON, DET: use masculine singular nominative (pronouns: each person has its own lemma)
             elif re.match(r'^(ADJ|PRON|DET)$', node.upos) and re.match(r'^(Masc)?$', node.feats['Gender']) and re.match(r'^(Sing)?$', node.feats['Number']) and re.match(r'^(Nom)?$', node.feats['Case']):
                 node.lemma = node.form.lower()

From 6ee2c9b98a11785fe3c0ef9ab5c074cab4f4dfb6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 22 Apr 2022 09:33:27 +0200
Subject: [PATCH 0564/1374] Added a block to fix features of infinitives in
 Spanish PUD.

---
 udapi/block/ud/es/fixverbfeats.py | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 udapi/block/ud/es/fixverbfeats.py

diff --git a/udapi/block/ud/es/fixverbfeats.py b/udapi/block/ud/es/fixverbfeats.py
new file mode 100644
index 00000000..3972273a
--- /dev/null
+++ b/udapi/block/ud/es/fixverbfeats.py
@@ -0,0 +1,19 @@
+"""Block to fix features (and potentially lemmas) of verbs in UD Spanish-PUD."""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixVerbFeats(Block):
+
+    def process_node(self, node):
+        """
+        The features assigned to verbs in Spanish PUD are often wrong, although
+        the annotation was (reportedly) done manually. For example, infinitives
+        are tagged with VerbForm=Fin instead of VerbForm=Inf.
+        """
+        if re.match(r'^(VERB|AUX)$', node.upos):
+            if re.search(r'[aei]r$', node.form, re.IGNORECASE):
+                # The infinitive has no features other than VerbForm.
+                node.feats = {}
+                node.feats['VerbForm'] = 'Inf'
+                node.lemma = node.form.lower()

From 67334da56f852d1c15c03bad7ab679d3eb63879e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 22 Apr 2022 11:38:34 +0200
Subject: [PATCH 0565/1374] Fix features of gerunds in Spanish.

---
 udapi/block/ud/es/fixverbfeats.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/udapi/block/ud/es/fixverbfeats.py b/udapi/block/ud/es/fixverbfeats.py
index 3972273a..6c924319 100644
--- a/udapi/block/ud/es/fixverbfeats.py
+++ b/udapi/block/ud/es/fixverbfeats.py
@@ -17,3 +17,9 @@ def process_node(self, node):
                 node.feats = {}
                 node.feats['VerbForm'] = 'Inf'
                 node.lemma = node.form.lower()
+            elif re.search(r'ndo$', node.form, re.IGNORECASE):
+                if node.form.lower() != 'entiendo':
+                    # The gerund has no features other than VerbForm.
+                    # The lemma is not always straightforward but we have fixed it manually.
+                    node.feats = {}
+                    node.feats['VerbForm'] = 'Ger'

From fd0f74382c7779d0f22d5ad8b5aef341d91eb0dc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 22 Apr 2022 12:02:23 +0200
Subject: [PATCH 0566/1374] Fix features of participles in Spanish.

---
 udapi/block/ud/es/fixverbfeats.py | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/udapi/block/ud/es/fixverbfeats.py b/udapi/block/ud/es/fixverbfeats.py
index 6c924319..146105a2 100644
--- a/udapi/block/ud/es/fixverbfeats.py
+++ b/udapi/block/ud/es/fixverbfeats.py
@@ -23,3 +23,16 @@ def process_node(self, node):
                     # The lemma is not always straightforward but we have fixed it manually.
                     node.feats = {}
                     node.feats['VerbForm'] = 'Ger'
+            elif re.search(r'(d|biert|dich|fech|hech|muert|puest|vist)[oa]s?$', node.form, re.IGNORECASE):
+                # The (past) participle has always Gender and Number.
+                # It can be VERB/AUX (infinitive is the lemma) or ADJ (masculine singular is the lemma).
+                # As a verb, it also has Tense=Past. As an adjective it does not have this feature (in AnCora; but why not?)
+                gender = node.feats['Gender']
+                number = node.feats['Number']
+                node.feats = {}
+                node.feats['VerbForm'] = 'Part'
+                node.feats['Tense'] = 'Past'
+                node.feats['Gender'] = gender
+                node.feats['Number'] = number
+                if re.search(r'ad[oa]s?$', node.form, re.IGNORECASE):
+                    node.lemma = re.sub(r'd[os]s?$', 'r', node.form.lower())

From 6259fd07eff9ceb90126ab2d3d6f57c0804b6f3a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 22 Apr 2022 12:05:55 +0200
Subject: [PATCH 0567/1374] Guess gender and number if unknown.

---
 udapi/block/ud/es/fixverbfeats.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/es/fixverbfeats.py b/udapi/block/ud/es/fixverbfeats.py
index 146105a2..3282a6eb 100644
--- a/udapi/block/ud/es/fixverbfeats.py
+++ b/udapi/block/ud/es/fixverbfeats.py
@@ -27,8 +27,8 @@ def process_node(self, node):
                 # The (past) participle has always Gender and Number.
                 # It can be VERB/AUX (infinitive is the lemma) or ADJ (masculine singular is the lemma).
                 # As a verb, it also has Tense=Past. As an adjective it does not have this feature (in AnCora; but why not?)
-                gender = node.feats['Gender']
-                number = node.feats['Number']
+                gender = node.feats['Gender'] ? node.feats['Gender'] : re.search(r'os?$', node.form, re.IGNORECASE) ? 'Masc' : 'Fem'
+                number = node.feats['Number'] ? node.feats['Number'] : re.search(r's$', node.form, re.IGNORECASE) ? 'Plur' : 'Sing'
                 node.feats = {}
                 node.feats['VerbForm'] = 'Part'
                 node.feats['Tense'] = 'Past'

From c7ee815eace81fa82c5204023a5105485c847cd3 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 22 Apr 2022 12:08:41 +0200
Subject: [PATCH 0568/1374] Fixed: Python syntax instead of Perl.

---
 udapi/block/ud/es/fixverbfeats.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/es/fixverbfeats.py b/udapi/block/ud/es/fixverbfeats.py
index 3282a6eb..56d6587c 100644
--- a/udapi/block/ud/es/fixverbfeats.py
+++ b/udapi/block/ud/es/fixverbfeats.py
@@ -27,8 +27,8 @@ def process_node(self, node):
                 # The (past) participle has always Gender and Number.
                 # It can be VERB/AUX (infinitive is the lemma) or ADJ (masculine singular is the lemma).
                 # As a verb, it also has Tense=Past. As an adjective it does not have this feature (in AnCora; but why not?)
-                gender = node.feats['Gender'] ? node.feats['Gender'] : re.search(r'os?$', node.form, re.IGNORECASE) ? 'Masc' : 'Fem'
-                number = node.feats['Number'] ? node.feats['Number'] : re.search(r's$', node.form, re.IGNORECASE) ? 'Plur' : 'Sing'
+                gender = node.feats['Gender'] if node.feats['Gender'] else ('Masc' if re.search(r'os?$', node.form, re.IGNORECASE) else 'Fem')
+                number = node.feats['Number'] if node.feats['Number'] else ('Plur' if re.search(r's$', node.form, re.IGNORECASE) else 'Sing')
                 node.feats = {}
                 node.feats['VerbForm'] = 'Part'
                 node.feats['Tense'] = 'Past'

From 0644a490d3e749553855d1b0e6fe60199a33d78c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 22 Apr 2022 12:10:11 +0200
Subject: [PATCH 0569/1374] Bug fix.

---
 udapi/block/ud/es/fixverbfeats.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/es/fixverbfeats.py b/udapi/block/ud/es/fixverbfeats.py
index 56d6587c..6784afde 100644
--- a/udapi/block/ud/es/fixverbfeats.py
+++ b/udapi/block/ud/es/fixverbfeats.py
@@ -35,4 +35,4 @@ def process_node(self, node):
                 node.feats['Gender'] = gender
                 node.feats['Number'] = number
                 if re.search(r'ad[oa]s?$', node.form, re.IGNORECASE):
-                    node.lemma = re.sub(r'd[os]s?$', 'r', node.form.lower())
+                    node.lemma = re.sub(r'd[oa]s?$', 'r', node.form.lower())

From e80b81131c7e3264f0c972bdf4428a3247b2e5e0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 22 Apr 2022 12:12:48 +0200
Subject: [PATCH 0570/1374] Fixed: "da" is not a participle.

---
 udapi/block/ud/es/fixverbfeats.py | 25 +++++++++++++------------
 1 file changed, 13 insertions(+), 12 deletions(-)

diff --git a/udapi/block/ud/es/fixverbfeats.py b/udapi/block/ud/es/fixverbfeats.py
index 6784afde..d6e99aa7 100644
--- a/udapi/block/ud/es/fixverbfeats.py
+++ b/udapi/block/ud/es/fixverbfeats.py
@@ -24,15 +24,16 @@ def process_node(self, node):
                     node.feats = {}
                     node.feats['VerbForm'] = 'Ger'
             elif re.search(r'(d|biert|dich|fech|hech|muert|puest|vist)[oa]s?$', node.form, re.IGNORECASE):
-                # The (past) participle has always Gender and Number.
-                # It can be VERB/AUX (infinitive is the lemma) or ADJ (masculine singular is the lemma).
-                # As a verb, it also has Tense=Past. As an adjective it does not have this feature (in AnCora; but why not?)
-                gender = node.feats['Gender'] if node.feats['Gender'] else ('Masc' if re.search(r'os?$', node.form, re.IGNORECASE) else 'Fem')
-                number = node.feats['Number'] if node.feats['Number'] else ('Plur' if re.search(r's$', node.form, re.IGNORECASE) else 'Sing')
-                node.feats = {}
-                node.feats['VerbForm'] = 'Part'
-                node.feats['Tense'] = 'Past'
-                node.feats['Gender'] = gender
-                node.feats['Number'] = number
-                if re.search(r'ad[oa]s?$', node.form, re.IGNORECASE):
-                    node.lemma = re.sub(r'd[oa]s?$', 'r', node.form.lower())
+                if node.form.lower() != 'da':
+                    # The (past) participle has always Gender and Number.
+                    # It can be VERB/AUX (infinitive is the lemma) or ADJ (masculine singular is the lemma).
+                    # As a verb, it also has Tense=Past. As an adjective it does not have this feature (in AnCora; but why not?)
+                    gender = node.feats['Gender'] if node.feats['Gender'] else ('Masc' if re.search(r'os?$', node.form, re.IGNORECASE) else 'Fem')
+                    number = node.feats['Number'] if node.feats['Number'] else ('Plur' if re.search(r's$', node.form, re.IGNORECASE) else 'Sing')
+                    node.feats = {}
+                    node.feats['VerbForm'] = 'Part'
+                    node.feats['Tense'] = 'Past'
+                    node.feats['Gender'] = gender
+                    node.feats['Number'] = number
+                    if re.search(r'ad[oa]s?$', node.form, re.IGNORECASE):
+                        node.lemma = re.sub(r'd[oa]s?$', 'r', node.form.lower())

From e7dbd6439d765e86322fe106d22d63ee1c3527b8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 22 Apr 2022 12:18:44 +0200
Subject: [PATCH 0571/1374] It must be -ado/-ido (to prevent catching puedo,
 pudo, ayuda, inunda...)

---
 udapi/block/ud/es/fixverbfeats.py | 27 +++++++++++++--------------
 1 file changed, 13 insertions(+), 14 deletions(-)

diff --git a/udapi/block/ud/es/fixverbfeats.py b/udapi/block/ud/es/fixverbfeats.py
index d6e99aa7..643ecd7c 100644
--- a/udapi/block/ud/es/fixverbfeats.py
+++ b/udapi/block/ud/es/fixverbfeats.py
@@ -23,17 +23,16 @@ def process_node(self, node):
                     # The lemma is not always straightforward but we have fixed it manually.
                     node.feats = {}
                     node.feats['VerbForm'] = 'Ger'
-            elif re.search(r'(d|biert|dich|fech|hech|muert|puest|vist)[oa]s?$', node.form, re.IGNORECASE):
-                if node.form.lower() != 'da':
-                    # The (past) participle has always Gender and Number.
-                    # It can be VERB/AUX (infinitive is the lemma) or ADJ (masculine singular is the lemma).
-                    # As a verb, it also has Tense=Past. As an adjective it does not have this feature (in AnCora; but why not?)
-                    gender = node.feats['Gender'] if node.feats['Gender'] else ('Masc' if re.search(r'os?$', node.form, re.IGNORECASE) else 'Fem')
-                    number = node.feats['Number'] if node.feats['Number'] else ('Plur' if re.search(r's$', node.form, re.IGNORECASE) else 'Sing')
-                    node.feats = {}
-                    node.feats['VerbForm'] = 'Part'
-                    node.feats['Tense'] = 'Past'
-                    node.feats['Gender'] = gender
-                    node.feats['Number'] = number
-                    if re.search(r'ad[oa]s?$', node.form, re.IGNORECASE):
-                        node.lemma = re.sub(r'd[oa]s?$', 'r', node.form.lower())
+            elif re.search(r'([ai]d|biert|dich|fech|hech|muert|puest|vist)[oa]s?$', node.form, re.IGNORECASE):
+                # The (past) participle has always Gender and Number.
+                # It can be VERB/AUX (infinitive is the lemma) or ADJ (masculine singular is the lemma).
+                # As a verb, it also has Tense=Past. As an adjective it does not have this feature (in AnCora; but why not?)
+                gender = node.feats['Gender'] if node.feats['Gender'] else ('Masc' if re.search(r'os?$', node.form, re.IGNORECASE) else 'Fem')
+                number = node.feats['Number'] if node.feats['Number'] else ('Plur' if re.search(r's$', node.form, re.IGNORECASE) else 'Sing')
+                node.feats = {}
+                node.feats['VerbForm'] = 'Part'
+                node.feats['Tense'] = 'Past'
+                node.feats['Gender'] = gender
+                node.feats['Number'] = number
+                if re.search(r'ad[oa]s?$', node.form, re.IGNORECASE):
+                    node.lemma = re.sub(r'd[oa]s?$', 'r', node.form.lower())

From de8021fe2616b0eed5f3a425fc51eae57da34483 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 24 Apr 2022 14:26:58 +0200
Subject: [PATCH 0572/1374] =?UTF-8?q?"=D1=80=D0=B0=D0=B2=D0=BD=D0=BE=5F?=
 =?UTF-8?q?=D0=BA=D0=B0=D0=BA"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ru/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 887b5e58..bff1a677 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -22,6 +22,7 @@ class FixEdeprels(Block):
         'плюс':       [],
         'потому_что': [],
         'пусть':      [],
+        'равно_как':  [],
         'раз':        [],
         'словно':     [],
         'так_что':    [],

From 7a2d08f84b8af05b9b40ad92d8b70ca9bd885411 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 24 Apr 2022 17:04:33 +0200
Subject: [PATCH 0573/1374] Fixed some Russian edeprels.

---
 udapi/block/ud/ru/fixedeprels.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index bff1a677..ebf8d213 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -18,6 +18,7 @@ class FixEdeprels(Block):
         'если':       [],
         'как':        ['как_только'],
         'когда':      [],
+        'минус':      [],
         'нежели':     [],
         'плюс':       [],
         'потому_что': [],
@@ -42,11 +43,13 @@ class FixEdeprels(Block):
         'в_вид':            'в_виде:gen',
         'в_качество':       'в_качестве:gen',
         'в_отношение':      'в_отношении:gen',
+        'в_с':              'в:loc', # annotation error: 'в партнерстве с ACCELS' lacks the second level
         'в_связь_с':        'в_связи_с:ins',
         'в_случай_если':    'в_случае_если',
         'в_соответствие_с': 'в_соответствии_с:ins',
         'в_течение':        'в_течение:gen',
         'в_тот_время_как':  'в_то_время_как',
+        'в_угода':          'в_угоду:dat',
         'в_ход':            'в_ходе:gen',
         'вблизи':           'вблизи:gen',
         'вместо':           'вместо:gen',
@@ -72,6 +75,7 @@ class FixEdeprels(Block):
         'около':            'около:gen',
         'от':               'от:gen',
         'относительно':     'относительно:gen',
+        'перед':            'перед:ins',
         'по_мера':          'по_мере:gen',
         'по_мера_то_как':   'по_мере_того_как',
         'по_отношение_ко?': 'по_отношению_к:dat',
@@ -124,6 +128,9 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r':(быть|столько).*', '', edep['deprel'])
                 # Some markers should be discarded only if they occur as clause markers (acl, advcl).
                 edep['deprel'] = re.sub(r'^(advcl|acl(?::relcl)?):(в|вместо|при)$', r'\1', edep['deprel'])
+                # Some markers should not occur as clause markers (acl, advcl) and should be instead considered nominal markers (nmod, obl).
+                edep['deprel'] = re.sub(r'^advcl:перед', r'obl:перед', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl(?::relcl)?):перед', r'nmod:перед', edep['deprel'])
                 # If the case marker starts with 'столько', remove this part.
                 # It occurs in the expressions of the type 'сколько...столько' but the real case marker of the modifier is something else.
                 # Similarly, 'то' occurs in 'то...то' and should be removed.

From b164b5dc65d2c8d71ed1a59867b5033574a99cfe Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 27 Apr 2022 21:37:22 +0200
Subject: [PATCH 0574/1374] Fixed some Russian edeprels.

---
 udapi/block/ud/ru/fixedeprels.py | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index ebf8d213..1946faf0 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -18,9 +18,11 @@ class FixEdeprels(Block):
         'если':       [],
         'как':        ['как_только'],
         'когда':      [],
+        'менее_чем':  [],
         'минус':      [],
         'нежели':     [],
         'плюс':       [],
+        'пока':       [],
         'потому_что': [],
         'пусть':      [],
         'равно_как':  [],
@@ -39,8 +41,10 @@ class FixEdeprels(Block):
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
+        'versus':           'версус:nom',
         'loc':              'в:loc',
         'в_вид':            'в_виде:gen',
+        'в_во_глава':       'в:acc', # annotation error: 'входил в группу во главе с геологом'
         'в_качество':       'в_качестве:gen',
         'в_отношение':      'в_отношении:gen',
         'в_с':              'в:loc', # annotation error: 'в партнерстве с ACCELS' lacks the second level
@@ -52,6 +56,7 @@ class FixEdeprels(Block):
         'в_угода':          'в_угоду:dat',
         'в_ход':            'в_ходе:gen',
         'вблизи':           'вблизи:gen',
+        'взамен':           'взамен:gen',
         'вместо':           'вместо:gen',
         'во_глава':         'во_главе_с:ins',
         'во_глава_с':       'во_главе_с:ins',
@@ -69,7 +74,9 @@ class FixEdeprels(Block):
         'к':                'к:dat',
         'ко':               'ко:dat',
         'кроме':            'кроме:gen',
+        'между_во_глава':   'между:ins', # annotation error: 'между делегацией Минобороны во главе с замминистра Владимиром Исаковым и лидером Приднестровья Игорем Смирновым'
         'над':              'над:ins', # at least I have not encountered any genuine example of accusative
+        'насчет':           'насчет:gen',
         'несмотря_на':      'несмотря_на:acc',
         'ниже':             'ниже:gen',
         'около':            'около:gen',
@@ -84,6 +91,7 @@ class FixEdeprels(Block):
         'помимо':           'помимо:gen',
         'порядка':          'порядка:gen',
         'после':            'после:gen',
+        'посредством_как':  'посредством:gen',
         'при':              'при:loc',
         'при_помощь':       'при_помощи:gen',
         'при_условие_что':  'при_условии_что',
@@ -125,11 +133,11 @@ def process_node(self, node):
                 bdeprel = m.group(1)
                 solved = False
                 # If the marker is 'быть', discard it. It represents the phrase 'то есть', which should not be analyzed as introducing a subordinate clause.
-                edep['deprel'] = re.sub(r':(быть|столько).*', '', edep['deprel'])
+                edep['deprel'] = re.sub(r':(быть|сколь|столько).*', '', edep['deprel'])
                 # Some markers should be discarded only if they occur as clause markers (acl, advcl).
                 edep['deprel'] = re.sub(r'^(advcl|acl(?::relcl)?):(в|вместо|при)$', r'\1', edep['deprel'])
                 # Some markers should not occur as clause markers (acl, advcl) and should be instead considered nominal markers (nmod, obl).
-                edep['deprel'] = re.sub(r'^advcl:перед', r'obl:перед', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:(взамен|на|насчет|перед|по|с|среди)', r'obl:\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl(?::relcl)?):перед', r'nmod:перед', edep['deprel'])
                 # If the case marker starts with 'столько', remove this part.
                 # It occurs in the expressions of the type 'сколько...столько' but the real case marker of the modifier is something else.

From f3b8689bffdccd0cf608423b8f50deaee0419207 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 27 Apr 2022 21:41:06 +0200
Subject: [PATCH 0575/1374] Bug fix.

---
 udapi/block/ud/ru/fixedeprels.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 1946faf0..a6c702f7 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -137,7 +137,7 @@ def process_node(self, node):
                 # Some markers should be discarded only if they occur as clause markers (acl, advcl).
                 edep['deprel'] = re.sub(r'^(advcl|acl(?::relcl)?):(в|вместо|при)$', r'\1', edep['deprel'])
                 # Some markers should not occur as clause markers (acl, advcl) and should be instead considered nominal markers (nmod, obl).
-                edep['deprel'] = re.sub(r'^advcl:(взамен|на|насчет|перед|по|с|среди)', r'obl:\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:(взамен|на|насчет|перед|по|с|среди)(:|$)', r'obl:\1', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl(?::relcl)?):перед', r'nmod:перед', edep['deprel'])
                 # If the case marker starts with 'столько', remove this part.
                 # It occurs in the expressions of the type 'сколько...столько' but the real case marker of the modifier is something else.

From 2001bc041a17b5730f18c422eefe1fa85edf46c2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 27 Apr 2022 22:30:45 +0200
Subject: [PATCH 0576/1374] Fixed some Russian edeprels.

---
 udapi/block/ud/ru/fixedeprels.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index a6c702f7..1fd649d3 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -15,6 +15,7 @@ class FixEdeprels(Block):
         'более_чем':  [],
         'будто':      [],
         'ведь':       [],
+        'ежели':      [],
         'если':       [],
         'как':        ['как_только'],
         'когда':      [],
@@ -45,13 +46,16 @@ class FixEdeprels(Block):
         'loc':              'в:loc',
         'в_вид':            'в_виде:gen',
         'в_во_глава':       'в:acc', # annotation error: 'входил в группу во главе с геологом'
+        'в_для':            'в:acc',
         'в_качество':       'в_качестве:gen',
         'в_отношение':      'в_отношении:gen',
         'в_с':              'в:loc', # annotation error: 'в партнерстве с ACCELS' lacks the second level
         'в_связь_с':        'в_связи_с:ins',
         'в_случай_если':    'в_случае_если',
+        'в_случай_когда':   'в_случае_когда',
         'в_соответствие_с': 'в_соответствии_с:ins',
         'в_течение':        'в_течение:gen',
+        'в_то_быть':        'в:loc',
         'в_тот_время_как':  'в_то_время_как',
         'в_угода':          'в_угоду:dat',
         'в_ход':            'в_ходе:gen',
@@ -67,10 +71,12 @@ class FixEdeprels(Block):
         'вроде':            'вроде:gen',
         'выше':             'выше:gen',
         'для':              'для:gen',
+        'для_в':            'для:gen',
         'до':               'до:gen',
         'до_то_как':        'до:gen', # до того, как ...
         'за_исключение':    'за_исключением:gen',
         'из':               'из:gen',
+        'из_более_чем':     'из:gen',
         'к':                'к:dat',
         'ко':               'ко:dat',
         'кроме':            'кроме:gen',
@@ -103,6 +109,7 @@ class FixEdeprels(Block):
         'со_сторона':       'со_стороны:gen',
         'согласно':         'согласно:dat',
         'спустя':           'спустя:acc',
+        'среди':            'среди:gen',
         'у':                'у:gen',
         'через':            'через:acc',
         'чтоб':             'чтобы'

From fc687fcbc394be78aeb15186402f967b68c10b9e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 27 Apr 2022 22:33:54 +0200
Subject: [PATCH 0577/1374] prevent duplicates in `node.coref_mentions`

fix #106
---
 udapi/core/coref.py            | 2 +-
 udapi/core/tests/test_coref.py | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index ff66c77f..edd297b4 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -642,7 +642,7 @@ def load_coref_from_misc(doc, strict=True):
                             _error(f"Invalid head_idx={head_idx} for {mention.entity.eid} "
                                     f"closed at {node} with words={mention._words}", 1)
                 else:
-                    mention = CorefMention(words=[node], entity=entity)
+                    mention = CorefMention(words=[node], entity=entity, add_word_backlinks=False)
                     if other:
                         mention._other = other
                     if subspan_idx:
diff --git a/udapi/core/tests/test_coref.py b/udapi/core/tests/test_coref.py
index 6142d1f8..369e8caf 100755
--- a/udapi/core/tests/test_coref.py
+++ b/udapi/core/tests/test_coref.py
@@ -17,6 +17,10 @@ def test_load(self):
         coref_entities = docs[-1].coref_entities
         self.assertEqual(len(coref_entities), 1)
         self.assertEqual(coref_entities[0].eid, 'e36781')
+        node = next(docs[-1].nodes)
+        self.assertEqual(len(node.coref_entities), 1)
+        self.assertEqual(len(node.coref_mentions), 1)
+        self.assertEqual(node.coref_entities[0], coref_entities[0])
 
     def test_edits(self):
         data_filename = os.path.join(os.path.dirname(__file__), 'data', 'fr-democrat-dev-sample.conllu')

From 641a8d48526e6e0c7623e78b643e56e3df268efa Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 28 Apr 2022 09:08:34 +0200
Subject: [PATCH 0578/1374] Fixed some Russian edeprels.

---
 udapi/block/ud/ru/fixedeprels.py | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 1fd649d3..7a1d36b2 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -19,11 +19,13 @@ class FixEdeprels(Block):
         'если':       [],
         'как':        ['как_только'],
         'когда':      [],
+        'кроме_как':  [],
         'менее_чем':  [],
         'минус':      [],
         'нежели':     [],
         'плюс':       [],
         'пока':       [],
+        'поскольку':  [],
         'потому_что': [],
         'пусть':      [],
         'равно_как':  [],
@@ -33,7 +35,9 @@ class FixEdeprels(Block):
         'хоть':       [],
         'хотя':       [],
         'чем':        [],
-        'что':        []
+        'что':        [],
+        'чтобы':      [],
+        'яко':        []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -79,14 +83,19 @@ class FixEdeprels(Block):
         'из_более_чем':     'из:gen',
         'к':                'к:dat',
         'ко':               'ко:dat',
+        'коли_скоро':       'коль_скоро',
         'кроме':            'кроме:gen',
         'между_во_глава':   'между:ins', # annotation error: 'между делегацией Минобороны во главе с замминистра Владимиром Исаковым и лидером Приднестровья Игорем Смирновым'
+        'на_вперед':        'на:acc',
         'над':              'над:ins', # at least I have not encountered any genuine example of accusative
         'насчет':           'насчет:gen',
         'несмотря_на':      'несмотря_на:acc',
         'ниже':             'ниже:gen',
         'около':            'около:gen',
         'от':               'от:gen',
+        'от_до':            'от:gen',
+        'от_от':            'от:gen',
+        'от_с':             'от:gen',
         'относительно':     'относительно:gen',
         'перед':            'перед:ins',
         'по_мера':          'по_мере:gen',
@@ -103,14 +112,23 @@ class FixEdeprels(Block):
         'при_условие_что':  'при_условии_что',
         'про':              'про:acc',
         'против':           'против:gen',
+        'с_более_чем':      'с:gen',
+        'с_во_глава':       'с:ins',
+        'с_на':             'с:par',
         'с_помощь':         'с_помощью:gen',
+        'с_тем':            'с:ins',
         'с_тот_пора_как':   'с_тех_пор_как',
+        'с_что':            'с:ins',
         'свыше':            'свыше:gen',
         'со_сторона':       'со_стороны:gen',
         'согласно':         'согласно:dat',
         'спустя':           'спустя:acc',
         'среди':            'среди:gen',
+        'среди_в':          'среди:gen',
+        'так_чтобы':        'чтобы',
+        'тем_между':        'между:ins',
         'у':                'у:gen',
+        'у_без':            'у:gen',
         'через':            'через:acc',
         'чтоб':             'чтобы'
     }
@@ -140,7 +158,7 @@ def process_node(self, node):
                 bdeprel = m.group(1)
                 solved = False
                 # If the marker is 'быть', discard it. It represents the phrase 'то есть', which should not be analyzed as introducing a subordinate clause.
-                edep['deprel'] = re.sub(r':(быть|сколь|столько).*', '', edep['deprel'])
+                edep['deprel'] = re.sub(r':(быть|сколь|столько|типа).*', '', edep['deprel'])
                 # Some markers should be discarded only if they occur as clause markers (acl, advcl).
                 edep['deprel'] = re.sub(r'^(advcl|acl(?::relcl)?):(в|вместо|при)$', r'\1', edep['deprel'])
                 # Some markers should not occur as clause markers (acl, advcl) and should be instead considered nominal markers (nmod, obl).

From a8fea33f756cc83eec4f0ce71d5e1ee912456cbc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 28 Apr 2022 09:18:14 +0200
Subject: [PATCH 0579/1374] Fixed some Russian edeprels.

---
 udapi/block/ud/ru/fixedeprels.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 7a1d36b2..383cdfdd 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -162,8 +162,8 @@ def process_node(self, node):
                 # Some markers should be discarded only if they occur as clause markers (acl, advcl).
                 edep['deprel'] = re.sub(r'^(advcl|acl(?::relcl)?):(в|вместо|при)$', r'\1', edep['deprel'])
                 # Some markers should not occur as clause markers (acl, advcl) and should be instead considered nominal markers (nmod, obl).
-                edep['deprel'] = re.sub(r'^advcl:(взамен|на|насчет|перед|по|с|среди)(:|$)', r'obl:\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl(?::relcl)?):перед', r'nmod:перед', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:(взамен|для|до|на|насчет|от|перед|по|с|среди)(:|$)', r'obl:\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl(?::relcl)?):(взамен|для|до|на|насчет|от|перед|по|с|среди)', r'nmod:\1', edep['deprel'])
                 # If the case marker starts with 'столько', remove this part.
                 # It occurs in the expressions of the type 'сколько...столько' but the real case marker of the modifier is something else.
                 # Similarly, 'то' occurs in 'то...то' and should be removed.

From e938f67739a6633db8624aa110bf386840fcbb7b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 28 Apr 2022 09:21:41 +0200
Subject: [PATCH 0580/1374] Bug fix.

---
 udapi/block/ud/ru/fixedeprels.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 383cdfdd..f7701b0f 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -163,7 +163,7 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^(advcl|acl(?::relcl)?):(в|вместо|при)$', r'\1', edep['deprel'])
                 # Some markers should not occur as clause markers (acl, advcl) and should be instead considered nominal markers (nmod, obl).
                 edep['deprel'] = re.sub(r'^advcl:(взамен|для|до|на|насчет|от|перед|по|с|среди)(:|$)', r'obl:\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl(?::relcl)?):(взамен|для|до|на|насчет|от|перед|по|с|среди)', r'nmod:\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl(?::relcl)?):(взамен|для|до|на|насчет|от|перед|по|с|среди)(:|$)', r'nmod:\1', edep['deprel'])
                 # If the case marker starts with 'столько', remove this part.
                 # It occurs in the expressions of the type 'сколько...столько' but the real case marker of the modifier is something else.
                 # Similarly, 'то' occurs in 'то...то' and should be removed.

From 9da0f2d79e96f20efc9e4980ea66cb05bf4c5ea4 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 28 Apr 2022 09:24:52 +0200
Subject: [PATCH 0581/1374] Bug fix.

---
 udapi/block/ud/ru/fixedeprels.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index f7701b0f..77813cb2 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -162,8 +162,8 @@ def process_node(self, node):
                 # Some markers should be discarded only if they occur as clause markers (acl, advcl).
                 edep['deprel'] = re.sub(r'^(advcl|acl(?::relcl)?):(в|вместо|при)$', r'\1', edep['deprel'])
                 # Some markers should not occur as clause markers (acl, advcl) and should be instead considered nominal markers (nmod, obl).
-                edep['deprel'] = re.sub(r'^advcl:(взамен|для|до|на|насчет|от|перед|по|с|среди)(:|$)', r'obl:\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl(?::relcl)?):(взамен|для|до|на|насчет|от|перед|по|с|среди)(:|$)', r'nmod:\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:(взамен|для|до|на|насчет|от|перед|по|с|среди)(:|$)', r'obl:\1\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl(?::relcl)?):(взамен|для|до|на|насчет|от|перед|по|с|среди)(:|$)', r'nmod:\1\2', edep['deprel'])
                 # If the case marker starts with 'столько', remove this part.
                 # It occurs in the expressions of the type 'сколько...столько' but the real case marker of the modifier is something else.
                 # Similarly, 'то' occurs in 'то...то' and should be removed.

From 8aa69eb0b22941fa1ef52278cdadcaaee35a7823 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 28 Apr 2022 09:29:21 +0200
Subject: [PATCH 0582/1374] Bug fix.

---
 udapi/block/ud/ru/fixedeprels.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 77813cb2..0cb84264 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -163,7 +163,7 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^(advcl|acl(?::relcl)?):(в|вместо|при)$', r'\1', edep['deprel'])
                 # Some markers should not occur as clause markers (acl, advcl) and should be instead considered nominal markers (nmod, obl).
                 edep['deprel'] = re.sub(r'^advcl:(взамен|для|до|на|насчет|от|перед|по|с|среди)(:|$)', r'obl:\1\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl(?::relcl)?):(взамен|для|до|на|насчет|от|перед|по|с|среди)(:|$)', r'nmod:\1\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^acl(?::relcl)?:(взамен|для|до|на|насчет|от|перед|по|с|среди)(:|$)', r'nmod:\1\2', edep['deprel'])
                 # If the case marker starts with 'столько', remove this part.
                 # It occurs in the expressions of the type 'сколько...столько' but the real case marker of the modifier is something else.
                 # Similarly, 'то' occurs in 'то...то' and should be removed.

From 5f81f7ca1c55f44ad1649bfe0ddb660a5402a88c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 28 Apr 2022 09:55:50 +0200
Subject: [PATCH 0583/1374] Fixed some Russian edeprels.

---
 udapi/block/ud/ru/fixedeprels.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 0cb84264..977805c4 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -161,9 +161,10 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r':(быть|сколь|столько|типа).*', '', edep['deprel'])
                 # Some markers should be discarded only if they occur as clause markers (acl, advcl).
                 edep['deprel'] = re.sub(r'^(advcl|acl(?::relcl)?):(в|вместо|при)$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^ccomp:чтобы$', r'ccomp', edep['deprel'])
                 # Some markers should not occur as clause markers (acl, advcl) and should be instead considered nominal markers (nmod, obl).
-                edep['deprel'] = re.sub(r'^advcl:(взамен|для|до|на|насчет|от|перед|по|с|среди)(:|$)', r'obl:\1\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^acl(?::relcl)?:(взамен|для|до|на|насчет|от|перед|по|с|среди)(:|$)', r'nmod:\1\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:(взамен|для|до|из|на|насчет|от|перед|по|после|с|среди|у)(:|$)', r'obl:\1\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^acl(?::relcl)?:(взамен|для|до|из|на|насчет|от|перед|по|после|с|среди|у)(:|$)', r'nmod:\1\2', edep['deprel'])
                 # If the case marker starts with 'столько', remove this part.
                 # It occurs in the expressions of the type 'сколько...столько' but the real case marker of the modifier is something else.
                 # Similarly, 'то' occurs in 'то...то' and should be removed.

From 84e050203be61981fb4f482b32956d2545aa7859 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 28 Apr 2022 10:21:32 +0200
Subject: [PATCH 0584/1374] Bug fix.

---
 udapi/block/ud/ru/fixedeprels.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index 977805c4..d6e99eed 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -153,6 +153,8 @@ def process_node(self, node):
         abbreviation and its morphological case is unknown.
         """
         for edep in node.deps:
+            # Although in theory allowed by the EUD guidelines, Russian does not enhance the ccomp relation with case markers.
+            edep['deprel'] = re.sub(r'^ccomp:чтобы$', r'ccomp', edep['deprel'])
             m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):', edep['deprel'])
             if m:
                 bdeprel = m.group(1)
@@ -161,7 +163,6 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r':(быть|сколь|столько|типа).*', '', edep['deprel'])
                 # Some markers should be discarded only if they occur as clause markers (acl, advcl).
                 edep['deprel'] = re.sub(r'^(advcl|acl(?::relcl)?):(в|вместо|при)$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^ccomp:чтобы$', r'ccomp', edep['deprel'])
                 # Some markers should not occur as clause markers (acl, advcl) and should be instead considered nominal markers (nmod, obl).
                 edep['deprel'] = re.sub(r'^advcl:(взамен|для|до|из|на|насчет|от|перед|по|после|с|среди|у)(:|$)', r'obl:\1\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^acl(?::relcl)?:(взамен|для|до|из|на|насчет|от|перед|по|после|с|среди|у)(:|$)', r'nmod:\1\2', edep['deprel'])
@@ -184,7 +185,7 @@ def process_node(self, node):
                 for x in self.unambiguous:
                     # All secondary prepositions have only one fixed morphological case
                     # they appear with, so we can replace whatever case we encounter with the correct one.
-                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?$', edep['deprel'])
+                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'(?::(?:nom|gen|par|dat|acc|voc|loc|ins))?$', edep['deprel'])
                     if m:
                         edep['deprel'] = m.group(1)+':'+self.unambiguous[x]
                         solved = True

From 2220946afac8a01650e6e0292356fa3e6ff5463a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 28 Apr 2022 10:34:36 +0200
Subject: [PATCH 0585/1374] Bug fix.

---
 udapi/block/ud/ru/fixedeprels.py | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/ru/fixedeprels.py b/udapi/block/ud/ru/fixedeprels.py
index d6e99eed..6fa73460 100644
--- a/udapi/block/ud/ru/fixedeprels.py
+++ b/udapi/block/ud/ru/fixedeprels.py
@@ -76,10 +76,8 @@ class FixEdeprels(Block):
         'выше':             'выше:gen',
         'для':              'для:gen',
         'для_в':            'для:gen',
-        'до':               'до:gen',
         'до_то_как':        'до:gen', # до того, как ...
         'за_исключение':    'за_исключением:gen',
-        'из':               'из:gen',
         'из_более_чем':     'из:gen',
         'к':                'к:dat',
         'ко':               'ко:dat',
@@ -92,7 +90,6 @@ class FixEdeprels(Block):
         'несмотря_на':      'несмотря_на:acc',
         'ниже':             'ниже:gen',
         'около':            'около:gen',
-        'от':               'от:gen',
         'от_до':            'от:gen',
         'от_от':            'от:gen',
         'от_с':             'от:gen',
@@ -193,8 +190,16 @@ def process_node(self, node):
                 if solved:
                     continue
                 # The following prepositions have more than one morphological case
-                # available. Thanks to the Case feature on prepositions, we can
-                # identify the correct one.
+                # available.
+                m = re.match(r'^(obl(?::arg)?|nmod):(до|из|от)(?::(?:nom|dat|acc|voc|loc|ins))?$', edep['deprel'])
+                if m:
+                    adpcase = self.copy_case_from_adposition(node, m.group(2))
+                    if adpcase:
+                        edep['deprel'] = m.group(1)+':'+adpcase
+                    else:
+                        # Genitive or partitive are possible. Pick genitive.
+                        edep['deprel'] = m.group(1)+':'+m.group(2)+':gen'
+                    continue
                 # Both "на" and "в" also occur with genitive. However, this
                 # is only because there are numerals in the phrase ("в 9 случаев из 10")
                 # and the whole phrase should not be analyzed as genitive.

From b6a799c4e0bf82c8add59aa4cf3c64cfd6bedf5f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 13 May 2022 11:03:04 +0200
Subject: [PATCH 0586/1374] A block to fix Russian "to est" from mark to cc.

---
 udapi/block/ud/ru/fixtoest.py | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 udapi/block/ud/ru/fixtoest.py

diff --git a/udapi/block/ud/ru/fixtoest.py b/udapi/block/ud/ru/fixtoest.py
new file mode 100644
index 00000000..1b603e96
--- /dev/null
+++ b/udapi/block/ud/ru/fixtoest.py
@@ -0,0 +1,35 @@
+"""Block to fix annotation of то есть in Russian."""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixToEst(Block):
+
+    def process_node(self, node):
+        """
+        In the converted data from Kira, the fixed expression "то есть" ("that is")
+        is treated as a subordinator and attached as "mark", which later makes it
+        part of complex enhanced relation labels. I believe that this analysis is
+        wrong and that it will be better to label these expressions as "cc".
+        """
+        if node.udeprel == 'mark' and node.lemma == 'то':
+            if len([c for c in node.children if c.udeprel == 'fixed' and c.lemma == 'быть']) > 0:
+                self.set_basic_and_enhanced(node, node.parent, 'cc', 'cc')
+
+    def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
+        '''
+        Modifies the incoming relation of a node both in the basic tree and in
+        the enhanced graph. If the node does not yet depend in the enhanced
+        graph on the current basic parent, the new relation will be added without
+        removing any old one. If the node already depends multiple times on the
+        current basic parent in the enhanced graph, all such enhanced relations
+        will be removed before adding the new one.
+        '''
+        old_parent = node.parent
+        node.parent = parent
+        node.deprel = deprel
+        node.deps = [x for x in node.deps if x['parent'] != old_parent]
+        new_edep = {}
+        new_edep['parent'] = parent
+        new_edep['deprel'] = edeprel
+        node.deps.append(new_edep)

From 4e97deca1849ab559ad3a2e12ca091fac56213df Mon Sep 17 00:00:00 2001
From: Daniel Hershcovich <daniel.hershcovich@gmail.com>
Date: Wed, 18 May 2022 14:27:57 +0200
Subject: [PATCH 0587/1374] Support printing enhanced graphs in Tikz (#107)

---
 udapi/block/write/tikz.py | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/udapi/block/write/tikz.py b/udapi/block/write/tikz.py
index 43417c61..40071739 100644
--- a/udapi/block/write/tikz.py
+++ b/udapi/block/write/tikz.py
@@ -39,7 +39,8 @@ class Tikz(BaseWriter):
     """
 
     def __init__(self, print_sent_id=True, print_text=True, print_preambule=True,
-                 attributes=None, as_tree=False, comment_attribute=None, **kwargs):
+                 attributes=None, as_tree=False, comment_attribute=None,
+                 enhanced=False, **kwargs):
         """Create the Tikz block object.
 
         Args:
@@ -50,6 +51,7 @@ def __init__(self, print_sent_id=True, print_text=True, print_preambule=True,
         attributes: comma-separated list of node attributes to print (each on a separate line).
         as_tree: boolean - should print it as a 2D tree?
         comment_attribute: which attribute to print as a string under each graph (e.g. text_en)
+        enhanced: boolean - print the enhanced graph below the sentence, too?
         """
         super().__init__(**kwargs)
         self.print_sent_id = print_sent_id
@@ -63,6 +65,9 @@ def __init__(self, print_sent_id=True, print_text=True, print_preambule=True,
             self.node_attributes = 'form,upos'.split(',')
         self.as_tree = as_tree
         self.comment_attribute = comment_attribute
+        if as_tree and enhanced:
+            raise ValueError("The enhanced graph cannot be printed as a tree")
+        self.enhanced = enhanced
 
     def before_process_document(self, doc):
         super().before_process_document(doc)
@@ -140,6 +145,12 @@ def process_tree(self, tree):
                     print(r'\deproot{%d}{root}' % node.ord)
                 else:
                     print(r'\depedge{%d}{%d}{%s}' % (node.parent.ord, node.ord, node.deprel))
+                if self.enhanced:
+                    for dep in node.deps:
+                        if dep['parent'].is_root():
+                            print(r'\deproot[edge below]{%d}{root}' % node.ord)
+                        else:
+                            print(r'\depedge[edge below]{%d}{%d}{%s}' % (dep['parent'].ord, node.ord, dep['deprel']))
         if self.comment_attribute and tree.comment:
             start_pos = tree.comment.find(self.comment_attribute + ' = ')
             if start_pos != -1:

From 3688e4cc0be8e324c6ba87c1b96ca2b9e5bd8b16 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 25 May 2022 10:09:26 +0200
Subject: [PATCH 0588/1374] A block to check for Czech-specific bugs in feature
 values.

---
 udapi/block/ud/cs/markfeatsbugs.py | 217 +++++++++++++++++++++++++++++
 1 file changed, 217 insertions(+)
 create mode 100644 udapi/block/ud/cs/markfeatsbugs.py

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
new file mode 100644
index 00000000..b4b6ccfa
--- /dev/null
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -0,0 +1,217 @@
+"""
+Block to identify missing or ill-valued features in Czech. Any bugs that it
+finds will be saved in the MISC column as a Bug attribute, which can be later
+used in filters and highlighted in text output.
+"""
+from udapi.core.block import Block
+import logging
+import re
+
+class MarkFeatsBugs(Block):
+
+    allowed = {
+        'NOUN': {'Gender': ['Masc', 'Fem', 'Neut'],
+                 'Animacy': ['Anim', 'Inan'],
+                 'Number': ['Sing', 'Dual', 'Plur'],
+                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                 'Polarity': ['Pos', 'Neg'],
+                 'Foreign': ['Yes']},
+        'ADJ':  {'Gender': ['Masc', 'Fem', 'Neut'],
+                 'Animacy': ['Anim', 'Inan'],
+                 'Number': ['Sing', 'Dual', 'Plur'],
+                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                 'Degree': ['Pos', 'Cmp', 'Sup'],
+                 'Polarity': ['Pos', 'Neg'],
+                 'Variant': ['Short'],
+                 'Poss': ['Yes'],
+                 'Gender[psor]': ['Masc', 'Fem'],
+                 'NameType': ['Giv', 'Sur'], # for possessive adjectives derived from personal names
+                 'NumType': ['Ord'],
+                 'VerbForm': ['Part'],
+                 'Aspect': ['Imp', 'Perf'],
+                 'Tense': ['Pres', 'Past'],
+                 'Voice': ['Act', 'Pass'],
+                 'Foreign': ['Yes']}
+    }
+
+    required = {
+        'NOUN': ['Gender', 'Number', 'Case', 'Polarity'],
+        'ADJ': ['Gender', 'Number', 'Case', 'Degree', 'Polarity']
+    }
+
+    def bug(self, node, bugstring):
+        bugs = []
+        if node.misc['Bug']:
+            bugs = node.misc['Bug'].split('+')
+        if not bugstring in bugs:
+            bugs.append(bugstring)
+        node.misc['Bug'] = '+'.join(bugs)
+
+    def check_allowed_features(self, node, allowed):
+        """
+        We need a dictionary indexed by feature names that are allowed; for each
+        feature name, there is a list of allowed values.
+        """
+        # Check for features that are not allowed but the node has them.
+        # For features that are allowed, check that their values are allowed.
+        for f in node.feats:
+            if f in allowed:
+                if not node.feats[f] in allowed[f]:
+                    self.bug(node, 'Feat' + f + 'Value' + node.feats[f] + 'NotAllowed')
+            else:
+                self.bug(node, 'Feat' + f + 'NotAllowed')
+
+    def check_required_features(self, node, required):
+        """
+        We need a list of names of features whose values must not be empty.
+        """
+        for f in required:
+            if not f in node.feats:
+                self.bug(node, 'Feat' + f + 'Missing')
+
+    def process_node(self, node):
+        if node.upos == 'NOUN':
+            self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity'])
+            if node.feats['Gender'] == 'Masc':
+                self.check_required_features(node, ['Animacy'])
+                self.check_allowed_features(node, {
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Animacy': ['Anim', 'Inan'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'Polarity': ['Pos', 'Neg'],
+                    'Foreign': ['Yes']})
+            else:
+                self.check_allowed_features(node, {
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'Polarity': ['Pos', 'Neg'],
+                    'Foreign': ['Yes']})
+        elif node.upos == 'PROPN':
+            self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity'])
+            if node.feats['Gender'] == 'Masc':
+                self.check_required_features(node, ['Animacy'])
+                self.check_allowed_features(node, {
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Animacy': ['Anim', 'Inan'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'Polarity': ['Pos', 'Neg'],
+                    'NameType': ['Giv', 'Sur', 'Geo'],
+                    'Foreign': ['Yes']})
+            else:
+                self.check_allowed_features(node, {
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'Polarity': ['Pos', 'Neg'],
+                    'NameType': ['Giv', 'Sur', 'Geo'],
+                    'Foreign': ['Yes']})
+        elif node.upos == 'ADJ':
+            if node.feats['Poss'] == 'Yes': # possessive adjectives
+                if node.feats['Gender'] == 'Masc':
+                    self.check_required_features(node, ['Poss', 'Gender[psor]', 'Gender', 'Animacy', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'Poss': ['Yes'],
+                        'Gender[psor]': ['Masc', 'Fem'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'NameType': ['Giv', 'Sur'], # for possessive adjectives derived from personal names
+                        'Foreign': ['Yes']})
+                else:
+                    self.check_required_features(node, ['Poss', 'Gender[psor]', 'Gender', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'Poss': ['Yes'],
+                        'Gender[psor]': ['Masc', 'Fem'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'NameType': ['Giv', 'Sur'], # for possessive adjectives derived from personal names
+                        'Foreign': ['Yes']})
+            elif node.feats['NumType'] == 'Ord': # ordinal numerals are a subtype of adjectives
+                if node.feats['Gender'] == 'Masc':
+                    self.check_required_features(node, ['NumType', 'Gender', 'Animacy', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'NumType': ['Ord'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Foreign': ['Yes']})
+                else:
+                    self.check_required_features(node, ['NumType', 'Gender', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'NumType': ['Ord'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Foreign': ['Yes']})
+            elif node.feats['VerbForm'] == 'Part': # participles (except l-participles) are a subtype of adjectives
+                if node.feats['Gender'] == 'Masc':
+                    self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'VerbForm': ['Part'],
+                        'Aspect': ['Imp', 'Perf'],
+                        'Voice': ['Act', 'Pass'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Variant': ['Short'],
+                        'Foreign': ['Yes']})
+                else:
+                    self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Number', 'Case', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'VerbForm': ['Part'],
+                        'Aspect': ['Imp', 'Perf'],
+                        'Voice': ['Act', 'Pass'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Variant': ['Short'],
+                        'Foreign': ['Yes']})
+            elif node.feats['Variant'] == 'Short': # short (nominal) forms of adjectives have no degree
+                if node.feats['Gender'] == 'Masc':
+                    self.check_required_features(node, ['Gender', 'Animacy', 'Number', 'Case', 'Polarity', 'Variant'])
+                    self.check_allowed_features(node, {
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Variant': ['Short'],
+                        'Foreign': ['Yes']})
+                else:
+                    self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity', 'Variant'])
+                    self.check_allowed_features(node, {
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Variant': ['Short'],
+                        'Foreign': ['Yes']})
+            else: # regular adjectives
+                if node.feats['Gender'] == 'Masc':
+                    self.check_required_features(node, ['Gender', 'Animacy', 'Number', 'Case', 'Degree', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Degree': ['Pos', 'Cmp', 'Sup'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Foreign': ['Yes']})
+                else:
+                    self.check_required_features(node, ['Gender', 'Number', 'Case', 'Degree', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Degree': ['Pos', 'Cmp', 'Sup'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Foreign': ['Yes']})

From 0116b9c71d603aa7e9111a598dc1fe8f0865a550 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 25 May 2022 16:41:46 +0200
Subject: [PATCH 0589/1374] Rules for features in Czech.

---
 udapi/block/ud/cs/markfeatsbugs.py | 303 ++++++++++++++++++++++++++---
 1 file changed, 279 insertions(+), 24 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index b4b6ccfa..c71ccd0f 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -70,6 +70,7 @@ def check_required_features(self, node, required):
                 self.bug(node, 'Feat' + f + 'Missing')
 
     def process_node(self, node):
+        # NOUNS ################################################################
         if node.upos == 'NOUN':
             self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity'])
             if node.feats['Gender'] == 'Masc':
@@ -88,6 +89,7 @@ def process_node(self, node):
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                     'Polarity': ['Pos', 'Neg'],
                     'Foreign': ['Yes']})
+        # PROPER NOUNS #########################################################
         elif node.upos == 'PROPN':
             self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity'])
             if node.feats['Gender'] == 'Masc':
@@ -108,6 +110,7 @@ def process_node(self, node):
                     'Polarity': ['Pos', 'Neg'],
                     'NameType': ['Giv', 'Sur', 'Geo'],
                     'Foreign': ['Yes']})
+        # ADJECTIVES ###########################################################
         elif node.upos == 'ADJ':
             if node.feats['Poss'] == 'Yes': # possessive adjectives
                 if node.feats['Gender'] == 'Masc':
@@ -150,31 +153,61 @@ def process_node(self, node):
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                         'Foreign': ['Yes']})
             elif node.feats['VerbForm'] == 'Part': # participles (except l-participles) are a subtype of adjectives
-                if node.feats['Gender'] == 'Masc':
-                    self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity'])
-                    self.check_allowed_features(node, {
-                        'VerbForm': ['Part'],
-                        'Aspect': ['Imp', 'Perf'],
-                        'Voice': ['Act', 'Pass'],
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Animacy': ['Anim', 'Inan'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                        'Polarity': ['Pos', 'Neg'],
-                        'Variant': ['Short'],
-                        'Foreign': ['Yes']})
+                self.check_required_features(node, ['VerbForm', 'Voice'])
+                if node.feats['Voice'] == 'Act': # active participles have tense, passives don't
+                    if node.feats['Gender'] == 'Masc':
+                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Tense', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity'])
+                        self.check_allowed_features(node, {
+                            'VerbForm': ['Part'],
+                            'Aspect': ['Imp', 'Perf'],
+                            'Voice': ['Act'],
+                            'Tense': ['Past', 'Pres', 'Fut'], # Fut only for lemma 'boudoucí'
+                            'Gender': ['Masc', 'Fem', 'Neut'],
+                            'Animacy': ['Anim', 'Inan'],
+                            'Number': ['Sing', 'Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                            'Polarity': ['Pos', 'Neg'],
+                            'Variant': ['Short'],
+                            'Foreign': ['Yes']})
+                    else:
+                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Tense', 'Gender', 'Number', 'Case', 'Polarity'])
+                        self.check_allowed_features(node, {
+                            'VerbForm': ['Part'],
+                            'Aspect': ['Imp', 'Perf'],
+                            'Voice': ['Act'],
+                            'Tense': ['Past', 'Pres', 'Fut'], # Fut only for lemma 'boudoucí'
+                            'Gender': ['Masc', 'Fem', 'Neut'],
+                            'Number': ['Sing', 'Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                            'Polarity': ['Pos', 'Neg'],
+                            'Variant': ['Short'],
+                            'Foreign': ['Yes']})
                 else:
-                    self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Number', 'Case', 'Polarity'])
-                    self.check_allowed_features(node, {
-                        'VerbForm': ['Part'],
-                        'Aspect': ['Imp', 'Perf'],
-                        'Voice': ['Act', 'Pass'],
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                        'Polarity': ['Pos', 'Neg'],
-                        'Variant': ['Short'],
-                        'Foreign': ['Yes']})
+                    if node.feats['Gender'] == 'Masc':
+                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity'])
+                        self.check_allowed_features(node, {
+                            'VerbForm': ['Part'],
+                            'Aspect': ['Imp', 'Perf'],
+                            'Voice': ['Pass'],
+                            'Gender': ['Masc', 'Fem', 'Neut'],
+                            'Animacy': ['Anim', 'Inan'],
+                            'Number': ['Sing', 'Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                            'Polarity': ['Pos', 'Neg'],
+                            'Variant': ['Short'],
+                            'Foreign': ['Yes']})
+                    else:
+                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Number', 'Case', 'Polarity'])
+                        self.check_allowed_features(node, {
+                            'VerbForm': ['Part'],
+                            'Aspect': ['Imp', 'Perf'],
+                            'Voice': ['Pass'],
+                            'Gender': ['Masc', 'Fem', 'Neut'],
+                            'Number': ['Sing', 'Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                            'Polarity': ['Pos', 'Neg'],
+                            'Variant': ['Short'],
+                            'Foreign': ['Yes']})
             elif node.feats['Variant'] == 'Short': # short (nominal) forms of adjectives have no degree
                 if node.feats['Gender'] == 'Masc':
                     self.check_required_features(node, ['Gender', 'Animacy', 'Number', 'Case', 'Polarity', 'Variant'])
@@ -215,3 +248,225 @@ def process_node(self, node):
                         'Degree': ['Pos', 'Cmp', 'Sup'],
                         'Polarity': ['Pos', 'Neg'],
                         'Foreign': ['Yes']})
+        # PRONOUNS #############################################################
+        elif node.upos == 'PRON':
+            self.check_required_features(node, ['PronType'])
+            if node.feats['PronType'] == 'Prs':
+                if node.feats['Reflex'] == 'Yes':
+                    self.check_required_features(node, ['PronType', 'Reflex', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Prs'],
+                        'Reflex': ['Yes'],
+                        'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins'],
+                        'Variant': ['Short']
+                    })
+                else: # not reflexive
+                    self.check_required_features(node, ['PronType', 'Person', 'Number', 'Case'])
+                    if node.feats['Person'] == '3':
+                        if re.match(r'^(Nom|Voc)$', node.feats['Case']):
+                            self.check_required_features(node, ['Gender'])
+                            # In PDT, animacy of personal pronouns is distinguished only for Person=3 Case=Nom Gender=Masc Number=Plur ('oni' vs. 'ony').
+                            # So we will neither require nor allow it in singular and dual.
+                            if node.feats['Gender'] == 'Masc' and node.feats['Number'] == 'Plur':
+                                self.check_required_features(node, ['Animacy'])
+                                self.check_allowed_features(node, {
+                                    'PronType': ['Prs'],
+                                    'Person': ['3'],
+                                    'Gender': ['Masc'],
+                                    'Animacy': ['Anim', 'Inan'],
+                                    'Number': ['Plur'],
+                                    'Case': ['Nom', 'Voc']
+                                })
+                            else: # on, ona, ono, ony (Fem Plur)
+                                self.check_allowed_features(node, {
+                                    'PronType': ['Prs'],
+                                    'Person': ['3'],
+                                    'Gender': ['Masc', 'Fem', 'Neut'],
+                                    'Number': ['Sing', 'Dual', 'Plur'],
+                                    'Case': ['Nom', 'Voc']
+                                })
+                        else: # non-nominatives also have PrepCase
+                            # Mostly only two gender groups and no animacy:
+                            # Masc,Neut ... jeho, jemu, jej, něm, jím
+                            # Fem ... jí, ji, ní
+                            # Neut ... je
+                            self.check_required_features(node, ['PrepCase'])
+                            if node.feats['Number'] == 'Sing':
+                                self.check_required_features(node, ['Gender'])
+                                self.check_allowed_features(node, {
+                                    'PronType': ['Prs'],
+                                    'Person': ['3'],
+                                    'Gender': ['Masc,Neut', 'Fem', 'Neut'],
+                                    'Number': ['Sing'],
+                                    'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins'],
+                                    'PrepCase': ['Npr', 'Pre']
+                                })
+                            # No gender in dual and plural:
+                            # Plur ... jich, jim, je, nich, jimi
+                            else:
+                                self.check_allowed_features(node, {
+                                    'PronType': ['Prs'],
+                                    'Person': ['3'],
+                                    'Number': ['Dual', 'Plur'],
+                                    'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins'],
+                                    'PrepCase': ['Npr', 'Pre']
+                                })
+                    else: # 1st and 2nd person do not have gender
+                        self.check_allowed_features(node, {
+                            'PronType': ['Prs'],
+                            'Person': ['1', '2', '3'],
+                            'Number': ['Sing', 'Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                            'Variant': ['Short']
+                        })
+            else: # PronType není Prs
+                # Int,Rel ... kdo, co
+                # Rel ... kdož, což, jenž, ješto, jenžto, an
+                # Ind ... něco
+                # Neg ... nic, nicož
+                # kdo, kdož, někdo, nikdo ... Gender=Masc, Animacy=Anim, Case (but no Number; it could be used in the context of any number)
+                # jehožto, něhožto, jemužto, němužto ... Gender=Masc,Neut (similarly to non-nominative forms of personal pronoun 'on')
+                ###!!! We could make the requirements more precise if we look at the lemma.
+                self.check_required_features(node, ['PronType', 'Case'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Int,Rel', 'Rel', 'Ind', 'Neg'],
+                    'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Neut'],
+                    'Animacy': ['Anim'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'PrepCase': ['Npr', 'Pre']
+                })
+        # DETERMINERS ##########################################################
+        elif node.upos == 'DET':
+            # Possessive determiners 'jeho' and 'jejich' (formerly 'jich') do not inflect, i.e., no Gender, Number, Case.
+            # Note that the possessive determiner 'její' (formerly 'jejie') does inflect, although it also has the lemma 'jeho'.
+            if re.match(r'^(jeho|jejich|jich|jehož|jejichž|jichž|jehožto|jejichžto|jichžto)$', node.form.lower()):
+                self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Prs', 'Rel'],
+                    'Poss': ['Yes'],
+                    'Person': ['3'],
+                    'Number[psor]': ['Sing', 'Dual', 'Plur'],
+                    'Gender[psor]': ['Masc,Neut']
+                })
+            else:
+                # Gender is annotated in all cases in singular, but only in
+                # nominative, accusative (and theoretically vocative) in plural.
+                # Other cases (Gen, Dat, Loc, Ins) are gender-less: 'těch', 'svým', ...
+                # Note that this is not consistent with adjectives, where we
+                # disambiguate gender in all cases in plural.
+                # Same for animacy (which implies masculine gender).
+                self.check_required_features(node, ['PronType', 'Number', 'Case'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Prs', 'Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
+                    'Poss': ['Yes'],
+                    'Reflex': ['Yes'],
+                    'Person': ['1', '2', '3'],
+                    'Number[psor]': ['Sing', 'Dual', 'Plur'],
+                    'Gender[psor]': ['Masc,Neut', 'Fem'],
+                    'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # non-nominative forms of Masc and Neut are merged; Fem,Neut is e.g. 'vaše' in singular
+                    'Animacy': ['Anim', 'Inan'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                })
+        # NUMERALS #############################################################
+        elif node.upos == 'NUM':
+            self.check_required_features(node, ['NumType', 'NumForm'])
+            self.check_allowed_features(node, {
+                'NumType': ['Card'],
+                'NumForm': ['Word', 'Digit', 'Roman'],
+                'NumValue': ['1,2,3'],
+                'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # similarly to determiners, genders are merged in some slots of the paradigm
+                'Animacy': ['Anim', 'Inan'],
+                'Number': ['Sing', 'Dual', 'Plur'],
+                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+            })
+        # VERBS AND AUXILIARIES ################################################
+        elif re.match(r'^(VERB|AUX)$', node.upos):
+            self.check_required_features(node, ['Aspect', 'VerbForm'])
+            if node.feats['VerbForm'] == 'Inf':
+                # There is no voice. For some reason, PDT does not annotate that
+                # the infinitive form is active (while a passive infinitive is
+                # a combination of the infinitive with a passive participle).
+                self.check_required_features(node, ['Polarity'])
+                self.check_allowed_features(node, {
+                    'Aspect': ['Imp', 'Perf'],
+                    'VerbForm': ['Inf'],
+                    'Polarity': ['Pos', 'Neg']
+                })
+            elif node.feats['VerbForm'] == 'Fin':
+                # Voice is optional. For some reason it is not annotated with
+                # imperatives (although passive imperatives are a combination
+                # of the active imperative and a passive participle). It is
+                # also not annotated at the conditional auxiliary 'bych', 'bys', 'by', 'bychom', 'byste'.
+                if node.feats['Mood'] == 'Cnd':
+                    self.check_required_features(node, ['Mood', 'Person'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf'],
+                        'VerbForm': ['Fin'],
+                        'Mood': ['Cnd'],
+                        'Person': ['1', '2', '3'],
+                        'Number': ['Sing', 'Dual', 'Plur'] # optional: it is not annotated in the third person
+                    })
+                elif node.feats['Mood'] == 'Imp':
+                    self.check_required_features(node, ['Mood', 'Person', 'Number', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf'],
+                        'VerbForm': ['Fin'],
+                        'Mood': ['Imp'],
+                        'Person': ['1', '2', '3'], # 3rd person imperative occasionally occurs in old Czech (but the form is identical to 2nd person)
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Polarity': ['Pos', 'Neg']
+                    })
+                else: # indicative
+                    self.check_required_features(node, ['Mood', 'Voice', 'Tense', 'Person', 'Number', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf'],
+                        'VerbForm': ['Fin'],
+                        'Mood': ['Ind'],
+                        'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
+                        'Voice': ['Act'],
+                        'Person': ['1', '2', '3'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Variant': ['Short', 'Long'] # distinguishes sigmatic (Long) and asigmatic (Short) aorist
+                    })
+            elif node.feats['VerbForm'] == 'Part': # only l-participle; the others are ADJ, not VERB
+                self.check_required_features(node, ['Tense', 'Gender', 'Number', 'Voice', 'Polarity'])
+                self.check_allowed_features(node, {
+                    'Aspect': ['Imp', 'Perf'],
+                    'VerbForm': ['Part'],
+                    'Tense': ['Past'],
+                    'Voice': ['Act'], # passive participle is ADJ, so we will not encounter it under VERB
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Animacy': ['Anim', 'Inan'],
+                    'Polarity': ['Pos', 'Neg']
+                })
+            else: # converb
+                self.check_required_features(node, ['Tense', 'Number', 'Voice', 'Polarity'])
+                self.check_allowed_features(node, {
+                    'Aspect': ['Imp', 'Perf'],
+                    'VerbForm': ['Conv'],
+                    'Tense': ['Past', 'Pres'],
+                    'Voice': ['Act'], # passive participle is ADJ, so we will not encounter it under VERB
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Gender': ['Masc', 'Fem', 'Neut'], # annotated only in singular, and no animacy
+                    'Polarity': ['Pos', 'Neg']
+                })
+        # ADVERBS ##############################################################
+        elif node.upos == 'ADV':
+            self.check_allowed_features(node, {
+                'PronType': ['Dem', 'Int,Rel', 'Ind', 'Neg'],
+                'Degree': ['Pos', 'Cmp', 'Sup'],
+                'Polarity': ['Pos', 'Neg']
+            })
+        # ADPOSITIONS ##########################################################
+        elif node.upos == 'ADP':
+            self.check_allowed_features(node, {
+                'AdpType': ['Prep', 'Voc'],
+                'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins']
+            })
+        # THE REST: NO FEATURES ################################################
+        else:
+            self.check_allowed_features(node, {})

From a7c7b145b432a86cd12ac1303cc6daf69fa54a13 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 25 May 2022 21:42:13 +0200
Subject: [PATCH 0590/1374] More precise requirements on features of Czech
 pronouns and determiners.

---
 udapi/block/ud/cs/markfeatsbugs.py | 170 ++++++++++++++++++++++++-----
 1 file changed, 145 insertions(+), 25 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index c71ccd0f..a2c2bb7b 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -319,28 +319,118 @@ def process_node(self, node):
                             'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                             'Variant': ['Short']
                         })
-            else: # PronType není Prs
-                # Int,Rel ... kdo, co
-                # Rel ... kdož, což, jenž, ješto, jenžto, an
-                # Ind ... něco
-                # Neg ... nic, nicož
-                # kdo, kdož, někdo, nikdo ... Gender=Masc, Animacy=Anim, Case (but no Number; it could be used in the context of any number)
-                # jehožto, něhožto, jemužto, němužto ... Gender=Masc,Neut (similarly to non-nominative forms of personal pronoun 'on')
-                ###!!! We could make the requirements more precise if we look at the lemma.
-                self.check_required_features(node, ['PronType', 'Case'])
+            elif re.search(r'k[dt]o', node.lemma): # kdo (kto), kdož, někdo, nikdo
+                # There is no Number. Někdo and nikdo behave like singular;
+                # kdo is by default singular as well but it also occurs as a subject
+                # of plural verbs.
+                self.check_required_features(node, ['PronType', 'Gender', 'Animacy', 'Case'])
                 self.check_allowed_features(node, {
                     'PronType': ['Int,Rel', 'Rel', 'Ind', 'Neg'],
-                    'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Neut'],
+                    'Gender': ['Masc'],
                     'Animacy': ['Anim'],
-                    'Number': ['Sing', 'Dual', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'PrepCase': ['Npr', 'Pre']
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Loc', 'Ins']
+                })
+            elif re.match(r'^(co|což|něco|nicož)$', node.lemma):
+                # Although these pronouns behave by default as neuter singular,
+                # no Gender and Number is annotated. However, quite unusually,
+                # there is Animacy=Inan without Gender.
+                ###!!! This should probably be fixed in all Czech treebanks and
+                ###!!! in Interset. The pronoun should get Gender=Neut and no
+                ###!!! animacy. For now, let's at least make animacy an optional
+                ###!!! feature (I see that we already do not fill it in the Old
+                ###!!! Czech data).
+                self.check_required_features(node, ['PronType', 'Case'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Int,Rel', 'Rel', 'Ind', 'Neg'],
+                    'Animacy': ['Inan'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Loc', 'Ins']
+                })
+            elif node.lemma == 'ješto':
+                # Unlike 'jenžto', this relative pronoun does not inflect, it
+                # always occurs in a nominative position, but the context can
+                # be any gender and number.
+                self.check_required_features(node, ['PronType', 'Case'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Rel'],
+                    'Case': ['Nom']
                 })
+            elif re.match(r'^(jenž|jenžto)$', node.lemma):
+                # The relative pronouns 'jenž', 'jenžto' inflect for gender;
+                # while we normally take this as a sign of DET (instead of PRON),
+                # these can never act as real DET because they never modify a
+                # nominal.
+                # Similarly to the personal pronoun 'on', animacy is only
+                # annotated for masculine nominative plural, non-nominative
+                # forms are merged for masculine and neuter (jehož, jemuž), and
+                # non-singular gender is only annotated in nominative (while
+                # these cases are common for all genders: jichž, jimž, jimiž).
+                # Unlike 'on', 'jenž' has the feature PrepCase everywhere, even
+                # in the nominative, although there is no prepositional counter-
+                # part (but similarly the locative has no prepositionless form).
+                if node.feats['Case'] == 'Nom':
+                    if node.feats['Gender'] == 'Masc' and node.feats['Number'] == 'Plur':
+                        self.check_required_features(node, ['PronType', 'Gender', 'Animacy', 'Number', 'Case', 'PrepCase'])
+                        self.check_allowed_features(node, {
+                            'PronType': ['Rel'],
+                            'Gender': ['Masc'],
+                            'Animacy': ['Anim', 'Inan'],
+                            'Number': ['Plur'],
+                            'Case': ['Nom'],
+                            'PrepCase': ['Npr', 'Pre']
+                        })
+                    else: # not Masc Plur
+                        self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case', 'PrepCase'])
+                        self.check_allowed_features(node, {
+                            'PronType': ['Rel'],
+                            'Gender': ['Masc', 'Fem', 'Neut'],
+                            'Number': ['Sing', 'Dual', 'Plur'],
+                            'Case': ['Nom'],
+                            'PrepCase': ['Npr', 'Pre']
+                        })
+                else: # not Case=Nom
+                    if node.feats['Number'] == 'Sing':
+                        self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case', 'PrepCase'])
+                        self.check_allowed_features(node, {
+                            'PronType': ['Rel'],
+                            'Gender': ['Masc,Neut', 'Fem'],
+                            'Number': ['Sing'],
+                            'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins'],
+                            'PrepCase': ['Npr', 'Pre']
+                        })
+                    else: # non-nominative dual or plural: jichž, nichž, jimž, nimž, jež, něž, jimiž, nimiž
+                        self.check_required_features(node, ['PronType', 'Number', 'Case', 'PrepCase'])
+                        self.check_allowed_features(node, {
+                            'PronType': ['Rel'],
+                            'Number': ['Dual', 'Plur'],
+                            'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins'],
+                            'PrepCase': ['Npr', 'Pre']
+                        })
+            else:
+                # What remains is the relative pronoun 'an'. It behaves similarly
+                # to 'jenž' but it does not have the PrepCase feature and it
+                # only occurs in the nominative.
+                if node.feats['Gender'] == 'Masc' and node.feats['Number'] == 'Plur': # ani
+                    self.check_required_features(node, ['PronType', 'Gender', 'Animacy', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Rel'],
+                        'Gender': ['Masc'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Plur'],
+                        'Case': ['Nom']
+                    })
+                else: # not Masc Plur: an, ana, ano, any
+                    self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Rel'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom']
+                    })
         # DETERMINERS ##########################################################
         elif node.upos == 'DET':
             # Possessive determiners 'jeho' and 'jejich' (formerly 'jich') do not inflect, i.e., no Gender, Number, Case.
             # Note that the possessive determiner 'její' (formerly 'jejie') does inflect, although it also has the lemma 'jeho'.
-            if re.match(r'^(jeho|jejich|jich|jehož|jejichž|jichž|jehožto|jejichžto|jichžto)$', node.form.lower()):
+            if re.match(r'^(jeho|jejich|jich)(ž(to)?)?$', node.form.lower()):
                 self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]'])
                 self.check_allowed_features(node, {
                     'PronType': ['Prs', 'Rel'],
@@ -349,21 +439,50 @@ def process_node(self, node):
                     'Number[psor]': ['Sing', 'Dual', 'Plur'],
                     'Gender[psor]': ['Masc,Neut']
                 })
-            else:
-                # Gender is annotated in all cases in singular, but only in
-                # nominative, accusative (and theoretically vocative) in plural.
-                # Other cases (Gen, Dat, Loc, Ins) are gender-less: 'těch', 'svým', ...
+            elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)(ž(to)?)?$', node.form.lower()):
+                # The feminine possessive 'její' slightly inflects, unlike 'jeho' and 'jejich'.
+                self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Prs', 'Rel'],
+                    'Poss': ['Yes'],
+                    'Person': ['3'],
+                    'Number[psor]': ['Sing'],
+                    'Gender[psor]': ['Fem'],
+                    'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                })
+            elif node.feats['Poss'] == 'Yes': # 'můj', 'tvůj', 'svůj'
+                # Gender is annotated in all cases in singular (můj, má, mé)
+                # but only in nominative (and vocative) in plural (mí, mé, má);
+                # neuter is also different in accusative (mé, má).
+                # Animacy is distinguished only in nom/voc plural masculine (mí, mé).
+                # Other cases in plural are gender-less (mých, mým, mé, mými).
                 # Note that this is not consistent with adjectives, where we
                 # disambiguate gender in all cases in plural.
-                # Same for animacy (which implies masculine gender).
-                self.check_required_features(node, ['PronType', 'Number', 'Case'])
+                self.check_required_features(node, ['PronType', 'Poss', 'Number', 'Case'])
                 self.check_allowed_features(node, {
-                    'PronType': ['Prs', 'Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
+                    'PronType': ['Prs'],
                     'Poss': ['Yes'],
                     'Reflex': ['Yes'],
-                    'Person': ['1', '2', '3'],
-                    'Number[psor]': ['Sing', 'Dual', 'Plur'],
-                    'Gender[psor]': ['Masc,Neut', 'Fem'],
+                    'Person': ['1', '2'], # only if not reflexive
+                    'Number[psor]': ['Sing', 'Plur'], # only if not reflexive
+                    'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'],
+                    'Animacy': ['Anim', 'Inan'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                })
+            else:
+                # Gender is annotated in all cases in singular (ten, ta, to)
+                # but only in nominative (and vocative) in plural (ti, ty, ta);
+                # neuter is also different in accusative (ty, ta).
+                # Animacy is distinguished only in nom/voc plural masculine (ti, ty).
+                # Other cases in plural are gender-less (těch, těm, ty, těmi).
+                # Note that this is not consistent with adjectives, where we
+                # disambiguate gender in all cases in plural.
+                self.check_required_features(node, ['PronType', 'Number', 'Case'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
                     'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # non-nominative forms of Masc and Neut are merged; Fem,Neut is e.g. 'vaše' in singular
                     'Animacy': ['Anim', 'Inan'],
                     'Number': ['Sing', 'Dual', 'Plur'],
@@ -457,12 +576,13 @@ def process_node(self, node):
         # ADVERBS ##############################################################
         elif node.upos == 'ADV':
             self.check_allowed_features(node, {
-                'PronType': ['Dem', 'Int,Rel', 'Ind', 'Neg'],
+                'PronType': ['Dem', 'Int,Rel', 'Ind', 'Neg', 'Tot'],
                 'Degree': ['Pos', 'Cmp', 'Sup'],
                 'Polarity': ['Pos', 'Neg']
             })
         # ADPOSITIONS ##########################################################
         elif node.upos == 'ADP':
+            self.check_required_features(node, ['AdpType', 'Case'])
             self.check_allowed_features(node, {
                 'AdpType': ['Prep', 'Voc'],
                 'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins']

From 08311e094b7443b7719924530f25e7c7fcc849ef Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 25 May 2022 23:43:30 +0200
Subject: [PATCH 0591/1374] More detailed feature conditions based on PDT.

---
 udapi/block/ud/cs/markfeatsbugs.py | 232 ++++++++++++++++++++++-------
 1 file changed, 179 insertions(+), 53 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index a2c2bb7b..e027d1cb 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -441,65 +441,180 @@ def process_node(self, node):
                 })
             elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)(ž(to)?)?$', node.form.lower()):
                 # The feminine possessive 'její' slightly inflects, unlike 'jeho' and 'jejich'.
-                self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]'])
-                self.check_allowed_features(node, {
-                    'PronType': ['Prs', 'Rel'],
-                    'Poss': ['Yes'],
-                    'Person': ['3'],
-                    'Number[psor]': ['Sing'],
-                    'Gender[psor]': ['Fem'],
-                    'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'],
-                    'Number': ['Sing', 'Dual', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                })
+                # Congruent gender is annotated only in singular. Masculine and
+                # neuter are merged even in nominative. Feminine singular does
+                # not distinguish case in PDT but we need it in Old Czech at
+                # least for 'jejiej'.
+                if node.feats['Number'] == 'Sing':
+                    self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]', 'Gender', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Prs', 'Rel'],
+                        'Poss': ['Yes'],
+                        'Person': ['3'],
+                        'Number[psor]': ['Sing'],
+                        'Gender[psor]': ['Fem'],
+                        'Gender': ['Masc,Neut', 'Fem'],
+                        'Number': ['Sing'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
+                else:
+                    self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Prs', 'Rel'],
+                        'Poss': ['Yes'],
+                        'Person': ['3'],
+                        'Number[psor]': ['Sing'],
+                        'Gender[psor]': ['Fem'],
+                        'Number': ['Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
             elif node.feats['Poss'] == 'Yes': # 'můj', 'tvůj', 'svůj'
                 # Gender is annotated in all cases in singular (můj, má, mé)
-                # but only in nominative (and vocative) in plural (mí, mé, má);
-                # neuter is also different in accusative (mé, má).
-                # Animacy is distinguished only in nom/voc plural masculine (mí, mé).
-                # Other cases in plural are gender-less (mých, mým, mé, mými).
+                # but only in nominative, accusative, and vocative in plural
+                # (Nom/Voc mí, mé, má; Acc mé, má). Animacy is distinguished
+                # in plural if gender is distinguished and masculine; in
+                # singular it is distinguished only in accusative (mého, můj).
+                # Other cases in plural are gender-less (mých, mým, mými).
                 # Note that this is not consistent with adjectives, where we
                 # disambiguate gender in all cases in plural.
-                self.check_required_features(node, ['PronType', 'Poss', 'Number', 'Case'])
-                self.check_allowed_features(node, {
-                    'PronType': ['Prs'],
-                    'Poss': ['Yes'],
-                    'Reflex': ['Yes'],
-                    'Person': ['1', '2'], # only if not reflexive
-                    'Number[psor]': ['Sing', 'Plur'], # only if not reflexive
-                    'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'],
-                    'Animacy': ['Anim', 'Inan'],
-                    'Number': ['Sing', 'Dual', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                })
+                if node.feats['Number'] == 'Sing':
+                    self.check_required_features(node, ['PronType', 'Poss', 'Gender', 'Number', 'Case'])
+                    if node.feats['Gender'] == 'Masc' and node.feats['Case'] == 'Acc':
+                        self.check_required_features(node, ['Animacy'])
+                        self.check_allowed_features(node, {
+                            'PronType': ['Prs'],
+                            'Poss': ['Yes'],
+                            'Reflex': ['Yes'],
+                            'Person': ['1', '2'], # only if not reflexive
+                            'Number[psor]': ['Sing', 'Plur'], # only if not reflexive
+                            'Gender': ['Masc'],
+                            'Animacy': ['Anim', 'Inan'],
+                            'Number': ['Sing'],
+                            'Case': ['Acc']
+                        })
+                    else:
+                        self.check_allowed_features(node, {
+                            'PronType': ['Prs'],
+                            'Poss': ['Yes'],
+                            'Reflex': ['Yes'],
+                            'Person': ['1', '2'], # only if not reflexive
+                            'Number[psor]': ['Sing', 'Plur'], # only if not reflexive
+                            'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'],
+                            'Number': ['Sing'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                        })
+                elif re.match(r'^(Nom|Acc|Voc)$', node.feats['Case']):
+                    self.check_required_features(node, ['PronType', 'Poss', 'Gender', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Prs'],
+                        'Poss': ['Yes'],
+                        'Reflex': ['Yes'],
+                        'Person': ['1', '2'], # only if not reflexive
+                        'Number[psor]': ['Sing', 'Plur'], # only if not reflexive
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Dual', 'Plur'],
+                        'Case': ['Nom', 'Acc', 'Voc']
+                    })
+                else:
+                    self.check_required_features(node, ['PronType', 'Poss', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Prs'],
+                        'Poss': ['Yes'],
+                        'Reflex': ['Yes'],
+                        'Person': ['1', '2'], # only if not reflexive
+                        'Number[psor]': ['Sing', 'Plur'], # only if not reflexive
+                        'Number': ['Dual', 'Plur'],
+                        'Case': ['Gen', 'Dat', 'Loc', 'Ins']
+                    })
             else:
                 # Gender is annotated in all cases in singular (ten, ta, to)
-                # but only in nominative (and vocative) in plural (ti, ty, ta);
-                # neuter is also different in accusative (ty, ta).
-                # Animacy is distinguished only in nom/voc plural masculine (ti, ty).
-                # Other cases in plural are gender-less (těch, těm, ty, těmi).
+                # but only in nominative, accusative, and vocative in plural
+                # (Nom/Voc ti, ty, ta; Acc ty, ta). Animacy is distinguished
+                # in plural if gender is distinguished and masculine; in
+                # singular it is distinguished only in accusative (toho, ten).
+                # Other cases in plural are gender-less (těch, těm, těmi).
                 # Note that this is not consistent with adjectives, where we
                 # disambiguate gender in all cases in plural.
-                self.check_required_features(node, ['PronType', 'Number', 'Case'])
-                self.check_allowed_features(node, {
-                    'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
-                    'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # non-nominative forms of Masc and Neut are merged; Fem,Neut is e.g. 'vaše' in singular
-                    'Animacy': ['Anim', 'Inan'],
-                    'Number': ['Sing', 'Dual', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                })
+                if node.feats['Number'] == 'Sing':
+                    self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case'])
+                    if node.feats['Gender'] == 'Masc' and node.feats['Case'] == 'Acc':
+                        self.check_required_features(node, ['Animacy'])
+                        self.check_allowed_features(node, {
+                            'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
+                            'Gender': ['Masc'],
+                            'Animacy': ['Anim', 'Inan'],
+                            'Number': ['Sing'],
+                            'Case': ['Acc']
+                        })
+                    else:
+                        self.check_allowed_features(node, {
+                            'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
+                            'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # non-nominative forms of Masc and Neut are merged; Fem,Neut is e.g. 'vaše' in singular
+                            'Number': ['Sing'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                        })
+                elif re.match(r'^(Nom|Acc|Voc)$', node.feats['Case']):
+                    self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Dual', 'Plur'],
+                        'Case': ['Nom', 'Acc', 'Voc']
+                    })
+                else:
+                    self.check_required_features(node, ['PronType', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
+                        'Number': ['Dual', 'Plur'],
+                        'Case': ['Gen', 'Dat', 'Loc', 'Ins']
+                    })
         # NUMERALS #############################################################
         elif node.upos == 'NUM':
             self.check_required_features(node, ['NumType', 'NumForm'])
-            self.check_allowed_features(node, {
-                'NumType': ['Card'],
-                'NumForm': ['Word', 'Digit', 'Roman'],
-                'NumValue': ['1,2,3'],
-                'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # similarly to determiners, genders are merged in some slots of the paradigm
-                'Animacy': ['Anim', 'Inan'],
-                'Number': ['Sing', 'Dual', 'Plur'],
-                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-            })
+            # Arabic digits and Roman numerals do not have inflection features.
+            if re.match(r'^(Digit|Roman)$', node.feats['NumForm']):
+                self.check_allowed_features(node, {
+                    'NumType': ['Card'],
+                    'NumForm': ['Digit', 'Roman']
+                })
+            else:
+                ###!!! Somehow the NumValue feature from PDT via Interset is useless.
+                # 'jeden' has Gender, Animacy, Number, Case: jeden, jedna, jedno, jednoho, jednomu, jednom, jedním, jedné, jednu, jednou, jedni, jedny, jedněch, jedněm, jedněmi.
+                # 'dva', 'oba' have Gender, Number=Dual(Plur in modern Czech), Case: dva, dvě, dvou, dvěma.
+                # 'tři', 'čtyři' have Number=Plur, Case: tři, třech, třem, třemi.
+                # 'pět' and more have Number=Plur, Case: pět, pěti.
+                if node.lemma == 'jeden':
+                    self.check_required_features(node, ['NumType', 'NumForm', 'NumValue', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'NumType': ['Card'],
+                        'NumForm': ['Word'],
+                        'NumValue': ['1,2,3'],
+                        'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # similarly to determiners, genders are merged in some slots of the paradigm
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
+                elif re.match(r'^(dva|oba)$', node.lemma):
+                    self.check_required_features(node, ['NumType', 'NumForm', 'NumValue', 'Gender', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'NumType': ['Card'],
+                        'NumForm': ['Word'],
+                        'NumValue': ['1,2,3'],
+                        'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # similarly to determiners, genders are merged in some slots of the paradigm
+                        'Number': ['Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
+                else:
+                    self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'NumType': ['Card'],
+                        'NumForm': ['Word'],
+                        'NumValue': ['1,2,3'],
+                        'Number': ['Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
         # VERBS AND AUXILIARIES ################################################
         elif re.match(r'^(VERB|AUX)$', node.upos):
             self.check_required_features(node, ['Aspect', 'VerbForm'])
@@ -575,11 +690,22 @@ def process_node(self, node):
                 })
         # ADVERBS ##############################################################
         elif node.upos == 'ADV':
-            self.check_allowed_features(node, {
-                'PronType': ['Dem', 'Int,Rel', 'Ind', 'Neg', 'Tot'],
-                'Degree': ['Pos', 'Cmp', 'Sup'],
-                'Polarity': ['Pos', 'Neg']
-            })
+            if node.feats['PronType'] != '':
+                # Pronominal adverbs are neither compared nor negated.
+                self.check_allowed_features(node, {
+                    'PronType': ['Dem', 'Int,Rel', 'Ind', 'Neg', 'Tot']
+                })
+            elif node.feats['Degree'] != '':
+                # Adverbs that are compared can also be negated.
+                self.check_required_features(node, ['Degree', 'Polarity'])
+                self.check_allowed_features(node, {
+                    'Degree': ['Pos', 'Cmp', 'Sup'],
+                    'Polarity': ['Pos', 'Neg']
+                })
+            else:
+                # The remaining adverbs are neither pronominal, nor compared or
+                # negated.
+                self.check_allowed_features(node, {})
         # ADPOSITIONS ##########################################################
         elif node.upos == 'ADP':
             self.check_required_features(node, ['AdpType', 'Case'])

From 9d8dc3b0568596a1d8ff16dc9f54504ea38a583a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 27 May 2022 13:08:32 +0200
Subject: [PATCH 0592/1374] Fix spurious auxiliaries in Kazakh.

---
 udapi/block/ud/kk/fixspuriousaux.py | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 udapi/block/ud/kk/fixspuriousaux.py

diff --git a/udapi/block/ud/kk/fixspuriousaux.py b/udapi/block/ud/kk/fixspuriousaux.py
new file mode 100644
index 00000000..8a1e06c8
--- /dev/null
+++ b/udapi/block/ud/kk/fixspuriousaux.py
@@ -0,0 +1,24 @@
+"""Block to convert spurious auxiliaries to lexical verbs in Kazakh."""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixSpuriousAux(Block):
+
+    def process_node(self, node):
+        """
+        Some verbs that are called auxiliary by the traditional grammar, should
+        be analyzed in UD as VERB + non-finite xcomp.
+        """
+        if node.upos == 'AUX' and node.udeprel == 'aux':
+            # баста = start
+            if re.match(r'^(баста)$', node.lemma):
+                node.upos = 'VERB'
+                # The auxiliary inherits the incoming relation of its original parent.
+                lexverb = node.parent
+                node.parent = lexverb.parent
+                node.deprel = lexverb.deprel
+                # The auxiliary also inherits some but not all children of the lexical verb.
+                for c in lexverb.children:
+                    if re.match(r'^(nsubj|csubj|obl|advmod|advcl|vocative|discourse|parataxis|punct)$', c.udeprel):
+                        c.parent = node

From f6cd84c05eb10f2acf47022afb6eaa2ff4195c10 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 27 May 2022 13:11:34 +0200
Subject: [PATCH 0593/1374] Bug fix.

---
 udapi/block/ud/kk/fixspuriousaux.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/kk/fixspuriousaux.py b/udapi/block/ud/kk/fixspuriousaux.py
index 8a1e06c8..a2ba777c 100644
--- a/udapi/block/ud/kk/fixspuriousaux.py
+++ b/udapi/block/ud/kk/fixspuriousaux.py
@@ -22,3 +22,6 @@ def process_node(self, node):
                 for c in lexverb.children:
                     if re.match(r'^(nsubj|csubj|obl|advmod|advcl|vocative|discourse|parataxis|punct)$', c.udeprel):
                         c.parent = node
+                # The lexical verb becomes an xcomp of the auxiliary.
+                lexverb.parent = node
+                lexverb.deprel = 'xcomp'

From 0dbb2cf5d8897f5463dcc712049491d94206eddc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 27 May 2022 13:20:04 +0200
Subject: [PATCH 0594/1374] =?UTF-8?q?=D0=BA=D0=B5=D1=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/kk/fixspuriousaux.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/kk/fixspuriousaux.py b/udapi/block/ud/kk/fixspuriousaux.py
index a2ba777c..044ff178 100644
--- a/udapi/block/ud/kk/fixspuriousaux.py
+++ b/udapi/block/ud/kk/fixspuriousaux.py
@@ -12,7 +12,7 @@ def process_node(self, node):
         """
         if node.upos == 'AUX' and node.udeprel == 'aux':
             # баста = start
-            if re.match(r'^(баста)$', node.lemma):
+            if re.match(r'^(баста|кет)$', node.lemma):
                 node.upos = 'VERB'
                 # The auxiliary inherits the incoming relation of its original parent.
                 lexverb = node.parent

From 59a1f6c57fc6d2913fc06e4f6495f105004c2bdc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 27 May 2022 18:09:03 +0200
Subject: [PATCH 0595/1374] A block to remove multi-word token if it contains
 spaces and if its words match the space-delimited segments.

---
 udapi/block/ud/fixmwtspace.py | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 udapi/block/ud/fixmwtspace.py

diff --git a/udapi/block/ud/fixmwtspace.py b/udapi/block/ud/fixmwtspace.py
new file mode 100644
index 00000000..a2b7b875
--- /dev/null
+++ b/udapi/block/ud/fixmwtspace.py
@@ -0,0 +1,22 @@
+"""
+Block ud.FixMwtSpace looks for multiword tokens whose form contains a space,
+which should be avoided. If found, the block checks whether it can remove
+the multiword token seamlessly, that is, whether the syntactic words correspond
+to the space-delimited parts of the multiword token. If possible, the MWT
+line will be removed.
+"""
+from udapi.core.block import Block
+import re
+
+
+class FixMwtSpace(Block):
+    """Try to remove multiword tokens with spaces."""
+
+    def process_node(self, node):
+        if node.multiword_token:
+            mwt = node.multiword_token
+            if re.search(r' ', mwt.form):
+                if node == mwt.words[0]:
+                    wordforms = [x.form for x in mwt.words]
+                    if ' '.join(wordforms) == mwt.form:
+                        mwt.remove()

From 29c48fa5a9002e37d14fe610d942586a06c9d328 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 16:51:48 +0200
Subject: [PATCH 0596/1374] Restore forms of words within multiword tokens.

---
 udapi/block/ud/mr/addformsinmwt.py | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 udapi/block/ud/mr/addformsinmwt.py

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
new file mode 100644
index 00000000..b468fb04
--- /dev/null
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -0,0 +1,27 @@
+"""
+Block ud.mr.AddFormsInMwt looks for multiword tokens whose words lack forms.
+Based on the form of the surface token and on the information provided in
+the lemmas and UPOS, tries to reconstruct the forms of individual words.
+"""
+from udapi.core.block import Block
+import re
+import logging
+
+
+class AddFormsInMwt(Block):
+    """Guess forms of syntactic worms within a multiword token."""
+
+    def process_node(self, node):
+        if node.form == '_' and node.multiword_token:
+            mwt = node.multiword_token
+            # Many multiword tokens consist of NOUN + ADP. Beware: The adposition
+            # may have a form different from its lemma. It happens with possessive
+            # postpositions चा, चे, which distinguish the gender and number of
+            # the possessed entity.
+            if len(mwt.words) == 2 and mwt.words[1].upos == 'ADP':
+                if mwt.form == mwt.words[0].lemma + mwt.words[1].lemma:
+                    node.form = node.lemma
+                else:
+                    logging.info("Cannot decompose %s+ADP multiword token '%s'. Part lemmas are '%s' and '%s'." % (mwt.words[0].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma))
+            else:
+                logging.info("Cannot decompose multiword token '%s' of %d parts: %s" % (mwt.form, len(mwt.words), str([x.lemma for x in mwt.words])))

From d0e75c1f8fc89337b6ca87eb4b41b675a2eec3fd Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 16:59:38 +0200
Subject: [PATCH 0597/1374] Improved decomposition of X+ADP.

---
 udapi/block/ud/mr/addformsinmwt.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index b468fb04..26110fea 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -19,8 +19,12 @@ def process_node(self, node):
             # postpositions चा, चे, which distinguish the gender and number of
             # the possessed entity.
             if len(mwt.words) == 2 and mwt.words[1].upos == 'ADP':
-                if mwt.form == mwt.words[0].lemma + mwt.words[1].lemma:
-                    node.form = node.lemma
+                m = re.match(r'^(.+)' + mwt.words[1].lemma + r'$', mwt.form)
+                if m:
+                    if node == mwt.words[0]:
+                        node.form = m.group(1)
+                    else:
+                        node.form = node.lemma
                 else:
                     logging.info("Cannot decompose %s+ADP multiword token '%s'. Part lemmas are '%s' and '%s'." % (mwt.words[0].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma))
             else:

From 788830b3fe3d1cd963498080b019bb7c675a6bef Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 17:07:02 +0200
Subject: [PATCH 0598/1374] =?UTF-8?q?=E0=A4=9A=E0=A4=BE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/mr/addformsinmwt.py | 26 ++++++++++++++++++--------
 1 file changed, 18 insertions(+), 8 deletions(-)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index 26110fea..be290c50 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -19,13 +19,23 @@ def process_node(self, node):
             # postpositions चा, चे, which distinguish the gender and number of
             # the possessed entity.
             if len(mwt.words) == 2 and mwt.words[1].upos == 'ADP':
-                m = re.match(r'^(.+)' + mwt.words[1].lemma + r'$', mwt.form)
-                if m:
-                    if node == mwt.words[0]:
-                        node.form = m.group(1)
+                if mwt.words[1].lemma == 'चा':
+                    m = re.match(r'^(.+)(चा|चे)$', mwt.form)
+                    if m:
+                        if node == mwt.words[0]:
+                            node.form = m.group(1)
+                        else:
+                            node.form = m.group(2)
                     else:
-                        node.form = node.lemma
-                else:
-                    logging.info("Cannot decompose %s+ADP multiword token '%s'. Part lemmas are '%s' and '%s'." % (mwt.words[0].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma))
+                        logging.info("Cannot decompose %s+ADP multiword token '%s'. Part lemmas are '%s' and '%s'." % (mwt.words[0].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma))
+                else: # not the possessive 'ca'
+                    m = re.match(r'^(.+)' + mwt.words[1].lemma + r'$', mwt.form)
+                    if m:
+                        if node == mwt.words[0]:
+                            node.form = m.group(1)
+                        else:
+                            node.form = node.lemma
+                    else:
+                        logging.info("Cannot decompose %s+ADP multiword token '%s'. Part lemmas are '%s' and '%s'." % (mwt.words[0].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma))
             else:
-                logging.info("Cannot decompose multiword token '%s' of %d parts: %s" % (mwt.form, len(mwt.words), str([x.lemma for x in mwt.words])))
+                logging.info("Cannot decompose multiword token '%s' of %d parts: %s" % (mwt.form, len(mwt.words), str([x.lemma + '/' + x.upos for x in mwt.words])))

From d5495edaf163f6e258147fee49f9f4bc8bc18fa0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 17:09:19 +0200
Subject: [PATCH 0599/1374] =?UTF-8?q?=E0=A4=9A=E0=A5=8D=E0=A4=AF=E0=A4=BE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/mr/addformsinmwt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index be290c50..5fcb9866 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -20,7 +20,7 @@ def process_node(self, node):
             # the possessed entity.
             if len(mwt.words) == 2 and mwt.words[1].upos == 'ADP':
                 if mwt.words[1].lemma == 'चा':
-                    m = re.match(r'^(.+)(चा|चे)$', mwt.form)
+                    m = re.match(r'^(.+)(चा|चे|च्या)$', mwt.form)
                     if m:
                         if node == mwt.words[0]:
                             node.form = m.group(1)

From 20e33c965cc18a1ca4f6664323ef0e167978e5f8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 17:11:39 +0200
Subject: [PATCH 0600/1374] =?UTF-8?q?=E0=A4=9A=E0=A5=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/mr/addformsinmwt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index 5fcb9866..903409f0 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -20,7 +20,7 @@ def process_node(self, node):
             # the possessed entity.
             if len(mwt.words) == 2 and mwt.words[1].upos == 'ADP':
                 if mwt.words[1].lemma == 'चा':
-                    m = re.match(r'^(.+)(चा|चे|च्या)$', mwt.form)
+                    m = re.match(r'^(.+)(चा|चे|च्या|ची)$', mwt.form)
                     if m:
                         if node == mwt.words[0]:
                             node.form = m.group(1)

From fc5b262e7b65d8911a80f3409e28badd714f9b03 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 17:23:28 +0200
Subject: [PATCH 0601/1374] Particle "ca".

---
 udapi/block/ud/mr/addformsinmwt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index 903409f0..44802762 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -18,7 +18,7 @@ def process_node(self, node):
             # may have a form different from its lemma. It happens with possessive
             # postpositions चा, चे, which distinguish the gender and number of
             # the possessed entity.
-            if len(mwt.words) == 2 and mwt.words[1].upos == 'ADP':
+            if len(mwt.words) == 2 and re.match(r'^(ADP|PART)$', mwt.words[1].upos):
                 if mwt.words[1].lemma == 'चा':
                     m = re.match(r'^(.+)(चा|चे|च्या|ची)$', mwt.form)
                     if m:

From 31e99b45980823b9bb3f0a2a82b6bd40872b0801 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 17:45:32 +0200
Subject: [PATCH 0602/1374] Possessive pronouns.

---
 udapi/block/ud/mr/addformsinmwt.py | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index 44802762..7efe1e72 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -20,12 +20,25 @@ def process_node(self, node):
             # the possessed entity.
             if len(mwt.words) == 2 and re.match(r'^(ADP|PART)$', mwt.words[1].upos):
                 if mwt.words[1].lemma == 'चा':
-                    m = re.match(r'^(.+)(चा|चे|च्या|ची)$', mwt.form)
+                    # चा (cā) ... Masc Sing
+                    # ची (cī) ... Fem Sing, Neut Plur
+                    # चे (ce) ... Neut Sing, Masc Plur
+                    # च्या (cyā) ... Fem Plur
+                    m = re.match(r'^(.+)(चा|ची|चे|च्या)$', mwt.form)
+                    # The resulting form is different with personal pronouns.
+                    # माझा (mājhā), माझी (mājhī), माझे (mājhe), माझ्या (mājhyā)
+                    # तुझी (tujhī), तुझे (tujhe)
+                    m2 = re.match(r'^(माझ|तुझ)(ा|ी|े|्या)$', mwt.form)
                     if m:
                         if node == mwt.words[0]:
                             node.form = m.group(1)
                         else:
                             node.form = m.group(2)
+                    elif m2:
+                        if node == mwt.words[0]:
+                            node.form = m.group(1)
+                        else:
+                            node.form = 'च' + m.group(2)
                     else:
                         logging.info("Cannot decompose %s+ADP multiword token '%s'. Part lemmas are '%s' and '%s'." % (mwt.words[0].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma))
                 else: # not the possessive 'ca'

From 3a33d279bd2e2b3a99c325d4921a314941217c98 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 17:46:23 +0200
Subject: [PATCH 0603/1374] Bug fix.

---
 udapi/block/ud/mr/addformsinmwt.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index 7efe1e72..e3fcafe5 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -36,9 +36,9 @@ def process_node(self, node):
                             node.form = m.group(2)
                     elif m2:
                         if node == mwt.words[0]:
-                            node.form = m.group(1)
+                            node.form = m2.group(1)
                         else:
-                            node.form = 'च' + m.group(2)
+                            node.form = 'च' + m2.group(2)
                     else:
                         logging.info("Cannot decompose %s+ADP multiword token '%s'. Part lemmas are '%s' and '%s'." % (mwt.words[0].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma))
                 else: # not the possessive 'ca'

From a454721a0efbf19adfa2e973aaa03608052fc665 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 18:13:28 +0200
Subject: [PATCH 0604/1374] =?UTF-8?q?=E0=A4=9A=E0=A4=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/mr/addformsinmwt.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index e3fcafe5..abf538d8 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -24,10 +24,12 @@ def process_node(self, node):
                     # ची (cī) ... Fem Sing, Neut Plur
                     # चे (ce) ... Neut Sing, Masc Plur
                     # च्या (cyā) ... Fem Plur
-                    m = re.match(r'^(.+)(चा|ची|चे|च्या)$', mwt.form)
+                    # चं (caṁ) ... ?
+                    m = re.match(r'^(.+)(चा|ची|चे|च्या|चं)$', mwt.form)
                     # The resulting form is different with personal pronouns.
                     # माझा (mājhā), माझी (mājhī), माझे (mājhe), माझ्या (mājhyā)
                     # तुझी (tujhī), तुझे (tujhe)
+                    # त्याचं (tyācaṁ)
                     m2 = re.match(r'^(माझ|तुझ)(ा|ी|े|्या)$', mwt.form)
                     if m:
                         if node == mwt.words[0]:

From 59fb2e823e9b34679781422ef9f8a73329d97c54 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 18:19:31 +0200
Subject: [PATCH 0605/1374] Fix wrong lemma.

---
 udapi/block/ud/mr/addformsinmwt.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index abf538d8..7ecb64b4 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -19,7 +19,9 @@ def process_node(self, node):
             # postpositions चा, चे, which distinguish the gender and number of
             # the possessed entity.
             if len(mwt.words) == 2 and re.match(r'^(ADP|PART)$', mwt.words[1].upos):
-                if mwt.words[1].lemma == 'चा':
+                # Occasionally the lemma of the possessive postposition is mistakenly 'ची' instead of 'चा'.
+                if mwt.words[1].lemma == 'चा' or mwt.words[1].lemma == 'ची':
+                    mwt.words[1].lemma = 'चा'
                     # चा (cā) ... Masc Sing
                     # ची (cī) ... Fem Sing, Neut Plur
                     # चे (ce) ... Neut Sing, Masc Plur

From a2077ea36ff859ecee9f89445e000c933969d50c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 18:30:12 +0200
Subject: [PATCH 0606/1374] Three-word tokens.

---
 udapi/block/ud/mr/addformsinmwt.py | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index 7ecb64b4..b899b55c 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -54,5 +54,26 @@ def process_node(self, node):
                             node.form = node.lemma
                     else:
                         logging.info("Cannot decompose %s+ADP multiword token '%s'. Part lemmas are '%s' and '%s'." % (mwt.words[0].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma))
+            elif len(mwt.words) == 3 and re.match(r'^(ADP|PART)$', mwt.words[1].upos) and re.match(r'^(ADP|PART)$', mwt.words[2].upos):
+                # Compound postpositions where the middle word is the possessive 'चा'.
+                if mwt.words[1].lemma == 'चा':
+                    m = re.match(r'^(.+)(चा|ची|चे|च्या|चं)(.+)$', mwt.form)
+                    m2 = re.match(r'^(माझ|तुझ)(ा|ी|े|्या)(.+)$', mwt.form)
+                    if m:
+                        if node == mwt.words[0]:
+                            node.form = m.group(1)
+                        elif node == mwt.words[1]:
+                            node.form = m.group(2)
+                        else:
+                            node.form = m.group(3)
+                    elif m2:
+                        if node == mwt.words[0]:
+                            node.form = m2.group(1)
+                        elif node == mwt.words[1]:
+                            node.form = 'च' + m2.group(2)
+                        else:
+                            node.form = m2.group(3)
+                    else:
+                        logging.info("Cannot decompose %s+%s+%s multiword token '%s'. Part lemmas are '%s', '%s', and '%s'." % (mwt.words[0].upos, mwt.words[1].upos, mwt.words[2].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma, mwt.words[1].lemma))
             else:
                 logging.info("Cannot decompose multiword token '%s' of %d parts: %s" % (mwt.form, len(mwt.words), str([x.lemma + '/' + x.upos for x in mwt.words])))

From 3441331c8a4fa39c64651a6d8409007d61847aa8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 18:55:19 +0200
Subject: [PATCH 0607/1374] The honorific pronoun.

---
 udapi/block/ud/mr/addformsinmwt.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index b899b55c..0ad7fded 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -31,8 +31,9 @@ def process_node(self, node):
                     # The resulting form is different with personal pronouns.
                     # माझा (mājhā), माझी (mājhī), माझे (mājhe), माझ्या (mājhyā)
                     # तुझी (tujhī), तुझे (tujhe)
+                    # आपला (āpalā), आपली (āpalī), आपल्या (āpalyā)
                     # त्याचं (tyācaṁ)
-                    m2 = re.match(r'^(माझ|तुझ)(ा|ी|े|्या)$', mwt.form)
+                    m2 = re.match(r'^(माझ|तुझ|आपल)(ा|ी|े|्या)$', mwt.form)
                     if m:
                         if node == mwt.words[0]:
                             node.form = m.group(1)
@@ -58,7 +59,7 @@ def process_node(self, node):
                 # Compound postpositions where the middle word is the possessive 'चा'.
                 if mwt.words[1].lemma == 'चा':
                     m = re.match(r'^(.+)(चा|ची|चे|च्या|चं)(.+)$', mwt.form)
-                    m2 = re.match(r'^(माझ|तुझ)(ा|ी|े|्या)(.+)$', mwt.form)
+                    m2 = re.match(r'^(माझ|तुझ|आपल)(ा|ी|े|्या)$', mwt.form)
                     if m:
                         if node == mwt.words[0]:
                             node.form = m.group(1)

From 15cf8914cfd75a14eb88bf2ff6278ba7741637a7 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 18:57:15 +0200
Subject: [PATCH 0608/1374] Bug fix.

---
 udapi/block/ud/mr/addformsinmwt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index 0ad7fded..f508076c 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -59,7 +59,7 @@ def process_node(self, node):
                 # Compound postpositions where the middle word is the possessive 'चा'.
                 if mwt.words[1].lemma == 'चा':
                     m = re.match(r'^(.+)(चा|ची|चे|च्या|चं)(.+)$', mwt.form)
-                    m2 = re.match(r'^(माझ|तुझ|आपल)(ा|ी|े|्या)$', mwt.form)
+                    m2 = re.match(r'^(माझ|तुझ|आपल)(ा|ी|े|्या)(.+)$', mwt.form)
                     if m:
                         if node == mwt.words[0]:
                             node.form = m.group(1)

From 940a2c6dff3895c5cad7473dcaa566a47c157390 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 19:53:17 +0200
Subject: [PATCH 0609/1374] -vara.

---
 udapi/block/ud/mr/addformsinmwt.py | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index f508076c..2df0b2e3 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -46,7 +46,16 @@ def process_node(self, node):
                             node.form = 'च' + m2.group(2)
                     else:
                         logging.info("Cannot decompose %s+ADP multiword token '%s'. Part lemmas are '%s' and '%s'." % (mwt.words[0].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma))
-                else: # not the possessive 'ca'
+                elif mwt.words[1].lemma == 'वरती':
+                    m = re.match(r'^(.+)वर$', mwt.form)
+                    if m:
+                        if node == mwt.words[0]:
+                            node.form = m.group(1)
+                        else:
+                            node.form = 'वर'
+                    else:
+                        logging.info("Cannot decompose %s+ADP multiword token '%s'. Part lemmas are '%s' and '%s'." % (mwt.words[0].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma))
+                else: # not the possessive 'चा'
                     m = re.match(r'^(.+)' + mwt.words[1].lemma + r'$', mwt.form)
                     if m:
                         if node == mwt.words[0]:

From 001e7f2cb531540633f4c667eb0b111f78709a0c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 May 2022 19:54:49 +0200
Subject: [PATCH 0610/1374] =?UTF-8?q?+=20=E0=A4=A4=E0=A5=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/mr/addformsinmwt.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index 2df0b2e3..7077e665 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -47,12 +47,12 @@ def process_node(self, node):
                     else:
                         logging.info("Cannot decompose %s+ADP multiword token '%s'. Part lemmas are '%s' and '%s'." % (mwt.words[0].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma))
                 elif mwt.words[1].lemma == 'वरती':
-                    m = re.match(r'^(.+)वर$', mwt.form)
+                    m = re.match(r'^(.+)(वर(?:ती)?)$', mwt.form)
                     if m:
                         if node == mwt.words[0]:
                             node.form = m.group(1)
                         else:
-                            node.form = 'वर'
+                            node.form = m.group(2)
                     else:
                         logging.info("Cannot decompose %s+ADP multiword token '%s'. Part lemmas are '%s' and '%s'." % (mwt.words[0].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma))
                 else: # not the possessive 'चा'

From d339c1030b6f8a6ad9675776f2795e6dfef88440 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Barbora=20Dohnalov=C3=A1?=
 <71558316+kybersutr@users.noreply.github.com>
Date: Tue, 31 May 2022 17:23:04 +0200
Subject: [PATCH 0611/1374] Entity setter (#108)

* add possibility to change the entity of a mention

* keep mentions sorted

* remove text

* self instead of mention

* add warning and tests

Co-authored-by: Kybersutr <barca.dohnalova@seznam.cz>
---
 udapi/core/coref.py            | 8 ++++++--
 udapi/core/tests/test_coref.py | 5 +++++
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index edd297b4..3eb76db3 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -103,6 +103,7 @@
 import collections.abc
 import copy
 import logging
+import bisect
 
 @functools.total_ordering
 class CorefMention(object):
@@ -192,9 +193,12 @@ def entity(self):
     @entity.setter
     def entity(self, new_entity):
         if self._entity is not None:
-            raise NotImplementedError('changing the entity of a mention not supported yet')
+            original_entity = self._entity
+            original_entity._mentions.remove(self)
+            if  not original_entity._mentions:
+                logging.warning(f"Original entity {original_entity.eid} is now empty.")
         self._entity = new_entity
-        new_entity._mentions.append(new_entity)
+        bisect.insort(new_entity._mentions, self)
 
     @property
     def bridging(self):
diff --git a/udapi/core/tests/test_coref.py b/udapi/core/tests/test_coref.py
index 369e8caf..e0998b75 100755
--- a/udapi/core/tests/test_coref.py
+++ b/udapi/core/tests/test_coref.py
@@ -48,6 +48,11 @@ def test_edits(self):
         self.assertEqual(new_entity.mentions[1], m1)
         self.assertTrue(m2 < m1)
         self.assertEqual(m2.words, [first_node, second_node, second_node.next_node])
+        entity2 = doc.create_coref_entity()
+        m1.entity = entity2
+        self.assertEqual(m1.entity.eid, entity2.eid)
+        m2.entity = entity2
+        self.assertEqual(m2.entity.eid, entity2.eid)
 
 
 if __name__ == "__main__":

From df5b371c7b1e17dbbb0b26cffe8f84243631c452 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 1 Jun 2022 14:52:30 +0200
Subject: [PATCH 0612/1374] util.Eval empty_nodes=1 node='my code...'

allow processing empty nodes with util.Eval
---
 udapi/block/util/eval.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/udapi/block/util/eval.py b/udapi/block/util/eval.py
index 0f80d018..df6aaabf 100644
--- a/udapi/block/util/eval.py
+++ b/udapi/block/util/eval.py
@@ -29,7 +29,7 @@ class Eval(Block):
     # pylint: disable=too-many-arguments,too-many-instance-attributes
     def __init__(self, doc=None, bundle=None, tree=None, node=None, start=None, end=None,
                  before_doc=None, after_doc=None, before_bundle=None, after_bundle=None,
-                 coref_mention=None, coref_entity=None,
+                 coref_mention=None, coref_entity=None, empty_nodes=False,
                  expand_code=True, **kwargs):
         super().__init__(**kwargs)
         self.doc = doc
@@ -44,6 +44,7 @@ def __init__(self, doc=None, bundle=None, tree=None, node=None, start=None, end=
         self.after_bundle = after_bundle
         self.coref_mention = coref_mention
         self.coref_entity = coref_entity
+        self.empty_nodes = empty_nodes
         self.expand_code = expand_code
         self.count = collections.Counter()
 
@@ -115,7 +116,8 @@ def process_tree(self, tree):
             exec(self.expand_eval_code(self.tree))
 
         if self.node:
-            for node in tree.descendants():
+            nodes = tree.descendants_and_empty if self.empty_nodes else tree.descendants
+            for node in nodes:
                 this = node
                 exec(self.expand_eval_code(self.node))
 

From 6e9320fbb2fdccdcfdfacc0c25d2659801b54ba6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 7 Jun 2022 10:16:59 +0200
Subject: [PATCH 0613/1374] Lemmatization of Cantonese.

---
 udapi/block/ud/yue/lemmatize.py | 43 +++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 udapi/block/ud/yue/lemmatize.py

diff --git a/udapi/block/ud/yue/lemmatize.py b/udapi/block/ud/yue/lemmatize.py
new file mode 100644
index 00000000..87279dc1
--- /dev/null
+++ b/udapi/block/ud/yue/lemmatize.py
@@ -0,0 +1,43 @@
+"""Block to add missing lemmas in cases where it seems obvious what the lemma should be."""
+from udapi.core.block import Block
+import logging
+import re
+
+class Lemmatize(Block):
+
+    # dictionary: form --> lemma
+    lemma = {
+        '𡃁仔':   '笭仔',
+        '仲':     '重',
+        '企':     '徛',
+        '係咪':   '係',
+        '出嚟':   '出唻',
+        '可':     '可以',
+        '啦':     '喇',
+        '㗎喇':   '㗎嘑',
+        '喇':     '嘑',
+        '嚟':     '唻',
+        '就嚟':   '就唻',
+        '死𡃁妹': '死笭妹',
+        '老豆':   '老頭',
+        '蚊':     '緡',
+        '蛋撻':   '蛋澾',
+        '返嚟':   '返唻',
+        '過嚟人': '過唻人',
+        '過嚟':   '過唻'
+    }
+
+    def process_node(self, node):
+        """
+        Parts of the Cantonese treebank lack lemmas. Fortunately, lemmatization
+        of Sino-Tibetan languages is pretty straightforward most of the time,
+        as the lemma typically equals to the actual word form.
+
+        For Cantonese, lemmatization includes normalization of some characters.
+        These are the few cases where lemma differs from the surface form.
+        """
+        if node.lemma == '' or node.lemma == '_' and node.form != '_' and node.feats['Typo'] != 'Yes':
+            if node.form in self.lemma:
+                node.lemma = self.lemma[node.form]
+            else:
+                node.lemma = node.form

From 9c26f877cb0200f7d52b64e4563c6cdd9cc5e09a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 7 Jun 2022 16:48:13 +0200
Subject: [PATCH 0614/1374] sanity check: cannot compare nodes from different
 documents

When `node1` and `node2` are from different documents,
it makes no sense to use `node1.precedes(node2)`.
Sorting nodes from different docs using `precedes` could result in unexpected bugs
because with the default Python `sort` even nodes from the same document
may not be in the correct order (the relation was not transitive without the added sanity check).
---
 udapi/core/node.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index ad36aa0a..63242698 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -692,6 +692,8 @@ def precedes(self, node):
             return self._ord < node._ord
         if self._root._zone != node._root._zone:
             raise ValueError(f"Cannot compare word order across zones: {self} {node}")
+        if self._root._bundle._document is not node._root._bundle._document:
+            raise ValueError(f"Cannot compare word order across documents: {self} {node}")
         return self._root._bundle.number < node._root._bundle.number
 
     def is_leaf(self):

From 02cb25bba090e49dc32bd5f74161e3266740e500 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 9 Jun 2022 01:00:03 +0200
Subject: [PATCH 0615/1374] 02-blocks.ipynb not finished yet

---
 tutorial/01-visualizing.ipynb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tutorial/01-visualizing.ipynb b/tutorial/01-visualizing.ipynb
index 382bb11f..70bea240 100644
--- a/tutorial/01-visualizing.ipynb
+++ b/tutorial/01-visualizing.ipynb
@@ -526,7 +526,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "In the next tutorial, [02-blocks.ipynb](02-blocks.ipynb), we will explore several useful Udapi blocks, some of which may be handy when working further on Exercise 2 or similar tasks."
+    "In the next tutorial, 02-blocks.ipynb (not finished yet), we will explore several useful Udapi blocks, some of which may be handy when working further on Exercise 2 or similar tasks."
    ]
   }
  ],

From 5216c81c600fd280867e5fd101ef05a87658c26a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 9 Jun 2022 01:00:51 +0200
Subject: [PATCH 0616/1374] 02-blocks.ipynb not finished yet

---
 tutorial/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tutorial/README.md b/tutorial/README.md
index 05e96d59..425f7df5 100644
--- a/tutorial/README.md
+++ b/tutorial/README.md
@@ -6,4 +6,4 @@ Don't display the tutorial `ipynb` files on GitHub because it cannot render the
 If you don't have Jupyter installed, you can display the tutorial with https://nbviewer.jupyter.org, using the following links:
 
 - [01-visualizing.ipynb](https://nbviewer.jupyter.org/github/udapi/udapi-python/blob/master/tutorial/01-visualizing.ipynb)
-- [02-blocks.ipynb](https://nbviewer.jupyter.org/github/udapi/udapi-python/blob/master/tutorial/01-blocks.ipynb)
+- 02-blocks.ipynb (not finished yet)

From b193c2fb5d41c075fc21b194b4ddb5b88d42a6d6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 10 Jun 2022 22:17:23 +0200
Subject: [PATCH 0617/1374] Fix spurious auxiliaries in Uyghur.

---
 udapi/block/ud/ug/fixspuriousaux.py | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 udapi/block/ud/ug/fixspuriousaux.py

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
new file mode 100644
index 00000000..2ac6adc2
--- /dev/null
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -0,0 +1,27 @@
+"""Block to convert spurious auxiliaries to lexical verbs in Uyghur."""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixSpuriousAux(Block):
+
+    def process_node(self, node):
+        """
+        Some verbs that are called auxiliary by the traditional grammar, should
+        be analyzed in UD as VERB + non-finite xcomp.
+        """
+        if node.upos == 'AUX' and node.udeprel == 'aux':
+            # بەر = give (used with actions done for the benefit of somebody)
+            if re.match(r'^(بەر)$', node.lemma):
+                node.upos = 'VERB'
+                # The auxiliary inherits the incoming relation of its original parent.
+                lexverb = node.parent
+                node.parent = lexverb.parent
+                node.deprel = lexverb.deprel
+                # The auxiliary also inherits some but not all children of the lexical verb.
+                for c in lexverb.children:
+                    if re.match(r'^(nsubj|csubj|obl|advmod|advcl|vocative|discourse|parataxis|punct)$', c.udeprel):
+                        c.parent = node
+                # The lexical verb becomes an xcomp of the auxiliary.
+                lexverb.parent = node
+                lexverb.deprel = 'xcomp'

From 42cdc02d3b50ecf4d70ed68d510c9d81635c41a5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 10 Jun 2022 22:28:33 +0200
Subject: [PATCH 0618/1374] =?UTF-8?q?=DA=86=D9=89=D9=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ug/fixspuriousaux.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
index 2ac6adc2..2f2d779c 100644
--- a/udapi/block/ud/ug/fixspuriousaux.py
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -12,7 +12,8 @@ def process_node(self, node):
         """
         if node.upos == 'AUX' and node.udeprel == 'aux':
             # بەر = give (used with actions done for the benefit of somebody)
-            if re.match(r'^(بەر)$', node.lemma):
+            # چىق = go out
+            if re.match(r'^(بەر|چىق)$', node.lemma):
                 node.upos = 'VERB'
                 # The auxiliary inherits the incoming relation of its original parent.
                 lexverb = node.parent

From 8a5e45f6df8f7a9770003c979180e66d274efc12 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 10 Jun 2022 22:49:14 +0200
Subject: [PATCH 0619/1374] =?UTF-8?q?=D9=8A=DB=88=D8=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ug/fixspuriousaux.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
index 2f2d779c..b770edcf 100644
--- a/udapi/block/ud/ug/fixspuriousaux.py
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -13,7 +13,8 @@ def process_node(self, node):
         if node.upos == 'AUX' and node.udeprel == 'aux':
             # بەر = give (used with actions done for the benefit of somebody)
             # چىق = go out
-            if re.match(r'^(بەر|چىق)$', node.lemma):
+            # يۈر = walk (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)
+            if re.match(r'^(بەر|چىق|يۈر)$', node.lemma):
                 node.upos = 'VERB'
                 # The auxiliary inherits the incoming relation of its original parent.
                 lexverb = node.parent

From c580385d1147590bb5fc43bca925f001cd623a04 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 10 Jun 2022 22:55:15 +0200
Subject: [PATCH 0620/1374] =?UTF-8?q?=D8=A6=D9=88=D9=84=D8=AA=DB=87=D8=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ug/fixspuriousaux.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
index b770edcf..c03a0e5a 100644
--- a/udapi/block/ud/ug/fixspuriousaux.py
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -14,7 +14,8 @@ def process_node(self, node):
             # بەر = give (used with actions done for the benefit of somebody)
             # چىق = go out
             # يۈر = walk (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)
-            if re.match(r'^(بەر|چىق|يۈر)$', node.lemma):
+            # ئولتۇر = sit (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)
+            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر)$', node.lemma):
                 node.upos = 'VERB'
                 # The auxiliary inherits the incoming relation of its original parent.
                 lexverb = node.parent

From 77024b3ee2b8648c8737dfcaecd64c1b08c78220 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Jun 2022 10:04:06 +0200
Subject: [PATCH 0621/1374] =?UTF-8?q?=D8=A8=D8=A7=D9=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ug/fixspuriousaux.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
index c03a0e5a..8eae5f19 100644
--- a/udapi/block/ud/ug/fixspuriousaux.py
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -15,7 +15,8 @@ def process_node(self, node):
             # چىق = go out
             # يۈر = walk (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)
             # ئولتۇر = sit (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)
-            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر)$', node.lemma):
+            # باق = to do ever?
+            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر|باق)$', node.lemma):
                 node.upos = 'VERB'
                 # The auxiliary inherits the incoming relation of its original parent.
                 lexverb = node.parent

From 8bc5af7019a62220f7480b9f13abccabff801ab6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Jun 2022 10:08:17 +0200
Subject: [PATCH 0622/1374] It does not work if we require upos=AUX.

---
 udapi/block/ud/ug/fixspuriousaux.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
index 8eae5f19..8ea1227e 100644
--- a/udapi/block/ud/ug/fixspuriousaux.py
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -10,7 +10,9 @@ def process_node(self, node):
         Some verbs that are called auxiliary by the traditional grammar, should
         be analyzed in UD as VERB + non-finite xcomp.
         """
-        if node.upos == 'AUX' and node.udeprel == 'aux':
+        # Sometimes there is a double error: it should not be auxiliary, it is
+        # attached as aux but it is not tagged AUX. So we only look at the deprel.
+        if node.udeprel == 'aux':
             # بەر = give (used with actions done for the benefit of somebody)
             # چىق = go out
             # يۈر = walk (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)

From b679662a77d3f8735521a57f2190512a8f272a70 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Jun 2022 10:18:53 +0200
Subject: [PATCH 0623/1374] _

---
 udapi/block/ud/ug/fixspuriousaux.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
index 8ea1227e..78cb86ec 100644
--- a/udapi/block/ud/ug/fixspuriousaux.py
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -18,7 +18,9 @@ def process_node(self, node):
             # يۈر = walk (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)
             # ئولتۇر = sit (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)
             # باق = to do ever?
-            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر|باق)$', node.lemma):
+            # ئۆت = pass
+            # _ ... some putative auxiliaries do not even have a lemma
+            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر|باق|ئۆت|_)$', node.lemma):
                 node.upos = 'VERB'
                 # The auxiliary inherits the incoming relation of its original parent.
                 lexverb = node.parent

From 9003c324882539ba6201a7a18be22a08328d2c17 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Jun 2022 10:57:43 +0200
Subject: [PATCH 0624/1374] =?UTF-8?q?=D8=A8=D8=A7=D8=B4=D9=84=D9=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ug/fixspuriousaux.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
index 78cb86ec..da40074e 100644
--- a/udapi/block/ud/ug/fixspuriousaux.py
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -19,8 +19,10 @@ def process_node(self, node):
             # ئولتۇر = sit (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)
             # باق = to do ever?
             # ئۆت = pass
+            # كۆرۈش = see
+            # باشلى = start
             # _ ... some putative auxiliaries do not even have a lemma
-            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر|باق|ئۆت|_)$', node.lemma):
+            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش)$', node.lemma):
                 node.upos = 'VERB'
                 # The auxiliary inherits the incoming relation of its original parent.
                 lexverb = node.parent

From d97891b9053ad9e2f7bd14337e43e579768688a0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Jun 2022 11:01:08 +0200
Subject: [PATCH 0625/1374] =?UTF-8?q?=D8=A8=D8=A7=D8=B4=D9=84=D9=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ug/fixspuriousaux.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
index da40074e..4e620a2e 100644
--- a/udapi/block/ud/ug/fixspuriousaux.py
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -22,7 +22,7 @@ def process_node(self, node):
             # كۆرۈش = see
             # باشلى = start
             # _ ... some putative auxiliaries do not even have a lemma
-            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش)$', node.lemma):
+            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش|باشلى)$', node.lemma):
                 node.upos = 'VERB'
                 # The auxiliary inherits the incoming relation of its original parent.
                 lexverb = node.parent

From be9d3675600e7884ca77835412d392c8a6daf817 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Jun 2022 11:10:28 +0200
Subject: [PATCH 0626/1374] =?UTF-8?q?=D9=8A=DB=95=D8=AA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ug/fixspuriousaux.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
index 4e620a2e..7bc8f546 100644
--- a/udapi/block/ud/ug/fixspuriousaux.py
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -21,8 +21,9 @@ def process_node(self, node):
             # ئۆت = pass
             # كۆرۈش = see
             # باشلى = start
+            # يەت = be enough
             # _ ... some putative auxiliaries do not even have a lemma
-            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش|باشلى)$', node.lemma):
+            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش|باشلى|يەت)$', node.lemma):
                 node.upos = 'VERB'
                 # The auxiliary inherits the incoming relation of its original parent.
                 lexverb = node.parent

From dc347add2e736251b4822578dfc4566110e8b834 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Jun 2022 11:16:04 +0200
Subject: [PATCH 0627/1374] =?UTF-8?q?=D9=82=D8=A7=D9=8A=D8=AA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ug/fixspuriousaux.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
index 7bc8f546..4cc038dc 100644
--- a/udapi/block/ud/ug/fixspuriousaux.py
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -17,13 +17,14 @@ def process_node(self, node):
             # چىق = go out
             # يۈر = walk (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)
             # ئولتۇر = sit (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)
-            # باق = to do ever?
+            # باق = do ever?
             # ئۆت = pass
             # كۆرۈش = see
             # باشلى = start
             # يەت = be enough
+            # قايت = return
             # _ ... some putative auxiliaries do not even have a lemma
-            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش|باشلى|يەت)$', node.lemma):
+            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش|باشلى|يەت|قايت)$', node.lemma):
                 node.upos = 'VERB'
                 # The auxiliary inherits the incoming relation of its original parent.
                 lexverb = node.parent

From a6880f6a483d7f129159cd5a1f48f88e9a03dcbf Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Jun 2022 11:21:52 +0200
Subject: [PATCH 0628/1374] =?UTF-8?q?=DA=86=DB=88=D8=B4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ug/fixspuriousaux.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
index 4cc038dc..9ccff72c 100644
--- a/udapi/block/ud/ug/fixspuriousaux.py
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -23,8 +23,9 @@ def process_node(self, node):
             # باشلى = start
             # يەت = be enough
             # قايت = return
+            # چۈش = fall down
             # _ ... some putative auxiliaries do not even have a lemma
-            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش|باشلى|يەت|قايت)$', node.lemma):
+            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش|باشلى|يەت|قايت|چۈش)$', node.lemma):
                 node.upos = 'VERB'
                 # The auxiliary inherits the incoming relation of its original parent.
                 lexverb = node.parent

From 470cd271e3812591f78f7ddf0d651d4571c46428 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Jun 2022 11:31:27 +0200
Subject: [PATCH 0629/1374] =?UTF-8?q?=D8=A8=D8=A7=D8=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ug/fixspuriousaux.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
index 9ccff72c..bfbf8816 100644
--- a/udapi/block/ud/ug/fixspuriousaux.py
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -13,7 +13,7 @@ def process_node(self, node):
         # Sometimes there is a double error: it should not be auxiliary, it is
         # attached as aux but it is not tagged AUX. So we only look at the deprel.
         if node.udeprel == 'aux':
-            # بەر = give (used with actions done for the benefit of somebody)
+            # بەر/بار = give (used with actions done for the benefit of somebody)
             # چىق = go out
             # يۈر = walk (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)
             # ئولتۇر = sit (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)
@@ -25,7 +25,7 @@ def process_node(self, node):
             # قايت = return
             # چۈش = fall down
             # _ ... some putative auxiliaries do not even have a lemma
-            if re.match(r'^(بەر|چىق|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش|باشلى|يەت|قايت|چۈش)$', node.lemma):
+            if re.match(r'^(بەر|بار|چىق|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش|باشلى|يەت|قايت|چۈش)$', node.lemma):
                 node.upos = 'VERB'
                 # The auxiliary inherits the incoming relation of its original parent.
                 lexverb = node.parent

From 558bf49fe425f477671034eaef69c0bc67de8253 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Jun 2022 11:36:37 +0200
Subject: [PATCH 0630/1374] =?UTF-8?q?=D9=82=D9=89=D9=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ug/fixspuriousaux.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
index bfbf8816..dc06ade7 100644
--- a/udapi/block/ud/ug/fixspuriousaux.py
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -24,8 +24,9 @@ def process_node(self, node):
             # يەت = be enough
             # قايت = return
             # چۈش = fall down
+            # قىل = do
             # _ ... some putative auxiliaries do not even have a lemma
-            if re.match(r'^(بەر|بار|چىق|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش|باشلى|يەت|قايت|چۈش)$', node.lemma):
+            if re.match(r'^(بەر|بار|چىق|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش|باشلى|يەت|قايت|چۈش|قىل)$', node.lemma):
                 node.upos = 'VERB'
                 # The auxiliary inherits the incoming relation of its original parent.
                 lexverb = node.parent

From a9e39f6fe8c7dd2ef3f8d77d188b77f9ce0b073e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Jun 2022 11:49:11 +0200
Subject: [PATCH 0631/1374] =?UTF-8?q?=D9=83=D9=89=D8=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ug/fixspuriousaux.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ug/fixspuriousaux.py b/udapi/block/ud/ug/fixspuriousaux.py
index dc06ade7..952644f8 100644
--- a/udapi/block/ud/ug/fixspuriousaux.py
+++ b/udapi/block/ud/ug/fixspuriousaux.py
@@ -15,6 +15,7 @@ def process_node(self, node):
         if node.udeprel == 'aux':
             # بەر/بار = give (used with actions done for the benefit of somebody)
             # چىق = go out
+            # چىقىش = come out
             # يۈر = walk (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)
             # ئولتۇر = sit (the equivalent in Kazakh is considered to be a progressive auxiliary but it does not seem to be the case in Uyghur)
             # باق = do ever?
@@ -25,8 +26,12 @@ def process_node(self, node):
             # قايت = return
             # چۈش = fall down
             # قىل = do
+            # چاپ = jump
+            # قورق = fear
+            # كەلتۈر = cause
+            # كىر = enter
             # _ ... some putative auxiliaries do not even have a lemma
-            if re.match(r'^(بەر|بار|چىق|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش|باشلى|يەت|قايت|چۈش|قىل)$', node.lemma):
+            if re.match(r'^(بەر|بار|چىق|چىقىش|يۈر|ئولتۇر|باق|ئۆت|_|كۆرۈش|باشلى|يەت|قايت|چۈش|قىل|چاپ|قورق|كەلتۈر|كىر)$', node.lemma):
                 node.upos = 'VERB'
                 # The auxiliary inherits the incoming relation of its original parent.
                 lexverb = node.parent

From 56b9dc693f1a928a719ae98eae253321bbdbf2a0 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 13 Jun 2022 20:37:38 +0200
Subject: [PATCH 0632/1374] even single-sentence docs should have
 `meta["loaded_from"]`

---
 udapi/core/basereader.py       | 1 +
 udapi/core/tests/test_coref.py | 1 +
 2 files changed, 2 insertions(+)

diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 9210b910..53a1129c 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -177,6 +177,7 @@ def process_document(self, document):
                 if root.newdoc and root.newdoc is not True:
                     document.meta["docname"] = root.newdoc
                 document.meta['global.Entity'] = self._global_entity
+                document.meta['loaded_from'] = self.filename
 
             filehandle = self.filehandle
             if filehandle is None:
diff --git a/udapi/core/tests/test_coref.py b/udapi/core/tests/test_coref.py
index e0998b75..8952d6d8 100755
--- a/udapi/core/tests/test_coref.py
+++ b/udapi/core/tests/test_coref.py
@@ -21,6 +21,7 @@ def test_load(self):
         self.assertEqual(len(node.coref_entities), 1)
         self.assertEqual(len(node.coref_mentions), 1)
         self.assertEqual(node.coref_entities[0], coref_entities[0])
+        self.assertEqual(docs[-1].meta["loaded_from"], data_filename)
 
     def test_edits(self):
         data_filename = os.path.join(os.path.dirname(__file__), 'data', 'fr-democrat-dev-sample.conllu')

From 3df722c2b9f63732efab41aa095a4922b98b088b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 14 Jun 2022 13:22:34 +0200
Subject: [PATCH 0633/1374] We no longer use a global list of required/allowed
 features per UPOS.

---
 udapi/block/ud/cs/markfeatsbugs.py | 30 ------------------------------
 1 file changed, 30 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index e027d1cb..d7854982 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -9,36 +9,6 @@
 
 class MarkFeatsBugs(Block):
 
-    allowed = {
-        'NOUN': {'Gender': ['Masc', 'Fem', 'Neut'],
-                 'Animacy': ['Anim', 'Inan'],
-                 'Number': ['Sing', 'Dual', 'Plur'],
-                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                 'Polarity': ['Pos', 'Neg'],
-                 'Foreign': ['Yes']},
-        'ADJ':  {'Gender': ['Masc', 'Fem', 'Neut'],
-                 'Animacy': ['Anim', 'Inan'],
-                 'Number': ['Sing', 'Dual', 'Plur'],
-                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                 'Degree': ['Pos', 'Cmp', 'Sup'],
-                 'Polarity': ['Pos', 'Neg'],
-                 'Variant': ['Short'],
-                 'Poss': ['Yes'],
-                 'Gender[psor]': ['Masc', 'Fem'],
-                 'NameType': ['Giv', 'Sur'], # for possessive adjectives derived from personal names
-                 'NumType': ['Ord'],
-                 'VerbForm': ['Part'],
-                 'Aspect': ['Imp', 'Perf'],
-                 'Tense': ['Pres', 'Past'],
-                 'Voice': ['Act', 'Pass'],
-                 'Foreign': ['Yes']}
-    }
-
-    required = {
-        'NOUN': ['Gender', 'Number', 'Case', 'Polarity'],
-        'ADJ': ['Gender', 'Number', 'Case', 'Degree', 'Polarity']
-    }
-
     def bug(self, node, bugstring):
         bugs = []
         if node.misc['Bug']:

From 2d0425ac2deda455e42aadb88093171ba394d2d6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 14 Jun 2022 22:18:20 +0200
Subject: [PATCH 0634/1374] Better checking of required and allowed features in
 Czech.

---
 udapi/block/ud/cs/markfeatsbugs.py | 327 ++++++++++++-----------------
 1 file changed, 135 insertions(+), 192 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index d7854982..b7b6c5b1 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -9,6 +9,18 @@
 
 class MarkFeatsBugs(Block):
 
+    # The convention used in PDT is not consistent. Adjectives are fully disambiguated
+    # (three genders, two animacies, three numbers, seven cases), even though some
+    # forms are shared among many feature combinations. On the other hand, pronouns
+    # and determiners omit some features in the context of certain values of other
+    # features (e.g., gender and animacy are not distinguished in plural if the case
+    # is genitive, dative, locative or instrumental).
+    # In contrast, ČNK (CNC) fully disambiguates pronouns and determiners just like
+    # adjectives.
+    # Here we can trigger one of the two conventions. It should become a block parameter
+    # in the future.
+    pdt20 = False # True = like in PDT 2.0; False = like in ČNK
+
     def bug(self, node, bugstring):
         bugs = []
         if node.misc['Bug']:
@@ -231,60 +243,29 @@ def process_node(self, node):
                         'Variant': ['Short']
                     })
                 else: # not reflexive
-                    self.check_required_features(node, ['PronType', 'Person', 'Number', 'Case'])
-                    if node.feats['Person'] == '3':
-                        if re.match(r'^(Nom|Voc)$', node.feats['Case']):
-                            self.check_required_features(node, ['Gender'])
-                            # In PDT, animacy of personal pronouns is distinguished only for Person=3 Case=Nom Gender=Masc Number=Plur ('oni' vs. 'ony').
-                            # So we will neither require nor allow it in singular and dual.
-                            if node.feats['Gender'] == 'Masc' and node.feats['Number'] == 'Plur':
-                                self.check_required_features(node, ['Animacy'])
-                                self.check_allowed_features(node, {
-                                    'PronType': ['Prs'],
-                                    'Person': ['3'],
-                                    'Gender': ['Masc'],
-                                    'Animacy': ['Anim', 'Inan'],
-                                    'Number': ['Plur'],
-                                    'Case': ['Nom', 'Voc']
-                                })
-                            else: # on, ona, ono, ony (Fem Plur)
-                                self.check_allowed_features(node, {
-                                    'PronType': ['Prs'],
-                                    'Person': ['3'],
-                                    'Gender': ['Masc', 'Fem', 'Neut'],
-                                    'Number': ['Sing', 'Dual', 'Plur'],
-                                    'Case': ['Nom', 'Voc']
-                                })
-                        else: # non-nominatives also have PrepCase
+                    if node.feats['Person'] == '3': # on, ona, ono, oni, ony
+                        if re.match(r'^(Nom|Voc)$', node.feats['Case']): # on, ona, ono, oni, ony
+                            self.check_adjective_like(node, ['PronType', 'Person'], {
+                                'PronType': ['Prs'],
+                                'Person': ['3']
+                            })
+                        else: # jeho, něho, jemu, němu, jej, něj, něm, jím, ním, jí, ní, ji, ni, je, ně
                             # Mostly only two gender groups and no animacy:
                             # Masc,Neut ... jeho, jemu, jej, něm, jím
                             # Fem ... jí, ji, ní
                             # Neut ... je
-                            self.check_required_features(node, ['PrepCase'])
-                            if node.feats['Number'] == 'Sing':
-                                self.check_required_features(node, ['Gender'])
-                                self.check_allowed_features(node, {
-                                    'PronType': ['Prs'],
-                                    'Person': ['3'],
-                                    'Gender': ['Masc,Neut', 'Fem', 'Neut'],
-                                    'Number': ['Sing'],
-                                    'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins'],
-                                    'PrepCase': ['Npr', 'Pre']
-                                })
                             # No gender in dual and plural:
                             # Plur ... jich, jim, je, nich, jimi
-                            else:
-                                self.check_allowed_features(node, {
-                                    'PronType': ['Prs'],
-                                    'Person': ['3'],
-                                    'Number': ['Dual', 'Plur'],
-                                    'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins'],
-                                    'PrepCase': ['Npr', 'Pre']
-                                })
-                    else: # 1st and 2nd person do not have gender
+                            self.check_adjective_like(node, ['PronType', 'Person', 'PrepCase'], {
+                                'PronType': ['Prs'],
+                                'Person': ['3'],
+                                'PrepCase': ['Npr', 'Pre']
+                            })
+                    else: # 1st and 2nd person do not have gender: já, ty
+                        self.check_required_features(node, ['PronType', 'Person', 'Number', 'Case'])
                         self.check_allowed_features(node, {
                             'PronType': ['Prs'],
-                            'Person': ['1', '2', '3'],
+                            'Person': ['1', '2'],
                             'Number': ['Sing', 'Dual', 'Plur'],
                             'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                             'Variant': ['Short']
@@ -337,44 +318,10 @@ def process_node(self, node):
                 # Unlike 'on', 'jenž' has the feature PrepCase everywhere, even
                 # in the nominative, although there is no prepositional counter-
                 # part (but similarly the locative has no prepositionless form).
-                if node.feats['Case'] == 'Nom':
-                    if node.feats['Gender'] == 'Masc' and node.feats['Number'] == 'Plur':
-                        self.check_required_features(node, ['PronType', 'Gender', 'Animacy', 'Number', 'Case', 'PrepCase'])
-                        self.check_allowed_features(node, {
-                            'PronType': ['Rel'],
-                            'Gender': ['Masc'],
-                            'Animacy': ['Anim', 'Inan'],
-                            'Number': ['Plur'],
-                            'Case': ['Nom'],
-                            'PrepCase': ['Npr', 'Pre']
-                        })
-                    else: # not Masc Plur
-                        self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case', 'PrepCase'])
-                        self.check_allowed_features(node, {
-                            'PronType': ['Rel'],
-                            'Gender': ['Masc', 'Fem', 'Neut'],
-                            'Number': ['Sing', 'Dual', 'Plur'],
-                            'Case': ['Nom'],
-                            'PrepCase': ['Npr', 'Pre']
-                        })
-                else: # not Case=Nom
-                    if node.feats['Number'] == 'Sing':
-                        self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case', 'PrepCase'])
-                        self.check_allowed_features(node, {
-                            'PronType': ['Rel'],
-                            'Gender': ['Masc,Neut', 'Fem'],
-                            'Number': ['Sing'],
-                            'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins'],
-                            'PrepCase': ['Npr', 'Pre']
-                        })
-                    else: # non-nominative dual or plural: jichž, nichž, jimž, nimž, jež, něž, jimiž, nimiž
-                        self.check_required_features(node, ['PronType', 'Number', 'Case', 'PrepCase'])
-                        self.check_allowed_features(node, {
-                            'PronType': ['Rel'],
-                            'Number': ['Dual', 'Plur'],
-                            'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins'],
-                            'PrepCase': ['Npr', 'Pre']
-                        })
+                self.check_adjective_like(node, ['PronType', 'PrepCase'], {
+                    'PronType': ['Rel'],
+                    'PrepCase': ['Npr', 'Pre']
+                })
             else:
                 # What remains is the relative pronoun 'an'. It behaves similarly
                 # to 'jenž' but it does not have the PrepCase feature and it
@@ -439,107 +386,15 @@ def process_node(self, node):
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
             elif node.feats['Poss'] == 'Yes': # 'můj', 'tvůj', 'svůj'
-                # Gender is annotated in all cases in singular (můj, má, mé)
-                # but only in nominative, accusative, and vocative in plural
-                # (Nom/Voc mí, mé, má; Acc mé, má). Animacy is distinguished
-                # in plural if gender is distinguished and masculine; in
-                # singular it is distinguished only in accusative (mého, můj).
-                # Other cases in plural are gender-less (mých, mým, mými).
-                # Note that this is not consistent with adjectives, where we
-                # disambiguate gender in all cases in plural.
-                if node.feats['Number'] == 'Sing':
-                    self.check_required_features(node, ['PronType', 'Poss', 'Gender', 'Number', 'Case'])
-                    if node.feats['Gender'] == 'Masc' and node.feats['Case'] == 'Acc':
-                        self.check_required_features(node, ['Animacy'])
-                        self.check_allowed_features(node, {
-                            'PronType': ['Prs'],
-                            'Poss': ['Yes'],
-                            'Reflex': ['Yes'],
-                            'Person': ['1', '2'], # only if not reflexive
-                            'Number[psor]': ['Sing', 'Plur'], # only if not reflexive
-                            'Gender': ['Masc'],
-                            'Animacy': ['Anim', 'Inan'],
-                            'Number': ['Sing'],
-                            'Case': ['Acc']
-                        })
-                    else:
-                        self.check_allowed_features(node, {
-                            'PronType': ['Prs'],
-                            'Poss': ['Yes'],
-                            'Reflex': ['Yes'],
-                            'Person': ['1', '2'], # only if not reflexive
-                            'Number[psor]': ['Sing', 'Plur'], # only if not reflexive
-                            'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'],
-                            'Number': ['Sing'],
-                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                        })
-                elif re.match(r'^(Nom|Acc|Voc)$', node.feats['Case']):
-                    self.check_required_features(node, ['PronType', 'Poss', 'Gender', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'PronType': ['Prs'],
-                        'Poss': ['Yes'],
-                        'Reflex': ['Yes'],
-                        'Person': ['1', '2'], # only if not reflexive
-                        'Number[psor]': ['Sing', 'Plur'], # only if not reflexive
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Animacy': ['Anim', 'Inan'],
-                        'Number': ['Dual', 'Plur'],
-                        'Case': ['Nom', 'Acc', 'Voc']
-                    })
-                else:
-                    self.check_required_features(node, ['PronType', 'Poss', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'PronType': ['Prs'],
-                        'Poss': ['Yes'],
-                        'Reflex': ['Yes'],
-                        'Person': ['1', '2'], # only if not reflexive
-                        'Number[psor]': ['Sing', 'Plur'], # only if not reflexive
-                        'Number': ['Dual', 'Plur'],
-                        'Case': ['Gen', 'Dat', 'Loc', 'Ins']
-                    })
+                self.check_adjective_like(node, ['PronType', 'Poss'], {
+                    'PronType': ['Prs'],
+                    'Poss': ['Yes'],
+                    'Reflex': ['Yes'],
+                    'Person': ['1', '2'], # only if not reflexive
+                    'Number[psor]': ['Sing', 'Plur'] # only if not reflexive
+                })
             else:
-                # Gender is annotated in all cases in singular (ten, ta, to)
-                # but only in nominative, accusative, and vocative in plural
-                # (Nom/Voc ti, ty, ta; Acc ty, ta). Animacy is distinguished
-                # in plural if gender is distinguished and masculine; in
-                # singular it is distinguished only in accusative (toho, ten).
-                # Other cases in plural are gender-less (těch, těm, těmi).
-                # Note that this is not consistent with adjectives, where we
-                # disambiguate gender in all cases in plural.
-                if node.feats['Number'] == 'Sing':
-                    self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case'])
-                    if node.feats['Gender'] == 'Masc' and node.feats['Case'] == 'Acc':
-                        self.check_required_features(node, ['Animacy'])
-                        self.check_allowed_features(node, {
-                            'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
-                            'Gender': ['Masc'],
-                            'Animacy': ['Anim', 'Inan'],
-                            'Number': ['Sing'],
-                            'Case': ['Acc']
-                        })
-                    else:
-                        self.check_allowed_features(node, {
-                            'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
-                            'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # non-nominative forms of Masc and Neut are merged; Fem,Neut is e.g. 'vaše' in singular
-                            'Number': ['Sing'],
-                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                        })
-                elif re.match(r'^(Nom|Acc|Voc)$', node.feats['Case']):
-                    self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Animacy': ['Anim', 'Inan'],
-                        'Number': ['Dual', 'Plur'],
-                        'Case': ['Nom', 'Acc', 'Voc']
-                    })
-                else:
-                    self.check_required_features(node, ['PronType', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
-                        'Number': ['Dual', 'Plur'],
-                        'Case': ['Gen', 'Dat', 'Loc', 'Ins']
-                    })
+                self.check_adjective_like(node, ['PronType'], {'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp']})
         # NUMERALS #############################################################
         elif node.upos == 'NUM':
             self.check_required_features(node, ['NumType', 'NumForm'])
@@ -568,14 +423,25 @@ def process_node(self, node):
                     })
                 elif re.match(r'^(dva|oba)$', node.lemma):
                     self.check_required_features(node, ['NumType', 'NumForm', 'NumValue', 'Gender', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'NumType': ['Card'],
-                        'NumForm': ['Word'],
-                        'NumValue': ['1,2,3'],
-                        'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # similarly to determiners, genders are merged in some slots of the paradigm
-                        'Number': ['Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                    })
+                    if self.pdt20:
+                        self.check_allowed_features(node, {
+                            'NumType': ['Card'],
+                            'NumForm': ['Word'],
+                            'NumValue': ['1,2,3'],
+                            'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # similarly to determiners, genders are merged in some slots of the paradigm
+                            'Number': ['Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                        })
+                    else:
+                        self.check_allowed_features(node, {
+                            'NumType': ['Card'],
+                            'NumForm': ['Word'],
+                            'NumValue': ['1,2,3'],
+                            'Gender': ['Masc', 'Fem', 'Neut'],
+                            'Animacy': ['Anim', 'Inan'],
+                            'Number': ['Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                        })
                 else:
                     self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
                     self.check_allowed_features(node, {
@@ -686,3 +552,80 @@ def process_node(self, node):
         # THE REST: NO FEATURES ################################################
         else:
             self.check_allowed_features(node, {})
+
+    def check_adjective_like(self, node, r0, a0):
+        """
+        Long form of adjectives, pronouns and determiners mostly share declension
+        paradigms and thus the sets of features that are expected. Whether the
+        actual feature sets are the same depends on the tagging convention (PDT
+        vs. ČNK): in PDT, adjectives are fully disambiguated while pronouns are
+        not; in ČNK, both adjectives and pronouns (incl. determiners) are fully
+        disambiguated. This method defines the core inflectional features while
+        any extras (such as PronType for pronouns) have to be provided by the
+        caller in parameters r0 (list) and a0 (dict).
+        """
+        required_features = []
+        allowed_featurs = {}
+        full_set = node.upos == 'ADJ' or not self.pdt20
+        if full_set:
+            # Even in the full set, animacy is only distinguished for the
+            # masculine gender.
+            if node.feats['Gender'] == 'Masc':
+                required_features = ['Gender', 'Animacy', 'Number', 'Case']
+                allowed_features = {
+                    'Gender': ['Masc'],
+                    'Animacy': ['Anim', 'Inan'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                }
+            else:
+                required_features = ['Gender', 'Number', 'Case']
+                allowed_features = {
+                    'Gender': ['Fem', 'Neut'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                }
+        else:
+            # Gender is annotated in all cases in singular (ten, ta, to)
+            # but only in nominative, accusative, and vocative in plural
+            # (Nom/Voc ti, ty, ta; Acc ty, ta). Animacy is distinguished
+            # in plural if gender is distinguished and it is masculine; in
+            # singular it is distinguished only in accusative (toho, ten).
+            # Other cases in plural are gender-less (těch, těm, těmi).
+            # Note that this is not consistent with adjectives, where we
+            # disambiguate gender in all cases in plural.
+            if node.feats['Number'] == 'Sing':
+                if node.feats['Gender'] == 'Masc' and node.feats['Case'] == 'Acc':
+                    required_features = ['Gender', 'Animacy', 'Number', 'Case']
+                    allowed_features = {
+                        'Gender': ['Masc'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing'],
+                        'Case': ['Acc']
+                    }
+                else:
+                    required_features = ['Gender', 'Number', 'Case']
+                    allowed_features = {
+                        'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # non-nominative forms of Masc and Neut are merged; Fem,Neut is e.g. 'vaše' in singular
+                        'Number': ['Sing'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    }
+            elif re.match(r'^(Nom|Acc|Voc)$', node.feats['Case']):
+                required_features = ['Gender', 'Number', 'Case']
+                allowed_features = {
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Animacy': ['Anim', 'Inan'],
+                    'Number': ['Dual', 'Plur'],
+                    'Case': ['Nom', 'Acc', 'Voc']
+                }
+            else:
+                required_features = ['Number', 'Case']
+                allowed_features = {
+                    'Number': ['Dual', 'Plur'],
+                    'Case': ['Gen', 'Dat', 'Loc', 'Ins']
+                }
+        required_features = r0 + required_features
+        a0.update(allowed_features)
+        allowed_features = a0
+        self.check_required_features(node, required_features)
+        self.check_allowed_features(node, allowed_features)

From 84334251ee1954fb42ec8cb570a38800262b68d7 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 15 Jun 2022 10:12:55 +0200
Subject: [PATCH 0635/1374] Distinguish reflexive and irreflexive possessives.

---
 udapi/block/ud/cs/markfeatsbugs.py | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index b7b6c5b1..78acc6f8 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -386,13 +386,19 @@ def process_node(self, node):
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
             elif node.feats['Poss'] == 'Yes': # 'můj', 'tvůj', 'svůj'
-                self.check_adjective_like(node, ['PronType', 'Poss'], {
-                    'PronType': ['Prs'],
-                    'Poss': ['Yes'],
-                    'Reflex': ['Yes'],
-                    'Person': ['1', '2'], # only if not reflexive
-                    'Number[psor]': ['Sing', 'Plur'] # only if not reflexive
-                })
+                if node.feats['Reflex'] == 'Yes':
+                    self.check_adjective_like(node, ['PronType', 'Poss', 'Reflex'], {
+                        'PronType': ['Prs'],
+                        'Poss': ['Yes'],
+                        'Reflex': ['Yes']
+                    })
+                else:
+                    self.check_adjective_like(node, ['PronType', 'Poss', 'Person', 'Number[psor]'], {
+                        'PronType': ['Prs'],
+                        'Poss': ['Yes'],
+                        'Person': ['1', '2'],
+                        'Number[psor]': ['Sing', 'Plur']
+                    })
             else:
                 self.check_adjective_like(node, ['PronType'], {'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp']})
         # NUMERALS #############################################################

From 4facb6d760aa0e0aaacf55f4b699076bf39b2cb8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 15 Jun 2022 14:26:18 +0200
Subject: [PATCH 0636/1374] Animacy only for masculine gender, also for
 participles.

---
 udapi/block/ud/cs/markfeatsbugs.py | 36 ++++++++++++++++++++----------
 1 file changed, 24 insertions(+), 12 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 78acc6f8..11ecd6d9 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -508,24 +508,36 @@ def process_node(self, node):
                         'Variant': ['Short', 'Long'] # distinguishes sigmatic (Long) and asigmatic (Short) aorist
                     })
             elif node.feats['VerbForm'] == 'Part': # only l-participle; the others are ADJ, not VERB
-                self.check_required_features(node, ['Tense', 'Gender', 'Number', 'Voice', 'Polarity'])
-                self.check_allowed_features(node, {
-                    'Aspect': ['Imp', 'Perf'],
-                    'VerbForm': ['Part'],
-                    'Tense': ['Past'],
-                    'Voice': ['Act'], # passive participle is ADJ, so we will not encounter it under VERB
-                    'Number': ['Sing', 'Dual', 'Plur'],
-                    'Gender': ['Masc', 'Fem', 'Neut'],
-                    'Animacy': ['Anim', 'Inan'],
-                    'Polarity': ['Pos', 'Neg']
-                })
+                if node.feats['Gender'] == 'Masc':
+                    self.check_required_features(node, ['Tense', 'Gender', 'Animacy', 'Number', 'Voice', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf'],
+                        'VerbForm': ['Part'],
+                        'Tense': ['Past'],
+                        'Voice': ['Act'], # passive participle is ADJ, so we will not encounter it under VERB
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Gender': ['Masc'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Polarity': ['Pos', 'Neg']
+                    })
+                else:
+                    self.check_required_features(node, ['Tense', 'Gender', 'Number', 'Voice', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf'],
+                        'VerbForm': ['Part'],
+                        'Tense': ['Past'],
+                        'Voice': ['Act'], # passive participle is ADJ, so we will not encounter it under VERB
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Gender': ['Fem', 'Neut'],
+                        'Polarity': ['Pos', 'Neg']
+                    })
             else: # converb
                 self.check_required_features(node, ['Tense', 'Number', 'Voice', 'Polarity'])
                 self.check_allowed_features(node, {
                     'Aspect': ['Imp', 'Perf'],
                     'VerbForm': ['Conv'],
                     'Tense': ['Past', 'Pres'],
-                    'Voice': ['Act'], # passive participle is ADJ, so we will not encounter it under VERB
+                    'Voice': ['Act'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Gender': ['Masc', 'Fem', 'Neut'], # annotated only in singular, and no animacy
                     'Polarity': ['Pos', 'Neg']

From 3feff237f673d9a65434af5241e3cb317b6c4820 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 21 Jun 2022 11:24:49 +0200
Subject: [PATCH 0637/1374] more Windows friendly

---
 udapi/core/resource.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/core/resource.py b/udapi/core/resource.py
index 9e5923f1..ae7320c6 100644
--- a/udapi/core/resource.py
+++ b/udapi/core/resource.py
@@ -12,7 +12,9 @@ def require_file(path):
             raise IOError(path + " does not exist")
         return os.path.abspath(path)
     udapi_data = os.environ.get('UDAPI_DATA', os.environ.get('HOME'))
-    full_path = udapi_data + '/' + path
+    if udapi_data is None:
+        raise IOError(f"Empty environment vars: UDAPI_DATA={os.environ.get('UDAPI_DATA')} HOME={os.environ.get('HOME')}")
+    full_path = os.path.join(udapi_data, path)
     if not os.path.isfile(full_path):
         logging.info('Downloading %s to %s', BASEURL + path, full_path)
         os.makedirs(os.path.dirname(full_path), exist_ok=True)

From 4178f18d5d7527c23eea23126d8d93de0087208c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 22 Jun 2022 01:51:32 +0200
Subject: [PATCH 0638/1374] os.environ.get('HOME') does not work on Windows

---
 udapi/core/resource.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/udapi/core/resource.py b/udapi/core/resource.py
index ae7320c6..da2ba561 100644
--- a/udapi/core/resource.py
+++ b/udapi/core/resource.py
@@ -2,6 +2,7 @@
 import logging
 import urllib.request
 import os
+from os.path import expanduser
 
 BASEURL = 'http://ufallab.ms.mff.cuni.cz/tectomt/share/data/'
 
@@ -11,9 +12,9 @@ def require_file(path):
         if not os.path.isfile(path):
             raise IOError(path + " does not exist")
         return os.path.abspath(path)
-    udapi_data = os.environ.get('UDAPI_DATA', os.environ.get('HOME'))
+    udapi_data = os.environ.get('UDAPI_DATA', expanduser('~'))
     if udapi_data is None:
-        raise IOError(f"Empty environment vars: UDAPI_DATA={os.environ.get('UDAPI_DATA')} HOME={os.environ.get('HOME')}")
+        raise IOError(f"Empty environment vars: UDAPI_DATA={os.environ.get('UDAPI_DATA')} HOME={expanduser('~')}")
     full_path = os.path.join(udapi_data, path)
     if not os.path.isfile(full_path):
         logging.info('Downloading %s to %s', BASEURL + path, full_path)

From b3f5dca4c0dfbe3e4f2fb6850a37fd41c745a0dd Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 27 Jul 2022 09:31:14 +0200
Subject: [PATCH 0639/1374] Catch more MWTs in Marathi.

---
 udapi/block/ud/mr/addformsinmwt.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/mr/addformsinmwt.py b/udapi/block/ud/mr/addformsinmwt.py
index 7077e665..bd63ee7d 100644
--- a/udapi/block/ud/mr/addformsinmwt.py
+++ b/udapi/block/ud/mr/addformsinmwt.py
@@ -66,7 +66,8 @@ def process_node(self, node):
                         logging.info("Cannot decompose %s+ADP multiword token '%s'. Part lemmas are '%s' and '%s'." % (mwt.words[0].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma))
             elif len(mwt.words) == 3 and re.match(r'^(ADP|PART)$', mwt.words[1].upos) and re.match(r'^(ADP|PART)$', mwt.words[2].upos):
                 # Compound postpositions where the middle word is the possessive 'चा'.
-                if mwt.words[1].lemma == 'चा':
+                # The lemma of the middle word should be 'चा' but sometimes it is 'च्या'.
+                if re.match(r'^(चा|च्या)$', mwt.words[1].lemma):
                     m = re.match(r'^(.+)(चा|ची|चे|च्या|चं)(.+)$', mwt.form)
                     m2 = re.match(r'^(माझ|तुझ|आपल)(ा|ी|े|्या)(.+)$', mwt.form)
                     if m:
@@ -74,6 +75,7 @@ def process_node(self, node):
                             node.form = m.group(1)
                         elif node == mwt.words[1]:
                             node.form = m.group(2)
+                            node.lemma = 'चा'
                         else:
                             node.form = m.group(3)
                     elif m2:
@@ -81,9 +83,12 @@ def process_node(self, node):
                             node.form = m2.group(1)
                         elif node == mwt.words[1]:
                             node.form = 'च' + m2.group(2)
+                            node.lemma = 'चा'
                         else:
                             node.form = m2.group(3)
                     else:
                         logging.info("Cannot decompose %s+%s+%s multiword token '%s'. Part lemmas are '%s', '%s', and '%s'." % (mwt.words[0].upos, mwt.words[1].upos, mwt.words[2].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma, mwt.words[1].lemma))
+                else:
+                    logging.info("Cannot decompose %s+%s+%s multiword token '%s'. Part lemmas are '%s', '%s', and '%s'." % (mwt.words[0].upos, mwt.words[1].upos, mwt.words[2].upos, mwt.form, mwt.words[0].lemma, mwt.words[1].lemma, mwt.words[1].lemma))
             else:
                 logging.info("Cannot decompose multiword token '%s' of %d parts: %s" % (mwt.form, len(mwt.words), str([x.lemma + '/' + x.upos for x in mwt.words])))

From db6ae9ba76de22af008021db6774e9e1c0db26ab Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 30 Jul 2022 11:09:48 +0200
Subject: [PATCH 0640/1374] Added a block to fix certain instances of duplicate
 subjects in Danish.

---
 udapi/block/ud/da/fixmultisubject.py | 56 ++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 udapi/block/ud/da/fixmultisubject.py

diff --git a/udapi/block/ud/da/fixmultisubject.py b/udapi/block/ud/da/fixmultisubject.py
new file mode 100644
index 00000000..7307f0cf
--- /dev/null
+++ b/udapi/block/ud/da/fixmultisubject.py
@@ -0,0 +1,56 @@
+"""
+Block ud.da.FixMultiSubject tries to fix some systemic instances of predicates
+that have more than one subject dependent.
+"""
+from udapi.core.block import Block
+
+class FixMultiSubject(Block):
+    """
+    Make sure that a predicate has at most one subject. Note that it can
+    only fix instances that follow certain pattern observed in the Danish
+    data.
+    """
+
+    def process_node(self, node):
+        subjects = [x for x in node.children if re.match(r'^[nc]subj$', x.udeprel)]
+        if len(subjects) > 1:
+            # Pattern 1: A node is is attached as xcomp to the current node, and
+            # one of the subjects is closer to that xcomp than to the current
+            # node.
+            xcompchildren = [x for x in node.children if x.udeprel == 'xcomp']
+            if len(subjects) == 2 and len(xcompchildren) == 1:
+                xcompnode = xcompchildren[0]
+                dn = [dist(node, x) for x in subjects]
+                dx = [dist(xcompnode, x) for x in subjects]
+                # Is the first subject closer to xcomp than it is to the current node?
+                # At the same time, is the second subject closer to the current node than it is to xcomp?
+                if dx[0] < dn[0] and dn[1] < dx[1]:
+                    # The first subject should be re-attached to the xcomp node.
+                    subjects[0].parent = xcompnode
+                    # There are typically other dependents that should belong to the xcomp node.
+                    for c in node.children:
+                        if dist(xcompnode, c) < dist(node, c):
+                            c.parent = xcompnode
+                    # The xcompnode should probably be attached as something else
+                    # than xcomp, perhaps even the direction of the relation should
+                    # be reversed, but one would have to resolve this manually.
+                    xcompnode.misc['ToDo'] = 'check-xcomp'
+                # Is the second subject closer to xcomp than it is to the current node?
+                # At the same time, is the first subject closer to the current node than it is to xcomp?
+                elif dx[1] < dn[1] and dn[0] < dx[0]:
+                    # The second subject should be re-attached to the xcomp node.
+                    subjects[1].parent = xcompnode
+                    # There are typically other dependents that should belong to the xcomp node.
+                    for c in node.children:
+                        if dist(xcompnode, c) < dist(node, c):
+                            c.parent = xcompnode
+                    # The xcompnode should probably be attached as something else
+                    # than xcomp, perhaps even the direction of the relation should
+                    # be reversed, but one would have to resolve this manually.
+                    xcompnode.misc['ToDo'] = 'check-xcomp'
+
+def dist(x, y):
+    d = x.ord - y.ord
+    if d < 0:
+        d = -d
+    return d

From 4c844704dbe939bc83096950e5bdfa839174b021 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 30 Jul 2022 11:11:33 +0200
Subject: [PATCH 0641/1374] Bug fix.

---
 udapi/block/ud/da/fixmultisubject.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/da/fixmultisubject.py b/udapi/block/ud/da/fixmultisubject.py
index 7307f0cf..a6709718 100644
--- a/udapi/block/ud/da/fixmultisubject.py
+++ b/udapi/block/ud/da/fixmultisubject.py
@@ -3,6 +3,7 @@
 that have more than one subject dependent.
 """
 from udapi.core.block import Block
+import re
 
 class FixMultiSubject(Block):
     """

From a3a8b808b93ecbbd01f616b37f31a046b417b945 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 30 Jul 2022 11:13:25 +0200
Subject: [PATCH 0642/1374] Bug fix.

---
 udapi/block/ud/da/fixmultisubject.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/da/fixmultisubject.py b/udapi/block/ud/da/fixmultisubject.py
index a6709718..90ab6b7b 100644
--- a/udapi/block/ud/da/fixmultisubject.py
+++ b/udapi/block/ud/da/fixmultisubject.py
@@ -30,7 +30,7 @@ def process_node(self, node):
                     subjects[0].parent = xcompnode
                     # There are typically other dependents that should belong to the xcomp node.
                     for c in node.children:
-                        if dist(xcompnode, c) < dist(node, c):
+                        if c != xcompnode and dist(xcompnode, c) < dist(node, c):
                             c.parent = xcompnode
                     # The xcompnode should probably be attached as something else
                     # than xcomp, perhaps even the direction of the relation should
@@ -43,7 +43,7 @@ def process_node(self, node):
                     subjects[1].parent = xcompnode
                     # There are typically other dependents that should belong to the xcomp node.
                     for c in node.children:
-                        if dist(xcompnode, c) < dist(node, c):
+                        if c != xcompnode and dist(xcompnode, c) < dist(node, c):
                             c.parent = xcompnode
                     # The xcompnode should probably be attached as something else
                     # than xcomp, perhaps even the direction of the relation should

From 575440891e7a4e49de2364b7524e7f6b46b3e95b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 30 Jul 2022 13:12:53 +0200
Subject: [PATCH 0643/1374] Another pattern for duplicite subjects in Danish.

---
 udapi/block/ud/da/fixmultisubject.py | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/udapi/block/ud/da/fixmultisubject.py b/udapi/block/ud/da/fixmultisubject.py
index 90ab6b7b..37fe5f13 100644
--- a/udapi/block/ud/da/fixmultisubject.py
+++ b/udapi/block/ud/da/fixmultisubject.py
@@ -19,6 +19,9 @@ def process_node(self, node):
             # one of the subjects is closer to that xcomp than to the current
             # node.
             xcompchildren = [x for x in node.children if x.udeprel == 'xcomp']
+            # Pattern 2: Similar to pattern 1, but advcl instead of xcomp, and
+            # possibly not so many other mis-attached dependents.
+            advclchildren = [x for x in node.children if x.udeprel == 'advcl']
             if len(subjects) == 2 and len(xcompchildren) == 1:
                 xcompnode = xcompchildren[0]
                 dn = [dist(node, x) for x in subjects]
@@ -49,6 +52,20 @@ def process_node(self, node):
                     # than xcomp, perhaps even the direction of the relation should
                     # be reversed, but one would have to resolve this manually.
                     xcompnode.misc['ToDo'] = 'check-xcomp'
+            elif len(subjects) == 2 and len(advclchildren) == 1:
+                advclnode = advclchildren[0]
+                dn = [dist(node, x) for x in subjects]
+                dx = [dist(xcompnode, x) for x in subjects]
+                # Is the first subject closer to advcl than it is to the current node?
+                # At the same time, is the second subject closer to the current node than it is to advcl?
+                if dx[0] < dn[0] and dn[1] < dx[1]:
+                    # The first subject should be re-attached to the advcl node.
+                    subjects[0].parent = advclnode
+                # Is the second subject closer to advcl than it is to the current node?
+                # At the same time, is the first subject closer to the current node than it is to advcl?
+                elif dx[1] < dn[1] and dn[0] < dx[0]:
+                    # The second subject should be re-attached to the xcomp node.
+                    subjects[1].parent = advclnode
 
 def dist(x, y):
     d = x.ord - y.ord

From d643b8d05eb698e1443b84321f2fbad4a99291ff Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 30 Jul 2022 13:14:31 +0200
Subject: [PATCH 0644/1374] Bug fix.

---
 udapi/block/ud/da/fixmultisubject.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/da/fixmultisubject.py b/udapi/block/ud/da/fixmultisubject.py
index 37fe5f13..142a51d9 100644
--- a/udapi/block/ud/da/fixmultisubject.py
+++ b/udapi/block/ud/da/fixmultisubject.py
@@ -55,7 +55,7 @@ def process_node(self, node):
             elif len(subjects) == 2 and len(advclchildren) == 1:
                 advclnode = advclchildren[0]
                 dn = [dist(node, x) for x in subjects]
-                dx = [dist(xcompnode, x) for x in subjects]
+                dx = [dist(advclnode, x) for x in subjects]
                 # Is the first subject closer to advcl than it is to the current node?
                 # At the same time, is the second subject closer to the current node than it is to advcl?
                 if dx[0] < dn[0] and dn[1] < dx[1]:

From 7ca292f2282c6627eff720316707f2ab66b0b519 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 30 Jul 2022 13:19:53 +0200
Subject: [PATCH 0645/1374] Improvement: The problematic predicate can now have
 multiple advcl dependents.

---
 udapi/block/ud/da/fixmultisubject.py | 30 +++++++++++++++-------------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/udapi/block/ud/da/fixmultisubject.py b/udapi/block/ud/da/fixmultisubject.py
index 142a51d9..453bc1c0 100644
--- a/udapi/block/ud/da/fixmultisubject.py
+++ b/udapi/block/ud/da/fixmultisubject.py
@@ -52,20 +52,22 @@ def process_node(self, node):
                     # than xcomp, perhaps even the direction of the relation should
                     # be reversed, but one would have to resolve this manually.
                     xcompnode.misc['ToDo'] = 'check-xcomp'
-            elif len(subjects) == 2 and len(advclchildren) == 1:
-                advclnode = advclchildren[0]
-                dn = [dist(node, x) for x in subjects]
-                dx = [dist(advclnode, x) for x in subjects]
-                # Is the first subject closer to advcl than it is to the current node?
-                # At the same time, is the second subject closer to the current node than it is to advcl?
-                if dx[0] < dn[0] and dn[1] < dx[1]:
-                    # The first subject should be re-attached to the advcl node.
-                    subjects[0].parent = advclnode
-                # Is the second subject closer to advcl than it is to the current node?
-                # At the same time, is the first subject closer to the current node than it is to advcl?
-                elif dx[1] < dn[1] and dn[0] < dx[0]:
-                    # The second subject should be re-attached to the xcomp node.
-                    subjects[1].parent = advclnode
+            elif len(subjects) == 2 and len(advclchildren) > 0:
+                for advclnode in advclchildren:
+                    dn = [dist(node, x) for x in subjects]
+                    dx = [dist(advclnode, x) for x in subjects]
+                    # Is the first subject closer to advcl than it is to the current node?
+                    # At the same time, is the second subject closer to the current node than it is to advcl?
+                    if dx[0] < dn[0] and dn[1] < dx[1]:
+                        # The first subject should be re-attached to the advcl node.
+                        subjects[0].parent = advclnode
+                        break
+                    # Is the second subject closer to advcl than it is to the current node?
+                    # At the same time, is the first subject closer to the current node than it is to advcl?
+                    elif dx[1] < dn[1] and dn[0] < dx[0]:
+                        # The second subject should be re-attached to the xcomp node.
+                        subjects[1].parent = advclnode
+                        break
 
 def dist(x, y):
     d = x.ord - y.ord

From 551f2ed23bbec82bcbed9c7780a07f1a2e65f02c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 30 Jul 2022 17:01:27 +0200
Subject: [PATCH 0646/1374] A more lenient approach to catching the pattern.

---
 udapi/block/ud/da/fixmultisubject.py | 62 ++++++++++++++--------------
 1 file changed, 32 insertions(+), 30 deletions(-)

diff --git a/udapi/block/ud/da/fixmultisubject.py b/udapi/block/ud/da/fixmultisubject.py
index 453bc1c0..401c054a 100644
--- a/udapi/block/ud/da/fixmultisubject.py
+++ b/udapi/block/ud/da/fixmultisubject.py
@@ -22,36 +22,38 @@ def process_node(self, node):
             # Pattern 2: Similar to pattern 1, but advcl instead of xcomp, and
             # possibly not so many other mis-attached dependents.
             advclchildren = [x for x in node.children if x.udeprel == 'advcl']
-            if len(subjects) == 2 and len(xcompchildren) == 1:
-                xcompnode = xcompchildren[0]
-                dn = [dist(node, x) for x in subjects]
-                dx = [dist(xcompnode, x) for x in subjects]
-                # Is the first subject closer to xcomp than it is to the current node?
-                # At the same time, is the second subject closer to the current node than it is to xcomp?
-                if dx[0] < dn[0] and dn[1] < dx[1]:
-                    # The first subject should be re-attached to the xcomp node.
-                    subjects[0].parent = xcompnode
-                    # There are typically other dependents that should belong to the xcomp node.
-                    for c in node.children:
-                        if c != xcompnode and dist(xcompnode, c) < dist(node, c):
-                            c.parent = xcompnode
-                    # The xcompnode should probably be attached as something else
-                    # than xcomp, perhaps even the direction of the relation should
-                    # be reversed, but one would have to resolve this manually.
-                    xcompnode.misc['ToDo'] = 'check-xcomp'
-                # Is the second subject closer to xcomp than it is to the current node?
-                # At the same time, is the first subject closer to the current node than it is to xcomp?
-                elif dx[1] < dn[1] and dn[0] < dx[0]:
-                    # The second subject should be re-attached to the xcomp node.
-                    subjects[1].parent = xcompnode
-                    # There are typically other dependents that should belong to the xcomp node.
-                    for c in node.children:
-                        if c != xcompnode and dist(xcompnode, c) < dist(node, c):
-                            c.parent = xcompnode
-                    # The xcompnode should probably be attached as something else
-                    # than xcomp, perhaps even the direction of the relation should
-                    # be reversed, but one would have to resolve this manually.
-                    xcompnode.misc['ToDo'] = 'check-xcomp'
+            if len(subjects) == 2 and len(xcompchildren) > 0:
+                for xcompnode in xcompchildren:
+                    dn = [dist(node, x) for x in subjects]
+                    dx = [dist(xcompnode, x) for x in subjects]
+                    # Is the first subject closer to xcomp than it is to the current node?
+                    # At the same time, is the second subject closer to the current node than it is to xcomp?
+                    if dx[0] <= dn[0] and dn[1] <= dx[1]:
+                        # The first subject should be re-attached to the xcomp node.
+                        subjects[0].parent = xcompnode
+                        # There are typically other dependents that should belong to the xcomp node.
+                        for c in node.children:
+                            if c != xcompnode and dist(xcompnode, c) < dist(node, c):
+                                c.parent = xcompnode
+                        # The xcompnode should probably be attached as something else
+                        # than xcomp, perhaps even the direction of the relation should
+                        # be reversed, but one would have to resolve this manually.
+                        xcompnode.misc['ToDo'] = 'check-xcomp'
+                        break
+                    # Is the second subject closer to xcomp than it is to the current node?
+                    # At the same time, is the first subject closer to the current node than it is to xcomp?
+                    elif dx[1] <= dn[1] and dn[0] <= dx[0]:
+                        # The second subject should be re-attached to the xcomp node.
+                        subjects[1].parent = xcompnode
+                        # There are typically other dependents that should belong to the xcomp node.
+                        for c in node.children:
+                            if c != xcompnode and dist(xcompnode, c) < dist(node, c):
+                                c.parent = xcompnode
+                        # The xcompnode should probably be attached as something else
+                        # than xcomp, perhaps even the direction of the relation should
+                        # be reversed, but one would have to resolve this manually.
+                        xcompnode.misc['ToDo'] = 'check-xcomp'
+                        break
             elif len(subjects) == 2 and len(advclchildren) > 0:
                 for advclnode in advclchildren:
                     dn = [dist(node, x) for x in subjects]

From 1f48111035d1cda1ec678af3ca4574087b11023d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 30 Jul 2022 17:10:35 +0200
Subject: [PATCH 0647/1374] Taking commas into account when assessing node
 distance.

---
 udapi/block/ud/da/fixmultisubject.py | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/da/fixmultisubject.py b/udapi/block/ud/da/fixmultisubject.py
index 401c054a..a690d0ba 100644
--- a/udapi/block/ud/da/fixmultisubject.py
+++ b/udapi/block/ud/da/fixmultisubject.py
@@ -72,7 +72,20 @@ def process_node(self, node):
                         break
 
 def dist(x, y):
-    d = x.ord - y.ord
-    if d < 0:
-        d = -d
+    if x.ord < y.ord:
+        a = x
+        b = y
+    else:
+        a = y
+        b = x
+    d = b.ord - a.ord
+    # Count the commas between the two nodes. A comma should be seen as increasing
+    # the distance of the nodes, that is, decreasing the probability that they
+    # are in the same clause.
+    nc = 0
+    for i in a.root.descendants:
+        if i.ord > a.ord and i.ord < b.ord:
+            if i.form == ',':
+                nc += 1
+    d += nc * 10
     return d

From a430ac7a458a7c169b6fd0ae2b996c4bb20d9db0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 30 Jul 2022 17:22:54 +0200
Subject: [PATCH 0648/1374] New pattern: "amod" with a copula.

---
 udapi/block/ud/da/fixmultisubject.py | 30 ++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/udapi/block/ud/da/fixmultisubject.py b/udapi/block/ud/da/fixmultisubject.py
index a690d0ba..8bd9333a 100644
--- a/udapi/block/ud/da/fixmultisubject.py
+++ b/udapi/block/ud/da/fixmultisubject.py
@@ -22,6 +22,10 @@ def process_node(self, node):
             # Pattern 2: Similar to pattern 1, but advcl instead of xcomp, and
             # possibly not so many other mis-attached dependents.
             advclchildren = [x for x in node.children if x.udeprel == 'advcl']
+            # Pattern 3: Instead of xcomp or advcl, there is a simple amod
+            # (under a verb!), in fact an adjective with a copula that should
+            # have been advcl.
+            amodchildren = [x for x in node.children if x.udeprel == 'amod']
             if len(subjects) == 2 and len(xcompchildren) > 0:
                 for xcompnode in xcompchildren:
                     dn = [dist(node, x) for x in subjects]
@@ -70,6 +74,32 @@ def process_node(self, node):
                         # The second subject should be re-attached to the xcomp node.
                         subjects[1].parent = advclnode
                         break
+            elif len(subjects) == 2 and len(amodchildren) > 0:
+                for amodnode in amodchildren:
+                    dn = [dist(node, x) for x in subjects]
+                    dx = [dist(amodnode, x) for x in subjects]
+                    # Is the first subject closer to amod than it is to the current node?
+                    # At the same time, is the second subject closer to the current node than it is to amod?
+                    if dx[0] < dn[0] and dn[1] < dx[1]:
+                        # The first subject should be re-attached to the advcl node.
+                        subjects[0].parent = amodnode
+                        amodnode.deprel = 'advcl'
+                        # There are typically other dependents that should belong to the amod node.
+                        for c in node.children:
+                            if c != amodnode and dist(amodnode, c) < dist(node, c):
+                                c.parent = amodnode
+                        break
+                    # Is the second subject closer to amod than it is to the current node?
+                    # At the same time, is the first subject closer to the current node than it is to amod?
+                    elif dx[1] < dn[1] and dn[0] < dx[0]:
+                        # The second subject should be re-attached to the xcomp node.
+                        subjects[1].parent = amodnode
+                        amodnode.deprel = 'advcl'
+                        # There are typically other dependents that should belong to the amod node.
+                        for c in node.children:
+                            if c != amodnode and dist(amodnode, c) < dist(node, c):
+                                c.parent = amodnode
+                        break
 
 def dist(x, y):
     if x.ord < y.ord:

From 8589f3b64bcc070030a243186027354fe96682b9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 30 Jul 2022 17:28:46 +0200
Subject: [PATCH 0649/1374] Nouns with copula are "obl" not "amod".

---
 udapi/block/ud/da/fixmultisubject.py | 54 ++++++++++++++--------------
 1 file changed, 28 insertions(+), 26 deletions(-)

diff --git a/udapi/block/ud/da/fixmultisubject.py b/udapi/block/ud/da/fixmultisubject.py
index 8bd9333a..e9367d46 100644
--- a/udapi/block/ud/da/fixmultisubject.py
+++ b/udapi/block/ud/da/fixmultisubject.py
@@ -24,8 +24,9 @@ def process_node(self, node):
             advclchildren = [x for x in node.children if x.udeprel == 'advcl']
             # Pattern 3: Instead of xcomp or advcl, there is a simple amod
             # (under a verb!), in fact an adjective with a copula that should
-            # have been advcl.
-            amodchildren = [x for x in node.children if x.udeprel == 'amod']
+            # have been advcl. Alternatively, the nonverbal clause is headed
+            # by a noun, and the deprel is obl instead of amod.
+            amodchildren = [x for x in node.children if re.match(r'^(amod|obl)$', x.udeprel)]
             if len(subjects) == 2 and len(xcompchildren) > 0:
                 for xcompnode in xcompchildren:
                     dn = [dist(node, x) for x in subjects]
@@ -76,30 +77,31 @@ def process_node(self, node):
                         break
             elif len(subjects) == 2 and len(amodchildren) > 0:
                 for amodnode in amodchildren:
-                    dn = [dist(node, x) for x in subjects]
-                    dx = [dist(amodnode, x) for x in subjects]
-                    # Is the first subject closer to amod than it is to the current node?
-                    # At the same time, is the second subject closer to the current node than it is to amod?
-                    if dx[0] < dn[0] and dn[1] < dx[1]:
-                        # The first subject should be re-attached to the advcl node.
-                        subjects[0].parent = amodnode
-                        amodnode.deprel = 'advcl'
-                        # There are typically other dependents that should belong to the amod node.
-                        for c in node.children:
-                            if c != amodnode and dist(amodnode, c) < dist(node, c):
-                                c.parent = amodnode
-                        break
-                    # Is the second subject closer to amod than it is to the current node?
-                    # At the same time, is the first subject closer to the current node than it is to amod?
-                    elif dx[1] < dn[1] and dn[0] < dx[0]:
-                        # The second subject should be re-attached to the xcomp node.
-                        subjects[1].parent = amodnode
-                        amodnode.deprel = 'advcl'
-                        # There are typically other dependents that should belong to the amod node.
-                        for c in node.children:
-                            if c != amodnode and dist(amodnode, c) < dist(node, c):
-                                c.parent = amodnode
-                        break
+                    if len([x for x in amodnode.children if x.udeprel == 'cop']) > 0:
+                        dn = [dist(node, x) for x in subjects]
+                        dx = [dist(amodnode, x) for x in subjects]
+                        # Is the first subject closer to amod than it is to the current node?
+                        # At the same time, is the second subject closer to the current node than it is to amod?
+                        if dx[0] < dn[0] and dn[1] < dx[1]:
+                            # The first subject should be re-attached to the advcl node.
+                            subjects[0].parent = amodnode
+                            amodnode.deprel = 'advcl'
+                            # There are typically other dependents that should belong to the amod node.
+                            for c in node.children:
+                                if c != amodnode and dist(amodnode, c) < dist(node, c):
+                                    c.parent = amodnode
+                            break
+                        # Is the second subject closer to amod than it is to the current node?
+                        # At the same time, is the first subject closer to the current node than it is to amod?
+                        elif dx[1] < dn[1] and dn[0] < dx[0]:
+                            # The second subject should be re-attached to the xcomp node.
+                            subjects[1].parent = amodnode
+                            amodnode.deprel = 'advcl'
+                            # There are typically other dependents that should belong to the amod node.
+                            for c in node.children:
+                                if c != amodnode and dist(amodnode, c) < dist(node, c):
+                                    c.parent = amodnode
+                            break
 
 def dist(x, y):
     if x.ord < y.ord:

From dcc759cebef6d2b2343f64a65524b60e182a0570 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 1 Aug 2022 01:33:22 +0200
Subject: [PATCH 0650/1374] bugfix in create_block

_import_blocks now returns pairs (name, instance),
but we need just the instance
---
 udapi/core/basewriter.py | 2 +-
 udapi/core/run.py        | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/core/basewriter.py b/udapi/core/basewriter.py
index cc72c6e7..cdc2c38f 100644
--- a/udapi/core/basewriter.py
+++ b/udapi/core/basewriter.py
@@ -66,7 +66,7 @@ def before_process_document(self, document):
                     logging.info('Writing to file %s.', docname)
                     sys.stdout = open(docname, 'wt', encoding=self.encoding, newline=self.newline)
                 else:
-                    logging.warning('overwrite=1 but documet.meta["loaded_from"] is None')
+                    logging.warning('overwrite=1 but document.meta["loaded_from"] is None')
             else:
                 sys.stdout = self.orig_stdout
         else:
diff --git a/udapi/core/run.py b/udapi/core/run.py
index c3a4ca6f..a0cc4a9a 100644
--- a/udapi/core/run.py
+++ b/udapi/core/run.py
@@ -176,4 +176,4 @@ def scenario_string(self):
 def create_block(block, **kwargs):
     """A factory function for creating new block instances (handy for IPython)."""
     blocks = _import_blocks([block], [kwargs])
-    return blocks[0]
+    return blocks[0][1]

From d08d549ff8b04abbd3645bb256a0279f97b1b625 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 16 Aug 2022 22:44:42 +0200
Subject: [PATCH 0651/1374] Spurious auxiliaries in Hindi and Urdu.

---
 udapi/block/ud/hi/fixaux.py | 45 +++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 udapi/block/ud/hi/fixaux.py

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
new file mode 100644
index 00000000..c561d4ce
--- /dev/null
+++ b/udapi/block/ud/hi/fixaux.py
@@ -0,0 +1,45 @@
+"""
+Block to fix annotation of verbs that are currently treated as auxiliaries
+but they should be treated as normal verbs instead.
+"""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixAux(Block):
+
+    def process_node(self, node):
+        # The following verbs appear in verb-verb compounds as the semantically
+        # less salient element: le (to take), de (to give), ḍāla (to throw),
+        # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come). There
+        # are also jā (to go) and paṛa (to fall) but we do not list them here
+        # because they can also act as genuine auxiliaries.
+        hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ']
+        urcompound = ['لے', 'دے', 'بیٹھ', 'رکھ', 'آ']
+        recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
+        hiphase = ['लग', 'चुक']
+        urphase = ['لگ', 'چک']
+        rephase = r'^(' + '|'.join(hiphase + urphase) + r')$'
+        if re.match(recompound, node.lemma) and node.upos == 'AUX' and node.udeprel == 'aux':
+            node.deprel = 'compound'
+            # The word is no longer treated as an auxiliary, so it should be VERB rather than AUX.
+            node.upos = "VERB"
+        elif re.match(rephase, node.lemma) and node.upos == 'AUX' and node.udeprel == 'aux':
+            secpred = node.parent
+            grandparent = secpred.parent
+            node.parent = grandparent
+            node.deprel = secpred.deprel
+            secpred.parent = node
+            secpred.deprel = "xcomp"
+            ###!!! We should also take care of DEPS if they exist.
+            # The word is no longer treated as an auxiliary, so it should be VERB rather than AUX.
+            node.upos = "VERB"
+            # Examine the children of the original parent.
+            # Those that modify the clause should be re-attached to me.
+            # Those that modify the word (noun, adjective) should stay there.
+            for c in secpred.children:
+                # obl is borderline. It could modify an adjective rather than a clause.
+                # obj and iobj should not occur in copular clauses but it sometimes
+                # occurs with pseudocopulas: "I declare him handsome."
+                if re.match("(nsubj|csubj|advmod|advcl|obj|iobj|obl|aux|mark|punct|cc|expl|dislocated|vocative|discourse|parataxis)", c.udeprel):
+                    c.parent = node

From 562f840ac00be75f48fbd52f6b6dab0178af13e7 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 11:33:37 +0200
Subject: [PATCH 0652/1374] Fix lemma before fixing auxiliary.

---
 udapi/block/ud/hi/fixaux.py | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index c561d4ce..54a9bd83 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -9,6 +9,7 @@
 class FixAux(Block):
 
     def process_node(self, node):
+        self.fix_lemma(node)
         # The following verbs appear in verb-verb compounds as the semantically
         # less salient element: le (to take), de (to give), ḍāla (to throw),
         # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come). There
@@ -17,6 +18,7 @@ def process_node(self, node):
         hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ']
         urcompound = ['لے', 'دے', 'بیٹھ', 'رکھ', 'آ']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
+        # Control and raising verbs.
         hiphase = ['लग', 'चुक']
         urphase = ['لگ', 'چک']
         rephase = r'^(' + '|'.join(hiphase + urphase) + r')$'
@@ -43,3 +45,15 @@ def process_node(self, node):
                 # occurs with pseudocopulas: "I declare him handsome."
                 if re.match("(nsubj|csubj|advmod|advcl|obj|iobj|obl|aux|mark|punct|cc|expl|dislocated|vocative|discourse|parataxis)", c.udeprel):
                     c.parent = node
+
+    def fix_lemma(self, node):
+        """
+        Some verbal forms have wrong lemmas in the Hindi/Urdu treebanks. If they
+        are tagged AUX, it means that either the validator fails to recognize a
+        correct auxiliary, or we fail here to recognize a spurious auxiliary that
+        must be fixed.
+        """
+        if node.upos == 'AUX':
+            # لگا is a perfective participle of لگنا (lagnā) "to seem, to appear"
+            if node.lemma == 'لگا':
+                node.lemma = 'لگ'

From 1a8e7c721fe67f9fcdee86938e65ef185e745c1c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 11:46:53 +0200
Subject: [PATCH 0653/1374] =?UTF-8?q?=DA=86=D8=A7=DB=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 54a9bd83..f6507840 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -54,6 +54,12 @@ def fix_lemma(self, node):
         must be fixed.
         """
         if node.upos == 'AUX':
+            # چاہ is a wrong lemmatization of چاہتی, which is a wrong spelling of چاہیئے (cāhie) "should"
+            if node.lemma == 'چاہ':
+                node.lemma = 'چاہیئے'
+                if node.form == 'چاہتی':
+                    node.feats['Typo'] = 'Yes'
+                    node.misc['CorrectForm'] = 'چاہیئے'
             # لگا is a perfective participle of لگنا (lagnā) "to seem, to appear"
             if node.lemma == 'لگا':
                 node.lemma = 'لگ'

From 7aae1ba2f90630e1fcf84c2c33208c61ed1f726d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 11:58:16 +0200
Subject: [PATCH 0654/1374] =?UTF-8?q?=DA=86=D8=A7=DB=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index f6507840..e390dc72 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -19,8 +19,10 @@ def process_node(self, node):
         urcompound = ['لے', 'دے', 'بیٹھ', 'رکھ', 'آ']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
-        hiphase = ['लग', 'चुक']
-        urphase = ['لگ', 'چک']
+        # چاہنا चाहना (cāhnā) "to want, to wish" is a control verb but not an auxiliary.
+        # Its form چاہیئے (cāhie) "should, ought to" (literally "is wanted"?) is treated as a separate, derived word, and it is a modal auxiliary.
+        hiphase = ['लग', 'चुक', 'चाह']
+        urphase = ['لگ', 'چک', 'چاہ']
         rephase = r'^(' + '|'.join(hiphase + urphase) + r')$'
         if re.match(recompound, node.lemma) and node.upos == 'AUX' and node.udeprel == 'aux':
             node.deprel = 'compound'
@@ -54,12 +56,6 @@ def fix_lemma(self, node):
         must be fixed.
         """
         if node.upos == 'AUX':
-            # چاہ is a wrong lemmatization of چاہتی, which is a wrong spelling of چاہیئے (cāhie) "should"
-            if node.lemma == 'چاہ':
-                node.lemma = 'چاہیئے'
-                if node.form == 'چاہتی':
-                    node.feats['Typo'] = 'Yes'
-                    node.misc['CorrectForm'] = 'چاہیئے'
             # لگا is a perfective participle of لگنا (lagnā) "to seem, to appear"
             if node.lemma == 'لگا':
                 node.lemma = 'لگ'

From 47a7ef38c2c4c957b000743e8eed37681debf0f1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 12:09:53 +0200
Subject: [PATCH 0655/1374] =?UTF-8?q?=E0=A4=A6=E0=A4=BF=E0=A4=96=E0=A4=BE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index e390dc72..f4cce0e4 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -19,10 +19,11 @@ def process_node(self, node):
         urcompound = ['لے', 'دے', 'بیٹھ', 'رکھ', 'آ']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
-        # چاہنا चाहना (cāhnā) "to want, to wish" is a control verb but not an auxiliary.
-        # Its form چاہیئے (cāhie) "should, ought to" (literally "is wanted"?) is treated as a separate, derived word, and it is a modal auxiliary.
-        hiphase = ['लग', 'चुक', 'चाह']
-        urphase = ['لگ', 'چک', 'چاہ']
+        # چاہنا चाहना (cāhnā) “to want, to wish” is a control verb but not an auxiliary.
+        # Its form چاہیئے (cāhie) “should, ought to” (literally "is wanted"?) is treated as a separate, derived word, and it is a modal auxiliary.
+        # دکھانا दिखाना (dikhānā) “to show”
+        hiphase = ['लग', 'चुक', 'चाह', 'दिखा']
+        urphase = ['لگ', 'چک', 'چاہ', 'دکھا']
         rephase = r'^(' + '|'.join(hiphase + urphase) + r')$'
         if re.match(recompound, node.lemma) and node.upos == 'AUX' and node.udeprel == 'aux':
             node.deprel = 'compound'

From 5aff16b435f5baa0ecb1bb830fa57ae6e980c109 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 12:22:58 +0200
Subject: [PATCH 0656/1374] ... kar ke

---
 udapi/block/ud/hi/fixaux.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index f4cce0e4..a1033d32 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -60,3 +60,8 @@ def fix_lemma(self, node):
             # لگا is a perfective participle of لگنا (lagnā) "to seem, to appear"
             if node.lemma == 'لگا':
                 node.lemma = 'لگ'
+            # The postposition ke after a verbal stem is not an auxiliary.
+            # Example: علحدہ علحدہ کیس رجسٹر کر کے “by registering separate cases”
+            if node.lemma == 'کا' and node.form == 'کے':
+                node.upos = 'ADP'
+                node.deprel = 'mark'

From 8acbf13ece8b280aee1ec785f61cf96f93fc3918 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 13:16:00 +0200
Subject: [PATCH 0657/1374] =?UTF-8?q?=DA=86=D8=A7=DB=81=D8=A6=DB=92?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index a1033d32..8f484546 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -57,6 +57,9 @@ def fix_lemma(self, node):
         must be fixed.
         """
         if node.upos == 'AUX':
+            # چاہئے (cāhie) “should, ought to” occurs with alternative spellings (should they also be labeled as typos?)
+            if node.form == 'چاہئے' or node.form == 'چاہیئے' or node.form == 'چاہیے':
+                node.lemma = 'چاہئے'
             # لگا is a perfective participle of لگنا (lagnā) "to seem, to appear"
             if node.lemma == 'لگا':
                 node.lemma = 'لگ'

From 2db0c9e11cb9eba23aacbe9142ae7123851a44fc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 13:26:54 +0200
Subject: [PATCH 0658/1374] Plural of cahie.

---
 udapi/block/ud/hi/fixaux.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 8f484546..4967e9f9 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -60,6 +60,9 @@ def fix_lemma(self, node):
             # چاہئے (cāhie) “should, ought to” occurs with alternative spellings (should they also be labeled as typos?)
             if node.form == 'چاہئے' or node.form == 'چاہیئے' or node.form == 'چاہیے':
                 node.lemma = 'چاہئے'
+            if node.form == 'چاہئیں':
+                node.lemma = 'چاہئے'
+                node.feats['Number'] = 'Plur'
             # لگا is a perfective participle of لگنا (lagnā) "to seem, to appear"
             if node.lemma == 'لگا':
                 node.lemma = 'لگ'

From d7241a18b7b5d866bb7a72df95be7dcf6deb8bd5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 13:35:03 +0200
Subject: [PATCH 0659/1374] =?UTF-8?q?=DA=AF=DB=8C=D8=A7=20is=20a=20perfect?=
 =?UTF-8?q?ive=20participle=20of=20=D8=AC=D8=A7=D9=86=D8=A7=E2=80=8E=20(j?=
 =?UTF-8?q?=C4=81n=C4=81)=20=E2=80=9Cto=20go=E2=80=9D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 4967e9f9..5fa11356 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -63,7 +63,10 @@ def fix_lemma(self, node):
             if node.form == 'چاہئیں':
                 node.lemma = 'چاہئے'
                 node.feats['Number'] = 'Plur'
-            # لگا is a perfective participle of لگنا (lagnā) "to seem, to appear"
+            # گیا is a perfective participle of جانا‎ (jānā) “to go”
+            if node.lemma == 'گیا':
+                node.lemma = 'جا'
+            # لگا is a perfective participle of لگنا (lagnā) “to seem, to appear”
             if node.lemma == 'لگا':
                 node.lemma = 'لگ'
             # The postposition ke after a verbal stem is not an auxiliary.

From 027fe04bb6f4195070fc536d3a26770b1b38197a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 14:50:00 +0200
Subject: [PATCH 0660/1374] =?UTF-8?q?Urdu=20pseudo-auxiliary=20=D9=BE?=
 =?UTF-8?q?=DA=BE=DB=8C=D9=86=DA=A9=20(phenk).?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 5fa11356..a04ed04f 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -11,12 +11,12 @@ class FixAux(Block):
     def process_node(self, node):
         self.fix_lemma(node)
         # The following verbs appear in verb-verb compounds as the semantically
-        # less salient element: le (to take), de (to give), ḍāla (to throw),
+        # less salient element: le (to take), de (to give), ḍāla / phenk (to throw),
         # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come). There
         # are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
         hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ']
-        urcompound = ['لے', 'دے', 'بیٹھ', 'رکھ', 'آ']
+        urcompound = ['لے', 'دے', 'پھینک', 'بیٹھ', 'رکھ', 'آ']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
         # چاہنا चाहना (cāhnā) “to want, to wish” is a control verb but not an auxiliary.

From 5a9f2b875c5195f78d8cd6a5e6ef9ff42d7d572e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 15:15:22 +0200
Subject: [PATCH 0661/1374] =?UTF-8?q?=E0=A4=B5=E0=A4=BE=E0=A4=B2=E0=A4=BE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index a04ed04f..7b3b9c23 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -29,6 +29,13 @@ def process_node(self, node):
             node.deprel = 'compound'
             # The word is no longer treated as an auxiliary, so it should be VERB rather than AUX.
             node.upos = "VERB"
+        # والا (vālā) with infinitive is annotated as auxiliary but it should not.
+        # It is not even a verb (it does not have a verbal paradigm); it is more
+        # like an adjective morphologically, and like a noun syntactically. It means
+        # “the one who does the action of the content verb infinitive.”
+        elif node.lemma == 'वाला' or node.lemma == 'والا':
+            node.upos = 'ADJ'
+            node.deprel = 'compound'
         elif re.match(rephase, node.lemma) and node.upos == 'AUX' and node.udeprel == 'aux':
             secpred = node.parent
             grandparent = secpred.parent

From c1c3518d872c265391c6efdcbf35a7829c8cfe99 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 15:21:02 +0200
Subject: [PATCH 0662/1374] =?UTF-8?q?If=20v=C3=A1l=C3=A1=20is=20no=20longe?=
 =?UTF-8?q?r=20adposition,=20it=20cannot=20have=20AdpType.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 7b3b9c23..e843dd6f 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -29,12 +29,15 @@ def process_node(self, node):
             node.deprel = 'compound'
             # The word is no longer treated as an auxiliary, so it should be VERB rather than AUX.
             node.upos = "VERB"
-        # والا (vālā) with infinitive is annotated as auxiliary but it should not.
+        # वाला والا (vālā) with infinitive is annotated as auxiliary but it should not.
         # It is not even a verb (it does not have a verbal paradigm); it is more
         # like an adjective morphologically, and like a noun syntactically. It means
         # “the one who does the action of the content verb infinitive.”
+        # Some occurrences in the original annotation are case or mark, so we do not
+        # check AUX/aux here.
         elif node.lemma == 'वाला' or node.lemma == 'والا':
             node.upos = 'ADJ'
+            node.feats['AdpType'] = ''
             node.deprel = 'compound'
         elif re.match(rephase, node.lemma) and node.upos == 'AUX' and node.udeprel == 'aux':
             secpred = node.parent

From 0e5f4909850ac14097ec1a70c625275e3402bd35 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 15:33:25 +0200
Subject: [PATCH 0663/1374] =?UTF-8?q?Features=20of=20v=C4=81l=C4=81.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index e843dd6f..34566e06 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -38,6 +38,8 @@ def process_node(self, node):
         elif node.lemma == 'वाला' or node.lemma == 'والا':
             node.upos = 'ADJ'
             node.feats['AdpType'] = ''
+            node.feats['VerbForm'] = ''
+            node.feats['Aspect'] = ''
             node.deprel = 'compound'
         elif re.match(rephase, node.lemma) and node.upos == 'AUX' and node.udeprel == 'aux':
             secpred = node.parent

From 783246b8c556823f7632fb0114ce4e0edbf2af94 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 15:42:37 +0200
Subject: [PATCH 0664/1374] =?UTF-8?q?=D8=B3=DA=A9=DB=92?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 34566e06..b18c074f 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -81,6 +81,8 @@ def fix_lemma(self, node):
             # لگا is a perfective participle of لگنا (lagnā) “to seem, to appear”
             if node.lemma == 'لگا':
                 node.lemma = 'لگ'
+            if node.lemma == 'سکے':
+                node.lemma = 'سک'
             # The postposition ke after a verbal stem is not an auxiliary.
             # Example: علحدہ علحدہ کیس رجسٹر کر کے “by registering separate cases”
             if node.lemma == 'کا' and node.form == 'کے':

From d357827545a125cb45e21d99670c309c30b85cd1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 16:08:49 +0200
Subject: [PATCH 0665/1374] =?UTF-8?q?=D8=A8=D9=86=D8=A7=20is=20not=20the?=
 =?UTF-8?q?=20lemma=20of=20=DA=A9=D8=B1.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index b18c074f..75e7f9bb 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -69,6 +69,10 @@ def fix_lemma(self, node):
         must be fixed.
         """
         if node.upos == 'AUX':
+            # بنانا बनाना “make, create, produce, cause to be/become”
+            # (I don't know why in some instances بنا was used as lemma for کر “to do”.)
+            if node.form == 'کر' and node.lemma == 'بنا':
+                node.lemma = 'کر'
             # چاہئے (cāhie) “should, ought to” occurs with alternative spellings (should they also be labeled as typos?)
             if node.form == 'چاہئے' or node.form == 'چاہیئے' or node.form == 'چاہیے':
                 node.lemma = 'چاہئے'

From 646b0c47d64c0977b2354a75e10bb4596538e941 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 20:19:00 +0200
Subject: [PATCH 0666/1374] =?UTF-8?q?=DA=86=DA=A9=D8=A7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 75e7f9bb..9d59195d 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -79,6 +79,9 @@ def fix_lemma(self, node):
             if node.form == 'چاہئیں':
                 node.lemma = 'چاہئے'
                 node.feats['Number'] = 'Plur'
+            # چکا is a perfective participle of چکنا (cuknā) “to be finished”
+            if node.lemma == 'چکا':
+                node.lemma = 'چک'
             # گیا is a perfective participle of جانا‎ (jānā) “to go”
             if node.lemma == 'گیا':
                 node.lemma = 'جا'

From fc741a6edaabc0bdac2fd0a65293c7b561843519 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 20:27:20 +0200
Subject: [PATCH 0667/1374] =?UTF-8?q?=D8=B1=DB=81=D8=A7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 9d59195d..7b3de989 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -88,6 +88,10 @@ def fix_lemma(self, node):
             # لگا is a perfective participle of لگنا (lagnā) “to seem, to appear”
             if node.lemma == 'لگا':
                 node.lemma = 'لگ'
+            # رہا is a perfective participle of رہنا (rahnā) “to stay”
+            if node.lemma == 'رہا':
+                node.lemma = 'رہ'
+            # sakna to be able to
             if node.lemma == 'سکے':
                 node.lemma = 'سک'
             # The postposition ke after a verbal stem is not an auxiliary.

From 2848129c7eb7ee0d3f081181b48949acbded312f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 22:40:14 +0200
Subject: [PATCH 0668/1374] =?UTF-8?q?Lemmatization=20of=20=D9=88=D8=A7?=
 =?UTF-8?q?=D9=84=DB=8C.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 7b3de989..0c811365 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -94,6 +94,10 @@ def fix_lemma(self, node):
             # sakna to be able to
             if node.lemma == 'سکے':
                 node.lemma = 'سک'
+            # The compound part vālā is not an auxiliary. We handle it in process_node()
+            # but it must be lemmatized properly.
+            if node.lemma == 'والی':
+                node.lemma = 'والا'
             # The postposition ke after a verbal stem is not an auxiliary.
             # Example: علحدہ علحدہ کیس رجسٹر کر کے “by registering separate cases”
             if node.lemma == 'کا' and node.form == 'کے':

From 51f6f1614b451969aeff200138cdfef8afcad1ce Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 22:52:20 +0200
Subject: [PATCH 0669/1374] =?UTF-8?q?Lemmatization=20of=20=DA=AF=D8=A7,=20?=
 =?UTF-8?q?=DA=AF=DB=8C,=20=DA=AF=DB=92.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 0c811365..da5d6b42 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -82,6 +82,12 @@ def fix_lemma(self, node):
             # چکا is a perfective participle of چکنا (cuknā) “to be finished”
             if node.lemma == 'چکا':
                 node.lemma = 'چک'
+            # گا, گی, گے denote the future tense. They are written as separate
+            # words in Urdu (while they are just suffixes in Hindi). However,
+            # when written as a separate auxiliary, all these forms should share
+            # the same lemma.
+            if node.lemma == 'گی' or node.lemma = 'گے':
+                node.lemma = 'گا'
             # گیا is a perfective participle of جانا‎ (jānā) “to go”
             if node.lemma == 'گیا':
                 node.lemma = 'جا'

From c11aa6703f0854a3f83238695656da106a88c74a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 22:53:31 +0200
Subject: [PATCH 0670/1374] Bug fix.

---
 udapi/block/ud/hi/fixaux.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index da5d6b42..1843e2de 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -86,7 +86,7 @@ def fix_lemma(self, node):
             # words in Urdu (while they are just suffixes in Hindi). However,
             # when written as a separate auxiliary, all these forms should share
             # the same lemma.
-            if node.lemma == 'گی' or node.lemma = 'گے':
+            if node.lemma == 'گی' or node.lemma == 'گے':
                 node.lemma = 'گا'
             # گیا is a perfective participle of جانا‎ (jānā) “to go”
             if node.lemma == 'گیا':

From 57dffd5625e94b369ac06410196ae7a3e7f3bd27 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 23:09:57 +0200
Subject: [PATCH 0671/1374] Lemmatization of lena, dena.

---
 udapi/block/ud/hi/fixaux.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 1843e2de..00141be4 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -82,6 +82,9 @@ def fix_lemma(self, node):
             # چکا is a perfective participle of چکنا (cuknā) “to be finished”
             if node.lemma == 'چکا':
                 node.lemma = 'چک'
+            # دیا is a perfective participle of دینا (denā) “to give”
+            if node.lemma == 'دیا':
+                node.lemma = 'دے'
             # گا, گی, گے denote the future tense. They are written as separate
             # words in Urdu (while they are just suffixes in Hindi). However,
             # when written as a separate auxiliary, all these forms should share
@@ -91,6 +94,9 @@ def fix_lemma(self, node):
             # گیا is a perfective participle of جانا‎ (jānā) “to go”
             if node.lemma == 'گیا':
                 node.lemma = 'جا'
+            # لیا is a perfective participle of لینا (lenā) “to take”
+            if node.lemma == 'لیا':
+                node.lemma = 'لے'
             # لگا is a perfective participle of لگنا (lagnā) “to seem, to appear”
             if node.lemma == 'لگا':
                 node.lemma = 'لگ'

From d6a66df056d57b0fe24ded3770aa182b35ca0a3f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 21 Aug 2022 23:22:29 +0200
Subject: [PATCH 0672/1374] =?UTF-8?q?=D8=A7=D9=B9=DA=BE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 00141be4..28293ab6 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -16,7 +16,7 @@ def process_node(self, node):
         # are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
         hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ']
-        urcompound = ['لے', 'دے', 'پھینک', 'بیٹھ', 'رکھ', 'آ']
+        urcompound = ['لے', 'دے', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
         # چاہنا चाहना (cāhnā) “to want, to wish” is a control verb but not an auxiliary.
@@ -69,6 +69,9 @@ def fix_lemma(self, node):
         must be fixed.
         """
         if node.upos == 'AUX':
+            # اٹھنا “to rise, get up”
+            if node.lemma == 'اٹھا':
+                node.lemma = 'اٹھ'
             # بنانا बनाना “make, create, produce, cause to be/become”
             # (I don't know why in some instances بنا was used as lemma for کر “to do”.)
             if node.form == 'کر' and node.lemma == 'بنا':

From 160d20df833612ccbb52b7b1a4586467b9051bb1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 09:58:18 +0200
Subject: [PATCH 0673/1374] =?UTF-8?q?=D8=AF=DB=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 28293ab6..5a4351e1 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -86,7 +86,7 @@ def fix_lemma(self, node):
             if node.lemma == 'چکا':
                 node.lemma = 'چک'
             # دیا is a perfective participle of دینا (denā) “to give”
-            if node.lemma == 'دیا':
+            if node.lemma == 'دیا' or node.lemma == 'دی':
                 node.lemma = 'دے'
             # گا, گی, گے denote the future tense. They are written as separate
             # words in Urdu (while they are just suffixes in Hindi). However,

From eab5615969dbe4bd7b5349ad3a58f3ced14f19ee Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 10:07:29 +0200
Subject: [PATCH 0674/1374] =?UTF-8?q?Wrongly=20lemmatized=20forms=20of=20?=
 =?UTF-8?q?=D8=AC=D8=A7=D9=86=D8=A7=E2=80=8E=20(j=C4=81n=C4=81)=20?=
 =?UTF-8?q?=E2=80=9Cto=20go=E2=80=9D.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 5a4351e1..b6b68ceb 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -95,7 +95,7 @@ def fix_lemma(self, node):
             if node.lemma == 'گی' or node.lemma == 'گے':
                 node.lemma = 'گا'
             # گیا is a perfective participle of جانا‎ (jānā) “to go”
-            if node.lemma == 'گیا':
+            if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی':
                 node.lemma = 'جا'
             # لیا is a perfective participle of لینا (lenā) “to take”
             if node.lemma == 'لیا':

From 18dc8b44dd288f8b125467144d56c1447c135f60 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 10:18:36 +0200
Subject: [PATCH 0675/1374] =?UTF-8?q?Wrongly=20lemmatized=20forms=20of=20?=
 =?UTF-8?q?=D8=AC=D8=A7=D9=86=D8=A7=E2=80=8E=20(j=C4=81n=C4=81)=20?=
 =?UTF-8?q?=E2=80=9Cto=20go=E2=80=9D.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/hi/fixaux.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index b6b68ceb..81f4653b 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -95,7 +95,8 @@ def fix_lemma(self, node):
             if node.lemma == 'گی' or node.lemma == 'گے':
                 node.lemma = 'گا'
             # گیا is a perfective participle of جانا‎ (jānā) “to go”
-            if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی':
+            # جان is nonsense. It occurs with forms like جانی, which is a feminine form of the infinitive جانا‎.
+            if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی' or node.lemma == 'جان':
                 node.lemma = 'جا'
             # لیا is a perfective participle of لینا (lenā) “to take”
             if node.lemma == 'لیا':

From bd1f23a3c60e9c8e0bb1ccef87851fbafb6a4fa3 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 10:26:57 +0200
Subject: [PATCH 0676/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 81f4653b..3b7e2f02 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -82,6 +82,9 @@ def fix_lemma(self, node):
             if node.form == 'چاہئیں':
                 node.lemma = 'چاہئے'
                 node.feats['Number'] = 'Plur'
+            # چاہے seems to be a wrong lemma of چاہیں_گے “would like”
+            if node.lemma == 'چاہے':
+                node.lemma = 'چاہ'
             # چکا is a perfective participle of چکنا (cuknā) “to be finished”
             if node.lemma == 'چکا':
                 node.lemma = 'چک'
@@ -108,7 +111,7 @@ def fix_lemma(self, node):
             if node.lemma == 'رہا':
                 node.lemma = 'رہ'
             # sakna to be able to
-            if node.lemma == 'سکے':
+            if node.lemma == 'سکے' or node.lemma == 'سکی':
                 node.lemma = 'سک'
             # The compound part vālā is not an auxiliary. We handle it in process_node()
             # but it must be lemmatized properly.

From 8b23ecc0f6c2e58777bd70e2b4c11c4c76fba58d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 10:32:59 +0200
Subject: [PATCH 0677/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 3b7e2f02..ecf7c3b2 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -99,7 +99,7 @@ def fix_lemma(self, node):
                 node.lemma = 'گا'
             # گیا is a perfective participle of جانا‎ (jānā) “to go”
             # جان is nonsense. It occurs with forms like جانی, which is a feminine form of the infinitive جانا‎.
-            if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی' or node.lemma == 'جان':
+            if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی' or node.lemma == 'جان' or node.lemma == 'جانا':
                 node.lemma = 'جا'
             # لیا is a perfective participle of لینا (lenā) “to take”
             if node.lemma == 'لیا':
@@ -108,10 +108,10 @@ def fix_lemma(self, node):
             if node.lemma == 'لگا':
                 node.lemma = 'لگ'
             # رہا is a perfective participle of رہنا (rahnā) “to stay”
-            if node.lemma == 'رہا':
+            if node.lemma == 'رہا' or node.lemma == 'رہے':
                 node.lemma = 'رہ'
             # sakna to be able to
-            if node.lemma == 'سکے' or node.lemma == 'سکی':
+            if node.lemma == 'سکے' or node.lemma == 'سکی' or node.lemma == 'سکتا':
                 node.lemma = 'سک'
             # The compound part vālā is not an auxiliary. We handle it in process_node()
             # but it must be lemmatized properly.

From 356a7cda698ec00b2c0fc594c3b3157a05c50300 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 10:39:13 +0200
Subject: [PATCH 0678/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index ecf7c3b2..f320bb98 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -12,11 +12,11 @@ def process_node(self, node):
         self.fix_lemma(node)
         # The following verbs appear in verb-verb compounds as the semantically
         # less salient element: le (to take), de (to give), ḍāla / phenk (to throw),
-        # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come). There
-        # are also jā (to go) and paṛa (to fall) but we do not list them here
+        # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come), lā (to bring).
+        # There are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
         hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ']
-        urcompound = ['لے', 'دے', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ']
+        urcompound = ['لے', 'دے', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
         # چاہنا चाहना (cāhnā) “to want, to wish” is a control verb but not an auxiliary.
@@ -99,7 +99,7 @@ def fix_lemma(self, node):
                 node.lemma = 'گا'
             # گیا is a perfective participle of جانا‎ (jānā) “to go”
             # جان is nonsense. It occurs with forms like جانی, which is a feminine form of the infinitive جانا‎.
-            if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی' or node.lemma == 'جان' or node.lemma == 'جانا':
+            if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی' or node.lemma == 'جان' or node.lemma == 'جانا' or node.lemma == 'جاؤ':
                 node.lemma = 'جا'
             # لیا is a perfective participle of لینا (lenā) “to take”
             if node.lemma == 'لیا':

From f8e8a0aac7e6dfb52f2ff256d1f4c4fa95a6f271 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 10:48:40 +0200
Subject: [PATCH 0679/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index f320bb98..0a7f8d3a 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -12,11 +12,12 @@ def process_node(self, node):
         self.fix_lemma(node)
         # The following verbs appear in verb-verb compounds as the semantically
         # less salient element: le (to take), de (to give), ḍāla / phenk (to throw),
-        # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come), lā (to bring).
+        # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come), lā (to bring),
+        # pahuñc (to reach).
         # There are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
-        hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ']
-        urcompound = ['لے', 'دے', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا']
+        hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच']
+        urcompound = ['لے', 'دے', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
         # چاہنا चाहना (cāhnā) “to want, to wish” is a control verb but not an auxiliary.
@@ -102,7 +103,7 @@ def fix_lemma(self, node):
             if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی' or node.lemma == 'جان' or node.lemma == 'جانا' or node.lemma == 'جاؤ':
                 node.lemma = 'جا'
             # لیا is a perfective participle of لینا (lenā) “to take”
-            if node.lemma == 'لیا':
+            if node.lemma == 'لیا' or node.lemma == 'لو':
                 node.lemma = 'لے'
             # لگا is a perfective participle of لگنا (lagnā) “to seem, to appear”
             if node.lemma == 'لگا':

From 04068d58a6b5488691079f5538ac122c084925ec Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 10:54:52 +0200
Subject: [PATCH 0680/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 0a7f8d3a..2ce70d6a 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -102,8 +102,11 @@ def fix_lemma(self, node):
             # جان is nonsense. It occurs with forms like جانی, which is a feminine form of the infinitive جانا‎.
             if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی' or node.lemma == 'جان' or node.lemma == 'جانا' or node.lemma == 'جاؤ':
                 node.lemma = 'جا'
+            # Wrongly lemmatized present forms of “to be”.
+            if node.lemma == 'ہوں' or node.lemma == 'ہوا':
+                node.lemma = 'ہے'
             # لیا is a perfective participle of لینا (lenā) “to take”
-            if node.lemma == 'لیا' or node.lemma == 'لو':
+            if node.lemma == 'لیا' or node.lemma == 'لو' or node.lemma == 'لی':
                 node.lemma = 'لے'
             # لگا is a perfective participle of لگنا (lagnā) “to seem, to appear”
             if node.lemma == 'لگا':

From d0275bec69254fc9b3b910584d10d13d4052e32c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 11:01:58 +0200
Subject: [PATCH 0681/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 2ce70d6a..2178e421 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -111,8 +111,11 @@ def fix_lemma(self, node):
             # لگا is a perfective participle of لگنا (lagnā) “to seem, to appear”
             if node.lemma == 'لگا':
                 node.lemma = 'لگ'
+            # پڑے is a perfective participle of پڑنا (paṛnā) “to fall”
+            if node.lemma == 'پڑے':
+                node.lemma = 'پڑ'
             # رہا is a perfective participle of رہنا (rahnā) “to stay”
-            if node.lemma == 'رہا' or node.lemma == 'رہے':
+            if node.lemma == 'رہا' or node.lemma == 'رہی' or node.lemma == 'رہے':
                 node.lemma = 'رہ'
             # sakna to be able to
             if node.lemma == 'سکے' or node.lemma == 'سکی' or node.lemma == 'سکتا':

From 8d6866b473195bf97d79a9b25fd9b21984541e62 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 11:08:26 +0200
Subject: [PATCH 0682/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 2178e421..dcf6fe3a 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -13,11 +13,11 @@ def process_node(self, node):
         # The following verbs appear in verb-verb compounds as the semantically
         # less salient element: le (to take), de (to give), ḍāla / phenk (to throw),
         # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come), lā (to bring),
-        # pahuñc (to reach).
+        # pahuñc (to reach), dekh (to look).
         # There are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
         hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच']
-        urcompound = ['لے', 'دے', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ']
+        urcompound = ['لے', 'دے', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
         # چاہنا चाहना (cāhnā) “to want, to wish” is a control verb but not an auxiliary.
@@ -100,13 +100,13 @@ def fix_lemma(self, node):
                 node.lemma = 'گا'
             # گیا is a perfective participle of جانا‎ (jānā) “to go”
             # جان is nonsense. It occurs with forms like جانی, which is a feminine form of the infinitive جانا‎.
-            if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی' or node.lemma == 'جان' or node.lemma == 'جانا' or node.lemma == 'جاؤ':
+            if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی' or node.lemma == 'جان' or node.lemma == 'جانا' or node.lemma == 'جاؤ' or node.lemma == 'جائی':
                 node.lemma = 'جا'
             # Wrongly lemmatized present forms of “to be”.
             if node.lemma == 'ہوں' or node.lemma == 'ہوا':
                 node.lemma = 'ہے'
             # لیا is a perfective participle of لینا (lenā) “to take”
-            if node.lemma == 'لیا' or node.lemma == 'لو' or node.lemma == 'لی':
+            if node.lemma == 'لیا' or node.lemma == 'لو' or node.lemma == 'لی' or node.lemma == 'لیجیے':
                 node.lemma = 'لے'
             # لگا is a perfective participle of لگنا (lagnā) “to seem, to appear”
             if node.lemma == 'لگا':

From 86248be9f7d975d6d96a2daab5208b2175a1762c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 11:15:02 +0200
Subject: [PATCH 0683/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index dcf6fe3a..84a4b9c1 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -120,6 +120,9 @@ def fix_lemma(self, node):
             # sakna to be able to
             if node.lemma == 'سکے' or node.lemma == 'سکی' or node.lemma == 'سکتا':
                 node.lemma = 'سک'
+            # Wrongly lemmatized past forms of “to be”.
+            if node.lemma == 'تھ' or node.lemma == 'تھے' or node.lemma == 'تھیں':
+                node.lemma = 'تھا'
             # The compound part vālā is not an auxiliary. We handle it in process_node()
             # but it must be lemmatized properly.
             if node.lemma == 'والی':

From 6a726c962590fd03e9bf56096853e80e0560d319 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 11:21:29 +0200
Subject: [PATCH 0684/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 84a4b9c1..ea865b14 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -70,6 +70,9 @@ def fix_lemma(self, node):
         must be fixed.
         """
         if node.upos == 'AUX':
+            # آنے is the oblique infinitive form of “to come”
+            if node.lemma == 'آنہ':
+                node.lemma = 'آ'
             # اٹھنا “to rise, get up”
             if node.lemma == 'اٹھا':
                 node.lemma = 'اٹھ'
@@ -90,7 +93,7 @@ def fix_lemma(self, node):
             if node.lemma == 'چکا':
                 node.lemma = 'چک'
             # دیا is a perfective participle of دینا (denā) “to give”
-            if node.lemma == 'دیا' or node.lemma == 'دی':
+            if node.lemma == 'دیا' or node.lemma == 'دی' or node.lemma == 'دیت':
                 node.lemma = 'دے'
             # گا, گی, گے denote the future tense. They are written as separate
             # words in Urdu (while they are just suffixes in Hindi). However,

From 0cd5546c5397b4055797d3f6e9e09f3f67f0c7ef Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 11:29:57 +0200
Subject: [PATCH 0685/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index ea865b14..df914996 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -13,11 +13,11 @@ def process_node(self, node):
         # The following verbs appear in verb-verb compounds as the semantically
         # less salient element: le (to take), de (to give), ḍāla / phenk (to throw),
         # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come), lā (to bring),
-        # pahuñc (to reach), dekh (to look).
+        # pahuñc (to reach), dekh (to look), phar (to return).
         # There are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
         hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच']
-        urcompound = ['لے', 'دے', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ']
+        urcompound = ['لے', 'دے', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ', 'پھر']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
         # چاہنا चाहना (cāhnā) “to want, to wish” is a control verb but not an auxiliary.
@@ -117,6 +117,9 @@ def fix_lemma(self, node):
             # پڑے is a perfective participle of پڑنا (paṛnā) “to fall”
             if node.lemma == 'پڑے':
                 node.lemma = 'پڑ'
+            # پھرے is a perfective participle of پھرنا (pharnā) “to return”
+            if node.lemma == 'پھرے':
+                node.lemma = 'پھر'
             # رہا is a perfective participle of رہنا (rahnā) “to stay”
             if node.lemma == 'رہا' or node.lemma == 'رہی' or node.lemma == 'رہے':
                 node.lemma = 'رہ'

From 9046d0e4ed67f9dadd6088a55d14d390810e55d6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 11:40:44 +0200
Subject: [PATCH 0686/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index df914996..1507e8e4 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -13,11 +13,11 @@ def process_node(self, node):
         # The following verbs appear in verb-verb compounds as the semantically
         # less salient element: le (to take), de (to give), ḍāla / phenk (to throw),
         # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come), lā (to bring),
-        # pahuñc (to reach), dekh (to look), phar (to return).
+        # pahuñc (to reach), dekh (to look), phar (to return), cal (to walk).
         # There are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
         hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच']
-        urcompound = ['لے', 'دے', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ', 'پھر']
+        urcompound = ['لے', 'دے', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ', 'پھر', 'چل']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
         # چاہنا चाहना (cāhnā) “to want, to wish” is a control verb but not an auxiliary.
@@ -103,7 +103,7 @@ def fix_lemma(self, node):
                 node.lemma = 'گا'
             # گیا is a perfective participle of جانا‎ (jānā) “to go”
             # جان is nonsense. It occurs with forms like جانی, which is a feminine form of the infinitive جانا‎.
-            if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی' or node.lemma == 'جان' or node.lemma == 'جانا' or node.lemma == 'جاؤ' or node.lemma == 'جائی':
+            if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی' or node.lemma == 'جان' or node.lemma == 'جانا' or node.lemma == 'جاؤ' or node.lemma == 'جائی' or node.lemma == 'جاتے' or node.lemma == 'جات':
                 node.lemma = 'جا'
             # Wrongly lemmatized present forms of “to be”.
             if node.lemma == 'ہوں' or node.lemma == 'ہوا':

From 27321a9cae361be1e251f3ffe165055c2a591ac3 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 11:48:48 +0200
Subject: [PATCH 0687/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 1507e8e4..e6435d09 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -17,7 +17,7 @@ def process_node(self, node):
         # There are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
         hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच']
-        urcompound = ['لے', 'دے', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ', 'پھر', 'چل']
+        urcompound = ['لے', 'دے', 'ڈال', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ', 'پھر', 'چل']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
         # چاہنا चाहना (cāhnā) “to want, to wish” is a control verb but not an auxiliary.
@@ -124,7 +124,7 @@ def fix_lemma(self, node):
             if node.lemma == 'رہا' or node.lemma == 'رہی' or node.lemma == 'رہے':
                 node.lemma = 'رہ'
             # sakna to be able to
-            if node.lemma == 'سکے' or node.lemma == 'سکی' or node.lemma == 'سکتا':
+            if node.lemma == 'سکے' or node.lemma == 'سکی' or node.lemma == 'سکتا' or node.lemma == 'سکت':
                 node.lemma = 'سک'
             # Wrongly lemmatized past forms of “to be”.
             if node.lemma == 'تھ' or node.lemma == 'تھے' or node.lemma == 'تھیں':

From 3c0e186abb780fdcf6ae18064c7ea18170cdc37b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 11:56:40 +0200
Subject: [PATCH 0688/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index e6435d09..440bcd80 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -106,10 +106,12 @@ def fix_lemma(self, node):
             if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی' or node.lemma == 'جان' or node.lemma == 'جانا' or node.lemma == 'جاؤ' or node.lemma == 'جائی' or node.lemma == 'جاتے' or node.lemma == 'جات':
                 node.lemma = 'جا'
             # Wrongly lemmatized present forms of “to be”.
-            if node.lemma == 'ہوں' or node.lemma == 'ہوا':
+            # In one instance, ہے had a lemma from a neighboring verb, so we also look at the form.
+            if node.lemma == 'ہوں' or node.lemma == 'ہوا' or node.form == 'ہے':
                 node.lemma = 'ہے'
             # لیا is a perfective participle of لینا (lenā) “to take”
-            if node.lemma == 'لیا' or node.lemma == 'لو' or node.lemma == 'لی' or node.lemma == 'لیجیے':
+            # In one instance, لیا had a lemma from a neighboring verb, so we also look at the form.
+            if node.lemma == 'لیا' or node.form == 'لیا' or node.lemma == 'لو' or node.lemma == 'لی' or node.lemma == 'لیجیے':
                 node.lemma = 'لے'
             # لگا is a perfective participle of لگنا (lagnā) “to seem, to appear”
             if node.lemma == 'لگا':

From 5c9c72eed8952fbd51b44963816e5215f2c51922 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 12:16:16 +0200
Subject: [PATCH 0689/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 440bcd80..f6d9e7d7 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -95,6 +95,9 @@ def fix_lemma(self, node):
             # دیا is a perfective participle of دینا (denā) “to give”
             if node.lemma == 'دیا' or node.lemma == 'دی' or node.lemma == 'دیت':
                 node.lemma = 'دے'
+            # دکھائیں (dikhānā) “to show”
+            if node.form == 'دکھائیں':
+                node.lemma = 'دکھا'
             # گا, گی, گے denote the future tense. They are written as separate
             # words in Urdu (while they are just suffixes in Hindi). However,
             # when written as a separate auxiliary, all these forms should share

From f678f17af97ee046759b677d6c3b5cda1ab06451 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 12:27:02 +0200
Subject: [PATCH 0690/1374] Spurious semantic auxiliaries.

---
 udapi/block/ud/hi/fixaux.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index f6d9e7d7..1f2d670c 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -13,11 +13,12 @@ def process_node(self, node):
         # The following verbs appear in verb-verb compounds as the semantically
         # less salient element: le (to take), de (to give), ḍāla / phenk (to throw),
         # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come), lā (to bring),
-        # pahuñc (to reach), dekh (to look), phar (to return), cal (to walk).
+        # pahuñc (to reach), dekh (to look), phar (to return), cal (to walk),
+        # caṛh (to climb), saṛ (to rot).
         # There are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
         hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच']
-        urcompound = ['لے', 'دے', 'ڈال', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ', 'پھر', 'چل']
+        urcompound = ['لے', 'دے', 'ڈال', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ', 'پھر', 'چل', 'چڑھ', 'سڑ']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
         # چاہنا चाहना (cāhnā) “to want, to wish” is a control verb but not an auxiliary.

From bff1cecf97b947dc44a60a385209b9fca74a9bc2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 12:53:16 +0200
Subject: [PATCH 0691/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 1f2d670c..e6ec6c53 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -17,7 +17,7 @@ def process_node(self, node):
         # caṛh (to climb), saṛ (to rot).
         # There are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
-        hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच']
+        hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच', 'चल']
         urcompound = ['لے', 'دے', 'ڈال', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ', 'پھر', 'چل', 'چڑھ', 'سڑ']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
@@ -90,7 +90,9 @@ def fix_lemma(self, node):
             # چاہے seems to be a wrong lemma of چاہیں_گے “would like”
             if node.lemma == 'چاہے':
                 node.lemma = 'چاہ'
-            # چکا is a perfective participle of چکنا (cuknā) “to be finished”
+            # चुका چکا is a perfective participle of चुकना چکنا (cuknā) “to be finished”
+            if node.lemma == 'चुका':
+                node.lemma = 'चुक'
             if node.lemma == 'چکا':
                 node.lemma = 'چک'
             # دیا is a perfective participle of دینا (denā) “to give”
@@ -111,6 +113,8 @@ def fix_lemma(self, node):
                 node.lemma = 'جا'
             # Wrongly lemmatized present forms of “to be”.
             # In one instance, ہے had a lemma from a neighboring verb, so we also look at the form.
+            if node.lemma == 'हों':
+                node.lemma = 'है'
             if node.lemma == 'ہوں' or node.lemma == 'ہوا' or node.form == 'ہے':
                 node.lemma = 'ہے'
             # لیا is a perfective participle of لینا (lenā) “to take”

From d956b903dbe9bb3d86079e579706bd9b91cf9a6d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 13:06:39 +0200
Subject: [PATCH 0692/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index e6ec6c53..be0eaf02 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -14,10 +14,10 @@ def process_node(self, node):
         # less salient element: le (to take), de (to give), ḍāla / phenk (to throw),
         # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come), lā (to bring),
         # pahuñc (to reach), dekh (to look), phar (to return), cal (to walk),
-        # caṛh (to climb), saṛ (to rot).
+        # caṛh (to climb), saṛ (to rot), nikāl (to remove).
         # There are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
-        hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच', 'चल']
+        hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच', 'चल', 'निकाल']
         urcompound = ['لے', 'دے', 'ڈال', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ', 'پھر', 'چل', 'چڑھ', 'سڑ']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
@@ -95,7 +95,9 @@ def fix_lemma(self, node):
                 node.lemma = 'चुक'
             if node.lemma == 'چکا':
                 node.lemma = 'چک'
-            # دیا is a perfective participle of دینا (denā) “to give”
+            # दिया دیا is a perfective participle of देना دینا (denā) “to give”
+            if node.lemma == 'दिया':
+                node.lemma = 'दे'
             if node.lemma == 'دیا' or node.lemma == 'دی' or node.lemma == 'دیت':
                 node.lemma = 'دے'
             # دکھائیں (dikhānā) “to show”
@@ -117,8 +119,10 @@ def fix_lemma(self, node):
                 node.lemma = 'है'
             if node.lemma == 'ہوں' or node.lemma == 'ہوا' or node.form == 'ہے':
                 node.lemma = 'ہے'
-            # لیا is a perfective participle of لینا (lenā) “to take”
+            # लिया لیا is a perfective participle of लेना لینا (lenā) “to take”
             # In one instance, لیا had a lemma from a neighboring verb, so we also look at the form.
+            if node.lemma == 'लिया':
+                node.lemma = 'ले'
             if node.lemma == 'لیا' or node.form == 'لیا' or node.lemma == 'لو' or node.lemma == 'لی' or node.lemma == 'لیجیے':
                 node.lemma = 'لے'
             # لگا is a perfective participle of لگنا (lagnā) “to seem, to appear”

From 5308b9e5063d21b17ed2548111f54c2e81e8b1c6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 13:16:16 +0200
Subject: [PATCH 0693/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index be0eaf02..16dfc0aa 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -109,8 +109,10 @@ def fix_lemma(self, node):
             # the same lemma.
             if node.lemma == 'گی' or node.lemma == 'گے':
                 node.lemma = 'گا'
-            # گیا is a perfective participle of جانا‎ (jānā) “to go”
-            # جان is nonsense. It occurs with forms like جانی, which is a feminine form of the infinitive جانا‎.
+            # گیا is a perfective participle of जाना جانا‎ (jānā) “to go”
+            # जान جان is nonsense. It occurs with forms like جانی, which is a feminine form of the infinitive جانا‎.
+            if node.lemma == 'जाना' or node.lemma == 'जान':
+                node.lemma = 'जा'
             if node.lemma == 'گیا' or node.lemma == 'جائے' or node.lemma == 'جاتا' or node.lemma == 'جاتی' or node.lemma == 'جان' or node.lemma == 'جانا' or node.lemma == 'جاؤ' or node.lemma == 'جائی' or node.lemma == 'جاتے' or node.lemma == 'جات':
                 node.lemma = 'جا'
             # Wrongly lemmatized present forms of “to be”.

From 7484b1e55e5820abbb079cf19f8bc7013ae1f726 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 13:53:52 +0200
Subject: [PATCH 0694/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 16dfc0aa..595f1725 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -14,10 +14,10 @@ def process_node(self, node):
         # less salient element: le (to take), de (to give), ḍāla / phenk (to throw),
         # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come), lā (to bring),
         # pahuñc (to reach), dekh (to look), phar (to return), cal (to walk),
-        # caṛh (to climb), saṛ (to rot), nikāl (to remove).
+        # caṛh (to climb), saṛ (to rot), nikāl (to remove), girā (to drop).
         # There are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
-        hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच', 'चल', 'निकाल']
+        hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच', 'चल', 'निकाल', 'गिरा']
         urcompound = ['لے', 'دے', 'ڈال', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ', 'پھر', 'چل', 'چڑھ', 'سڑ']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
@@ -136,13 +136,17 @@ def fix_lemma(self, node):
             # پھرے is a perfective participle of پھرنا (pharnā) “to return”
             if node.lemma == 'پھرے':
                 node.lemma = 'پھر'
-            # رہا is a perfective participle of رہنا (rahnā) “to stay”
+            # रहा رہا is a perfective participle of रहना رہنا (rahnā) “to stay”
+            if node.lemma == 'रहा' or node.lemma == 'रहूं':
+                node.lemma = 'रह'
             if node.lemma == 'رہا' or node.lemma == 'رہی' or node.lemma == 'رہے':
                 node.lemma = 'رہ'
             # sakna to be able to
             if node.lemma == 'سکے' or node.lemma == 'سکی' or node.lemma == 'سکتا' or node.lemma == 'سکت':
                 node.lemma = 'سک'
             # Wrongly lemmatized past forms of “to be”.
+            if node.lemma == 'थी':
+                node.lemma = 'था'
             if node.lemma == 'تھ' or node.lemma == 'تھے' or node.lemma == 'تھیں':
                 node.lemma = 'تھا'
             # The compound part vālā is not an auxiliary. We handle it in process_node()

From 8f5e017e9ab0329fa9894ccde17d2e07d56a207b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 15:29:42 +0200
Subject: [PATCH 0695/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 595f1725..041f5d44 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -127,7 +127,9 @@ def fix_lemma(self, node):
                 node.lemma = 'ले'
             if node.lemma == 'لیا' or node.form == 'لیا' or node.lemma == 'لو' or node.lemma == 'لی' or node.lemma == 'لیجیے':
                 node.lemma = 'لے'
-            # لگا is a perfective participle of لگنا (lagnā) “to seem, to appear”
+            # लगा لگا is a perfective participle of लगना لگنا (lagnā) “to seem, to appear”
+            if node.lemma == 'लगा':
+                node.lemma = 'लग'
             if node.lemma == 'لگا':
                 node.lemma = 'لگ'
             # پڑے is a perfective participle of پڑنا (paṛnā) “to fall”

From 3341b087c67755c3fbe2b4724adcf1776421d453 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 15:47:29 +0200
Subject: [PATCH 0696/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 041f5d44..feb622d9 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -74,9 +74,6 @@ def fix_lemma(self, node):
             # آنے is the oblique infinitive form of “to come”
             if node.lemma == 'آنہ':
                 node.lemma = 'آ'
-            # اٹھنا “to rise, get up”
-            if node.lemma == 'اٹھا':
-                node.lemma = 'اٹھ'
             # بنانا बनाना “make, create, produce, cause to be/become”
             # (I don't know why in some instances بنا was used as lemma for کر “to do”.)
             if node.form == 'کر' and node.lemma == 'بنا':
@@ -151,6 +148,11 @@ def fix_lemma(self, node):
                 node.lemma = 'था'
             if node.lemma == 'تھ' or node.lemma == 'تھے' or node.lemma == 'تھیں':
                 node.lemma = 'تھا'
+            # उठा اٹھا is a perfective participle of उठना اٹھنا (uṭhnā) “to rise, get up”
+            if node.lemma == 'उठा':
+                node.lemma = 'उठ'
+            if node.lemma == 'اٹھا':
+                node.lemma = 'اٹھ'
             # The compound part vālā is not an auxiliary. We handle it in process_node()
             # but it must be lemmatized properly.
             if node.lemma == 'والی':

From 326e3d200f3efce29098efc47f73e73ecf34cc21 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 16:02:34 +0200
Subject: [PATCH 0697/1374] Spurious semantic auxiliaries.

---
 udapi/block/ud/hi/fixaux.py | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index feb622d9..fd0c77c0 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -14,18 +14,20 @@ def process_node(self, node):
         # less salient element: le (to take), de (to give), ḍāla / phenk (to throw),
         # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come), lā (to bring),
         # pahuñc (to reach), dekh (to look), phar (to return), cal (to walk),
-        # caṛh (to climb), saṛ (to rot), nikāl (to remove), girā (to drop).
+        # caṛh (to climb), saṛ (to rot), nikāl (to remove), girā (to drop), samā
+        # (to encounter), dhamaka (to bully).
         # There are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
-        hicompound = ['ले', 'दे', 'डाल', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच', 'चल', 'निकाल', 'गिरा']
+        hicompound = ['ले', 'दे', 'डाल', 'फेंक', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच', 'चल', 'निकाल', 'गिरा', 'समा', 'धमक']
         urcompound = ['لے', 'دے', 'ڈال', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ', 'پھر', 'چل', 'چڑھ', 'سڑ']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
-        # چاہنا चाहना (cāhnā) “to want, to wish” is a control verb but not an auxiliary.
+        # चाहना چاہنا (cāhnā) “to want, to wish” is a control verb but not an auxiliary.
         # Its form چاہیئے (cāhie) “should, ought to” (literally "is wanted"?) is treated as a separate, derived word, and it is a modal auxiliary.
-        # دکھانا दिखाना (dikhānā) “to show”
-        hiphase = ['लग', 'चुक', 'चाह', 'दिखा']
-        urphase = ['لگ', 'چک', 'چاہ', 'دکھا']
+        # दिखाना دکھانا (dikhānā) “to show”
+        # बनना بننا (bananā) “to become”
+        hiphase = ['लग', 'चुक', 'चाह', 'दिखा', 'बन']
+        urphase = ['لگ', 'چک', 'چاہ', 'دکھا', 'بن']
         rephase = r'^(' + '|'.join(hiphase + urphase) + r')$'
         if re.match(recompound, node.lemma) and node.upos == 'AUX' and node.udeprel == 'aux':
             node.deprel = 'compound'

From 67dc40eb1a41ca4fd0be6554c2577767cf532c77 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 16:21:46 +0200
Subject: [PATCH 0698/1374] Spurious semantic auxiliaries.

---
 udapi/block/ud/hi/fixaux.py | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index fd0c77c0..ec61592f 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -11,14 +11,15 @@ class FixAux(Block):
     def process_node(self, node):
         self.fix_lemma(node)
         # The following verbs appear in verb-verb compounds as the semantically
-        # less salient element: le (to take), de (to give), ḍāla / phenk (to throw),
+        # less salient element: le (to take), de (to give), ḍāla / phenka (to throw),
         # baiṭha (to sit), uṭha (to rise), rakha (to keep), ā (to come), lā (to bring),
-        # pahuñc (to reach), dekh (to look), phar (to return), cal (to walk),
-        # caṛh (to climb), saṛ (to rot), nikāl (to remove), girā (to drop), samā
-        # (to encounter), dhamaka (to bully).
+        # pahuñca (to reach), dekha (to look), phara (to return), cala (to walk),
+        # caṛha (to climb), saṛa (to rot), nikala (to get out), nikāla (to remove), girā (to drop),
+        # samā (to encounter), dhamaka (to bully), khaḍā (to stand), daboca (to catch),
+        # gujara (to pass).
         # There are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
-        hicompound = ['ले', 'दे', 'डाल', 'फेंक', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच', 'चल', 'निकाल', 'गिरा', 'समा', 'धमक']
+        hicompound = ['ले', 'दे', 'डाल', 'फेंक', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच', 'चल', 'निकल', 'निकाल', 'गिरा', 'समा', 'धमक', 'खडा', 'दबोच', 'गुजर']
         urcompound = ['لے', 'دے', 'ڈال', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ', 'پھر', 'چل', 'چڑھ', 'سڑ']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
@@ -116,7 +117,7 @@ def fix_lemma(self, node):
                 node.lemma = 'جا'
             # Wrongly lemmatized present forms of “to be”.
             # In one instance, ہے had a lemma from a neighboring verb, so we also look at the form.
-            if node.lemma == 'हों':
+            if node.lemma == 'हों' or node.lemma == 'है.':
                 node.lemma = 'है'
             if node.lemma == 'ہوں' or node.lemma == 'ہوا' or node.form == 'ہے':
                 node.lemma = 'ہے'

From 7ebadbeecf5a10f5a518987822f534f7ae4aa54c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 16:35:58 +0200
Subject: [PATCH 0699/1374] Fix lemmatization.

---
 udapi/block/ud/hi/fixaux.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index ec61592f..49518e05 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -132,6 +132,9 @@ def fix_lemma(self, node):
                 node.lemma = 'लग'
             if node.lemma == 'لگا':
                 node.lemma = 'لگ'
+            # पहुंचा پہنچا is a perfective participle of पहुंचना پہنچنا (pahuñcnā) “to reach”
+            if node.lemma == 'पहुंचा' or node.lemma == 'पहुँच':
+                node.lemma = 'पहुंच'
             # پڑے is a perfective participle of پڑنا (paṛnā) “to fall”
             if node.lemma == 'پڑے':
                 node.lemma = 'پڑ'

From 58bdbc12283ea253f33a12a3966b2166b82e463f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 22 Aug 2022 16:49:07 +0200
Subject: [PATCH 0700/1374] Spurious semantic auxiliaries.

---
 udapi/block/ud/hi/fixaux.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/hi/fixaux.py b/udapi/block/ud/hi/fixaux.py
index 49518e05..004ab4af 100644
--- a/udapi/block/ud/hi/fixaux.py
+++ b/udapi/block/ud/hi/fixaux.py
@@ -16,10 +16,10 @@ def process_node(self, node):
         # pahuñca (to reach), dekha (to look), phara (to return), cala (to walk),
         # caṛha (to climb), saṛa (to rot), nikala (to get out), nikāla (to remove), girā (to drop),
         # samā (to encounter), dhamaka (to bully), khaḍā (to stand), daboca (to catch),
-        # gujara (to pass).
+        # gujara (to pass), ghera (to surround), baca (to escape).
         # There are also jā (to go) and paṛa (to fall) but we do not list them here
         # because they can also act as genuine auxiliaries.
-        hicompound = ['ले', 'दे', 'डाल', 'फेंक', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच', 'चल', 'निकल', 'निकाल', 'गिरा', 'समा', 'धमक', 'खडा', 'दबोच', 'गुजर']
+        hicompound = ['ले', 'दे', 'डाल', 'फेंक', 'बैठ', 'उठ', 'रख', 'आ', 'पहुंच', 'चल', 'निकल', 'निकाल', 'गिरा', 'समा', 'धमक', 'खडा', 'दबोच', 'गुजर', 'फूंक', 'घेर', 'बच']
         urcompound = ['لے', 'دے', 'ڈال', 'پھینک', 'بیٹھ', 'اٹھ', 'رکھ', 'آ', 'لا', 'پہنچ', 'دیکھ', 'پھر', 'چل', 'چڑھ', 'سڑ']
         recompound = r'^(' + '|'.join(hicompound + urcompound) + r')$'
         # Control and raising verbs.
@@ -27,7 +27,7 @@ def process_node(self, node):
         # Its form چاہیئے (cāhie) “should, ought to” (literally "is wanted"?) is treated as a separate, derived word, and it is a modal auxiliary.
         # दिखाना دکھانا (dikhānā) “to show”
         # बनना بننا (bananā) “to become”
-        hiphase = ['लग', 'चुक', 'चाह', 'दिखा', 'बन']
+        hiphase = ['लग', 'चुक', 'चाह', 'दिखा', 'बन', 'करा']
         urphase = ['لگ', 'چک', 'چاہ', 'دکھا', 'بن']
         rephase = r'^(' + '|'.join(hiphase + urphase) + r')$'
         if re.match(recompound, node.lemma) and node.upos == 'AUX' and node.udeprel == 'aux':

From 5a239dd41c325b1583fe635b9854a2e68d2893a9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 30 Sep 2022 13:21:36 +0200
Subject: [PATCH 0701/1374] FixLeaf: case and mark should be among the
 defaults.

---
 udapi/block/ud/fixleaf.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/fixleaf.py b/udapi/block/ud/fixleaf.py
index d715ec01..9b4ce191 100644
--- a/udapi/block/ud/fixleaf.py
+++ b/udapi/block/ud/fixleaf.py
@@ -8,11 +8,11 @@
 
 class FixLeaf(Block):
     """
-    Make sure that aux and cop dependents are leaves unless one of the known
-    exceptions applies.
+    Make sure that function words are leaves unless one of the known exceptions
+    applies.
     """
 
-    def __init__(self, deprels='aux,cop,cc', **kwargs):
+    def __init__(self, deprels='aux,cop,case,mark,cc', **kwargs):
         """
         Args:
         deprels: comma-separated list of deprels to be fixed. Default = aux,cop,case,mark,cc.

From b2d1ea858224ffb8ef37929e4e998b524dc9d98a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 30 Sep 2022 13:53:01 +0200
Subject: [PATCH 0702/1374] Paired punctuation must not cause non-projectivity
 if an outside node depends on an inside node.

---
 udapi/block/ud/fixpunct.py | 58 +++++++++++++++++++++++++-------------
 1 file changed, 38 insertions(+), 20 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 95cb40d0..15d310c7 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -27,15 +27,15 @@
     '{': '}',
     '"': '"',   # ASCII double quotes
     "'": "'",   # ASCII single quotes
-    '“': '”',   # quotation marks used in English,...
-    '„': '“',   # Czech, German, Russian,...
-    '«': '»',   # French, Russian, Spanish,...
+    '“': '”',   # quotation marks used in English, ...
+    '„': '“',   # Czech, German, Russian, ...
+    '«': '»',   # French, Russian, Spanish, ...
     '‹': '›',   # dtto
     '《': '》',  # Korean, Chinese
     '「': '」',  # Chinese, Japanese
-    '『': '』',  # dtto
-    '¿': '?',   # Spanish question quotation marks
-    '¡': '!',   # Spanish exclamation quotation marks
+    '『': '』',  # ditto
+    '¿': '?',   # Spanish paired question marks
+    '¡': '!',   # Spanish paired exclamation marks
     }
 
 FINAL_PUNCT = '.?!'
@@ -65,7 +65,7 @@ def process_tree(self, root):
         # This may introduce multiple subroots, which will be fixed later on
         # (preventing to temporarily create multiple subroots here would prevent fixing some errors).
         for node in root.descendants:
-            while node.parent.upos == "PUNCT":
+            while node.parent.upos == 'PUNCT':
                 node.parent = node.parent.parent
 
         # Second, fix paired punctuations: quotes and brackets, marking them in _punct_type.
@@ -83,10 +83,9 @@ def process_tree(self, root):
 
         # Third, fix subordinate punctuation (i.e. any punctuation not marked in _punct_type).
         for node in root.descendants:
-            if node.upos == "PUNCT" and not self._punct_type[node.ord]:
+            if node.upos == 'PUNCT' and not self._punct_type[node.ord]:
                 self._fix_subord_punct(node)
 
-
         # UD requires "exactly one word is the head of the sentence, dependent on a notional ROOT", i.e. a single "subroot".
         # This seems to be a stronger rule than no-PUNCT-children because it is checked by the validator.
         # So lets prevent multiple subroots (at the cost of possibly re-introducing PUNCT-children).
@@ -107,7 +106,7 @@ def process_tree(self, root):
         # TODO: This block changes parents not only for PUNCT nodes. These should be reflected into enhanced deps as well.
         if self.copy_to_enhanced:
             for node in root.descendants:
-                if node.upos == "PUNCT":
+                if node.upos == 'PUNCT':
                     node.deps = [{'parent': node.parent, 'deprel': 'punct'}]
 
     def _fix_subord_punct(self, node):
@@ -131,12 +130,12 @@ def _fix_subord_punct(self, node):
         l_cand, r_cand = node.prev_node, node.next_node
         if node.form in FINAL_PUNCT:
             r_cand = None
-        while l_cand.ord > 0 and l_cand.upos == "PUNCT":
+        while l_cand.ord > 0 and l_cand.upos == 'PUNCT':
             if self._punct_type[l_cand.ord] == 'opening' and l_cand.parent != node:
                 l_cand = None
                 break
             l_cand = l_cand.prev_node
-        while r_cand is not None and r_cand.upos == "PUNCT":
+        while r_cand is not None and r_cand.upos == 'PUNCT':
             if self._punct_type[r_cand.ord] == 'closing' and r_cand.parent != node:
                 r_cand = None
                 break
@@ -193,7 +192,7 @@ def _fix_subord_punct(self, node):
         # We try to be conservative and keep the parent, unless we are sure it is wrong.
         if node.parent not in path:
             node.parent = cand
-        node.deprel = "punct"
+        node.deprel = 'punct'
 
     def _will_be_projective(self, node, cand):
         node.parent = cand
@@ -206,7 +205,6 @@ def _fix_paired_punct(self, root, opening_node, closing_punct):
         if (self.check_paired_punct_upos
             or opening_node.form == "'") and opening_node.upos != 'PUNCT':
             return
-
         nested_level = 0
         for node in root.descendants[opening_node.ord:]:
             if node.form == closing_punct:
@@ -219,14 +217,31 @@ def _fix_paired_punct(self, root, opening_node, closing_punct):
                 nested_level += 1
 
     def _fix_pair(self, root, opening_node, closing_node):
+        # Ideally, paired punctuation symbols should be attached to the single
+        # head of the subtree inside. Provided the inside segment is a single
+        # subtree.
         heads = []
         punct_heads = []
-        for node in root.descendants[opening_node.ord: closing_node.ord - 1]:
-            if node.parent.precedes(opening_node) or closing_node.precedes(node.parent):
-                if node.upos == 'PUNCT':
-                    punct_heads.append(node)
-                else:
-                    heads.append(node)
+        for node in root.descendants:
+            if node == opening_node or node == closing_node:
+                continue
+            # If this is a node inside of the pair, is its parent outside?
+            if opening_node.precedes(node) and node.precedes(closing_node):
+                if node.parent.precedes(opening_node) or closing_node.precedes(node.parent):
+                    if node.upos == 'PUNCT':
+                        punct_heads.append(node)
+                    else:
+                        heads.append(node)
+            # Not only the punctuation symbols must not be attached non-projectively,
+            # they also must not cause non-projectivity of other relations. This could
+            # happen if an outside node is attached to an inside node. To account for
+            # this, mark the inside parent as a head, too.
+            else:
+                if opening_node.precedes(node.parent) and node.parent.precedes(closing_node):
+                    if node.parent.upos == 'PUNCT':
+                        punct_heads.append(node.parent)
+                    else:
+                        heads.append(node.parent)
 
         # Punctuation should not have children, but if there is no other head candidate,
         # let's break this rule.
@@ -246,6 +261,9 @@ def _fix_pair(self, root, opening_node, closing_node):
             # However, this means that the paired punctuation will be attached non-projectively,
             # which is forbidden by the UD guidelines.
             # Thus, we will choose the nearest head, which is the only way how to prevent non-projectivities.
+            # Sort the heads by their ords (this is not guaranteed because we were adding a mixture of
+            # inside heads and inside parents of outside nodes).
+            heads.sort(key=lambda x: x.ord)
             opening_node.parent = heads[0]
             closing_node.parent = heads[-1]
 

From 559ec080cdf924289c95468b94640053c069621b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 11 Nov 2022 10:27:35 +0100
Subject: [PATCH 0703/1374] Optionally fix non-copula auxiliaries alongside
 copulas.

---
 udapi/block/ud/fixpseudocop.py | 53 +++++++++++++++++++---------------
 1 file changed, 30 insertions(+), 23 deletions(-)

diff --git a/udapi/block/ud/fixpseudocop.py b/udapi/block/ud/fixpseudocop.py
index ab07eaaa..ecc5f0bd 100644
--- a/udapi/block/ud/fixpseudocop.py
+++ b/udapi/block/ud/fixpseudocop.py
@@ -7,33 +7,40 @@
 
 class FixPseudoCop(Block):
 
-    def __init__(self, lemma, **kwargs):
+    def __init__(self, lemmas, noncopaux=False, **kwargs):
         """Create the ud.FixPseudoCop block instance.
 
         Args:
-        lemma: the lemma of the pseudocopula that should be fixed
+        lemmas: comma-separated list of lemmas of the pseudocopulas that should be fixed
+        noncopaux: do the same for non-copula auxiliaries with the given lemma
         """
         super().__init__(**kwargs)
-        self.lemma = lemma
+        self.lemmas = lemmas.split(',')
+        self.noncopaux = noncopaux
 
     def process_node(self, node):
-        pseudocop = self.lemma
-        if node.lemma == pseudocop and node.udeprel == "cop":
-            secpred = node.parent
-            grandparent = secpred.parent
-            node.parent = grandparent
-            node.deprel = secpred.deprel
-            secpred.parent = node
-            secpred.deprel = "xcomp"
-            ###!!! We should also take care of DEPS if they exist.
-            # As a copula, the word was tagged AUX. Now it should be VERB.
-            node.upos = "VERB"
-            # Examine the children of the original parent.
-            # Those that modify the clause should be re-attached to me.
-            # Those that modify the word (noun, adjective) should stay there.
-            for c in secpred.children:
-                # obl is borderline. It could modify an adjective rather than a clause.
-                # obj and iobj should not occur in copular clauses but it sometimes
-                # occurs with pseudocopulas: "I declare him handsome."
-                if re.match("(nsubj|csubj|advmod|advcl|obj|iobj|obl|aux|mark|punct|cc|expl|dislocated|vocative|discourse|parataxis)", c.udeprel):
-                    c.parent = node
+        pseudocop = self.lemmas
+        if node.lemma in pseudocop:
+            # Besides spurious copulas, this block can be optionally used to fix spurious auxiliaries (if noncopaux is set).
+            if node.udeprel == 'cop' or self.noncopaux and node.udeprel == 'aux':
+                secpred = node.parent
+                grandparent = secpred.parent
+                node.parent = grandparent
+                node.deprel = secpred.deprel
+                secpred.parent = node
+                secpred.deprel = "xcomp"
+                ###!!! We should also take care of DEPS if they exist.
+                # As a copula, the word was tagged AUX. Now it should be VERB.
+                node.upos = "VERB"
+                # Examine the children of the original parent.
+                # Those that modify the clause should be re-attached to me.
+                # Those that modify the word (noun, adjective) should stay there.
+                for c in secpred.children:
+                    # obl is borderline. It could modify an adjective rather than a clause.
+                    # obj and iobj should not occur in copular clauses but it sometimes
+                    # occurs with pseudocopulas: "I declare him handsome."
+                    if re.match("(nsubj|csubj|advmod|advcl|obj|iobj|obl|aux|mark|punct|cc|expl|dislocated|vocative|discourse|parataxis)", c.udeprel):
+                        c.parent = node
+            # Another possible error is that the word is tagged AUX without being attached as "cop" or "aux".
+            elif self.noncopaux and node.upos == 'AUX':
+                node.upos = 'VERB'

From ea1c77b57cfbd3cea9e7afa26a789bc688bf7003 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 11 Nov 2022 11:17:36 +0100
Subject: [PATCH 0704/1374] Delete --use-feature=in-tree-build

This feature was removed in pip 22.3
(in-tree builds are now the default)
and it results in CircleCI fails.
---
 .circleci/config.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 7be539d2..4e88d664 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -35,7 +35,7 @@ jobs:
           # pip-dependency-file: test-requirements.txt  # if you have a different name for your requirements file, maybe one that combines your runtime and test requirements.
       - run:
           name: Install Udapi
-          command: pip install --use-feature=in-tree-build ".[test]"
+          command: pip install ".[test]"
       - run:
           name: Run pytest tests
           # This assumes pytest is installed via the install-package step above

From 1ef23f857b8f8c9b7080b9c33d2dde56a14abf1f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 24 Nov 2022 16:58:39 +0100
Subject: [PATCH 0705/1374] Reworked feature checking so that a similar block
 can be written for another language.

---
 udapi/block/ud/cs/markfeatsbugs.py | 37 ++-------------
 udapi/block/ud/markfeatsbugs.py    | 75 ++++++++++++++++++++++++++++++
 2 files changed, 80 insertions(+), 32 deletions(-)
 create mode 100644 udapi/block/ud/markfeatsbugs.py

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 11ecd6d9..3fb8d058 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -2,12 +2,15 @@
 Block to identify missing or ill-valued features in Czech. Any bugs that it
 finds will be saved in the MISC column as a Bug attribute, which can be later
 used in filters and highlighted in text output.
+
+Usage: cat *.conllu | udapy -HAM ud.cs.MarkFeatsBugs > bugs.html
+Windows: python udapy read.Conllu files="a.conllu,b.conllu" ud.cs.MarkFeatsBugs write.TextModeTreesHtml files="bugs.html" marked_only=1 attributes=form,lemma,upos,xpos,feats,deprel,misc
 """
-from udapi.core.block import Block
+import udapi.block.ud.markfeatsbugs
 import logging
 import re
 
-class MarkFeatsBugs(Block):
+class MarkFeatsBugs(udapi.block.ud.markfeatsbugs.MarkFeatsBugs):
 
     # The convention used in PDT is not consistent. Adjectives are fully disambiguated
     # (three genders, two animacies, three numbers, seven cases), even though some
@@ -21,36 +24,6 @@ class MarkFeatsBugs(Block):
     # in the future.
     pdt20 = False # True = like in PDT 2.0; False = like in ČNK
 
-    def bug(self, node, bugstring):
-        bugs = []
-        if node.misc['Bug']:
-            bugs = node.misc['Bug'].split('+')
-        if not bugstring in bugs:
-            bugs.append(bugstring)
-        node.misc['Bug'] = '+'.join(bugs)
-
-    def check_allowed_features(self, node, allowed):
-        """
-        We need a dictionary indexed by feature names that are allowed; for each
-        feature name, there is a list of allowed values.
-        """
-        # Check for features that are not allowed but the node has them.
-        # For features that are allowed, check that their values are allowed.
-        for f in node.feats:
-            if f in allowed:
-                if not node.feats[f] in allowed[f]:
-                    self.bug(node, 'Feat' + f + 'Value' + node.feats[f] + 'NotAllowed')
-            else:
-                self.bug(node, 'Feat' + f + 'NotAllowed')
-
-    def check_required_features(self, node, required):
-        """
-        We need a list of names of features whose values must not be empty.
-        """
-        for f in required:
-            if not f in node.feats:
-                self.bug(node, 'Feat' + f + 'Missing')
-
     def process_node(self, node):
         # NOUNS ################################################################
         if node.upos == 'NOUN':
diff --git a/udapi/block/ud/markfeatsbugs.py b/udapi/block/ud/markfeatsbugs.py
new file mode 100644
index 00000000..b24dcecb
--- /dev/null
+++ b/udapi/block/ud/markfeatsbugs.py
@@ -0,0 +1,75 @@
+"""
+Block to identify missing or ill-valued features in a treebank. Any bugs that it
+finds will be saved in the MISC column as a Bug attribute, which can be later
+used in filters and highlighted in text output. This is a base block that only
+implements service methods. A language-specific block must be derived from this
+one and define the actual rules valid in that language.
+
+Usage (Czech example): cat *.conllu | udapy -HAM ud.cs.MarkFeatsBugs > bugs.html
+"""
+from udapi.core.block import Block
+import logging
+import re
+
+class MarkFeatsBugs(Block):
+
+    def bug(self, node, bugstring):
+        bugs = []
+        if node.misc['Bug']:
+            bugs = node.misc['Bug'].split('+')
+        if not bugstring in bugs:
+            bugs.append(bugstring)
+        node.misc['Bug'] = '+'.join(bugs)
+
+    def check_allowed_features(self, node, allowed):
+        """
+        We need a dictionary indexed by feature names that are allowed; for each
+        feature name, there is a list of allowed values.
+        """
+        # Check for features that are not allowed but the node has them.
+        # For features that are allowed, check that their values are allowed.
+        for f in node.feats:
+            if f in allowed:
+                if not node.feats[f] in allowed[f]:
+                    self.bug(node, 'Feat' + f + 'Value' + node.feats[f] + 'NotAllowed')
+            else:
+                self.bug(node, 'Feat' + f + 'NotAllowed')
+
+    def check_required_features(self, node, required):
+        """
+        We need a list of names of features whose values must not be empty.
+        """
+        for f in required:
+            if not f in node.feats:
+                self.bug(node, 'Feat' + f + 'Missing')
+
+    def process_node(self, node):
+        """
+        This is a generic block, do nothing here. In a language-specific block
+        based on this one, rules similar to the examples below can be specified:
+
+        # NOUNS ################################################################
+        if node.upos == 'NOUN':
+            self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity'])
+            if node.feats['Gender'] == 'Masc':
+                self.check_required_features(node, ['Animacy'])
+                self.check_allowed_features(node, {
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Animacy': ['Anim', 'Inan'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'Polarity': ['Pos', 'Neg'],
+                    'Foreign': ['Yes']})
+            else:
+                self.check_allowed_features(node, {
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'Polarity': ['Pos', 'Neg'],
+                    'Foreign': ['Yes']})
+        #...
+        # THE REST: NO FEATURES ################################################
+        else:
+            self.check_allowed_features(node, {})
+        """
+        return

From 5a836db5852a97a69b972646493024894a7d3ca4 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 24 Nov 2022 17:37:16 +0100
Subject: [PATCH 0706/1374] Added Latin.

---
 udapi/block/ud/cs/markfeatsbugs.py |   2 +-
 udapi/block/ud/la/markfeatsbugs.py | 608 +++++++++++++++++++++++++++++
 2 files changed, 609 insertions(+), 1 deletion(-)
 create mode 100644 udapi/block/ud/la/markfeatsbugs.py

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 3fb8d058..ef203033 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -4,7 +4,7 @@
 used in filters and highlighted in text output.
 
 Usage: cat *.conllu | udapy -HAM ud.cs.MarkFeatsBugs > bugs.html
-Windows: python udapy read.Conllu files="a.conllu,b.conllu" ud.cs.MarkFeatsBugs write.TextModeTreesHtml files="bugs.html" marked_only=1 attributes=form,lemma,upos,xpos,feats,deprel,misc
+Windows: python udapy read.Conllu files="a.conllu,b.conllu" ud.cs.MarkFeatsBugs write.TextModeTreesHtml files="bugs.html" marked_only=1 layout=compact attributes=form,lemma,upos,xpos,feats,deprel,misc
 """
 import udapi.block.ud.markfeatsbugs
 import logging
diff --git a/udapi/block/ud/la/markfeatsbugs.py b/udapi/block/ud/la/markfeatsbugs.py
new file mode 100644
index 00000000..8741eabb
--- /dev/null
+++ b/udapi/block/ud/la/markfeatsbugs.py
@@ -0,0 +1,608 @@
+"""
+Block to identify missing or ill-valued features in Latin. Any bugs that it
+finds will be saved in the MISC column as a Bug attribute, which can be later
+used in filters and highlighted in text output.
+
+Usage: cat *.conllu | udapy -HAM ud.la.MarkFeatsBugs > bugs.html
+Windows: python udapy read.Conllu files="a.conllu,b.conllu" ud.la.MarkFeatsBugs write.TextModeTreesHtml files="bugs.html" marked_only=1 layout=compact attributes=form,lemma,upos,xpos,feats,deprel,misc
+"""
+import udapi.block.ud.markfeatsbugs
+import logging
+import re
+
+class MarkFeatsBugs(udapi.block.ud.markfeatsbugs.MarkFeatsBugs):
+
+    def process_node(self, node):
+        # NOUNS ################################################################
+        if node.upos == 'NOUN':
+            self.check_required_features(node, ['Gender', 'Number', 'Case'])
+            if node.feats['Gender'] == 'Masc':
+                self.check_required_features(node, ['Animacy'])
+                self.check_allowed_features(node, {
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Animacy': ['Anim', 'Inan'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'Foreign': ['Yes']})
+            else:
+                self.check_allowed_features(node, {
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'Foreign': ['Yes']})
+        # PROPER NOUNS #########################################################
+        elif node.upos == 'PROPN':
+            self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity'])
+            if node.feats['Gender'] == 'Masc':
+                self.check_required_features(node, ['Animacy'])
+                self.check_allowed_features(node, {
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Animacy': ['Anim', 'Inan'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'Polarity': ['Pos', 'Neg'],
+                    'NameType': ['Giv', 'Sur', 'Geo'],
+                    'Foreign': ['Yes']})
+            else:
+                self.check_allowed_features(node, {
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'Polarity': ['Pos', 'Neg'],
+                    'NameType': ['Giv', 'Sur', 'Geo'],
+                    'Foreign': ['Yes']})
+        # ADJECTIVES ###########################################################
+        elif node.upos == 'ADJ':
+            if node.feats['Poss'] == 'Yes': # possessive adjectives
+                if node.feats['Gender'] == 'Masc':
+                    self.check_required_features(node, ['Poss', 'Gender[psor]', 'Gender', 'Animacy', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'Poss': ['Yes'],
+                        'Gender[psor]': ['Masc', 'Fem'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'NameType': ['Giv', 'Sur'], # for possessive adjectives derived from personal names
+                        'Foreign': ['Yes']})
+                else:
+                    self.check_required_features(node, ['Poss', 'Gender[psor]', 'Gender', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'Poss': ['Yes'],
+                        'Gender[psor]': ['Masc', 'Fem'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'NameType': ['Giv', 'Sur'], # for possessive adjectives derived from personal names
+                        'Foreign': ['Yes']})
+            elif node.feats['NumType'] == 'Ord': # ordinal numerals are a subtype of adjectives
+                if node.feats['Gender'] == 'Masc':
+                    self.check_required_features(node, ['NumType', 'Gender', 'Animacy', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'NumType': ['Ord'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Foreign': ['Yes']})
+                else:
+                    self.check_required_features(node, ['NumType', 'Gender', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'NumType': ['Ord'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Foreign': ['Yes']})
+            elif node.feats['VerbForm'] == 'Part': # participles (except l-participles) are a subtype of adjectives
+                self.check_required_features(node, ['VerbForm', 'Voice'])
+                if node.feats['Voice'] == 'Act': # active participles have tense, passives don't
+                    if node.feats['Gender'] == 'Masc':
+                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Tense', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity'])
+                        self.check_allowed_features(node, {
+                            'VerbForm': ['Part'],
+                            'Aspect': ['Imp', 'Perf'],
+                            'Voice': ['Act'],
+                            'Tense': ['Past', 'Pres', 'Fut'], # Fut only for lemma 'boudoucí'
+                            'Gender': ['Masc', 'Fem', 'Neut'],
+                            'Animacy': ['Anim', 'Inan'],
+                            'Number': ['Sing', 'Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                            'Polarity': ['Pos', 'Neg'],
+                            'Variant': ['Short'],
+                            'Foreign': ['Yes']})
+                    else:
+                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Tense', 'Gender', 'Number', 'Case', 'Polarity'])
+                        self.check_allowed_features(node, {
+                            'VerbForm': ['Part'],
+                            'Aspect': ['Imp', 'Perf'],
+                            'Voice': ['Act'],
+                            'Tense': ['Past', 'Pres', 'Fut'], # Fut only for lemma 'boudoucí'
+                            'Gender': ['Masc', 'Fem', 'Neut'],
+                            'Number': ['Sing', 'Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                            'Polarity': ['Pos', 'Neg'],
+                            'Variant': ['Short'],
+                            'Foreign': ['Yes']})
+                else:
+                    if node.feats['Gender'] == 'Masc':
+                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity'])
+                        self.check_allowed_features(node, {
+                            'VerbForm': ['Part'],
+                            'Aspect': ['Imp', 'Perf'],
+                            'Voice': ['Pass'],
+                            'Gender': ['Masc', 'Fem', 'Neut'],
+                            'Animacy': ['Anim', 'Inan'],
+                            'Number': ['Sing', 'Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                            'Polarity': ['Pos', 'Neg'],
+                            'Variant': ['Short'],
+                            'Foreign': ['Yes']})
+                    else:
+                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Number', 'Case', 'Polarity'])
+                        self.check_allowed_features(node, {
+                            'VerbForm': ['Part'],
+                            'Aspect': ['Imp', 'Perf'],
+                            'Voice': ['Pass'],
+                            'Gender': ['Masc', 'Fem', 'Neut'],
+                            'Number': ['Sing', 'Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                            'Polarity': ['Pos', 'Neg'],
+                            'Variant': ['Short'],
+                            'Foreign': ['Yes']})
+            elif node.feats['Variant'] == 'Short': # short (nominal) forms of adjectives have no degree
+                if node.feats['Gender'] == 'Masc':
+                    self.check_required_features(node, ['Gender', 'Animacy', 'Number', 'Case', 'Polarity', 'Variant'])
+                    self.check_allowed_features(node, {
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Variant': ['Short'],
+                        'Foreign': ['Yes']})
+                else:
+                    self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity', 'Variant'])
+                    self.check_allowed_features(node, {
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Variant': ['Short'],
+                        'Foreign': ['Yes']})
+            else: # regular adjectives
+                if node.feats['Gender'] == 'Masc':
+                    self.check_required_features(node, ['Gender', 'Animacy', 'Number', 'Case', 'Degree', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Degree': ['Pos', 'Cmp', 'Sup'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Foreign': ['Yes']})
+                else:
+                    self.check_required_features(node, ['Gender', 'Number', 'Case', 'Degree', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Degree': ['Pos', 'Cmp', 'Sup'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Foreign': ['Yes']})
+        # PRONOUNS #############################################################
+        elif node.upos == 'PRON':
+            self.check_required_features(node, ['PronType'])
+            if node.feats['PronType'] == 'Prs':
+                if node.feats['Reflex'] == 'Yes':
+                    self.check_required_features(node, ['PronType', 'Reflex', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Prs'],
+                        'Reflex': ['Yes'],
+                        'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins'],
+                        'Variant': ['Short']
+                    })
+                else: # not reflexive
+                    if node.feats['Person'] == '3': # on, ona, ono, oni, ony
+                        if re.match(r'^(Nom|Voc)$', node.feats['Case']): # on, ona, ono, oni, ony
+                            self.check_adjective_like(node, ['PronType', 'Person'], {
+                                'PronType': ['Prs'],
+                                'Person': ['3']
+                            })
+                        else: # jeho, něho, jemu, němu, jej, něj, něm, jím, ním, jí, ní, ji, ni, je, ně
+                            # Mostly only two gender groups and no animacy:
+                            # Masc,Neut ... jeho, jemu, jej, něm, jím
+                            # Fem ... jí, ji, ní
+                            # Neut ... je
+                            # No gender in dual and plural:
+                            # Plur ... jich, jim, je, nich, jimi
+                            self.check_adjective_like(node, ['PronType', 'Person', 'PrepCase'], {
+                                'PronType': ['Prs'],
+                                'Person': ['3'],
+                                'PrepCase': ['Npr', 'Pre']
+                            })
+                    else: # 1st and 2nd person do not have gender: já, ty
+                        self.check_required_features(node, ['PronType', 'Person', 'Number', 'Case'])
+                        self.check_allowed_features(node, {
+                            'PronType': ['Prs'],
+                            'Person': ['1', '2'],
+                            'Number': ['Sing', 'Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                            'Variant': ['Short']
+                        })
+            elif re.search(r'k[dt]o', node.lemma): # kdo (kto), kdož, někdo, nikdo
+                # There is no Number. Někdo and nikdo behave like singular;
+                # kdo is by default singular as well but it also occurs as a subject
+                # of plural verbs.
+                self.check_required_features(node, ['PronType', 'Gender', 'Animacy', 'Case'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Int,Rel', 'Rel', 'Ind', 'Neg'],
+                    'Gender': ['Masc'],
+                    'Animacy': ['Anim'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Loc', 'Ins']
+                })
+            elif re.match(r'^(co|což|něco|nicož)$', node.lemma):
+                # Although these pronouns behave by default as neuter singular,
+                # no Gender and Number is annotated. However, quite unusually,
+                # there is Animacy=Inan without Gender.
+                ###!!! This should probably be fixed in all Czech treebanks and
+                ###!!! in Interset. The pronoun should get Gender=Neut and no
+                ###!!! animacy. For now, let's at least make animacy an optional
+                ###!!! feature (I see that we already do not fill it in the Old
+                ###!!! Czech data).
+                self.check_required_features(node, ['PronType', 'Case'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Int,Rel', 'Rel', 'Ind', 'Neg'],
+                    'Animacy': ['Inan'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Loc', 'Ins']
+                })
+            elif node.lemma == 'ješto':
+                # Unlike 'jenžto', this relative pronoun does not inflect, it
+                # always occurs in a nominative position, but the context can
+                # be any gender and number.
+                self.check_required_features(node, ['PronType', 'Case'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Rel'],
+                    'Case': ['Nom']
+                })
+            elif re.match(r'^(jenž|jenžto)$', node.lemma):
+                # The relative pronouns 'jenž', 'jenžto' inflect for gender;
+                # while we normally take this as a sign of DET (instead of PRON),
+                # these can never act as real DET because they never modify a
+                # nominal.
+                # Similarly to the personal pronoun 'on', animacy is only
+                # annotated for masculine nominative plural, non-nominative
+                # forms are merged for masculine and neuter (jehož, jemuž), and
+                # non-singular gender is only annotated in nominative (while
+                # these cases are common for all genders: jichž, jimž, jimiž).
+                # Unlike 'on', 'jenž' has the feature PrepCase everywhere, even
+                # in the nominative, although there is no prepositional counter-
+                # part (but similarly the locative has no prepositionless form).
+                self.check_adjective_like(node, ['PronType', 'PrepCase'], {
+                    'PronType': ['Rel'],
+                    'PrepCase': ['Npr', 'Pre']
+                })
+            else:
+                # What remains is the relative pronoun 'an'. It behaves similarly
+                # to 'jenž' but it does not have the PrepCase feature and it
+                # only occurs in the nominative.
+                if node.feats['Gender'] == 'Masc' and node.feats['Number'] == 'Plur': # ani
+                    self.check_required_features(node, ['PronType', 'Gender', 'Animacy', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Rel'],
+                        'Gender': ['Masc'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Plur'],
+                        'Case': ['Nom']
+                    })
+                else: # not Masc Plur: an, ana, ano, any
+                    self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Rel'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom']
+                    })
+        # DETERMINERS ##########################################################
+        elif node.upos == 'DET':
+            # Possessive determiners 'jeho' and 'jejich' (formerly 'jich') do not inflect, i.e., no Gender, Number, Case.
+            # Note that the possessive determiner 'její' (formerly 'jejie') does inflect, although it also has the lemma 'jeho'.
+            if re.match(r'^(jeho|jejich|jich)(ž(to)?)?$', node.form.lower()):
+                self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Prs', 'Rel'],
+                    'Poss': ['Yes'],
+                    'Person': ['3'],
+                    'Number[psor]': ['Sing', 'Dual', 'Plur'],
+                    'Gender[psor]': ['Masc,Neut']
+                })
+            elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)(ž(to)?)?$', node.form.lower()):
+                # The feminine possessive 'její' slightly inflects, unlike 'jeho' and 'jejich'.
+                # Congruent gender is annotated only in singular. Masculine and
+                # neuter are merged even in nominative. Feminine singular does
+                # not distinguish case in PDT but we need it in Old Czech at
+                # least for 'jejiej'.
+                if node.feats['Number'] == 'Sing':
+                    self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]', 'Gender', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Prs', 'Rel'],
+                        'Poss': ['Yes'],
+                        'Person': ['3'],
+                        'Number[psor]': ['Sing'],
+                        'Gender[psor]': ['Fem'],
+                        'Gender': ['Masc,Neut', 'Fem'],
+                        'Number': ['Sing'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
+                else:
+                    self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Prs', 'Rel'],
+                        'Poss': ['Yes'],
+                        'Person': ['3'],
+                        'Number[psor]': ['Sing'],
+                        'Gender[psor]': ['Fem'],
+                        'Number': ['Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
+            elif node.feats['Poss'] == 'Yes': # 'můj', 'tvůj', 'svůj'
+                if node.feats['Reflex'] == 'Yes':
+                    self.check_adjective_like(node, ['PronType', 'Poss', 'Reflex'], {
+                        'PronType': ['Prs'],
+                        'Poss': ['Yes'],
+                        'Reflex': ['Yes']
+                    })
+                else:
+                    self.check_adjective_like(node, ['PronType', 'Poss', 'Person', 'Number[psor]'], {
+                        'PronType': ['Prs'],
+                        'Poss': ['Yes'],
+                        'Person': ['1', '2'],
+                        'Number[psor]': ['Sing', 'Plur']
+                    })
+            else:
+                self.check_adjective_like(node, ['PronType'], {'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp']})
+        # NUMERALS #############################################################
+        elif node.upos == 'NUM':
+            self.check_required_features(node, ['NumType', 'NumForm'])
+            # Arabic digits and Roman numerals do not have inflection features.
+            if re.match(r'^(Digit|Roman)$', node.feats['NumForm']):
+                self.check_allowed_features(node, {
+                    'NumType': ['Card'],
+                    'NumForm': ['Digit', 'Roman']
+                })
+            else:
+                ###!!! Somehow the NumValue feature from PDT via Interset is useless.
+                # 'jeden' has Gender, Animacy, Number, Case: jeden, jedna, jedno, jednoho, jednomu, jednom, jedním, jedné, jednu, jednou, jedni, jedny, jedněch, jedněm, jedněmi.
+                # 'dva', 'oba' have Gender, Number=Dual(Plur in modern Czech), Case: dva, dvě, dvou, dvěma.
+                # 'tři', 'čtyři' have Number=Plur, Case: tři, třech, třem, třemi.
+                # 'pět' and more have Number=Plur, Case: pět, pěti.
+                if node.lemma == 'jeden':
+                    self.check_required_features(node, ['NumType', 'NumForm', 'NumValue', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'NumType': ['Card'],
+                        'NumForm': ['Word'],
+                        'NumValue': ['1,2,3'],
+                        'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # similarly to determiners, genders are merged in some slots of the paradigm
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
+                elif re.match(r'^(dva|oba)$', node.lemma):
+                    self.check_required_features(node, ['NumType', 'NumForm', 'NumValue', 'Gender', 'Number', 'Case'])
+                    if self.pdt20:
+                        self.check_allowed_features(node, {
+                            'NumType': ['Card'],
+                            'NumForm': ['Word'],
+                            'NumValue': ['1,2,3'],
+                            'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # similarly to determiners, genders are merged in some slots of the paradigm
+                            'Number': ['Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                        })
+                    else:
+                        self.check_allowed_features(node, {
+                            'NumType': ['Card'],
+                            'NumForm': ['Word'],
+                            'NumValue': ['1,2,3'],
+                            'Gender': ['Masc', 'Fem', 'Neut'],
+                            'Animacy': ['Anim', 'Inan'],
+                            'Number': ['Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                        })
+                else:
+                    self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'NumType': ['Card'],
+                        'NumForm': ['Word'],
+                        'NumValue': ['1,2,3'],
+                        'Number': ['Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
+        # VERBS AND AUXILIARIES ################################################
+        elif re.match(r'^(VERB|AUX)$', node.upos):
+            self.check_required_features(node, ['Aspect', 'VerbForm'])
+            if node.feats['VerbForm'] == 'Inf':
+                # There is no voice. For some reason, PDT does not annotate that
+                # the infinitive form is active (while a passive infinitive is
+                # a combination of the infinitive with a passive participle).
+                self.check_required_features(node, ['Polarity'])
+                self.check_allowed_features(node, {
+                    'Aspect': ['Imp', 'Perf'],
+                    'VerbForm': ['Inf'],
+                    'Polarity': ['Pos', 'Neg']
+                })
+            elif node.feats['VerbForm'] == 'Fin':
+                # Voice is optional. For some reason it is not annotated with
+                # imperatives (although passive imperatives are a combination
+                # of the active imperative and a passive participle). It is
+                # also not annotated at the conditional auxiliary 'bych', 'bys', 'by', 'bychom', 'byste'.
+                if node.feats['Mood'] == 'Cnd':
+                    self.check_required_features(node, ['Mood', 'Person'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf'],
+                        'VerbForm': ['Fin'],
+                        'Mood': ['Cnd'],
+                        'Person': ['1', '2', '3'],
+                        'Number': ['Sing', 'Dual', 'Plur'] # optional: it is not annotated in the third person
+                    })
+                elif node.feats['Mood'] == 'Imp':
+                    self.check_required_features(node, ['Mood', 'Person', 'Number', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf'],
+                        'VerbForm': ['Fin'],
+                        'Mood': ['Imp'],
+                        'Person': ['1', '2', '3'], # 3rd person imperative occasionally occurs in old Czech (but the form is identical to 2nd person)
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Polarity': ['Pos', 'Neg']
+                    })
+                else: # indicative
+                    self.check_required_features(node, ['Mood', 'Voice', 'Tense', 'Person', 'Number', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf'],
+                        'VerbForm': ['Fin'],
+                        'Mood': ['Ind'],
+                        'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
+                        'Voice': ['Act'],
+                        'Person': ['1', '2', '3'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Variant': ['Short', 'Long'] # distinguishes sigmatic (Long) and asigmatic (Short) aorist
+                    })
+            elif node.feats['VerbForm'] == 'Part': # only l-participle; the others are ADJ, not VERB
+                if node.feats['Gender'] == 'Masc':
+                    self.check_required_features(node, ['Tense', 'Gender', 'Animacy', 'Number', 'Voice', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf'],
+                        'VerbForm': ['Part'],
+                        'Tense': ['Past'],
+                        'Voice': ['Act'], # passive participle is ADJ, so we will not encounter it under VERB
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Gender': ['Masc'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Polarity': ['Pos', 'Neg']
+                    })
+                else:
+                    self.check_required_features(node, ['Tense', 'Gender', 'Number', 'Voice', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf'],
+                        'VerbForm': ['Part'],
+                        'Tense': ['Past'],
+                        'Voice': ['Act'], # passive participle is ADJ, so we will not encounter it under VERB
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Gender': ['Fem', 'Neut'],
+                        'Polarity': ['Pos', 'Neg']
+                    })
+            else: # converb
+                self.check_required_features(node, ['Tense', 'Number', 'Voice', 'Polarity'])
+                self.check_allowed_features(node, {
+                    'Aspect': ['Imp', 'Perf'],
+                    'VerbForm': ['Conv'],
+                    'Tense': ['Past', 'Pres'],
+                    'Voice': ['Act'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Gender': ['Masc', 'Fem', 'Neut'], # annotated only in singular, and no animacy
+                    'Polarity': ['Pos', 'Neg']
+                })
+        # ADVERBS ##############################################################
+        elif node.upos == 'ADV':
+            if node.feats['PronType'] != '':
+                # Pronominal adverbs are neither compared nor negated.
+                self.check_allowed_features(node, {
+                    'PronType': ['Dem', 'Int,Rel', 'Ind', 'Neg', 'Tot']
+                })
+            elif node.feats['Degree'] != '':
+                # Adverbs that are compared can also be negated.
+                self.check_required_features(node, ['Degree', 'Polarity'])
+                self.check_allowed_features(node, {
+                    'Degree': ['Pos', 'Cmp', 'Sup'],
+                    'Polarity': ['Pos', 'Neg']
+                })
+            else:
+                # The remaining adverbs are neither pronominal, nor compared or
+                # negated.
+                self.check_allowed_features(node, {})
+        # ADPOSITIONS ##########################################################
+        elif node.upos == 'ADP':
+            self.check_required_features(node, ['AdpType', 'Case'])
+            self.check_allowed_features(node, {
+                'AdpType': ['Prep', 'Voc'],
+                'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins']
+            })
+        # THE REST: NO FEATURES ################################################
+        else:
+            self.check_allowed_features(node, {})
+
+    def check_adjective_like(self, node, r0, a0):
+        """
+        Long form of adjectives, pronouns and determiners mostly share declension
+        paradigms and thus the sets of features that are expected. Whether the
+        actual feature sets are the same depends on the tagging convention (PDT
+        vs. ČNK): in PDT, adjectives are fully disambiguated while pronouns are
+        not; in ČNK, both adjectives and pronouns (incl. determiners) are fully
+        disambiguated. This method defines the core inflectional features while
+        any extras (such as PronType for pronouns) have to be provided by the
+        caller in parameters r0 (list) and a0 (dict).
+        """
+        required_features = []
+        allowed_featurs = {}
+        full_set = node.upos == 'ADJ' or not self.pdt20
+        if full_set:
+            # Even in the full set, animacy is only distinguished for the
+            # masculine gender.
+            if node.feats['Gender'] == 'Masc':
+                required_features = ['Gender', 'Animacy', 'Number', 'Case']
+                allowed_features = {
+                    'Gender': ['Masc'],
+                    'Animacy': ['Anim', 'Inan'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                }
+            else:
+                required_features = ['Gender', 'Number', 'Case']
+                allowed_features = {
+                    'Gender': ['Fem', 'Neut'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                }
+        else:
+            # Gender is annotated in all cases in singular (ten, ta, to)
+            # but only in nominative, accusative, and vocative in plural
+            # (Nom/Voc ti, ty, ta; Acc ty, ta). Animacy is distinguished
+            # in plural if gender is distinguished and it is masculine; in
+            # singular it is distinguished only in accusative (toho, ten).
+            # Other cases in plural are gender-less (těch, těm, těmi).
+            # Note that this is not consistent with adjectives, where we
+            # disambiguate gender in all cases in plural.
+            if node.feats['Number'] == 'Sing':
+                if node.feats['Gender'] == 'Masc' and node.feats['Case'] == 'Acc':
+                    required_features = ['Gender', 'Animacy', 'Number', 'Case']
+                    allowed_features = {
+                        'Gender': ['Masc'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing'],
+                        'Case': ['Acc']
+                    }
+                else:
+                    required_features = ['Gender', 'Number', 'Case']
+                    allowed_features = {
+                        'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # non-nominative forms of Masc and Neut are merged; Fem,Neut is e.g. 'vaše' in singular
+                        'Number': ['Sing'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    }
+            elif re.match(r'^(Nom|Acc|Voc)$', node.feats['Case']):
+                required_features = ['Gender', 'Number', 'Case']
+                allowed_features = {
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Animacy': ['Anim', 'Inan'],
+                    'Number': ['Dual', 'Plur'],
+                    'Case': ['Nom', 'Acc', 'Voc']
+                }
+            else:
+                required_features = ['Number', 'Case']
+                allowed_features = {
+                    'Number': ['Dual', 'Plur'],
+                    'Case': ['Gen', 'Dat', 'Loc', 'Ins']
+                }
+        required_features = r0 + required_features
+        a0.update(allowed_features)
+        allowed_features = a0
+        self.check_required_features(node, required_features)
+        self.check_allowed_features(node, allowed_features)

From 0f167c2a64adcb98a61740c348e3b7579502005d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 24 Nov 2022 17:47:54 +0100
Subject: [PATCH 0707/1374] Removed Czech-specific rules from Latin block.

For a start, the Latin rules check NOUNs and PROPNs only.
---
 udapi/block/ud/la/markfeatsbugs.py | 598 +----------------------------
 1 file changed, 11 insertions(+), 587 deletions(-)

diff --git a/udapi/block/ud/la/markfeatsbugs.py b/udapi/block/ud/la/markfeatsbugs.py
index 8741eabb..4cf6c1b3 100644
--- a/udapi/block/ud/la/markfeatsbugs.py
+++ b/udapi/block/ud/la/markfeatsbugs.py
@@ -16,593 +16,17 @@ def process_node(self, node):
         # NOUNS ################################################################
         if node.upos == 'NOUN':
             self.check_required_features(node, ['Gender', 'Number', 'Case'])
-            if node.feats['Gender'] == 'Masc':
-                self.check_required_features(node, ['Animacy'])
-                self.check_allowed_features(node, {
-                    'Gender': ['Masc', 'Fem', 'Neut'],
-                    'Animacy': ['Anim', 'Inan'],
-                    'Number': ['Sing', 'Dual', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'Foreign': ['Yes']})
-            else:
-                self.check_allowed_features(node, {
-                    'Gender': ['Masc', 'Fem', 'Neut'],
-                    'Number': ['Sing', 'Dual', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'Foreign': ['Yes']})
+            self.check_allowed_features(node, {
+                'Gender': ['Masc', 'Fem', 'Neut'],
+                'Number': ['Sing', 'Plur'],
+                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
+                'Foreign': ['Yes']})
         # PROPER NOUNS #########################################################
         elif node.upos == 'PROPN':
-            self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity'])
-            if node.feats['Gender'] == 'Masc':
-                self.check_required_features(node, ['Animacy'])
-                self.check_allowed_features(node, {
-                    'Gender': ['Masc', 'Fem', 'Neut'],
-                    'Animacy': ['Anim', 'Inan'],
-                    'Number': ['Sing', 'Dual', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'Polarity': ['Pos', 'Neg'],
-                    'NameType': ['Giv', 'Sur', 'Geo'],
-                    'Foreign': ['Yes']})
-            else:
-                self.check_allowed_features(node, {
-                    'Gender': ['Masc', 'Fem', 'Neut'],
-                    'Number': ['Sing', 'Dual', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'Polarity': ['Pos', 'Neg'],
-                    'NameType': ['Giv', 'Sur', 'Geo'],
-                    'Foreign': ['Yes']})
-        # ADJECTIVES ###########################################################
-        elif node.upos == 'ADJ':
-            if node.feats['Poss'] == 'Yes': # possessive adjectives
-                if node.feats['Gender'] == 'Masc':
-                    self.check_required_features(node, ['Poss', 'Gender[psor]', 'Gender', 'Animacy', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'Poss': ['Yes'],
-                        'Gender[psor]': ['Masc', 'Fem'],
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Animacy': ['Anim', 'Inan'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                        'NameType': ['Giv', 'Sur'], # for possessive adjectives derived from personal names
-                        'Foreign': ['Yes']})
-                else:
-                    self.check_required_features(node, ['Poss', 'Gender[psor]', 'Gender', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'Poss': ['Yes'],
-                        'Gender[psor]': ['Masc', 'Fem'],
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                        'NameType': ['Giv', 'Sur'], # for possessive adjectives derived from personal names
-                        'Foreign': ['Yes']})
-            elif node.feats['NumType'] == 'Ord': # ordinal numerals are a subtype of adjectives
-                if node.feats['Gender'] == 'Masc':
-                    self.check_required_features(node, ['NumType', 'Gender', 'Animacy', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'NumType': ['Ord'],
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Animacy': ['Anim', 'Inan'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                        'Foreign': ['Yes']})
-                else:
-                    self.check_required_features(node, ['NumType', 'Gender', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'NumType': ['Ord'],
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                        'Foreign': ['Yes']})
-            elif node.feats['VerbForm'] == 'Part': # participles (except l-participles) are a subtype of adjectives
-                self.check_required_features(node, ['VerbForm', 'Voice'])
-                if node.feats['Voice'] == 'Act': # active participles have tense, passives don't
-                    if node.feats['Gender'] == 'Masc':
-                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Tense', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity'])
-                        self.check_allowed_features(node, {
-                            'VerbForm': ['Part'],
-                            'Aspect': ['Imp', 'Perf'],
-                            'Voice': ['Act'],
-                            'Tense': ['Past', 'Pres', 'Fut'], # Fut only for lemma 'boudoucí'
-                            'Gender': ['Masc', 'Fem', 'Neut'],
-                            'Animacy': ['Anim', 'Inan'],
-                            'Number': ['Sing', 'Dual', 'Plur'],
-                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                            'Polarity': ['Pos', 'Neg'],
-                            'Variant': ['Short'],
-                            'Foreign': ['Yes']})
-                    else:
-                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Tense', 'Gender', 'Number', 'Case', 'Polarity'])
-                        self.check_allowed_features(node, {
-                            'VerbForm': ['Part'],
-                            'Aspect': ['Imp', 'Perf'],
-                            'Voice': ['Act'],
-                            'Tense': ['Past', 'Pres', 'Fut'], # Fut only for lemma 'boudoucí'
-                            'Gender': ['Masc', 'Fem', 'Neut'],
-                            'Number': ['Sing', 'Dual', 'Plur'],
-                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                            'Polarity': ['Pos', 'Neg'],
-                            'Variant': ['Short'],
-                            'Foreign': ['Yes']})
-                else:
-                    if node.feats['Gender'] == 'Masc':
-                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity'])
-                        self.check_allowed_features(node, {
-                            'VerbForm': ['Part'],
-                            'Aspect': ['Imp', 'Perf'],
-                            'Voice': ['Pass'],
-                            'Gender': ['Masc', 'Fem', 'Neut'],
-                            'Animacy': ['Anim', 'Inan'],
-                            'Number': ['Sing', 'Dual', 'Plur'],
-                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                            'Polarity': ['Pos', 'Neg'],
-                            'Variant': ['Short'],
-                            'Foreign': ['Yes']})
-                    else:
-                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Number', 'Case', 'Polarity'])
-                        self.check_allowed_features(node, {
-                            'VerbForm': ['Part'],
-                            'Aspect': ['Imp', 'Perf'],
-                            'Voice': ['Pass'],
-                            'Gender': ['Masc', 'Fem', 'Neut'],
-                            'Number': ['Sing', 'Dual', 'Plur'],
-                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                            'Polarity': ['Pos', 'Neg'],
-                            'Variant': ['Short'],
-                            'Foreign': ['Yes']})
-            elif node.feats['Variant'] == 'Short': # short (nominal) forms of adjectives have no degree
-                if node.feats['Gender'] == 'Masc':
-                    self.check_required_features(node, ['Gender', 'Animacy', 'Number', 'Case', 'Polarity', 'Variant'])
-                    self.check_allowed_features(node, {
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Animacy': ['Anim', 'Inan'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                        'Polarity': ['Pos', 'Neg'],
-                        'Variant': ['Short'],
-                        'Foreign': ['Yes']})
-                else:
-                    self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity', 'Variant'])
-                    self.check_allowed_features(node, {
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                        'Polarity': ['Pos', 'Neg'],
-                        'Variant': ['Short'],
-                        'Foreign': ['Yes']})
-            else: # regular adjectives
-                if node.feats['Gender'] == 'Masc':
-                    self.check_required_features(node, ['Gender', 'Animacy', 'Number', 'Case', 'Degree', 'Polarity'])
-                    self.check_allowed_features(node, {
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Animacy': ['Anim', 'Inan'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                        'Degree': ['Pos', 'Cmp', 'Sup'],
-                        'Polarity': ['Pos', 'Neg'],
-                        'Foreign': ['Yes']})
-                else:
-                    self.check_required_features(node, ['Gender', 'Number', 'Case', 'Degree', 'Polarity'])
-                    self.check_allowed_features(node, {
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                        'Degree': ['Pos', 'Cmp', 'Sup'],
-                        'Polarity': ['Pos', 'Neg'],
-                        'Foreign': ['Yes']})
-        # PRONOUNS #############################################################
-        elif node.upos == 'PRON':
-            self.check_required_features(node, ['PronType'])
-            if node.feats['PronType'] == 'Prs':
-                if node.feats['Reflex'] == 'Yes':
-                    self.check_required_features(node, ['PronType', 'Reflex', 'Case'])
-                    self.check_allowed_features(node, {
-                        'PronType': ['Prs'],
-                        'Reflex': ['Yes'],
-                        'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins'],
-                        'Variant': ['Short']
-                    })
-                else: # not reflexive
-                    if node.feats['Person'] == '3': # on, ona, ono, oni, ony
-                        if re.match(r'^(Nom|Voc)$', node.feats['Case']): # on, ona, ono, oni, ony
-                            self.check_adjective_like(node, ['PronType', 'Person'], {
-                                'PronType': ['Prs'],
-                                'Person': ['3']
-                            })
-                        else: # jeho, něho, jemu, němu, jej, něj, něm, jím, ním, jí, ní, ji, ni, je, ně
-                            # Mostly only two gender groups and no animacy:
-                            # Masc,Neut ... jeho, jemu, jej, něm, jím
-                            # Fem ... jí, ji, ní
-                            # Neut ... je
-                            # No gender in dual and plural:
-                            # Plur ... jich, jim, je, nich, jimi
-                            self.check_adjective_like(node, ['PronType', 'Person', 'PrepCase'], {
-                                'PronType': ['Prs'],
-                                'Person': ['3'],
-                                'PrepCase': ['Npr', 'Pre']
-                            })
-                    else: # 1st and 2nd person do not have gender: já, ty
-                        self.check_required_features(node, ['PronType', 'Person', 'Number', 'Case'])
-                        self.check_allowed_features(node, {
-                            'PronType': ['Prs'],
-                            'Person': ['1', '2'],
-                            'Number': ['Sing', 'Dual', 'Plur'],
-                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                            'Variant': ['Short']
-                        })
-            elif re.search(r'k[dt]o', node.lemma): # kdo (kto), kdož, někdo, nikdo
-                # There is no Number. Někdo and nikdo behave like singular;
-                # kdo is by default singular as well but it also occurs as a subject
-                # of plural verbs.
-                self.check_required_features(node, ['PronType', 'Gender', 'Animacy', 'Case'])
-                self.check_allowed_features(node, {
-                    'PronType': ['Int,Rel', 'Rel', 'Ind', 'Neg'],
-                    'Gender': ['Masc'],
-                    'Animacy': ['Anim'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Loc', 'Ins']
-                })
-            elif re.match(r'^(co|což|něco|nicož)$', node.lemma):
-                # Although these pronouns behave by default as neuter singular,
-                # no Gender and Number is annotated. However, quite unusually,
-                # there is Animacy=Inan without Gender.
-                ###!!! This should probably be fixed in all Czech treebanks and
-                ###!!! in Interset. The pronoun should get Gender=Neut and no
-                ###!!! animacy. For now, let's at least make animacy an optional
-                ###!!! feature (I see that we already do not fill it in the Old
-                ###!!! Czech data).
-                self.check_required_features(node, ['PronType', 'Case'])
-                self.check_allowed_features(node, {
-                    'PronType': ['Int,Rel', 'Rel', 'Ind', 'Neg'],
-                    'Animacy': ['Inan'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Loc', 'Ins']
-                })
-            elif node.lemma == 'ješto':
-                # Unlike 'jenžto', this relative pronoun does not inflect, it
-                # always occurs in a nominative position, but the context can
-                # be any gender and number.
-                self.check_required_features(node, ['PronType', 'Case'])
-                self.check_allowed_features(node, {
-                    'PronType': ['Rel'],
-                    'Case': ['Nom']
-                })
-            elif re.match(r'^(jenž|jenžto)$', node.lemma):
-                # The relative pronouns 'jenž', 'jenžto' inflect for gender;
-                # while we normally take this as a sign of DET (instead of PRON),
-                # these can never act as real DET because they never modify a
-                # nominal.
-                # Similarly to the personal pronoun 'on', animacy is only
-                # annotated for masculine nominative plural, non-nominative
-                # forms are merged for masculine and neuter (jehož, jemuž), and
-                # non-singular gender is only annotated in nominative (while
-                # these cases are common for all genders: jichž, jimž, jimiž).
-                # Unlike 'on', 'jenž' has the feature PrepCase everywhere, even
-                # in the nominative, although there is no prepositional counter-
-                # part (but similarly the locative has no prepositionless form).
-                self.check_adjective_like(node, ['PronType', 'PrepCase'], {
-                    'PronType': ['Rel'],
-                    'PrepCase': ['Npr', 'Pre']
-                })
-            else:
-                # What remains is the relative pronoun 'an'. It behaves similarly
-                # to 'jenž' but it does not have the PrepCase feature and it
-                # only occurs in the nominative.
-                if node.feats['Gender'] == 'Masc' and node.feats['Number'] == 'Plur': # ani
-                    self.check_required_features(node, ['PronType', 'Gender', 'Animacy', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'PronType': ['Rel'],
-                        'Gender': ['Masc'],
-                        'Animacy': ['Anim', 'Inan'],
-                        'Number': ['Plur'],
-                        'Case': ['Nom']
-                    })
-                else: # not Masc Plur: an, ana, ano, any
-                    self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'PronType': ['Rel'],
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Case': ['Nom']
-                    })
-        # DETERMINERS ##########################################################
-        elif node.upos == 'DET':
-            # Possessive determiners 'jeho' and 'jejich' (formerly 'jich') do not inflect, i.e., no Gender, Number, Case.
-            # Note that the possessive determiner 'její' (formerly 'jejie') does inflect, although it also has the lemma 'jeho'.
-            if re.match(r'^(jeho|jejich|jich)(ž(to)?)?$', node.form.lower()):
-                self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]'])
-                self.check_allowed_features(node, {
-                    'PronType': ['Prs', 'Rel'],
-                    'Poss': ['Yes'],
-                    'Person': ['3'],
-                    'Number[psor]': ['Sing', 'Dual', 'Plur'],
-                    'Gender[psor]': ['Masc,Neut']
-                })
-            elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)(ž(to)?)?$', node.form.lower()):
-                # The feminine possessive 'její' slightly inflects, unlike 'jeho' and 'jejich'.
-                # Congruent gender is annotated only in singular. Masculine and
-                # neuter are merged even in nominative. Feminine singular does
-                # not distinguish case in PDT but we need it in Old Czech at
-                # least for 'jejiej'.
-                if node.feats['Number'] == 'Sing':
-                    self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]', 'Gender', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'PronType': ['Prs', 'Rel'],
-                        'Poss': ['Yes'],
-                        'Person': ['3'],
-                        'Number[psor]': ['Sing'],
-                        'Gender[psor]': ['Fem'],
-                        'Gender': ['Masc,Neut', 'Fem'],
-                        'Number': ['Sing'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                    })
-                else:
-                    self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'PronType': ['Prs', 'Rel'],
-                        'Poss': ['Yes'],
-                        'Person': ['3'],
-                        'Number[psor]': ['Sing'],
-                        'Gender[psor]': ['Fem'],
-                        'Number': ['Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                    })
-            elif node.feats['Poss'] == 'Yes': # 'můj', 'tvůj', 'svůj'
-                if node.feats['Reflex'] == 'Yes':
-                    self.check_adjective_like(node, ['PronType', 'Poss', 'Reflex'], {
-                        'PronType': ['Prs'],
-                        'Poss': ['Yes'],
-                        'Reflex': ['Yes']
-                    })
-                else:
-                    self.check_adjective_like(node, ['PronType', 'Poss', 'Person', 'Number[psor]'], {
-                        'PronType': ['Prs'],
-                        'Poss': ['Yes'],
-                        'Person': ['1', '2'],
-                        'Number[psor]': ['Sing', 'Plur']
-                    })
-            else:
-                self.check_adjective_like(node, ['PronType'], {'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp']})
-        # NUMERALS #############################################################
-        elif node.upos == 'NUM':
-            self.check_required_features(node, ['NumType', 'NumForm'])
-            # Arabic digits and Roman numerals do not have inflection features.
-            if re.match(r'^(Digit|Roman)$', node.feats['NumForm']):
-                self.check_allowed_features(node, {
-                    'NumType': ['Card'],
-                    'NumForm': ['Digit', 'Roman']
-                })
-            else:
-                ###!!! Somehow the NumValue feature from PDT via Interset is useless.
-                # 'jeden' has Gender, Animacy, Number, Case: jeden, jedna, jedno, jednoho, jednomu, jednom, jedním, jedné, jednu, jednou, jedni, jedny, jedněch, jedněm, jedněmi.
-                # 'dva', 'oba' have Gender, Number=Dual(Plur in modern Czech), Case: dva, dvě, dvou, dvěma.
-                # 'tři', 'čtyři' have Number=Plur, Case: tři, třech, třem, třemi.
-                # 'pět' and more have Number=Plur, Case: pět, pěti.
-                if node.lemma == 'jeden':
-                    self.check_required_features(node, ['NumType', 'NumForm', 'NumValue', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'NumType': ['Card'],
-                        'NumForm': ['Word'],
-                        'NumValue': ['1,2,3'],
-                        'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # similarly to determiners, genders are merged in some slots of the paradigm
-                        'Animacy': ['Anim', 'Inan'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                    })
-                elif re.match(r'^(dva|oba)$', node.lemma):
-                    self.check_required_features(node, ['NumType', 'NumForm', 'NumValue', 'Gender', 'Number', 'Case'])
-                    if self.pdt20:
-                        self.check_allowed_features(node, {
-                            'NumType': ['Card'],
-                            'NumForm': ['Word'],
-                            'NumValue': ['1,2,3'],
-                            'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # similarly to determiners, genders are merged in some slots of the paradigm
-                            'Number': ['Dual', 'Plur'],
-                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                        })
-                    else:
-                        self.check_allowed_features(node, {
-                            'NumType': ['Card'],
-                            'NumForm': ['Word'],
-                            'NumValue': ['1,2,3'],
-                            'Gender': ['Masc', 'Fem', 'Neut'],
-                            'Animacy': ['Anim', 'Inan'],
-                            'Number': ['Dual', 'Plur'],
-                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                        })
-                else:
-                    self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'NumType': ['Card'],
-                        'NumForm': ['Word'],
-                        'NumValue': ['1,2,3'],
-                        'Number': ['Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                    })
-        # VERBS AND AUXILIARIES ################################################
-        elif re.match(r'^(VERB|AUX)$', node.upos):
-            self.check_required_features(node, ['Aspect', 'VerbForm'])
-            if node.feats['VerbForm'] == 'Inf':
-                # There is no voice. For some reason, PDT does not annotate that
-                # the infinitive form is active (while a passive infinitive is
-                # a combination of the infinitive with a passive participle).
-                self.check_required_features(node, ['Polarity'])
-                self.check_allowed_features(node, {
-                    'Aspect': ['Imp', 'Perf'],
-                    'VerbForm': ['Inf'],
-                    'Polarity': ['Pos', 'Neg']
-                })
-            elif node.feats['VerbForm'] == 'Fin':
-                # Voice is optional. For some reason it is not annotated with
-                # imperatives (although passive imperatives are a combination
-                # of the active imperative and a passive participle). It is
-                # also not annotated at the conditional auxiliary 'bych', 'bys', 'by', 'bychom', 'byste'.
-                if node.feats['Mood'] == 'Cnd':
-                    self.check_required_features(node, ['Mood', 'Person'])
-                    self.check_allowed_features(node, {
-                        'Aspect': ['Imp', 'Perf'],
-                        'VerbForm': ['Fin'],
-                        'Mood': ['Cnd'],
-                        'Person': ['1', '2', '3'],
-                        'Number': ['Sing', 'Dual', 'Plur'] # optional: it is not annotated in the third person
-                    })
-                elif node.feats['Mood'] == 'Imp':
-                    self.check_required_features(node, ['Mood', 'Person', 'Number', 'Polarity'])
-                    self.check_allowed_features(node, {
-                        'Aspect': ['Imp', 'Perf'],
-                        'VerbForm': ['Fin'],
-                        'Mood': ['Imp'],
-                        'Person': ['1', '2', '3'], # 3rd person imperative occasionally occurs in old Czech (but the form is identical to 2nd person)
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Polarity': ['Pos', 'Neg']
-                    })
-                else: # indicative
-                    self.check_required_features(node, ['Mood', 'Voice', 'Tense', 'Person', 'Number', 'Polarity'])
-                    self.check_allowed_features(node, {
-                        'Aspect': ['Imp', 'Perf'],
-                        'VerbForm': ['Fin'],
-                        'Mood': ['Ind'],
-                        'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
-                        'Voice': ['Act'],
-                        'Person': ['1', '2', '3'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Polarity': ['Pos', 'Neg'],
-                        'Variant': ['Short', 'Long'] # distinguishes sigmatic (Long) and asigmatic (Short) aorist
-                    })
-            elif node.feats['VerbForm'] == 'Part': # only l-participle; the others are ADJ, not VERB
-                if node.feats['Gender'] == 'Masc':
-                    self.check_required_features(node, ['Tense', 'Gender', 'Animacy', 'Number', 'Voice', 'Polarity'])
-                    self.check_allowed_features(node, {
-                        'Aspect': ['Imp', 'Perf'],
-                        'VerbForm': ['Part'],
-                        'Tense': ['Past'],
-                        'Voice': ['Act'], # passive participle is ADJ, so we will not encounter it under VERB
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Gender': ['Masc'],
-                        'Animacy': ['Anim', 'Inan'],
-                        'Polarity': ['Pos', 'Neg']
-                    })
-                else:
-                    self.check_required_features(node, ['Tense', 'Gender', 'Number', 'Voice', 'Polarity'])
-                    self.check_allowed_features(node, {
-                        'Aspect': ['Imp', 'Perf'],
-                        'VerbForm': ['Part'],
-                        'Tense': ['Past'],
-                        'Voice': ['Act'], # passive participle is ADJ, so we will not encounter it under VERB
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Gender': ['Fem', 'Neut'],
-                        'Polarity': ['Pos', 'Neg']
-                    })
-            else: # converb
-                self.check_required_features(node, ['Tense', 'Number', 'Voice', 'Polarity'])
-                self.check_allowed_features(node, {
-                    'Aspect': ['Imp', 'Perf'],
-                    'VerbForm': ['Conv'],
-                    'Tense': ['Past', 'Pres'],
-                    'Voice': ['Act'],
-                    'Number': ['Sing', 'Dual', 'Plur'],
-                    'Gender': ['Masc', 'Fem', 'Neut'], # annotated only in singular, and no animacy
-                    'Polarity': ['Pos', 'Neg']
-                })
-        # ADVERBS ##############################################################
-        elif node.upos == 'ADV':
-            if node.feats['PronType'] != '':
-                # Pronominal adverbs are neither compared nor negated.
-                self.check_allowed_features(node, {
-                    'PronType': ['Dem', 'Int,Rel', 'Ind', 'Neg', 'Tot']
-                })
-            elif node.feats['Degree'] != '':
-                # Adverbs that are compared can also be negated.
-                self.check_required_features(node, ['Degree', 'Polarity'])
-                self.check_allowed_features(node, {
-                    'Degree': ['Pos', 'Cmp', 'Sup'],
-                    'Polarity': ['Pos', 'Neg']
-                })
-            else:
-                # The remaining adverbs are neither pronominal, nor compared or
-                # negated.
-                self.check_allowed_features(node, {})
-        # ADPOSITIONS ##########################################################
-        elif node.upos == 'ADP':
-            self.check_required_features(node, ['AdpType', 'Case'])
+            self.check_required_features(node, ['Gender', 'Number', 'Case'])
             self.check_allowed_features(node, {
-                'AdpType': ['Prep', 'Voc'],
-                'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins']
-            })
-        # THE REST: NO FEATURES ################################################
-        else:
-            self.check_allowed_features(node, {})
-
-    def check_adjective_like(self, node, r0, a0):
-        """
-        Long form of adjectives, pronouns and determiners mostly share declension
-        paradigms and thus the sets of features that are expected. Whether the
-        actual feature sets are the same depends on the tagging convention (PDT
-        vs. ČNK): in PDT, adjectives are fully disambiguated while pronouns are
-        not; in ČNK, both adjectives and pronouns (incl. determiners) are fully
-        disambiguated. This method defines the core inflectional features while
-        any extras (such as PronType for pronouns) have to be provided by the
-        caller in parameters r0 (list) and a0 (dict).
-        """
-        required_features = []
-        allowed_featurs = {}
-        full_set = node.upos == 'ADJ' or not self.pdt20
-        if full_set:
-            # Even in the full set, animacy is only distinguished for the
-            # masculine gender.
-            if node.feats['Gender'] == 'Masc':
-                required_features = ['Gender', 'Animacy', 'Number', 'Case']
-                allowed_features = {
-                    'Gender': ['Masc'],
-                    'Animacy': ['Anim', 'Inan'],
-                    'Number': ['Sing', 'Dual', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                }
-            else:
-                required_features = ['Gender', 'Number', 'Case']
-                allowed_features = {
-                    'Gender': ['Fem', 'Neut'],
-                    'Number': ['Sing', 'Dual', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                }
-        else:
-            # Gender is annotated in all cases in singular (ten, ta, to)
-            # but only in nominative, accusative, and vocative in plural
-            # (Nom/Voc ti, ty, ta; Acc ty, ta). Animacy is distinguished
-            # in plural if gender is distinguished and it is masculine; in
-            # singular it is distinguished only in accusative (toho, ten).
-            # Other cases in plural are gender-less (těch, těm, těmi).
-            # Note that this is not consistent with adjectives, where we
-            # disambiguate gender in all cases in plural.
-            if node.feats['Number'] == 'Sing':
-                if node.feats['Gender'] == 'Masc' and node.feats['Case'] == 'Acc':
-                    required_features = ['Gender', 'Animacy', 'Number', 'Case']
-                    allowed_features = {
-                        'Gender': ['Masc'],
-                        'Animacy': ['Anim', 'Inan'],
-                        'Number': ['Sing'],
-                        'Case': ['Acc']
-                    }
-                else:
-                    required_features = ['Gender', 'Number', 'Case']
-                    allowed_features = {
-                        'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # non-nominative forms of Masc and Neut are merged; Fem,Neut is e.g. 'vaše' in singular
-                        'Number': ['Sing'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                    }
-            elif re.match(r'^(Nom|Acc|Voc)$', node.feats['Case']):
-                required_features = ['Gender', 'Number', 'Case']
-                allowed_features = {
-                    'Gender': ['Masc', 'Fem', 'Neut'],
-                    'Animacy': ['Anim', 'Inan'],
-                    'Number': ['Dual', 'Plur'],
-                    'Case': ['Nom', 'Acc', 'Voc']
-                }
-            else:
-                required_features = ['Number', 'Case']
-                allowed_features = {
-                    'Number': ['Dual', 'Plur'],
-                    'Case': ['Gen', 'Dat', 'Loc', 'Ins']
-                }
-        required_features = r0 + required_features
-        a0.update(allowed_features)
-        allowed_features = a0
-        self.check_required_features(node, required_features)
-        self.check_allowed_features(node, allowed_features)
+                'Gender': ['Masc', 'Fem', 'Neut'],
+                'Number': ['Sing', 'Plur'],
+                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
+                'NameType': ['Giv', 'Sur', 'Geo'],
+                'Foreign': ['Yes']})

From 606515a088cc9779b3fef46795a0c4a6bb1f6613 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 24 Nov 2022 17:51:05 +0100
Subject: [PATCH 0708/1374] Usage layout=compact.

---
 udapi/block/ud/cs/markfeatsbugs.py | 2 +-
 udapi/block/ud/la/markfeatsbugs.py | 2 +-
 udapi/block/ud/markfeatsbugs.py    | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index ef203033..309e7ac8 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -3,7 +3,7 @@
 finds will be saved in the MISC column as a Bug attribute, which can be later
 used in filters and highlighted in text output.
 
-Usage: cat *.conllu | udapy -HAM ud.cs.MarkFeatsBugs > bugs.html
+Usage: cat *.conllu | udapy -HAMX layout=compact ud.cs.MarkFeatsBugs > bugs.html
 Windows: python udapy read.Conllu files="a.conllu,b.conllu" ud.cs.MarkFeatsBugs write.TextModeTreesHtml files="bugs.html" marked_only=1 layout=compact attributes=form,lemma,upos,xpos,feats,deprel,misc
 """
 import udapi.block.ud.markfeatsbugs
diff --git a/udapi/block/ud/la/markfeatsbugs.py b/udapi/block/ud/la/markfeatsbugs.py
index 4cf6c1b3..8aea567f 100644
--- a/udapi/block/ud/la/markfeatsbugs.py
+++ b/udapi/block/ud/la/markfeatsbugs.py
@@ -3,7 +3,7 @@
 finds will be saved in the MISC column as a Bug attribute, which can be later
 used in filters and highlighted in text output.
 
-Usage: cat *.conllu | udapy -HAM ud.la.MarkFeatsBugs > bugs.html
+Usage: cat *.conllu | udapy -HAMX layout=compact ud.la.MarkFeatsBugs > bugs.html
 Windows: python udapy read.Conllu files="a.conllu,b.conllu" ud.la.MarkFeatsBugs write.TextModeTreesHtml files="bugs.html" marked_only=1 layout=compact attributes=form,lemma,upos,xpos,feats,deprel,misc
 """
 import udapi.block.ud.markfeatsbugs
diff --git a/udapi/block/ud/markfeatsbugs.py b/udapi/block/ud/markfeatsbugs.py
index b24dcecb..1bb8188b 100644
--- a/udapi/block/ud/markfeatsbugs.py
+++ b/udapi/block/ud/markfeatsbugs.py
@@ -5,7 +5,7 @@
 implements service methods. A language-specific block must be derived from this
 one and define the actual rules valid in that language.
 
-Usage (Czech example): cat *.conllu | udapy -HAM ud.cs.MarkFeatsBugs > bugs.html
+Usage (Czech example): cat *.conllu | udapy -HAMX layout=compact ud.cs.MarkFeatsBugs > bugs.html
 """
 from udapi.core.block import Block
 import logging

From 204da3bbb4bfa59c085c4c05a6bc8be2e134e27d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 24 Nov 2022 21:05:39 +0100
Subject: [PATCH 0709/1374] More rules for Latin features (cloned from Czech).

---
 udapi/block/ud/la/markfeatsbugs.py | 148 +++++++++++++++++++++++++++++
 1 file changed, 148 insertions(+)

diff --git a/udapi/block/ud/la/markfeatsbugs.py b/udapi/block/ud/la/markfeatsbugs.py
index 8aea567f..96c7b682 100644
--- a/udapi/block/ud/la/markfeatsbugs.py
+++ b/udapi/block/ud/la/markfeatsbugs.py
@@ -30,3 +30,151 @@ def process_node(self, node):
                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
                 'NameType': ['Giv', 'Sur', 'Geo'],
                 'Foreign': ['Yes']})
+        # ADJECTIVES ###########################################################
+        elif node.upos == 'ADJ':
+            self.check_required_features(node, ['Gender', 'Number', 'Case', 'Degree'])
+            self.check_allowed_features(node, {
+                'Gender': ['Masc', 'Fem', 'Neut'],
+                'Number': ['Sing', 'Plur'],
+                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
+                'Degree': ['Pos', 'Cmp', 'Sup'],
+                'Foreign': ['Yes']})
+        # PRONOUNS #############################################################
+        elif node.upos == 'PRON':
+            self.check_required_features(node, ['PronType'])
+            if node.feats['PronType'] == 'Prs':
+                if node.feats['Reflex'] == 'Yes':
+                    self.check_required_features(node, ['PronType', 'Reflex', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Prs'],
+                        'Reflex': ['Yes'],
+                        'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Abl']
+                    })
+                else: # not reflexive
+                    if node.feats['Person'] == '3': # on, ona, ono, oni, ony
+                        self.check_required_features(node, ['PronType', 'Person', 'Gender', 'Number', 'Case'])
+                        self.check_allowed_features(node, {
+                            'PronType': ['Prs'],
+                            'Person': ['3'],
+                            'Gender': ['Masc', 'Fem', 'Neut'],
+                            'Number': ['Sing', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
+                        })
+                    else: # 1st and 2nd person do not have gender: já, ty
+                        self.check_required_features(node, ['PronType', 'Person', 'Number', 'Case'])
+                        self.check_allowed_features(node, {
+                            'PronType': ['Prs'],
+                            'Person': ['1', '2'],
+                            'Number': ['Sing', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
+                        })
+        # DETERMINERS ##########################################################
+        elif node.upos == 'DET':
+            if node.feats['Poss'] == 'Yes': # 'můj', 'tvůj', 'svůj'
+                self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Gender', 'Number', 'Case'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Prs'],
+                    'Poss': ['Yes'],
+                    'Person': ['1', '2', '3'],
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Number': ['Sing', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
+                })
+            else:
+                self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Number': ['Sing', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
+                })
+        # NUMERALS #############################################################
+        elif node.upos == 'NUM':
+            self.check_required_features(node, ['NumType', 'NumForm'])
+            # Arabic digits and Roman numerals do not have inflection features.
+            if re.match(r'^(Digit|Roman)$', node.feats['NumForm']):
+                self.check_allowed_features(node, {
+                    'NumType': ['Card'],
+                    'NumForm': ['Digit', 'Roman']
+                })
+            else:
+                self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
+                self.check_allowed_features(node, {
+                    'NumType': ['Card'],
+                    'NumForm': ['Word'],
+                    'Number': ['Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
+                })
+        # VERBS AND AUXILIARIES ################################################
+        elif re.match(r'^(VERB|AUX)$', node.upos):
+            self.check_required_features(node, ['Aspect', 'VerbForm'])
+            if node.feats['VerbForm'] == 'Inf':
+                self.check_allowed_features(node, {
+                    'Aspect': ['Imp', 'Perf', 'Prosp'],
+                    'VerbForm': ['Inf'],
+                    'Polarity': ['Pos', 'Neg']
+                })
+            elif node.feats['VerbForm'] == 'Fin':
+                if node.feats['Mood'] == 'Imp':
+                    self.check_required_features(node, ['Mood', 'Person', 'Number'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf', 'Prosp'],
+                        'VerbForm': ['Fin'],
+                        'Mood': ['Imp'],
+                        'Person': ['1', '2', '3'],
+                        'Number': ['Sing', 'Plur'],
+                        'Polarity': ['Pos', 'Neg']
+                    })
+                else: # indicative or subjunctive
+                    self.check_required_features(node, ['Mood', 'Voice', 'Tense', 'Person', 'Number'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf', 'Prosp'],
+                        'VerbForm': ['Fin'],
+                        'Mood': ['Ind', 'Sub'],
+                        'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
+                        'Voice': ['Act'],
+                        'Person': ['1', '2', '3'],
+                        'Number': ['Sing', 'Plur'],
+                        'Polarity': ['Pos', 'Neg']
+                    })
+            elif node.feats['VerbForm'] == 'Part':
+                self.check_required_features(node, ['Tense', 'Gender', 'Number', 'Voice'])
+                self.check_allowed_features(node, {
+                    'Aspect': ['Imp', 'Perf', 'Prosp'],
+                    'VerbForm': ['Part'],
+                    'Tense': ['Past'],
+                    'Voice': ['Act'], # passive participle is ADJ, so we will not encounter it under VERB
+                    'Number': ['Sing', 'Plur'],
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Polarity': ['Pos', 'Neg']
+                })
+            else: # verbal noun
+                self.check_required_features(node, ['Tense', 'Number', 'Voice'])
+                self.check_allowed_features(node, {
+                    'Aspect': ['Imp', 'Perf', 'Prosp'],
+                    'VerbForm': ['Vnoun'],
+                    'Tense': ['Past', 'Pres'],
+                    'Voice': ['Act'],
+                    'Number': ['Sing', 'Plur'],
+                    'Gender': ['Masc', 'Fem', 'Neut'], # annotated only in singular
+                    'Polarity': ['Pos', 'Neg']
+                })
+        # ADVERBS ##############################################################
+        elif node.upos == 'ADV':
+            if node.feats['PronType'] != '':
+                # Pronominal adverbs are neither compared nor negated.
+                self.check_allowed_features(node, {
+                    'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot']
+                })
+            else:
+                # The remaining adverbs are neither pronominal, nor compared or
+                # negated.
+                self.check_allowed_features(node, {})
+        # PARTICLES ############################################################
+        elif node.upos == 'PART':
+            self.check_allowed_features(node, {
+                'Polarity': ['Neg']
+            })
+        # THE REST: NO FEATURES ################################################
+        else:
+            self.check_allowed_features(node, {})

From 98db11584577be72a5748c8c81cb4030348270c0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 24 Nov 2022 22:32:50 +0100
Subject: [PATCH 0710/1374] Added feature rules for Malayalam.

---
 udapi/block/ud/ml/markfeatsbugs.py | 191 +++++++++++++++++++++++++++++
 1 file changed, 191 insertions(+)
 create mode 100644 udapi/block/ud/ml/markfeatsbugs.py

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
new file mode 100644
index 00000000..a46580d1
--- /dev/null
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -0,0 +1,191 @@
+"""
+Block to identify missing or ill-valued features in Malayalam. Any bugs that it
+finds will be saved in the MISC column as a Bug attribute, which can be later
+used in filters and highlighted in text output.
+
+Usage: cat *.conllu | udapy -HAMX layout=compact ud.ml.MarkFeatsBugs > bugs.html
+Windows: python udapy read.Conllu files="a.conllu,b.conllu" ud.ml.MarkFeatsBugs write.TextModeTreesHtml files="bugs.html" marked_only=1 layout=compact attributes=form,lemma,upos,xpos,feats,deprel,misc
+"""
+import udapi.block.ud.markfeatsbugs
+import logging
+import re
+
+class MarkFeatsBugs(udapi.block.ud.markfeatsbugs.MarkFeatsBugs):
+
+    def process_node(self, node):
+        # NOUNS AND PROPER NOUNS ###############################################
+        if re.match(r'^(NOUN|PROPN)$', node.upos):
+            self.check_required_features(node, ['Animacy', 'Number', 'Case'])
+            self.check_allowed_features(node, {
+                'Animacy': ['Anim', 'Inan'],
+                'Number': ['Sing', 'Plur'],
+                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp'],
+                'Foreign': ['Yes']})
+        # ADJECTIVES ###########################################################
+        elif node.upos == 'ADJ':
+            self.check_allowed_features(node, {
+                'Foreign': ['Yes']})
+        # PRONOUNS #############################################################
+        elif node.upos == 'PRON':
+            self.check_required_features(node, ['PronType'])
+            if node.feats['PronType'] == 'Prs':
+                if node.feats['Reflex'] == 'Yes':
+                    self.check_required_features(node, ['PronType', 'Reflex', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Prs'],
+                        'Reflex': ['Yes'],
+                        'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Abl', 'Ins', 'Cmp']
+                    })
+                else: # not reflexive
+                    if node.feats['Person'] == '3': # അവൻ avan, അവൾ avaḷ, അത് at, അവർ avaṟ
+                        if node.feats['Number'] == 'Sing':
+                            self.check_required_features(node, ['PronType', 'Person', 'Deixis', 'Gender', 'Number', 'Case'])
+                            self.check_allowed_features(node, {
+                                'PronType': ['Prs'],
+                                'Person': ['3'],
+                                'Deixis': ['Prox', 'Remt'],
+                                'Gender': ['Masc', 'Fem', 'Neut'],
+                                'Number': ['Sing'],
+                                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
+                            })
+                        else: # plural pronouns do not distinguish gender
+                            self.check_required_features(node, ['PronType', 'Person', 'Deixis', 'Number', 'Case'])
+                            self.check_allowed_features(node, {
+                                'PronType': ['Prs'],
+                                'Person': ['3'],
+                                'Deixis': ['Prox', 'Remt'],
+                                'Number': ['Plur'],
+                                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
+                            })
+                    else: # 1st and 2nd person do not have gender: ഞാൻ ñān, നീ nī
+                        self.check_required_features(node, ['PronType', 'Person', 'Number', 'Case'])
+                        self.check_allowed_features(node, {
+                            'PronType': ['Prs'],
+                            'Person': ['1', '2'],
+                            'Number': ['Sing', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
+                        })
+        # DETERMINERS ##########################################################
+        elif node.upos == 'DET':
+            if node.feats['Poss'] == 'Yes': # 'můj', 'tvůj', 'svůj'
+                self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Gender', 'Number', 'Case'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Prs'],
+                    'Poss': ['Yes'],
+                    'Person': ['1', '2', '3'],
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Number': ['Sing', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
+                })
+            else:
+                self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Number': ['Sing', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
+                })
+        # NUMERALS #############################################################
+        elif node.upos == 'NUM':
+            self.check_required_features(node, ['NumType', 'NumForm'])
+            # Arabic digits and Roman numerals do not have inflection features.
+            if re.match(r'^(Digit|Roman)$', node.feats['NumForm']):
+                self.check_allowed_features(node, {
+                    'NumType': ['Card'],
+                    'NumForm': ['Digit', 'Roman']
+                })
+            else:
+                self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
+                self.check_allowed_features(node, {
+                    'NumType': ['Card'],
+                    'NumForm': ['Word'],
+                    'Number': ['Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
+                })
+        # VERBS ################################################################
+        elif node.upos == 'VERB':
+            self.check_required_features(node, ['VerbForm', 'Voice'])
+            if node.feats['VerbForm'] == 'Inf':
+                self.check_allowed_features(node, {
+                    'VerbForm': ['Inf'],
+                    'Polarity': ['Pos', 'Neg'],
+                    'Voice': ['Act', 'Pass', 'Cau']
+                })
+            elif node.feats['VerbForm'] == 'Fin':
+                if node.feats['Mood'] == 'Imp':
+                    self.check_required_features(node, ['Mood', 'Voice'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf', 'Prog'],
+                        'VerbForm': ['Fin'],
+                        'Mood': ['Imp'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Voice': ['Act', 'Pass', 'Cau']
+                    })
+                else:
+                    self.check_required_features(node, ['Mood', 'Tense', 'Voice'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf', 'Prog'],
+                        'VerbForm': ['Fin'],
+                        'Mood': ['Ind', 'Nec'],
+                        'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
+                        'Polarity': ['Pos', 'Neg'],
+                        'Voice': ['Act', 'Pass', 'Cau']
+                    })
+            elif node.feats['VerbForm'] == 'Part':
+                self.check_required_features(node, ['Tense', 'Voice'])
+                self.check_allowed_features(node, {
+                    'Aspect': ['Imp', 'Perf', 'Prog'],
+                    'VerbForm': ['Part'],
+                    'Tense': ['Past'],
+                    'Polarity': ['Pos', 'Neg'],
+                    'Voice': ['Act', 'Pass', 'Cau']
+                })
+            else: # verbal noun
+                self.check_required_features(node, ['Tense', 'Voice'])
+                self.check_allowed_features(node, {
+                    'Aspect': ['Imp', 'Perf', 'Prog'],
+                    'VerbForm': ['Vnoun'],
+                    'Tense': ['Past', 'Pres'],
+                    'Gender': ['Masc', 'Fem', 'Neut'],
+                    'Polarity': ['Pos', 'Neg'],
+                    'Voice': ['Act', 'Pass', 'Cau'],
+                })
+        # AUXILIARIES ##########################################################
+        elif node.upos == 'AUX':
+            self.check_required_features(node, ['VerbForm'])
+            if node.feats['Mood'] == 'Imp':
+                self.check_required_features(node, ['Mood'])
+                self.check_allowed_features(node, {
+                    'Aspect': ['Imp', 'Perf', 'Prog'],
+                    'VerbForm': ['Fin'],
+                    'Mood': ['Imp'],
+                    'Polarity': ['Pos', 'Neg']
+                })
+            else: # indicative or subjunctive
+                self.check_required_features(node, ['Mood', 'Tense'])
+                self.check_allowed_features(node, {
+                    'Aspect': ['Imp', 'Perf', 'Prog'],
+                    'VerbForm': ['Fin'],
+                    'Mood': ['Ind', 'Sub'],
+                    'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
+                    'Polarity': ['Pos', 'Neg']
+                })
+        # ADVERBS ##############################################################
+        elif node.upos == 'ADV':
+            if node.feats['PronType'] != '':
+                # Pronominal adverbs are neither compared nor negated.
+                self.check_allowed_features(node, {
+                    'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot']
+                })
+            else:
+                # The remaining adverbs are neither pronominal, nor compared or
+                # negated.
+                self.check_allowed_features(node, {})
+        # PARTICLES ############################################################
+        elif node.upos == 'PART':
+            self.check_allowed_features(node, {
+                'Polarity': ['Neg']
+            })
+        # THE REST: NO FEATURES ################################################
+        else:
+            self.check_allowed_features(node, {})

From 84965b94e618f1f2b5fb2cdc3a46fca4dc897c5e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 24 Nov 2022 23:44:42 +0100
Subject: [PATCH 0711/1374] Non-personal pronouns in Malayalam.

---
 udapi/block/ud/ml/markfeatsbugs.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index a46580d1..fc25eccb 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -65,6 +65,12 @@ def process_node(self, node):
                             'Number': ['Sing', 'Plur'],
                             'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
                         })
+            else: # not personal
+                self.check_required_features(node, ['PronType', 'Case'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Dem', 'Int'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
+                })
         # DETERMINERS ##########################################################
         elif node.upos == 'DET':
             if node.feats['Poss'] == 'Yes': # 'můj', 'tvůj', 'svůj'

From cce7db13d41deeba166ff7a766ae58c6a4fb3db0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Nov 2022 11:41:50 +0100
Subject: [PATCH 0712/1374] Malayalam determiners have fewer features than
 pronouns.

---
 udapi/block/ud/ml/markfeatsbugs.py | 19 ++++++-------------
 1 file changed, 6 insertions(+), 13 deletions(-)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index fc25eccb..41d4cf09 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -73,23 +73,16 @@ def process_node(self, node):
                 })
         # DETERMINERS ##########################################################
         elif node.upos == 'DET':
-            if node.feats['Poss'] == 'Yes': # 'můj', 'tvůj', 'svůj'
-                self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Gender', 'Number', 'Case'])
+            if node.feats['PronType'] == 'Art':
+                self.check_required_features(node, ['PronType', 'Definite'])
                 self.check_allowed_features(node, {
-                    'PronType': ['Prs'],
-                    'Poss': ['Yes'],
-                    'Person': ['1', '2', '3'],
-                    'Gender': ['Masc', 'Fem', 'Neut'],
-                    'Number': ['Sing', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
+                    'PronType': ['Art'],
+                    'Definite': ['Ind']
                 })
             else:
-                self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case'])
+                self.check_required_features(node, ['PronType'])
                 self.check_allowed_features(node, {
-                    'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
-                    'Gender': ['Masc', 'Fem', 'Neut'],
-                    'Number': ['Sing', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
+                    'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot']
                 })
         # NUMERALS #############################################################
         elif node.upos == 'NUM':

From 8a9435f4b3a510dc1b2f6f34c98ee9f5e9e80b5f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 25 Nov 2022 15:09:34 +0100
Subject: [PATCH 0713/1374] Added Chinese lemmatization.

---
 udapi/block/ud/zh/lemmatize.py | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 udapi/block/ud/zh/lemmatize.py

diff --git a/udapi/block/ud/zh/lemmatize.py b/udapi/block/ud/zh/lemmatize.py
new file mode 100644
index 00000000..7db798a0
--- /dev/null
+++ b/udapi/block/ud/zh/lemmatize.py
@@ -0,0 +1,34 @@
+"""Block to add missing lemmas in cases where it seems obvious what the lemma should be."""
+from udapi.core.block import Block
+import logging
+import re
+
+class Lemmatize(Block):
+
+    # dictionary: form --> lemma
+    lemma = {
+        # The plural suffix -men.
+        '我們':   '我', # trad
+        '我们':   '我', # simp
+        '他們':   '他', # trad
+        '他们':   '他', # simp
+        '它們':   '它', # trad
+        '它们':   '它', # simp
+        '牠們':   '牠', # trad
+        '她們':   '她', # trad
+        '她们':   '她', # simp
+        '人們':   '人', # trad
+        '人们':   '人'  # simp
+    }
+
+    def process_node(self, node):
+        """
+        Parts of the Chinese treebanks lack lemmas. Fortunately, lemmatization
+        of Sino-Tibetan languages is pretty straightforward most of the time,
+        as the lemma typically equals to the actual word form.
+        """
+        if node.lemma == '' or node.lemma == '_' and node.form != '_' and node.feats['Typo'] != 'Yes':
+            if node.form in self.lemma:
+                node.lemma = self.lemma[node.form]
+            else:
+                node.lemma = node.form

From 72f045ef84ea000f403d210301d33d1acf3f7018 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 26 Nov 2022 12:46:54 +0100
Subject: [PATCH 0714/1374] Enable rewriting of lemmas in Chinese.

---
 udapi/block/ud/zh/lemmatize.py | 27 ++++++++++++++++++++++-----
 1 file changed, 22 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/zh/lemmatize.py b/udapi/block/ud/zh/lemmatize.py
index 7db798a0..2b7a2dc5 100644
--- a/udapi/block/ud/zh/lemmatize.py
+++ b/udapi/block/ud/zh/lemmatize.py
@@ -5,6 +5,20 @@
 
 class Lemmatize(Block):
 
+    def __init__(self, rewrite='empty', **kwargs):
+        """
+        Create the ud.zh.Lemmatize block instance.
+
+        Args:
+        rewrite=empty: set the lemma if it was empty so far; do not touch the rest
+        rewrite=form: set the lemma if it was empty or equal to form; do not touch the rest
+        rewrite=all: set the lemma regardless of what it was previously
+        """
+        super().__init__(**kwargs)
+        if not re.match(r'^(empty|form|all)$', rewrite):
+            raise ValueError("Unexpected value of parameter 'rewrite'")
+        self.rewrite = rewrite
+
     # dictionary: form --> lemma
     lemma = {
         # The plural suffix -men.
@@ -27,8 +41,11 @@ def process_node(self, node):
         of Sino-Tibetan languages is pretty straightforward most of the time,
         as the lemma typically equals to the actual word form.
         """
-        if node.lemma == '' or node.lemma == '_' and node.form != '_' and node.feats['Typo'] != 'Yes':
-            if node.form in self.lemma:
-                node.lemma = self.lemma[node.form]
-            else:
-                node.lemma = node.form
+        if self.rewrite == 'empty' and not (node.lemma == '' or node.lemma == '_' and node.form != '_' and node.feats['Typo'] != 'Yes'):
+            return
+        elif self.rewrite == 'form' and not (node.lemma == node.form or node.lemma == '' or node.lemma == '_' and node.form != '_' and node.feats['Typo'] != 'Yes'):
+            return
+        if node.form in self.lemma:
+            node.lemma = self.lemma[node.form]
+        else:
+            node.lemma = node.form

From b4dd844870291532089ce518bb0ad4d1f562d92a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 26 Nov 2022 14:59:31 +0100
Subject: [PATCH 0715/1374] Use lemmatization to make copulas acceptable.

---
 udapi/block/ud/zh/lemmatize.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/zh/lemmatize.py b/udapi/block/ud/zh/lemmatize.py
index 2b7a2dc5..9b4c7cba 100644
--- a/udapi/block/ud/zh/lemmatize.py
+++ b/udapi/block/ud/zh/lemmatize.py
@@ -45,7 +45,13 @@ def process_node(self, node):
             return
         elif self.rewrite == 'form' and not (node.lemma == node.form or node.lemma == '' or node.lemma == '_' and node.form != '_' and node.feats['Typo'] != 'Yes'):
             return
-        if node.form in self.lemma:
+        # Verbs that are derived from the copula and tagged as the copula need
+        # to have the lemma of the copula (是 shì).
+        if re.search(r'是', node.form) and re.match(r'^(AUX|VERB)$', node.upos):
+            node.lemma = '是'
+            if node.form == '不是':
+                node.feats['Polarity'] = 'Neg'
+        elif node.form in self.lemma:
             node.lemma = self.lemma[node.form]
         else:
             node.lemma = node.form

From 3bea246947ce88825cc15f690e0de744b85c37ee Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 26 Nov 2022 23:40:44 +0100
Subject: [PATCH 0716/1374] Another Chinese copula.

---
 udapi/block/ud/zh/lemmatize.py | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/zh/lemmatize.py b/udapi/block/ud/zh/lemmatize.py
index 9b4c7cba..298f3501 100644
--- a/udapi/block/ud/zh/lemmatize.py
+++ b/udapi/block/ud/zh/lemmatize.py
@@ -46,9 +46,18 @@ def process_node(self, node):
         elif self.rewrite == 'form' and not (node.lemma == node.form or node.lemma == '' or node.lemma == '_' and node.form != '_' and node.feats['Typo'] != 'Yes'):
             return
         # Verbs that are derived from the copula and tagged as the copula need
-        # to have the lemma of the copula (是 shì).
-        if re.search(r'是', node.form) and re.match(r'^(AUX|VERB)$', node.upos):
-            node.lemma = '是'
+        # to have the lemma of the copula (是 shì 爲 為 为 wèi/wéi).
+        # 亦為 亦为 Yì wèi také
+        # 則為 则为 Zé wèi potom
+        # 更為 更为 Gèng wèi více
+        # 認為 认为 Rènwéi myslet, věřit
+        # 以為 以为 Yǐwéi myslet, věřit
+        # 以爲 以为 Yǐwéi myslet, věřit
+        m = re.search(r'([是爲為为])', node.form)
+        if m and re.match(r'^(AUX|VERB)$', node.upos):
+            node.lemma = m.group(1)
+            if node.lemma == '爲':
+                node.lemma = '為'
             if node.form == '不是':
                 node.feats['Polarity'] = 'Neg'
         elif node.form in self.lemma:

From d9af327a10bc816334d6e0514f636206dfb44c9f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 27 Nov 2022 01:44:04 +0100
Subject: [PATCH 0717/1374] readers' parameter merge=1

so e.g. `udapy read.Conllu files=a.connlu,b.conllu merge=1`
merges the two files into one document and should be equivalent to
`cat a.conllu b.conllu | udapy read.Conllu from=-`.
---
 udapi/core/basereader.py | 82 +++++++++++++++++++++-------------------
 1 file changed, 44 insertions(+), 38 deletions(-)

diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 53a1129c..a3b334da 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -13,7 +13,7 @@ class BaseReader(Block):
 
     # pylint: disable=too-many-arguments
     def __init__(self, files='-', filehandle=None, zone='keep', bundles_per_doc=0, encoding='utf-8-sig',
-                 sent_id_filter=None, split_docs=False, ignore_sent_id=False, **kwargs):
+                 sent_id_filter=None, split_docs=False, ignore_sent_id=False, merge=False, **kwargs):
         super().__init__(**kwargs)
         if filehandle is not None:
             files = None
@@ -28,6 +28,7 @@ def __init__(self, files='-', filehandle=None, zone='keep', bundles_per_doc=0, e
             logging.debug('Using sent_id_filter=%s', sent_id_filter)
         self.split_docs = split_docs
         self.ignore_sent_id = ignore_sent_id
+        self.merge = merge
         # `global.Entity` is a header stored in a comment before the first tree of each document in a given CoNLL-U file.
         # In Udapi, it is stored in `document.meta['global.Entity']`, but for technical reasons, we need to temporarily store it in here, the reader.
         # The reason is that `read.Conllu` uses a fast loading interface with `read_trees()`,
@@ -111,43 +112,48 @@ def try_fast_load(self, document):
             if filehandle is None:
                 self.finished = True
                 return True
-        try:
-            trees = self.read_trees()
-        except NotImplementedError:
-            return False
 
-        document.meta['loaded_from'] = self.filename
-        document.meta['global.Entity'] = self._global_entity
-        if trees and trees[0].newdoc and trees[0].newdoc is not True:
-            document.meta["docname"] = trees[0].newdoc
-
-        bundle, last_bundle_id = None, ''
-        for root in trees:
-            add_to_the_last_bundle = False
-
-            if self.ignore_sent_id:
-                root._sent_id = None
-            elif root._sent_id is not None:
-                parts = root._sent_id.split('/', 1)
-                bundle_id = parts[0]
-                if len(parts) == 2:
-                    root.zone = parts[1]
-                add_to_the_last_bundle = bundle_id == last_bundle_id
-                last_bundle_id = bundle_id
-            if self.zone != 'keep':
-                root.zone = self.zone
-
-            # assign new/next bundle to `bundle` if needed
-            if not bundle or not add_to_the_last_bundle:
-                bundle = document.create_bundle()
-                if last_bundle_id != '':
-                    bundle.bundle_id = last_bundle_id
-
-            bundle.add_tree(root)
-
-        self.next_filehandle()
-        if self.filehandle is None:
-            self.finished = True
+        while True:
+            try:
+                trees = self.read_trees()
+            except NotImplementedError:
+                return False
+
+            document.meta['loaded_from'] = self.filename
+            document.meta['global.Entity'] = self._global_entity
+            if trees and trees[0].newdoc and trees[0].newdoc is not True:
+                document.meta["docname"] = trees[0].newdoc
+
+            bundle, last_bundle_id = None, ''
+            for root in trees:
+                add_to_the_last_bundle = False
+
+                if self.ignore_sent_id:
+                    root._sent_id = None
+                elif root._sent_id is not None:
+                    parts = root._sent_id.split('/', 1)
+                    bundle_id = parts[0]
+                    if len(parts) == 2:
+                        root.zone = parts[1]
+                    add_to_the_last_bundle = bundle_id == last_bundle_id
+                    last_bundle_id = bundle_id
+                if self.zone != 'keep':
+                    root.zone = self.zone
+
+                # assign new/next bundle to `bundle` if needed
+                if not bundle or not add_to_the_last_bundle:
+                    bundle = document.create_bundle()
+                    if last_bundle_id != '':
+                        bundle.bundle_id = last_bundle_id
+
+                bundle.add_tree(root)
+
+            self.next_filehandle()
+            if self.filehandle is None:
+                self.finished = True
+                return True
+            if not self.merge:
+                return True
         return True
 
     # pylint: disable=too-many-branches,too-many-statements
@@ -190,7 +196,7 @@ def process_document(self, document):
             while True:
                 root = self.filtered_read_tree()
                 if root is None:
-                    if trees_loaded == 0 and self.files.has_next_file():
+                    if (trees_loaded == 0 or self.merge) and self.files.has_next_file():
                         filehandle = self.next_filehandle()
                         continue
                     self.finished = not self.files.has_next_file()

From e148621de92ea26550634d4972b6e0093660a103 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 27 Nov 2022 17:11:40 +0100
Subject: [PATCH 0718/1374] Lemmatization of negated verbs in Chinese.

---
 udapi/block/ud/zh/lemmatize.py | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/zh/lemmatize.py b/udapi/block/ud/zh/lemmatize.py
index 298f3501..75d62716 100644
--- a/udapi/block/ud/zh/lemmatize.py
+++ b/udapi/block/ud/zh/lemmatize.py
@@ -45,6 +45,9 @@ def process_node(self, node):
             return
         elif self.rewrite == 'form' and not (node.lemma == node.form or node.lemma == '' or node.lemma == '_' and node.form != '_' and node.feats['Typo'] != 'Yes'):
             return
+        # Lemmatize negated verbs to their affirmative forms.
+        # 不是 bùshì = not be
+        # 没有 méiyǒu = not exist
         # Verbs that are derived from the copula and tagged as the copula need
         # to have the lemma of the copula (是 shì 爲 為 为 wèi/wéi).
         # 亦為 亦为 Yì wèi také
@@ -53,13 +56,16 @@ def process_node(self, node):
         # 認為 认为 Rènwéi myslet, věřit
         # 以為 以为 Yǐwéi myslet, věřit
         # 以爲 以为 Yǐwéi myslet, věřit
-        m = re.search(r'([是爲為为])', node.form)
-        if m and re.match(r'^(AUX|VERB)$', node.upos):
-            node.lemma = m.group(1)
-            if node.lemma == '爲':
-                node.lemma = '為'
-            if node.form == '不是':
+        if re.match(r'^(AUX|VERB)$', node.upos):
+            m1 = re.match(r'^(不|没)(.+)$', node.form)
+            m2 = re.search(r'([是爲為为])', node.form)
+            if m1:
+                node.lemma = m1.group(1)
                 node.feats['Polarity'] = 'Neg'
+            elif m2:
+                node.lemma = m2.group(1)
+                if node.lemma == '爲':
+                    node.lemma = '為'
         elif node.form in self.lemma:
             node.lemma = self.lemma[node.form]
         else:

From 40f224a9e9554d9573d9059fb7aea16ea20a731a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 27 Nov 2022 17:26:13 +0100
Subject: [PATCH 0719/1374] Oops! Wrong part!

---
 udapi/block/ud/zh/lemmatize.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/zh/lemmatize.py b/udapi/block/ud/zh/lemmatize.py
index 75d62716..7658d9b4 100644
--- a/udapi/block/ud/zh/lemmatize.py
+++ b/udapi/block/ud/zh/lemmatize.py
@@ -60,7 +60,7 @@ def process_node(self, node):
             m1 = re.match(r'^(不|没)(.+)$', node.form)
             m2 = re.search(r'([是爲為为])', node.form)
             if m1:
-                node.lemma = m1.group(1)
+                node.lemma = m1.group(2)
                 node.feats['Polarity'] = 'Neg'
             elif m2:
                 node.lemma = m2.group(1)

From 0e0d53905e40848c0e7a11e4d87aa3715a93ee33 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 27 Nov 2022 17:35:42 +0100
Subject: [PATCH 0720/1374] =?UTF-8?q?Another=20negation=20pattern:=20?=
 =?UTF-8?q?=E6=9C=AA.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/zh/lemmatize.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/zh/lemmatize.py b/udapi/block/ud/zh/lemmatize.py
index 7658d9b4..9c492800 100644
--- a/udapi/block/ud/zh/lemmatize.py
+++ b/udapi/block/ud/zh/lemmatize.py
@@ -48,6 +48,7 @@ def process_node(self, node):
         # Lemmatize negated verbs to their affirmative forms.
         # 不是 bùshì = not be
         # 没有 méiyǒu = not exist
+        # 未能 wèinéng = cannot
         # Verbs that are derived from the copula and tagged as the copula need
         # to have the lemma of the copula (是 shì 爲 為 为 wèi/wéi).
         # 亦為 亦为 Yì wèi také
@@ -57,7 +58,7 @@ def process_node(self, node):
         # 以為 以为 Yǐwéi myslet, věřit
         # 以爲 以为 Yǐwéi myslet, věřit
         if re.match(r'^(AUX|VERB)$', node.upos):
-            m1 = re.match(r'^(不|没)(.+)$', node.form)
+            m1 = re.match(r'^([不没未])(.+)$', node.form)
             m2 = re.search(r'([是爲為为])', node.form)
             if m1:
                 node.lemma = m1.group(2)

From 74445e4722de55a7e9714642def6fd09a1d5e2ae Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 27 Nov 2022 17:50:50 +0100
Subject: [PATCH 0721/1374] Another negation pattern.

---
 udapi/block/ud/zh/lemmatize.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/zh/lemmatize.py b/udapi/block/ud/zh/lemmatize.py
index 9c492800..436c3587 100644
--- a/udapi/block/ud/zh/lemmatize.py
+++ b/udapi/block/ud/zh/lemmatize.py
@@ -48,6 +48,7 @@ def process_node(self, node):
         # Lemmatize negated verbs to their affirmative forms.
         # 不是 bùshì = not be
         # 没有 méiyǒu = not exist
+        # 沒能 méinéng = cannot
         # 未能 wèinéng = cannot
         # Verbs that are derived from the copula and tagged as the copula need
         # to have the lemma of the copula (是 shì 爲 為 为 wèi/wéi).
@@ -58,7 +59,7 @@ def process_node(self, node):
         # 以為 以为 Yǐwéi myslet, věřit
         # 以爲 以为 Yǐwéi myslet, věřit
         if re.match(r'^(AUX|VERB)$', node.upos):
-            m1 = re.match(r'^([不没未])(.+)$', node.form)
+            m1 = re.match(r'^([不没沒未])(.+)$', node.form)
             m2 = re.search(r'([是爲為为])', node.form)
             if m1:
                 node.lemma = m1.group(2)

From 13088ed765f05f6f684595863a81a783e8ceafbb Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 27 Nov 2022 18:18:26 +0100
Subject: [PATCH 0722/1374] Lemmatization of interrogative verbs in Chinese.

---
 udapi/block/ud/zh/lemmatize.py | 25 ++++++++++++++++---------
 1 file changed, 16 insertions(+), 9 deletions(-)

diff --git a/udapi/block/ud/zh/lemmatize.py b/udapi/block/ud/zh/lemmatize.py
index 436c3587..abacf29f 100644
--- a/udapi/block/ud/zh/lemmatize.py
+++ b/udapi/block/ud/zh/lemmatize.py
@@ -47,25 +47,32 @@ def process_node(self, node):
             return
         # Lemmatize negated verbs to their affirmative forms.
         # 不是 bùshì = not be
-        # 没有 méiyǒu = not exist
-        # 沒能 méinéng = cannot
+        # 沒有 没有 méiyǒu = not exist
+        # 沒能 没能 méinéng = cannot
         # 未能 wèinéng = cannot
+        # Lemmatize question verbs to their base forms.
+        # 要不要 yàobùyào = do (you) want?
+        # 有没有 yǒuméiyǒu = do (you) have?
         # Verbs that are derived from the copula and tagged as the copula need
         # to have the lemma of the copula (是 shì 爲 為 为 wèi/wéi).
-        # 亦為 亦为 Yì wèi také
-        # 則為 则为 Zé wèi potom
-        # 更為 更为 Gèng wèi více
-        # 認為 认为 Rènwéi myslet, věřit
-        # 以為 以为 Yǐwéi myslet, věřit
-        # 以爲 以为 Yǐwéi myslet, věřit
+        # 亦為 亦为 yìwèi = také
+        # 則為 则为 zéwèi = potom
+        # 更為 更为 gèngwèi = více
+        # 認為 认为 rènwéi = myslet, věřit
+        # 以為 以为 yǐwéi = myslet, věřit
+        # 以爲 以为 yǐwéi = myslet, věřit
         if re.match(r'^(AUX|VERB)$', node.upos):
             m1 = re.match(r'^([不没沒未])(.+)$', node.form)
-            m2 = re.search(r'([是爲為为])', node.form)
+            m2 = re.match(r'^(.+)([不没沒未])\1$', node.form)
+            m3 = re.search(r'([是爲為为])', node.form)
             if m1:
                 node.lemma = m1.group(2)
                 node.feats['Polarity'] = 'Neg'
             elif m2:
                 node.lemma = m2.group(1)
+                node.feats['Mood'] = 'Int'
+            elif m3:
+                node.lemma = m3.group(1)
                 if node.lemma == '爲':
                     node.lemma = '為'
         elif node.form in self.lemma:

From 64f5bc7427efd3c32a84229e2c2c901b545118b4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 1 Dec 2022 14:26:38 +0100
Subject: [PATCH 0723/1374] print also number of documents and paragraphs

if any, based on newdoc and newpar annotations
---
 udapi/block/util/wc.py | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/udapi/block/util/wc.py b/udapi/block/util/wc.py
index 137c95e9..e8ea2676 100644
--- a/udapi/block/util/wc.py
+++ b/udapi/block/util/wc.py
@@ -13,6 +13,7 @@ def __init__(self, tsv=False, **kwargs):
         """
         super().__init__(**kwargs)
         self.trees, self.words, self.mwts, self.tokens, self.empty = 0, 0, 0, 0, 0
+        self.docs, self.paragraphs = 0, 0
         self.tsv = tsv
 
     def process_tree(self, tree):
@@ -22,13 +23,21 @@ def process_tree(self, tree):
         self.mwts += mwtoks
         self.tokens += len(tree.token_descendants) if mwtoks else len(tree.descendants)
         self.empty += len(tree.empty_nodes)
+        if tree.newdoc:
+            self.docs += 1
+        if tree.newpar:
+            self.paragraphs += 1
 
     def process_end(self):
         if self.tsv:
-            print('\t'.join(map(str, (self.trees, self.words, self.tokens, self.mwts, self.empty))))
+            print('\t'.join(map(str, (self.trees, self.words, self.tokens, self.mwts, self.empty, self.docs, self.paragraphs))))
         else:
             print('%8d trees\n%8d words' % (self.trees, self.words))
             if self.mwts:
                 print('%8d multi-word tokens\n%8d tokens' % (self.mwts, self.tokens))
             if self.empty:
                 print('%8d empty nodes' % self.empty)
+            if self.docs:
+                print('%8d documents' % self.docs)
+            if self.paragraphs:
+                print('%8d paragraphs' % self.paragraphs)

From c29590fefe4a045c8c33c0e8729c3a2582d1cf5f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 2 Dec 2022 23:18:53 +0100
Subject: [PATCH 0724/1374] Enable separate checking of Flavio's approach to
 Latin morphology.

---
 udapi/block/ud/la/markfeatsbugs.py | 141 +++++++++++++++--------------
 1 file changed, 75 insertions(+), 66 deletions(-)

diff --git a/udapi/block/ud/la/markfeatsbugs.py b/udapi/block/ud/la/markfeatsbugs.py
index 96c7b682..149fcd18 100644
--- a/udapi/block/ud/la/markfeatsbugs.py
+++ b/udapi/block/ud/la/markfeatsbugs.py
@@ -12,15 +12,32 @@
 
 class MarkFeatsBugs(udapi.block.ud.markfeatsbugs.MarkFeatsBugs):
 
+    def __init__(self, flavio=False, **kwargs):
+        """
+        Create the ud.la.MarkFeatsBugs block instance.
+
+        Args:
+        flavio=1: Accept features as defined by Flavio for treebanks he
+            maintains. By default, a more conservative set of features and
+            values is expected.
+        """
+        super().__init__(**kwargs)
+        self.flavio = flavio
+
     def process_node(self, node):
         # NOUNS ################################################################
         if node.upos == 'NOUN':
-            self.check_required_features(node, ['Gender', 'Number', 'Case'])
-            self.check_allowed_features(node, {
+            rf = ['Gender', 'Number', 'Case']
+            af = {
                 'Gender': ['Masc', 'Fem', 'Neut'],
                 'Number': ['Sing', 'Plur'],
                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
-                'Foreign': ['Yes']})
+                'Foreign': ['Yes']}
+            if self.flavio:
+                rf.append('InflClass')
+                af['InflClass'] = ['IndEurA', 'IndEurO', 'IndEurX']
+            self.check_required_features(node, rf)
+            self.check_allowed_features(node, af)
         # PROPER NOUNS #########################################################
         elif node.upos == 'PROPN':
             self.check_required_features(node, ['Gender', 'Number', 'Case'])
@@ -32,13 +49,20 @@ def process_node(self, node):
                 'Foreign': ['Yes']})
         # ADJECTIVES ###########################################################
         elif node.upos == 'ADJ':
-            self.check_required_features(node, ['Gender', 'Number', 'Case', 'Degree'])
-            self.check_allowed_features(node, {
+            rf = ['Gender', 'Number', 'Case', 'Degree']
+            af = {
                 'Gender': ['Masc', 'Fem', 'Neut'],
                 'Number': ['Sing', 'Plur'],
                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
-                'Degree': ['Pos', 'Cmp', 'Sup'],
-                'Foreign': ['Yes']})
+                'Degree': ['Pos', 'Cmp', 'Sup', 'Abs'],
+                'Foreign': ['Yes']}
+            if self.flavio:
+                # Flavio does not use Degree=Pos, hence Degree is not required.
+                rf = [f for f in rf if f != 'Degree']
+                rf.append('InflClass')
+                af['InflClass'] = ['IndEurA', 'IndEurO', 'IndEurX']
+            self.check_required_features(node, rf)
+            self.check_allowed_features(node, af)
         # PRONOUNS #############################################################
         elif node.upos == 'PRON':
             self.check_required_features(node, ['PronType'])
@@ -81,13 +105,19 @@ def process_node(self, node):
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
                 })
             else:
-                self.check_required_features(node, ['PronType', 'Gender', 'Number', 'Case'])
-                self.check_allowed_features(node, {
+                rf = ['PronType', 'Gender', 'Number', 'Case']
+                af = {
                     'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
                     'Gender': ['Masc', 'Fem', 'Neut'],
                     'Number': ['Sing', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
-                })
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']}
+                if self.flavio:
+                    rf.append('InflClass')
+                    af['PronType'].append('Con')
+                    af['InflClass'] = ['LatPron']
+                    af['Form'] = ['Emp']
+                self.check_required_features(node, rf)
+                self.check_allowed_features(node, af)
         # NUMERALS #############################################################
         elif node.upos == 'NUM':
             self.check_required_features(node, ['NumType', 'NumForm'])
@@ -98,73 +128,52 @@ def process_node(self, node):
                     'NumForm': ['Digit', 'Roman']
                 })
             else:
-                self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
+                self.check_required_features(node, ['NumType', 'NumForm'])
                 self.check_allowed_features(node, {
                     'NumType': ['Card'],
-                    'NumForm': ['Word'],
-                    'Number': ['Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
+                    'NumForm': ['Word']
                 })
         # VERBS AND AUXILIARIES ################################################
         elif re.match(r'^(VERB|AUX)$', node.upos):
-            self.check_required_features(node, ['Aspect', 'VerbForm'])
-            if node.feats['VerbForm'] == 'Inf':
-                self.check_allowed_features(node, {
-                    'Aspect': ['Imp', 'Perf', 'Prosp'],
-                    'VerbForm': ['Inf'],
-                    'Polarity': ['Pos', 'Neg']
-                })
-            elif node.feats['VerbForm'] == 'Fin':
-                if node.feats['Mood'] == 'Imp':
-                    self.check_required_features(node, ['Mood', 'Person', 'Number'])
-                    self.check_allowed_features(node, {
-                        'Aspect': ['Imp', 'Perf', 'Prosp'],
-                        'VerbForm': ['Fin'],
-                        'Mood': ['Imp'],
-                        'Person': ['1', '2', '3'],
-                        'Number': ['Sing', 'Plur'],
-                        'Polarity': ['Pos', 'Neg']
-                    })
-                else: # indicative or subjunctive
-                    self.check_required_features(node, ['Mood', 'Voice', 'Tense', 'Person', 'Number'])
-                    self.check_allowed_features(node, {
-                        'Aspect': ['Imp', 'Perf', 'Prosp'],
-                        'VerbForm': ['Fin'],
-                        'Mood': ['Ind', 'Sub'],
-                        'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
-                        'Voice': ['Act'],
-                        'Person': ['1', '2', '3'],
-                        'Number': ['Sing', 'Plur'],
-                        'Polarity': ['Pos', 'Neg']
-                    })
+            rf = ['Aspect', 'VerbForm']
+            af = {
+                'Aspect': ['Imp', 'Perf', 'Prosp'],
+                'VerbForm': ['Inf', 'Fin', 'Part', 'Vnoun'],
+                'Polarity': ['Pos', 'Neg']}
+            if node.feats['VerbForm'] == 'Fin':
+                rf.extend(['Mood', 'Person', 'Number'])
+                af['Mood'] = ['Ind', 'Sub', 'Imp']
+                af['Person'] = ['1', '2', '3']
+                af['Number'] = ['Sing', 'Plur']
+                if re.match(r'^(Ind|Sub)$', node.feats['Mood']): # indicative or subjunctive
+                    rf.extend(['Voice', 'Tense'])
+                    af['Voice'] = ['Act', 'Pass']
+                    af['Tense'] = ['Past', 'Imp', 'Pres', 'Fut']
             elif node.feats['VerbForm'] == 'Part':
-                self.check_required_features(node, ['Tense', 'Gender', 'Number', 'Voice'])
-                self.check_allowed_features(node, {
-                    'Aspect': ['Imp', 'Perf', 'Prosp'],
-                    'VerbForm': ['Part'],
-                    'Tense': ['Past'],
-                    'Voice': ['Act'], # passive participle is ADJ, so we will not encounter it under VERB
-                    'Number': ['Sing', 'Plur'],
-                    'Gender': ['Masc', 'Fem', 'Neut'],
-                    'Polarity': ['Pos', 'Neg']
-                })
+                rf.extend(['Tense', 'Gender', 'Number', 'Voice'])
+                af['Tense'] = ['Past']
+                af['Voice'] = ['Act']
+                af['Number'] = ['Sing', 'Plur']
+                af['Gender'] = ['Masc', 'Fem', 'Neut']
             else: # verbal noun
-                self.check_required_features(node, ['Tense', 'Number', 'Voice'])
-                self.check_allowed_features(node, {
-                    'Aspect': ['Imp', 'Perf', 'Prosp'],
-                    'VerbForm': ['Vnoun'],
-                    'Tense': ['Past', 'Pres'],
-                    'Voice': ['Act'],
-                    'Number': ['Sing', 'Plur'],
-                    'Gender': ['Masc', 'Fem', 'Neut'], # annotated only in singular
-                    'Polarity': ['Pos', 'Neg']
-                })
+                rf.extend(['Tense', 'Voice'])
+                af['Tense'] = ['Past', 'Pres']
+                af['Voice'] = ['Act']
+                af['Gender'] = ['Masc', 'Fem', 'Neut']
+            if self.flavio:
+                # Flavio has killed Tense in his treebanks.
+                rf = [f for f in rf if f != 'Tense']
+                # Flavio added InflClass but not everywhere, so it is not required.
+                af['InflClass'] = ['LatA', 'LatAnom', 'LatE', 'LatI2', 'LatX']
+            self.check_required_features(node, rf)
+            self.check_allowed_features(node, af)
         # ADVERBS ##############################################################
         elif node.upos == 'ADV':
             if node.feats['PronType'] != '':
                 # Pronominal adverbs are neither compared nor negated.
                 self.check_allowed_features(node, {
-                    'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot']
+                    'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot'],
+                    'AdvType': ['Loc']
                 })
             else:
                 # The remaining adverbs are neither pronominal, nor compared or

From 8b05a49741481d20cf4b0b4ec41bf92b4a696701 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 3 Dec 2022 12:36:35 +0100
Subject: [PATCH 0725/1374] Adjusted Latin feature rules.

---
 udapi/block/ud/la/markfeatsbugs.py | 209 +++++++++++++++++------------
 1 file changed, 121 insertions(+), 88 deletions(-)

diff --git a/udapi/block/ud/la/markfeatsbugs.py b/udapi/block/ud/la/markfeatsbugs.py
index 149fcd18..31d112b8 100644
--- a/udapi/block/ud/la/markfeatsbugs.py
+++ b/udapi/block/ud/la/markfeatsbugs.py
@@ -25,121 +25,146 @@ def __init__(self, flavio=False, **kwargs):
         self.flavio = flavio
 
     def process_node(self, node):
+        rf = []
+        af = {}
         # NOUNS ################################################################
         if node.upos == 'NOUN':
-            rf = ['Gender', 'Number', 'Case']
+            if not node.feats['Abbr'] == 'Yes':
+                rf = ['Gender', 'Number', 'Case']
             af = {
                 'Gender': ['Masc', 'Fem', 'Neut'],
                 'Number': ['Sing', 'Plur'],
                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
+                'Degree': ['Dim'],
+                'Abbr': ['Yes'],
                 'Foreign': ['Yes']}
             if self.flavio:
-                rf.append('InflClass')
-                af['InflClass'] = ['IndEurA', 'IndEurO', 'IndEurX']
+                # Flavio added InflClass but not everywhere, so it is not required.
+                af['InflClass'] = ['IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # PROPER NOUNS #########################################################
         elif node.upos == 'PROPN':
-            self.check_required_features(node, ['Gender', 'Number', 'Case'])
-            self.check_allowed_features(node, {
+            if not node.feats['Abbr'] == 'Yes':
+                rf = ['Gender', 'Number', 'Case']
+            af = {
                 'Gender': ['Masc', 'Fem', 'Neut'],
                 'Number': ['Sing', 'Plur'],
                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
                 'NameType': ['Giv', 'Sur', 'Geo'],
-                'Foreign': ['Yes']})
+                'Abbr': ['Yes'],
+                'Foreign': ['Yes']}
+            if self.flavio:
+                # Flavio added InflClass but not everywhere, so it is not required.
+                af['InflClass'] = ['IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
+                af['Proper'] = ['Yes']
+            self.check_required_features(node, rf)
+            self.check_allowed_features(node, af)
         # ADJECTIVES ###########################################################
         elif node.upos == 'ADJ':
-            rf = ['Gender', 'Number', 'Case', 'Degree']
+            if not node.feats['Abbr'] == 'Yes':
+                rf = ['Gender', 'Number', 'Case', 'Degree']
             af = {
+                'NumType': ['Ord', 'Dist'],
                 'Gender': ['Masc', 'Fem', 'Neut'],
                 'Number': ['Sing', 'Plur'],
                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
                 'Degree': ['Pos', 'Cmp', 'Sup', 'Abs'],
+                'Abbr': ['Yes'],
                 'Foreign': ['Yes']}
             if self.flavio:
                 # Flavio does not use Degree=Pos, hence Degree is not required.
                 rf = [f for f in rf if f != 'Degree']
-                rf.append('InflClass')
-                af['InflClass'] = ['IndEurA', 'IndEurO', 'IndEurX']
+                # Flavio added InflClass but not everywhere, so it is not required.
+                af['InflClass'] = ['IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
+                af['Compound'] = ['Yes']
+                af['Proper'] = ['Yes']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # PRONOUNS #############################################################
         elif node.upos == 'PRON':
-            self.check_required_features(node, ['PronType'])
+            rf = ['PronType', 'Case']
+            af = {
+                'PronType': ['Prs', 'Rel', 'Ind'],
+                'Case':     ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
+            }
             if node.feats['PronType'] == 'Prs':
-                if node.feats['Reflex'] == 'Yes':
-                    self.check_required_features(node, ['PronType', 'Reflex', 'Case'])
-                    self.check_allowed_features(node, {
-                        'PronType': ['Prs'],
-                        'Reflex': ['Yes'],
-                        'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Abl']
-                    })
-                else: # not reflexive
-                    if node.feats['Person'] == '3': # on, ona, ono, oni, ony
-                        self.check_required_features(node, ['PronType', 'Person', 'Gender', 'Number', 'Case'])
-                        self.check_allowed_features(node, {
-                            'PronType': ['Prs'],
-                            'Person': ['3'],
-                            'Gender': ['Masc', 'Fem', 'Neut'],
-                            'Number': ['Sing', 'Plur'],
-                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
-                        })
-                    else: # 1st and 2nd person do not have gender: já, ty
-                        self.check_required_features(node, ['PronType', 'Person', 'Number', 'Case'])
-                        self.check_allowed_features(node, {
-                            'PronType': ['Prs'],
-                            'Person': ['1', '2'],
-                            'Number': ['Sing', 'Plur'],
-                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
-                        })
+                af['Reflex'] = ['Yes']
+                if node.feats['Reflex'] == 'Yes': # seipsum, se
+                    # seipsum has gender and number but se does not, so it is not required
+                    af['Gender'] = ['Masc']
+                    af['Number'] = ['Sing']
+                    af['Person'] = ['3']
+                    af['Case'] = ['Gen', 'Dat', 'Acc', 'Loc', 'Abl']
+                else: # not reflexive: ego, tu, is, nos
+                    rf.extend(['Person', 'Number'])
+                    af['Person'] = ['1', '2', '3']
+                    af['Number'] = ['Sing', 'Plur']
+                    # 1st and 2nd person do not have gender
+                    if node.feats['Person'] == '3': # is, id
+                        rf.append('Gender')
+                        af['Gender'] = ['Masc', 'Fem', 'Neut']
+            elif re.match(r'^(Rel|Ind)$', node.feats['PronType']):
+                rf.extend(['Gender', 'Number'])
+                af['Gender'] = ['Masc', 'Fem', 'Neut']
+                af['Number'] = ['Sing', 'Plur']
+            if self.flavio:
+                # Flavio added InflClass but not everywhere, so it is not required.
+                af['InflClass'] = ['LatAnom', 'LatPron']
+            self.check_required_features(node, rf)
+            self.check_allowed_features(node, af)
         # DETERMINERS ##########################################################
         elif node.upos == 'DET':
-            if node.feats['Poss'] == 'Yes': # 'můj', 'tvůj', 'svůj'
-                self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Gender', 'Number', 'Case'])
-                self.check_allowed_features(node, {
-                    'PronType': ['Prs'],
-                    'Poss': ['Yes'],
-                    'Person': ['1', '2', '3'],
-                    'Gender': ['Masc', 'Fem', 'Neut'],
-                    'Number': ['Sing', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
-                })
+            rf = ['PronType', 'Gender', 'Number', 'Case']
+            af = {
+                'Gender': ['Masc', 'Fem', 'Neut'],
+                'Number': ['Sing', 'Plur'],
+                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']}
+            if node.feats['Poss'] == 'Yes': # 'meus', 'tuus', 'suus', 'noster'
+                rf.extend(['Poss', 'Person[psor]'])
+                af['PronType'] = ['Prs']
+                af['Poss'] = 'Yes'
+                af['Person[psor]'] = ['1', '2', '3']
+                af['Reflex'] = ['Yes']
+                # The possessor's number is distinguished in the first and second person (meus vs. noster) but not in the third person (suus).
+                if node.feats['Person[psor]'] != '3':
+                    rf.append('Number[psor]')
+                    af['Number[psor]'] = ['Sing', 'Plur']
             else:
-                rf = ['PronType', 'Gender', 'Number', 'Case']
-                af = {
-                    'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp'],
-                    'Gender': ['Masc', 'Fem', 'Neut'],
-                    'Number': ['Sing', 'Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']}
-                if self.flavio:
-                    rf.append('InflClass')
-                    af['PronType'].append('Con')
-                    af['InflClass'] = ['LatPron']
-                    af['Form'] = ['Emp']
-                self.check_required_features(node, rf)
-                self.check_allowed_features(node, af)
+                af['PronType'] = ['Dem', 'Rel', 'Ind', 'Tot', 'Con']
+            if self.flavio:
+                # Flavio added InflClass but not everywhere, so it is not required.
+                af['InflClass'] = ['IndEurA', 'IndEurI', 'IndEurO', 'LatPron']
+                af['Form'] = ['Emp']
+            self.check_required_features(node, rf)
+            self.check_allowed_features(node, af)
         # NUMERALS #############################################################
         elif node.upos == 'NUM':
-            self.check_required_features(node, ['NumType', 'NumForm'])
+            rf = ['NumType', 'NumForm']
+            af = {
+                'NumType': ['Card'],
+                'NumForm': ['Word', 'Roman', 'Digit']
+            }
             # Arabic digits and Roman numerals do not have inflection features.
-            if re.match(r'^(Digit|Roman)$', node.feats['NumForm']):
-                self.check_allowed_features(node, {
-                    'NumType': ['Card'],
-                    'NumForm': ['Digit', 'Roman']
-                })
-            else:
-                self.check_required_features(node, ['NumType', 'NumForm'])
-                self.check_allowed_features(node, {
-                    'NumType': ['Card'],
-                    'NumForm': ['Word']
-                })
+            if not re.match(r'^(Digit|Roman)$', node.feats['NumForm']):
+                af['Gender'] = ['Masc', 'Fem', 'Neut']
+                af['Number'] = ['Sing', 'Plur']
+                af['Case'] = ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
+            if self.flavio:
+                # Flavio added InflClass but not everywhere, so it is not required.
+                af['InflClass'] = ['IndEurA', 'IndEurI', 'IndEurO', 'LatPron']
+            self.check_required_features(node, rf)
+            self.check_allowed_features(node, af)
         # VERBS AND AUXILIARIES ################################################
         elif re.match(r'^(VERB|AUX)$', node.upos):
-            rf = ['Aspect', 'VerbForm']
+            rf = ['VerbForm']
             af = {
-                'Aspect': ['Imp', 'Perf', 'Prosp'],
                 'VerbForm': ['Inf', 'Fin', 'Part', 'Vnoun'],
                 'Polarity': ['Pos', 'Neg']}
+            # Main verbs have aspect but auxiliaries don't.
+            if node.upos == 'VERB':
+                rf.append('Aspect')
+                af['Aspect'] = ['Imp', 'Perf', 'Prosp']
             if node.feats['VerbForm'] == 'Fin':
                 rf.extend(['Mood', 'Person', 'Number'])
                 af['Mood'] = ['Ind', 'Sub', 'Imp']
@@ -150,40 +175,48 @@ def process_node(self, node):
                     af['Voice'] = ['Act', 'Pass']
                     af['Tense'] = ['Past', 'Imp', 'Pres', 'Fut']
             elif node.feats['VerbForm'] == 'Part':
-                rf.extend(['Tense', 'Gender', 'Number', 'Voice'])
+                rf.extend(['Tense', 'Gender', 'Number', 'Voice', 'Case'])
                 af['Tense'] = ['Past']
-                af['Voice'] = ['Act']
+                af['Voice'] = ['Act', 'Pass']
                 af['Number'] = ['Sing', 'Plur']
                 af['Gender'] = ['Masc', 'Fem', 'Neut']
-            else: # verbal noun
+                af['Case'] = ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
+                af['Degree'] = ['Abs']
+            elif node.feats['VerbForm'] == 'Vnoun':
                 rf.extend(['Tense', 'Voice'])
                 af['Tense'] = ['Past', 'Pres']
-                af['Voice'] = ['Act']
+                af['Voice'] = ['Act', 'Pass']
                 af['Gender'] = ['Masc', 'Fem', 'Neut']
+            # else: nothing to be added form VerbForm=Inf
             if self.flavio:
                 # Flavio has killed Tense in his treebanks.
                 rf = [f for f in rf if f != 'Tense']
                 # Flavio added InflClass but not everywhere, so it is not required.
                 af['InflClass'] = ['LatA', 'LatAnom', 'LatE', 'LatI2', 'LatX']
+                if node.feats['VerbForm'] == 'Part':
+                    af['InflClass[nominal]'] = ['IndEurA', 'IndEurI', 'IndEurO']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # ADVERBS ##############################################################
         elif node.upos == 'ADV':
-            if node.feats['PronType'] != '':
-                # Pronominal adverbs are neither compared nor negated.
-                self.check_allowed_features(node, {
-                    'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot'],
-                    'AdvType': ['Loc']
-                })
-            else:
-                # The remaining adverbs are neither pronominal, nor compared or
-                # negated.
-                self.check_allowed_features(node, {})
+            af = {
+                'AdvType':  ['Loc', 'Tim'],
+                'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot', 'Con'],
+                'Degree':   ['Pos', 'Cmp', 'Sup', 'Abs']
+            }
+            if self.flavio:
+                af['Compound'] = 'Yes'
+                af['Form'] = 'Emp'
+            self.check_allowed_features(node, af)
         # PARTICLES ############################################################
         elif node.upos == 'PART':
-            self.check_allowed_features(node, {
+            af = {
+                'PartType': ['Int'],
                 'Polarity': ['Neg']
-            })
+            }
+            if self.flavio:
+                af['Form'] = 'Emp'
+            self.check_allowed_features(node, af)
         # THE REST: NO FEATURES ################################################
         else:
             self.check_allowed_features(node, {})

From ab86f1b93d6e20bf4f42c18c1af9f3c22c5e4f64 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 4 Dec 2022 12:07:10 +0100
Subject: [PATCH 0726/1374] Refined features of pronouns in Malayalam.

---
 udapi/block/ud/ml/markfeatsbugs.py | 71 +++++++++++++-----------------
 1 file changed, 30 insertions(+), 41 deletions(-)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index 41d4cf09..96cf8b55 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -27,50 +27,38 @@ def process_node(self, node):
                 'Foreign': ['Yes']})
         # PRONOUNS #############################################################
         elif node.upos == 'PRON':
-            self.check_required_features(node, ['PronType'])
+            rf = ['PronType', 'Case']
+            af = {
+                'PronType': ['Prs', 'Int'], # demonstrative pronouns are treated as third person personal pronouns
+                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
+            }
             if node.feats['PronType'] == 'Prs':
+                af['Reflex'] = ['Yes']
                 if node.feats['Reflex'] == 'Yes':
-                    self.check_required_features(node, ['PronType', 'Reflex', 'Case'])
-                    self.check_allowed_features(node, {
-                        'PronType': ['Prs'],
-                        'Reflex': ['Yes'],
-                        'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Abl', 'Ins', 'Cmp']
-                    })
+                    af['Case'] = [c for c in af['Case'] if c != 'Nom' and c != 'Voc']
                 else: # not reflexive
-                    if node.feats['Person'] == '3': # അവൻ avan, അവൾ avaḷ, അത് at, അവർ avaṟ
+                    rf.extend(['Person', 'Number'])
+                    af['Person'] = ['1', '2', '3']
+                    af['Number'] = ['Sing', 'Plur']
+                    # 1st and 2nd person do not have gender: ഞാൻ ñān, നീ nī; or 3rd person താൻ tān̕
+                    if node.feats['Person'] == '3' and not node.lemma == 'താൻ': # അവൻ avan, അവൾ avaḷ, അത് at, അവർ avaṟ; but not താൻ tān̕
+                        rf.append('Deixis')
+                        af['Deixis'] = ['Prox', 'Remt']
                         if node.feats['Number'] == 'Sing':
-                            self.check_required_features(node, ['PronType', 'Person', 'Deixis', 'Gender', 'Number', 'Case'])
-                            self.check_allowed_features(node, {
-                                'PronType': ['Prs'],
-                                'Person': ['3'],
-                                'Deixis': ['Prox', 'Remt'],
-                                'Gender': ['Masc', 'Fem', 'Neut'],
-                                'Number': ['Sing'],
-                                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
-                            })
-                        else: # plural pronouns do not distinguish gender
-                            self.check_required_features(node, ['PronType', 'Person', 'Deixis', 'Number', 'Case'])
-                            self.check_allowed_features(node, {
-                                'PronType': ['Prs'],
-                                'Person': ['3'],
-                                'Deixis': ['Prox', 'Remt'],
-                                'Number': ['Plur'],
-                                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
-                            })
-                    else: # 1st and 2nd person do not have gender: ഞാൻ ñān, നീ nī
-                        self.check_required_features(node, ['PronType', 'Person', 'Number', 'Case'])
-                        self.check_allowed_features(node, {
-                            'PronType': ['Prs'],
-                            'Person': ['1', '2'],
-                            'Number': ['Sing', 'Plur'],
-                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
-                        })
-            else: # not personal
-                self.check_required_features(node, ['PronType', 'Case'])
-                self.check_allowed_features(node, {
-                    'PronType': ['Dem', 'Int'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
-                })
+                            rf.append('Gender')
+                            af['Gender'] = ['Masc', 'Fem', 'Neut']
+                            # third person singular neuter pronouns also distinguish animacy (animate neuter are animals and plants, they have a different accusative form)
+                            if node.feats['Gender'] == 'Neut':
+                                rf.append('Animacy')
+                                af['Animacy'] = ['Anim', 'Inan']
+                        else: # plural pronouns do not distinguish gender but they do distinguish animacy
+                            rf.append('Animacy')
+                            af['Animacy'] = ['Anim', 'Inan']
+                    elif node.feats['Person'] == '1' and node.feats['Number'] == 'Plur':
+                        rf.append('Clusivity')
+                        af['Clusivity'] = ['In', 'Ex']
+            self.check_required_features(node, rf)
+            self.check_allowed_features(node, af)
         # DETERMINERS ##########################################################
         elif node.upos == 'DET':
             if node.feats['PronType'] == 'Art':
@@ -82,7 +70,8 @@ def process_node(self, node):
             else:
                 self.check_required_features(node, ['PronType'])
                 self.check_allowed_features(node, {
-                    'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot']
+                    'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot'],
+                    'Deixis': ['Prox', 'Remt']
                 })
         # NUMERALS #############################################################
         elif node.upos == 'NUM':

From cd9b962cb602eced89466af00ee077afd20d63bc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 4 Dec 2022 15:04:02 +0100
Subject: [PATCH 0727/1374] Write sentences in a HTML list.

---
 udapi/block/write/sentenceshtml.py | 37 ++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 udapi/block/write/sentenceshtml.py

diff --git a/udapi/block/write/sentenceshtml.py b/udapi/block/write/sentenceshtml.py
new file mode 100644
index 00000000..e0f87241
--- /dev/null
+++ b/udapi/block/write/sentenceshtml.py
@@ -0,0 +1,37 @@
+"""SentencesHtml class is a writer for sentences in HTML list (could be Google-translated, remembering sentence correspondence)."""
+from udapi.core.basewriter import BaseWriter
+
+
+class SentencesHtml(BaseWriter):
+    """A writer of sentences in HTML list (one per item).
+
+    Usage:
+    udapy write.SentencesHtml if_missing=empty < my.conllu > my.html
+    """
+
+    def __init__(self, title='Sentences from CoNLL-U', if_missing='detokenize', **kwargs):
+        """Create the SentencesHtml writer block.
+
+        Parameters:
+        if_missing: What to do if `root.text` is `None`? (default=detokenize)
+         * `detokenize`: use `root.compute_text()` to compute the sentence.
+         * `empty`: print an empty line
+         * `warn_detokenize`, `warn_empty`: in addition emit a warning via `logging.warning()`
+         * `fatal`: raise an exception
+        """
+        super().__init__(**kwargs)
+        self.title = title
+        self.if_missing = if_missing
+
+    def before_process_document(self, document):
+        super().before_process_document(document)
+        print('<!DOCTYPE html>\n<html>\n<head>\n<meta charset="utf-8">')
+        print('<title>' + self.title + '</title>')
+        print('</head>\n<body>\n<ul>\n')
+
+    def after_process_document(self, document):
+        print("</ul>\n</body>\n</html>")
+        super().after_process_document(document)
+
+    def process_tree(self, tree):
+        print('  <li id="%s">%s</li>' % (tree.sent_id, tree.get_sentence(self.if_missing)))

From faeecb50ca7c3dfbc1130c628593c9b7031f035e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 4 Dec 2022 19:30:44 +0100
Subject: [PATCH 0728/1374] Refined feature tests for Malayalam.

---
 udapi/block/ud/ml/markfeatsbugs.py | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index 96cf8b55..2372bd23 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -57,6 +57,15 @@ def process_node(self, node):
                     elif node.feats['Person'] == '1' and node.feats['Number'] == 'Plur':
                         rf.append('Clusivity')
                         af['Clusivity'] = ['In', 'Ex']
+            # Interrogative pronouns, too, can be case-marked. Therefore, the
+            # base form must have Case=Nom.
+            # ആര് ār "who" (Nom) എന്ത് ent "what" (Nom, Acc.Inan)
+            # ആരെ āre "who" (Acc) എന്തെ ente "what" (Acc.Anim) എന്തിനെ entine "what" (Acc.Anim or maybe Inan but optional)
+            # ആരുടെ āruṭe "who" (Gen) എന്തിന് entin "what" (Gen) or "why"
+            # ആരൊക്കെ ārokke "who" (Dat?) എന്തൊക്കെ entokke "what" (Dat?)
+            elif node.feats['PronType'] == 'Int':
+                rf.append('Animacy')
+                af['Animacy'] = ['Anim', 'Inan']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # DETERMINERS ##########################################################
@@ -101,13 +110,18 @@ def process_node(self, node):
                 })
             elif node.feats['VerbForm'] == 'Fin':
                 if node.feats['Mood'] == 'Imp':
-                    self.check_required_features(node, ['Mood', 'Voice'])
+                    # Unlike other forms, the imperative distinguishes politeness.
+                    # The verb stem serves as an informal imperative: തുറ tuṟa "open"
+                    # The citation form may serve as a formal imperative: തുറക്കുക tuṟakkūka "open"
+                    # Finally, there is another formal imperative with -kkū: തുറക്കൂ tuṟakkū "open"
+                    self.check_required_features(node, ['Mood', 'Voice', 'Polite'])
                     self.check_allowed_features(node, {
                         'Aspect': ['Imp', 'Perf', 'Prog'],
                         'VerbForm': ['Fin'],
                         'Mood': ['Imp'],
                         'Polarity': ['Pos', 'Neg'],
-                        'Voice': ['Act', 'Pass', 'Cau']
+                        'Voice': ['Act', 'Pass', 'Cau'],
+                        'Polite': ['Infm', 'Form']
                     })
                 else:
                     self.check_required_features(node, ['Mood', 'Tense', 'Voice'])

From 9f1c9adadd6b5e53aa9cf5aaea9cd8e26cdfe663 Mon Sep 17 00:00:00 2001
From: "Federica Gamba (PhD" <gamba@cyan.ms.mff.cuni.cz>
Date: Tue, 6 Dec 2022 10:24:48 +0100
Subject: [PATCH 0729/1374] Further adjusted Latin feature rules.

---
 udapi/block/ud/la/markfeatsbugs.py | 155 ++++++++++++++++++++---------
 1 file changed, 107 insertions(+), 48 deletions(-)

diff --git a/udapi/block/ud/la/markfeatsbugs.py b/udapi/block/ud/la/markfeatsbugs.py
index 31d112b8..323f60f7 100644
--- a/udapi/block/ud/la/markfeatsbugs.py
+++ b/udapi/block/ud/la/markfeatsbugs.py
@@ -29,7 +29,7 @@ def process_node(self, node):
         af = {}
         # NOUNS ################################################################
         if node.upos == 'NOUN':
-            if not node.feats['Abbr'] == 'Yes':
+            if not node.feats['Abbr'] == 'Yes' or node.feats['Case']: # abbreviated or indeclinable nouns
                 rf = ['Gender', 'Number', 'Case']
             af = {
                 'Gender': ['Masc', 'Fem', 'Neut'],
@@ -41,61 +41,71 @@ def process_node(self, node):
             if self.flavio:
                 # Flavio added InflClass but not everywhere, so it is not required.
                 af['InflClass'] = ['IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
+                af['VerbForm'] = ['Part']
+                af['Proper'] = ['Yes']
+                af['Compound'] = ['Yes']
+                af['NameType'] = ['Ast', 'Cal', 'Com', 'Geo', 'Giv', 'Let', 'Lit', 'Met', 'Nat', 'Rel', 'Sur', 'Oth']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # PROPER NOUNS #########################################################
         elif node.upos == 'PROPN':
-            if not node.feats['Abbr'] == 'Yes':
+            if not node.feats['Abbr'] == 'Yes' and node.feats['Case']: # abbreviated and indeclinable nouns
                 rf = ['Gender', 'Number', 'Case']
             af = {
                 'Gender': ['Masc', 'Fem', 'Neut'],
                 'Number': ['Sing', 'Plur'],
                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
-                'NameType': ['Giv', 'Sur', 'Geo'],
                 'Abbr': ['Yes'],
                 'Foreign': ['Yes']}
             if self.flavio:
-                # Flavio added InflClass but not everywhere, so it is not required.
-                af['InflClass'] = ['IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
-                af['Proper'] = ['Yes']
+                af['Compound'] = 'Yes'
+                af['NameType'] = ['Ast', 'Cal', 'Com', 'Geo', 'Giv', 'Let', 'Lit', 'Met', 'Nat', 'Rel', 'Sur', 'Oth']
+                if not node.feats['Abbr'] == 'Yes' and node.feats['Case']:
+                    af['InflClass'] = ['IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # ADJECTIVES ###########################################################
         elif node.upos == 'ADJ':
-            if not node.feats['Abbr'] == 'Yes':
-                rf = ['Gender', 'Number', 'Case', 'Degree']
+            if not node.feats['Abbr'] == 'Yes' and node.feats['Case']:
+                rf = ['Gender', 'Number', 'Case']
             af = {
                 'NumType': ['Ord', 'Dist'],
                 'Gender': ['Masc', 'Fem', 'Neut'],
                 'Number': ['Sing', 'Plur'],
                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
-                'Degree': ['Pos', 'Cmp', 'Sup', 'Abs'],
+                'Degree': ['Cmp', 'Sup', 'Abs'],
                 'Abbr': ['Yes'],
-                'Foreign': ['Yes']}
+                'Foreign': ['Yes'],
+                'Polarity': ['Neg']}
             if self.flavio:
                 # Flavio does not use Degree=Pos, hence Degree is not required.
-                rf = [f for f in rf if f != 'Degree']
+                # rf = [f for f in rf if f != 'Degree']
                 # Flavio added InflClass but not everywhere, so it is not required.
                 af['InflClass'] = ['IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
                 af['Compound'] = ['Yes']
+                af['VerbForm'] = ['Part']
                 af['Proper'] = ['Yes']
+                af['Degree'].append('Dim')
+                af['NameType'] = ['Ast', 'Cal', 'Com', 'Geo', 'Giv', 'Let', 'Lit', 'Met', 'Nat', 'Rel', 'Sur', 'Oth']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # PRONOUNS #############################################################
         elif node.upos == 'PRON':
             rf = ['PronType', 'Case']
             af = {
-                'PronType': ['Prs', 'Rel', 'Ind'],
+                'PronType': ['Prs', 'Rel', 'Ind', 'Int', 'Rcp'],
                 'Case':     ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
             }
             if node.feats['PronType'] == 'Prs':
                 af['Reflex'] = ['Yes']
                 if node.feats['Reflex'] == 'Yes': # seipsum, se
+                    rf.extend(['Person'])
                     # seipsum has gender and number but se does not, so it is not required
-                    af['Gender'] = ['Masc']
-                    af['Number'] = ['Sing']
+                    # TODO: seipsum in ITTB, but why lemma seipsum instead of seipse?
+                    af['Gender'] = ['Masc', 'Fem', 'Neut']
+                    af['Number'] = ['Sing', 'Plur']
                     af['Person'] = ['3']
-                    af['Case'] = ['Gen', 'Dat', 'Acc', 'Loc', 'Abl']
+                    af['Case'] = ['Nom', 'Gen', 'Dat', 'Acc', 'Loc', 'Abl']
                 else: # not reflexive: ego, tu, is, nos
                     rf.extend(['Person', 'Number'])
                     af['Person'] = ['1', '2', '3']
@@ -104,22 +114,34 @@ def process_node(self, node):
                     if node.feats['Person'] == '3': # is, id
                         rf.append('Gender')
                         af['Gender'] = ['Masc', 'Fem', 'Neut']
-            elif re.match(r'^(Rel|Ind)$', node.feats['PronType']):
+            elif re.match(r'^(Rel|Int)$', node.feats['PronType']):
                 rf.extend(['Gender', 'Number'])
                 af['Gender'] = ['Masc', 'Fem', 'Neut']
                 af['Number'] = ['Sing', 'Plur']
+            elif node.feats['PronType'] == 'Ind':
+                rf = [f for f in rf if f != 'Case']
+                af['Gender'] = ['Masc', 'Fem', 'Neut']
+                af['Number'] = ['Sing', 'Plur']
             if self.flavio:
                 # Flavio added InflClass but not everywhere, so it is not required.
                 af['InflClass'] = ['LatAnom', 'LatPron']
+                af['Compound'] = ['Yes']
+                af['Polarity'] = ['Neg']
+                af['Form'] = ['Emp']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # DETERMINERS ##########################################################
         elif node.upos == 'DET':
-            rf = ['PronType', 'Gender', 'Number', 'Case']
+            rf = ['PronType']
+            if node.feats['Case']:
+                rf.extend(['Gender', 'Number', 'Case'])
             af = {
                 'Gender': ['Masc', 'Fem', 'Neut'],
                 'Number': ['Sing', 'Plur'],
-                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']}
+                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
+                'Degree': ['Cmp', 'Abs', 'Sup'],
+                'Polarity': ['Neg']
+                }
             if node.feats['Poss'] == 'Yes': # 'meus', 'tuus', 'suus', 'noster'
                 rf.extend(['Poss', 'Person[psor]'])
                 af['PronType'] = ['Prs']
@@ -131,11 +153,16 @@ def process_node(self, node):
                     rf.append('Number[psor]')
                     af['Number[psor]'] = ['Sing', 'Plur']
             else:
-                af['PronType'] = ['Dem', 'Rel', 'Ind', 'Tot', 'Con']
+                af['PronType'] = ['Dem', 'Rel', 'Ind', 'Int', 'Tot', 'Con']
             if self.flavio:
                 # Flavio added InflClass but not everywhere, so it is not required.
-                af['InflClass'] = ['IndEurA', 'IndEurI', 'IndEurO', 'LatPron']
+                af['InflClass'] = ['IndEurA', 'IndEurI', 'IndEurO', 'IndEurX', 'LatPron']
+                af['Compound'] = ['Yes']
                 af['Form'] = ['Emp']
+                af['NumType'] = ['Card']
+                af['Degree'].append('Dim')
+                if re.match(r'^(unus|ambo)', node.lemma):
+                    af['NumValue'] = ['1', '2']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # NUMERALS #############################################################
@@ -151,50 +178,59 @@ def process_node(self, node):
                 af['Number'] = ['Sing', 'Plur']
                 af['Case'] = ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
             if self.flavio:
-                # Flavio added InflClass but not everywhere, so it is not required.
+                # Flavio added InflClass but not everywhere, so it is not required. # e.g. duodecim
                 af['InflClass'] = ['IndEurA', 'IndEurI', 'IndEurO', 'LatPron']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # VERBS AND AUXILIARIES ################################################
         elif re.match(r'^(VERB|AUX)$', node.upos):
-            rf = ['VerbForm']
+            rf = ['VerbForm', 'Aspect']
             af = {
-                'VerbForm': ['Inf', 'Fin', 'Part', 'Vnoun'],
-                'Polarity': ['Pos', 'Neg']}
+                'VerbForm': ['Inf', 'Fin', 'Part'],
+                'Aspect': ['Imp', 'Inch', 'Perf', 'Prosp'],
+                'Polarity': ['Neg']
+                }
+            if not re.match(r'^(Ger|Gdv)$', node.feats['VerbForm']):
+                rf.append('Tense')
+                af['Tense'] = ['Pres', 'Fut']
+            if node.upos == 'VERB': # and not node.lemma.endswith('sum'): # compounds of sum
+                rf.append('Voice')
+                af['Voice'] = ['Act', 'Pass']
             # Main verbs have aspect but auxiliaries don't.
-            if node.upos == 'VERB':
-                rf.append('Aspect')
-                af['Aspect'] = ['Imp', 'Perf', 'Prosp']
-            if node.feats['VerbForm'] == 'Fin':
+            # TODO: apparently, apparently AUXs have aspect as well
+            # if node.upos == 'VERB':
+            #    rf.append('Aspect')
+            #    af['Aspect'] = ['Imp', 'Inch', 'Perf', 'Prosp']
+            if node.feats['VerbForm'] == 'Fin': # imperative, indicative or subjunctive
                 rf.extend(['Mood', 'Person', 'Number'])
+                af['Tense'].extend(['Past', 'Pqp'])
                 af['Mood'] = ['Ind', 'Sub', 'Imp']
                 af['Person'] = ['1', '2', '3']
                 af['Number'] = ['Sing', 'Plur']
-                if re.match(r'^(Ind|Sub)$', node.feats['Mood']): # indicative or subjunctive
-                    rf.extend(['Voice', 'Tense'])
-                    af['Voice'] = ['Act', 'Pass']
-                    af['Tense'] = ['Past', 'Imp', 'Pres', 'Fut']
             elif node.feats['VerbForm'] == 'Part':
-                rf.extend(['Tense', 'Gender', 'Number', 'Voice', 'Case'])
-                af['Tense'] = ['Past']
-                af['Voice'] = ['Act', 'Pass']
+                rf.extend(['Gender', 'Number', 'Case'])
                 af['Number'] = ['Sing', 'Plur']
                 af['Gender'] = ['Masc', 'Fem', 'Neut']
                 af['Case'] = ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
-                af['Degree'] = ['Abs']
-            elif node.feats['VerbForm'] == 'Vnoun':
-                rf.extend(['Tense', 'Voice'])
-                af['Tense'] = ['Past', 'Pres']
-                af['Voice'] = ['Act', 'Pass']
+                af['Degree'] = ['Abs', 'Cmp']
                 af['Gender'] = ['Masc', 'Fem', 'Neut']
-            # else: nothing to be added form VerbForm=Inf
+                af['Tense'].append('Past')
+            # else: nothing to be added for VerbForm=Inf
             if self.flavio:
                 # Flavio has killed Tense in his treebanks.
                 rf = [f for f in rf if f != 'Tense']
+                af['VerbForm'].append('Vnoun')
                 # Flavio added InflClass but not everywhere, so it is not required.
-                af['InflClass'] = ['LatA', 'LatAnom', 'LatE', 'LatI2', 'LatX']
-                if node.feats['VerbForm'] == 'Part':
+                af['InflClass'] = ['LatA', 'LatAnom', 'LatE', 'LatI', 'LatI2', 'LatX']
+                if 'Degree' in af:
+                    af['Degree'].append('Dim')
+                else:
+                    af['Degree'] = ['Dim']
+                af['Compound'] = ['Yes']
+                af['Proper'] = ['Yes']
+                if re.match(r'^(Part|Vnoun)$', node.feats['VerbForm']):
                     af['InflClass[nominal]'] = ['IndEurA', 'IndEurI', 'IndEurO']
+                af['VerbForm'].append('Vnoun')
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # ADVERBS ##############################################################
@@ -202,20 +238,43 @@ def process_node(self, node):
             af = {
                 'AdvType':  ['Loc', 'Tim'],
                 'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot', 'Con'],
-                'Degree':   ['Pos', 'Cmp', 'Sup', 'Abs']
+                'Degree':   ['Pos', 'Cmp', 'Sup', 'Abs'],
+                'Polarity': ['Neg']
             }
             if self.flavio:
-                af['Compound'] = 'Yes'
-                af['Form'] = 'Emp'
+                af['Compound'] = ['Yes']
+                af['Form'] = ['Emp']
+                af['NumType'] = ['Card', 'Ord'] # e.g., primum
+                af['VerbForm'] = ['Part']
+                af['Degree'].append('Dim')
             self.check_allowed_features(node, af)
         # PARTICLES ############################################################
         elif node.upos == 'PART':
             af = {
-                'PartType': ['Int'],
+                'PartType': ['Int', 'Emp'],
                 'Polarity': ['Neg']
             }
             if self.flavio:
-                af['Form'] = 'Emp'
+                af['Form'] = ['Emp']
+                af['PronType'] = ['Dem']
+            self.check_allowed_features(node, af)
+        # CONJUNCTIONS #########################################################
+        elif re.match(r'^[CS]CONJ$', node.upos):
+            af = {
+            'PronType': ['Rel', 'Con'],
+            'Polarity': ['Neg']}
+            if self.flavio:
+                af['Compound'] = ['Yes']
+                af['Form'] = ['Emp']
+                af['VerbForm'] = ['Fin']
+                af['NumType'] = ['Card']
+            self.check_allowed_features(node, af)
+        # ADPOSITIONS ##########################################################
+        elif node.upos == 'ADP':
+            if self.flavio:
+                af = {
+                'VerbForm': ['Part'],
+                'Proper': ['Yes']}
             self.check_allowed_features(node, af)
         # THE REST: NO FEATURES ################################################
         else:

From 3de5c225d9fc8e1a56922bd13b2feea8f4ca7bf4 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 6 Dec 2022 11:21:33 +0100
Subject: [PATCH 0730/1374] Usage: the new parameter merge=1 implemented by
 Martin.

---
 udapi/block/ud/cs/markfeatsbugs.py | 2 +-
 udapi/block/ud/la/markfeatsbugs.py | 2 +-
 udapi/block/ud/ml/markfeatsbugs.py | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 309e7ac8..30ee90b2 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -4,7 +4,7 @@
 used in filters and highlighted in text output.
 
 Usage: cat *.conllu | udapy -HAMX layout=compact ud.cs.MarkFeatsBugs > bugs.html
-Windows: python udapy read.Conllu files="a.conllu,b.conllu" ud.cs.MarkFeatsBugs write.TextModeTreesHtml files="bugs.html" marked_only=1 layout=compact attributes=form,lemma,upos,xpos,feats,deprel,misc
+Windows: python udapy read.Conllu files="a.conllu,b.conllu" merge=1 ud.cs.MarkFeatsBugs write.TextModeTreesHtml files="bugs.html" marked_only=1 layout=compact attributes=form,lemma,upos,xpos,feats,deprel,misc
 """
 import udapi.block.ud.markfeatsbugs
 import logging
diff --git a/udapi/block/ud/la/markfeatsbugs.py b/udapi/block/ud/la/markfeatsbugs.py
index 31d112b8..74a06a07 100644
--- a/udapi/block/ud/la/markfeatsbugs.py
+++ b/udapi/block/ud/la/markfeatsbugs.py
@@ -4,7 +4,7 @@
 used in filters and highlighted in text output.
 
 Usage: cat *.conllu | udapy -HAMX layout=compact ud.la.MarkFeatsBugs > bugs.html
-Windows: python udapy read.Conllu files="a.conllu,b.conllu" ud.la.MarkFeatsBugs write.TextModeTreesHtml files="bugs.html" marked_only=1 layout=compact attributes=form,lemma,upos,xpos,feats,deprel,misc
+Windows: python udapy read.Conllu files="a.conllu,b.conllu" merge=1 ud.la.MarkFeatsBugs write.TextModeTreesHtml files="bugs.html" marked_only=1 layout=compact attributes=form,lemma,upos,xpos,feats,deprel,misc
 """
 import udapi.block.ud.markfeatsbugs
 import logging
diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index 2372bd23..b286a27c 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -4,7 +4,7 @@
 used in filters and highlighted in text output.
 
 Usage: cat *.conllu | udapy -HAMX layout=compact ud.ml.MarkFeatsBugs > bugs.html
-Windows: python udapy read.Conllu files="a.conllu,b.conllu" ud.ml.MarkFeatsBugs write.TextModeTreesHtml files="bugs.html" marked_only=1 layout=compact attributes=form,lemma,upos,xpos,feats,deprel,misc
+Windows: python udapy read.Conllu files="a.conllu,b.conllu" merge=1 ud.ml.MarkFeatsBugs write.TextModeTreesHtml files="bugs.html" marked_only=1 layout=compact attributes=form,lemma,upos,xpos,feats,deprel,misc
 """
 import udapi.block.ud.markfeatsbugs
 import logging

From 1544c7474cdf91aa2f1c52b3566dedf11a127e5f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 14 Dec 2022 17:17:00 +0100
Subject: [PATCH 0731/1374] update for newer versions of termcolor and colorama

---
 requirements.txt                   | 2 +-
 udapi/block/write/textmodetrees.py | 9 +++++++--
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 647361f7..044d3af7 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,3 +1,3 @@
-colorama
+colorama>=0.4.6
 termcolor
 ufal.udpipe
diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index f3f6e007..41539670 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -1,4 +1,5 @@
 """An ASCII pretty printer of dependency trees."""
+import os
 import re
 import sys
 
@@ -344,8 +345,12 @@ def before_process_document(self, document):
         super().before_process_document(document)
         if self.color == 'auto':
             self.color = sys.stdout.isatty()
-            if self.color:
-                colorama.init()
+        if self.color:
+            colorama.just_fix_windows_console()
+            # termcolor since 2.1 also autodetects whether sys.stdout.isatty()
+            # and if not, it disables the colors, so `cat i.conllu | udapy -T | less -R"
+            # does not work. We need to turn off termcolor's autodetection with FORCE_COLOR.
+            os.environ["FORCE_COLOR"] = "1"
         if self.print_doc_meta:
             for key, value in sorted(document.meta.items()):
                 print('%s = %s' % (key, value))

From 9b0d20115a4dfea531519bf54f8fe5326ac77261 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 16 Dec 2022 23:03:43 +0100
Subject: [PATCH 0732/1374] read.Sentences newdoc_if_empty_line=1

---
 udapi/block/read/sentences.py | 14 ++++++++++++--
 udapi/core/document.py        |  2 +-
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/udapi/block/read/sentences.py b/udapi/block/read/sentences.py
index 356e196f..9b428331 100644
--- a/udapi/block/read/sentences.py
+++ b/udapi/block/read/sentences.py
@@ -9,6 +9,8 @@ class Sentences(BaseReader):
     Args:
     ignore_empty_lines: if True, delete empty lines from the input.
         Default=False.
+    newdoc_if_empty_line: if True, empty lines mark document boundaries,
+        which are marked with `root.newdoc`. Default=False.
     rstrip: a set of characters to be stripped from the end of each line.
         Default='\r\n '. You can use rstrip='\n' if you want to preserve
         any space or '\r' (Carriage Return) at end of line,
@@ -16,8 +18,12 @@ class Sentences(BaseReader):
         As most blocks do not expect whitespace other than a space to appear
         in the processed text, using this feature is at your own risk.
     """
-    def __init__(self, ignore_empty_lines=False, rstrip='\r\n ', **kwargs):
+    def __init__(self, ignore_empty_lines=False, newdoc_if_empty_line=False,
+                 rstrip='\r\n ', **kwargs):
+        if ignore_empty_lines and newdoc_if_empty_line:
+            raise ValueError("ignore_empty_lines is not compatible with newdoc_if_empty_line")
         self.ignore_empty_lines = ignore_empty_lines
+        self.newdoc_if_empty_line = newdoc_if_empty_line
         self.rstrip = rstrip
         super().__init__(**kwargs)
 
@@ -38,11 +44,15 @@ def read_tree(self, document=None):
         # (or '\r\n' if reading a Windows file on Unix machine).
         if line == '':
             return None
-        if self.ignore_empty_lines:
+        preceded_by_empty_line = False
+        if self.ignore_empty_lines or self.newdoc_if_empty_line:
             while line in {'\n', '\r\n'}:
+                preceded_by_empty_line = True
                 line = self.filehandle.readline()
                 if line == '':
                     return None
         root = Root()
         root.text = line.rstrip(self.rstrip)
+        if self.newdoc_if_empty_line and preceded_by_empty_line:
+            root.newdoc = True
         return root
diff --git a/udapi/core/document.py b/udapi/core/document.py
index dcf146ea..d6a84f0e 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -23,7 +23,7 @@ def __init__(self, filename=None, **kwargs):
             No pre-processing is applied, so when loading the document from a *.txt file,
             `Document("a.txt").nodes` will be empty and you need to run tokenization first.
             You can pass additional parameters for `udapi.block.read.sentences`
-            (`ignore_empty_lines` and `rstrip`).
+            (`ignore_empty_lines`, `newdoc_if_empty_line` and `rstrip`).
         """
         self.bundles = []
         self._highest_bundle_id = 0

From 83989865bf94f3ae9355364f05ac32aef84e8979 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 20 Dec 2022 11:12:47 +0100
Subject: [PATCH 0733/1374] bugfix

logging.warning takes multiple *args to be substituted for %s,
not a single argument, see
https://docs.python.org/3/library/logging.html#logging.debug

However, using f-strings seems to be less error-prone.
---
 udapi/block/read/conllu.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index d703fb26..7e59e2f9 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -73,7 +73,7 @@ def parse_comment_line(self, line, root):
         if entity_match is not None:
             global_entity = entity_match.group(1)
             if self._global_entity and self._global_entity != global_entity:
-                logging.warning("Mismatch in global.Entity: %s != %s", (self._global_entity, global_entity))
+                logging.warning(f"Mismatch in global.Entity: {self._global_entity} != {global_entity}")
             self._global_entity = global_entity
             root.comment += '$GLOBAL.ENTITY\n'
             return

From f93d4c92a64b9aad8bcdf1d2a8045bc6ae554cc5 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 9 Jan 2023 21:04:47 +0100
Subject: [PATCH 0734/1374] fix a bug preventing to load two conllu files into
 two zones

BaseReader calls
```
if self.zone != 'keep':
    root.zone = self.zone
```
so it supposes that root.sent_id will reflect the new zone.
Originally, `root.sent_id` was computed each time on the fly,
but after optimization it is cached in `root._sent_id`.
---
 udapi/core/root.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/udapi/core/root.py b/udapi/core/root.py
index 0132566a..6a5717a2 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -95,6 +95,12 @@ def zone(self, zone):
         if self._bundle:
             self._bundle.check_zone(zone)
         self._zone = zone
+        if self._bundle is not None:
+            self._sent_id = self._bundle.address() + '/' + zone
+        elif self._sent_id:
+            self._sent_id = self._sent_id.split('/', 1)[0] + '/' + zone
+        else:
+            self._sent_id = '?/' + zone
 
     @property
     def parent(self):

From 187a2b20139a60c0ca3ad8f08325b3851a695e86 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 9 Jan 2023 21:08:59 +0100
Subject: [PATCH 0735/1374] util.MarkDiff ignore_parent=1

sometimes we may not be interested in differences in the topology
---
 udapi/block/util/markdiff.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/udapi/block/util/markdiff.py b/udapi/block/util/markdiff.py
index 3d183f57..6c57ab36 100644
--- a/udapi/block/util/markdiff.py
+++ b/udapi/block/util/markdiff.py
@@ -9,7 +9,7 @@ class MarkDiff(Block):
     """Mark differences between parallel trees."""
 
     def __init__(self, gold_zone, attributes='form,lemma,upos,xpos,deprel,feats,misc',
-                 mark=1, add=False, print_stats=0, **kwargs):
+                 mark=1, add=False, print_stats=0, ignore_parent=False, **kwargs):
         """Create the Mark block object.
         Params:
         gold_zone: Which of the zones should be treated as gold?
@@ -20,6 +20,7 @@ def __init__(self, gold_zone, attributes='form,lemma,upos,xpos,deprel,feats,misc
         add: If False, node.misc attributes Mark, ToDo and Bug will be deleted before running this block,
             so that the marked_only option (e.g. via `udapy -TM`) prints only nodes marked by this block.
         print_stats: How many lines of statistics should be printed? -1 means all.
+        ignore_parent: ignore differences in dependency parents
         """
         super().__init__(**kwargs)
         self.gold_zone = gold_zone
@@ -27,6 +28,7 @@ def __init__(self, gold_zone, attributes='form,lemma,upos,xpos,deprel,feats,misc
         self.mark = mark
         self.add = add
         self.print_stats = print_stats
+        self.ignore_parent = ignore_parent
         self.stats = collections.Counter()
 
     def process_tree(self, tree):
@@ -60,7 +62,7 @@ def process_tree(self, tree):
             edit, pred_lo, pred_hi, gold_lo, gold_hi = diff
             if edit == 'equal':
                 for p_node, g_node in zip(pred_nodes[pred_lo:pred_hi], gold_nodes[gold_lo:gold_hi]):
-                    if alignment.get(p_node.parent.ord - 1) != g_node.parent.ord - 1:
+                    if not self.ignore_parent and alignment.get(p_node.parent.ord - 1) != g_node.parent.ord - 1:
                         p_node.misc['Mark'] = self.mark
                         g_node.misc['Mark'] = self.mark
                         self.stats['ONLY-PARENT-CHANGED'] += 1
@@ -76,7 +78,7 @@ def process_tree(self, tree):
                                 p_value, g_value = p_node._get_attr(attr), g_node._get_attr(attr)
                                 if p_value != g_value:
                                     self.stats[f'{attr.upper()}: {p_value} -> {g_value}'] += 1
-                            if alignment.get(p_node.parent.ord - 1) != g_node.parent.ord - 1:
+                            if not self.ignore_parent and alignment.get(p_node.parent.ord - 1) != g_node.parent.ord - 1:
                                 self.stats['PARENT-CHANGED'] += 1
                         pred_lo, gold_lo = pred_lo + n, gold_lo + n
                     for node in gold_nodes[gold_lo:gold_hi]:

From 2ad4922b5f9fe4196c5b67a00f42f45039f83c3a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 9 Jan 2023 21:09:42 +0100
Subject: [PATCH 0736/1374] write.TextModeTreesHtml prints zones side by side
 by default

---
 udapi/block/write/textmodetreeshtml.py | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/udapi/block/write/textmodetreeshtml.py b/udapi/block/write/textmodetreeshtml.py
index 9f9f6aa2..7fedc1b8 100644
--- a/udapi/block/write/textmodetreeshtml.py
+++ b/udapi/block/write/textmodetreeshtml.py
@@ -26,7 +26,7 @@ class TextModeTreesHtml(TextModeTrees):
     This block is a subclass of `TextModeTrees`, see its documentation for more info.
     """
 
-    def __init__(self, color=True, title='Udapi visualization', **kwargs):
+    def __init__(self, color=True, title='Udapi visualization', zones_in_rows=True, **kwargs):
         """Create new TextModeTreesHtml block object.
 
         Args: see `TextModeTrees`.
@@ -38,6 +38,7 @@ def __init__(self, color=True, title='Udapi visualization', **kwargs):
         """
         super().__init__(color=color, **kwargs)
         self.title = title
+        self.zones_in_rows = zones_in_rows
 
     def before_process_document(self, document):
         # TextModeTrees.before_process_document changes the color property,
@@ -82,3 +83,15 @@ def print_headers(self, root):
             print(escape(text))
         if self.print_comments and root.comment:
             print('#' + self.colorize_comment(escape(root.comment)).rstrip().replace('\n', '\n#'))
+
+    def process_bundle(self, bundle):
+        if self.zones_in_rows:
+            print("<table><tr>")
+            for tree in bundle:
+                if self._should_process_tree(tree):
+                    print("<td>")
+                    self.process_tree(tree)
+                    print("</td>")
+            print("</tr></table>")
+        else:
+            super().process_bundle(bundle)

From a49785d844e85771d499b3431cf8d8c9f3878307 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 9 Jan 2023 21:28:09 +0100
Subject: [PATCH 0737/1374] empty zone does not need a slash in sent_id

---
 udapi/core/root.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/udapi/core/root.py b/udapi/core/root.py
index 6a5717a2..3e6bf62b 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -95,12 +95,13 @@ def zone(self, zone):
         if self._bundle:
             self._bundle.check_zone(zone)
         self._zone = zone
+        slashzone = '/' + zone if zone else ''
         if self._bundle is not None:
-            self._sent_id = self._bundle.address() + '/' + zone
+            self._sent_id = self._bundle.address() + slashzone
         elif self._sent_id:
-            self._sent_id = self._sent_id.split('/', 1)[0] + '/' + zone
+            self._sent_id = self._sent_id.split('/', 1)[0] + slashzone
         else:
-            self._sent_id = '?/' + zone
+            self._sent_id = '?' + slashzone
 
     @property
     def parent(self):

From 5a7ccdc00b7466d1a1469fec9b2a0a63efce1880 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 11 Jan 2023 14:43:05 +0100
Subject: [PATCH 0738/1374] Case=Ben allowed in Malayalam.

---
 udapi/block/ud/ml/markfeatsbugs.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index b286a27c..47437e2a 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -19,7 +19,7 @@ def process_node(self, node):
             self.check_allowed_features(node, {
                 'Animacy': ['Anim', 'Inan'],
                 'Number': ['Sing', 'Plur'],
-                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp'],
+                'Case': ['Nom', 'Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp'],
                 'Foreign': ['Yes']})
         # ADJECTIVES ###########################################################
         elif node.upos == 'ADJ':
@@ -30,7 +30,7 @@ def process_node(self, node):
             rf = ['PronType', 'Case']
             af = {
                 'PronType': ['Prs', 'Int'], # demonstrative pronouns are treated as third person personal pronouns
-                'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
+                'Case': ['Nom', 'Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
             }
             if node.feats['PronType'] == 'Prs':
                 af['Reflex'] = ['Yes']
@@ -97,7 +97,7 @@ def process_node(self, node):
                     'NumType': ['Card'],
                     'NumForm': ['Word'],
                     'Number': ['Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
+                    'Case': ['Nom', 'Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
                 })
         # VERBS ################################################################
         elif node.upos == 'VERB':

From e9fe589322d5f6d03d318862bc93ec9eba26bd85 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 18 Jan 2023 12:49:10 +0100
Subject: [PATCH 0739/1374] Comment: link to the issue where "interleaved" is
 defined.

https://github.com/ufal/corefUD/issues/25
---
 udapi/block/corefud/fixinterleaved.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/udapi/block/corefud/fixinterleaved.py b/udapi/block/corefud/fixinterleaved.py
index c5a1b3ed..026b19f3 100644
--- a/udapi/block/corefud/fixinterleaved.py
+++ b/udapi/block/corefud/fixinterleaved.py
@@ -3,7 +3,9 @@
 import itertools
 
 class FixInterleaved(Block):
-    """Fix mentions with interleaved or crossing spans."""
+    """Fix mentions with interleaved or crossing spans.
+       https://github.com/ufal/corefUD/issues/25
+    """
 
     def __init__(self, same_entity_only=True, both_discontinuous=False,
                  crossing_only=False, nested_same_subspan=True, **kwargs):
@@ -58,8 +60,8 @@ def process_tree(self, tree):
                 pass
             deleted.add(mB)
 
-            # By changing the mA.words, we could have create another error:
-            # making the span same as another mention. Let's fix it
+            # By changing the mA.words, we could have created another error:
+            # making the span same as another mention. Let's fix it.
             sA = set(mA.words)
             for mC in mentions:
                 if mC in deleted or mC is mA or mC is mB:

From 6a9501b6522fca2fe4d38c2fcdf8946170ae69c4 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 25 Jan 2023 14:44:30 +0100
Subject: [PATCH 0740/1374] Updated feature checking for ml.

---
 udapi/block/ud/ml/markfeatsbugs.py | 68 +++++++++++++++++++++---------
 1 file changed, 47 insertions(+), 21 deletions(-)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index 47437e2a..54119030 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -19,18 +19,21 @@ def process_node(self, node):
             self.check_allowed_features(node, {
                 'Animacy': ['Anim', 'Inan'],
                 'Number': ['Sing', 'Plur'],
-                'Case': ['Nom', 'Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp'],
-                'Foreign': ['Yes']})
+                'Case': ['Nom', 'Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],
+                'Foreign': ['Yes'],
+                'Typo': ['Yes']})
         # ADJECTIVES ###########################################################
         elif node.upos == 'ADJ':
             self.check_allowed_features(node, {
-                'Foreign': ['Yes']})
+                'Foreign': ['Yes'],
+                'Typo': ['Yes']})
         # PRONOUNS #############################################################
         elif node.upos == 'PRON':
             rf = ['PronType', 'Case']
             af = {
                 'PronType': ['Prs', 'Int'], # demonstrative pronouns are treated as third person personal pronouns
-                'Case': ['Nom', 'Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
+                'Case': ['Nom', 'Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],
+                'Typo': ['Yes']
             }
             if node.feats['PronType'] == 'Prs':
                 af['Reflex'] = ['Yes']
@@ -74,13 +77,15 @@ def process_node(self, node):
                 self.check_required_features(node, ['PronType', 'Definite'])
                 self.check_allowed_features(node, {
                     'PronType': ['Art'],
-                    'Definite': ['Ind']
+                    'Definite': ['Ind'],
+                    'Typo': ['Yes']
                 })
             else:
                 self.check_required_features(node, ['PronType'])
                 self.check_allowed_features(node, {
                     'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot'],
-                    'Deixis': ['Prox', 'Remt']
+                    'Deixis': ['Prox', 'Remt'],
+                    'Typo': ['Yes']
                 })
         # NUMERALS #############################################################
         elif node.upos == 'NUM':
@@ -89,24 +94,27 @@ def process_node(self, node):
             if re.match(r'^(Digit|Roman)$', node.feats['NumForm']):
                 self.check_allowed_features(node, {
                     'NumType': ['Card'],
-                    'NumForm': ['Digit', 'Roman']
+                    'NumForm': ['Digit', 'Roman'],
+                    'Typo': ['Yes']
                 })
             else:
-                self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
+                self.check_required_features(node, ['NumType', 'NumForm', 'Case'])
                 self.check_allowed_features(node, {
                     'NumType': ['Card'],
                     'NumForm': ['Word'],
                     'Number': ['Plur'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp']
+                    'Case': ['Nom', 'Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],
+                    'Typo': ['Yes']
                 })
         # VERBS ################################################################
         elif node.upos == 'VERB':
-            self.check_required_features(node, ['VerbForm', 'Voice'])
+            self.check_required_features(node, ['VerbForm'])
             if node.feats['VerbForm'] == 'Inf':
                 self.check_allowed_features(node, {
                     'VerbForm': ['Inf'],
                     'Polarity': ['Pos', 'Neg'],
-                    'Voice': ['Act', 'Pass', 'Cau']
+                    'Voice': ['Act', 'Pass', 'Cau'],
+                    'Typo': ['Yes']
                 })
             elif node.feats['VerbForm'] == 'Fin':
                 if node.feats['Mood'] == 'Imp':
@@ -121,26 +129,39 @@ def process_node(self, node):
                         'Mood': ['Imp'],
                         'Polarity': ['Pos', 'Neg'],
                         'Voice': ['Act', 'Pass', 'Cau'],
-                        'Polite': ['Infm', 'Form']
+                        'Polite': ['Infm', 'Form'],
+                        'Typo': ['Yes']
+                    })
+                elif node.feats['Mood'] == 'Nec':
+                    self.check_required_features(node, ['Mood', 'Voice'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf', 'Prog'],
+                        'VerbForm': ['Fin'],
+                        'Mood': ['Nec'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Voice': ['Act', 'Pass', 'Cau'],
+                        'Typo': ['Yes']
                     })
                 else:
                     self.check_required_features(node, ['Mood', 'Tense', 'Voice'])
                     self.check_allowed_features(node, {
                         'Aspect': ['Imp', 'Perf', 'Prog'],
                         'VerbForm': ['Fin'],
-                        'Mood': ['Ind', 'Nec'],
+                        'Mood': ['Ind', 'Pot'],
                         'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
                         'Polarity': ['Pos', 'Neg'],
-                        'Voice': ['Act', 'Pass', 'Cau']
+                        'Voice': ['Act', 'Pass', 'Cau'],
+                        'Typo': ['Yes']
                     })
             elif node.feats['VerbForm'] == 'Part':
-                self.check_required_features(node, ['Tense', 'Voice'])
+                self.check_required_features(node, ['Tense'])
                 self.check_allowed_features(node, {
                     'Aspect': ['Imp', 'Perf', 'Prog'],
                     'VerbForm': ['Part'],
                     'Tense': ['Past'],
                     'Polarity': ['Pos', 'Neg'],
-                    'Voice': ['Act', 'Pass', 'Cau']
+                    'Voice': ['Act', 'Pass', 'Cau'],
+                    'Typo': ['Yes']
                 })
             else: # verbal noun
                 self.check_required_features(node, ['Tense', 'Voice'])
@@ -151,6 +172,7 @@ def process_node(self, node):
                     'Gender': ['Masc', 'Fem', 'Neut'],
                     'Polarity': ['Pos', 'Neg'],
                     'Voice': ['Act', 'Pass', 'Cau'],
+                    'Typo': ['Yes']
                 })
         # AUXILIARIES ##########################################################
         elif node.upos == 'AUX':
@@ -161,7 +183,8 @@ def process_node(self, node):
                     'Aspect': ['Imp', 'Perf', 'Prog'],
                     'VerbForm': ['Fin'],
                     'Mood': ['Imp'],
-                    'Polarity': ['Pos', 'Neg']
+                    'Polarity': ['Pos', 'Neg'],
+                    'Typo': ['Yes']
                 })
             else: # indicative or subjunctive
                 self.check_required_features(node, ['Mood', 'Tense'])
@@ -171,23 +194,26 @@ def process_node(self, node):
                     'Mood': ['Ind', 'Sub'],
                     'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
                     'Polarity': ['Pos', 'Neg']
+                    'Typo': ['Yes']
                 })
         # ADVERBS ##############################################################
         elif node.upos == 'ADV':
             if node.feats['PronType'] != '':
                 # Pronominal adverbs are neither compared nor negated.
                 self.check_allowed_features(node, {
-                    'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot']
+                    'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot'],
+                    'Typo': ['Yes']
                 })
             else:
                 # The remaining adverbs are neither pronominal, nor compared or
                 # negated.
-                self.check_allowed_features(node, {})
+                self.check_allowed_features(node, {'Typo': ['Yes']})
         # PARTICLES ############################################################
         elif node.upos == 'PART':
             self.check_allowed_features(node, {
-                'Polarity': ['Neg']
+                'Polarity': ['Neg'],
+                'Typo': ['Yes']
             })
         # THE REST: NO FEATURES ################################################
         else:
-            self.check_allowed_features(node, {})
+            self.check_allowed_features(node, {'Typo': ['Yes']})

From 448bba23b9aa90f8741efcd7565a516a7c84c85b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 25 Jan 2023 14:45:28 +0100
Subject: [PATCH 0741/1374] bug fix

---
 udapi/block/ud/ml/markfeatsbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index 54119030..4741d2fa 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -193,7 +193,7 @@ def process_node(self, node):
                     'VerbForm': ['Fin'],
                     'Mood': ['Ind', 'Sub'],
                     'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
-                    'Polarity': ['Pos', 'Neg']
+                    'Polarity': ['Pos', 'Neg'],
                     'Typo': ['Yes']
                 })
         # ADVERBS ##############################################################

From 7524bd5cdbe88661eb09eb46f88bc3de07f5716e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 25 Jan 2023 14:59:48 +0100
Subject: [PATCH 0742/1374] Updated feature checking for ml.

---
 udapi/block/ud/ml/markfeatsbugs.py | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index 4741d2fa..be084e22 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -25,6 +25,7 @@ def process_node(self, node):
         # ADJECTIVES ###########################################################
         elif node.upos == 'ADJ':
             self.check_allowed_features(node, {
+                'VerbForm': ['Part'],
                 'Foreign': ['Yes'],
                 'Typo': ['Yes']})
         # PRONOUNS #############################################################
@@ -66,9 +67,9 @@ def process_node(self, node):
             # ആരെ āre "who" (Acc) എന്തെ ente "what" (Acc.Anim) എന്തിനെ entine "what" (Acc.Anim or maybe Inan but optional)
             # ആരുടെ āruṭe "who" (Gen) എന്തിന് entin "what" (Gen) or "why"
             # ആരൊക്കെ ārokke "who" (Dat?) എന്തൊക്കെ entokke "what" (Dat?)
-            elif node.feats['PronType'] == 'Int':
-                rf.append('Animacy')
-                af['Animacy'] = ['Anim', 'Inan']
+            #elif node.feats['PronType'] == 'Int':
+            #    rf.append('Animacy')
+            #    af['Animacy'] = ['Anim', 'Inan']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # DETERMINERS ##########################################################
@@ -122,13 +123,12 @@ def process_node(self, node):
                     # The verb stem serves as an informal imperative: തുറ tuṟa "open"
                     # The citation form may serve as a formal imperative: തുറക്കുക tuṟakkūka "open"
                     # Finally, there is another formal imperative with -kkū: തുറക്കൂ tuṟakkū "open"
-                    self.check_required_features(node, ['Mood', 'Voice', 'Polite'])
+                    self.check_required_features(node, ['Mood', 'Polite'])
                     self.check_allowed_features(node, {
                         'Aspect': ['Imp', 'Perf', 'Prog'],
                         'VerbForm': ['Fin'],
                         'Mood': ['Imp'],
                         'Polarity': ['Pos', 'Neg'],
-                        'Voice': ['Act', 'Pass', 'Cau'],
                         'Polite': ['Infm', 'Form'],
                         'Typo': ['Yes']
                     })
@@ -164,7 +164,9 @@ def process_node(self, node):
                     'Typo': ['Yes']
                 })
             else: # verbal noun
-                self.check_required_features(node, ['Tense', 'Voice'])
+                # The "actual Malayalam verbal noun" (unlike the "nominalized form") does not inflect for Tense and Voice.
+                # Currently both forms are VerbForm=Vnoun.
+                #self.check_required_features(node, ['Tense', 'Voice'])
                 self.check_allowed_features(node, {
                     'Aspect': ['Imp', 'Perf', 'Prog'],
                     'VerbForm': ['Vnoun'],

From 0c0e0a257896741295c27661397e5d263aa8d1dc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 25 Jan 2023 15:12:49 +0100
Subject: [PATCH 0743/1374] AUX allows Vnoun.

---
 udapi/block/ud/ml/markfeatsbugs.py | 45 ++++++++++++++++++++----------
 1 file changed, 31 insertions(+), 14 deletions(-)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index be084e22..4f17c45f 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -174,28 +174,45 @@ def process_node(self, node):
                     'Gender': ['Masc', 'Fem', 'Neut'],
                     'Polarity': ['Pos', 'Neg'],
                     'Voice': ['Act', 'Pass', 'Cau'],
+                    # We only annotate case of verbal nouns if it is not Nom, i.e., there is an actual case suffix.
+                    'Case': ['Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],
                     'Typo': ['Yes']
                 })
         # AUXILIARIES ##########################################################
         elif node.upos == 'AUX':
             self.check_required_features(node, ['VerbForm'])
-            if node.feats['Mood'] == 'Imp':
-                self.check_required_features(node, ['Mood'])
-                self.check_allowed_features(node, {
-                    'Aspect': ['Imp', 'Perf', 'Prog'],
-                    'VerbForm': ['Fin'],
-                    'Mood': ['Imp'],
-                    'Polarity': ['Pos', 'Neg'],
-                    'Typo': ['Yes']
-                })
-            else: # indicative or subjunctive
-                self.check_required_features(node, ['Mood', 'Tense'])
+            if node.feats['VerbForm'] == 'Fin':
+                if node.feats['Mood'] == 'Imp':
+                    self.check_required_features(node, ['Mood'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf', 'Prog'],
+                        'VerbForm': ['Fin'],
+                        'Mood': ['Imp'],
+                        'Polarity': ['Pos', 'Neg'],
+                        'Typo': ['Yes']
+                    })
+                else: # indicative or subjunctive
+                    self.check_required_features(node, ['Mood', 'Tense'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf', 'Prog'],
+                        'VerbForm': ['Fin'],
+                        'Mood': ['Ind', 'Sub'],
+                        'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
+                        'Polarity': ['Pos', 'Neg'],
+                        'Typo': ['Yes']
+                    })
+            else: # verbal noun
+                # The "actual Malayalam verbal noun" (unlike the "nominalized form") does not inflect for Tense and Voice.
+                # Currently both forms are VerbForm=Vnoun.
+                #self.check_required_features(node, ['Tense', 'Voice'])
                 self.check_allowed_features(node, {
                     'Aspect': ['Imp', 'Perf', 'Prog'],
-                    'VerbForm': ['Fin'],
-                    'Mood': ['Ind', 'Sub'],
-                    'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
+                    'VerbForm': ['Vnoun'],
+                    'Tense': ['Past', 'Pres'],
+                    'Gender': ['Masc', 'Fem', 'Neut'],
                     'Polarity': ['Pos', 'Neg'],
+                    # We only annotate case of verbal nouns if it is not Nom, i.e., there is an actual case suffix.
+                    'Case': ['Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],
                     'Typo': ['Yes']
                 })
         # ADVERBS ##############################################################

From 94e7e85033515b101873c58e16a97dcd7b465dd9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 25 Jan 2023 15:15:41 +0100
Subject: [PATCH 0744/1374] Foreign VERB

---
 udapi/block/ud/ml/markfeatsbugs.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index 4f17c45f..2cb4f791 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -115,6 +115,7 @@ def process_node(self, node):
                     'VerbForm': ['Inf'],
                     'Polarity': ['Pos', 'Neg'],
                     'Voice': ['Act', 'Pass', 'Cau'],
+                    'Foreign': ['Yes'],
                     'Typo': ['Yes']
                 })
             elif node.feats['VerbForm'] == 'Fin':
@@ -130,6 +131,7 @@ def process_node(self, node):
                         'Mood': ['Imp'],
                         'Polarity': ['Pos', 'Neg'],
                         'Polite': ['Infm', 'Form'],
+                        'Foreign': ['Yes'],
                         'Typo': ['Yes']
                     })
                 elif node.feats['Mood'] == 'Nec':
@@ -140,6 +142,7 @@ def process_node(self, node):
                         'Mood': ['Nec'],
                         'Polarity': ['Pos', 'Neg'],
                         'Voice': ['Act', 'Pass', 'Cau'],
+                        'Foreign': ['Yes'],
                         'Typo': ['Yes']
                     })
                 else:
@@ -151,6 +154,7 @@ def process_node(self, node):
                         'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
                         'Polarity': ['Pos', 'Neg'],
                         'Voice': ['Act', 'Pass', 'Cau'],
+                        'Foreign': ['Yes'],
                         'Typo': ['Yes']
                     })
             elif node.feats['VerbForm'] == 'Part':
@@ -161,6 +165,7 @@ def process_node(self, node):
                     'Tense': ['Past'],
                     'Polarity': ['Pos', 'Neg'],
                     'Voice': ['Act', 'Pass', 'Cau'],
+                    'Foreign': ['Yes'],
                     'Typo': ['Yes']
                 })
             else: # verbal noun
@@ -176,6 +181,7 @@ def process_node(self, node):
                     'Voice': ['Act', 'Pass', 'Cau'],
                     # We only annotate case of verbal nouns if it is not Nom, i.e., there is an actual case suffix.
                     'Case': ['Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],
+                    'Foreign': ['Yes'],
                     'Typo': ['Yes']
                 })
         # AUXILIARIES ##########################################################

From e79bd16052f39cad08782315887df7849177ce3d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 25 Jan 2023 22:46:50 +0100
Subject: [PATCH 0745/1374] Conditional in Malayalam.

---
 udapi/block/ud/ml/markfeatsbugs.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index 2cb4f791..75552c36 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -32,7 +32,7 @@ def process_node(self, node):
         elif node.upos == 'PRON':
             rf = ['PronType', 'Case']
             af = {
-                'PronType': ['Prs', 'Int'], # demonstrative pronouns are treated as third person personal pronouns
+                'PronType': ['Prs', 'Int', 'Ind'], # demonstrative pronouns are treated as third person personal pronouns
                 'Case': ['Nom', 'Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],
                 'Typo': ['Yes']
             }
@@ -150,7 +150,7 @@ def process_node(self, node):
                     self.check_allowed_features(node, {
                         'Aspect': ['Imp', 'Perf', 'Prog'],
                         'VerbForm': ['Fin'],
-                        'Mood': ['Ind', 'Pot'],
+                        'Mood': ['Ind', 'Pot', 'Cnd'],
                         'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
                         'Polarity': ['Pos', 'Neg'],
                         'Voice': ['Act', 'Pass', 'Cau'],

From 337e7f6d159cf68bacb88529ea843c6c8b67a18d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 26 Jan 2023 00:05:13 +0100
Subject: [PATCH 0746/1374] Conditional in Malayalam.

---
 udapi/block/ud/ml/markfeatsbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index 75552c36..5ca2b4fb 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -202,7 +202,7 @@ def process_node(self, node):
                     self.check_allowed_features(node, {
                         'Aspect': ['Imp', 'Perf', 'Prog'],
                         'VerbForm': ['Fin'],
-                        'Mood': ['Ind', 'Sub'],
+                        'Mood': ['Ind', 'Sub', 'Cnd'],
                         'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
                         'Polarity': ['Pos', 'Neg'],
                         'Typo': ['Yes']

From b6600ea65e001d76ffbec656382384d60511d76c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 26 Jan 2023 00:07:40 +0100
Subject: [PATCH 0747/1374] Don't print empty tables if no trees will be
 printed in a given bundle

Fixes #110
---
 udapi/block/write/textmodetreeshtml.py | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/udapi/block/write/textmodetreeshtml.py b/udapi/block/write/textmodetreeshtml.py
index 7fedc1b8..5ccceb78 100644
--- a/udapi/block/write/textmodetreeshtml.py
+++ b/udapi/block/write/textmodetreeshtml.py
@@ -86,12 +86,22 @@ def print_headers(self, root):
 
     def process_bundle(self, bundle):
         if self.zones_in_rows:
-            print("<table><tr>")
+            # Don't print <table><tr></tr></table> if no tree will be printed in this bundle.
+            marked_trees = []
             for tree in bundle:
                 if self._should_process_tree(tree):
+                    if self.print_empty:
+                        allnodes = [tree] + tree.descendants_and_empty
+                    else:
+                        allnodes = tree.descendants(add_self=1)
+                if self.should_print_tree(tree, allnodes):
+                    marked_trees.append(tree)
+            if marked_trees:
+                print("<table><tr>")
+                for tree in marked_trees:
                     print("<td>")
                     self.process_tree(tree)
                     print("</td>")
-            print("</tr></table>")
+                print("</tr></table>")
         else:
             super().process_bundle(bundle)

From b8b68bf6474751dbf5ec7205ea40936c19c5aa73 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 26 Jan 2023 09:56:25 +0100
Subject: [PATCH 0748/1374] Do not check foreign words for Malayalam features.

---
 udapi/block/ud/ml/markfeatsbugs.py | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index 5ca2b4fb..12e2ef0f 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -13,8 +13,17 @@
 class MarkFeatsBugs(udapi.block.ud.markfeatsbugs.MarkFeatsBugs):
 
     def process_node(self, node):
+        # FOREIGN WORDS ########################################################
+        # Do not put any restrictions on words that have Foreign=Yes. These may
+        # also have Lang=xx in MISC, which would mean that the official
+        # validator would judge them by the rules for language [xx]. But even
+        # if they are not fully code-switched (e.g. because they are written in
+        # the Malayalam script, like the English verb പ്ലാന്റ് plānṟ "plant"),
+        # they still may not have the regular features of Malayalam morphology.
+        if node.feats['Foreign'] == 'Yes':
+            pass
         # NOUNS AND PROPER NOUNS ###############################################
-        if re.match(r'^(NOUN|PROPN)$', node.upos):
+        elif re.match(r'^(NOUN|PROPN)$', node.upos):
             self.check_required_features(node, ['Animacy', 'Number', 'Case'])
             self.check_allowed_features(node, {
                 'Animacy': ['Anim', 'Inan'],

From 1335522492d7c6cc528ab576dfb3142d4aac67e3 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 26 Jan 2023 21:59:37 +0100
Subject: [PATCH 0749/1374] improve definition of almost_forest in
 PrintMentions

---
 udapi/block/corefud/printmentions.py | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
index 7ed31b0d..12db433a 100644
--- a/udapi/block/corefud/printmentions.py
+++ b/udapi/block/corefud/printmentions.py
@@ -10,7 +10,7 @@ class PrintMentions(Block):
     def __init__(self, continuous='include', almost_continuous='include', treelet='include',
                  forest='include', almost_forest='include', oneword='include', singleton='include',
                  empty='include', max_trees=0, html=False, shuffle=True, print_other_forms=5,
-                 print_total=True,
+                 print_total=True, print_should=True,
                  print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
                  minimize_cross=True, color=True, attributes='form,upos,deprel',
                  print_undef_as='_', print_doc_meta=True, print_comments=False,
@@ -33,6 +33,7 @@ def __init__(self, continuous='include', almost_continuous='include', treelet='i
             random.seed(42)
         self.print_other_forms = print_other_forms
         self.print_total = print_total,
+        self.print_should = print_should,
         print_class = TextModeTreesHtml if html else TextModeTrees
         self.print_block = print_class(
                 print_sent_id=print_sent_id, print_text=print_text, add_empty_line=add_empty_line, indent=indent,
@@ -61,7 +62,9 @@ def _ok(self, condition, value):
         return (condition and value == 'only') or (not condition and value=='exclude')
 
     def _is_auxiliary_etc(self, node):
-        if node.udeprel in {'case', 'cc', 'punct', 'conj', 'mark', 'appos', 'vocative'}:
+        if node.udeprel in {'case', 'cc', 'conj', 'mark', 'appos', 'vocative', 'discourse'}:
+            return True
+        if node.deprel == 'advmod:emph':
             return True
         if node.udeprel == 'dep' and node.upos in {'ADP', 'SCONJ', 'CCONJ', 'PUNCT'}:
             return True
@@ -79,8 +82,25 @@ def _is_forest(self, mention, mwords, almost):
             for ch in w.children:
                 if ch not in mwords:
                     if not almost:
+                        if self.print_should:
+                            ch.misc["ShouldBeInSpanOf"] = mention.entity.eid
                         return False
+                    # Punctuation before or after the mention span can depend on any of the mwords
+                    # without breaking the almost_forest property.
+                    # According to the UD guidelines, it should depend on the highest node within the phrase,
+                    # i.e. on the mention head, but it is not our goal now to check UD punctuation guidelines.
+                    if ch.udeprel == 'punct' and (ch < mention.words[0] or ch > mention.words[-1]):
+                        continue
+                    # Some auxiliary words (e.g. prepositions) may be excluded from the mention span
+                    # without breaking the almost_forest property, but they need to depend
+                    # on the mention head (or if the mention is not a catena, they need to depend
+                    # on one of the potential heads, i.e. a node from mwords whose parent is not in mwords).
+                    # For example: "A gift for (e1 John)" is almost_forest ("for" depends on "John" which is the mention head),
+                    # but          "(e1[1/2] John) with (e1[2/2]) Mary" is not almost_forest
+                    # because "with" depends on "Mary", which is not the mention head (nor a potential mention head).
                     if not (w.parent and w.parent not in mwords and self._is_auxiliary_etc(ch)):
+                        if self.print_should:
+                            ch.misc["ShouldBeInSpanOf"] = mention.entity.eid
                         return False
         return True
 

From 0178372e381accb9c28795bcfff5f21366e48520 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 27 Jan 2023 22:49:12 +0100
Subject: [PATCH 0750/1374] Malayalam adpositions can have the Case feature.

---
 udapi/block/ud/ml/markfeatsbugs.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index 12e2ef0f..c2a8e0f4 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -242,6 +242,13 @@ def process_node(self, node):
                 # The remaining adverbs are neither pronominal, nor compared or
                 # negated.
                 self.check_allowed_features(node, {'Typo': ['Yes']})
+        # ADPOSITIONS ##########################################################
+        elif node.upos == 'ADP':
+            self.check_allowed_features(node, {
+                # Case suffixes after numbers are separate tokens, they are attached
+                # via the 'case' relation and they bear the Case feature (the number does not).
+                'Case': ['Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],
+                'Typo': ['Yes']})
         # PARTICLES ############################################################
         elif node.upos == 'PART':
             self.check_allowed_features(node, {

From c3da386bf36609774e34464899a048700631b4b9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 28 Jan 2023 11:08:43 +0100
Subject: [PATCH 0751/1374] ud.SetTranslation (e.g. lines from Google
 Translate)

---
 udapi/block/ud/settranslation.py | 59 ++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 udapi/block/ud/settranslation.py

diff --git a/udapi/block/ud/settranslation.py b/udapi/block/ud/settranslation.py
new file mode 100644
index 00000000..487cca06
--- /dev/null
+++ b/udapi/block/ud/settranslation.py
@@ -0,0 +1,59 @@
+"""
+Block SetTranslation for setting of sentence-level translation (the attribute
+text_en for English translation) from a separate text file (one sentence per
+line). For example, one can export the original sentences using write.SentencesHtml,
+then Google-translate them in the web browser, then CTRL+C CTRL+V to a plain
+text editor, save them as translations.txt and import them using this block.
+
+Usage:
+udapy -s ud.SetTranslation file=translations.txt < in.conllu > out.conllu
+
+Author: Dan Zeman
+"""
+from udapi.core.block import Block
+import re
+import logging
+
+class SetTranslation(Block):
+    """
+    Set text_en to the next available translation.
+    """
+
+    def __init__(self, file, overwrite=False, **kwargs):
+        """
+        Create the SetTranslation block.
+
+        Parameters:
+        file: the name of the text file with the translations (one sentence per line)
+        overwrite=1: set the translation even if the sentence already has one
+            (default: do not overwrite existing translations)
+        """
+        super().__init__(**kwargs)
+        self.file = file
+        fh = open(self.file, 'r', encoding='utf-8')
+        self.trlines = fh.readlines()
+        self.nlines = len(self.trlines)
+        self.iline = 0
+        self.overwrite = overwrite
+
+    def process_tree(self, tree):
+        if self.iline < self.nlines:
+            translation = self.trlines[self.iline]
+            self.iline += 1
+            comments = []
+            if tree.comment:
+                comments = tree.comment.split('\n')
+            i_tr = -1
+            for i in range(len(comments)):
+                # The initial '#' character has been stripped.
+                if re.match(r'\s*text_en\s*=', comments[i]):
+                    i_tr = i
+                    break
+            if i_tr >= 0:
+                if self.overwrite:
+                    comments[i_tr] = ' text_en = ' + translation
+            else:
+                comments.append(' text_en = ' + translation)
+            tree.comment = '\n'.join(comments)
+        elif self.iline == self.nlines:
+            logging.warning('There are only %d translation lines but there are more input sentences.' % self.nlines)

From a75ab8d8bd9754b776911c41977fbcacdcf3b521 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 30 Jan 2023 00:52:29 +0100
Subject: [PATCH 0752/1374] first draft of a coreference-visualization writer

---
 udapi/block/write/corefhtml.py | 123 +++++++++++++++++++++++++++++++++
 1 file changed, 123 insertions(+)
 create mode 100644 udapi/block/write/corefhtml.py

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
new file mode 100644
index 00000000..fc49dfb4
--- /dev/null
+++ b/udapi/block/write/corefhtml.py
@@ -0,0 +1,123 @@
+"""CorefHtml class is a writer for HTML+JavaScript visualization of coreference."""
+from udapi.core.basewriter import BaseWriter
+from udapi.core.coref import span_to_nodes, CorefEntity, CorefMention
+
+ETYPES = 'person place organization animal plant object substance time number abstract event'.split()
+
+class CorefHtml(BaseWriter):
+
+    def __init__(self, path_to_js='web', **kwargs):
+        super().__init__(**kwargs)
+        self.path_to_js = path_to_js
+
+    def process_document(self, doc):
+        print('<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8">')
+        print('<title>Udapi CorefUD viewer</title>')
+        print('<script src="https://code.jquery.com/jquery-3.6.3.min.js"></script>')
+        #print('<script src="coref.js"></script>') #$(window).on("load", function() {...}
+        #print('<link rel="stylesheet" href="coref.css">')
+        print('<style>\n'
+              'span {border: 1px solid black; border-radius: 5px; padding: 2px; display:inline-block;}\n'
+              '.empty {color: gray;}\n'
+              '.singleton {color: rgb(0,0,100);}\n'
+              '.selected {background: red !important;}\n'
+              '.other{ background: hsl(0, 0%, 85%);}')
+        for i, etype in enumerate(ETYPES):
+            print(f'.{etype}{{background: hsl({int(i * 360/len(ETYPES))}, 80%, 85%);}}')
+        print('</style>')
+        print('</head>\n<body>')
+
+        for tree in doc.trees:
+            self.process_tree(tree)
+
+        print('<script>\n$("span").click(function(e) {\n'
+              ' let was_selected = $(this).hasClass("selected");\n'
+              ' $("span").removeClass("selected");\n'
+              ' if (!was_selected){$("."+$(this).attr("class").split(" ")[0]).addClass("selected");}\n'
+              ' e.stopPropagation();\n});\n</script>')
+        print('</body></html>')
+
+    def process_tree(self, tree):
+        mentions = set()
+        nodes_and_empty = tree.descendants_and_empty
+        for node in nodes_and_empty:
+            for m in node.coref_mentions:
+                mentions.add(m)
+
+        sent_mentions = []
+        for mention in mentions:
+            mspan = mention.span
+            if ',' not in mspan:
+                sent_mentions.append(mention)
+            else:
+                entity = mention.entity
+                head_str = str(mention.words.index(mention.head) + 1)
+                subspans = mspan.split(',')
+                for idx,subspan in enumerate(subspans, 1):
+                    subspan_eid = f'{entity.eid}[{idx}/{len(subspans)}]'
+                    subspan_words = span_to_nodes(tree, subspan)
+                    fake_entity = CorefEntity(subspan_eid, entity.etype)
+                    fake_mention = CorefMention(subspan_words, head_str, fake_entity, add_word_backlinks=False)
+                    if mention._other:
+                        fake_mention._other = mention._other
+                    if mention._bridging and idx == 1:
+                        fake_mention._bridging = mention._bridging
+                    sent_mentions.append(fake_mention)
+        sent_mentions.sort(reverse=True)
+
+        opened = []
+        print('<p>')
+        for node in nodes_and_empty:
+            while sent_mentions and sent_mentions[-1].words[0] == node:
+                m = sent_mentions.pop()
+                e = m.entity
+                classes = f'{e.eid} {e.etype or "other"}'
+                if all(w.is_empty() for w in m.words):
+                    classes += ' empty'
+                if len(e.mentions) == 1:
+                    classes += ' singleton'
+                title = f'eid={e.eid}\ntype={e.etype}\nhead={m.head.form}'
+                print(f'<span class="{classes}" data-eid="{e.eid}" title="{title}"', end='')
+                if m.other:
+                    print(f'\n{m.other}', end='')
+                print('">', end='')
+                opened.append(m)
+            
+            is_head = self._is_head(node)
+            if is_head:
+                print('<b>', end='')
+            if node.is_empty():
+                print('<i>', end='')
+            print(node.form, end='')
+            if node.is_empty():
+                print('</i>', end='')
+            if is_head:
+                print('</b>', end='')
+            
+            while opened and opened[-1].words[-1] == node:
+                print('</span>', end='')
+                opened.pop()
+
+            if not node.no_space_after:
+                print(' ', end='')
+                
+        print('</p>')
+
+    def _is_head(self, node):
+        for mention in node.coref_mentions:
+            if mention.head == node:
+                return mention
+        return None
+
+# id needs to be a valid DOM querySelector
+# so it cannot contain # nor / and it cannot start with a digit
+def _id(node):
+    if node is None:
+        return 'null'
+    return '"n%s"' % node.address().replace('#', '-').replace('/', '-')
+
+
+def _esc(string):
+    if string is None:
+        string = ''
+    return string.replace('\\', '\\\\').replace('"', r'\"')

From e3ae1c3fb65fa62431e23c2bfff9d8534d458019 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 30 Jan 2023 13:25:49 +0100
Subject: [PATCH 0753/1374] fix visualization of discontinuous mentions

introduce CorefMentionSubspan instead of fake mentions
(should be used also in store_coref_to_misc() in future)
---
 udapi/block/write/corefhtml.py | 40 +++++++++++-----------------------
 udapi/core/coref.py            | 39 ++++++++++++++++++++++++++++++++-
 2 files changed, 51 insertions(+), 28 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index fc49dfb4..890b172a 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -44,44 +44,30 @@ def process_tree(self, tree):
             for m in node.coref_mentions:
                 mentions.add(m)
 
-        sent_mentions = []
+        subspans = []
         for mention in mentions:
-            mspan = mention.span
-            if ',' not in mspan:
-                sent_mentions.append(mention)
-            else:
-                entity = mention.entity
-                head_str = str(mention.words.index(mention.head) + 1)
-                subspans = mspan.split(',')
-                for idx,subspan in enumerate(subspans, 1):
-                    subspan_eid = f'{entity.eid}[{idx}/{len(subspans)}]'
-                    subspan_words = span_to_nodes(tree, subspan)
-                    fake_entity = CorefEntity(subspan_eid, entity.etype)
-                    fake_mention = CorefMention(subspan_words, head_str, fake_entity, add_word_backlinks=False)
-                    if mention._other:
-                        fake_mention._other = mention._other
-                    if mention._bridging and idx == 1:
-                        fake_mention._bridging = mention._bridging
-                    sent_mentions.append(fake_mention)
-        sent_mentions.sort(reverse=True)
+            subspans.extend(mention._subspans())
+        subspans.sort(reverse=True)
 
         opened = []
         print('<p>')
         for node in nodes_and_empty:
-            while sent_mentions and sent_mentions[-1].words[0] == node:
-                m = sent_mentions.pop()
+            while subspans and subspans[-1].words[0] == node:
+                subspan = subspans.pop()
+                m = subspan.mention
                 e = m.entity
                 classes = f'{e.eid} {e.etype or "other"}'
-                if all(w.is_empty() for w in m.words):
+                if all(w.is_empty() for w in subspan.words):
                     classes += ' empty'
                 if len(e.mentions) == 1:
                     classes += ' singleton'
-                title = f'eid={e.eid}\ntype={e.etype}\nhead={m.head.form}'
-                print(f'<span class="{classes}" data-eid="{e.eid}" title="{title}"', end='')
+
+                title = f'eid={subspan.subspan_eid}\ntype={e.etype}\nhead={m.head.form}'
                 if m.other:
-                    print(f'\n{m.other}', end='')
-                print('">', end='')
-                opened.append(m)
+                    title += f'\n{m.other}'
+                print(f'<span class="{classes}" title="{title}">', end='') #data-eid="{e.eid}"
+
+                opened.append(subspan)
             
             is_head = self._is_head(node)
             if is_head:
diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 3eb76db3..1a6d1f95 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -128,6 +128,17 @@ def __init__(self, words, head=None, entity=None, add_word_backlinks=True):
                     new_word._mentions.append(self)
                     new_word._mentions.sort()
 
+    def _subspans(self):
+        mspan = self.span
+        if ',' not in mspan:
+            return [CorefMentionSubspan(self._words, self, '')]
+        root = self._words[0].root
+        subspans = mspan.split(',')
+        result = []
+        for idx,subspan in enumerate(subspans, 1):
+            result.append(CorefMentionSubspan(span_to_nodes(root, subspan), self, f'[{idx}/{len(subspans)}]'))
+        return result
+
     def __lt__(self, another):
         """Does this mention precedes (word-order wise) `another` mention?
 
@@ -247,6 +258,32 @@ def span(self, new_span):
         self.words = span_to_nodes(self._head.root, new_span)
 
 
+@functools.total_ordering
+class CorefMentionSubspan(object):
+    """Helper class for representing a continuous subspan of a mention."""
+    __slots__ = ['words', 'mention', 'subspan_id']
+
+    def __init__(self, words, mention, subspan_id):
+        if not words:
+            raise ValueError("mention.words must be non-empty")
+        self.words = sorted(words)
+        self.mention = mention
+        self.subspan_id = subspan_id
+
+    def __lt__(self, another):
+        if self.words[0] is another.words[0]:
+            if len(self.words) > len(another.words):
+                return True
+            if  len(self.words) < len(another.words):
+                return False
+            assert False
+        return self.words[0].precedes(another.words[0])
+
+    @property
+    def subspan_eid(self):
+        return self.mention._entity.eid + self.subspan_id
+
+
 CHARS_FORBIDDEN_IN_ID = "-=| \t()"
 
 
@@ -886,7 +923,7 @@ def nodes_to_span(nodes):
     Note that empty nodes may form gaps in the span, so if a given tree contains
     an empty node with ord 5.1, but only nodes with ords 3, 4, 5, 6, 7.1 and 7.2
     are provided as `nodes`, the resulting string will be "3-5,6,7.1-7.2".
-    This means that the implementation needs to iterate of all nodes
+    This means that the implementation needs to iterate over all nodes
     in a given tree (root.descendants_and_empty) to check for such gaps.
     """
     if not nodes:

From b78ef7eea0b76c4f41f8408d918092681d9c5fad Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 30 Jan 2023 14:16:46 +0100
Subject: [PATCH 0754/1374] util.Normalize: sort attributes in FEATS and MISC

---
 udapi/block/util/normalize.py | 40 +++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 udapi/block/util/normalize.py

diff --git a/udapi/block/util/normalize.py b/udapi/block/util/normalize.py
new file mode 100644
index 00000000..5b4270cc
--- /dev/null
+++ b/udapi/block/util/normalize.py
@@ -0,0 +1,40 @@
+"""util.Normalize normalizes the ordering of various attributes in CoNLL-U."""
+from udapi.core.block import Block
+
+class Normalize(Block):
+    """Normalize the ordering of attributes in the FEATS and MISC columns.
+    
+    The attribute-value pairs in the FEATS column in CoNLL-U files
+    must be sorted alphabetically (case-insensitive) according to the guidelines
+    (https://universaldependencies.org/format.html#morphological-annotation).
+    The same is highly recommended for the MISC column.
+    It is useful e.g. for comparing two conllu files with diff.
+
+    Udapi does the sorting automatically, but for speed reasons
+    only when writing into these attributes.
+    This block thus just forces deserialization of node.feats and node.misc,
+    so that the Udapi later sorts the attributes during serialization.
+    It is a bit more efficient than something like
+    util.Eval node='node.feats["Number"] = node.feats["Number"]'
+    or
+    util.Eval node='node.misc["NonExistentAttribute"] = None'
+    """
+
+    def __init__(self, feats=True, misc=True, **kwargs):
+        """
+        Args:
+        `feats`: normalize the ordering of FEATS. Default=True.
+        `misc`: normalize the ordering of MISC. Default=True.
+        """
+        super().__init__(**kwargs)
+        self.feats = feats
+        self.misc = misc
+        # TODO: normalize also standardized comments like text, sent_id,...
+
+    def process_node(self, node):
+        if self.feats:
+            node.feats._deserialize_if_empty()
+            node.feats._string = None
+        if self.misc:
+            node.misc._deserialize_if_empty()
+            node.misc._string = None

From 90f338de077467acb4cb9ebebce68179419a0d77 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 30 Jan 2023 14:29:30 +0100
Subject: [PATCH 0755/1374] allow writing to node.sdeprel, add tests

---
 udapi/core/node.py            |  8 ++++++++
 udapi/core/tests/test_node.py | 25 ++++++++++++++++++++++++-
 2 files changed, 32 insertions(+), 1 deletion(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 63242698..e188e134 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -166,6 +166,14 @@ def sdeprel(self):
             return parts[1]
         return ''
 
+    @sdeprel.setter
+    def sdeprel(self, value):
+        udeprel = self.udeprel
+        if value is not None and value != '':
+            self.deprel = udeprel + ':' + value
+        else:
+            self.deprel = udeprel
+
     @property
     def feats(self):
         """Property for morphological features stored as a `Feats` object.
diff --git a/udapi/core/tests/test_node.py b/udapi/core/tests/test_node.py
index 28a45d85..8bc7f182 100755
--- a/udapi/core/tests/test_node.py
+++ b/udapi/core/tests/test_node.py
@@ -119,7 +119,7 @@ def test_draw(self):
             sys.stdout = sys.__stdout__  # pylint: disable=redefined-variable-type
 
     def test_feats(self):
-        """Test the morphological featrues."""
+        """Test the morphological features."""
         node = Node(root=None)
         self.assertEqual(str(node.feats), '_')
         node.feats = ''
@@ -145,6 +145,29 @@ def test_feats(self):
         self.assertEqual(str(node.feats), '_')
         self.assertEqual(node.feats, {})
 
+    def test_deprel(self):
+        """Test getting setting the dependency relation."""
+        node = Node(root=None, deprel='acl:relcl')
+        self.assertEqual(node.deprel, 'acl:relcl')
+        self.assertEqual(node.udeprel, 'acl')
+        self.assertEqual(node.sdeprel, 'relcl')
+        node.udeprel = 'advcl'
+        self.assertEqual(node.deprel, 'advcl:relcl')
+        node.sdeprel = 'tcl'
+        self.assertEqual(node.deprel, 'advcl:tcl')
+        node.sdeprel = ''
+        self.assertEqual(node.deprel, 'advcl')
+        self.assertEqual(node.udeprel, 'advcl')
+        self.assertEqual(node.sdeprel, '')
+        node.udeprel = 'nsubj'
+        self.assertEqual(node.deprel, 'nsubj')
+        self.assertEqual(node.udeprel, 'nsubj')
+        self.assertEqual(node.sdeprel, '')
+        node.udeprel = 'nsubj:pass:outer'
+        self.assertEqual(node.deprel, 'nsubj:pass:outer')
+        self.assertEqual(node.udeprel, 'nsubj')
+        self.assertEqual(node.sdeprel, 'pass:outer')
+
     def test_deps_getter(self):
         """Test enhanced dependencies."""
         # Create a path to the test CoNLLU file.

From 5817af214df034e42cf09ef2c08f0c8d15b3a0d9 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 30 Jan 2023 16:31:50 +0100
Subject: [PATCH 0756/1374] write.CorefHtml marks subspans of discontiuous
 mentions with a red border

---
 udapi/block/write/corefhtml.py | 26 +++++++++++++++++---------
 1 file changed, 17 insertions(+), 9 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index 890b172a..e0ab830b 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -18,26 +18,34 @@ def process_document(self, doc):
         #print('<link rel="stylesheet" href="coref.css">')
         print('<style>\n'
               'span {border: 1px solid black; border-radius: 5px; padding: 2px; display:inline-block;}\n'
-              '.empty {color: gray;}\n'
-              '.singleton {color: rgb(0,0,100);}\n'
-              '.selected {background: red !important;}\n'
-              '.other{ background: hsl(0, 0%, 85%);}')
+              '.empty {color: gray;}\n.singleton {color: rgb(0,0,100);}\n'
+              '.active {border: 1px solid red;}\n.selected {background: red !important;}\n'
+              '.other {background: hsl(0, 0%, 85%);}')
         for i, etype in enumerate(ETYPES):
-            print(f'.{etype}{{background: hsl({int(i * 360/len(ETYPES))}, 80%, 85%);}}')
+            print(f'.{etype} {{background: hsl({int(i * 360/len(ETYPES))}, 80%, 85%);}}')
         print('</style>')
         print('</head>\n<body>')
 
+        mention_ids = {}
+        for entity in doc.coref_entities:
+            for idx, mention in enumerate(entity.mentions, 1):
+                mention_ids[mention] = f'{entity.eid}e{idx}'
+
         for tree in doc.trees:
-            self.process_tree(tree)
+            self.process_tree(tree, mention_ids)
 
         print('<script>\n$("span").click(function(e) {\n'
               ' let was_selected = $(this).hasClass("selected");\n'
               ' $("span").removeClass("selected");\n'
               ' if (!was_selected){$("."+$(this).attr("class").split(" ")[0]).addClass("selected");}\n'
-              ' e.stopPropagation();\n});\n</script>')
+              ' e.stopPropagation();\n});\n'
+              '$("span").hover(\n'
+              ' function(e) {$("span").removeClass("active"); $("."+$(this).attr("class").split(" ")[1]).addClass("active");},\n'
+              ' function(e) {$("span").removeClass("active");}\n'
+              ');\n</script>')
         print('</body></html>')
 
-    def process_tree(self, tree):
+    def process_tree(self, tree, mention_ids):
         mentions = set()
         nodes_and_empty = tree.descendants_and_empty
         for node in nodes_and_empty:
@@ -56,7 +64,7 @@ def process_tree(self, tree):
                 subspan = subspans.pop()
                 m = subspan.mention
                 e = m.entity
-                classes = f'{e.eid} {e.etype or "other"}'
+                classes = f'{e.eid} {mention_ids[m]} {e.etype or "other"}'
                 if all(w.is_empty() for w in subspan.words):
                     classes += ' empty'
                 if len(e.mentions) == 1:

From 355e7bdc32ab854827aff1f7277b069f5c5a8bc0 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 30 Jan 2023 17:57:48 +0100
Subject: [PATCH 0757/1374] write.CorefHtml shows also crossing mentions

using valid (well-nested) html
---
 udapi/block/write/corefhtml.py | 56 +++++++++++++++++++++++++---------
 1 file changed, 42 insertions(+), 14 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index e0ab830b..3efe9793 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -18,7 +18,8 @@ def process_document(self, doc):
         #print('<link rel="stylesheet" href="coref.css">')
         print('<style>\n'
               'span {border: 1px solid black; border-radius: 5px; padding: 2px; display:inline-block;}\n'
-              '.empty {color: gray;}\n.singleton {color: rgb(0,0,100);}\n'
+              '.empty {color: gray;}\n.singleton {border-style: dotted;}\n'
+              '.crossing:before {content: "!"; display: block; background: #ffd500;}\n'
               '.active {border: 1px solid red;}\n.selected {background: red !important;}\n'
               '.other {background: hsl(0, 0%, 85%);}')
         for i, etype in enumerate(ETYPES):
@@ -45,6 +46,22 @@ def process_document(self, doc):
               ');\n</script>')
         print('</body></html>')
 
+    def _start_subspan(self, subspan, mention_ids, crossing=False):
+        m = subspan.mention
+        e = m.entity
+        classes = f'{e.eid} {mention_ids[m]} {e.etype or "other"}'
+        title = f'eid={subspan.subspan_eid}\ntype={e.etype}\nhead={m.head.form}'
+        if all(w.is_empty() for w in subspan.words):
+            classes += ' empty'
+        if len(e.mentions) == 1:
+            classes += ' singleton'
+        if crossing:
+            classes += ' crossing'
+            title += '\ncrossing'
+        if m.other:
+            title += f'\n{m.other}'
+        print(f'<span class="{classes}" title="{title}">', end='') #data-eid="{e.eid}"
+
     def process_tree(self, tree, mention_ids):
         mentions = set()
         nodes_and_empty = tree.descendants_and_empty
@@ -62,19 +79,7 @@ def process_tree(self, tree, mention_ids):
         for node in nodes_and_empty:
             while subspans and subspans[-1].words[0] == node:
                 subspan = subspans.pop()
-                m = subspan.mention
-                e = m.entity
-                classes = f'{e.eid} {mention_ids[m]} {e.etype or "other"}'
-                if all(w.is_empty() for w in subspan.words):
-                    classes += ' empty'
-                if len(e.mentions) == 1:
-                    classes += ' singleton'
-
-                title = f'eid={subspan.subspan_eid}\ntype={e.etype}\nhead={m.head.form}'
-                if m.other:
-                    title += f'\n{m.other}'
-                print(f'<span class="{classes}" title="{title}">', end='') #data-eid="{e.eid}"
-
+                self._start_subspan(subspan, mention_ids)
                 opened.append(subspan)
             
             is_head = self._is_head(node)
@@ -92,6 +97,29 @@ def process_tree(self, tree, mention_ids):
                 print('</span>', end='')
                 opened.pop()
 
+            # Two mentions are crossing iff their spans have non-zero intersection,
+            # but neither is a subset of the other, e.g. (e1 ... (e2 ... e1) ... e2).
+            # Let's visualize this (simplified) as
+            # <span class=e1>...<span class=e2>...</span></span><span class="e2 crossing">...</span>
+            # i.e. let's split mention e2 into two subspans which are next to each other.
+            # Unfortunatelly, we cannot mark now both crossing mentions using html class "crossing"
+            # (opening tags are already printed), so we'll mark only the second part of the second mention.
+            endings = [x for x in opened if x.words[-1] == node]
+            if endings:
+                new_opened, brokens, found_crossing = [], [], False
+                for subspan in opened:
+                    if subspan.words[-1] == node:
+                        found_crossing = True
+                    elif found_crossing:
+                        brokens.append(subspan)
+                    else:
+                        new_opened.append(subspan)
+                opened = new_opened
+                print('</span>' * (len(endings) + len(brokens)), end='')
+                for broken in brokens:
+                    self._start_subspan(broken, mention_ids, True)
+                    opened.append(subspan)
+
             if not node.no_space_after:
                 print(' ', end='')
                 

From fc8d1cef7f705b6d0c24d2cc73a44d54e66ce7f0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Barbora=20Dohnalov=C3=A1?= <barca.dohnalova@seznam.cz>
Date: Mon, 30 Jan 2023 19:01:41 +0100
Subject: [PATCH 0758/1374] add try catch block

---
 udapi/block/read/conllu.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 7e59e2f9..bba69696 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -193,7 +193,11 @@ def read_tree_from_lines(self, lines):
 
         # Create multi-word tokens.
         for fields in mwts:
-            range_start, range_end = fields[0].split('-')
+            try:
+                range_start, range_end = fields[0].split('-')
+            except ValueError:
+                logging.warning(f"Wrong MWT range in\n{fields[0]}\n\n{lines}")
+                raise
             words = nodes[int(range_start):int(range_end) + 1]
             root.create_multiword_token(words, form=fields[1], misc=fields[-1])
 

From 310e4c29a4f44a856ca947a2330f64815f0c061b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 31 Jan 2023 17:16:35 +0100
Subject: [PATCH 0759/1374] fix a bug when newly created trees had sent_id =
 "?"

---
 udapi/core/bundle.py              |  4 ++--
 udapi/core/tests/test_document.py | 13 ++++++++-----
 2 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/udapi/core/bundle.py b/udapi/core/bundle.py
index 110ed42c..26a06741 100644
--- a/udapi/core/bundle.py
+++ b/udapi/core/bundle.py
@@ -72,7 +72,7 @@ def has_tree(self, zone=''):
     def create_tree(self, zone=None):
         """Return the root of a newly added tree with a given zone."""
         root = Root()
-        root.zone = zone
+        root._zone = zone
         self.add_tree(root)
         return root
 
@@ -89,7 +89,7 @@ def check_zone(self, new_zone):
     def add_tree(self, root):
         """Add an existing tree to the bundle."""
         if root.zone is None:
-            root.zone = ''
+            root._zone = ''
         self.check_zone(root.zone)
         root.bundle = self
         self.trees.append(root)
diff --git a/udapi/core/tests/test_document.py b/udapi/core/tests/test_document.py
index 66363ca9..28283dda 100755
--- a/udapi/core/tests/test_document.py
+++ b/udapi/core/tests/test_document.py
@@ -9,12 +9,15 @@ class TestDocument(unittest.TestCase):
     def test_init(self):
         doc = Document()
 
-    def test_iterator(self):
+    def test_ids(self):
         doc = Document()
-        doc.bundles = ['a', 'b', 'c']
-        for bundle in doc:
-            print(bundle)
-
+        bundle1 = doc.create_bundle()
+        bundle2 = doc.create_bundle()
+        self.assertEqual(bundle1.address(), "1")
+        self.assertEqual(bundle2.address(), "2")
+        self.assertEqual([b.bundle_id for b in doc], ["1", "2"])
+        tree1 = bundle1.create_tree()
+        self.assertEqual(tree1.address(), "1")
 
 if __name__ == "__main__":
     unittest.main()

From bfaad057444cb2ab8355b1d6b423ce09198ea37d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 31 Jan 2023 20:15:16 +0100
Subject: [PATCH 0760/1374] fix ordering of same-span subspans

this can happen easily with discontinuous mentions
---
 udapi/core/coref.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 1a6d1f95..1a13d9fb 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -276,7 +276,7 @@ def __lt__(self, another):
                 return True
             if  len(self.words) < len(another.words):
                 return False
-            assert False
+            return self.mention < another.mention
         return self.words[0].precedes(another.words[0])
 
     @property

From bd0f24b75fcc80b289518cbceab7b0b375ced68d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 31 Jan 2023 20:16:31 +0100
Subject: [PATCH 0761/1374] first draft of corefud.GuessSpan

---
 udapi/block/corefud/guessspan.py | 9 +++++++++
 1 file changed, 9 insertions(+)
 create mode 100644 udapi/block/corefud/guessspan.py

diff --git a/udapi/block/corefud/guessspan.py b/udapi/block/corefud/guessspan.py
new file mode 100644
index 00000000..5c3c6c12
--- /dev/null
+++ b/udapi/block/corefud/guessspan.py
@@ -0,0 +1,9 @@
+from udapi.core.block import Block
+
+class GuessSpan(Block):
+    """Block corefud.GuessSpan heuristically fills mention spans, while keeping mention.head"""
+
+    def process_coref_mention(self, mention):
+        mention.words = mention.head.descendants(add_self=True)
+        # TODO add empty nodes that are causing gaps
+        # TODO add heuristics from corefud.PrintMentions almost_forest=1

From e67283a7046a355ecbc942f10fb6db928279552b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 31 Jan 2023 20:44:30 +0100
Subject: [PATCH 0762/1374] node.parent = empty_node now raises an exception

---
 udapi/core/node.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index e188e134..618e75eb 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -324,6 +324,8 @@ def parent(self, new_parent):
         # Check for None new_parent and cycles.
         if new_parent is None:
             raise ValueError(f'Cannot set None as parent: {self}')
+        if new_parent.is_empty():
+            raise ValueError(f'Cannot set EmptyNode as parent in basic dependencies: {self}')
         if self is new_parent:
             raise CycleError('Cannot set a node as its own parent (cycle are forbidden): %s', self)
         if self._children and new_parent.is_descendant_of(self):

From 4b80322bf0a89dece5653e9f3afb7fbb808a880e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 31 Jan 2023 20:54:37 +0100
Subject: [PATCH 0763/1374] write.CorefHtml shows trees as in write.Html

---
 udapi/block/write/corefhtml.py | 103 ++++++++++++++++++++++++++-------
 1 file changed, 83 insertions(+), 20 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index 3efe9793..8503854f 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -1,27 +1,66 @@
 """CorefHtml class is a writer for HTML+JavaScript visualization of coreference."""
 from udapi.core.basewriter import BaseWriter
 from udapi.core.coref import span_to_nodes, CorefEntity, CorefMention
+import udapi.block.write.html
 
 ETYPES = 'person place organization animal plant object substance time number abstract event'.split()
 
+CSS = '''
+.sentence span {border: 1px solid black; border-radius: 5px; padding: 2px; display:inline-block;}
+.showtree {float:left; margin: 5px;}
+.close{float:right; font-weight: 900; font-size: 30px; width: 36px; height: 36px; padding: 2px}
+.empty {color: gray;}
+.singleton {border-style: dotted;}
+.crossing:before {content: "!"; display: block; background: #ffd500;}
+.active {border: 1px solid red !important;}
+.selected {background: red !important;}
+.other {background: hsl(0, 0%, 85%);}
+'''
+
+SCRIPT_BASE = '''
+$("span").click(function(e) {
+ let was_selected = $(this).hasClass("selected");
+ $("span").removeClass("selected");
+ if (!was_selected){$("."+$(this).attr("class").split(" ")[0]).addClass("selected");}
+ e.stopPropagation();
+});
+
+$("span").hover(
+ function(e) {$("span").removeClass("active"); $("."+$(this).attr("class").split(" ")[1]).addClass("active");},
+ function(e) {$("span").removeClass("active");}
+);
+'''
+
+SCRIPT_SHOWTREE = '''
+$(".sentence").each(function(index){
+  var sent_id = this.id;
+  $(this).before(
+    $("<button>", {append: "🌲", id:"button-"+sent_id, title: "show dependency tree", class: "showtree"}).on("click", function() {
+      var tree_div = $("#tree-"+sent_id);
+      if (tree_div.length == 0){
+        var tdiv = $("<div>", {id:"tree-"+sent_id}).insertBefore($(this));
+        tdiv.treexView([data[index]]);
+        $("<button>",{append:"×", class:"close"}).prependTo(tdiv).on("click", function(){$(this).parent().remove();});
+        $('#button-'+sent_id).attr('title', 'hide dependency tree');
+      } else {tree_div.remove();}
+    })
+  );
+});
+'''
+
 class CorefHtml(BaseWriter):
 
-    def __init__(self, path_to_js='web', **kwargs):
+    def __init__(self, show_trees=True, **kwargs):
         super().__init__(**kwargs)
-        self.path_to_js = path_to_js
+        self.show_trees = show_trees
 
     def process_document(self, doc):
         print('<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8">')
         print('<title>Udapi CorefUD viewer</title>')
         print('<script src="https://code.jquery.com/jquery-3.6.3.min.js"></script>')
-        #print('<script src="coref.js"></script>') #$(window).on("load", function() {...}
-        #print('<link rel="stylesheet" href="coref.css">')
-        print('<style>\n'
-              'span {border: 1px solid black; border-radius: 5px; padding: 2px; display:inline-block;}\n'
-              '.empty {color: gray;}\n.singleton {border-style: dotted;}\n'
-              '.crossing:before {content: "!"; display: block; background: #ffd500;}\n'
-              '.active {border: 1px solid red;}\n.selected {background: red !important;}\n'
-              '.other {background: hsl(0, 0%, 85%);}')
+        if self.show_trees:
+            print('<script src="https://cdn.rawgit.com/ufal/js-treex-view/gh-pages/js-treex-view.js"></script>')
+        print('<style>' + CSS)
         for i, etype in enumerate(ETYPES):
             print(f'.{etype} {{background: hsl({int(i * 360/len(ETYPES))}, 80%, 85%);}}')
         print('</style>')
@@ -35,15 +74,37 @@ def process_document(self, doc):
         for tree in doc.trees:
             self.process_tree(tree, mention_ids)
 
-        print('<script>\n$("span").click(function(e) {\n'
-              ' let was_selected = $(this).hasClass("selected");\n'
-              ' $("span").removeClass("selected");\n'
-              ' if (!was_selected){$("."+$(this).attr("class").split(" ")[0]).addClass("selected");}\n'
-              ' e.stopPropagation();\n});\n'
-              '$("span").hover(\n'
-              ' function(e) {$("span").removeClass("active"); $("."+$(this).attr("class").split(" ")[1]).addClass("active");},\n'
-              ' function(e) {$("span").removeClass("active");}\n'
-              ');\n</script>')
+        print('<script>')
+        print(SCRIPT_BASE)
+        if self.show_trees:
+            print('data=[')
+            for (bundle_number, bundle) in enumerate(doc, 1):
+                if bundle_number != 1:
+                    print(',', end='')
+                print('{"zones":{', end='')
+                first_zone = True
+                desc = ''
+                for tree in bundle.trees:
+                    zone = tree.zone
+                    if first_zone:
+                        first_zone = False
+                    else:
+                        print(',', end='')
+                    print('"%s":{"sentence":"%s",' % (zone, _esc(tree.text)), end='')
+                    print('"trees":{"a":{"language":"%s","nodes":[' % zone)
+                    print('{"id":%s,"parent":null,' % _id(tree), end='')
+                    print('"firstson":' + _id(tree.children[0] if tree.children else None), end=',')
+                    print('"labels":["zone=%s","id=%s"]}' % (zone, tree.address()))
+                    desc += ',["[%s]","label"],[" ","space"]' % zone
+                    for node in tree.descendants:
+                        desc += udapi.block.write.html.Html.print_node(node)
+                    desc += r',["\n","newline"]'
+                    print(']}}}')
+                # print desc without the extra starting comma
+                print('},"desc":[%s]}' % desc[1:])
+            print('];')
+            print(SCRIPT_SHOWTREE)
+        print('</script>')
         print('</body></html>')
 
     def _start_subspan(self, subspan, mention_ids, crossing=False):
@@ -74,8 +135,10 @@ def process_tree(self, tree, mention_ids):
             subspans.extend(mention._subspans())
         subspans.sort(reverse=True)
 
+        if tree.newpar:
+            print('<hr>')
         opened = []
-        print('<p>')
+        print(f'<p class="sentence" id={_id(tree)}>')
         for node in nodes_and_empty:
             while subspans and subspans[-1].words[0] == node:
                 subspan = subspans.pop()

From 9e11bd515e19fa59c0bdbc50654d29544b13a21b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 1 Feb 2023 18:03:19 +0100
Subject: [PATCH 0764/1374] util.Normalize now normalizes also sent_id

---
 udapi/block/util/normalize.py | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/udapi/block/util/normalize.py b/udapi/block/util/normalize.py
index 5b4270cc..298bea42 100644
--- a/udapi/block/util/normalize.py
+++ b/udapi/block/util/normalize.py
@@ -20,16 +20,33 @@ class Normalize(Block):
     util.Eval node='node.misc["NonExistentAttribute"] = None'
     """
 
-    def __init__(self, feats=True, misc=True, **kwargs):
+    def __init__(self, feats=True, misc=True, sent_id=True, start_sent_id=1, **kwargs):
         """
         Args:
         `feats`: normalize the ordering of FEATS. Default=True.
         `misc`: normalize the ordering of MISC. Default=True.
+        `sent_id`: normalize sent_id so it forms a sequence of integers
+        `start_sent_id`: the first sent_id number
         """
         super().__init__(**kwargs)
         self.feats = feats
         self.misc = misc
-        # TODO: normalize also standardized comments like text, sent_id,...
+        self.sent_id = sent_id
+        self.next_sent_id = start_sent_id
+        # TODO: normalize also the order of standardized comments like text, sent_id,...
+
+    def process_bundle(self, bundle):
+        if self.sent_id:
+            bundle.bundle_id = str(self.next_sent_id)
+            self.next_sent_id += 1
+
+        for tree in bundle:
+            if self._should_process_tree(tree):
+                self.process_tree(tree)
+
+    def process_tree(self, tree):
+        for node in tree.descendants:
+            self.process_node(node)
 
     def process_node(self, node):
         if self.feats:

From 4e1b75678dab1f2602cc26b641a31de977a98f14 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 2 Feb 2023 00:47:37 +0100
Subject: [PATCH 0765/1374] sent_id should not be normalized by default

Unlike feats and misc ordering, we can lose information this way - the original sent_id,
so it is potentially dangerous.
---
 udapi/block/util/normalize.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/util/normalize.py b/udapi/block/util/normalize.py
index 298bea42..48cd6dc1 100644
--- a/udapi/block/util/normalize.py
+++ b/udapi/block/util/normalize.py
@@ -20,12 +20,12 @@ class Normalize(Block):
     util.Eval node='node.misc["NonExistentAttribute"] = None'
     """
 
-    def __init__(self, feats=True, misc=True, sent_id=True, start_sent_id=1, **kwargs):
+    def __init__(self, feats=True, misc=True, sent_id=False, start_sent_id=1, **kwargs):
         """
         Args:
         `feats`: normalize the ordering of FEATS. Default=True.
         `misc`: normalize the ordering of MISC. Default=True.
-        `sent_id`: normalize sent_id so it forms a sequence of integers
+        `sent_id`: normalize sent_id so it forms a sequence of integers. Default=False.
         `start_sent_id`: the first sent_id number
         """
         super().__init__(**kwargs)

From b899af14c12c7ba4c9750ba39bf5f5544783ba59 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 2 Feb 2023 09:53:59 +0100
Subject: [PATCH 0766/1374] write.Conllu path=another/directory keeps the file
 name, but changes the directory

---
 udapi/core/basewriter.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/udapi/core/basewriter.py b/udapi/core/basewriter.py
index cdc2c38f..93f6463a 100644
--- a/udapi/core/basewriter.py
+++ b/udapi/core/basewriter.py
@@ -1,6 +1,7 @@
 """BaseWriter is the base class for all writer blocks."""
 import sys
 import logging
+import os
 
 import udapi.core.coref
 from udapi.core.block import Block
@@ -11,7 +12,7 @@ class BaseWriter(Block):
     """Base class for all reader blocks."""
 
     def __init__(self, files='-', filehandle=None, docname_as_file=False, encoding='utf-8',
-                 newline='\n', overwrite=False, **kwargs):
+                 newline='\n', overwrite=False, path=None, **kwargs):
         super().__init__(**kwargs)
         self.orig_files = files
         self.orig_stdout = sys.stdout
@@ -29,6 +30,7 @@ def __init__(self, files='-', filehandle=None, docname_as_file=False, encoding='
             raise ValueError("overwrite=1 is not compatible with files=" + files)
         if overwrite and docname_as_file:
             raise ValueError("overwrite=1 is not compatible with docname_as_file=1")
+        self.path = path
 
     @property
     def filename(self):
@@ -60,9 +62,11 @@ def before_process_document(self, document):
                     sys.stdout = open(docname, 'wt', encoding=self.encoding, newline=self.newline)
                 else:
                     logging.warning('docname_as_file=1 but the document contains no docname')
-            elif self.overwrite:
+            elif self.overwrite or self.path:
                 docname = document.meta.get('loaded_from', None)
                 if docname is not None:
+                    if self.path:
+                        docname = os.path.join(self.path, os.path.split(docname)[1])
                     logging.info('Writing to file %s.', docname)
                     sys.stdout = open(docname, 'wt', encoding=self.encoding, newline=self.newline)
                 else:

From 9d183c1d979c50fabff9b3a295a0d8194a09c790 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 2 Feb 2023 10:14:59 +0100
Subject: [PATCH 0767/1374] etype mismatch is stored in
 mention.other["orig_etype"]

which allows easier debugging
---
 udapi/core/coref.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 1a13d9fb..12dda239 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -665,6 +665,7 @@ def load_coref_from_misc(doc, strict=True):
                     entity.etype = etype
                 elif etype and entity.etype and entity.etype != etype:
                     logging.warning(f"etype mismatch in {node}: {entity.etype} != {etype}")
+                    other["orig_etype"] = etype
                 # CorefEntity could be created first with "Bridge=" without any type
                 elif etype and entity.etype is None:
                     entity.etype = etype

From 5b3ed0268ccf76f5332fcce87ac0da9a42b221b8 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 2 Feb 2023 14:19:33 +0100
Subject: [PATCH 0768/1374] allow using e.g. write.CorefHtml path='html/*.html'

---
 udapi/core/basewriter.py | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/udapi/core/basewriter.py b/udapi/core/basewriter.py
index 93f6463a..e17a64c3 100644
--- a/udapi/core/basewriter.py
+++ b/udapi/core/basewriter.py
@@ -66,11 +66,21 @@ def before_process_document(self, document):
                 docname = document.meta.get('loaded_from', None)
                 if docname is not None:
                     if self.path:
-                        docname = os.path.join(self.path, os.path.split(docname)[1])
+                        old_dir, old_filename = os.path.split(docname)
+                        new_dir, new_filename = os.path.split(self.path)
+                        old_file, old_ext = os.path.splitext(old_filename)
+                        new_file, new_ext = os.path.splitext(new_filename)
+                        if new_dir in ('', '*'):
+                            new_dir = old_dir
+                        if new_file in ('', '*'):
+                            new_file = old_file
+                        if new_ext in ('', '*'):
+                            new_ext = old_ext
+                        docname = os.path.join(new_dir, new_file + new_ext)
                     logging.info('Writing to file %s.', docname)
                     sys.stdout = open(docname, 'wt', encoding=self.encoding, newline=self.newline)
                 else:
-                    logging.warning('overwrite=1 but document.meta["loaded_from"] is None')
+                    logging.warning('using overwrite or path but document.meta["loaded_from"] is None')
             else:
                 sys.stdout = self.orig_stdout
         else:

From 34aa19d7d892790b81b2b79579fc4391c07a23ed Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 2 Feb 2023 14:42:30 +0100
Subject: [PATCH 0769/1374] write.Conllu path=my_dir should be interpreted as
 path=my_dir/

---
 udapi/core/basewriter.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/core/basewriter.py b/udapi/core/basewriter.py
index e17a64c3..6e1b7446 100644
--- a/udapi/core/basewriter.py
+++ b/udapi/core/basewriter.py
@@ -30,6 +30,9 @@ def __init__(self, files='-', filehandle=None, docname_as_file=False, encoding='
             raise ValueError("overwrite=1 is not compatible with files=" + files)
         if overwrite and docname_as_file:
             raise ValueError("overwrite=1 is not compatible with docname_as_file=1")
+        # interpret path=my_dir/my_subdir as path=my_dir/my_subdir/
+        if path and path[-1] != os.sep and '*' not in path:
+            path += os.sep
         self.path = path
 
     @property

From 301b808082254a9b45a2bd4cfe162719dc02bc23 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 4 Feb 2023 01:36:25 +0100
Subject: [PATCH 0770/1374] corefud.GuessSpan: add empty nodes that are causing
 gaps

---
 udapi/block/corefud/guessspan.py | 28 ++++++++++++++++++++++++++--
 1 file changed, 26 insertions(+), 2 deletions(-)

diff --git a/udapi/block/corefud/guessspan.py b/udapi/block/corefud/guessspan.py
index 5c3c6c12..d6093ece 100644
--- a/udapi/block/corefud/guessspan.py
+++ b/udapi/block/corefud/guessspan.py
@@ -4,6 +4,30 @@ class GuessSpan(Block):
     """Block corefud.GuessSpan heuristically fills mention spans, while keeping mention.head"""
 
     def process_coref_mention(self, mention):
-        mention.words = mention.head.descendants(add_self=True)
-        # TODO add empty nodes that are causing gaps
+        mwords = mention.head.descendants(add_self=True)
         # TODO add heuristics from corefud.PrintMentions almost_forest=1
+
+        # Add empty nodes that are causing gaps.
+        # A node "within the span" whose enhanced parent is in the mentions
+        # must be added to the mention as well.
+        # "within the span" includes also empty nodes "on the boundary".
+        # However, don't add empty nodes which are in a gap cause by non-empty nodes.
+        to_add = []
+        min_ord = int(mwords[0].ord) if mwords[0].is_empty() else mwords[0].ord - 1
+        max_ord = int(mwords[-1].ord) + 1
+        root = mention.head.root
+        for empty in root.empty_nodes:
+            if empty in mwords:
+                continue
+            if empty.ord > max_ord:
+                break
+            if empty.ord > min_ord:
+                if any(enh['parent'] in mwords for enh in empty.deps):
+                    to_add.append(empty)
+                elif empty.ord > min_ord + 1 and empty.ord < max_ord - 1:
+                    prev_nonempty = root.descendants[int(empty.ord) - 1]
+                    next_nonempty = root.descendants[int(empty.ord)]
+                    if prev_nonempty in mwords and next_nonempty in mwords:
+                        to_add.append(empty)
+                    #else: empty.misc['Mark'] = f'not_in_treelet_of_{mention.entity.eid}'
+        mention.words = sorted(mwords + to_add)

From 2285d27f5e9444d3db7a8a0b8db227b38e5c082b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 5 Feb 2023 01:06:32 +0100
Subject: [PATCH 0771/1374] write.CorefHtml: distinguish entities using colors,
 show eid and docname

---
 udapi/block/write/corefhtml.py | 41 +++++++++++++++++++++++++---------
 1 file changed, 30 insertions(+), 11 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index 8503854f..0a06b7e5 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -1,19 +1,21 @@
 """CorefHtml class is a writer for HTML+JavaScript visualization of coreference."""
 from udapi.core.basewriter import BaseWriter
 from udapi.core.coref import span_to_nodes, CorefEntity, CorefMention
+from collections import Counter
 import udapi.block.write.html
 
 ETYPES = 'person place organization animal plant object substance time number abstract event'.split()
 
 CSS = '''
 .sentence span {border: 1px solid black; border-radius: 5px; padding: 2px; display:inline-block;}
+.sentence span .eid {display:block; font-size: 10px;}
 .showtree {float:left; margin: 5px;}
 .close{float:right; font-weight: 900; font-size: 30px; width: 36px; height: 36px; padding: 2px}
 .empty {color: gray;}
-.singleton {border-style: dotted;}
+.sentence .singleton {border-style: dotted;}
 .crossing:before {content: "!"; display: block; background: #ffd500;}
 .active {border: 1px solid red !important;}
-.selected {background: red !important;}
+.selected {background: red !important; text-shadow: 1px 1px 4px white, -1px 1px 4px white, 1px -1px 4px white, -1px -1px 4px white;}
 .other {background: hsl(0, 0%, 85%);}
 '''
 
@@ -50,9 +52,11 @@
 
 class CorefHtml(BaseWriter):
 
-    def __init__(self, show_trees=True, **kwargs):
+    def __init__(self, show_trees=True, show_eid=True, colors=7, **kwargs):
         super().__init__(**kwargs)
         self.show_trees = show_trees
+        self.show_eid = show_eid
+        self.colors = colors
 
     def process_document(self, doc):
         print('<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8">')
@@ -63,16 +67,25 @@ def process_document(self, doc):
         print('<style>' + CSS)
         for i, etype in enumerate(ETYPES):
             print(f'.{etype} {{background: hsl({int(i * 360/len(ETYPES))}, 80%, 85%);}}')
+        if self.colors:
+            for i in range(self.colors):
+                print(f'.c{i} {{color: hsl({int(i * 360/self.colors)}, 100%, 30%);}}')
         print('</style>')
         print('</head>\n<body>')
 
         mention_ids = {}
+        entity_colors = {}
+        entities_of_type = Counter()
         for entity in doc.coref_entities:
+            if self.colors:
+                count = entities_of_type[entity.etype]
+                entities_of_type[entity.etype] = count + 1
+                entity_colors[entity] = f'c{count % self.colors}'
             for idx, mention in enumerate(entity.mentions, 1):
                 mention_ids[mention] = f'{entity.eid}e{idx}'
 
         for tree in doc.trees:
-            self.process_tree(tree, mention_ids)
+            self.process_tree(tree, mention_ids, entity_colors)
 
         print('<script>')
         print(SCRIPT_BASE)
@@ -107,11 +120,13 @@ def process_document(self, doc):
         print('</script>')
         print('</body></html>')
 
-    def _start_subspan(self, subspan, mention_ids, crossing=False):
+    def _start_subspan(self, subspan, mention_ids, entity_colors, crossing=False):
         m = subspan.mention
         e = m.entity
         classes = f'{e.eid} {mention_ids[m]} {e.etype or "other"}'
-        title = f'eid={subspan.subspan_eid}\ntype={e.etype}\nhead={m.head.form}'
+        title = f'eid={subspan.subspan_eid}\ntype={e.etype} ({entity_colors[e]})\nhead={m.head.form}'
+        if self.colors:
+            classes += f' {entity_colors[e]}'
         if all(w.is_empty() for w in subspan.words):
             classes += ' empty'
         if len(e.mentions) == 1:
@@ -121,9 +136,11 @@ def _start_subspan(self, subspan, mention_ids, crossing=False):
             title += '\ncrossing'
         if m.other:
             title += f'\n{m.other}'
-        print(f'<span class="{classes}" title="{title}">', end='') #data-eid="{e.eid}"
+        print(f'<span class="{classes}" title="{title}">', end='')
+        if self.show_eid:
+            print(f'<b class="eid">{subspan.subspan_eid}</b>', end='')
 
-    def process_tree(self, tree, mention_ids):
+    def process_tree(self, tree, mention_ids, entity_colors):
         mentions = set()
         nodes_and_empty = tree.descendants_and_empty
         for node in nodes_and_empty:
@@ -135,14 +152,16 @@ def process_tree(self, tree, mention_ids):
             subspans.extend(mention._subspans())
         subspans.sort(reverse=True)
 
-        if tree.newpar:
+        if tree.newdoc:
+            print(f'<hr><h1>{tree.newdoc if tree.newdoc is not True else ""}</h1><hr>')
+        elif tree.newpar:
             print('<hr>')
         opened = []
         print(f'<p class="sentence" id={_id(tree)}>')
         for node in nodes_and_empty:
             while subspans and subspans[-1].words[0] == node:
                 subspan = subspans.pop()
-                self._start_subspan(subspan, mention_ids)
+                self._start_subspan(subspan, mention_ids, entity_colors)
                 opened.append(subspan)
             
             is_head = self._is_head(node)
@@ -180,7 +199,7 @@ def process_tree(self, tree, mention_ids):
                 opened = new_opened
                 print('</span>' * (len(endings) + len(brokens)), end='')
                 for broken in brokens:
-                    self._start_subspan(broken, mention_ids, True)
+                    self._start_subspan(broken, mention_ids, entity_colors, True)
                     opened.append(subspan)
 
             if not node.no_space_after:

From cae7c37efe8548c2e432b108e4aa06df3b778e3a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 6 Feb 2023 15:07:42 +0100
Subject: [PATCH 0772/1374] `read.Conllu max_docs=3` will load only the first
 three documents

This is nice for debugging coreference files,
where we cannot load just first N sentences
because there may be Bridge/SplitAnte referring
to unknown eid. This way we load whole docs.
---
 udapi/block/read/conllu.py | 22 ++++++++++++++++++++--
 udapi/core/basereader.py   | 31 ++++++++++++++++++++++++++++---
 2 files changed, 48 insertions(+), 5 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index bba69696..d5623fba 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -81,8 +81,26 @@ def parse_comment_line(self, line, root):
         root.comment += line[1:] + "\n"
 
     def read_trees(self):
-        return [self.read_tree_from_lines(s.split('\n')) for s in
-                self.filehandle.read().split('\n\n') if s]
+        if not self.max_docs:
+            return [self.read_tree_from_lines(s.split('\n')) for s in
+                    self.filehandle.read().split('\n\n') if s]
+        # udapi.core.basereader takes care about the max_docs parameter.
+        # However, we can make the loading much faster by not reading
+        # the whole file if the user wants just first N documents.
+        trees, lines, loaded_docs = [], [], 0
+        for line in self.filehandle:
+            line = line.rstrip()
+            if line == '':
+               tree = self.read_tree_from_lines(lines)
+               lines = []
+               if tree.newdoc:
+                   if loaded_docs == self.max_docs:
+                       return trees
+                   loaded_docs += 1
+               trees.append(tree)
+            else:
+                lines.append(line)
+        return
 
     def read_tree(self):
         if self.filehandle is None:
diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index a3b334da..a841bf1b 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -13,7 +13,8 @@ class BaseReader(Block):
 
     # pylint: disable=too-many-arguments
     def __init__(self, files='-', filehandle=None, zone='keep', bundles_per_doc=0, encoding='utf-8-sig',
-                 sent_id_filter=None, split_docs=False, ignore_sent_id=False, merge=False, **kwargs):
+                 sent_id_filter=None, split_docs=False, ignore_sent_id=False, merge=False,
+                 max_docs=0, **kwargs):
         super().__init__(**kwargs)
         if filehandle is not None:
             files = None
@@ -29,6 +30,8 @@ def __init__(self, files='-', filehandle=None, zone='keep', bundles_per_doc=0, e
         self.split_docs = split_docs
         self.ignore_sent_id = ignore_sent_id
         self.merge = merge
+        self.max_docs = max_docs
+        self._docs_loaded = 0
         # `global.Entity` is a header stored in a comment before the first tree of each document in a given CoNLL-U file.
         # In Udapi, it is stored in `document.meta['global.Entity']`, but for technical reasons, we need to temporarily store it in here, the reader.
         # The reason is that `read.Conllu` uses a fast loading interface with `read_trees()`,
@@ -126,6 +129,11 @@ def try_fast_load(self, document):
 
             bundle, last_bundle_id = None, ''
             for root in trees:
+                if root.newdoc:
+                    if self.max_docs and self._docs_loaded >= self.max_docs:
+                        self.finished = True
+                        return True
+                    self._docs_loaded += 1
                 add_to_the_last_bundle = False
 
                 if self.ignore_sent_id:
@@ -180,8 +188,10 @@ def process_document(self, document):
                     if root._sent_id is not None:
                         bundle.bundle_id = root._sent_id.split('/', 1)[0]
                 bundle.add_tree(root)
-                if root.newdoc and root.newdoc is not True:
-                    document.meta["docname"] = root.newdoc
+                if root.newdoc:
+                    self._docs_loaded += 1
+                    if root.newdoc is not True:
+                        document.meta["docname"] = root.newdoc
                 document.meta['global.Entity'] = self._global_entity
                 document.meta['loaded_from'] = self.filename
 
@@ -204,6 +214,17 @@ def process_document(self, document):
                 if trees_loaded == 0:
                     document.meta['loaded_from'] = self.filename
                     document.meta['global.Entity'] = self._global_entity
+                    # Parameter max_docs is primarily aimed for counting UD docs, ie. trees with newdoc.
+                    # However, it could be useful even when working with files without the newdoc annotations,
+                    # e.g. when using files='!*.conllu' or bundles_per_doc, in which case we count the Udapi documents
+                    # so even if the first tree in udapi.Document does not have newdoc, we count it as a new document.
+                    # The cases where newdoc is used are checked further below.
+                    if not root.newdoc:
+                        if self.max_docs and self._docs_loaded >= self.max_docs:
+                            self.finished = True
+                            return
+                        self._docs_loaded += 1
+
                 add_to_the_last_bundle = False
                 trees_loaded += 1
 
@@ -222,6 +243,9 @@ def process_document(self, document):
 
                 # The `# newdoc` comment in CoNLL-U marks a start of a new document.
                 if root.newdoc:
+                    if self.max_docs and self._docs_loaded >= self.max_docs:
+                        self.finished = True
+                        return
                     if not bundle and root.newdoc is not True:
                         document.meta["docname"] = root.newdoc
                     if bundle and self.split_docs:
@@ -231,6 +255,7 @@ def process_document(self, document):
                                             len(orig_bundles))
                         self.finished = False
                         return
+                    self._docs_loaded += 1
 
                 # assign new/next bundle to `bundle` if needed
                 if not bundle or not add_to_the_last_bundle:

From ae34d8024d8ee95db6e1bf39581e44fc08bcbc73 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 6 Feb 2023 15:25:50 +0100
Subject: [PATCH 0773/1374] refactor code duplication

---
 udapi/block/write/corefhtml.py | 29 +++--------------------------
 udapi/block/write/html.py      | 28 +++++++++++++++-------------
 2 files changed, 18 insertions(+), 39 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index 0a06b7e5..c7950ce9 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -50,6 +50,8 @@
 });
 '''
 
+WRITE_HTML = udapi.block.write.html.Html()
+
 class CorefHtml(BaseWriter):
 
     def __init__(self, show_trees=True, show_eid=True, colors=7, **kwargs):
@@ -90,32 +92,7 @@ def process_document(self, doc):
         print('<script>')
         print(SCRIPT_BASE)
         if self.show_trees:
-            print('data=[')
-            for (bundle_number, bundle) in enumerate(doc, 1):
-                if bundle_number != 1:
-                    print(',', end='')
-                print('{"zones":{', end='')
-                first_zone = True
-                desc = ''
-                for tree in bundle.trees:
-                    zone = tree.zone
-                    if first_zone:
-                        first_zone = False
-                    else:
-                        print(',', end='')
-                    print('"%s":{"sentence":"%s",' % (zone, _esc(tree.text)), end='')
-                    print('"trees":{"a":{"language":"%s","nodes":[' % zone)
-                    print('{"id":%s,"parent":null,' % _id(tree), end='')
-                    print('"firstson":' + _id(tree.children[0] if tree.children else None), end=',')
-                    print('"labels":["zone=%s","id=%s"]}' % (zone, tree.address()))
-                    desc += ',["[%s]","label"],[" ","space"]' % zone
-                    for node in tree.descendants:
-                        desc += udapi.block.write.html.Html.print_node(node)
-                    desc += r',["\n","newline"]'
-                    print(']}}}')
-                # print desc without the extra starting comma
-                print('},"desc":[%s]}' % desc[1:])
-            print('];')
+            WRITE_HTML.print_doc_json(doc)
             print(SCRIPT_SHOWTREE)
         print('</script>')
         print('</body></html>')
diff --git a/udapi/block/write/html.py b/udapi/block/write/html.py
index 148b29ee..48431900 100644
--- a/udapi/block/write/html.py
+++ b/udapi/block/write/html.py
@@ -79,16 +79,26 @@ def process_document(self, doc):
         print('</head>\n<body>')
         print('<button style="float:right" type="submit" onclick="saveTree()">'
               '<span>Save as SVG</span></button><div id="treex-view"></div><script>')
+        self.print_doc_json(doc)
+        print("$('#treex-view').treexView(data);")
+        print('''function saveTree() {
+         var svg_el = jQuery('svg');
+         if (svg_el.length) {
+            var svg = new Blob([svg_el.parent().html()], {type: "image/svg+xml"});
+            saveAs(svg, 'tree.svg');
+         }
+        }''')
+        print('</script></body></html>')
+
+    def print_doc_json(self, doc):
         print('data=[')
         for (bundle_number, bundle) in enumerate(doc, 1):
-            # TODO: if not self._should_process_bundle(bundle): continue
             if bundle_number != 1:
                 print(',', end='')
             print('{"zones":{', end='')
             first_zone = True
             desc = ''
             for tree in bundle.trees:
-                # TODO: if not self._should_process_tree(tree): continue
                 zone = tree.zone
                 if first_zone:
                     first_zone = False
@@ -101,24 +111,16 @@ def process_document(self, doc):
                 print('"labels":["zone=%s","id=%s"]}' % (zone, tree.address()))
                 desc += ',["[%s]","label"],[" ","space"]' % zone
                 for node in tree.descendants:
-                    desc += self.print_node(node)
+                    desc += self.print_node_json(node)
                 desc += r',["\n","newline"]'
                 print(']}}}')
             # print desc without the extra starting comma
             print('},"desc":[%s]}' % desc[1:])
         print('];')
-        print("$('#treex-view').treexView(data);")
-        print('''function saveTree() {
-         var svg_el = jQuery('svg');
-         if (svg_el.length) {
-            var svg = new Blob([svg_el.parent().html()], {type: "image/svg+xml"});
-            saveAs(svg, 'tree.svg');
-         }
-        }''')
-        print('</script></body></html>')
+
 
     @staticmethod
-    def print_node(node):
+    def print_node_json(node):
         """JSON representation of a given node."""
         # pylint does not understand `.format(**locals())` and falsely alarms for unused vars
         # pylint: disable=too-many-locals,unused-variable

From ca4d2b7f8240a0faca55f9aad6513d9a94968a08 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 6 Feb 2023 19:53:25 +0100
Subject: [PATCH 0774/1374] write.CorefHtml: add side panel with an overview of
 entities

---
 udapi/block/write/corefhtml.py | 62 ++++++++++++++++++++++++++++++----
 1 file changed, 55 insertions(+), 7 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index c7950ce9..280fc213 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -6,7 +6,25 @@
 
 ETYPES = 'person place organization animal plant object substance time number abstract event'.split()
 
+HEADER = '''
+<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8">
+<title>Udapi CorefUD viewer</title>
+<script src="https://code.jquery.com/jquery-3.6.3.min.js"></script>
+'''
+# I use a pure CSS-3 solution: #overiew {resize: horizontal; overflow: auto;}
+# so that the width of #overview can be changed by dragging the bottom right corner.
+# The following lines would make the whole right border draggable:
+#<script src="https://code.jquery.com/ui/1.13.2/jquery-ui.js"></script>
+#<link rel="stylesheet" href="https://code.jquery.com/ui/1.13.2/themes/base/jquery-ui.css">
+#<script>$( function() {$( "#overview" ).resizable({handles: "e"});} );</script>
+#<div id="overview" class="ui-widget-content">
 CSS = '''
+#wrap {display: flex; align-items: flex-start;}
+#main {width: 100%; padding: 5px; background: white; z-index:100;}
+#overview { position: sticky; top: 0; overflow-y: scroll; height:95vh; resize:horizontal;
+            display: grid; border-right: double;
+            padding: 5px; width: 20em; background: #ddd; border-radius: 5px;
+}
 .sentence span {border: 1px solid black; border-radius: 5px; padding: 2px; display:inline-block;}
 .sentence span .eid {display:block; font-size: 10px;}
 .showtree {float:left; margin: 5px;}
@@ -23,10 +41,16 @@
 $("span").click(function(e) {
  let was_selected = $(this).hasClass("selected");
  $("span").removeClass("selected");
- if (!was_selected){$("."+$(this).attr("class").split(" ")[0]).addClass("selected");}
+ if (!was_selected) {$("."+$(this).attr("class").split(" ")[0]).addClass("selected");}
  e.stopPropagation();
 });
 
+window.onhashchange = function() {
+ $("span").removeClass("selected");
+ var fragment = window.location.hash.substring(1);
+ if (fragment) {$("." + fragment).addClass("selected");}
+}
+
 $("span").hover(
  function(e) {$("span").removeClass("active"); $("."+$(this).attr("class").split(" ")[1]).addClass("active");},
  function(e) {$("span").removeClass("active");}
@@ -60,10 +84,18 @@ def __init__(self, show_trees=True, show_eid=True, colors=7, **kwargs):
         self.show_eid = show_eid
         self.colors = colors
 
+    def _representative_word(self, entity):
+        # return the first PROPN or NOUN. Or the most frequent one?
+        heads = [m.head for m in entity.mentions]
+        lemma_or_form = lambda n: n.lemma if n.lemma else n.form
+        for upos in ('PROPN', 'NOUN'):
+            nodes = [n for n in heads if n.upos == upos]
+            if nodes:
+                return lemma_or_form(nodes[0])
+        return lemma_or_form(heads[0])
+
     def process_document(self, doc):
-        print('<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8">')
-        print('<title>Udapi CorefUD viewer</title>')
-        print('<script src="https://code.jquery.com/jquery-3.6.3.min.js"></script>')
+        print(HEADER)
         if self.show_trees:
             print('<script src="https://cdn.rawgit.com/ufal/js-treex-view/gh-pages/js-treex-view.js"></script>')
         print('<style>' + CSS)
@@ -73,7 +105,7 @@ def process_document(self, doc):
             for i in range(self.colors):
                 print(f'.c{i} {{color: hsl({int(i * 360/self.colors)}, 100%, 30%);}}')
         print('</style>')
-        print('</head>\n<body>')
+        print('</head>\n<body>\n<div id="wrap">')
 
         mention_ids = {}
         entity_colors = {}
@@ -86,8 +118,21 @@ def process_document(self, doc):
             for idx, mention in enumerate(entity.mentions, 1):
                 mention_ids[mention] = f'{entity.eid}e{idx}'
 
+        print('<div id="overview">')
+        print('<table><thead><tr><th title="entity id">eid</th>'
+              '<th title="number of mentions">#m</th>'
+              '<th title="a word best representing the entity">word</th></tr></thead>\n<tbody>')
+        for entity in doc.coref_entities:
+            print(f'<tr><td><a href="#{entity.eid}">{entity.eid}</a></td>'
+                  f'<td>{len(entity.mentions)}</td>'
+                  f'<td>{self._representative_word(entity)}</td></tr>')
+        print('</tbody></table>')
+        print('</div>')
+
+        print('<div id="main">')
         for tree in doc.trees:
             self.process_tree(tree, mention_ids, entity_colors)
+        print('</div>')
 
         print('<script>')
         print(SCRIPT_BASE)
@@ -95,7 +140,7 @@ def process_document(self, doc):
             WRITE_HTML.print_doc_json(doc)
             print(SCRIPT_SHOWTREE)
         print('</script>')
-        print('</body></html>')
+        print('</div></body></html>')
 
     def _start_subspan(self, subspan, mention_ids, entity_colors, crossing=False):
         m = subspan.mention
@@ -113,7 +158,10 @@ def _start_subspan(self, subspan, mention_ids, entity_colors, crossing=False):
             title += '\ncrossing'
         if m.other:
             title += f'\n{m.other}'
-        print(f'<span class="{classes}" title="{title}">', end='')
+        span_id = ''
+        if (subspan.subspan_id == '' or subspan.subspan_id.startswith('[1/')) and e.mentions[0] == m:
+            span_id = f'id="{e.eid}" '
+        print(f'<span {span_id}class="{classes}" title="{title}">', end='')
         if self.show_eid:
             print(f'<b class="eid">{subspan.subspan_eid}</b>', end='')
 

From bbd702aa35fcf4e13d2a4ab2d3972a7efd89fcc5 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 7 Feb 2023 16:22:03 +0100
Subject: [PATCH 0775/1374] Python glob.glob does not support {dir1,dir2}
 anyway

---
 udapi/core/files.py | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/udapi/core/files.py b/udapi/core/files.py
index 7fcd9149..c6973dad 100644
--- a/udapi/core/files.py
+++ b/udapi/core/files.py
@@ -58,14 +58,6 @@ def string_to_filenames(self, string):
         or commas. For specifying files with spaces or commas in filenames, you need to use
         wildcard patterns or '@' filelist. (But preferably don't use such filenames.)
         """
-        # "!" means glob pattern which can contain {dir1,dir2}
-        # so it cannot be combined with separating tokens with comma.
-        if string[0] == '!':
-            pattern = string[1:]
-            filenames = glob.glob(pattern)
-            if not filenames:
-                raise RuntimeError('No filenames matched "%s" pattern' % pattern)
-            return filenames
         return list(itertools.chain.from_iterable(self._token_to_filenames(tok)
                                                   for tok in string.replace(',', ' ').split()))
 

From a5acaf43b1edb3468dfc493da6e7ae87f2d99966 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 7 Feb 2023 17:58:45 +0100
Subject: [PATCH 0776/1374] ud.ComplyWithText: use node.misc['CorrectForm']

instead of node.misc['OrigForm'] which was a misleading name
because the previous form value is usually not the real original form.
---
 udapi/block/ud/complywithtext.py | 25 +++++++++++++++++--------
 1 file changed, 17 insertions(+), 8 deletions(-)

diff --git a/udapi/block/ud/complywithtext.py b/udapi/block/ud/complywithtext.py
index cead294a..bacc56a2 100644
--- a/udapi/block/ud/complywithtext.py
+++ b/udapi/block/ud/complywithtext.py
@@ -34,7 +34,7 @@ class ComplyWithText(Block):
     """Adapt the nodes to comply with the text."""
 
     def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, max_mwt_length=4,
-                 **kwargs):
+                 previous_form_attr='CorrectForm', **kwargs):
         """Args:
         fix_text: After all heuristics are applied, the token forms may still not match the text.
             Should we edit the text to match the token forms (as a last resort)? Default=True.
@@ -54,24 +54,33 @@ def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, max_mwt_
             Default=True (i.e. add the goeswith nodes if applicable).
         max_mwt_length - Maximum length of newly created multi-word tokens (in syntactic words).
             Default=4.
+        previous_form_attr - when changing node.form, we store the previous value
+            in node.misc[previous_form_attr] (so no information is lost).
+            Default="CorrectForm" because we expect that the previous value
+            (i.e. the value of node.form before applying this block)
+            contained the corrected spelling, while root.text contains
+            the original spelling with typos as found in the raw text.
+            CorrectForm is defined in https://universaldependencies.org/u/overview/typos.html
+            When setting this parameter to an empty string, no values will be stored to node.misc.
         """
         super().__init__(**kwargs)
         self.fix_text = fix_text
         self.prefer_mwt = prefer_mwt
         self.allow_goeswith = allow_goeswith
         self.max_mwt_length = max_mwt_length
+        self.allow_add_punct = allow_add_punct
+        self.allow_delete_punct = allow_delete_punct
+        self.previous_form_attr = previous_form_attr
 
     @staticmethod
     def allow_space(form):
         """Is space allowed within this token form?"""
         return re.fullmatch('[0-9 ]+([,.][0-9]+)?', form)
 
-    @staticmethod
-    def store_orig_form(node, new_form):
-        """Store the original form of this node into MISC, unless the change is common&expected."""
-        _ = new_form
+    def store_previous_form(self, node):
+        """Store the previous form of this node into MISC, unless the change is common&expected."""
         if node.form not in ("''", "``"):
-            node.misc['OrigForm'] = node.form
+            node.misc[self.previous_form_attr] = node.form
 
     def process_tree(self, root):
         text = root.text
@@ -203,7 +212,7 @@ def solve_diff(self, nodes, form):
         if ' ' in form:
             if len(nodes) == 1 and node.form == form.replace(' ', ''):
                 if self.allow_space(form):
-                    self.store_orig_form(node, form)
+                    self.store_previous_form(node)
                     node.form = form
                 elif self.allow_goeswith:
                     forms = form.split()
@@ -235,7 +244,7 @@ def solve_diff(self, nodes, form):
 
         # Third, solve the 1-1 cases.
         else:
-            self.store_orig_form(node, form)
+            self.store_previous_form(node)
             node.form = form
 
 

From a69c7a158edb91d12d2907f6802c3104d946ee0d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 7 Feb 2023 18:00:46 +0100
Subject: [PATCH 0777/1374] ud.ComplyWithText fix_text=1 should always produce
 valid CoNLL-U

so even if there are diffs which cannot be resolved,
and thus we cannot fill SpaceAfter=No in the rest of the sentence,
we must execute the "if self.fix_text:..." code,
which changes the root.text (instead of changing the annotation of nodes).
---
 udapi/block/ud/complywithtext.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/complywithtext.py b/udapi/block/ud/complywithtext.py
index bacc56a2..1a13a4ec 100644
--- a/udapi/block/ud/complywithtext.py
+++ b/udapi/block/ud/complywithtext.py
@@ -121,7 +121,7 @@ def process_tree(self, root):
                     node.misc['SpaceAfter'] = 'No'
             else:
                 logging.warning('Node %s does not match text "%s"', node, tmp_text[:20])
-                return
+                break
 
         # Edit root.text if needed.
         if self.fix_text:

From fde163c32837ccc02a9b89d535be9769d4414340 Mon Sep 17 00:00:00 2001
From: "Federica Gamba (PhD" <gamba@cyan.ms.mff.cuni.cz>
Date: Wed, 8 Feb 2023 14:23:05 +0100
Subject: [PATCH 0778/1374] further adjusted Latin feature rules

---
 udapi/block/ud/la/markfeatsbugs.py | 122 ++++++++++++++++++-----------
 1 file changed, 78 insertions(+), 44 deletions(-)

diff --git a/udapi/block/ud/la/markfeatsbugs.py b/udapi/block/ud/la/markfeatsbugs.py
index 323f60f7..111bceb9 100644
--- a/udapi/block/ud/la/markfeatsbugs.py
+++ b/udapi/block/ud/la/markfeatsbugs.py
@@ -29,7 +29,7 @@ def process_node(self, node):
         af = {}
         # NOUNS ################################################################
         if node.upos == 'NOUN':
-            if not node.feats['Abbr'] == 'Yes' or node.feats['Case']: # abbreviated or indeclinable nouns
+            if node.feats['Case'] and not node.feats['Abbr'] == 'Yes': # abbreviated or indeclinable nouns
                 rf = ['Gender', 'Number', 'Case']
             af = {
                 'Gender': ['Masc', 'Fem', 'Neut'],
@@ -37,11 +37,11 @@ def process_node(self, node):
                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
                 'Degree': ['Dim'],
                 'Abbr': ['Yes'],
-                'Foreign': ['Yes']}
+                'Foreign': ['Yes'],
+                'VerbForm': ['Part']}
             if self.flavio:
                 # Flavio added InflClass but not everywhere, so it is not required.
                 af['InflClass'] = ['IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
-                af['VerbForm'] = ['Part']
                 af['Proper'] = ['Yes']
                 af['Compound'] = ['Yes']
                 af['NameType'] = ['Ast', 'Cal', 'Com', 'Geo', 'Giv', 'Let', 'Lit', 'Met', 'Nat', 'Rel', 'Sur', 'Oth']
@@ -76,14 +76,12 @@ def process_node(self, node):
                 'Degree': ['Cmp', 'Sup', 'Abs'],
                 'Abbr': ['Yes'],
                 'Foreign': ['Yes'],
-                'Polarity': ['Neg']}
+                'Polarity': ['Neg'],
+                'VerbForm': ['Part']}
             if self.flavio:
-                # Flavio does not use Degree=Pos, hence Degree is not required.
-                # rf = [f for f in rf if f != 'Degree']
                 # Flavio added InflClass but not everywhere, so it is not required.
                 af['InflClass'] = ['IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
                 af['Compound'] = ['Yes']
-                af['VerbForm'] = ['Part']
                 af['Proper'] = ['Yes']
                 af['Degree'].append('Dim')
                 af['NameType'] = ['Ast', 'Cal', 'Com', 'Geo', 'Giv', 'Let', 'Lit', 'Met', 'Nat', 'Rel', 'Sur', 'Oth']
@@ -93,15 +91,16 @@ def process_node(self, node):
         elif node.upos == 'PRON':
             rf = ['PronType', 'Case']
             af = {
-                'PronType': ['Prs', 'Rel', 'Ind', 'Int', 'Rcp'],
-                'Case':     ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
+               'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
+               'Proper': ['Yes'],
+               'Compound': ['Yes'],
+               'Polarity': ['Neg']
             }
             if node.feats['PronType'] == 'Prs':
                 af['Reflex'] = ['Yes']
                 if node.feats['Reflex'] == 'Yes': # seipsum, se
                     rf.extend(['Person'])
                     # seipsum has gender and number but se does not, so it is not required
-                    # TODO: seipsum in ITTB, but why lemma seipsum instead of seipse?
                     af['Gender'] = ['Masc', 'Fem', 'Neut']
                     af['Number'] = ['Sing', 'Plur']
                     af['Person'] = ['3']
@@ -122,6 +121,19 @@ def process_node(self, node):
                 rf = [f for f in rf if f != 'Case']
                 af['Gender'] = ['Masc', 'Fem', 'Neut']
                 af['Number'] = ['Sing', 'Plur']
+            # lexical check of PronTypes
+            af['PronType'] = []
+            if node.lemma in ['is', 'ego', 'tu', 'sui', 'seipsum', 'nos', 'uos', 'vos', 'tumetipse', 'nosmetipse']:
+                af['PronType'].append('Prs')
+            elif node.lemma in ['quis', 'aliquis', 'nihil', 'nemo', 'quivis']:
+                af['PronType'].append('Ind')
+            elif node.lemma in ['inuicem', 'invicem']:
+                af['PronType'].append('Rcp')
+                rf.remove('Case')
+            elif node.lemma in ['quicumque', 'qui', 'quisquis']:
+                af['PronType'].append('Rel')
+            if node.lemma in ['qui', 'quis', 'quisnam', 'ecquis']:
+                af['PronType'].append('Int')
             if self.flavio:
                 # Flavio added InflClass but not everywhere, so it is not required.
                 af['InflClass'] = ['LatAnom', 'LatPron']
@@ -140,7 +152,9 @@ def process_node(self, node):
                 'Number': ['Sing', 'Plur'],
                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
                 'Degree': ['Cmp', 'Abs', 'Sup'],
-                'Polarity': ['Neg']
+                'Polarity': ['Neg'],
+                'Proper': ['Yes'],
+                'PronType': []
                 }
             if node.feats['Poss'] == 'Yes': # 'meus', 'tuus', 'suus', 'noster'
                 rf.extend(['Poss', 'Person[psor]'])
@@ -152,8 +166,24 @@ def process_node(self, node):
                 if node.feats['Person[psor]'] != '3':
                     rf.append('Number[psor]')
                     af['Number[psor]'] = ['Sing', 'Plur']
-            else:
-                af['PronType'] = ['Dem', 'Rel', 'Ind', 'Int', 'Tot', 'Con']
+            if node.feats['PronType'] == 'Ind':
+                af['NumType'] = ['Card']
+            # lexical check of PronTypes
+            if node.lemma in ['suus', 'meus', 'noster', 'tuus', 'uester', 'vester', 'voster']:
+                if not af['PronType'] == ['Prs']:
+                    af['PronType'].append('Prs')
+            elif node.lemma in ['aliquot', 'quidam', 'quispiam', 'quivis', 'nullus', 'nonnullus', 'aliqui', 'qui', 'quilibet', 'quantuslibet', 'unus', 'uterque', 'ullus', 'multus', 'quisque', 'paucus', 'complures', 'quamplures', 'quicumque', 'reliquus', 'plerusque', 'aliqualis', 'quisquam', 'qualiscumque']:
+                af['PronType'].append('Ind')
+            elif node.lemma in ['omnis', 'totus', 'ambo', 'cunctus', 'unusquisque', 'uniuersus']:
+                af['PronType'].append('Tot')
+            if node.lemma in ['quantus', 'qualis', 'quicumque', 'quot', 'quotus']:
+                af['PronType'].append('Rel')
+            elif node.lemma in ['qui', 'quantus', 'quot']:
+                af['PronType'].append('Int')
+            elif node.lemma in ['hic', 'ipse', 'ille', 'tantus', 'talis', 'is', 'iste', 'eiusmodi', 'huiusmodi', 'idem', 'totidem', 'tot']:
+                af['PronType'].append('Dem')
+            elif node.lemma in ['alius', 'alter', 'solus', 'ceterus', 'alteruter', 'neuter', 'uter']:
+                af['PronType'].append('Con')
             if self.flavio:
                 # Flavio added InflClass but not everywhere, so it is not required.
                 af['InflClass'] = ['IndEurA', 'IndEurI', 'IndEurO', 'IndEurX', 'LatPron']
@@ -170,8 +200,8 @@ def process_node(self, node):
             rf = ['NumType', 'NumForm']
             af = {
                 'NumType': ['Card'],
-                'NumForm': ['Word', 'Roman', 'Digit']
-            }
+                'NumForm': ['Word', 'Roman', 'Digit'],
+                'Proper': ['Yes']}
             # Arabic digits and Roman numerals do not have inflection features.
             if not re.match(r'^(Digit|Roman)$', node.feats['NumForm']):
                 af['Gender'] = ['Masc', 'Fem', 'Neut']
@@ -186,40 +216,40 @@ def process_node(self, node):
         elif re.match(r'^(VERB|AUX)$', node.upos):
             rf = ['VerbForm', 'Aspect']
             af = {
-                'VerbForm': ['Inf', 'Fin', 'Part'],
+                'VerbForm': ['Inf', 'Fin', 'Part', 'Conv'],
                 'Aspect': ['Imp', 'Inch', 'Perf', 'Prosp'],
-                'Polarity': ['Neg']
+                'Polarity': ['Neg'],
+                'Typo': ['Yes']
                 }
-            if not re.match(r'^(Ger|Gdv)$', node.feats['VerbForm']):
+            if node.feats['VerbForm'] not in ['Part', 'Conv']:
                 rf.append('Tense')
-                af['Tense'] = ['Pres', 'Fut']
-            if node.upos == 'VERB': # and not node.lemma.endswith('sum'): # compounds of sum
+                af['Tense'] = ['Past', 'Pqp', 'Pres', 'Fut']
+            if node.upos == 'VERB':
                 rf.append('Voice')
                 af['Voice'] = ['Act', 'Pass']
-            # Main verbs have aspect but auxiliaries don't.
-            # TODO: apparently, apparently AUXs have aspect as well
-            # if node.upos == 'VERB':
-            #    rf.append('Aspect')
-            #    af['Aspect'] = ['Imp', 'Inch', 'Perf', 'Prosp']
             if node.feats['VerbForm'] == 'Fin': # imperative, indicative or subjunctive
                 rf.extend(['Mood', 'Person', 'Number'])
-                af['Tense'].extend(['Past', 'Pqp'])
                 af['Mood'] = ['Ind', 'Sub', 'Imp']
                 af['Person'] = ['1', '2', '3']
                 af['Number'] = ['Sing', 'Plur']
             elif node.feats['VerbForm'] == 'Part':
                 rf.extend(['Gender', 'Number', 'Case'])
-                af['Number'] = ['Sing', 'Plur']
-                af['Gender'] = ['Masc', 'Fem', 'Neut']
+                af['Number'] = ['Sing', 'Plur'] if node.misc['TraditionalMood'] != 'Gerundium' else ['Sing']
+                af['Gender'] = ['Masc', 'Fem', 'Neut'] if node.misc['TraditionalMood'] != 'Gerundium' else ['Neut']
                 af['Case'] = ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
                 af['Degree'] = ['Abs', 'Cmp']
-                af['Gender'] = ['Masc', 'Fem', 'Neut']
-                af['Tense'].append('Past')
-            # else: nothing to be added for VerbForm=Inf
+                if node.misc['TraditionalMood'].startswith('Gerundi'):
+                    af['Voice'] = ['Pass']
+                    af['Aspect'] = 'Prosp'
+            elif node.feats['VerbForm'] == 'Conv':
+                rf.extend(['Case', 'Gender', 'Number'])
+                af['Case'] = ['Abl', 'Acc']
+                af['Gender'] = ['Masc']
+                af['Number'] = ['Sing']
+                af['Voice'] = ['Act']
+            elif node.feats['VerbForm'] == 'Inf':
+                af['Tense'].remove('Pqp')
             if self.flavio:
-                # Flavio has killed Tense in his treebanks.
-                rf = [f for f in rf if f != 'Tense']
-                af['VerbForm'].append('Vnoun')
                 # Flavio added InflClass but not everywhere, so it is not required.
                 af['InflClass'] = ['LatA', 'LatAnom', 'LatE', 'LatI', 'LatI2', 'LatX']
                 if 'Degree' in af:
@@ -228,23 +258,22 @@ def process_node(self, node):
                     af['Degree'] = ['Dim']
                 af['Compound'] = ['Yes']
                 af['Proper'] = ['Yes']
-                if re.match(r'^(Part|Vnoun)$', node.feats['VerbForm']):
-                    af['InflClass[nominal]'] = ['IndEurA', 'IndEurI', 'IndEurO']
-                af['VerbForm'].append('Vnoun')
+                if re.match(r'^(Part|Conv)$', node.feats['VerbForm']):
+                    af['InflClass[nominal]'] = ['IndEurA', 'IndEurI', 'IndEurO', 'IndEurU']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # ADVERBS ##############################################################
         elif node.upos == 'ADV':
             af = {
-                'AdvType':  ['Loc', 'Tim'],
+                'AdvType': ['Loc', 'Tim'],
                 'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot', 'Con'],
-                'Degree':   ['Pos', 'Cmp', 'Sup', 'Abs'],
+                'Degree': ['Pos', 'Cmp', 'Sup', 'Abs'],
+                'NumType': ['Card', 'Ord'], # e.g., primum
                 'Polarity': ['Neg']
             }
             if self.flavio:
                 af['Compound'] = ['Yes']
                 af['Form'] = ['Emp']
-                af['NumType'] = ['Card', 'Ord'] # e.g., primum
                 af['VerbForm'] = ['Part']
                 af['Degree'].append('Dim')
             self.check_allowed_features(node, af)
@@ -262,7 +291,8 @@ def process_node(self, node):
         elif re.match(r'^[CS]CONJ$', node.upos):
             af = {
             'PronType': ['Rel', 'Con'],
-            'Polarity': ['Neg']}
+            'Polarity': ['Neg'],
+            'Compound': ['Yes']}
             if self.flavio:
                 af['Compound'] = ['Yes']
                 af['Form'] = ['Emp']
@@ -271,10 +301,14 @@ def process_node(self, node):
             self.check_allowed_features(node, af)
         # ADPOSITIONS ##########################################################
         elif node.upos == 'ADP':
+            rf = ['AdpType']
+            af = {
+                'AdpType': ['Prep', 'Post'],
+                'Abbr': ['Yes']
+            }
             if self.flavio:
-                af = {
-                'VerbForm': ['Part'],
-                'Proper': ['Yes']}
+                af['VerbForm'] = ['Part'],
+                af['Proper'] = ['Yes']
             self.check_allowed_features(node, af)
         # THE REST: NO FEATURES ################################################
         else:

From 29fb09caccd678560845ea3d80b2027145231c90 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 8 Feb 2023 18:04:56 +0100
Subject: [PATCH 0779/1374] improve ud.ComplyWithText for KorKor

---
 udapi/block/ud/complywithtext.py | 81 ++++++++++++++++++++++++--------
 1 file changed, 62 insertions(+), 19 deletions(-)

diff --git a/udapi/block/ud/complywithtext.py b/udapi/block/ud/complywithtext.py
index 1a13a4ec..02904731 100644
--- a/udapi/block/ud/complywithtext.py
+++ b/udapi/block/ud/complywithtext.py
@@ -24,7 +24,7 @@
 """
 import difflib
 import logging
-import re
+import regex
 
 from udapi.core.block import Block
 from udapi.core.mwt import MWT
@@ -34,6 +34,7 @@ class ComplyWithText(Block):
     """Adapt the nodes to comply with the text."""
 
     def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, max_mwt_length=4,
+                 allow_add_punct=True, allow_delete_punct=True, allow_hyphen_goeswith=True,
                  previous_form_attr='CorrectForm', **kwargs):
         """Args:
         fix_text: After all heuristics are applied, the token forms may still not match the text.
@@ -54,6 +55,14 @@ def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, max_mwt_
             Default=True (i.e. add the goeswith nodes if applicable).
         max_mwt_length - Maximum length of newly created multi-word tokens (in syntactic words).
             Default=4.
+        allow_add_punct - allow creating punctuation-only nodes
+        allow_delete_punct - allow deleting extra punctuation-only nodes,
+            which are not represented in root.text
+        allow_hyphen_goeswith - if e.g. node.form=="mother-in-law" corresponds to
+            "mother in law" in root.text, convert it to three nodes:
+            node1(form="mother", feats["Typo"]="Yes", misc["CorrectForm"]="mother-in-law")
+            node2(form="in", deprel="goeswith", upos="X", parent=node1)
+            node3(form="law", deprel="goeswith", upos="X", parent=node1).
         previous_form_attr - when changing node.form, we store the previous value
             in node.misc[previous_form_attr] (so no information is lost).
             Default="CorrectForm" because we expect that the previous value
@@ -62,6 +71,7 @@ def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, max_mwt_
             the original spelling with typos as found in the raw text.
             CorrectForm is defined in https://universaldependencies.org/u/overview/typos.html
             When setting this parameter to an empty string, no values will be stored to node.misc.
+            When keeping the default name CorrectForm, node.feats["Typo"] = "Yes" will be filled as well.
         """
         super().__init__(**kwargs)
         self.fix_text = fix_text
@@ -70,17 +80,20 @@ def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, max_mwt_
         self.max_mwt_length = max_mwt_length
         self.allow_add_punct = allow_add_punct
         self.allow_delete_punct = allow_delete_punct
+        self.allow_hyphen_goeswith = allow_hyphen_goeswith
         self.previous_form_attr = previous_form_attr
 
     @staticmethod
     def allow_space(form):
         """Is space allowed within this token form?"""
-        return re.fullmatch('[0-9 ]+([,.][0-9]+)?', form)
+        return regex.fullmatch('[0-9 ]+([,.][0-9]+)?', form)
 
     def store_previous_form(self, node):
         """Store the previous form of this node into MISC, unless the change is common&expected."""
-        if node.form not in ("''", "``"):
+        if node.form not in ("''", "``") and self.previous_form_attr:
             node.misc[self.previous_form_attr] = node.form
+            if self.previous_form_attr == 'CorrectForm':
+                node.feats['Typo'] = 'Yes'
 
     def process_tree(self, root):
         text = root.text
@@ -190,18 +203,38 @@ def solve_diffs(self, diffs, tree_chars, char_nodes, text):
         for diff in diffs:
             edit, tree_lo, tree_hi, text_lo, text_hi = diff
 
-            # Focus only on edits of type 'replace', log insertions and deletions as failures.
             if edit == 'equal':
-                continue
-            if edit in ('insert', 'delete'):
-                logging.warning('Unable to solve token-vs-text mismatch\n%s',
-                                _diff2str(diff, tree_chars, text))
-                continue
-
-            # Revert the splittng and solve the diff.
-            nodes = [n for n in char_nodes[tree_lo:tree_hi] if n is not None]
-            form = text[text_lo:text_hi]
-            self.solve_diff(nodes, form.strip())
+                pass
+            elif edit == 'insert':
+                forms = text[text_lo:text_hi].split(' ')
+                if all(regex.fullmatch('\p{P}+', f) for f in forms) and self.allow_add_punct:
+                    #logging.info(f'trying to add {forms} before {char_nodes[tree_lo]}')
+                    next_node = char_nodes[tree_lo]
+                    for f in reversed(forms):
+                        new = next_node.create_child(form=f, deprel='punct', upos='PUNCT')
+                        new.shift_before_node(next_node)
+                        new.misc['Added'] = 1
+                else:
+                    logging.warning('Unable to insert nodes\n%s',
+                                    _diff2str(diff, tree_chars, text))
+            elif edit == 'delete':
+                nodes = [n for n in char_nodes[tree_lo:tree_hi] if n is not None]
+                if all(regex.fullmatch('\p{P}+', n.form) for n in nodes):
+                    if self.allow_delete_punct:
+                        for node in nodes:
+                            node.remove(children='rehang')
+                    else:
+                        logging.warning('Unable to delete punctuation nodes (try ud.ComplyWithText allow_delete_punct=1)\n%s',
+                                        _diff2str(diff, tree_chars, text))
+                else:
+                    logging.warning('Unable to delete non-punctuation nodes\n%s',
+                                        _diff2str(diff, tree_chars, text))
+            else:
+                assert edit == 'replace'
+                # Revert the splittng and solve the diff.
+                nodes = [n for n in char_nodes[tree_lo:tree_hi] if n is not None]
+                form = text[text_lo:text_hi]
+                self.solve_diff(nodes, form.strip())
 
     def solve_diff(self, nodes, form):
         """Fix a given (minimal) tokens-vs-text inconsistency."""
@@ -210,20 +243,25 @@ def solve_diff(self, nodes, form):
 
         # First, solve the cases when the text contains a space.
         if ' ' in form:
-            if len(nodes) == 1 and node.form == form.replace(' ', ''):
+            node_form = node.form
+            if self.allow_hyphen_goeswith and node_form.replace('-', ' ') == form:
+                node_form = node_form.replace('-', '')
+            if len(nodes) == 1 and node_form == form.replace(' ', ''):
                 if self.allow_space(form):
                     self.store_previous_form(node)
                     node.form = form
                 elif self.allow_goeswith:
+                    self.store_previous_form(node)
                     forms = form.split()
                     node.form = forms[0]
+                    node.feats['Typo'] = 'Yes'
                     for split_form in reversed(forms[1:]):
-                        new = node.create_child(form=split_form, deprel='goeswith', upos=node.upos)
+                        new = node.create_child(form=split_form, deprel='goeswith', upos='X')
                         new.shift_after_node(node)
                 else:
                     logging.warning('Unable to solve 1:m diff:\n%s -> %s', nodes_str, form)
             else:
-                logging.warning('Unable to solve n:m diff:\n%s -> %s', nodes_str, form)
+                logging.warning(f'Unable to solve {len(nodes)}:{len(form.split(" "))} diff:\n{nodes_str} -> {form}')
 
         # Second, solve the cases when multiple nodes match one form (without any spaces).
         elif len(nodes) > 1:
@@ -244,8 +282,13 @@ def solve_diff(self, nodes, form):
 
         # Third, solve the 1-1 cases.
         else:
-            self.store_previous_form(node)
-            node.form = form
+            if self.allow_add_punct and form.startswith(node.form) and regex.fullmatch('\p{P}+', form[len(node.form):]):
+                new = node.create_child(form=form[len(node.form):], deprel='punct', upos='PUNCT')
+                new.shift_after_node(node)
+                new.misc['Added'] = 1
+            else:
+                self.store_previous_form(node)
+                node.form = form
 
 
 def _nodes_to_chars(nodes):

From d5a1a2a756ef13629984eb40af7b5853dbd8c7a0 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 8 Feb 2023 18:06:45 +0100
Subject: [PATCH 0780/1374] udapy hints when using a wrong block name or
 parameter name

thanks to @michnov for this idea
---
 udapi/core/block.py | 23 +++++++++++++++++++----
 udapi/core/run.py   | 33 +++++++++++++++++++++++++++++++--
 2 files changed, 50 insertions(+), 6 deletions(-)

diff --git a/udapi/core/block.py b/udapi/core/block.py
index f039abce..fdcad9fa 100644
--- a/udapi/core/block.py
+++ b/udapi/core/block.py
@@ -1,5 +1,6 @@
 """Block class represents the basic Udapi processing unit."""
 import logging
+import inspect
 
 def not_overridden(method):
   method.is_not_overridden = True
@@ -14,9 +15,23 @@ class Block(object):
         Possible values are: process (default), skip, skip_warn, fail, delete.
     """
 
-    def __init__(self, zones='all', if_empty_tree='process'):
+    def __init__(self, zones='all', if_empty_tree='process', **kwargs):
         self.zones = zones
         self.if_empty_tree = if_empty_tree
+        if kwargs:
+            params = set()
+            for cls in type(self).mro()[:-1]:
+                params.update(inspect.signature(cls.__init__).parameters.keys())
+            params -= {'self', 'kwargs'}
+            raise TypeError(f"Extra parameters {kwargs}.\n"
+                            f"Parameters of {self.block_name()} are:\n"
+                            + '\n'.join(sorted(params)))
+
+    def block_name(self):
+        module = ".".join(self.__module__.split(".")[:-1])
+        if module.startswith('udapi.block.'):
+            module = module[12:]
+        return module + "." + self.__class__.__name__
 
     def process_start(self):
         """A hook method that is executed before processing UD data"""
@@ -73,7 +88,7 @@ def process_document(self, document):
         p_tree = not hasattr(self.process_tree, 'is_not_overridden')
         p_node = not hasattr(self.process_node, 'is_not_overridden')
         if not any((p_entity, p_mention, p_bundle, p_tree, p_node)):
-            raise Exception("No processing activity defined in block " + str(self))
+            raise Exception("No processing activity defined in block " + self.block_name())
 
         if p_entity or p_mention:
             for entity in document.coref_entities:
@@ -85,8 +100,8 @@ def process_document(self, document):
 
         if p_bundle or p_tree or p_node:
             for bundle_no, bundle in enumerate(document.bundles, 1):
-                logging.debug('Block %s processing bundle #%d (id=%s)',
-                            self.__class__.__name__, bundle_no, bundle.bundle_id)
+                logging.debug(f'Block {self.block_name()} processing '
+                              f'bundle #{bundle_no} (id={bundle.bundle_id})')
                 if p_bundle:
                     self.process_bundle(bundle)
                 else:
diff --git a/udapi/core/run.py b/udapi/core/run.py
index a0cc4a9a..418baca6 100644
--- a/udapi/core/run.py
+++ b/udapi/core/run.py
@@ -67,6 +67,26 @@ def _parse_command_line_arguments(scenario):
     return block_names, block_args
 
 
+def _blocks_in_a_package(package_name):
+    import importlib.util, pkgutil
+
+    if not importlib.util.find_spec(package_name):
+        return []
+    try:
+        package = __import__(package_name, fromlist="dummy")
+        submodule_names = [m.name for m in pkgutil.iter_modules(package.__path__)]
+        pname = package_name
+        if pname.startswith("udapi.block."):
+            pname = pname[12:]
+        blocks = []
+        for sname in submodule_names:
+            module =  __import__(f"{package_name}.{sname}", fromlist="dummy")
+            bname = [c for c in dir(module) if c.lower() == sname][0]
+            blocks.append(f"{pname}.{bname}")
+        return blocks
+    except:
+            return []
+
 def _import_blocks(block_names, block_args):
     """
     Parse block names, import particular packages and call the constructor for each object.
@@ -92,8 +112,17 @@ def _import_blocks(block_names, block_args):
             command = "from " + module + " import " + class_name + " as b" + str(block_id)
             logging.debug("Trying to run command: %s", command)
             exec(command)  # pylint: disable=exec-used
-        except Exception:
-            logging.warning("Error when trying import the block %s", block_name)
+        except ModuleNotFoundError as err:
+            package_name = ".".join(module.split(".")[:-1])
+            blocks = _blocks_in_a_package(package_name)
+            if not blocks:
+                raise
+            raise ModuleNotFoundError(
+                f"Cannot find block {block_name} (i.e. class {module}.{class_name})\n"
+                f"Available block in {package_name} are:\n"
+                + "\n".join(_blocks_in_a_package(package_name))) from err
+        except Exception as ex:
+            logging.warning(f"Cannot import block {block_name} (i.e. class {module}.{class_name})")
             raise
 
         # Run the imported module.

From 49ed44d2e309523cdf3361c599934d5dbf58a2a8 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 8 Feb 2023 18:23:36 +0100
Subject: [PATCH 0781/1374] read.XY files='!*.conllu' should iterated over
 sorted files

glob.glob() returns files in an arbitrary order (as `ls -U`)
---
 udapi/core/files.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/core/files.py b/udapi/core/files.py
index c6973dad..be59b2c0 100644
--- a/udapi/core/files.py
+++ b/udapi/core/files.py
@@ -65,7 +65,7 @@ def string_to_filenames(self, string):
     def _token_to_filenames(token):
         if token[0] == '!':
             pattern = token[1:]
-            filenames = glob.glob(pattern)
+            filenames = sorted(glob.glob(pattern))
             if not filenames:
                 raise RuntimeError('No filenames matched "%s" pattern' % pattern)
         elif token[0] == '@':

From 1a4241104709e7647cf75ff84dbc68df3428fbe0 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 9 Feb 2023 23:49:11 +0100
Subject: [PATCH 0782/1374] improve ud.ComplyWithText (for KorKor)

---
 udapi/block/ud/complywithtext.py | 70 ++++++++++++++++++++------------
 1 file changed, 45 insertions(+), 25 deletions(-)

diff --git a/udapi/block/ud/complywithtext.py b/udapi/block/ud/complywithtext.py
index 02904731..c850018e 100644
--- a/udapi/block/ud/complywithtext.py
+++ b/udapi/block/ud/complywithtext.py
@@ -35,7 +35,8 @@ class ComplyWithText(Block):
 
     def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, max_mwt_length=4,
                  allow_add_punct=True, allow_delete_punct=True, allow_hyphen_goeswith=True,
-                 previous_form_attr='CorrectForm', **kwargs):
+                 previous_form_label='CorrectForm', previous_text_label='CorrectText',
+                 added_label='Added', **kwargs):
         """Args:
         fix_text: After all heuristics are applied, the token forms may still not match the text.
             Should we edit the text to match the token forms (as a last resort)? Default=True.
@@ -63,8 +64,8 @@ def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, max_mwt_
             node1(form="mother", feats["Typo"]="Yes", misc["CorrectForm"]="mother-in-law")
             node2(form="in", deprel="goeswith", upos="X", parent=node1)
             node3(form="law", deprel="goeswith", upos="X", parent=node1).
-        previous_form_attr - when changing node.form, we store the previous value
-            in node.misc[previous_form_attr] (so no information is lost).
+        previous_form_label - when changing node.form, we store the previous value
+            in node.misc[previous_form_label] (so no information is lost).
             Default="CorrectForm" because we expect that the previous value
             (i.e. the value of node.form before applying this block)
             contained the corrected spelling, while root.text contains
@@ -72,6 +73,12 @@ def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, max_mwt_
             CorrectForm is defined in https://universaldependencies.org/u/overview/typos.html
             When setting this parameter to an empty string, no values will be stored to node.misc.
             When keeping the default name CorrectForm, node.feats["Typo"] = "Yes" will be filled as well.
+        previous_text_label - when we are not able to adapt the annotation to match root.text
+            and fix_text is True, we store the previous root.text in a CoNLL-U comment with this label.
+            Default="CorrectText". When setting this parameter to an empty string,
+            no values will be stored to root.comment.
+        added_label - when creating new nodes because allow_add_punct=True, we mark these nodes
+            as new_node.misc[added_label] = 1. Default="Added".
         """
         super().__init__(**kwargs)
         self.fix_text = fix_text
@@ -81,7 +88,9 @@ def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, max_mwt_
         self.allow_add_punct = allow_add_punct
         self.allow_delete_punct = allow_delete_punct
         self.allow_hyphen_goeswith = allow_hyphen_goeswith
-        self.previous_form_attr = previous_form_attr
+        self.previous_form_label = previous_form_label
+        self.previous_text_label = previous_text_label
+        self.added_label = added_label
 
     @staticmethod
     def allow_space(form):
@@ -90,9 +99,9 @@ def allow_space(form):
 
     def store_previous_form(self, node):
         """Store the previous form of this node into MISC, unless the change is common&expected."""
-        if node.form not in ("''", "``") and self.previous_form_attr:
-            node.misc[self.previous_form_attr] = node.form
-            if self.previous_form_attr == 'CorrectForm':
+        if node.form not in ("''", "``") and self.previous_form_label:
+            node.misc[self.previous_form_label] = node.form
+            if self.previous_form_label == 'CorrectForm':
                 node.feats['Typo'] = 'Yes'
 
     def process_tree(self, root):
@@ -140,7 +149,8 @@ def process_tree(self, root):
         if self.fix_text:
             computed_text = root.compute_text()
             if text != computed_text:
-                root.add_comment('ToDoOrigText = ' + root.text)
+                if self.previous_text_label:
+                    root.add_comment(f'{self.previous_text_label} = {root.text}')
                 root.text = computed_text
 
     def unspace_diffs(self, orig_diffs, tree_chars, text):
@@ -152,6 +162,10 @@ def unspace_diffs(self, orig_diffs, tree_chars, text):
                     tree_lo += 1
                 if tree_chars[tree_hi - 1] == ' ':
                     tree_hi -= 1
+                if text[text_lo] == ' ':
+                    text_lo += 1
+                if text[text_hi - 1] == ' ':
+                    text_hi -= 1
             old = tree_chars[tree_lo:tree_hi]
             new = text[text_lo:text_hi]
             if old == '' and new == '':
@@ -208,12 +222,11 @@ def solve_diffs(self, diffs, tree_chars, char_nodes, text):
             elif edit == 'insert':
                 forms = text[text_lo:text_hi].split(' ')
                 if all(regex.fullmatch('\p{P}+', f) for f in forms) and self.allow_add_punct:
-                    #logging.info(f'trying to add {forms} before {char_nodes[tree_lo]}')
                     next_node = char_nodes[tree_lo]
                     for f in reversed(forms):
                         new = next_node.create_child(form=f, deprel='punct', upos='PUNCT')
                         new.shift_before_node(next_node)
-                        new.misc['Added'] = 1
+                        new.misc[self.added_label] = 1
                 else:
                     logging.warning('Unable to insert nodes\n%s',
                                     _diff2str(diff, tree_chars, text))
@@ -246,18 +259,26 @@ def solve_diff(self, nodes, form):
             node_form = node.form
             if self.allow_hyphen_goeswith and node_form.replace('-', ' ') == form:
                 node_form = node_form.replace('-', '')
-            if len(nodes) == 1 and node_form == form.replace(' ', ''):
-                if self.allow_space(form):
-                    self.store_previous_form(node)
-                    node.form = form
-                elif self.allow_goeswith:
-                    self.store_previous_form(node)
-                    forms = form.split()
-                    node.form = forms[0]
-                    node.feats['Typo'] = 'Yes'
-                    for split_form in reversed(forms[1:]):
-                        new = node.create_child(form=split_form, deprel='goeswith', upos='X')
+            if len(nodes) == 1:
+                if node_form == form.replace(' ', ''):
+                    if self.allow_space(form):
+                        self.store_previous_form(node)
+                        node.form = form
+                    elif self.allow_goeswith:
+                        self.store_previous_form(node)
+                        forms = form.split()
+                        node.form = forms[0]
+                        node.feats['Typo'] = 'Yes'
+                        for split_form in reversed(forms[1:]):
+                            new = node.create_child(form=split_form, deprel='goeswith', upos='X')
+                            new.shift_after_node(node)
+                    else:
+                        logging.warning('Unable to solve 1:m diff:\n%s -> %s', nodes_str, form)
+                elif self.allow_add_punct and form.startswith(node.form) and regex.fullmatch('[ \p{P}]+', form[len(node.form):]):
+                    for punct_form in reversed(form[len(node.form):].split()):
+                        new = node.create_child(form=punct_form, lemma=punct_form, deprel='punct', upos='PUNCT')
                         new.shift_after_node(node)
+                        new.misc[self.added_label] = 1
                 else:
                     logging.warning('Unable to solve 1:m diff:\n%s -> %s', nodes_str, form)
             else:
@@ -283,9 +304,10 @@ def solve_diff(self, nodes, form):
         # Third, solve the 1-1 cases.
         else:
             if self.allow_add_punct and form.startswith(node.form) and regex.fullmatch('\p{P}+', form[len(node.form):]):
-                new = node.create_child(form=form[len(node.form):], deprel='punct', upos='PUNCT')
+                punct_form = form[len(node.form):]
+                new = node.create_child(form=punct_form, lemma=punct_form, deprel='punct', upos='PUNCT')
                 new.shift_after_node(node)
-                new.misc['Added'] = 1
+                new.misc[self.added_label] = 1
             else:
                 self.store_previous_form(node)
                 node.form = form
@@ -313,6 +335,4 @@ def _log_diffs(diffs, tree_chars, text, msg):
 def _diff2str(diff, tree, text):
     old = '|' + ''.join(tree[diff[1]:diff[2]]) + '|'
     new = '|' + ''.join(text[diff[3]:diff[4]]) + '|'
-    if diff[0] == 'equal':
-        return '{:7} {!s:>50}'.format(diff[0], old)
     return '{:7} {!s:>50} --> {!s}'.format(diff[0], old, new)

From 3abb76df036f7aa2e8f39437aa7d5b80032ae850 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 10 Feb 2023 14:08:12 +0100
Subject: [PATCH 0783/1374] ud.ComplyWithText fix_text=1 should always produce
 valid CoNLL-U

even if the raw texts include double spaces or no-break spaces
(TODO: alternatively, we could annotate these using SpacesAfter).
---
 udapi/block/ud/complywithtext.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/complywithtext.py b/udapi/block/ud/complywithtext.py
index c850018e..351ebc01 100644
--- a/udapi/block/ud/complywithtext.py
+++ b/udapi/block/ud/complywithtext.py
@@ -109,9 +109,13 @@ def process_tree(self, root):
         if text is None:
             raise ValueError('Tree %s has no text, cannot use ud.ComplyWithText' % root)
 
-        # Normalize the stored text (double space -> single space)
+        # Normalize the stored text (e.g. double space or no-break space -> single space)
         # and skip sentences which are already ok.
         text = ' '.join(text.split())
+        if root.text != text and self.fix_text:
+            if self.previous_text_label:
+                root.add_comment(f'{self.previous_text_label} = {root.text}')
+            root.text = text
         if text == root.compute_text():
             return
 

From 0c6f946802345cc670ece9663fc7007ff05efd73 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 10 Feb 2023 14:09:36 +0100
Subject: [PATCH 0784/1374] corefud.PrintMentions should show Entity
 annotations in MISC by default

---
 udapi/block/corefud/printmentions.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/corefud/printmentions.py b/udapi/block/corefud/printmentions.py
index 12db433a..d011f686 100644
--- a/udapi/block/corefud/printmentions.py
+++ b/udapi/block/corefud/printmentions.py
@@ -12,7 +12,7 @@ def __init__(self, continuous='include', almost_continuous='include', treelet='i
                  empty='include', max_trees=0, html=False, shuffle=True, print_other_forms=5,
                  print_total=True, print_should=True,
                  print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
-                 minimize_cross=True, color=True, attributes='form,upos,deprel',
+                 minimize_cross=True, color=True, attributes='ord,form,upos,deprel,misc',
                  print_undef_as='_', print_doc_meta=True, print_comments=False,
                  mark='(Mark)', hints=True, layout='classic',
                  **kwargs):

From f9dd071481e49944fe6c70629bf9d56a90bd86d6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 10 Feb 2023 14:27:46 +0100
Subject: [PATCH 0785/1374] keep newdoc and global.Entity when using
 read.Conllu sent_id_filter=regex

The global.Entity comment will be read automatically by read.Conllu
and then inserted automatically by write.Conllu, but only for trees
with tree.newdoc, so we need to keep this annotation as well
(move it to the new first tree in a given document).
---
 udapi/core/basereader.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index a841bf1b..71d57159 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -97,13 +97,19 @@ def filtered_read_tree(self):
         tree = self.read_tree()
         if self.sent_id_filter is None:
             return tree
+
+        skipped_newdoc = None
         while True:
             if tree is None:
                 return None
             if self.sent_id_filter.match(tree.sent_id) is not None:
+                if skipped_newdoc and not tree.newdoc:
+                    tree.newdoc = skipped_newdoc
                 return tree
             logging.debug('Skipping sentence %s as it does not match the sent_id_filter %s.',
                           tree.sent_id, self.sent_id_filter)
+            if tree.newdoc:
+                skipped_newdoc = tree.newdoc
             tree = self.read_tree()
 
     def try_fast_load(self, document):

From b036d572af97a9f06482ccdcd7e90cfe4f0f5655 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 10 Feb 2023 15:15:48 +0100
Subject: [PATCH 0786/1374] update ord of empty nodes when deleting preceding
 nonempty nodes

TODO: add tests, solve also deleting of empty nodes
---
 udapi/core/node.py | 30 ++++++++++++++++++++++++++++--
 1 file changed, 28 insertions(+), 2 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 618e75eb..8a764498 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -516,6 +516,7 @@ def remove(self, children=None):
             `rehang_warn` means to rehang and warn:-).
         """
         self._parent._children.remove(self)
+        empty_follows = None
         if children is not None and self._children:
             if children.startswith('rehang'):
                 for child in self._children:
@@ -523,6 +524,16 @@ def remove(self, children=None):
                 self._parent._children.extend(self._children)
                 self._parent._children.sort()
                 self._children.clear()
+            elif self._root.empty_nodes:
+                will_be_removed = self.descendants(add_self=1)
+                prev_nonempty = self._root
+                empty_follows = {}
+                for node in self._root.descendants_and_empty:
+                    if node.empty:
+                        empty_follows[node] = prev_nonempty
+                    elif node not in will_be_removed:
+                        prev_nonempty = node
+
             if children.endswith('warn'):
                 logging.warning('%s is being removed by remove(children=%s), '
                                 ' but it has (unexpected) children', self, children)
@@ -536,14 +547,29 @@ def remove(self, children=None):
                 self._root._descendants.remove(self)
             except ValueError:
                 pass # self may be an already deleted node e.g. if n.remove() called twice
-            for (new_ord, node) in enumerate(self._root._descendants[self._ord - 1:], self._ord):
-                node.ord = new_ord
+            else:
+                for (new_ord, node) in enumerate(self._root._descendants[self._ord - 1:], self._ord):
+                    node.ord = new_ord
+                for empty in self._root.empty_nodes:
+                    if empty > self:
+                        empty.ord = round(empty.ord - 1, 1)
         else:
             # TODO nodes_to_remove = self.unordered_descendants()
             # and mark all nodes as deleted, remove them from MWT and coref mentions
             self._root._descendants = sorted(self._root.unordered_descendants())
             for (new_ord, node) in enumerate(self._root._descendants, 1):
                 node.ord = new_ord
+            # Decrease ord of empty nodes (keep their fractional part)
+            # Make sure that e.g. after deleting node with ord=2
+            # ords "1 1.1 1.2 2 2.1" will become "1 1.1 1.2 1.3".
+            if empty_follows:
+                last_ord = 0
+                for empty in self._root.empty_nodes:
+                    prev_nonempty = empty_follows[empty]
+                    new_ord = round(prev_nonempty.ord + (empty.ord % 1), 1)
+                    while new_ord <= last_ord:
+                        new_ord = round(new_ord + 0.1, 1)
+                    last_ord, empty.ord = new_ord, new_ord
 
     def _shift_before_ord(self, reference_ord, without_children=False):
         """Internal method for changing word order."""

From 6c289d3bda8134a683f6362198888ee920520203 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 10 Feb 2023 16:32:51 +0100
Subject: [PATCH 0787/1374] ud.ComplyWithText: the previous root.text value is
 better described as OrigText

Unlike the previous node.form values, it is (usually) the original raw text including typos etc,
so the label "CorrectText" was completely misleading.
---
 udapi/block/ud/complywithtext.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/complywithtext.py b/udapi/block/ud/complywithtext.py
index 351ebc01..b36b2512 100644
--- a/udapi/block/ud/complywithtext.py
+++ b/udapi/block/ud/complywithtext.py
@@ -35,7 +35,7 @@ class ComplyWithText(Block):
 
     def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, max_mwt_length=4,
                  allow_add_punct=True, allow_delete_punct=True, allow_hyphen_goeswith=True,
-                 previous_form_label='CorrectForm', previous_text_label='CorrectText',
+                 previous_form_label='CorrectForm', previous_text_label='OrigText',
                  added_label='Added', **kwargs):
         """Args:
         fix_text: After all heuristics are applied, the token forms may still not match the text.
@@ -74,8 +74,8 @@ def __init__(self, fix_text=True, prefer_mwt=True, allow_goeswith=True, max_mwt_
             When setting this parameter to an empty string, no values will be stored to node.misc.
             When keeping the default name CorrectForm, node.feats["Typo"] = "Yes" will be filled as well.
         previous_text_label - when we are not able to adapt the annotation to match root.text
-            and fix_text is True, we store the previous root.text in a CoNLL-U comment with this label.
-            Default="CorrectText". When setting this parameter to an empty string,
+            and fix_text is True, we store the previous root.text value in a CoNLL-U comment with this label.
+            Default="OrigText". When setting this parameter to an empty string,
             no values will be stored to root.comment.
         added_label - when creating new nodes because allow_add_punct=True, we mark these nodes
             as new_node.misc[added_label] = 1. Default="Added".

From 043f4d73745a0155db76d5f4776d77f7ceeeba8a Mon Sep 17 00:00:00 2001
From: "Federica Gamba (PhD" <gamba@cyan.ms.mff.cuni.cz>
Date: Fri, 17 Feb 2023 16:47:25 +0100
Subject: [PATCH 0788/1374] minor changes in Latin feature rules

---
 udapi/block/ud/la/markfeatsbugs.py | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/la/markfeatsbugs.py b/udapi/block/ud/la/markfeatsbugs.py
index 111bceb9..fde3b0bd 100644
--- a/udapi/block/ud/la/markfeatsbugs.py
+++ b/udapi/block/ud/la/markfeatsbugs.py
@@ -27,8 +27,11 @@ def __init__(self, flavio=False, **kwargs):
     def process_node(self, node):
         rf = []
         af = {}
+        # PROIEL-specific: greek words without features
+        if node.lemma == 'greek.expression':
+            pass
         # NOUNS ################################################################
-        if node.upos == 'NOUN':
+        elif node.upos == 'NOUN':
             if node.feats['Case'] and not node.feats['Abbr'] == 'Yes': # abbreviated or indeclinable nouns
                 rf = ['Gender', 'Number', 'Case']
             af = {
@@ -125,14 +128,14 @@ def process_node(self, node):
             af['PronType'] = []
             if node.lemma in ['is', 'ego', 'tu', 'sui', 'seipsum', 'nos', 'uos', 'vos', 'tumetipse', 'nosmetipse']:
                 af['PronType'].append('Prs')
-            elif node.lemma in ['quis', 'aliquis', 'nihil', 'nemo', 'quivis']:
+            elif node.lemma in ['quis', 'aliquis', 'nihil', 'nemo', 'quivis', 'qui']:
                 af['PronType'].append('Ind')
             elif node.lemma in ['inuicem', 'invicem']:
                 af['PronType'].append('Rcp')
                 rf.remove('Case')
-            elif node.lemma in ['quicumque', 'qui', 'quisquis']:
+            if node.lemma in ['quicumque', 'qui', 'quisquis']:
                 af['PronType'].append('Rel')
-            if node.lemma in ['qui', 'quis', 'quisnam', 'ecquis']:
+            if node.lemma in ['qui', 'quis', 'quisnam', 'ecquis', 'ecqui']:
                 af['PronType'].append('Int')
             if self.flavio:
                 # Flavio added InflClass but not everywhere, so it is not required.
@@ -176,7 +179,7 @@ def process_node(self, node):
                 af['PronType'].append('Ind')
             elif node.lemma in ['omnis', 'totus', 'ambo', 'cunctus', 'unusquisque', 'uniuersus']:
                 af['PronType'].append('Tot')
-            if node.lemma in ['quantus', 'qualis', 'quicumque', 'quot', 'quotus']:
+            if node.lemma in ['quantus', 'qualis', 'quicumque', 'quot', 'quotus', 'quotquot']:
                 af['PronType'].append('Rel')
             elif node.lemma in ['qui', 'quantus', 'quot']:
                 af['PronType'].append('Int')

From e84741a6e78acaaf13739945bd17814d569e3601 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 17 Feb 2023 22:06:56 +0100
Subject: [PATCH 0789/1374] Remove NOCOREF entities e.g. from AnCora.

---
 udapi/block/corefud/removenocorefentities.py | 21 ++++++++++++++++++++
 udapi/core/coref.py                          |  2 +-
 2 files changed, 22 insertions(+), 1 deletion(-)
 create mode 100644 udapi/block/corefud/removenocorefentities.py

diff --git a/udapi/block/corefud/removenocorefentities.py b/udapi/block/corefud/removenocorefentities.py
new file mode 100644
index 00000000..8baba086
--- /dev/null
+++ b/udapi/block/corefud/removenocorefentities.py
@@ -0,0 +1,21 @@
+from udapi.core.block import Block
+import udapi.core.coref
+import re
+import logging
+
+class RemoveNoCorefEntities(Block):
+    """
+    Some corpora (e.g., AnCora) include annotation of named entities that are
+    not annotated for coreference. To distinguish them, their cluster ID starts
+    with 'NOCOREF' (optionally followed by entity type, so that one cluster
+    still has just one type). We may want to remove such entities from datasets
+    that are used to train coreference resolves, to prevent the resolvers from
+    thinking that all members of a NOCOREF cluster are coreferential. That is
+    what this block does.
+    """
+
+    def process_document(self, doc):
+        entities = doc.coref_entities
+        if not entities:
+            return
+        doc.coref_entities = [e for e in entities if not re.match(r'^NOCOREF', e.eid)]
diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 12dda239..4cd656f1 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -300,7 +300,7 @@ def __init__(self, eid, etype=None):
         self.split_ante = []
 
     def __lt__(self, another):
-        """Does this CorefEntity precedes (word-order wise) `another` entity?
+        """Does this CorefEntity precede (word-order wise) `another` entity?
 
         This method defines a total ordering of all entities
         by the first mention of each entity (see `CorefMention.__lt__`).

From 16c3a48ed3eb7861757092649a6ece22b893151c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 17 Feb 2023 22:27:19 +0100
Subject: [PATCH 0790/1374] Another method of removing entities.

---
 udapi/block/corefud/removenocorefentities.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/corefud/removenocorefentities.py b/udapi/block/corefud/removenocorefentities.py
index 8baba086..4551873c 100644
--- a/udapi/block/corefud/removenocorefentities.py
+++ b/udapi/block/corefud/removenocorefentities.py
@@ -18,4 +18,4 @@ def process_document(self, doc):
         entities = doc.coref_entities
         if not entities:
             return
-        doc.coref_entities = [e for e in entities if not re.match(r'^NOCOREF', e.eid)]
+        doc._eid_to_entity = {e._eid: e for e in entities if not re.match(r'^NOCOREF', e.eid)}

From 8b442889aca3c1b881d7d53896d1eb0547635cfa Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Tue, 21 Feb 2023 15:52:18 +0100
Subject: [PATCH 0791/1374] CorefUD: counting sentence sequences with no coref
 annotation

---
 udapi/block/corefud/countgaps.py | 67 ++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 udapi/block/corefud/countgaps.py

diff --git a/udapi/block/corefud/countgaps.py b/udapi/block/corefud/countgaps.py
new file mode 100644
index 00000000..c8ee8d76
--- /dev/null
+++ b/udapi/block/corefud/countgaps.py
@@ -0,0 +1,67 @@
+from udapi.core.block import Block
+from collections import Counter
+
+class CountGaps(Block):
+    """Block corefud.checkConsistency searches for sentence sequences with no coref annotation."""
+
+    def __init__(self, report_per_newdoc=False, report_per_file=True, report_total=True, **kwargs):
+        super().__init__(**kwargs)
+        self.report_per_newdoc = report_per_newdoc
+        self.report_per_file = report_per_file
+        self.report_total = report_total
+        self._total_counter = Counter()
+
+    def _report_stats(self, counter=None, header_id=None):
+        if not counter:
+            counter = self._total_counter
+        if header_id:
+            print(f"============ {header_id} ============")
+        for key in sorted(counter):
+            print(f"{key:2d}: {counter[key]}")
+
+    def _count_empty_seqs(self, empty_seqs):
+        counter = Counter()
+        for seq in empty_seqs:
+            counter[len(seq)] += 1
+        return counter
+
+    def process_document(self, doc):
+        file_counter = Counter()
+        empty_seqs = []
+        curr_seq = []
+        newdoc = None
+        for i, tree in enumerate(doc.trees):
+            if tree.newdoc:
+                if i:
+                    if curr_seq:
+                        empty_seqs.append(curr_seq)
+                    newdoc_counter = self._count_empty_seqs(empty_seqs)
+                    file_counter.update(newdoc_counter)
+                    if self.report_per_newdoc:
+                        self._report_stats(newdoc_counter, header_id=newdoc)
+                newdoc = tree.newdoc
+                empty_seqs = []
+                curr_seq = []
+
+            has_mention = any(node.coref_mentions for node in tree.descendants)
+            if not has_mention:
+                curr_seq.append(tree.sent_id)
+            elif curr_seq:
+                empty_seqs.append(curr_seq)
+                curr_seq = []
+        
+        if curr_seq:
+            empty_seqs.append(curr_seq)
+        newdoc_counter = self._count_empty_seqs(empty_seqs)
+        file_counter.update(newdoc_counter)
+        if self.report_per_newdoc:
+            self._report_stats(newdoc_counter, header_id=newdoc)
+
+        if self.report_per_file:
+            self._report_stats(file_counter, header_id="FULL DOC")
+
+        self._total_counter.update(file_counter)
+
+    def process_end(self):
+        if self.report_total:
+            self._report_stats(header_id="TOTAL")

From 716461fe3b67711f71a8cee028668fe34ceffef0 Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Tue, 21 Feb 2023 19:22:33 +0100
Subject: [PATCH 0792/1374] besides sequences, counting also paragraphs with no
 coref mentions

---
 udapi/block/corefud/countgaps.py | 63 +++++++++++++++++++++++---------
 1 file changed, 45 insertions(+), 18 deletions(-)

diff --git a/udapi/block/corefud/countgaps.py b/udapi/block/corefud/countgaps.py
index c8ee8d76..fc45540a 100644
--- a/udapi/block/corefud/countgaps.py
+++ b/udapi/block/corefud/countgaps.py
@@ -1,5 +1,5 @@
 from udapi.core.block import Block
-from collections import Counter
+from collections import defaultdict, Counter
 
 class CountGaps(Block):
     """Block corefud.checkConsistency searches for sentence sequences with no coref annotation."""
@@ -9,15 +9,15 @@ def __init__(self, report_per_newdoc=False, report_per_file=True, report_total=T
         self.report_per_newdoc = report_per_newdoc
         self.report_per_file = report_per_file
         self.report_total = report_total
-        self._total_counter = Counter()
+        self._total_counter = defaultdict(Counter)
 
-    def _report_stats(self, counter=None, header_id=None):
-        if not counter:
-            counter = self._total_counter
+    def _report_stats(self, counter, header_id=None):
         if header_id:
             print(f"============ {header_id} ============")
         for key in sorted(counter):
             print(f"{key:2d}: {counter[key]}")
+        print("-------")
+        print(f"SUM: {sum([k*counter[k] for k in counter])}")
 
     def _count_empty_seqs(self, empty_seqs):
         counter = Counter()
@@ -26,42 +26,69 @@ def _count_empty_seqs(self, empty_seqs):
         return counter
 
     def process_document(self, doc):
-        file_counter = Counter()
+        file_counters = defaultdict(Counter)
         empty_seqs = []
+        empty_pars = []
         curr_seq = []
+        curr_par = []
+        is_empty_par = True
         newdoc = None
         for i, tree in enumerate(doc.trees):
             if tree.newdoc:
                 if i:
                     if curr_seq:
                         empty_seqs.append(curr_seq)
-                    newdoc_counter = self._count_empty_seqs(empty_seqs)
-                    file_counter.update(newdoc_counter)
+                    newdoc_seq_counter = self._count_empty_seqs(empty_seqs)
+                    file_counters["seq"].update(newdoc_seq_counter)
+                    if is_empty_par:
+                        empty_pars.append(curr_par)
+                    newdoc_par_counter = self._count_empty_seqs(empty_pars)
+                    file_counters["par"].update(newdoc_par_counter)
                     if self.report_per_newdoc:
-                        self._report_stats(newdoc_counter, header_id=newdoc)
+                        self._report_stats(newdoc_seq_counter, header_id=f"SEQ STATS in {newdoc}")
+                        self._report_stats(newdoc_par_counter, header_id=f"PAR STATS in {newdoc}")
                 newdoc = tree.newdoc
                 empty_seqs = []
+                empty_pars = []
                 curr_seq = []
+                curr_par = []
+                is_empty_par = True
+            if tree.newpar:
+                if not tree.newdoc and is_empty_par:
+                    empty_pars.append(curr_par)
+                curr_par = []
+                is_empty_par = True
 
             has_mention = any(node.coref_mentions for node in tree.descendants)
             if not has_mention:
                 curr_seq.append(tree.sent_id)
-            elif curr_seq:
-                empty_seqs.append(curr_seq)
-                curr_seq = []
+                curr_par.append(tree.sent_id)
+            else:
+                if curr_seq:
+                    empty_seqs.append(curr_seq)
+                    curr_seq = []
+                is_empty_par = False
         
         if curr_seq:
             empty_seqs.append(curr_seq)
-        newdoc_counter = self._count_empty_seqs(empty_seqs)
-        file_counter.update(newdoc_counter)
+        newdoc_seq_counter = self._count_empty_seqs(empty_seqs)
+        file_counters["seq"].update(newdoc_seq_counter)
+        if curr_par:
+            empty_pars.append(curr_par)
+        newdoc_par_counter = self._count_empty_seqs(empty_pars)
+        file_counters["par"].update(newdoc_par_counter)
         if self.report_per_newdoc:
-            self._report_stats(newdoc_counter, header_id=newdoc)
+            self._report_stats(newdoc_seq_counter, header_id=f"SEQ STATS, {newdoc}")
+            self._report_stats(newdoc_par_counter, header_id=f"PAR STATS, {newdoc}")
 
         if self.report_per_file:
-            self._report_stats(file_counter, header_id="FULL DOC")
+            self._report_stats(file_counters["seq"], header_id="SEQ STATS, FILE")
+            self._report_stats(file_counters["par"], header_id="PAR STATS, FILE")
 
-        self._total_counter.update(file_counter)
+        self._total_counter["seq"].update(file_counters["seq"])
+        self._total_counter["par"].update(file_counters["par"])
 
     def process_end(self):
         if self.report_total:
-            self._report_stats(header_id="TOTAL")
+            self._report_stats(self._total_counter["seq"], header_id="SEQ STATS, TOTAL")
+            self._report_stats(self._total_counter["par"], header_id="PAR STATS, TOTAL")

From c147469f5a4a9267902974846c6ff2d804447cdb Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 25 Feb 2023 00:25:12 +0100
Subject: [PATCH 0793/1374] write.CorefHtml add visualization menu

show: eid, trees, line breaks, paragraphs
---
 udapi/block/write/corefhtml.py | 39 +++++++++++++++++++++++++++-------
 1 file changed, 31 insertions(+), 8 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index 280fc213..20f68291 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -11,7 +11,7 @@
 <title>Udapi CorefUD viewer</title>
 <script src="https://code.jquery.com/jquery-3.6.3.min.js"></script>
 '''
-# I use a pure CSS-3 solution: #overiew {resize: horizontal; overflow: auto;}
+# I use a pure CSS-3 solution: #overview {resize: horizontal; overflow: auto;}
 # so that the width of #overview can be changed by dragging the bottom right corner.
 # The following lines would make the whole right border draggable:
 #<script src="https://code.jquery.com/ui/1.13.2/jquery-ui.js"></script>
@@ -25,9 +25,19 @@
             display: grid; border-right: double;
             padding: 5px; width: 20em; background: #ddd; border-radius: 5px;
 }
+#main-menu {position:fixed; z-index:150; top: 4px; right:4px; display:none;
+            padding: 5px 55px 5px 5px; background-color:gray; border-radius: 5px;}
+#menubtn {position: fixed; right: 8px; top: 8px; z-index: 200;}
+#menubtn div {width: 30px; height: 4px; background-color: black; margin: 5px 0; transition: 0.4s;}
+.change .b1 {transform: translate(0, 9px) rotate(-45deg);}
+.change .b2 {opacity: 0;}
+.change .b3 {transform: translate(0, -9px) rotate(45deg);}
+
 .sentence span {border: 1px solid black; border-radius: 5px; padding: 2px; display:inline-block;}
+.sentence .tree span {border: none; padding: 0; display:inline;}
 .sentence span .eid {display:block; font-size: 10px;}
-.showtree {float:left; margin: 5px;}
+.showtree {margin: 5px; user-select: none;}
+.display-inline {display: inline;}
 .close{float:right; font-weight: 900; font-size: 30px; width: 36px; height: 36px; padding: 2px}
 .empty {color: gray;}
 .sentence .singleton {border-style: dotted;}
@@ -55,16 +65,22 @@
  function(e) {$("span").removeClass("active"); $("."+$(this).attr("class").split(" ")[1]).addClass("active");},
  function(e) {$("span").removeClass("active");}
 );
+
+function menuclick(x) {
+  x.classList.toggle("change");
+  $("#main-menu").toggle();
+}
+
 '''
 
 SCRIPT_SHOWTREE = '''
 $(".sentence").each(function(index){
   var sent_id = this.id;
-  $(this).before(
+  $(this).prepend(
     $("<button>", {append: "🌲", id:"button-"+sent_id, title: "show dependency tree", class: "showtree"}).on("click", function() {
       var tree_div = $("#tree-"+sent_id);
       if (tree_div.length == 0){
-        var tdiv = $("<div>", {id:"tree-"+sent_id}).insertBefore($(this));
+        var tdiv = $("<div>", {id:"tree-"+sent_id, class:"tree"}).insertAfter($(this));
         tdiv.treexView([data[index]]);
         $("<button>",{append:"×", class:"close"}).prependTo(tdiv).on("click", function(){$(this).parent().remove();});
         $('#button-'+sent_id).attr('title', 'hide dependency tree');
@@ -130,6 +146,13 @@ def process_document(self, doc):
         print('</div>')
 
         print('<div id="main">')
+        print('<div id="main-menu"><div id="menu-show">Show<br>\n'
+              ' <input id="show-eid" type="checkbox" checked onclick="$(\'.eid\').toggle();"><label for="show-eid">eid</label><br>\n'
+              ' <input id="show-trees" type="checkbox" checked onclick="$(\'.showtree\').toggle();"><label for="show-trees">trees</label><br>\n'
+              ' <input id="show-breaks" type="checkbox" checked onclick="$(\'.sentence\').toggleClass(\'display-inline\');"><label for="show-breaks">line breaks</label><br>\n'
+              ' <input id="show-pars" type="checkbox" checked onclick="$(\'.par\').toggle();"><label for="show-pars">paragraphs</label><br>\n'
+              '</div></div>\n'
+              '<button id="menubtn" onclick="menuclick(this)"><div class="b1"></div><div class="b2"></div><div class="b3"></div></button>\n')
         for tree in doc.trees:
             self.process_tree(tree, mention_ids, entity_colors)
         print('</div>')
@@ -180,7 +203,7 @@ def process_tree(self, tree, mention_ids, entity_colors):
         if tree.newdoc:
             print(f'<hr><h1>{tree.newdoc if tree.newdoc is not True else ""}</h1><hr>')
         elif tree.newpar:
-            print('<hr>')
+            print('<hr class="par">')
         opened = []
         print(f'<p class="sentence" id={_id(tree)}>')
         for node in nodes_and_empty:
@@ -188,7 +211,7 @@ def process_tree(self, tree, mention_ids, entity_colors):
                 subspan = subspans.pop()
                 self._start_subspan(subspan, mention_ids, entity_colors)
                 opened.append(subspan)
-            
+
             is_head = self._is_head(node)
             if is_head:
                 print('<b>', end='')
@@ -199,7 +222,7 @@ def process_tree(self, tree, mention_ids, entity_colors):
                 print('</i>', end='')
             if is_head:
                 print('</b>', end='')
-            
+
             while opened and opened[-1].words[-1] == node:
                 print('</span>', end='')
                 opened.pop()
@@ -229,7 +252,7 @@ def process_tree(self, tree, mention_ids, entity_colors):
 
             if not node.no_space_after:
                 print(' ', end='')
-                
+
         print('</p>')
 
     def _is_head(self, node):

From 0b30f5b75ab2a53ed5e0425d536094dee5c56f02 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 25 Feb 2023 02:53:43 +0100
Subject: [PATCH 0794/1374] more visualization options

---
 udapi/block/write/corefhtml.py | 65 +++++++++++++++++++---------------
 1 file changed, 37 insertions(+), 28 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index 20f68291..fd500e7d 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -11,13 +11,7 @@
 <title>Udapi CorefUD viewer</title>
 <script src="https://code.jquery.com/jquery-3.6.3.min.js"></script>
 '''
-# I use a pure CSS-3 solution: #overview {resize: horizontal; overflow: auto;}
-# so that the width of #overview can be changed by dragging the bottom right corner.
-# The following lines would make the whole right border draggable:
-#<script src="https://code.jquery.com/ui/1.13.2/jquery-ui.js"></script>
-#<link rel="stylesheet" href="https://code.jquery.com/ui/1.13.2/themes/base/jquery-ui.css">
-#<script>$( function() {$( "#overview" ).resizable({handles: "e"});} );</script>
-#<div id="overview" class="ui-widget-content">
+
 CSS = '''
 #wrap {display: flex; align-items: flex-start;}
 #main {width: 100%; padding: 5px; background: white; z-index:100;}
@@ -27,15 +21,19 @@
 }
 #main-menu {position:fixed; z-index:150; top: 4px; right:4px; display:none;
             padding: 5px 55px 5px 5px; background-color:gray; border-radius: 5px;}
+#main-menu div {display: inline-block;}
 #menubtn {position: fixed; right: 8px; top: 8px; z-index: 200;}
 #menubtn div {width: 30px; height: 4px; background-color: black; margin: 5px 0; transition: 0.4s;}
 .change .b1 {transform: translate(0, 9px) rotate(-45deg);}
 .change .b2 {opacity: 0;}
 .change .b3 {transform: translate(0, -9px) rotate(45deg);}
 
-.sentence span {border: 1px solid black; border-radius: 5px; padding: 2px; display:inline-block;}
-.sentence .tree span {border: none; padding: 0; display:inline;}
-.sentence span .eid {display:block; font-size: 10px;}
+.m {border: 1px solid black; border-radius: 5px; padding: 2px; display:inline-block;}
+.nobox {border:1px solid transparent; padding:0; background: transparent !important; display: inline}
+.nobox .labels {display: inline;}
+.nocolor {color: black !important;}
+.nobold {font-weight: normal;}
+.labels {display: block; font-size: 10px;}
 .showtree {margin: 5px; user-select: none;}
 .display-inline {display: inline;}
 .close{float:right; font-weight: 900; font-size: 30px; width: 36px; height: 36px; padding: 2px}
@@ -48,22 +46,22 @@
 '''
 
 SCRIPT_BASE = '''
-$("span").click(function(e) {
+$(".m").click(function(e) {
  let was_selected = $(this).hasClass("selected");
- $("span").removeClass("selected");
+ $(".m").removeClass("selected");
  if (!was_selected) {$("."+$(this).attr("class").split(" ")[0]).addClass("selected");}
  e.stopPropagation();
 });
 
 window.onhashchange = function() {
- $("span").removeClass("selected");
+ $(".m").removeClass("selected");
  var fragment = window.location.hash.substring(1);
  if (fragment) {$("." + fragment).addClass("selected");}
 }
 
-$("span").hover(
- function(e) {$("span").removeClass("active"); $("."+$(this).attr("class").split(" ")[1]).addClass("active");},
- function(e) {$("span").removeClass("active");}
+$(".m").hover(
+ function(e) {$(".m").removeClass("active"); $("."+$(this).attr("class").split(" ")[1]).addClass("active");},
+ function(e) {$(".m").removeClass("active");}
 );
 
 function menuclick(x) {
@@ -94,10 +92,11 @@
 
 class CorefHtml(BaseWriter):
 
-    def __init__(self, show_trees=True, show_eid=True, colors=7, **kwargs):
+    def __init__(self, show_trees=True, show_eid=False, show_etype=False, colors=7, **kwargs):
         super().__init__(**kwargs)
         self.show_trees = show_trees
         self.show_eid = show_eid
+        self.show_etype = show_etype
         self.colors = colors
 
     def _representative_word(self, entity):
@@ -120,6 +119,10 @@ def process_document(self, doc):
         if self.colors:
             for i in range(self.colors):
                 print(f'.c{i} {{color: hsl({int(i * 360/self.colors)}, 100%, 30%);}}')
+        if not self.show_eid:
+            print('.eid {display: none;}')
+        if not self.show_etype:
+            print('.etype {display: none;}')
         print('</style>')
         print('</head>\n<body>\n<div id="wrap">')
 
@@ -146,13 +149,19 @@ def process_document(self, doc):
         print('</div>')
 
         print('<div id="main">')
-        print('<div id="main-menu"><div id="menu-show">Show<br>\n'
-              ' <input id="show-eid" type="checkbox" checked onclick="$(\'.eid\').toggle();"><label for="show-eid">eid</label><br>\n'
+        print('<div id="main-menu">Show<br><div>\n'
+              f' <input id="show-eid" type="checkbox" {"checked" if self.show_eid else ""} onclick="$(\'.eid\').toggle();"><label for="show-eid">eid</label><br>\n'
+              f' <input id="show-etype" type="checkbox" {"checked" if self.show_etype else ""} onclick="$(\'.etype\').toggle();"><label for="show-etype">etype</label><br>\n'
               ' <input id="show-trees" type="checkbox" checked onclick="$(\'.showtree\').toggle();"><label for="show-trees">trees</label><br>\n'
-              ' <input id="show-breaks" type="checkbox" checked onclick="$(\'.sentence\').toggleClass(\'display-inline\');"><label for="show-breaks">line breaks</label><br>\n'
+              ' <input id="show-color" type="checkbox" checked onclick="$(\'.m\').toggleClass(\'nocolor\');"><label for="show-color">colors</label><br>\n'
+              ' <input id="show-boxes" type="checkbox" checked onclick="$(\'.m\').toggleClass(\'nobox\');"><label for="show-boxes">boxes</label></div><div>\n'
+              ' <input id="show-heads" type="checkbox" checked onclick="$(\'.head\').toggleClass(\'nobold\');"><label for="show-heads">heads in bold</label><br>\n'
+              ' <input id="show-empty" type="checkbox" checked onclick="$(\'.empty\').toggle();"><label for="show-empty">empty words</label><br>\n'
+              ' <input id="show-breaks" type="checkbox" checked onclick="$(\'.sentence\').toggleClass(\'display-inline\');"><label for="show-breaks">sentence per line</label><br>\n'
               ' <input id="show-pars" type="checkbox" checked onclick="$(\'.par\').toggle();"><label for="show-pars">paragraphs</label><br>\n'
+              ' <input id="show-docs" type="checkbox" checked onclick="$(\'h1\').toggle();"><label for="show-docs">document names</label><br>\n'
               '</div></div>\n'
-              '<button id="menubtn" onclick="menuclick(this)"><div class="b1"></div><div class="b2"></div><div class="b3"></div></button>\n')
+              '<button id="menubtn" title="Visualization options" onclick="menuclick(this)"><div class="b1"></div><div class="b2"></div><div class="b3"></div></button>\n')
         for tree in doc.trees:
             self.process_tree(tree, mention_ids, entity_colors)
         print('</div>')
@@ -168,8 +177,8 @@ def process_document(self, doc):
     def _start_subspan(self, subspan, mention_ids, entity_colors, crossing=False):
         m = subspan.mention
         e = m.entity
-        classes = f'{e.eid} {mention_ids[m]} {e.etype or "other"}'
-        title = f'eid={subspan.subspan_eid}\ntype={e.etype} ({entity_colors[e]})\nhead={m.head.form}'
+        classes = f'{e.eid} {mention_ids[m]} {e.etype or "other"} m'
+        title = f'eid={subspan.subspan_eid}\netype={e.etype}\nhead={m.head.form}'
         if self.colors:
             classes += f' {entity_colors[e]}'
         if all(w.is_empty() for w in subspan.words):
@@ -184,9 +193,9 @@ def _start_subspan(self, subspan, mention_ids, entity_colors, crossing=False):
         span_id = ''
         if (subspan.subspan_id == '' or subspan.subspan_id.startswith('[1/')) and e.mentions[0] == m:
             span_id = f'id="{e.eid}" '
-        print(f'<span {span_id}class="{classes}" title="{title}">', end='')
-        if self.show_eid:
-            print(f'<b class="eid">{subspan.subspan_eid}</b>', end='')
+        print(f'<span {span_id}class="{classes}" title="{title}">'
+              f'<span class="labels"><b class="eid">{subspan.subspan_eid}</b>'
+              f' <i class="etype">{e.etype}</i></span>', end='')
 
     def process_tree(self, tree, mention_ids, entity_colors):
         mentions = set()
@@ -214,9 +223,9 @@ def process_tree(self, tree, mention_ids, entity_colors):
 
             is_head = self._is_head(node)
             if is_head:
-                print('<b>', end='')
+                print('<b class="head">', end='')
             if node.is_empty():
-                print('<i>', end='')
+                print('<i class="empty">', end='')
             print(node.form, end='')
             if node.is_empty():
                 print('</i>', end='')

From 520512c9d1de454321cb1ff3a5389d4bf67ad36d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 20 Mar 2023 21:16:49 +0100
Subject: [PATCH 0795/1374] New block: util.SplitSentence.

---
 udapi/block/util/splitsentence.py | 73 +++++++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)
 create mode 100644 udapi/block/util/splitsentence.py

diff --git a/udapi/block/util/splitsentence.py b/udapi/block/util/splitsentence.py
new file mode 100644
index 00000000..704b11ef
--- /dev/null
+++ b/udapi/block/util/splitsentence.py
@@ -0,0 +1,73 @@
+"""
+my.SplitSentence will split a given sentence at a given token.
+"""
+import logging
+from udapi.core.block import Block
+from udapi.core.root import Root
+
+class SplitSentence(Block):
+    """
+    If the sent_id of the current sentence matches the parameter, splits the
+    sentence into two. The first token of the second sentence is also given as
+    a parameter.
+    """
+
+    def __init__(self, sent_id=None, word_id=None, **kwargs):
+        """
+        Args:
+        sent_id: which sentence should be split (new ids will have A and B appended)
+        word_id: which word should be the first word of the second sentence (tokens and words will be renumbered)
+        """
+        super().__init__(**kwargs)
+        if not sent_id:
+            logging.fatal('Missing parameter sent_id')
+        if not word_id:
+            logging.fatal('Missing parameter word_id')
+        self.sent_id = sent_id
+        self.word_id = word_id
+
+    def process_document(self, document):
+        for bundle_no, bundle in enumerate(document.bundles):
+            if bundle.bundle_id == self.sent_id:
+                logging.info('Found!')
+                # In general, a bundle may contain multiple trees in different zones.
+                # In UD data, we always expect just one zone (labeled '') per bundle.
+                # This code could be extended to split all zones but we do not try to do it at present.
+                # (The zones may be translations to other languages and it is not likely that we would
+                # want to split each translation at the same position.)
+                if len(bundle.trees) != 1:
+                    logging.fatal('Cannot process bundles that have less or more than 1 zone')
+                if not bundle.has_tree(zone=''):
+                    logging.fatal('Cannot process bundles that do not have the zone with empty zone id')
+                root = bundle.get_tree()
+                nodes_to_move = [n for n in root.descendants if n.ord >= self.word_id]
+                if len(nodes_to_move) == 0:
+                    logging.fatal('No nodes to move to the new sentence; word_id may be out of range')
+                # Create a new bundle at the end of the current document.
+                new_bundle = document.create_bundle()
+                # Move the new bundle to the position right after the current bundle.
+                new_bundle_no = bundle_no + 1
+                document.bundles.pop()
+                document.bundles.insert(new_bundle_no, new_bundle)
+                updated_no = new_bundle_no
+                for b in document.bundles[new_bundle_no:]:
+                    b.number = updated_no
+                    updated_no += 1
+                new_bundle.bundle_id = bundle.bundle_id + 'B'
+                bundle.bundle_id += 'A'
+                new_root = Root(zone='')
+                new_bundle.add_tree(new_root)
+                new_root.steal_nodes(nodes_to_move)
+                # The steal_nodes() method does not make sure that all nodes newly attached
+                # to the artificial root have the 'root' relation. Fix it.
+                for n in root.descendants:
+                    if n.parent.is_root():
+                        n.deprel = 'root'
+                for n in new_root.descendants:
+                    if n.parent.is_root():
+                        n.deprel = 'root'
+                # Update the sentence text attributes of the new sentences.
+                root.text = root.compute_text()
+                new_root.text = new_root.compute_text()
+                # We have found our sentence. No need to process the rest of the document.
+                break

From 75c85b98f5f36cd6c48785c5495819aa5ac7f535 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 20 Mar 2023 21:28:33 +0100
Subject: [PATCH 0796/1374] Warn if there are multiple children of the root.

---
 udapi/block/util/splitsentence.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/udapi/block/util/splitsentence.py b/udapi/block/util/splitsentence.py
index 704b11ef..5a093a30 100644
--- a/udapi/block/util/splitsentence.py
+++ b/udapi/block/util/splitsentence.py
@@ -60,12 +60,20 @@ def process_document(self, document):
                 new_root.steal_nodes(nodes_to_move)
                 # The steal_nodes() method does not make sure that all nodes newly attached
                 # to the artificial root have the 'root' relation. Fix it.
+                n_root = 0
                 for n in root.descendants:
                     if n.parent.is_root():
                         n.deprel = 'root'
+                        n_root += 1
+                if n_root > 1:
+                    logging.warning('More than one 0:root relation in the first part of the sentence.')
+                n_root = 0
                 for n in new_root.descendants:
                     if n.parent.is_root():
                         n.deprel = 'root'
+                        n_root += 1
+                if n_root > 1:
+                    logging.warning('More than one 0:root relation in the second part of the sentence.')
                 # Update the sentence text attributes of the new sentences.
                 root.text = root.compute_text()
                 new_root.text = new_root.compute_text()

From 948f915c6aa41cde044ebbbdd9d69499065b6352 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 22 Mar 2023 15:32:55 +0100
Subject: [PATCH 0797/1374] lazy loading of further documents in
 write.CorefHtml

---
 udapi/block/write/corefhtml.py | 91 +++++++++++++++++++++++++++-------
 1 file changed, 73 insertions(+), 18 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index fd500e7d..e2cd40f2 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -1,8 +1,24 @@
-"""CorefHtml class is a writer for HTML+JavaScript visualization of coreference."""
+"""CorefHtml class is a writer for HTML+JavaScript visualization of coreference.
+
+When using lazy loading of documents (infinite scrolling),
+modern browsers don't allow JavaScript to load files from a local file system
+("Access to XMLHttpRequest at 'file://.../doc2.html' from origin 'null' has been
+blocked by CORS policy: Cross origin requests are only supported for protocol schemes:
+http, data, chrome, chrome-extension, https.")
+
+The recommended solution is to start a local web server, e.g. using
+  python -m http.server
+and browse http://0.0.0.0:8000/my.html.
+
+Non-recommended solution is to run
+ google-chrome --new-window --user-data-dir=/tmp/chrome-proxy --allow-file-access-from-files my.html
+"""
 from udapi.core.basewriter import BaseWriter
 from udapi.core.coref import span_to_nodes, CorefEntity, CorefMention
 from collections import Counter
 import udapi.block.write.html
+import sys
+import os
 
 ETYPES = 'person place organization animal plant object substance time number abstract event'.split()
 
@@ -46,12 +62,19 @@
 '''
 
 SCRIPT_BASE = '''
-$(".m").click(function(e) {
- let was_selected = $(this).hasClass("selected");
- $(".m").removeClass("selected");
- if (!was_selected) {$("."+$(this).attr("class").split(" ")[0]).addClass("selected");}
- e.stopPropagation();
-});
+function add_mention_listeners(mentions){
+ mentions.click(function(e) {
+   let was_selected = $(this).hasClass("selected");
+   $(".m").removeClass("selected");
+   if (!was_selected) {$("."+$(this).attr("class").split(" ")[0]).addClass("selected");}
+   e.stopPropagation();
+  });
+ mentions.hover(
+   function(e) {$(".m").removeClass("active"); $("."+$(this).attr("class").split(" ")[1]).addClass("active");},
+   function(e) {$(".m").removeClass("active");}
+  );
+}
+add_mention_listeners($(".m"));
 
 window.onhashchange = function() {
  $(".m").removeClass("selected");
@@ -59,16 +82,22 @@
  if (fragment) {$("." + fragment).addClass("selected");}
 }
 
-$(".m").hover(
- function(e) {$(".m").removeClass("active"); $("."+$(this).attr("class").split(" ")[1]).addClass("active");},
- function(e) {$(".m").removeClass("active");}
-);
-
 function menuclick(x) {
   x.classList.toggle("change");
   $("#main-menu").toggle();
 }
 
+var docs_loaded = 1;
+$(window).scroll(function () {
+  if ($(window).scrollTop() >= $(document).height() - $(window).height() - 42 && docs_loaded < all_docs) {
+    docs_loaded += 1;
+    console.log("loading doc" + docs_loaded + ".html");
+    $.get(docs_dir + "/doc" + docs_loaded + ".html", function(data){
+     $("#main").append(data);
+     add_mention_listeners($("#doc" + docs_loaded + " .m"));
+    });
+  }
+});
 '''
 
 SCRIPT_SHOWTREE = '''
@@ -80,7 +109,7 @@
       if (tree_div.length == 0){
         var tdiv = $("<div>", {id:"tree-"+sent_id, class:"tree"}).insertAfter($(this));
         tdiv.treexView([data[index]]);
-        $("<button>",{append:"×", class:"close"}).prependTo(tdiv).on("click", function(){$(this).parent().remove();});
+        $("<button>", {append:"×", class:"close"}).prependTo(tdiv).on("click", function(){$(this).parent().remove();});
         $('#button-'+sent_id).attr('title', 'hide dependency tree');
       } else {tree_div.remove();}
     })
@@ -92,12 +121,15 @@
 
 class CorefHtml(BaseWriter):
 
-    def __init__(self, show_trees=True, show_eid=False, show_etype=False, colors=7, **kwargs):
+    def __init__(self, docs_dir='.', show_trees=True, show_eid=False, show_etype=False, colors=7, **kwargs):
         super().__init__(**kwargs)
+        self.docs_dir = docs_dir
         self.show_trees = show_trees
         self.show_eid = show_eid
         self.show_etype = show_etype
         self.colors = colors
+        if docs_dir != '.' and not os.path.exists(docs_dir):
+            os.makedirs(docs_dir)
 
     def _representative_word(self, entity):
         # return the first PROPN or NOUN. Or the most frequent one?
@@ -109,7 +141,19 @@ def _representative_word(self, entity):
                 return lemma_or_form(nodes[0])
         return lemma_or_form(heads[0])
 
+    def process_ud_doc(self, ud_doc, doc_num, mention_ids, entity_colors):
+        print(f'<div class="doc" id="doc{doc_num}">')
+        for tree in ud_doc:
+            self.process_tree(tree, mention_ids, entity_colors)
+        print('</div>')
+
     def process_document(self, doc):
+        ud_docs = []
+        for tree in doc.trees:
+            if tree.newdoc or not ud_docs:
+                ud_docs.append([])
+            ud_docs[-1].append(tree)
+
         print(HEADER)
         if self.show_trees:
             print('<script src="https://cdn.rawgit.com/ufal/js-treex-view/gh-pages/js-treex-view.js"></script>')
@@ -162,11 +206,22 @@ def process_document(self, doc):
               ' <input id="show-docs" type="checkbox" checked onclick="$(\'h1\').toggle();"><label for="show-docs">document names</label><br>\n'
               '</div></div>\n'
               '<button id="menubtn" title="Visualization options" onclick="menuclick(this)"><div class="b1"></div><div class="b2"></div><div class="b3"></div></button>\n')
-        for tree in doc.trees:
-            self.process_tree(tree, mention_ids, entity_colors)
-        print('</div>')
 
-        print('<script>')
+        # The first ud_doc will be printed to the main html file.
+        self.process_ud_doc(ud_docs[0], 1, mention_ids, entity_colors)
+        print('</div>') # id=main
+
+        # Other ud_docs will be printed into separate files (so they can be loaded lazily)
+        orig_stdout = sys.stdout
+        try:
+            for i, ud_doc in enumerate(ud_docs[1:], 2):
+                sys.stdout = open(f"{self.docs_dir}/doc{i}.html", 'wt')
+                self.process_ud_doc(ud_doc, i, mention_ids, entity_colors)
+                sys.stdout.close()
+        finally:
+            sys.stdout = orig_stdout
+
+        print(f'<script>\nvar all_docs = {len(ud_docs)};\nvar docs_dir = "{self.docs_dir}";')
         print(SCRIPT_BASE)
         if self.show_trees:
             WRITE_HTML.print_doc_json(doc)

From 0b363899f279d46b37761bf21178126d13c03287 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 28 Mar 2023 20:03:21 +0200
Subject: [PATCH 0798/1374] load lazily also the json files (and make them
 valid json)

---
 udapi/block/write/corefhtml.py | 111 ++++++++++++++++++++++++---------
 udapi/block/write/html.py      |  12 +++-
 2 files changed, 90 insertions(+), 33 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index e2cd40f2..cd0db1e5 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -87,41 +87,78 @@
   $("#main-menu").toggle();
 }
 
+function load_doc(doc_num) {
+  loading_now = true;
+  console.log("loading doc" + doc_num + ".html");
+  $.get(docs_dir + "/doc" + doc_num + ".html", function(data){
+    $("#main").append(data);
+    add_mention_listeners($("#doc" + doc_num + " .m"));
+    $("#doc" + doc_num + " .sentence").each(add_show_tree_button);
+    loading_now = false;
+  }).fail(function(){
+    if (! load_fail_reported) {
+      load_fail_reported = true;
+      alert("Cannot load " + docs_dir + "/doc" + doc_num
+      + ".html\\nLocal files do not support lazy loading. Run a web server 'python -m http.server'");
+    }
+  });
+}
+
 var docs_loaded = 1;
+var load_fail_reported = false;
+var loading_now = false;
+add_show_tree_button = function(index, el){ } // to be redefined later if show_trees=True
 $(window).scroll(function () {
-  if ($(window).scrollTop() >= $(document).height() - $(window).height() - 42 && docs_loaded < all_docs) {
+  if (!loading_now && $(window).scrollTop() >= $(document).height() - $(window).height() - 42 && docs_loaded < all_docs) {
     docs_loaded += 1;
-    console.log("loading doc" + docs_loaded + ".html");
-    $.get(docs_dir + "/doc" + docs_loaded + ".html", function(data){
-     $("#main").append(data);
-     add_mention_listeners($("#doc" + docs_loaded + " .m"));
-    });
+    load_doc(docs_loaded);
   }
 });
 '''
 
 SCRIPT_SHOWTREE = '''
-$(".sentence").each(function(index){
-  var sent_id = this.id;
-  $(this).prepend(
+function show_tree_in_tdiv(tdiv, doc_number, index){
+  tdiv.treexView([docs_json[doc_number][index]]);
+  $("<button>", {append:"×", class:"close"}).prependTo(tdiv).on("click", function(){tdiv.remove();});
+}
+
+var load_json_fail_reported = false;
+add_show_tree_button = function(index, el){
+  var sent_id = el.id;
+  $(el).prepend(
     $("<button>", {append: "🌲", id:"button-"+sent_id, title: "show dependency tree", class: "showtree"}).on("click", function() {
       var tree_div = $("#tree-"+sent_id);
       if (tree_div.length == 0){
-        var tdiv = $("<div>", {id:"tree-"+sent_id, class:"tree"}).insertAfter($(this));
-        tdiv.treexView([data[index]]);
-        $("<button>", {append:"×", class:"close"}).prependTo(tdiv).on("click", function(){$(this).parent().remove();});
         $('#button-'+sent_id).attr('title', 'hide dependency tree');
+        var tdiv = $("<div>", {id:"tree-"+sent_id, class:"tree"}).insertAfter($(el));
+        doc_number = 1 * el.parentElement.id.substr(3);
+        if (docs_json[doc_number]){
+          show_tree_in_tdiv(tdiv, doc_number, index);
+        } else {
+          $.getJSON(docs_dir + "/doc" + doc_number + ".json", function(data){
+            docs_json[doc_number] = data;
+            show_tree_in_tdiv(tdiv, doc_number, index);
+          }).fail(function(){
+            if (! load_json_fail_reported) {
+              load_json_fail_reported = true;
+              alert("Cannot load " + docs_dir + "/doc" + doc_number
+              + ".json\\nLocal files do not support lazy loading. Run a web server 'python -m http.server'");
+            }
+          });
+        }
       } else {tree_div.remove();}
     })
   );
-});
+}
+
+$("#doc1 .sentence").each(add_show_tree_button);
 '''
 
 WRITE_HTML = udapi.block.write.html.Html()
 
 class CorefHtml(BaseWriter):
 
-    def __init__(self, docs_dir='.', show_trees=True, show_eid=False, show_etype=False, colors=7, **kwargs):
+    def __init__(self, docs_dir='docs', show_trees=True, show_eid=False, show_etype=False, colors=7, **kwargs):
         super().__init__(**kwargs)
         self.docs_dir = docs_dir
         self.show_trees = show_trees
@@ -130,6 +167,8 @@ def __init__(self, docs_dir='.', show_trees=True, show_eid=False, show_etype=Fal
         self.colors = colors
         if docs_dir != '.' and not os.path.exists(docs_dir):
             os.makedirs(docs_dir)
+        self._mention_ids = {}
+        self._entity_colors = {}
 
     def _representative_word(self, entity):
         # return the first PROPN or NOUN. Or the most frequent one?
@@ -141,18 +180,21 @@ def _representative_word(self, entity):
                 return lemma_or_form(nodes[0])
         return lemma_or_form(heads[0])
 
-    def process_ud_doc(self, ud_doc, doc_num, mention_ids, entity_colors):
+    def process_ud_doc(self, ud_doc, doc_num):
         print(f'<div class="doc" id="doc{doc_num}">')
         for tree in ud_doc:
-            self.process_tree(tree, mention_ids, entity_colors)
+            self.process_tree(tree)
         print('</div>')
 
     def process_document(self, doc):
-        ud_docs = []
+        ud_docs, doc_num, sent_id2doc = [], 0, {}
         for tree in doc.trees:
             if tree.newdoc or not ud_docs:
                 ud_docs.append([])
+                doc_num += 1
             ud_docs[-1].append(tree)
+            sent_id2doc[tree.sent_id] = doc_num
+        # TODO: use sent_id2doc
 
         print(HEADER)
         if self.show_trees:
@@ -170,16 +212,16 @@ def process_document(self, doc):
         print('</style>')
         print('</head>\n<body>\n<div id="wrap">')
 
-        mention_ids = {}
-        entity_colors = {}
+        self._mention_ids = {}
+        self._entity_colors = {}
         entities_of_type = Counter()
         for entity in doc.coref_entities:
             if self.colors:
                 count = entities_of_type[entity.etype]
                 entities_of_type[entity.etype] = count + 1
-                entity_colors[entity] = f'c{count % self.colors}'
+                self._entity_colors[entity] = f'c{count % self.colors}'
             for idx, mention in enumerate(entity.mentions, 1):
-                mention_ids[mention] = f'{entity.eid}e{idx}'
+                self._mention_ids[mention] = f'{entity.eid}e{idx}'
 
         print('<div id="overview">')
         print('<table><thead><tr><th title="entity id">eid</th>'
@@ -208,7 +250,7 @@ def process_document(self, doc):
               '<button id="menubtn" title="Visualization options" onclick="menuclick(this)"><div class="b1"></div><div class="b2"></div><div class="b3"></div></button>\n')
 
         # The first ud_doc will be printed to the main html file.
-        self.process_ud_doc(ud_docs[0], 1, mention_ids, entity_colors)
+        self.process_ud_doc(ud_docs[0], 1)
         print('</div>') # id=main
 
         # Other ud_docs will be printed into separate files (so they can be loaded lazily)
@@ -216,7 +258,7 @@ def process_document(self, doc):
         try:
             for i, ud_doc in enumerate(ud_docs[1:], 2):
                 sys.stdout = open(f"{self.docs_dir}/doc{i}.html", 'wt')
-                self.process_ud_doc(ud_doc, i, mention_ids, entity_colors)
+                self.process_ud_doc(ud_doc, i)
                 sys.stdout.close()
         finally:
             sys.stdout = orig_stdout
@@ -224,18 +266,27 @@ def process_document(self, doc):
         print(f'<script>\nvar all_docs = {len(ud_docs)};\nvar docs_dir = "{self.docs_dir}";')
         print(SCRIPT_BASE)
         if self.show_trees:
-            WRITE_HTML.print_doc_json(doc)
+            print('docs_json = [false, ', end='') # 1-based index, so dummy docs_json[0]
+            WRITE_HTML.print_doc_json(ud_docs[0])
+            print('];')
+            try:
+                for i, ud_doc in enumerate(ud_docs[1:], 2):
+                    sys.stdout = open(f"{self.docs_dir}/doc{i}.json", 'wt')
+                    WRITE_HTML.print_doc_json(ud_doc)
+                    sys.stdout.close()
+            finally:
+                sys.stdout = orig_stdout
             print(SCRIPT_SHOWTREE)
         print('</script>')
         print('</div></body></html>')
 
-    def _start_subspan(self, subspan, mention_ids, entity_colors, crossing=False):
+    def _start_subspan(self, subspan, crossing=False):
         m = subspan.mention
         e = m.entity
-        classes = f'{e.eid} {mention_ids[m]} {e.etype or "other"} m'
+        classes = f'{e.eid} {self._mention_ids[m]} {e.etype or "other"} m'
         title = f'eid={subspan.subspan_eid}\netype={e.etype}\nhead={m.head.form}'
         if self.colors:
-            classes += f' {entity_colors[e]}'
+            classes += f' {self._entity_colors[e]}'
         if all(w.is_empty() for w in subspan.words):
             classes += ' empty'
         if len(e.mentions) == 1:
@@ -252,7 +303,7 @@ def _start_subspan(self, subspan, mention_ids, entity_colors, crossing=False):
               f'<span class="labels"><b class="eid">{subspan.subspan_eid}</b>'
               f' <i class="etype">{e.etype}</i></span>', end='')
 
-    def process_tree(self, tree, mention_ids, entity_colors):
+    def process_tree(self, tree):
         mentions = set()
         nodes_and_empty = tree.descendants_and_empty
         for node in nodes_and_empty:
@@ -273,7 +324,7 @@ def process_tree(self, tree, mention_ids, entity_colors):
         for node in nodes_and_empty:
             while subspans and subspans[-1].words[0] == node:
                 subspan = subspans.pop()
-                self._start_subspan(subspan, mention_ids, entity_colors)
+                self._start_subspan(subspan)
                 opened.append(subspan)
 
             is_head = self._is_head(node)
@@ -311,7 +362,7 @@ def process_tree(self, tree, mention_ids, entity_colors):
                 opened = new_opened
                 print('</span>' * (len(endings) + len(brokens)), end='')
                 for broken in brokens:
-                    self._start_subspan(broken, mention_ids, entity_colors, True)
+                    self._start_subspan(broken, True)
                     opened.append(subspan)
 
             if not node.no_space_after:
diff --git a/udapi/block/write/html.py b/udapi/block/write/html.py
index 48431900..ae85d43c 100644
--- a/udapi/block/write/html.py
+++ b/udapi/block/write/html.py
@@ -79,7 +79,9 @@ def process_document(self, doc):
         print('</head>\n<body>')
         print('<button style="float:right" type="submit" onclick="saveTree()">'
               '<span>Save as SVG</span></button><div id="treex-view"></div><script>')
+        print('data=', end='')
         self.print_doc_json(doc)
+        print(';')
         print("$('#treex-view').treexView(data);")
         print('''function saveTree() {
          var svg_el = jQuery('svg');
@@ -91,14 +93,18 @@ def process_document(self, doc):
         print('</script></body></html>')
 
     def print_doc_json(self, doc):
-        print('data=[')
+        print('[')
         for (bundle_number, bundle) in enumerate(doc, 1):
             if bundle_number != 1:
                 print(',', end='')
             print('{"zones":{', end='')
             first_zone = True
             desc = ''
-            for tree in bundle.trees:
+            try:
+                trees = bundle.trees
+            except:
+                trees = [bundle] # allow to call print_doc_json([tree1, tree2])
+            for tree in trees:
                 zone = tree.zone
                 if first_zone:
                     first_zone = False
@@ -116,7 +122,7 @@ def print_doc_json(self, doc):
                 print(']}}}')
             # print desc without the extra starting comma
             print('},"desc":[%s]}' % desc[1:])
-        print('];')
+        print(']')
 
 
     @staticmethod

From 327bb6f9083f6131b4f986dac9b56f2570957f60 Mon Sep 17 00:00:00 2001
From: Federica Gamba <gamba@cyan.ms.mff.cuni.cz>
Date: Thu, 30 Mar 2023 12:22:27 +0200
Subject: [PATCH 0799/1374] adjustments in Latin feature rules

---
 udapi/block/ud/la/markfeatsbugs.py | 74 +++++++++++++++++++-----------
 1 file changed, 47 insertions(+), 27 deletions(-)

diff --git a/udapi/block/ud/la/markfeatsbugs.py b/udapi/block/ud/la/markfeatsbugs.py
index fde3b0bd..dce4592d 100644
--- a/udapi/block/ud/la/markfeatsbugs.py
+++ b/udapi/block/ud/la/markfeatsbugs.py
@@ -28,7 +28,8 @@ def process_node(self, node):
         rf = []
         af = {}
         # PROIEL-specific: greek words without features
-        if node.lemma == 'greek.expression':
+        # LLCT-specific: corrupted nodes
+        if node.lemma in ['greek.expression', 'missing^token']:
             pass
         # NOUNS ################################################################
         elif node.upos == 'NOUN':
@@ -41,12 +42,14 @@ def process_node(self, node):
                 'Degree': ['Dim'],
                 'Abbr': ['Yes'],
                 'Foreign': ['Yes'],
-                'VerbForm': ['Part']}
+                'VerbForm': ['Part', 'Vnoun']}
             if self.flavio:
                 # Flavio added InflClass but not everywhere, so it is not required.
-                af['InflClass'] = ['IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
+                af['InflClass'] = ['Ind', 'IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
                 af['Proper'] = ['Yes']
+                af['Polarity'] = ['Neg']
                 af['Compound'] = ['Yes']
+                af['Variant'] = ['Greek']
                 af['NameType'] = ['Ast', 'Cal', 'Com', 'Geo', 'Giv', 'Let', 'Lit', 'Met', 'Nat', 'Rel', 'Sur', 'Oth']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
@@ -61,10 +64,10 @@ def process_node(self, node):
                 'Abbr': ['Yes'],
                 'Foreign': ['Yes']}
             if self.flavio:
-                af['Compound'] = 'Yes'
+                af['Compound'] = ['Yes']
+                af['Variant'] = ['Greek']
                 af['NameType'] = ['Ast', 'Cal', 'Com', 'Geo', 'Giv', 'Let', 'Lit', 'Met', 'Nat', 'Rel', 'Sur', 'Oth']
-                if not node.feats['Abbr'] == 'Yes' and node.feats['Case']:
-                    af['InflClass'] = ['IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
+                af['InflClass'] = ['Ind', 'IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # ADJECTIVES ###########################################################
@@ -72,7 +75,7 @@ def process_node(self, node):
             if not node.feats['Abbr'] == 'Yes' and node.feats['Case']:
                 rf = ['Gender', 'Number', 'Case']
             af = {
-                'NumType': ['Ord', 'Dist'],
+                'NumType': ['Dist', 'Mult', 'Ord'],
                 'Gender': ['Masc', 'Fem', 'Neut'],
                 'Number': ['Sing', 'Plur'],
                 'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl'],
@@ -83,9 +86,10 @@ def process_node(self, node):
                 'VerbForm': ['Part']}
             if self.flavio:
                 # Flavio added InflClass but not everywhere, so it is not required.
-                af['InflClass'] = ['IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
+                af['InflClass'] = ['Ind', 'IndEurA', 'IndEurE', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
                 af['Compound'] = ['Yes']
                 af['Proper'] = ['Yes']
+                af['Variant'] = ['Greek']
                 af['Degree'].append('Dim')
                 af['NameType'] = ['Ast', 'Cal', 'Com', 'Geo', 'Giv', 'Let', 'Lit', 'Met', 'Nat', 'Rel', 'Sur', 'Oth']
             self.check_required_features(node, rf)
@@ -112,10 +116,10 @@ def process_node(self, node):
                     rf.extend(['Person', 'Number'])
                     af['Person'] = ['1', '2', '3']
                     af['Number'] = ['Sing', 'Plur']
-                    # 1st and 2nd person do not have gender
+                    # 3rd person must have gender
                     if node.feats['Person'] == '3': # is, id
                         rf.append('Gender')
-                        af['Gender'] = ['Masc', 'Fem', 'Neut']
+                    af['Gender'] = ['Masc', 'Fem', 'Neut']
             elif re.match(r'^(Rel|Int)$', node.feats['PronType']):
                 rf.extend(['Gender', 'Number'])
                 af['Gender'] = ['Masc', 'Fem', 'Neut']
@@ -126,20 +130,20 @@ def process_node(self, node):
                 af['Number'] = ['Sing', 'Plur']
             # lexical check of PronTypes
             af['PronType'] = []
-            if node.lemma in ['is', 'ego', 'tu', 'sui', 'seipsum', 'nos', 'uos', 'vos', 'tumetipse', 'nosmetipse']:
+            if node.lemma in ['ego', 'tu', 'is', 'sui', 'seipsum', 'nos', 'uos', 'vos', 'egoipse', 'egometipse', 'tumetipse', 'semetipse', 'nosmetipse']:
                 af['PronType'].append('Prs')
-            elif node.lemma in ['quis', 'aliquis', 'nihil', 'nemo', 'quivis', 'qui']:
+            elif node.lemma in ['aliquis', 'nemo', 'nihil', 'nihilum', 'qui', 'quis', 'quisquis', 'quiuis', 'quivis']:
                 af['PronType'].append('Ind')
             elif node.lemma in ['inuicem', 'invicem']:
                 af['PronType'].append('Rcp')
                 rf.remove('Case')
-            if node.lemma in ['quicumque', 'qui', 'quisquis']:
+            if node.lemma in ['qui', 'quicumque', 'quisquis']:
                 af['PronType'].append('Rel')
-            if node.lemma in ['qui', 'quis', 'quisnam', 'ecquis', 'ecqui']:
+            if node.lemma in [ 'ecquis', 'ecqui', 'numquis', 'qui', 'quis', 'quisnam']:
                 af['PronType'].append('Int')
             if self.flavio:
                 # Flavio added InflClass but not everywhere, so it is not required.
-                af['InflClass'] = ['LatAnom', 'LatPron']
+                af['InflClass'] = ['Ind', 'IndEurO', 'IndEurX', 'LatAnom', 'LatPron']
                 af['Compound'] = ['Yes']
                 af['Polarity'] = ['Neg']
                 af['Form'] = ['Emp']
@@ -175,25 +179,26 @@ def process_node(self, node):
             if node.lemma in ['suus', 'meus', 'noster', 'tuus', 'uester', 'vester', 'voster']:
                 if not af['PronType'] == ['Prs']:
                     af['PronType'].append('Prs')
-            elif node.lemma in ['aliquot', 'quidam', 'quispiam', 'quivis', 'nullus', 'nonnullus', 'aliqui', 'qui', 'quilibet', 'quantuslibet', 'unus', 'uterque', 'ullus', 'multus', 'quisque', 'paucus', 'complures', 'quamplures', 'quicumque', 'reliquus', 'plerusque', 'aliqualis', 'quisquam', 'qualiscumque']:
+            elif node.lemma in ['aliquantus', 'aliqui', 'aliquot', 'quidam', 'nonnullus', 'nullus', 'quantuscumque', 'quantuslibet', 'qui', 'quilibet', 'quispiam', 'quiuis', 'quivis', 'quotlibet', 'ullus', 'unus', 'uterque','multus', 'quisque', 'paucus', 'complures', 'quamplures', 'quicumque', 'reliquus', 'plerusque', 'aliqualis', 'quisquam', 'qualiscumque']:
                 af['PronType'].append('Ind')
             elif node.lemma in ['omnis', 'totus', 'ambo', 'cunctus', 'unusquisque', 'uniuersus']:
                 af['PronType'].append('Tot')
             if node.lemma in ['quantus', 'qualis', 'quicumque', 'quot', 'quotus', 'quotquot']:
                 af['PronType'].append('Rel')
-            elif node.lemma in ['qui', 'quantus', 'quot']:
+            if node.lemma in ['qui', 'quantus', 'quot']:
                 af['PronType'].append('Int')
-            elif node.lemma in ['hic', 'ipse', 'ille', 'tantus', 'talis', 'is', 'iste', 'eiusmodi', 'huiusmodi', 'idem', 'totidem', 'tot']:
+            elif node.lemma in ['hic', 'ipse', 'ille', 'tantus', 'talis', 'is', 'iste', 'eiusmodi', 'huiusmodi', 'idem', 'totidem', 'tot', 'praedictus', 'praefatus', 'suprascriptus']:
                 af['PronType'].append('Dem')
-            elif node.lemma in ['alius', 'alter', 'solus', 'ceterus', 'alteruter', 'neuter', 'uter']:
+            elif node.lemma in ['alius', 'alter', 'solus', 'ceterus', 'alteruter', 'neuter', 'uter', 'uterlibet', 'uterque']:
                 af['PronType'].append('Con')
             if self.flavio:
                 # Flavio added InflClass but not everywhere, so it is not required.
-                af['InflClass'] = ['IndEurA', 'IndEurI', 'IndEurO', 'IndEurX', 'LatPron']
+                af['InflClass'] = ['Ind', 'IndEurA', 'IndEurI', 'IndEurO', 'IndEurX', 'LatPron']
                 af['Compound'] = ['Yes']
                 af['Form'] = ['Emp']
                 af['NumType'] = ['Card']
                 af['Degree'].append('Dim')
+                af['PronType'].append('Art')
                 if re.match(r'^(unus|ambo)', node.lemma):
                     af['NumValue'] = ['1', '2']
             self.check_required_features(node, rf)
@@ -202,7 +207,7 @@ def process_node(self, node):
         elif node.upos == 'NUM':
             rf = ['NumType', 'NumForm']
             af = {
-                'NumType': ['Card'],
+                'NumType': ['Card', 'Ord'],
                 'NumForm': ['Word', 'Roman', 'Digit'],
                 'Proper': ['Yes']}
             # Arabic digits and Roman numerals do not have inflection features.
@@ -212,7 +217,9 @@ def process_node(self, node):
                 af['Case'] = ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Abl']
             if self.flavio:
                 # Flavio added InflClass but not everywhere, so it is not required. # e.g. duodecim
-                af['InflClass'] = ['IndEurA', 'IndEurI', 'IndEurO', 'LatPron']
+                af['InflClass'] = ['Ind', 'IndEurA', 'IndEurI', 'IndEurO', 'LatPron']
+                af['NumForm'].append('Reference')
+                af['Compound'] = ['Yes']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # VERBS AND AUXILIARIES ################################################
@@ -227,7 +234,7 @@ def process_node(self, node):
             if node.feats['VerbForm'] not in ['Part', 'Conv']:
                 rf.append('Tense')
                 af['Tense'] = ['Past', 'Pqp', 'Pres', 'Fut']
-            if node.upos == 'VERB':
+            if node.upos == 'VERB' or (node.upos == 'AUX' and node.lemma != 'sum'):
                 rf.append('Voice')
                 af['Voice'] = ['Act', 'Pass']
             if node.feats['VerbForm'] == 'Fin': # imperative, indicative or subjunctive
@@ -255,6 +262,7 @@ def process_node(self, node):
             if self.flavio:
                 # Flavio added InflClass but not everywhere, so it is not required.
                 af['InflClass'] = ['LatA', 'LatAnom', 'LatE', 'LatI', 'LatI2', 'LatX']
+                af['VerbType'] = ['Mod']
                 if 'Degree' in af:
                     af['Degree'].append('Dim')
                 else:
@@ -262,7 +270,12 @@ def process_node(self, node):
                 af['Compound'] = ['Yes']
                 af['Proper'] = ['Yes']
                 if re.match(r'^(Part|Conv)$', node.feats['VerbForm']):
-                    af['InflClass[nominal]'] = ['IndEurA', 'IndEurI', 'IndEurO', 'IndEurU']
+                    af['InflClass[nominal]'] = ['IndEurA', 'IndEurI', 'IndEurO', 'IndEurU', 'IndEurX']
+                elif node.feats['VerbForm'] == 'Inf':
+                    af['Case'] = ['Nom', 'Acc', 'Abl']
+                    af['Gender'] = ['Neut']
+                    af['Number'] = ['Sing']
+                    af['InflClass[nominal]'] = ['Ind']
             self.check_required_features(node, rf)
             self.check_allowed_features(node, af)
         # ADVERBS ##############################################################
@@ -271,13 +284,13 @@ def process_node(self, node):
                 'AdvType': ['Loc', 'Tim'],
                 'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot', 'Con'],
                 'Degree': ['Pos', 'Cmp', 'Sup', 'Abs'],
-                'NumType': ['Card', 'Ord'], # e.g., primum
+                'NumType': ['Card', 'Mult', 'Ord'], # e.g., primum
                 'Polarity': ['Neg']
             }
             if self.flavio:
                 af['Compound'] = ['Yes']
                 af['Form'] = ['Emp']
-                af['VerbForm'] = ['Part']
+                af['VerbForm'] = ['Fin', 'Part']
                 af['Degree'].append('Dim')
             self.check_allowed_features(node, af)
         # PARTICLES ############################################################
@@ -289,6 +302,7 @@ def process_node(self, node):
             if self.flavio:
                 af['Form'] = ['Emp']
                 af['PronType'] = ['Dem']
+                af['Compound'] = ['Yes']
             self.check_allowed_features(node, af)
         # CONJUNCTIONS #########################################################
         elif re.match(r'^[CS]CONJ$', node.upos):
@@ -301,6 +315,8 @@ def process_node(self, node):
                 af['Form'] = ['Emp']
                 af['VerbForm'] = ['Fin']
                 af['NumType'] = ['Card']
+                af['ConjType'] = ['Expl']
+                af['AdvType'] = ['Loc']
             self.check_allowed_features(node, af)
         # ADPOSITIONS ##########################################################
         elif node.upos == 'ADP':
@@ -310,9 +326,13 @@ def process_node(self, node):
                 'Abbr': ['Yes']
             }
             if self.flavio:
-                af['VerbForm'] = ['Part'],
+                af['VerbForm'] = ['Part']
                 af['Proper'] = ['Yes']
+                af['Compound'] = ['Yes']
             self.check_allowed_features(node, af)
+        # X ##########################################################
+        elif node.upos == 'X':
+            af = {'Abbr': ['Yes']}
         # THE REST: NO FEATURES ################################################
         else:
             self.check_allowed_features(node, {})

From 1ddfce4aec593e222a0e3d26e8f74acf561d1356 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 31 Mar 2023 19:42:35 +0200
Subject: [PATCH 0800/1374] gzip the docs/* json and html files

---
 udapi/block/write/corefhtml.py | 49 ++++++++++++++++++++--------------
 1 file changed, 29 insertions(+), 20 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index cd0db1e5..6129b335 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -17,6 +17,7 @@
 from udapi.core.coref import span_to_nodes, CorefEntity, CorefMention
 from collections import Counter
 import udapi.block.write.html
+import gzip
 import sys
 import os
 
@@ -26,6 +27,7 @@
 <!DOCTYPE html><html lang="en"><head><meta charset="UTF-8">
 <title>Udapi CorefUD viewer</title>
 <script src="https://code.jquery.com/jquery-3.6.3.min.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/pako/2.1.0/pako.min.js"></script>
 '''
 
 CSS = '''
@@ -87,21 +89,26 @@
   $("#main-menu").toggle();
 }
 
-function load_doc(doc_num) {
+async function load_doc(doc_num) {
   loading_now = true;
-  console.log("loading doc" + doc_num + ".html");
-  $.get(docs_dir + "/doc" + doc_num + ".html", function(data){
-    $("#main").append(data);
-    add_mention_listeners($("#doc" + doc_num + " .m"));
-    $("#doc" + doc_num + " .sentence").each(add_show_tree_button);
-    loading_now = false;
-  }).fail(function(){
+  let filename = docs_dir + "/doc" + doc_num + ".html.gz"
+  console.log("loading " + filename);
+  try {
+    const res = await fetch(filename);
+    let raw = await res.arrayBuffer();
+    data = pako.inflate(raw, {to: "string"});
+  } catch (error){
     if (! load_fail_reported) {
       load_fail_reported = true;
-      alert("Cannot load " + docs_dir + "/doc" + doc_num
-      + ".html\\nLocal files do not support lazy loading. Run a web server 'python -m http.server'");
+      alert("Cannot load " + filename + "\\nLocal files do not support lazy loading."
+      + " Run a web server 'python -m http.server'\\n"
+      + "error = " + error);
     }
-  });
+  }
+  $("#main").append(data);
+  add_mention_listeners($("#doc" + doc_num + " .m"));
+  $("#doc" + doc_num + " .sentence").each(add_show_tree_button);
+  loading_now = false;
 }
 
 var docs_loaded = 1;
@@ -126,7 +133,7 @@
 add_show_tree_button = function(index, el){
   var sent_id = el.id;
   $(el).prepend(
-    $("<button>", {append: "🌲", id:"button-"+sent_id, title: "show dependency tree", class: "showtree"}).on("click", function() {
+    $("<button>", {append: "🌲", id:"button-"+sent_id, title: "show dependency tree", class: "showtree"}).on("click", async function() {
       var tree_div = $("#tree-"+sent_id);
       if (tree_div.length == 0){
         $('#button-'+sent_id).attr('title', 'hide dependency tree');
@@ -135,16 +142,18 @@
         if (docs_json[doc_number]){
           show_tree_in_tdiv(tdiv, doc_number, index);
         } else {
-          $.getJSON(docs_dir + "/doc" + doc_number + ".json", function(data){
-            docs_json[doc_number] = data;
+          try {
+            console.log("loading doc" + doc_number + ".json.gz");
+            const res = await fetch(docs_dir + "/doc" + doc_number + ".json.gz");
+            let raw = await res.arrayBuffer();
+            docs_json[doc_number] = JSON.parse(pako.inflate(raw, {to: "string"}));
             show_tree_in_tdiv(tdiv, doc_number, index);
-          }).fail(function(){
+          } catch(error) {
             if (! load_json_fail_reported) {
               load_json_fail_reported = true;
-              alert("Cannot load " + docs_dir + "/doc" + doc_number
-              + ".json\\nLocal files do not support lazy loading. Run a web server 'python -m http.server'");
+              alert("Cannot load " + docs_dir + "/doc" + doc_number + ".json.gz:\\n" + error);
             }
-          });
+          }
         }
       } else {tree_div.remove();}
     })
@@ -257,7 +266,7 @@ def process_document(self, doc):
         orig_stdout = sys.stdout
         try:
             for i, ud_doc in enumerate(ud_docs[1:], 2):
-                sys.stdout = open(f"{self.docs_dir}/doc{i}.html", 'wt')
+                sys.stdout = gzip.open(f"{self.docs_dir}/doc{i}.html.gz", 'wt')
                 self.process_ud_doc(ud_doc, i)
                 sys.stdout.close()
         finally:
@@ -271,7 +280,7 @@ def process_document(self, doc):
             print('];')
             try:
                 for i, ud_doc in enumerate(ud_docs[1:], 2):
-                    sys.stdout = open(f"{self.docs_dir}/doc{i}.json", 'wt')
+                    sys.stdout = gzip.open(f"{self.docs_dir}/doc{i}.json.gz", 'wt')
                     WRITE_HTML.print_doc_json(ud_doc)
                     sys.stdout.close()
             finally:

From a6b6bd3654f9032b5e62607bab952b2afec7e121 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 4 Apr 2023 19:27:45 +0200
Subject: [PATCH 0801/1374] count number of documents correctly

even if the first tree misses the newdoc annotation
---
 udapi/block/util/wc.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/util/wc.py b/udapi/block/util/wc.py
index e8ea2676..9920d0b6 100644
--- a/udapi/block/util/wc.py
+++ b/udapi/block/util/wc.py
@@ -23,7 +23,7 @@ def process_tree(self, tree):
         self.mwts += mwtoks
         self.tokens += len(tree.token_descendants) if mwtoks else len(tree.descendants)
         self.empty += len(tree.empty_nodes)
-        if tree.newdoc:
+        if tree.newdoc or tree == tree.document[0].trees[0]:
             self.docs += 1
         if tree.newpar:
             self.paragraphs += 1

From e1d4563dea9553f39eee60a235826fb95049db4a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 4 Apr 2023 19:37:48 +0200
Subject: [PATCH 0802/1374] read.Sentences newdoc_if_empty_line=1 should mark
 also the first tree with newdoc

---
 udapi/block/read/sentences.py | 5 +++++
 udapi/core/basereader.py      | 2 +-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/udapi/block/read/sentences.py b/udapi/block/read/sentences.py
index 9b428331..7487d580 100644
--- a/udapi/block/read/sentences.py
+++ b/udapi/block/read/sentences.py
@@ -56,3 +56,8 @@ def read_tree(self, document=None):
         if self.newdoc_if_empty_line and preceded_by_empty_line:
             root.newdoc = True
         return root
+
+    # The first line in a file also marks a start of new document
+    def after_process_document(self, document):
+        if self.newdoc_if_empty_line:
+            document.bundles[0].trees[0].newdoc = True
diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 71d57159..1ff8a4fd 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -314,6 +314,6 @@ def read_documents(self):
         docs = []
         while not self.finished:
             doc = Document()
-            self.process_document(doc)
+            self.apply_on_document(doc)
             docs.append(doc)
         return docs

From e6415af8afd404a05ea1f4eedb23942820ba0bbc Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 5 Apr 2023 13:23:16 +0200
Subject: [PATCH 0803/1374] hint when using a wrong block name

even if there are submodules in that package
or modules with compilation errors
---
 udapi/core/run.py | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/udapi/core/run.py b/udapi/core/run.py
index 418baca6..912c12fc 100644
--- a/udapi/core/run.py
+++ b/udapi/core/run.py
@@ -80,9 +80,13 @@ def _blocks_in_a_package(package_name):
             pname = pname[12:]
         blocks = []
         for sname in submodule_names:
-            module =  __import__(f"{package_name}.{sname}", fromlist="dummy")
-            bname = [c for c in dir(module) if c.lower() == sname][0]
-            blocks.append(f"{pname}.{bname}")
+            try: # ignore modules with compilation errors
+                module =  __import__(f"{package_name}.{sname}", fromlist="dummy")
+                bnames = [c for c in dir(module) if c.lower() == sname]
+                if bnames:
+                    blocks.append(f"{pname}.{bnames[0]}")
+            except:
+                pass
         return blocks
     except:
             return []
@@ -114,13 +118,13 @@ def _import_blocks(block_names, block_args):
             exec(command)  # pylint: disable=exec-used
         except ModuleNotFoundError as err:
             package_name = ".".join(module.split(".")[:-1])
-            blocks = _blocks_in_a_package(package_name)
-            if not blocks:
+            package_blocks = _blocks_in_a_package(package_name)
+            if not package_blocks:
                 raise
             raise ModuleNotFoundError(
                 f"Cannot find block {block_name} (i.e. class {module}.{class_name})\n"
                 f"Available block in {package_name} are:\n"
-                + "\n".join(_blocks_in_a_package(package_name))) from err
+                + "\n".join(package_blocks)) from err
         except Exception as ex:
             logging.warning(f"Cannot import block {block_name} (i.e. class {module}.{class_name})")
             raise

From c3b96bff6dc6d65b9fd72e59f2a7baf61da22385 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 5 Apr 2023 15:00:58 +0200
Subject: [PATCH 0804/1374] writers should simulate "mkdir -p dirname"

---
 udapi/core/basewriter.py | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/udapi/core/basewriter.py b/udapi/core/basewriter.py
index 6e1b7446..95b32a65 100644
--- a/udapi/core/basewriter.py
+++ b/udapi/core/basewriter.py
@@ -2,6 +2,7 @@
 import sys
 import logging
 import os
+from pathlib import Path
 
 import udapi.core.coref
 from udapi.core.block import Block
@@ -62,7 +63,7 @@ def before_process_document(self, document):
                 docname = document.meta.get('docname', None)
                 if docname is not None:
                     logging.info('Writing to file %s.', docname)
-                    sys.stdout = open(docname, 'wt', encoding=self.encoding, newline=self.newline)
+                    sys.stdout = self._open(docname)
                 else:
                     logging.warning('docname_as_file=1 but the document contains no docname')
             elif self.overwrite or self.path:
@@ -81,7 +82,7 @@ def before_process_document(self, document):
                             new_ext = old_ext
                         docname = os.path.join(new_dir, new_file + new_ext)
                     logging.info('Writing to file %s.', docname)
-                    sys.stdout = open(docname, 'wt', encoding=self.encoding, newline=self.newline)
+                    sys.stdout = self._open(docname)
                 else:
                     logging.warning('using overwrite or path but document.meta["loaded_from"] is None')
             else:
@@ -96,10 +97,13 @@ def before_process_document(self, document):
                 sys.stdout = self.orig_stdout
             else:
                 logging.info('Writing to file %s.', filename)
-                sys.stdout = open(filename, 'wt', encoding=self.encoding, newline=self.newline)
+                sys.stdout = self._open(filename)
         if old_filehandle not in (sys.stdout, self.orig_stdout):
             old_filehandle.close()
 
+    def _open(self, filename):
+        Path(filename).parent.mkdir(parents=True, exist_ok=True)
+        return open(filename, 'wt', encoding=self.encoding, newline=self.newline)
 
     def after_process_document(self, document):
         sys.stdout.flush()

From 293c72986c5d9d2512aafb29f6e2f8c35bc1b572 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 5 Apr 2023 18:21:47 +0200
Subject: [PATCH 0805/1374] keep valid CoNLL-U when creating MWTs

---
 udapi/core/root.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/core/root.py b/udapi/core/root.py
index 3e6bf62b..758fb709 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -178,6 +178,10 @@ def create_multiword_token(self, words=None, form=None, misc=None):
         """
         mwt = MWT(words, form, misc, root=self)
         self._mwts.append(mwt)
+        if words[-1].misc["SpaceAfter"] == "No":
+            mwt.misc["SpaceAfter"] = "No"
+        for word in words:
+            word.misc["SpaceAfter"] = ""
         return mwt
 
     @property

From c6465a51e861e14185d2b2efb15a3f892e521556 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 6 Apr 2023 16:25:52 +0200
Subject: [PATCH 0806/1374] Abbr=Yes in ml.

---
 udapi/block/ud/ml/markfeatsbugs.py | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index c2a8e0f4..240355fb 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -29,12 +29,14 @@ def process_node(self, node):
                 'Animacy': ['Anim', 'Inan'],
                 'Number': ['Sing', 'Plur'],
                 'Case': ['Nom', 'Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],
+                'Abbr': ['Yes'],
                 'Foreign': ['Yes'],
                 'Typo': ['Yes']})
         # ADJECTIVES ###########################################################
         elif node.upos == 'ADJ':
             self.check_allowed_features(node, {
                 'VerbForm': ['Part'],
+                'Abbr': ['Yes'],
                 'Foreign': ['Yes'],
                 'Typo': ['Yes']})
         # PRONOUNS #############################################################
@@ -43,6 +45,7 @@ def process_node(self, node):
             af = {
                 'PronType': ['Prs', 'Int', 'Ind'], # demonstrative pronouns are treated as third person personal pronouns
                 'Case': ['Nom', 'Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],
+                'Abbr': ['Yes'],
                 'Typo': ['Yes']
             }
             if node.feats['PronType'] == 'Prs':
@@ -88,6 +91,7 @@ def process_node(self, node):
                 self.check_allowed_features(node, {
                     'PronType': ['Art'],
                     'Definite': ['Ind'],
+                    'Abbr': ['Yes'],
                     'Typo': ['Yes']
                 })
             else:
@@ -95,6 +99,7 @@ def process_node(self, node):
                 self.check_allowed_features(node, {
                     'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg', 'Tot'],
                     'Deixis': ['Prox', 'Remt'],
+                    'Abbr': ['Yes'],
                     'Typo': ['Yes']
                 })
         # NUMERALS #############################################################
@@ -105,6 +110,7 @@ def process_node(self, node):
                 self.check_allowed_features(node, {
                     'NumType': ['Card'],
                     'NumForm': ['Digit', 'Roman'],
+                    'Abbr': ['Yes'],
                     'Typo': ['Yes']
                 })
             else:
@@ -114,6 +120,7 @@ def process_node(self, node):
                     'NumForm': ['Word'],
                     'Number': ['Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],
+                    'Abbr': ['Yes'],
                     'Typo': ['Yes']
                 })
         # VERBS ################################################################
@@ -125,6 +132,7 @@ def process_node(self, node):
                     'Polarity': ['Pos', 'Neg'],
                     'Voice': ['Act', 'Pass', 'Cau'],
                     'Foreign': ['Yes'],
+                    'Abbr': ['Yes'],
                     'Typo': ['Yes']
                 })
             elif node.feats['VerbForm'] == 'Fin':
@@ -140,6 +148,7 @@ def process_node(self, node):
                         'Mood': ['Imp'],
                         'Polarity': ['Pos', 'Neg'],
                         'Polite': ['Infm', 'Form'],
+                        'Abbr': ['Yes'],
                         'Foreign': ['Yes'],
                         'Typo': ['Yes']
                     })
@@ -151,6 +160,7 @@ def process_node(self, node):
                         'Mood': ['Nec'],
                         'Polarity': ['Pos', 'Neg'],
                         'Voice': ['Act', 'Pass', 'Cau'],
+                        'Abbr': ['Yes'],
                         'Foreign': ['Yes'],
                         'Typo': ['Yes']
                     })
@@ -163,6 +173,7 @@ def process_node(self, node):
                         'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
                         'Polarity': ['Pos', 'Neg'],
                         'Voice': ['Act', 'Pass', 'Cau'],
+                        'Abbr': ['Yes'],
                         'Foreign': ['Yes'],
                         'Typo': ['Yes']
                     })
@@ -174,6 +185,7 @@ def process_node(self, node):
                     'Tense': ['Past'],
                     'Polarity': ['Pos', 'Neg'],
                     'Voice': ['Act', 'Pass', 'Cau'],
+                    'Abbr': ['Yes'],
                     'Foreign': ['Yes'],
                     'Typo': ['Yes']
                 })
@@ -190,6 +202,7 @@ def process_node(self, node):
                     'Voice': ['Act', 'Pass', 'Cau'],
                     # We only annotate case of verbal nouns if it is not Nom, i.e., there is an actual case suffix.
                     'Case': ['Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],
+                    'Abbr': ['Yes'],
                     'Foreign': ['Yes'],
                     'Typo': ['Yes']
                 })
@@ -204,6 +217,7 @@ def process_node(self, node):
                         'VerbForm': ['Fin'],
                         'Mood': ['Imp'],
                         'Polarity': ['Pos', 'Neg'],
+                        'Abbr': ['Yes'],
                         'Typo': ['Yes']
                     })
                 else: # indicative or subjunctive
@@ -214,6 +228,7 @@ def process_node(self, node):
                         'Mood': ['Ind', 'Sub', 'Cnd'],
                         'Tense': ['Past', 'Imp', 'Pres', 'Fut'], # only in indicative
                         'Polarity': ['Pos', 'Neg'],
+                        'Abbr': ['Yes'],
                         'Typo': ['Yes']
                     })
             else: # verbal noun
@@ -228,6 +243,7 @@ def process_node(self, node):
                     'Polarity': ['Pos', 'Neg'],
                     # We only annotate case of verbal nouns if it is not Nom, i.e., there is an actual case suffix.
                     'Case': ['Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],
+                    'Abbr': ['Yes'],
                     'Typo': ['Yes']
                 })
         # ADVERBS ##############################################################
@@ -248,13 +264,15 @@ def process_node(self, node):
                 # Case suffixes after numbers are separate tokens, they are attached
                 # via the 'case' relation and they bear the Case feature (the number does not).
                 'Case': ['Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],
+                'Abbr': ['Yes'],
                 'Typo': ['Yes']})
         # PARTICLES ############################################################
         elif node.upos == 'PART':
             self.check_allowed_features(node, {
                 'Polarity': ['Neg'],
+                'Abbr': ['Yes'],
                 'Typo': ['Yes']
             })
         # THE REST: NO FEATURES ################################################
         else:
-            self.check_allowed_features(node, {'Typo': ['Yes']})
+            self.check_allowed_features(node, {'Abbr': ['Yes'], 'Typo': ['Yes']})

From 9e6b1fbd5ea5645fb8ab331c16a8fb46f283bae0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 6 Apr 2023 16:43:13 +0200
Subject: [PATCH 0807/1374] ml features

---
 udapi/block/ud/ml/markfeatsbugs.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index 240355fb..e2fae0f5 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -36,6 +36,7 @@ def process_node(self, node):
         elif node.upos == 'ADJ':
             self.check_allowed_features(node, {
                 'VerbForm': ['Part'],
+                'NumType': ['Ord'],
                 'Abbr': ['Yes'],
                 'Foreign': ['Yes'],
                 'Typo': ['Yes']})
@@ -116,7 +117,7 @@ def process_node(self, node):
             else:
                 self.check_required_features(node, ['NumType', 'NumForm', 'Case'])
                 self.check_allowed_features(node, {
-                    'NumType': ['Card'],
+                    'NumType': ['Card', 'Frac'],
                     'NumForm': ['Word'],
                     'Number': ['Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Ben', 'Acc', 'Voc', 'Loc', 'Abl', 'Ins', 'Cmp', 'Com', 'All'],

From 59a8329e0faad77183550437ab395aad728e8243 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 6 Apr 2023 16:49:11 +0200
Subject: [PATCH 0808/1374] Malayalam reflexive pronouns do not take case.

---
 udapi/block/ud/ml/markfeatsbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/ml/markfeatsbugs.py b/udapi/block/ud/ml/markfeatsbugs.py
index e2fae0f5..13c8434c 100644
--- a/udapi/block/ud/ml/markfeatsbugs.py
+++ b/udapi/block/ud/ml/markfeatsbugs.py
@@ -52,7 +52,7 @@ def process_node(self, node):
             if node.feats['PronType'] == 'Prs':
                 af['Reflex'] = ['Yes']
                 if node.feats['Reflex'] == 'Yes':
-                    af['Case'] = [c for c in af['Case'] if c != 'Nom' and c != 'Voc']
+                    rf = ['PronType']
                 else: # not reflexive
                     rf.extend(['Person', 'Number'])
                     af['Person'] = ['1', '2', '3']

From acde65d4ff98c42bc8af93e573381e6a51333a89 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 6 Apr 2023 22:31:35 +0200
Subject: [PATCH 0809/1374] prevent creating nested MWTs

---
 udapi/core/root.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/udapi/core/root.py b/udapi/core/root.py
index 758fb709..eee90f7e 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -176,6 +176,12 @@ def create_multiword_token(self, words=None, form=None, misc=None):
         form: string representing the surface form of the new MWT
         misc: misc attribute of the new MWT
         """
+        # Nested or overlapping MWTs are not allowed in CoNLL-U,
+        # so first remove all previous MWTs containing any of words.
+        for w in words:
+            if w.multiword_token:
+                w.multiword_token.remove()
+        # Now, create the new MWT.
         mwt = MWT(words, form, misc, root=self)
         self._mwts.append(mwt)
         if words[-1].misc["SpaceAfter"] == "No":

From f84147cc2d6f5b8ca21efc90be75aded0afc9992 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 6 Apr 2023 22:42:39 +0200
Subject: [PATCH 0810/1374] both MWT and Node should have property `words`

---
 udapi/block/write/vislcg.py |  5 +----
 udapi/core/node.py          | 12 ++++++++++++
 2 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/udapi/block/write/vislcg.py b/udapi/block/write/vislcg.py
index 569b1056..acdf1e80 100644
--- a/udapi/block/write/vislcg.py
+++ b/udapi/block/write/vislcg.py
@@ -64,10 +64,7 @@ def process_tree(self, tree):
         # Print the line with forms and optional upos tags and feats.
         for token in tree.token_descendants:
             print('"<%s>"' % self._escape(token.form))
-            try:
-                words = token.words
-            except AttributeError:
-                words = [token]
+            words = token.words
             print('\t' + self._node(words[0]))
             for nonfirst_mwt_word in words[1:]:
                 print('\t\t' + self._node(nonfirst_mwt_word))
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 8a764498..d51d20d3 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -884,6 +884,18 @@ def multiword_token(self):
         """
         return self._mwt
 
+    @property
+    def words(self):
+        """Return one-item list with this node.
+
+        This property is there for compatibility with udapi.core.mwt.MWT.words.
+        So that it is possible to use code such as:
+          for token in root.token_descendants:
+            words = token.words
+            ...
+        """
+        return [self]
+
     def is_nonprojective(self):
         """Is the node attached to its parent non-projectively?
 

From 35d45617414a4738afdd9ee52cf13b21993c2ba5 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 7 Apr 2023 00:23:40 +0200
Subject: [PATCH 0811/1374] ud.pt.AddHyphenMwt

e.g. "ex - juiz" as three words is converted into a single MWT
"ex-juiz" with two words ("ex" and "juiz").
Questionable compound phrases are skipped, but marked with ToDo in MISC.
---
 udapi/block/ud/pt/addhyphenmwt.py | 37 +++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 udapi/block/ud/pt/addhyphenmwt.py

diff --git a/udapi/block/ud/pt/addhyphenmwt.py b/udapi/block/ud/pt/addhyphenmwt.py
new file mode 100644
index 00000000..9492b1a2
--- /dev/null
+++ b/udapi/block/ud/pt/addhyphenmwt.py
@@ -0,0 +1,37 @@
+"""Block ud.pt.AddHyphenMwt for transforming hyphen compounds into multiword tokens in Portuguese-GSD.
+
+See https://github.com/UniversalDependencies/UD_Portuguese-GSD/issues/39
+"""
+from udapi.core.block import Block
+
+class AddHyphenMwt(Block):
+
+    def _ok(self, token):
+        # The hyphen in "al-Assad" perhaps should be kept as a separate word.
+        return token.form.isalnum() and token.form.lower() != 'al'
+
+    def process_tree(self, root):
+        tokens, i = root.token_descendants, 1
+        while i+1 < len(tokens):
+            start_i = i-1
+            if tokens[i].form == "-" and self._ok(tokens[i-1]) and self._ok(tokens[i+1]):
+                while i+3 < len(tokens) and tokens[i+2].form == "-" and self._ok(tokens[i+3]):
+                    i += 2
+                compound, words = tokens[start_i:i+2], []
+                for token in compound:
+                    words += token.words
+                heads = [w for w in words if w.parent not in words]
+                cuckolds = [w for w in words if w not in heads and any(c not in words for c in w.children)]
+                if len(heads) > 1:
+                    for h in heads:
+                        h.misc["ToDo"] = 'NonCatenaCompound'
+                elif cuckolds:
+                    for c in cuckolds:
+                        c.misc["ToDo"] = 'HasChildrenOutsideCompound'
+                else:
+                    compound_form = "".join(t.form for t in compound)
+                    for hyphen in compound[1::2]:
+                        hyphen.remove()
+                    root.create_multiword_token([w for w in words if w.form != '-'], compound_form)
+                    root.text = None
+            i += 1

From 6c650683fafb71f5516f20f60dc099ca5a928d0b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 18 Apr 2023 09:02:25 +0200
Subject: [PATCH 0812/1374] Summarize the various annotations of "el que"
 relative clauses.

---
 udapi/block/ud/ca/elque.py | 51 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 udapi/block/ud/ca/elque.py

diff --git a/udapi/block/ud/ca/elque.py b/udapi/block/ud/ca/elque.py
new file mode 100644
index 00000000..88ba18cd
--- /dev/null
+++ b/udapi/block/ud/ca/elque.py
@@ -0,0 +1,51 @@
+"""
+This block searches for relative clauses modifying a determiner ('el que...').
+It is written for Catalan but a similar block should work for Spanish and other
+Romance languages.
+"""
+from udapi.core.block import Block
+import logging
+import re
+
+class ElQue(Block):
+
+    def process_node(self, node):
+        # We take 'que' as the central node of the construction.
+        if node.lemma == 'que' and node.upos == 'PRON' and node.parent.ord > node.ord:
+            # We will refer to the parent of 'que' as a verb, although it can be
+            # a non-verbal predicate, too.
+            que = node
+            verb = node.parent
+            # Check the lemma of the determiner. The form may vary for gender and number.
+            if que.prev_node and que.prev_node.lemma == 'el':
+                el = que.prev_node
+                stanford = []
+                adp = None
+                if el.prev_node and el.prev_node.upos == 'ADP':
+                    adp = el.prev_node
+                    parentstr = 'OTHER'
+                    if adp.parent == el:
+                        parentstr = 'el'
+                    elif adp.parent == que:
+                        parentstr = 'que'
+                    elif adp.parent == verb:
+                        parentstr = 'VERB'
+                    stanford.append(adp.deprel + '(' + parentstr + ', ADP)')
+                if el.parent == adp:
+                    parentstr = 'ADP'
+                elif el.parent == que:
+                    parentstr = 'que'
+                elif el.parent == verb:
+                    parentstr = 'VERB'
+                else:
+                    parentstr = 'OTHER'
+                stanford.append(el.deprel + '(' + parentstr + ', el)')
+                stanford.append(que.deprel + '(VERB, que)')
+                if verb.parent == adp:
+                    parentstr = 'ADP'
+                elif verb.parent == el:
+                    parentstr = 'el'
+                else:
+                    parentstr = 'OTHER'
+                stanford.append(verb.deprel + '(' + parentstr + ', VERB)')
+                print('; '.join(stanford))

From bdc7547e518cbafd91cef6e17267d9bc3c73986c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 18 Apr 2023 09:15:59 +0200
Subject: [PATCH 0813/1374] Treat fixed multiword prepositions as one.

---
 udapi/block/ud/ca/elque.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ca/elque.py b/udapi/block/ud/ca/elque.py
index 88ba18cd..31ebf565 100644
--- a/udapi/block/ud/ca/elque.py
+++ b/udapi/block/ud/ca/elque.py
@@ -23,6 +23,8 @@ def process_node(self, node):
                 adp = None
                 if el.prev_node and el.prev_node.upos == 'ADP':
                     adp = el.prev_node
+                    if adp.udeprel == 'fixed':
+                        adp = adp.parent
                     parentstr = 'OTHER'
                     if adp.parent == el:
                         parentstr = 'el'

From d63c6f8cb06d6e42a3742a0b8c518a39d5da1f32 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 18 Apr 2023 10:07:22 +0200
Subject: [PATCH 0814/1374] Extended the ElQue block. Now it can also harmonize
 the annotation.

---
 udapi/block/ud/ca/elque.py | 78 +++++++++++++++++++++++++-------------
 1 file changed, 52 insertions(+), 26 deletions(-)

diff --git a/udapi/block/ud/ca/elque.py b/udapi/block/ud/ca/elque.py
index 31ebf565..1ffa0de6 100644
--- a/udapi/block/ud/ca/elque.py
+++ b/udapi/block/ud/ca/elque.py
@@ -9,6 +9,14 @@
 
 class ElQue(Block):
 
+    def __init__(self, fix=False, **kwargs):
+        """
+        Default: Print the annotation patterns but do not fix anything.
+        fix=1: Do not print the patterns but fix them.
+        """
+        super().__init__(**kwargs)
+        self.fix = fix
+
     def process_node(self, node):
         # We take 'que' as the central node of the construction.
         if node.lemma == 'que' and node.upos == 'PRON' and node.parent.ord > node.ord:
@@ -19,35 +27,53 @@ def process_node(self, node):
             # Check the lemma of the determiner. The form may vary for gender and number.
             if que.prev_node and que.prev_node.lemma == 'el':
                 el = que.prev_node
-                stanford = []
                 adp = None
                 if el.prev_node and el.prev_node.upos == 'ADP':
                     adp = el.prev_node
                     if adp.udeprel == 'fixed':
                         adp = adp.parent
-                    parentstr = 'OTHER'
-                    if adp.parent == el:
-                        parentstr = 'el'
-                    elif adp.parent == que:
-                        parentstr = 'que'
-                    elif adp.parent == verb:
-                        parentstr = 'VERB'
-                    stanford.append(adp.deprel + '(' + parentstr + ', ADP)')
-                if el.parent == adp:
-                    parentstr = 'ADP'
-                elif el.parent == que:
-                    parentstr = 'que'
-                elif el.parent == verb:
-                    parentstr = 'VERB'
-                else:
-                    parentstr = 'OTHER'
-                stanford.append(el.deprel + '(' + parentstr + ', el)')
-                stanford.append(que.deprel + '(VERB, que)')
-                if verb.parent == adp:
-                    parentstr = 'ADP'
-                elif verb.parent == el:
-                    parentstr = 'el'
+                if self.fix:
+                    self.fix_pattern(adp, el, que, verb)
                 else:
-                    parentstr = 'OTHER'
-                stanford.append(verb.deprel + '(' + parentstr + ', VERB)')
-                print('; '.join(stanford))
+                    self.print_pattern(adp, el, que, verb)
+
+    def print_pattern(self, adp, el, que, verb):
+        stanford = []
+        if adp:
+            if adp.parent == el:
+                parentstr = 'el'
+            elif adp.parent == que:
+                parentstr = 'que'
+            elif adp.parent == verb:
+                parentstr = 'VERB'
+            else:
+                parentstr = 'OTHER'
+            stanford.append(adp.deprel + '(' + parentstr + ', ADP)')
+        if el.parent == adp:
+            parentstr = 'ADP'
+        elif el.parent == que:
+            parentstr = 'que'
+        elif el.parent == verb:
+            parentstr = 'VERB'
+        else:
+            parentstr = 'OTHER'
+        stanford.append(el.deprel + '(' + parentstr + ', el)')
+        # We found the verb as the parent of 'que', so we do not need to check the parent of 'que' now.
+        stanford.append(que.deprel + '(VERB, que)')
+        if verb.parent == adp:
+            parentstr = 'ADP'
+        elif verb.parent == el:
+            parentstr = 'el'
+        else:
+            parentstr = 'OTHER'
+        stanford.append(verb.deprel + '(' + parentstr + ', VERB)')
+        print('; '.join(stanford))
+
+    def fix_pattern(self, adp, el, que, verb):
+        if adp:
+            if adp.parent == que or adp.parent == verb:
+                adp.parent = el
+                adp.deprel = 'case'
+                if len(adp.deps) == 1:
+                    adp.deps[0]['parent'] = el
+                    adp.deps[0]['deprel'] = 'case'

From 3f57dcea1fcae0bce2b64b5001baff17b7753d04 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 18 Apr 2023 10:18:56 +0200
Subject: [PATCH 0815/1374] Attachment of "el".

---
 udapi/block/ud/ca/elque.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/ud/ca/elque.py b/udapi/block/ud/ca/elque.py
index 1ffa0de6..407996f0 100644
--- a/udapi/block/ud/ca/elque.py
+++ b/udapi/block/ud/ca/elque.py
@@ -77,3 +77,8 @@ def fix_pattern(self, adp, el, que, verb):
                 if len(adp.deps) == 1:
                     adp.deps[0]['parent'] = el
                     adp.deps[0]['deprel'] = 'case'
+        if el.parent == que:
+            ###!!! Just a temporary change. In the end it will be attached elsewhere.
+            el.parent = verb
+            if len(el.deps) == 1:
+                el.deps[0]['parent'] = verb

From 1bccb8bccff80a64406430a69e5b96d570522e4b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 18 Apr 2023 11:31:58 +0200
Subject: [PATCH 0816/1374] "El que" re-attach if subject.

---
 udapi/block/ud/ca/elque.py | 31 ++++++++++++++++++++++++++-----
 1 file changed, 26 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/ca/elque.py b/udapi/block/ud/ca/elque.py
index 407996f0..f9b6a2b4 100644
--- a/udapi/block/ud/ca/elque.py
+++ b/udapi/block/ud/ca/elque.py
@@ -72,13 +72,34 @@ def print_pattern(self, adp, el, que, verb):
     def fix_pattern(self, adp, el, que, verb):
         if adp:
             if adp.parent == que or adp.parent == verb:
-                adp.parent = el
-                adp.deprel = 'case'
-                if len(adp.deps) == 1:
-                    adp.deps[0]['parent'] = el
-                    adp.deps[0]['deprel'] = 'case'
+                attach(adp, el, 'case')
         if el.parent == que:
             ###!!! Just a temporary change. In the end it will be attached elsewhere.
+            attach(el, verb)
             el.parent = verb
             if len(el.deps) == 1:
                 el.deps[0]['parent'] = verb
+        if verb.parent != adp and verb.parent != el and verb.parent != que:
+            if re.match(r'^[nc]subj$', verb.udeprel):
+                attach(el, verb.parent, 'nsubj')
+                attach(verb, el, 'acl:relcl')
+                # If anything before 'el' depends on the verb ('cc', 'mark', 'punct' etc.),
+                # re-attach it to 'el'.
+                for c in verb.children:
+                    if c.ord < el.ord and re.match(r'^(cc|mark|case|punct)$', c.udeprel):
+                        attach(c, el)
+
+def attach(node, parent, deprel=None):
+    """
+    Attach a node to a new parent with a new deprel in the basic tree. In
+    addition, if there are enhanced dependencies and there is just one incoming
+    enhanced relation (this is the case in AnCora), this relation will be
+    modified accordingly.
+    """
+    node.parent = parent
+    if deprel:
+        node.deprel = deprel
+    if len(node.deps) == 1:
+        node.deps[0]['parent'] = parent
+        if deprel:
+            node.deps[0]['deprel'] = deprel

From cb0149f6e3897e6cd9e1a1bba4046b92e114521d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 18 Apr 2023 11:57:19 +0200
Subject: [PATCH 0817/1374] "El que" re-attach if object.

---
 udapi/block/ud/ca/elque.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ca/elque.py b/udapi/block/ud/ca/elque.py
index f9b6a2b4..368c6da1 100644
--- a/udapi/block/ud/ca/elque.py
+++ b/udapi/block/ud/ca/elque.py
@@ -80,8 +80,13 @@ def fix_pattern(self, adp, el, que, verb):
             if len(el.deps) == 1:
                 el.deps[0]['parent'] = verb
         if verb.parent != adp and verb.parent != el and verb.parent != que:
+            eldeprel = None
             if re.match(r'^[nc]subj$', verb.udeprel):
-                attach(el, verb.parent, 'nsubj')
+                eldeprel = 'nsubj'
+            elif re.match(r'^ccomp$', verb.udeprel):
+                eldeprel = 'obj'
+            if eldeprel:
+                attach(el, verb.parent, eldeprel)
                 attach(verb, el, 'acl:relcl')
                 # If anything before 'el' depends on the verb ('cc', 'mark', 'punct' etc.),
                 # re-attach it to 'el'.

From c1557d132a945c7b63f14a19b3afae89b4b974af Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 18 Apr 2023 12:08:00 +0200
Subject: [PATCH 0818/1374] "El que" re-attach if oblique or nmod.

---
 udapi/block/ud/ca/elque.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/ud/ca/elque.py b/udapi/block/ud/ca/elque.py
index 368c6da1..3ccde287 100644
--- a/udapi/block/ud/ca/elque.py
+++ b/udapi/block/ud/ca/elque.py
@@ -85,6 +85,10 @@ def fix_pattern(self, adp, el, que, verb):
                 eldeprel = 'nsubj'
             elif re.match(r'^ccomp$', verb.udeprel):
                 eldeprel = 'obj'
+            elif re.match(r'^advcl$', verb.udeprel):
+                eldeprel = 'obl'
+            elif re.match(r'^acl$', verb.udeprel):
+                eldeprel = 'nmod'
             if eldeprel:
                 attach(el, verb.parent, eldeprel)
                 attach(verb, el, 'acl:relcl')

From 985b327ab8dac98a5a196993069a0eb304b3fec5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 18 Apr 2023 12:25:05 +0200
Subject: [PATCH 0819/1374] "El que" re-attach if other relations.

---
 udapi/block/ud/ca/elque.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ca/elque.py b/udapi/block/ud/ca/elque.py
index 3ccde287..6b3ad22b 100644
--- a/udapi/block/ud/ca/elque.py
+++ b/udapi/block/ud/ca/elque.py
@@ -89,6 +89,8 @@ def fix_pattern(self, adp, el, que, verb):
                 eldeprel = 'obl'
             elif re.match(r'^acl$', verb.udeprel):
                 eldeprel = 'nmod'
+            elif re.match(r'^(xcomp|conj|appos|root)$', verb.udeprel):
+                eldeprel = verb.deprel
             if eldeprel:
                 attach(el, verb.parent, eldeprel)
                 attach(verb, el, 'acl:relcl')

From 5b51969642a19980688f670308e67f3fa855d837 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 25 Apr 2023 19:05:11 +0200
Subject: [PATCH 0820/1374] bundle.add_tree(t) should set/update t.sent_id
 according to bundle.bundle_id

also use f-strings and internally faster self._bundle_id
---
 udapi/block/udpipe/base.py |  4 ++--
 udapi/core/bundle.py       | 10 +++++++---
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
index 3ec4a131..3c3d14f0 100644
--- a/udapi/block/udpipe/base.py
+++ b/udapi/block/udpipe/base.py
@@ -153,7 +153,7 @@ def process_document(self, doc):
                             orig_bundle_id = bundle.bundle_id
                             bundle.bundle_id = orig_bundle_id + '-1'
                             for i, new_tree in enumerate(new_trees[1:], 2):
-                                new_bundle = Bundle(document=doc, bundle_id=orig_bundle_id + '-' + str(i))
+                                new_bundle = Bundle(document=doc, bundle_id=f"{orig_bundle_id}-{i}")
                                 new_tree.zone = tree.zone
                                 new_bundle.add_tree(new_tree)
                                 new_bundles.append(new_bundle)
@@ -166,7 +166,7 @@ def process_document(self, doc):
                             bundle.bundle_id = orig_bundle_id + '-1'
                             tree.text = sentences[0]
                             for i, sentence in enumerate(sentences[1:], 2):
-                                new_bundle = Bundle(document=doc, bundle_id=orig_bundle_id + '-' + str(i))
+                                new_bundle = Bundle(document=doc, bundle_id=f"{orig_bundle_id}-{i}")
                                 new_tree = new_bundle.create_tree(zone=tree.zone)
                                 new_tree.text = sentence
                                 new_bundles.append(new_bundle)
diff --git a/udapi/core/bundle.py b/udapi/core/bundle.py
index 26a06741..23cc6104 100644
--- a/udapi/core/bundle.py
+++ b/udapi/core/bundle.py
@@ -39,9 +39,9 @@ def bundle_id(self, bundle_id):
                 tree._sent_id = bundle_id + '/' + tree.zone  # pylint: disable=protected-access
 
     def __str__(self):
-        if self.bundle_id is None:
+        if self._bundle_id is None:
             return 'bundle without id'
-        return "bundle id='%s'" % self.bundle_id
+        return f"bundle id='{self._bundle_id}'"
 
     def __iter__(self):
         return iter(self.trees)
@@ -91,6 +91,10 @@ def add_tree(self, root):
         if root.zone is None:
             root._zone = ''
         self.check_zone(root.zone)
+        if self._bundle_id:
+            root._sent_id = self._bundle_id
+            if root.zone:
+                root._sent_id += '/' + root.zone
         root.bundle = self
         self.trees.append(root)
         doc_json = root.json.get('__doc__')
@@ -107,7 +111,7 @@ def remove(self):
 
     def address(self):
         """Return bundle_id or '?' if missing."""
-        return self.bundle_id if self.bundle_id is not None else '?'
+        return self._bundle_id if self._bundle_id is not None else '?'
 
     def draw(self, **kwargs):
         """Pretty print the trees using TextModeTrees."""

From 14a18f5370a88ffcac13ddf29c932f0a9e03c7f3 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 6 May 2023 13:25:30 +0200
Subject: [PATCH 0821/1374] Cloned the Catalan ElQue block for Spanish, which
 also has "el cual".

---
 udapi/block/ud/es/elque.py | 116 +++++++++++++++++++++++++++++++++++++
 1 file changed, 116 insertions(+)
 create mode 100644 udapi/block/ud/es/elque.py

diff --git a/udapi/block/ud/es/elque.py b/udapi/block/ud/es/elque.py
new file mode 100644
index 00000000..4d14b98d
--- /dev/null
+++ b/udapi/block/ud/es/elque.py
@@ -0,0 +1,116 @@
+"""
+This block searches for relative clauses modifying a determiner ('el que, el cual...').
+It is written for Spanish but a similar block should work for other Romance
+languages.
+"""
+from udapi.core.block import Block
+import logging
+import re
+
+class ElQue(Block):
+
+    def __init__(self, fix=False, **kwargs):
+        """
+        Default: Print the annotation patterns but do not fix anything.
+        fix=1: Do not print the patterns but fix them.
+        """
+        super().__init__(**kwargs)
+        self.fix = fix
+
+    def process_node(self, node):
+        # We take 'que' as the central node of the construction.
+        if re.match(r'^(que|cual)$', node.lemma) and node.upos == 'PRON' and node.parent.ord > node.ord:
+            # We will refer to the parent of 'que' as a verb, although it can be
+            # a non-verbal predicate, too.
+            que = node
+            verb = node.parent
+            # Check the lemma of the determiner. The form may vary for gender and number.
+            if que.prev_node and que.prev_node.lemma == 'el':
+                el = que.prev_node
+                adp = None
+                if el.prev_node and el.prev_node.upos == 'ADP':
+                    adp = el.prev_node
+                    if adp.udeprel == 'fixed':
+                        adp = adp.parent
+                if self.fix:
+                    self.fix_pattern(adp, el, que, verb)
+                else:
+                    self.print_pattern(adp, el, que, verb)
+
+    def print_pattern(self, adp, el, que, verb):
+        stanford = []
+        if adp:
+            if adp.parent == el:
+                parentstr = 'el'
+            elif adp.parent == que:
+                parentstr = 'que'
+            elif adp.parent == verb:
+                parentstr = 'VERB'
+            else:
+                parentstr = 'OTHER'
+            stanford.append(adp.deprel + '(' + parentstr + ', ADP)')
+        if el.parent == adp:
+            parentstr = 'ADP'
+        elif el.parent == que:
+            parentstr = 'que'
+        elif el.parent == verb:
+            parentstr = 'VERB'
+        else:
+            parentstr = 'OTHER'
+        stanford.append(el.deprel + '(' + parentstr + ', el)')
+        # We found the verb as the parent of 'que', so we do not need to check the parent of 'que' now.
+        stanford.append(que.deprel + '(VERB, que)')
+        if verb.parent == adp:
+            parentstr = 'ADP'
+        elif verb.parent == el:
+            parentstr = 'el'
+        else:
+            parentstr = 'OTHER'
+        stanford.append(verb.deprel + '(' + parentstr + ', VERB)')
+        print('; '.join(stanford))
+
+    def fix_pattern(self, adp, el, que, verb):
+        if adp:
+            if adp.parent == que or adp.parent == verb:
+                attach(adp, el, 'case')
+        if el.parent == que:
+            ###!!! Just a temporary change. In the end it will be attached elsewhere.
+            attach(el, verb)
+            el.parent = verb
+            if len(el.deps) == 1:
+                el.deps[0]['parent'] = verb
+        if verb.parent != adp and verb.parent != el and verb.parent != que:
+            eldeprel = None
+            if re.match(r'^[nc]subj$', verb.udeprel):
+                eldeprel = 'nsubj'
+            elif re.match(r'^ccomp$', verb.udeprel):
+                eldeprel = 'obj'
+            elif re.match(r'^advcl$', verb.udeprel):
+                eldeprel = 'obl'
+            elif re.match(r'^acl$', verb.udeprel):
+                eldeprel = 'nmod'
+            elif re.match(r'^(xcomp|conj|appos|root)$', verb.udeprel):
+                eldeprel = verb.deprel
+            if eldeprel:
+                attach(el, verb.parent, eldeprel)
+                attach(verb, el, 'acl:relcl')
+                # If anything before 'el' depends on the verb ('cc', 'mark', 'punct' etc.),
+                # re-attach it to 'el'.
+                for c in verb.children:
+                    if c.ord < el.ord and re.match(r'^(cc|mark|case|punct)$', c.udeprel):
+                        attach(c, el)
+
+def attach(node, parent, deprel=None):
+    """
+    Attach a node to a new parent with a new deprel in the basic tree. In
+    addition, if there are enhanced dependencies and there is just one incoming
+    enhanced relation (this is the case in AnCora), this relation will be
+    modified accordingly.
+    """
+    node.parent = parent
+    if deprel:
+        node.deprel = deprel
+    if len(node.deps) == 1:
+        node.deps[0]['parent'] = parent
+        if deprel:
+            node.deps[0]['deprel'] = deprel

From d208cfbce3b78f5d9640736143318ae98ce030f3 Mon Sep 17 00:00:00 2001
From: CircleCI Config Suggestions Bot
 <131677722+CircleCI-config-suggestions-bot@users.noreply.github.com>
Date: Fri, 5 May 2023 14:21:30 -0400
Subject: [PATCH 0822/1374] Upload test results to CircleCI

---
 .circleci/config.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 4e88d664..988f321d 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -36,10 +36,13 @@ jobs:
       - run:
           name: Install Udapi
           command: pip install ".[test]"
+      - run: mkdir -p test-results
       - run:
           name: Run pytest tests
           # This assumes pytest is installed via the install-package step above
-          command: pytest
+          command: pytest --junitxml=test-results/junit.xml -o junit_family=legacy
+      - store_test_results:
+          path: test-results
       - run:
           name: Color TextModeTrees
           command: udapy read.Conllu files=udapi/core/tests/data/babinsky.conllu write.TextModeTrees color=1

From bcb31f016ab8f685e52eed3c351eace450e750a3 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 9 May 2023 12:46:00 +0200
Subject: [PATCH 0823/1374] try to solve build failures at
 https://readthedocs.org/

---
 .readthedocs.yaml | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 .readthedocs.yaml

diff --git a/.readthedocs.yaml b/.readthedocs.yaml
new file mode 100644
index 00000000..f26f84cf
--- /dev/null
+++ b/.readthedocs.yaml
@@ -0,0 +1,19 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Currently, RTD needs to select an OS with OpenSSL>=1.1.1 because of
+# urllib3's dependence on that system library.  (alternately, pin urllib3<2
+# See https://github.com/urllib3/urllib3/issues/2168
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.10"
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+  fail_on_warning: true

From d98beee9878adef71661a4d59abcba509db49053 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 9 May 2023 12:50:52 +0200
Subject: [PATCH 0824/1374] readthedocs build fails because of missing colorama

---
 .readthedocs.yaml     | 6 +++++-
 docs/requirements.txt | 3 ++-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/.readthedocs.yaml b/.readthedocs.yaml
index f26f84cf..8804cc4e 100644
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@@ -16,4 +16,8 @@ build:
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
   configuration: docs/conf.py
-  fail_on_warning: true
+  fail_on_warning: false
+
+python:
+   install:
+   - requirements: docs/requirements.txt
diff --git a/docs/requirements.txt b/docs/requirements.txt
index a994db47..044d3af7 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,2 +1,3 @@
-colorama
+colorama>=0.4.6
 termcolor
+ufal.udpipe

From bb51c9397a77dd26ee39c790a62745003a314c6a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 30 May 2023 07:42:14 +0200
Subject: [PATCH 0825/1374] Czech third-person personal pronouns must allow
 Variant=Short.

---
 udapi/block/ud/cs/markfeatsbugs.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 30ee90b2..7e06f27f 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -222,7 +222,7 @@ def process_node(self, node):
                                 'PronType': ['Prs'],
                                 'Person': ['3']
                             })
-                        else: # jeho, něho, jemu, němu, jej, něj, něm, jím, ním, jí, ní, ji, ni, je, ně
+                        else: # jeho, něho, ho, jemu, němu, mu, jej, něj, něm, jím, ním, jí, ní, ji, ni, je, ně
                             # Mostly only two gender groups and no animacy:
                             # Masc,Neut ... jeho, jemu, jej, něm, jím
                             # Fem ... jí, ji, ní
@@ -232,7 +232,8 @@ def process_node(self, node):
                             self.check_adjective_like(node, ['PronType', 'Person', 'PrepCase'], {
                                 'PronType': ['Prs'],
                                 'Person': ['3'],
-                                'PrepCase': ['Npr', 'Pre']
+                                'PrepCase': ['Npr', 'Pre'],
+                                'Variant': ['Short']
                             })
                     else: # 1st and 2nd person do not have gender: já, ty
                         self.check_required_features(node, ['PronType', 'Person', 'Number', 'Case'])

From 28b05fe6e3caf7d1a959d096b247583cd77fc946 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 30 May 2023 07:49:18 +0200
Subject: [PATCH 0826/1374] Clitic third-person pronouns do not have PrepCase.

---
 udapi/block/ud/cs/markfeatsbugs.py | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 7e06f27f..2c113f7a 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -222,18 +222,25 @@ def process_node(self, node):
                                 'PronType': ['Prs'],
                                 'Person': ['3']
                             })
-                        else: # jeho, něho, ho, jemu, němu, mu, jej, něj, něm, jím, ním, jí, ní, ji, ni, je, ně
+                        elif node.feats['Variant'] == 'Short': # ho, mu
+                            # The short (clitic) forms do not have PrepCase.
+                            self.check_adjective_like(node, ['PronType', 'Person'], {
+                                'PronType': ['Prs'],
+                                'Person': ['3'],
+                                'Variant': ['Short']
+                            })
+                        else: # jeho, něho, jemu, němu, jej, něj, něm, jím, ním, jí, ní, ji, ni, je, ně
                             # Mostly only two gender groups and no animacy:
                             # Masc,Neut ... jeho, jemu, jej, něm, jím
                             # Fem ... jí, ji, ní
                             # Neut ... je
                             # No gender in dual and plural:
                             # Plur ... jich, jim, je, nich, jimi
+                            # Here we require PrepCase but disallow Variant.
                             self.check_adjective_like(node, ['PronType', 'Person', 'PrepCase'], {
                                 'PronType': ['Prs'],
                                 'Person': ['3'],
-                                'PrepCase': ['Npr', 'Pre'],
-                                'Variant': ['Short']
+                                'PrepCase': ['Npr', 'Pre']
                             })
                     else: # 1st and 2nd person do not have gender: já, ty
                         self.check_required_features(node, ['PronType', 'Person', 'Number', 'Case'])

From 3d24ef5e1b774cb161f26065fc658a5a8b024af0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 30 May 2023 08:22:48 +0200
Subject: [PATCH 0827/1374] Allow VerbForm=Vnoun for verbal nouns.

---
 udapi/block/ud/cs/markfeatsbugs.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 2c113f7a..96e65b0f 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -28,7 +28,13 @@ def process_node(self, node):
         # NOUNS ################################################################
         if node.upos == 'NOUN':
             self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity'])
-            if node.feats['Gender'] == 'Masc':
+            if node.feats['VerbForm'] == 'Vnoun':
+                # verbal nouns: bytí, dělání, ...
+                self.check_allowed_features(node, {
+                    'Gender': ['Neut'],
+                    'Foreign': ['Yes']
+                })
+            elif node.feats['Gender'] == 'Masc':
                 self.check_required_features(node, ['Animacy'])
                 self.check_allowed_features(node, {
                     'Gender': ['Masc', 'Fem', 'Neut'],

From 20cc9a26660b79348dec03d76d4606459f415033 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 30 May 2023 08:26:02 +0200
Subject: [PATCH 0828/1374] Allow VerbForm=Vnoun for verbal nouns.

---
 udapi/block/ud/cs/markfeatsbugs.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 96e65b0f..7c9f3527 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -31,7 +31,11 @@ def process_node(self, node):
             if node.feats['VerbForm'] == 'Vnoun':
                 # verbal nouns: bytí, dělání, ...
                 self.check_allowed_features(node, {
+                    'VerbForm': ['Vnoun'],
                     'Gender': ['Neut'],
+                    'Number': ['Sing', 'Dual', 'Plur'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'Polarity': ['Pos', 'Neg'],
                     'Foreign': ['Yes']
                 })
             elif node.feats['Gender'] == 'Masc':

From 7cd1ef1ecdf913704bbbe553b45f2f73d636d3ea Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 30 May 2023 09:00:12 +0200
Subject: [PATCH 0829/1374] =?UTF-8?q?Allow=20Variant=3DShort=20for=20"s?=
 =?UTF-8?q?=C3=A1m".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 7c9f3527..ac8a435f 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -390,8 +390,11 @@ def process_node(self, node):
                         'Person': ['1', '2'],
                         'Number[psor]': ['Sing', 'Plur']
                     })
+            elif re.match(r'^(samý)$', node.lemma):
+                # Unlike other determiners, it allows Variant=Short: sám, sama, samu, samo, sami, samy.
+                self.check_adjective_like(node, ['PronType'], {'PronType': ['Emp'], 'Variant': ['Short']})
             else:
-                self.check_adjective_like(node, ['PronType'], {'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot', 'Emp']})
+                self.check_adjective_like(node, ['PronType'], {'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot']})
         # NUMERALS #############################################################
         elif node.upos == 'NUM':
             self.check_required_features(node, ['NumType', 'NumForm'])

From 027eaf42d4056ab68870d0f9b6bbbc08352ef5fa Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 30 May 2023 18:08:04 +0200
Subject: [PATCH 0830/1374] Do not apply Czech constraints to foreign words.

---
 udapi/block/ud/cs/markfeatsbugs.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index ac8a435f..3c1a29ac 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -25,8 +25,11 @@ class MarkFeatsBugs(udapi.block.ud.markfeatsbugs.MarkFeatsBugs):
     pdt20 = False # True = like in PDT 2.0; False = like in ČNK
 
     def process_node(self, node):
+        # Czech constraints should not be applied to foreign words.
+        if node.feats['Foreign'] == 'Yes':
+            pass
         # NOUNS ################################################################
-        if node.upos == 'NOUN':
+        elif node.upos == 'NOUN':
             self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity'])
             if node.feats['VerbForm'] == 'Vnoun':
                 # verbal nouns: bytí, dělání, ...

From a9050283fe1530e9f14dcbe5ffc10e64b2f85eae Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 1 Jun 2023 16:43:12 +0200
Subject: [PATCH 0831/1374] NumValue is not useful and was annotated oddly in
 the Czech data.

---
 udapi/block/ud/cs/markfeatsbugs.py | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 3c1a29ac..7e1f8ffb 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -408,29 +408,26 @@ def process_node(self, node):
                     'NumForm': ['Digit', 'Roman']
                 })
             else:
-                ###!!! Somehow the NumValue feature from PDT via Interset is useless.
                 # 'jeden' has Gender, Animacy, Number, Case: jeden, jedna, jedno, jednoho, jednomu, jednom, jedním, jedné, jednu, jednou, jedni, jedny, jedněch, jedněm, jedněmi.
                 # 'dva', 'oba' have Gender, Number=Dual(Plur in modern Czech), Case: dva, dvě, dvou, dvěma.
                 # 'tři', 'čtyři' have Number=Plur, Case: tři, třech, třem, třemi.
                 # 'pět' and more have Number=Plur, Case: pět, pěti.
                 if node.lemma == 'jeden':
-                    self.check_required_features(node, ['NumType', 'NumForm', 'NumValue', 'Number', 'Case'])
+                    self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
                     self.check_allowed_features(node, {
                         'NumType': ['Card'],
                         'NumForm': ['Word'],
-                        'NumValue': ['1,2,3'],
                         'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # similarly to determiners, genders are merged in some slots of the paradigm
                         'Animacy': ['Anim', 'Inan'],
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
                 elif re.match(r'^(dva|oba)$', node.lemma):
-                    self.check_required_features(node, ['NumType', 'NumForm', 'NumValue', 'Gender', 'Number', 'Case'])
+                    self.check_required_features(node, ['NumType', 'NumForm', 'Gender', 'Number', 'Case'])
                     if self.pdt20:
                         self.check_allowed_features(node, {
                             'NumType': ['Card'],
                             'NumForm': ['Word'],
-                            'NumValue': ['1,2,3'],
                             'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # similarly to determiners, genders are merged in some slots of the paradigm
                             'Number': ['Dual', 'Plur'],
                             'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
@@ -439,7 +436,6 @@ def process_node(self, node):
                         self.check_allowed_features(node, {
                             'NumType': ['Card'],
                             'NumForm': ['Word'],
-                            'NumValue': ['1,2,3'],
                             'Gender': ['Masc', 'Fem', 'Neut'],
                             'Animacy': ['Anim', 'Inan'],
                             'Number': ['Dual', 'Plur'],
@@ -450,7 +446,6 @@ def process_node(self, node):
                     self.check_allowed_features(node, {
                         'NumType': ['Card'],
                         'NumForm': ['Word'],
-                        'NumValue': ['1,2,3'],
                         'Number': ['Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })

From 9760e6999138c8e9435ce280b453f5411321d7a1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 1 Jul 2023 18:18:04 +0200
Subject: [PATCH 0832/1374] Update positions of empty nodes when regular nodes
 are shifted.

---
 udapi/core/node.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index d51d20d3..eb0dcbf1 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -574,6 +574,7 @@ def remove(self, children=None):
     def _shift_before_ord(self, reference_ord, without_children=False):
         """Internal method for changing word order."""
         all_nodes = self._root._descendants
+        empty_nodes = self._root.empty_nodes
 
         # Moving a single node can be faster than nodes_to_move = [self]
         if without_children or not self._children:
@@ -584,14 +585,22 @@ def _shift_before_ord(self, reference_ord, without_children=False):
                     all_nodes[i_ord - 1]._ord = i_ord
                 all_nodes[reference_ord - 2] = self
                 self._ord = reference_ord - 1
+                for en in empty_nodes:
+                    if en._ord > my_ord and en._ord < reference_ord:
+                        en._ord -= 1
             elif reference_ord < my_ord:
                 for i_ord in range(my_ord, reference_ord, -1):
                     all_nodes[i_ord - 1] = all_nodes[i_ord - 2]
                     all_nodes[i_ord - 1]._ord = i_ord
                 all_nodes[reference_ord - 1] = self
                 self._ord = reference_ord
+                for en in empty_nodes:
+                    ###!!! Empty nodes before the first overt token (ID=0.X) will be never moved this way. We cannot know whether the caller wanted to place the shifted node before or after them.
+                    if en._ord < my_ord and en._ord > reference_ord:
+                        en._ord += 1
             return
 
+        ###!!! Updating ords of empty nodes is implemented for the simple case above but it has to be implemented also for the complex case below!
         nodes_to_move = self.descendants(add_self=True)
         first_ord, last_ord = nodes_to_move[0]._ord, nodes_to_move[-1]._ord
 

From e5b51864f29ef33c55f1b42102a9ffb469593511 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 19 Sep 2023 09:28:51 +0200
Subject: [PATCH 0833/1374] A new block to survey fixed multiword expressions
 in UD treebanks.

---
 udapi/block/ud/printfixed.py | 104 +++++++++++++++++++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 udapi/block/ud/printfixed.py

diff --git a/udapi/block/ud/printfixed.py b/udapi/block/ud/printfixed.py
new file mode 100644
index 00000000..313943bb
--- /dev/null
+++ b/udapi/block/ud/printfixed.py
@@ -0,0 +1,104 @@
+"""
+Block PrintFixed prints occurrences of fixed multiword expressions in UD. It
+can be run twice in a row, first collecting known fixed expressions and then
+also reporting other occurrences of these expressions where they are not
+annotated as fixed.
+
+Usage:
+udapy ud.PrintFixed only_forms=1 < in.conllu | sort -u > fixed_expressions.txt
+udapy ud.PrintFixed known_expressions=fixed_expressions.txt < in.conllu | sort | uniq -c | less
+
+Author: Dan Zeman
+"""
+from udapi.core.block import Block
+import re
+import logging
+
+class PrintFixed(Block):
+    """
+    Print fixed multiword expressions.
+    """
+
+    def __init__(self, only_forms=False, known_expressions=None, **kwargs):
+        """
+        Create the PrintFixed block.
+
+        Parameters:
+        only_forms=1: print the word forms but not tags and other info;
+            This can be used to create the list of known forms that we want to
+            identify even if they are not annotated as fixed.
+        known_expressions: the name of the text file with the expressions
+        """
+        super().__init__(**kwargs)
+        self.only_forms = only_forms
+        self.known_expressions = {}
+        self.first_words = {}
+        self.max_length = 2
+        if known_expressions:
+            fh = open(known_expressions, 'r', encoding='utf-8')
+            n = 0
+            for expression in fh.readlines():
+                expression = expression.replace('\n', '')
+                if expression in self.known_expressions:
+                    self.known_expressions[expression] += 1
+                else:
+                    self.known_expressions[expression] = 1
+                    logging.info("Read known fixed expression '%s'" % expression)
+                    n += 1
+                words = expression.split(' ')
+                first_word = words[0]
+                self.first_words[first_word] = 1
+                length = len(words)
+                if length > self.max_length:
+                    self.max_length = length
+            logging.info('Read %d known fixed expressions.' % n)
+
+    def process_node(self, node):
+        fixed_children = [x for x in node.children if x.udeprel == 'fixed']
+        if len(fixed_children) > 0:
+            # Fixed children are always to the right of of the parent. But there
+            # may be other nodes in between that are not fixed children (for
+            # example, there may be punctuation that is attached to one of the
+            # fixed nodes).
+            n = node
+            list_of_forms = [node.form.lower()]
+            list_of_tags = [node.upos]
+            while n != fixed_children[-1]:
+                n = n.next_node
+                if n.parent == node and n.udeprel == 'fixed':
+                    list_of_forms.append(n.form.lower())
+                    list_of_tags.append(n.upos)
+                else:
+                    list_of_forms.append('X')
+                    list_of_tags.append('X')
+            forms = ' '.join(list_of_forms)
+            tags = ' '.join(list_of_tags)
+            if self.only_forms:
+                print(forms)
+            else:
+                print("%s / %s / %s" % (forms, tags, node.deprel))
+        else:
+            # If this is not the first word of a fixed expression, check whether
+            # something that looks like a known fixed expression starts here.
+            # Note that it is also possible that a known expression starts here
+            # but only a subset is actually marked as such; we currently do not
+            # account for this.
+            if node.form.lower() in self.first_words:
+                n = node
+                list_of_forms = [node.form.lower()]
+                list_of_tags = [node.upos]
+                for i in range(self.max_length - 1):
+                    n = n.next_node
+                    if not n:
+                        break
+                    ###!!! At present we cannot identify known expressions with gaps ('X').
+                    list_of_forms.append(n.form.lower())
+                    list_of_tags.append(n.upos)
+                    forms = ' '.join(list_of_forms)
+                    if forms in self.known_expressions:
+                        if self.only_forms:
+                            print(forms)
+                        else:
+                            tags = ' '.join(list_of_tags)
+                            print("%s / %s / NOT FIXED" % (forms, tags))
+                        break

From 404af3dc15819b4e3c493a61cfeb72cea6a8aaf6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 20 Sep 2023 17:45:25 +0200
Subject: [PATCH 0834/1374] allow `udapi.Document("file name with
 spaces.conllu")`

---
 udapi/core/document.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/core/document.py b/udapi/core/document.py
index d6a84f0e..65ef5a75 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -34,7 +34,7 @@ def __init__(self, filename=None, **kwargs):
             if filename.endswith(".conllu"):
                 self.load_conllu(filename, **kwargs)
             elif filename.endswith(".txt"):
-                reader = SentencesReader(files=filename, **kwargs)
+                reader = SentencesReader(files=[filename], **kwargs)
                 reader.apply_on_document(self)
             else:
                 raise ValueError("Only *.conllu and *.txt are supported. Provided: " + filename)
@@ -65,11 +65,11 @@ def create_bundle(self):
 
     def load_conllu(self, filename=None, **kwargs):
         """Load a document from a conllu-formatted file."""
-        ConlluReader(files=filename, **kwargs).process_document(self)
+        ConlluReader(files=[filename], **kwargs).process_document(self)
 
     def store_conllu(self, filename):
         """Store a document into a conllu-formatted file."""
-        ConlluWriter(files=filename).apply_on_document(self)
+        ConlluWriter(files=[filename]).apply_on_document(self)
 
     def from_conllu_string(self, string):
         """Load a document from a conllu-formatted string."""

From a15082dc86ef2337dc3948f59cba2a4726d6d939 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 25 Sep 2023 22:23:28 +0200
Subject: [PATCH 0835/1374] make sure node.children are always sorted

even after calling shift_* methods
---
 udapi/core/node.py            | 3 +++
 udapi/core/tests/test_node.py | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index d51d20d3..03afb6f0 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -590,6 +590,7 @@ def _shift_before_ord(self, reference_ord, without_children=False):
                     all_nodes[i_ord - 1]._ord = i_ord
                 all_nodes[reference_ord - 1] = self
                 self._ord = reference_ord
+            self._parent._children.sort()
             return
 
         nodes_to_move = self.descendants(add_self=True)
@@ -615,6 +616,7 @@ def _shift_before_ord(self, reference_ord, without_children=False):
             for node in nodes_to_move:
                 all_nodes[trg_ord - 1], node._ord = node, trg_ord
                 trg_ord += 1
+            self._parent._children.sort()
             return
 
         # First, move a node from position src_ord to position trg_ord RIGHT-ward.
@@ -648,6 +650,7 @@ def _shift_before_ord(self, reference_ord, without_children=False):
         for node in nodes_to_move:
             all_nodes[trg_ord - 1], node._ord = node, trg_ord
             trg_ord += 1
+        self._parent._children.sort()
 
     def shift_after_node(self, reference_node, without_children=False, skip_if_descendant=False):
         """Shift this node after the reference_node."""
diff --git a/udapi/core/tests/test_node.py b/udapi/core/tests/test_node.py
index 8bc7f182..381f5741 100755
--- a/udapi/core/tests/test_node.py
+++ b/udapi/core/tests/test_node.py
@@ -61,6 +61,9 @@ def test_topology(self):
         nodes[0].shift_after_node(nodes[1])
         self.assertEqual([node.ord for node in nodes], [2, 1, 3, 4, 5, 6])
         self.assertEqual([node.ord for node in root.descendants()], [1, 2, 3, 4, 5, 6])
+        self.assertEqual([node.ord for node in nodes[1].children], [2, 3, 4])
+        nodes[3].shift_before_node(nodes[2])
+        self.assertEqual([node.ord for node in nodes[1].children], [2, 3, 6])
 
     def test_draw(self):
         """Test the draw() method, which uses udapi.block.write.textmodetrees."""

From 06877ad326a1ee82453be70c9823ca22b9d2246f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 25 Sep 2023 23:10:14 +0200
Subject: [PATCH 0836/1374] allow loading invalid CoNLL-U files with more than
 1 empty line

---
 udapi/block/read/conllu.py | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index d5623fba..a8e73375 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -82,8 +82,13 @@ def parse_comment_line(self, line, root):
 
     def read_trees(self):
         if not self.max_docs:
+            # Valid CoNLL-U files must have sentences separated by a single empty line.
+            # However, some users have to work with invalid files e.g. ending with two empty lines.
+            # It is obvious how to parse such files and re.split(r'\n\n+', s) is only twice as slow
+            # as s.split('\n\n') and this time is negligble
+            # relative to the main CoNLL-U parsing in read_tree_from_lines().
             return [self.read_tree_from_lines(s.split('\n')) for s in
-                    self.filehandle.read().split('\n\n') if s]
+                    re.split(r'\n\n+', self.filehandle.read()) if s]
         # udapi.core.basereader takes care about the max_docs parameter.
         # However, we can make the loading much faster by not reading
         # the whole file if the user wants just first N documents.
@@ -91,13 +96,13 @@ def read_trees(self):
         for line in self.filehandle:
             line = line.rstrip()
             if line == '':
-               tree = self.read_tree_from_lines(lines)
-               lines = []
-               if tree.newdoc:
-                   if loaded_docs == self.max_docs:
-                       return trees
-                   loaded_docs += 1
-               trees.append(tree)
+                tree = self.read_tree_from_lines(lines)
+                lines = []
+                if tree.newdoc:
+                    if loaded_docs == self.max_docs:
+                        return trees
+                    loaded_docs += 1
+                trees.append(tree)
             else:
                 lines.append(line)
         return

From 50aab192fa0f80ec02d933074060d0e84a561cd0 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 9 Oct 2023 17:48:01 +0200
Subject: [PATCH 0837/1374] AddMwt merges possible existing MWTs with the new
 ones

Also, some MISC attributes (SpaceAfter,...) are required to stay on the token level,
other MISC attributes (Entity) are required to stay on the word level,
and the remaining MISC attributes can be either word xor token level
depending on whether `multiword_analysis(node)['misc'] == '*'`.
---
 udapi/block/ud/addmwt.py | 34 ++++++++++++++++++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/addmwt.py b/udapi/block/ud/addmwt.py
index 2d251989..996f4dc9 100644
--- a/udapi/block/ud/addmwt.py
+++ b/udapi/block/ud/addmwt.py
@@ -15,6 +15,9 @@ def process_node(self, node):
             orig_attr[attr] = getattr(node, attr)
         orig_attr['feats'] = node.feats.copy()
         orig_attr['misc'] = node.misc.copy()
+        # Defaults for the newly created MWT
+        mwt_misc = node.misc.copy()
+        mwt_form = node.form
 
         forms = analysis['form'].split()
         main = analysis.get('main', 0)
@@ -37,6 +40,7 @@ def process_node(self, node):
         elif orig_attr['form'][0].isupper():
             nodes[0].form = nodes[0].form.title()
 
+        node.misc = None
         for attr in 'lemma upos xpos feats deprel misc'.split():
             if attr in analysis:
                 values = analysis[attr].split()
@@ -47,6 +51,17 @@ def process_node(self, node):
                             logging.warning("%s = %s" % (attr, analysis.get(attr, '')))
                     if values[i] == '*':
                         setattr(new_node, attr, orig_attr[attr])
+                        # No MISC attribute should be duplicated on the word level and token level,
+                        # so if copying MISC to a new_node, delete mwt_misc.
+                        # However, SpaceAfter should be annotated only on the token level,
+                        # so make sure it is not accidentally copied on the word level.
+                        if attr == 'misc':
+                            orig_attr['misc'].clear()
+                            for a in 'SpaceAfter SpacesAfter SpacesBefore'.split():
+                                if new_node.misc[a]:
+                                    orig_attr['misc'][a] = new_node.misc[a]
+                                    del new_node.misc[a]
+
                     elif attr == 'feats' and '*' in values[i]:
                         new_node.feats = values[i]
                         for feat_name, feat_value in list(new_node.feats.items()):
@@ -55,8 +70,23 @@ def process_node(self, node):
                     else:
                         setattr(new_node, attr, values[i])
 
-        mwt = node.root.create_multiword_token(nodes, orig_attr['form'], orig_attr['misc'])
-        node.misc = None
+        # Entity (coreference) annotation should be only on the word level,
+        # so make sure it does not stay on the token level.
+        if mwt_misc['Entity']:
+            nodes[0].misc['Entity'] = mwt_misc['Entity']
+            del mwt_misc['Entity']
+
+        # If node is already part of an MWT, we need to delete the old MWT and extend the new MWT.
+        if node.multiword_token:
+            mwt_words = node.multiword_token.words
+            mwt_form = node.multiword_token.form
+            if node.multiword_token.misc:
+                mwt_misc.update(node.multiword_token.misc)
+            node.multiword_token.remove()
+            mwt_words[mwt_words.index(node):mwt_words.index(node)+1] = nodes
+            nodes = mwt_words
+
+        mwt = node.root.create_multiword_token(nodes, mwt_form, mwt_misc)
         self.postprocess_mwt(mwt)
 
     def multiword_analysis(self, node):

From 304977b7eaadf219d1487578f8a9aa7b7e030391 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 9 Oct 2023 18:31:26 +0200
Subject: [PATCH 0838/1374] trying to fix readthedocs.org builds

---
 docs/conf.py          | 2 +-
 docs/requirements.txt | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/conf.py b/docs/conf.py
index 45966b57..ddf6420c 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -68,7 +68,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = "en"
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 044d3af7..a537f220 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,3 +1,4 @@
 colorama>=0.4.6
 termcolor
 ufal.udpipe
+sphinx_rtd_theme

From 803ac5098903d8f8d00b7d4b3462b6cc0831208d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 9 Oct 2023 19:50:08 +0200
Subject: [PATCH 0839/1374] trying further to fix readthedocs.org builds

---
 docs/conf.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index ddf6420c..b7d0f6e5 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -51,7 +51,7 @@
 
 # General information about the project.
 project = 'Udapi'
-copyright = '2017, Martin Popel'
+copyright = '2023, Martin Popel'
 author = 'Martin Popel'
 
 # The version info for the project you're documenting, acts as replacement for
@@ -61,7 +61,7 @@
 # The short X.Y version.
 version = '0'
 # The full version, including alpha/beta/rc tags.
-release = '2'
+release = '3'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -167,7 +167,7 @@ def run_apidoc(_):
     module = os.path.abspath(os.path.join(cur_dir, "..", "udapi"))
     print(module)
 
-    from sphinx.apidoc import main
+    from sphinx.ext.apidoc import main
     main(['--separate', '-o', cur_dir, module, '--force'])
 
 def setup(app):

From bf00f646e73d3c4f97e82c15265172d440ac88a4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 11 Oct 2023 11:21:44 +0200
Subject: [PATCH 0840/1374] Cannot shift a node before the root

---
 udapi/core/node.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index 03afb6f0..0c3a85cb 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -662,6 +662,8 @@ def shift_after_node(self, reference_node, without_children=False, skip_if_desce
 
     def shift_before_node(self, reference_node, without_children=False, skip_if_descendant=False):
         """Shift this node before the reference_node."""
+        if reference_node.is_root():
+            raise ValueError(f'Cannot shift a node before the root ({reference_node})')
         if not without_children and reference_node.is_descendant_of(self):
             if skip_if_descendant:
                 return
@@ -690,6 +692,8 @@ def shift_before_subtree(self, reference_node, without_children=0, skip_if_desce
         Args:
         without_children: shift just this node without its subtree?
         """
+        if reference_node.is_root():
+            raise ValueError(f'Cannot shift a node before the root ({reference_node})')
         if not without_children and reference_node.is_descendant_of(self):
             if skip_if_descendant:
                 return

From a4a183dd59af4f81252dc23a6ebb022e1e0a8e30 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 12 Oct 2023 15:47:10 +0200
Subject: [PATCH 0841/1374] Added missing article features to Greek AddMwt.

---
 udapi/block/ud/el/addmwt.py | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/udapi/block/ud/el/addmwt.py b/udapi/block/ud/el/addmwt.py
index 8381c69f..ac753ed5 100644
--- a/udapi/block/ud/el/addmwt.py
+++ b/udapi/block/ud/el/addmwt.py
@@ -8,13 +8,13 @@
 import udapi.block.ud.addmwt
 
 MWTS = {
-    'στη':   {'form': 'σ τη', 'feats':   '_ Case=Acc|Gender=Fem|Number=Sing'},
-    'στην':  {'form': 'σ την', 'feats':  '_ Case=Acc|Gender=Fem|Number=Sing'},
-    'στα':   {'form': 'σ τα', 'feats':   '_ Case=Acc|Gender=Neut|Number=Plur'},
-    'στους': {'form': 'σ τους', 'feats': '_ Case=Acc|Gender=Masc|Number=Plur'},
-    'στις':  {'form': 'σ τις', 'feats':  '_ Case=Acc|Gender=Fem|Number=Plur'},
-    'στον':  {'form': 'σ τον', 'feats':  '_ Case=Acc|Gender=Masc|Number=Sing'},
-    'στο':   {'form': 'σ το', 'feats':   '_ Case=Acc|Gender=*|Number=Sing'},
+    'στη':   {'form': 'σ τη', 'feats':   '_ Case=Acc|Definite=Def|Gender=Fem|Number=Sing|PronType=Art'},
+    'στην':  {'form': 'σ την', 'feats':  '_ Case=Acc|Definite=Def|Gender=Fem|Number=Sing|PronType=Art'},
+    'στα':   {'form': 'σ τα', 'feats':   '_ Case=Acc|Definite=Def|Gender=Neut|Number=Plur|PronType=Art'},
+    'στους': {'form': 'σ τους', 'feats': '_ Case=Acc|Definite=Def|Gender=Masc|Number=Plur|PronType=Art'},
+    'στις':  {'form': 'σ τις', 'feats':  '_ Case=Acc|Definite=Def|Gender=Fem|Number=Plur|PronType=Art'},
+    'στον':  {'form': 'σ τον', 'feats':  '_ Case=Acc|Definite=Def|Gender=Masc|Number=Sing|PronType=Art'},
+    'στο':   {'form': 'σ το', 'feats':   '_ Case=Acc|Definite=Def|Gender=*|Number=Sing|PronType=Art'},
 }
 
 # shared values for all entries in MWTS

From e0ddbf40fa7c8246c737870bf687935c54fdf8f9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 13 Oct 2023 16:10:07 +0200
Subject: [PATCH 0842/1374] Originally mistakenly added to another branch, now
 to master.

---
 udapi/block/ud/printfixed.py | 104 +++++++++++++++++++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 udapi/block/ud/printfixed.py

diff --git a/udapi/block/ud/printfixed.py b/udapi/block/ud/printfixed.py
new file mode 100644
index 00000000..313943bb
--- /dev/null
+++ b/udapi/block/ud/printfixed.py
@@ -0,0 +1,104 @@
+"""
+Block PrintFixed prints occurrences of fixed multiword expressions in UD. It
+can be run twice in a row, first collecting known fixed expressions and then
+also reporting other occurrences of these expressions where they are not
+annotated as fixed.
+
+Usage:
+udapy ud.PrintFixed only_forms=1 < in.conllu | sort -u > fixed_expressions.txt
+udapy ud.PrintFixed known_expressions=fixed_expressions.txt < in.conllu | sort | uniq -c | less
+
+Author: Dan Zeman
+"""
+from udapi.core.block import Block
+import re
+import logging
+
+class PrintFixed(Block):
+    """
+    Print fixed multiword expressions.
+    """
+
+    def __init__(self, only_forms=False, known_expressions=None, **kwargs):
+        """
+        Create the PrintFixed block.
+
+        Parameters:
+        only_forms=1: print the word forms but not tags and other info;
+            This can be used to create the list of known forms that we want to
+            identify even if they are not annotated as fixed.
+        known_expressions: the name of the text file with the expressions
+        """
+        super().__init__(**kwargs)
+        self.only_forms = only_forms
+        self.known_expressions = {}
+        self.first_words = {}
+        self.max_length = 2
+        if known_expressions:
+            fh = open(known_expressions, 'r', encoding='utf-8')
+            n = 0
+            for expression in fh.readlines():
+                expression = expression.replace('\n', '')
+                if expression in self.known_expressions:
+                    self.known_expressions[expression] += 1
+                else:
+                    self.known_expressions[expression] = 1
+                    logging.info("Read known fixed expression '%s'" % expression)
+                    n += 1
+                words = expression.split(' ')
+                first_word = words[0]
+                self.first_words[first_word] = 1
+                length = len(words)
+                if length > self.max_length:
+                    self.max_length = length
+            logging.info('Read %d known fixed expressions.' % n)
+
+    def process_node(self, node):
+        fixed_children = [x for x in node.children if x.udeprel == 'fixed']
+        if len(fixed_children) > 0:
+            # Fixed children are always to the right of of the parent. But there
+            # may be other nodes in between that are not fixed children (for
+            # example, there may be punctuation that is attached to one of the
+            # fixed nodes).
+            n = node
+            list_of_forms = [node.form.lower()]
+            list_of_tags = [node.upos]
+            while n != fixed_children[-1]:
+                n = n.next_node
+                if n.parent == node and n.udeprel == 'fixed':
+                    list_of_forms.append(n.form.lower())
+                    list_of_tags.append(n.upos)
+                else:
+                    list_of_forms.append('X')
+                    list_of_tags.append('X')
+            forms = ' '.join(list_of_forms)
+            tags = ' '.join(list_of_tags)
+            if self.only_forms:
+                print(forms)
+            else:
+                print("%s / %s / %s" % (forms, tags, node.deprel))
+        else:
+            # If this is not the first word of a fixed expression, check whether
+            # something that looks like a known fixed expression starts here.
+            # Note that it is also possible that a known expression starts here
+            # but only a subset is actually marked as such; we currently do not
+            # account for this.
+            if node.form.lower() in self.first_words:
+                n = node
+                list_of_forms = [node.form.lower()]
+                list_of_tags = [node.upos]
+                for i in range(self.max_length - 1):
+                    n = n.next_node
+                    if not n:
+                        break
+                    ###!!! At present we cannot identify known expressions with gaps ('X').
+                    list_of_forms.append(n.form.lower())
+                    list_of_tags.append(n.upos)
+                    forms = ' '.join(list_of_forms)
+                    if forms in self.known_expressions:
+                        if self.only_forms:
+                            print(forms)
+                        else:
+                            tags = ' '.join(list_of_tags)
+                            print("%s / %s / NOT FIXED" % (forms, tags))
+                        break

From e495f6f4244cb663f1891d1d1fff6ccee38e1003 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 14 Oct 2023 02:29:39 +0200
Subject: [PATCH 0843/1374] corefud.Stats counts also the number of singletons

This number is not reported, but can be accessed from Python.
---
 udapi/block/corefud/stats.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
index cdd84e7a..5d01e3f1 100644
--- a/udapi/block/corefud/stats.py
+++ b/udapi/block/corefud/stats.py
@@ -22,6 +22,7 @@ def __init__(self, m_len_max=5, c_len_max=5, report_mentions=True, report_entiti
         self.counter = Counter()
         self.mentions = 0
         self.entities = 0
+        self.singletons = 0
         self.total_nodes = 0
         self.longest_mention = 0
         self.longest_entity = 0
@@ -32,6 +33,8 @@ def process_document(self, doc):
         self.total_nodes += len(list(doc.nodes))
         for entity in doc.coref_entities:
             len_mentions = len(entity.mentions)
+            if len_mentions == 1:
+                self.singletons += 1
             if len_mentions == 1 and self.exclude_singletons:
                 continue
             elif len_mentions > 1 and self.exclude_nonsingletons:

From c651b042cc452dff06c2d34e263c79f63967f783 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 15 Oct 2023 02:33:43 +0200
Subject: [PATCH 0844/1374] util.Normalize sent_id_prefix

---
 udapi/block/util/normalize.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/udapi/block/util/normalize.py b/udapi/block/util/normalize.py
index 48cd6dc1..9d470ceb 100644
--- a/udapi/block/util/normalize.py
+++ b/udapi/block/util/normalize.py
@@ -20,24 +20,28 @@ class Normalize(Block):
     util.Eval node='node.misc["NonExistentAttribute"] = None'
     """
 
-    def __init__(self, feats=True, misc=True, sent_id=False, start_sent_id=1, **kwargs):
+    def __init__(self, feats=True, misc=True, sent_id=False, start_sent_id=1, sent_id_prefix="", **kwargs):
         """
         Args:
         `feats`: normalize the ordering of FEATS. Default=True.
         `misc`: normalize the ordering of MISC. Default=True.
         `sent_id`: normalize sent_id so it forms a sequence of integers. Default=False.
         `start_sent_id`: the first sent_id number
+        `sent_id_prefix`: a string to be prepended before the integer sent_id. Default=empty string.
         """
         super().__init__(**kwargs)
         self.feats = feats
         self.misc = misc
         self.sent_id = sent_id
         self.next_sent_id = start_sent_id
+        self.sent_id_prefix = sent_id_prefix
+        if sent_id_prefix or start_sent_id != 1:
+            self.sent_id = True
         # TODO: normalize also the order of standardized comments like text, sent_id,...
 
     def process_bundle(self, bundle):
         if self.sent_id:
-            bundle.bundle_id = str(self.next_sent_id)
+            bundle.bundle_id = self.sent_id_prefix + str(self.next_sent_id)
             self.next_sent_id += 1
 
         for tree in bundle:

From 16fc5e5e9d58b27f32476b9c1dc204dc73612784 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 15 Oct 2023 02:34:32 +0200
Subject: [PATCH 0845/1374] root.flatten()

---
 udapi/core/root.py | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/udapi/core/root.py b/udapi/core/root.py
index eee90f7e..1fd99fc7 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -300,3 +300,17 @@ def steal_nodes(self, nodes):
                     self.create_multiword_token(words=words, form=mwt.form, misc=mwt.misc)
         self._descendants += nodes
         # pylint: enable=protected-access
+
+    def flatten(self, deprel='root'):
+        """Flatten the tree (i.e. attach all nodes to the root) and reset all deprels.
+
+        This is equivalent to
+          for node in root.descendants:
+              node.parent = root
+              node.deprel = 'root'
+        but it is faster.
+        """
+        self._children = self._descendants[:]
+        for node in self._children:
+            node._parent = self
+            node._children.clear()

From b27a213498173d09fd91081488b481fb8f33505f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 15 Oct 2023 02:36:22 +0200
Subject: [PATCH 0846/1374] udpipe.Cs online=1 #uses the Lindat web service

---
 udapi/block/udpipe/base.py |  15 +++--
 udapi/tool/udpipe.py       |   6 +-
 udapi/tool/udpipeonline.py | 116 +++++++++++++++++++++++++++++++++++++
 3 files changed, 130 insertions(+), 7 deletions(-)
 create mode 100644 udapi/tool/udpipeonline.py

diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
index 3c3d14f0..448dbb60 100644
--- a/udapi/block/udpipe/base.py
+++ b/udapi/block/udpipe/base.py
@@ -1,6 +1,7 @@
 """Block udpipe.Base for tagging and parsing using UDPipe."""
 from udapi.core.block import Block
 from udapi.tool.udpipe import UDPipe
+from udapi.tool.udpipeonline import UDPipeOnline
 from udapi.core.bundle import Bundle
 
 KNOWN_MODELS = {
@@ -118,11 +119,11 @@ class Base(Block):
     """Base class for all UDPipe blocks."""
 
     # pylint: disable=too-many-arguments
-    def __init__(self, model=None, model_alias=None,
+    def __init__(self, model=None, model_alias=None, online=False,
                  tokenize=True, tag=True, parse=True, resegment=False, **kwargs):
         """Create the udpipe.En block object."""
         super().__init__(**kwargs)
-        self.model, self.model_alias = model, model_alias
+        self.model, self.model_alias, self.online = model, model_alias, online
         self._tool = None
         self.tokenize, self.tag, self.parse, self.resegment = tokenize, tag, parse, resegment
 
@@ -134,8 +135,14 @@ def tool(self):
         if not self.model:
             if not self.model_alias:
                 raise ValueError('model (path/to/model) or model_alias (e.g. en) must be set!')
-            self.model = KNOWN_MODELS[self.model_alias]
-        self._tool = UDPipe(model=self.model)
+            if self.online:
+                self.model = self.model_alias
+            else:
+                self.model = KNOWN_MODELS[self.model_alias]
+        if self.online:
+            self._tool = UDPipeOnline(model=self.model)
+        else:
+            self._tool = UDPipe(model=self.model)
         return self._tool
 
     def process_document(self, doc):
diff --git a/udapi/tool/udpipe.py b/udapi/tool/udpipe.py
index 18f6b2ca..f96fafdf 100644
--- a/udapi/tool/udpipe.py
+++ b/udapi/tool/udpipe.py
@@ -34,10 +34,10 @@ def tag_parse_tree(self, root):
             raise IOError("UDPipe error " + self.error.message)
         self.conllu_reader.files.filehandle = io.StringIO(out_data)
         parsed_root = self.conllu_reader.read_tree()
-        nodes = [root] + descendants
+        root.flatten()
         for parsed_node in parsed_root.descendants:
-            node = nodes[parsed_node.ord]
-            node.parent = nodes[parsed_node.parent.ord]
+            node = descendants[parsed_node.ord - 1]
+            node.parent = descendants[parsed_node.parent.ord - 1] if parsed_node.parent.ord else root
             for attr in 'upos xpos lemma feats deprel'.split():
                 setattr(node, attr, getattr(parsed_node, attr))
 
diff --git a/udapi/tool/udpipeonline.py b/udapi/tool/udpipeonline.py
new file mode 100644
index 00000000..2b78a45a
--- /dev/null
+++ b/udapi/tool/udpipeonline.py
@@ -0,0 +1,116 @@
+"""Wrapper for UDPipe online web service."""
+import io
+import sys
+import email.mime.multipart
+import email.mime.nonmultipart
+import email.policy
+import json
+import os
+import sys
+import urllib.error
+import urllib.request
+
+from udapi.block.read.conllu import Conllu as ConlluReader
+from udapi.core.root import Root
+
+class UDPipeOnline:
+    """Wrapper for UDPipe online web service."""
+
+    def __init__(self, model, server="https://lindat.mff.cuni.cz/services/udpipe/api"):
+        """Create the UDPipeOnline tool object."""
+        self.model = model
+        self.server = server
+
+    def list_models(self):
+        with urllib.request.urlopen(self.server + "/models") as request:
+            response = json.loads(request.read())
+        return list(response["models"].keys())
+
+    def perform_request(self, params, method="process"):
+        if not params:
+            request_headers, request_data = {}, None
+        else:
+            message = email.mime.multipart.MIMEMultipart("form-data", policy=email.policy.HTTP)
+
+            for name, value in params.items():
+                payload = email.mime.nonmultipart.MIMENonMultipart("text", "plain")
+                payload.add_header("Content-Disposition", "form-data; name=\"{}\"".format(name))
+                payload.add_header("Content-Transfer-Encoding", "8bit")
+                payload.set_payload(value, charset="utf-8")
+                message.attach(payload)
+
+            request_data = message.as_bytes().split(b"\r\n\r\n", maxsplit=1)[1]
+            request_headers = {"Content-Type": message["Content-Type"]}
+
+        try:
+            with urllib.request.urlopen(urllib.request.Request(
+                url=f"{self.server}/{method}", headers=request_headers, data=request_data
+            )) as request:
+                response = json.loads(request.read())
+        except urllib.error.HTTPError as e:
+            print("An exception was raised during UDPipe 'process' REST request.\n"
+                "The service returned the following error:\n"
+                "  {}".format(e.fp.read().decode("utf-8")), file=sys.stderr)
+            raise
+        except json.JSONDecodeError as e:
+            print("Cannot parse the JSON response of UDPipe 'process' REST request.\n"
+                "  {}".format(e.msg), file=sys.stderr)
+            raise
+
+        if "model" not in response or "result" not in response:
+            raise ValueError("Cannot parse the UDPipe 'process' REST request response.")
+
+        return response["result"]
+
+    def tag_parse_tree(self, root):
+        """Tag (+lemmatize, fill FEATS) and parse a tree (already tokenized)."""
+        descendants = root.descendants
+        if not descendants:
+            return
+        in_data = " ".join([n.form for n in descendants])
+        out_data = self.perform_request(params={"data": in_data, "input":"horizontal", "tagger":"", "parser":""})
+        conllu_reader = ConlluReader()
+        conllu_reader.files.filehandle = io.StringIO(out_data)
+        parsed_root = conllu_reader.read_tree()
+        root.flatten()
+        for parsed_node in parsed_root.descendants:
+            node = descendants[parsed_node.ord - 1]
+            node.parent = descendants[parsed_node.parent.ord - 1] if parsed_node.parent.ord else root
+            for attr in 'upos xpos lemma feats deprel'.split():
+                setattr(node, attr, getattr(parsed_node, attr))
+
+    def tokenize_tag_parse_tree(self, root, resegment=False, tag=True, parse=True):
+        """Tokenize, tag (+lemmatize, fill FEATS) and parse the text stored in `root.text`.
+
+        If resegment=True, the returned list of Udapi trees may contain multiple trees.
+        """
+        if parse and not tag:
+            raise ValueError('Combination parse=True tag=False is not allowed.')
+        if root.children:
+            raise ValueError('Tree already contained nodes before tokenization')
+
+        # Tokenize and possibly segment the input text
+        params = {"model": self.model, "data": root.text, "tokenizer":"" if resegment else "presegmented"}
+        if tag:
+            params["tagger"] = ""
+        if parse:
+            params["parser"] = ""
+        out_data = self.perform_request(params=params)
+        conllu_reader = ConlluReader(empty_parent="ignore")
+        conllu_reader.files.filehandle = io.StringIO(out_data)
+        trees = conllu_reader.read_trees()
+
+        # The input "root" object must be the first item in "trees".
+        for attr in ('_children', '_descendants', '_mwts', 'text', 'comment'):
+            setattr(root, attr, getattr(trees[0], attr))
+        for node in root._children:
+            node._parent = root
+        for node in root._descendants:
+            node._root = root
+        trees[0] = root
+        return trees
+
+    def segment_text(self, text):
+        """Segment the provided text into sentences returned as a Python list."""
+        params = {"model": self.model, "data": text, "tokenizer":"", "output": "plaintext=normalized_spaces"}
+        return self.perform_request(params=params).rstrip().split("\n")

From aa30a546f57bcc9204d5cfd59634c6abdaea8c6d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 18 Oct 2023 10:29:10 +0200
Subject: [PATCH 0847/1374] ud.MarkBugs allows unlimited number of nsubj:outer
 children

Multiple subjects should be still marked as bugs,
but outer subjects (nsubj:outer and csubj:outer) are an exception from this rule.

The [guidelines](https://universaldependencies.org/u/dep/nsubj-outer.html)
do not give any restriction on the maximal number of [nc]subj:outer children
and it seems that we could have sentences like

  The problem is that the title is Some Like It Hot.

Fixes #117
---
 udapi/block/ud/markbugs.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index 5ca0f703..a12ea0b9 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -131,9 +131,9 @@ def process_node(self, node):
             self.log(node, 'degree-upos',
                      'Degree=%s upos!=ADJ|ADV (but %s)' % (feats['Degree'], upos))
 
-        subject_children = [n for n in node.children if 'subj' in n.udeprel]
+        subject_children = [n for n in node.children if 'subj' in n.udeprel and n.sdeprel != 'outer']
         if len(subject_children) > 1:
-            self.log(node, 'multi-subj', 'More than one [nc]subj(:pass)? child')
+            self.log(node, 'multi-subj', 'More than one (non-outer) [nc]subj child')
 
         object_children = [n for n in node.children if n.udeprel in ('obj', 'ccomp')]
         if len(object_children) > 1:

From 59f0fda5278b1d83dd32198474948d3eb1f0f16f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 18 Oct 2023 20:37:30 +0200
Subject: [PATCH 0848/1374] n1 < n2 is faster and shorter than n1.precedes(n2)

---
 udapi/block/ud/fixpunct.py | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 15d310c7..e8153342 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -148,13 +148,13 @@ def _fix_subord_punct(self, node):
         if l_cand is None or l_cand.is_root():
             l_cand, l_path = None, []
         else:
-            while (not l_cand.parent.is_root() and l_cand.parent.precedes(node)
-                   and not node.precedes(l_cand.descendants(add_self=1)[-1])):
+            while (not l_cand.parent.is_root() and l_cand.parent < node
+                   and not node < l_cand.descendants(add_self=1)[-1]):
                 l_cand = l_cand.parent
                 l_path.append(l_cand)
         if r_cand is not None:
-            while (not r_cand.parent.is_root() and node.precedes(r_cand.parent)
-                   and not r_cand.descendants(add_self=1)[0].precedes(node)):
+            while (not r_cand.parent.is_root() and node < r_cand.parent
+                   and not r_cand.descendants(add_self=1)[0] < node):
                 r_cand = r_cand.parent
                 r_path.append(r_cand)
 
@@ -226,8 +226,8 @@ def _fix_pair(self, root, opening_node, closing_node):
             if node == opening_node or node == closing_node:
                 continue
             # If this is a node inside of the pair, is its parent outside?
-            if opening_node.precedes(node) and node.precedes(closing_node):
-                if node.parent.precedes(opening_node) or closing_node.precedes(node.parent):
+            if node > opening_node and node < closing_node:
+                if node.parent < opening_node or node.parent > closing_node:
                     if node.upos == 'PUNCT':
                         punct_heads.append(node)
                     else:
@@ -237,7 +237,7 @@ def _fix_pair(self, root, opening_node, closing_node):
             # happen if an outside node is attached to an inside node. To account for
             # this, mark the inside parent as a head, too.
             else:
-                if opening_node.precedes(node.parent) and node.parent.precedes(closing_node):
+                if node.parent > opening_node and node.parent < closing_node:
                     if node.parent.upos == 'PUNCT':
                         punct_heads.append(node.parent)
                     else:

From 6de0c78bd56c6b6fdd901c5fccc95c8fd10ec087 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 19 Oct 2023 00:27:25 +0200
Subject: [PATCH 0849/1374] ud.FixPunct should not fail by creating cycles

If node.form is among the opening paired punctuation symbols
and check_paired_punct_upos==False, we consider that node
a punctuation even if its upos is not PUNCT.
Thus we should prevent any children of these nodes as well.
---
 udapi/block/ud/fixpunct.py | 28 +++++++++++++++++++---------
 1 file changed, 19 insertions(+), 9 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index e8153342..7ca5d476 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -60,14 +60,25 @@ def __init__(self, check_paired_punct_upos=False, copy_to_enhanced=False, **kwar
         self.check_paired_punct_upos = check_paired_punct_upos
         self.copy_to_enhanced = copy_to_enhanced
 
+    def _is_punct(self, node):
+        if node.upos == 'PUNCT':
+            return True
+        if self.check_paired_punct_upos:
+            return False
+        if node.form == "'":
+            return False
+        if node.form in PAIRED_PUNCT or node.form in PAIRED_PUNCT.values():
+            return True
+        return False
+
     def process_tree(self, root):
         # First, make sure no PUNCT has children.
         # This may introduce multiple subroots, which will be fixed later on
         # (preventing to temporarily create multiple subroots here would prevent fixing some errors).
         for node in root.descendants:
-            while node.parent.upos == 'PUNCT':
+            while self._is_punct(node.parent):
                 node.parent = node.parent.parent
-
+        root.draw()
         # Second, fix paired punctuations: quotes and brackets, marking them in _punct_type.
         # This should be done before handling the subordinate punctuation,
         # in order to prevent non-projectivities e.g. in dot-before-closing-quote style sentences:
@@ -77,7 +88,7 @@ def process_tree(self, root):
         self._punct_type = [None] * (1 + len(root.descendants))
         for node in root.descendants:
             if self._punct_type[node.ord] != 'closing':
-                closing_punct = PAIRED_PUNCT.get(node.form, None)
+                closing_punct = PAIRED_PUNCT.get(node.form)
                 if closing_punct is not None:
                     self._fix_paired_punct(root, node, closing_punct)
 
@@ -236,12 +247,11 @@ def _fix_pair(self, root, opening_node, closing_node):
             # they also must not cause non-projectivity of other relations. This could
             # happen if an outside node is attached to an inside node. To account for
             # this, mark the inside parent as a head, too.
-            else:
-                if node.parent > opening_node and node.parent < closing_node:
-                    if node.parent.upos == 'PUNCT':
-                        punct_heads.append(node.parent)
-                    else:
-                        heads.append(node.parent)
+            elif node.parent > opening_node and node.parent < closing_node:
+                if node.parent.upos == 'PUNCT':
+                    punct_heads.append(node.parent)
+                else:
+                    heads.append(node.parent)
 
         # Punctuation should not have children, but if there is no other head candidate,
         # let's break this rule.

From e00e7feac3045127a48850b04a3fc263420fdc7a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 19 Oct 2023 00:35:03 +0200
Subject: [PATCH 0850/1374] ud.FixPunct not all double quotation marks are
 punctuation

If the double quotation symbols in 'buy 17" or 16" wheels'
are tagged as NOUNs, we should not consider them a punctuation.
---
 udapi/block/ud/fixpunct.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 7ca5d476..898d0c9c 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -50,8 +50,9 @@ def __init__(self, check_paired_punct_upos=False, copy_to_enhanced=False, **kwar
         Args:
         check_paired_punct_upos: fix paired punctuation tokens only if their UPOS=PUNCT.
             The default is false, which means that fixed punctuation is detected only
-            based on the form with the exception of single quote / apostrophe character,
-            which is frequently ambiguous, so UPOS=PUNCT is checked always.
+            based on the form with the exception of single & double quote character,
+            which is frequently ambiguous*, so UPOS=PUNCT is checked always.
+            *) Single quote can be an apostrophe. Double quote as a NOUN can be the inch symbol.
         copy_to_enhanced: for all PUNCT nodes, let the enhanced depencies be the same
             as the basic dependencies.
         """
@@ -65,7 +66,7 @@ def _is_punct(self, node):
             return True
         if self.check_paired_punct_upos:
             return False
-        if node.form == "'":
+        if node.form in "'\"":
             return False
         if node.form in PAIRED_PUNCT or node.form in PAIRED_PUNCT.values():
             return True
@@ -78,7 +79,7 @@ def process_tree(self, root):
         for node in root.descendants:
             while self._is_punct(node.parent):
                 node.parent = node.parent.parent
-        root.draw()
+
         # Second, fix paired punctuations: quotes and brackets, marking them in _punct_type.
         # This should be done before handling the subordinate punctuation,
         # in order to prevent non-projectivities e.g. in dot-before-closing-quote style sentences:
@@ -214,7 +215,7 @@ def _causes_gap(self, node):
 
     def _fix_paired_punct(self, root, opening_node, closing_punct):
         if (self.check_paired_punct_upos
-            or opening_node.form == "'") and opening_node.upos != 'PUNCT':
+            or opening_node.form in "'\"") and opening_node.upos != 'PUNCT':
             return
         nested_level = 0
         for node in root.descendants[opening_node.ord:]:

From 7d1fdcf9188845632658e5ee81d41976840c733c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 27 Oct 2023 18:09:48 +0200
Subject: [PATCH 0851/1374] ud.FixPunct don't change root to punct in edeps

---
 udapi/block/ud/fixpunct.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 898d0c9c..1c402a70 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -53,8 +53,8 @@ def __init__(self, check_paired_punct_upos=False, copy_to_enhanced=False, **kwar
             based on the form with the exception of single & double quote character,
             which is frequently ambiguous*, so UPOS=PUNCT is checked always.
             *) Single quote can be an apostrophe. Double quote as a NOUN can be the inch symbol.
-        copy_to_enhanced: for all PUNCT nodes, let the enhanced depencies be the same
-            as the basic dependencies.
+        copy_to_enhanced: for all upos=PUNCT deprel=punct nodes, let the enhanced depencies
+            be the same as the basic dependencies.
         """
         super().__init__(**kwargs)
         self._punct_type = None
@@ -118,7 +118,7 @@ def process_tree(self, root):
         # TODO: This block changes parents not only for PUNCT nodes. These should be reflected into enhanced deps as well.
         if self.copy_to_enhanced:
             for node in root.descendants:
-                if node.upos == 'PUNCT':
+                if node.upos == 'PUNCT' and node.udeprel == 'punct':
                     node.deps = [{'parent': node.parent, 'deprel': 'punct'}]
 
     def _fix_subord_punct(self, node):

From 908f56a903f8174d8566b03ca194aec32a3a0dfc Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 28 Oct 2023 02:17:51 +0200
Subject: [PATCH 0852/1374] prevent [L2 Enhanced unconnected-egraph] validation
 errors

---
 udapi/block/ud/fixpunct.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/fixpunct.py b/udapi/block/ud/fixpunct.py
index 1c402a70..854a24a8 100644
--- a/udapi/block/ud/fixpunct.py
+++ b/udapi/block/ud/fixpunct.py
@@ -53,7 +53,7 @@ def __init__(self, check_paired_punct_upos=False, copy_to_enhanced=False, **kwar
             based on the form with the exception of single & double quote character,
             which is frequently ambiguous*, so UPOS=PUNCT is checked always.
             *) Single quote can be an apostrophe. Double quote as a NOUN can be the inch symbol.
-        copy_to_enhanced: for all upos=PUNCT deprel=punct nodes, let the enhanced depencies
+        copy_to_enhanced: for all upos=PUNCT, let the enhanced depencies
             be the same as the basic dependencies.
         """
         super().__init__(**kwargs)
@@ -111,6 +111,8 @@ def process_tree(self, root):
         # This may not hold if the original subroot was a paired punctuation, which was rehanged.
         if root.children[0].udeprel != 'root':
             root.children[0].udeprel = 'root'
+            if self.copy_to_enhanced:
+                root.children[0].deps = [{'parent': root, 'deprel': 'root'}]
             for another_node in root.children[0].descendants:
                 if another_node.udeprel == 'root':
                     another_node.udeprel = 'punct'
@@ -118,8 +120,8 @@ def process_tree(self, root):
         # TODO: This block changes parents not only for PUNCT nodes. These should be reflected into enhanced deps as well.
         if self.copy_to_enhanced:
             for node in root.descendants:
-                if node.upos == 'PUNCT' and node.udeprel == 'punct':
-                    node.deps = [{'parent': node.parent, 'deprel': 'punct'}]
+                if node.upos == 'PUNCT':
+                    node.deps = [{'parent': node.parent, 'deprel': node.deprel}]
 
     def _fix_subord_punct(self, node):
         # Dot used as the ordinal-number marker (in some languages) or abbreviation marker.

From 7f7faf1dc55fa131d0f477ae610864c8e3ba437d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 30 Oct 2023 12:34:15 +0100
Subject: [PATCH 0853/1374] bundle.nodes added in parallel to doc.nodes

---
 udapi/core/bundle.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/udapi/core/bundle.py b/udapi/core/bundle.py
index 23cc6104..83877495 100644
--- a/udapi/core/bundle.py
+++ b/udapi/core/bundle.py
@@ -116,3 +116,12 @@ def address(self):
     def draw(self, **kwargs):
         """Pretty print the trees using TextModeTrees."""
         TextModeTrees(**kwargs).process_bundle(self)
+
+    @property
+    def nodes(self):
+        """An iterator over all nodes (excluding empty nodes) in all trees in this bundle."""
+        for tree in self:
+            # tree.descendants is slightly slower than tree._descendants,
+            # but it seems safer, see the comment in udapi.core.block.Block.process.process_tree().
+            for node in tree.descendants:
+                yield node

From 732a885fd7534e1e4c0bd1f705d8f5c390d1d68e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 30 Oct 2023 12:34:50 +0100
Subject: [PATCH 0854/1374] util.MarkDiff mark_attr=AnyOtherNameThanMark

---
 udapi/block/util/markdiff.py | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/udapi/block/util/markdiff.py b/udapi/block/util/markdiff.py
index 6c57ab36..50083f1b 100644
--- a/udapi/block/util/markdiff.py
+++ b/udapi/block/util/markdiff.py
@@ -9,7 +9,7 @@ class MarkDiff(Block):
     """Mark differences between parallel trees."""
 
     def __init__(self, gold_zone, attributes='form,lemma,upos,xpos,deprel,feats,misc',
-                 mark=1, add=False, print_stats=0, ignore_parent=False, **kwargs):
+                 mark=1, mark_attr="Mark", add=False, print_stats=0, ignore_parent=False, **kwargs):
         """Create the Mark block object.
         Params:
         gold_zone: Which of the zones should be treated as gold?
@@ -26,6 +26,7 @@ def __init__(self, gold_zone, attributes='form,lemma,upos,xpos,deprel,feats,misc
         self.gold_zone = gold_zone
         self.attrs = attributes.split(',')
         self.mark = mark
+        self.mark_attr = mark_attr
         self.add = add
         self.print_stats = print_stats
         self.ignore_parent = ignore_parent
@@ -37,15 +38,15 @@ def process_tree(self, tree):
             return
         if not self.add:
             for node in tree.descendants + gold_tree.descendants:
-                del node.misc['Mark']
+                del node.misc[self.mark_attr]
                 del node.misc['ToDo']
                 del node.misc['Bug']
 
         pred_nodes, gold_nodes = tree.descendants, gold_tree.descendants
         # Make sure both pred and gold trees are marked, even if one has just deleted nodes.
         if len(pred_nodes) != len(gold_nodes):
-            tree.add_comment('Mark = %s' % self.mark)
-            gold_tree.add_comment('Mark = %s' % self.mark)
+            tree.add_comment(f'{self.mark_attr} = {self.mark}')
+            gold_tree.add_comment(f'{self.mark_attr} = {self.mark}')
         pred_tokens = ['_'.join(n.get_attrs(self.attrs)) for n in pred_nodes]
         gold_tokens = ['_'.join(n.get_attrs(self.attrs)) for n in gold_nodes]
         matcher = difflib.SequenceMatcher(None, pred_tokens, gold_tokens, autojunk=False)
@@ -63,12 +64,12 @@ def process_tree(self, tree):
             if edit == 'equal':
                 for p_node, g_node in zip(pred_nodes[pred_lo:pred_hi], gold_nodes[gold_lo:gold_hi]):
                     if not self.ignore_parent and alignment.get(p_node.parent.ord - 1) != g_node.parent.ord - 1:
-                        p_node.misc['Mark'] = self.mark
-                        g_node.misc['Mark'] = self.mark
+                        p_node.misc[self.mark_attr] = self.mark
+                        g_node.misc[self.mark_attr] = self.mark
                         self.stats['ONLY-PARENT-CHANGED'] += 1
             else:
                 for node in pred_nodes[pred_lo:pred_hi] + gold_nodes[gold_lo:gold_hi]:
-                    node.misc['Mark'] = self.mark
+                    node.misc[self.mark_attr] = self.mark
                 if self.print_stats:
                     if edit == 'replace':
                         # first n nodes are treated as aligned, the rest is treated as ADDED/DELETED

From caf8fb9a734df05185f1f8960d54b8a2aef58e40 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 1 Nov 2023 15:05:38 +0100
Subject: [PATCH 0855/1374] util.Mark mark_attr

---
 udapi/block/util/mark.py     | 16 +++++++++++++---
 udapi/block/util/markdiff.py |  1 +
 2 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/udapi/block/util/mark.py b/udapi/block/util/mark.py
index c57f7443..5ab50d2f 100644
--- a/udapi/block/util/mark.py
+++ b/udapi/block/util/mark.py
@@ -15,7 +15,7 @@ class Mark(Block):
     udapy -TM util.Mark node='node.is_nonprojective()' < in | less -R
     """
 
-    def __init__(self, node, mark=1, add=True, **kwargs):
+    def __init__(self, node, mark=1, mark_attr="Mark", add=True, print_stats=False, **kwargs):
         """Create the Mark block object.
 
         Args:
@@ -24,17 +24,27 @@ def __init__(self, node, mark=1, add=True, **kwargs):
 
         `mark`: the node will be marked with `Mark=<mark>` in `node.misc`. Default=1.
 
+        `mark_attr`: use this MISC attribute name instead of "Mark".
+
         `add`: should we keep existing Mark|ToDo|Bug? Default=True.
         """
         super().__init__(**kwargs)
         self.mark = mark
+        self.mark_attr = mark_attr
         self.node = node
         self.add = add
+        self.print_stats = print_stats
+        self._marked = 0
 
     def process_node(self, node):
         if eval(self.node):
-            node.misc['Mark'] = self.mark
+            node.misc[self.mark_attr] = self.mark
+            self._marked += 1
         elif not self.add:
-            del node.misc['Mark']
+            del node.misc[self.mark_attr]
             del node.misc['ToDo']
             del node.misc['Bug']
+
+    def process_end(self):
+        if self.print_stats:
+            print(f'util.Mark marked {self._marked} nodes')
diff --git a/udapi/block/util/markdiff.py b/udapi/block/util/markdiff.py
index 50083f1b..60bac5c7 100644
--- a/udapi/block/util/markdiff.py
+++ b/udapi/block/util/markdiff.py
@@ -17,6 +17,7 @@ def __init__(self, gold_zone, attributes='form,lemma,upos,xpos,deprel,feats,misc
         attributes: Which node attributes should be considered when searching for diffs?
             The tree topology, i.e. node parent is always considered.
         mark: What value should be used in `node.misc['Mark']` of the differing nodes?
+        mark_attr: use this MISC attribute name instead of "Mark".
         add: If False, node.misc attributes Mark, ToDo and Bug will be deleted before running this block,
             so that the marked_only option (e.g. via `udapy -TM`) prints only nodes marked by this block.
         print_stats: How many lines of statistics should be printed? -1 means all.

From 39fe8ad9971c952c5dddeec6c5b4d0625735182b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 1 Nov 2023 17:05:52 +0100
Subject: [PATCH 0856/1374] typo in comments

---
 udapi/core/bundle.py   | 2 +-
 udapi/core/document.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/core/bundle.py b/udapi/core/bundle.py
index 83877495..0a637f01 100644
--- a/udapi/core/bundle.py
+++ b/udapi/core/bundle.py
@@ -122,6 +122,6 @@ def nodes(self):
         """An iterator over all nodes (excluding empty nodes) in all trees in this bundle."""
         for tree in self:
             # tree.descendants is slightly slower than tree._descendants,
-            # but it seems safer, see the comment in udapi.core.block.Block.process.process_tree().
+            # but it seems safer, see the comment in udapi.core.block.Block.process_tree().
             for node in tree.descendants:
                 yield node
diff --git a/udapi/core/document.py b/udapi/core/document.py
index 65ef5a75..8507d2f1 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -96,7 +96,7 @@ def nodes(self):
         for bundle in self:
             for tree in bundle:
                 # tree.descendants is slightly slower than tree._descendants,
-                # but it seems safer, see the comment in udapi.core.block.Block.process.process_tree().
+                # but it seems safer, see the comment in udapi.core.block.Block.process_tree().
                 for node in tree.descendants:
                     yield node
 

From be3068b76abf2b26cc4dc0d938d7dd80286d8f0d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 1 Nov 2023 19:00:54 +0100
Subject: [PATCH 0857/1374] util.MarkDiff align=both

---
 udapi/block/util/markdiff.py | 32 ++++++++++++++++++++++++++------
 1 file changed, 26 insertions(+), 6 deletions(-)

diff --git a/udapi/block/util/markdiff.py b/udapi/block/util/markdiff.py
index 60bac5c7..f5f7b17d 100644
--- a/udapi/block/util/markdiff.py
+++ b/udapi/block/util/markdiff.py
@@ -9,7 +9,8 @@ class MarkDiff(Block):
     """Mark differences between parallel trees."""
 
     def __init__(self, gold_zone, attributes='form,lemma,upos,xpos,deprel,feats,misc',
-                 mark=1, mark_attr="Mark", add=False, print_stats=0, ignore_parent=False, **kwargs):
+                 mark=1, mark_attr='Mark', add=False, print_stats=0, ignore_parent=False,
+                 align=False, align_attr='Align', **kwargs):
         """Create the Mark block object.
         Params:
         gold_zone: Which of the zones should be treated as gold?
@@ -18,10 +19,19 @@ def __init__(self, gold_zone, attributes='form,lemma,upos,xpos,deprel,feats,misc
             The tree topology, i.e. node parent is always considered.
         mark: What value should be used in `node.misc['Mark']` of the differing nodes?
         mark_attr: use this MISC attribute name instead of "Mark".
+            Use mark_attr=0 to prevent marking diffs in MISC.
         add: If False, node.misc attributes Mark, ToDo and Bug will be deleted before running this block,
             so that the marked_only option (e.g. via `udapy -TM`) prints only nodes marked by this block.
         print_stats: How many lines of statistics should be printed? -1 means all.
         ignore_parent: ignore differences in dependency parents
+        align: store word alignment, possible values are False (no alignment stored, the default)
+            "from-pred", i.e. pred_node.misc["Align"] = aligned_gold_node.ord,
+            "from-gold", i.e. gold_node.misc["Align"] = aligned_pred_node.ord and
+            "both", i.e. both from-pred and from-gold.
+            If only forms should be considered for inducing the word alignment,
+            you should use "util.MarkDiff attributes='form' ignore_parent=1 align=1".
+            Only one-to-one alignment is supported.
+        align_attr: use this MISC attribute name instead of "Align".
         """
         super().__init__(**kwargs)
         self.gold_zone = gold_zone
@@ -31,7 +41,11 @@ def __init__(self, gold_zone, attributes='form,lemma,upos,xpos,deprel,feats,misc
         self.add = add
         self.print_stats = print_stats
         self.ignore_parent = ignore_parent
+        self.align = align
+        self.align_attr = align_attr
         self.stats = collections.Counter()
+        if not mark_attr and not align and not print_stats:
+            raise ValueError('mark_attr=0 does not make sense without align or print_stats')
 
     def process_tree(self, tree):
         gold_tree = tree.bundle.get_tree(self.gold_zone)
@@ -45,7 +59,7 @@ def process_tree(self, tree):
 
         pred_nodes, gold_nodes = tree.descendants, gold_tree.descendants
         # Make sure both pred and gold trees are marked, even if one has just deleted nodes.
-        if len(pred_nodes) != len(gold_nodes):
+        if len(pred_nodes) != len(gold_nodes) and self.mark_attr:
             tree.add_comment(f'{self.mark_attr} = {self.mark}')
             gold_tree.add_comment(f'{self.mark_attr} = {self.mark}')
         pred_tokens = ['_'.join(n.get_attrs(self.attrs)) for n in pred_nodes]
@@ -59,18 +73,24 @@ def process_tree(self, tree):
             if edit in {'equal', 'replace'}:
                 for i in range(pred_lo, pred_hi):
                     alignment[i] = i - pred_lo + gold_lo
+                    if self.align in ("both", "from-pred"):
+                        pred_nodes[i].misc[self.align_attr] = i - pred_lo + gold_lo + 1
+                    if self.align in ("both", "from-gold"):
+                        gold_nodes[i - pred_lo + gold_lo].misc[self.align_attr] = i + 1
 
         for diff in diffs:
             edit, pred_lo, pred_hi, gold_lo, gold_hi = diff
             if edit == 'equal':
                 for p_node, g_node in zip(pred_nodes[pred_lo:pred_hi], gold_nodes[gold_lo:gold_hi]):
                     if not self.ignore_parent and alignment.get(p_node.parent.ord - 1) != g_node.parent.ord - 1:
-                        p_node.misc[self.mark_attr] = self.mark
-                        g_node.misc[self.mark_attr] = self.mark
                         self.stats['ONLY-PARENT-CHANGED'] += 1
+                        if self.mark_attr:
+                            p_node.misc[self.mark_attr] = self.mark
+                            g_node.misc[self.mark_attr] = self.mark
             else:
-                for node in pred_nodes[pred_lo:pred_hi] + gold_nodes[gold_lo:gold_hi]:
-                    node.misc[self.mark_attr] = self.mark
+                if self.mark_attr:
+                    for node in pred_nodes[pred_lo:pred_hi] + gold_nodes[gold_lo:gold_hi]:
+                        node.misc[self.mark_attr] = self.mark
                 if self.print_stats:
                     if edit == 'replace':
                         # first n nodes are treated as aligned, the rest is treated as ADDED/DELETED

From 28dbce9a9ee7de8a25c6714cebf01a5c2c4a383c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 2 Nov 2023 04:15:03 +0100
Subject: [PATCH 0858/1374] read.Text

---
 udapi/block/read/text.py | 57 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 udapi/block/read/text.py

diff --git a/udapi/block/read/text.py b/udapi/block/read/text.py
new file mode 100644
index 00000000..0213bdcb
--- /dev/null
+++ b/udapi/block/read/text.py
@@ -0,0 +1,57 @@
+"""Text class is a reader for word-wrapped plain-text files."""
+from udapi.core.basereader import BaseReader
+from udapi.core.root import Root
+
+
+class Text(BaseReader):
+    r"""A reader for plain-text files with sentences on one or more lines.
+    
+    Sentences are separated by one or more empty lines.
+    Newlines within sentences are substituted by a space.
+
+    Args:
+    rstrip: a set of characters to be stripped from the end of each line.
+        Default='\r\n '. You can use rstrip='\n' if you want to preserve
+        any space or '\r' (Carriage Return) at end of line,
+        so that `udpipe.Base` keeps these characters in `SpacesAfter`.
+        As most blocks do not expect whitespace other than a space to appear
+        in the processed text, using this feature is at your own risk.
+    """
+    def __init__(self, rstrip='\r\n ', **kwargs):
+        self.rstrip = rstrip
+        super().__init__(**kwargs)
+
+    @staticmethod
+    def is_multizone_reader():
+        """Can this reader read bundles which contain more zones?.
+
+        This implementation returns always False.
+        """
+        return False
+
+    def read_tree(self, document=None):
+        if self.filehandle is None:
+            return None
+        lines = []
+        line = None
+        while True:
+            line = self.filehandle.readline()
+            # if readline() returns an empty string, the end of the file has been
+            # reached, while a blank line is represented by '\n'
+            # (or '\r\n' if reading a Windows file on Unix machine).
+            if line == '':
+                if not lines:
+                    return None
+                else:
+                    break
+            elif line in {'\n', '\r\n'}:
+                if not lines:
+                    continue
+                else:
+                    break
+            else:
+                lines.append(line.rstrip(self.rstrip))
+
+        root = Root()
+        root.text = " ".join(lines)
+        return root

From 4e875c57fdcbd0fe6a59ef658b181569b1d79727 Mon Sep 17 00:00:00 2001
From: fjambe <81561988+fjambe@users.noreply.github.com>
Date: Tue, 14 Nov 2023 15:10:50 +0100
Subject: [PATCH 0859/1374] upload addmwt.py

---
 udapi/block/ud/la/addmwt.py | 58 +++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 udapi/block/ud/la/addmwt.py

diff --git a/udapi/block/ud/la/addmwt.py b/udapi/block/ud/la/addmwt.py
new file mode 100644
index 00000000..d874c004
--- /dev/null
+++ b/udapi/block/ud/la/addmwt.py
@@ -0,0 +1,58 @@
+""" Block ud.la.AddMwt for heuristic detection of multi-word (PRON + cum, nonne) and abbreviations-dots tokens. """
+import udapi.block.ud.addmwt
+
+MWTS = {
+    'mecum':   {'lemma': 'ego cum', 'form': 'me cum', 'feats': 'Case=Abl|Gender=Masc|Number=Sing AdpType=Post|Clitic=Yes'},
+    'tecum':  {'lemma': 'tu cum', 'form': 'te cum', 'feats': 'Case=Abl|Gender=Masc|Number=Sing AdpType=Post|Clitic=Yes'},
+    'nobiscum':   {'lemma': 'nos cum', 'form': 'nobis cum', 'feats': 'Case=Abl|Gender=Neut|Number=Plur AdpType=Post|Clitic=Yes'},
+    'vobiscum': {'lemma': 'vos cum', 'form': 'vobis cum', 'feats': 'Case=Abl|Gender=Masc|Number=Plur AdpType=Post|Clitic=Yes'},
+    'uobiscum': {'lemma': 'uos cum', 'form': 'uobis cum', 'feats': 'Case=Abl|Gender=Masc|Number=Plur AdpType=Post|Clitic=Yes'},
+    'secum': {'lemma': 'sui cum', 'form': 'se cum', 'feats': 'Case=Abl|Gender=Masc AdpType=Post|Clitic=Yes'}, # can be singular or plural
+}
+
+# shared values for all entries in MWTS
+for v in MWTS.values():
+    v['upos'] = 'PRON ADP'
+    # v['xpos'] = '' # treebank-specific
+    v['deprel'] = 'obl case'
+    v['main'] = 0
+    v['shape'] = 'subtree'
+	   
+
+class AddMwt(udapi.block.ud.addmwt.AddMwt):
+    """Detect and mark MWTs (split them into words and add the words to the tree)."""
+
+    def multiword_analysis(self, node):
+        """Return a dict with MWT info or None if `node` does not represent a multiword token."""
+        analysis = MWTS.get(node.form.lower(), None)
+        if analysis is not None:
+            return analysis
+            
+        if node.form.endswith('.') and len(node.form) > 1 and node.form != '...':
+            dic = {
+                'form': 'x .',
+                'lemma': '* .',
+                'upos': '* PUNCT',
+                'xpos': '_ _',
+                'feats': '* _',
+                'deprel': '* punct',
+                'main': 0,
+                'shape': 'subtree'
+            }
+            forma = node.form[:-1] + ' .'
+            dic.update(form = forma)
+            return dic
+        elif node.lemma == 'nonne':
+        	dic = {
+        	'form': 'non ne',
+                'lemma': 'non ne',
+                'upos': 'PART PART',
+                # 'xpos': '_ _', # treebank-specific
+                'feats': 'Polarity=Neg Clitic=Yes|PartType=Int',
+                'deprel': 'advmod:neg discourse',
+                'main': 0,
+                'shape': 'sibling'
+        	}
+        	return dic
+        return None
+

From 6fe35b1db6f9aa17226934542cb9c33849291572 Mon Sep 17 00:00:00 2001
From: fjambe <81561988+fjambe@users.noreply.github.com>
Date: Tue, 14 Nov 2023 17:19:46 +0100
Subject: [PATCH 0860/1374] Improvement of addmwt.py

---
 udapi/block/ud/la/addmwt.py | 41 +++++++++++--------------------------
 1 file changed, 12 insertions(+), 29 deletions(-)

diff --git a/udapi/block/ud/la/addmwt.py b/udapi/block/ud/la/addmwt.py
index d874c004..27831151 100644
--- a/udapi/block/ud/la/addmwt.py
+++ b/udapi/block/ud/la/addmwt.py
@@ -2,21 +2,21 @@
 import udapi.block.ud.addmwt
 
 MWTS = {
-    'mecum':   {'lemma': 'ego cum', 'form': 'me cum', 'feats': 'Case=Abl|Gender=Masc|Number=Sing AdpType=Post|Clitic=Yes'},
-    'tecum':  {'lemma': 'tu cum', 'form': 'te cum', 'feats': 'Case=Abl|Gender=Masc|Number=Sing AdpType=Post|Clitic=Yes'},
-    'nobiscum':   {'lemma': 'nos cum', 'form': 'nobis cum', 'feats': 'Case=Abl|Gender=Neut|Number=Plur AdpType=Post|Clitic=Yes'},
-    'vobiscum': {'lemma': 'vos cum', 'form': 'vobis cum', 'feats': 'Case=Abl|Gender=Masc|Number=Plur AdpType=Post|Clitic=Yes'},
-    'uobiscum': {'lemma': 'uos cum', 'form': 'uobis cum', 'feats': 'Case=Abl|Gender=Masc|Number=Plur AdpType=Post|Clitic=Yes'},
-    'secum': {'lemma': 'sui cum', 'form': 'se cum', 'feats': 'Case=Abl|Gender=Masc AdpType=Post|Clitic=Yes'}, # can be singular or plural
+    'mecum':   {'lemma': 'ego cum', 'form': 'me cum', 'upos': 'PRON ADP', 'feats': 'Case=Abl|Gender=Masc|Number=Sing AdpType=Post|Clitic=Yes', 'deprel': 'obl case'},
+    'tecum':  {'lemma': 'tu cum', 'form': 'te cum', 'upos': 'PRON ADP', 'feats': 'Case=Abl|Gender=Masc|Number=Sing AdpType=Post|Clitic=Yes', 'deprel': 'obl case'},
+    'nobiscum':   {'lemma': 'nos cum', 'form': 'nobis cum', 'upos': 'PRON ADP', 'feats': 'Case=Abl|Gender=Neut|Number=Plur AdpType=Post|Clitic=Yes', 'deprel': 'obl case'},
+    'vobiscum': {'lemma': 'vos cum', 'form': 'vobis cum', 'upos': 'PRON ADP', 'feats': 'Case=Abl|Gender=Masc|Number=Plur AdpType=Post|Clitic=Yes', 'deprel': 'obl case'},
+    'uobiscum': {'lemma': 'uos cum', 'form': 'uobis cum', 'upos': 'PRON ADP', 'feats': 'Case=Abl|Gender=Masc|Number=Plur AdpType=Post|Clitic=Yes', 'deprel': 'obl case'},
+    'secum': {'lemma': 'sui cum', 'form': 'se cum', 'upos': 'PRON ADP', 'feats': 'Case=Abl|Gender=Masc AdpType=Post|Clitic=Yes', 'deprel': 'obl case'}, # can be singular or plural
+    'nonne': {'lemma': 'non ne', 'form': 'non ne', 'upos': 'PART PART', 'feats': 'Polarity=Neg Clitic=Yes|PartType=Int', 'deprel': 'advmod:neg discourse', 'shape': 'sibling'}
 }
 
 # shared values for all entries in MWTS
 for v in MWTS.values():
-    v['upos'] = 'PRON ADP'
     # v['xpos'] = '' # treebank-specific
-    v['deprel'] = 'obl case'
+    if 'shape' not in v:
+        v['shape'] = 'subtree'
     v['main'] = 0
-    v['shape'] = 'subtree'
 	   
 
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
@@ -29,30 +29,13 @@ def multiword_analysis(self, node):
             return analysis
             
         if node.form.endswith('.') and len(node.form) > 1 and node.form != '...':
-            dic = {
-                'form': 'x .',
+	    # currently under discussion
+            return {'form': node.form[:-1] + ' .',
                 'lemma': '* .',
                 'upos': '* PUNCT',
                 'xpos': '_ _',
                 'feats': '* _',
                 'deprel': '* punct',
                 'main': 0,
-                'shape': 'subtree'
-            }
-            forma = node.form[:-1] + ' .'
-            dic.update(form = forma)
-            return dic
-        elif node.lemma == 'nonne':
-        	dic = {
-        	'form': 'non ne',
-                'lemma': 'non ne',
-                'upos': 'PART PART',
-                # 'xpos': '_ _', # treebank-specific
-                'feats': 'Polarity=Neg Clitic=Yes|PartType=Int',
-                'deprel': 'advmod:neg discourse',
-                'main': 0,
-                'shape': 'sibling'
-        	}
-        	return dic
-        return None
+                'shape': 'subtree'}
 

From cd77a939b37327671aaec68333c3b683969e0840 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 21 Nov 2023 09:44:39 +0100
Subject: [PATCH 0861/1374] write.Sentences newdoc=1 newpar=1

---
 udapi/block/write/sentences.py | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/udapi/block/write/sentences.py b/udapi/block/write/sentences.py
index 60eb6bec..70553d7d 100644
--- a/udapi/block/write/sentences.py
+++ b/udapi/block/write/sentences.py
@@ -3,13 +3,14 @@
 
 
 class Sentences(BaseWriter):
-    """A writer of plain-text sentences (one per line).
+    """A writer of plain-text sentences (one sentence per line).
 
     Usage:
     udapy write.Sentences if_missing=empty < my.conllu > my.txt
+    udapy write.Sentences newdoc=1 newpar=1 < my.conllu > my.txt
     """
 
-    def __init__(self, if_missing='detokenize', **kwargs):
+    def __init__(self, if_missing='detokenize', newdoc=None, newpar=None, **kwargs):
         """Create the Sentences writer block.
 
         Parameters:
@@ -18,9 +19,21 @@ def __init__(self, if_missing='detokenize', **kwargs):
          * `empty`: print an empty line
          * `warn_detokenize`, `warn_empty`: in addition emit a warning via `logging.warning()`
          * `fatal`: raise an exception
+        newdoc: What to do if `root.newdoc` is not None? (default=None)
+         * None: ignore it
+         * True: print an empty_line (except for the first tree, i.e. bundle.number==1)
+        newpar: What to do if `root.newpar` is not None? (default=None)
+         * None: ignore it
+         * True: print an empty_line (except for the first tree, i.e. bundle.number==1)
         """
         super().__init__(**kwargs)
         self.if_missing = if_missing
+        self.newdoc = newdoc
+        self.newpar = newpar
 
     def process_tree(self, tree):
+        if self.newdoc and tree.newdoc and tree.bundle.number > 1:
+            print()
+        if self.newpar and tree.newpar and tree.bundle.number > 1:
+            print()
         print(tree.get_sentence(self.if_missing))

From a5a42f64ad0f635300366e8790efc8d6942c8810 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 22 Nov 2023 15:20:01 +0100
Subject: [PATCH 0862/1374] util.MarkDiff: joining None results in an error

---
 udapi/block/util/markdiff.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/util/markdiff.py b/udapi/block/util/markdiff.py
index f5f7b17d..e102ca9c 100644
--- a/udapi/block/util/markdiff.py
+++ b/udapi/block/util/markdiff.py
@@ -62,8 +62,8 @@ def process_tree(self, tree):
         if len(pred_nodes) != len(gold_nodes) and self.mark_attr:
             tree.add_comment(f'{self.mark_attr} = {self.mark}')
             gold_tree.add_comment(f'{self.mark_attr} = {self.mark}')
-        pred_tokens = ['_'.join(n.get_attrs(self.attrs)) for n in pred_nodes]
-        gold_tokens = ['_'.join(n.get_attrs(self.attrs)) for n in gold_nodes]
+        pred_tokens = ['_'.join(n.get_attrs(self.attrs, undefs="_")) for n in pred_nodes]
+        gold_tokens = ['_'.join(n.get_attrs(self.attrs, undefs="_")) for n in gold_nodes]
         matcher = difflib.SequenceMatcher(None, pred_tokens, gold_tokens, autojunk=False)
         diffs = list(matcher.get_opcodes())
 

From ac7562984291d0af72f8d9fba6e8e6ffae4d5d95 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 11 Jan 2024 17:11:11 +0100
Subject: [PATCH 0863/1374] ud.FixCompoundName: If a treebank connects person
 names using compound, convert it to flat:name.

---
 udapi/block/ud/fixcompoundname.py | 36 +++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 udapi/block/ud/fixcompoundname.py

diff --git a/udapi/block/ud/fixcompoundname.py b/udapi/block/ud/fixcompoundname.py
new file mode 100644
index 00000000..43eb6578
--- /dev/null
+++ b/udapi/block/ud/fixcompoundname.py
@@ -0,0 +1,36 @@
+"""
+Block ud.FixCompoundName finds compound relations between PROPN nodes and converts
+them to flat:name. This is not necessarily correct in all situations. The difference
+between compound and flat is that compound allows to distinguish head and modifier.
+Multiword person names (given name and surname, or various other patterns) typically
+should be analyzed as flat but there are treebanks that incorrectly use compound
+for person names. This block can be used to fix them.
+"""
+from udapi.core.block import Block
+import logging
+
+
+class FixCompoundName(Block):
+    """
+    Converts a compound relation between two PROPN nodes into a flat relation.
+    Compounds of a PROPN and a non-PROPN will be left alone, although they are
+    suspicious, too.
+    """
+
+    def process_node(self, node):
+        if node.upos == 'PROPN' and node.udeprel == 'compound' and node.parent.upos == 'PROPN':
+            # See if there are other PROPN compound siblings.
+            namewords = [x for x in node.siblings if x.upos == 'PROPN' and x.udeprel == 'compound']
+            namewords.append(node.parent)
+            namewords = sorted(namewords, key=lambda x: x.ord)
+            ###!!! We currently cannot transform enhanced dependencies.
+            ###!!! If we proceed, the basic tree would diverge from the enhanced dependencies.
+            if len(node.deps) > 0:
+                logging.fatal('There are enhanced dependencies but ud.FixCompoundName has been implemented only for basic dependencies.')
+            # The first name word will be the technical head. If it is the current parent, fine.
+            if namewords[0] != node.parent:
+                namewords[0].parent = node.parent.parent
+                namewords[0].deprel = node.parent.deprel
+            for i in range(len(namewords)-1):
+                namewords[i+1].parent = namewords[0]
+                namewords[i+1].deprel = 'flat:name'

From 02698410b6c7c5a17b092afbbc0044ab1a0b5515 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 11 Jan 2024 18:11:33 +0100
Subject: [PATCH 0864/1374] Improved block ud.FixCompoundName.

---
 udapi/block/ud/fixcompoundname.py | 37 +++++++++++++++++++------------
 1 file changed, 23 insertions(+), 14 deletions(-)

diff --git a/udapi/block/ud/fixcompoundname.py b/udapi/block/ud/fixcompoundname.py
index 43eb6578..74610757 100644
--- a/udapi/block/ud/fixcompoundname.py
+++ b/udapi/block/ud/fixcompoundname.py
@@ -7,6 +7,7 @@
 for person names. This block can be used to fix them.
 """
 from udapi.core.block import Block
+import regex as re
 import logging
 
 
@@ -19,18 +20,26 @@ class FixCompoundName(Block):
 
     def process_node(self, node):
         if node.upos == 'PROPN' and node.udeprel == 'compound' and node.parent.upos == 'PROPN':
+            origparent = node.parent
+            grandparent = origparent.parent
+            outdeprel = origparent.deprel
             # See if there are other PROPN compound siblings.
-            namewords = [x for x in node.siblings if x.upos == 'PROPN' and x.udeprel == 'compound']
-            namewords.append(node.parent)
-            namewords = sorted(namewords, key=lambda x: x.ord)
-            ###!!! We currently cannot transform enhanced dependencies.
-            ###!!! If we proceed, the basic tree would diverge from the enhanced dependencies.
-            if len(node.deps) > 0:
-                logging.fatal('There are enhanced dependencies but ud.FixCompoundName has been implemented only for basic dependencies.')
-            # The first name word will be the technical head. If it is the current parent, fine.
-            if namewords[0] != node.parent:
-                namewords[0].parent = node.parent.parent
-                namewords[0].deprel = node.parent.deprel
-            for i in range(len(namewords)-1):
-                namewords[i+1].parent = namewords[0]
-                namewords[i+1].deprel = 'flat:name'
+            namewords = sorted([x for x in origparent.children(add_self=True) if x.upos == 'PROPN' and (x.udeprel == 'compound' or x == origparent)], key=lambda y: y.ord)
+            # The Hindi treebank tags dates (['30', 'navaṁbara'], ['disaṁbara', '1993']) as PROPN compounds.
+            # This is wrong but it is also different from personal names we are targeting here.
+            # Hence, we will skip "names" that contain numbers.
+            if len([x for x in namewords if re.search(r"\d", x.form)]) == 0:
+                #logging.info(str([x.misc['Translit'] for x in namewords]))
+                ###!!! We currently cannot transform enhanced dependencies.
+                ###!!! If we proceed, the basic tree would diverge from the enhanced dependencies.
+                if len(node.deps) > 0:
+                    logging.fatal('There are enhanced dependencies but ud.FixCompoundName has been implemented only for basic dependencies.')
+                # The first name word will be the technical head. If it is the current parent, fine.
+                head = namewords[0]
+                rest = namewords[1:]
+                if head != origparent:
+                    head.parent = grandparent
+                    head.deprel = outdeprel
+                for n in rest:
+                    n.parent = head
+                    n.deprel = 'flat:name'

From a5f5d90603669cb9bee389b96d93e1bf85935d70 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 31 Jan 2024 17:16:28 +0100
Subject: [PATCH 0865/1374] WIP: corefud.Link2Cluster for converting link-based
 coreference annotation to CorefUD

---
 udapi/block/corefud/link2cluster.py | 37 +++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 udapi/block/corefud/link2cluster.py

diff --git a/udapi/block/corefud/link2cluster.py b/udapi/block/corefud/link2cluster.py
new file mode 100644
index 00000000..4e296507
--- /dev/null
+++ b/udapi/block/corefud/link2cluster.py
@@ -0,0 +1,37 @@
+from udapi.core.block import Block
+
+class Link2Cluster(Block):
+    """Block corefud.Link2Cluster converts link-based coreference annotation to the (cluster-based) CorefUD format."""
+
+    def __init__(self, id_attr='external-id', ante_attr='antecedent-id', **kwargs):
+        super().__init__(**kwargs)
+        self.id_attr = id_attr
+        self.ante_id = ante_attr
+
+    def process_document(self, doc):
+        id2node = {}
+        links = []
+        for node in doc.nodes:
+            this_id = node.misc[self.id_attr]
+            if this_id != '':
+                id2node[this_id] = node
+                ante_id = node.misc[self.ante_attr]
+                if ante_id != '':
+                    links.append([ante_id, this_id])
+
+        # sorted(...,reverse=True) converts both cataphora and anaphora to a pair (this, ante) where ante < this.
+        node_links = [sorted([id2node[link[0]], id2node[link[1]]], reverse=True) for link in links]
+        
+        # sort() makes sure the links are sorted by the "this" node (i.e. the anaphor, not the antecendent).
+        node_links.sort()
+        
+        # Thanks to this sorting, we can assert that this_node is not part of any mention/entity when iterating
+        # and we can prevent the need for merging two entities.
+        for this_node, ante_node in node_links:
+            assert not this_node.mentions
+            if ante_node.mentions:
+                ante_node.entities[0].create_mention(head=this_node, words=[this_node])
+            else:
+                entity = this_node.root.document.create_coref_entity()
+                entity.create_mention(head=ante_node, words=[ante_node])
+                entity.create_mention(head=this_node, words=[this_node])

From 3f9dd8417c7bf6dc387ef7abdde9443527971c70 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 1 Feb 2024 02:01:36 +0100
Subject: [PATCH 0866/1374] corefud.Link2Cluster prepared to convert PROIEL
 files

---
 udapi/block/corefud/link2cluster.py | 40 +++++++++++++++++++++--------
 udapi/core/document.py              |  4 +--
 2 files changed, 32 insertions(+), 12 deletions(-)

diff --git a/udapi/block/corefud/link2cluster.py b/udapi/block/corefud/link2cluster.py
index 4e296507..e04380bf 100644
--- a/udapi/block/corefud/link2cluster.py
+++ b/udapi/block/corefud/link2cluster.py
@@ -1,12 +1,14 @@
+import logging
 from udapi.core.block import Block
 
 class Link2Cluster(Block):
     """Block corefud.Link2Cluster converts link-based coreference annotation to the (cluster-based) CorefUD format."""
 
-    def __init__(self, id_attr='external-id', ante_attr='antecedent-id', **kwargs):
+    def __init__(self, id_attr='proiel-id', ante_attr='antecedent-proiel-id', delete_orig_attrs=True, **kwargs):
         super().__init__(**kwargs)
         self.id_attr = id_attr
-        self.ante_id = ante_attr
+        self.ante_attr = ante_attr
+        self.delete_orig_attrs = delete_orig_attrs
 
     def process_document(self, doc):
         id2node = {}
@@ -18,20 +20,38 @@ def process_document(self, doc):
                 ante_id = node.misc[self.ante_attr]
                 if ante_id != '':
                     links.append([ante_id, this_id])
+                if self.delete_orig_attrs:
+                    for attr in (self.id_attr, self.ante_attr):
+                        del node.misc[attr]
+
+        for link in links:
+            if link[0] not in id2node:
+                logging.warning(f"{link[0]} is referenced in {self.ante_attr}, but not in {self.id_attr}")               
+        links = [link for link in links if link[0] in id2node]        
+
+        # nodeA < nodeB is a shortcut for nodeA.ord < nodeB.ord
+        # but here we need to sort nodes from different sentences,
+        # so we need to compare first the bundle number and then node.ord.
+        sort_key = lambda node: (node.root.bundle.number, node.ord)
 
         # sorted(...,reverse=True) converts both cataphora and anaphora to a pair (this, ante) where ante < this.
-        node_links = [sorted([id2node[link[0]], id2node[link[1]]], reverse=True) for link in links]
+        node_links = [sorted([id2node[link[0]], id2node[link[1]]], reverse=True, key=sort_key) for link in links]
         
-        # sort() makes sure the links are sorted by the "this" node (i.e. the anaphor, not the antecendent).
-        node_links.sort()
+        # Makes sure the links are sorted by this_node (i.e. the anaphor, not the antecendent).
+        node_links.sort(key=lambda link: sort_key(link[0]))
         
         # Thanks to this sorting, we can assert that this_node is not part of any mention/entity when iterating
         # and we can prevent the need for merging two entities.
         for this_node, ante_node in node_links:
-            assert not this_node.mentions
-            if ante_node.mentions:
-                ante_node.entities[0].create_mention(head=this_node, words=[this_node])
+            assert not this_node.coref_mentions
+            if ante_node.coref_mentions:
+                ante_node.coref_entities[0].create_mention(head=this_node, words=[this_node])
             else:
                 entity = this_node.root.document.create_coref_entity()
-                entity.create_mention(head=ante_node, words=[ante_node])
-                entity.create_mention(head=this_node, words=[this_node])
+                m_ante = entity.create_mention(head=ante_node, words=[ante_node])
+                m_this = entity.create_mention(head=this_node, words=[this_node])
+                for node, mention in ((ante_node, m_ante), (this_node, m_this)):
+                    if node.misc['information-status']:
+                        mention.other['infstat'] = node.misc['information-status']
+                        if self.delete_orig_attrs:
+                            del node.misc['information-status']
diff --git a/udapi/core/document.py b/udapi/core/document.py
index 8507d2f1..5f2bdf0b 100644
--- a/udapi/core/document.py
+++ b/udapi/core/document.py
@@ -159,9 +159,9 @@ def create_coref_entity(self, eid=None, etype=None):
         self._load_coref()
         if not eid:
             counter = 1
-            while self._eid_to_entity.get(f'c{counter}'):
+            while self._eid_to_entity.get(f'e{counter}'):
                 counter += 1
-            eid = f'c{counter}'
+            eid = f'e{counter}'
         elif self._eid_to_entity.get(eid):
             raise ValueError("Entity with eid=%s already exists", eid)
         entity = udapi.core.coref.CorefEntity(eid, etype)

From ed822b8c4597e606ea4632d56412ba3db901db42 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 1 Feb 2024 17:32:51 +0100
Subject: [PATCH 0867/1374] Better implementation following suggestions by
 @martinpopel

---
 udapi/block/ud/fixcompoundname.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/fixcompoundname.py b/udapi/block/ud/fixcompoundname.py
index 74610757..90596e35 100644
--- a/udapi/block/ud/fixcompoundname.py
+++ b/udapi/block/ud/fixcompoundname.py
@@ -24,11 +24,12 @@ def process_node(self, node):
             grandparent = origparent.parent
             outdeprel = origparent.deprel
             # See if there are other PROPN compound siblings.
-            namewords = sorted([x for x in origparent.children(add_self=True) if x.upos == 'PROPN' and (x.udeprel == 'compound' or x == origparent)], key=lambda y: y.ord)
+            # (The list node.children is automatically sorted by ord. If any new sorting is needed later, we can compare nodes directly, their default comparison value is ord.)
+            namewords = [x for x in origparent.children(add_self=True) if x.upos == 'PROPN' and (x.udeprel == 'compound' or x == origparent)]
             # The Hindi treebank tags dates (['30', 'navaṁbara'], ['disaṁbara', '1993']) as PROPN compounds.
             # This is wrong but it is also different from personal names we are targeting here.
             # Hence, we will skip "names" that contain numbers.
-            if len([x for x in namewords if re.search(r"\d", x.form)]) == 0:
+            if any(re.search(r"\d", x.form) for x in namewords):
                 #logging.info(str([x.misc['Translit'] for x in namewords]))
                 ###!!! We currently cannot transform enhanced dependencies.
                 ###!!! If we proceed, the basic tree would diverge from the enhanced dependencies.

From bb9e553df751db1fe2d01c691f1f600674f12f07 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 3 Feb 2024 21:38:03 +0100
Subject: [PATCH 0868/1374] improve udpipe.Base online=1 - bugfix: `model` was
 ignored when tokenize=0 - allow more combinations, e.g.   tokenize=0 tag=1
 parse=0 or   tokenize=0 tag=0 parse=1   where the existing tags/parses are
 reused - for redoing the tokenization, you can use tokenize=1 delete_nodes=1 
  which first deletes the existing nodes and then creates them again   using
 UDPipe's tokenizer

---
 udapi/block/udpipe/base.py | 21 +++++++++++++--------
 udapi/tool/udpipeonline.py | 25 +++++++++++++++++++------
 2 files changed, 32 insertions(+), 14 deletions(-)

diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
index 448dbb60..d94f8cc5 100644
--- a/udapi/block/udpipe/base.py
+++ b/udapi/block/udpipe/base.py
@@ -120,12 +120,14 @@ class Base(Block):
 
     # pylint: disable=too-many-arguments
     def __init__(self, model=None, model_alias=None, online=False,
-                 tokenize=True, tag=True, parse=True, resegment=False, **kwargs):
+                 tokenize=True, tag=True, parse=True, resegment=False,
+                 delete_nodes=False, **kwargs):
         """Create the udpipe.En block object."""
         super().__init__(**kwargs)
         self.model, self.model_alias, self.online = model, model_alias, online
         self._tool = None
         self.tokenize, self.tag, self.parse, self.resegment = tokenize, tag, parse, resegment
+        self.delete_nodes = delete_nodes
 
     @property
     def tool(self):
@@ -146,16 +148,19 @@ def tool(self):
         return self._tool
 
     def process_document(self, doc):
-        tok, tag, par = self.tokenize, self.tag, self.parse
+        tok, tag, par, reseg = self.tokenize, self.tag, self.parse, self.resegment
         old_bundles = doc.bundles
         new_bundles = []
         for bundle in old_bundles:
             for tree in bundle:
                 new_bundles.append(bundle)
                 if self._should_process_tree(tree):
+                    if self.delete_nodes:
+                        for subroot in tree.children:
+                            subroot.remove()
                     if tok:
-                        new_trees = self.tool.tokenize_tag_parse_tree(tree, resegment=self.resegment,
-                                                                      tag=self.tag, parse=self.parse)
+                        new_trees = self.tool.tokenize_tag_parse_tree(tree, resegment=reseg,
+                                                                      tag=tag, parse=par)
                         if self.resegment and len(new_trees) > 1:
                             orig_bundle_id = bundle.bundle_id
                             bundle.bundle_id = orig_bundle_id + '-1'
@@ -164,9 +169,9 @@ def process_document(self, doc):
                                 new_tree.zone = tree.zone
                                 new_bundle.add_tree(new_tree)
                                 new_bundles.append(new_bundle)
-                    elif not tok and tag and par:
-                        self.tool.tag_parse_tree(tree)
-                    elif not tok and not tag and not par and self.resegment:
+                    elif not tok and not reseg and (tag or par):
+                        self.tool.tag_parse_tree(tree, tag=tag, parse=par)
+                    elif not tok and reseg and not tag and not par:
                         sentences = self.tool.segment_text(tree.text)
                         if len(sentences) > 1:
                             orig_bundle_id = bundle.bundle_id
@@ -178,7 +183,7 @@ def process_document(self, doc):
                                 new_tree.text = sentence
                                 new_bundles.append(new_bundle)
                     else:
-                        raise ValueError("Unimplemented tokenize=%s tag=%s parse=%s" % (tok, tag, par))
+                        raise ValueError(f"Unimplemented tokenize={tok} tag={tag} parse={par} resegment={reseg}")
         doc.bundles = new_bundles
 
 '''
diff --git a/udapi/tool/udpipeonline.py b/udapi/tool/udpipeonline.py
index 2b78a45a..26f31a73 100644
--- a/udapi/tool/udpipeonline.py
+++ b/udapi/tool/udpipeonline.py
@@ -62,21 +62,34 @@ def perform_request(self, params, method="process"):
 
         return response["result"]
 
-    def tag_parse_tree(self, root):
+    def tag_parse_tree(self, root, tag=True, parse=True):
         """Tag (+lemmatize, fill FEATS) and parse a tree (already tokenized)."""
+        if not tag and not parse:
+            raise ValueError('tag_parse_tree(root, tag=False, parse=False) does not make sense.')
         descendants = root.descendants
         if not descendants:
             return
         in_data = " ".join([n.form for n in descendants])
-        out_data = self.perform_request(params={"data": in_data, "input":"horizontal", "tagger":"", "parser":""})
-        conllu_reader = ConlluReader()
+        params = {"model": self.model, "data": in_data, "input":"horizontal", "tagger":""}
+        if tag:
+            attrs = 'upos xpos lemma feats'.split()
+        else:
+            attrs = []
+        if parse:
+            params["parser"] = ""
+            attrs.append('deprel')
+
+        out_data = self.perform_request(params=params)
+        conllu_reader = ConlluReader(empty_parent="ignore")
         conllu_reader.files.filehandle = io.StringIO(out_data)
         parsed_root = conllu_reader.read_tree()
-        root.flatten()
+        if parse:
+            root.flatten()
         for parsed_node in parsed_root.descendants:
             node = descendants[parsed_node.ord - 1]
-            node.parent = descendants[parsed_node.parent.ord - 1] if parsed_node.parent.ord else root
-            for attr in 'upos xpos lemma feats deprel'.split():
+            if parse:
+                node.parent = descendants[parsed_node.parent.ord - 1] if parsed_node.parent.ord else root
+            for attr in attrs:
                 setattr(node, attr, getattr(parsed_node, attr))
 
     def tokenize_tag_parse_tree(self, root, resegment=False, tag=True, parse=True):

From d780aa9f092adbffed003960b9764d3ee3dd4a91 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sun, 4 Feb 2024 01:59:23 +0100
Subject: [PATCH 0869/1374] write.CorefHtml shows sent_id

---
 udapi/block/write/corefhtml.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index 6129b335..cc956ade 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -61,6 +61,7 @@
 .active {border: 1px solid red !important;}
 .selected {background: red !important; text-shadow: 1px 1px 4px white, -1px 1px 4px white, 1px -1px 4px white, -1px -1px 4px white;}
 .other {background: hsl(0, 0%, 85%);}
+.sent_id {display: none; background: #ddd; border-radius: 3px;}
 '''
 
 SCRIPT_BASE = '''
@@ -133,7 +134,7 @@
 add_show_tree_button = function(index, el){
   var sent_id = el.id;
   $(el).prepend(
-    $("<button>", {append: "🌲", id:"button-"+sent_id, title: "show dependency tree", class: "showtree"}).on("click", async function() {
+    $("<button>", {append: "🌲", id:"button-"+sent_id, title: "show dependency tree "+sent_id.substring(1), class: "showtree"}).on("click", async function() {
       var tree_div = $("#tree-"+sent_id);
       if (tree_div.length == 0){
         $('#button-'+sent_id).attr('title', 'hide dependency tree');
@@ -247,6 +248,7 @@ def process_document(self, doc):
         print('<div id="main-menu">Show<br><div>\n'
               f' <input id="show-eid" type="checkbox" {"checked" if self.show_eid else ""} onclick="$(\'.eid\').toggle();"><label for="show-eid">eid</label><br>\n'
               f' <input id="show-etype" type="checkbox" {"checked" if self.show_etype else ""} onclick="$(\'.etype\').toggle();"><label for="show-etype">etype</label><br>\n'
+              ' <input id="show-sent_id" type="checkbox" onclick="$(\'.sent_id\').toggle();"><label for="show-sent_id">sent_id</label><br>\n'
               ' <input id="show-trees" type="checkbox" checked onclick="$(\'.showtree\').toggle();"><label for="show-trees">trees</label><br>\n'
               ' <input id="show-color" type="checkbox" checked onclick="$(\'.m\').toggleClass(\'nocolor\');"><label for="show-color">colors</label><br>\n'
               ' <input id="show-boxes" type="checkbox" checked onclick="$(\'.m\').toggleClass(\'nobox\');"><label for="show-boxes">boxes</label></div><div>\n'
@@ -330,6 +332,7 @@ def process_tree(self, tree):
             print('<hr class="par">')
         opened = []
         print(f'<p class="sentence" id={_id(tree)}>')
+        print(f'<span class="sent_id">🆔{tree.sent_id}</span>')
         for node in nodes_and_empty:
             while subspans and subspans[-1].words[0] == node:
                 subspan = subspans.pop()
@@ -386,11 +389,11 @@ def _is_head(self, node):
         return None
 
 # id needs to be a valid DOM querySelector
-# so it cannot contain # nor / and it cannot start with a digit
+# so it cannot contain [#./] and it cannot start with a digit
 def _id(node):
     if node is None:
         return 'null'
-    return '"n%s"' % node.address().replace('#', '-').replace('/', '-')
+    return '"n%s"' % node.address().replace('#', '-').replace('/', '-').replace('.', '-')
 
 
 def _esc(string):

From 808505658573229c0f66a2d4fb9dc80c8f0b0224 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michal=20Nov=C3=A1k?= <michnov@users.noreply.github.com>
Date: Tue, 6 Feb 2024 16:17:52 +0100
Subject: [PATCH 0870/1374] Corefhtml writer: use a relative docs_dir path in
 the JS script (#120)

* if docs_dir is prefixed with the same path as used in the 'path' parameter, a relative path is used in the JS script instead

* tiny doc fix

* 'docs_dir' no longer has to specify the absolute path. A relative path to the 'path' output directory should be used instead.
---
 udapi/block/write/corefhtml.py | 12 ++++++++----
 udapi/core/basewriter.py       |  2 +-
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index cc956ade..2f5e9512 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -170,13 +170,17 @@ class CorefHtml(BaseWriter):
 
     def __init__(self, docs_dir='docs', show_trees=True, show_eid=False, show_etype=False, colors=7, **kwargs):
         super().__init__(**kwargs)
-        self.docs_dir = docs_dir
         self.show_trees = show_trees
         self.show_eid = show_eid
         self.show_etype = show_etype
         self.colors = colors
-        if docs_dir != '.' and not os.path.exists(docs_dir):
-            os.makedirs(docs_dir)
+        self.js_docs_dir = docs_dir
+        self.docs_dir = docs_dir
+        if self.path:
+            new_dir, _ = os.path.split(self.path)
+            self.docs_dir = os.path.join(new_dir, docs_dir)
+        if docs_dir != '.' and not os.path.exists(self.docs_dir):
+            os.makedirs(self.docs_dir)
         self._mention_ids = {}
         self._entity_colors = {}
 
@@ -274,7 +278,7 @@ def process_document(self, doc):
         finally:
             sys.stdout = orig_stdout
 
-        print(f'<script>\nvar all_docs = {len(ud_docs)};\nvar docs_dir = "{self.docs_dir}";')
+        print(f'<script>\nvar all_docs = {len(ud_docs)};\nvar docs_dir = "{self.js_docs_dir}";')
         print(SCRIPT_BASE)
         if self.show_trees:
             print('docs_json = [false, ', end='') # 1-based index, so dummy docs_json[0]
diff --git a/udapi/core/basewriter.py b/udapi/core/basewriter.py
index 95b32a65..071ec124 100644
--- a/udapi/core/basewriter.py
+++ b/udapi/core/basewriter.py
@@ -10,7 +10,7 @@
 
 
 class BaseWriter(Block):
-    """Base class for all reader blocks."""
+    """Base class for all writer blocks."""
 
     def __init__(self, files='-', filehandle=None, docname_as_file=False, encoding='utf-8',
                  newline='\n', overwrite=False, path=None, **kwargs):

From 5820b153fdafd592f7dd52e099c860cca3d9807f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 7 Feb 2024 18:09:37 +0100
Subject: [PATCH 0871/1374] write.CorefHtml rtl=1 for proper right-to-left
 rendering of sentences

The automatic Unicode heuristics works almost OK,
except for nested named entities where right-to-left (e.g. for Hebrew)
rendering needs to be forced with `dir='rtl'`.
---
 udapi/block/write/corefhtml.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index 2f5e9512..942ef9aa 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -168,12 +168,13 @@
 
 class CorefHtml(BaseWriter):
 
-    def __init__(self, docs_dir='docs', show_trees=True, show_eid=False, show_etype=False, colors=7, **kwargs):
+    def __init__(self, docs_dir='docs', show_trees=True, show_eid=False, show_etype=False, colors=7, rtl=None, **kwargs):
         super().__init__(**kwargs)
         self.show_trees = show_trees
         self.show_eid = show_eid
         self.show_etype = show_etype
         self.colors = colors
+        self.rtl = rtl
         self.js_docs_dir = docs_dir
         self.docs_dir = docs_dir
         if self.path:
@@ -181,6 +182,7 @@ def __init__(self, docs_dir='docs', show_trees=True, show_eid=False, show_etype=
             self.docs_dir = os.path.join(new_dir, docs_dir)
         if docs_dir != '.' and not os.path.exists(self.docs_dir):
             os.makedirs(self.docs_dir)
+
         self._mention_ids = {}
         self._entity_colors = {}
 
@@ -314,7 +316,7 @@ def _start_subspan(self, subspan, crossing=False):
         span_id = ''
         if (subspan.subspan_id == '' or subspan.subspan_id.startswith('[1/')) and e.mentions[0] == m:
             span_id = f'id="{e.eid}" '
-        print(f'<span {span_id}class="{classes}" title="{title}">'
+        print(f'<span {span_id}class="{classes}" title="{title}" dir="ltr">'
               f'<span class="labels"><b class="eid">{subspan.subspan_eid}</b>'
               f' <i class="etype">{e.etype}</i></span>', end='')
 
@@ -335,7 +337,8 @@ def process_tree(self, tree):
         elif tree.newpar:
             print('<hr class="par">')
         opened = []
-        print(f'<p class="sentence" id={_id(tree)}>')
+        rtl = ' dir="rtl"' if self.rtl else ""
+        print(f'<p class="sentence" id={_id(tree)}{rtl}>')
         print(f'<span class="sent_id">🆔{tree.sent_id}</span>')
         for node in nodes_and_empty:
             while subspans and subspans[-1].words[0] == node:

From 0583401cd5d508b630e2925724612a000ccc6b22 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 8 Feb 2024 14:33:01 +0100
Subject: [PATCH 0872/1374] write.corefHtml there are more characters invalid
 in DOM querySelector

---
 udapi/block/write/corefhtml.py | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index 942ef9aa..64499e42 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -20,6 +20,7 @@
 import gzip
 import sys
 import os
+import re
 
 ETYPES = 'person place organization animal plant object substance time number abstract event'.split()
 
@@ -156,7 +157,10 @@
             }
           }
         }
-      } else {tree_div.remove();}
+      } else {
+        tree_div.remove();
+        $('#button-'+sent_id).attr('title', 'show dependency tree '+sent_id.substring(1));
+      }
     })
   );
 }
@@ -395,12 +399,15 @@ def _is_head(self, node):
                 return mention
         return None
 
+
 # id needs to be a valid DOM querySelector
-# so it cannot contain [#./] and it cannot start with a digit
+# so it cannot contain [#./:] and maybe more,
+# so let's substitute all [^\w\d-] to be on the safe side.
+# DOM IDs cannot start with a digit, so prepend e.g. "n".
 def _id(node):
     if node is None:
         return 'null'
-    return '"n%s"' % node.address().replace('#', '-').replace('/', '-').replace('.', '-')
+    return re.sub(r'[^\w\d-]', '_', f"n{node.address()}")
 
 
 def _esc(string):

From 7f81639b58cff749f2a92ff544994a227a98b754 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 8 Feb 2024 16:55:21 +0100
Subject: [PATCH 0873/1374] write.CorefHtml show real sent_id (the DOM escaping
 is lossy)

---
 udapi/block/write/corefhtml.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index 64499e42..b7d19e4b 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -134,11 +134,12 @@
 var load_json_fail_reported = false;
 add_show_tree_button = function(index, el){
   var sent_id = el.id;
+  $(el).prepend('<span class="sent_id">🆔' + el.dataset.id + '</span>');
   $(el).prepend(
-    $("<button>", {append: "🌲", id:"button-"+sent_id, title: "show dependency tree "+sent_id.substring(1), class: "showtree"}).on("click", async function() {
+    $("<button>", {append: "🌲", id:"button-"+sent_id, title: "show dependency tree "+el.dataset.id, class: "showtree"}).on("click", async function() {
       var tree_div = $("#tree-"+sent_id);
       if (tree_div.length == 0){
-        $('#button-'+sent_id).attr('title', 'hide dependency tree');
+        $('#button-'+sent_id).attr('title', 'hide dependency tree '+el.dataset.id);
         var tdiv = $("<div>", {id:"tree-"+sent_id, class:"tree"}).insertAfter($(el));
         doc_number = 1 * el.parentElement.id.substr(3);
         if (docs_json[doc_number]){
@@ -159,7 +160,7 @@
         }
       } else {
         tree_div.remove();
-        $('#button-'+sent_id).attr('title', 'show dependency tree '+sent_id.substring(1));
+        $('#button-'+sent_id).attr('title', 'show dependency tree '+el.dataset.id);
       }
     })
   );
@@ -342,8 +343,7 @@ def process_tree(self, tree):
             print('<hr class="par">')
         opened = []
         rtl = ' dir="rtl"' if self.rtl else ""
-        print(f'<p class="sentence" id={_id(tree)}{rtl}>')
-        print(f'<span class="sent_id">🆔{tree.sent_id}</span>')
+        print(f'<p class="sentence" data-id="{tree.sent_id}" id="{_id(tree)}"{rtl}>')
         for node in nodes_and_empty:
             while subspans and subspans[-1].words[0] == node:
                 subspan = subspans.pop()

From 50187e915761552ca44edad657dd9b943e0bf97c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 9 Feb 2024 00:32:35 +0100
Subject: [PATCH 0874/1374] visualization menu options should apply even to
 newly loaded docs

---
 udapi/block/write/corefhtml.py | 33 ++++++++++++++++++++++-----------
 1 file changed, 22 insertions(+), 11 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index b7d19e4b..b5696f12 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -110,6 +110,17 @@
   $("#main").append(data);
   add_mention_listeners($("#doc" + doc_num + " .m"));
   $("#doc" + doc_num + " .sentence").each(add_show_tree_button);
+  $('.eid').toggle($('#show-eid')[0].checked);
+  $('.etype').toggle($('#show-etype')[0].checked);
+  $('.sent_id').toggle($('#show-sent_id')[0].checked);
+  $('.showtree').toggle($('#show-trees')[0].checked);
+  $('.m').toggleClass('nocolor', ! $('#show-color')[0].checked);
+  $('.m').toggleClass('nobox', ! $('#show-boxes')[0].checked);
+  $('.head').toggleClass('nobold', ! $('#show-heads')[0].checked);
+  $('.empty').toggle($('#show-empty')[0].checked);
+  $('.sentence').toggleClass('display-inline', ! $('#show-breaks')[0].checked);
+  $('.par').toggle($('#show-pars')[0].checked);
+  $('h1').toggle($('#show-docs')[0].checked);
   loading_now = false;
 }
 
@@ -257,17 +268,17 @@ def process_document(self, doc):
 
         print('<div id="main">')
         print('<div id="main-menu">Show<br><div>\n'
-              f' <input id="show-eid" type="checkbox" {"checked" if self.show_eid else ""} onclick="$(\'.eid\').toggle();"><label for="show-eid">eid</label><br>\n'
-              f' <input id="show-etype" type="checkbox" {"checked" if self.show_etype else ""} onclick="$(\'.etype\').toggle();"><label for="show-etype">etype</label><br>\n'
-              ' <input id="show-sent_id" type="checkbox" onclick="$(\'.sent_id\').toggle();"><label for="show-sent_id">sent_id</label><br>\n'
-              ' <input id="show-trees" type="checkbox" checked onclick="$(\'.showtree\').toggle();"><label for="show-trees">trees</label><br>\n'
-              ' <input id="show-color" type="checkbox" checked onclick="$(\'.m\').toggleClass(\'nocolor\');"><label for="show-color">colors</label><br>\n'
-              ' <input id="show-boxes" type="checkbox" checked onclick="$(\'.m\').toggleClass(\'nobox\');"><label for="show-boxes">boxes</label></div><div>\n'
-              ' <input id="show-heads" type="checkbox" checked onclick="$(\'.head\').toggleClass(\'nobold\');"><label for="show-heads">heads in bold</label><br>\n'
-              ' <input id="show-empty" type="checkbox" checked onclick="$(\'.empty\').toggle();"><label for="show-empty">empty words</label><br>\n'
-              ' <input id="show-breaks" type="checkbox" checked onclick="$(\'.sentence\').toggleClass(\'display-inline\');"><label for="show-breaks">sentence per line</label><br>\n'
-              ' <input id="show-pars" type="checkbox" checked onclick="$(\'.par\').toggle();"><label for="show-pars">paragraphs</label><br>\n'
-              ' <input id="show-docs" type="checkbox" checked onclick="$(\'h1\').toggle();"><label for="show-docs">document names</label><br>\n'
+              f' <input id="show-eid" type="checkbox" {"checked" if self.show_eid else ""} onclick="$(\'.eid\').toggle(this.checked);"><label for="show-eid">eid</label><br>\n'
+              f' <input id="show-etype" type="checkbox" {"checked" if self.show_etype else ""} onclick="$(\'.etype\').toggle(this.checked);"><label for="show-etype">etype</label><br>\n'
+              ' <input id="show-sent_id" type="checkbox" onclick="$(\'.sent_id\').toggle(this.checked);"><label for="show-sent_id">sent_id</label><br>\n'
+              ' <input id="show-trees" type="checkbox" checked onclick="$(\'.showtree\').toggle(this.checked);"><label for="show-trees">trees</label><br>\n'
+              ' <input id="show-color" type="checkbox" checked onclick="$(\'.m\').toggleClass(\'nocolor\',!this.checked);"><label for="show-color">colors</label><br>\n'
+              ' <input id="show-boxes" type="checkbox" checked onclick="$(\'.m\').toggleClass(\'nobox\',!this.checked);"><label for="show-boxes">boxes</label></div><div>\n'
+              ' <input id="show-heads" type="checkbox" checked onclick="$(\'.head\').toggleClass(\'nobold\',!this.checked);"><label for="show-heads">heads in bold</label><br>\n'
+              ' <input id="show-empty" type="checkbox" checked onclick="$(\'.empty\').toggle(this.checked);"><label for="show-empty">empty words</label><br>\n'
+              ' <input id="show-breaks" type="checkbox" checked onclick="$(\'.sentence\').toggleClass(\'display-inline\',!this.checked);"><label for="show-breaks">sentence per line</label><br>\n'
+              ' <input id="show-pars" type="checkbox" checked onclick="$(\'.par\').toggle(this.checked);"><label for="show-pars">paragraphs</label><br>\n'
+              ' <input id="show-docs" type="checkbox" checked onclick="$(\'h1\').toggle(this.checked);"><label for="show-docs">document names</label><br>\n'
               '</div></div>\n'
               '<button id="menubtn" title="Visualization options" onclick="menuclick(this)"><div class="b1"></div><div class="b2"></div><div class="b3"></div></button>\n')
 

From a9f5ecb6456a528f20a26a4587f18ec47d6b8f7e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 9 Feb 2024 12:03:25 +0100
Subject: [PATCH 0875/1374] WIP: a reader for Corpus of Czech Verse json files

---
 udapi/block/read/ccv.py | 78 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 udapi/block/read/ccv.py

diff --git a/udapi/block/read/ccv.py b/udapi/block/read/ccv.py
new file mode 100644
index 00000000..eb449362
--- /dev/null
+++ b/udapi/block/read/ccv.py
@@ -0,0 +1,78 @@
+"""Ccv class is a reader for Corpus of Czech Verse json files."""
+from udapi.core.basereader import BaseReader
+from udapi.core.root import Root
+from udapi.block.ud.setspaceafterfromtext import SetSpaceAfterFromText
+import json
+
+class Ccv(BaseReader):
+    r"""A reader for Corpus of Czech Verse json files.
+
+    See https://github.com/versotym/corpusCzechVerse
+    Each verse (line) is stored as one tree (although it is quite often not a whole sentence).
+    Start of each stanza is marked with `newpar`.
+    Start of each poem is marked with `newdoc = [poem_id]`.
+
+    Args:
+    tokenize: create nodes
+    """
+    def __init__(self, tokenize=True, **kwargs):
+        self.tokenize = tokenize
+        self._cache = None
+        super().__init__(**kwargs)
+
+    @staticmethod
+    def is_multizone_reader():
+        """Can this reader read bundles which contain more zones?.
+
+        This implementation returns always False.
+        """
+        return False
+
+    def read_tree(self):
+        if self._cache:
+            return self._cache.pop()
+        else:
+            trees = self.read_trees()
+            if not trees:
+                return None
+            self._cache = list(reversed(trees[1:]))
+            return trees[0]
+
+    def read_trees(self):
+        if self.filehandle is None:
+            return None
+        poems = json.load(self.filehandle)
+        all_trees = []
+        for poem in poems:
+            poem_trees = []
+            for stanza in poem["body"]:
+                stanza_trees = []
+                for line in stanza:
+                    root = Root()
+                    root.text = line["text"]
+                    root.json["rhyme"] = line["rhyme"]
+                    root.json["metre"] = line["metre"]
+                    root.json["stress"] = line["stress"]
+                    stanza_trees.append(root)
+                    if self.tokenize:
+                        words = [[]] + [[w] for w in line["words"]]
+                        for index, puncts in line["punct"].items():
+                            for punct in puncts:
+                                words[int(index)].append({"token": punct, "lemma": punct})
+                        for word in words:
+                            for w in word:
+                                node = root.create_child(form=w["token"], lemma=w["lemma"])
+                                if "morph" in w:
+                                    node.xpos = w["morph"]
+                                    node.misc["xsampa"] = w["xsampa"]
+                                    node.misc["phoebe"] = w["phoebe"]
+                        SetSpaceAfterFromText.process_tree(None, root)
+                stanza_trees[0].newpar = True
+                poem_trees.extend(stanza_trees)
+            root = poem_trees[0]
+            root.newdoc = poem["poem_id"]
+            root.json["p_author"] = poem["p_author"]
+            root.json["b_author"] = poem["b_author"]
+            root.json["biblio"] = poem["biblio"] 
+            all_trees.extend(poem_trees)
+        return all_trees

From d7cd40516b944bd2181e1959f7c3b5c98a5a720b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 9 Feb 2024 20:19:44 +0100
Subject: [PATCH 0876/1374] util.Normalize empty_node_ord=1

---
 udapi/block/util/normalize.py | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/udapi/block/util/normalize.py b/udapi/block/util/normalize.py
index 9d470ceb..b150d551 100644
--- a/udapi/block/util/normalize.py
+++ b/udapi/block/util/normalize.py
@@ -20,12 +20,13 @@ class Normalize(Block):
     util.Eval node='node.misc["NonExistentAttribute"] = None'
     """
 
-    def __init__(self, feats=True, misc=True, sent_id=False, start_sent_id=1, sent_id_prefix="", **kwargs):
+    def __init__(self, feats=True, misc=True, sent_id=False, empty_node_ord=False, start_sent_id=1, sent_id_prefix="", **kwargs):
         """
         Args:
         `feats`: normalize the ordering of FEATS. Default=True.
         `misc`: normalize the ordering of MISC. Default=True.
         `sent_id`: normalize sent_id so it forms a sequence of integers. Default=False.
+        `empty_node_ord`: normalize ord attributes of empty nodes. Default=False.
         `start_sent_id`: the first sent_id number
         `sent_id_prefix`: a string to be prepended before the integer sent_id. Default=empty string.
         """
@@ -33,6 +34,7 @@ def __init__(self, feats=True, misc=True, sent_id=False, start_sent_id=1, sent_i
         self.feats = feats
         self.misc = misc
         self.sent_id = sent_id
+        self.empty_node_ord = empty_node_ord
         self.next_sent_id = start_sent_id
         self.sent_id_prefix = sent_id_prefix
         if sent_id_prefix or start_sent_id != 1:
@@ -49,6 +51,20 @@ def process_bundle(self, bundle):
                 self.process_tree(tree)
 
     def process_tree(self, tree):
+        if self.empty_node_ord:
+            node_ord, empty_ord = 0, 0
+            for node in tree.descendants_and_empty:
+                if node.is_empty():
+                    empty_ord += 1
+                    old_empty_ord, new_empty_ord = str(node.ord), f"{node_ord}.{empty_ord}"
+                    if old_empty_ord != new_empty_ord:
+                        # Make sure all nodes in this sentence have deserialized enhanced deps.
+                        for n in tree.descendants_and_empty:
+                            n.deps
+                        node.ord = new_empty_ord
+                else:
+                    empty_ord = 0
+                    node_ord = node.ord
         for node in tree.descendants:
             self.process_node(node)
 

From 9ddcda491aefe6b6f7bf68ec9616307d6ff45d72 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 9 Feb 2024 21:26:38 +0100
Subject: [PATCH 0877/1374] corefud.FixEntityAcrossNewdoc

---
 udapi/block/corefud/fixentityacrossnewdoc.py | 25 ++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 udapi/block/corefud/fixentityacrossnewdoc.py

diff --git a/udapi/block/corefud/fixentityacrossnewdoc.py b/udapi/block/corefud/fixentityacrossnewdoc.py
new file mode 100644
index 00000000..61e5e4f6
--- /dev/null
+++ b/udapi/block/corefud/fixentityacrossnewdoc.py
@@ -0,0 +1,25 @@
+from udapi.core.block import Block
+import udapi.core.coref
+import logging
+
+class FixEntityAcrossNewdoc(Block):
+    """
+    Fix the error reported by validate.py --coref:
+    "[L6 Coref entity-across-newdoc] Same entity id should not occur in multiple documents"
+    by making the entity IDs (eid) unique in each newdoc document.
+
+    This block uses Udapi's support for loading GUM-like GRP document-wide IDs
+    (so the implementation is simple, although unnecessarily slow).
+    After applying this block, IDs of all entities are prefixed with document numbers,
+    e.g. "e45" in the 12th document changes to "d12.e45".
+    If you prefer simple eid, use corefud.IndexClusters afterwards.
+    """
+
+    def process_document(self, doc):
+        if not doc.eid_to_entity:
+            logging.warning(f"No entities in document {doc.meta}")
+        udapi.core.coref.store_coref_to_misc(doc)
+        assert doc.meta["global.Entity"].startswith("eid")
+        doc.meta["global.Entity"] = "GRP" + doc.meta["global.Entity"][3:]
+        udapi.core.coref.load_coref_from_misc(doc)
+        doc.meta["global.Entity"] = "eid" + doc.meta["global.Entity"][3:]

From 3ae1229f26f93c81de8e1a8f82cfd4ed22d685d6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 10 Feb 2024 03:56:00 +0100
Subject: [PATCH 0878/1374] improve and simplify corefud.Link2Cluster

---
 udapi/block/corefud/link2cluster.py | 71 ++++++++++++++++-------------
 1 file changed, 39 insertions(+), 32 deletions(-)

diff --git a/udapi/block/corefud/link2cluster.py b/udapi/block/corefud/link2cluster.py
index e04380bf..3f9f9bb3 100644
--- a/udapi/block/corefud/link2cluster.py
+++ b/udapi/block/corefud/link2cluster.py
@@ -13,45 +13,52 @@ def __init__(self, id_attr='proiel-id', ante_attr='antecedent-proiel-id', delete
     def process_document(self, doc):
         id2node = {}
         links = []
-        for node in doc.nodes:
+        for node in doc.nodes_and_empty:
             this_id = node.misc[self.id_attr]
             if this_id != '':
                 id2node[this_id] = node
                 ante_id = node.misc[self.ante_attr]
                 if ante_id != '':
-                    links.append([ante_id, this_id])
+                    if ante_id == this_id:
+                        logging.warning(f"{node} has a self-reference {self.ante_attr}={ante_id}")
+                    else:
+                        links.append([ante_id, this_id])
                 if self.delete_orig_attrs:
                     for attr in (self.id_attr, self.ante_attr):
                         del node.misc[attr]
 
-        for link in links:
-            if link[0] not in id2node:
-                logging.warning(f"{link[0]} is referenced in {self.ante_attr}, but not in {self.id_attr}")               
-        links = [link for link in links if link[0] in id2node]        
-
-        # nodeA < nodeB is a shortcut for nodeA.ord < nodeB.ord
-        # but here we need to sort nodes from different sentences,
-        # so we need to compare first the bundle number and then node.ord.
-        sort_key = lambda node: (node.root.bundle.number, node.ord)
-
-        # sorted(...,reverse=True) converts both cataphora and anaphora to a pair (this, ante) where ante < this.
-        node_links = [sorted([id2node[link[0]], id2node[link[1]]], reverse=True, key=sort_key) for link in links]
-        
-        # Makes sure the links are sorted by this_node (i.e. the anaphor, not the antecendent).
-        node_links.sort(key=lambda link: sort_key(link[0]))
-        
-        # Thanks to this sorting, we can assert that this_node is not part of any mention/entity when iterating
-        # and we can prevent the need for merging two entities.
-        for this_node, ante_node in node_links:
-            assert not this_node.coref_mentions
-            if ante_node.coref_mentions:
-                ante_node.coref_entities[0].create_mention(head=this_node, words=[this_node])
+        # It seems faster&simpler to process the links in any order and implement entity merging,
+        # rather than trying to sort the links so that no entity merging is needed.
+        for ante_id, this_id in links:
+            if ante_id not in id2node:
+                logging.warning(f"{ante_id} is referenced in {self.ante_attr}, but not in {self.id_attr}")
             else:
-                entity = this_node.root.document.create_coref_entity()
-                m_ante = entity.create_mention(head=ante_node, words=[ante_node])
-                m_this = entity.create_mention(head=this_node, words=[this_node])
-                for node, mention in ((ante_node, m_ante), (this_node, m_this)):
-                    if node.misc['information-status']:
-                        mention.other['infstat'] = node.misc['information-status']
-                        if self.delete_orig_attrs:
-                            del node.misc['information-status']
+                ante_node, this_node = id2node[ante_id], id2node[this_id]
+                if not this_node.coref_mentions and not ante_node.coref_mentions:
+                    # None of the nodes is part of any mention/entity. Let's create them.
+                    entity = this_node.root.document.create_coref_entity()
+                    m_ante = entity.create_mention(head=ante_node, words=[ante_node])
+                    m_this = entity.create_mention(head=this_node, words=[this_node])
+                    for node, mention in ((ante_node, m_ante), (this_node, m_this)):
+                        if node.misc['information-status']:
+                            mention.other['infstat'] = node.misc['information-status']
+                            if self.delete_orig_attrs:
+                                del node.misc['information-status']
+                elif this_node.coref_mentions and ante_node.coref_mentions:
+                    # Both of the nodes are part of mentions in different entities.
+                    # Let's merge the two entities (i.e. "steal" all mentions from the "ante" entity to "this" entity).
+                    # While the official API supports "stealing" a single mention (m.entity = another_entity),
+                    # the implementation below using _mentions and _entity is a bit faster.
+                    e_ante, e_this = this_node.coref_entities[0], ante_node.coref_entities[0]
+                    assert e_ante != e_this
+                    for mention in e_ante.mentions:
+                        mention._entity = e_this
+                    e_this._mentions.extend(e_ante.mentions)
+                    e_this._mentions.sort()
+                    e_ante._mentions.clear()
+                else:
+                    # Only one of the nodes is part of an entity. Let's add the second one to this entity.
+                    if ante_node.coref_mentions:
+                        ante_node.coref_entities[0].create_mention(head=this_node, words=[this_node])
+                    else:
+                        this_node.coref_entities[0].create_mention(head=ante_node, words=[ante_node])

From f981c832e8cfa74a6df93ee5a91385ea60d7db2c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 14 Feb 2024 22:27:56 +0100
Subject: [PATCH 0879/1374] write.CorefHtml rtl=1 fix

The title should be always rendered left-to-right (e.g. "head=X", not "X=head"),
so for RTL languages, we need to use explicit dir="ltr" and insert a nested span with dir="rtl".
---
 udapi/block/write/corefhtml.py | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index b5696f12..7958e0bb 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -332,9 +332,16 @@ def _start_subspan(self, subspan, crossing=False):
         span_id = ''
         if (subspan.subspan_id == '' or subspan.subspan_id.startswith('[1/')) and e.mentions[0] == m:
             span_id = f'id="{e.eid}" '
-        print(f'<span {span_id}class="{classes}" title="{title}" dir="ltr">'
-              f'<span class="labels"><b class="eid">{subspan.subspan_eid}</b>'
-              f' <i class="etype">{e.etype}</i></span>', end='')
+        # The title should be always rendered left-to-right (e.g. "head=X", not "X=head"),
+        # so for RTL languages, we need to use explicit dir="ltr" and insert a nested span with dir="rtl".
+        if self.rtl:
+            print(f'<span {span_id}class="{classes}" title="{title}" dir="ltr">'
+                  f'<span class="labels"><b class="eid">{subspan.subspan_eid}</b>'
+                  f' <i class="etype">{e.etype}</i></span><span dir="rtl">', end='')
+        else:
+            print(f'<span {span_id}class="{classes}" title="{title}">'
+                  f'<span class="labels"><b class="eid">{subspan.subspan_eid}</b>'
+                  f' <i class="etype">{e.etype}</i></span>', end='')
 
     def process_tree(self, tree):
         mentions = set()
@@ -373,7 +380,10 @@ def process_tree(self, tree):
                 print('</b>', end='')
 
             while opened and opened[-1].words[-1] == node:
-                print('</span>', end='')
+                if self.rtl:
+                    print('</span></span>', end='')
+                else:
+                    print('</span>', end='')
                 opened.pop()
 
             # Two mentions are crossing iff their spans have non-zero intersection,

From be5c58ee66e76cee8a8c0603bfe4097c5776b05b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 16 Feb 2024 02:02:13 +0100
Subject: [PATCH 0880/1374] nice LaTeX tables using corefud.Stats style=tex-doc

udapy -q read.Conllu split_docs=1 corefud.Stats per_doc=1 style=tex-doc < in.conllu > out.tex
---
 udapi/block/corefud/stats.py | 138 +++++++++++++++++++++++++++++++----
 1 file changed, 124 insertions(+), 14 deletions(-)

diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
index 5d01e3f1..00e50882 100644
--- a/udapi/block/corefud/stats.py
+++ b/udapi/block/corefud/stats.py
@@ -4,20 +4,23 @@
 class Stats(Block):
     """Block corefud.Stats prints various coreference-related statistics."""
 
-    def __init__(self, m_len_max=5, c_len_max=5, report_mentions=True, report_entities=True,
+    def __init__(self, m_len_max=5, e_len_max=5, report_mentions=True, report_entities=True,
                  report_details=True, selected_upos='NOUN PRON PROPN DET ADJ VERB ADV NUM',
-                 exclude_singletons=False, exclude_nonsingletons=False, style='human', **kwargs):
+                 exclude_singletons=False, exclude_nonsingletons=False, style='human',
+                 per_doc=False, **kwargs):
         super().__init__(**kwargs)
         self.m_len_max = m_len_max
-        self.c_len_max = c_len_max
+        self.e_len_max = e_len_max
         self.report_mentions = report_mentions
         self.report_entities = report_entities
         self.report_details = report_details
         self.exclude_singletons = exclude_singletons
         self.exclude_nonsingletons = exclude_nonsingletons
         self.style = style
-        if style not in 'tex human'.split():
-            raise ValueError(f'Unknown style f{style}')
+        if style not in 'tex tex-table tex-doc human'.split():
+            raise ValueError(f'Unknown style {style}')
+        self.per_doc = per_doc
+        self._header_printed = False
 
         self.counter = Counter()
         self.mentions = 0
@@ -31,6 +34,7 @@ def __init__(self, m_len_max=5, c_len_max=5, report_mentions=True, report_entiti
 
     def process_document(self, doc):
         self.total_nodes += len(list(doc.nodes))
+        self.counter['documents'] += 1
         for entity in doc.coref_entities:
             len_mentions = len(entity.mentions)
             if len_mentions == 1:
@@ -41,7 +45,7 @@ def process_document(self, doc):
                 continue
             self.longest_entity = max(len_mentions, self.longest_entity)
             self.counter['c_total_len'] += len_mentions
-            self.counter[f"c_len_{min(len_mentions, self.c_len_max)}"] += 1
+            self.counter[f"c_len_{min(len_mentions, self.e_len_max)}"] += 1
 
             self.entities += 1
             if not self.report_mentions and not self.report_details:
@@ -69,7 +73,32 @@ def process_document(self, doc):
                             heads += 0 if any(d['parent'] in mwords for d in w.deps) else 1
                     self.counter['m_nontreelet'] += 1 if heads > 1 else 0
 
-    def process_end(self):
+
+    def after_process_document(self, doc):
+        if self.per_doc:
+            self.process_end(skip=False, doc=doc)
+            self.counter = Counter()
+            self.mentions = 0
+            self.entities = 0
+            self.singletons = 0
+            self.total_nodes = 0
+            self.longest_mention = 0
+            self.longest_entity = 0
+            self.m_words = 0
+
+    def process_end(self, skip=True, doc=None):
+        if not self._header_printed:
+            self._header_printed = True
+            self.print_header()
+        if self.per_doc:
+            if skip:
+                self.print_footer()
+                return
+            else:
+                print(f"{doc[0].trees[0].newdoc:15}", end='&' if self.style.startswith('tex') else '\n')
+        elif self.style.startswith('tex-'):
+            print(f"{self.counter['documents']:4} documents &")
+
         mentions_nonzero = 1 if self.mentions == 0 else self.mentions
         entities_nonzero = 1 if self.entities == 0 else self.entities
         total_nodes_nonzero = 1 if self.total_nodes == 0 else self.total_nodes
@@ -80,17 +109,18 @@ def process_end(self):
                         ('entities_per1k', f"{1000 * self.entities / total_nodes_nonzero:6.0f}"),
                         ('longest_entity', f"{self.longest_entity:6}"),
                         ('avg_entity', f"{self.counter['c_total_len'] / entities_nonzero:5.1f}")]
-            for i in range(1, self.c_len_max + 1):
+            for i in range(1, self.e_len_max + 1):
                 percent = 100 * self.counter[f"c_len_{i}"] / entities_nonzero
-                columns.append((f"c_len_{i}{'' if i < self.c_len_max else '+'}", f"{percent:5.1f}"))
+                columns.append((f"c_len_{i}{'' if i < self.e_len_max else '+'}", f"{percent:5.1f}"))
         if self.report_mentions:
             columns += [('mentions', f"{self.mentions:7,}"),
                         ('mentions_per1k', f"{1000 * self.mentions / total_nodes_nonzero:6.0f}"),
                         ('longest_mention', f"{self.longest_mention:6}"),
                         ('avg_mention', f"{self.counter['m_total_len'] / mentions_nonzero:5.1f}")]
-            for i in range(0, self.m_len_max + 1):
-                percent = 100 * self.counter[f"m_len_{i}"] / mentions_nonzero
-                columns.append((f"m_len_{i}{'' if i < self.m_len_max else '+'}", f"{percent:5.1f}"))
+            if self.m_len_max:
+                for i in range(0, self.m_len_max + 1):
+                    percent = 100 * self.counter[f"m_len_{i}"] / mentions_nonzero
+                    columns.append((f"m_len_{i}{'' if i < self.m_len_max else '+'}", f"{percent:5.1f}"))
         if self.report_details:
             columns += [('with_empty', f"{100 * self.counter['m_with_empty'] / mentions_nonzero:5.1f}"),
                         ('with_gaps', f"{100 * self.counter['m_with_gaps'] / mentions_nonzero:5.1f}"),
@@ -102,8 +132,88 @@ def process_end(self):
             for upos in upos_list:
                 columns.append(('head_upos=' + upos, f"{100 * self.counter['m_head_upos_' + upos] / mentions_nonzero:5.1f}"))
 
-        if self.style == 'tex':
-            print(" & ".join(c[1] for c in columns))
+        if self.style.startswith('tex'):
+            print(" & ".join(c[1] for c in columns), end=" \\\\\n")
         elif self.style == 'human':
             for c in columns:
                 print(f"{c[0]:>15} = {c[1].strip():>10}")
+        if not self.per_doc:
+            self.print_footer()
+
+    def print_header(self):
+        if not self.style.startswith('tex-'):
+            return
+        if self.style == 'tex-doc':
+            print(r'\documentclass{standalone}')
+            print(r'\usepackage[utf8]{inputenc}\usepackage{booktabs}\usepackage{underscore}')
+            print(r'\title{Udapi coreference statistics}')
+            print(r'\begin{document}')
+        print(r'\def\MC#1#2{\multicolumn{#1}{c}{#2}}')
+        lines = [r'\begin{tabular}{@{}l ', " "*15, ("document" if self.per_doc else "dataset ") + " "*7, " "*15]
+        if self.report_entities:
+            lines[0] += "rrrr "
+            lines[1] += r'& \MC{4}{entities}                 '
+            lines[2] += r'&  total & per 1k & \MC{2}{length} '
+            lines[3] += r'&  count &  words &    max &  avg. '
+            if self.e_len_max:
+                for i in range(1, self.e_len_max + 1):
+                    lines[0] += "r"
+                    lines[2] += f"& {i:4}" + ("+ " if i==self.e_len_max else "  ")
+                    lines[3] += r'&  [\%] '
+                lines[0] += " "
+                lines[1] += r'& \MC{' + str(self.e_len_max) + r'}{distribution of entity lengths}'
+        if self.report_mentions:
+            lines[0] += "rrrr "
+            lines[1] += r'& \MC{4}{mentions}                  '
+            lines[2] += r'&   total & per 1k & \MC{2}{length} '
+            lines[3] += r'&   count &  words &    max &  avg. '
+            if self.m_len_max:
+                for i in range(0, self.m_len_max + 1):
+                    lines[0] += "r"
+                    lines[2] += f"& {i:4}" + ("+ " if i==self.m_len_max else "  ")
+                    lines[3] += r'&  [\%] '
+                lines[0] += " "
+                lines[1] += r'& \MC{' + str(self.m_len_max + 1) + r'}{distribution of mention lengths}' + " "*7
+        if self.report_details:
+            lines[0] += "rrrr "
+            lines[1] += r'& \MC{3}{mention type}       '
+            lines[2] += r'&w/empty& w/gap&non-tree'
+            lines[3] += r'&  [\%] ' * 3
+            if self.selected_upos:
+                upos_list = self.selected_upos + ['other']
+            else:
+                upos_list = [x[12:] for x in self.counter if x.startswith('m_head_upos_')]
+            lines[0] += "@{~}r" * len(upos_list)
+            lines[1] += r"& \MC{" + str(len(upos_list)) + r"}{distribution of head UPOS}"
+            lines[2] += ''.join(f'&{upos:7}' for upos in upos_list)
+            lines[3] += r'&  [\%] ' * len(upos_list)
+        lines[0] += r'@{}}\toprule'
+        last_col = 1
+        lines[1] += r'\\'
+        lines[2] += r'\\'
+        lines[3] += r'\\\midrule'
+        if self.report_entities:
+            last_col += 4
+            lines[1] += r'\cmidrule(lr){2-5}'
+            lines[2] += r'\cmidrule(lr){4-5}'
+            if self.e_len_max:
+                last_col += self.e_len_max
+                lines[1] += r'\cmidrule(lr){6-' + str(last_col) + '}'
+        if self.report_mentions:
+            lines[1] += r'\cmidrule(lr){' + f"{last_col+1}-{last_col+4}" + '}'
+            lines[2] += r'\cmidrule(lr){' + f"{last_col+3}-{last_col+4}" + '}'
+            last_col += 4
+            if self.m_len_max:
+                lines[1] += r'\cmidrule(lr){' + f"{last_col+1}-{last_col+self.m_len_max+1}" + '}'
+                last_col += self.m_len_max + 1
+        if self.report_details:
+            lines[1] += r'\cmidrule(lr){' + f"{last_col+1}-{last_col+3}"
+            lines[1] += r'}\cmidrule(l){' + f"{last_col+4}-{last_col+3+len(upos_list)}" + '}'
+        print("\n".join(lines))
+
+    def print_footer(self):
+        if not self.style.startswith('tex-'):
+            return
+        print(r'\bottomrule\end{tabular}')
+        if self.style == 'tex-doc':
+            print(r'\end{document}')

From a9b65919580edd1e7e0d1c50e7464182b1ae3d23 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Barbora=20Dohnalov=C3=A1?=
 <71558316+kybersutr@users.noreply.github.com>
Date: Mon, 19 Feb 2024 14:12:01 +0100
Subject: [PATCH 0881/1374] Add block for fixing inconsistent parentheses in
 mention spans (#121)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* add FixParentheses block

* nicer code

* typo

---------

Co-authored-by: Barbora Dohnalová <barca.dohnalova@seznam.cz>
---
 udapi/block/corefud/fixparentheses.py | 31 +++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100755 udapi/block/corefud/fixparentheses.py

diff --git a/udapi/block/corefud/fixparentheses.py b/udapi/block/corefud/fixparentheses.py
new file mode 100755
index 00000000..9baeca98
--- /dev/null
+++ b/udapi/block/corefud/fixparentheses.py
@@ -0,0 +1,31 @@
+from udapi.core.block import Block
+
+
+class FixParentheses(Block):
+    """Find mentions that contain opening parenthesis but do not contain the closing one (or the other way around).
+    If the missing parenthesis is an immediate neighbour of the mention span, add it to the span."""
+
+    def __init__(self, mark=True, **kwargs):
+        super().__init__(**kwargs)
+        self.mark = mark
+
+    def process_coref_mention(self, mention):
+        words = [word.lemma for word in mention.words]
+        pairs = ['()', '[]', '{}']
+        for pair in pairs:
+            if pair[0] in words:
+                if not pair[1] in words and pair[1] in [node.lemma for node in mention.head.root.descendants]:
+                    if mention.words[-1].ord == int(mention.words[-1].ord) and mention.words[-1].next_node and \
+                            mention.words[-1].next_node.lemma == pair[1]:
+                        next_node = mention.words[-1].next_node
+                        mention.words.append(next_node)
+                        if self.mark:
+                            next_node.misc['Mark'] = 1
+
+            elif pair[1] in words and pair[0] in [node.lemma for node in mention.head.root.descendants]:
+                if mention.words[0].ord == int(mention.words[0].ord) and mention.words[0].prev_node \
+                        and mention.words[0].prev_node.lemma == pair[0]:
+                    prev_node = mention.words[0].prev_node
+                    mention.words.append(prev_node)
+                    if self.mark:
+                        prev_node.misc['Mark'] = 1

From baaed2a2fec6d46353172117e2f186ad5fce6341 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 19 Feb 2024 16:32:06 +0100
Subject: [PATCH 0882/1374] write.CorefHtml visualisation options non-mentions
 and bg-color

---
 udapi/block/write/corefhtml.py | 32 +++++++++++++++++++++++++++-----
 1 file changed, 27 insertions(+), 5 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index 7958e0bb..5943d45b 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -24,6 +24,8 @@
 
 ETYPES = 'person place organization animal plant object substance time number abstract event'.split()
 
+HTYPES = 'PROPN NOUN PRON VERB DET OTHER'.split()
+
 HEADER = '''
 <!DOCTYPE html><html lang="en"><head><meta charset="UTF-8">
 <title>Udapi CorefUD viewer</title>
@@ -56,12 +58,11 @@
 .showtree {margin: 5px; user-select: none;}
 .display-inline {display: inline;}
 .close{float:right; font-weight: 900; font-size: 30px; width: 36px; height: 36px; padding: 2px}
-.empty {color: gray;}
+i.empty {color: gray; border: 3px outset gray; padding: 1px;}
 .sentence .singleton {border-style: dotted;}
 .crossing:before {content: "!"; display: block; background: #ffd500;}
 .active {border: 1px solid red !important;}
 .selected {background: red !important; text-shadow: 1px 1px 4px white, -1px 1px 4px white, 1px -1px 4px white, -1px -1px 4px white;}
-.other {background: hsl(0, 0%, 85%);}
 .sent_id {display: none; background: #ddd; border-radius: 3px;}
 '''
 
@@ -116,11 +117,13 @@
   $('.showtree').toggle($('#show-trees')[0].checked);
   $('.m').toggleClass('nocolor', ! $('#show-color')[0].checked);
   $('.m').toggleClass('nobox', ! $('#show-boxes')[0].checked);
+  $('.norm').toggle($('#show-norm')[0].checked);
   $('.head').toggleClass('nobold', ! $('#show-heads')[0].checked);
   $('.empty').toggle($('#show-empty')[0].checked);
   $('.sentence').toggleClass('display-inline', ! $('#show-breaks')[0].checked);
   $('.par').toggle($('#show-pars')[0].checked);
   $('h1').toggle($('#show-docs')[0].checked);
+  $('.m').toggleClass('htype',$('#htype')[0].checked)
   loading_now = false;
 }
 
@@ -234,6 +237,10 @@ def process_document(self, doc):
         print('<style>' + CSS)
         for i, etype in enumerate(ETYPES):
             print(f'.{etype} {{background: hsl({int(i * 360/len(ETYPES))}, 80%, 85%);}}')
+        print('.other {background: hsl(0, 0%, 85%);}')
+        for i, htype in enumerate(HTYPES[:-1]):
+            print(f'.htype.{htype} {{background: hsl({int(i * 360/len(HTYPES))}, 80%, 85%);}}')
+        print('.htype.OTHER {background: hsl(0, 0%, 85%);}')
         if self.colors:
             for i in range(self.colors):
                 print(f'.c{i} {{color: hsl({int(i * 360/self.colors)}, 100%, 30%);}}')
@@ -274,13 +281,19 @@ def process_document(self, doc):
               ' <input id="show-trees" type="checkbox" checked onclick="$(\'.showtree\').toggle(this.checked);"><label for="show-trees">trees</label><br>\n'
               ' <input id="show-color" type="checkbox" checked onclick="$(\'.m\').toggleClass(\'nocolor\',!this.checked);"><label for="show-color">colors</label><br>\n'
               ' <input id="show-boxes" type="checkbox" checked onclick="$(\'.m\').toggleClass(\'nobox\',!this.checked);"><label for="show-boxes">boxes</label></div><div>\n'
+              ' <input id="show-norm" type="checkbox" checked onclick="$(\'.norm\').toggle(this.checked);"><label for="show-norm">non-mentions</label><br>\n'
               ' <input id="show-heads" type="checkbox" checked onclick="$(\'.head\').toggleClass(\'nobold\',!this.checked);"><label for="show-heads">heads in bold</label><br>\n'
               ' <input id="show-empty" type="checkbox" checked onclick="$(\'.empty\').toggle(this.checked);"><label for="show-empty">empty words</label><br>\n'
               ' <input id="show-breaks" type="checkbox" checked onclick="$(\'.sentence\').toggleClass(\'display-inline\',!this.checked);"><label for="show-breaks">sentence per line</label><br>\n'
               ' <input id="show-pars" type="checkbox" checked onclick="$(\'.par\').toggle(this.checked);"><label for="show-pars">paragraphs</label><br>\n'
               ' <input id="show-docs" type="checkbox" checked onclick="$(\'h1\').toggle(this.checked);"><label for="show-docs">document names</label><br>\n'
-              '</div></div>\n'
-              '<button id="menubtn" title="Visualization options" onclick="menuclick(this)"><div class="b1"></div><div class="b2"></div><div class="b3"></div></button>\n')
+              '</div><fieldset onclick="$(\'.m\').toggleClass(\'htype\',$(\'#htype\')[0].checked)"><legend>bg color:</legend>\n'
+              '<label><input type="radio" name="bgcolor" id="etype" checked>entity type</label>\n'
+              '<label><input type="radio" name="bgcolor" id="htype">head upos</label>\n'
+              '</fieldset>\n'
+              '</div>\n'
+              '<button id="menubtn" title="Visualization options" onclick="menuclick(this)"><div class="b1"></div><div class="b2"></div><div class="b3"></div></button>\n'
+              )
 
         # The first ud_doc will be printed to the main html file.
         self.process_ud_doc(ud_docs[0], 1)
@@ -318,6 +331,8 @@ def _start_subspan(self, subspan, crossing=False):
         e = m.entity
         classes = f'{e.eid} {self._mention_ids[m]} {e.etype or "other"} m'
         title = f'eid={subspan.subspan_eid}\netype={e.etype}\nhead={m.head.form}'
+        classes += f" {m.head.upos if m.head.upos in HTYPES else 'OTHER'}"
+        title += f'\nhead-upos={m.head.upos}'
         if self.colors:
             classes += f' {self._entity_colors[e]}'
         if all(w.is_empty() for w in subspan.words):
@@ -359,15 +374,20 @@ def process_tree(self, tree):
             print(f'<hr><h1>{tree.newdoc if tree.newdoc is not True else ""}</h1><hr>')
         elif tree.newpar:
             print('<hr class="par">')
-        opened = []
+        opened, prev_node_mention = [], True
         rtl = ' dir="rtl"' if self.rtl else ""
         print(f'<p class="sentence" data-id="{tree.sent_id}" id="{_id(tree)}"{rtl}>')
         for node in nodes_and_empty:
+            if not prev_node_mention and subspans and subspans[-1].words[0] == node:
+                print('</span>', end='')
             while subspans and subspans[-1].words[0] == node:
                 subspan = subspans.pop()
                 self._start_subspan(subspan)
                 opened.append(subspan)
 
+            if not opened and prev_node_mention:
+                print('<span class="norm">', end='')
+            prev_node_mention = True if opened else False
             is_head = self._is_head(node)
             if is_head:
                 print('<b class="head">', end='')
@@ -412,6 +432,8 @@ def process_tree(self, tree):
             if not node.no_space_after:
                 print(' ', end='')
 
+        if not prev_node_mention:
+            print('</span>', end='')
         print('</p>')
 
     def _is_head(self, node):

From aaf215cbae6a5f3fab249c7cc0aa1397930303f9 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 19 Feb 2024 18:15:06 +0100
Subject: [PATCH 0883/1374] write.CorefHtml bugfix: load next document even if
 no scrollbar

---
 udapi/block/write/corefhtml.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index 5943d45b..7b2824d4 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -131,12 +131,15 @@
 var load_fail_reported = false;
 var loading_now = false;
 add_show_tree_button = function(index, el){ } // to be redefined later if show_trees=True
-$(window).scroll(function () {
+function load_more() {
   if (!loading_now && $(window).scrollTop() >= $(document).height() - $(window).height() - 42 && docs_loaded < all_docs) {
     docs_loaded += 1;
     load_doc(docs_loaded);
   }
-});
+}
+$(window).scroll(load_more);
+const resizeObserver = new ResizeObserver(entries =>load_more());
+resizeObserver.observe(document.body);
 '''
 
 SCRIPT_SHOWTREE = '''

From cd63f731d14ed35f1777cab7c203a1981db1605d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 19 Feb 2024 19:54:04 +0100
Subject: [PATCH 0884/1374] corefud.Stats max 50 rows per table, so pdflatex
 does not die

---
 udapi/block/corefud/stats.py | 29 ++++++++++++++++++-----------
 1 file changed, 18 insertions(+), 11 deletions(-)

diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
index 00e50882..e05815a6 100644
--- a/udapi/block/corefud/stats.py
+++ b/udapi/block/corefud/stats.py
@@ -7,7 +7,7 @@ class Stats(Block):
     def __init__(self, m_len_max=5, e_len_max=5, report_mentions=True, report_entities=True,
                  report_details=True, selected_upos='NOUN PRON PROPN DET ADJ VERB ADV NUM',
                  exclude_singletons=False, exclude_nonsingletons=False, style='human',
-                 per_doc=False, **kwargs):
+                 per_doc=False, max_rows_per_page=50, **kwargs):
         super().__init__(**kwargs)
         self.m_len_max = m_len_max
         self.e_len_max = e_len_max
@@ -20,7 +20,9 @@ def __init__(self, m_len_max=5, e_len_max=5, report_mentions=True, report_entiti
         if style not in 'tex tex-table tex-doc human'.split():
             raise ValueError(f'Unknown style {style}')
         self.per_doc = per_doc
+        self.max_rows_per_page = max_rows_per_page
         self._header_printed = False
+        self._lines_printed = None
 
         self.counter = Counter()
         self.mentions = 0
@@ -87,9 +89,9 @@ def after_process_document(self, doc):
             self.m_words = 0
 
     def process_end(self, skip=True, doc=None):
-        if not self._header_printed:
-            self._header_printed = True
+        if not self._lines_printed:
             self.print_header()
+            self._lines_printed = 0
         if self.per_doc:
             if skip:
                 self.print_footer()
@@ -98,6 +100,7 @@ def process_end(self, skip=True, doc=None):
                 print(f"{doc[0].trees[0].newdoc:15}", end='&' if self.style.startswith('tex') else '\n')
         elif self.style.startswith('tex-'):
             print(f"{self.counter['documents']:4} documents &")
+        self._lines_printed += 1
 
         mentions_nonzero = 1 if self.mentions == 0 else self.mentions
         entities_nonzero = 1 if self.entities == 0 else self.entities
@@ -139,17 +142,21 @@ def process_end(self, skip=True, doc=None):
                 print(f"{c[0]:>15} = {c[1].strip():>10}")
         if not self.per_doc:
             self.print_footer()
+        elif self._lines_printed > self.max_rows_per_page:
+            self.print_footer(False)
+            self._lines_printed = 0
 
     def print_header(self):
         if not self.style.startswith('tex-'):
             return
         if self.style == 'tex-doc':
-            print(r'\documentclass{standalone}')
-            print(r'\usepackage[utf8]{inputenc}\usepackage{booktabs}\usepackage{underscore}')
-            print(r'\title{Udapi coreference statistics}')
-            print(r'\begin{document}')
+            if self._lines_printed is None:
+                print(r'\documentclass[multi=mypage]{standalone}')
+                print(r'\usepackage[utf8]{inputenc}\usepackage{booktabs}\usepackage{underscore}')
+                print(r'\title{Udapi coreference statistics}')
+                print(r'\begin{document}')
         print(r'\def\MC#1#2{\multicolumn{#1}{c}{#2}}')
-        lines = [r'\begin{tabular}{@{}l ', " "*15, ("document" if self.per_doc else "dataset ") + " "*7, " "*15]
+        lines = [r'\begin{mypage}\begin{tabular}{@{}l ', " "*15, ("document" if self.per_doc else "dataset ") + " "*7, " "*15]
         if self.report_entities:
             lines[0] += "rrrr "
             lines[1] += r'& \MC{4}{entities}                 '
@@ -211,9 +218,9 @@ def print_header(self):
             lines[1] += r'}\cmidrule(l){' + f"{last_col+4}-{last_col+3+len(upos_list)}" + '}'
         print("\n".join(lines))
 
-    def print_footer(self):
+    def print_footer(self, end_doc=True):
         if not self.style.startswith('tex-'):
             return
-        print(r'\bottomrule\end{tabular}')
-        if self.style == 'tex-doc':
+        print(r'\bottomrule\end{tabular}\end{mypage}')
+        if self.style == 'tex-doc' and end_doc:
             print(r'\end{document}')

From 5eefdf38ae43dd00a3408f2608ea10b0eb033e62 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 24 Feb 2024 00:32:05 +0100
Subject: [PATCH 0885/1374] allow removing empty nodes, fix a bug in reordering
 empty nodes after remove()

---
 udapi/core/node.py            | 51 ++++++++++++++++++++++++-----------
 udapi/core/tests/test_node.py | 31 +++++++++++++++++++++
 2 files changed, 67 insertions(+), 15 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index ecb964f2..0e746c60 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -506,7 +506,7 @@ def is_empty():
         return False
 
     def remove(self, children=None):
-        """Delete this node and all its descendants.
+        """Delete this node (and all its descendants unlsess specified otherwise).
 
         Args:
         children: a string specifying what to do if the node has any children.
@@ -516,7 +516,8 @@ def remove(self, children=None):
             `rehang_warn` means to rehang and warn:-).
         """
         self._parent._children.remove(self)
-        empty_follows = None
+
+        # If there are any children, do the action specified in the "children" parameter.
         if children is not None and self._children:
             if children.startswith('rehang'):
                 for child in self._children:
@@ -524,16 +525,6 @@ def remove(self, children=None):
                 self._parent._children.extend(self._children)
                 self._parent._children.sort()
                 self._children.clear()
-            elif self._root.empty_nodes:
-                will_be_removed = self.descendants(add_self=1)
-                prev_nonempty = self._root
-                empty_follows = {}
-                for node in self._root.descendants_and_empty:
-                    if node.empty:
-                        empty_follows[node] = prev_nonempty
-                    elif node not in will_be_removed:
-                        prev_nonempty = node
-
             if children.endswith('warn'):
                 logging.warning('%s is being removed by remove(children=%s), '
                                 ' but it has (unexpected) children', self, children)
@@ -550,10 +541,27 @@ def remove(self, children=None):
             else:
                 for (new_ord, node) in enumerate(self._root._descendants[self._ord - 1:], self._ord):
                     node.ord = new_ord
+                last_ord = 0
                 for empty in self._root.empty_nodes:
-                    if empty > self:
-                        empty.ord = round(empty.ord - 1, 1)
+                    if empty._ord > self._ord:
+                        new_ord = round(empty._ord - 1, 1)
+                        if new_ord <= last_ord:
+                            new_ord = round(last_ord + 0.1, 1)
+                        empty.ord = new_ord
+                    last_ord = empty._ord
         else:
+            # Remember the position of empty nodes, so we can reorder them as well.
+            empty_follows = None
+            if self._root.empty_nodes:
+                will_be_removed = self if children and children.startswith('rehang') else self.descendants(add_self=1)
+                prev_nonempty = self._root
+                empty_follows = {}
+                for node in self._root.descendants_and_empty:
+                    if node.is_empty():
+                        empty_follows[node] = prev_nonempty
+                    elif node not in will_be_removed:
+                        prev_nonempty = node
+
             # TODO nodes_to_remove = self.unordered_descendants()
             # and mark all nodes as deleted, remove them from MWT and coref mentions
             self._root._descendants = sorted(self._root.unordered_descendants())
@@ -566,7 +574,7 @@ def remove(self, children=None):
                 last_ord = 0
                 for empty in self._root.empty_nodes:
                     prev_nonempty = empty_follows[empty]
-                    new_ord = round(prev_nonempty.ord + (empty.ord % 1), 1)
+                    new_ord = round(prev_nonempty._ord + (empty._ord % 1), 1)
                     while new_ord <= last_ord:
                         new_ord = round(new_ord + 0.1, 1)
                     last_ord, empty.ord = new_ord, new_ord
@@ -1047,6 +1055,19 @@ def shift(self, reference_node, after=0, move_subtree=0, reference_subtree=0):
         """Attempts at changing the word order of EmptyNode result in NotImplemented exception."""
         raise NotImplemented('Empty nodes cannot be re-order using shift* methods yet.')
 
+    def remove(self):
+        """Delete this empty node."""
+        to_reorder = [e for e in self._root.empty_nodes if e._ord > self._ord and e._ord < self.ord+1]
+        for empty in to_reorder:
+            empty._ord = round(empty._ord - 0.1, 1)
+        try:
+            self._root.empty_nodes.remove(self)
+        except ValueError:
+            return # self may be an already deleted node e.g. if n.remove() called twice
+        for n in self._root.empty_nodes + self._root._descendants:
+            if n._deps:
+                n._deps = {(deprel, parent) for deprel, parent in n._deps if parent != self}
+
 @functools.total_ordering
 class OrdTuple:
     """Class for the rare case of 9+ consecutive empty nodes, i.e. ords x.10, x.11 etc.
diff --git a/udapi/core/tests/test_node.py b/udapi/core/tests/test_node.py
index 381f5741..83348c67 100755
--- a/udapi/core/tests/test_node.py
+++ b/udapi/core/tests/test_node.py
@@ -214,5 +214,36 @@ def test_deps_setter(self):
 
         self.assertEqual(nodes[0].raw_deps, '2:test')
 
+    def test_empty_nodes(self):
+        """Test creation of empty nodes and how their ord is changed when removing nodes."""
+        root = Root()
+        for i in range(3):
+            root.create_child(form=f'node{i+1}')
+
+        n1, n2, n3 = root.descendants()
+        n3.parent = n2
+        e1 = n1.create_empty_child('dep', after=False, form='e1')
+        e2 = n1.create_empty_child('dep', after=False, form='e2')
+        e3 = n1.create_empty_child('dep', after=True, form='e3')
+        e4 = n1.create_empty_child('dep', after=True, form='e4')
+        e5 = n2.create_empty_child('dep', after=False, form='e5')
+        e6 = n1.create_empty_child('dep', after=True, form='e6')
+
+        self.assertEqual(root.empty_nodes, [e1, e2, e3, e4, e5, e6])
+        self.assertEqual(root.descendants_and_empty, [e1, e2, n1, e3, e4, e5, e6, n2, n3])
+        self.assertEqual([n.ord for n in root.descendants_and_empty], [0.1, 0.2, 1, 1.1, 1.2, 1.3, 1.4, 2, 3])
+        e5.remove()
+        self.assertEqual(root.descendants_and_empty, [e1, e2, n1, e3, e4, e6, n2, n3])
+        self.assertEqual([n.ord for n in root.descendants_and_empty], [0.1, 0.2, 1, 1.1, 1.2, 1.3, 2, 3])
+        n1.remove()
+        self.assertEqual(root.descendants_and_empty, [e1, e2, e3, e4, e6, n2, n3])
+        self.assertEqual([n.ord for n in root.descendants_and_empty], [0.1, 0.2, 0.3, 0.4, 0.5, 1, 2])
+        e7 = n3.create_empty_child('dep', after=True, form='e7')
+        self.assertEqual(root.descendants_and_empty, [e1, e2, e3, e4, e6, n2, n3, e7])
+        self.assertEqual([n.ord for n in root.descendants_and_empty], [0.1, 0.2, 0.3, 0.4, 0.5, 1, 2, 2.1])
+        n2.remove()
+        self.assertEqual(root.descendants_and_empty, [e1, e2, e3, e4, e6, e7])
+        self.assertEqual([n.ord for n in root.descendants_and_empty], [0.1, 0.2, 0.3, 0.4, 0.5, 0.6])
+
 if __name__ == "__main__":
     unittest.main()

From e0573b536c3850c4821c116c76474c9d3bf84b31 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 24 Feb 2024 11:22:27 +0100
Subject: [PATCH 0886/1374] write.CorefHtml bugfixes and allow locally-loaded
 js

We need to escape not only node IDs, but also entity IDs
(we cannot assume the standard e1, e2,... type of eid).
Also, let's add the "n" before IDs only when needed.
---
 udapi/block/write/corefhtml.py | 41 +++++++++++++++++++++++-----------
 1 file changed, 28 insertions(+), 13 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index 7b2824d4..067ab380 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -190,8 +190,10 @@
 
 class CorefHtml(BaseWriter):
 
-    def __init__(self, docs_dir='docs', show_trees=True, show_eid=False, show_etype=False, colors=7, rtl=None, **kwargs):
+    def __init__(self, docs_dir='docs', path_to_js='web',
+                 show_trees=True, show_eid=False, show_etype=False, colors=7, rtl=None, **kwargs):
         super().__init__(**kwargs)
+        self.path_to_js = path_to_js
         self.show_trees = show_trees
         self.show_eid = show_eid
         self.show_etype = show_etype
@@ -234,9 +236,18 @@ def process_document(self, doc):
             sent_id2doc[tree.sent_id] = doc_num
         # TODO: use sent_id2doc
 
-        print(HEADER)
-        if self.show_trees:
-            print('<script src="https://cdn.rawgit.com/ufal/js-treex-view/gh-pages/js-treex-view.js"></script>')
+        print('<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8">')
+        print('<title>Udapi CorefUD viewer</title>')
+        if self.path_to_js == 'web':
+            print('<script src="https://code.jquery.com/jquery-3.6.3.min.js"></script>')
+            print('<script src="https://cdnjs.cloudflare.com/ajax/libs/pako/2.1.0/pako.min.js"></script>')
+            if self.show_trees:
+                print('<script src="https://cdn.rawgit.com/ufal/js-treex-view/gh-pages/js-treex-view.js"></script>')
+        else:
+            print(f'<script src="{self.path_to_js}/jquery-3.6.3.min.js"></script>')
+            print(f'<script src="{self.path_to_js}/pako.min.js"></script>')
+            if self.show_trees:
+                print(f'<script src="{self.path_to_js}/js-treex-view.js"></script>')
         print('<style>' + CSS)
         for i, etype in enumerate(ETYPES):
             print(f'.{etype} {{background: hsl({int(i * 360/len(ETYPES))}, 80%, 85%);}}')
@@ -263,14 +274,14 @@ def process_document(self, doc):
                 entities_of_type[entity.etype] = count + 1
                 self._entity_colors[entity] = f'c{count % self.colors}'
             for idx, mention in enumerate(entity.mentions, 1):
-                self._mention_ids[mention] = f'{entity.eid}e{idx}'
+                self._mention_ids[mention] = f'{_dom_esc(entity.eid)}e{idx}'
 
         print('<div id="overview">')
         print('<table><thead><tr><th title="entity id">eid</th>'
               '<th title="number of mentions">#m</th>'
               '<th title="a word best representing the entity">word</th></tr></thead>\n<tbody>')
         for entity in doc.coref_entities:
-            print(f'<tr><td><a href="#{entity.eid}">{entity.eid}</a></td>'
+            print(f'<tr><td><a href="#{_dom_esc(entity.eid)}">{entity.eid}</a></td>'
                   f'<td>{len(entity.mentions)}</td>'
                   f'<td>{self._representative_word(entity)}</td></tr>')
         print('</tbody></table>')
@@ -332,7 +343,7 @@ def process_document(self, doc):
     def _start_subspan(self, subspan, crossing=False):
         m = subspan.mention
         e = m.entity
-        classes = f'{e.eid} {self._mention_ids[m]} {e.etype or "other"} m'
+        classes = f'{_dom_esc(e.eid)} {self._mention_ids[m]} {e.etype or "other"} m'
         title = f'eid={subspan.subspan_eid}\netype={e.etype}\nhead={m.head.form}'
         classes += f" {m.head.upos if m.head.upos in HTYPES else 'OTHER'}"
         title += f'\nhead-upos={m.head.upos}'
@@ -349,16 +360,16 @@ def _start_subspan(self, subspan, crossing=False):
             title += f'\n{m.other}'
         span_id = ''
         if (subspan.subspan_id == '' or subspan.subspan_id.startswith('[1/')) and e.mentions[0] == m:
-            span_id = f'id="{e.eid}" '
+            span_id = f'id="{_dom_esc(e.eid)}" '
         # The title should be always rendered left-to-right (e.g. "head=X", not "X=head"),
         # so for RTL languages, we need to use explicit dir="ltr" and insert a nested span with dir="rtl".
         if self.rtl:
             print(f'<span {span_id}class="{classes}" title="{title}" dir="ltr">'
-                  f'<span class="labels"><b class="eid">{subspan.subspan_eid}</b>'
+                  f'<span class="labels"><b class="eid">{_dom_esc(subspan.subspan_eid)}</b>'
                   f' <i class="etype">{e.etype}</i></span><span dir="rtl">', end='')
         else:
             print(f'<span {span_id}class="{classes}" title="{title}">'
-                  f'<span class="labels"><b class="eid">{subspan.subspan_eid}</b>'
+                  f'<span class="labels"><b class="eid">{_dom_esc(subspan.subspan_eid)}</b>'
                   f' <i class="etype">{e.etype}</i></span>', end='')
 
     def process_tree(self, tree):
@@ -449,12 +460,16 @@ def _is_head(self, node):
 # id needs to be a valid DOM querySelector
 # so it cannot contain [#./:] and maybe more,
 # so let's substitute all [^\w\d-] to be on the safe side.
-# DOM IDs cannot start with a digit, so prepend e.g. "n".
+# DOM IDs cannot start with a digit, so prepend e.g. "n" if needed.
+def _dom_esc(string):
+    if string[0].isdecimal():
+        string = 'n' + string
+    return re.sub(r'[^\w\d-]', '_', string)
+
 def _id(node):
     if node is None:
         return 'null'
-    return re.sub(r'[^\w\d-]', '_', f"n{node.address()}")
-
+    return _dom_esc(node.address())
 
 def _esc(string):
     if string is None:

From 2acf197bdce020f498b00bb8e76a33bf8b0cc8ca Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 29 Feb 2024 11:18:42 +0100
Subject: [PATCH 0887/1374] write.CorefHtml allow showing sent_id even if
 show_trees=False

---
 udapi/block/write/corefhtml.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/udapi/block/write/corefhtml.py b/udapi/block/write/corefhtml.py
index 067ab380..1d5d4716 100644
--- a/udapi/block/write/corefhtml.py
+++ b/udapi/block/write/corefhtml.py
@@ -130,7 +130,9 @@
 var docs_loaded = 1;
 var load_fail_reported = false;
 var loading_now = false;
-add_show_tree_button = function(index, el){ } // to be redefined later if show_trees=True
+add_show_tree_button = function(index, el){ // to be redefined later if show_trees=True
+  $(el).prepend('<span class="sent_id">🆔' + el.dataset.id + '</span>');
+}
 function load_more() {
   if (!loading_now && $(window).scrollTop() >= $(document).height() - $(window).height() - 42 && docs_loaded < all_docs) {
     docs_loaded += 1;
@@ -182,8 +184,6 @@
     })
   );
 }
-
-$("#doc1 .sentence").each(add_show_tree_button);
 '''
 
 WRITE_HTML = udapi.block.write.html.Html()
@@ -213,7 +213,7 @@ def __init__(self, docs_dir='docs', path_to_js='web',
     def _representative_word(self, entity):
         # return the first PROPN or NOUN. Or the most frequent one?
         heads = [m.head for m in entity.mentions]
-        lemma_or_form = lambda n: n.lemma if n.lemma else n.form
+        lemma_or_form = lambda n: n.lemma if n.lemma and n.lemma != '_' else n.form
         for upos in ('PROPN', 'NOUN'):
             nodes = [n for n in heads if n.upos == upos]
             if nodes:
@@ -292,7 +292,7 @@ def process_document(self, doc):
               f' <input id="show-eid" type="checkbox" {"checked" if self.show_eid else ""} onclick="$(\'.eid\').toggle(this.checked);"><label for="show-eid">eid</label><br>\n'
               f' <input id="show-etype" type="checkbox" {"checked" if self.show_etype else ""} onclick="$(\'.etype\').toggle(this.checked);"><label for="show-etype">etype</label><br>\n'
               ' <input id="show-sent_id" type="checkbox" onclick="$(\'.sent_id\').toggle(this.checked);"><label for="show-sent_id">sent_id</label><br>\n'
-              ' <input id="show-trees" type="checkbox" checked onclick="$(\'.showtree\').toggle(this.checked);"><label for="show-trees">trees</label><br>\n'
+              + (' <input id="show-trees" type="checkbox" checked onclick="$(\'.showtree\').toggle(this.checked);"><label for="show-trees">trees</label><br>\n' if self.show_trees else '') +
               ' <input id="show-color" type="checkbox" checked onclick="$(\'.m\').toggleClass(\'nocolor\',!this.checked);"><label for="show-color">colors</label><br>\n'
               ' <input id="show-boxes" type="checkbox" checked onclick="$(\'.m\').toggleClass(\'nobox\',!this.checked);"><label for="show-boxes">boxes</label></div><div>\n'
               ' <input id="show-norm" type="checkbox" checked onclick="$(\'.norm\').toggle(this.checked);"><label for="show-norm">non-mentions</label><br>\n'
@@ -337,6 +337,7 @@ def process_document(self, doc):
             finally:
                 sys.stdout = orig_stdout
             print(SCRIPT_SHOWTREE)
+        print('$("#doc1 .sentence").each(add_show_tree_button);')
         print('</script>')
         print('</div></body></html>')
 

From 3e1d36741dc48b659bf9b21d550341b740dc22e0 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 29 Feb 2024 11:20:40 +0100
Subject: [PATCH 0888/1374] bugfix in read.Conllu: read_trees() should return
 the trees

even if max_docs is used.
Also, None values should be excluded from the trees.
---
 udapi/block/read/conllu.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index a8e73375..bb76bfee 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -102,10 +102,11 @@ def read_trees(self):
                     if loaded_docs == self.max_docs:
                         return trees
                     loaded_docs += 1
-                trees.append(tree)
+                if tree:
+                    trees.append(tree)
             else:
                 lines.append(line)
-        return
+        return trees
 
     def read_tree(self):
         if self.filehandle is None:

From 26e55a700aa88b5df0ea700371304505b938e614 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 29 Feb 2024 11:22:47 +0100
Subject: [PATCH 0889/1374] transform.Flatten oneroot=1

to make the resulting trees pass the validate.py --level 2 tests
---
 udapi/block/transform/flatten.py | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/udapi/block/transform/flatten.py b/udapi/block/transform/flatten.py
index ded64fb1..d218ad27 100644
--- a/udapi/block/transform/flatten.py
+++ b/udapi/block/transform/flatten.py
@@ -4,6 +4,22 @@
 class Flatten(Block):
     """Apply `node.parent = node.root; node.deprel = 'root'` on all nodes."""
 
-    def process_node(self, node):
-        node.parent = node.root
-        node.deprel = 'root'
+    def __init__(self, oneroot=False, **kwargs):
+        """Args:
+        oneroot: only the first node will have deprel 'root'.
+            All other nodes will depend on the first node with deprel 'dep'.
+            This option makes the trees valid according to the validator.
+            (default=False)
+        """
+        super().__init__(**kwargs)
+        self.oneroot = oneroot
+
+    def process_tree(self, tree):
+        for node in tree.descendants:
+            node.parent = node.root
+            node.deprel = 'root'
+        if self.oneroot:
+            first = tree.descendants[0]
+            for node in tree.descendants[1:]:
+                node.parent = first
+                node.deprel = 'dep'

From 290edbc74ebbe01833fa91cb1476f88afc676a8e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 29 Feb 2024 11:23:34 +0100
Subject: [PATCH 0890/1374] skip None trees in the basereader

---
 udapi/block/util/splitsentence.py | 2 +-
 udapi/core/basereader.py          | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/util/splitsentence.py b/udapi/block/util/splitsentence.py
index 5a093a30..2886cd5d 100644
--- a/udapi/block/util/splitsentence.py
+++ b/udapi/block/util/splitsentence.py
@@ -1,5 +1,5 @@
 """
-my.SplitSentence will split a given sentence at a given token.
+Block util.SplitSentence will split a given sentence at a given token.
 """
 import logging
 from udapi.core.block import Block
diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 1ff8a4fd..9367f4c4 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -135,6 +135,8 @@ def try_fast_load(self, document):
 
             bundle, last_bundle_id = None, ''
             for root in trees:
+                if root is None:
+                    continue
                 if root.newdoc:
                     if self.max_docs and self._docs_loaded >= self.max_docs:
                         self.finished = True

From 2bc7cc02e02678a3aa8486bcb57fdb846513b45c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 29 Feb 2024 11:26:35 +0100
Subject: [PATCH 0891/1374] read.Conll2012 coreference format reader

---
 udapi/block/read/conll2012.py | 110 ++++++++++++++++++++++++++++++++++
 1 file changed, 110 insertions(+)
 create mode 100644 udapi/block/read/conll2012.py

diff --git a/udapi/block/read/conll2012.py b/udapi/block/read/conll2012.py
new file mode 100644
index 00000000..a60f52ca
--- /dev/null
+++ b/udapi/block/read/conll2012.py
@@ -0,0 +1,110 @@
+""""Conll2012 is a reader block for the coreference in CoNLL-2012 format.
+
+This implementation was tested on the LitBank files only, so far.
+LitBank does not use most of the columns, so the implementation
+should be improved to handle other types of CoNLL-2012 files.
+"""
+import json
+import logging
+import re
+
+import udapi.block.read.conllu
+from udapi.core.root import Root
+from udapi.core.node import Node
+
+#RE_BEGIN = re.compile(r'^#begin document \(([^)]+)\); part (\d+)')
+RE_BEGIN = re.compile(r'^#begin document \(([^)]+)\)')
+
+class Conll2012(udapi.block.read.conllu.Conllu):
+    """A reader of the Conll2012 files."""
+
+    def __init__(self, attributes='docname,_,ord,form,_,_,_,_,_,_,_,_,coref', **kwargs):
+        """Create the Conll2012 reader object.
+
+        Args:
+        attributes: comma-separated list of column names in the input files
+            (default='docname,_,ord,form,_,_,_,_,_,_,_,_,coref')
+            For ignoring a column, use "_" as its name.
+            Column "ord" marks the column with 0-based (unlike in CoNLL-U, which uses 1-based)
+            word-order number/index (usualy called ID).
+        """
+        super().__init__(**kwargs)
+        self.node_attributes = attributes.split(',')
+        self._docname = 'd'
+
+    def parse_comment_line(self, line, root):
+        if line.startswith("#end document"):
+            return
+        match = RE_BEGIN.match(line)
+        if match:
+            docname = match.group(1)
+            root.newdoc = docname
+            self._global_entity = 'eid-etype-head-other'
+            root.comment += '$GLOBAL.ENTITY\n'
+            self._docname = docname
+        else:
+            logging.warning(f"Unexpected comment line: {line}")
+
+    def parse_node_line(self, line, root, nodes):
+        fields = line.split('\t')
+        if len(fields) != len(self.node_attributes):
+            if self.strict:
+                raise RuntimeError('Wrong number of columns in %r' % line)
+            fields.extend(['_'] * (len(self.node_attributes) - len(fields)))
+
+        # This implementation is slower than in read.Conllu,
+        # but it allows for arbitrary columns
+        node = root.create_child()
+        for (n_attribute, attribute_name) in enumerate(self.node_attributes):
+            value = fields[n_attribute]
+            if attribute_name == 'docname':
+                if value != self._docname:
+                    logging.warning(f"Document name mismatch {value} != {self._docname}")
+
+            # convert the zero-based index to one-based
+            elif attribute_name == 'ord':
+                setattr(node, 'ord', int(value) + 1)
+
+            elif attribute_name == 'coref':
+                if value and value != '_':
+                    entities = value.split("|")
+                    modified_entities = []
+                    escaped_docname = self._docname.replace("-", "")
+                    for entity in entities:
+                        entity_num = entity.replace("(", "").replace(")","")
+                        modified_entity = f"{escaped_docname}_e{entity_num}--1"
+                        if entity.startswith("(") and entity.endswith(")"):
+                            modified_entity = "(" + modified_entity + ")"
+                        elif entity.startswith("("):
+                            modified_entity = "(" + modified_entity
+                        elif entity.endswith(")"):
+                            modified_entity = f"{escaped_docname}_e{entity_num}" + ")"
+
+                        # to avoid parentheses clashes, put the entities with ")" first
+                        if modified_entity.startswith("("):
+                            modified_entities.append(modified_entity)
+                        else:
+                            modified_entities.insert(0, modified_entity)
+                    node.misc['Entity'] = ''.join(modified_entities)
+
+            elif attribute_name == 'form' or (attribute_name != '_' and value != '_'):
+                setattr(node, attribute_name, value)
+        nodes.append(node)
+
+    def read_tree_from_lines(self, lines):
+        root = Root()
+        nodes = [root]
+        for line in lines:
+            if line == '':
+                pass
+            elif line[0] == '#':
+                self.parse_comment_line(line, root)
+            else:
+                self.parse_node_line(line, root, nodes)
+
+        # If no nodes were read from the filehandle (so only root remained in nodes),
+        # we return None as a sign of failure (end of file or more than one empty line).
+        if len(nodes) == 1:
+            return None
+
+        return root

From 39a65ab3ac754619bd2abe377726206bee53c3e5 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 29 Feb 2024 11:28:14 +0100
Subject: [PATCH 0892/1374] read.AddText for adding word-wrapped plain-text to
 existing trees

---
 udapi/block/read/addtext.py | 59 +++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 udapi/block/read/addtext.py

diff --git a/udapi/block/read/addtext.py b/udapi/block/read/addtext.py
new file mode 100644
index 00000000..040174be
--- /dev/null
+++ b/udapi/block/read/addtext.py
@@ -0,0 +1,59 @@
+"""read.AddText is a reader for adding word-wrapped plain-text to existing trees."""
+from udapi.core.basereader import BaseReader
+from udapi.core.root import Root
+import logging
+
+class AddText(BaseReader):
+    r"""A reader for plain-text files to be stored to existing trees.
+
+    For example LitBank conll files are segmented to sentences and tokenized,
+    but the SpacesAfter attributes are missing. We need to load the original
+    (raw) texts, which are not tokenized and not segmented, only word-wrapped
+    (to 70 characters per line).
+
+    Args:
+    add_newpar: add newpar CoNLL-U annotations on empty lines (and the beginning of file)
+    """
+    def __init__(self, zone='', add_newpar=True, **kwargs):
+        super().__init__(zone=zone, **kwargs)
+        self.add_newpar = add_newpar
+
+    @staticmethod
+    def is_multizone_reader():
+        """Can this reader read bundles which contain more zones?.
+
+        This implementation returns always False.
+        """
+        return False
+
+    def process_document(self, document):
+        filehandle = self.next_filehandle()
+        if filehandle is None:
+            self.finished = True
+            return
+        text = ''.join(self.filehandle.readlines())
+        i, end, was_newpar = 0, len(text), True
+        while i <= end and text[i].isspace():
+            i += 1
+
+        for bundle in document.bundles:
+            root = bundle.get_tree(zone=self.zone)
+            if self.add_newpar and was_newpar:
+                root.newpar = True
+                was_newpar = False
+            for node in root.token_descendants:
+                if text[i:i+len(node.form)] == node.form:
+                    i += len(node.form)
+                    if i > end or text[i].isspace():
+                        del node.misc['SpaceAfter']
+                        was_newpar = i+1 < end and text[i+1] == '\n' and text[i] == '\n'
+                        while i <= end and text[i].isspace():
+                            i += 1
+                    else:
+                        node.misc['SpaceAfter'] = 'No'
+                        was_newpar = False
+                else:
+                    logging.warning('Node %s does not match text "%s"', node, text[i:i+20])
+                    return
+            root.text = root.compute_text()
+        self.finished = not self.files.has_next_file()

From fe70c4181dec44bf55d17ea7dac676f18374f09a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 6 Mar 2024 23:03:23 +0100
Subject: [PATCH 0893/1374] add process_empty_node() method to Block and allow
 util.Mark empty=1

E.g. for highlighting empty nodes in a conllu file, we can now use
```
udapy -TM util.Mark node='node.is_empty()' empty=1 < in.conllu | less -R
```
---
 udapi/block/util/mark.py | 11 ++++++++++-
 udapi/core/block.py      | 18 ++++++++++++++----
 2 files changed, 24 insertions(+), 5 deletions(-)

diff --git a/udapi/block/util/mark.py b/udapi/block/util/mark.py
index 5ab50d2f..bcb4f894 100644
--- a/udapi/block/util/mark.py
+++ b/udapi/block/util/mark.py
@@ -15,7 +15,7 @@ class Mark(Block):
     udapy -TM util.Mark node='node.is_nonprojective()' < in | less -R
     """
 
-    def __init__(self, node, mark=1, mark_attr="Mark", add=True, print_stats=False, **kwargs):
+    def __init__(self, node, mark=1, mark_attr="Mark", add=True, print_stats=False, empty=False, **kwargs):
         """Create the Mark block object.
 
         Args:
@@ -27,6 +27,10 @@ def __init__(self, node, mark=1, mark_attr="Mark", add=True, print_stats=False,
         `mark_attr`: use this MISC attribute name instead of "Mark".
 
         `add`: should we keep existing Mark|ToDo|Bug? Default=True.
+
+        `print_stats`: print the total number of marked nodes to stdout at process_end
+
+        `empty`: apply the code also on empty nodes
         """
         super().__init__(**kwargs)
         self.mark = mark
@@ -35,6 +39,7 @@ def __init__(self, node, mark=1, mark_attr="Mark", add=True, print_stats=False,
         self.add = add
         self.print_stats = print_stats
         self._marked = 0
+        self.empty = empty
 
     def process_node(self, node):
         if eval(self.node):
@@ -45,6 +50,10 @@ def process_node(self, node):
             del node.misc['ToDo']
             del node.misc['Bug']
 
+    def process_empty_node(self, empty_node):
+        if self.empty:
+            self.process_node(empty_node)
+
     def process_end(self):
         if self.print_stats:
             print(f'util.Mark marked {self._marked} nodes')
diff --git a/udapi/core/block.py b/udapi/core/block.py
index fdcad9fa..d293df61 100644
--- a/udapi/core/block.py
+++ b/udapi/core/block.py
@@ -46,6 +46,11 @@ def process_node(self, _):
         """Process a UD node"""
         pass
 
+    @not_overridden
+    def process_empty_node(self, _):
+        """Process an empty node (in enhanced dependencies)"""
+        pass
+
     @not_overridden
     def process_tree(self, tree):
         """Process a UD tree"""
@@ -87,7 +92,8 @@ def process_document(self, document):
         p_bundle = not hasattr(self.process_bundle, 'is_not_overridden')
         p_tree = not hasattr(self.process_tree, 'is_not_overridden')
         p_node = not hasattr(self.process_node, 'is_not_overridden')
-        if not any((p_entity, p_mention, p_bundle, p_tree, p_node)):
+        p_empty_node = not hasattr(self.process_empty_node, 'is_not_overridden')
+        if not any((p_entity, p_mention, p_bundle, p_tree, p_node, p_empty_node)):
             raise Exception("No processing activity defined in block " + self.block_name())
 
         if p_entity or p_mention:
@@ -98,7 +104,7 @@ def process_document(self, document):
                     for mention in entity.mentions:
                         self.process_coref_mention(mention)
 
-        if p_bundle or p_tree or p_node:
+        if p_bundle or p_tree or p_node or p_empty_node:
             for bundle_no, bundle in enumerate(document.bundles, 1):
                 logging.debug(f'Block {self.block_name()} processing '
                               f'bundle #{bundle_no} (id={bundle.bundle_id})')
@@ -110,8 +116,12 @@ def process_document(self, document):
                             if p_tree:
                                 self.process_tree(tree)
                             else:
-                                for node in tree.descendants:
-                                    self.process_node(node)
+                                if p_node:
+                                    for node in tree.descendants:
+                                        self.process_node(node)
+                                if p_empty_node:
+                                    for empty_node in tree.empty_nodes:
+                                        self.process_empty_node(empty_node)
 
     @not_overridden
     def process_coref_entity(self, entity):

From e9ac88ed9456a6d9ae920a0a5c2c0d5debcd7b02 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 8 Mar 2024 16:24:10 +0100
Subject: [PATCH 0894/1374] Typo.

---
 udapi/block/corefud/fixinterleaved.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/corefud/fixinterleaved.py b/udapi/block/corefud/fixinterleaved.py
index 026b19f3..dfc18956 100644
--- a/udapi/block/corefud/fixinterleaved.py
+++ b/udapi/block/corefud/fixinterleaved.py
@@ -27,7 +27,7 @@ def process_tree(self, tree):
             if self.same_entity_only and mA.entity != mB.entity:
                 continue
 
-            # Fully nested spans are OK, expect for same-subspan
+            # Fully nested spans are OK, except for same-subspan.
             sA, sB = set(mA.words), set(mB.words)
             if (sA <= sB) or (sB <= sA):
                 if not self.nested_same_subspan:

From a43cd21f962a72e4f5e6f5dc40c5d35393669107 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 8 Mar 2024 17:02:42 +0100
Subject: [PATCH 0895/1374] Trying to avoid non-deterministic behavior.

---
 udapi/block/corefud/fixinterleaved.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/corefud/fixinterleaved.py b/udapi/block/corefud/fixinterleaved.py
index dfc18956..b4a42a43 100644
--- a/udapi/block/corefud/fixinterleaved.py
+++ b/udapi/block/corefud/fixinterleaved.py
@@ -63,7 +63,7 @@ def process_tree(self, tree):
             # By changing the mA.words, we could have created another error:
             # making the span same as another mention. Let's fix it.
             sA = set(mA.words)
-            for mC in mentions:
+            for mC in sorted(mentions):
                 if mC in deleted or mC is mA or mC is mB:
                     continue
                 if sA != set(mC.words):

From aeb067cbdb26348d54a27742c033ffeb2fe2c7f0 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 20 Mar 2024 10:42:12 +0100
Subject: [PATCH 0896/1374] corefud.Delete - delete coreference annotation and
 optionally also empty nodes

---
 udapi/block/corefud/delete.py | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 udapi/block/corefud/delete.py

diff --git a/udapi/block/corefud/delete.py b/udapi/block/corefud/delete.py
new file mode 100644
index 00000000..11498b72
--- /dev/null
+++ b/udapi/block/corefud/delete.py
@@ -0,0 +1,30 @@
+"""Delete coreference annotation (Entity|Bridge|SplitAnte) and optionally also empty nodes."""
+
+from udapi.core.block import Block
+import udapi.core.coref
+import logging
+
+class Delete(Block):
+
+    def __init__(self, empty=False, **kwargs):
+        super().__init__(**kwargs)
+        self.empty = empty
+
+    def process_document(self, doc):
+        # This block should work both with coreference loaded (deserialized) and not.
+        doc._eid_to_entity = None
+        for root in doc.trees:
+            if self.empty:
+                root.empty_nodes = []
+                for node in root.descendants:
+                    if node.raw_deps != '_':
+                        node.raw_deps = '|'.join(d for d in node.raw_deps.split('|') if not '.' in d)
+                        if node.raw_deps == '':
+                            node.raw_deps = '0:root'
+                    if '.' in node.misc['Functor']:
+                        del node.misc['Functor']
+
+            for node in root.descendants + root.empty_nodes:
+                node._mentions = []
+                for attr in ('Entity', 'Bridge', 'SplitAnte'):
+                    del node.misc[attr]

From cdb30d06fcb628f2cc9b6ddb6e41815d0820cb08 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 20 Mar 2024 11:31:36 +0100
Subject: [PATCH 0897/1374] There are functors with dot, so we need to check
 for dot only in the ord

---
 udapi/block/corefud/delete.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/corefud/delete.py b/udapi/block/corefud/delete.py
index 11498b72..31d71eca 100644
--- a/udapi/block/corefud/delete.py
+++ b/udapi/block/corefud/delete.py
@@ -21,7 +21,7 @@ def process_document(self, doc):
                         node.raw_deps = '|'.join(d for d in node.raw_deps.split('|') if not '.' in d)
                         if node.raw_deps == '':
                             node.raw_deps = '0:root'
-                    if '.' in node.misc['Functor']:
+                    if '.' in node.misc['Functor'].split(':')[0]:
                         del node.misc['Functor']
 
             for node in root.descendants + root.empty_nodes:

From 4dea13633720bd69aae582211572b22a1f4af959 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 20 Mar 2024 15:49:39 +0100
Subject: [PATCH 0898/1374] New block to fix UD: If advmod is used with UPOS
 that excludes advmod, change advmod to something else (i.e., the UPOS is
 correct and the DEPREL is not).

---
 udapi/block/ud/fixadvmodbyupos.py | 38 +++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 udapi/block/ud/fixadvmodbyupos.py

diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
new file mode 100644
index 00000000..781e7586
--- /dev/null
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -0,0 +1,38 @@
+"""
+Block ud.FixAdvmodByUpos will change the dependency relation from advmod to something else
+if the UPOS is not ADV.
+"""
+from udapi.core.block import Block
+
+
+class FixAdvmodByUpos(Block):
+    """
+    Make sure advmod is not used with UPOS it should not be used with.
+    """
+
+    def process_node(self, node):
+        if node.udeprel == 'advmod':
+            if node.upos in ['NOUN', 'PROPN', 'PRON', 'DET', 'NUM']:
+                node.deprel = 'obl'
+            elif node.upos == 'VERB':
+                node.deprel = 'advcl'
+            elif node.upos == 'AUX':
+                node.deprel = 'aux'
+            elif node.upos in ['ADP', 'SCONJ']:
+                if node.parent.upos == 'VERB':
+                    node.deprel = 'mark'
+                else:
+                    node.deprel = 'case'
+            elif node.upos == 'CCONJ':
+                node.deprel = 'cc'
+            elif node.upos == 'INTJ':
+                node.deprel = 'discourse'
+            else:
+                node.deprel = 'dep'
+        ###!!! The following are not advmod so they should probably have their own block or this block should have a different name.
+        elif node.udeprel == 'expl':
+            if node.upos == 'AUX':
+                node.deprel = 'aux'
+        elif node.udeprel == 'mark':
+            if node.upos == 'PRON':
+                node.deprel = 'nsubj' # it could be also obj, iobj, obl or nmod; just guessing what might be more probable

From 19fe22939699b383355b0c0dc2764f8c5792f39d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 20 Mar 2024 16:03:50 +0100
Subject: [PATCH 0899/1374] A dummy way of getting rid of multiple subjects.

---
 udapi/block/ud/fixmultisubjects.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 udapi/block/ud/fixmultisubjects.py

diff --git a/udapi/block/ud/fixmultisubjects.py b/udapi/block/ud/fixmultisubjects.py
new file mode 100644
index 00000000..f8aeca06
--- /dev/null
+++ b/udapi/block/ud/fixmultisubjects.py
@@ -0,0 +1,23 @@
+"""
+Block ud.FixMultiSubjects will ensure that no node has more than one subject child (except those
+marked as :outer).
+"""
+import re
+from udapi.core.block import Block
+
+
+class FixMultiSubjects(Block):
+    """
+    Make sure there is at most one subject that is not marked as :outer.
+    """
+
+    def process_node(self, node):
+        subjects = [x for x in node.children if re.match(r"^[nc]subj(:|$)", x.deprel) and not re.search(r":outer$", x.deprel)]
+        # For the moment, we take the dummiest approach possible: The first subject survives and all others are forced to a different deprel.
+        if len(subjects) > 1:
+            subjects = subjects[1:]
+            for s in subjects:
+                if re.match(r"^n", s.deprel):
+                    s.deprel = 'obl'
+                else:
+                    s.deprel = 'advcl'

From c03419c457b5e57dd5480fb8f11f4a816166d41f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 7 Apr 2024 19:55:36 +0200
Subject: [PATCH 0900/1374] Blocks to work with PARSEME MWE corpora.

---
 udapi/block/mwe/normalize.py    | 68 ++++++++++++++++++++++++++++++
 udapi/block/mwe/possessives.py  | 74 +++++++++++++++++++++++++++++++++
 udapi/block/mwe/tosubdeprels.py | 62 +++++++++++++++++++++++++++
 3 files changed, 204 insertions(+)
 create mode 100644 udapi/block/mwe/normalize.py
 create mode 100644 udapi/block/mwe/possessives.py
 create mode 100644 udapi/block/mwe/tosubdeprels.py

diff --git a/udapi/block/mwe/normalize.py b/udapi/block/mwe/normalize.py
new file mode 100644
index 00000000..e7ebf24f
--- /dev/null
+++ b/udapi/block/mwe/normalize.py
@@ -0,0 +1,68 @@
+"""Block that takes PARSEME-like annotation of multiword expressions from MISC
+   and normalizes it so that the type is always annotated at the first word of
+   the expression."""
+from udapi.core.block import Block
+import logging
+import re
+
+class Normalize(Block):
+
+    def collect_mwes(self, root):
+        """
+        Collects annotations of multiword expressions from MISC of the nodes.
+        The expected annotation is in the style of Parseme (see
+        https://gitlab.com/parseme/corpora/-/wikis/home#annotation and download
+        the data from http://hdl.handle.net/11372/LRT-5124), except that there
+        are only ten columns and the annotation from the eleventh column is
+        copied to the tenth (MISC) as the attribute Mwe (e.g., Mwe=1:LVC.cause).
+        """
+        nodes = root.descendants
+        mwes = {} # for each mwe id, its type and list of node ids
+        mwes_by_nodes = {} # for each node id, a list of mwe ids
+        for n in nodes:
+            mwes_by_nodes[n.ord] = []
+            miscmwe = n.misc['Mwe']
+            if miscmwe:
+                # A node may belong to multiple multiword expressions.
+                miscmwes = miscmwe.split(';')
+                for m in miscmwes:
+                    # Either it is NUMBER:TYPE, or just NUMBER.
+                    # Number identifies this MWE among all MWEs in the sentence.
+                    # Type is a main uppercase string (VID, LVC etc.), optionally
+                    # followed by a subtype ('LVC.cause').
+                    # See https://gitlab.com/parseme/corpora/-/wikis/home
+                    match = re.match(r"^([0-9]+)(?::([A-Za-z\.]+))?$", m)
+                    if match:
+                        number = match.group(1)
+                        type = match.group(2)
+                        if not number in mwes:
+                            mwes[number] = {'nodes': [], 'type': ''}
+                        if type:
+                            mwes[number]['type'] = type
+                        mwes[number]['nodes'].append(n.ord)
+                        mwes_by_nodes[n.ord].append(number)
+                    else:
+                        logging.warning("Cannot parse Mwe=%s" % m)
+        return (mwes, mwes_by_nodes)
+
+    def process_tree(self, root):
+        """
+        Collects annotations of multiword expressions from MISC of the nodes.
+        Then saves them back but makes sure that the type is annotated at the
+        first word of the expression (as opposed to the syntactic head or to
+        any other word).
+        """
+        (mwes, mwes_by_nodes) = self.collect_mwes(root)
+        nodes = root.descendants
+        for n in nodes:
+            # Erase the previous MWE annotations so we can start from scratch.
+            n.misc['Mwe'] = ''
+            # There may be multiple MWEs this node is member of.
+            annotations = []
+            for m in mwes_by_nodes[n.ord]:
+                if n.ord == mwes[m]['nodes'][0]:
+                    annotations.append("%s:%s" % (m, mwes[m]['type']))
+                else:
+                    annotations.append(m)
+            if annotations:
+                n.misc['Mwe'] = ';'.join(annotations)
diff --git a/udapi/block/mwe/possessives.py b/udapi/block/mwe/possessives.py
new file mode 100644
index 00000000..0849a210
--- /dev/null
+++ b/udapi/block/mwe/possessives.py
@@ -0,0 +1,74 @@
+"""Block that takes PARSEME-like annotation of multiword expressions from MISC,
+   looks for dependent possessive pronouns and reports how they are treated."""
+from udapi.core.block import Block
+import logging
+import re
+
+class Possessives(Block):
+
+    def collect_mwes(self, root):
+        """
+        Collects annotations of multiword expressions from MISC of the nodes.
+        The expected annotation is in the style of Parseme (see
+        https://gitlab.com/parseme/corpora/-/wikis/home#annotation and download
+        the data from http://hdl.handle.net/11372/LRT-5124), except that there
+        are only ten columns and the annotation from the eleventh column is
+        copied to the tenth (MISC) as the attribute Mwe (e.g., Mwe=1:LVC.cause).
+        """
+        nodes = root.descendants
+        mwes = {} # for each mwe id, its type and list of node ids
+        mwes_by_nodes = {} # for each node id, a list of mwe ids
+        for n in nodes:
+            mwes_by_nodes[n.ord] = []
+            miscmwe = n.misc['Mwe']
+            if miscmwe:
+                # A node may belong to multiple multiword expressions.
+                miscmwes = miscmwe.split(';')
+                for m in miscmwes:
+                    # Either it is NUMBER:TYPE, or just NUMBER.
+                    # Number identifies this MWE among all MWEs in the sentence.
+                    # Type is a main uppercase string (VID, LVC etc.), optionally
+                    # followed by a subtype ('LVC.cause').
+                    # See https://gitlab.com/parseme/corpora/-/wikis/home
+                    match = re.match(r"^([0-9]+)(?::([A-Za-z\.]+))?$", m)
+                    if match:
+                        number = match.group(1)
+                        type = match.group(2)
+                        if not number in mwes:
+                            mwes[number] = {'nodes': [], 'type': ''}
+                        if type:
+                            mwes[number]['type'] = type
+                        mwes[number]['nodes'].append(n.ord)
+                        mwes_by_nodes[n.ord].append(number)
+                    else:
+                        logging.warning("Cannot parse Mwe=%s" % m)
+        return (mwes, mwes_by_nodes)
+
+    def process_tree(self, root):
+        """
+        Collects annotations of multiword expressions from MISC of the nodes.
+        Then surveys the possessive pronouns.
+        """
+        (mwes, mwes_by_nodes) = self.collect_mwes(root)
+        nodes = root.descendants
+        for m in mwes:
+            mwenodes = [x for x in nodes if m in mwes_by_nodes[x.ord]]
+            mweheads = [x for x in mwenodes if not x.parent in mwenodes]
+            mwedescendantset = set()
+            for x in mweheads:
+                mwedescendantset = mwedescendantset.union(set(x.descendants))
+            mwedescendants = list(sorted(mwedescendantset))
+            # Is there a possessive pronoun?
+            possprons = [x for x in mwedescendants if x.upos == 'PRON' and x.feats['Poss'] == 'Yes']
+            inpp = [x for x in possprons if m in mwes_by_nodes[x.ord]]
+            outpp = [x for x in possprons if not m in mwes_by_nodes[x.ord]]
+            observation = ''
+            if inpp and outpp:
+                observation = 'both'
+            elif inpp:
+                observation = 'in'
+            elif outpp:
+                observation = 'out'
+            if observation:
+                expression = ' '.join([x.form if m in mwes_by_nodes[x.ord] else '('+x.form+')' for x in mwedescendants])
+                print(observation + ': ' + expression)
diff --git a/udapi/block/mwe/tosubdeprels.py b/udapi/block/mwe/tosubdeprels.py
new file mode 100644
index 00000000..3682c0c7
--- /dev/null
+++ b/udapi/block/mwe/tosubdeprels.py
@@ -0,0 +1,62 @@
+"""Block that takes PARSEME-like annotation of multiword expressions from MISC
+   and projects it to subtypes of dependency relation labels. The motivation is
+   that a parser could learn to predict the multiword expressions."""
+from udapi.core.block import Block
+import logging
+import re
+
+class ToSubDeprels(Block):
+
+    def collect_mwes(self, root):
+        """
+        Collects annotations of multiword expressions from MISC of the nodes.
+        The expected annotation is in the style of Parseme (see
+        https://gitlab.com/parseme/corpora/-/wikis/home#annotation and download
+        the data from http://hdl.handle.net/11372/LRT-5124), except that there
+        are only ten columns and the annotation from the eleventh column is
+        copied to the tenth (MISC) as the attribute Mwe (e.g., Mwe=1:LVC.cause).
+        """
+        nodes = root.descendants
+        mwes = {} # for each mwe id, its type and list of node ids
+        mwes_by_nodes = {} # for each node id, a list of mwe ids
+        for n in nodes:
+            mwes_by_nodes[n.ord] = []
+            miscmwe = n.misc['Mwe']
+            if miscmwe:
+                # A node may belong to multiple multiword expressions.
+                miscmwes = miscmwe.split(';')
+                for m in miscmwes:
+                    # Either it is NUMBER:TYPE, or just NUMBER.
+                    # Number identifies this MWE among all MWEs in the sentence.
+                    # Type is a main uppercase string (VID, LVC etc.), optionally
+                    # followed by a subtype ('LVC.cause').
+                    # See https://gitlab.com/parseme/corpora/-/wikis/home
+                    match = re.match(r"^([0-9]+)(?::([A-Za-z\.]+))?$", m)
+                    if match:
+                        number = match.group(1)
+                        type = match.group(2)
+                        if not number in mwes:
+                            mwes[number] = {'nodes': [], 'type': ''}
+                        if type:
+                            mwes[number]['type'] = type
+                        mwes[number]['nodes'].append(n.ord)
+                        mwes_by_nodes[n.ord].append(number)
+                    else:
+                        logging.warning("Cannot parse Mwe=%s" % m)
+        return (mwes, mwes_by_nodes)
+
+    def process_tree(self, root):
+        """
+        Collects annotations of multiword expressions from MISC of the nodes.
+        Then saves the type of the MWE as a subtype of the deprels inside.
+        """
+        nodes = root.descendants
+        (mwes, mwes_by_nodes) = self.collect_mwes(root)
+        # Now we hopefully know the type of every multiword expression in the sentence.
+        for n in nodes:
+            if mwes_by_nodes[n.ord]:
+                for m in mwes_by_nodes[n.ord]:
+                    type = re.sub(r"\.", '', mwes[m]['type'].lower())
+                    # Add the MWE type to the DEPREL if the parent is also in the same MWE.
+                    if n.parent.ord > 0 and m in mwes_by_nodes[n.parent.ord]:
+                        n.deprel += ':' + type

From 60292602a96471bbb014fa847b83f7c5647a572b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 12 Apr 2024 14:43:38 +0200
Subject: [PATCH 0901/1374] Punct-child is now tested by the validator; the
 remaining ones should not be penalized.

Legitimate:
- If the sentence contains only punctuation.
- If a punctuation symbol is enclosed in paired punctuation symbols (such as "(!)").
---
 udapi/block/ud/markbugs.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index a12ea0b9..2204eb4f 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -139,10 +139,6 @@ def process_node(self, node):
         if len(object_children) > 1:
             self.log(node, 'multi-obj', 'More than one obj|ccomp child')
 
-        # In addition to http://universaldependencies.org/svalidation.html
-        if parent.udeprel == 'punct':
-            self.log(node, 'punct-child', 'parent.deprel=punct')
-
         # See http://universaldependencies.org/u/overview/syntax.html#the-status-of-function-words
         # TODO: Promotion by Head Elision: It is difficult to detect this exception.
         #       So far, I have just excluded "det" from the forbidded parent.deprel set

From f2987e60e746417a16a1142366cd1ea493007a5b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michal=20Nov=C3=A1k?= <michnov@users.noreply.github.com>
Date: Mon, 15 Apr 2024 18:28:29 +0200
Subject: [PATCH 0902/1374] Recursively searching for non-empty ancestors of
 enhanced dependencies with empty parents (#123)

* deps to empty tokens must be recursively redirected to the non-empty ancestors

* propagate to non-empty ancestors only if the root is unreachable otherwise
---
 udapi/block/corefud/delete.py | 60 ++++++++++++++++++++++++++++++++---
 1 file changed, 55 insertions(+), 5 deletions(-)

diff --git a/udapi/block/corefud/delete.py b/udapi/block/corefud/delete.py
index 31d71eca..6a4e1388 100644
--- a/udapi/block/corefud/delete.py
+++ b/udapi/block/corefud/delete.py
@@ -10,19 +10,69 @@ def __init__(self, empty=False, **kwargs):
         super().__init__(**kwargs)
         self.empty = empty
 
+    def is_root_reachable_by_deps(self, node, parents_to_ignore=None):
+        """ Check if the root node is reachable from node, possibly after deleting the parents_to_ignore nodes.
+        """
+        stack = [(node, [])]
+        while stack:
+            proc_node, path = stack.pop()
+            # root is reachable
+            if proc_node == node.root:
+                break
+            # path forms a cycle, the root cannot be reached through this branch
+            if proc_node in path:
+                continue
+            for dep in proc_node.deps:
+                # the root cannot be reached through ignored nodes
+                if dep['parent'] in parents_to_ignore:
+                    continue
+                # process the parent recursively
+                stack.append((dep['parent'], path + [proc_node]))
+        else:
+            return False
+        return True
+
+    def _deps_ignore_nodes(self, node, parents_to_ignore):
+        """ Retrieve deps from the node, recursively ignoring specified parents.
+        """
+        newdeps = []
+        stack = [(node, [])]
+        while stack:
+            proc_node, skipped_nodes = stack.pop()
+            # if there is a cycle of skipped nodes, ground the subtree to the root
+            if proc_node in skipped_nodes:
+                newdeps.append({'parent': node.root, 'deprel': 'root'})
+                continue
+            for dep in proc_node.deps:
+                # keep deps with a parent that shouldn't be ignored
+                if not dep['parent'] in parents_to_ignore:
+                    newdeps.append(dep)
+                    continue
+                # process the ignored parent recursively
+                stack.append((dep['parent'], skipped_nodes + [proc_node]))
+        return newdeps
+
     def process_document(self, doc):
         # This block should work both with coreference loaded (deserialized) and not.
         doc._eid_to_entity = None
         for root in doc.trees:
             if self.empty:
-                root.empty_nodes = []
                 for node in root.descendants:
-                    if node.raw_deps != '_':
-                        node.raw_deps = '|'.join(d for d in node.raw_deps.split('|') if not '.' in d)
-                        if node.raw_deps == '':
-                            node.raw_deps = '0:root'
+                    # process only the nodes dependent on empty nodes
+                    if not '.' in node.raw_deps:
+                        continue
+                    # just remove empty parents if the root remains reachable
+                    if self.is_root_reachable_by_deps(node, root.empty_nodes):
+                        node.deps = [dep for dep in node.deps if not dep['parent'] in root.empty_nodes]
+                    # otherwise propagate to non-empty ancestors
+                    else:
+                        newdeps = self._deps_ignore_nodes(node, root.empty_nodes)
+                        newdeps_sorted = sorted(set((dep['parent'].ord, dep['deprel']) for dep in newdeps))
+                        node.raw_deps = '|'.join(f"{p}:{r}" for p, r in newdeps_sorted)
+
                     if '.' in node.misc['Functor'].split(':')[0]:
                         del node.misc['Functor']
+                root.empty_nodes = []
 
             for node in root.descendants + root.empty_nodes:
                 node._mentions = []

From ea33c78c5e5451b817866b4fc7cd9ed88c65a6b8 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 15 Apr 2024 19:24:17 +0200
Subject: [PATCH 0903/1374] corefud.Delete misc=1

parameters (coref|empty|misc) turn on/off the deletion
of the respective parts of CoNLL-U.
---
 udapi/block/corefud/delete.py | 25 +++++++++++++++++++------
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/udapi/block/corefud/delete.py b/udapi/block/corefud/delete.py
index 6a4e1388..4e68e8dd 100644
--- a/udapi/block/corefud/delete.py
+++ b/udapi/block/corefud/delete.py
@@ -6,9 +6,16 @@
 
 class Delete(Block):
 
-    def __init__(self, empty=False, **kwargs):
+    def __init__(self, coref=True, empty=False, misc=False, **kwargs):
+        """Args:
+        coref: delete coreference attributes in MISC, i.e (Entity|Bridge|SplitAnte)
+        empty: delete all empty nodes and references to them (from DEPS and MISC[Functor])
+        misc: delete all attributes in MISC except for SpaceAfter
+        """
         super().__init__(**kwargs)
+        self.coref = coref
         self.empty = empty
+        self.misc = misc
 
     def is_root_reachable_by_deps(self, node, parents_to_ignore=None):
         """ Check if the root node is reachable from node, possibly after deleting the parents_to_ignore nodes.
@@ -54,7 +61,8 @@ def _deps_ignore_nodes(self, node, parents_to_ignore):
 
     def process_document(self, doc):
         # This block should work both with coreference loaded (deserialized) and not.
-        doc._eid_to_entity = None
+        if self.coref:
+            doc._eid_to_entity = None
         for root in doc.trees:
             if self.empty:
                 for node in root.descendants:
@@ -74,7 +82,12 @@ def process_document(self, doc):
                         del node.misc['Functor']
                 root.empty_nodes = []
 
-            for node in root.descendants + root.empty_nodes:
-                node._mentions = []
-                for attr in ('Entity', 'Bridge', 'SplitAnte'):
-                    del node.misc[attr]
+            if self.coref or self.misc:
+                for node in root.descendants + root.empty_nodes:
+                    if self.misc:
+                        node.misc = 'SpaceAfter=No' if node.no_space_after else None
+                    if self.coref:
+                        node._mentions = []
+                        if not self.misc:
+                            for attr in ('Entity', 'Bridge', 'SplitAnte'):
+                                del node.misc[attr]

From 84720385395843d29c26e210e7cfcb2805ad8901 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 16 Apr 2024 22:28:46 +0200
Subject: [PATCH 0904/1374] corefud.SingleParent: keep only the highest
 enhanced parent of empty nodes

for the purpose of training the predictor of zeros (by Milan Straka)
for the CRAC24 shared task.
---
 udapi/block/corefud/singleparent.py | 47 +++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 udapi/block/corefud/singleparent.py

diff --git a/udapi/block/corefud/singleparent.py b/udapi/block/corefud/singleparent.py
new file mode 100644
index 00000000..ee9b1948
--- /dev/null
+++ b/udapi/block/corefud/singleparent.py
@@ -0,0 +1,47 @@
+"""If an empty node has multiple (enhanced-deps) parents, only the highest one is kept."""
+from udapi.core.block import Block
+from collections import Counter
+from udapi.core.node import find_minimal_common_treelet
+import logging
+
+class SingleParent(Block):
+
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+        self._reasons = Counter()
+
+    def process_tree(self, tree):
+        for empty in tree.empty_nodes:
+            self._reasons['_empty'] += 1
+            if len(empty.deps) > 1:
+                self._reasons['_more-parents'] += 1
+                parents = [d['parent'] for d in empty.deps]
+                nonempty_parents = [p for p in parents if not p.is_empty()]
+                if len(nonempty_parents) != len(parents):
+                    self._reasons['empty-parent'] += 1
+                    #empty.misc['Mark'] = f"empty-parent:{empty.deps}"
+                    logging.warning(f"Empty node {empty} has an empty parent.")
+                if not nonempty_parents:
+                    empty.deps = []
+                    self._reasons['no-nonempty-parent'] += 1
+                    continue
+                (highest, added_nodes) = find_minimal_common_treelet(*nonempty_parents)
+                if highest in nonempty_parents:
+                    self._reasons['one-governs'] += 1
+                    empty.deps = [d for d in empty.deps if d['parent'] is highest]
+                    continue
+                nonempty_parents.sort(key=lambda n:n._get_attr('depth'))
+                if len(nonempty_parents)>1 and nonempty_parents[0]._get_attr('depth') == nonempty_parents[0]._get_attr('depth'):
+                    self._reasons['same-depth'] += 1
+                    #empty.misc['Mark'] = f"same-depth:{empty.deps}"
+                else:
+                    self._reasons['one-highest'] += 1
+                    #empty.misc['Mark'] = f"one-highest:{empty.deps}"
+                empty.deps = [d for d in empty.deps if d['parent'] is nonempty_parents[0]]
+
+    def after_process_document(self, document):
+        message = "\n"
+        for k, v in self._reasons.most_common():
+            message += f"{k}={v}\n"
+        #document.meta["bugs"] = message
+        logging.info(message)

From 370175894f5d0f1657ae8e9c63c12fab3e49a436 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 09:25:54 +0200
Subject: [PATCH 0905/1374] FixEdeprels: Cloned Lithuanian from Czech.

---
 udapi/block/ud/lt/fixedeprels.py | 528 +++++++++++++++++++++++++++++++
 1 file changed, 528 insertions(+)
 create mode 100644 udapi/block/ud/lt/fixedeprels.py

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
new file mode 100644
index 00000000..bf7873f0
--- /dev/null
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -0,0 +1,528 @@
+"""Block to fix case-enhanced dependency relations in Lithuanian."""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixEdeprels(Block):
+
+    # Sometimes there are multiple layers of case marking and only the outermost
+    # layer should be reflected in the relation. For example, the semblative 'jako'
+    # is used with the same case (preposition + morphology) as the nominal that
+    # is being compared ('jako_v:loc' etc.) We do not want to multiply the relations
+    # by all the inner cases.
+    # The list in the value contains exceptions that should be left intact.
+    outermost = {
+        'ač':      [],
+        'ačkoli':  [], # 'ačkoliv' se převede na 'ačkoli' dole
+        'byť':     [],
+        'i_když':  [],
+        'jak':     [],
+        'jakkoli': [], # 'jakkoliv' se převede na 'jakkoli' dole
+        'jako':    [],
+        'jakoby':  ['jakoby_pod:ins'], # these instances in FicTree should be spelled 'jako by'
+        'než':     ['než_aby'],
+        'protože': [],
+        'takže':   [],
+        'třebaže': []
+    }
+
+    # Secondary prepositions sometimes have the lemma of the original part of
+    # speech. We want the grammaticalized form instead. List even those that
+    # will have the same lexical form, as we also want to check the morphological
+    # case. And include all other prepositions that have unambiguous morphological
+    # case, even if they are not secondary.
+    unambiguous = {
+        'abi':              'aby',
+        'aby_na':           'na:loc',
+        'ačkoliv':          'ačkoli',
+        'ať':               'ať', # remove morphological case
+        'ať_forma':         'formou:gen',
+        'ať_v':             'v:loc',
+        'ať_z':             'z:gen',
+        'ať_z_strana':      'ze_strany:gen',
+        'až_do':            'do:gen',
+        'až_o':             'o:acc',
+        'během':            'během:gen',
+        'bez':              'bez:gen',
+        'bez_ohled_na':     'bez_ohledu_na:acc',
+        'bez_zřetel_k':     'bez_zřetele_k:dat',
+        'bez_zřetel_na':    'bez_zřetele_na:acc',
+        'blíž':             'blízko:dat',
+        'cesta':            'cestou:gen',
+        'daleko':           'nedaleko:gen',
+        'daleko_od':        'od:gen',
+        'dík':              'díky:dat',
+        'díky':             'díky:dat',
+        'dle':              'dle:gen',
+        'do':               'do:gen',
+        'do_k':             'k:dat',
+        'do_oblast':        'do_oblasti:gen',
+        'do_rozpor_s':      'do_rozporu_s:ins',
+        'do_soulad_s':      'do_souladu_s:ins',
+        'forma':            'formou:gen',
+        'i_když':           'i_když', # remove morphological case
+        'jak_aby':          'jak',
+        'jak_ad':           'jak',
+        'jakkoliv':         'jakkoli',
+        'jako':             'jako', # remove morphological case
+        'jako_kupříkladu':  'jako',
+        'jakoby':           'jako',
+        'jakoby_pod':       'pod:ins',
+        'jelikož_do':       'jelikož',
+        'jestli_že':        'jestliže',
+        'k':                'k:dat',
+        'k_konec':          'ke_konci:gen',
+        'kdykoliv':         'kdykoli',
+        'kol':              'kolem:gen',
+        'kolem':            'kolem:gen',
+        'konec':            'koncem:gen',
+        'krom':             'kromě:gen',
+        'kromě':            'kromě:gen',
+        'liž':              'li',
+        'mezi_uvnitř':      'uvnitř:gen',
+        'na_báze':          'na_bázi:gen',
+        'na_čelo':          'na_čele:gen',
+        'na_mimo':          'na:loc', # na kurtě i mimo něj
+        'na_než':           'na:acc', # na víc než čtyři a půl kilometru
+        'na_od':            'na_rozdíl_od:gen',
+        'na_podklad':       'na_podkladě:gen',
+        'na_rozdíl_od':     'na_rozdíl_od:gen',
+        'na_újma':          'gen', # 'nebude na újmu' is a multi-word predicate but 'na újmu' is probably not used as an independent oblique modifier
+        'na_úroveň':        'na_úrovni:gen',
+        'na_úsek':          'na_úseku:gen',
+        'na_základ':        'na_základě:gen',
+        'na_základna':      'na_základně:gen',
+        'na_závěr':         'na_závěr:gen',
+        'namísto':          'namísto:gen',
+        'namísto_do':       'do:gen',
+        'narozdíl_od':      'na_rozdíl_od:gen',
+        'následek':         'následkem:gen',
+        'navzdory':         'navzdory:dat',
+        'nedaleko':         'nedaleko:gen',
+        'než':              'než', # remove morphological case
+        'nežli':            'nežli', # remove morphological case
+        'o_jako':           'jako',
+        'o_o':              'o:acc',
+        'od':               'od:gen',
+        'ohledně':          'ohledně:gen',
+        'okolo':            'okolo:gen',
+        'oproti':           'oproti:dat',
+        'po_v':             'po:loc',
+        'po_doba':          'po_dobu:gen',
+        'po_vzor':          'po_vzoru:gen',
+        'poblíž':           'poblíž:gen',
+        'počátek':          'počátkem:gen',
+        'počínat':          'počínaje:ins',
+        'pod_dojem':        'pod_dojmem:gen',
+        'pod_vliv':         'pod_vlivem:gen',
+        'podle':            'podle:gen',
+        'pomoc':            'pomocí:gen',
+        'pomocí':           'pomocí:gen',
+        'postup':           'postupem:gen',
+        'pouze_v':          'v:loc',
+        'pro':              'pro:acc',
+        'prostřednictví':   'prostřednictvím:gen',
+        'prostřednictvím':  'prostřednictvím:gen',
+        'proti':            'proti:dat',
+        'protože':          'protože', # remove morphological case
+        'před_během':       'během:gen', # před a během utkání
+        'před_po':          'po:loc', # před a po vyloučení Schindlera
+        'přes':             'přes:acc',
+        'přestože':         'přestože', # remove morphological case
+        'při':              'při:loc',
+        'při_příležitost':  'při_příležitosti:gen',
+        's_ohled_k':        's_ohledem_k:dat',
+        's_ohled_na':       's_ohledem_na:acc',
+        's_pomoc':          's_pomocí:gen',
+        's_přihlédnutí_k':  's_přihlédnutím_k:dat',
+        's_přihlédnutí_na': 's_přihlédnutím_na:acc',
+        's_výjimka':        's_výjimkou:gen',
+        's_vyloučení':      's_vyloučením:gen',
+        's_zřetel_k':       'se_zřetelem_k:dat',
+        's_zřetel_na':      'se_zřetelem_na:acc',
+        'severně_od':       'od:gen',
+        'skrz':             'skrz:acc',
+        'směr_do':          'směrem_do:gen',
+        'směr_k':           'směrem_k:dat',
+        'směr_na':          'směrem_na:acc',
+        'směr_od':          'směrem_od:gen',
+        'společně_s':       'společně_s:ins',
+        'spolu':            'spolu_s:ins',
+        'spolu_s':          'spolu_s:ins',
+        'stranou':          'stranou:gen',
+        'takže':            'takže', # remove morphological case
+        'takže_a':          'takže',
+        'třebaže':          'třebaže', # remove morphological case
+        'u':                'u:gen',
+        'u_příležitost':    'u_příležitosti:gen',
+        'uprostřed':        'uprostřed:gen',
+        'uvnitř':           'uvnitř:gen',
+        'v_analogie_s':     'v_analogii_s:ins',
+        'v_čelo':           'v_čele:gen',
+        'v_čelo_s':         'v_čele_s:ins',
+        'v_dohoda_s':       'v_dohodě_s:ins',
+        'v_duch':           'v_duchu:gen',
+        'v_důsledek':       'v_důsledku:gen',
+        'v_forma':          've_formě:gen',
+        'v_jméno':          've_jménu:gen',
+        'v_k':              'k:dat',
+        'v_kombinace_s':    'v_kombinaci_s:ins',
+        'v_konfrontace_s':  'v_konfrontaci_s:ins',
+        'v_kontext_s':      'v_kontextu_s:ins',
+        'v_na':             'na:loc',
+        'v_oblast':         'v_oblasti:gen',
+        'v_oblast_s':       's:ins',
+        'v_obor':           'v_oboru:gen',
+        'v_otázka':         'v_otázce:gen',
+        'v_podoba':         'v_podobě:gen',
+        'v_poměr_k':        'v_poměru_k:dat',
+        'v_proces':         'v_procesu:gen',
+        'v_prospěch':       've_prospěch:gen',
+        'v_protiklad_k':    'v_protikladu_k:dat',
+        'v_průběh':         'v_průběhu:gen',
+        'v_případ':         'v_případě:gen',
+        'v_případ_že':      'v_případě_že',
+        'v_rámec':          'v_rámci:gen',
+        'v_rozpor_s':       'v_rozporu_s:ins',
+        'v_řada':           'v_řadě:gen',
+        'v_shoda_s':        've_shodě_s:ins',
+        'v_služba':         've_službách:gen',
+        'v_směr':           've_směru:gen',
+        'v_směr_k':         've_směru_k:dat',
+        'v_smysl':          've_smyslu:gen',
+        'v_součinnost_s':   'v_součinnosti_s:ins',
+        'v_souhlas_s':      'v_souhlasu_s:ins',
+        'v_soulad_s':       'v_souladu_s:ins',
+        'v_souvislost_s':   'v_souvislosti_s:ins',
+        'v_spojení_s':      've_spojení_s:ins',
+        'v_spojený_s':      've_spojení_s:ins',
+        'v_spojitost_s':    've_spojitosti_s:ins',
+        'v_spolupráce_s':   've_spolupráci_s:ins',
+        'v_s_spolupráce':   've_spolupráci_s:ins',
+        'v_srovnání_s':     've_srovnání_s:ins',
+        'v_srovnání_se':    've_srovnání_s:ins',
+        'v_světlo':         've_světle:gen',
+        'v_věc':            've_věci:gen',
+        'v_vztah_k':        've_vztahu_k:dat',
+        'v_zájem':          'v_zájmu:gen',
+        'v_záležitost':     'v_záležitosti:gen',
+        'v_závěr':          'v_závěru:gen',
+        'v_závislost_na':   'v_závislosti_na:loc',
+        'v_závislost_s':    'v_závislosti_s:ins',
+        'v_znamení':        've_znamení:gen',
+        'včetně':           'včetně:gen',
+        'vedle':            'vedle:gen',
+        'vina':             'vinou:gen',
+        'vliv':             'vlivem:gen',
+        'vůči':             'vůči:dat',
+        'vzhledem':         'vzhledem_k:dat',
+        'vzhledem_k':       'vzhledem_k:dat',
+        'z':                'z:gen',
+        'z_důvod':          'z_důvodu:gen',
+        'z_hledisko':       'z_hlediska:gen',
+        'z_oblast':         'z_oblasti:gen',
+        'z_řada':           'z_řad:gen',
+        'z_strana':         'ze_strany:gen',
+        'z_nedostatek':     'z_nedostatku:gen',
+        'z_titul':          'z_titulu:gen',
+        'za_pomoc':         'za_pomoci:gen',
+        'za_účast':         'za_účasti:gen',
+        'za_účel':          'za_účelem:gen',
+        'začátek':          'začátkem:gen',
+        'zásluha':          'zásluhou:gen',
+        'zatím_co':         'zatímco',
+        'závěr':            'závěrem:gen',
+        'závisle_na':       'nezávisle_na:loc',
+        'že':               'že', # remove morphological case
+        'že_ať':            'ať',
+        'že_jako':          'že',
+        'že_jakoby':        'že',
+        'že_za':            'za:gen'
+    }
+
+    def copy_case_from_adposition(self, node, adposition):
+        """
+        In some treebanks, adpositions have the Case feature and it denotes the
+        valency case that the preposition's nominal must be in.
+        """
+        # The following is only partial solution. We will not see
+        # some children because they may be shared children of coordination.
+        prepchildren = [x for x in node.children if x.lemma == adposition]
+        if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
+            return adposition+':'+prepchildren[0].feats['Case'].lower()
+        else:
+            return None
+
+    def process_node(self, node):
+        """
+        Occasionally the edeprels automatically derived from the Czech basic
+        trees do not match the whitelist. For example, the noun is an
+        abbreviation and its morphological case is unknown.
+        """
+        for edep in node.deps:
+            m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):', edep['deprel'])
+            if m:
+                bdeprel = m.group(1)
+                solved = False
+                # Issues caused by errors in the original annotation must be fixed early.
+                # Especially if acl|advcl occurs with a preposition that unambiguously
+                # receives a morphological case in the subsequent steps, and then gets
+                # flagged as solved.
+                edep['deprel'] = re.sub(r'^advcl:do(?::gen)?$', r'obl:do:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
+                edep['deprel'] = re.sub(r'^acl:k(?::dat)?$', r'acl', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:k(?::dat)?$', r'obl:k:dat', edep['deprel']) ###!!! Ale měli bychom opravit i závislost v základním stromu!
+                edep['deprel'] = re.sub(r'^advcl:místo(?::gen)?$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
+                edep['deprel'] = re.sub(r'^acl:na_způsob(?::gen)?$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
+                edep['deprel'] = re.sub(r'^acl:od(?::gen)?$', r'nmod:od:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:od(?::gen)?$', r'obl:od:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
+                edep['deprel'] = re.sub(r'^advcl:podle(?::gen)?$', r'obl:podle:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:pro(?::acc)?$', r'obl:pro:acc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^acl:v$', r'nmod:v:loc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^advcl:v_duchu?(?::gen)?$', r'obl:v_duchu:gen', edep['deprel'])
+                # Removing 'až' must be done early. The remainder may be 'počátek'
+                # and we will want to convert it to 'počátkem:gen'.
+                edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
+                # If one of the following expressions occurs followed by another preposition
+                # or by morphological case, remove the additional case marking. For example,
+                # 'jako_v' becomes just 'jako'.
+                for x in self.outermost:
+                    exceptions = self.outermost[x]
+                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'([_:].+)?$', edep['deprel'])
+                    if m and m.group(2) and not x+m.group(2) in exceptions:
+                        edep['deprel'] = m.group(1)+':'+x
+                        solved = True
+                        break
+                if solved:
+                    continue
+                for x in self.unambiguous:
+                    # All secondary prepositions have only one fixed morphological case
+                    # they appear with, so we can replace whatever case we encounter with the correct one.
+                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?$', edep['deprel'])
+                    if m:
+                        edep['deprel'] = m.group(1)+':'+self.unambiguous[x]
+                        solved = True
+                        break
+                if solved:
+                    continue
+                # The following prepositions have more than one morphological case
+                # available. Thanks to the Case feature on prepositions, we can
+                # identify the correct one.
+                m = re.match(r'^(obl(?::arg)?|nmod):(mezi|na|nad|o|po|pod|před|v|za)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
+                if m:
+                    adpcase = self.copy_case_from_adposition(node, m.group(2))
+                    if adpcase and not re.search(r':(nom|gen|dat|voc)$', adpcase):
+                        edep['deprel'] = m.group(1)+':'+adpcase
+                        continue
+            if re.match(r'^(acl|advcl):', edep['deprel']):
+                # We do not include 'i' in the list of redundant prefixes because we want to preserve 'i když' (but we want to discard the other combinations).
+                edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(acl|advcl):kdy$', r'\1', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(advcl):neboť$', r'\1', edep['deprel']) # 'neboť' is coordinating
+                edep['deprel'] = re.sub(r'^(advcl):nechť$', r'\1', edep['deprel'])
+                if edep['deprel'] == 'acl:v' and node.form == 'patře':
+                    edep['deprel'] = 'nmod:v:loc'
+                    node.deprel = 'nmod'
+                    node.lemma = 'patro'
+                    node.upos = 'NOUN'
+                    node.xpos = 'NNNS6-----A----'
+                    node.feats['Aspect'] = ''
+                    node.feats['Gender'] = 'Neut'
+                    node.feats['Tense'] = ''
+                    node.feats['VerbForm'] = ''
+                    node.feats['Voice'] = ''
+            elif re.match(r'^(nmod|obl(:arg)?):', edep['deprel']):
+                if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
+                    # This is a same-case noun-noun modifier, which just happens to be in the locative.
+                    # For example, 'v Ostravě-Porubě', 'Porubě' is attached to 'Ostravě', 'Ostravě' has
+                    # nmod:v:loc, which is OK, but for 'Porubě' the case does not say anything significant.
+                    edep['deprel'] = 'nmod'
+                elif edep['deprel'] == 'obl:loc':
+                    # Annotation error. The first occurrence in PDT dev:
+                    # 'V Rapaportu, ceníku Antverpské burzy i Diamantberichtu jsou uvedeny ceny...'
+                    # The preposition 'V' should modify coordination 'Rapaportu i Diamantberichtu'.
+                    # However, 'Rapaportu' is attached as 'obl' to 'Diamantberichtu'.
+                    edep['deprel'] = 'obl:v:loc'
+                elif edep['deprel'] == 'obl:arg:loc':
+                    # Annotation error. The first occurrence in PDT dev:
+                    edep['deprel'] = 'obl:arg:na:loc'
+                elif edep['deprel'] == 'nmod:loc':
+                    # 'působil v kanadském Edmontonu Oilers', 'Edmontonu' attached to 'Oilers' and not vice versa.
+                    edep['deprel'] = 'nmod:nom'
+                elif edep['deprel'] == 'obl:nom' or edep['deprel'] == 'obl:voc':
+                    # Possibly an annotation error, nominative should be accusative, and the nominal should be direct object?
+                    # However, there seems to be a great variability in the causes, some are subjects and many are really obliques, so let's go just with 'obl' for now.
+                    edep['deprel'] = 'obl'
+                elif edep['deprel'] == 'nmod:voc':
+                    # 'v 8. čísle tiskoviny Ty rudá krávo'
+                    edep['deprel'] = 'nmod:nom'
+                elif edep['deprel'] == 'nmod:co:nom':
+                    # Annotation error: 'kompatibilní znamená tolik co slučitelný'
+                    # 'co' should be relative pronoun rather than subordinating conjunction.
+                    edep['deprel'] = 'acl:relcl'
+                    node.deprel = 'acl:relcl'
+                elif re.match(r'^(obl(:arg)?):li$', edep['deprel']):
+                    edep['deprel'] = 'advcl:li'
+                elif re.match(r'^(nmod|obl(:arg)?):mezi:voc$', edep['deprel']):
+                    edep['deprel'] = re.sub(r':voc$', r':acc', edep['deprel'])
+                elif re.match(r'^(nmod|obl(:arg)?):mezi$', edep['deprel']):
+                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):mimo$', edep['deprel']):
+                    edep['deprel'] += ':acc'
+                elif re.match(r'^(nmod|obl(:arg)?):místo$', edep['deprel']):
+                    edep['deprel'] += ':gen'
+                elif re.match(r'^obl:místo_za:acc$', edep['deprel']):
+                    # 'chytají krávu místo za rohy spíše za ocas'
+                    # This should be treated as coordination; 'místo' and 'spíše' are adverbs (???); 'case' for 'místo' does not seem to be the optimal solution.
+                    for c in node.children:
+                        if c.form == 'místo':
+                            c.upos = 'ADV'
+                            c.deprel = 'cc'
+                    edep['deprel'] = 'obl:za:acc'
+                elif re.match(r'^(nmod|obl(:arg)?):místo[_:].+$', edep['deprel']) and not re.match(r'^(nmod|obl(:arg)?):místo_aby$', edep['deprel']):
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):místo[_:].+$', r'\1:místo:gen', edep['deprel'])
+                elif re.match(r'^(nmod|obl(:arg)?):na(:gen)?$', edep['deprel']):
+                    edep['deprel'] = re.sub(r':gen$', '', edep['deprel'])
+                    # The case is unknown. We need 'acc' or 'loc'.
+                    # The locative is probably more frequent but it is not so likely with every noun.
+                    # If there is an nummod:gov child, it must be accusative and not locative.
+                    # (The case would be taken from the number but if it is expressed as digits, it does not have the case feature.)
+                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    elif re.match(r'^(adresát|AIDS|DEM|frank|h|ha|hodina|Honolulu|jméno|koruna|litr|metr|míle|miliarda|milión|mm|MUDr|NATO|obyvatel|OSN|počet|procento|příklad|rok|SSSR|vůz)$', node.lemma):
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':loc'
+                elif re.match(r'^obl:arg:na_konec$', edep['deprel']):
+                    # Annotation error. It should have been two prepositional phrases: 'snížil na 225 tisíc koncem minulého roku'
+                    edep['deprel'] = 'obl:arg:na:acc'
+                elif re.match(r'^(nmod|obl(:arg)?):nad$', edep['deprel']):
+                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):o$', edep['deprel']):
+                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':loc'
+                elif re.match(r'^(nmod|obl(:arg)?):ohled_na:ins$', edep['deprel']):
+                    # Annotation error.
+                    if node.form == 's':
+                        ohled = node.next_node
+                        na = ohled.next_node
+                        noun = na.next_node
+                        self.set_basic_and_enhanced(noun, node.parent, 'obl', 'obl:s_ohledem_na:acc')
+                        self.set_basic_and_enhanced(ohled, node, 'fixed', 'fixed')
+                        self.set_basic_and_enhanced(na, node, 'fixed', 'fixed')
+                        self.set_basic_and_enhanced(node, noun, 'case', 'case')
+                elif re.match(r'^nmod:pára:nom$', edep['deprel']):
+                    # Annotation error: 'par excellence'.
+                    edep['deprel'] = 'nmod'
+                    for c in node.children:
+                        if c.udeprel == 'case' and c.form.lower() == 'par':
+                            c.lemma = 'par'
+                            c.upos = 'ADP'
+                            c.xpos = 'RR--X----------'
+                            c.feats['Case'] = ''
+                            c.feats['Gender'] = ''
+                            c.feats['Number'] = ''
+                            c.feats['Polarity'] = ''
+                            c.feats['AdpType'] = 'Prep'
+                elif re.match(r'^(nmod|obl(:arg)?):po$', edep['deprel']):
+                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':loc'
+                elif re.match(r'^(nmod|obl(:arg)?):pod$', edep['deprel']):
+                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):před$', edep['deprel']):
+                    # Accusative would be possible but unlikely.
+                    edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):s$', edep['deprel']):
+                    # Genitive would be possible but unlikely.
+                    edep['deprel'] += ':ins'
+                elif re.match(r'^(nmod|obl(:arg)?):v_s(:loc)?$', edep['deprel']) and node.form == 'spolupráci':
+                    # Annotation error. 'Ve spolupráci s' should be analyzed as a multi-word preposition.
+                    # Find the content nominal.
+                    cnouns = [x for x in node.children if x.ord > node.ord and re.match(r'^(nmod|obl)', x.udeprel)]
+                    vs = [x for x in node.children if x.ord < node.ord and x.lemma == 'v']
+                    if len(cnouns) > 0 and len(vs) > 0:
+                        cnoun = cnouns[0]
+                        v = vs[0]
+                        self.set_basic_and_enhanced(cnoun, node.parent, 'obl', 'obl:ve_spolupráci_s:ins')
+                        self.set_basic_and_enhanced(v, cnoun, 'case', 'case')
+                        self.set_basic_and_enhanced(node, v, 'fixed', 'fixed')
+                elif re.match(r'^(nmod|obl(:arg)?):v(:nom)?$', edep['deprel']):
+                    # ':nom' occurs in 'karneval v Rio de Janeiro'
+                    edep['deprel'] = re.sub(r':nom$', '', edep['deprel'])
+                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                        edep['deprel'] += ':acc'
+                    else:
+                        edep['deprel'] += ':loc'
+                elif re.match(r'^obl:v_čel[eo]_s:ins$', edep['deprel']):
+                    # There is just one occurrence and it is an error:
+                    # 'Předloňský kůň roku Law Soziri šel již v Lahovickém oblouku v čele s Raddelliosem a tato dvojice také nakonec zahanbila ostatní soupeře...'
+                    # There should be two independent oblique modifiers, 'v čele' and 's Raddelliosem'.
+                    edep['deprel'] = 'obl:s:ins'
+                elif re.match(r'^(nmod|obl(:arg)?):za$', edep['deprel']):
+                    # Instrumental would be possible but unlikely.
+                    edep['deprel'] += ':acc'
+                else:
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_?l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(jak_)?ad([_:].+)?$', r'\1', edep['deprel']) # ad infinitum
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):co(:nom)?$', r'advmod', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):de([_:].+)?$', r'\1', edep['deprel']) # de facto
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):di([_:].+)?$', r'\1', edep['deprel']) # Lido di Jesolo
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):en([_:].+)?$', r'\1', edep['deprel']) # bienvenue en France
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):in([_:].+)?$', r'\1', edep['deprel']) # made in NHL
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):into([_:].+)?$', r'\1', edep['deprel']) # made in NHL
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno:nom$', r'\1:jménem:nom', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno(:gen)?$', r'\1:jménem:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi:(nom|dat)$', r'\1:mezi:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o:(nom|gen|dat)$', r'\1:o:acc', edep['deprel']) # 'zájem o obaly'
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):of([_:].+)?$', r'\1', edep['deprel']) # University of North Carolina
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):per([_:].+)?$', r'\1', edep['deprel']) # per rollam
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po:(nom|gen)$', r'\1:po:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před:gen$', r'\1:před:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přestože[_:].+$', r'\1:přestože', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):se?:(nom|acc|ins)$', r'\1:s:ins', edep['deprel']) # accusative: 'být s to' should be a fixed expression and it should be the predicate!
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):shoda(:gen)?$', r'\1', edep['deprel']) # 'shodou okolností' is not a prepositional phrase
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v:gen$', r'\1:v:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vo:acc$', r'\1:o:acc', edep['deprel']) # colloquial: vo všecko
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):von([_:].+)?$', r'\1', edep['deprel']) # von Neumannem
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):voor([_:].+)?$', r'\1', edep['deprel']) # Hoge Raad voor Diamant
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:nom$', r'\1:z:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:ins$', r'\1:s:ins', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za:nom$', r'\1:za:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^nmod:že:gen$', 'acl:že', edep['deprel'])
+
+    def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
+        '''
+        Modifies the incoming relation of a node both in the basic tree and in
+        the enhanced graph. If the node does not yet depend in the enhanced
+        graph on the current basic parent, the new relation will be added without
+        removing any old one. If the node already depends multiple times on the
+        current basic parent in the enhanced graph, all such enhanced relations
+        will be removed before adding the new one.
+        '''
+        old_parent = node.parent
+        node.parent = parent
+        node.deprel = deprel
+        node.deps = [x for x in node.deps if x['parent'] != old_parent]
+        new_edep = {}
+        new_edep['parent'] = parent
+        new_edep['deprel'] = edeprel
+        node.deps.append(new_edep)

From af9219fd913f1c5d4c04d4c57bdc83b56ce166ed Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 09:38:47 +0200
Subject: [PATCH 0906/1374] nes

---
 udapi/block/ud/lt/fixedeprels.py | 53 ++------------------------------
 1 file changed, 2 insertions(+), 51 deletions(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index bf7873f0..3dc7a616 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -32,10 +32,10 @@ class FixEdeprels(Block):
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
-        'abi':              'aby',
+        'nes':              'nes', # remove morphological case # because
+
         'aby_na':           'na:loc',
         'ačkoliv':          'ačkoli',
-        'ať':               'ať', # remove morphological case
         'ať_forma':         'formou:gen',
         'ať_v':             'v:loc',
         'ať_z':             'z:gen',
@@ -110,19 +110,6 @@ class FixEdeprels(Block):
         'po_v':             'po:loc',
         'po_doba':          'po_dobu:gen',
         'po_vzor':          'po_vzoru:gen',
-        'poblíž':           'poblíž:gen',
-        'počátek':          'počátkem:gen',
-        'počínat':          'počínaje:ins',
-        'pod_dojem':        'pod_dojmem:gen',
-        'pod_vliv':         'pod_vlivem:gen',
-        'podle':            'podle:gen',
-        'pomoc':            'pomocí:gen',
-        'pomocí':           'pomocí:gen',
-        'postup':           'postupem:gen',
-        'pouze_v':          'v:loc',
-        'pro':              'pro:acc',
-        'prostřednictví':   'prostřednictvím:gen',
-        'prostřednictvím':  'prostřednictvím:gen',
         'proti':            'proti:dat',
         'protože':          'protože', # remove morphological case
         'před_během':       'během:gen', # před a během utkání
@@ -142,14 +129,6 @@ class FixEdeprels(Block):
         's_zřetel_na':      'se_zřetelem_na:acc',
         'severně_od':       'od:gen',
         'skrz':             'skrz:acc',
-        'směr_do':          'směrem_do:gen',
-        'směr_k':           'směrem_k:dat',
-        'směr_na':          'směrem_na:acc',
-        'směr_od':          'směrem_od:gen',
-        'společně_s':       'společně_s:ins',
-        'spolu':            'spolu_s:ins',
-        'spolu_s':          'spolu_s:ins',
-        'stranou':          'stranou:gen',
         'takže':            'takže', # remove morphological case
         'takže_a':          'takže',
         'třebaže':          'třebaže', # remove morphological case
@@ -218,21 +197,6 @@ class FixEdeprels(Block):
         'vzhledem':         'vzhledem_k:dat',
         'vzhledem_k':       'vzhledem_k:dat',
         'z':                'z:gen',
-        'z_důvod':          'z_důvodu:gen',
-        'z_hledisko':       'z_hlediska:gen',
-        'z_oblast':         'z_oblasti:gen',
-        'z_řada':           'z_řad:gen',
-        'z_strana':         'ze_strany:gen',
-        'z_nedostatek':     'z_nedostatku:gen',
-        'z_titul':          'z_titulu:gen',
-        'za_pomoc':         'za_pomoci:gen',
-        'za_účast':         'za_účasti:gen',
-        'za_účel':          'za_účelem:gen',
-        'začátek':          'začátkem:gen',
-        'zásluha':          'zásluhou:gen',
-        'zatím_co':         'zatímco',
-        'závěr':            'závěrem:gen',
-        'závisle_na':       'nezávisle_na:loc',
         'že':               'že', # remove morphological case
         'že_ať':            'ať',
         'že_jako':          'že',
@@ -270,19 +234,6 @@ def process_node(self, node):
                 # flagged as solved.
                 edep['deprel'] = re.sub(r'^advcl:do(?::gen)?$', r'obl:do:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
                 edep['deprel'] = re.sub(r'^acl:k(?::dat)?$', r'acl', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:k(?::dat)?$', r'obl:k:dat', edep['deprel']) ###!!! Ale měli bychom opravit i závislost v základním stromu!
-                edep['deprel'] = re.sub(r'^advcl:místo(?::gen)?$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
-                edep['deprel'] = re.sub(r'^acl:na_způsob(?::gen)?$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
-                edep['deprel'] = re.sub(r'^acl:od(?::gen)?$', r'nmod:od:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:od(?::gen)?$', r'obl:od:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
-                edep['deprel'] = re.sub(r'^advcl:podle(?::gen)?$', r'obl:podle:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:pro(?::acc)?$', r'obl:pro:acc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^acl:v$', r'nmod:v:loc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:v_duchu?(?::gen)?$', r'obl:v_duchu:gen', edep['deprel'])
-                # Removing 'až' must be done early. The remainder may be 'počátek'
-                # and we will want to convert it to 'počátkem:gen'.
-                edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
                 # If one of the following expressions occurs followed by another preposition
                 # or by morphological case, remove the additional case marking. For example,
                 # 'jako_v' becomes just 'jako'.

From 83a3059fc9ba3328a60c292d58d85e7bf2106e3f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 09:43:53 +0200
Subject: [PATCH 0907/1374] Removed some Czech defaults from Lithuanian.

---
 udapi/block/ud/lt/fixedeprels.py | 203 +++++--------------------------
 1 file changed, 30 insertions(+), 173 deletions(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index 3dc7a616..bd26b740 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -286,179 +286,36 @@ def process_node(self, node):
                     node.feats['VerbForm'] = ''
                     node.feats['Voice'] = ''
             elif re.match(r'^(nmod|obl(:arg)?):', edep['deprel']):
-                if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
-                    # This is a same-case noun-noun modifier, which just happens to be in the locative.
-                    # For example, 'v Ostravě-Porubě', 'Porubě' is attached to 'Ostravě', 'Ostravě' has
-                    # nmod:v:loc, which is OK, but for 'Porubě' the case does not say anything significant.
-                    edep['deprel'] = 'nmod'
-                elif edep['deprel'] == 'obl:loc':
-                    # Annotation error. The first occurrence in PDT dev:
-                    # 'V Rapaportu, ceníku Antverpské burzy i Diamantberichtu jsou uvedeny ceny...'
-                    # The preposition 'V' should modify coordination 'Rapaportu i Diamantberichtu'.
-                    # However, 'Rapaportu' is attached as 'obl' to 'Diamantberichtu'.
-                    edep['deprel'] = 'obl:v:loc'
-                elif edep['deprel'] == 'obl:arg:loc':
-                    # Annotation error. The first occurrence in PDT dev:
-                    edep['deprel'] = 'obl:arg:na:loc'
-                elif edep['deprel'] == 'nmod:loc':
-                    # 'působil v kanadském Edmontonu Oilers', 'Edmontonu' attached to 'Oilers' and not vice versa.
-                    edep['deprel'] = 'nmod:nom'
-                elif edep['deprel'] == 'obl:nom' or edep['deprel'] == 'obl:voc':
-                    # Possibly an annotation error, nominative should be accusative, and the nominal should be direct object?
-                    # However, there seems to be a great variability in the causes, some are subjects and many are really obliques, so let's go just with 'obl' for now.
-                    edep['deprel'] = 'obl'
-                elif edep['deprel'] == 'nmod:voc':
-                    # 'v 8. čísle tiskoviny Ty rudá krávo'
-                    edep['deprel'] = 'nmod:nom'
-                elif edep['deprel'] == 'nmod:co:nom':
-                    # Annotation error: 'kompatibilní znamená tolik co slučitelný'
-                    # 'co' should be relative pronoun rather than subordinating conjunction.
-                    edep['deprel'] = 'acl:relcl'
-                    node.deprel = 'acl:relcl'
-                elif re.match(r'^(obl(:arg)?):li$', edep['deprel']):
-                    edep['deprel'] = 'advcl:li'
-                elif re.match(r'^(nmod|obl(:arg)?):mezi:voc$', edep['deprel']):
-                    edep['deprel'] = re.sub(r':voc$', r':acc', edep['deprel'])
-                elif re.match(r'^(nmod|obl(:arg)?):mezi$', edep['deprel']):
-                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):mimo$', edep['deprel']):
-                    edep['deprel'] += ':acc'
-                elif re.match(r'^(nmod|obl(:arg)?):místo$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^obl:místo_za:acc$', edep['deprel']):
-                    # 'chytají krávu místo za rohy spíše za ocas'
-                    # This should be treated as coordination; 'místo' and 'spíše' are adverbs (???); 'case' for 'místo' does not seem to be the optimal solution.
-                    for c in node.children:
-                        if c.form == 'místo':
-                            c.upos = 'ADV'
-                            c.deprel = 'cc'
-                    edep['deprel'] = 'obl:za:acc'
-                elif re.match(r'^(nmod|obl(:arg)?):místo[_:].+$', edep['deprel']) and not re.match(r'^(nmod|obl(:arg)?):místo_aby$', edep['deprel']):
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):místo[_:].+$', r'\1:místo:gen', edep['deprel'])
-                elif re.match(r'^(nmod|obl(:arg)?):na(:gen)?$', edep['deprel']):
-                    edep['deprel'] = re.sub(r':gen$', '', edep['deprel'])
-                    # The case is unknown. We need 'acc' or 'loc'.
-                    # The locative is probably more frequent but it is not so likely with every noun.
-                    # If there is an nummod:gov child, it must be accusative and not locative.
-                    # (The case would be taken from the number but if it is expressed as digits, it does not have the case feature.)
-                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    elif re.match(r'^(adresát|AIDS|DEM|frank|h|ha|hodina|Honolulu|jméno|koruna|litr|metr|míle|miliarda|milión|mm|MUDr|NATO|obyvatel|OSN|počet|procento|příklad|rok|SSSR|vůz)$', node.lemma):
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':loc'
-                elif re.match(r'^obl:arg:na_konec$', edep['deprel']):
-                    # Annotation error. It should have been two prepositional phrases: 'snížil na 225 tisíc koncem minulého roku'
-                    edep['deprel'] = 'obl:arg:na:acc'
-                elif re.match(r'^(nmod|obl(:arg)?):nad$', edep['deprel']):
-                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):o$', edep['deprel']):
-                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':loc'
-                elif re.match(r'^(nmod|obl(:arg)?):ohled_na:ins$', edep['deprel']):
-                    # Annotation error.
-                    if node.form == 's':
-                        ohled = node.next_node
-                        na = ohled.next_node
-                        noun = na.next_node
-                        self.set_basic_and_enhanced(noun, node.parent, 'obl', 'obl:s_ohledem_na:acc')
-                        self.set_basic_and_enhanced(ohled, node, 'fixed', 'fixed')
-                        self.set_basic_and_enhanced(na, node, 'fixed', 'fixed')
-                        self.set_basic_and_enhanced(node, noun, 'case', 'case')
-                elif re.match(r'^nmod:pára:nom$', edep['deprel']):
-                    # Annotation error: 'par excellence'.
-                    edep['deprel'] = 'nmod'
-                    for c in node.children:
-                        if c.udeprel == 'case' and c.form.lower() == 'par':
-                            c.lemma = 'par'
-                            c.upos = 'ADP'
-                            c.xpos = 'RR--X----------'
-                            c.feats['Case'] = ''
-                            c.feats['Gender'] = ''
-                            c.feats['Number'] = ''
-                            c.feats['Polarity'] = ''
-                            c.feats['AdpType'] = 'Prep'
-                elif re.match(r'^(nmod|obl(:arg)?):po$', edep['deprel']):
-                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':loc'
-                elif re.match(r'^(nmod|obl(:arg)?):pod$', edep['deprel']):
-                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):před$', edep['deprel']):
-                    # Accusative would be possible but unlikely.
-                    edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):s$', edep['deprel']):
-                    # Genitive would be possible but unlikely.
-                    edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):v_s(:loc)?$', edep['deprel']) and node.form == 'spolupráci':
-                    # Annotation error. 'Ve spolupráci s' should be analyzed as a multi-word preposition.
-                    # Find the content nominal.
-                    cnouns = [x for x in node.children if x.ord > node.ord and re.match(r'^(nmod|obl)', x.udeprel)]
-                    vs = [x for x in node.children if x.ord < node.ord and x.lemma == 'v']
-                    if len(cnouns) > 0 and len(vs) > 0:
-                        cnoun = cnouns[0]
-                        v = vs[0]
-                        self.set_basic_and_enhanced(cnoun, node.parent, 'obl', 'obl:ve_spolupráci_s:ins')
-                        self.set_basic_and_enhanced(v, cnoun, 'case', 'case')
-                        self.set_basic_and_enhanced(node, v, 'fixed', 'fixed')
-                elif re.match(r'^(nmod|obl(:arg)?):v(:nom)?$', edep['deprel']):
-                    # ':nom' occurs in 'karneval v Rio de Janeiro'
-                    edep['deprel'] = re.sub(r':nom$', '', edep['deprel'])
-                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':loc'
-                elif re.match(r'^obl:v_čel[eo]_s:ins$', edep['deprel']):
-                    # There is just one occurrence and it is an error:
-                    # 'Předloňský kůň roku Law Soziri šel již v Lahovickém oblouku v čele s Raddelliosem a tato dvojice také nakonec zahanbila ostatní soupeře...'
-                    # There should be two independent oblique modifiers, 'v čele' and 's Raddelliosem'.
-                    edep['deprel'] = 'obl:s:ins'
-                elif re.match(r'^(nmod|obl(:arg)?):za$', edep['deprel']):
-                    # Instrumental would be possible but unlikely.
-                    edep['deprel'] += ':acc'
-                else:
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_?l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(jak_)?ad([_:].+)?$', r'\1', edep['deprel']) # ad infinitum
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):co(:nom)?$', r'advmod', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):de([_:].+)?$', r'\1', edep['deprel']) # de facto
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):di([_:].+)?$', r'\1', edep['deprel']) # Lido di Jesolo
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):en([_:].+)?$', r'\1', edep['deprel']) # bienvenue en France
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):in([_:].+)?$', r'\1', edep['deprel']) # made in NHL
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):into([_:].+)?$', r'\1', edep['deprel']) # made in NHL
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno:nom$', r'\1:jménem:nom', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno(:gen)?$', r'\1:jménem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi:(nom|dat)$', r'\1:mezi:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o:(nom|gen|dat)$', r'\1:o:acc', edep['deprel']) # 'zájem o obaly'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):of([_:].+)?$', r'\1', edep['deprel']) # University of North Carolina
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):per([_:].+)?$', r'\1', edep['deprel']) # per rollam
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po:(nom|gen)$', r'\1:po:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před:gen$', r'\1:před:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přestože[_:].+$', r'\1:přestože', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):se?:(nom|acc|ins)$', r'\1:s:ins', edep['deprel']) # accusative: 'být s to' should be a fixed expression and it should be the predicate!
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):shoda(:gen)?$', r'\1', edep['deprel']) # 'shodou okolností' is not a prepositional phrase
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v:gen$', r'\1:v:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vo:acc$', r'\1:o:acc', edep['deprel']) # colloquial: vo všecko
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):von([_:].+)?$', r'\1', edep['deprel']) # von Neumannem
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):voor([_:].+)?$', r'\1', edep['deprel']) # Hoge Raad voor Diamant
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:nom$', r'\1:z:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:ins$', r'\1:s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za:nom$', r'\1:za:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^nmod:že:gen$', 'acl:že', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_?l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(jak_)?ad([_:].+)?$', r'\1', edep['deprel']) # ad infinitum
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):co(:nom)?$', r'advmod', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):de([_:].+)?$', r'\1', edep['deprel']) # de facto
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):di([_:].+)?$', r'\1', edep['deprel']) # Lido di Jesolo
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):en([_:].+)?$', r'\1', edep['deprel']) # bienvenue en France
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):in([_:].+)?$', r'\1', edep['deprel']) # made in NHL
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):into([_:].+)?$', r'\1', edep['deprel']) # made in NHL
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno:nom$', r'\1:jménem:nom', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno(:gen)?$', r'\1:jménem:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi:(nom|dat)$', r'\1:mezi:ins', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o:(nom|gen|dat)$', r'\1:o:acc', edep['deprel']) # 'zájem o obaly'
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):of([_:].+)?$', r'\1', edep['deprel']) # University of North Carolina
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):per([_:].+)?$', r'\1', edep['deprel']) # per rollam
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po:(nom|gen)$', r'\1:po:acc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před:gen$', r'\1:před:ins', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přestože[_:].+$', r'\1:přestože', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):se?:(nom|acc|ins)$', r'\1:s:ins', edep['deprel']) # accusative: 'být s to' should be a fixed expression and it should be the predicate!
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):shoda(:gen)?$', r'\1', edep['deprel']) # 'shodou okolností' is not a prepositional phrase
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v:gen$', r'\1:v:loc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vo:acc$', r'\1:o:acc', edep['deprel']) # colloquial: vo všecko
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):von([_:].+)?$', r'\1', edep['deprel']) # von Neumannem
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):voor([_:].+)?$', r'\1', edep['deprel']) # Hoge Raad voor Diamant
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:nom$', r'\1:z:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:ins$', r'\1:s:ins', edep['deprel'])
+                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za:nom$', r'\1:za:acc', edep['deprel'])
+                edep['deprel'] = re.sub(r'^nmod:že:gen$', 'acl:že', edep['deprel'])
 
     def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
         '''

From 4b4ecc7c9e136616c9460a731d2e23e9d31726d4 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 09:46:39 +0200
Subject: [PATCH 0908/1374] Removed some Czech defaults from Lithuanian.

---
 udapi/block/ud/lt/fixedeprels.py | 32 --------------------------------
 1 file changed, 32 deletions(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index bd26b740..a336ad68 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -107,10 +107,6 @@ class FixEdeprels(Block):
         'ohledně':          'ohledně:gen',
         'okolo':            'okolo:gen',
         'oproti':           'oproti:dat',
-        'po_v':             'po:loc',
-        'po_doba':          'po_dobu:gen',
-        'po_vzor':          'po_vzoru:gen',
-        'proti':            'proti:dat',
         'protože':          'protože', # remove morphological case
         'před_během':       'během:gen', # před a během utkání
         'před_po':          'po:loc', # před a po vyloučení Schindlera
@@ -286,36 +282,8 @@ def process_node(self, node):
                     node.feats['VerbForm'] = ''
                     node.feats['Voice'] = ''
             elif re.match(r'^(nmod|obl(:arg)?):', edep['deprel']):
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_?l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(jak_)?ad([_:].+)?$', r'\1', edep['deprel']) # ad infinitum
                 edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):co(:nom)?$', r'advmod', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):de([_:].+)?$', r'\1', edep['deprel']) # de facto
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):di([_:].+)?$', r'\1', edep['deprel']) # Lido di Jesolo
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):en([_:].+)?$', r'\1', edep['deprel']) # bienvenue en France
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):in([_:].+)?$', r'\1', edep['deprel']) # made in NHL
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):into([_:].+)?$', r'\1', edep['deprel']) # made in NHL
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno:nom$', r'\1:jménem:nom', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno(:gen)?$', r'\1:jménem:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi:(nom|dat)$', r'\1:mezi:ins', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o:(nom|gen|dat)$', r'\1:o:acc', edep['deprel']) # 'zájem o obaly'
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):of([_:].+)?$', r'\1', edep['deprel']) # University of North Carolina
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):per([_:].+)?$', r'\1', edep['deprel']) # per rollam
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po:(nom|gen)$', r'\1:po:acc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před:gen$', r'\1:před:ins', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přestože[_:].+$', r'\1:přestože', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):se?:(nom|acc|ins)$', r'\1:s:ins', edep['deprel']) # accusative: 'být s to' should be a fixed expression and it should be the predicate!
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):shoda(:gen)?$', r'\1', edep['deprel']) # 'shodou okolností' is not a prepositional phrase
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v:gen$', r'\1:v:loc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vo:acc$', r'\1:o:acc', edep['deprel']) # colloquial: vo všecko
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):von([_:].+)?$', r'\1', edep['deprel']) # von Neumannem
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):voor([_:].+)?$', r'\1', edep['deprel']) # Hoge Raad voor Diamant
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:nom$', r'\1:z:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:ins$', r'\1:s:ins', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za:nom$', r'\1:za:acc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^nmod:že:gen$', 'acl:že', edep['deprel'])
 
     def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
         '''

From bd5268c07c74a01c7be397cf8dbe9104fa7ce532 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 09:51:38 +0200
Subject: [PATCH 0909/1374] Removed some Czech defaults from Lithuanian.

---
 udapi/block/ud/lt/fixedeprels.py | 79 +-------------------------------
 1 file changed, 1 insertion(+), 78 deletions(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index a336ad68..ea7d93b9 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -70,15 +70,6 @@ class FixEdeprels(Block):
         'jakoby_pod':       'pod:ins',
         'jelikož_do':       'jelikož',
         'jestli_že':        'jestliže',
-        'k':                'k:dat',
-        'k_konec':          'ke_konci:gen',
-        'kdykoliv':         'kdykoli',
-        'kol':              'kolem:gen',
-        'kolem':            'kolem:gen',
-        'konec':            'koncem:gen',
-        'krom':             'kromě:gen',
-        'kromě':            'kromě:gen',
-        'liž':              'li',
         'mezi_uvnitř':      'uvnitř:gen',
         'na_báze':          'na_bázi:gen',
         'na_čelo':          'na_čele:gen',
@@ -105,15 +96,6 @@ class FixEdeprels(Block):
         'o_o':              'o:acc',
         'od':               'od:gen',
         'ohledně':          'ohledně:gen',
-        'okolo':            'okolo:gen',
-        'oproti':           'oproti:dat',
-        'protože':          'protože', # remove morphological case
-        'před_během':       'během:gen', # před a během utkání
-        'před_po':          'po:loc', # před a po vyloučení Schindlera
-        'přes':             'přes:acc',
-        'přestože':         'přestože', # remove morphological case
-        'při':              'při:loc',
-        'při_příležitost':  'při_příležitosti:gen',
         's_ohled_k':        's_ohledem_k:dat',
         's_ohled_na':       's_ohledem_na:acc',
         's_pomoc':          's_pomocí:gen',
@@ -128,60 +110,6 @@ class FixEdeprels(Block):
         'takže':            'takže', # remove morphological case
         'takže_a':          'takže',
         'třebaže':          'třebaže', # remove morphological case
-        'u':                'u:gen',
-        'u_příležitost':    'u_příležitosti:gen',
-        'uprostřed':        'uprostřed:gen',
-        'uvnitř':           'uvnitř:gen',
-        'v_analogie_s':     'v_analogii_s:ins',
-        'v_čelo':           'v_čele:gen',
-        'v_čelo_s':         'v_čele_s:ins',
-        'v_dohoda_s':       'v_dohodě_s:ins',
-        'v_duch':           'v_duchu:gen',
-        'v_důsledek':       'v_důsledku:gen',
-        'v_forma':          've_formě:gen',
-        'v_jméno':          've_jménu:gen',
-        'v_k':              'k:dat',
-        'v_kombinace_s':    'v_kombinaci_s:ins',
-        'v_konfrontace_s':  'v_konfrontaci_s:ins',
-        'v_kontext_s':      'v_kontextu_s:ins',
-        'v_na':             'na:loc',
-        'v_oblast':         'v_oblasti:gen',
-        'v_oblast_s':       's:ins',
-        'v_obor':           'v_oboru:gen',
-        'v_otázka':         'v_otázce:gen',
-        'v_podoba':         'v_podobě:gen',
-        'v_poměr_k':        'v_poměru_k:dat',
-        'v_proces':         'v_procesu:gen',
-        'v_prospěch':       've_prospěch:gen',
-        'v_protiklad_k':    'v_protikladu_k:dat',
-        'v_průběh':         'v_průběhu:gen',
-        'v_případ':         'v_případě:gen',
-        'v_případ_že':      'v_případě_že',
-        'v_rámec':          'v_rámci:gen',
-        'v_rozpor_s':       'v_rozporu_s:ins',
-        'v_řada':           'v_řadě:gen',
-        'v_shoda_s':        've_shodě_s:ins',
-        'v_služba':         've_službách:gen',
-        'v_směr':           've_směru:gen',
-        'v_směr_k':         've_směru_k:dat',
-        'v_smysl':          've_smyslu:gen',
-        'v_součinnost_s':   'v_součinnosti_s:ins',
-        'v_souhlas_s':      'v_souhlasu_s:ins',
-        'v_soulad_s':       'v_souladu_s:ins',
-        'v_souvislost_s':   'v_souvislosti_s:ins',
-        'v_spojení_s':      've_spojení_s:ins',
-        'v_spojený_s':      've_spojení_s:ins',
-        'v_spojitost_s':    've_spojitosti_s:ins',
-        'v_spolupráce_s':   've_spolupráci_s:ins',
-        'v_s_spolupráce':   've_spolupráci_s:ins',
-        'v_srovnání_s':     've_srovnání_s:ins',
-        'v_srovnání_se':    've_srovnání_s:ins',
-        'v_světlo':         've_světle:gen',
-        'v_věc':            've_věci:gen',
-        'v_vztah_k':        've_vztahu_k:dat',
-        'v_zájem':          'v_zájmu:gen',
-        'v_záležitost':     'v_záležitosti:gen',
-        'v_závěr':          'v_závěru:gen',
         'v_závislost_na':   'v_závislosti_na:loc',
         'v_závislost_s':    'v_závislosti_s:ins',
         'v_znamení':        've_znamení:gen',
@@ -192,11 +120,6 @@ class FixEdeprels(Block):
         'vůči':             'vůči:dat',
         'vzhledem':         'vzhledem_k:dat',
         'vzhledem_k':       'vzhledem_k:dat',
-        'z':                'z:gen',
-        'že':               'že', # remove morphological case
-        'že_ať':            'ať',
-        'že_jako':          'že',
-        'že_jakoby':        'že',
         'že_za':            'za:gen'
     }
 
@@ -255,7 +178,7 @@ def process_node(self, node):
                 # The following prepositions have more than one morphological case
                 # available. Thanks to the Case feature on prepositions, we can
                 # identify the correct one.
-                m = re.match(r'^(obl(?::arg)?|nmod):(mezi|na|nad|o|po|pod|před|v|za)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
+                m = re.match(r'^(obl(?::arg)?|nmod):(před)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
                 if m:
                     adpcase = self.copy_case_from_adposition(node, m.group(2))
                     if adpcase and not re.search(r':(nom|gen|dat|voc)$', adpcase):

From d5a29bf96f4c1030019c24f50993bfa68f684dc2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 11:04:17 +0200
Subject: [PATCH 0910/1374] Removed some Czech defaults from Lithuanian.

---
 udapi/block/ud/lt/fixedeprels.py | 83 ++++++--------------------------
 1 file changed, 14 insertions(+), 69 deletions(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index ea7d93b9..bd4dd7c9 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -12,17 +12,9 @@ class FixEdeprels(Block):
     # by all the inner cases.
     # The list in the value contains exceptions that should be left intact.
     outermost = {
-        'ač':      [],
-        'ačkoli':  [], # 'ačkoliv' se převede na 'ačkoli' dole
-        'byť':     [],
-        'i_když':  [],
-        'jak':     [],
-        'jakkoli': [], # 'jakkoliv' se převede na 'jakkoli' dole
-        'jako':    [],
-        'jakoby':  ['jakoby_pod:ins'], # these instances in FicTree should be spelled 'jako by'
+        'kaip':    [],
+
         'než':     ['než_aby'],
-        'protože': [],
-        'takže':   [],
         'třebaže': []
     }
 
@@ -32,69 +24,32 @@ class FixEdeprels(Block):
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
+        'apie':             'apie:acc', # about (topic)
+        'jei':              'jei', # remove morphological case # if
+        'jeigu':            'jeigu', # remove morphological case # if
+        'kaip':             'kaip', # remove morphological case # as, than
+        'kaip_į':           'kaip',
+        'kaip_per':         'kaip',
+        'kaip_prieš':       'kaip',
+        'kaip_su':          'kaip',
         'nes':              'nes', # remove morphological case # because
+        'pagal':            'pagal:acc', # according to, under, by
+        'pagal_dėl':        'pagal:acc',
+        'per':              'per:acc', # through, over (přes)
 
         'aby_na':           'na:loc',
-        'ačkoliv':          'ačkoli',
-        'ať_forma':         'formou:gen',
-        'ať_v':             'v:loc',
-        'ať_z':             'z:gen',
-        'ať_z_strana':      'ze_strany:gen',
-        'až_do':            'do:gen',
-        'až_o':             'o:acc',
-        'během':            'během:gen',
         'bez':              'bez:gen',
         'bez_ohled_na':     'bez_ohledu_na:acc',
         'bez_zřetel_k':     'bez_zřetele_k:dat',
         'bez_zřetel_na':    'bez_zřetele_na:acc',
         'blíž':             'blízko:dat',
         'cesta':            'cestou:gen',
-        'daleko':           'nedaleko:gen',
-        'daleko_od':        'od:gen',
-        'dík':              'díky:dat',
-        'díky':             'díky:dat',
-        'dle':              'dle:gen',
-        'do':               'do:gen',
         'do_k':             'k:dat',
         'do_oblast':        'do_oblasti:gen',
         'do_rozpor_s':      'do_rozporu_s:ins',
         'do_soulad_s':      'do_souladu_s:ins',
-        'forma':            'formou:gen',
-        'i_když':           'i_když', # remove morphological case
-        'jak_aby':          'jak',
-        'jak_ad':           'jak',
-        'jakkoliv':         'jakkoli',
-        'jako':             'jako', # remove morphological case
-        'jako_kupříkladu':  'jako',
-        'jakoby':           'jako',
-        'jakoby_pod':       'pod:ins',
-        'jelikož_do':       'jelikož',
-        'jestli_že':        'jestliže',
-        'mezi_uvnitř':      'uvnitř:gen',
-        'na_báze':          'na_bázi:gen',
-        'na_čelo':          'na_čele:gen',
-        'na_mimo':          'na:loc', # na kurtě i mimo něj
-        'na_než':           'na:acc', # na víc než čtyři a půl kilometru
-        'na_od':            'na_rozdíl_od:gen',
-        'na_podklad':       'na_podkladě:gen',
-        'na_rozdíl_od':     'na_rozdíl_od:gen',
-        'na_újma':          'gen', # 'nebude na újmu' is a multi-word predicate but 'na újmu' is probably not used as an independent oblique modifier
-        'na_úroveň':        'na_úrovni:gen',
-        'na_úsek':          'na_úseku:gen',
-        'na_základ':        'na_základě:gen',
-        'na_základna':      'na_základně:gen',
-        'na_závěr':         'na_závěr:gen',
-        'namísto':          'namísto:gen',
-        'namísto_do':       'do:gen',
-        'narozdíl_od':      'na_rozdíl_od:gen',
-        'následek':         'následkem:gen',
-        'navzdory':         'navzdory:dat',
-        'nedaleko':         'nedaleko:gen',
         'než':              'než', # remove morphological case
         'nežli':            'nežli', # remove morphological case
-        'o_jako':           'jako',
-        'o_o':              'o:acc',
-        'od':               'od:gen',
         'ohledně':          'ohledně:gen',
         's_ohled_k':        's_ohledem_k:dat',
         's_ohled_na':       's_ohledem_na:acc',
@@ -110,16 +65,6 @@ class FixEdeprels(Block):
         'takže':            'takže', # remove morphological case
         'takže_a':          'takže',
         'třebaže':          'třebaže', # remove morphological case
-        'v_závislost_na':   'v_závislosti_na:loc',
-        'v_závislost_s':    'v_závislosti_s:ins',
-        'v_znamení':        've_znamení:gen',
-        'včetně':           'včetně:gen',
-        'vedle':            'vedle:gen',
-        'vina':             'vinou:gen',
-        'vliv':             'vlivem:gen',
-        'vůči':             'vůči:dat',
-        'vzhledem':         'vzhledem_k:dat',
-        'vzhledem_k':       'vzhledem_k:dat',
         'že_za':            'za:gen'
     }
 
@@ -178,7 +123,7 @@ def process_node(self, node):
                 # The following prepositions have more than one morphological case
                 # available. Thanks to the Case feature on prepositions, we can
                 # identify the correct one.
-                m = re.match(r'^(obl(?::arg)?|nmod):(před)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
+                m = re.match(r'^(obl(?::arg)?|nmod):(už)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
                 if m:
                     adpcase = self.copy_case_from_adposition(node, m.group(2))
                     if adpcase and not re.search(r':(nom|gen|dat|voc)$', adpcase):

From 1e4dc917ebc0459588a05362addb58f0c057c8b7 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 11:44:35 +0200
Subject: [PATCH 0911/1374] Removed some Czech defaults from Lithuanian.

---
 udapi/block/ud/lt/fixedeprels.py | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index bd4dd7c9..a9e94f21 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -36,21 +36,18 @@ class FixEdeprels(Block):
         'pagal':            'pagal:acc', # according to, under, by
         'pagal_dėl':        'pagal:acc',
         'per':              'per:acc', # through, over (přes)
+        'tarp':             'tarp:gen', # between
 
         'aby_na':           'na:loc',
         'bez':              'bez:gen',
         'bez_ohled_na':     'bez_ohledu_na:acc',
         'bez_zřetel_k':     'bez_zřetele_k:dat',
         'bez_zřetel_na':    'bez_zřetele_na:acc',
-        'blíž':             'blízko:dat',
-        'cesta':            'cestou:gen',
         'do_k':             'k:dat',
         'do_oblast':        'do_oblasti:gen',
         'do_rozpor_s':      'do_rozporu_s:ins',
         'do_soulad_s':      'do_souladu_s:ins',
         'než':              'než', # remove morphological case
-        'nežli':            'nežli', # remove morphological case
-        'ohledně':          'ohledně:gen',
         's_ohled_k':        's_ohledem_k:dat',
         's_ohled_na':       's_ohledem_na:acc',
         's_pomoc':          's_pomocí:gen',
@@ -60,11 +57,6 @@ class FixEdeprels(Block):
         's_vyloučení':      's_vyloučením:gen',
         's_zřetel_k':       'se_zřetelem_k:dat',
         's_zřetel_na':      'se_zřetelem_na:acc',
-        'severně_od':       'od:gen',
-        'skrz':             'skrz:acc',
-        'takže':            'takže', # remove morphological case
-        'takže_a':          'takže',
-        'třebaže':          'třebaže', # remove morphological case
         'že_za':            'za:gen'
     }
 

From 549172758258bf788169232a8118da4b939af03e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 11:52:44 +0200
Subject: [PATCH 0912/1374] Removed some Czech defaults from Lithuanian.

---
 udapi/block/ud/lt/fixedeprels.py | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index a9e94f21..f9d39ef7 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -36,6 +36,7 @@ class FixEdeprels(Block):
         'pagal':            'pagal:acc', # according to, under, by
         'pagal_dėl':        'pagal:acc',
         'per':              'per:acc', # through, over (přes)
+        'prie':             'prie:gen', # to, at, near, under
         'tarp':             'tarp:gen', # between
 
         'aby_na':           'na:loc',
@@ -44,17 +45,9 @@ class FixEdeprels(Block):
         'bez_zřetel_k':     'bez_zřetele_k:dat',
         'bez_zřetel_na':    'bez_zřetele_na:acc',
         'do_k':             'k:dat',
-        'do_oblast':        'do_oblasti:gen',
-        'do_rozpor_s':      'do_rozporu_s:ins',
-        'do_soulad_s':      'do_souladu_s:ins',
         'než':              'než', # remove morphological case
         's_ohled_k':        's_ohledem_k:dat',
         's_ohled_na':       's_ohledem_na:acc',
-        's_pomoc':          's_pomocí:gen',
-        's_přihlédnutí_k':  's_přihlédnutím_k:dat',
-        's_přihlédnutí_na': 's_přihlédnutím_na:acc',
-        's_výjimka':        's_výjimkou:gen',
-        's_vyloučení':      's_vyloučením:gen',
         's_zřetel_k':       'se_zřetelem_k:dat',
         's_zřetel_na':      'se_zřetelem_na:acc',
         'že_za':            'za:gen'

From 0b1287683f55eb61dfaf4836e452980b281c332c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 13:54:31 +0200
Subject: [PATCH 0913/1374] Removed some Czech defaults from Lithuanian.

---
 udapi/block/ud/lt/fixedeprels.py | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index f9d39ef7..153a13db 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -25,6 +25,8 @@ class FixEdeprels(Block):
     # case, even if they are not secondary.
     unambiguous = {
         'apie':             'apie:acc', # about (topic)
+        'dėl':              'dėl:gen', # because of
+        'iki':              'iki:gen', # until
         'jei':              'jei', # remove morphological case # if
         'jeigu':            'jeigu', # remove morphological case # if
         'kaip':             'kaip', # remove morphological case # as, than
@@ -44,12 +46,6 @@ class FixEdeprels(Block):
         'bez_ohled_na':     'bez_ohledu_na:acc',
         'bez_zřetel_k':     'bez_zřetele_k:dat',
         'bez_zřetel_na':    'bez_zřetele_na:acc',
-        'do_k':             'k:dat',
-        'než':              'než', # remove morphological case
-        's_ohled_k':        's_ohledem_k:dat',
-        's_ohled_na':       's_ohledem_na:acc',
-        's_zřetel_k':       'se_zřetelem_k:dat',
-        's_zřetel_na':      'se_zřetelem_na:acc',
         'že_za':            'za:gen'
     }
 

From fdc7e3c42e6e21ac91dc00548c42155a48f226cd Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 13:59:57 +0200
Subject: [PATCH 0914/1374] Removed some Czech defaults from Lithuanian.

---
 udapi/block/ud/lt/fixedeprels.py | 16 +---------------
 1 file changed, 1 insertion(+), 15 deletions(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index 153a13db..d57e3db5 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -35,6 +35,7 @@ class FixEdeprels(Block):
         'kaip_prieš':       'kaip',
         'kaip_su':          'kaip',
         'nes':              'nes', # remove morphological case # because
+        'nors':             'nors', # remove morphological case # though, although, when, if
         'pagal':            'pagal:acc', # according to, under, by
         'pagal_dėl':        'pagal:acc',
         'per':              'per:acc', # through, over (přes)
@@ -115,21 +116,6 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):kdy$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):neboť$', r'\1', edep['deprel']) # 'neboť' is coordinating
-                edep['deprel'] = re.sub(r'^(advcl):nechť$', r'\1', edep['deprel'])
-                if edep['deprel'] == 'acl:v' and node.form == 'patře':
-                    edep['deprel'] = 'nmod:v:loc'
-                    node.deprel = 'nmod'
-                    node.lemma = 'patro'
-                    node.upos = 'NOUN'
-                    node.xpos = 'NNNS6-----A----'
-                    node.feats['Aspect'] = ''
-                    node.feats['Gender'] = 'Neut'
-                    node.feats['Tense'] = ''
-                    node.feats['VerbForm'] = ''
-                    node.feats['Voice'] = ''
             elif re.match(r'^(nmod|obl(:arg)?):', edep['deprel']):
                 edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
                 edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits

From 6b577cd59e78c85ba51f63a680bc7b8ad78b9506 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 14:20:00 +0200
Subject: [PATCH 0915/1374] nuo:gen

---
 udapi/block/ud/lt/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index d57e3db5..db2854b4 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -36,6 +36,7 @@ class FixEdeprels(Block):
         'kaip_su':          'kaip',
         'nes':              'nes', # remove morphological case # because
         'nors':             'nors', # remove morphological case # though, although, when, if
+        'nuo':              'nuo:gen', # from
         'pagal':            'pagal:acc', # according to, under, by
         'pagal_dėl':        'pagal:acc',
         'per':              'per:acc', # through, over (přes)

From bc350beee3e0ab489dfb2c4612a94dc732600d7b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 14:26:16 +0200
Subject: [PATCH 0916/1374] po + gen/acc/ins

---
 udapi/block/ud/lt/fixedeprels.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index db2854b4..35974987 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -105,11 +105,12 @@ def process_node(self, node):
                     continue
                 # The following prepositions have more than one morphological case
                 # available. Thanks to the Case feature on prepositions, we can
-                # identify the correct one.
-                m = re.match(r'^(obl(?::arg)?|nmod):(už)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
+                # identify the correct one. Exclude 'nom' and 'voc', which cannot
+                # be correct.
+                m = re.match(r'^(obl(?::arg)?|nmod):(po|už)(?::(?:nom|voc))?$', edep['deprel'])
                 if m:
                     adpcase = self.copy_case_from_adposition(node, m.group(2))
-                    if adpcase and not re.search(r':(nom|gen|dat|voc)$', adpcase):
+                    if adpcase and not re.search(r':(nom|voc)$', adpcase):
                         edep['deprel'] = m.group(1)+':'+adpcase
                         continue
             if re.match(r'^(acl|advcl):', edep['deprel']):

From 84c7fcea8205f45374472644b1c2e5993aade5a9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 14:50:37 +0200
Subject: [PATCH 0917/1374] po + gen/acc/ins

---
 udapi/block/ud/lt/fixedeprels.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index 35974987..a6df1da6 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -113,6 +113,10 @@ def process_node(self, node):
                     if adpcase and not re.search(r':(nom|voc)$', adpcase):
                         edep['deprel'] = m.group(1)+':'+adpcase
                         continue
+                    # The remaining instance of 'po' should be ':acc'.
+                    elif m.group(2) == 'po':
+                        edep['deprel'] = m.group(1)+':po:acc'
+                        continue
             if re.match(r'^(acl|advcl):', edep['deprel']):
                 # We do not include 'i' in the list of redundant prefixes because we want to preserve 'i když' (but we want to discard the other combinations).
                 edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])

From d51a4a739ae9b9000626a7daab54e62832dfa9f1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 15:18:00 +0200
Subject: [PATCH 0918/1374] =?UTF-8?q?=C4=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/lt/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index a6df1da6..9fd462ba 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -27,6 +27,7 @@ class FixEdeprels(Block):
         'apie':             'apie:acc', # about (topic)
         'dėl':              'dėl:gen', # because of
         'iki':              'iki:gen', # until
+        'į':                'į:acc', # to, into, in
         'jei':              'jei', # remove morphological case # if
         'jeigu':            'jeigu', # remove morphological case # if
         'kaip':             'kaip', # remove morphological case # as, than

From fe58cd66f04c1f4f8ee2f94b321ec81b69aaf5e9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 15:24:51 +0200
Subject: [PATCH 0919/1374] =?UTF-8?q?prie=C5=A1:acc?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/lt/fixedeprels.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index 9fd462ba..f34f0230 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -42,10 +42,9 @@ class FixEdeprels(Block):
         'pagal_dėl':        'pagal:acc',
         'per':              'per:acc', # through, over (přes)
         'prie':             'prie:gen', # to, at, near, under
+        'prieš':            'prieš:acc', # against
         'tarp':             'tarp:gen', # between
 
-        'aby_na':           'na:loc',
-        'bez':              'bez:gen',
         'bez_ohled_na':     'bez_ohledu_na:acc',
         'bez_zřetel_k':     'bez_zřetele_k:dat',
         'bez_zřetel_na':    'bez_zřetele_na:acc',

From 48aa4d2df0f2e70d1c6cd0035b5f9eb86fea5800 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 15:34:00 +0200
Subject: [PATCH 0920/1374] su:ins

---
 udapi/block/ud/lt/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index f34f0230..80f92ba4 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -43,6 +43,7 @@ class FixEdeprels(Block):
         'per':              'per:acc', # through, over (přes)
         'prie':             'prie:gen', # to, at, near, under
         'prieš':            'prieš:acc', # against
+        'su':               'su:ins', # with
         'tarp':             'tarp:gen', # between
 
         'bez_ohled_na':     'bez_ohledu_na:acc',

From 4784a8a3b52e85fa482de3689ecd745ed9db758b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 15:46:36 +0200
Subject: [PATCH 0921/1374] nei

---
 udapi/block/ud/lt/fixedeprels.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index 80f92ba4..e6c9036d 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -12,10 +12,8 @@ class FixEdeprels(Block):
     # by all the inner cases.
     # The list in the value contains exceptions that should be left intact.
     outermost = {
-        'kaip':    [],
-
-        'než':     ['než_aby'],
-        'třebaže': []
+        'kaip': [],
+        'nei':  []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -35,6 +33,7 @@ class FixEdeprels(Block):
         'kaip_per':         'kaip',
         'kaip_prieš':       'kaip',
         'kaip_su':          'kaip',
+        'nei':              'nei', # remove morphological case # more than
         'nes':              'nes', # remove morphological case # because
         'nors':             'nors', # remove morphological case # though, although, when, if
         'nuo':              'nuo:gen', # from

From 809aae44e53dd6540bcd692d9b20f637523d8d98 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 17:09:21 +0200
Subject: [PATCH 0922/1374] kadangi

---
 udapi/block/ud/lt/fixedeprels.py | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index e6c9036d..b13fcebd 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -13,7 +13,8 @@ class FixEdeprels(Block):
     # The list in the value contains exceptions that should be left intact.
     outermost = {
         'kaip': [],
-        'nei':  []
+        'nei':  [],
+        'nes':  []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -28,11 +29,8 @@ class FixEdeprels(Block):
         'į':                'į:acc', # to, into, in
         'jei':              'jei', # remove morphological case # if
         'jeigu':            'jeigu', # remove morphological case # if
+        'kadangi':          'kadangi', # remove morphological case # since, because
         'kaip':             'kaip', # remove morphological case # as, than
-        'kaip_į':           'kaip',
-        'kaip_per':         'kaip',
-        'kaip_prieš':       'kaip',
-        'kaip_su':          'kaip',
         'nei':              'nei', # remove morphological case # more than
         'nes':              'nes', # remove morphological case # because
         'nors':             'nors', # remove morphological case # though, although, when, if

From 24f65bf06a8ca4566538b4ab9fe0e8135743b4c0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 May 2024 19:58:27 +0200
Subject: [PATCH 0923/1374] jog

---
 udapi/block/ud/lt/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index b13fcebd..f330dc3e 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -29,6 +29,7 @@ class FixEdeprels(Block):
         'į':                'į:acc', # to, into, in
         'jei':              'jei', # remove morphological case # if
         'jeigu':            'jeigu', # remove morphological case # if
+        'jog':              'jog', # remove morphological case # because
         'kadangi':          'kadangi', # remove morphological case # since, because
         'kaip':             'kaip', # remove morphological case # as, than
         'nei':              'nei', # remove morphological case # more than

From 4dc4414022083452d23ff20bbca9b8a423f5bd78 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 12 May 2024 10:58:39 +0200
Subject: [PATCH 0924/1374] negu

---
 udapi/block/ud/lt/fixedeprels.py | 17 +++--------------
 1 file changed, 3 insertions(+), 14 deletions(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index f330dc3e..2fbe1daa 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -13,6 +13,7 @@ class FixEdeprels(Block):
     # The list in the value contains exceptions that should be left intact.
     outermost = {
         'kaip': [],
+        'negu': [],
         'nei':  [],
         'nes':  []
     }
@@ -32,6 +33,7 @@ class FixEdeprels(Block):
         'jog':              'jog', # remove morphological case # because
         'kadangi':          'kadangi', # remove morphological case # since, because
         'kaip':             'kaip', # remove morphological case # as, than
+        'negu':             'negu', # remove morphological case # than
         'nei':              'nei', # remove morphological case # more than
         'nes':              'nes', # remove morphological case # because
         'nors':             'nors', # remove morphological case # though, although, when, if
@@ -42,12 +44,7 @@ class FixEdeprels(Block):
         'prie':             'prie:gen', # to, at, near, under
         'prieš':            'prieš:acc', # against
         'su':               'su:ins', # with
-        'tarp':             'tarp:gen', # between
-
-        'bez_ohled_na':     'bez_ohledu_na:acc',
-        'bez_zřetel_k':     'bez_zřetele_k:dat',
-        'bez_zřetel_na':    'bez_zřetele_na:acc',
-        'že_za':            'za:gen'
+        'tarp':             'tarp:gen' # between
     }
 
     def copy_case_from_adposition(self, node, adposition):
@@ -116,14 +113,6 @@ def process_node(self, node):
                     elif m.group(2) == 'po':
                         edep['deprel'] = m.group(1)+':po:acc'
                         continue
-            if re.match(r'^(acl|advcl):', edep['deprel']):
-                # We do not include 'i' in the list of redundant prefixes because we want to preserve 'i když' (but we want to discard the other combinations).
-                edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
-            elif re.match(r'^(nmod|obl(:arg)?):', edep['deprel']):
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
 
     def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
         '''

From ff19cb670c929772b53c5464324ec4a10e767e63 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 12 May 2024 11:10:43 +0200
Subject: [PATCH 0925/1374] =?UTF-8?q?obl:arg:u=C5=BE:acc?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/lt/fixedeprels.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index 2fbe1daa..b913f505 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -113,6 +113,11 @@ def process_node(self, node):
                     elif m.group(2) == 'po':
                         edep['deprel'] = m.group(1)+':po:acc'
                         continue
+                    # The remaining 'už' are ':acc' (they are second conjuncts
+                    # in coordinated oblique modifiers).
+                    elif m.group(2) == 'už':
+                        edep['deprel'] = m.group(1)+':už:acc'
+                        continue
 
     def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
         '''

From 6fa9da85f552a17849b06e17a9a73bcd1ec086e8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 12 May 2024 11:19:59 +0200
Subject: [PATCH 0926/1374] lyg

---
 udapi/block/ud/lt/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index b913f505..feb4769e 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -13,6 +13,7 @@ class FixEdeprels(Block):
     # The list in the value contains exceptions that should be left intact.
     outermost = {
         'kaip': [],
+        'lyg':  [],
         'negu': [],
         'nei':  [],
         'nes':  []
@@ -33,6 +34,7 @@ class FixEdeprels(Block):
         'jog':              'jog', # remove morphological case # because
         'kadangi':          'kadangi', # remove morphological case # since, because
         'kaip':             'kaip', # remove morphological case # as, than
+        'lyg':              'lyg', # remove morphological case # like
         'negu':             'negu', # remove morphological case # than
         'nei':              'nei', # remove morphological case # more than
         'nes':              'nes', # remove morphological case # because

From cdf94bbd8100d925d31950950b7d90480d500f40 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 12 May 2024 11:46:11 +0200
Subject: [PATCH 0927/1374] =?UTF-8?q?i=C5=A1:gen?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/lt/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index feb4769e..f093360d 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -28,6 +28,7 @@ class FixEdeprels(Block):
         'apie':             'apie:acc', # about (topic)
         'dėl':              'dėl:gen', # because of
         'iki':              'iki:gen', # until
+        'iš':               'iš:gen', # from, out of
         'į':                'į:acc', # to, into, in
         'jei':              'jei', # remove morphological case # if
         'jeigu':            'jeigu', # remove morphological case # if

From 4f0a63ae45782109155a8649aeb171b05f08e610 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 12 May 2024 11:49:23 +0200
Subject: [PATCH 0928/1374] =?UTF-8?q?vir=C5=A1:gen?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/lt/fixedeprels.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index f093360d..457451ec 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -47,7 +47,8 @@ class FixEdeprels(Block):
         'prie':             'prie:gen', # to, at, near, under
         'prieš':            'prieš:acc', # against
         'su':               'su:ins', # with
-        'tarp':             'tarp:gen' # between
+        'tarp':             'tarp:gen', # between
+        'virš':             'virš:gen' # above
     }
 
     def copy_case_from_adposition(self, node, adposition):

From 297483c2c89fc2144374c866bd6b42473188135c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 12 May 2024 11:55:32 +0200
Subject: [PATCH 0929/1374] tarsi

---
 udapi/block/ud/lt/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index 457451ec..3b5cd819 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -48,6 +48,7 @@ class FixEdeprels(Block):
         'prieš':            'prieš:acc', # against
         'su':               'su:ins', # with
         'tarp':             'tarp:gen', # between
+        'tarsi':            'tarsi', # remove morphological case # as if
         'virš':             'virš:gen' # above
     }
 

From 043514975f2ebcd815603a3163ca37a8b5615d2a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 12 May 2024 12:11:24 +0200
Subject: [PATCH 0930/1374] kai

---
 udapi/block/ud/lt/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/lt/fixedeprels.py b/udapi/block/ud/lt/fixedeprels.py
index 3b5cd819..9b1cb98d 100644
--- a/udapi/block/ud/lt/fixedeprels.py
+++ b/udapi/block/ud/lt/fixedeprels.py
@@ -34,6 +34,7 @@ class FixEdeprels(Block):
         'jeigu':            'jeigu', # remove morphological case # if
         'jog':              'jog', # remove morphological case # because
         'kadangi':          'kadangi', # remove morphological case # since, because
+        'kai':              'kai', # remove morphological case # when
         'kaip':             'kaip', # remove morphological case # as, than
         'lyg':              'lyg', # remove morphological case # like
         'negu':             'negu', # remove morphological case # than

From d7fc75d6c7ae9018ec2fe6e9922f574d277bd022 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 13 May 2024 19:23:13 +0200
Subject: [PATCH 0931/1374] Cloned Arabic from Lithuanian.

---
 udapi/block/ud/ar/fixedeprels.py | 122 +++++++++++++++++++++++++++++++
 1 file changed, 122 insertions(+)
 create mode 100644 udapi/block/ud/ar/fixedeprels.py

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
new file mode 100644
index 00000000..7f0e185c
--- /dev/null
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -0,0 +1,122 @@
+"""Block to fix case-enhanced dependency relations in Arabic."""
+from udapi.core.block import Block
+import logging
+import re
+
+class FixEdeprels(Block):
+
+    # Sometimes there are multiple layers of case marking and only the outermost
+    # layer should be reflected in the relation. For example, the semblative 'jako'
+    # is used with the same case (preposition + morphology) as the nominal that
+    # is being compared ('jako_v:loc' etc.) We do not want to multiply the relations
+    # by all the inner cases.
+    # The list in the value contains exceptions that should be left intact.
+    outermost = {
+        'kaip': [],
+        'lyg':  [],
+        'negu': [],
+        'nei':  [],
+        'nes':  []
+    }
+
+    # Secondary prepositions sometimes have the lemma of the original part of
+    # speech. We want the grammaticalized form instead. List even those that
+    # will have the same lexical form, as we also want to check the morphological
+    # case. And include all other prepositions that have unambiguous morphological
+    # case, even if they are not secondary.
+    unambiguous = {
+        'فِي':             'فِي:gen', # fī = in
+        'dėl':              'dėl:gen', # because of
+        'nors':             'nors', # remove morphological case # though, although, when, if
+        'virš':             'virš:gen' # above
+    }
+
+    def copy_case_from_adposition(self, node, adposition):
+        """
+        In some treebanks, adpositions have the Case feature and it denotes the
+        valency case that the preposition's nominal must be in.
+        """
+        # The following is only partial solution. We will not see
+        # some children because they may be shared children of coordination.
+        prepchildren = [x for x in node.children if x.lemma == adposition]
+        if len(prepchildren) > 0 and prepchildren[0].feats['Case'] != '':
+            return adposition+':'+prepchildren[0].feats['Case'].lower()
+        else:
+            return None
+
+    def process_node(self, node):
+        """
+        Occasionally the edeprels automatically derived from the Czech basic
+        trees do not match the whitelist. For example, the noun is an
+        abbreviation and its morphological case is unknown.
+        """
+        for edep in node.deps:
+            m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):', edep['deprel'])
+            if m:
+                bdeprel = m.group(1)
+                solved = False
+                # Issues caused by errors in the original annotation must be fixed early.
+                # Especially if acl|advcl occurs with a preposition that unambiguously
+                # receives a morphological case in the subsequent steps, and then gets
+                # flagged as solved.
+                edep['deprel'] = re.sub(r'^advcl:do(?::gen)?$', r'obl:do:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
+                edep['deprel'] = re.sub(r'^acl:k(?::dat)?$', r'acl', edep['deprel'])
+                # If one of the following expressions occurs followed by another preposition
+                # or by morphological case, remove the additional case marking. For example,
+                # 'jako_v' becomes just 'jako'.
+                for x in self.outermost:
+                    exceptions = self.outermost[x]
+                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'([_:].+)?$', edep['deprel'])
+                    if m and m.group(2) and not x+m.group(2) in exceptions:
+                        edep['deprel'] = m.group(1)+':'+x
+                        solved = True
+                        break
+                if solved:
+                    continue
+                for x in self.unambiguous:
+                    # All secondary prepositions have only one fixed morphological case
+                    # they appear with, so we can replace whatever case we encounter with the correct one.
+                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?$', edep['deprel'])
+                    if m:
+                        edep['deprel'] = m.group(1)+':'+self.unambiguous[x]
+                        solved = True
+                        break
+                if solved:
+                    continue
+                # The following prepositions have more than one morphological case
+                # available. Thanks to the Case feature on prepositions, we can
+                # identify the correct one. Exclude 'nom' and 'voc', which cannot
+                # be correct.
+                m = re.match(r'^(obl(?::arg)?|nmod):(po|už)(?::(?:nom|voc))?$', edep['deprel'])
+                if m:
+                    adpcase = self.copy_case_from_adposition(node, m.group(2))
+                    if adpcase and not re.search(r':(nom|voc)$', adpcase):
+                        edep['deprel'] = m.group(1)+':'+adpcase
+                        continue
+                    # The remaining instance of 'po' should be ':acc'.
+                    elif m.group(2) == 'po':
+                        edep['deprel'] = m.group(1)+':po:acc'
+                        continue
+                    # The remaining 'už' are ':acc' (they are second conjuncts
+                    # in coordinated oblique modifiers).
+                    elif m.group(2) == 'už':
+                        edep['deprel'] = m.group(1)+':už:acc'
+                        continue
+
+    def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
+        '''
+        Modifies the incoming relation of a node both in the basic tree and in
+        the enhanced graph. If the node does not yet depend in the enhanced
+        graph on the current basic parent, the new relation will be added without
+        removing any old one. If the node already depends multiple times on the
+        current basic parent in the enhanced graph, all such enhanced relations
+        will be removed before adding the new one.
+        '''
+        old_parent = node.parent
+        node.parent = parent
+        node.deprel = deprel
+        node.deps = [x for x in node.deps if x['parent'] != old_parent]
+        new_edep = {}
+        new_edep['parent'] = parent
+        new_edep['deprel'] = edeprel
+        node.deps.append(new_edep)

From c2c5809e857369e9d49c6328a3c442f72116a3da Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 13 May 2024 20:50:54 +0200
Subject: [PATCH 0932/1374] =?UTF-8?q?=D9=84=D9=90?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 7f0e185c..50375c81 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -12,10 +12,6 @@ class FixEdeprels(Block):
     # by all the inner cases.
     # The list in the value contains exceptions that should be left intact.
     outermost = {
-        'kaip': [],
-        'lyg':  [],
-        'negu': [],
-        'nei':  [],
         'nes':  []
     }
 
@@ -25,8 +21,8 @@ class FixEdeprels(Block):
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
-        'فِي':             'فِي:gen', # fī = in
-        'dėl':              'dėl:gen', # because of
+        'فِي':   'فِي:gen', # fī = in
+        'لِ':    'لِ:gen', # li = to
         'nors':             'nors', # remove morphological case # though, although, when, if
         'virš':             'virš:gen' # above
     }

From d9178ea9ecef65abcaaa8527f40db2c5db90ca5e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 13 May 2024 21:17:10 +0200
Subject: [PATCH 0933/1374] =?UTF-8?q?=D9=85=D9=90=D9=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 50375c81..39dba833 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -23,6 +23,7 @@ class FixEdeprels(Block):
     unambiguous = {
         'فِي':   'فِي:gen', # fī = in
         'لِ':    'لِ:gen', # li = to
+        'مِن':   'مِن:gen', # min = from
         'nors':             'nors', # remove morphological case # though, although, when, if
         'virš':             'virš:gen' # above
     }

From d7a47db16221b8ac8db51623e77107ab49fbfa89 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 13 May 2024 21:54:00 +0200
Subject: [PATCH 0934/1374] =?UTF-8?q?=D8=A8=D9=90?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 39dba833..b5549da0 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -24,6 +24,7 @@ class FixEdeprels(Block):
         'فِي':   'فِي:gen', # fī = in
         'لِ':    'لِ:gen', # li = to
         'مِن':   'مِن:gen', # min = from
+        'بِ':    'بِ:gen', # bi = for, with
         'nors':             'nors', # remove morphological case # though, although, when, if
         'virš':             'virš:gen' # above
     }

From 4eda847c9a8e991299f04a5359be5344932e7d81 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 14 May 2024 08:28:42 +0200
Subject: [PATCH 0935/1374] =?UTF-8?q?=D8=B9=D9=8E=D9=84=D9=8E=D9=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index b5549da0..319e160a 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -21,10 +21,11 @@ class FixEdeprels(Block):
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
-        'فِي':   'فِي:gen', # fī = in
-        'لِ':    'لِ:gen', # li = to
-        'مِن':   'مِن:gen', # min = from
-        'بِ':    'بِ:gen', # bi = for, with
+        'فِي':    'فِي:gen', # fī = in
+        'لِ':     'لِ:gen', # li = to
+        'مِن':    'مِن:gen', # min = from
+        'بِ':     'بِ:gen', # bi = for, with
+        'عَلَى':   'عَلَى:gen', # ʿalā = on
         'nors':             'nors', # remove morphological case # though, although, when, if
         'virš':             'virš:gen' # above
     }

From d4a1e6705d1b55391bb87f77878026042b4c4a47 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 14 May 2024 08:57:19 +0200
Subject: [PATCH 0936/1374] =?UTF-8?q?=D8=A5=D9=90=D9=84=D9=8E=D9=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 319e160a..6770d8b4 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -26,6 +26,7 @@ class FixEdeprels(Block):
         'مِن':    'مِن:gen', # min = from
         'بِ':     'بِ:gen', # bi = for, with
         'عَلَى':   'عَلَى:gen', # ʿalā = on
+        'إِلَى':   'إِلَى:gen', # ʾilā = to
         'nors':             'nors', # remove morphological case # though, although, when, if
         'virš':             'virš:gen' # above
     }

From a37695fdc346410512ac9e1df6af56d323433cae Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 14 May 2024 09:29:52 +0200
Subject: [PATCH 0937/1374] =?UTF-8?q?'=D8=A8=D9=8E=D9=8A=D9=86=D9=8E':=20?=
 =?UTF-8?q?=20=20'=D8=A8=D9=8E=D9=8A=D9=86=D9=8E:gen',=20#=20bayna=20=3D?=
 =?UTF-8?q?=20between?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 6770d8b4..c56c6d9d 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -27,6 +27,7 @@ class FixEdeprels(Block):
         'بِ':     'بِ:gen', # bi = for, with
         'عَلَى':   'عَلَى:gen', # ʿalā = on
         'إِلَى':   'إِلَى:gen', # ʾilā = to
+        'بَينَ':   'بَينَ:gen', # bayna = between
         'nors':             'nors', # remove morphological case # though, although, when, if
         'virš':             'virš:gen' # above
     }

From 1865be32c36c84ada0c58dfea3744c325049e8f9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 14 May 2024 10:03:33 +0200
Subject: [PATCH 0938/1374] =?UTF-8?q?'=D9=85=D9=8E=D8=B9=D9=8E':=20=20=20?=
 =?UTF-8?q?=20'=D9=85=D9=8E=D8=B9=D9=8E:gen',=20#=20ma=CA=BFa=20=3D=20with?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index c56c6d9d..6b415d62 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -28,6 +28,7 @@ class FixEdeprels(Block):
         'عَلَى':   'عَلَى:gen', # ʿalā = on
         'إِلَى':   'إِلَى:gen', # ʾilā = to
         'بَينَ':   'بَينَ:gen', # bayna = between
+        'مَعَ':    'مَعَ:gen', # maʿa = with
         'nors':             'nors', # remove morphological case # though, although, when, if
         'virš':             'virš:gen' # above
     }

From c6d4b273f1a21e554b97f89a28a37bfaa55d172a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 14 May 2024 10:32:49 +0200
Subject: [PATCH 0939/1374] =?UTF-8?q?'=D8=B9=D9=8E=D9=86':=20=20=20=20'?=
 =?UTF-8?q?=D8=B9=D9=8E=D9=86:gen',=20#=20=CA=BFan=20=3D=20about,=20from?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 6b415d62..8084aa87 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -29,6 +29,7 @@ class FixEdeprels(Block):
         'إِلَى':   'إِلَى:gen', # ʾilā = to
         'بَينَ':   'بَينَ:gen', # bayna = between
         'مَعَ':    'مَعَ:gen', # maʿa = with
+        'عَن':    'عَن:gen', # ʿan = about, from
         'nors':             'nors', # remove morphological case # though, although, when, if
         'virš':             'virš:gen' # above
     }

From aec625d65580cdb058aadfe4c1789ac36263f3a4 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 14 May 2024 12:13:18 +0200
Subject: [PATCH 0940/1374] =?UTF-8?q?'=D8=AE=D9=90=D9=84=D9=8E=D8=A7=D9=84?=
 =?UTF-8?q?=D9=8E':=20=20=20'=D8=AE=D9=90=D9=84=D9=8E=D8=A7=D9=84=D9=8E:ge?=
 =?UTF-8?q?n',=20#=20=E1=B8=ABil=C4=81la=20=3D=20during?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 8084aa87..8e33dd5f 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -30,6 +30,7 @@ class FixEdeprels(Block):
         'بَينَ':   'بَينَ:gen', # bayna = between
         'مَعَ':    'مَعَ:gen', # maʿa = with
         'عَن':    'عَن:gen', # ʿan = about, from
+        'خِلَالَ':   'خِلَالَ:gen', # ḫilāla = during
         'nors':             'nors', # remove morphological case # though, although, when, if
         'virš':             'virš:gen' # above
     }

From 5a807332faa0c2a6d2973a25c174cf98f89888d6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 14 May 2024 14:46:48 +0200
Subject: [PATCH 0941/1374] =?UTF-8?q?'=D8=A8=D9=8E=D8=B9=D8=AF=D9=8E':=20?=
 =?UTF-8?q?=20=20'=D8=A8=D9=8E=D8=B9=D8=AF=D9=8E:gen',=20#=20ba=CA=BFda=20?=
 =?UTF-8?q?=3D=20after?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 8e33dd5f..ef9a0e05 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -31,6 +31,7 @@ class FixEdeprels(Block):
         'مَعَ':    'مَعَ:gen', # maʿa = with
         'عَن':    'عَن:gen', # ʿan = about, from
         'خِلَالَ':   'خِلَالَ:gen', # ḫilāla = during
+        'بَعدَ':   'بَعدَ:gen', # baʿda = after
         'nors':             'nors', # remove morphological case # though, although, when, if
         'virš':             'virš:gen' # above
     }

From f0a12cb7391456de112b574b913c4adb6f000549 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 16 May 2024 19:37:57 +0200
Subject: [PATCH 0942/1374] mundu=since

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index ef9a0e05..158358ed 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -32,6 +32,7 @@ class FixEdeprels(Block):
         'عَن':    'عَن:gen', # ʿan = about, from
         'خِلَالَ':   'خِلَالَ:gen', # ḫilāla = during
         'بَعدَ':   'بَعدَ:gen', # baʿda = after
+        'مُنذُ':   'مُنذُ:gen', # munḏu = since
         'nors':             'nors', # remove morphological case # though, although, when, if
         'virš':             'virš:gen' # above
     }

From 3620d2fad4caf71dc9db01af00dbde7635056136 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 16 May 2024 20:15:22 +0200
Subject: [PATCH 0943/1374] hawla=about

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 158358ed..ec435d35 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -33,6 +33,7 @@ class FixEdeprels(Block):
         'خِلَالَ':   'خِلَالَ:gen', # ḫilāla = during
         'بَعدَ':   'بَعدَ:gen', # baʿda = after
         'مُنذُ':   'مُنذُ:gen', # munḏu = since
+        'حَولَ':   'حَولَ:gen', # ḥawla = about
         'nors':             'nors', # remove morphological case # though, although, when, if
         'virš':             'virš:gen' # above
     }

From 277b7bcbd117bc0c0596c19214c5527da5b68219 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 16 May 2024 22:07:32 +0200
Subject: [PATCH 0944/1374] =?UTF-8?q?=D8=A3=D9=8E=D9=86=D9=8E=D9=91?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index ec435d35..b2547d84 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -12,7 +12,7 @@ class FixEdeprels(Block):
     # by all the inner cases.
     # The list in the value contains exceptions that should be left intact.
     outermost = {
-        'nes':  []
+        'أَنَّ':  []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -34,7 +34,7 @@ class FixEdeprels(Block):
         'بَعدَ':   'بَعدَ:gen', # baʿda = after
         'مُنذُ':   'مُنذُ:gen', # munḏu = since
         'حَولَ':   'حَولَ:gen', # ḥawla = about
-        'nors':             'nors', # remove morphological case # though, although, when, if
+        'أَنَّ':    'أَنَّ', # remove morphological case; ʾanna = that
         'virš':             'virš:gen' # above
     }
 

From 83f3b86d0e9f58518c6f756866f64e8ebfc06604 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 18 May 2024 11:55:50 +0200
Subject: [PATCH 0945/1374] =?UTF-8?q?'=D9=82=D9=8E=D8=A8=D9=84=D9=8E':=20?=
 =?UTF-8?q?=20=20'=D9=82=D9=8E=D8=A8=D9=84=D9=8E:gen',=20#=20qabla=20=3D?=
 =?UTF-8?q?=20before?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index b2547d84..7ace7c7b 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -35,6 +35,7 @@ class FixEdeprels(Block):
         'مُنذُ':   'مُنذُ:gen', # munḏu = since
         'حَولَ':   'حَولَ:gen', # ḥawla = about
         'أَنَّ':    'أَنَّ', # remove morphological case; ʾanna = that
+        'قَبلَ':   'قَبلَ:gen', # qabla = before
         'virš':             'virš:gen' # above
     }
 

From 65f1b33e05f7f96d2465aa500aedde02895fda88 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 18 May 2024 12:15:11 +0200
Subject: [PATCH 0946/1374] =?UTF-8?q?'=D8=A3=D9=8E=D9=85=D9=8E=D8=A7=D9=85?=
 =?UTF-8?q?=D9=8E':=20=20'=D8=A3=D9=8E=D9=85=D9=8E=D8=A7=D9=85=D9=8E:gen',?=
 =?UTF-8?q?=20#=20=CA=BEam=C4=81ma=20=3D=20in=20front=20of?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 7ace7c7b..4cff9ad1 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -36,6 +36,7 @@ class FixEdeprels(Block):
         'حَولَ':   'حَولَ:gen', # ḥawla = about
         'أَنَّ':    'أَنَّ', # remove morphological case; ʾanna = that
         'قَبلَ':   'قَبلَ:gen', # qabla = before
+        'أَمَامَ':  'أَمَامَ:gen', # ʾamāma = in front of
         'virš':             'virš:gen' # above
     }
 

From 8bb2e02e818dd0a7c590f34243e4e60f090d1b7c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 18 May 2024 12:27:51 +0200
Subject: [PATCH 0947/1374] =?UTF-8?q?=D8=A5=D9=90=D8=B0=D9=8E=D8=A7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 4cff9ad1..15556391 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -12,7 +12,8 @@ class FixEdeprels(Block):
     # by all the inner cases.
     # The list in the value contains exceptions that should be left intact.
     outermost = {
-        'أَنَّ':  []
+        'أَنَّ':  [],
+        'إِذَا': []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -37,6 +38,7 @@ class FixEdeprels(Block):
         'أَنَّ':    'أَنَّ', # remove morphological case; ʾanna = that
         'قَبلَ':   'قَبلَ:gen', # qabla = before
         'أَمَامَ':  'أَمَامَ:gen', # ʾamāma = in front of
+        'إِذَا':   'إِذَا', # remove morphological case; ʾiḏā = if
         'virš':             'virš:gen' # above
     }
 

From b8a6592ca9e4c200eebb27e1ac684f24c1eeb883 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 18 May 2024 13:10:16 +0200
Subject: [PATCH 0948/1374] =?UTF-8?q?'=D8=A8=D9=90=5F=D8=B3=D9=8E=D8=A8?=
 =?UTF-8?q?=D9=8E=D8=A8':=20'=D8=A8=D9=90=D8=B3=D9=8E=D8=A8=D9=8E=D8=A8?=
 =?UTF-8?q?=D9=90:gen',=20#=20bisababi=20=3D=20because=20of?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 15556391..d0ef1a78 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -39,6 +39,7 @@ class FixEdeprels(Block):
         'قَبلَ':   'قَبلَ:gen', # qabla = before
         'أَمَامَ':  'أَمَامَ:gen', # ʾamāma = in front of
         'إِذَا':   'إِذَا', # remove morphological case; ʾiḏā = if
+        'بِ_سَبَب': 'بِسَبَبِ:gen', # bisababi = because of
         'virš':             'virš:gen' # above
     }
 

From 4772d32a77a03f24c9d8755eddbfabea800a7b53 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 18 May 2024 15:32:19 +0200
Subject: [PATCH 0949/1374] =?UTF-8?q?=D8=AD=D9=8E=D9=8A=D8=AB=D9=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index d0ef1a78..4181eb75 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -13,7 +13,8 @@ class FixEdeprels(Block):
     # The list in the value contains exceptions that should be left intact.
     outermost = {
         'أَنَّ':  [],
-        'إِذَا': []
+        'إِذَا': [],
+        'حَيثُ': []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -40,6 +41,7 @@ class FixEdeprels(Block):
         'أَمَامَ':  'أَمَامَ:gen', # ʾamāma = in front of
         'إِذَا':   'إِذَا', # remove morphological case; ʾiḏā = if
         'بِ_سَبَب': 'بِسَبَبِ:gen', # bisababi = because of
+        'حَيثُ':   'حَيثُ', # remove morphological case; ḥayṯu = where (SCONJ, not ADV)
         'virš':             'virš:gen' # above
     }
 

From 4453e0e4da415cfd958f450e43adbdc6e3a909f3 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 18 May 2024 15:59:10 +0200
Subject: [PATCH 0950/1374] =?UTF-8?q?'=D9=85=D9=90=D9=86=5F=D8=AE=D9=90?=
 =?UTF-8?q?=D9=84=D9=8E=D8=A7=D9=84=D9=8E':=20'=D9=85=D9=90=D9=86=5F=D8=AE?=
 =?UTF-8?q?=D9=90=D9=84=D9=8E=D8=A7=D9=84=D9=90:gen',=20#=20min=20?=
 =?UTF-8?q?=E1=B8=ABil=C4=81li=20=3D=20through,=20during?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 4181eb75..cbb65d1e 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -42,6 +42,7 @@ class FixEdeprels(Block):
         'إِذَا':   'إِذَا', # remove morphological case; ʾiḏā = if
         'بِ_سَبَب': 'بِسَبَبِ:gen', # bisababi = because of
         'حَيثُ':   'حَيثُ', # remove morphological case; ḥayṯu = where (SCONJ, not ADV)
+        'مِن_خِلَالَ': 'مِن_خِلَالِ:gen', # min ḫilāli = through, during
         'virš':             'virš:gen' # above
     }
 

From 40e89b0a5a2a494c1613c26605cdce09aa399b33 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 18 May 2024 23:10:41 +0200
Subject: [PATCH 0951/1374] =?UTF-8?q?'=D8=AD=D9=8E=D8=AA=D9=8E=D9=91=D9=89?=
 =?UTF-8?q?':=20=20=20'=D8=AD=D9=8E=D8=AA=D9=8E=D9=91=D9=89:gen',=20#=20?=
 =?UTF-8?q?=E1=B8=A5att=C4=81=20=3D=20until?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index cbb65d1e..a50e967f 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -43,6 +43,7 @@ class FixEdeprels(Block):
         'بِ_سَبَب': 'بِسَبَبِ:gen', # bisababi = because of
         'حَيثُ':   'حَيثُ', # remove morphological case; ḥayṯu = where (SCONJ, not ADV)
         'مِن_خِلَالَ': 'مِن_خِلَالِ:gen', # min ḫilāli = through, during
+        'حَتَّى':   'حَتَّى:gen', # ḥattā = until
         'virš':             'virš:gen' # above
     }
 

From c56ca1cb38323fd31822bf52ef89460e886b931c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 18 May 2024 23:29:29 +0200
Subject: [PATCH 0952/1374] =?UTF-8?q?'=D8=AF=D9=8E=D8=A7=D8=AE=D9=90=D9=84?=
 =?UTF-8?q?=D9=8E':=20=20'=D8=AF=D9=8E=D8=A7=D8=AE=D9=90=D9=84=D9=8E:gen',?=
 =?UTF-8?q?=20#=20d=C4=81=E1=B8=ABila=20=3D=20inside=20of?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index a50e967f..d2e6aa26 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -44,6 +44,7 @@ class FixEdeprels(Block):
         'حَيثُ':   'حَيثُ', # remove morphological case; ḥayṯu = where (SCONJ, not ADV)
         'مِن_خِلَالَ': 'مِن_خِلَالِ:gen', # min ḫilāli = through, during
         'حَتَّى':   'حَتَّى:gen', # ḥattā = until
+        'دَاخِلَ':  'دَاخِلَ:gen', # dāḫila = inside of
         'virš':             'virš:gen' # above
     }
 

From 37dc14539ed0c66713b97b1ebbdf52b9e8dc440a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 18 May 2024 23:53:00 +0200
Subject: [PATCH 0953/1374] =?UTF-8?q?'=D9=84=D9=8E=D8=AF=D9=8E=D9=89':=20?=
 =?UTF-8?q?=20=20'=D9=84=D9=8E=D8=AF=D9=8E=D9=89:gen',=20#=20lad=C4=81=20?=
 =?UTF-8?q?=3D=20with,=20by,=20of,=20for?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index d2e6aa26..63e8fbf0 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -45,6 +45,7 @@ class FixEdeprels(Block):
         'مِن_خِلَالَ': 'مِن_خِلَالِ:gen', # min ḫilāli = through, during
         'حَتَّى':   'حَتَّى:gen', # ḥattā = until
         'دَاخِلَ':  'دَاخِلَ:gen', # dāḫila = inside of
+        'لَدَى':   'لَدَى:gen', # ladā = with, by, of, for
         'virš':             'virš:gen' # above
     }
 

From 4e09a49b76a1be0714b73fa455124dff682d75ad Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 19 May 2024 00:10:35 +0200
Subject: [PATCH 0954/1374] =?UTF-8?q?'=D8=B6=D9=90=D8=AF=D9=8E=D9=91':=20?=
 =?UTF-8?q?=20=20=20'=D8=B6=D9=90=D8=AF=D9=8E=D9=91:gen',=20#=20=E1=B8=8Di?=
 =?UTF-8?q?dda=20=3D=20against?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 63e8fbf0..4b1089c1 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -46,6 +46,7 @@ class FixEdeprels(Block):
         'حَتَّى':   'حَتَّى:gen', # ḥattā = until
         'دَاخِلَ':  'دَاخِلَ:gen', # dāḫila = inside of
         'لَدَى':   'لَدَى:gen', # ladā = with, by, of, for
+        'ضِدَّ':    'ضِدَّ:gen', # ḍidda = against
         'virš':             'virš:gen' # above
     }
 

From b161f480c9c13f602a548e66cc495a5c2738ae4d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 19 May 2024 10:34:04 +0200
Subject: [PATCH 0955/1374] =?UTF-8?q?'=D9=85=D9=90=D9=86=5F=D8=A3=D9=8E?=
 =?UTF-8?q?=D8=AC=D9=84':=20'=D9=85=D9=90=D9=86=5F=D8=A3=D9=8E=D8=AC=D9=84?=
 =?UTF-8?q?=D9=90:gen',=20#=20min=20=CA=BEa=C7=A7li=20=3D=20for=20the=20sa?=
 =?UTF-8?q?ke=20of?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 4b1089c1..4d6ce446 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -47,6 +47,7 @@ class FixEdeprels(Block):
         'دَاخِلَ':  'دَاخِلَ:gen', # dāḫila = inside of
         'لَدَى':   'لَدَى:gen', # ladā = with, by, of, for
         'ضِدَّ':    'ضِدَّ:gen', # ḍidda = against
+        'مِن_أَجل': 'مِن_أَجلِ:gen', # min ʾaǧli = for the sake of
         'virš':             'virš:gen' # above
     }
 

From e3a635f24511ed278d30ffaa0d7bbc39ad943075 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 19 May 2024 10:49:03 +0200
Subject: [PATCH 0956/1374] =?UTF-8?q?=D9=85=D9=90=D8=AB=D9=84=D9=8E=20=3D?=
 =?UTF-8?q?=20like?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 4d6ce446..ed08f5e9 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -14,7 +14,8 @@ class FixEdeprels(Block):
     outermost = {
         'أَنَّ':  [],
         'إِذَا': [],
-        'حَيثُ': []
+        'حَيثُ': [],
+        'مِثلَ': []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -48,6 +49,7 @@ class FixEdeprels(Block):
         'لَدَى':   'لَدَى:gen', # ladā = with, by, of, for
         'ضِدَّ':    'ضِدَّ:gen', # ḍidda = against
         'مِن_أَجل': 'مِن_أَجلِ:gen', # min ʾaǧli = for the sake of
+        'مِثلَ':   'مِثلَ', # remove morphological case; miṯla = like
         'virš':             'virš:gen' # above
     }
 

From a09bd9720d9e3e2c6fd7a9e690c0921454d84436 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 19 May 2024 12:11:45 +0200
Subject: [PATCH 0957/1374] =?UTF-8?q?=D9=84=D9=90=D8=A3=D9=8E=D9=86=D9=8E?=
 =?UTF-8?q?=D9=91?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index ed08f5e9..2061310c 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -15,7 +15,8 @@ class FixEdeprels(Block):
         'أَنَّ':  [],
         'إِذَا': [],
         'حَيثُ': [],
-        'مِثلَ': []
+        'مِثلَ': [],
+        'لِأَنَّ': []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -50,6 +51,7 @@ class FixEdeprels(Block):
         'ضِدَّ':    'ضِدَّ:gen', # ḍidda = against
         'مِن_أَجل': 'مِن_أَجلِ:gen', # min ʾaǧli = for the sake of
         'مِثلَ':   'مِثلَ', # remove morphological case; miṯla = like
+        'لِأَنَّ':    'لِأَنَّ', # remove morphological case; li-ʾanna = because
         'virš':             'virš:gen' # above
     }
 

From c60926594c66dd887fab8a17750711bf4cadebb9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 20 May 2024 10:42:53 +0200
Subject: [PATCH 0958/1374] =?UTF-8?q?'=D9=83=D9=8E':=20=20=20=20=20'=D9=83?=
 =?UTF-8?q?=D9=8E:gen',=20#=20ka=20=3D=20in=20(temporal=3F)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 2061310c..8d1cbba0 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -52,6 +52,7 @@ class FixEdeprels(Block):
         'مِن_أَجل': 'مِن_أَجلِ:gen', # min ʾaǧli = for the sake of
         'مِثلَ':   'مِثلَ', # remove morphological case; miṯla = like
         'لِأَنَّ':    'لِأَنَّ', # remove morphological case; li-ʾanna = because
+        'كَ':     'كَ:gen', # ka = in (temporal?)
         'virš':             'virš:gen' # above
     }
 
@@ -79,12 +80,11 @@ def process_node(self, node):
             if m:
                 bdeprel = m.group(1)
                 solved = False
-                # Issues caused by errors in the original annotation must be fixed early.
-                # Especially if acl|advcl occurs with a preposition that unambiguously
-                # receives a morphological case in the subsequent steps, and then gets
-                # flagged as solved.
-                edep['deprel'] = re.sub(r'^advcl:do(?::gen)?$', r'obl:do:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
-                edep['deprel'] = re.sub(r'^acl:k(?::dat)?$', r'acl', edep['deprel'])
+                # Arabic clauses often start with وَ wa "and", which does not add
+                # much to the meaning but sometimes gets included in the enhanced
+                # case label. Remove it if there are more informative subsequent
+                # morphs.
+                edep['deprel'] = re.sub(r':وَ_', r':', edep['deprel'])
                 # If one of the following expressions occurs followed by another preposition
                 # or by morphological case, remove the additional case marking. For example,
                 # 'jako_v' becomes just 'jako'.

From e94029a68118520610b51fc146fe81e805250741 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 6 Jun 2024 11:41:39 +0200
Subject: [PATCH 0959/1374] indama, tahta

---
 udapi/block/ud/ar/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 8d1cbba0..68155263 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -53,6 +53,8 @@ class FixEdeprels(Block):
         'مِثلَ':   'مِثلَ', # remove morphological case; miṯla = like
         'لِأَنَّ':    'لِأَنَّ', # remove morphological case; li-ʾanna = because
         'كَ':     'كَ:gen', # ka = in (temporal?)
+        'عِندَمَا': 'عِندَمَا', # ʿindamā = when
+        'تَحتَ':   'تَحتَ:gen', # tahta = under
         'virš':             'virš:gen' # above
     }
 

From 062eff6b534a011998de15790d8edc7c68ef8c41 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 6 Jun 2024 13:21:54 +0200
Subject: [PATCH 0960/1374] abra = via

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 68155263..95e7e829 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -55,6 +55,7 @@ class FixEdeprels(Block):
         'كَ':     'كَ:gen', # ka = in (temporal?)
         'عِندَمَا': 'عِندَمَا', # ʿindamā = when
         'تَحتَ':   'تَحتَ:gen', # tahta = under
+        'عَبرَ':   'عَبرَ:gen', # ʿabra = via
         'virš':             'virš:gen' # above
     }
 

From 0fce578be3b99e61026775b513113876fad062d3 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 6 Jun 2024 13:35:21 +0200
Subject: [PATCH 0961/1374] =?UTF-8?q?'=D8=A5=D9=90=D9=86=D9=8E=D9=91'=20th?=
 =?UTF-8?q?at?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 95e7e829..dfe48969 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -13,6 +13,7 @@ class FixEdeprels(Block):
     # The list in the value contains exceptions that should be left intact.
     outermost = {
         'أَنَّ':  [],
+        'إِنَّ':  [],
         'إِذَا': [],
         'حَيثُ': [],
         'مِثلَ': [],
@@ -39,6 +40,7 @@ class FixEdeprels(Block):
         'مُنذُ':   'مُنذُ:gen', # munḏu = since
         'حَولَ':   'حَولَ:gen', # ḥawla = about
         'أَنَّ':    'أَنَّ', # remove morphological case; ʾanna = that
+        'إِنَّ':    'إِنَّ', # remove morphological case; ʾinna = that
         'قَبلَ':   'قَبلَ:gen', # qabla = before
         'أَمَامَ':  'أَمَامَ:gen', # ʾamāma = in front of
         'إِذَا':   'إِذَا', # remove morphological case; ʾiḏā = if

From 13b4a5ea939f82bae4f7b416372dd123d66ccb7b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 6 Jun 2024 17:24:08 +0200
Subject: [PATCH 0962/1374] =?UTF-8?q?=CA=BEan=20=3D=20that?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index dfe48969..ff2bf071 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -40,6 +40,7 @@ class FixEdeprels(Block):
         'مُنذُ':   'مُنذُ:gen', # munḏu = since
         'حَولَ':   'حَولَ:gen', # ḥawla = about
         'أَنَّ':    'أَنَّ', # remove morphological case; ʾanna = that
+        'أَن':    'أَن', # remove morphological case; ʾan = that
         'إِنَّ':    'إِنَّ', # remove morphological case; ʾinna = that
         'قَبلَ':   'قَبلَ:gen', # qabla = before
         'أَمَامَ':  'أَمَامَ:gen', # ʾamāma = in front of

From 3bbe8c2a317aa229bddb1ffae46bde47df6f3b51 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 6 Jun 2024 17:50:56 +0200
Subject: [PATCH 0963/1374] =?UTF-8?q?=CA=BEan=20=3D=20that?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index ff2bf071..861de9bc 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -13,6 +13,7 @@ class FixEdeprels(Block):
     # The list in the value contains exceptions that should be left intact.
     outermost = {
         'أَنَّ':  [],
+        'أَن':  [],
         'إِنَّ':  [],
         'إِذَا': [],
         'حَيثُ': [],

From 2bc4392286af31b544d756ce3d6cc402f3c93bff Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 7 Jun 2024 11:29:37 +0200
Subject: [PATCH 0964/1374] =?UTF-8?q?=D8=A8=D9=8E=D8=B9=D8=AF=D9=8E=5F?=
 =?UTF-8?q?=D8=A3=D9=8E=D9=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 861de9bc..dc4e078c 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -38,6 +38,7 @@ class FixEdeprels(Block):
         'عَن':    'عَن:gen', # ʿan = about, from
         'خِلَالَ':   'خِلَالَ:gen', # ḫilāla = during
         'بَعدَ':   'بَعدَ:gen', # baʿda = after
+        'بَعدَ_أَن': 'بَعدَ:gen', # baʿda ʾan = after + clause
         'مُنذُ':   'مُنذُ:gen', # munḏu = since
         'حَولَ':   'حَولَ:gen', # ḥawla = about
         'أَنَّ':    'أَنَّ', # remove morphological case; ʾanna = that

From c0ad326c84008cbbe59bd787c1e5cb3618b55a99 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 7 Jun 2024 12:16:01 +0200
Subject: [PATCH 0965/1374] =?UTF-8?q?kam=C4=81=20=3D=20as?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index dc4e078c..052a34d1 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -18,7 +18,8 @@ class FixEdeprels(Block):
         'إِذَا': [],
         'حَيثُ': [],
         'مِثلَ': [],
-        'لِأَنَّ': []
+        'لِأَنَّ':  [],
+        'كَمَا': []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -61,6 +62,7 @@ class FixEdeprels(Block):
         'عِندَمَا': 'عِندَمَا', # ʿindamā = when
         'تَحتَ':   'تَحتَ:gen', # tahta = under
         'عَبرَ':   'عَبرَ:gen', # ʿabra = via
+        'كَمَا':   'كَمَا', # remove morphological case; kamā = as
         'virš':             'virš:gen' # above
     }
 

From 493f4834e0e556fc4ef4cf938fc315a7f231b508 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 7 Jun 2024 13:43:21 +0200
Subject: [PATCH 0966/1374] =?UTF-8?q?=D8=A8=D9=8E=D8=B9=D8=AF=D9=8E=D9=85?=
 =?UTF-8?q?=D9=8E=D8=A7=20=3D=20after?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 052a34d1..b43acdef 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -39,6 +39,7 @@ class FixEdeprels(Block):
         'عَن':    'عَن:gen', # ʿan = about, from
         'خِلَالَ':   'خِلَالَ:gen', # ḫilāla = during
         'بَعدَ':   'بَعدَ:gen', # baʿda = after
+        'بَعدَمَا': 'بَعدَ:gen', # baʿdamā = after
         'بَعدَ_أَن': 'بَعدَ:gen', # baʿda ʾan = after + clause
         'مُنذُ':   'مُنذُ:gen', # munḏu = since
         'حَولَ':   'حَولَ:gen', # ḥawla = about

From cc0fc0d2210791a6f7f4dc77a6b360dcec92ebc2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 7 Jun 2024 13:51:02 +0200
Subject: [PATCH 0967/1374] =?UTF-8?q?'=D9=85=D9=8F=D9=82=D9=8E=D8=A7=D8=A8?=
 =?UTF-8?q?=D9=90=D9=84=D9=8E':=20'=D9=85=D9=8F=D9=82=D9=8E=D8=A7=D8=A8?=
 =?UTF-8?q?=D9=90=D9=84=D9=8E:gen',=20#=20muq=C4=81bila=20=3D=20in=20excha?=
 =?UTF-8?q?nge=20for,=20opposite=20to,=20corresponding=20to?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index b43acdef..5f6733c6 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -64,6 +64,7 @@ class FixEdeprels(Block):
         'تَحتَ':   'تَحتَ:gen', # tahta = under
         'عَبرَ':   'عَبرَ:gen', # ʿabra = via
         'كَمَا':   'كَمَا', # remove morphological case; kamā = as
+        'مُقَابِلَ': 'مُقَابِلَ:gen', # muqābila = in exchange for, opposite to, corresponding to
         'virš':             'virš:gen' # above
     }
 

From 6ec4e1e2c271994cec04a3d0b55daae10122c04d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 7 Jun 2024 14:11:52 +0200
Subject: [PATCH 0968/1374] inda = indama

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 5f6733c6..bb0127cb 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -61,6 +61,7 @@ class FixEdeprels(Block):
         'لِأَنَّ':    'لِأَنَّ', # remove morphological case; li-ʾanna = because
         'كَ':     'كَ:gen', # ka = in (temporal?)
         'عِندَمَا': 'عِندَمَا', # ʿindamā = when
+        'عِندَ':   'عِندَمَا', # ʿinda = when
         'تَحتَ':   'تَحتَ:gen', # tahta = under
         'عَبرَ':   'عَبرَ:gen', # ʿabra = via
         'كَمَا':   'كَمَا', # remove morphological case; kamā = as

From ab3adc3de02235488c78e0db09c8fd23b1c85e6d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 7 Jun 2024 14:20:12 +0200
Subject: [PATCH 0969/1374] fi itar = in frame

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index bb0127cb..143b2b0b 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -66,6 +66,7 @@ class FixEdeprels(Block):
         'عَبرَ':   'عَبرَ:gen', # ʿabra = via
         'كَمَا':   'كَمَا', # remove morphological case; kamā = as
         'مُقَابِلَ': 'مُقَابِلَ:gen', # muqābila = in exchange for, opposite to, corresponding to
+        'فِي_إِطَار': 'فِي_إِطَار:gen', # fī ʾiṭār = in frame
         'virš':             'virš:gen' # above
     }
 

From d3804cecf8fd815d5499a3cb39c3f314c82e6d96 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 7 Jun 2024 16:12:49 +0200
Subject: [PATCH 0970/1374] fi hini = while

---
 udapi/block/ud/ar/fixedeprels.py | 80 ++++++++++++++++----------------
 1 file changed, 41 insertions(+), 39 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 143b2b0b..f95d9f88 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -19,7 +19,8 @@ class FixEdeprels(Block):
         'حَيثُ': [],
         'مِثلَ': [],
         'لِأَنَّ':  [],
-        'كَمَا': []
+        'كَمَا': [],
+        'فِي_حِينَ': []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -28,45 +29,46 @@ class FixEdeprels(Block):
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
-        'فِي':    'فِي:gen', # fī = in
-        'لِ':     'لِ:gen', # li = to
-        'مِن':    'مِن:gen', # min = from
-        'بِ':     'بِ:gen', # bi = for, with
-        'عَلَى':   'عَلَى:gen', # ʿalā = on
-        'إِلَى':   'إِلَى:gen', # ʾilā = to
-        'بَينَ':   'بَينَ:gen', # bayna = between
-        'مَعَ':    'مَعَ:gen', # maʿa = with
-        'عَن':    'عَن:gen', # ʿan = about, from
-        'خِلَالَ':   'خِلَالَ:gen', # ḫilāla = during
-        'بَعدَ':   'بَعدَ:gen', # baʿda = after
-        'بَعدَمَا': 'بَعدَ:gen', # baʿdamā = after
-        'بَعدَ_أَن': 'بَعدَ:gen', # baʿda ʾan = after + clause
-        'مُنذُ':   'مُنذُ:gen', # munḏu = since
-        'حَولَ':   'حَولَ:gen', # ḥawla = about
-        'أَنَّ':    'أَنَّ', # remove morphological case; ʾanna = that
-        'أَن':    'أَن', # remove morphological case; ʾan = that
-        'إِنَّ':    'إِنَّ', # remove morphological case; ʾinna = that
-        'قَبلَ':   'قَبلَ:gen', # qabla = before
-        'أَمَامَ':  'أَمَامَ:gen', # ʾamāma = in front of
-        'إِذَا':   'إِذَا', # remove morphological case; ʾiḏā = if
-        'بِ_سَبَب': 'بِسَبَبِ:gen', # bisababi = because of
-        'حَيثُ':   'حَيثُ', # remove morphological case; ḥayṯu = where (SCONJ, not ADV)
-        'مِن_خِلَالَ': 'مِن_خِلَالِ:gen', # min ḫilāli = through, during
-        'حَتَّى':   'حَتَّى:gen', # ḥattā = until
-        'دَاخِلَ':  'دَاخِلَ:gen', # dāḫila = inside of
-        'لَدَى':   'لَدَى:gen', # ladā = with, by, of, for
-        'ضِدَّ':    'ضِدَّ:gen', # ḍidda = against
-        'مِن_أَجل': 'مِن_أَجلِ:gen', # min ʾaǧli = for the sake of
-        'مِثلَ':   'مِثلَ', # remove morphological case; miṯla = like
-        'لِأَنَّ':    'لِأَنَّ', # remove morphological case; li-ʾanna = because
-        'كَ':     'كَ:gen', # ka = in (temporal?)
-        'عِندَمَا': 'عِندَمَا', # ʿindamā = when
-        'عِندَ':   'عِندَمَا', # ʿinda = when
-        'تَحتَ':   'تَحتَ:gen', # tahta = under
-        'عَبرَ':   'عَبرَ:gen', # ʿabra = via
-        'كَمَا':   'كَمَا', # remove morphological case; kamā = as
-        'مُقَابِلَ': 'مُقَابِلَ:gen', # muqābila = in exchange for, opposite to, corresponding to
+        'فِي':      'فِي:gen', # fī = in
+        'لِ':       'لِ:gen', # li = to
+        'مِن':      'مِن:gen', # min = from
+        'بِ':       'بِ:gen', # bi = for, with
+        'عَلَى':     'عَلَى:gen', # ʿalā = on
+        'إِلَى':     'إِلَى:gen', # ʾilā = to
+        'بَينَ':     'بَينَ:gen', # bayna = between
+        'مَعَ':      'مَعَ:gen', # maʿa = with
+        'عَن':      'عَن:gen', # ʿan = about, from
+        'خِلَالَ':     'خِلَالَ:gen', # ḫilāla = during
+        'بَعدَ':     'بَعدَ:gen', # baʿda = after
+        'بَعدَمَا':   'بَعدَ:gen', # baʿdamā = after
+        'بَعدَ_أَن':  'بَعدَ:gen', # baʿda ʾan = after + clause
+        'مُنذُ':     'مُنذُ:gen', # munḏu = since
+        'حَولَ':     'حَولَ:gen', # ḥawla = about
+        'أَنَّ':      'أَنَّ', # remove morphological case; ʾanna = that
+        'أَن':      'أَن', # remove morphological case; ʾan = that
+        'إِنَّ':      'إِنَّ', # remove morphological case; ʾinna = that
+        'قَبلَ':     'قَبلَ:gen', # qabla = before
+        'أَمَامَ':    'أَمَامَ:gen', # ʾamāma = in front of
+        'إِذَا':     'إِذَا', # remove morphological case; ʾiḏā = if
+        'بِ_سَبَب':   'بِسَبَبِ:gen', # bisababi = because of
+        'حَيثُ':     'حَيثُ', # remove morphological case; ḥayṯu = where (SCONJ, not ADV)
+        'مِن_خِلَالَ':  'مِن_خِلَالِ:gen', # min ḫilāli = through, during
+        'حَتَّى':     'حَتَّى:gen', # ḥattā = until
+        'دَاخِلَ':    'دَاخِلَ:gen', # dāḫila = inside of
+        'لَدَى':     'لَدَى:gen', # ladā = with, by, of, for
+        'ضِدَّ':      'ضِدَّ:gen', # ḍidda = against
+        'مِن_أَجل':  'مِن_أَجلِ:gen', # min ʾaǧli = for the sake of
+        'مِثلَ':     'مِثلَ', # remove morphological case; miṯla = like
+        'لِأَنَّ':      'لِأَنَّ', # remove morphological case; li-ʾanna = because
+        'كَ':       'كَ:gen', # ka = in (temporal?)
+        'عِندَمَا':   'عِندَمَا', # ʿindamā = when
+        'عِندَ':     'عِندَمَا', # ʿinda = when
+        'تَحتَ':     'تَحتَ:gen', # tahta = under
+        'عَبرَ':     'عَبرَ:gen', # ʿabra = via
+        'كَمَا':     'كَمَا', # remove morphological case; kamā = as
+        'مُقَابِلَ':   'مُقَابِلَ:gen', # muqābila = in exchange for, opposite to, corresponding to
         'فِي_إِطَار': 'فِي_إِطَار:gen', # fī ʾiṭār = in frame
+        'فِي_حِينَ':  'فِي_حِينِ', # fī ḥīni = while
         'virš':             'virš:gen' # above
     }
 

From 5fc7b67be762d6cf97cc2cf655f8667694b8473f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 7 Jun 2024 16:29:38 +0200
Subject: [PATCH 0971/1374] dimna = within

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index f95d9f88..8fe062df 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -69,6 +69,7 @@ class FixEdeprels(Block):
         'مُقَابِلَ':   'مُقَابِلَ:gen', # muqābila = in exchange for, opposite to, corresponding to
         'فِي_إِطَار': 'فِي_إِطَار:gen', # fī ʾiṭār = in frame
         'فِي_حِينَ':  'فِي_حِينِ', # fī ḥīni = while
+        'ضِمنَ':     'ضِمنَ:gen', # ḍimna = within, inside, among
         'virš':             'virš:gen' # above
     }
 

From cc4754944e1472882ca16655d582f3d0037e3726 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 7 Jun 2024 16:50:44 +0200
Subject: [PATCH 0972/1374] min duni = without

---
 udapi/block/ud/ar/fixedeprels.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 8fe062df..088c147e 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -69,7 +69,10 @@ class FixEdeprels(Block):
         'مُقَابِلَ':   'مُقَابِلَ:gen', # muqābila = in exchange for, opposite to, corresponding to
         'فِي_إِطَار': 'فِي_إِطَار:gen', # fī ʾiṭār = in frame
         'فِي_حِينَ':  'فِي_حِينِ', # fī ḥīni = while
+        'فِيمَا':    'فِيمَا', # fīmā = while
         'ضِمنَ':     'ضِمنَ:gen', # ḍimna = within, inside, among
+        'مِن_دُونَ':  'مِن_دُونِ:gen', # min dūni = without, beneath, underneath
+        'مِن_دُونَ_أَن': 'مِن_دُونِ:gen', # min dūni ʾan = without, beneath, underneath + clause
         'virš':             'virš:gen' # above
     }
 

From 4d4d72d98a017064794edb8268c54bad37ce935a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 8 Jun 2024 18:03:50 +0200
Subject: [PATCH 0973/1374] duna = without

---
 udapi/block/ud/ar/fixedeprels.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 088c147e..b307e842 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -73,6 +73,11 @@ class FixEdeprels(Block):
         'ضِمنَ':     'ضِمنَ:gen', # ḍimna = within, inside, among
         'مِن_دُونَ':  'مِن_دُونِ:gen', # min dūni = without, beneath, underneath
         'مِن_دُونَ_أَن': 'مِن_دُونِ:gen', # min dūni ʾan = without, beneath, underneath + clause
+        'دُونَ':     'دُونَ:gen', # dūna = without
+        'بِ_دُونَ':   'دُونَ:gen', # bi dūni = without
+        'دُونَ_أَن':  'دُونَ:gen', # dūna ʾan = without
+        'بِ_دُونَ_أَن': 'دُونَ:gen', # bi dūni ʾan = without
+        'دُونَ_سِوَى': 'دُونَ:gen', # dūna siwā = without
         'virš':             'virš:gen' # above
     }
 

From 4d944ec2d555128cfd29c0dd989ec56f6c5c1e4b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 8 Jun 2024 19:13:03 +0200
Subject: [PATCH 0974/1374] itra = right after

---
 udapi/block/ud/ar/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index b307e842..0a0a1b99 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -78,6 +78,8 @@ class FixEdeprels(Block):
         'دُونَ_أَن':  'دُونَ:gen', # dūna ʾan = without
         'بِ_دُونَ_أَن': 'دُونَ:gen', # bi dūni ʾan = without
         'دُونَ_سِوَى': 'دُونَ:gen', # dūna siwā = without
+        'إِثرَ':     'إِثرَ:gen', # ʾiṯra = right after
+        'عَلَى_إِثرَ': 'إِثرَ:gen', # ʿalā ʾiṯri = right after
         'virš':             'virš:gen' # above
     }
 

From 805994a91c196d1e9d9f9c879df4dd977fa5104f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Jun 2024 09:59:36 +0200
Subject: [PATCH 0975/1374] =?UTF-8?q?ra=C4=A1ma=20=3D=20despite?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 0a0a1b99..1990eba5 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -80,6 +80,10 @@ class FixEdeprels(Block):
         'دُونَ_سِوَى': 'دُونَ:gen', # dūna siwā = without
         'إِثرَ':     'إِثرَ:gen', # ʾiṯra = right after
         'عَلَى_إِثرَ': 'إِثرَ:gen', # ʿalā ʾiṯri = right after
+        'رَغمَ':     'رَغمَ:gen', # raġma = despite
+        'رَغمَ_أَنَّ':  'رَغمَ:gen', # raġma ʾanna = despite + clause
+        'عَلَى_رَغمَ_أَنَّ': 'رَغمَ:gen', # ʿalā raġma ʾanna = despite + clause
+        'رَغمَ_أَنَّ_مِن': 'رَغمَ:gen', # raġma ʾanna min = despite
         'virš':             'virš:gen' # above
     }
 

From fd26fdf4594a492969b20ee7edd60649b481295d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Jun 2024 10:20:24 +0200
Subject: [PATCH 0976/1374] ila anna

---
 udapi/block/ud/ar/fixedeprels.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 1990eba5..4bfca3e4 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -84,6 +84,12 @@ class FixEdeprels(Block):
         'رَغمَ_أَنَّ':  'رَغمَ:gen', # raġma ʾanna = despite + clause
         'عَلَى_رَغمَ_أَنَّ': 'رَغمَ:gen', # ʿalā raġma ʾanna = despite + clause
         'رَغمَ_أَنَّ_مِن': 'رَغمَ:gen', # raġma ʾanna min = despite
+        'إِلَى_أَنَّ':    'إِلَى_أَنَّ', # until? that?
+        'إِلَى_أَنَّ_هُوَ': 'إِلَى_أَنَّ',
+        'إِلَى_أَنَّ_لَدَى': 'إِلَى_أَنَّ',
+        'إِلَى_أَنَّ_هُوَ_مِن': 'إِلَى_أَنَّ',
+        'بِ_إِضَافَة_إِلَى_أَنَّ': 'إِلَى_أَنَّ',
+        'إِلَى_أَنَّ_هُوَ_مِن_بَينَ': 'إِلَى_أَنَّ',
         'virš':             'virš:gen' # above
     }
 

From aae6b8737cdcc3dbcc487a8639ec8e167e430410 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Jun 2024 10:24:48 +0200
Subject: [PATCH 0977/1374] ila anna

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 4bfca3e4..acb5510d 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -90,6 +90,7 @@ class FixEdeprels(Block):
         'إِلَى_أَنَّ_هُوَ_مِن': 'إِلَى_أَنَّ',
         'بِ_إِضَافَة_إِلَى_أَنَّ': 'إِلَى_أَنَّ',
         'إِلَى_أَنَّ_هُوَ_مِن_بَينَ': 'إِلَى_أَنَّ',
+        'إِلَى_أَنَّ_مِن':        'إِلَى_أَنَّ',
         'virš':             'virš:gen' # above
     }
 

From 6662ff1810a401f86fc2282b018ed986ef432d32 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Jun 2024 11:12:29 +0200
Subject: [PATCH 0978/1374] =?UTF-8?q?na=E1=B8=A5wa=20=3D=20about?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index acb5510d..b770dca9 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -91,6 +91,16 @@ class FixEdeprels(Block):
         'بِ_إِضَافَة_إِلَى_أَنَّ': 'إِلَى_أَنَّ',
         'إِلَى_أَنَّ_هُوَ_مِن_بَينَ': 'إِلَى_أَنَّ',
         'إِلَى_أَنَّ_مِن':        'إِلَى_أَنَّ',
+        'نَحوَ':              'نَحوَ', # naḥwa = about, approximately
+        'بِ_نَحوَ':            'بِ:gen', # by about N
+        'نَحوَ_بِ':            'بِ:gen', # about by N
+        'قَبلَ_نَحوَ':          'قَبلَ:gen', # before about N
+        'عَلَى_نَحوَ':          'عَلَى:gen', # to about N
+        'إِلَى_نَحوَ':          'إِلَى:gen', # to about N
+        'لِ_نَحوَ':            'لِ:gen', # to/for about N
+        'مُنذُ_نَحوَ':          'مُنذُ:gen', # since about N
+        'بَعدَ_نَحوَ':          'بَعدَ:gen', # after about N
+        'فِي_نَحوَ':           'فِي:gen', # in about N
         'virš':             'virš:gen' # above
     }
 

From ac585d7c3b1770af589b466fd11a6f14b01568b4 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Jun 2024 11:27:21 +0200
Subject: [PATCH 0979/1374] =?UTF-8?q?=CA=BEa=E1=B9=AFn=C4=81=CA=BEa=20=3D?=
 =?UTF-8?q?=20during?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index b770dca9..f95ef3ab 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -101,6 +101,8 @@ class FixEdeprels(Block):
         'مُنذُ_نَحوَ':          'مُنذُ:gen', # since about N
         'بَعدَ_نَحوَ':          'بَعدَ:gen', # after about N
         'فِي_نَحوَ':           'فِي:gen', # in about N
+        'أَثنَاءَ':            'أَثنَاءَ:gen', # ʾaṯnāʾa = during
+        'فِي_أَثنَاءَ':         'أَثنَاءَ:gen', # ʾaṯnāʾa = during
         'virš':             'virš:gen' # above
     }
 

From d0ce949c8fd91dd8aee03f55f33e4f2626b1c271 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Jun 2024 11:50:59 +0200
Subject: [PATCH 0980/1374] =?UTF-8?q?'=D9=84=D9=8E=D9=88=5F=D9=85=D9=90?=
 =?UTF-8?q?=D9=86':=20=20=20=20=20=20=20=20=20=20=20=20'=D9=84=D9=8E=D9=88?=
 =?UTF-8?q?',=20#=20if?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index f95ef3ab..633674ad 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -16,6 +16,7 @@ class FixEdeprels(Block):
         'أَن':  [],
         'إِنَّ':  [],
         'إِذَا': [],
+        'لَو':  [],
         'حَيثُ': [],
         'مِثلَ': [],
         'لِأَنَّ':  [],
@@ -29,13 +30,15 @@ class FixEdeprels(Block):
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
-        'فِي':      'فِي:gen', # fī = in
-        'لِ':       'لِ:gen', # li = to
-        'مِن':      'مِن:gen', # min = from
-        'بِ':       'بِ:gen', # bi = for, with
-        'عَلَى':     'عَلَى:gen', # ʿalā = on
-        'إِلَى':     'إِلَى:gen', # ʾilā = to
-        'بَينَ':     'بَينَ:gen', # bayna = between
+        'فِي':       'فِي:gen', # fī = in
+        'لِ':        'لِ:gen', # li = to
+        'مِن':       'مِن:gen', # min = from
+        'بِ':        'بِ:gen', # bi = for, with
+        'عَلَى':      'عَلَى:gen', # ʿalā = on
+        'إِلَى':      'إِلَى:gen', # ʾilā = to
+        'بَينَ':      'بَينَ:gen', # bayna = between
+        'بَينَمَا':    'بَينَ:gen',
+        'بَينَمَا_لَم': 'بَينَ:gen',
         'مَعَ':      'مَعَ:gen', # maʿa = with
         'عَن':      'عَن:gen', # ʿan = about, from
         'خِلَالَ':     'خِلَالَ:gen', # ḫilāla = during
@@ -103,6 +106,11 @@ class FixEdeprels(Block):
         'فِي_نَحوَ':           'فِي:gen', # in about N
         'أَثنَاءَ':            'أَثنَاءَ:gen', # ʾaṯnāʾa = during
         'فِي_أَثنَاءَ':         'أَثنَاءَ:gen', # ʾaṯnāʾa = during
+        'لَو':               'لَو', # law = if
+        'حَتَّى_لَو':           'لَو', # even if
+        'حَتَّى_وَ_لَو':         'لَو', # even if
+        'لَو_أَنَّ':            'لَو', # if
+        'لَو_مِن':            'لَو', # if
         'virš':             'virš:gen' # above
     }
 

From a7a927f5acdf61cff58b259ae8bce6e6f8557bcc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Jun 2024 12:51:18 +0200
Subject: [PATCH 0981/1374] bi anna

---
 udapi/block/ud/ar/fixedeprels.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 633674ad..7888f9b4 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -111,6 +111,14 @@ class FixEdeprels(Block):
         'حَتَّى_وَ_لَو':         'لَو', # even if
         'لَو_أَنَّ':            'لَو', # if
         'لَو_مِن':            'لَو', # if
+        'بِ_أَنَّ':             'أَنَّ', # that
+        'بِ_أَنَّ_هما_مِن':      'أَنَّ', # that
+        'بِ_أَنَّ_هُوَ':          'أَنَّ', # that
+        'بِ_أَنَّ_أَمَامَ':        'أَنَّ', # that
+        'بِ_أَنَّ_لَا':           'أَنَّ', # that
+        'بِ_أَنَّ_هُوَ_عَلَى':      'أَنَّ', # that
+        'بِ_أَنَّ_لَا':           'أَنَّ', # that
+        'بِ_أَنَّ_مِن':          'أَنَّ', # that
         'virš':             'virš:gen' # above
     }
 

From d6de01e04c31ed0304bf72a82cc8bd03c804e0d2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Jun 2024 22:55:35 +0200
Subject: [PATCH 0982/1374] aqiba = after

---
 udapi/block/ud/ar/fixedeprels.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 7888f9b4..cb6716f3 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -119,6 +119,9 @@ class FixEdeprels(Block):
         'بِ_أَنَّ_هُوَ_عَلَى':      'أَنَّ', # that
         'بِ_أَنَّ_لَا':           'أَنَّ', # that
         'بِ_أَنَّ_مِن':          'أَنَّ', # that
+        'عَقِبَ':              'عَقِبَ:gen', # ʿaqiba = following
+        'عَقِبَ_أَن':           'عَقِبَ:gen', # ʿaqiba = following
+        'عَقِبَ_مِن':           'عَقِبَ:gen', # ʿaqiba = following
         'virš':             'virš:gen' # above
     }
 

From c0d62e2ed550e260272a6297c383e210ca1b1738 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Jun 2024 11:59:35 +0200
Subject: [PATCH 0983/1374] id = because

---
 udapi/block/ud/ar/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index cb6716f3..a3371211 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -122,6 +122,8 @@ class FixEdeprels(Block):
         'عَقِبَ':              'عَقِبَ:gen', # ʿaqiba = following
         'عَقِبَ_أَن':           'عَقِبَ:gen', # ʿaqiba = following
         'عَقِبَ_مِن':           'عَقِبَ:gen', # ʿaqiba = following
+        'إِذ':               'إِذ', # ʾiḏ = because
+        'إِذ_أَنَّ':            'إِذ', # ʾiḏ ʾanna
         'virš':             'virš:gen' # above
     }
 

From eaaacf46723517335de0ac6d668e30eccc8fcf22 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Jun 2024 14:49:58 +0200
Subject: [PATCH 0984/1374] =?UTF-8?q?bi=C5=A1ani=20=3D=20about?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index a3371211..64158829 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -124,6 +124,7 @@ class FixEdeprels(Block):
         'عَقِبَ_مِن':           'عَقِبَ:gen', # ʿaqiba = following
         'إِذ':               'إِذ', # ʾiḏ = because
         'إِذ_أَنَّ':            'إِذ', # ʾiḏ ʾanna
+        'بِ_شَأن':            'بِشَأنِ:gen', # bišaʾni = about, regarding (lit. with + matter)
         'virš':             'virš:gen' # above
     }
 

From f00eb1f0ef2bda20e5b7ad8cb790ca5c65be8236 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Jun 2024 15:11:56 +0200
Subject: [PATCH 0985/1374] hasaba = according to

---
 udapi/block/ud/ar/fixedeprels.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 64158829..07a06b7e 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -125,6 +125,10 @@ class FixEdeprels(Block):
         'إِذ':               'إِذ', # ʾiḏ = because
         'إِذ_أَنَّ':            'إِذ', # ʾiḏ ʾanna
         'بِ_شَأن':            'بِشَأنِ:gen', # bišaʾni = about, regarding (lit. with + matter)
+        'حَسَبَ':              'حَسَبَ:gen', # ḥasaba = according to, depending on
+        'بِ_حَسَبَ':            'حَسَبَ:gen', # ḥasaba = according to, depending on
+        'حَسَبَمَا':            'حَسَبَ:gen', # ḥasaba = according to, depending on
+        'عَلَى_حَسَبَ':          'حَسَبَ:gen', # ḥasaba = according to, depending on
         'virš':             'virš:gen' # above
     }
 

From edff98515c7bd6c099853224dab591f8cd06572a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Jun 2024 16:14:56 +0200
Subject: [PATCH 0986/1374] bi an-nisbati li = in proportion to

---
 udapi/block/ud/ar/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 07a06b7e..940c728f 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -129,6 +129,8 @@ class FixEdeprels(Block):
         'بِ_حَسَبَ':            'حَسَبَ:gen', # ḥasaba = according to, depending on
         'حَسَبَمَا':            'حَسَبَ:gen', # ḥasaba = according to, depending on
         'عَلَى_حَسَبَ':          'حَسَبَ:gen', # ḥasaba = according to, depending on
+        'بِ_نِسبَة_لِ':         'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati li = in proportion to
+        'بِ_نِسبَة_لِ_مِن':      'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati li = in proportion to
         'virš':             'virš:gen' # above
     }
 

From aeb544249582f57eb69109e323691d6f692d6255 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Jun 2024 16:41:21 +0200
Subject: [PATCH 0987/1374] li-kay = in order to

---
 udapi/block/ud/ar/fixedeprels.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 940c728f..9128e572 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -131,6 +131,9 @@ class FixEdeprels(Block):
         'عَلَى_حَسَبَ':          'حَسَبَ:gen', # ḥasaba = according to, depending on
         'بِ_نِسبَة_لِ':         'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati li = in proportion to
         'بِ_نِسبَة_لِ_مِن':      'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati li = in proportion to
+        'تُجَاهَ':             'تُجَاهَ:gen', # tuǧāha = towards, facing
+        'لِكَي':              'لِكَي', # li-kay = in order to
+        'ذٰلِكَ_لِكَي':          'لِكَي', # li-kay = in order to
         'virš':             'virš:gen' # above
     }
 

From 91909470803a1db2fab59563cf2e49322aacb41d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Jun 2024 17:01:05 +0200
Subject: [PATCH 0988/1374] min qibali = by

---
 udapi/block/ud/ar/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 9128e572..c872986e 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -134,6 +134,8 @@ class FixEdeprels(Block):
         'تُجَاهَ':             'تُجَاهَ:gen', # tuǧāha = towards, facing
         'لِكَي':              'لِكَي', # li-kay = in order to
         'ذٰلِكَ_لِكَي':          'لِكَي', # li-kay = in order to
+        'مِن_قِبَل':           'مِن_قِبَلِ:gen', # min qibali = by
+        'مِن_قِبَل_بِ_فِي':      'مِن_قِبَلِ:gen', # min qibali = by
         'virš':             'virš:gen' # above
     }
 

From bdaf73bfd1ac6b4b91205d84d8f5e075d9f1bf8f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Jun 2024 17:23:24 +0200
Subject: [PATCH 0989/1374] hawala = around, about

---
 udapi/block/ud/ar/fixedeprels.py | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index c872986e..d3c03502 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -136,6 +136,18 @@ class FixEdeprels(Block):
         'ذٰلِكَ_لِكَي':          'لِكَي', # li-kay = in order to
         'مِن_قِبَل':           'مِن_قِبَلِ:gen', # min qibali = by
         'مِن_قِبَل_بِ_فِي':      'مِن_قِبَلِ:gen', # min qibali = by
+        'حَوَالَى':            'حَوَالَى', # ḥawālā = around, about
+        'فِي_حَوَالَى':         'فِي:gen', # fi hawala = in around X
+        'إِلَى_حَوَالَى':        'إِلَى:gen', # ila hawala = to around X
+        'بِ_حَوَالَى':          'بِ:gen', # bi hawala = with around X
+        'حَوَالَى_مِن':         'مِن:gen', # hawala min = from around X
+        'مِن_حَوَالَى':         'مِن:gen', # min hawala = from around X
+        'بَينَ_حَوَالَى':        'بَينَ:gen', # bayna hawala
+        'مُقَابِلَ_حَوَالَى':      'مُقَابِلَ:gen', # muqabila hawala
+        'إِلَى_حَوَالَى_مِن':     'إِلَى:gen', # ila hawala min
+        'لِ_حَوَالَى':          'لِ:gen', # li hawala = for around X
+        'بَعدَ_حَوَالَى':        'بَعدَ:gen', # baada hawala
+        'قَبلَ_حَوَالَى':        'قَبلَ:gen', # qabla hawala
         'virš':             'virš:gen' # above
     }
 

From 1bc3c4c2733054ab476093c457b1ff8363e77289 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Jun 2024 17:35:17 +0200
Subject: [PATCH 0990/1374] Combined case markers.

---
 udapi/block/ud/ar/fixedeprels.py | 45 ++++++++++++++++++--------------
 1 file changed, 26 insertions(+), 19 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index d3c03502..d18910af 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -30,27 +30,34 @@ class FixEdeprels(Block):
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
-        'فِي':       'فِي:gen', # fī = in
-        'لِ':        'لِ:gen', # li = to
-        'مِن':       'مِن:gen', # min = from
-        'بِ':        'بِ:gen', # bi = for, with
-        'عَلَى':      'عَلَى:gen', # ʿalā = on
+        'فِي':            'فِي:gen', # fī = in
+        'لِ':             'لِ:gen', # li = to
+        'مِن':            'مِن:gen', # min = from
+        'بِ':             'بِ:gen', # bi = for, with
+        'عَلَى':           'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَن':        'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَنَّ':        'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَنَّ_هُوَ':     'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَن_بِ':      'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَنَّ_هُوَ_لَدَى': 'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَنَّ_مِن_شَأن': 'عَلَى:gen', # ʿalā = on
         'إِلَى':      'إِلَى:gen', # ʾilā = to
         'بَينَ':      'بَينَ:gen', # bayna = between
         'بَينَمَا':    'بَينَ:gen',
         'بَينَمَا_لَم': 'بَينَ:gen',
-        'مَعَ':      'مَعَ:gen', # maʿa = with
-        'عَن':      'عَن:gen', # ʿan = about, from
-        'خِلَالَ':     'خِلَالَ:gen', # ḫilāla = during
-        'بَعدَ':     'بَعدَ:gen', # baʿda = after
-        'بَعدَمَا':   'بَعدَ:gen', # baʿdamā = after
-        'بَعدَ_أَن':  'بَعدَ:gen', # baʿda ʾan = after + clause
-        'مُنذُ':     'مُنذُ:gen', # munḏu = since
-        'حَولَ':     'حَولَ:gen', # ḥawla = about
-        'أَنَّ':      'أَنَّ', # remove morphological case; ʾanna = that
-        'أَن':      'أَن', # remove morphological case; ʾan = that
-        'إِنَّ':      'إِنَّ', # remove morphological case; ʾinna = that
-        'قَبلَ':     'قَبلَ:gen', # qabla = before
+        'مَعَ':       'مَعَ:gen', # maʿa = with
+        'عَن':       'عَن:gen', # ʿan = about, from
+        'خِلَالَ':      'خِلَالَ:gen', # ḫilāla = during
+        'بَعدَ':      'بَعدَ:gen', # baʿda = after
+        'بَعدَمَا':    'بَعدَ:gen', # baʿdamā = after
+        'بَعدَ_أَن':   'بَعدَ:gen', # baʿda ʾan = after + clause
+        'مُنذُ':      'مُنذُ:gen', # munḏu = since
+        'حَولَ':      'حَولَ:gen', # ḥawla = about
+        'أَنَّ':       'أَنَّ', # remove morphological case; ʾanna = that
+        'أَن':       'أَن', # remove morphological case; ʾan = that
+        'إِنَّ':       'إِنَّ', # remove morphological case; ʾinna = that
+        'قَبلَ':      'قَبلَ:gen', # qabla = before
+        'قَبلَ_أَن':   'قَبلَ:gen', # qabla = before
         'أَمَامَ':    'أَمَامَ:gen', # ʾamāma = in front of
         'إِذَا':     'إِذَا', # remove morphological case; ʾiḏā = if
         'بِ_سَبَب':   'بِسَبَبِ:gen', # bisababi = because of
@@ -129,8 +136,8 @@ class FixEdeprels(Block):
         'بِ_حَسَبَ':            'حَسَبَ:gen', # ḥasaba = according to, depending on
         'حَسَبَمَا':            'حَسَبَ:gen', # ḥasaba = according to, depending on
         'عَلَى_حَسَبَ':          'حَسَبَ:gen', # ḥasaba = according to, depending on
-        'بِ_نِسبَة_لِ':         'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati li = in proportion to
-        'بِ_نِسبَة_لِ_مِن':      'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati li = in proportion to
+        'بِ_نِسبَة_لِ':         'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati li (bin-nisbati li) = in proportion/relation to
+        'بِ_نِسبَة_لِ_مِن':      'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati li (bin-nisbati li) = in proportion/relation to
         'تُجَاهَ':             'تُجَاهَ:gen', # tuǧāha = towards, facing
         'لِكَي':              'لِكَي', # li-kay = in order to
         'ذٰلِكَ_لِكَي':          'لِكَي', # li-kay = in order to

From c14cfddd587b6cc4a9a8bf1adec42e96e7df25da Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Jun 2024 21:45:54 +0200
Subject: [PATCH 0991/1374] =?UTF-8?q?=E1=B8=AB=C4=81ri=C7=A7a=20=3D=20outs?=
 =?UTF-8?q?ide?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index d18910af..6be43c91 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -155,6 +155,11 @@ class FixEdeprels(Block):
         'لِ_حَوَالَى':          'لِ:gen', # li hawala = for around X
         'بَعدَ_حَوَالَى':        'بَعدَ:gen', # baada hawala
         'قَبلَ_حَوَالَى':        'قَبلَ:gen', # qabla hawala
+        'خَارِجَ':             'خَارِجَ:gen', # ḫāriǧa = outside
+        'فِي_خَارِجَ':          'خَارِجَ:gen', # ḫāriǧa = outside
+        'لِ_خَارِجَ':           'لِخَارِجِ:gen', # liḫāriǧi = out
+        'إِلَى_خَارِجَ':         'إِلَى_خَارِجِ:gen', # ʾilā ḫāriǧi = out
+        'مِن_خَارِجَ':          'مِن_خَارِجِ:gen', # min ḫāriǧi = from outside
         'virš':             'virš:gen' # above
     }
 

From 7711697fb1a771a0d89d9f70afd5cd4055608104 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Jun 2024 22:05:29 +0200
Subject: [PATCH 0992/1374] =?UTF-8?q?=CA=BFal=C4=81=20ra=C4=A1mi=20=3D=20d?=
 =?UTF-8?q?espite?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 6be43c91..c1502ff5 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -160,6 +160,11 @@ class FixEdeprels(Block):
         'لِ_خَارِجَ':           'لِخَارِجِ:gen', # liḫāriǧi = out
         'إِلَى_خَارِجَ':         'إِلَى_خَارِجِ:gen', # ʾilā ḫāriǧi = out
         'مِن_خَارِجَ':          'مِن_خَارِجِ:gen', # min ḫāriǧi = from outside
+        'عَلَى_رَغم':          'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
+        'عَلَى_رَغم_مِن':       'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
+        'عَلَى_رَغم_أَنَّ':       'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
+        'عَلَى_رَغم_مِن_أَنَّ':    'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
+        'عَلَى_رَغم_مِن_أَنَّ_هُوَ': 'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
         'virš':             'virš:gen' # above
     }
 

From e8a7b5a34f7bd16f84fdd1fcb17eb0b613dd498c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jun 2024 08:48:10 +0200
Subject: [PATCH 0993/1374] =?UTF-8?q?was=E1=B9=ADa=20=3D=20in=20the=20midd?=
 =?UTF-8?q?le?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index c1502ff5..3f31be3f 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -165,6 +165,9 @@ class FixEdeprels(Block):
         'عَلَى_رَغم_أَنَّ':       'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
         'عَلَى_رَغم_مِن_أَنَّ':    'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
         'عَلَى_رَغم_مِن_أَنَّ_هُوَ': 'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
+        'وَسطَ':              'وَسطَ:gen', # wasṭa = in the middle
+        'فِي_وَسطَ':           'وَسطَ:gen', # wasṭa = in the middle
+        'بِ_وَسطَ':            'وَسطَ:gen', # wasṭa = in the middle
         'virš':             'virš:gen' # above
     }
 

From d2327f2b4fa5c3df046f1bb67ba66d45a8432d35 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jun 2024 08:56:39 +0200
Subject: [PATCH 0994/1374] wifqa = according to

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 3f31be3f..e9ae988f 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -168,6 +168,7 @@ class FixEdeprels(Block):
         'وَسطَ':              'وَسطَ:gen', # wasṭa = in the middle
         'فِي_وَسطَ':           'وَسطَ:gen', # wasṭa = in the middle
         'بِ_وَسطَ':            'وَسطَ:gen', # wasṭa = in the middle
+        'وِفقَ':              'وِفقَ:gen', # wifqa = according to
         'virš':             'virš:gen' # above
     }
 

From d7bbccf54f5f15a4dcf2d9343a8c5f9fadbb5c0e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jun 2024 16:08:07 +0200
Subject: [PATCH 0995/1374] bayna = between, among

---
 udapi/block/ud/ar/fixedeprels.py | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index e9ae988f..c0078086 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -41,11 +41,14 @@ class FixEdeprels(Block):
         'عَلَى_أَن_بِ':      'عَلَى:gen', # ʿalā = on
         'عَلَى_أَنَّ_هُوَ_لَدَى': 'عَلَى:gen', # ʿalā = on
         'عَلَى_أَنَّ_مِن_شَأن': 'عَلَى:gen', # ʿalā = on
-        'إِلَى':      'إِلَى:gen', # ʾilā = to
-        'بَينَ':      'بَينَ:gen', # bayna = between
-        'بَينَمَا':    'بَينَ:gen',
-        'بَينَمَا_لَم': 'بَينَ:gen',
-        'مَعَ':       'مَعَ:gen', # maʿa = with
+        'إِلَى':       'إِلَى:gen', # ʾilā = to
+        'بَينَ':       'بَينَ:gen', # bayna = between
+        'بَينَمَا':     'بَينَ:gen',
+        'بَينَمَا_لَم':  'بَينَ:gen',
+        'مِن_بَينَ':    'بَينَ:gen',
+        'مَعَ_مِن_بَينَ': 'بَينَ:gen',
+        'مِن_مِن_بَينَ': 'بَينَ:gen',
+        'مَعَ':        'مَعَ:gen', # maʿa = with
         'عَن':       'عَن:gen', # ʿan = about, from
         'خِلَالَ':      'خِلَالَ:gen', # ḫilāla = during
         'بَعدَ':      'بَعدَ:gen', # baʿda = after

From 534b5538c0c25cf65211d6f0505d28dd29d936b2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jun 2024 16:38:22 +0200
Subject: [PATCH 0996/1374] =?UTF-8?q?=CA=BEiz=C4=81=CA=BEa=20=3D=20regardi?=
 =?UTF-8?q?ng,=20facing,=20towards?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index c0078086..87457103 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -172,6 +172,8 @@ class FixEdeprels(Block):
         'فِي_وَسطَ':           'وَسطَ:gen', # wasṭa = in the middle
         'بِ_وَسطَ':            'وَسطَ:gen', # wasṭa = in the middle
         'وِفقَ':              'وِفقَ:gen', # wifqa = according to
+        'إِزَاءَ':             'إِزَاءَ:gen', # ʾizāʾa = regarding, facing, towards
+        'بِ_إِزَاءَ':           'إِزَاءَ:gen', # ʾizāʾa = regarding, facing, towards
         'virš':             'virš:gen' # above
     }
 

From 596d1a12435dbb06d0ca9231e05b20fb75479916 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jun 2024 17:06:29 +0200
Subject: [PATCH 0997/1374] qurba = near

---
 udapi/block/ud/ar/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 87457103..9e9aba00 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -174,6 +174,8 @@ class FixEdeprels(Block):
         'وِفقَ':              'وِفقَ:gen', # wifqa = according to
         'إِزَاءَ':             'إِزَاءَ:gen', # ʾizāʾa = regarding, facing, towards
         'بِ_إِزَاءَ':           'إِزَاءَ:gen', # ʾizāʾa = regarding, facing, towards
+        'قُربَ':              'قُربَ:gen', # qurba = near
+        'عَن_قُربَ':           'قُربَ:gen', # qurba = near
         'virš':             'virš:gen' # above
     }
 

From 1148186557fafa9105dad61eb32fef5a5ddb733c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jun 2024 17:35:57 +0200
Subject: [PATCH 0998/1374] =?UTF-8?q?war=C4=81=CA=BEa=20=3D=20behind,=20pa?=
 =?UTF-8?q?st,=20beyond?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 9e9aba00..f5615540 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -176,6 +176,9 @@ class FixEdeprels(Block):
         'بِ_إِزَاءَ':           'إِزَاءَ:gen', # ʾizāʾa = regarding, facing, towards
         'قُربَ':              'قُربَ:gen', # qurba = near
         'عَن_قُربَ':           'قُربَ:gen', # qurba = near
+        'وَرَاءَ':             'وَرَاءَ:gen', # warāʾa = behind, past, beyond
+        'عَن_أَنَّ_وَرَاءَ':       'وَرَاءَ:gen', # warāʾa = behind, past, beyond
+        'مِن_وَرَاءَ':          'مِن_وَرَاءِ:gen', # min warāʾi = from behind
         'virš':             'virš:gen' # above
     }
 

From dc756a30dfd29856d4883b47006ece3a71cf9161 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jun 2024 17:48:05 +0200
Subject: [PATCH 0999/1374] =?UTF-8?q?bi-al-=CA=BEi=E1=B8=8D=C4=81fati=20?=
 =?UTF-8?q?=CA=BEil=C4=81=20=3D=20in=20addition=20to?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index f5615540..61630944 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -179,6 +179,7 @@ class FixEdeprels(Block):
         'وَرَاءَ':             'وَرَاءَ:gen', # warāʾa = behind, past, beyond
         'عَن_أَنَّ_وَرَاءَ':       'وَرَاءَ:gen', # warāʾa = behind, past, beyond
         'مِن_وَرَاءَ':          'مِن_وَرَاءِ:gen', # min warāʾi = from behind
+        'بِ_إِضَافَة_إِلَى':      'بِاَلإِضَافَةِ_إِلَى:gen', # bi-al-ʾiḍāfati ʾilā = in addition to
         'virš':             'virš:gen' # above
     }
 

From 8a20c6c0d0325fafba2043d2af828db906a3a4b1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jun 2024 18:03:09 +0200
Subject: [PATCH 1000/1374] =?UTF-8?q?'=D9=85=D9=90=D9=86=5F=D8=A3=D9=8E?=
 =?UTF-8?q?=D8=AC=D9=84':=20=20=20=20=20=20=20=20=20=20=20'=D9=85=D9=90?=
 =?UTF-8?q?=D9=86=5F=D8=A3=D9=8E=D8=AC=D9=84=D9=90:gen',=20#=20min=20?=
 =?UTF-8?q?=CA=BEa=C7=A7li=20=3D=20for=20the=20sake=20of=20=20=20=20=20=20?=
 =?UTF-8?q?=20=20=20'=D9=85=D9=90=D9=86=5F=D8=A7=D8=AC=D9=84':=20=20=20=20?=
 =?UTF-8?q?=20=20=20=20=20=20=20'=D9=85=D9=90=D9=86=5F=D8=A3=D9=8E=D8=AC?=
 =?UTF-8?q?=D9=84=D9=90:gen',=20#=20min=20=CA=BEa=C7=A7li=20=3D=20for=20th?=
 =?UTF-8?q?e=20sake=20of?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 61630944..e7facbc6 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -70,7 +70,8 @@ class FixEdeprels(Block):
         'دَاخِلَ':    'دَاخِلَ:gen', # dāḫila = inside of
         'لَدَى':     'لَدَى:gen', # ladā = with, by, of, for
         'ضِدَّ':      'ضِدَّ:gen', # ḍidda = against
-        'مِن_أَجل':  'مِن_أَجلِ:gen', # min ʾaǧli = for the sake of
+        'مِن_أَجل':           'مِن_أَجلِ:gen', # min ʾaǧli = for the sake of
+        'مِن_اجل':           'مِن_أَجلِ:gen', # min ʾaǧli = for the sake of
         'مِثلَ':     'مِثلَ', # remove morphological case; miṯla = like
         'لِأَنَّ':      'لِأَنَّ', # remove morphological case; li-ʾanna = because
         'كَ':       'كَ:gen', # ka = in (temporal?)

From 73e572ce99d0f31d8aab1c7643c3e77eb6363497 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jun 2024 18:51:45 +0200
Subject: [PATCH 1001/1374] fawqa = above, over

---
 udapi/block/ud/ar/fixedeprels.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index e7facbc6..97647cec 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -57,8 +57,9 @@ class FixEdeprels(Block):
         'مُنذُ':      'مُنذُ:gen', # munḏu = since
         'حَولَ':      'حَولَ:gen', # ḥawla = about
         'أَنَّ':       'أَنَّ', # remove morphological case; ʾanna = that
-        'أَن':       'أَن', # remove morphological case; ʾan = that
+        'أَن':       'أَنَّ', # remove morphological case; ʾanna = that
         'إِنَّ':       'إِنَّ', # remove morphological case; ʾinna = that
+        'إِن':       'إِنَّ', # remove morphological case; ʾinna = that
         'قَبلَ':      'قَبلَ:gen', # qabla = before
         'قَبلَ_أَن':   'قَبلَ:gen', # qabla = before
         'أَمَامَ':    'أَمَامَ:gen', # ʾamāma = in front of
@@ -181,6 +182,8 @@ class FixEdeprels(Block):
         'عَن_أَنَّ_وَرَاءَ':       'وَرَاءَ:gen', # warāʾa = behind, past, beyond
         'مِن_وَرَاءَ':          'مِن_وَرَاءِ:gen', # min warāʾi = from behind
         'بِ_إِضَافَة_إِلَى':      'بِاَلإِضَافَةِ_إِلَى:gen', # bi-al-ʾiḍāfati ʾilā = in addition to
+        'فَوقَ':              'فَوقَ:gen', # fawqa = above, over
+        'مِن_فَوقَ':           'مِن_فَوقِ:gen', # min fawqi = from above
         'virš':             'virš:gen' # above
     }
 

From dcdf0a28c248aa429ebfaa2875abc2f1da8eea88 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jun 2024 21:12:06 +0200
Subject: [PATCH 1002/1374] =?UTF-8?q?=CA=BEil=C4=81=20=C7=A7=C4=81nibi=20?=
 =?UTF-8?q?=3D=20beside?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 97647cec..8548be29 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -184,6 +184,7 @@ class FixEdeprels(Block):
         'بِ_إِضَافَة_إِلَى':      'بِاَلإِضَافَةِ_إِلَى:gen', # bi-al-ʾiḍāfati ʾilā = in addition to
         'فَوقَ':              'فَوقَ:gen', # fawqa = above, over
         'مِن_فَوقَ':           'مِن_فَوقِ:gen', # min fawqi = from above
+        'إِلَى_جَانِب':         'إِلَى_جَانِبِ:gen', # ʾilā ǧānibi = beside
         'virš':             'virš:gen' # above
     }
 

From 537b4f7c4244c0cdc5cd4eec7bed9783a5c3c6ef Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jun 2024 21:26:28 +0200
Subject: [PATCH 1003/1374] bihadafi = with goal

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 8548be29..2b3d0b4a 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -185,6 +185,7 @@ class FixEdeprels(Block):
         'فَوقَ':              'فَوقَ:gen', # fawqa = above, over
         'مِن_فَوقَ':           'مِن_فَوقِ:gen', # min fawqi = from above
         'إِلَى_جَانِب':         'إِلَى_جَانِبِ:gen', # ʾilā ǧānibi = beside
+        'بِ_هَدَف':            'بِهَدَفِ:gen', # bihadafi = with goal
         'virš':             'virš:gen' # above
     }
 

From 40efaf77f7220989ff0bdfab00a02b02ea23e3e9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jun 2024 21:52:59 +0200
Subject: [PATCH 1004/1374] biismi = in name

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 2b3d0b4a..3edbd400 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -186,6 +186,7 @@ class FixEdeprels(Block):
         'مِن_فَوقَ':           'مِن_فَوقِ:gen', # min fawqi = from above
         'إِلَى_جَانِب':         'إِلَى_جَانِبِ:gen', # ʾilā ǧānibi = beside
         'بِ_هَدَف':            'بِهَدَفِ:gen', # bihadafi = with goal
+        'بِ_اِسم':            'بِاِسمِ:gen', # biismi = in name
         'virš':             'virš:gen' # above
     }
 

From d97c55b79241583fda5262f76ba4e72d314f0595 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jun 2024 22:14:03 +0200
Subject: [PATCH 1005/1374] =?UTF-8?q?f=C4=AB=20=E1=B8=A5u=E1=B8=8D=C5=ABri?=
 =?UTF-8?q?=20=3D=20in=20presence=20of?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 3edbd400..79c23b51 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -186,7 +186,10 @@ class FixEdeprels(Block):
         'مِن_فَوقَ':           'مِن_فَوقِ:gen', # min fawqi = from above
         'إِلَى_جَانِب':         'إِلَى_جَانِبِ:gen', # ʾilā ǧānibi = beside
         'بِ_هَدَف':            'بِهَدَفِ:gen', # bihadafi = with goal
-        'بِ_اِسم':            'بِاِسمِ:gen', # biismi = in name
+        'بِ_اِسم':            'بِاِسمِ:gen', # biismi = in name of
+        'مِن_حَيثُ':           'مِن:gen',
+        'بِ_حَيثُ':            'بِ:gen',
+        'فِي_حُضُور':          'فِي_حُضُورِ:gen', # fī ḥuḍūri = in presence of
         'virš':             'virš:gen' # above
     }
 

From d2a6efcf3eb756764e73c7b0771de714c35ae4f9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Jun 2024 22:40:34 +0200
Subject: [PATCH 1006/1374] =?UTF-8?q?bi=E1=B8=ABil=C4=81fi=20=3D=20in=20ad?=
 =?UTF-8?q?dition=20to?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 79c23b51..541eeec4 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -190,6 +190,7 @@ class FixEdeprels(Block):
         'مِن_حَيثُ':           'مِن:gen',
         'بِ_حَيثُ':            'بِ:gen',
         'فِي_حُضُور':          'فِي_حُضُورِ:gen', # fī ḥuḍūri = in presence of
+        'بِ_خِلَاف':            'بِخِلَافِ:gen', # biḫilāfi = in addition to
         'virš':             'virš:gen' # above
     }
 

From f1ee5adbce653461f97d4b22884f60f78aa0e569 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 12 Jun 2024 08:25:32 +0200
Subject: [PATCH 1007/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 541eeec4..e2758cc6 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -143,9 +143,12 @@ class FixEdeprels(Block):
         'عَلَى_حَسَبَ':          'حَسَبَ:gen', # ḥasaba = according to, depending on
         'بِ_نِسبَة_لِ':         'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati li (bin-nisbati li) = in proportion/relation to
         'بِ_نِسبَة_لِ_مِن':      'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati li (bin-nisbati li) = in proportion/relation to
+        'بِ_نِسبَة_إِلَى':       'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati ʾilā (bin-nisbati ʾilā) = in proportion/relation to
+        'بِ_نِسبَة':           'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati (bin-nisbati) = in proportion/relation to
         'تُجَاهَ':             'تُجَاهَ:gen', # tuǧāha = towards, facing
         'لِكَي':              'لِكَي', # li-kay = in order to
         'ذٰلِكَ_لِكَي':          'لِكَي', # li-kay = in order to
+        'كَي':               'لِكَي', # kay = in order to
         'مِن_قِبَل':           'مِن_قِبَلِ:gen', # min qibali = by
         'مِن_قِبَل_بِ_فِي':      'مِن_قِبَلِ:gen', # min qibali = by
         'حَوَالَى':            'حَوَالَى', # ḥawālā = around, about
@@ -185,6 +188,7 @@ class FixEdeprels(Block):
         'فَوقَ':              'فَوقَ:gen', # fawqa = above, over
         'مِن_فَوقَ':           'مِن_فَوقِ:gen', # min fawqi = from above
         'إِلَى_جَانِب':         'إِلَى_جَانِبِ:gen', # ʾilā ǧānibi = beside
+        'مِن_جَانِب':          'إِلَى_جَانِبِ:gen', # min ǧānibi = beside
         'بِ_هَدَف':            'بِهَدَفِ:gen', # bihadafi = with goal
         'بِ_اِسم':            'بِاِسمِ:gen', # biismi = in name of
         'مِن_حَيثُ':           'مِن:gen',

From ad6c70f534bf334ab6934c4c7ebe18a9150b89d7 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 12 Jun 2024 08:40:22 +0200
Subject: [PATCH 1008/1374] =?UTF-8?q?=C7=A7arr=C4=81=CA=BE=20=3D=20because?=
 =?UTF-8?q?=20of?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index e2758cc6..10e545be 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -195,6 +195,8 @@ class FixEdeprels(Block):
         'بِ_حَيثُ':            'بِ:gen',
         'فِي_حُضُور':          'فِي_حُضُورِ:gen', # fī ḥuḍūri = in presence of
         'بِ_خِلَاف':            'بِخِلَافِ:gen', # biḫilāfi = in addition to
+        'جَرَّاء':             'جَرَّاء:gen', # ǧarrāʾ = because of
+        'مِن_جَرَّاء':          'جَرَّاء:gen', # ǧarrāʾ = because of
         'virš':             'virš:gen' # above
     }
 

From 123250be7a4ef60345add50204ebfa8accf04974 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 12 Jun 2024 13:46:47 +0200
Subject: [PATCH 1009/1374] an tariqi = via

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 10e545be..ba6442dc 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -197,6 +197,7 @@ class FixEdeprels(Block):
         'بِ_خِلَاف':            'بِخِلَافِ:gen', # biḫilāfi = in addition to
         'جَرَّاء':             'جَرَّاء:gen', # ǧarrāʾ = because of
         'مِن_جَرَّاء':          'جَرَّاء:gen', # ǧarrāʾ = because of
+        'عَن_طَرِيق':          'عَن_طَرِيقِ:gen', # ʿan ṭarīqi = via
         'virš':             'virš:gen' # above
     }
 

From 6ba7b3aa12d828c4bb055c31418e91de93e175b0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 12 Jun 2024 15:16:56 +0200
Subject: [PATCH 1010/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index ba6442dc..ad9e55ef 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -198,6 +198,19 @@ class FixEdeprels(Block):
         'جَرَّاء':             'جَرَّاء:gen', # ǧarrāʾ = because of
         'مِن_جَرَّاء':          'جَرَّاء:gen', # ǧarrāʾ = because of
         'عَن_طَرِيق':          'عَن_طَرِيقِ:gen', # ʿan ṭarīqi = via
+        'فِي_ظِلّ':            'فِي_ظِلِّ:gen', # fī ẓilli = in light of
+        'بِ_مُوجِب':           'بِمُوجِبِ:gen', # bimūǧibi = with motive
+        'حِيَالَ':             'حِيَالَ:gen', # ḥiyāla = concerning
+        'فِي_شَأن':           'فِي_شَأنِ:gen', # fī šaʾni = in regard of
+        'فِي_عُقب':           'فِي_أَعقَابِ:gen', # fī ʾaʿqābi = in the aftermath of
+        'بناء_عَلَى':         'بناء_عَلَى:gen', # bnāʾ ʿalā = based on
+        'طِوَالَ':             'طِوَالَ:gen', # ṭiwāla = throughout
+        'فِي_حِين_أَنَّ':        'فِي_حِينِ',
+        'فِي_غُضُون':          'فِي:gen',
+        'فِي_مُقَابِلَ':         'مُقَابِلَ:gen',
+        'لِ_بِ':              'لِ:gen',
+        'بِ_لَا':              'بِ:gen',
+        'لِ_صَالِح':           'لِصَالِحِ:gen', # liṣāliḥi = in interest of
         'virš':             'virš:gen' # above
     }
 

From 5cd97b1d4edaaaf7f716050425cf5ce603d75c33 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 12 Jun 2024 15:24:44 +0200
Subject: [PATCH 1011/1374] =?UTF-8?q?siw=C4=81=20=3D=20except=20for?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index ad9e55ef..6b3b063d 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -211,6 +211,7 @@ class FixEdeprels(Block):
         'لِ_بِ':              'لِ:gen',
         'بِ_لَا':              'بِ:gen',
         'لِ_صَالِح':           'لِصَالِحِ:gen', # liṣāliḥi = in interest of
+        'سِوَى':              'سِوَى:gen', # siwā = except for
         'virš':             'virš:gen' # above
     }
 

From 28a490ad3732b201e4816cc0640cc8360c60a504 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 12 Jun 2024 15:34:39 +0200
Subject: [PATCH 1012/1374] =?UTF-8?q?siw=C4=81=20=3D=20except=20for?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 6b3b063d..a7c06557 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -212,6 +212,10 @@ class FixEdeprels(Block):
         'بِ_لَا':              'بِ:gen',
         'لِ_صَالِح':           'لِصَالِحِ:gen', # liṣāliḥi = in interest of
         'سِوَى':              'سِوَى:gen', # siwā = except for
+        'سِوَى_عَلَى':          'سِوَى:gen', # siwā = except for
+        'سِوَى_أَنَّ_هُوَ':        'سِوَى:gen', # siwā = except for
+        'سِوَى_بِ':            'سِوَى:gen', # siwā = except for
+        'سِوَى_لِ':            'سِوَى:gen', # siwā = except for
         'virš':             'virš:gen' # above
     }
 

From 00022696bb2f5a5a60f55daf3754611cacc6e48d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 12 Jun 2024 17:40:36 +0200
Subject: [PATCH 1013/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index a7c06557..567fda8b 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -216,6 +216,9 @@ class FixEdeprels(Block):
         'سِوَى_أَنَّ_هُوَ':        'سِوَى:gen', # siwā = except for
         'سِوَى_بِ':            'سِوَى:gen', # siwā = except for
         'سِوَى_لِ':            'سِوَى:gen', # siwā = except for
+        'بِ_اِستِثنَاء':        'بِاِستِثنَاءِ:gen', # biistiṯnāʾi = with exception of
+        'بِ_قُرب_مِن':         'بِاَلقُربِ_مِن:gen', # bi-al-qurbi min = near (with proximity to)
+        'قُبَالَةَ':            'قُبَالَةَ:gen', # qubālata = in front of, facing
         'virš':             'virš:gen' # above
     }
 

From 213ff46a44d9fdda59bc7720a6bd945e90d6311c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 13 Jun 2024 14:29:53 +0200
Subject: [PATCH 1014/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 53 ++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 567fda8b..d9ecf538 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -219,6 +219,59 @@ class FixEdeprels(Block):
         'بِ_اِستِثنَاء':        'بِاِستِثنَاءِ:gen', # biistiṯnāʾi = with exception of
         'بِ_قُرب_مِن':         'بِاَلقُربِ_مِن:gen', # bi-al-qurbi min = near (with proximity to)
         'قُبَالَةَ':            'قُبَالَةَ:gen', # qubālata = in front of, facing
+        'إِلَى_أَن':           'إِلَى:gen',
+        'بِ_إِلَى':            'بِ:gen',
+        'بِ_إِنَّ':             'بِ:gen',
+        'بِ_رَغم_مِن_أَن':      'بِ:gen',
+        'بِ_رَغم_مِن_أَنَّ_هُوَ':   'بِ:gen',
+        'بِ_عَلَى':            'بِ:gen',
+        'بِ_عَن':             'بِ:gen',
+        'بِ_فِي':             'بِ:gen',
+        'بِ_كَ':              'بِ:gen',
+        'بِ_لِ':              'بِ:gen',
+        'بِ_مَا_أَنَّ':          'بِ:gen',
+        'بِ_مِن':             'بِ:gen',
+        'بِ_وَ_لِ':            'بِ:gen',
+        'عَلَى_إِلَى':          'عَلَى:gen',
+        'عَلَى_بِ':            'عَلَى:gen',
+        'عَلَى_بِ_فِي':         'عَلَى:gen',
+        'عَلَى_مِن':           'عَلَى:gen',
+        'عَن_أَن':            'عَن:gen',
+        'عَن_أَنَّ':            'عَن:gen',
+        'عَن_بِ':             'عَن:gen',
+        'عَن_فِي_أَن':         'عَن:gen',
+        'عَن_مِن':            'عَن:gen',
+        'فِي_إِلَى':           'فِي:gen',
+        'فِي_أَن':            'فِي:gen',
+        'فِي_أَنَّ':            'فِي:gen',
+        'فِي_أَنَّ_عَلَى':        'فِي:gen',
+        'فِي_أَنَّ_لَدَى':        'فِي:gen',
+        'فِي_أَنَّ_مِن':         'فِي:gen',
+        'فِي_بِ':             'فِي:gen',
+        'فِي_بِ_فِي':          'فِي:gen',
+        'فِي_مَا':            'فِي:gen',
+        'فِي_مَعَ':            'فِي:gen',
+        'فِي_مِن':            'فِي:gen',
+        'كَ_لِ':              'كَ:gen',
+        'كَ_وَ_وَ':            'كَ:gen',
+        'لِ_إِلَى':            'لِ:gen',
+        'لِ_أَمَامَ_وَ':         'لِ:gen',
+        'لِ_أَن':             'لِ:gen',
+        'لِ_عَن':             'لِ:gen',
+        'لِ_فِي':             'لِ:gen',
+        'لِ_مَعَ':             'لِ:gen',
+        'لِ_مِن':             'لِ:gen',
+        'لِ_وَ':              'لِ:gen',
+        'لِ_وَ_فِي':           'لِ:gen',
+        'مَعَ_أَنَّ':            'مَعَ:gen',
+        'مَعَ_بِ':             'مَعَ:gen',
+        'مِن_إِلَى':           'مِن:gen',
+        'مِن_أَن':            'مِن:gen',
+        'مِن_أَنَّ':            'مِن:gen',
+        'مِن_بِ':             'مِن:gen',
+        'مِن_عَلَى':           'مِن:gen',
+        'مِن_فِي':            'مِن:gen',
+        'مِن_مِن':            'مِن:gen',
         'virš':             'virš:gen' # above
     }
 

From 89abfa2269f60d14b64253e958cdcd061df2dc3c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 13 Jun 2024 15:09:25 +0200
Subject: [PATCH 1015/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 23 ++++-------------------
 1 file changed, 4 insertions(+), 19 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index d9ecf538..2acc0d5f 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -272,6 +272,8 @@ class FixEdeprels(Block):
         'مِن_عَلَى':           'مِن:gen',
         'مِن_فِي':            'مِن:gen',
         'مِن_مِن':            'مِن:gen',
+        'بِ_مُنَاسَبَة':         'بِمُنَاسَبَةِ:gen', # bimunāsabati = on the occasion of
+        'فِي_مَجَال':          'فِي_مَجَالِ:gen', # fī maǧāli = in the area of
         'virš':             'virš:gen' # above
     }
 
@@ -304,6 +306,8 @@ def process_node(self, node):
                 # case label. Remove it if there are more informative subsequent
                 # morphs.
                 edep['deprel'] = re.sub(r':وَ_', r':', edep['deprel'])
+                edep['deprel'] = re.sub(r':وَ:', r':', edep['deprel'])
+                edep['deprel'] = re.sub(r':وَ$', r'', edep['deprel'])
                 # If one of the following expressions occurs followed by another preposition
                 # or by morphological case, remove the additional case marking. For example,
                 # 'jako_v' becomes just 'jako'.
@@ -326,25 +330,6 @@ def process_node(self, node):
                         break
                 if solved:
                     continue
-                # The following prepositions have more than one morphological case
-                # available. Thanks to the Case feature on prepositions, we can
-                # identify the correct one. Exclude 'nom' and 'voc', which cannot
-                # be correct.
-                m = re.match(r'^(obl(?::arg)?|nmod):(po|už)(?::(?:nom|voc))?$', edep['deprel'])
-                if m:
-                    adpcase = self.copy_case_from_adposition(node, m.group(2))
-                    if adpcase and not re.search(r':(nom|voc)$', adpcase):
-                        edep['deprel'] = m.group(1)+':'+adpcase
-                        continue
-                    # The remaining instance of 'po' should be ':acc'.
-                    elif m.group(2) == 'po':
-                        edep['deprel'] = m.group(1)+':po:acc'
-                        continue
-                    # The remaining 'už' are ':acc' (they are second conjuncts
-                    # in coordinated oblique modifiers).
-                    elif m.group(2) == 'už':
-                        edep['deprel'] = m.group(1)+':už:acc'
-                        continue
 
     def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
         '''

From bc9f76d238b147aada8f11ab18c0a2d6ff185a34 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 13 Jun 2024 15:38:10 +0200
Subject: [PATCH 1016/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 2acc0d5f..4c7ba8b1 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -274,6 +274,10 @@ class FixEdeprels(Block):
         'مِن_مِن':            'مِن:gen',
         'بِ_مُنَاسَبَة':         'بِمُنَاسَبَةِ:gen', # bimunāsabati = on the occasion of
         'فِي_مَجَال':          'فِي_مَجَالِ:gen', # fī maǧāli = in the area of
+        'عَدَا':              'عَدَا:gen', # ʿadā = except for
+        'بِ_اِعتِبَار':         'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
+        'بِ_اِعتِبَار_أَنَّ':      'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
+        'بِ_اِعتِبَار_مِن':      'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
         'virš':             'virš:gen' # above
     }
 

From 75557320cae441c268df6ae276b21f65bd1208e8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 13 Jun 2024 15:50:17 +0200
Subject: [PATCH 1017/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 4c7ba8b1..0043a7df 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -278,6 +278,7 @@ class FixEdeprels(Block):
         'بِ_اِعتِبَار':         'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
         'بِ_اِعتِبَار_أَنَّ':      'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
         'بِ_اِعتِبَار_مِن':      'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
+        'بِ_تُهمَة':           'بِتُهمَةِ:gen', # bituhmati = on charges of
         'virš':             'virš:gen' # above
     }
 

From 14cbd6a3663d117406b0b36766113a32e126cc41 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 13 Jun 2024 16:05:58 +0200
Subject: [PATCH 1018/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 0043a7df..15a120b6 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -279,6 +279,7 @@ class FixEdeprels(Block):
         'بِ_اِعتِبَار_أَنَّ':      'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
         'بِ_اِعتِبَار_مِن':      'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
         'بِ_تُهمَة':           'بِتُهمَةِ:gen', # bituhmati = on charges of
+        'بِ_فَضل':            'بِفَضلِ:gen', # bifaḍli = thanks to
         'virš':             'virš:gen' # above
     }
 

From bd125353cdff191f50807e80eb81e6642d60197b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 13 Jun 2024 16:31:37 +0200
Subject: [PATCH 1019/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 15a120b6..2cb4ecf5 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -280,6 +280,8 @@ class FixEdeprels(Block):
         'بِ_اِعتِبَار_مِن':      'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
         'بِ_تُهمَة':           'بِتُهمَةِ:gen', # bituhmati = on charges of
         'بِ_فَضل':            'بِفَضلِ:gen', # bifaḍli = thanks to
+        'عَلَى_حِسَاب':         'عَلَى_حِسَابِ:gen', # ʿalā ḥisābi = at the expense of
+        'لِ_حِسَاب':           'عَلَى_حِسَابِ:gen', # ʿalā ḥisābi = at the expense of
         'virš':             'virš:gen' # above
     }
 

From bb68273faaad47013113316f4bdb64345d1c8926 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 13 Jun 2024 17:09:00 +0200
Subject: [PATCH 1020/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 2cb4ecf5..6d600e10 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -282,6 +282,11 @@ class FixEdeprels(Block):
         'بِ_فَضل':            'بِفَضلِ:gen', # bifaḍli = thanks to
         'عَلَى_حِسَاب':         'عَلَى_حِسَابِ:gen', # ʿalā ḥisābi = at the expense of
         'لِ_حِسَاب':           'عَلَى_حِسَابِ:gen', # ʿalā ḥisābi = at the expense of
+        'عَلَى_رَأس':          'عَلَى_رَأسِ:gen', # ʿalā raʾsi = on top of
+        'قُبَيلَ':             'قُبَيلَ:gen', # qubayla = before
+        'مَهمَا':             'مَهمَا', # mahmā = regardless
+        'مِمَّا':              'مِمَّا', # mimmā = that, which
+        'مِمَّا_لَدَى':          'مِمَّا', # mimmā = that, which
         'virš':             'virš:gen' # above
     }
 

From cd5becc7c680346a5b611f926073088c70347777 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 13 Jun 2024 22:07:35 +0200
Subject: [PATCH 1021/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 6d600e10..9d924a88 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -287,6 +287,25 @@ class FixEdeprels(Block):
         'مَهمَا':             'مَهمَا', # mahmā = regardless
         'مِمَّا':              'مِمَّا', # mimmā = that, which
         'مِمَّا_لَدَى':          'مِمَّا', # mimmā = that, which
+        'بِ_اِتِّجَاه':          'بِاِتِّجَاهِ:gen', # bi-ittiǧāhi = towards
+        'فِي_اِتِّجَاه':         'بِاِتِّجَاهِ:gen', # bi-ittiǧāhi = towards
+        'طَالَمَا':            'طَالَمَا', # ṭālamā = as long as
+        'طَالَمَا_أَنَّ':         'طَالَمَا', # ṭālamā = as long as
+        'عَلَى_غِرَار':         'عَلَى_غِرَارِ:gen', # ʿalā ġirāri = similar to
+        'فَورَ':              'فَورَ:gen', # fawra = as soon as
+        'فِي_حَال':           'فِي_حَالِ:gen', # fī ḥāli = in case
+        'فِي_حَالَة':          'فِي_حَالِ:gen', # fī ḥāli = in case
+        'بِ_حَالَة':           'فِي_حَالِ:gen', # fī ḥāli = in case
+        'لِ_مِثلَ':            'مِثلَ', # miṯla = like
+        'مِثلَمَا':            'مِثلَ', # miṯla = like
+        'مِن_مِثلَ':           'مِثلَ', # miṯla = like
+        'بِ_مِثلَ':            'مِثلَ', # miṯla = like
+        'فِي_مِثلَ':           'مِثلَ', # miṯla = like
+        'إِلَى_مِثلَ':          'مِثلَ', # miṯla = like
+        'عَلَى_مِثلَ':          'مِثلَ', # miṯla = like
+        'عَن_مِثلَ':           'مِثلَ', # miṯla = like
+        'مُنذُ_أَن':           'مُنذُ:gen',
+        'مُنذُ_وَ_فِي':         'مُنذُ:gen',
         'virš':             'virš:gen' # above
     }
 

From a9f105bc85acbdd3a6bf42ae1f6ef62227b3e070 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 13 Jun 2024 23:20:16 +0200
Subject: [PATCH 1022/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 9d924a88..0179bece 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -306,6 +306,23 @@ class FixEdeprels(Block):
         'عَن_مِثلَ':           'مِثلَ', # miṯla = like
         'مُنذُ_أَن':           'مُنذُ:gen',
         'مُنذُ_وَ_فِي':         'مُنذُ:gen',
+        'إِلَّا':               'إِلَّا', # ʾillā = except, unless
+        'إِلَّا_أَنَّ':            'إِلَّا', # ʾillā = except, unless
+        'إِلَّا_أَنَّ_هُوَ':         'إِلَّا', # ʾillā = except, unless
+        'إِلَّا_أَن':            'إِلَّا', # ʾillā = except, unless
+        'إِلَّا_إِذَا':           'إِلَّا', # ʾillā = except, unless
+        'عَلَى_إِلَّا':           'إِلَّا', # ʾillā = except, unless
+        'بَدَلًا_مِن':           'بَدَلًا_مِن:gen', # badalan min = instead of
+        'بِ_حُضُور':           'فِي_حُضُورِ:gen', # together with
+        'بِ_صَدَد':            'بِصَدَدِ:gen', # biṣadadi = with respect to
+        'بِ_مُقتَضَى':          'بِمُقتَضَى:gen', # bimuqtaḍā = with requirement of
+        'خَلفَ':              'خَلفَ:gen', # ḫalfa = behind
+        'عَلَى_أَسَاس':         'عَلَى_أَسَاسٍ:gen', # ʿalā ʾasāsin = based on
+        'عَلَى_أَسَاس_أَنَّ':      'عَلَى_أَسَاسٍ:gen', # ʿalā ʾasāsin = based on
+        'فِي_خِتَام':          'فِي_خِتَامِ', # fī ḫitāmi = in conclusion
+        'فِي_ضَوء':           'فِي_ضَوءِ:gen', # fī ḍawʾi = in light of
+        'كُلَّمَا':             'كُلَّمَا', # kullamā = whenever
+        'لِ_كَون':            'لِكَونِ', # likawni = because
         'virš':             'virš:gen' # above
     }
 

From 033e93b9322f4452af68535406ea98fd702722d0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 10:14:02 +0200
Subject: [PATCH 1023/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 0179bece..5bfa0aea 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -21,7 +21,8 @@ class FixEdeprels(Block):
         'مِثلَ': [],
         'لِأَنَّ':  [],
         'كَمَا': [],
-        'فِي_حِينَ': []
+        'فِي_حِينَ': [],
+        'فَ':   []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -323,6 +324,30 @@ class FixEdeprels(Block):
         'فِي_ضَوء':           'فِي_ضَوءِ:gen', # fī ḍawʾi = in light of
         'كُلَّمَا':             'كُلَّمَا', # kullamā = whenever
         'لِ_كَون':            'لِكَونِ', # likawni = because
+        'بِ_مُشَارَكَة':         'بِمُشَارَكَةِ:gen', # bimušārakati = with participation of
+        'بينا':             'بَينَ:gen', # bayna = between
+        'بِ_دَور':            'بِ:gen', # bidawri = with role, in turn?
+        'بِ_صِفَة':            'بِصِفَةِ:gen', # biṣifati = as
+        'بِ_قَصد':            'بِقَصدِ:gen', # biqaṣdi = with intention
+        'عَلَى_اِعتِبَار_أَنَّ':    'عَلَى_اِعتِبَارِ_أَنَّ', # ʿalā iʿtibāri ʾanna = considering that
+        'عَلَى_حَدّ':           'عَلَى:gen',
+        'فِي_حَدّ':            'فِي:gen',
+        'عَلَى_مدى':          'عَلَى:gen',
+        'عَلَى_يَد':           'عَلَى:gen',
+        'فَ':                'فَ', # fa = so (advcl or coordination)
+        'فَ_بَينَ':            'فَ', # fa = so (advcl or coordination)
+        'فَ_فِي':             'فَ', # fa = so (advcl or coordination)
+        'فَ_مِن':             'فَ', # fa = so (advcl or coordination)
+        'فَ_إِذَا':            'فَ', # fa = so (advcl or coordination)
+        'فَ_بَدَل_مِن_أَن':      'فَ', # fa = so (advcl or coordination)
+        'فَ_بَينَ':            'فَ', # fa = so (advcl or coordination)
+        'فَ_عَلَى':            'فَ', # fa = so (advcl or coordination)
+        'فَ_فِي':             'فَ', # fa = so (advcl or coordination)
+        'فِي_سَبِيل':          'فِي_سَبِيلِ:gen', # fī sabīli = in order to
+        'مِن_شَأن':           'مِن_شَأنِ:gen', # min šaʾni = from matter
+        'مِن_نَاحِيَة':         'مِن:gen',
+        'وإن':              'إِنَّ',
+        'حَتَّى_وإن':          'إِنَّ',
         'virš':             'virš:gen' # above
     }
 

From 85b0c3dda9bae12a86f138016b7a8d893677bc84 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 10:35:50 +0200
Subject: [PATCH 1024/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 5bfa0aea..3621212c 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -348,6 +348,11 @@ class FixEdeprels(Block):
         'مِن_نَاحِيَة':         'مِن:gen',
         'وإن':              'إِنَّ',
         'حَتَّى_وإن':          'إِنَّ',
+        'إِلَى_بَينَ':          'إِلَى_بَينِ:gen', # ʾilā bayni = to between
+        'بِ_رَغم_مِن':         'رَغمَ:gen', # despite
+        'بِ_رَغم':            'رَغمَ:gen', # despite
+        'بِ_رَغم_أَنَّ':         'رَغمَ:gen', # despite
+        'بِ_رَغم_مِن_أَنَّ':      'رَغمَ:gen', # despite
         'virš':             'virš:gen' # above
     }
 

From 2aeb0339bb66c9ba0c149ab101359ea08b6e4aa6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 11:52:45 +0200
Subject: [PATCH 1025/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 3621212c..6c89567a 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -353,6 +353,23 @@ class FixEdeprels(Block):
         'بِ_رَغم':            'رَغمَ:gen', # despite
         'بِ_رَغم_أَنَّ':         'رَغمَ:gen', # despite
         'بِ_رَغم_مِن_أَنَّ':      'رَغمَ:gen', # despite
+        'بدون':             'دُونَ:gen', # without
+        'بِ_تَعَاوُن_مَعَ':       'بِاَلتَّعَاوُنِ_مَعَ:gen', # bi-at-taʿāwuni maʿa = in cooperation with
+        'بِ_خُصُوص':           'بِخُصُوصِ:gen', # biḫuṣūṣi = with regard
+        'بِ_دَعوَى':           'بِ:gen',
+        'بِ_صَرف_نَظَر_عَن':     'بِصَرفِ_اَلنَّظَرِ_عَن:gen', # biṣarfi an-naẓari ʿan = regardless of
+        'بِ_وَاسِطَة':          'بِوَاسِطَةِ:gen', # biwāsiṭati = by means of
+        'ذٰلِكَ_لِأَنَّ':            'لِأَنَّ', # because
+        'عَلَى_قَيد':          'عَلَى:gen',
+        'فِي_دَاخِل':          'دَاخِل:gen',
+        'لِ_عَلَى':            'لِ:gen',
+        'لِذَا':              'لِذَا', # liḏā = so, therefore
+        'لِذٰلِكَ':             'لِذَا', # liḏā = so, therefore
+        'مِن_ثُمَّ':            'مِن:gen',
+        'مِن_خَارِج':          'مِن_خَارِجِ:gen', # min ḫāriǧi = from outside
+        'مِن_دَاخِلَ':          'مِن_دَاخِلِ:gen', # min dāḫili = from inside
+        'مِن_ضِمنَ':           'مِن_ضِمنِ:gen', # min ḍimni = from within = including
+        'هذا_بالأضافة':      'بِ:gen',
         'virš':             'virš:gen' # above
     }
 

From 2c34ba55e223b8122c50d3a201d574be993e0734 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 13:38:01 +0200
Subject: [PATCH 1026/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 47 ++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 6c89567a..9f2423b2 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -370,6 +370,53 @@ class FixEdeprels(Block):
         'مِن_دَاخِلَ':          'مِن_دَاخِلِ:gen', # min dāḫili = from inside
         'مِن_ضِمنَ':           'مِن_ضِمنِ:gen', # min ḍimni = from within = including
         'هذا_بالأضافة':      'بِ:gen',
+        'أَلَّا':               'إِلَّا',
+        'إِمَّا_لِ':            'لِ:gen',
+        'إِيَّا':              'إِلَّا',
+        'بُعَيدَ':             'بُعَيدَ:gen', # buʿayda = shortly after
+        'بِ_إِضَافَة_لِ':        'بِاَلإِضَافَةِ_إِلَى:gen', # in addition to
+        'بِ_اِعتِمَاد_عَلَى':     'بِاَلِاعتِمَادِ_عَلَى:gen', # bi-al-i-ʼʿtimādi ʿalā = depending on
+        'بِ_ثُمَّ':             'بِ:gen',
+        'بِ_جَانِب':           'بِجَانِبِ:gen', # biǧānibi = next to
+        'بِ_حُلُول':           'بِ:gen',
+        'بِ_رِئَاسَة':          'بِ:gen',
+        'بِ_قَدر':            'بِ:gen',
+        'بِ_نِيَابَة_عَن':       'بِاَلنِّيَابَةِ_عَن:gen', # bi-an-niyābati ʿan = on behalf of
+        'بِنَاء_عَلَى':         'بناء_عَلَى:gen',
+        'ثُمَّ':               'بِ:gen',
+        'حَتَّى_إِنَّ':           'حَتَّى:gen', # before
+        'حَتَّى_بِ':            'حَتَّى:gen', # before
+        'حَتَّى_أَنَّ':           'حَتَّى:gen', # before
+        'حِينَمَا':            'فِي_حِينِ', # during
+        'إِلَى_حِينَ':          'فِي_حِينِ', # during
+        'ذٰلِكَ_بَعدَمَا':         'بَعدَ:gen',
+        'طالَما':            'طَالَمَا:gen',
+        'طِيلَةَ':             'طِيلَةَ:gen', # ṭīlata = during
+        'عَلَى_مَقرَبَة_مِن':     'عَلَى_مَقرَبَةٍ_مِن:gen', # ʿalā maqrabatin min = in the vicinity of
+        'غَيرَ':              'إِلَّا',
+        'فِي_بَاطِن':          'فِي:gen',
+        'فِي_سِيَاق':          'فِي:gen',
+        'فِي_صَفّ':            'فِي:gen',
+        'فِي_صُورَة':          'فِي:gen',
+        'فِي_مُوَاجَهَة':        'فِي:gen',
+        'لكن_إِذَا':          'إِذَا',
+        'لكن_لَدَى':          'لَدَى:gen',
+        'لَا':                'إِلَّا',
+        'لَمَّا':              'كُلَّمَا',
+        'لَمَّا_لِ':            'كُلَّمَا',
+        'لِ_جِهَة':            'لِ:gen',
+        'لِ_سَبَب':            'لِ:gen',
+        'لِ_فِي_بَينَ':         'لِ:gen',
+        'لِذَا_فَ':            'لِ:gen',
+        'ما_دَام':           'مِمَّا',
+        'مقابل':            'مُقَابِلَ:gen',
+        'مِن_بَعدَ':           'مِن:gen',
+        'مِن_ثَمَّ':            'مِن:gen',
+        'مِن_غَير_أَن':        'مِن:gen',
+        'مِن_قَبلَ':           'مِن_قِبَلِ:gen',
+        'نَاهِيك_بِ':          'بِ:gen',
+        'نَتِيجَة_لِ':          'لِ:gen',
+        'وان':              'أَنَّ',
         'virš':             'virš:gen' # above
     }
 

From 8b8a6f877afec8881cc4282915e6679ecfbbcd46 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 14:55:36 +0200
Subject: [PATCH 1027/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 9f2423b2..1d4611f0 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -417,6 +417,15 @@ class FixEdeprels(Block):
         'نَاهِيك_بِ':          'بِ:gen',
         'نَتِيجَة_لِ':          'لِ:gen',
         'وان':              'أَنَّ',
+        'أَمَامَ_مِن':          'أَمَامَ:gen',
+        'أَمَّا':              'أَمَامَ:gen',
+        'إِذًا':              'إِذَا',
+        'إِلَى_بَعدَ':          'إِلَى:gen',
+        'إِلَى_حَيثُ':          'إِلَى:gen',
+        'إِلَى_فِي':           'إِلَى:gen',
+        'إِلَى_قَبلَ':          'إِلَى_قَبلِ:gen', # ʾilā qabli = until before X (e.g. until one year ago)
+        'إِنَّمَا':             'إِنَّ',
+        'اِبتِدَاء_مِن':        'مِن:gen',
         'virš':             'virš:gen' # above
     }
 

From 75f0615ec4d72e73043392be8561d7c7215d35f3 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 15:08:41 +0200
Subject: [PATCH 1028/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 1d4611f0..ac65d0b1 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -426,6 +426,13 @@ class FixEdeprels(Block):
         'إِلَى_قَبلَ':          'إِلَى_قَبلِ:gen', # ʾilā qabli = until before X (e.g. until one year ago)
         'إِنَّمَا':             'إِنَّ',
         'اِبتِدَاء_مِن':        'مِن:gen',
+        'بازاء':            'بِ:gen',
+        'بالتسخين':         'بِ:gen',
+        'بشان':             'بِشَأنِ:gen',
+        'بناء_لِ':           'لِ:gen',
+        'بَل':               'قَبلَ:gen',
+        'بَيدَ':              'بِ:gen',
+        'بَيدَ_أَنَّ':           'بِ:gen',
         'virš':             'virš:gen' # above
     }
 

From 632b18e2310681b9b31f779dc08e84e32c7e8de2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 17:41:59 +0200
Subject: [PATCH 1029/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index ac65d0b1..819055bc 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -433,6 +433,38 @@ class FixEdeprels(Block):
         'بَل':               'قَبلَ:gen',
         'بَيدَ':              'بِ:gen',
         'بَيدَ_أَنَّ':           'بِ:gen',
+        'بِ_أَن':             'بِ:gen',
+        'بِ_اِنطِلَاق':          'بِ:gen',
+        'بِ_تَالِي_إِنَّ':        'بِ:gen',
+        'بِ_تَوَازِي_مَعَ':       'بِاَلتَّوَازِي_مَعَ:gen', # bi-at-tawāzī maʿa = in parallel with
+        'بِ_جِهَة':            'بِ:gen',
+        'بِ_حَقّ':             'بِ:gen',
+        'بِ_حُكم':            'بِ:gen',
+        'بِ_دَاخِلَ':           'دَاخِلَ:gen',
+        'بِ_دُون':            'دُونَ:gen',
+        'بِ_رِفقَة':           'بِرِفقَةٍ:gen', # birifqatin = in company of
+        'بِ_سَبّ':             'بِ:gen',
+        'بِ_شَرط_أَن':         'بِ:gen',
+        'بِ_عَكس':            'بِ:gen',
+        'بِ_غَضّ_نَظَر_عَن':      'بِغَضِّ_اَلنَّظَرِ_عَن:gen', # biġaḍḍi an-naẓari ʿan = regardless of
+        'بِ_مَثَابَة':          'بِ:gen',
+        'بِ_مُجَرَّد':           'بِ:gen',
+        'بِ_مُسَاعَدَة':         'بِ:gen',
+        'بِ_مُقَارَنَة_بِ':       'بِاَلمُقَارَنَةِ_بِ:gen', # bi-al-muqāranati bi = in comparison to
+        'بِ_مِقدَار':          'بِ:gen',
+        'بِ_نَتِيجَة':          'بِ:gen',
+        'بِ_نَظَر_إِلَى':        'بِ:gen',
+        'بِ_وَاقِع':           'بِ:gen',
+        'بِ_وَسَط':            'بِوَسَطِ:gen', # biwasaṭi = in the middle of
+        'بِ_وَصف':            'بِ:gen',
+        'ثَمَّ':               'بِ:gen',
+        'حولما_إِذَا':        'إِذَا',
+        'دونما':            'دُونَ:gen',
+        'ذٰلِكَ_عِندَمَا':         'بِ:gen',
+        'ذٰلِكَ_نَظَر_لِ':         'بِ:gen',
+        'رَهنَ':              'رَهنَ:gen', # rahna = depending on
+        'رَيثَمَا':            'رَهنَ:gen', # rahna = depending on
+        'عبر':              'عَبرَ:gen',
         'virš':             'virš:gen' # above
     }
 

From 70601f0078549c78144855cbac262fa46abf7f28 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 18:08:32 +0200
Subject: [PATCH 1030/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 819055bc..a19382cd 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -465,6 +465,15 @@ class FixEdeprels(Block):
         'رَهنَ':              'رَهنَ:gen', # rahna = depending on
         'رَيثَمَا':            'رَهنَ:gen', # rahna = depending on
         'عبر':              'عَبرَ:gen',
+        'عَلَى_أبواب':        'عَلَى:gen',
+        'عَلَى_أَثَر':          'عَلَى:gen',
+        'عَلَى_الفور':        'عَلَى:gen',
+        'عَلَى_اِختِلَاف':        'عَلَى:gen',
+        'عَلَى_بَينَ':          'عَلَى:gen',
+        'عَلَى_حَولَ':          'عَلَى:gen',
+        'عَلَى_طَرِيقَة':        'عَلَى_طَرِيقَةِ:gen', # ʿalā ṭarīqati = on the way
+        'عَلَى_عَكس':          'عَلَى:gen',
+        'عَلَى_مَدَى':          'عَلَى_مَدَى:gen', # ʿalā madā = on period
         'virš':             'virš:gen' # above
     }
 

From b4445d2db81d5f5aa1c623e9f903142cd56092ef Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 18:32:23 +0200
Subject: [PATCH 1031/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index a19382cd..86602629 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -474,6 +474,21 @@ class FixEdeprels(Block):
         'عَلَى_طَرِيقَة':        'عَلَى_طَرِيقَةِ:gen', # ʿalā ṭarīqati = on the way
         'عَلَى_عَكس':          'عَلَى:gen',
         'عَلَى_مَدَى':          'عَلَى_مَدَى:gen', # ʿalā madā = on period
+        'فِي_بَعدَ':           'فِي:gen',
+        'فِي_بَينَ':           'بَينَ:gen',
+        'فِي_حَقّ':            'فِي:gen',
+        'فِي_حُكم':           'فِي:gen',
+        'فِي_خِلَالَ':           'فِي:gen',
+        'فِي_دَاخِلَ':          'فِي:gen',
+        'فِي_شَكل':           'فِي:gen',
+        'فِي_غَضن':           'فِي:gen',
+        'فِي_مستشفى':        'فِي:gen',
+        'فِي_مَقدَم':          'فِي:gen',
+        'فِي_مُنَاسَبَة':        'فِي_مُنَاسَبَةِ:gen', # fī munāsabati = on the occasion of
+        'فِي_نِطَاق':          'فِي:gen',
+        'فِي_وَجه':           'فِي:gen',
+        'فِي_وَسط':           'وَسطَ:gen',
+        'قَيدَ':              'فِي:gen',
         'virš':             'virš:gen' # above
     }
 

From 3b16e7b71d03e44bae422eae41fd57b25cc28e80 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 18:52:39 +0200
Subject: [PATCH 1032/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 86602629..1466bd83 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -489,6 +489,15 @@ class FixEdeprels(Block):
         'فِي_وَجه':           'فِي:gen',
         'فِي_وَسط':           'وَسطَ:gen',
         'قَيدَ':              'فِي:gen',
+        'كَ_أَنَّ':             'كَ:gen',
+        'كَأَنَّمَا':            'كَأَنَّمَا', # ka-ʾannamā = as if
+        'لدى':              'لَدَى:gen',
+        'لكن_بِ':            'بِ:gen',
+        'لكن_دَاخِلَ':         'دَاخِلَ:gen',
+        'لَ':                'لِ:gen',
+        'لَا_سِيَّمَا_بَعدَ':       'بَعدَ:gen',
+        'لَا_سِيَّمَا_وَ_أَنَّ':      'أَنَّ',
+        'لَا_سِيَّمَا_وَ_أَنَّ_هُوَ':   'أَنَّ',
         'virš':             'virš:gen' # above
     }
 

From a84a62a57fa0b950d297a08b8e7c59c742666103 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 20:17:56 +0200
Subject: [PATCH 1033/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 1466bd83..856a0d0d 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -85,6 +85,7 @@ class FixEdeprels(Block):
         'مُقَابِلَ':   'مُقَابِلَ:gen', # muqābila = in exchange for, opposite to, corresponding to
         'فِي_إِطَار': 'فِي_إِطَار:gen', # fī ʾiṭār = in frame
         'فِي_حِينَ':  'فِي_حِينِ', # fī ḥīni = while
+        'فِي_حِين':           'فِي_حِينِ', # fī ḥīni = while
         'فِيمَا':    'فِيمَا', # fīmā = while
         'ضِمنَ':     'ضِمنَ:gen', # ḍimna = within, inside, among
         'مِن_دُونَ':  'مِن_دُونِ:gen', # min dūni = without, beneath, underneath
@@ -498,6 +499,30 @@ class FixEdeprels(Block):
         'لَا_سِيَّمَا_بَعدَ':       'بَعدَ:gen',
         'لَا_سِيَّمَا_وَ_أَنَّ':      'أَنَّ',
         'لَا_سِيَّمَا_وَ_أَنَّ_هُوَ':   'أَنَّ',
+        'لِ_أَجَلّ':            'لِ:gen',
+        'لِ_دَرَجَة_أَنَّ':        'لِ:gen',
+        'لِ_دُخُول':           'لِ:gen',
+        'لِ_عِندَ':            'لِ:gen',
+        'لِ_لِئَلّا':            'لِ:gen',
+        'لٰكِن_بَعدَ':          'بَعدَ:gen',
+        'لٰكِن_مَعَ':           'مَعَ:gen',
+        'لٰكِنَّ':              'مَعَ:gen',
+        'ما':               'مِمَّا',
+        'مَا':               'مِمَّا',
+        'مادامت':           'مِمَّا',
+        'مَالَم':             'مَالَم', # mālam = unless
+        'مَعَ_فِي':            'مَعَ:gen',
+        'مُقَارَن_بِ':          'بِ:gen',
+        'مِن_أَجل_أَن':        'مِن:gen',
+        'مِن_تَحتَ':           'مِن:gen',
+        'مِن_حَولَ':           'مِن:gen',
+        'مِن_دُون_أَن':        'مِن_دُون:gen',
+        'مِن_طَرَف':           'مِن:gen',
+        'مِن_عِندَ':           'مِن:gen',
+        'مِن_مَوقِع':          'مِن:gen',
+        'وبشان':            'بِشَأنِ:gen',
+        'ولو':              'إِذَا', # walaw = even if
+        'ولو_أَنَّ':           'إِذَا', # walaw = even if
         'virš':             'virš:gen' # above
     }
 

From 4690b236dd0413b128c2f1ae65660889be417e6f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 20:49:38 +0200
Subject: [PATCH 1034/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 804 +++++++++++++++----------------
 1 file changed, 401 insertions(+), 403 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 856a0d0d..75d4b3a2 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -31,496 +31,494 @@ class FixEdeprels(Block):
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
-        'فِي':            'فِي:gen', # fī = in
-        'لِ':             'لِ:gen', # li = to
-        'مِن':            'مِن:gen', # min = from
-        'بِ':             'بِ:gen', # bi = for, with
-        'عَلَى':           'عَلَى:gen', # ʿalā = on
-        'عَلَى_أَن':        'عَلَى:gen', # ʿalā = on
-        'عَلَى_أَنَّ':        'عَلَى:gen', # ʿalā = on
-        'عَلَى_أَنَّ_هُوَ':     'عَلَى:gen', # ʿalā = on
-        'عَلَى_أَن_بِ':      'عَلَى:gen', # ʿalā = on
-        'عَلَى_أَنَّ_هُوَ_لَدَى': 'عَلَى:gen', # ʿalā = on
-        'عَلَى_أَنَّ_مِن_شَأن': 'عَلَى:gen', # ʿalā = on
-        'إِلَى':       'إِلَى:gen', # ʾilā = to
-        'بَينَ':       'بَينَ:gen', # bayna = between
-        'بَينَمَا':     'بَينَ:gen',
-        'بَينَمَا_لَم':  'بَينَ:gen',
-        'مِن_بَينَ':    'بَينَ:gen',
-        'مَعَ_مِن_بَينَ': 'بَينَ:gen',
-        'مِن_مِن_بَينَ': 'بَينَ:gen',
-        'مَعَ':        'مَعَ:gen', # maʿa = with
-        'عَن':       'عَن:gen', # ʿan = about, from
-        'خِلَالَ':      'خِلَالَ:gen', # ḫilāla = during
-        'بَعدَ':      'بَعدَ:gen', # baʿda = after
-        'بَعدَمَا':    'بَعدَ:gen', # baʿdamā = after
-        'بَعدَ_أَن':   'بَعدَ:gen', # baʿda ʾan = after + clause
-        'مُنذُ':      'مُنذُ:gen', # munḏu = since
-        'حَولَ':      'حَولَ:gen', # ḥawla = about
-        'أَنَّ':       'أَنَّ', # remove morphological case; ʾanna = that
-        'أَن':       'أَنَّ', # remove morphological case; ʾanna = that
-        'إِنَّ':       'إِنَّ', # remove morphological case; ʾinna = that
-        'إِن':       'إِنَّ', # remove morphological case; ʾinna = that
-        'قَبلَ':      'قَبلَ:gen', # qabla = before
-        'قَبلَ_أَن':   'قَبلَ:gen', # qabla = before
-        'أَمَامَ':    'أَمَامَ:gen', # ʾamāma = in front of
-        'إِذَا':     'إِذَا', # remove morphological case; ʾiḏā = if
-        'بِ_سَبَب':   'بِسَبَبِ:gen', # bisababi = because of
-        'حَيثُ':     'حَيثُ', # remove morphological case; ḥayṯu = where (SCONJ, not ADV)
-        'مِن_خِلَالَ':  'مِن_خِلَالِ:gen', # min ḫilāli = through, during
-        'حَتَّى':     'حَتَّى:gen', # ḥattā = until
-        'دَاخِلَ':    'دَاخِلَ:gen', # dāḫila = inside of
-        'لَدَى':     'لَدَى:gen', # ladā = with, by, of, for
-        'ضِدَّ':      'ضِدَّ:gen', # ḍidda = against
-        'مِن_أَجل':           'مِن_أَجلِ:gen', # min ʾaǧli = for the sake of
-        'مِن_اجل':           'مِن_أَجلِ:gen', # min ʾaǧli = for the sake of
-        'مِثلَ':     'مِثلَ', # remove morphological case; miṯla = like
-        'لِأَنَّ':      'لِأَنَّ', # remove morphological case; li-ʾanna = because
-        'كَ':       'كَ:gen', # ka = in (temporal?)
-        'عِندَمَا':   'عِندَمَا', # ʿindamā = when
-        'عِندَ':     'عِندَمَا', # ʿinda = when
-        'تَحتَ':     'تَحتَ:gen', # tahta = under
-        'عَبرَ':     'عَبرَ:gen', # ʿabra = via
-        'كَمَا':     'كَمَا', # remove morphological case; kamā = as
-        'مُقَابِلَ':   'مُقَابِلَ:gen', # muqābila = in exchange for, opposite to, corresponding to
-        'فِي_إِطَار': 'فِي_إِطَار:gen', # fī ʾiṭār = in frame
-        'فِي_حِينَ':  'فِي_حِينِ', # fī ḥīni = while
-        'فِي_حِين':           'فِي_حِينِ', # fī ḥīni = while
-        'فِيمَا':    'فِيمَا', # fīmā = while
-        'ضِمنَ':     'ضِمنَ:gen', # ḍimna = within, inside, among
-        'مِن_دُونَ':  'مِن_دُونِ:gen', # min dūni = without, beneath, underneath
-        'مِن_دُونَ_أَن': 'مِن_دُونِ:gen', # min dūni ʾan = without, beneath, underneath + clause
-        'دُونَ':     'دُونَ:gen', # dūna = without
-        'بِ_دُونَ':   'دُونَ:gen', # bi dūni = without
-        'دُونَ_أَن':  'دُونَ:gen', # dūna ʾan = without
-        'بِ_دُونَ_أَن': 'دُونَ:gen', # bi dūni ʾan = without
-        'دُونَ_سِوَى': 'دُونَ:gen', # dūna siwā = without
-        'إِثرَ':     'إِثرَ:gen', # ʾiṯra = right after
-        'عَلَى_إِثرَ': 'إِثرَ:gen', # ʿalā ʾiṯri = right after
-        'رَغمَ':     'رَغمَ:gen', # raġma = despite
-        'رَغمَ_أَنَّ':  'رَغمَ:gen', # raġma ʾanna = despite + clause
-        'عَلَى_رَغمَ_أَنَّ': 'رَغمَ:gen', # ʿalā raġma ʾanna = despite + clause
-        'رَغمَ_أَنَّ_مِن': 'رَغمَ:gen', # raġma ʾanna min = despite
-        'إِلَى_أَنَّ':    'إِلَى_أَنَّ', # until? that?
-        'إِلَى_أَنَّ_هُوَ': 'إِلَى_أَنَّ',
-        'إِلَى_أَنَّ_لَدَى': 'إِلَى_أَنَّ',
-        'إِلَى_أَنَّ_هُوَ_مِن': 'إِلَى_أَنَّ',
-        'بِ_إِضَافَة_إِلَى_أَنَّ': 'إِلَى_أَنَّ',
-        'إِلَى_أَنَّ_هُوَ_مِن_بَينَ': 'إِلَى_أَنَّ',
-        'إِلَى_أَنَّ_مِن':        'إِلَى_أَنَّ',
-        'نَحوَ':              'نَحوَ', # naḥwa = about, approximately
-        'بِ_نَحوَ':            'بِ:gen', # by about N
-        'نَحوَ_بِ':            'بِ:gen', # about by N
-        'قَبلَ_نَحوَ':          'قَبلَ:gen', # before about N
-        'عَلَى_نَحوَ':          'عَلَى:gen', # to about N
-        'إِلَى_نَحوَ':          'إِلَى:gen', # to about N
-        'لِ_نَحوَ':            'لِ:gen', # to/for about N
-        'مُنذُ_نَحوَ':          'مُنذُ:gen', # since about N
-        'بَعدَ_نَحوَ':          'بَعدَ:gen', # after about N
-        'فِي_نَحوَ':           'فِي:gen', # in about N
+        'اِبتِدَاء_مِن':        'مِن:gen',
+        'إِثرَ':              'إِثرَ:gen', # ʾiṯra = right after
         'أَثنَاءَ':            'أَثنَاءَ:gen', # ʾaṯnāʾa = during
-        'فِي_أَثنَاءَ':         'أَثنَاءَ:gen', # ʾaṯnāʾa = during
-        'لَو':               'لَو', # law = if
-        'حَتَّى_لَو':           'لَو', # even if
-        'حَتَّى_وَ_لَو':         'لَو', # even if
-        'لَو_أَنَّ':            'لَو', # if
-        'لَو_مِن':            'لَو', # if
-        'بِ_أَنَّ':             'أَنَّ', # that
-        'بِ_أَنَّ_هما_مِن':      'أَنَّ', # that
-        'بِ_أَنَّ_هُوَ':          'أَنَّ', # that
-        'بِ_أَنَّ_أَمَامَ':        'أَنَّ', # that
-        'بِ_أَنَّ_لَا':           'أَنَّ', # that
-        'بِ_أَنَّ_هُوَ_عَلَى':      'أَنَّ', # that
-        'بِ_أَنَّ_لَا':           'أَنَّ', # that
-        'بِ_أَنَّ_مِن':          'أَنَّ', # that
-        'عَقِبَ':              'عَقِبَ:gen', # ʿaqiba = following
-        'عَقِبَ_أَن':           'عَقِبَ:gen', # ʿaqiba = following
-        'عَقِبَ_مِن':           'عَقِبَ:gen', # ʿaqiba = following
         'إِذ':               'إِذ', # ʾiḏ = because
         'إِذ_أَنَّ':            'إِذ', # ʾiḏ ʾanna
-        'بِ_شَأن':            'بِشَأنِ:gen', # bišaʾni = about, regarding (lit. with + matter)
-        'حَسَبَ':              'حَسَبَ:gen', # ḥasaba = according to, depending on
-        'بِ_حَسَبَ':            'حَسَبَ:gen', # ḥasaba = according to, depending on
-        'حَسَبَمَا':            'حَسَبَ:gen', # ḥasaba = according to, depending on
-        'عَلَى_حَسَبَ':          'حَسَبَ:gen', # ḥasaba = according to, depending on
-        'بِ_نِسبَة_لِ':         'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati li (bin-nisbati li) = in proportion/relation to
-        'بِ_نِسبَة_لِ_مِن':      'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati li (bin-nisbati li) = in proportion/relation to
-        'بِ_نِسبَة_إِلَى':       'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati ʾilā (bin-nisbati ʾilā) = in proportion/relation to
-        'بِ_نِسبَة':           'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati (bin-nisbati) = in proportion/relation to
-        'تُجَاهَ':             'تُجَاهَ:gen', # tuǧāha = towards, facing
-        'لِكَي':              'لِكَي', # li-kay = in order to
-        'ذٰلِكَ_لِكَي':          'لِكَي', # li-kay = in order to
-        'كَي':               'لِكَي', # kay = in order to
-        'مِن_قِبَل':           'مِن_قِبَلِ:gen', # min qibali = by
-        'مِن_قِبَل_بِ_فِي':      'مِن_قِبَلِ:gen', # min qibali = by
-        'حَوَالَى':            'حَوَالَى', # ḥawālā = around, about
-        'فِي_حَوَالَى':         'فِي:gen', # fi hawala = in around X
-        'إِلَى_حَوَالَى':        'إِلَى:gen', # ila hawala = to around X
-        'بِ_حَوَالَى':          'بِ:gen', # bi hawala = with around X
-        'حَوَالَى_مِن':         'مِن:gen', # hawala min = from around X
-        'مِن_حَوَالَى':         'مِن:gen', # min hawala = from around X
-        'بَينَ_حَوَالَى':        'بَينَ:gen', # bayna hawala
-        'مُقَابِلَ_حَوَالَى':      'مُقَابِلَ:gen', # muqabila hawala
-        'إِلَى_حَوَالَى_مِن':     'إِلَى:gen', # ila hawala min
-        'لِ_حَوَالَى':          'لِ:gen', # li hawala = for around X
-        'بَعدَ_حَوَالَى':        'بَعدَ:gen', # baada hawala
-        'قَبلَ_حَوَالَى':        'قَبلَ:gen', # qabla hawala
-        'خَارِجَ':             'خَارِجَ:gen', # ḫāriǧa = outside
-        'فِي_خَارِجَ':          'خَارِجَ:gen', # ḫāriǧa = outside
-        'لِ_خَارِجَ':           'لِخَارِجِ:gen', # liḫāriǧi = out
-        'إِلَى_خَارِجَ':         'إِلَى_خَارِجِ:gen', # ʾilā ḫāriǧi = out
-        'مِن_خَارِجَ':          'مِن_خَارِجِ:gen', # min ḫāriǧi = from outside
-        'عَلَى_رَغم':          'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
-        'عَلَى_رَغم_مِن':       'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
-        'عَلَى_رَغم_أَنَّ':       'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
-        'عَلَى_رَغم_مِن_أَنَّ':    'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
-        'عَلَى_رَغم_مِن_أَنَّ_هُوَ': 'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
-        'وَسطَ':              'وَسطَ:gen', # wasṭa = in the middle
-        'فِي_وَسطَ':           'وَسطَ:gen', # wasṭa = in the middle
-        'بِ_وَسطَ':            'وَسطَ:gen', # wasṭa = in the middle
-        'وِفقَ':              'وِفقَ:gen', # wifqa = according to
+        'إِذًا':              'إِذَا',
+        'إِذَا':              'إِذَا', # remove morphological case; ʾiḏā = if
         'إِزَاءَ':             'إِزَاءَ:gen', # ʾizāʾa = regarding, facing, towards
-        'بِ_إِزَاءَ':           'إِزَاءَ:gen', # ʾizāʾa = regarding, facing, towards
-        'قُربَ':              'قُربَ:gen', # qurba = near
-        'عَن_قُربَ':           'قُربَ:gen', # qurba = near
-        'وَرَاءَ':             'وَرَاءَ:gen', # warāʾa = behind, past, beyond
-        'عَن_أَنَّ_وَرَاءَ':       'وَرَاءَ:gen', # warāʾa = behind, past, beyond
-        'مِن_وَرَاءَ':          'مِن_وَرَاءِ:gen', # min warāʾi = from behind
-        'بِ_إِضَافَة_إِلَى':      'بِاَلإِضَافَةِ_إِلَى:gen', # bi-al-ʾiḍāfati ʾilā = in addition to
-        'فَوقَ':              'فَوقَ:gen', # fawqa = above, over
-        'مِن_فَوقَ':           'مِن_فَوقِ:gen', # min fawqi = from above
-        'إِلَى_جَانِب':         'إِلَى_جَانِبِ:gen', # ʾilā ǧānibi = beside
-        'مِن_جَانِب':          'إِلَى_جَانِبِ:gen', # min ǧānibi = beside
-        'بِ_هَدَف':            'بِهَدَفِ:gen', # bihadafi = with goal
-        'بِ_اِسم':            'بِاِسمِ:gen', # biismi = in name of
-        'مِن_حَيثُ':           'مِن:gen',
-        'بِ_حَيثُ':            'بِ:gen',
-        'فِي_حُضُور':          'فِي_حُضُورِ:gen', # fī ḥuḍūri = in presence of
-        'بِ_خِلَاف':            'بِخِلَافِ:gen', # biḫilāfi = in addition to
-        'جَرَّاء':             'جَرَّاء:gen', # ǧarrāʾ = because of
-        'مِن_جَرَّاء':          'جَرَّاء:gen', # ǧarrāʾ = because of
-        'عَن_طَرِيق':          'عَن_طَرِيقِ:gen', # ʿan ṭarīqi = via
-        'فِي_ظِلّ':            'فِي_ظِلِّ:gen', # fī ẓilli = in light of
-        'بِ_مُوجِب':           'بِمُوجِبِ:gen', # bimūǧibi = with motive
-        'حِيَالَ':             'حِيَالَ:gen', # ḥiyāla = concerning
-        'فِي_شَأن':           'فِي_شَأنِ:gen', # fī šaʾni = in regard of
-        'فِي_عُقب':           'فِي_أَعقَابِ:gen', # fī ʾaʿqābi = in the aftermath of
-        'بناء_عَلَى':         'بناء_عَلَى:gen', # bnāʾ ʿalā = based on
-        'طِوَالَ':             'طِوَالَ:gen', # ṭiwāla = throughout
-        'فِي_حِين_أَنَّ':        'فِي_حِينِ',
-        'فِي_غُضُون':          'فِي:gen',
-        'فِي_مُقَابِلَ':         'مُقَابِلَ:gen',
-        'لِ_بِ':              'لِ:gen',
-        'بِ_لَا':              'بِ:gen',
-        'لِ_صَالِح':           'لِصَالِحِ:gen', # liṣāliḥi = in interest of
-        'سِوَى':              'سِوَى:gen', # siwā = except for
-        'سِوَى_عَلَى':          'سِوَى:gen', # siwā = except for
-        'سِوَى_أَنَّ_هُوَ':        'سِوَى:gen', # siwā = except for
-        'سِوَى_بِ':            'سِوَى:gen', # siwā = except for
-        'سِوَى_لِ':            'سِوَى:gen', # siwā = except for
-        'بِ_اِستِثنَاء':        'بِاِستِثنَاءِ:gen', # biistiṯnāʾi = with exception of
-        'بِ_قُرب_مِن':         'بِاَلقُربِ_مِن:gen', # bi-al-qurbi min = near (with proximity to)
-        'قُبَالَةَ':            'قُبَالَةَ:gen', # qubālata = in front of, facing
-        'إِلَى_أَن':           'إِلَى:gen',
-        'بِ_إِلَى':            'بِ:gen',
-        'بِ_إِنَّ':             'بِ:gen',
-        'بِ_رَغم_مِن_أَن':      'بِ:gen',
-        'بِ_رَغم_مِن_أَنَّ_هُوَ':   'بِ:gen',
-        'بِ_عَلَى':            'بِ:gen',
-        'بِ_عَن':             'بِ:gen',
-        'بِ_فِي':             'بِ:gen',
-        'بِ_كَ':              'بِ:gen',
-        'بِ_لِ':              'بِ:gen',
-        'بِ_مَا_أَنَّ':          'بِ:gen',
-        'بِ_مِن':             'بِ:gen',
-        'بِ_وَ_لِ':            'بِ:gen',
-        'عَلَى_إِلَى':          'عَلَى:gen',
-        'عَلَى_بِ':            'عَلَى:gen',
-        'عَلَى_بِ_فِي':         'عَلَى:gen',
-        'عَلَى_مِن':           'عَلَى:gen',
-        'عَن_أَن':            'عَن:gen',
-        'عَن_أَنَّ':            'عَن:gen',
-        'عَن_بِ':             'عَن:gen',
-        'عَن_فِي_أَن':         'عَن:gen',
-        'عَن_مِن':            'عَن:gen',
-        'فِي_إِلَى':           'فِي:gen',
-        'فِي_أَن':            'فِي:gen',
-        'فِي_أَنَّ':            'فِي:gen',
-        'فِي_أَنَّ_عَلَى':        'فِي:gen',
-        'فِي_أَنَّ_لَدَى':        'فِي:gen',
-        'فِي_أَنَّ_مِن':         'فِي:gen',
-        'فِي_بِ':             'فِي:gen',
-        'فِي_بِ_فِي':          'فِي:gen',
-        'فِي_مَا':            'فِي:gen',
-        'فِي_مَعَ':            'فِي:gen',
-        'فِي_مِن':            'فِي:gen',
-        'كَ_لِ':              'كَ:gen',
-        'كَ_وَ_وَ':            'كَ:gen',
-        'لِ_إِلَى':            'لِ:gen',
-        'لِ_أَمَامَ_وَ':         'لِ:gen',
-        'لِ_أَن':             'لِ:gen',
-        'لِ_عَن':             'لِ:gen',
-        'لِ_فِي':             'لِ:gen',
-        'لِ_مَعَ':             'لِ:gen',
-        'لِ_مِن':             'لِ:gen',
-        'لِ_وَ':              'لِ:gen',
-        'لِ_وَ_فِي':           'لِ:gen',
-        'مَعَ_أَنَّ':            'مَعَ:gen',
-        'مَعَ_بِ':             'مَعَ:gen',
-        'مِن_إِلَى':           'مِن:gen',
-        'مِن_أَن':            'مِن:gen',
-        'مِن_أَنَّ':            'مِن:gen',
-        'مِن_بِ':             'مِن:gen',
-        'مِن_عَلَى':           'مِن:gen',
-        'مِن_فِي':            'مِن:gen',
-        'مِن_مِن':            'مِن:gen',
-        'بِ_مُنَاسَبَة':         'بِمُنَاسَبَةِ:gen', # bimunāsabati = on the occasion of
-        'فِي_مَجَال':          'فِي_مَجَالِ:gen', # fī maǧāli = in the area of
-        'عَدَا':              'عَدَا:gen', # ʿadā = except for
-        'بِ_اِعتِبَار':         'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
-        'بِ_اِعتِبَار_أَنَّ':      'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
-        'بِ_اِعتِبَار_مِن':      'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
-        'بِ_تُهمَة':           'بِتُهمَةِ:gen', # bituhmati = on charges of
-        'بِ_فَضل':            'بِفَضلِ:gen', # bifaḍli = thanks to
-        'عَلَى_حِسَاب':         'عَلَى_حِسَابِ:gen', # ʿalā ḥisābi = at the expense of
-        'لِ_حِسَاب':           'عَلَى_حِسَابِ:gen', # ʿalā ḥisābi = at the expense of
-        'عَلَى_رَأس':          'عَلَى_رَأسِ:gen', # ʿalā raʾsi = on top of
-        'قُبَيلَ':             'قُبَيلَ:gen', # qubayla = before
-        'مَهمَا':             'مَهمَا', # mahmā = regardless
-        'مِمَّا':              'مِمَّا', # mimmā = that, which
-        'مِمَّا_لَدَى':          'مِمَّا', # mimmā = that, which
-        'بِ_اِتِّجَاه':          'بِاِتِّجَاهِ:gen', # bi-ittiǧāhi = towards
-        'فِي_اِتِّجَاه':         'بِاِتِّجَاهِ:gen', # bi-ittiǧāhi = towards
-        'طَالَمَا':            'طَالَمَا', # ṭālamā = as long as
-        'طَالَمَا_أَنَّ':         'طَالَمَا', # ṭālamā = as long as
-        'عَلَى_غِرَار':         'عَلَى_غِرَارِ:gen', # ʿalā ġirāri = similar to
-        'فَورَ':              'فَورَ:gen', # fawra = as soon as
-        'فِي_حَال':           'فِي_حَالِ:gen', # fī ḥāli = in case
-        'فِي_حَالَة':          'فِي_حَالِ:gen', # fī ḥāli = in case
-        'بِ_حَالَة':           'فِي_حَالِ:gen', # fī ḥāli = in case
-        'لِ_مِثلَ':            'مِثلَ', # miṯla = like
-        'مِثلَمَا':            'مِثلَ', # miṯla = like
-        'مِن_مِثلَ':           'مِثلَ', # miṯla = like
-        'بِ_مِثلَ':            'مِثلَ', # miṯla = like
-        'فِي_مِثلَ':           'مِثلَ', # miṯla = like
-        'إِلَى_مِثلَ':          'مِثلَ', # miṯla = like
-        'عَلَى_مِثلَ':          'مِثلَ', # miṯla = like
-        'عَن_مِثلَ':           'مِثلَ', # miṯla = like
-        'مُنذُ_أَن':           'مُنذُ:gen',
-        'مُنذُ_وَ_فِي':         'مُنذُ:gen',
+        'أَلَّا':               'إِلَّا',
         'إِلَّا':               'إِلَّا', # ʾillā = except, unless
+        'إِلَّا_إِذَا':           'إِلَّا', # ʾillā = except, unless
+        'إِلَّا_أَن':            'إِلَّا', # ʾillā = except, unless
         'إِلَّا_أَنَّ':            'إِلَّا', # ʾillā = except, unless
         'إِلَّا_أَنَّ_هُوَ':         'إِلَّا', # ʾillā = except, unless
-        'إِلَّا_أَن':            'إِلَّا', # ʾillā = except, unless
-        'إِلَّا_إِذَا':           'إِلَّا', # ʾillā = except, unless
-        'عَلَى_إِلَّا':           'إِلَّا', # ʾillā = except, unless
-        'بَدَلًا_مِن':           'بَدَلًا_مِن:gen', # badalan min = instead of
-        'بِ_حُضُور':           'فِي_حُضُورِ:gen', # together with
-        'بِ_صَدَد':            'بِصَدَدِ:gen', # biṣadadi = with respect to
-        'بِ_مُقتَضَى':          'بِمُقتَضَى:gen', # bimuqtaḍā = with requirement of
-        'خَلفَ':              'خَلفَ:gen', # ḫalfa = behind
-        'عَلَى_أَسَاس':         'عَلَى_أَسَاسٍ:gen', # ʿalā ʾasāsin = based on
-        'عَلَى_أَسَاس_أَنَّ':      'عَلَى_أَسَاسٍ:gen', # ʿalā ʾasāsin = based on
-        'فِي_خِتَام':          'فِي_خِتَامِ', # fī ḫitāmi = in conclusion
-        'فِي_ضَوء':           'فِي_ضَوءِ:gen', # fī ḍawʾi = in light of
-        'كُلَّمَا':             'كُلَّمَا', # kullamā = whenever
-        'لِ_كَون':            'لِكَونِ', # likawni = because
-        'بِ_مُشَارَكَة':         'بِمُشَارَكَةِ:gen', # bimušārakati = with participation of
-        'بينا':             'بَينَ:gen', # bayna = between
-        'بِ_دَور':            'بِ:gen', # bidawri = with role, in turn?
-        'بِ_صِفَة':            'بِصِفَةِ:gen', # biṣifati = as
-        'بِ_قَصد':            'بِقَصدِ:gen', # biqaṣdi = with intention
-        'عَلَى_اِعتِبَار_أَنَّ':    'عَلَى_اِعتِبَارِ_أَنَّ', # ʿalā iʿtibāri ʾanna = considering that
-        'عَلَى_حَدّ':           'عَلَى:gen',
-        'فِي_حَدّ':            'فِي:gen',
-        'عَلَى_مدى':          'عَلَى:gen',
-        'عَلَى_يَد':           'عَلَى:gen',
-        'فَ':                'فَ', # fa = so (advcl or coordination)
-        'فَ_بَينَ':            'فَ', # fa = so (advcl or coordination)
-        'فَ_فِي':             'فَ', # fa = so (advcl or coordination)
-        'فَ_مِن':             'فَ', # fa = so (advcl or coordination)
-        'فَ_إِذَا':            'فَ', # fa = so (advcl or coordination)
-        'فَ_بَدَل_مِن_أَن':      'فَ', # fa = so (advcl or coordination)
-        'فَ_بَينَ':            'فَ', # fa = so (advcl or coordination)
-        'فَ_عَلَى':            'فَ', # fa = so (advcl or coordination)
-        'فَ_فِي':             'فَ', # fa = so (advcl or coordination)
-        'فِي_سَبِيل':          'فِي_سَبِيلِ:gen', # fī sabīli = in order to
-        'مِن_شَأن':           'مِن_شَأنِ:gen', # min šaʾni = from matter
-        'مِن_نَاحِيَة':         'مِن:gen',
-        'وإن':              'إِنَّ',
-        'حَتَّى_وإن':          'إِنَّ',
-        'إِلَى_بَينَ':          'إِلَى_بَينِ:gen', # ʾilā bayni = to between
-        'بِ_رَغم_مِن':         'رَغمَ:gen', # despite
-        'بِ_رَغم':            'رَغمَ:gen', # despite
-        'بِ_رَغم_أَنَّ':         'رَغمَ:gen', # despite
-        'بِ_رَغم_مِن_أَنَّ':      'رَغمَ:gen', # despite
-        'بدون':             'دُونَ:gen', # without
-        'بِ_تَعَاوُن_مَعَ':       'بِاَلتَّعَاوُنِ_مَعَ:gen', # bi-at-taʿāwuni maʿa = in cooperation with
-        'بِ_خُصُوص':           'بِخُصُوصِ:gen', # biḫuṣūṣi = with regard
-        'بِ_دَعوَى':           'بِ:gen',
-        'بِ_صَرف_نَظَر_عَن':     'بِصَرفِ_اَلنَّظَرِ_عَن:gen', # biṣarfi an-naẓari ʿan = regardless of
-        'بِ_وَاسِطَة':          'بِوَاسِطَةِ:gen', # biwāsiṭati = by means of
-        'ذٰلِكَ_لِأَنَّ':            'لِأَنَّ', # because
-        'عَلَى_قَيد':          'عَلَى:gen',
-        'فِي_دَاخِل':          'دَاخِل:gen',
-        'لِ_عَلَى':            'لِ:gen',
-        'لِذَا':              'لِذَا', # liḏā = so, therefore
-        'لِذٰلِكَ':             'لِذَا', # liḏā = so, therefore
-        'مِن_ثُمَّ':            'مِن:gen',
-        'مِن_خَارِج':          'مِن_خَارِجِ:gen', # min ḫāriǧi = from outside
-        'مِن_دَاخِلَ':          'مِن_دَاخِلِ:gen', # min dāḫili = from inside
-        'مِن_ضِمنَ':           'مِن_ضِمنِ:gen', # min ḍimni = from within = including
-        'هذا_بالأضافة':      'بِ:gen',
-        'أَلَّا':               'إِلَّا',
-        'إِمَّا_لِ':            'لِ:gen',
-        'إِيَّا':              'إِلَّا',
-        'بُعَيدَ':             'بُعَيدَ:gen', # buʿayda = shortly after
-        'بِ_إِضَافَة_لِ':        'بِاَلإِضَافَةِ_إِلَى:gen', # in addition to
-        'بِ_اِعتِمَاد_عَلَى':     'بِاَلِاعتِمَادِ_عَلَى:gen', # bi-al-i-ʼʿtimādi ʿalā = depending on
-        'بِ_ثُمَّ':             'بِ:gen',
-        'بِ_جَانِب':           'بِجَانِبِ:gen', # biǧānibi = next to
-        'بِ_حُلُول':           'بِ:gen',
-        'بِ_رِئَاسَة':          'بِ:gen',
-        'بِ_قَدر':            'بِ:gen',
-        'بِ_نِيَابَة_عَن':       'بِاَلنِّيَابَةِ_عَن:gen', # bi-an-niyābati ʿan = on behalf of
-        'بِنَاء_عَلَى':         'بناء_عَلَى:gen',
-        'ثُمَّ':               'بِ:gen',
-        'حَتَّى_إِنَّ':           'حَتَّى:gen', # before
-        'حَتَّى_بِ':            'حَتَّى:gen', # before
-        'حَتَّى_أَنَّ':           'حَتَّى:gen', # before
-        'حِينَمَا':            'فِي_حِينِ', # during
-        'إِلَى_حِينَ':          'فِي_حِينِ', # during
-        'ذٰلِكَ_بَعدَمَا':         'بَعدَ:gen',
-        'طالَما':            'طَالَمَا:gen',
-        'طِيلَةَ':             'طِيلَةَ:gen', # ṭīlata = during
-        'عَلَى_مَقرَبَة_مِن':     'عَلَى_مَقرَبَةٍ_مِن:gen', # ʿalā maqrabatin min = in the vicinity of
-        'غَيرَ':              'إِلَّا',
-        'فِي_بَاطِن':          'فِي:gen',
-        'فِي_سِيَاق':          'فِي:gen',
-        'فِي_صَفّ':            'فِي:gen',
-        'فِي_صُورَة':          'فِي:gen',
-        'فِي_مُوَاجَهَة':        'فِي:gen',
-        'لكن_إِذَا':          'إِذَا',
-        'لكن_لَدَى':          'لَدَى:gen',
-        'لَا':                'إِلَّا',
-        'لَمَّا':              'كُلَّمَا',
-        'لَمَّا_لِ':            'كُلَّمَا',
-        'لِ_جِهَة':            'لِ:gen',
-        'لِ_سَبَب':            'لِ:gen',
-        'لِ_فِي_بَينَ':         'لِ:gen',
-        'لِذَا_فَ':            'لِ:gen',
-        'ما_دَام':           'مِمَّا',
-        'مقابل':            'مُقَابِلَ:gen',
-        'مِن_بَعدَ':           'مِن:gen',
-        'مِن_ثَمَّ':            'مِن:gen',
-        'مِن_غَير_أَن':        'مِن:gen',
-        'مِن_قَبلَ':           'مِن_قِبَلِ:gen',
-        'نَاهِيك_بِ':          'بِ:gen',
-        'نَتِيجَة_لِ':          'لِ:gen',
-        'وان':              'أَنَّ',
-        'أَمَامَ_مِن':          'أَمَامَ:gen',
-        'أَمَّا':              'أَمَامَ:gen',
-        'إِذًا':              'إِذَا',
+        'إِلَى':              'إِلَى:gen', # ʾilā = to
+        'إِلَى_أَن':           'إِلَى:gen',
+        'إِلَى_أَنَّ':           'إِلَى_أَنَّ', # until? that?
+        'إِلَى_أَنَّ_لَدَى':       'إِلَى_أَنَّ',
+        'إِلَى_أَنَّ_مِن':        'إِلَى_أَنَّ',
+        'إِلَى_أَنَّ_هُوَ':        'إِلَى_أَنَّ',
+        'إِلَى_أَنَّ_هُوَ_مِن':     'إِلَى_أَنَّ',
+        'إِلَى_أَنَّ_هُوَ_مِن_بَينَ': 'إِلَى_أَنَّ',
         'إِلَى_بَعدَ':          'إِلَى:gen',
+        'إِلَى_بَينَ':          'إِلَى_بَينِ:gen', # ʾilā bayni = to between
+        'إِلَى_جَانِب':         'إِلَى_جَانِبِ:gen', # ʾilā ǧānibi = beside
+        'إِلَى_حَوَالَى':        'إِلَى:gen', # ila hawala = to around X
+        'إِلَى_حَوَالَى_مِن':     'إِلَى:gen', # ila hawala min
         'إِلَى_حَيثُ':          'إِلَى:gen',
+        'إِلَى_حِينَ':          'فِي_حِينِ', # during
+        'إِلَى_خَارِجَ':         'إِلَى_خَارِجِ:gen', # ʾilā ḫāriǧi = out
         'إِلَى_فِي':           'إِلَى:gen',
         'إِلَى_قَبلَ':          'إِلَى_قَبلِ:gen', # ʾilā qabli = until before X (e.g. until one year ago)
+        'إِلَى_مِثلَ':          'مِثلَ', # miṯla = like
+        'إِلَى_نَحوَ':          'إِلَى:gen', # to about N
+        'أَمَّا':              'أَمَامَ:gen',
+        'إِمَّا_لِ':            'لِ:gen',
+        'أَمَامَ':             'أَمَامَ:gen', # ʾamāma = in front of
+        'أَمَامَ_مِن':          'أَمَامَ:gen',
+        'أَن':               'أَنَّ', # remove morphological case; ʾanna = that
+        'أَنَّ':               'أَنَّ', # remove morphological case; ʾanna = that
+        'إِن':               'إِنَّ', # remove morphological case; ʾinna = that
+        'إِنَّ':               'إِنَّ', # remove morphological case; ʾinna = that
         'إِنَّمَا':             'إِنَّ',
-        'اِبتِدَاء_مِن':        'مِن:gen',
-        'بازاء':            'بِ:gen',
-        'بالتسخين':         'بِ:gen',
-        'بشان':             'بِشَأنِ:gen',
-        'بناء_لِ':           'لِ:gen',
-        'بَل':               'قَبلَ:gen',
-        'بَيدَ':              'بِ:gen',
-        'بَيدَ_أَنَّ':           'بِ:gen',
+        'إِيَّا':              'إِلَّا',
+        'بِ':                'بِ:gen', # bi = for, with
+        'بِ_اِتِّجَاه':          'بِاِتِّجَاهِ:gen', # bi-ittiǧāhi = towards
+        'بِ_إِزَاءَ':           'إِزَاءَ:gen', # ʾizāʾa = regarding, facing, towards
+        'بِ_اِستِثنَاء':        'بِاِستِثنَاءِ:gen', # biistiṯnāʾi = with exception of
+        'بِ_اِسم':            'بِاِسمِ:gen', # biismi = in name of
+        'بِ_إِضَافَة_إِلَى':      'بِاَلإِضَافَةِ_إِلَى:gen', # bi-al-ʾiḍāfati ʾilā = in addition to
+        'بِ_إِضَافَة_إِلَى_أَنَّ':   'إِلَى_أَنَّ',
+        'بِ_إِضَافَة_لِ':        'بِاَلإِضَافَةِ_إِلَى:gen', # in addition to
+        'بِ_اِعتِبَار':         'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
+        'بِ_اِعتِبَار_أَنَّ':      'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
+        'بِ_اِعتِبَار_مِن':      'بِاِعتِبَارِ:gen', # bi-iʿtibāri = with regard to
+        'بِ_اِعتِمَاد_عَلَى':     'بِاَلِاعتِمَادِ_عَلَى:gen', # bi-al-i-ʼʿtimādi ʿalā = depending on
+        'بِ_إِلَى':            'بِ:gen',
+        'بِ_أَنَّ':             'أَنَّ', # that
         'بِ_أَن':             'بِ:gen',
+        'بِ_إِنَّ':             'بِ:gen',
+        'بِ_أَنَّ_أَمَامَ':        'أَنَّ', # that
+        'بِ_أَنَّ_لَا':           'أَنَّ', # that
+        'بِ_أَنَّ_مِن':          'أَنَّ', # that
+        'بِ_أَنَّ_هما_مِن':      'أَنَّ', # that
+        'بِ_أَنَّ_هُوَ':          'أَنَّ', # that
+        'بِ_أَنَّ_هُوَ_عَلَى':      'أَنَّ', # that
         'بِ_اِنطِلَاق':          'بِ:gen',
         'بِ_تَالِي_إِنَّ':        'بِ:gen',
+        'بِ_تَعَاوُن_مَعَ':       'بِاَلتَّعَاوُنِ_مَعَ:gen', # bi-at-taʿāwuni maʿa = in cooperation with
+        'بِ_تُهمَة':           'بِتُهمَةِ:gen', # bituhmati = on charges of
         'بِ_تَوَازِي_مَعَ':       'بِاَلتَّوَازِي_مَعَ:gen', # bi-at-tawāzī maʿa = in parallel with
+        'بِ_ثُمَّ':             'بِ:gen',
+        'بِ_جَانِب':           'بِجَانِبِ:gen', # biǧānibi = next to
         'بِ_جِهَة':            'بِ:gen',
+        'بِ_حَالَة':           'فِي_حَالِ:gen', # fī ḥāli = in case
+        'بِ_حَسَبَ':            'حَسَبَ:gen', # ḥasaba = according to, depending on
+        'بِ_حُضُور':           'فِي_حُضُورِ:gen', # together with
         'بِ_حَقّ':             'بِ:gen',
         'بِ_حُكم':            'بِ:gen',
+        'بِ_حُلُول':           'بِ:gen',
+        'بِ_حَوَالَى':          'بِ:gen', # bi hawala = with around X
+        'بِ_حَيثُ':            'بِ:gen',
+        'بِ_خُصُوص':           'بِخُصُوصِ:gen', # biḫuṣūṣi = with regard
+        'بِ_خِلَاف':            'بِخِلَافِ:gen', # biḫilāfi = in addition to
         'بِ_دَاخِلَ':           'دَاخِلَ:gen',
+        'بِ_دَعوَى':           'بِ:gen',
+        'بِ_دَور':            'بِ:gen', # bidawri = with role, in turn?
         'بِ_دُون':            'دُونَ:gen',
+        'بِ_دُونَ':            'دُونَ:gen', # bi dūni = without
+        'بِ_دُونَ_أَن':         'دُونَ:gen', # bi dūni ʾan = without
+        'بِ_رَغم':            'رَغمَ:gen', # despite
+        'بِ_رَغم_أَنَّ':         'رَغمَ:gen', # despite
+        'بِ_رَغم_مِن':         'رَغمَ:gen', # despite
+        'بِ_رَغم_مِن_أَن':      'بِ:gen',
+        'بِ_رَغم_مِن_أَنَّ':      'رَغمَ:gen', # despite
+        'بِ_رَغم_مِن_أَنَّ_هُوَ':   'بِ:gen',
         'بِ_رِفقَة':           'بِرِفقَةٍ:gen', # birifqatin = in company of
+        'بِ_رِئَاسَة':          'بِ:gen',
         'بِ_سَبّ':             'بِ:gen',
+        'بِ_سَبَب':            'بِسَبَبِ:gen', # bisababi = because of
+        'بِ_شَأن':            'بِشَأنِ:gen', # bišaʾni = about, regarding (lit. with + matter)
         'بِ_شَرط_أَن':         'بِ:gen',
+        'بِ_صَدَد':            'بِصَدَدِ:gen', # biṣadadi = with respect to
+        'بِ_صَرف_نَظَر_عَن':     'بِصَرفِ_اَلنَّظَرِ_عَن:gen', # biṣarfi an-naẓari ʿan = regardless of
+        'بِ_صِفَة':            'بِصِفَةِ:gen', # biṣifati = as
         'بِ_عَكس':            'بِ:gen',
+        'بِ_عَلَى':            'بِ:gen',
+        'بِ_عَن':             'بِ:gen',
         'بِ_غَضّ_نَظَر_عَن':      'بِغَضِّ_اَلنَّظَرِ_عَن:gen', # biġaḍḍi an-naẓari ʿan = regardless of
+        'بِ_فَضل':            'بِفَضلِ:gen', # bifaḍli = thanks to
+        'بِ_فِي':             'بِ:gen',
+        'بِ_قَدر':            'بِ:gen',
+        'بِ_قُرب_مِن':         'بِاَلقُربِ_مِن:gen', # bi-al-qurbi min = near (with proximity to)
+        'بِ_قَصد':            'بِقَصدِ:gen', # biqaṣdi = with intention
+        'بِ_كَ':              'بِ:gen',
+        'بِ_لِ':              'بِ:gen',
+        'بِ_لَا':              'بِ:gen',
+        'بِ_مَا_أَنَّ':          'بِ:gen',
         'بِ_مَثَابَة':          'بِ:gen',
+        'بِ_مِثلَ':            'مِثلَ', # miṯla = like
         'بِ_مُجَرَّد':           'بِ:gen',
         'بِ_مُسَاعَدَة':         'بِ:gen',
+        'بِ_مُشَارَكَة':         'بِمُشَارَكَةِ:gen', # bimušārakati = with participation of
         'بِ_مُقَارَنَة_بِ':       'بِاَلمُقَارَنَةِ_بِ:gen', # bi-al-muqāranati bi = in comparison to
+        'بِ_مُقتَضَى':          'بِمُقتَضَى:gen', # bimuqtaḍā = with requirement of
         'بِ_مِقدَار':          'بِ:gen',
+        'بِ_مِن':             'بِ:gen',
+        'بِ_مُنَاسَبَة':         'بِمُنَاسَبَةِ:gen', # bimunāsabati = on the occasion of
+        'بِ_مُوجِب':           'بِمُوجِبِ:gen', # bimūǧibi = with motive
         'بِ_نَتِيجَة':          'بِ:gen',
+        'بِ_نَحوَ':            'بِ:gen', # by about N
+        'بِ_نِسبَة':           'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati (bin-nisbati) = in proportion/relation to
+        'بِ_نِسبَة_إِلَى':       'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati ʾilā (bin-nisbati ʾilā) = in proportion/relation to
+        'بِ_نِسبَة_لِ':         'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati li (bin-nisbati li) = in proportion/relation to
+        'بِ_نِسبَة_لِ_مِن':      'بِاَلنِّسبَةِ_لِ:gen', # bi an-nisbati li (bin-nisbati li) = in proportion/relation to
         'بِ_نَظَر_إِلَى':        'بِ:gen',
+        'بِ_نِيَابَة_عَن':       'بِاَلنِّيَابَةِ_عَن:gen', # bi-an-niyābati ʿan = on behalf of
+        'بِ_هَدَف':            'بِهَدَفِ:gen', # bihadafi = with goal
+        'بِ_وَ_لِ':            'بِ:gen',
+        'بِ_وَاسِطَة':          'بِوَاسِطَةِ:gen', # biwāsiṭati = by means of
         'بِ_وَاقِع':           'بِ:gen',
         'بِ_وَسَط':            'بِوَسَطِ:gen', # biwasaṭi = in the middle of
+        'بِ_وَسطَ':            'وَسطَ:gen', # wasṭa = in the middle
         'بِ_وَصف':            'بِ:gen',
+        'بازاء':            'بِ:gen',
+        'بالتسخين':         'بِ:gen',
+        'بَدَلًا_مِن':           'بَدَلًا_مِن:gen', # badalan min = instead of
+        'بدون':             'دُونَ:gen', # without
+        'بشان':             'بِشَأنِ:gen',
+        'بَعدَ':              'بَعدَ:gen', # baʿda = after
+        'بَعدَ_أَن':           'بَعدَ:gen', # baʿda ʾan = after + clause
+        'بَعدَ_حَوَالَى':        'بَعدَ:gen', # baada hawala
+        'بَعدَ_نَحوَ':          'بَعدَ:gen', # after about N
+        'بَعدَمَا':            'بَعدَ:gen', # baʿdamā = after
+        'بُعَيدَ':             'بُعَيدَ:gen', # buʿayda = shortly after
+        'بَل':               'قَبلَ:gen',
+        'بِنَاء_عَلَى':         'بناء_عَلَى:gen',
+        'بناء_عَلَى':         'بناء_عَلَى:gen', # bnāʾ ʿalā = based on
+        'بناء_لِ':           'لِ:gen',
+        'بَيدَ':              'بِ:gen',
+        'بَيدَ_أَنَّ':           'بِ:gen',
+        'بَينَ':              'بَينَ:gen', # bayna = between
+        'بَينَ_حَوَالَى':        'بَينَ:gen', # bayna hawala
+        'بينا':             'بَينَ:gen', # bayna = between
+        'بَينَمَا':            'بَينَ:gen',
+        'بَينَمَا_لَم':         'بَينَ:gen',
+        'تُجَاهَ':             'تُجَاهَ:gen', # tuǧāha = towards, facing
+        'تَحتَ':              'تَحتَ:gen', # tahta = under
         'ثَمَّ':               'بِ:gen',
+        'ثُمَّ':               'بِ:gen',
+        'جَرَّاء':             'جَرَّاء:gen', # ǧarrāʾ = because of
+        'حَتَّى':              'حَتَّى:gen', # ḥattā = until
+        'حَتَّى_أَنَّ':           'حَتَّى:gen', # before
+        'حَتَّى_إِنَّ':           'حَتَّى:gen', # before
+        'حَتَّى_بِ':            'حَتَّى:gen', # before
+        'حَتَّى_لَو':           'لَو', # even if
+        'حَتَّى_وَ_لَو':         'لَو', # even if
+        'حَتَّى_وإن':          'إِنَّ',
+        'حَسَبَ':              'حَسَبَ:gen', # ḥasaba = according to, depending on
+        'حَسَبَمَا':            'حَسَبَ:gen', # ḥasaba = according to, depending on
+        'حَوَالَى':            'حَوَالَى', # ḥawālā = around, about
+        'حَوَالَى_مِن':         'مِن:gen', # hawala min = from around X
+        'حَولَ':              'حَولَ:gen', # ḥawla = about
         'حولما_إِذَا':        'إِذَا',
+        'حِيَالَ':             'حِيَالَ:gen', # ḥiyāla = concerning
+        'حَيثُ':              'حَيثُ', # remove morphological case; ḥayṯu = where (SCONJ, not ADV)
+        'حِينَمَا':            'فِي_حِينِ', # during
+        'خَارِجَ':             'خَارِجَ:gen', # ḫāriǧa = outside
+        'خِلَالَ':              'خِلَالَ:gen', # ḫilāla = during
+        'خَلفَ':              'خَلفَ:gen', # ḫalfa = behind
+        'دَاخِلَ':             'دَاخِلَ:gen', # dāḫila = inside of
+        'دُونَ':              'دُونَ:gen', # dūna = without
+        'دُونَ_أَن':           'دُونَ:gen', # dūna ʾan = without
+        'دُونَ_سِوَى':          'دُونَ:gen', # dūna siwā = without
         'دونما':            'دُونَ:gen',
-        'ذٰلِكَ_عِندَمَا':         'بِ:gen',
-        'ذٰلِكَ_نَظَر_لِ':         'بِ:gen',
+        'ذٰلِكَ_بَعدَمَا':        'بَعدَ:gen',
+        'ذٰلِكَ_عِندَمَا':        'بِ:gen',
+        'ذٰلِكَ_لِأَنَّ':           'لِأَنَّ', # because
+        'ذٰلِكَ_لِكَي':          'لِكَي', # li-kay = in order to
+        'ذٰلِكَ_نَظَر_لِ':        'بِ:gen',
+        'رَغمَ':              'رَغمَ:gen', # raġma = despite
+        'رَغمَ_أَنَّ':           'رَغمَ:gen', # raġma ʾanna = despite + clause
+        'رَغمَ_أَنَّ_مِن':        'رَغمَ:gen', # raġma ʾanna min = despite
         'رَهنَ':              'رَهنَ:gen', # rahna = depending on
         'رَيثَمَا':            'رَهنَ:gen', # rahna = depending on
+        'سِوَى':              'سِوَى:gen', # siwā = except for
+        'سِوَى_أَنَّ_هُوَ':        'سِوَى:gen', # siwā = except for
+        'سِوَى_بِ':            'سِوَى:gen', # siwā = except for
+        'سِوَى_عَلَى':          'سِوَى:gen', # siwā = except for
+        'سِوَى_لِ':            'سِوَى:gen', # siwā = except for
+        'ضِدَّ':               'ضِدَّ:gen', # ḍidda = against
+        'ضِمنَ':              'ضِمنَ:gen', # ḍimna = within, inside, among
+        'طَالَمَا':            'طَالَمَا', # ṭālamā = as long as
+        'طالَما':            'طَالَمَا:gen',
+        'طَالَمَا_أَنَّ':         'طَالَمَا', # ṭālamā = as long as
+        'طِوَالَ':             'طِوَالَ:gen', # ṭiwāla = throughout
+        'طِيلَةَ':             'طِيلَةَ:gen', # ṭīlata = during
         'عبر':              'عَبرَ:gen',
+        'عَبرَ':              'عَبرَ:gen', # ʿabra = via
+        'عَدَا':              'عَدَا:gen', # ʿadā = except for
+        'عَقِبَ':              'عَقِبَ:gen', # ʿaqiba = following
+        'عَقِبَ_أَن':           'عَقِبَ:gen', # ʿaqiba = following
+        'عَقِبَ_مِن':           'عَقِبَ:gen', # ʿaqiba = following
+        'عَلَى':              'عَلَى:gen', # ʿalā = on
         'عَلَى_أبواب':        'عَلَى:gen',
         'عَلَى_أَثَر':          'عَلَى:gen',
-        'عَلَى_الفور':        'عَلَى:gen',
+        'عَلَى_إِثرَ':          'إِثرَ:gen', # ʿalā ʾiṯri = right after
         'عَلَى_اِختِلَاف':        'عَلَى:gen',
+        'عَلَى_أَسَاس':         'عَلَى_أَسَاسٍ:gen', # ʿalā ʾasāsin = based on
+        'عَلَى_أَسَاس_أَنَّ':      'عَلَى_أَسَاسٍ:gen', # ʿalā ʾasāsin = based on
+        'عَلَى_اِعتِبَار_أَنَّ':    'عَلَى_اِعتِبَارِ_أَنَّ', # ʿalā iʿtibāri ʾanna = considering that
+        'عَلَى_إِلَّا':           'إِلَّا', # ʾillā = except, unless
+        'عَلَى_الفور':        'عَلَى:gen',
+        'عَلَى_إِلَى':          'عَلَى:gen',
+        'عَلَى_أَن':           'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَنَّ':           'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَن_بِ':         'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَنَّ_مِن_شَأن':    'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَنَّ_هُوَ':        'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَنَّ_هُوَ_لَدَى':    'عَلَى:gen', # ʿalā = on
+        'عَلَى_بِ':            'عَلَى:gen',
+        'عَلَى_بِ_فِي':         'عَلَى:gen',
         'عَلَى_بَينَ':          'عَلَى:gen',
+        'عَلَى_حَدّ':           'عَلَى:gen',
+        'عَلَى_حِسَاب':         'عَلَى_حِسَابِ:gen', # ʿalā ḥisābi = at the expense of
+        'عَلَى_حَسَبَ':          'حَسَبَ:gen', # ḥasaba = according to, depending on
         'عَلَى_حَولَ':          'عَلَى:gen',
+        'عَلَى_رَأس':          'عَلَى_رَأسِ:gen', # ʿalā raʾsi = on top of
+        'عَلَى_رَغم':          'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
+        'عَلَى_رَغم_أَنَّ':       'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
+        'عَلَى_رَغمَ_أَنَّ':       'رَغمَ:gen', # ʿalā raġma ʾanna = despite + clause
+        'عَلَى_رَغم_مِن':       'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
+        'عَلَى_رَغم_مِن_أَنَّ':    'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
+        'عَلَى_رَغم_مِن_أَنَّ_هُوَ': 'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
         'عَلَى_طَرِيقَة':        'عَلَى_طَرِيقَةِ:gen', # ʿalā ṭarīqati = on the way
         'عَلَى_عَكس':          'عَلَى:gen',
+        'عَلَى_غِرَار':         'عَلَى_غِرَارِ:gen', # ʿalā ġirāri = similar to
+        'عَلَى_قَيد':          'عَلَى:gen',
+        'عَلَى_لِسَان':         'عَلَى:gen',
+        'عَلَى_مِثلَ':          'مِثلَ', # miṯla = like
+        'عَلَى_مدى':          'عَلَى:gen',
         'عَلَى_مَدَى':          'عَلَى_مَدَى:gen', # ʿalā madā = on period
+        'عَلَى_مَقرَبَة_مِن':     'عَلَى_مَقرَبَةٍ_مِن:gen', # ʿalā maqrabatin min = in the vicinity of
+        'عَلَى_مِن':           'عَلَى:gen',
+        'عَلَى_نَحوَ':          'عَلَى:gen', # to about N
+        'عَلَى_يَد':           'عَلَى:gen',
+        'عَن':               'عَن:gen', # ʿan = about, from
+        'عَن_أَن':            'عَن:gen',
+        'عَن_أَنَّ':            'عَن:gen',
+        'عَن_أَنَّ_وَرَاءَ':       'وَرَاءَ:gen', # warāʾa = behind, past, beyond
+        'عَن_بِ':             'عَن:gen',
+        'عَن_طَرِيق':          'عَن_طَرِيقِ:gen', # ʿan ṭarīqi = via
+        'عَن_فِي_أَن':         'عَن:gen',
+        'عَن_قُربَ':           'قُربَ:gen', # qurba = near
+        'عَن_مِثلَ':           'مِثلَ', # miṯla = like
+        'عَن_مِن':            'عَن:gen',
+        'عِندَ':              'عِندَمَا', # ʿinda = when
+        'عِندَمَا':            'عِندَمَا', # ʿindamā = when
+        'غَيرَ':              'إِلَّا',
+        'فَ':                'فَ', # fa = so (advcl or coordination)
+        'فَ_إِذَا':            'فَ', # fa = so (advcl or coordination)
+        'فَ_بَدَل_مِن_أَن':      'فَ', # fa = so (advcl or coordination)
+        'فَ_بَينَ':            'فَ', # fa = so (advcl or coordination)
+        'فَ_عَلَى':            'فَ', # fa = so (advcl or coordination)
+        'فَ_فِي':             'فَ', # fa = so (advcl or coordination)
+        'فَ_مِن':             'فَ', # fa = so (advcl or coordination)
+        'فَورَ':              'فَورَ:gen', # fawra = as soon as
+        'فَوقَ':              'فَوقَ:gen', # fawqa = above, over
+        'فِي':               'فِي:gen', # fī = in
+        'فِي_اِتِّجَاه':         'بِاِتِّجَاهِ:gen', # bi-ittiǧāhi = towards
+        'فِي_أَثنَاءَ':         'أَثنَاءَ:gen', # ʾaṯnāʾa = during
+        'فِي_إِطَار':          'فِي_إِطَار:gen', # fī ʾiṭār = in frame
+        'فِي_إِلَى':           'فِي:gen',
+        'فِي_أَن':            'فِي:gen',
+        'فِي_أَنَّ':            'فِي:gen',
+        'فِي_أَنَّ_عَلَى':        'فِي:gen',
+        'فِي_أَنَّ_لَدَى':        'فِي:gen',
+        'فِي_أَنَّ_مِن':         'فِي:gen',
+        'فِي_بِ':             'فِي:gen',
+        'فِي_بِ_فِي':          'فِي:gen',
+        'فِي_بَاطِن':          'فِي:gen',
         'فِي_بَعدَ':           'فِي:gen',
         'فِي_بَينَ':           'بَينَ:gen',
+        'فِي_حَال':           'فِي_حَالِ:gen', # fī ḥāli = in case
+        'فِي_حَالَة':          'فِي_حَالِ:gen', # fī ḥāli = in case
+        'فِي_حَدّ':            'فِي:gen',
+        'فِي_حُضُور':          'فِي_حُضُورِ:gen', # fī ḥuḍūri = in presence of
         'فِي_حَقّ':            'فِي:gen',
         'فِي_حُكم':           'فِي:gen',
+        'فِي_حَوَالَى':         'فِي:gen', # fi hawala = in around X
+        'فِي_حِين':           'فِي_حِينِ', # fī ḥīni = while
+        'فِي_حِينَ':           'فِي_حِينِ', # fī ḥīni = while
+        'فِي_حِين_أَنَّ':        'فِي_حِينِ',
+        'فِي_خَارِجَ':          'خَارِجَ:gen', # ḫāriǧa = outside
+        'فِي_خِتَام':          'فِي_خِتَامِ', # fī ḫitāmi = in conclusion
         'فِي_خِلَالَ':           'فِي:gen',
+        'فِي_دَاخِل':          'دَاخِل:gen',
         'فِي_دَاخِلَ':          'فِي:gen',
+        'فِي_سَبِيل':          'فِي_سَبِيلِ:gen', # fī sabīli = in order to
+        'فِي_سِيَاق':          'فِي:gen',
+        'فِي_شَأن':           'فِي_شَأنِ:gen', # fī šaʾni = in regard of
         'فِي_شَكل':           'فِي:gen',
+        'فِي_صَفّ':            'فِي:gen',
+        'فِي_صُورَة':          'فِي:gen',
+        'فِي_ضَوء':           'فِي_ضَوءِ:gen', # fī ḍawʾi = in light of
+        'فِي_ظِلّ':            'فِي_ظِلِّ:gen', # fī ẓilli = in light of
+        'فِي_عُقب':           'فِي_أَعقَابِ:gen', # fī ʾaʿqābi = in the aftermath of
         'فِي_غَضن':           'فِي:gen',
+        'فِي_غُضُون':          'فِي:gen',
+        'فِي_مَا':            'فِي:gen',
+        'فِي_مِثلَ':           'مِثلَ', # miṯla = like
+        'فِي_مَجَال':          'فِي_مَجَالِ:gen', # fī maǧāli = in the area of
         'فِي_مستشفى':        'فِي:gen',
+        'فِي_مَعَ':            'فِي:gen',
+        'فِي_مُقَابِلَ':         'مُقَابِلَ:gen',
         'فِي_مَقدَم':          'فِي:gen',
+        'فِي_مِن':            'فِي:gen',
         'فِي_مُنَاسَبَة':        'فِي_مُنَاسَبَةِ:gen', # fī munāsabati = on the occasion of
+        'فِي_مُوَاجَهَة':        'فِي:gen',
+        'فِي_نَحوَ':           'فِي:gen', # in about N
         'فِي_نِطَاق':          'فِي:gen',
         'فِي_وَجه':           'فِي:gen',
         'فِي_وَسط':           'وَسطَ:gen',
+        'فِي_وَسطَ':           'وَسطَ:gen', # wasṭa = in the middle
+        'فِيمَا':             'فِيمَا', # fīmā = while
+        'قُبَالَةَ':            'قُبَالَةَ:gen', # qubālata = in front of, facing
+        'قَبلَ':              'قَبلَ:gen', # qabla = before
+        'قَبلَ_أَن':           'قَبلَ:gen', # qabla = before
+        'قَبلَ_حَوَالَى':        'قَبلَ:gen', # qabla hawala
+        'قَبلَ_نَحوَ':          'قَبلَ:gen', # before about N
+        'قُبَيلَ':             'قُبَيلَ:gen', # qubayla = before
+        'قُربَ':              'قُربَ:gen', # qurba = near
         'قَيدَ':              'فِي:gen',
+        'كَ':                'كَ:gen', # ka = in (temporal?)
         'كَ_أَنَّ':             'كَ:gen',
+        'كَ_لِ':              'كَ:gen',
+        'كَ_وَ_وَ':            'كَ:gen',
         'كَأَنَّمَا':            'كَأَنَّمَا', # ka-ʾannamā = as if
-        'لدى':              'لَدَى:gen',
-        'لكن_بِ':            'بِ:gen',
-        'لكن_دَاخِلَ':         'دَاخِلَ:gen',
+        'كُلَّمَا':             'كُلَّمَا', # kullamā = whenever
+        'كَمَا':              'كَمَا', # remove morphological case; kamā = as
+        'كَي':               'لِكَي', # kay = in order to
         'لَ':                'لِ:gen',
-        'لَا_سِيَّمَا_بَعدَ':       'بَعدَ:gen',
-        'لَا_سِيَّمَا_وَ_أَنَّ':      'أَنَّ',
-        'لَا_سِيَّمَا_وَ_أَنَّ_هُوَ':   'أَنَّ',
+        'لِ':                'لِ:gen', # li = to
         'لِ_أَجَلّ':            'لِ:gen',
-        'لِ_دَرَجَة_أَنَّ':        'لِ:gen',
+        'لِ_إِلَى':            'لِ:gen',
+        'لِ_أَمَامَ_وَ':         'لِ:gen',
+        'لِ_أَن':             'لِ:gen',
+        'لِ_بِ':              'لِ:gen',
+        'لِ_جِهَة':            'لِ:gen',
+        'لِ_حِسَاب':           'عَلَى_حِسَابِ:gen', # ʿalā ḥisābi = at the expense of
+        'لِ_حَوَالَى':          'لِ:gen', # li hawala = for around X
+        'لِ_خَارِجَ':           'لِخَارِجِ:gen', # liḫāriǧi = out
         'لِ_دُخُول':           'لِ:gen',
+        'لِ_دَرَجَة_أَنَّ':        'لِ:gen',
+        'لِ_سَبَب':            'لِ:gen',
+        'لِ_صَالِح':           'لِصَالِحِ:gen', # liṣāliḥi = in interest of
+        'لِ_عَلَى':            'لِ:gen',
+        'لِ_عَن':             'لِ:gen',
         'لِ_عِندَ':            'لِ:gen',
+        'لِ_فِي':             'لِ:gen',
+        'لِ_فِي_بَينَ':         'لِ:gen',
+        'لِ_كَون':            'لِكَونِ', # likawni = because
         'لِ_لِئَلّا':            'لِ:gen',
+        'لِ_مِثلَ':            'مِثلَ', # miṯla = like
+        'لِ_مَعَ':             'لِ:gen',
+        'لِ_مِن':             'لِ:gen',
+        'لِ_نَحوَ':            'لِ:gen', # to/for about N
+        'لِ_وَ':              'لِ:gen',
+        'لِ_وَ_فِي':           'لِ:gen',
+        'لَا':                'إِلَّا',
+        'لَا_سِيَّمَا_بَعدَ':       'بَعدَ:gen',
+        'لَا_سِيَّمَا_وَ_أَنَّ':      'أَنَّ',
+        'لَا_سِيَّمَا_وَ_أَنَّ_هُوَ':   'أَنَّ',
+        'لِأَنَّ':               'لِأَنَّ', # remove morphological case; li-ʾanna = because
+        'لدى':              'لَدَى:gen',
+        'لَدَى':              'لَدَى:gen', # ladā = with, by, of, for
+        'لِذَا':              'لِذَا', # liḏā = so, therefore
+        'لِذَا_فَ':            'لِ:gen',
+        'لِذٰلِكَ':             'لِذَا', # liḏā = so, therefore
+        'لٰكِنَّ':              'مَعَ:gen',
+        'لكن_إِذَا':          'إِذَا',
+        'لكن_بِ':            'بِ:gen',
         'لٰكِن_بَعدَ':          'بَعدَ:gen',
+        'لكن_دَاخِلَ':         'دَاخِلَ:gen',
+        'لكن_لَدَى':          'لَدَى:gen',
         'لٰكِن_مَعَ':           'مَعَ:gen',
-        'لٰكِنَّ':              'مَعَ:gen',
+        'لِكَي':              'لِكَي', # li-kay = in order to
+        'لَمَّا':              'كُلَّمَا',
+        'لَمَّا_لِ':            'كُلَّمَا',
+        'لَو':               'لَو', # law = if
+        'لَو_أَنَّ':            'لَو', # if
+        'لَو_مِن':            'لَو', # if
         'ما':               'مِمَّا',
         'مَا':               'مِمَّا',
+        'ما_دَام':           'مِمَّا',
         'مادامت':           'مِمَّا',
         'مَالَم':             'مَالَم', # mālam = unless
+        'مِثلَ':              'مِثلَ', # remove morphological case; miṯla = like
+        'مِثلَمَا':            'مِثلَ', # miṯla = like
+        'مَعَ':               'مَعَ:gen', # maʿa = with
+        'مَعَ_أَنَّ':            'مَعَ:gen',
+        'مَعَ_بِ':             'مَعَ:gen',
         'مَعَ_فِي':            'مَعَ:gen',
+        'مَعَ_مِن_بَينَ':        'بَينَ:gen',
+        'مقابل':            'مُقَابِلَ:gen',
+        'مُقَابِلَ':            'مُقَابِلَ:gen', # muqābila = in exchange for, opposite to, corresponding to
+        'مُقَابِلَ_حَوَالَى':      'مُقَابِلَ:gen', # muqabila hawala
         'مُقَارَن_بِ':          'بِ:gen',
+        'مِمَّا':              'مِمَّا', # mimmā = that, which
+        'مِمَّا_لَدَى':          'مِمَّا', # mimmā = that, which
+        'مِن':               'مِن:gen', # min = from
+        'مِن_اجل':           'مِن_أَجلِ:gen', # min ʾaǧli = for the sake of
+        'مِن_أَجل':           'مِن_أَجلِ:gen', # min ʾaǧli = for the sake of
         'مِن_أَجل_أَن':        'مِن:gen',
+        'مِن_إِلَى':           'مِن:gen',
+        'مِن_أَن':            'مِن:gen',
+        'مِن_أَنَّ':            'مِن:gen',
+        'مِن_بِ':             'مِن:gen',
+        'مِن_بَعدَ':           'مِن:gen',
+        'مِن_بَينَ':           'بَينَ:gen',
         'مِن_تَحتَ':           'مِن:gen',
+        'مِن_ثَمَّ':            'مِن:gen',
+        'مِن_ثُمَّ':            'مِن:gen',
+        'مِن_جَانِب':          'إِلَى_جَانِبِ:gen', # min ǧānibi = beside
+        'مِن_جَرَّاء':          'جَرَّاء:gen', # ǧarrāʾ = because of
+        'مِن_حَوَالَى':         'مِن:gen', # min hawala = from around X
         'مِن_حَولَ':           'مِن:gen',
-        'مِن_دُون_أَن':        'مِن_دُون:gen',
+        'مِن_حَيثُ':           'مِن:gen',
+        'مِن_خَارِج':          'مِن_خَارِجِ:gen', # min ḫāriǧi = from outside
+        'مِن_خَارِجَ':          'مِن_خَارِجِ:gen', # min ḫāriǧi = from outside
+        'مِن_خِلَالَ':           'مِن_خِلَالِ:gen', # min ḫilāli = through, during
+        'مِن_دَاخِلَ':          'مِن_دَاخِلِ:gen', # min dāḫili = from inside
+        'مِن_دُونَ':           'مِن_دُونِ:gen', # min dūni = without, beneath, underneath
+        'مِن_دُون_أَن':        'مِن_دُونِ:gen',
+        'مِن_دُونَ_أَن':        'مِن_دُونِ:gen', # min dūni ʾan = without, beneath, underneath + clause
+        'مِن_شَأن':           'مِن_شَأنِ:gen', # min šaʾni = from matter
+        'مِن_ضِمنَ':           'مِن_ضِمنِ:gen', # min ḍimni = from within = including
         'مِن_طَرَف':           'مِن:gen',
+        'مِن_عَلَى':           'مِن:gen',
         'مِن_عِندَ':           'مِن:gen',
+        'مِن_غَير_أَن':        'مِن:gen',
+        'مِن_فَوقَ':           'مِن_فَوقِ:gen', # min fawqi = from above
+        'مِن_فِي':            'مِن:gen',
+        'مِن_قَبلَ':           'مِن_قِبَلِ:gen',
+        'مِن_قِبَل':           'مِن_قِبَلِ:gen', # min qibali = by
+        'مِن_قِبَل_بِ_فِي':      'مِن_قِبَلِ:gen', # min qibali = by
+        'مِن_مِثلَ':           'مِثلَ', # miṯla = like
+        'مِن_مِن':            'مِن:gen',
+        'مِن_مِن_بَينَ':        'بَينَ:gen',
         'مِن_مَوقِع':          'مِن:gen',
+        'مِن_نَاحِيَة':         'مِن:gen',
+        'مِن_وَرَاءَ':          'مِن_وَرَاءِ:gen', # min warāʾi = from behind
+        'مُنذُ':              'مُنذُ:gen', # munḏu = since
+        'مُنذُ_أَن':           'مُنذُ:gen',
+        'مُنذُ_نَحوَ':          'مُنذُ:gen', # since about N
+        'مُنذُ_وَ_فِي':         'مُنذُ:gen',
+        'مَهمَا':             'مَهمَا', # mahmā = regardless
+        'نَاهِيك_بِ':          'بِ:gen',
+        'نَتِيجَة_لِ':          'لِ:gen',
+        'نَحوَ':              'نَحوَ', # naḥwa = about, approximately
+        'نَحوَ_بِ':            'بِ:gen', # about by N
+        'هذا_بالأضافة':      'بِ:gen',
+        'وان':              'أَنَّ',
+        'وإن':              'إِنَّ',
         'وبشان':            'بِشَأنِ:gen',
+        'وَرَاءَ':             'وَرَاءَ:gen', # warāʾa = behind, past, beyond
+        'وَسطَ':              'وَسطَ:gen', # wasṭa = in the middle
+        'وِفقَ':              'وِفقَ:gen', # wifqa = according to
         'ولو':              'إِذَا', # walaw = even if
         'ولو_أَنَّ':           'إِذَا', # walaw = even if
         'virš':             'virš:gen' # above

From d065c552ed4d3f108465fddee3468e43b1d87f8e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 20:58:04 +0200
Subject: [PATCH 1035/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 75d4b3a2..000f70a2 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -483,6 +483,7 @@ class FixEdeprels(Block):
         'مِن_خَارِجَ':          'مِن_خَارِجِ:gen', # min ḫāriǧi = from outside
         'مِن_خِلَالَ':           'مِن_خِلَالِ:gen', # min ḫilāli = through, during
         'مِن_دَاخِلَ':          'مِن_دَاخِلِ:gen', # min dāḫili = from inside
+        'مِن_دُون':           'مِن_دُونِ:gen', # min dūni = without, beneath, underneath
         'مِن_دُونَ':           'مِن_دُونِ:gen', # min dūni = without, beneath, underneath
         'مِن_دُون_أَن':        'مِن_دُونِ:gen',
         'مِن_دُونَ_أَن':        'مِن_دُونِ:gen', # min dūni ʾan = without, beneath, underneath + clause

From f97dfa6bf6bba005844a4fa2b6969a0053fb6171 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 21:07:49 +0200
Subject: [PATCH 1036/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 000f70a2..eeba418c 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -345,7 +345,7 @@ class FixEdeprels(Block):
         'فِي_حِينَ':           'فِي_حِينِ', # fī ḥīni = while
         'فِي_حِين_أَنَّ':        'فِي_حِينِ',
         'فِي_خَارِجَ':          'خَارِجَ:gen', # ḫāriǧa = outside
-        'فِي_خِتَام':          'فِي_خِتَامِ', # fī ḫitāmi = in conclusion
+        'فِي_خِتَام':          'فِي_خِتَامِ:gen', # fī ḫitāmi = in conclusion
         'فِي_خِلَالَ':           'فِي:gen',
         'فِي_دَاخِل':          'دَاخِل:gen',
         'فِي_دَاخِلَ':          'فِي:gen',

From 5f7ed0380e5222d6a5413b03aa579fc6a554db5d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 21:14:25 +0200
Subject: [PATCH 1037/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index eeba418c..132aabe3 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -346,6 +346,7 @@ class FixEdeprels(Block):
         'فِي_حِين_أَنَّ':        'فِي_حِينِ',
         'فِي_خَارِجَ':          'خَارِجَ:gen', # ḫāriǧa = outside
         'فِي_خِتَام':          'فِي_خِتَامِ:gen', # fī ḫitāmi = in conclusion
+        'فِي_خِتَامِ':          'فِي_خِتَامِ:gen', # fī ḫitāmi = in conclusion
         'فِي_خِلَالَ':           'فِي:gen',
         'فِي_دَاخِل':          'دَاخِل:gen',
         'فِي_دَاخِلَ':          'فِي:gen',

From 0d5ec559ed7ac058d8c3a5a4f0c207be26a03bf2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 21:37:35 +0200
Subject: [PATCH 1038/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 132aabe3..177376bf 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -121,6 +121,7 @@ class FixEdeprels(Block):
         'بِ_دُون':            'دُونَ:gen',
         'بِ_دُونَ':            'دُونَ:gen', # bi dūni = without
         'بِ_دُونَ_أَن':         'دُونَ:gen', # bi dūni ʾan = without
+        'بِ_رِعَايَة':          'بِ:gen',
         'بِ_رَغم':            'رَغمَ:gen', # despite
         'بِ_رَغم_أَنَّ':         'رَغمَ:gen', # despite
         'بِ_رَغم_مِن':         'رَغمَ:gen', # despite
@@ -139,6 +140,7 @@ class FixEdeprels(Block):
         'بِ_عَكس':            'بِ:gen',
         'بِ_عَلَى':            'بِ:gen',
         'بِ_عَن':             'بِ:gen',
+        'بِ_عَين':            'بِ:gen',
         'بِ_غَضّ_نَظَر_عَن':      'بِغَضِّ_اَلنَّظَرِ_عَن:gen', # biġaḍḍi an-naẓari ʿan = regardless of
         'بِ_فَضل':            'بِفَضلِ:gen', # bifaḍli = thanks to
         'بِ_فِي':             'بِ:gen',
@@ -256,8 +258,8 @@ class FixEdeprels(Block):
         'عَقِبَ_مِن':           'عَقِبَ:gen', # ʿaqiba = following
         'عَلَى':              'عَلَى:gen', # ʿalā = on
         'عَلَى_أبواب':        'عَلَى:gen',
-        'عَلَى_أَثَر':          'عَلَى:gen',
         'عَلَى_إِثرَ':          'إِثرَ:gen', # ʿalā ʾiṯri = right after
+        'عَلَى_أَثَر':          'عَلَى:gen',
         'عَلَى_اِختِلَاف':        'عَلَى:gen',
         'عَلَى_أَسَاس':         'عَلَى_أَسَاسٍ:gen', # ʿalā ʾasāsin = based on
         'عَلَى_أَسَاس_أَنَّ':      'عَلَى_أَسَاسٍ:gen', # ʿalā ʾasāsin = based on
@@ -280,8 +282,8 @@ class FixEdeprels(Block):
         'عَلَى_حَولَ':          'عَلَى:gen',
         'عَلَى_رَأس':          'عَلَى_رَأسِ:gen', # ʿalā raʾsi = on top of
         'عَلَى_رَغم':          'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
-        'عَلَى_رَغم_أَنَّ':       'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
         'عَلَى_رَغمَ_أَنَّ':       'رَغمَ:gen', # ʿalā raġma ʾanna = despite + clause
+        'عَلَى_رَغم_أَنَّ':       'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
         'عَلَى_رَغم_مِن':       'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
         'عَلَى_رَغم_مِن_أَنَّ':    'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite
         'عَلَى_رَغم_مِن_أَنَّ_هُوَ': 'عَلَى_رَغمِ:gen', # ʿalā raġmi = despite

From 468b8e8d63948735d9863a9cae6cbd469b794bac Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 21:53:29 +0200
Subject: [PATCH 1039/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 177376bf..2a3aefec 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -490,6 +490,7 @@ class FixEdeprels(Block):
         'مِن_دُونَ':           'مِن_دُونِ:gen', # min dūni = without, beneath, underneath
         'مِن_دُون_أَن':        'مِن_دُونِ:gen',
         'مِن_دُونَ_أَن':        'مِن_دُونِ:gen', # min dūni ʾan = without, beneath, underneath + clause
+        'مِن_زَاوِيَة':         'مِن:gen',
         'مِن_شَأن':           'مِن_شَأنِ:gen', # min šaʾni = from matter
         'مِن_ضِمنَ':           'مِن_ضِمنِ:gen', # min ḍimni = from within = including
         'مِن_طَرَف':           'مِن:gen',

From f0f32fa5fff10a8c3ad6bcc9372a0a8a0ae3845e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 22:02:15 +0200
Subject: [PATCH 1040/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 2a3aefec..636988ef 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -223,6 +223,7 @@ class FixEdeprels(Block):
         'خَارِجَ':             'خَارِجَ:gen', # ḫāriǧa = outside
         'خِلَالَ':              'خِلَالَ:gen', # ḫilāla = during
         'خَلفَ':              'خَلفَ:gen', # ḫalfa = behind
+        'دَاخِل':             'دَاخِلَ:gen', # dāḫila = inside of
         'دَاخِلَ':             'دَاخِلَ:gen', # dāḫila = inside of
         'دُونَ':              'دُونَ:gen', # dūna = without
         'دُونَ_أَن':           'دُونَ:gen', # dūna ʾan = without

From 3a302f550ef6b121929f3e7a926ce9924133e1b6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Jun 2024 22:13:55 +0200
Subject: [PATCH 1041/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 636988ef..ad093e1c 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -326,6 +326,7 @@ class FixEdeprels(Block):
         'فِي_اِتِّجَاه':         'بِاِتِّجَاهِ:gen', # bi-ittiǧāhi = towards
         'فِي_أَثنَاءَ':         'أَثنَاءَ:gen', # ʾaṯnāʾa = during
         'فِي_إِطَار':          'فِي_إِطَار:gen', # fī ʾiṭār = in frame
+        'فِي_اعقاب':         'فِي_أَعقَابِ:gen',
         'فِي_إِلَى':           'فِي:gen',
         'فِي_أَن':            'فِي:gen',
         'فِي_أَنَّ':            'فِي:gen',
@@ -526,8 +527,7 @@ class FixEdeprels(Block):
         'وَسطَ':              'وَسطَ:gen', # wasṭa = in the middle
         'وِفقَ':              'وِفقَ:gen', # wifqa = according to
         'ولو':              'إِذَا', # walaw = even if
-        'ولو_أَنَّ':           'إِذَا', # walaw = even if
-        'virš':             'virš:gen' # above
+        'ولو_أَنَّ':           'إِذَا' # walaw = even if
     }
 
     def copy_case_from_adposition(self, node, adposition):

From c29773c47602b4d49a392833a9c29cad9fe2f747 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 20 Jun 2024 18:41:07 +0200
Subject: [PATCH 1042/1374] Add PunctType and PunctSide features like in
 AnCora.

---
 udapi/block/ud/addpuncttype.py | 91 ++++++++++++++++++++++++++++++++++
 1 file changed, 91 insertions(+)
 create mode 100644 udapi/block/ud/addpuncttype.py

diff --git a/udapi/block/ud/addpuncttype.py b/udapi/block/ud/addpuncttype.py
new file mode 100644
index 00000000..f5f20e06
--- /dev/null
+++ b/udapi/block/ud/addpuncttype.py
@@ -0,0 +1,91 @@
+"""
+Some UD treebanks use features PunctType and PunctSide that classify
+punctuation symbols. This block can be used to add such features to data where
+they are missing – the classification is mostly deterministic. If the input
+data already contains such features, their values will be overwritten.
+"""
+from udapi.core.block import Block
+
+# TODO We need to know the language, there are many other quotation styles,
+#      e.g. Finnish and Swedish uses the same symbol for opening and closing: ”X”.
+#      Danish uses uses the French quotes, but switched: »X«.
+
+PUNCT_TYPES = {
+    '(': 'Brck',
+    ')': 'Brck',
+    '[': 'Brck',
+    ']': 'Brck',
+    '{': 'Brck',
+    '}': 'Brck',
+    '.': 'Peri',
+    '...': 'Elip',
+    '…': 'Elip',
+    ',': 'Comm',
+    ';': 'Semi',
+    ':': 'Colo',
+    '!': 'Excl',
+    '¡': 'Excl', # Spanish initial exclamation mark
+    '?': 'Qest',
+    '¿': 'Qest', # Spanish initial question mark
+    '/': 'Colo', # it is used this way in AnCora
+    '-': 'Dash',
+    '–': 'Dash',
+    '—': 'Dash',
+    '"': 'Quot',
+    "'": 'Quot',
+    '`': 'Quot',
+    '“': 'Quot', # opening English, closing Czech
+    '”': 'Quot', # closing English
+    '„': 'Quot', # opening Czech
+    '‘': 'Quot', # opening English, closing Czech
+    '’': 'Quot', # closing English
+    '‚': 'Quot', # opening Czech
+    '«': 'Quot', # opening French, closing Danish
+    '»': 'Quot', # closing French, opening Danish
+    '‹': 'Quot',
+    '›': 'Quot',
+    '《': 'Quot', # Korean, Chinese
+    '》': 'Quot',
+    '「': 'Quot', # Chinese, Japanese
+    '」': 'Quot',
+    '『': 'Quot',
+    '』': 'Quot'
+}
+
+PUNCT_SIDES = {
+    '(': 'Ini',
+    ')': 'Fin',
+    '[': 'Ini',
+    ']': 'Fin',
+    '{': 'Ini',
+    '}': 'Fin',
+    '¡': 'Ini', # Spanish initial exclamation mark
+    '!': 'Fin', # but outside Spanish people may expect empty value
+    '¿': 'Ini', # Spanish initial question mark
+    '?': 'Fin',
+    '《': 'Ini', # Korean, Chinese
+    '》': 'Fin',
+    '「': 'Ini', # Chinese, Japanese
+    '」': 'Fin',
+    '『': 'Ini',
+    '』': 'Fin'
+}
+
+
+class AddPunctType(Block):
+    """Add features PunctType and PunctSide where applicable."""
+
+    def process_node(self, node):
+        # The two features apply only to PUNCT. If they already occur elsewhere, erase them.
+        if node.upos != 'PUNCT':
+            node.feats['PunctType'] = ''
+            node.feats['PunctSide'] = ''
+        else:
+            if node.form in PUNCT_TYPES:
+                node.feats['PunctType'] = PUNCT_TYPES[node.form]
+            else:
+                node.feats['PunctType'] = ''
+            if node.form in PUNCT_SIDES:
+                node.feats['PunctSide'] = PUNCT_SIDES[node.form]
+            else:
+                node.feats['PunctSide'] = ''

From 339b093de03a311f4f06ed4154cdf9e885cf3ced Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 22 Jun 2024 18:23:48 +0200
Subject: [PATCH 1043/1374] Allow loading CoNLL-U files with cross-sentence
 mentions in the non-strict mode.

Cross-sentence mentions are still not supported, but with
`corefud.Load strict=0` we can at least ignore (delete) such mentions
and thus possibly "fix" such files.
---
 udapi/core/coref.py | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 4cd656f1..422375cd 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -603,7 +603,15 @@ def load_coref_from_misc(doc, strict=True):
                 last_word = mention.words[-1]
                 if node.root is not last_word.root:
                     # TODO cross-sentence mentions
-                    raise ValueError(f"Cross-sentence mentions not supported yet: {chunk} at {node}")
+                    if strict:
+                        raise ValueError(f"Cross-sentence mentions not supported yet: {chunk} at {node}")
+                    else:
+                        logging.warning(f"Cross-sentence mentions not supported yet: {chunk} at {node}. Deleting.")
+                        entity = mention.entity
+                        mention.words = []
+                        entity._mentions.remove(mention)
+                        if not entity._mentions:
+                            del entities[entity.eid]
                 for w in node.root.descendants_and_empty:
                     if last_word.precedes(w):
                         mention._words.append(w)
@@ -720,14 +728,14 @@ def load_coref_from_misc(doc, strict=True):
                     entities[ante_str] = CorefEntity(ante_str)
                 entities[this_str].split_ante.append(entities[ante_str])
 
-    for entity_name, mentions in unfinished_mentions.items():
-        for mention in mentions:
-            logging.warning(f"Mention {entity_name} opened at {mention.head}, but not closed. Deleting.")
+    for eid, mentions in unfinished_mentions.items():
+        for mention, head_idx in mentions:
+            logging.warning(f"Mention {eid} opened at {mention.head}, but not closed. Deleting.")
             entity = mention.entity
             mention.words = []
             entity._mentions.remove(mention)
             if not entity._mentions:
-                del entities[name]
+                del entities[eid]
 
     # c=doc.coref_entities should be sorted, so that c[0] < c[1] etc.
     # In other words, the dict should be sorted by the values (according to CorefEntity.__lt__),

From 192fb6ec86ffaddcb5aabf78afdea9d91b1aec27 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 22 Jun 2024 18:25:51 +0200
Subject: [PATCH 1044/1374] read.Conll2012 now supports also Portuguese
 Summ-it++ and Corref-PT versions of the format, when using
 `attributes=ord,form,_,_,_,_,_,_,coref` and
 `attributes=ord,form,_,_,_,_,coref`, respectively.

---
 udapi/block/read/conll2012.py | 47 +++++++++++++++++++++++++++++------
 1 file changed, 40 insertions(+), 7 deletions(-)

diff --git a/udapi/block/read/conll2012.py b/udapi/block/read/conll2012.py
index a60f52ca..f4b73dc8 100644
--- a/udapi/block/read/conll2012.py
+++ b/udapi/block/read/conll2012.py
@@ -1,6 +1,7 @@
 """"Conll2012 is a reader block for the coreference in CoNLL-2012 format.
 
-This implementation was tested on the LitBank files only, so far.
+This implementation was tested on the LitBank files only
+(and quickly on Portuguese Corref-PT and Summ-it++v2), so far.
 LitBank does not use most of the columns, so the implementation
 should be improved to handle other types of CoNLL-2012 files.
 """
@@ -12,8 +13,7 @@
 from udapi.core.root import Root
 from udapi.core.node import Node
 
-#RE_BEGIN = re.compile(r'^#begin document \(([^)]+)\); part (\d+)')
-RE_BEGIN = re.compile(r'^#begin document \(([^)]+)\)')
+RE_BEGIN = re.compile(r'^#begin document ([^ ]+)')
 
 class Conll2012(udapi.block.read.conllu.Conllu):
     """A reader of the Conll2012 files."""
@@ -23,10 +23,12 @@ def __init__(self, attributes='docname,_,ord,form,_,_,_,_,_,_,_,_,coref', **kwar
 
         Args:
         attributes: comma-separated list of column names in the input files
-            (default='docname,_,ord,form,_,_,_,_,_,_,_,_,coref')
+            (default='docname,_,ord,form,_,_,_,_,_,_,_,_,coref' suitable for LitBank)
             For ignoring a column, use "_" as its name.
             Column "ord" marks the column with 0-based (unlike in CoNLL-U, which uses 1-based)
             word-order number/index (usualy called ID).
+            For Corref-PT-SemEval, use attributes='ord,form,_,_,_,_,coref'.
+            For Summ-it++v2, use attributes='ord,form,_,_,_,_,_,_,coref'.
         """
         super().__init__(**kwargs)
         self.node_attributes = attributes.split(',')
@@ -38,6 +40,18 @@ def parse_comment_line(self, line, root):
         match = RE_BEGIN.match(line)
         if match:
             docname = match.group(1)
+            # LitBank uses e.g.
+            # #begin document (1023_bleak_house_brat); part 0
+            if docname.startswith('(') and docname.endswith(');'):
+                docname = docname[1:-2]
+            # Summ-it++v2 uses e.g.
+            # #begin document /home/andre/Recursos-fontes/Summit/Summ-it_v3.0/corpusAnotado_CCR/CIENCIA_2002_22010/CIENCIA_2002_22010.txt
+            elif docname.startswith('/home/'):
+                docname = docname.split('/')[-1]
+            # Corref-PT-SemEval uses e.g.
+            # #begin document D1_C30_Folha_07-08-2007_09h19.txt.xml
+            docname = docname.replace('.txt', '').replace('.xml', '')
+
             root.newdoc = docname
             self._global_entity = 'eid-etype-head-other'
             root.comment += '$GLOBAL.ENTITY\n'
@@ -62,15 +76,23 @@ def parse_node_line(self, line, root, nodes):
                     logging.warning(f"Document name mismatch {value} != {self._docname}")
 
             # convert the zero-based index to one-based
+            # but Corref-PT uses a mix of one-based and zero-based
             elif attribute_name == 'ord':
-                setattr(node, 'ord', int(value) + 1)
+                #setattr(node, 'ord', int(value) + 1)
+                if node.ord not in(int(value) + 1, int(value)):
+                    logging.warning(f"Mismatch: expected {node.ord=}, but found {int(value) + 1} {line=}")
 
             elif attribute_name == 'coref':
                 if value and value != '_':
-                    entities = value.split("|")
+                    # LitBank always separates chunks by a vertical bar, e.g. (13)|10)
+                    # Summ-it++v2 does not, e.g. (13)10)
+                    if '|' in value:
+                        chunks = value.split("|")
+                    else:
+                        chunks = [x for x in re.split(r'(\([^()]+\)?|[^()]+\))', value) if x]
                     modified_entities = []
                     escaped_docname = self._docname.replace("-", "")
-                    for entity in entities:
+                    for entity in chunks:
                         entity_num = entity.replace("(", "").replace(")","")
                         modified_entity = f"{escaped_docname}_e{entity_num}--1"
                         if entity.startswith("(") and entity.endswith(")"):
@@ -108,3 +130,14 @@ def read_tree_from_lines(self, lines):
             return None
 
         return root
+
+    def read_trees(self):
+        if self.max_docs:
+            raise NotImplementedError("TODO implement max_docs in read.Conll2012")
+        # Corref-PT does not put an empty line before #end document,
+        # so we need to split both on #end document and empty lines.
+        return [self.read_tree_from_lines(s.split('\n')) for s in
+                re.split(r'\n\n+|\n#end document\n', self.filehandle.read()) if s]
+
+    def read_tree(self):
+        raise NotImplementedError("TODO implement read_tree in read.Conll2012")

From dd14d93c2a47e683565d18ca5e7b1251010cd53f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 27 Jun 2024 19:17:38 +0200
Subject: [PATCH 1045/1374] ud.SplitUnderscoreTokens lemma=form

If lemmas were predicted e.g. by UDPipe, they won't be reliable
for such underscore_tokens, so it is better to use form as the lemma.
---
 udapi/block/ud/splitunderscoretokens.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/splitunderscoretokens.py b/udapi/block/ud/splitunderscoretokens.py
index 094f181a..44575e0c 100644
--- a/udapi/block/ud/splitunderscoretokens.py
+++ b/udapi/block/ud/splitunderscoretokens.py
@@ -23,7 +23,7 @@ class SplitUnderscoreTokens(Block):
     Real-world use cases: UD_Irish (`default_deprel=fixed`) and UD_Czech-CLTT v1.4.
     """
 
-    def __init__(self, deprel=None, default_deprel='flat', **kwargs):
+    def __init__(self, deprel=None, default_deprel='flat', lemma='split', **kwargs):
         """Create the SplitUnderscoreTokens block instance.
 
         Args:
@@ -31,14 +31,21 @@ def __init__(self, deprel=None, default_deprel='flat', **kwargs):
             Most common values are: flat, fixed, compound. Default=None.
         default_deprel: Which deprel to use for the newly created nodes if the heuristics
             in `deprel_for()` method fail. Default=flat.
+        lemma: What to do with the lemmas?
+            - 'split' (the default) means to split them on underscores as well
+              (and warn in case of a different number of underscores than in the form).
+            - 'form' means to copy the forms to the lemmas
         """
         super().__init__(**kwargs)
         self.deprel = deprel
         self.default_deprel = default_deprel
+        self.lemma = lemma
 
     def process_node(self, node):
         if node.form != '_' and '_' in node.form:
             forms = node.form.split('_')
+            if self.lemma == 'form':
+                node.lemma = node.form
             lemmas = node.lemma.split('_')
             if len(forms) != len(lemmas):
                 logging.warning("Different number of underscores in %s and %s, skipping.",

From b70c1108964ac3daf1b0d47c03ed15e49a2d0147 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 28 Aug 2024 16:33:10 +0200
Subject: [PATCH 1046/1374] ud.SetSpaceAfterFromText: make sure empty nodes
 have no 'SpaceAfter'

---
 udapi/block/ud/setspaceafterfromtext.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/udapi/block/ud/setspaceafterfromtext.py b/udapi/block/ud/setspaceafterfromtext.py
index c5321221..ec7ab658 100644
--- a/udapi/block/ud/setspaceafterfromtext.py
+++ b/udapi/block/ud/setspaceafterfromtext.py
@@ -14,6 +14,10 @@ class SetSpaceAfterFromText(Block):
     """Block for setting of the SpaceAfter=No MISC attribute according to the sentence text."""
 
     def process_tree(self, root):
+        # Empty nodes cannot have 'SpaceAfter=No', so make sure the file is valid.
+        for empty_node in root.empty_nodes:
+            del empty_node.misc['SpaceAfter']
+
         text = root.text
         if text is None:
             raise ValueError('Tree %s has no text, cannot use ud.SetSpaceAfterFromText' % root)

From 020fa91f4ddc2cd8e59797c86b73bda8b62db71f Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 28 Aug 2024 16:33:57 +0200
Subject: [PATCH 1047/1374] corefud.Load strict=0 is even less strict

---
 udapi/core/coref.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 422375cd..c2ebef2a 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -623,7 +623,9 @@ def load_coref_from_misc(doc, strict=True):
                         mention.head = mention.words[head_idx - 1]
                     except IndexError as err:
                         _error(f"Invalid head_idx={head_idx} for {mention.entity.eid} "
-                                f"closed at {node} with words={mention.words}", 1)
+                               f"closed at {node} with words={mention.words}", strict)
+                        if not strict and head_idx > len(mention.words):
+                            mention.head = mention.words[-1]
                 if subspan_idx and subspan_idx == total_subspans:
                     m = discontinuous_mentions[eid].pop()
                     if m is not mention:
@@ -643,7 +645,8 @@ def load_coref_from_misc(doc, strict=True):
                         try:
                             head_idx = int(value)
                         except ValueError as err:
-                            raise ValueError(f"Non-integer {value} as head index in {chunk} in {node}: {err}")
+                            _error(f"Non-integer {value} as head index in {chunk} in {node}: {err}", strict)
+                            head_idx = 1
                     elif name == 'other':
                         if other:
                             new_other = OtherDualDict(value)

From d901e442f4e96c13c8e55a5546bce5eac0c22610 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 1 Sep 2024 13:21:55 +0200
Subject: [PATCH 1048/1374] Polarity of nouns will be no longer (since 2.15)
 annotated in Czech UD.

---
 udapi/block/ud/cs/markfeatsbugs.py | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 7e1f8ffb..9c1a498e 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -30,7 +30,7 @@ def process_node(self, node):
             pass
         # NOUNS ################################################################
         elif node.upos == 'NOUN':
-            self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity'])
+            self.check_required_features(node, ['Gender', 'Number', 'Case'])
             if node.feats['VerbForm'] == 'Vnoun':
                 # verbal nouns: bytí, dělání, ...
                 self.check_allowed_features(node, {
@@ -38,7 +38,6 @@ def process_node(self, node):
                     'Gender': ['Neut'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'Polarity': ['Pos', 'Neg'],
                     'Foreign': ['Yes']
                 })
             elif node.feats['Gender'] == 'Masc':
@@ -48,18 +47,16 @@ def process_node(self, node):
                     'Animacy': ['Anim', 'Inan'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'Polarity': ['Pos', 'Neg'],
                     'Foreign': ['Yes']})
             else:
                 self.check_allowed_features(node, {
                     'Gender': ['Masc', 'Fem', 'Neut'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'Polarity': ['Pos', 'Neg'],
                     'Foreign': ['Yes']})
         # PROPER NOUNS #########################################################
         elif node.upos == 'PROPN':
-            self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity'])
+            self.check_required_features(node, ['Gender', 'Number', 'Case'])
             if node.feats['Gender'] == 'Masc':
                 self.check_required_features(node, ['Animacy'])
                 self.check_allowed_features(node, {
@@ -67,7 +64,6 @@ def process_node(self, node):
                     'Animacy': ['Anim', 'Inan'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'Polarity': ['Pos', 'Neg'],
                     'NameType': ['Giv', 'Sur', 'Geo'],
                     'Foreign': ['Yes']})
             else:
@@ -75,7 +71,6 @@ def process_node(self, node):
                     'Gender': ['Masc', 'Fem', 'Neut'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'Polarity': ['Pos', 'Neg'],
                     'NameType': ['Giv', 'Sur', 'Geo'],
                     'Foreign': ['Yes']})
         # ADJECTIVES ###########################################################

From 89449f8a79f0c47e05aa4cc3cb20d2cb25754000 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 1 Sep 2024 20:57:49 +0200
Subject: [PATCH 1049/1374] =?UTF-8?q?Rules=20for=20"mnoho",=20"m=C3=A1lo"?=
 =?UTF-8?q?=20etc.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 9c1a498e..908e4cad 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -391,6 +391,13 @@ def process_node(self, node):
             elif re.match(r'^(samý)$', node.lemma):
                 # Unlike other determiners, it allows Variant=Short: sám, sama, samu, samo, sami, samy.
                 self.check_adjective_like(node, ['PronType'], {'PronType': ['Emp'], 'Variant': ['Short']})
+            elif node.feats['NumType'] == 'Card': # pronominal quantifiers 'mnoho', 'málo', 'několik' etc.
+                self.check_required_features(node, ['PronType', 'NumType', 'Case'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Ind', 'Int', 'Rel', 'Dem'],
+                    'NumType': ['Card'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                })
             else:
                 self.check_adjective_like(node, ['PronType'], {'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot']})
         # NUMERALS #############################################################

From 8c50313f79beafe39d9bdb6cd15f3f6426746052 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 1 Sep 2024 21:44:32 +0200
Subject: [PATCH 1050/1374] =?UTF-8?q?"jeho=C5=BEe"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 908e4cad..6867d52d 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -336,7 +336,7 @@ def process_node(self, node):
         elif node.upos == 'DET':
             # Possessive determiners 'jeho' and 'jejich' (formerly 'jich') do not inflect, i.e., no Gender, Number, Case.
             # Note that the possessive determiner 'její' (formerly 'jejie') does inflect, although it also has the lemma 'jeho'.
-            if re.match(r'^(jeho|jejich|jich)(ž(to)?)?$', node.form.lower()):
+            if re.match(r'^(jeho|jejich|jich)(ž(e|to)?)?$', node.form.lower()):
                 self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]'])
                 self.check_allowed_features(node, {
                     'PronType': ['Prs', 'Rel'],
@@ -345,7 +345,7 @@ def process_node(self, node):
                     'Number[psor]': ['Sing', 'Dual', 'Plur'],
                     'Gender[psor]': ['Masc,Neut']
                 })
-            elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)(ž(to)?)?$', node.form.lower()):
+            elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)(ž(e|to)?)?$', node.form.lower()):
                 # The feminine possessive 'její' slightly inflects, unlike 'jeho' and 'jejich'.
                 # Congruent gender is annotated only in singular. Masculine and
                 # neuter are merged even in nominative. Feminine singular does

From 29cf11eb9af18d9c0fadeb692d37cd7882818fd1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 1 Sep 2024 22:01:48 +0200
Subject: [PATCH 1051/1374] "jeho" can have Case.

---
 udapi/block/ud/cs/markfeatsbugs.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 6867d52d..cd285380 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -343,7 +343,8 @@ def process_node(self, node):
                     'Poss': ['Yes'],
                     'Person': ['3'],
                     'Number[psor]': ['Sing', 'Dual', 'Plur'],
-                    'Gender[psor]': ['Masc,Neut']
+                    'Gender[psor]': ['Masc,Neut'],
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'] # uninflected in modern Czech, but old Czech annotations sometime indicate the case by context
                 })
             elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)(ž(e|to)?)?$', node.form.lower()):
                 # The feminine possessive 'její' slightly inflects, unlike 'jeho' and 'jejich'.

From 1a5f2fa8c8415e6df021d7fff076b255274a8f7a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 1 Sep 2024 22:06:10 +0200
Subject: [PATCH 1052/1374] More features for "jeho".

---
 udapi/block/ud/cs/markfeatsbugs.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index cd285380..56a36067 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -343,7 +343,9 @@ def process_node(self, node):
                     'Poss': ['Yes'],
                     'Person': ['3'],
                     'Number[psor]': ['Sing', 'Dual', 'Plur'],
-                    'Gender[psor]': ['Masc,Neut'],
+                    'Gender[psor]': ['Masc', 'Neut', 'Masc,Neut'],
+                    'Gender': ['Masc', 'Fem', 'Neut'], # uninflected in modern Czech, but old Czech annotations sometime indicate the modified gender by context
+                    'Number': ['Sing', 'Dual', 'Plur'], # uninflected in modern Czech, but old Czech annotations sometime indicate the modified number by context
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'] # uninflected in modern Czech, but old Czech annotations sometime indicate the case by context
                 })
             elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)(ž(e|to)?)?$', node.form.lower()):

From fde5d470676c8e4fc99133e74b09ae3742c5699d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 1 Sep 2024 22:22:07 +0200
Subject: [PATCH 1053/1374] "nejeden"

---
 udapi/block/ud/cs/markfeatsbugs.py | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 56a36067..48436a49 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -395,12 +395,15 @@ def process_node(self, node):
                 # Unlike other determiners, it allows Variant=Short: sám, sama, samu, samo, sami, samy.
                 self.check_adjective_like(node, ['PronType'], {'PronType': ['Emp'], 'Variant': ['Short']})
             elif node.feats['NumType'] == 'Card': # pronominal quantifiers 'mnoho', 'málo', 'několik' etc.
-                self.check_required_features(node, ['PronType', 'NumType', 'Case'])
-                self.check_allowed_features(node, {
-                    'PronType': ['Ind', 'Int', 'Rel', 'Dem'],
-                    'NumType': ['Card'],
-                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                })
+                if node.lemma eq 'nejeden':
+                    self.check_adjective_like(node, ['PronType', 'NumType'], {'PronType': ['Ind'], 'NumType': ['Card']}])
+                else:
+                    self.check_required_features(node, ['PronType', 'NumType', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Ind', 'Int', 'Rel', 'Dem'],
+                        'NumType': ['Card'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
             else:
                 self.check_adjective_like(node, ['PronType'], {'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot']})
         # NUMERALS #############################################################

From bbe9e05af46db173a47d46e27f7294b49eea4841 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 1 Sep 2024 22:23:28 +0200
Subject: [PATCH 1054/1374] Bug fix.

---
 udapi/block/ud/cs/markfeatsbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 48436a49..963b242f 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -396,7 +396,7 @@ def process_node(self, node):
                 self.check_adjective_like(node, ['PronType'], {'PronType': ['Emp'], 'Variant': ['Short']})
             elif node.feats['NumType'] == 'Card': # pronominal quantifiers 'mnoho', 'málo', 'několik' etc.
                 if node.lemma eq 'nejeden':
-                    self.check_adjective_like(node, ['PronType', 'NumType'], {'PronType': ['Ind'], 'NumType': ['Card']}])
+                    self.check_adjective_like(node, ['PronType', 'NumType'], {'PronType': ['Ind'], 'NumType': ['Card']})
                 else:
                     self.check_required_features(node, ['PronType', 'NumType', 'Case'])
                     self.check_allowed_features(node, {

From 4a9d07d1f738bb48633a28e7fb2039c7263602ca Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 1 Sep 2024 22:24:46 +0200
Subject: [PATCH 1055/1374] Bug fix.

---
 udapi/block/ud/cs/markfeatsbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 963b242f..72b4bdfd 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -395,7 +395,7 @@ def process_node(self, node):
                 # Unlike other determiners, it allows Variant=Short: sám, sama, samu, samo, sami, samy.
                 self.check_adjective_like(node, ['PronType'], {'PronType': ['Emp'], 'Variant': ['Short']})
             elif node.feats['NumType'] == 'Card': # pronominal quantifiers 'mnoho', 'málo', 'několik' etc.
-                if node.lemma eq 'nejeden':
+                if node.lemma == 'nejeden':
                     self.check_adjective_like(node, ['PronType', 'NumType'], {'PronType': ['Ind'], 'NumType': ['Card']})
                 else:
                     self.check_required_features(node, ['PronType', 'NumType', 'Case'])

From def2fd12533f1ddafb71e1b184807681f3dc9420 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 2 Sep 2024 15:46:20 +0200
Subject: [PATCH 1056/1374] Czech conditional "by" should not have Person and
 Number.

---
 udapi/block/ud/cs/markfeatsbugs.py | 27 +++++++++++++++++++--------
 1 file changed, 19 insertions(+), 8 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 72b4bdfd..aedae689 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -475,15 +475,26 @@ def process_node(self, node):
                 # imperatives (although passive imperatives are a combination
                 # of the active imperative and a passive participle). It is
                 # also not annotated at the conditional auxiliary 'bych', 'bys', 'by', 'bychom', 'byste'.
+                # Conditional "by" has no person and number (it is typically
+                # 3rd person but it could be other persons, too, as in "ty by
+                # ses bál").
                 if node.feats['Mood'] == 'Cnd':
-                    self.check_required_features(node, ['Mood', 'Person'])
-                    self.check_allowed_features(node, {
-                        'Aspect': ['Imp', 'Perf'],
-                        'VerbForm': ['Fin'],
-                        'Mood': ['Cnd'],
-                        'Person': ['1', '2', '3'],
-                        'Number': ['Sing', 'Dual', 'Plur'] # optional: it is not annotated in the third person
-                    })
+                    if node.form.lower() == 'by':
+                        self.check_required_features(node, ['Mood'])
+                        self.check_allowed_features(node, {
+                            'Aspect': ['Imp'],
+                            'VerbForm': ['Fin'],
+                            'Mood': ['Cnd']
+                        })
+                    else:
+                        self.check_required_features(node, ['Mood', 'Person', 'Number'])
+                        self.check_allowed_features(node, {
+                            'Aspect': ['Imp'],
+                            'VerbForm': ['Fin'],
+                            'Mood': ['Cnd'],
+                            'Person': ['1', '2'],
+                            'Number': ['Sing', 'Dual', 'Plur']
+                        })
                 elif node.feats['Mood'] == 'Imp':
                     self.check_required_features(node, ['Mood', 'Person', 'Number', 'Polarity'])
                     self.check_allowed_features(node, {

From 70c62cf2e37111384b4f6d834e7a18da2abdeb31 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 4 Sep 2024 21:35:33 +0200
Subject: [PATCH 1057/1374] New policy for annotation of Degree with Czech
 adjectives.

---
 udapi/block/ud/cs/markfeatsbugs.py | 34 ++++++++----------------------
 1 file changed, 9 insertions(+), 25 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index aedae689..305ba322 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -97,7 +97,7 @@ def process_node(self, node):
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                         'NameType': ['Giv', 'Sur'], # for possessive adjectives derived from personal names
                         'Foreign': ['Yes']})
-            elif node.feats['NumType'] == 'Ord': # ordinal numerals are a subtype of adjectives
+            elif node.feats['NumType'] == 'Ord' or node.feats['NumType'] == 'Mult': # ordinal numerals are a subtype of adjectives; same for some multiplicative numerals (dvojí, trojí)
                 if node.feats['Gender'] == 'Masc':
                     self.check_required_features(node, ['NumType', 'Gender', 'Animacy', 'Number', 'Case'])
                     self.check_allowed_features(node, {
@@ -117,7 +117,7 @@ def process_node(self, node):
                         'Foreign': ['Yes']})
             elif node.feats['VerbForm'] == 'Part': # participles (except l-participles) are a subtype of adjectives
                 self.check_required_features(node, ['VerbForm', 'Voice'])
-                if node.feats['Voice'] == 'Act': # active participles have tense, passives don't
+                if node.feats['Voice'] == 'Act': # active participles have tense, passives don't but they have degree
                     if node.feats['Gender'] == 'Masc':
                         self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Tense', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity'])
                         self.check_allowed_features(node, {
@@ -147,7 +147,7 @@ def process_node(self, node):
                             'Foreign': ['Yes']})
                 else:
                     if node.feats['Gender'] == 'Masc':
-                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity'])
+                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity', 'Degree'])
                         self.check_allowed_features(node, {
                             'VerbForm': ['Part'],
                             'Aspect': ['Imp', 'Perf'],
@@ -157,10 +157,11 @@ def process_node(self, node):
                             'Number': ['Sing', 'Dual', 'Plur'],
                             'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                             'Polarity': ['Pos', 'Neg'],
+                            'Degree': ['Pos', 'Cmp', 'Sup'],
                             'Variant': ['Short'],
                             'Foreign': ['Yes']})
                     else:
-                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Number', 'Case', 'Polarity'])
+                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Number', 'Case', 'Polarity', 'Degree'])
                         self.check_allowed_features(node, {
                             'VerbForm': ['Part'],
                             'Aspect': ['Imp', 'Perf'],
@@ -169,29 +170,10 @@ def process_node(self, node):
                             'Number': ['Sing', 'Dual', 'Plur'],
                             'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                             'Polarity': ['Pos', 'Neg'],
+                            'Degree': ['Pos', 'Cmp', 'Sup'],
                             'Variant': ['Short'],
                             'Foreign': ['Yes']})
-            elif node.feats['Variant'] == 'Short': # short (nominal) forms of adjectives have no degree
-                if node.feats['Gender'] == 'Masc':
-                    self.check_required_features(node, ['Gender', 'Animacy', 'Number', 'Case', 'Polarity', 'Variant'])
-                    self.check_allowed_features(node, {
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Animacy': ['Anim', 'Inan'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                        'Polarity': ['Pos', 'Neg'],
-                        'Variant': ['Short'],
-                        'Foreign': ['Yes']})
-                else:
-                    self.check_required_features(node, ['Gender', 'Number', 'Case', 'Polarity', 'Variant'])
-                    self.check_allowed_features(node, {
-                        'Gender': ['Masc', 'Fem', 'Neut'],
-                        'Number': ['Sing', 'Dual', 'Plur'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                        'Polarity': ['Pos', 'Neg'],
-                        'Variant': ['Short'],
-                        'Foreign': ['Yes']})
-            else: # regular adjectives
+            else: # regular adjectives, including short forms
                 if node.feats['Gender'] == 'Masc':
                     self.check_required_features(node, ['Gender', 'Animacy', 'Number', 'Case', 'Degree', 'Polarity'])
                     self.check_allowed_features(node, {
@@ -201,6 +183,7 @@ def process_node(self, node):
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                         'Degree': ['Pos', 'Cmp', 'Sup'],
                         'Polarity': ['Pos', 'Neg'],
+                        'Variant': ['Short'],
                         'Foreign': ['Yes']})
                 else:
                     self.check_required_features(node, ['Gender', 'Number', 'Case', 'Degree', 'Polarity'])
@@ -210,6 +193,7 @@ def process_node(self, node):
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                         'Degree': ['Pos', 'Cmp', 'Sup'],
                         'Polarity': ['Pos', 'Neg'],
+                        'Variant': ['Short'],
                         'Foreign': ['Yes']})
         # PRONOUNS #############################################################
         elif node.upos == 'PRON':

From f8abb95a9787b4d680ff6145104a092210056ba7 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 13:57:41 +0200
Subject: [PATCH 1058/1374] ud.cs.MarkFeatsBugs adapted more to Old Czech.

---
 udapi/block/ud/cs/markfeatsbugs.py | 105 ++++++++++++++++++++++++-----
 1 file changed, 89 insertions(+), 16 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 305ba322..b4fa4a26 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -215,10 +215,13 @@ def process_node(self, node):
                                 'Person': ['3']
                             })
                         elif node.feats['Variant'] == 'Short': # ho, mu
-                            # The short (clitic) forms do not have PrepCase.
+                            # The short (clitic) forms do not have PrepCase in Modern Czech
+                            # but Old Czech has also 'jmu' (besides 'jemu' and 'mu'), which
+                            # is also annotated as Variant=Short and PrepCase=Npr.
                             self.check_adjective_like(node, ['PronType', 'Person'], {
                                 'PronType': ['Prs'],
                                 'Person': ['3'],
+                                'PrepCase': ['Npr'],
                                 'Variant': ['Short']
                             })
                         else: # jeho, něho, jemu, němu, jej, něj, něm, jím, ním, jí, ní, ji, ni, je, ně
@@ -320,10 +323,10 @@ def process_node(self, node):
         elif node.upos == 'DET':
             # Possessive determiners 'jeho' and 'jejich' (formerly 'jich') do not inflect, i.e., no Gender, Number, Case.
             # Note that the possessive determiner 'její' (formerly 'jejie') does inflect, although it also has the lemma 'jeho'.
-            if re.match(r'^(jeho|jejich|jich)(ž(e|to)?)?$', node.form.lower()):
+            if re.match(r'^(jeho|jejich|jich)$', node.form.lower()):
                 self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]'])
                 self.check_allowed_features(node, {
-                    'PronType': ['Prs', 'Rel'],
+                    'PronType': ['Prs'],
                     'Poss': ['Yes'],
                     'Person': ['3'],
                     'Number[psor]': ['Sing', 'Dual', 'Plur'],
@@ -332,7 +335,21 @@ def process_node(self, node):
                     'Number': ['Sing', 'Dual', 'Plur'], # uninflected in modern Czech, but old Czech annotations sometime indicate the modified number by context
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'] # uninflected in modern Czech, but old Czech annotations sometime indicate the case by context
                 })
-            elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)(ž(e|to)?)?$', node.form.lower()):
+            # Relative possessive determiners 'jehož' and 'jejichž' behave similarly
+            # to the personal possessive determiners but they do not have Person.
+            elif re.match(r'^(jeho|jejich|jich)(ž(e|to)?)$', node.form.lower()):
+                self.check_required_features(node, ['PronType', 'Poss', 'Number[psor]'])
+                self.check_allowed_features(node, {
+                    'PronType': ['Rel'],
+                    'Poss': ['Yes'],
+                    'Number[psor]': ['Sing', 'Dual', 'Plur'],
+                    'Gender[psor]': ['Masc', 'Neut', 'Masc,Neut'],
+                    'Gender': ['Masc', 'Fem', 'Neut'], # uninflected in modern Czech, but old Czech annotations sometime indicate the modified gender by context
+                    'Number': ['Sing', 'Dual', 'Plur'], # uninflected in modern Czech, but old Czech annotations sometime indicate the modified number by context
+                    'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'] # uninflected in modern Czech, but old Czech annotations sometime indicate the case by context
+                })
+            # Feminine personal possessive determiner.
+            elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)$', node.form.lower()):
                 # The feminine possessive 'její' slightly inflects, unlike 'jeho' and 'jejich'.
                 # Congruent gender is annotated only in singular. Masculine and
                 # neuter are merged even in nominative. Feminine singular does
@@ -341,7 +358,7 @@ def process_node(self, node):
                 if node.feats['Number'] == 'Sing':
                     self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]', 'Gender', 'Number', 'Case'])
                     self.check_allowed_features(node, {
-                        'PronType': ['Prs', 'Rel'],
+                        'PronType': ['Prs'],
                         'Poss': ['Yes'],
                         'Person': ['3'],
                         'Number[psor]': ['Sing'],
@@ -353,7 +370,7 @@ def process_node(self, node):
                 else:
                     self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]', 'Number', 'Case'])
                     self.check_allowed_features(node, {
-                        'PronType': ['Prs', 'Rel'],
+                        'PronType': ['Prs'],
                         'Poss': ['Yes'],
                         'Person': ['3'],
                         'Number[psor]': ['Sing'],
@@ -361,6 +378,34 @@ def process_node(self, node):
                         'Number': ['Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
+            # Feminine relative possessive determiner.
+            elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)(ž(e|to)?)$', node.form.lower()):
+                # The feminine possessive 'jejíž' slightly inflects, unlike 'jehož' and 'jejichž'.
+                # Congruent gender is annotated only in singular. Masculine and
+                # neuter are merged even in nominative. Feminine singular does
+                # not distinguish case in PDT but we need it in Old Czech at
+                # least for 'jejiej'.
+                if node.feats['Number'] == 'Sing':
+                    self.check_required_features(node, ['PronType', 'Poss', 'Number[psor]', 'Gender[psor]', 'Gender', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Rel'],
+                        'Poss': ['Yes'],
+                        'Number[psor]': ['Sing'],
+                        'Gender[psor]': ['Fem'],
+                        'Gender': ['Masc,Neut', 'Fem'],
+                        'Number': ['Sing'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
+                else:
+                    self.check_required_features(node, ['PronType', 'Poss', 'Number[psor]', 'Gender[psor]', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Rel'],
+                        'Poss': ['Yes'],
+                        'Number[psor]': ['Sing'],
+                        'Gender[psor]': ['Fem'],
+                        'Number': ['Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
             elif node.feats['Poss'] == 'Yes': # 'můj', 'tvůj', 'svůj'
                 if node.feats['Reflex'] == 'Yes':
                     self.check_adjective_like(node, ['PronType', 'Poss', 'Reflex'], {
@@ -527,16 +572,44 @@ def process_node(self, node):
                         'Polarity': ['Pos', 'Neg']
                     })
             else: # converb
-                self.check_required_features(node, ['Tense', 'Number', 'Voice', 'Polarity'])
-                self.check_allowed_features(node, {
-                    'Aspect': ['Imp', 'Perf'],
-                    'VerbForm': ['Conv'],
-                    'Tense': ['Past', 'Pres'],
-                    'Voice': ['Act'],
-                    'Number': ['Sing', 'Dual', 'Plur'],
-                    'Gender': ['Masc', 'Fem', 'Neut'], # annotated only in singular, and no animacy
-                    'Polarity': ['Pos', 'Neg']
-                })
+                # Old Czech data annotate converb gender by context rather than form
+                # (because the form was different than in Modern Czech) and for
+                # masculines they also include animacy. In Modern Czech animacy is
+                # currently not annotated and Masc,Neut gender is merged.
+                if node.feats['Number'] == 'Sing':
+                    if node.feats['Gender'] == 'Masc':
+                        self.check_required_features(node, ['Tense', 'Gender', 'Animacy', 'Number', 'Voice', 'Polarity'])
+                        self.check_allowed_features(node, {
+                            'Aspect': ['Imp', 'Perf'],
+                            'VerbForm': ['Conv'],
+                            'Tense': ['Past', 'Pres'],
+                            'Voice': ['Act'], # passive participle is ADJ, so we will not encounter it under VERB
+                            'Number': ['Sing'],
+                            'Gender': ['Masc'],
+                            'Animacy': ['Anim', 'Inan'],
+                            'Polarity': ['Pos', 'Neg']
+                        })
+                    else:
+                        self.check_required_features(node, ['Tense', 'Gender', 'Number', 'Voice', 'Polarity'])
+                        self.check_allowed_features(node, {
+                            'Aspect': ['Imp', 'Perf'],
+                            'VerbForm': ['Conv'],
+                            'Tense': ['Past', 'Pres'],
+                            'Voice': ['Act'], # passive participle is ADJ, so we will not encounter it under VERB
+                            'Number': ['Sing'],
+                            'Gender': ['Fem', 'Neut'],
+                            'Polarity': ['Pos', 'Neg']
+                        })
+                else:
+                    self.check_required_features(node, ['Tense', 'Number', 'Voice', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Aspect': ['Imp', 'Perf'],
+                        'VerbForm': ['Conv'],
+                        'Tense': ['Past', 'Pres'],
+                        'Voice': ['Act'],
+                        'Number': ['Dual', 'Plur'],
+                        'Polarity': ['Pos', 'Neg']
+                    })
         # ADVERBS ##############################################################
         elif node.upos == 'ADV':
             if node.feats['PronType'] != '':

From 0c2db07cdfaa9fda7bc2578256cca4007f36b081 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 14:49:22 +0200
Subject: [PATCH 1059/1374] Disambiguating Int from Rel.

---
 udapi/block/ud/cs/markfeatsbugs.py | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index b4fa4a26..643c4f90 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -250,9 +250,11 @@ def process_node(self, node):
                 # There is no Number. Někdo and nikdo behave like singular;
                 # kdo is by default singular as well but it also occurs as a subject
                 # of plural verbs.
+                # Old Czech data disambiguate Int from Rel (Int is used only in direct questions with; indirect questions like "Ptal ses, kdo to je?" use Rel.)
+                # New Czech data, in particular PDT, use Int,Rel regardless of context.
                 self.check_required_features(node, ['PronType', 'Gender', 'Animacy', 'Case'])
                 self.check_allowed_features(node, {
-                    'PronType': ['Int,Rel', 'Rel', 'Ind', 'Neg'],
+                    'PronType': ['Int,Rel', 'Int', 'Rel', 'Ind', 'Neg'],
                     'Gender': ['Masc'],
                     'Animacy': ['Anim'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Loc', 'Ins']
@@ -266,9 +268,11 @@ def process_node(self, node):
                 ###!!! animacy. For now, let's at least make animacy an optional
                 ###!!! feature (I see that we already do not fill it in the Old
                 ###!!! Czech data).
+                # Old Czech data disambiguate Int from Rel (Int is used only in direct questions with; indirect questions like "Ptal ses, co to je?" use Rel.)
+                # New Czech data, in particular PDT, use Int,Rel regardless of context.
                 self.check_required_features(node, ['PronType', 'Case'])
                 self.check_allowed_features(node, {
-                    'PronType': ['Int,Rel', 'Rel', 'Ind', 'Neg'],
+                    'PronType': ['Int,Rel', 'Int', 'Rel', 'Ind', 'Neg'],
                     'Animacy': ['Inan'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Loc', 'Ins']
                 })
@@ -434,7 +438,9 @@ def process_node(self, node):
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
             else:
-                self.check_adjective_like(node, ['PronType'], {'PronType': ['Dem', 'Int,Rel', 'Rel', 'Ind', 'Neg', 'Tot']})
+                # Old Czech data disambiguate Int from Rel (Int is used only in direct questions with; indirect questions like "Ptal ses, kde to je?" use Rel.)
+                # New Czech data, in particular PDT, use Int,Rel regardless of context.
+                self.check_adjective_like(node, ['PronType'], {'PronType': ['Dem', 'Int,Rel', 'Int', 'Rel', 'Ind', 'Neg', 'Tot']})
         # NUMERALS #############################################################
         elif node.upos == 'NUM':
             self.check_required_features(node, ['NumType', 'NumForm'])
@@ -614,8 +620,10 @@ def process_node(self, node):
         elif node.upos == 'ADV':
             if node.feats['PronType'] != '':
                 # Pronominal adverbs are neither compared nor negated.
+                # Old Czech data disambiguate Int from Rel (Int is used only in direct questions with; indirect questions like "Ptal ses, kde to je?" use Rel.)
+                # New Czech data, in particular PDT, use Int,Rel regardless of context.
                 self.check_allowed_features(node, {
-                    'PronType': ['Dem', 'Int,Rel', 'Ind', 'Neg', 'Tot']
+                    'PronType': ['Dem', 'Int', 'Rel', 'Int,Rel', 'Ind', 'Neg', 'Tot']
                 })
             elif node.feats['Degree'] != '':
                 # Adverbs that are compared can also be negated.

From 9ee667c15977db6bb09f9f287cac9eb3970a98c7 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 14:56:02 +0200
Subject: [PATCH 1060/1374] Bug fix: Adjectival multiplicative numerals.

---
 udapi/block/ud/cs/markfeatsbugs.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 643c4f90..edb24f1b 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -101,7 +101,7 @@ def process_node(self, node):
                 if node.feats['Gender'] == 'Masc':
                     self.check_required_features(node, ['NumType', 'Gender', 'Animacy', 'Number', 'Case'])
                     self.check_allowed_features(node, {
-                        'NumType': ['Ord'],
+                        'NumType': ['Ord', 'Mult'],
                         'Gender': ['Masc', 'Fem', 'Neut'],
                         'Animacy': ['Anim', 'Inan'],
                         'Number': ['Sing', 'Dual', 'Plur'],
@@ -110,7 +110,7 @@ def process_node(self, node):
                 else:
                     self.check_required_features(node, ['NumType', 'Gender', 'Number', 'Case'])
                     self.check_allowed_features(node, {
-                        'NumType': ['Ord'],
+                        'NumType': ['Ord', 'Mult'],
                         'Gender': ['Masc', 'Fem', 'Neut'],
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],

From d24a0c47d278f92573e26e3f826a5c64eacb0bcb Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 15:13:00 +0200
Subject: [PATCH 1061/1374] Czech adverbial multiplicative numerals.

---
 udapi/block/ud/cs/markfeatsbugs.py | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index edb24f1b..cfdd751f 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -618,7 +618,17 @@ def process_node(self, node):
                     })
         # ADVERBS ##############################################################
         elif node.upos == 'ADV':
-            if node.feats['PronType'] != '':
+            if node.feats['NumType'] != '':
+                # Adverbial multiplicative numerals (jednou, dvakrát, třikrát)
+                # belong here. They have also pronominal counterparts (kolikrát,
+                # tolikrát, několikrát).
+                # Old Czech data disambiguate Int from Rel (Int is used only in direct questions with; indirect questions like "Ptal ses, kde to je?" use Rel.)
+                # New Czech data, in particular PDT, use Int,Rel regardless of context.
+                self.check_allowed_features(node, {
+                    'NumType': ['Mult'],
+                    'PronType': ['Dem', 'Int', 'Rel', 'Int,Rel', 'Ind']
+                })
+            elif node.feats['PronType'] != '':
                 # Pronominal adverbs are neither compared nor negated.
                 # Old Czech data disambiguate Int from Rel (Int is used only in direct questions with; indirect questions like "Ptal ses, kde to je?" use Rel.)
                 # New Czech data, in particular PDT, use Int,Rel regardless of context.

From b9a7be80ae54cb6311d3a87a2277c6b286cbf173 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 15:17:21 +0200
Subject: [PATCH 1062/1374] Czech adverbial ordinal numerals.

---
 udapi/block/ud/cs/markfeatsbugs.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index cfdd751f..909a350d 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -621,11 +621,12 @@ def process_node(self, node):
             if node.feats['NumType'] != '':
                 # Adverbial multiplicative numerals (jednou, dvakrát, třikrát)
                 # belong here. They have also pronominal counterparts (kolikrát,
-                # tolikrát, několikrát).
+                # tolikrát, několikrát). There are also adverbial ordinal numerals
+                # (zaprvé, poprvé, zadruhé, podruhé).
                 # Old Czech data disambiguate Int from Rel (Int is used only in direct questions with; indirect questions like "Ptal ses, kde to je?" use Rel.)
                 # New Czech data, in particular PDT, use Int,Rel regardless of context.
                 self.check_allowed_features(node, {
-                    'NumType': ['Mult'],
+                    'NumType': ['Mult', 'Ord'],
                     'PronType': ['Dem', 'Int', 'Rel', 'Int,Rel', 'Ind']
                 })
             elif node.feats['PronType'] != '':

From 5b3b0ecb0c23ca3eb9cbcf48a5593de397338f88 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 16:27:18 +0200
Subject: [PATCH 1063/1374] If we allow masculine gender, we must also allow
 animacy.

---
 udapi/block/ud/cs/markfeatsbugs.py | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 909a350d..46f737b3 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -336,12 +336,16 @@ def process_node(self, node):
                     'Number[psor]': ['Sing', 'Dual', 'Plur'],
                     'Gender[psor]': ['Masc', 'Neut', 'Masc,Neut'],
                     'Gender': ['Masc', 'Fem', 'Neut'], # uninflected in modern Czech, but old Czech annotations sometime indicate the modified gender by context
+                    'Animacy': ['Anim', 'Inan'], # uninflected in modern Czech, but old Czech annotations sometime indicate the modified gender by context
                     'Number': ['Sing', 'Dual', 'Plur'], # uninflected in modern Czech, but old Czech annotations sometime indicate the modified number by context
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'] # uninflected in modern Czech, but old Czech annotations sometime indicate the case by context
+                    # PrepCase is not allowed when it is a possessive determiner because no n-form can be used (jeho dům VS. na jeho dům).
+                    # Compare with genitive/accusative of the pronoun "on", there the form changes after preposition and PrepCase must be annotated
+                    # (jeho se bojím VS. bez něho se neobejdu).
                 })
             # Relative possessive determiners 'jehož' and 'jejichž' behave similarly
             # to the personal possessive determiners but they do not have Person.
-            elif re.match(r'^(jeho|jejich|jich)(ž(e|to)?)$', node.form.lower()):
+            elif re.match(r'^(jeho|jejich|jich)ž(e|to)?$', node.form.lower()):
                 self.check_required_features(node, ['PronType', 'Poss', 'Number[psor]'])
                 self.check_allowed_features(node, {
                     'PronType': ['Rel'],
@@ -349,8 +353,12 @@ def process_node(self, node):
                     'Number[psor]': ['Sing', 'Dual', 'Plur'],
                     'Gender[psor]': ['Masc', 'Neut', 'Masc,Neut'],
                     'Gender': ['Masc', 'Fem', 'Neut'], # uninflected in modern Czech, but old Czech annotations sometime indicate the modified gender by context
+                    'Animacy': ['Anim', 'Inan'], # uninflected in modern Czech, but old Czech annotations sometime indicate the modified gender by context
                     'Number': ['Sing', 'Dual', 'Plur'], # uninflected in modern Czech, but old Czech annotations sometime indicate the modified number by context
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'] # uninflected in modern Czech, but old Czech annotations sometime indicate the case by context
+                    # PrepCase is not allowed when it is a possessive determiner (muž, jehož manželka zahynula při nehodě) because no n-form can be used
+                    # (after preposition: muž, na jehož manželku jste si stěžoval). Compare with genitive/accusative of the relative pronoun "jenž",
+                    # there the form changes after preposition and PrepCase must be annotated (muž, jehož se bojím VS. muž, bez něhož se neobejdeme).
                 })
             # Feminine personal possessive determiner.
             elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)$', node.form.lower()):

From 833adb77507393a32b52457660065cda3cf5862c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 16:32:07 +0200
Subject: [PATCH 1064/1374] "oba" needs PronType=Tot.

---
 udapi/block/ud/cs/markfeatsbugs.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 46f737b3..f9234c4a 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -478,6 +478,7 @@ def process_node(self, node):
                     if self.pdt20:
                         self.check_allowed_features(node, {
                             'NumType': ['Card'],
+                            'PronType': ['Tot'], # for 'oba'
                             'NumForm': ['Word'],
                             'Gender': ['Masc', 'Masc,Neut', 'Fem', 'Fem,Neut', 'Neut'], # similarly to determiners, genders are merged in some slots of the paradigm
                             'Number': ['Dual', 'Plur'],
@@ -486,6 +487,7 @@ def process_node(self, node):
                     else:
                         self.check_allowed_features(node, {
                             'NumType': ['Card'],
+                            'PronType': ['Tot'], # for 'oba'
                             'NumForm': ['Word'],
                             'Gender': ['Masc', 'Fem', 'Neut'],
                             'Animacy': ['Anim', 'Inan'],

From f2ce8843d3ca90d5f2fdcd49e78ed1f7a49ca08f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 16:37:40 +0200
Subject: [PATCH 1065/1374] Czech negative pronoun "nic".

---
 udapi/block/ud/cs/markfeatsbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index f9234c4a..655df5a4 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -259,7 +259,7 @@ def process_node(self, node):
                     'Animacy': ['Anim'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Loc', 'Ins']
                 })
-            elif re.match(r'^(co|což|něco|nicož)$', node.lemma):
+            elif re.match(r'^(co|což|něco|nic|nicož)$', node.lemma):
                 # Although these pronouns behave by default as neuter singular,
                 # no Gender and Number is annotated. However, quite unusually,
                 # there is Animacy=Inan without Gender.

From 47d02f6688392e78fc6d75bf432686191cb27b70 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 16:59:04 +0200
Subject: [PATCH 1066/1374] =?UTF-8?q?Numerals=20p=C4=9Bt,=20deset,=20pades?=
 =?UTF-8?q?=C3=A1t...=20have=20Number=3DSing=20in=20PDT=20(!)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 655df5a4..85234cfb 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -495,11 +495,16 @@ def process_node(self, node):
                             'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                         })
                 else:
+                    # In PDT, cardinal numerals higher than four in nominative/accusative/vocative
+                    # have Number=Sing instead of Plur! It may be motivated by the default
+                    # agreement they trigger on verbs (but they don't have Gender=Neut).
+                    # It does not make much sense but we must allow Sing before a better
+                    # approach is defined and implemented in the data.
                     self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
                     self.check_allowed_features(node, {
                         'NumType': ['Card'],
                         'NumForm': ['Word'],
-                        'Number': ['Plur'],
+                        'Number': ['Sing', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
         # VERBS AND AUXILIARIES ################################################

From fbe8919a16b6b33809e19ea7efd25845d592f5e5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 17:06:30 +0200
Subject: [PATCH 1067/1374] "jejie": allow congruent Gender=Masc and Animacy.

---
 udapi/block/ud/cs/markfeatsbugs.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 85234cfb..ca684ec5 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -375,7 +375,8 @@ def process_node(self, node):
                         'Person': ['3'],
                         'Number[psor]': ['Sing'],
                         'Gender[psor]': ['Fem'],
-                        'Gender': ['Masc,Neut', 'Fem'],
+                        'Gender': ['Masc', 'Neut', 'Masc,Neut', 'Fem'],
+                        'Animacy': ['Anim', 'Inan'],
                         'Number': ['Sing'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })

From afe162c2a1ebea051aed20de714a6faf3876ecc8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 17:22:27 +0200
Subject: [PATCH 1068/1374] Separate bug report for unknown UPOS tags.

---
 udapi/block/ud/cs/markfeatsbugs.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index ca684ec5..30f0bda1 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -671,7 +671,10 @@ def process_node(self, node):
                 'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins']
             })
         # THE REST: NO FEATURES ################################################
+        # (OR UNDEFINED UPOS) ##################################################
         else:
+            if not re.match(r"^(CCONJ|SCONJ|PART|INTJ|PUNCT|SYM|X)$", node.upos):
+                self.bug(node, 'UnknownUpos' + node.upos)
             self.check_allowed_features(node, {})
 
     def check_adjective_like(self, node, r0, a0):

From d81db40899c2da4d2af855d097b412898bc05ba9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 17:32:51 +0200
Subject: [PATCH 1069/1374] =?UTF-8?q?NumType=3DSets=20(jedny,=20dvoje,=20t?=
 =?UTF-8?q?roje,=20=C4=8Dtvery...)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 30f0bda1..57c72cef 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -503,7 +503,7 @@ def process_node(self, node):
                     # approach is defined and implemented in the data.
                     self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
                     self.check_allowed_features(node, {
-                        'NumType': ['Card'],
+                        'NumType': ['Card', 'Sets'],
                         'NumForm': ['Word'],
                         'Number': ['Sing', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']

From 7407881835acb3eeb175babe3c914678a44279a9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 17:39:04 +0200
Subject: [PATCH 1070/1374] Allow Voice=Act with imperatives.

---
 udapi/block/ud/cs/markfeatsbugs.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 57c72cef..cca59bbe 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -552,6 +552,7 @@ def process_node(self, node):
                         'Aspect': ['Imp', 'Perf'],
                         'VerbForm': ['Fin'],
                         'Mood': ['Imp'],
+                        'Voice': ['Act'], # optional in Old Czech data, not used with imperatives in Modern Czech data (at least not yet)
                         'Person': ['1', '2', '3'], # 3rd person imperative occasionally occurs in old Czech (but the form is identical to 2nd person)
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Polarity': ['Pos', 'Neg']

From 0671d7ef29138a664f569d242815c88d60a9cc01 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 17:56:42 +0200
Subject: [PATCH 1071/1374] Do not require Aspect for biaspectual verbs.

---
 udapi/block/ud/cs/markfeatsbugs.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index cca59bbe..efd34684 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -510,7 +510,11 @@ def process_node(self, node):
                     })
         # VERBS AND AUXILIARIES ################################################
         elif re.match(r'^(VERB|AUX)$', node.upos):
-            self.check_required_features(node, ['Aspect', 'VerbForm'])
+            # All Czech verbs (and some adjectives and nouns) must have VerbForm.
+            # Almost all verbs have lexical Aspect but we cannot require it
+            # because there are a few biaspectual verbs (e.g. 'analyzovat') that
+            # do not have the feature.
+            self.check_required_features(node, ['VerbForm'])
             if node.feats['VerbForm'] == 'Inf':
                 # There is no voice. For some reason, PDT does not annotate that
                 # the infinitive form is active (while a passive infinitive is

From cec65249f46dac44c4e57d5402451c2cd0682284 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 18:00:50 +0200
Subject: [PATCH 1072/1374] Allow Animacy for Czech pronoun "an".

---
 udapi/block/ud/cs/markfeatsbugs.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index efd34684..50138518 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -320,6 +320,7 @@ def process_node(self, node):
                     self.check_allowed_features(node, {
                         'PronType': ['Rel'],
                         'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Animacy': ['Anim', 'Inan'],
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom']
                     })

From 252726b15785d0d922896b206e4bd22ce7141717 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 18:06:09 +0200
Subject: [PATCH 1073/1374] =?UTF-8?q?"s=C3=A1m"=20vs.=20"sam=C3=BD"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 50138518..ba81c94b 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -434,7 +434,9 @@ def process_node(self, node):
                         'Person': ['1', '2'],
                         'Number[psor]': ['Sing', 'Plur']
                     })
-            elif re.match(r'^(samý)$', node.lemma):
+            elif re.match(r'^(sám|samý)$', node.lemma):
+                # The above condition looks at both lemma options, although only one lemma is assumed.
+                # However, in New Czech data the one lemma is "samý" while in Old Czech data it is "sám".
                 # Unlike other determiners, it allows Variant=Short: sám, sama, samu, samo, sami, samy.
                 self.check_adjective_like(node, ['PronType'], {'PronType': ['Emp'], 'Variant': ['Short']})
             elif node.feats['NumType'] == 'Card': # pronominal quantifiers 'mnoho', 'málo', 'několik' etc.

From 14e2ff44d87113ced06be4c802adefba4fca407c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 22:56:03 +0200
Subject: [PATCH 1074/1374] util.SplitSentence can be triggered by a specific
 attribute in MISC.

---
 udapi/block/util/splitsentence.py | 111 ++++++++++++++++++++++--------
 1 file changed, 82 insertions(+), 29 deletions(-)

diff --git a/udapi/block/util/splitsentence.py b/udapi/block/util/splitsentence.py
index 2886cd5d..b6ca57d8 100644
--- a/udapi/block/util/splitsentence.py
+++ b/udapi/block/util/splitsentence.py
@@ -10,35 +10,87 @@ class SplitSentence(Block):
     If the sent_id of the current sentence matches the parameter, splits the
     sentence into two. The first token of the second sentence is also given as
     a parameter.
+
+    Alternatively, a MISC attribute can be specified that triggers sentence
+    splitting at the given token. With this approach, multiple sentence splits
+    can be performed during one run.
     """
 
-    def __init__(self, sent_id=None, word_id=None, **kwargs):
+    def __init__(self, sent_id=None, word_id=None, misc_name=None, misc_value=None, **kwargs):
         """
         Args:
         sent_id: which sentence should be split (new ids will have A and B appended)
         word_id: which word should be the first word of the second sentence (tokens and words will be renumbered)
+        misc_name: name of the MISC attribute that can trigger the split (cannot be combined with sent_id and word_id)
+        misc_value: value of the MISC attribute to trigger the split; if not specified, then simple occurrence of the attribute with any value will cause the split
+            MISC attributes that have triggered sentence split will be removed from their node.
         """
         super().__init__(**kwargs)
-        if not sent_id:
-            logging.fatal('Missing parameter sent_id')
-        if not word_id:
-            logging.fatal('Missing parameter word_id')
+        if misc_name:
+            if sent_id or word_id:
+                logging.fatal('Cannot combine misc_value with sent_id or word_id')
+        else:
+            if not sent_id:
+                logging.fatal('Missing parameter sent_id')
+            if not word_id:
+                logging.fatal('Missing parameter word_id')
         self.sent_id = sent_id
         self.word_id = word_id
+        self.misc_name = misc_name
+        self.misc_value = misc_value
 
     def process_document(self, document):
         for bundle_no, bundle in enumerate(document.bundles):
-            if bundle.bundle_id == self.sent_id:
+            # In general, a bundle may contain multiple trees in different zones.
+            # In UD data, we always expect just one zone (labeled '') per bundle.
+            # This code could be extended to split all zones but we do not try to do it at present.
+            # (The zones may be translations to other languages and it is not likely that we would
+            # want to split each translation at the same position.)
+            if len(bundle.trees) != 1:
+                logging.fatal('Cannot process bundles that have less or more than 1 zone')
+            if not bundle.has_tree(zone=''):
+                logging.fatal('Cannot process bundles that do not have the zone with empty zone id')
+            if self.misc_name:
+                root = bundle.get_tree()
+                split_points = [n for n in root.descendants if n.ord > 1 and n.misc[self.misc_name] and self.misc_value == None or n.misc[self.misc_name] == self.misc_value]
+                if split_points:
+                    # Create as many new bundles as there are split points.
+                    n_new = len(split_points)
+                    current_bid = bundle.bundle_id
+                    idletter = 'B' # a letter will be added to bundle ids to distinguish them
+                    for i in range(n_new):
+                        new_bundle = document.create_bundle()
+                        new_bundle.bundle_id = current_bid + idletter
+                        new_root = Root(zone='')
+                        new_bundle.add_tree(new_root)
+                        # Identify nodes to move to the new bundle.
+                        first_node_id = split_points[i].ord
+                        if i < n_new - 1:
+                            next_first_node_id = split_points[i+1].ord
+                            nodes_to_move = [n for n in root.descendants if n.ord >= first_node_id and n.ord < next_first_node_id]
+                        else:
+                            nodes_to_move = [n for n in root.descendants if n.ord >= first_node_id]
+                        new_root.steal_nodes(nodes_to_move)
+                        self.make_zeros_roots(new_root)
+                        new_root.text = new_root.compute_text()
+                        # The new bundle was created at the end of the document.
+                        # Move it to the position right after the current bundle.
+                        document.bundles.pop()
+                        document.bundles.insert(bundle_no + i + 1, new_bundle)
+                        idletter = chr(ord(idletter) + 1)
+                        # Remove from the node the MISC attribute that triggered the sentence split.
+                        split_points[i].misc[self.misc_name] = ''
+                    # Update the id of the current bundle, fix its zero-dependents and recompute sentence text.
+                    bundle.bundle_id += 'A'
+                    self.make_zeros_roots(root)
+                    root.text = root.compute_text()
+                    # Update the bundle numbers of the new bundles and all bundles after them.
+                    updated_no = bundle_no + 1
+                    for b in document.bundles[(bundle_no+1):]:
+                        b.number = updated_no
+                        updated_no += 1
+            elif bundle.bundle_id == self.sent_id:
                 logging.info('Found!')
-                # In general, a bundle may contain multiple trees in different zones.
-                # In UD data, we always expect just one zone (labeled '') per bundle.
-                # This code could be extended to split all zones but we do not try to do it at present.
-                # (The zones may be translations to other languages and it is not likely that we would
-                # want to split each translation at the same position.)
-                if len(bundle.trees) != 1:
-                    logging.fatal('Cannot process bundles that have less or more than 1 zone')
-                if not bundle.has_tree(zone=''):
-                    logging.fatal('Cannot process bundles that do not have the zone with empty zone id')
                 root = bundle.get_tree()
                 nodes_to_move = [n for n in root.descendants if n.ord >= self.word_id]
                 if len(nodes_to_move) == 0:
@@ -60,22 +112,23 @@ def process_document(self, document):
                 new_root.steal_nodes(nodes_to_move)
                 # The steal_nodes() method does not make sure that all nodes newly attached
                 # to the artificial root have the 'root' relation. Fix it.
-                n_root = 0
-                for n in root.descendants:
-                    if n.parent.is_root():
-                        n.deprel = 'root'
-                        n_root += 1
-                if n_root > 1:
-                    logging.warning('More than one 0:root relation in the first part of the sentence.')
-                n_root = 0
-                for n in new_root.descendants:
-                    if n.parent.is_root():
-                        n.deprel = 'root'
-                        n_root += 1
-                if n_root > 1:
-                    logging.warning('More than one 0:root relation in the second part of the sentence.')
+                self.make_zeros_roots(root)
+                self.make_zeros_roots(new_root)
                 # Update the sentence text attributes of the new sentences.
                 root.text = root.compute_text()
                 new_root.text = new_root.compute_text()
                 # We have found our sentence. No need to process the rest of the document.
                 break
+
+    def make_zeros_roots(self, root):
+        """
+        The steal_nodes() method does not make sure that all nodes newly attached
+        to the artificial root have the 'root' relation. Fix it.
+        """
+        n_root = 0
+        for n in root.descendants:
+            if n.parent.is_root():
+                n.deprel = 'root'
+                n_root += 1
+        if n_root > 1:
+            logging.warning('More than one 0:root relation in newly segmented sentence %s.' % root.bundle.bundle_id)

From 7aa646ca5d1899da81fc9bfb3b0165b7a7da618f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Sep 2024 23:27:49 +0200
Subject: [PATCH 1075/1374] Updated rules for multiword tokens in Czech.

---
 udapi/block/ud/cs/addmwt.py | 36 ++++++++++++++++++------------------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 4c203ddc..116761ff 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -1,13 +1,14 @@
 """Block ud.cs.AddMwt for heuristic detection of multi-word tokens."""
 import udapi.block.ud.addmwt
 
+# Define static rules for 'aby', 'kdyby' and similar forms.
 MWTS = {
     'abych': {'form': 'aby bych', 'feats': '_ Mood=Cnd|Number=Sing|Person=1|VerbForm=Fin'},
     'kdybych': {'form': 'když bych', 'feats': '_ Mood=Cnd|Number=Sing|Person=1|VerbForm=Fin'},
     'abys': {'form': 'aby bys', 'feats': '_ Mood=Cnd|Number=Sing|Person=2|VerbForm=Fin'},
     'kdybys': {'form': 'když bys', 'feats': '_ Mood=Cnd|Number=Sing|Person=2|VerbForm=Fin'},
-    'aby': {'form': 'aby by', 'feats': '_ Mood=Cnd|Person=3|VerbForm=Fin'},
-    'kdyby': {'form': 'když by', 'feats': '_ Mood=Cnd|Person=3|VerbForm=Fin'},
+    'aby': {'form': 'aby by', 'feats': '_ Mood=Cnd|VerbForm=Fin'},
+    'kdyby': {'form': 'když by', 'feats': '_ Mood=Cnd|VerbForm=Fin'},
     'abychom': {'form': 'aby bychom', 'feats': '_ Mood=Cnd|Number=Plur|Person=1|VerbForm=Fin'},
     'kdybychom': {'form': 'když bychom', 'feats': '_ Mood=Cnd|Number=Plur|Person=1|VerbForm=Fin'},
     'abyste': {'form': 'aby byste', 'feats': '_ Mood=Cnd|Number=Plur|Person=2|VerbForm=Fin'},
@@ -25,13 +26,14 @@
         person = '1'
     elif 'Person=2' in v['feats']:
         person = '2'
-
     v['xpos'] = 'J,------------- Vc-%s---%s-------' % (number, person)
     v['deprel'] = '* aux'
     v['lemma'] = v['form'].split()[0] + ' být'
     v['main'] = 0
     v['shape'] = 'siblings'
 
+# Define static rules for 'nač', 'zač', 'oč' (but not 'proč').
+# Add them to the already existing dictionary MWTS.
 # nač -> na + co
 for prep in 'na za o'.split():
     MWTS[prep + 'č'] = {
@@ -43,7 +45,6 @@
         'shape': 'subtree',
     }
 
-
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
     """Detect and mark MWTs (split them into words and add the words to the tree)."""
 
@@ -52,21 +53,20 @@ def multiword_analysis(self, node):
         analysis = MWTS.get(node.form.lower(), None)
         if analysis is not None:
             return analysis
-
-        # There is no VerbType=verbconj in the UD_Czech data.
-        # The purpose of this rule is rather to show that
-        # it is possible to write such "dynamic" rules
-        # (which cannot be included in static MWTS).
-        if node.form.lower().endswith('ť') and node.feats['VerbType'] == 'verbconj':
+        # If the node did not match any of the static rules defined in MWTS,
+        # check it against the "dynamic" rule below. The enclitic 'ť' will be
+        # separated from its host but only if it has been marked by an annotator
+        # in MISC.
+        if node.form.lower().endswith('ť') and node.misc['RETOKENIZE'] == 'rozdělit':
             return {
-                'form': node.form.lower()[:-1] + ' neboť',
-                'lemma': '* neboť',
-                'upos': '* CCONJ',
-                'xpos': 'Vt-S---3P-NA--2 J^-------------',
-                'feats': '* _',
-                'deprel': '* cc',
-                'main': 0,
-                'shape': 'subtree',
+                'form':   node.form.lower()[:-1] + ' ť',
+                'lemma':  '* ť',
+                'upos':   '* PART',
+                'xpos':   '* TT-------------',
+                'feats':  '* _',
+                'deprel': '* discourse',
+                'main':   0,
+                'shape':  'subtree',
             }
         return None
 

From f4417c0a4dcfa46b3cdb7d7fc65ef50912be280e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 6 Sep 2024 08:48:23 +0200
Subject: [PATCH 1076/1374] =?UTF-8?q?"jemu=C5=BEs"=20=3D=20"jemu=C5=BE"=20?=
 =?UTF-8?q?+=20"jsi"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/addmwt.py | 51 +++++++++++++++++++++++++++----------
 1 file changed, 38 insertions(+), 13 deletions(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 116761ff..14f6e474 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -54,20 +54,45 @@ def multiword_analysis(self, node):
         if analysis is not None:
             return analysis
         # If the node did not match any of the static rules defined in MWTS,
-        # check it against the "dynamic" rule below. The enclitic 'ť' will be
+        # check it against the "dynamic" rules below. The enclitic 'ť' will be
         # separated from its host but only if it has been marked by an annotator
-        # in MISC.
-        if node.form.lower().endswith('ť') and node.misc['RETOKENIZE'] == 'rozdělit':
-            return {
-                'form':   node.form.lower()[:-1] + ' ť',
-                'lemma':  '* ť',
-                'upos':   '* PART',
-                'xpos':   '* TT-------------',
-                'feats':  '* _',
-                'deprel': '* discourse',
-                'main':   0,
-                'shape':  'subtree',
-            }
+        # in MISC. (These are annotation conventions used for Old Czech in the
+        # Hičkok project.)
+        if node.misc['RETOKENIZE'] == 'rozdělit':
+            subtokens = ' '.split(node.misc['SUBTOKENS'])
+            if len(subtokens) != 2:
+                logging.warning("MISC SUBTOKENS='%s' has unexpected number of subtokens." % node.misc['SUBTOKENS'])
+                return None
+            token_from_subtokens = ''.join(subtokens)
+            if token_from_subtokens != node.form:
+                logging.warning("Concatenation of MISC SUBTOKENS='%s' does not yield the FORM '%s'." % (node.misc['SUBTOKENS'], node.form))
+                return None
+            if subtokens[1] == 's':
+                node.misc['RETOKENIZE'] = ''
+                node.misc['SUBTOKENS'] = ''
+                return {
+                    'form':   subtokens[0] + ' jsi',
+                    'lemma':  '* být',
+                    'upos':   '* AUX',
+                    'xpos':   '* VB-S---2P-AAI--',
+                    'feats':  '* Aspect=Imp|Mood=Ind|Number=Sing|Person=2|Polarity=Pos|Tense=Pres|VerbForm=Fin|Voice=Act',
+                    'deprel': '* aux',
+                    'main':   0,
+                    'shape':  'subtree' if node.upos in ['VERB'] else 'siblings',
+                }
+            if subtokens[1] == 'ť':
+                node.misc['RETOKENIZE'] = ''
+                node.misc['SUBTOKENS'] = ''
+                return {
+                    'form':   node.form.lower()[:-1] + ' ť',
+                    'lemma':  '* ť',
+                    'upos':   '* PART',
+                    'xpos':   '* TT-------------',
+                    'feats':  '* _',
+                    'deprel': '* discourse',
+                    'main':   0,
+                    'shape':  'subtree',
+                }
         return None
 
     def postprocess_mwt(self, mwt):

From 111a5f2ecfd0159797714fe6ac28b4347240cb01 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 6 Sep 2024 09:08:38 +0200
Subject: [PATCH 1077/1374] import logging

---
 udapi/block/ud/cs/addmwt.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 14f6e474..30a3d648 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -1,5 +1,6 @@
 """Block ud.cs.AddMwt for heuristic detection of multi-word tokens."""
 import udapi.block.ud.addmwt
+import logging
 
 # Define static rules for 'aby', 'kdyby' and similar forms.
 MWTS = {

From 6dd62269a7fa1c61c98c139e1b5d6877e7e1904d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 6 Sep 2024 09:15:37 +0200
Subject: [PATCH 1078/1374] Bug fix.

---
 udapi/block/ud/cs/addmwt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 30a3d648..e07c5ca6 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -60,7 +60,7 @@ def multiword_analysis(self, node):
         # in MISC. (These are annotation conventions used for Old Czech in the
         # Hičkok project.)
         if node.misc['RETOKENIZE'] == 'rozdělit':
-            subtokens = ' '.split(node.misc['SUBTOKENS'])
+            subtokens = node.misc['SUBTOKENS'].split()
             if len(subtokens) != 2:
                 logging.warning("MISC SUBTOKENS='%s' has unexpected number of subtokens." % node.misc['SUBTOKENS'])
                 return None

From 92d5a0d2ffc7d2662d2e077fbfac057cb880ec8b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 7 Sep 2024 11:10:01 +0200
Subject: [PATCH 1079/1374] =?UTF-8?q?Adapted=20to=20improved=20MISC=20anno?=
 =?UTF-8?q?tation=20from=20Hi=C4=8Dkok.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/addmwt.py | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index e07c5ca6..103541c9 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -59,18 +59,17 @@ def multiword_analysis(self, node):
         # separated from its host but only if it has been marked by an annotator
         # in MISC. (These are annotation conventions used for Old Czech in the
         # Hičkok project.)
-        if node.misc['RETOKENIZE'] == 'rozdělit':
-            subtokens = node.misc['SUBTOKENS'].split()
+        if node.misc['AddMwt'] != '':
+            subtokens = node.misc['AddMwt'].split()
             if len(subtokens) != 2:
-                logging.warning("MISC SUBTOKENS='%s' has unexpected number of subtokens." % node.misc['SUBTOKENS'])
+                logging.warning("MISC 'AddMwt=%s' has unexpected number of subtokens." % node.misc['AddMwt'])
                 return None
             token_from_subtokens = ''.join(subtokens)
             if token_from_subtokens != node.form:
-                logging.warning("Concatenation of MISC SUBTOKENS='%s' does not yield the FORM '%s'." % (node.misc['SUBTOKENS'], node.form))
+                logging.warning("Concatenation of MISC 'AddMwt=%s' does not yield the FORM '%s'." % (node.misc['AddMwt'], node.form))
                 return None
             if subtokens[1] == 's':
-                node.misc['RETOKENIZE'] = ''
-                node.misc['SUBTOKENS'] = ''
+                node.misc['AddMwt'] = ''
                 return {
                     'form':   subtokens[0] + ' jsi',
                     'lemma':  '* být',
@@ -82,8 +81,7 @@ def multiword_analysis(self, node):
                     'shape':  'subtree' if node.upos in ['VERB'] else 'siblings',
                 }
             if subtokens[1] == 'ť':
-                node.misc['RETOKENIZE'] = ''
-                node.misc['SUBTOKENS'] = ''
+                node.misc['AddMwt'] = ''
                 return {
                     'form':   node.form.lower()[:-1] + ' ť',
                     'lemma':  '* ť',

From a89ca772c1e7218d0b595bf748606f4965eb9275 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 7 Sep 2024 11:26:10 +0200
Subject: [PATCH 1080/1374] =?UTF-8?q?Allow=20short=20form=20"=C5=BE=C3=A1d?=
 =?UTF-8?q?en".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index ba81c94b..7438fdee 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -439,6 +439,9 @@ def process_node(self, node):
                 # However, in New Czech data the one lemma is "samý" while in Old Czech data it is "sám".
                 # Unlike other determiners, it allows Variant=Short: sám, sama, samu, samo, sami, samy.
                 self.check_adjective_like(node, ['PronType'], {'PronType': ['Emp'], 'Variant': ['Short']})
+            elif node.lemma == 'žádný':
+                # In Old Czech, this determiner also allows Variant=Short: žáden, žádna, žádnu, žádno, žádni, žádny.
+                self.check_adjective_like(node, ['PronType'], {'PronType': ['Neg'], 'Variant': ['Short']})
             elif node.feats['NumType'] == 'Card': # pronominal quantifiers 'mnoho', 'málo', 'několik' etc.
                 if node.lemma == 'nejeden':
                     self.check_adjective_like(node, ['PronType', 'NumType'], {'PronType': ['Ind'], 'NumType': ['Card']})

From 5dbedbec8a0db85d0d57a6931d909c542ba9e499 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 7 Sep 2024 11:43:57 +0200
Subject: [PATCH 1081/1374] "Lecco" behaves like "co".

---
 udapi/block/ud/cs/markfeatsbugs.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 7438fdee..78030100 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -248,8 +248,8 @@ def process_node(self, node):
                         })
             elif re.search(r'k[dt]o', node.lemma): # kdo (kto), kdož, někdo, nikdo
                 # There is no Number. Někdo and nikdo behave like singular;
-                # kdo is by default singular as well but it also occurs as a subject
-                # of plural verbs.
+                # kdo is by default singular as well but it also occurs as subject
+                # of plural verbs ("ti, kdo nepřišli včas, byli vyloučeni").
                 # Old Czech data disambiguate Int from Rel (Int is used only in direct questions with; indirect questions like "Ptal ses, kdo to je?" use Rel.)
                 # New Czech data, in particular PDT, use Int,Rel regardless of context.
                 self.check_required_features(node, ['PronType', 'Gender', 'Animacy', 'Case'])
@@ -259,7 +259,7 @@ def process_node(self, node):
                     'Animacy': ['Anim'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Loc', 'Ins']
                 })
-            elif re.match(r'^(co|což|něco|nic|nicož)$', node.lemma):
+            elif re.match(r'^(co|což|něco|lečco|lecco|nic|nicož)$', node.lemma):
                 # Although these pronouns behave by default as neuter singular,
                 # no Gender and Number is annotated. However, quite unusually,
                 # there is Animacy=Inan without Gender.

From ea7d93441b1cf8d9c630ddc8d68cc74d4f9db025 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 7 Sep 2024 14:36:16 +0200
Subject: [PATCH 1082/1374] Fix root-related errors.

---
 udapi/block/ud/fixroot.py | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 udapi/block/ud/fixroot.py

diff --git a/udapi/block/ud/fixroot.py b/udapi/block/ud/fixroot.py
new file mode 100644
index 00000000..be972d8b
--- /dev/null
+++ b/udapi/block/ud/fixroot.py
@@ -0,0 +1,37 @@
+"""
+Block ud.FixRoot will ensure that the tree is free of common root-related errors.
+Simple heuristics are used; it is likely that human inspection would lead to
+a different solution. Nevertheless, if a quick fix is needed to pass the
+validation, this block can be helpful.
+
+WARNING: The block currently ignores enhanced dependencies.
+"""
+import re
+from udapi.core.block import Block
+
+
+class FixRoot(Block):
+    """
+    Fixes the following validation errors:
+    - Only one node must be attached directly to the artificial root node.
+      => If the root has multiple children, keep the first one. Attach the other
+         ones to the first one. Change their deprel to 'parataxis'.
+    - The node attached as a child of the artificial root node must have the
+      'root' relation (or its subtype).
+      => If the root child has another deprel, change it to 'root'.
+    - The node attached as a child of the artificial root node is the only one
+      allowed to have the 'root' relation (or its subtype).
+      => If another node has that deprel, change it to 'parataxis'.
+    """
+
+    def process_tree(self, root):
+        rchildren = root.children
+        if len(rchildren) > 1:
+            for i in range(len(rchildren)-1):
+                rchildren[i+1].parent = rchildren[0]
+                rchildren[i+1].deprel = 'parataxis'
+        if rchildren[0].udeprel != 'root':
+            rchildren[0].deprel = 'root'
+        for n in root.descendants:
+            if not n.parent == root and n.udeprel == 'root':
+                n.deprel = 'parataxis'

From bf43850d6d30c5e8cafb948f325874b33d9a0aed Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 8 Sep 2024 11:17:01 +0200
Subject: [PATCH 1083/1374] util.JoinSentence is the opposite of
 util.SplitSentence.

---
 udapi/block/util/joinsentence.py | 78 ++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 udapi/block/util/joinsentence.py

diff --git a/udapi/block/util/joinsentence.py b/udapi/block/util/joinsentence.py
new file mode 100644
index 00000000..e52f0e8e
--- /dev/null
+++ b/udapi/block/util/joinsentence.py
@@ -0,0 +1,78 @@
+"""
+Block util.SplitSentence will split a given sentence at a given token.
+"""
+import logging
+from udapi.core.block import Block
+from udapi.core.root import Root
+
+class JoinSentence(Block):
+    """
+    Joins a sentence with the preceding one. There are two ways how to indicate
+    the sentences that this block should process.
+
+    Method 1: Parameter sent_id provides the id of the sentence that should be
+    merged with the preceding one. At most one sentence pair from the input will
+    be merged, even if there are multiple sentences with the given id.
+
+    Method 2: A MISC attribute can be specified that, if found, will trigger
+    joining of the current sentence to the previous one. With this approach,
+    multiple sentence pairs can be merged during one run.
+    """
+
+    def __init__(self, sent_id=None, misc_name=None, misc_value=None, **kwargs):
+        """
+        Args:
+        sent_id: which sentence should be appended to the previous one
+        misc_name: name of the MISC attribute that can trigger the joining (cannot be combined with sent_id and word_id)
+        misc_value: value of the MISC attribute to trigger the joining; if not specified, then simple occurrence of the attribute with any value will cause the joining
+            MISC attributes that have triggered sentence joining will be removed from their node.
+        """
+        super().__init__(**kwargs)
+        if misc_name:
+            if sent_id:
+                logging.fatal('Cannot combine misc_value with sent_id')
+        else:
+            if not sent_id:
+                logging.fatal('Missing parameter sent_id')
+        self.sent_id = sent_id
+        self.misc_name = misc_name
+        self.misc_value = misc_value
+
+    def process_document(self, document):
+        previous_tree = None
+        for bundle_no, bundle in enumerate(document.bundles):
+            # In general, a bundle may contain multiple trees in different zones.
+            # In UD data, we always expect just one zone (labeled '') per bundle.
+            # This code could be extended to join all zones but we do not try to do it at present.
+            if len(bundle.trees) != 1:
+                logging.fatal('Cannot process bundles that have less or more than 1 zone')
+            if not bundle.has_tree(zone=''):
+                logging.fatal('Cannot process bundles that do not have the zone with empty zone id')
+            if self.misc_name:
+                root = bundle.get_tree()
+                # The MISC attribute we are looking for should logically occur
+                # on the first node of the sentence but we can take it from any node.
+                join_commands = [n for n in root.descendants if n.misc[self.misc_name] and self.misc_value == None or n.misc[self.misc_name] == self.misc_value]
+                if join_commands:
+                    if not previous_tree:
+                        logging.fatal('Cannot join the first sentence as there is no previous sentence')
+                    previous_tree.steal_nodes(root.descendants)
+                    previous_tree.text = previous_tree.compute_text()
+                    # Remove from the node the MISC attribute that triggered the sentence split.
+                    for n in join_commands:
+                        n.misc[self.misc_name] = ''
+                    # Remove the current bundle. It will also update the numbers of the remaining bundles.
+                    bundle.remove()
+                else:
+                    previous_tree = root
+            elif bundle.bundle_id == self.sent_id:
+                logging.info('Found!')
+                if not previous_tree:
+                    logging.fatal('Cannot join the first sentence as there is no previous sentence')
+                root = bundle.get_tree()
+                previous_tree.steal_nodes(root.descendants)
+                previous_tree.text = previous_tree.compute_text()
+                # Remove the current bundle. It will also update the numbers of the remaining bundles.
+                bundle.remove()
+                # We have found our sentence. No need to process the rest of the document.
+                break

From 57be371819f4e3905b5d581727bec3756d3f4dc8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 10 Oct 2024 08:36:55 +0200
Subject: [PATCH 1084/1374] AddMwt: also xpos and feats.

---
 udapi/block/ud/cs/addmwt.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 103541c9..7cbfa4b1 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -41,6 +41,8 @@
         'form': prep + ' co',
         'lemma': prep + ' co',
         'upos': 'ADP PRON',
+        'xpos': 'RR--4---------- PQ--4----------',
+        'feats': 'AdpType=Prep|Case=Acc Animacy=Inan|Case=Acc|PronType=Int,Rel',
         'deprel': 'case *',
         'main': 1,
         'shape': 'subtree',

From e3c30ec69ed8d7eeeeb010ee9c6e4e4a2cbac8c5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 10 Oct 2024 22:51:35 +0200
Subject: [PATCH 1085/1374] Change det to amod if it is ADJ.

---
 udapi/block/ud/fixadvmodbyupos.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index 781e7586..e7bd03a6 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -29,10 +29,14 @@ def process_node(self, node):
                 node.deprel = 'discourse'
             else:
                 node.deprel = 'dep'
-        ###!!! The following are not advmod so they should probably have their own block or this block should have a different name.
+        ###!!! The following are not advmod so they should probably have their
+        ###!!! own block or this block should have a different name.
         elif node.udeprel == 'expl':
             if node.upos == 'AUX':
                 node.deprel = 'aux'
         elif node.udeprel == 'mark':
             if node.upos == 'PRON':
                 node.deprel = 'nsubj' # it could be also obj, iobj, obl or nmod; just guessing what might be more probable
+        elif node.udeprel == 'det':
+            if node.upos == 'ADJ':
+                node.deprel = 'amod'

From 26edfbcc35381a888d88c2c50a39d27e4a6ac2b8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 11 Oct 2024 23:37:47 +0200
Subject: [PATCH 1086/1374] Removed import that is not used.

---
 udapi/block/ud/cs/markfeatsbugs.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 78030100..00be9993 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -7,7 +7,6 @@
 Windows: python udapy read.Conllu files="a.conllu,b.conllu" merge=1 ud.cs.MarkFeatsBugs write.TextModeTreesHtml files="bugs.html" marked_only=1 layout=compact attributes=form,lemma,upos,xpos,feats,deprel,misc
 """
 import udapi.block.ud.markfeatsbugs
-import logging
 import re
 
 class MarkFeatsBugs(udapi.block.ud.markfeatsbugs.MarkFeatsBugs):

From 9a658f066fb1028ac65cc7464e257278dd600db6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 11 Oct 2024 23:42:48 +0200
Subject: [PATCH 1087/1374] Dan's tutorial.

---
 tutorial/udapi-tutorial-dz.odt | Bin 0 -> 185047 bytes
 tutorial/udapi-tutorial-dz.pdf | Bin 0 -> 236726 bytes
 2 files changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 tutorial/udapi-tutorial-dz.odt
 create mode 100644 tutorial/udapi-tutorial-dz.pdf

diff --git a/tutorial/udapi-tutorial-dz.odt b/tutorial/udapi-tutorial-dz.odt
new file mode 100644
index 0000000000000000000000000000000000000000..b3e8e9f0937e431c9a2e3a6cf3c38730ff104673
GIT binary patch
literal 185047
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

literal 0
HcmV?d00001

diff --git a/tutorial/udapi-tutorial-dz.pdf b/tutorial/udapi-tutorial-dz.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..851983fe8b176cea88bb33c62b39bfc68ec3e4bf
GIT binary patch
literal 236726
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
BO;P{=

literal 0
HcmV?d00001


From 10e72fa914a1f06f2d82929e53d2af7eebea072c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 11 Oct 2024 23:55:22 +0200
Subject: [PATCH 1088/1374] Avoid adding a MWT if the node already is in a MWT.

---
 udapi/block/ud/cs/addmwt.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 7cbfa4b1..bc688f8c 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -53,6 +53,9 @@ class AddMwt(udapi.block.ud.addmwt.AddMwt):
 
     def multiword_analysis(self, node):
         """Return a dict with MWT info or None if `node` does not represent a multiword token."""
+        # Avoid adding a MWT if the current node already is part of an MWT.
+        if node.multiword_token:
+            return None
         analysis = MWTS.get(node.form.lower(), None)
         if analysis is not None:
             return analysis

From 1819f3862d1295c93c08ff5e8d8326027374df87 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 12 Oct 2024 11:46:48 +0200
Subject: [PATCH 1089/1374] =?UTF-8?q?Zm=C4=9Bna=20po=C5=BEadavk=C5=AF=20pr?=
 =?UTF-8?q?o=20"jej=C3=AD,=20jej=C3=AD=C5=BE"=20ve=20staro=C4=8Desk=C3=BDc?=
 =?UTF-8?q?h=20datech.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 27 ++++++++++++++++-----------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 00be9993..d991a17f 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -363,11 +363,13 @@ def process_node(self, node):
             # Feminine personal possessive determiner.
             elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)$', node.form.lower()):
                 # The feminine possessive 'její' slightly inflects, unlike 'jeho' and 'jejich'.
-                # Congruent gender is annotated only in singular. Masculine and
-                # neuter are merged even in nominative. Feminine singular does
-                # not distinguish case in PDT but we need it in Old Czech at
-                # least for 'jejiej'.
-                if node.feats['Number'] == 'Sing':
+                # Congruent gender:
+                # - in PDT, only in singular; masculine and neuter are merged even in nominative
+                # - in Old Czech data, gender is disambiguated by context (no merging), even in dual and plural
+                # Case:
+                # - in PDT, not distinguished in feminine singular (její bota, její boty, její botě, její botu...)
+                # - in Old Czech data, distinguished always (and needed at least for 'jejiej')
+                if node.feats['Number'] == 'Sing' or not self.pdt20:
                     self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]', 'Gender', 'Number', 'Case'])
                     self.check_allowed_features(node, {
                         'PronType': ['Prs'],
@@ -394,18 +396,21 @@ def process_node(self, node):
             # Feminine relative possessive determiner.
             elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)(ž(e|to)?)$', node.form.lower()):
                 # The feminine possessive 'jejíž' slightly inflects, unlike 'jehož' and 'jejichž'.
-                # Congruent gender is annotated only in singular. Masculine and
-                # neuter are merged even in nominative. Feminine singular does
-                # not distinguish case in PDT but we need it in Old Czech at
-                # least for 'jejiej'.
-                if node.feats['Number'] == 'Sing':
+                # Congruent gender:
+                # - in PDT, only in singular; masculine and neuter are merged even in nominative
+                # - in Old Czech data, gender is disambiguated by context (no merging), even in dual and plural
+                # Case:
+                # - in PDT, not distinguished in feminine singular (jejíž bota, jejíž boty, jejíž botě, jejíž botu...)
+                # - in Old Czech data, distinguished always (and needed at least for 'jejiejž')
+                if node.feats['Number'] == 'Sing' or not self.pdt20:
                     self.check_required_features(node, ['PronType', 'Poss', 'Number[psor]', 'Gender[psor]', 'Gender', 'Number', 'Case'])
                     self.check_allowed_features(node, {
                         'PronType': ['Rel'],
                         'Poss': ['Yes'],
                         'Number[psor]': ['Sing'],
                         'Gender[psor]': ['Fem'],
-                        'Gender': ['Masc,Neut', 'Fem'],
+                        'Gender': ['Masc', 'Neut', 'Masc,Neut', 'Fem'],
+                        'Animacy': ['Anim', 'Inan'],
                         'Number': ['Sing'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })

From dcf10e249e799d19673840b86affe3a57f57c8b2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 12 Oct 2024 12:21:30 +0200
Subject: [PATCH 1090/1374] =?UTF-8?q?More=20detailed=20requirements=20for?=
 =?UTF-8?q?=20"jej=C3=AD",=20"jej=C3=AD=C5=BE".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 83 +++++++++++++++++++-----------
 1 file changed, 54 insertions(+), 29 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index d991a17f..9fb086f1 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -369,28 +369,41 @@ def process_node(self, node):
                 # Case:
                 # - in PDT, not distinguished in feminine singular (její bota, její boty, její botě, její botu...)
                 # - in Old Czech data, distinguished always (and needed at least for 'jejiej')
-                if node.feats['Number'] == 'Sing' or not self.pdt20:
-                    self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]', 'Gender', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'PronType': ['Prs'],
-                        'Poss': ['Yes'],
-                        'Person': ['3'],
-                        'Number[psor]': ['Sing'],
-                        'Gender[psor]': ['Fem'],
-                        'Gender': ['Masc', 'Neut', 'Masc,Neut', 'Fem'],
-                        'Animacy': ['Anim', 'Inan'],
-                        'Number': ['Sing'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                    })
+                if self.pdt20:
+                    if node.feats['Number'] == 'Sing':
+                        self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]', 'Gender', 'Number', 'Case'])
+                        self.check_allowed_features(node, {
+                            'PronType': ['Prs'],
+                            'Poss': ['Yes'],
+                            'Person': ['3'],
+                            'Number[psor]': ['Sing'],
+                            'Gender[psor]': ['Fem'],
+                            'Gender': ['Masc,Neut', 'Fem'],
+                            'Number': ['Sing'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                        })
+                    else:
+                        self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]', 'Number', 'Case'])
+                        self.check_allowed_features(node, {
+                            'PronType': ['Prs'],
+                            'Poss': ['Yes'],
+                            'Person': ['3'],
+                            'Number[psor]': ['Sing'],
+                            'Gender[psor]': ['Fem'],
+                            'Number': ['Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                        })
                 else:
-                    self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]', 'Number', 'Case'])
+                    self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]', 'Gender[psor]', 'Gender', 'Number', 'Case'])
                     self.check_allowed_features(node, {
                         'PronType': ['Prs'],
                         'Poss': ['Yes'],
                         'Person': ['3'],
                         'Number[psor]': ['Sing'],
                         'Gender[psor]': ['Fem'],
-                        'Number': ['Dual', 'Plur'],
+                        'Gender': ['Masc', 'Neut', 'Fem'],
+                        'Animacy': ['Anim', 'Inan'], # only for Gender=Masc
+                        'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
             # Feminine relative possessive determiner.
@@ -402,26 +415,38 @@ def process_node(self, node):
                 # Case:
                 # - in PDT, not distinguished in feminine singular (jejíž bota, jejíž boty, jejíž botě, jejíž botu...)
                 # - in Old Czech data, distinguished always (and needed at least for 'jejiejž')
-                if node.feats['Number'] == 'Sing' or not self.pdt20:
-                    self.check_required_features(node, ['PronType', 'Poss', 'Number[psor]', 'Gender[psor]', 'Gender', 'Number', 'Case'])
-                    self.check_allowed_features(node, {
-                        'PronType': ['Rel'],
-                        'Poss': ['Yes'],
-                        'Number[psor]': ['Sing'],
-                        'Gender[psor]': ['Fem'],
-                        'Gender': ['Masc', 'Neut', 'Masc,Neut', 'Fem'],
-                        'Animacy': ['Anim', 'Inan'],
-                        'Number': ['Sing'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
-                    })
+                if self.pdt20:
+                    if node.feats['Number'] == 'Sing':
+                        self.check_required_features(node, ['PronType', 'Poss', 'Number[psor]', 'Gender[psor]', 'Gender', 'Number', 'Case'])
+                        self.check_allowed_features(node, {
+                            'PronType': ['Rel'],
+                            'Poss': ['Yes'],
+                            'Number[psor]': ['Sing'],
+                            'Gender[psor]': ['Fem'],
+                            'Gender': ['Masc,Neut', 'Fem'],
+                            'Number': ['Sing'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                        })
+                    else:
+                        self.check_required_features(node, ['PronType', 'Poss', 'Number[psor]', 'Gender[psor]', 'Number', 'Case'])
+                        self.check_allowed_features(node, {
+                            'PronType': ['Rel'],
+                            'Poss': ['Yes'],
+                            'Number[psor]': ['Sing'],
+                            'Gender[psor]': ['Fem'],
+                            'Number': ['Dual', 'Plur'],
+                            'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                        })
                 else:
-                    self.check_required_features(node, ['PronType', 'Poss', 'Number[psor]', 'Gender[psor]', 'Number', 'Case'])
+                    self.check_required_features(node, ['PronType', 'Poss', 'Number[psor]', 'Gender[psor]', 'Gender', 'Number', 'Case'])
                     self.check_allowed_features(node, {
                         'PronType': ['Rel'],
                         'Poss': ['Yes'],
                         'Number[psor]': ['Sing'],
                         'Gender[psor]': ['Fem'],
-                        'Number': ['Dual', 'Plur'],
+                        'Gender': ['Masc', 'Neut', 'Fem'],
+                        'Animacy': ['Anim', 'Inan'], # only for Gender=Masc
+                        'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
             elif node.feats['Poss'] == 'Yes': # 'můj', 'tvůj', 'svůj'

From 199ce8d76d75ca862ae3b6c7f5deb562b6189f2b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 12 Oct 2024 17:55:35 +0200
Subject: [PATCH 1091/1374] Additional relations to be fixed given the correct
 UPOS.

---
 udapi/block/ud/fixadvmodbyupos.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index e7bd03a6..b232e185 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -34,9 +34,15 @@ def process_node(self, node):
         elif node.udeprel == 'expl':
             if node.upos == 'AUX':
                 node.deprel = 'aux'
+            elif node.upos == 'ADP':
+                node.deprel = 'case'
+            elif node.upos == 'CCONJ':
+                node.deprel = 'cc'
         elif node.udeprel == 'mark':
             if node.upos == 'PRON':
                 node.deprel = 'nsubj' # it could be also obj, iobj, obl or nmod; just guessing what might be more probable
         elif node.udeprel == 'det':
-            if node.upos == 'ADJ':
+            if node.upos == 'NOUN':
+                node.deprel = 'nmod'
+            elif node.upos == 'ADJ':
                 node.deprel = 'amod'

From afb736b72bb0e7b6e526ee8ad018fdc19a07c7b4 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 12 Oct 2024 20:17:52 +0200
Subject: [PATCH 1092/1374] Czech adjectives now allow Emph=Yes.

---
 udapi/block/ud/cs/markfeatsbugs.py | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 9fb086f1..490b53d8 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -85,6 +85,7 @@ def process_node(self, node):
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                         'NameType': ['Giv', 'Sur'], # for possessive adjectives derived from personal names
+                        'Emph': ['Yes'],
                         'Foreign': ['Yes']})
                 else:
                     self.check_required_features(node, ['Poss', 'Gender[psor]', 'Gender', 'Number', 'Case'])
@@ -95,6 +96,7 @@ def process_node(self, node):
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                         'NameType': ['Giv', 'Sur'], # for possessive adjectives derived from personal names
+                        'Emph': ['Yes'],
                         'Foreign': ['Yes']})
             elif node.feats['NumType'] == 'Ord' or node.feats['NumType'] == 'Mult': # ordinal numerals are a subtype of adjectives; same for some multiplicative numerals (dvojí, trojí)
                 if node.feats['Gender'] == 'Masc':
@@ -105,6 +107,7 @@ def process_node(self, node):
                         'Animacy': ['Anim', 'Inan'],
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Emph': ['Yes'],
                         'Foreign': ['Yes']})
                 else:
                     self.check_required_features(node, ['NumType', 'Gender', 'Number', 'Case'])
@@ -113,6 +116,7 @@ def process_node(self, node):
                         'Gender': ['Masc', 'Fem', 'Neut'],
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Emph': ['Yes'],
                         'Foreign': ['Yes']})
             elif node.feats['VerbForm'] == 'Part': # participles (except l-participles) are a subtype of adjectives
                 self.check_required_features(node, ['VerbForm', 'Voice'])
@@ -130,6 +134,7 @@ def process_node(self, node):
                             'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                             'Polarity': ['Pos', 'Neg'],
                             'Variant': ['Short'],
+                            'Emph': ['Yes'],
                             'Foreign': ['Yes']})
                     else:
                         self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Tense', 'Gender', 'Number', 'Case', 'Polarity'])
@@ -143,6 +148,7 @@ def process_node(self, node):
                             'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                             'Polarity': ['Pos', 'Neg'],
                             'Variant': ['Short'],
+                            'Emph': ['Yes'],
                             'Foreign': ['Yes']})
                 else:
                     if node.feats['Gender'] == 'Masc':
@@ -158,6 +164,7 @@ def process_node(self, node):
                             'Polarity': ['Pos', 'Neg'],
                             'Degree': ['Pos', 'Cmp', 'Sup'],
                             'Variant': ['Short'],
+                            'Emph': ['Yes'],
                             'Foreign': ['Yes']})
                     else:
                         self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Number', 'Case', 'Polarity', 'Degree'])
@@ -171,6 +178,7 @@ def process_node(self, node):
                             'Polarity': ['Pos', 'Neg'],
                             'Degree': ['Pos', 'Cmp', 'Sup'],
                             'Variant': ['Short'],
+                            'Emph': ['Yes'],
                             'Foreign': ['Yes']})
             else: # regular adjectives, including short forms
                 if node.feats['Gender'] == 'Masc':
@@ -183,6 +191,7 @@ def process_node(self, node):
                         'Degree': ['Pos', 'Cmp', 'Sup'],
                         'Polarity': ['Pos', 'Neg'],
                         'Variant': ['Short'],
+                        'Emph': ['Yes'],
                         'Foreign': ['Yes']})
                 else:
                     self.check_required_features(node, ['Gender', 'Number', 'Case', 'Degree', 'Polarity'])
@@ -193,6 +202,7 @@ def process_node(self, node):
                         'Degree': ['Pos', 'Cmp', 'Sup'],
                         'Polarity': ['Pos', 'Neg'],
                         'Variant': ['Short'],
+                        'Emph': ['Yes'],
                         'Foreign': ['Yes']})
         # PRONOUNS #############################################################
         elif node.upos == 'PRON':
@@ -729,7 +739,7 @@ def check_adjective_like(self, node, r0, a0):
         caller in parameters r0 (list) and a0 (dict).
         """
         required_features = []
-        allowed_featurs = {}
+        allowed_features = {}
         full_set = node.upos == 'ADJ' or not self.pdt20
         if full_set:
             # Even in the full set, animacy is only distinguished for the

From 5fb020d9939d6b26f411d74bd8a6999df9d56126 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 13 Oct 2024 10:08:43 +0200
Subject: [PATCH 1093/1374] =?UTF-8?q?Czech=20MWTs=20"na=C5=88,=20o=C5=88,?=
 =?UTF-8?q?=20pro=C5=88,=20za=C5=88".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/addmwt.py | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index bc688f8c..e613166f 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -33,10 +33,10 @@
     v['main'] = 0
     v['shape'] = 'siblings'
 
-# Define static rules for 'nač', 'zač', 'oč' (but not 'proč').
+# Define static rules for 'nač', 'oč', 'zač' (but not 'proč').
 # Add them to the already existing dictionary MWTS.
 # nač -> na + co
-for prep in 'na za o'.split():
+for prep in 'na o za'.split():
     MWTS[prep + 'č'] = {
         'form': prep + ' co',
         'lemma': prep + ' co',
@@ -48,6 +48,21 @@
         'shape': 'subtree',
     }
 
+# Define static rules for 'naň', 'oň', 'proň', 'zaň'.
+# Add them to the already existing dictionary MWTS.
+# naň -> na + něj
+for prep in 'na o pro za'.split():
+    MWTS[prep + 'ň'] = {
+        'form': prep + ' něj',
+        'lemma': prep + ' on',
+        'upos': 'ADP PRON',
+        'xpos': 'RR--4---------- PEZS4--3-------',
+        'feats': 'AdpType=Prep|Case=Acc Case=Acc|Gender=Masc,Neut|Number=Sing|Person=3|PrepCase=Pre|PronType=Prs',
+        'deprel': 'case *',
+        'main': 1,
+        'shape': 'subtree',
+    }
+
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
     """Detect and mark MWTs (split them into words and add the words to the tree)."""
 

From 36aeed1defb26746f3e8fb35c2cd904947710ad1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 13 Oct 2024 10:27:11 +0200
Subject: [PATCH 1094/1374] =?UTF-8?q?"p=C5=99=C4=9Bde=C5=88"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/addmwt.py | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index e613166f..b46edc25 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -1,5 +1,6 @@
 """Block ud.cs.AddMwt for heuristic detection of multi-word tokens."""
 import udapi.block.ud.addmwt
+import re
 import logging
 
 # Define static rules for 'aby', 'kdyby' and similar forms.
@@ -62,6 +63,19 @@
         'main': 1,
         'shape': 'subtree',
     }
+# Additional contractions in Old Czech with vocalization.
+for prep in 'přěd'.split():
+    preplemma = re.sub(r"ě", r"e", prep)
+    MWTS[prep + 'eň'] = {
+        'form': prep + ' něj',
+        'lemma': preplemma + ' on',
+        'upos': 'ADP PRON',
+        'xpos': 'RV--4---------- PEZS4--3-------',
+        'feats': 'AdpType=Voc|Case=Acc Case=Acc|Gender=Masc,Neut|Number=Sing|Person=3|PrepCase=Pre|PronType=Prs',
+        'deprel': 'case *',
+        'main': 1,
+        'shape': 'subtree',
+    }
 
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
     """Detect and mark MWTs (split them into words and add the words to the tree)."""

From e30ed9022293946f880b655ab1895c09606bc5fc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 13 Oct 2024 11:20:26 +0200
Subject: [PATCH 1095/1374] A new block to copy Bug attributes from MWT to its
 nodes.

---
 udapi/block/ud/markfeatsbugs.py        |  2 --
 udapi/block/util/markmwtbugsatnodes.py | 25 +++++++++++++++++++++++++
 2 files changed, 25 insertions(+), 2 deletions(-)
 create mode 100644 udapi/block/util/markmwtbugsatnodes.py

diff --git a/udapi/block/ud/markfeatsbugs.py b/udapi/block/ud/markfeatsbugs.py
index 1bb8188b..26c5624d 100644
--- a/udapi/block/ud/markfeatsbugs.py
+++ b/udapi/block/ud/markfeatsbugs.py
@@ -8,8 +8,6 @@
 Usage (Czech example): cat *.conllu | udapy -HAMX layout=compact ud.cs.MarkFeatsBugs > bugs.html
 """
 from udapi.core.block import Block
-import logging
-import re
 
 class MarkFeatsBugs(Block):
 
diff --git a/udapi/block/util/markmwtbugsatnodes.py b/udapi/block/util/markmwtbugsatnodes.py
new file mode 100644
index 00000000..ebc2ef4e
--- /dev/null
+++ b/udapi/block/util/markmwtbugsatnodes.py
@@ -0,0 +1,25 @@
+"""util.MarkMwtBugsAtNodes copies Bug attributes from MISC of multiword tokens to MISC of member nodes.
+   Otherwise they will be ignored when write.TextModeTrees marked_only=1 is called."""
+
+from udapi.core.block import Block
+
+class MarkMwtBugsAtNodes(Block):
+    """
+    If a node belongs to a multiword token and the MWT has Bug in MISC, copy
+    the Bug to the node so that filtering trees with bugs works.
+    The same bug note will be copied to all nodes in the MWT.
+    """
+
+    ###!!! Do we want to do the same thing also with ToDo attributes?
+    def bug(self, node, bugstring):
+        bugs = []
+        if node.misc['Bug']:
+            bugs = node.misc['Bug'].split('+')
+        if not bugstring in bugs:
+            bugs.append(bugstring)
+        node.misc['Bug'] = '+'.join(bugs)
+
+    def process_node(self, node):
+        if node.multiword_token:
+            if node.multiword_token.misc['Bug']:
+                self.bug(node, node.multiword_token.misc['Bug'])

From 9e68b89e8df54413a49aee2b3cec810aebbf504e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 13 Oct 2024 12:03:28 +0200
Subject: [PATCH 1096/1374] =?UTF-8?q?Czech=20MWTs=20"na=C5=88=C5=BE,=20o?=
 =?UTF-8?q?=C5=88=C5=BE,=20pro=C5=88=C5=BE,=20za=C5=88=C5=BE".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/addmwt.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index b46edc25..3414f88d 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -77,6 +77,21 @@
         'shape': 'subtree',
     }
 
+# Define static rules for 'naňž', 'oňž', 'proňž', 'zaňž'.
+# Add them to the already existing dictionary MWTS.
+# naňž -> na + nějž
+for prep in 'na o pro za'.split():
+    MWTS[prep + 'ňž'] = {
+        'form': prep + ' nějž',
+        'lemma': prep + ' jenž',
+        'upos': 'ADP PRON',
+        'xpos': 'RR--4---------- P4ZS4---------2',
+        'feats': 'AdpType=Prep|Case=Acc Case=Acc|Gender=Masc,Neut|Number=Sing|PrepCase=Pre|PronType=Rel',
+        'deprel': 'case *',
+        'main': 1,
+        'shape': 'subtree',
+    }
+
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
     """Detect and mark MWTs (split them into words and add the words to the tree)."""
 

From f747fa0b81803fa30939b104e25b693f095278c1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 14 Oct 2024 09:45:07 +0200
Subject: [PATCH 1097/1374] =?UTF-8?q?"Skirz=C4=9B=C5=88=C5=BE"=20et=20al.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/addmwt.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 3414f88d..a189b162 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -76,6 +76,17 @@
         'main': 1,
         'shape': 'subtree',
     }
+for prep in 'skirzě skrzě skrze'.split():
+    MWTS[prep + 'ň'] = {
+        'form': prep + ' něj',
+        'lemma': 'skrz on',
+        'upos': 'ADP PRON',
+        'xpos': 'RV--4---------- PEZS4--3-------',
+        'feats': 'AdpType=Voc|Case=Acc Case=Acc|Gender=Masc,Neut|Number=Sing|Person=3|PrepCase=Pre|PronType=Prs',
+        'deprel': 'case *',
+        'main': 1,
+        'shape': 'subtree',
+    }
 
 # Define static rules for 'naňž', 'oňž', 'proňž', 'zaňž'.
 # Add them to the already existing dictionary MWTS.
@@ -91,6 +102,18 @@
         'main': 1,
         'shape': 'subtree',
     }
+# Additional contractions in Old Czech with vocalization.
+for prep in 'skirzě skrzě skrze'.split():
+    MWTS[prep + 'ňž'] = {
+        'form': prep + ' nějž',
+        'lemma': 'skrz jenž',
+        'upos': 'ADP PRON',
+        'xpos': 'RV--4---------- P4ZS4---------2',
+        'feats': 'AdpType=Voc|Case=Acc Case=Acc|Gender=Masc,Neut|Number=Sing|PrepCase=Pre|PronType=Rel',
+        'deprel': 'case *',
+        'main': 1,
+        'shape': 'subtree',
+    }
 
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
     """Detect and mark MWTs (split them into words and add the words to the tree)."""

From 660f6e052fb10b6eafeb049ae2adb2dd7e0ce60b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 14 Oct 2024 10:54:59 +0200
Subject: [PATCH 1098/1374] corefud.Stats report_basics=1

---
 udapi/block/corefud/stats.py | 44 ++++++++++++++++++++++++++++++------
 1 file changed, 37 insertions(+), 7 deletions(-)

diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
index e05815a6..5368cabc 100644
--- a/udapi/block/corefud/stats.py
+++ b/udapi/block/corefud/stats.py
@@ -4,13 +4,16 @@
 class Stats(Block):
     """Block corefud.Stats prints various coreference-related statistics."""
 
-    def __init__(self, m_len_max=5, e_len_max=5, report_mentions=True, report_entities=True,
-                 report_details=True, selected_upos='NOUN PRON PROPN DET ADJ VERB ADV NUM',
+    def __init__(self, m_len_max=5, e_len_max=5,
+                 report_basics=False, report_mentions=True, report_entities=True,
+                 report_details=True, selected_upos='NOUN PRON PROPN DET ADJ VERB ADV NUM _',
                  exclude_singletons=False, exclude_nonsingletons=False, style='human',
-                 per_doc=False, max_rows_per_page=50, **kwargs):
+                 per_doc=False, max_rows_per_page=50, docname='newdoc', docname_len=15,
+                 **kwargs):
         super().__init__(**kwargs)
         self.m_len_max = m_len_max
         self.e_len_max = e_len_max
+        self.report_basics = report_basics
         self.report_mentions = report_mentions
         self.report_entities = report_entities
         self.report_details = report_details
@@ -21,6 +24,10 @@ def __init__(self, m_len_max=5, e_len_max=5, report_mentions=True, report_entiti
             raise ValueError(f'Unknown style {style}')
         self.per_doc = per_doc
         self.max_rows_per_page = max_rows_per_page
+        if docname not in 'newdoc filename'.split():
+            raise ValueError(f'Unknown style {style}')
+        self.docname = docname
+        self.docname_len = docname_len
         self._header_printed = False
         self._lines_printed = None
 
@@ -75,6 +82,12 @@ def process_document(self, doc):
                             heads += 0 if any(d['parent'] in mwords for d in w.deps) else 1
                     self.counter['m_nontreelet'] += 1 if heads > 1 else 0
 
+        if self.report_basics:
+            for tree in doc.trees:
+                self.counter['newdocs'] += 1 if tree.newdoc else 0
+                self.counter['sents'] += 1
+                self.counter['words'] += len(tree.descendants)
+                self.counter['empty'] += len(tree.empty_nodes)
 
     def after_process_document(self, doc):
         if self.per_doc:
@@ -97,7 +110,8 @@ def process_end(self, skip=True, doc=None):
                 self.print_footer()
                 return
             else:
-                print(f"{doc[0].trees[0].newdoc:15}", end='&' if self.style.startswith('tex') else '\n')
+                docname = doc.meta['loaded_from'] if self.docname == 'filename' else doc[0].trees[0].newdoc
+                print(f"{docname:{self.docname_len}}", end='&' if self.style.startswith('tex') else '\n')
         elif self.style.startswith('tex-'):
             print(f"{self.counter['documents']:4} documents &")
         self._lines_printed += 1
@@ -107,6 +121,11 @@ def process_end(self, skip=True, doc=None):
         total_nodes_nonzero = 1 if self.total_nodes == 0 else self.total_nodes
 
         columns =[ ]
+        if self.report_basics:
+            columns += [('docs', f"{self.counter['newdocs']:7,}"),
+                        ('sents', f"{self.counter['sents']:7,}"),
+                        ('words', f"{self.counter['words']:7,}"),
+                        ('empty', f"{self.counter['empty']:7,}"),]
         if self.report_entities:
             columns += [('entities', f"{self.entities:7,}"),
                         ('entities_per1k', f"{1000 * self.entities / total_nodes_nonzero:6.0f}"),
@@ -156,7 +175,15 @@ def print_header(self):
                 print(r'\title{Udapi coreference statistics}')
                 print(r'\begin{document}')
         print(r'\def\MC#1#2{\multicolumn{#1}{c}{#2}}')
-        lines = [r'\begin{mypage}\begin{tabular}{@{}l ', " "*15, ("document" if self.per_doc else "dataset ") + " "*7, " "*15]
+        lines = [r'\begin{mypage}\begin{tabular}{@{}l ',
+                 " " * self.docname_len,
+                 ("document" if self.per_doc else "dataset ") + " " * (self.docname_len-8),
+                 " " * self.docname_len]
+        if self.report_basics:
+            lines[0] += "rrrr "
+            lines[1] += r'& \MC{4}{total number of}              '
+            lines[2] += r'&        &         &         &         '
+            lines[3] += r'&   docs &   sents &   words & empty n.'
         if self.report_entities:
             lines[0] += "rrrr "
             lines[1] += r'& \MC{4}{entities}                 '
@@ -199,10 +226,13 @@ def print_header(self):
         lines[1] += r'\\'
         lines[2] += r'\\'
         lines[3] += r'\\\midrule'
-        if self.report_entities:
+        if self.report_basics:
             last_col += 4
             lines[1] += r'\cmidrule(lr){2-5}'
-            lines[2] += r'\cmidrule(lr){4-5}'
+        if self.report_entities:
+            lines[1] += r'\cmidrule(lr){' + f"{last_col+1}-{last_col+4}" + '}'
+            lines[2] += r'\cmidrule(lr){' + f"{last_col+3}-{last_col+4}" + '}'
+            last_col += 4
             if self.e_len_max:
                 last_col += self.e_len_max
                 lines[1] += r'\cmidrule(lr){6-' + str(last_col) + '}'

From e679de0ea2ff46e9da88420aaf6c51ba0c0c4051 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 14 Oct 2024 11:21:40 +0200
Subject: [PATCH 1099/1374] udpipe.En online=1 ranges=1

Use ranges=1, so that each token will contain `node.misc[TokenRange]`
with character level 0-based ranges, e.g. `0:2` for the first token
with two characters.
---
 udapi/block/udpipe/base.py | 7 ++++---
 udapi/tool/udpipe.py       | 4 +++-
 udapi/tool/udpipeonline.py | 5 ++++-
 3 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
index d94f8cc5..50d33883 100644
--- a/udapi/block/udpipe/base.py
+++ b/udapi/block/udpipe/base.py
@@ -121,13 +121,13 @@ class Base(Block):
     # pylint: disable=too-many-arguments
     def __init__(self, model=None, model_alias=None, online=False,
                  tokenize=True, tag=True, parse=True, resegment=False,
-                 delete_nodes=False, **kwargs):
+                 ranges=False, delete_nodes=False, **kwargs):
         """Create the udpipe.En block object."""
         super().__init__(**kwargs)
         self.model, self.model_alias, self.online = model, model_alias, online
         self._tool = None
         self.tokenize, self.tag, self.parse, self.resegment = tokenize, tag, parse, resegment
-        self.delete_nodes = delete_nodes
+        self.ranges, self.delete_nodes = ranges, delete_nodes
 
     @property
     def tool(self):
@@ -160,7 +160,8 @@ def process_document(self, doc):
                             subroot.remove()
                     if tok:
                         new_trees = self.tool.tokenize_tag_parse_tree(tree, resegment=reseg,
-                                                                      tag=tag, parse=par)
+                                                                      tag=tag, parse=par,
+                                                                      ranges=self.ranges)
                         if self.resegment and len(new_trees) > 1:
                             orig_bundle_id = bundle.bundle_id
                             bundle.bundle_id = orig_bundle_id + '-1'
diff --git a/udapi/tool/udpipe.py b/udapi/tool/udpipe.py
index f96fafdf..5d4a4d9c 100644
--- a/udapi/tool/udpipe.py
+++ b/udapi/tool/udpipe.py
@@ -47,11 +47,13 @@ def tag_parse_tree(self, root):
         # pylint: disable=protected-access
         #root._children, root._descendants = parsed_root._children, parsed_root._descendants
 
-    def tokenize_tag_parse_tree(self, root, resegment=False, tag=True, parse=True):
+    def tokenize_tag_parse_tree(self, root, resegment=False, tag=True, parse=True, ranges=False):
         """Tokenize, tag (+lemmatize, fill FEATS) and parse the text stored in `root.text`.
 
         If resegment=True, the returned list of Udapi trees may contain multiple trees.
         """
+        if ranges:
+            raise ValueError('ranges=True is implemented only in the REST API version (add "online=1" to the udpipe block)')
         if root.children:
             raise ValueError('Tree already contained nodes before tokenization')
 
diff --git a/udapi/tool/udpipeonline.py b/udapi/tool/udpipeonline.py
index 26f31a73..2a57cbe7 100644
--- a/udapi/tool/udpipeonline.py
+++ b/udapi/tool/udpipeonline.py
@@ -92,10 +92,11 @@ def tag_parse_tree(self, root, tag=True, parse=True):
             for attr in attrs:
                 setattr(node, attr, getattr(parsed_node, attr))
 
-    def tokenize_tag_parse_tree(self, root, resegment=False, tag=True, parse=True):
+    def tokenize_tag_parse_tree(self, root, resegment=False, tag=True, parse=True, ranges=False):
         """Tokenize, tag (+lemmatize, fill FEATS) and parse the text stored in `root.text`.
 
         If resegment=True, the returned list of Udapi trees may contain multiple trees.
+        If ranges=True, each token will contain `node.misc[TokenRange]` will contain character level 0-based ranges, e.g. `0:2`.
         """
         if parse and not tag:
             raise ValueError('Combination parse=True tag=False is not allowed.')
@@ -108,6 +109,8 @@ def tokenize_tag_parse_tree(self, root, resegment=False, tag=True, parse=True):
             params["tagger"] = ""
         if parse:
             params["parser"] = ""
+        if ranges:
+            params["tokenizer"] = "presegmented,ranges" if resegment else "ranges"
         out_data = self.perform_request(params=params)
         conllu_reader = ConlluReader(empty_parent="ignore")
         conllu_reader.files.filehandle = io.StringIO(out_data)

From 5eba832ea60e370ac151438f0a2a5b501fa2380c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 14 Oct 2024 14:58:38 +0200
Subject: [PATCH 1100/1374] Modified rules for Degree and Polarity of Czech
 adverbs.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

From now on, both Degree and Polarity are required (even if Pos is the only possible value) for most adverbs, unless other features will exclude it. The exceptions are pronominal adverbs (except totals, "vždy-nevždy") and adverbial numerals.
---
 udapi/block/ud/cs/markfeatsbugs.py | 61 +++++++++++++++++++++---------
 1 file changed, 43 insertions(+), 18 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 490b53d8..2bfae385 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -689,30 +689,55 @@ def process_node(self, node):
                 # belong here. They have also pronominal counterparts (kolikrát,
                 # tolikrát, několikrát). There are also adverbial ordinal numerals
                 # (zaprvé, poprvé, zadruhé, podruhé).
-                # Old Czech data disambiguate Int from Rel (Int is used only in direct questions with; indirect questions like "Ptal ses, kde to je?" use Rel.)
+                # Old Czech data disambiguate Int from Rel (Int is used only in direct questions with question mark; indirect questions like "Ptal ses, kde to je?" use Rel.)
                 # New Czech data, in particular PDT, use Int,Rel regardless of context.
                 self.check_allowed_features(node, {
                     'NumType': ['Mult', 'Ord'],
                     'PronType': ['Dem', 'Int', 'Rel', 'Int,Rel', 'Ind']
                 })
-            elif node.feats['PronType'] != '':
-                # Pronominal adverbs are neither compared nor negated.
-                # Old Czech data disambiguate Int from Rel (Int is used only in direct questions with; indirect questions like "Ptal ses, kde to je?" use Rel.)
-                # New Czech data, in particular PDT, use Int,Rel regardless of context.
-                self.check_allowed_features(node, {
-                    'PronType': ['Dem', 'Int', 'Rel', 'Int,Rel', 'Ind', 'Neg', 'Tot']
-                })
-            elif node.feats['Degree'] != '':
-                # Adverbs that are compared can also be negated.
-                self.check_required_features(node, ['Degree', 'Polarity'])
-                self.check_allowed_features(node, {
-                    'Degree': ['Pos', 'Cmp', 'Sup'],
-                    'Polarity': ['Pos', 'Neg']
-                })
+            elif self.pdt20:
+                if node.feats['PronType'] != '':
+                    # Pronominal adverbs in PDT are neither compared nor negated.
+                    # New Czech data, in particular PDT, use Int,Rel regardless of context.
+                    self.check_allowed_features(node, {
+                        'PronType': ['Dem', 'Int,Rel', 'Ind', 'Neg', 'Tot']
+                    })
+                elif node.feats['Degree'] != '':
+                    # Adverbs that are compared can also be negated.
+                    self.check_required_features(node, ['Degree', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Degree': ['Pos', 'Cmp', 'Sup'],
+                        'Polarity': ['Pos', 'Neg']
+                    })
+                else:
+                    # The remaining adverbs are neither pronominal, nor compared or
+                    # negated.
+                    self.check_allowed_features(node, {})
             else:
-                # The remaining adverbs are neither pronominal, nor compared or
-                # negated.
-                self.check_allowed_features(node, {})
+                if node.feats['PronType'] == 'Tot':
+                    # Total adverbs in Old Czech can be negated: vždy, nevždy.
+                    # Then for consistence with other adverbs, we also require
+                    # Degree, although it will be always Pos.
+                    self.check_required_features(node, ['Degree', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Tot'],
+                        'Degree': ['Pos'],
+                        'Polarity': ['Pos', 'Neg']
+                    })
+                elif node.feats['PronType'] != '':
+                    # Other pronominal adverbs are neither compared nor negated.
+                    # Old Czech data disambiguate Int from Rel (Int is used only in direct questions with question mark; indirect questions like "Ptal ses, kde to je?" use Rel.)
+                    self.check_allowed_features(node, {
+                        'PronType': ['Dem', 'Int', 'Rel', 'Ind', 'Neg']
+                    })
+                else:
+                    # All other adverbs should have both Degree and Polarity,
+                    # although for some of them the values will always be Pos.
+                    self.check_required_features(node, ['Degree', 'Polarity'])
+                    self.check_allowed_features(node, {
+                        'Degree': ['Pos', 'Cmp', 'Sup'],
+                        'Polarity': ['Pos', 'Neg']
+                    })
         # ADPOSITIONS ##########################################################
         elif node.upos == 'ADP':
             self.check_required_features(node, ['AdpType', 'Case'])

From 21a54b31a9ee58701eb668a74b84b751e256b5af Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 14 Oct 2024 17:20:15 +0200
Subject: [PATCH 1101/1374] Do not generate ambiguous Gender=Masc,Neut.

---
 udapi/block/ud/cs/addmwt.py | 116 ++++++++++++++++--------------------
 1 file changed, 52 insertions(+), 64 deletions(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index a189b162..2dd12fca 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -49,71 +49,7 @@
         'shape': 'subtree',
     }
 
-# Define static rules for 'naň', 'oň', 'proň', 'zaň'.
-# Add them to the already existing dictionary MWTS.
-# naň -> na + něj
-for prep in 'na o pro za'.split():
-    MWTS[prep + 'ň'] = {
-        'form': prep + ' něj',
-        'lemma': prep + ' on',
-        'upos': 'ADP PRON',
-        'xpos': 'RR--4---------- PEZS4--3-------',
-        'feats': 'AdpType=Prep|Case=Acc Case=Acc|Gender=Masc,Neut|Number=Sing|Person=3|PrepCase=Pre|PronType=Prs',
-        'deprel': 'case *',
-        'main': 1,
-        'shape': 'subtree',
-    }
-# Additional contractions in Old Czech with vocalization.
-for prep in 'přěd'.split():
-    preplemma = re.sub(r"ě", r"e", prep)
-    MWTS[prep + 'eň'] = {
-        'form': prep + ' něj',
-        'lemma': preplemma + ' on',
-        'upos': 'ADP PRON',
-        'xpos': 'RV--4---------- PEZS4--3-------',
-        'feats': 'AdpType=Voc|Case=Acc Case=Acc|Gender=Masc,Neut|Number=Sing|Person=3|PrepCase=Pre|PronType=Prs',
-        'deprel': 'case *',
-        'main': 1,
-        'shape': 'subtree',
-    }
-for prep in 'skirzě skrzě skrze'.split():
-    MWTS[prep + 'ň'] = {
-        'form': prep + ' něj',
-        'lemma': 'skrz on',
-        'upos': 'ADP PRON',
-        'xpos': 'RV--4---------- PEZS4--3-------',
-        'feats': 'AdpType=Voc|Case=Acc Case=Acc|Gender=Masc,Neut|Number=Sing|Person=3|PrepCase=Pre|PronType=Prs',
-        'deprel': 'case *',
-        'main': 1,
-        'shape': 'subtree',
-    }
 
-# Define static rules for 'naňž', 'oňž', 'proňž', 'zaňž'.
-# Add them to the already existing dictionary MWTS.
-# naňž -> na + nějž
-for prep in 'na o pro za'.split():
-    MWTS[prep + 'ňž'] = {
-        'form': prep + ' nějž',
-        'lemma': prep + ' jenž',
-        'upos': 'ADP PRON',
-        'xpos': 'RR--4---------- P4ZS4---------2',
-        'feats': 'AdpType=Prep|Case=Acc Case=Acc|Gender=Masc,Neut|Number=Sing|PrepCase=Pre|PronType=Rel',
-        'deprel': 'case *',
-        'main': 1,
-        'shape': 'subtree',
-    }
-# Additional contractions in Old Czech with vocalization.
-for prep in 'skirzě skrzě skrze'.split():
-    MWTS[prep + 'ňž'] = {
-        'form': prep + ' nějž',
-        'lemma': 'skrz jenž',
-        'upos': 'ADP PRON',
-        'xpos': 'RV--4---------- P4ZS4---------2',
-        'feats': 'AdpType=Voc|Case=Acc Case=Acc|Gender=Masc,Neut|Number=Sing|PrepCase=Pre|PronType=Rel',
-        'deprel': 'case *',
-        'main': 1,
-        'shape': 'subtree',
-    }
 
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
     """Detect and mark MWTs (split them into words and add the words to the tree)."""
@@ -164,6 +100,58 @@ def multiword_analysis(self, node):
                     'main':   0,
                     'shape':  'subtree',
                 }
+        # Contractions of prepositions and pronouns will be processed regardless
+        # of AddMwt instructions by the annotator. These rules are dynamic because
+        # the pronoun could be masculine or neuter. We pick Gender=Masc by default,
+        # unless the original token was annotated as Gender=Neut.
+        m = re.match(r"^(na|o|pro|přěde|ski?rz[eě]|za)ň(ž?)$", node.form.lower())
+        if m:
+            # Remove vocalization from 'přěde' (přěd něj) but keep it in 'skrze'
+            # (skrze něj).
+            if m.group(1) == 'přěde':
+                pform = 'přěd'
+                plemma = 'před'
+                adptype = 'Voc'
+                at = 'V'
+            elif re.match(r"^ski?rz[eě]$", m.group(1).lower()):
+                pform = m.group(1)
+                plemma = 'skrz'
+                adptype = 'Voc'
+                at = 'V'
+            else:
+                pform = m.group(1)
+                plemma = m.group(1)
+                adptype = 'Prep'
+                at = 'R'
+            # In UD PDT, Gender=Masc,Neut, and in PDT it is PEZS4--3.
+            if node.feats['Gender'] == 'Neut':
+                gender = 'Neut'
+                g = 'N'
+            else:
+                gender = 'Masc'
+                g = 'Y' # standing for 'M' or 'I'
+            if m.group(2).lower() == 'ž':
+                return {
+                    'form': pform + ' nějž',
+                    'lemma': plemma + ' jenž',
+                    'upos': 'ADP PRON',
+                    'xpos': 'R'+at+'--4---------- P4'+g+'S4---------2',
+                    'feats': 'AdpType='+adptype+'|Case=Acc Case=Acc|Gender='+gender+'|Number=Sing|PrepCase=Pre|PronType=Rel',
+                    'deprel': 'case *',
+                    'main': 1,
+                    'shape': 'subtree',
+                }
+            else:
+                return {
+                    'form': pform + ' něj',
+                    'lemma': plemma + ' on',
+                    'upos': 'ADP PRON',
+                    'xpos': 'R'+at+'--4---------- PE'+g+'S4--3-------',
+                    'feats': 'AdpType='+adptype+'|Case=Acc Case=Acc|Gender='+gender+'|Number=Sing|Person=3|PrepCase=Pre|PronType=Prs',
+                    'deprel': 'case *',
+                    'main': 1,
+                    'shape': 'subtree',
+                }
         return None
 
     def postprocess_mwt(self, mwt):

From d56c258e868b51c1912e9c41da4d365a79a92e9e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 14 Oct 2024 17:26:25 +0200
Subject: [PATCH 1102/1374] Survive non-concatenative AddMwt in MISC.

---
 udapi/block/ud/cs/addmwt.py | 80 +++++++++++++++++++------------------
 1 file changed, 42 insertions(+), 38 deletions(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 2dd12fca..70f6c01e 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -62,50 +62,16 @@ def multiword_analysis(self, node):
         analysis = MWTS.get(node.form.lower(), None)
         if analysis is not None:
             return analysis
-        # If the node did not match any of the static rules defined in MWTS,
-        # check it against the "dynamic" rules below. The enclitic 'ť' will be
-        # separated from its host but only if it has been marked by an annotator
-        # in MISC. (These are annotation conventions used for Old Czech in the
-        # Hičkok project.)
-        if node.misc['AddMwt'] != '':
-            subtokens = node.misc['AddMwt'].split()
-            if len(subtokens) != 2:
-                logging.warning("MISC 'AddMwt=%s' has unexpected number of subtokens." % node.misc['AddMwt'])
-                return None
-            token_from_subtokens = ''.join(subtokens)
-            if token_from_subtokens != node.form:
-                logging.warning("Concatenation of MISC 'AddMwt=%s' does not yield the FORM '%s'." % (node.misc['AddMwt'], node.form))
-                return None
-            if subtokens[1] == 's':
-                node.misc['AddMwt'] = ''
-                return {
-                    'form':   subtokens[0] + ' jsi',
-                    'lemma':  '* být',
-                    'upos':   '* AUX',
-                    'xpos':   '* VB-S---2P-AAI--',
-                    'feats':  '* Aspect=Imp|Mood=Ind|Number=Sing|Person=2|Polarity=Pos|Tense=Pres|VerbForm=Fin|Voice=Act',
-                    'deprel': '* aux',
-                    'main':   0,
-                    'shape':  'subtree' if node.upos in ['VERB'] else 'siblings',
-                }
-            if subtokens[1] == 'ť':
-                node.misc['AddMwt'] = ''
-                return {
-                    'form':   node.form.lower()[:-1] + ' ť',
-                    'lemma':  '* ť',
-                    'upos':   '* PART',
-                    'xpos':   '* TT-------------',
-                    'feats':  '* _',
-                    'deprel': '* discourse',
-                    'main':   0,
-                    'shape':  'subtree',
-                }
         # Contractions of prepositions and pronouns will be processed regardless
         # of AddMwt instructions by the annotator. These rules are dynamic because
         # the pronoun could be masculine or neuter. We pick Gender=Masc by default,
         # unless the original token was annotated as Gender=Neut.
+        # Note that we do this before looking at AddMwt in MISC because the code
+        # below that looks there will require that the parts can be concatenated,
+        # and that does not work for pronouns (skirzě + nějž != skirzěňž).
         m = re.match(r"^(na|o|pro|přěde|ski?rz[eě]|za)ň(ž?)$", node.form.lower())
         if m:
+            node.misc['AddMwt'] = ''
             # Remove vocalization from 'přěde' (přěd něj) but keep it in 'skrze'
             # (skrze něj).
             if m.group(1) == 'přěde':
@@ -152,6 +118,44 @@ def multiword_analysis(self, node):
                     'main': 1,
                     'shape': 'subtree',
                 }
+        # If the node did not match any of the static rules defined in MWTS,
+        # check it against the "dynamic" rules below. The enclitic 'ť' will be
+        # separated from its host but only if it has been marked by an annotator
+        # in MISC. (These are annotation conventions used for Old Czech in the
+        # Hičkok project.)
+        if node.misc['AddMwt'] != '':
+            subtokens = node.misc['AddMwt'].split()
+            if len(subtokens) != 2:
+                logging.warning("MISC 'AddMwt=%s' has unexpected number of subtokens." % node.misc['AddMwt'])
+                return None
+            token_from_subtokens = ''.join(subtokens)
+            if token_from_subtokens != node.form:
+                logging.warning("Concatenation of MISC 'AddMwt=%s' does not yield the FORM '%s'." % (node.misc['AddMwt'], node.form))
+                return None
+            if subtokens[1] == 's':
+                node.misc['AddMwt'] = ''
+                return {
+                    'form':   subtokens[0] + ' jsi',
+                    'lemma':  '* být',
+                    'upos':   '* AUX',
+                    'xpos':   '* VB-S---2P-AAI--',
+                    'feats':  '* Aspect=Imp|Mood=Ind|Number=Sing|Person=2|Polarity=Pos|Tense=Pres|VerbForm=Fin|Voice=Act',
+                    'deprel': '* aux',
+                    'main':   0,
+                    'shape':  'subtree' if node.upos in ['VERB'] else 'siblings',
+                }
+            if subtokens[1] == 'ť':
+                node.misc['AddMwt'] = ''
+                return {
+                    'form':   node.form.lower()[:-1] + ' ť',
+                    'lemma':  '* ť',
+                    'upos':   '* PART',
+                    'xpos':   '* TT-------------',
+                    'feats':  '* _',
+                    'deprel': '* discourse',
+                    'main':   0,
+                    'shape':  'subtree',
+                }
         return None
 
     def postprocess_mwt(self, mwt):

From 93ea438002bba28decb2348f5376409bf5f3a390 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 14 Oct 2024 17:36:00 +0200
Subject: [PATCH 1103/1374] Gender=Masc implies non-empty Animacy.

---
 udapi/block/ud/cs/addmwt.py | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 70f6c01e..7e7e0fcc 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -64,8 +64,9 @@ def multiword_analysis(self, node):
             return analysis
         # Contractions of prepositions and pronouns will be processed regardless
         # of AddMwt instructions by the annotator. These rules are dynamic because
-        # the pronoun could be masculine or neuter. We pick Gender=Masc by default,
-        # unless the original token was annotated as Gender=Neut.
+        # the pronoun could be masculine or neuter. We pick Gender=Masc and
+        # Animacy=Anim by default, unless the original token was annotated as
+        # Animacy=Inan or Gender=Neut.
         # Note that we do this before looking at AddMwt in MISC because the code
         # below that looks there will require that the parts can be concatenated,
         # and that does not work for pronouns (skirzě + nějž != skirzěňž).
@@ -89,20 +90,26 @@ def multiword_analysis(self, node):
                 plemma = m.group(1)
                 adptype = 'Prep'
                 at = 'R'
-            # In UD PDT, Gender=Masc,Neut, and in PDT it is PEZS4--3.
+            # In UD PDT, Gender=Masc,Neut, and in PDT it is PEZS4--3 / P4ZS4---.
             if node.feats['Gender'] == 'Neut':
                 gender = 'Neut'
+                animacy = ''
                 g = 'N'
+            elif node.feats['Animacy'] == 'Inan':
+                gender = 'Masc'
+                animacy = 'Animacy=Inan|'
+                g = 'I'
             else:
                 gender = 'Masc'
-                g = 'Y' # standing for 'M' or 'I'
+                animacy = 'Animacy=Anim|'
+                g = 'M'
             if m.group(2).lower() == 'ž':
                 return {
                     'form': pform + ' nějž',
                     'lemma': plemma + ' jenž',
                     'upos': 'ADP PRON',
                     'xpos': 'R'+at+'--4---------- P4'+g+'S4---------2',
-                    'feats': 'AdpType='+adptype+'|Case=Acc Case=Acc|Gender='+gender+'|Number=Sing|PrepCase=Pre|PronType=Rel',
+                    'feats': 'AdpType='+adptype+'|Case=Acc '+animacy+'Case=Acc|Gender='+gender+'|Number=Sing|PrepCase=Pre|PronType=Rel',
                     'deprel': 'case *',
                     'main': 1,
                     'shape': 'subtree',
@@ -113,7 +120,7 @@ def multiword_analysis(self, node):
                     'lemma': plemma + ' on',
                     'upos': 'ADP PRON',
                     'xpos': 'R'+at+'--4---------- PE'+g+'S4--3-------',
-                    'feats': 'AdpType='+adptype+'|Case=Acc Case=Acc|Gender='+gender+'|Number=Sing|Person=3|PrepCase=Pre|PronType=Prs',
+                    'feats': 'AdpType='+adptype+'|Case=Acc '+animacy+'Case=Acc|Gender='+gender+'|Number=Sing|Person=3|PrepCase=Pre|PronType=Prs',
                     'deprel': 'case *',
                     'main': 1,
                     'shape': 'subtree',

From e3b4aac6bf5da1629e36b8af8dcbfcae343f6447 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 14 Oct 2024 17:50:42 +0200
Subject: [PATCH 1104/1374] udpipe.En online=1 now parses the whole document
 with a single REST request

Thus the TokenRange is valid for the whole document
---
 udapi/block/udpipe/base.py |  9 +++++----
 udapi/tool/udpipeonline.py | 41 +++++++++++++++++++++++++++++++++++++-
 2 files changed, 45 insertions(+), 5 deletions(-)

diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
index 50d33883..069fc9fb 100644
--- a/udapi/block/udpipe/base.py
+++ b/udapi/block/udpipe/base.py
@@ -122,7 +122,6 @@ class Base(Block):
     def __init__(self, model=None, model_alias=None, online=False,
                  tokenize=True, tag=True, parse=True, resegment=False,
                  ranges=False, delete_nodes=False, **kwargs):
-        """Create the udpipe.En block object."""
         super().__init__(**kwargs)
         self.model, self.model_alias, self.online = model, model_alias, online
         self._tool = None
@@ -148,7 +147,10 @@ def tool(self):
         return self._tool
 
     def process_document(self, doc):
-        tok, tag, par, reseg = self.tokenize, self.tag, self.parse, self.resegment
+        tok, tag, par, reseg, ranges = self.tokenize, self.tag, self.parse, self.resegment, self.ranges
+        if self.zones == "all" and self.online:
+            self.tool.process_document(doc, tok, tag, par, reseg, ranges)
+            return
         old_bundles = doc.bundles
         new_bundles = []
         for bundle in old_bundles:
@@ -160,8 +162,7 @@ def process_document(self, doc):
                             subroot.remove()
                     if tok:
                         new_trees = self.tool.tokenize_tag_parse_tree(tree, resegment=reseg,
-                                                                      tag=tag, parse=par,
-                                                                      ranges=self.ranges)
+                                                                      tag=tag, parse=par, ranges=ranges)
                         if self.resegment and len(new_trees) > 1:
                             orig_bundle_id = bundle.bundle_id
                             bundle.bundle_id = orig_bundle_id + '-1'
diff --git a/udapi/tool/udpipeonline.py b/udapi/tool/udpipeonline.py
index 2a57cbe7..23971f53 100644
--- a/udapi/tool/udpipeonline.py
+++ b/udapi/tool/udpipeonline.py
@@ -110,7 +110,7 @@ def tokenize_tag_parse_tree(self, root, resegment=False, tag=True, parse=True, r
         if parse:
             params["parser"] = ""
         if ranges:
-            params["tokenizer"] = "presegmented,ranges" if resegment else "ranges"
+            params["tokenizer"] = "presegmented;ranges" if resegment else "ranges"
         out_data = self.perform_request(params=params)
         conllu_reader = ConlluReader(empty_parent="ignore")
         conllu_reader.files.filehandle = io.StringIO(out_data)
@@ -130,3 +130,42 @@ def segment_text(self, text):
         """Segment the provided text into sentences returned as a Python list."""
         params = {"model": self.model, "data": text, "tokenizer":"", "output": "plaintext=normalized_spaces"}
         return self.perform_request(params=params).rstrip().split("\n")
+
+    def process_document(self, doc, tokenize=True, tag=True, parse=True, resegment=False, ranges=False):
+        """Delete all existing bundles and substitute them with those parsed by UDPipe."""
+        if parse and not tag:
+            raise ValueError('Combination parse=True tag=False is not allowed.')
+        params = {"model": self.model, "tokenizer": "presegmented"}
+        if tag:
+            params["tagger"] = ""
+        if parse:
+            params["parser"] = ""
+        if resegment:
+            params["tokenizer"] = ""
+        if ranges:
+            params["tokenizer"] = "ranges" if resegment else "presegmented;ranges"
+
+        #in_trees = []
+        #for bundle in doc.bundles:
+        #    assert(len(bundle.trees) == 1)
+        #    in_trees.append(bundle.trees[0])
+        if tokenize:
+            params["data"] = "\n".join(root.text for root in doc.trees)
+        else:
+            params["input"] = "horizontal"
+            params["data"] = "\n".join(" ".join([n.form for n in root.descendants]) for root in doc.trees)
+
+        out_data = self.perform_request(params=params)
+        conllu_reader = ConlluReader(empty_parent="ignore")
+        conllu_reader.files.filehandle = io.StringIO(out_data)
+        trees = conllu_reader.read_trees()
+
+        bundles = list(reversed(doc.bundles))
+        for tree in trees:
+            if bundles:
+                bundle = bundles.pop()
+                # TODO is this safe?
+                bundle.trees = []
+            else:
+                bundle = doc.create_bundle()
+            bundle.add_tree(tree)

From 1cd6c19e85e287fe8320e5254218f301713bc6cc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 14 Oct 2024 22:26:43 +0200
Subject: [PATCH 1105/1374] Gradable and negatable quantifiers in Czech.

---
 udapi/block/ud/cs/markfeatsbugs.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 2bfae385..9c7f3dae 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -485,11 +485,16 @@ def process_node(self, node):
                 if node.lemma == 'nejeden':
                     self.check_adjective_like(node, ['PronType', 'NumType'], {'PronType': ['Ind'], 'NumType': ['Card']})
                 else:
+                    # Lemmas 'hodně' and 'málo' have Degree even if used as quantifiers and not adverbs:
+                    # hodně, více, nejvíce; málo, méně, nejméně
+                    # Lemmas 'mnoho' and 'málo' can be negated (nemnoho, nemálo).
                     self.check_required_features(node, ['PronType', 'NumType', 'Case'])
                     self.check_allowed_features(node, {
                         'PronType': ['Ind', 'Int', 'Rel', 'Dem'],
                         'NumType': ['Card'],
-                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Degree': ['Pos', 'Cmp', 'Sup'],
+                        'Polarity': ['Pos', 'Neg']
                     })
             else:
                 # Old Czech data disambiguate Int from Rel (Int is used only in direct questions with; indirect questions like "Ptal ses, kde to je?" use Rel.)

From 90e2980d01cc5c4409270d258b8155517ac15411 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 14 Oct 2024 22:38:57 +0200
Subject: [PATCH 1106/1374] =?UTF-8?q?Czech=20"p=C5=AFl"=20has=20no=20Case?=
 =?UTF-8?q?=20and=20no=20Number.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 9c7f3dae..01d20148 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -514,6 +514,7 @@ def process_node(self, node):
                 # 'dva', 'oba' have Gender, Number=Dual(Plur in modern Czech), Case: dva, dvě, dvou, dvěma.
                 # 'tři', 'čtyři' have Number=Plur, Case: tři, třech, třem, třemi.
                 # 'pět' and more have Number=Plur, Case: pět, pěti.
+                # 'půl' has no Number and Case, although it behaves syntactically similarly to 'pět' (but genitive is still 'půl', not '*půli').
                 if node.lemma == 'jeden':
                     self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
                     self.check_allowed_features(node, {
@@ -545,6 +546,12 @@ def process_node(self, node):
                             'Number': ['Dual', 'Plur'],
                             'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                         })
+                elif node.lemma == 'půl':
+                    self.check_required_features(node, ['NumType', 'NumForm'])
+                    self.check_allowed_features(node, {
+                        'NumType': ['Card'],
+                        'NumForm': ['Word']
+                    })
                 else:
                     # In PDT, cardinal numerals higher than four in nominative/accusative/vocative
                     # have Number=Sing instead of Plur! It may be motivated by the default

From 7189c5e191294ac474a8cf5f77553381b7fc50d9 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Oct 2024 08:16:38 +0200
Subject: [PATCH 1107/1374] Features of Czech pronouns "ho", "mu".

---
 udapi/block/ud/cs/markfeatsbugs.py | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 01d20148..91fe8b1b 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -223,19 +223,18 @@ def process_node(self, node):
                                 'PronType': ['Prs'],
                                 'Person': ['3']
                             })
-                        elif node.feats['Variant'] == 'Short': # ho, mu
-                            # The short (clitic) forms do not have PrepCase in Modern Czech
-                            # but Old Czech has also 'jmu' (besides 'jemu' and 'mu'), which
-                            # is also annotated as Variant=Short and PrepCase=Npr.
-                            self.check_adjective_like(node, ['PronType', 'Person'], {
+                        elif re.match(r"^(ho|mu)$", node.form.lower()):
+                            # The short (clitic) forms do not have PrepCase in Modern Czech.
+                            # Old Czech has also 'jmu' (besides 'jemu' and 'mu'); it should
+                            # not have Variant=Short and it should have PrepCase=Npr (the next block).
+                            self.check_adjective_like(node, ['PronType', 'Person', 'Variant'], {
                                 'PronType': ['Prs'],
                                 'Person': ['3'],
-                                'PrepCase': ['Npr'],
                                 'Variant': ['Short']
                             })
                         else: # jeho, něho, jemu, němu, jej, něj, něm, jím, ním, jí, ní, ji, ni, je, ně
                             # Mostly only two gender groups and no animacy:
-                            # Masc,Neut ... jeho, jemu, jej, něm, jím
+                            # Masc,Neut ... jeho, jemu, jmu, jej, něm, jím
                             # Fem ... jí, ji, ní
                             # Neut ... je
                             # No gender in dual and plural:

From 89017411c2022f19d88324ff04d1a43bfdc757b5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Oct 2024 08:58:43 +0200
Subject: [PATCH 1108/1374] Trying to survive node.upos == None.

re.match() cannot digest it.
---
 udapi/block/ud/cs/markfeatsbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 91fe8b1b..d17c1b35 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -565,7 +565,7 @@ def process_node(self, node):
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
         # VERBS AND AUXILIARIES ################################################
-        elif re.match(r'^(VERB|AUX)$', node.upos):
+        elif node.upos in ['VERB', 'AUX']:
             # All Czech verbs (and some adjectives and nouns) must have VerbForm.
             # Almost all verbs have lexical Aspect but we cannot require it
             # because there are a few biaspectual verbs (e.g. 'analyzovat') that

From 41f6c0f15abd283cbc19c2ea6aeb27b3b5faec20 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Oct 2024 09:01:19 +0200
Subject: [PATCH 1109/1374] Trying to survive node.upos == None.

re.match() cannot digest it.
---
 udapi/block/ud/cs/markfeatsbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index d17c1b35..f8f4024c 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -759,7 +759,7 @@ def process_node(self, node):
         # THE REST: NO FEATURES ################################################
         # (OR UNDEFINED UPOS) ##################################################
         else:
-            if not re.match(r"^(CCONJ|SCONJ|PART|INTJ|PUNCT|SYM|X)$", node.upos):
+            if not node.upos in ['CCONJ', 'SCONJ', 'PART', 'INTJ', 'PUNCT', 'SYM', 'X']:
                 self.bug(node, 'UnknownUpos' + node.upos)
             self.check_allowed_features(node, {})
 

From f46633fce0eb23cb09a6c7b7bfe2c8ac2ebb5035 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Oct 2024 09:04:46 +0200
Subject: [PATCH 1110/1374] Trying to survive node.upos == None.

---
 udapi/block/ud/cs/markfeatsbugs.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index f8f4024c..a0379d36 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -760,7 +760,10 @@ def process_node(self, node):
         # (OR UNDEFINED UPOS) ##################################################
         else:
             if not node.upos in ['CCONJ', 'SCONJ', 'PART', 'INTJ', 'PUNCT', 'SYM', 'X']:
-                self.bug(node, 'UnknownUpos' + node.upos)
+                bugmsg = 'UnknownUpos'
+                if node.upos:
+                    bugmsg += node.upos
+                self.bug(node, bugmsg)
             self.check_allowed_features(node, {})
 
     def check_adjective_like(self, node, r0, a0):

From f52a355ef1e3246116dbff90ac7a8dd8a180b56c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Oct 2024 09:10:22 +0200
Subject: [PATCH 1111/1374] Allow NameType=Nat.

---
 udapi/block/ud/cs/markfeatsbugs.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index a0379d36..985b0cc8 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -63,14 +63,14 @@ def process_node(self, node):
                     'Animacy': ['Anim', 'Inan'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'NameType': ['Giv', 'Sur', 'Geo'],
+                    'NameType': ['Giv', 'Sur', 'Geo', 'Nat'],
                     'Foreign': ['Yes']})
             else:
                 self.check_allowed_features(node, {
                     'Gender': ['Masc', 'Fem', 'Neut'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'NameType': ['Giv', 'Sur', 'Geo'],
+                    'NameType': ['Giv', 'Sur', 'Geo', 'Nat'],
                     'Foreign': ['Yes']})
         # ADJECTIVES ###########################################################
         elif node.upos == 'ADJ':
@@ -84,7 +84,7 @@ def process_node(self, node):
                         'Animacy': ['Anim', 'Inan'],
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                        'NameType': ['Giv', 'Sur'], # for possessive adjectives derived from personal names
+                        'NameType': ['Giv', 'Sur', 'Nat'], # for possessive adjectives derived from personal names
                         'Emph': ['Yes'],
                         'Foreign': ['Yes']})
                 else:
@@ -95,7 +95,7 @@ def process_node(self, node):
                         'Gender': ['Masc', 'Fem', 'Neut'],
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                        'NameType': ['Giv', 'Sur'], # for possessive adjectives derived from personal names
+                        'NameType': ['Giv', 'Sur', 'Nat'], # for possessive adjectives derived from personal names
                         'Emph': ['Yes'],
                         'Foreign': ['Yes']})
             elif node.feats['NumType'] == 'Ord' or node.feats['NumType'] == 'Mult': # ordinal numerals are a subtype of adjectives; same for some multiplicative numerals (dvojí, trojí)

From 485ae6351d3ac4b722e7178add071b4fde11190d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 15 Oct 2024 11:10:44 +0200
Subject: [PATCH 1112/1374] both Node and MWT classes should have
 x.no_space_after and x.is_mwt()

---
 udapi/core/mwt.py  | 14 ++++++++++++++
 udapi/core/node.py |  8 ++++++++
 2 files changed, 22 insertions(+)

diff --git a/udapi/core/mwt.py b/udapi/core/mwt.py
index 684adfaf..3cc95cac 100644
--- a/udapi/core/mwt.py
+++ b/udapi/core/mwt.py
@@ -47,6 +47,20 @@ def address(self):
         """Full (document-wide) id of the multi-word token."""
         return self.root.address + '#' + self.ord_range
 
+    @staticmethod
+    def is_mwt():
+        """Is this a multi-word token?
+
+        Returns always True.
+        False is returned only by instances of the Node class.
+        """
+        return True
+
+    @property
+    def no_space_after(self):
+        """Boolean property as a shortcut for `node.misc["SpaceAfter"] == "No"`."""
+        return self.misc["SpaceAfter"] == "No"
+
 # TODO: node.remove() should check if the node is not part of any MWT
 # TODO: Document that editing words by mwt.words.append(node), del or remove(node) is not supported
 # TODO: Make mwt._words private and provide a setter
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 0e746c60..a543678a 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -1004,6 +1004,14 @@ def create_coref_entity(self, eid=None, etype=None, **kwargs):
         entity.create_mention(head=self, **kwargs)
         return entity
 
+    @staticmethod
+    def is_mwt():
+        """Is this a multi-word token?
+
+        Returns False for all Node instances.
+        True is returned only by instances of the MWT class.
+        """
+        return False
 
 class CycleError(Exception):
     '''A cycle in the dependency tree detected (or would be created).'''

From e6c5d1ba9ca475e97e4d4194906d0edf0779be8a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Oct 2024 12:41:38 +0200
Subject: [PATCH 1113/1374] Old Czech determiner "jho".

---
 udapi/block/ud/cs/markfeatsbugs.py | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 985b0cc8..b9ba4cdb 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -225,8 +225,9 @@ def process_node(self, node):
                             })
                         elif re.match(r"^(ho|mu)$", node.form.lower()):
                             # The short (clitic) forms do not have PrepCase in Modern Czech.
-                            # Old Czech has also 'jmu' (besides 'jemu' and 'mu'); it should
-                            # not have Variant=Short and it should have PrepCase=Npr (the next block).
+                            # Old Czech has also 'jmu' (besides 'jemu' and 'mu') and 'jho'
+                            # (besides 'jeho' and 'ho'); it should not have Variant=Short
+                            # and it should have PrepCase=Npr (the next block).
                             self.check_adjective_like(node, ['PronType', 'Person', 'Variant'], {
                                 'PronType': ['Prs'],
                                 'Person': ['3'],
@@ -234,7 +235,7 @@ def process_node(self, node):
                             })
                         else: # jeho, něho, jemu, němu, jej, něj, něm, jím, ním, jí, ní, ji, ni, je, ně
                             # Mostly only two gender groups and no animacy:
-                            # Masc,Neut ... jeho, jemu, jmu, jej, něm, jím
+                            # Masc,Neut ... jeho, jho, jemu, jmu, jej, něm, jím
                             # Fem ... jí, ji, ní
                             # Neut ... je
                             # No gender in dual and plural:
@@ -336,7 +337,7 @@ def process_node(self, node):
         elif node.upos == 'DET':
             # Possessive determiners 'jeho' and 'jejich' (formerly 'jich') do not inflect, i.e., no Gender, Number, Case.
             # Note that the possessive determiner 'její' (formerly 'jejie') does inflect, although it also has the lemma 'jeho'.
-            if re.match(r'^(jeho|jejich|jich)$', node.form.lower()):
+            if re.match(r'^(je?ho|jejich|jich)$', node.form.lower()):
                 self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]'])
                 self.check_allowed_features(node, {
                     'PronType': ['Prs'],

From 4df8bdf78e2026e7628ce3312885ccdc76f80e16 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Oct 2024 17:25:37 +0200
Subject: [PATCH 1114/1374] =?UTF-8?q?Updated=20rules=20for=20the=20Czech?=
 =?UTF-8?q?=20pronouns=20"jen=C5=BE",=20"jen=C5=BEto",=20"je=C5=A1to".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 25 +++++++++++++++++++++----
 1 file changed, 21 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index b9ba4cdb..8d5ea022 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -289,6 +289,9 @@ def process_node(self, node):
                 # Unlike 'jenžto', this relative pronoun does not inflect, it
                 # always occurs in a nominative position, but the context can
                 # be any gender and number.
+                # Update from the Hičkok project: 'ješto' is lemmatized to
+                # 'jenžto' (see below), meaning that this branch should not be
+                # needed for the new data.
                 self.check_required_features(node, ['PronType', 'Case'])
                 self.check_allowed_features(node, {
                     'PronType': ['Rel'],
@@ -307,10 +310,24 @@ def process_node(self, node):
                 # Unlike 'on', 'jenž' has the feature PrepCase everywhere, even
                 # in the nominative, although there is no prepositional counter-
                 # part (but similarly the locative has no prepositionless form).
-                self.check_adjective_like(node, ['PronType', 'PrepCase'], {
-                    'PronType': ['Rel'],
-                    'PrepCase': ['Npr', 'Pre']
-                })
+                # Update from the Hičkok project: In Old Czech, both 'jenž' and
+                # 'jenžto' (or its variant 'ješto') can be used uninflected,
+                # accompanied by a resumptive pronoun which provides the inflection.
+                # In this case, the Hičkok data will not annotate Gender, Animacy,
+                # Number and Case of the relative pronoun. Therefore, we require
+                # the full set of features if any of them is present; otherwise,
+                # we only expect PronType and PrepCase.
+                if node.feats['Gender'] != '' or node.feats['Animacy'] != '' or node.feats['Number'] != '' or node.feats['Case'] != '':
+                    self.check_adjective_like(node, ['PronType', 'PrepCase'], {
+                        'PronType': ['Rel'],
+                        'PrepCase': ['Npr', 'Pre']
+                    })
+                else:
+                    self.check_required_features(node, ['PronType', 'PrepCase'])
+                    self.check_allowed_features(node, {
+                        'PronType': ['Rel'],
+                        'PrepCase': ['Npr']
+                    })
             else:
                 # What remains is the relative pronoun 'an'. It behaves similarly
                 # to 'jenž' but it does not have the PrepCase feature and it

From d9c43c2069b0ad23287566e9349df3afc7571e74 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 16 Oct 2024 11:00:58 +0200
Subject: [PATCH 1115/1374] New block to join two neighboring tokens without a
 space between them.

---
 tutorial/udapi-tutorial-dz.odt   | Bin 185047 -> 201247 bytes
 tutorial/udapi-tutorial-dz.pdf   | Bin 236726 -> 334412 bytes
 udapi/block/ud/jointoken.py      |  97 +++++++++++++++++++++++++++++++
 udapi/block/util/joinsentence.py |   2 +-
 4 files changed, 98 insertions(+), 1 deletion(-)
 create mode 100644 udapi/block/ud/jointoken.py

diff --git a/tutorial/udapi-tutorial-dz.odt b/tutorial/udapi-tutorial-dz.odt
index b3e8e9f0937e431c9a2e3a6cf3c38730ff104673..aba91234a8f850276b647e58bfb7810fc6d422be 100644
GIT binary patch
delta 60441
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

delta 44131
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
JW3MF+_<!e1T9g0)

diff --git a/tutorial/udapi-tutorial-dz.pdf b/tutorial/udapi-tutorial-dz.pdf
index 851983fe8b176cea88bb33c62b39bfc68ec3e4bf..54b5f8d127fc025590b8f611683b1fd6ad5fb545 100644
GIT binary patch
literal 334412
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%0D&d!dT{UZ
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%0A8m
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
V!#aeuGm$D^W<US=7k_w@{U7R;Z`S|-

delta 175019
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%0D&$1%DstC?PbjjcPx~{dVhC
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
YF2=W94m)xv42Hy@NO*Z=Rpm(jKR0;**8l(j

diff --git a/udapi/block/ud/jointoken.py b/udapi/block/ud/jointoken.py
new file mode 100644
index 00000000..43d2b30d
--- /dev/null
+++ b/udapi/block/ud/jointoken.py
@@ -0,0 +1,97 @@
+"""
+Block ud.JoinToken will join a given token with the preceding one.
+"""
+from udapi.core.block import Block
+import logging
+
+
+class JoinToken(Block):
+    """
+    Merge two tokens into one. A MISC attribute is used to mark the tokens that
+    should join the preceding token. (The attribute may have been set by an
+    annotator or by a previous block that tests the specific conditions under
+    which joining is desired.) Joining cannot be done across sentence
+    boundaries; if necessary, apply util.JoinSentence first. Multiword tokens
+    are currently not supported: None of the nodes to be merged can belong to
+    a MWT. (The block ud.JoinAsMwt may be of some help, but it works differently.)
+    Merging is simple if there is no space between the tokens (see SpaceAfter=No
+    at the first token). If there is a space, there are three options in theory:
+        
+        1. Keep the tokens as two nodes but apply the UD goeswith relation
+           (see https://universaldependencies.org/u/overview/typos.html) and
+           the related annotation rules.
+        2. Join them into one token that contains a space. Such "words with
+           spaces" can be exceptionally allowed in UD if they are registered
+           in the given language.
+        3. Remove the space without any trace. Not recommended in UD unless the
+           underlying text was created directly for UD and can be thus considered
+           part of the annotation.
+    
+    At present, this block does not support merging with spaces at all, but
+    in the future one or more of the options may be added.
+    """
+
+    def __init__(self, misc_name='JoinToken', misc_value=None, **kwargs):
+        """
+        Args:
+        misc_name: name of the MISC attribute that can trigger the joining
+            default: JoinToken
+        misc_value: value of the MISC attribute to trigger the joining;
+            if not specified, then simple occurrence of the attribute with any value will cause the joining
+            MISC attributes that have triggered sentence joining will be removed from their node.
+        """
+        super().__init__(**kwargs)
+        self.misc_name = misc_name
+        self.misc_value = misc_value
+
+    def process_node(self, node):
+        """
+        The JoinToken (or equivalent) attribute in MISC will trigger action.
+        Either the current node will be merged with the previous node and the
+        attribute will be removed from MISC, or a warning will be issued that
+        the merging cannot be done and the attribute will stay in MISC. Note
+        that multiword token lines and empty nodes are not even scanned for
+        the attribute, so if it is there, it will stay there but no warning
+        will be printed.
+        """
+        if node.misc[self.misc_name] == '':
+            return
+        if self.misc_value and node.misc[self.misc_name] != self.misc_value:
+            return
+        prevnode = node.prev_node
+        if not prevnode:
+            logging.warning("MISC %s cannot be used at the first token of a sentence." % self.misc_name)
+            node.misc['Bug'] = 'JoiningTokenNotSupportedHere'
+            return
+        if node.multiword_token or prevnode.multiword_token:
+            logging.warning("MISC %s cannot be used if one of the nodes belongs to a multiword token." % self.misc_name)
+            node.misc['Bug'] = 'JoiningTokenNotSupportedHere'
+            return
+        if prevnode.misc['SpaceAfter'] != 'No':
+            logging.warning("MISC %s cannot be used if there is space between the tokens." % self.misc_name)
+            node.misc['Bug'] = 'JoiningTokensWithSpaceNotSupported'
+            return
+        ###!!! This block currently must not be applied on data containing
+        ###!!! enhanced dependencies. We must first implement adjustments of
+        ###!!! the enhanced structure.
+        if prevnode.deps or node.deps:
+            logging.fatal('At present this block cannot be applied to data with enhanced dependencies.')
+        # If the first token depends on the second token, re-attach it to the
+        # second token's parent to prevent cycles.
+        if prevnode in node.descendants:
+            prevnode.parent = node.parent
+            prevnode.deprel = node.deprel
+        # Re-attach all children of the second token to the first token.
+        for c in node.children:
+            c.parent = prevnode
+        # Concatenate the word forms of the two tokens. Assume that morphological
+        # annotation, including the lemma, is already updated accordingly (we
+        # cannot guess it anyway).
+        prevnode.form += node.form
+        # Remove SpaceAfter=No from the first token unless the second token has
+        # this attribute, too (meaning that there is no space between the second
+        # token and whatever comes next).
+        prevnode.misc['SpaceAfter'] = node.misc['SpaceAfter']
+        # Remove the current node. The joining instruction was in its MISC, so
+        # it will disappear together with the node.
+        node.remove()
diff --git a/udapi/block/util/joinsentence.py b/udapi/block/util/joinsentence.py
index e52f0e8e..d83ba1c3 100644
--- a/udapi/block/util/joinsentence.py
+++ b/udapi/block/util/joinsentence.py
@@ -1,5 +1,5 @@
 """
-Block util.SplitSentence will split a given sentence at a given token.
+Block util.JoinSentence will join a given sentence with the preceding one.
 """
 import logging
 from udapi.core.block import Block

From 92b4b81b6d83e3421248998ca576bb3b026b5315 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 16 Oct 2024 12:51:34 +0200
Subject: [PATCH 1116/1374] More UPOS-DEPREL fixes.

---
 udapi/block/ud/fixadvmodbyupos.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index b232e185..b34446ba 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -46,3 +46,8 @@ def process_node(self, node):
                 node.deprel = 'nmod'
             elif node.upos == 'ADJ':
                 node.deprel = 'amod'
+            elif node.upos == 'ADV':
+                node.deprel = 'advmod'
+        elif node.udeprel == 'nummod':
+            if node.upos == 'DET':
+                node.deprel = 'det'

From ef742109c5ea6116427aeaefc56ca3116be2d480 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 16 Oct 2024 13:25:53 +0200
Subject: [PATCH 1117/1374] More UPOS-DEPREL fixes.

---
 udapi/block/ud/fixadvmodbyupos.py | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index b34446ba..047e9bd3 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -38,9 +38,15 @@ def process_node(self, node):
                 node.deprel = 'case'
             elif node.upos == 'CCONJ':
                 node.deprel = 'cc'
+        elif node.udeprel in ['aux', 'cop']:
+            if node.upos != 'AUX':
+                node.deprel = 'dep'
         elif node.udeprel == 'mark':
-            if node.upos == 'PRON':
+            if node.upos in ['PRON', 'DET']:
                 node.deprel = 'nsubj' # it could be also obj, iobj, obl or nmod; just guessing what might be more probable
+        elif node.udeprel == 'cc':
+            if node.upos == 'AUX':
+                node.deprel = 'aux'
         elif node.udeprel == 'det':
             if node.upos == 'NOUN':
                 node.deprel = 'nmod'
@@ -51,3 +57,6 @@ def process_node(self, node):
         elif node.udeprel == 'nummod':
             if node.upos == 'DET':
                 node.deprel = 'det'
+        elif node.udeprel == 'punct':
+            if node.upos != 'PUNCT':
+                node.deprel = 'dep'

From 8670eb4708e390e7e8509916334c2495e5726f99 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 16 Oct 2024 13:37:00 +0200
Subject: [PATCH 1118/1374] More UPOS-DEPREL fixes.

---
 udapi/block/ud/fixadvmodbyupos.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index 047e9bd3..d026f4fc 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -54,6 +54,8 @@ def process_node(self, node):
                 node.deprel = 'amod'
             elif node.upos == 'ADV':
                 node.deprel = 'advmod'
+            elif node.upos == 'X':
+                node.deprel = 'dep'
         elif node.udeprel == 'nummod':
             if node.upos == 'DET':
                 node.deprel = 'det'

From fdb82086efd7451c7206216c3149b9962eed18e7 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 16 Oct 2024 13:38:48 +0200
Subject: [PATCH 1119/1374] More UPOS-DEPREL fixes.

---
 udapi/block/ud/fixadvmodbyupos.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index d026f4fc..d5969624 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -41,6 +41,9 @@ def process_node(self, node):
         elif node.udeprel in ['aux', 'cop']:
             if node.upos != 'AUX':
                 node.deprel = 'dep'
+        elif node.udeprel == 'case':
+            if node.upos == 'DET':
+                node.deprel = 'det'
         elif node.udeprel == 'mark':
             if node.upos in ['PRON', 'DET']:
                 node.deprel = 'nsubj' # it could be also obj, iobj, obl or nmod; just guessing what might be more probable

From ff8d302bef64c5c82bc5d9873f11abe57423dc5e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 16 Oct 2024 14:44:54 +0200
Subject: [PATCH 1120/1374] Alternative spellings of the "-s" clitic.

---
 udapi/block/ud/cs/addmwt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 7e7e0fcc..76c5a471 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -139,7 +139,7 @@ def multiword_analysis(self, node):
             if token_from_subtokens != node.form:
                 logging.warning("Concatenation of MISC 'AddMwt=%s' does not yield the FORM '%s'." % (node.misc['AddMwt'], node.form))
                 return None
-            if subtokens[1] == 's':
+            if re.match(r"^j?s’?$", subtokens[1]):
                 node.misc['AddMwt'] = ''
                 return {
                     'form':   subtokens[0] + ' jsi',

From 40347cd9909585a8be3bc63af4fa2e14bd7389ff Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 16 Oct 2024 15:28:26 +0200
Subject: [PATCH 1121/1374] AddMwt subtokens should respect the forms we will
 actually generate.

---
 udapi/block/ud/cs/addmwt.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 76c5a471..63b37416 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -136,9 +136,6 @@ def multiword_analysis(self, node):
                 logging.warning("MISC 'AddMwt=%s' has unexpected number of subtokens." % node.misc['AddMwt'])
                 return None
             token_from_subtokens = ''.join(subtokens)
-            if token_from_subtokens != node.form:
-                logging.warning("Concatenation of MISC 'AddMwt=%s' does not yield the FORM '%s'." % (node.misc['AddMwt'], node.form))
-                return None
             if re.match(r"^j?s’?$", subtokens[1]):
                 node.misc['AddMwt'] = ''
                 return {
@@ -152,6 +149,9 @@ def multiword_analysis(self, node):
                     'shape':  'subtree' if node.upos in ['VERB'] else 'siblings',
                 }
             if subtokens[1] == 'ť':
+                if token_from_subtokens != node.form:
+                    logging.warning("Concatenation of MISC 'AddMwt=%s' does not yield the FORM '%s'." % (node.misc['AddMwt'], node.form))
+                    return None
                 node.misc['AddMwt'] = ''
                 return {
                     'form':   node.form.lower()[:-1] + ' ť',

From 3f612f8ab09d95ee1b6aace6770573baaab275ad Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 16 Oct 2024 15:33:25 +0200
Subject: [PATCH 1122/1374] Bug fix.

---
 udapi/block/ud/cs/addmwt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 63b37416..08af7aee 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -136,7 +136,7 @@ def multiword_analysis(self, node):
                 logging.warning("MISC 'AddMwt=%s' has unexpected number of subtokens." % node.misc['AddMwt'])
                 return None
             token_from_subtokens = ''.join(subtokens)
-            if re.match(r"^j?s’?$", subtokens[1]):
+            if subtokens[1] == 'jsi':
                 node.misc['AddMwt'] = ''
                 return {
                     'form':   subtokens[0] + ' jsi',

From 311b21ca53e0aad1538e017ee8bb2dbde0de03ec Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 16 Oct 2024 15:54:02 +0200
Subject: [PATCH 1123/1374] =?UTF-8?q?Krom=C4=9B=20"p=C5=99=C4=9Bde=C5=88"?=
 =?UTF-8?q?=20se=20vyskytlo=20i=20"p=C5=99=C4=9Bden".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/addmwt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 08af7aee..2be462d2 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -70,7 +70,7 @@ def multiword_analysis(self, node):
         # Note that we do this before looking at AddMwt in MISC because the code
         # below that looks there will require that the parts can be concatenated,
         # and that does not work for pronouns (skirzě + nějž != skirzěňž).
-        m = re.match(r"^(na|o|pro|přěde|ski?rz[eě]|za)ň(ž?)$", node.form.lower())
+        m = re.match(r"^(na|o|pro|přěde|ski?rz[eě]|za)[nň](ž?)$", node.form.lower())
         if m:
             node.misc['AddMwt'] = ''
             # Remove vocalization from 'přěde' (přěd něj) but keep it in 'skrze'

From b2a0081aee843ee07c7cc3a038f683ba522b25eb Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 16 Oct 2024 16:02:22 +0200
Subject: [PATCH 1124/1374] =?UTF-8?q?Splitting=20of=20"p=C5=99=C4=9Bden"?=
 =?UTF-8?q?=20should=20not=20trigger=20splitting=20of=20"on".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/addmwt.py | 126 ++++++++++++++++++------------------
 1 file changed, 63 insertions(+), 63 deletions(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 2be462d2..3cb6169f 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -62,69 +62,6 @@ def multiword_analysis(self, node):
         analysis = MWTS.get(node.form.lower(), None)
         if analysis is not None:
             return analysis
-        # Contractions of prepositions and pronouns will be processed regardless
-        # of AddMwt instructions by the annotator. These rules are dynamic because
-        # the pronoun could be masculine or neuter. We pick Gender=Masc and
-        # Animacy=Anim by default, unless the original token was annotated as
-        # Animacy=Inan or Gender=Neut.
-        # Note that we do this before looking at AddMwt in MISC because the code
-        # below that looks there will require that the parts can be concatenated,
-        # and that does not work for pronouns (skirzě + nějž != skirzěňž).
-        m = re.match(r"^(na|o|pro|přěde|ski?rz[eě]|za)[nň](ž?)$", node.form.lower())
-        if m:
-            node.misc['AddMwt'] = ''
-            # Remove vocalization from 'přěde' (přěd něj) but keep it in 'skrze'
-            # (skrze něj).
-            if m.group(1) == 'přěde':
-                pform = 'přěd'
-                plemma = 'před'
-                adptype = 'Voc'
-                at = 'V'
-            elif re.match(r"^ski?rz[eě]$", m.group(1).lower()):
-                pform = m.group(1)
-                plemma = 'skrz'
-                adptype = 'Voc'
-                at = 'V'
-            else:
-                pform = m.group(1)
-                plemma = m.group(1)
-                adptype = 'Prep'
-                at = 'R'
-            # In UD PDT, Gender=Masc,Neut, and in PDT it is PEZS4--3 / P4ZS4---.
-            if node.feats['Gender'] == 'Neut':
-                gender = 'Neut'
-                animacy = ''
-                g = 'N'
-            elif node.feats['Animacy'] == 'Inan':
-                gender = 'Masc'
-                animacy = 'Animacy=Inan|'
-                g = 'I'
-            else:
-                gender = 'Masc'
-                animacy = 'Animacy=Anim|'
-                g = 'M'
-            if m.group(2).lower() == 'ž':
-                return {
-                    'form': pform + ' nějž',
-                    'lemma': plemma + ' jenž',
-                    'upos': 'ADP PRON',
-                    'xpos': 'R'+at+'--4---------- P4'+g+'S4---------2',
-                    'feats': 'AdpType='+adptype+'|Case=Acc '+animacy+'Case=Acc|Gender='+gender+'|Number=Sing|PrepCase=Pre|PronType=Rel',
-                    'deprel': 'case *',
-                    'main': 1,
-                    'shape': 'subtree',
-                }
-            else:
-                return {
-                    'form': pform + ' něj',
-                    'lemma': plemma + ' on',
-                    'upos': 'ADP PRON',
-                    'xpos': 'R'+at+'--4---------- PE'+g+'S4--3-------',
-                    'feats': 'AdpType='+adptype+'|Case=Acc '+animacy+'Case=Acc|Gender='+gender+'|Number=Sing|Person=3|PrepCase=Pre|PronType=Prs',
-                    'deprel': 'case *',
-                    'main': 1,
-                    'shape': 'subtree',
-                }
         # If the node did not match any of the static rules defined in MWTS,
         # check it against the "dynamic" rules below. The enclitic 'ť' will be
         # separated from its host but only if it has been marked by an annotator
@@ -163,6 +100,69 @@ def multiword_analysis(self, node):
                     'main':   0,
                     'shape':  'subtree',
                 }
+            # Contractions of prepositions and pronouns almost could be processed
+            # regardless of AddMwt instructions by the annotator, but we still
+            # require it to be on the safe side. For example, both 'přědeň' and
+            # 'přěden' are attested in Old Czech but then we do not want to catch
+            # 'on' (besides the wanted 'oň'). Another reason si that the pronoun
+            # could be masculine or neuter. We pick Gender=Masc and Animacy=Anim
+            # by default, unless the original token was annotated as Animacy=Inan
+            # or Gender=Neut.
+            m = re.match(r"^(na|o|pro|přěde|ski?rz[eě]|za)[nň](ž?)$", node.form.lower())
+            if m:
+                node.misc['AddMwt'] = ''
+                # Remove vocalization from 'přěde' (přěd něj) but keep it in 'skrze'
+                # (skrze něj).
+                if m.group(1) == 'přěde':
+                    pform = 'přěd'
+                    plemma = 'před'
+                    adptype = 'Voc'
+                    at = 'V'
+                elif re.match(r"^ski?rz[eě]$", m.group(1).lower()):
+                    pform = m.group(1)
+                    plemma = 'skrz'
+                    adptype = 'Voc'
+                    at = 'V'
+                else:
+                    pform = m.group(1)
+                    plemma = m.group(1)
+                    adptype = 'Prep'
+                    at = 'R'
+                # In UD PDT, Gender=Masc,Neut, and in PDT it is PEZS4--3 / P4ZS4---.
+                if node.feats['Gender'] == 'Neut':
+                    gender = 'Neut'
+                    animacy = ''
+                    g = 'N'
+                elif node.feats['Animacy'] == 'Inan':
+                    gender = 'Masc'
+                    animacy = 'Animacy=Inan|'
+                    g = 'I'
+                else:
+                    gender = 'Masc'
+                    animacy = 'Animacy=Anim|'
+                    g = 'M'
+                if m.group(2).lower() == 'ž':
+                    return {
+                        'form': pform + ' nějž',
+                        'lemma': plemma + ' jenž',
+                        'upos': 'ADP PRON',
+                        'xpos': 'R'+at+'--4---------- P4'+g+'S4---------2',
+                        'feats': 'AdpType='+adptype+'|Case=Acc '+animacy+'Case=Acc|Gender='+gender+'|Number=Sing|PrepCase=Pre|PronType=Rel',
+                        'deprel': 'case *',
+                        'main': 1,
+                        'shape': 'subtree',
+                    }
+                else:
+                    return {
+                        'form': pform + ' něj',
+                        'lemma': plemma + ' on',
+                        'upos': 'ADP PRON',
+                        'xpos': 'R'+at+'--4---------- PE'+g+'S4--3-------',
+                        'feats': 'AdpType='+adptype+'|Case=Acc '+animacy+'Case=Acc|Gender='+gender+'|Number=Sing|Person=3|PrepCase=Pre|PronType=Prs',
+                        'deprel': 'case *',
+                        'main': 1,
+                        'shape': 'subtree',
+                    }
         return None
 
     def postprocess_mwt(self, mwt):

From d6bd83b0b84416ae47ce03f2f4993294fa0b1da3 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 21 Oct 2024 17:17:23 +0200
Subject: [PATCH 1125/1374] UDPipe should not add SpaceAfter=No to the last
 token in a document

because such conllu would not pass the validation by validate.py
---
 udapi/tool/udpipeonline.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/tool/udpipeonline.py b/udapi/tool/udpipeonline.py
index 23971f53..206719f5 100644
--- a/udapi/tool/udpipeonline.py
+++ b/udapi/tool/udpipeonline.py
@@ -150,10 +150,10 @@ def process_document(self, doc, tokenize=True, tag=True, parse=True, resegment=F
         #    assert(len(bundle.trees) == 1)
         #    in_trees.append(bundle.trees[0])
         if tokenize:
-            params["data"] = "\n".join(root.text for root in doc.trees)
+            params["data"] = "\n".join(root.text for root in doc.trees) + "\n"
         else:
             params["input"] = "horizontal"
-            params["data"] = "\n".join(" ".join([n.form for n in root.descendants]) for root in doc.trees)
+            params["data"] = "\n".join(" ".join([n.form for n in root.descendants]) for root in doc.trees) + "\n"
 
         out_data = self.perform_request(params=params)
         conllu_reader = ConlluReader(empty_parent="ignore")

From e7e07bdabe5b5a83527f7e00be55e664785f29b6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 23 Oct 2024 15:30:20 +0200
Subject: [PATCH 1126/1374] util.Normalize sent_id_from_filename=1
 sent_id_reset_at_newdoc=1 newdoc_from_filename=1

---
 udapi/block/util/normalize.py | 28 ++++++++++++++++++++++++----
 1 file changed, 24 insertions(+), 4 deletions(-)

diff --git a/udapi/block/util/normalize.py b/udapi/block/util/normalize.py
index b150d551..4cce4ab8 100644
--- a/udapi/block/util/normalize.py
+++ b/udapi/block/util/normalize.py
@@ -1,9 +1,10 @@
 """util.Normalize normalizes the ordering of various attributes in CoNLL-U."""
 from udapi.core.block import Block
+from pathlib import Path
 
 class Normalize(Block):
     """Normalize the ordering of attributes in the FEATS and MISC columns.
-    
+
     The attribute-value pairs in the FEATS column in CoNLL-U files
     must be sorted alphabetically (case-insensitive) according to the guidelines
     (https://universaldependencies.org/format.html#morphological-annotation).
@@ -20,7 +21,8 @@ class Normalize(Block):
     util.Eval node='node.misc["NonExistentAttribute"] = None'
     """
 
-    def __init__(self, feats=True, misc=True, sent_id=False, empty_node_ord=False, start_sent_id=1, sent_id_prefix="", **kwargs):
+    def __init__(self, feats=True, misc=True, sent_id=False, empty_node_ord=False, start_sent_id=1, sent_id_prefix="",
+                 sent_id_from_filename=False, sent_id_reset_at_newdoc=False, newdoc_from_filename=False, **kwargs):
         """
         Args:
         `feats`: normalize the ordering of FEATS. Default=True.
@@ -29,6 +31,9 @@ def __init__(self, feats=True, misc=True, sent_id=False, empty_node_ord=False, s
         `empty_node_ord`: normalize ord attributes of empty nodes. Default=False.
         `start_sent_id`: the first sent_id number
         `sent_id_prefix`: a string to be prepended before the integer sent_id. Default=empty string.
+        `sent_id_from_filename`: add Path(doc.meta["loaded_from"]).stem before the `sent_id_prefix`. Default=False.
+        `sent_id_reset_at_newdoc`: reset the sent_id counter to 1 for each new document. Default=False.
+        `newdoc_from_filename`: set newdoc to Path(doc.meta["loaded_from"]).stem. Default=False.
         """
         super().__init__(**kwargs)
         self.feats = feats
@@ -37,13 +42,28 @@ def __init__(self, feats=True, misc=True, sent_id=False, empty_node_ord=False, s
         self.empty_node_ord = empty_node_ord
         self.next_sent_id = start_sent_id
         self.sent_id_prefix = sent_id_prefix
-        if sent_id_prefix or start_sent_id != 1:
+        self.sent_id_from_filename = sent_id_from_filename
+        self.sent_id_reset_at_newdoc = sent_id_reset_at_newdoc
+        self.newdoc_from_filename = newdoc_from_filename
+        if sent_id_reset_at_newdoc and not sent_id_from_filename:
+            raise ValueError("Cannot use sent_id_reset_at_newdoc without sent_id_from_filename")
+        if sent_id_prefix or start_sent_id != 1 or sent_id_from_filename:
             self.sent_id = True
+
         # TODO: normalize also the order of standardized comments like text, sent_id,...
 
     def process_bundle(self, bundle):
+        is_newdoc = any(tree.newdoc for tree in bundle.trees)
+        if self.newdoc_from_filename and is_newdoc:
+            tree = next(tree for tree in bundle.trees if tree.newdoc)
+            tree.newdoc = Path(bundle.document.meta["loaded_from"]).stem
         if self.sent_id:
-            bundle.bundle_id = self.sent_id_prefix + str(self.next_sent_id)
+            if self.sent_id_reset_at_newdoc and is_newdoc:
+                self.next_sent_id = 1
+            prefix = self.sent_id_prefix
+            if self.sent_id_from_filename:
+                prefix = Path(bundle.document.meta["loaded_from"]).stem + prefix
+            bundle.bundle_id = prefix + str(self.next_sent_id)
             self.next_sent_id += 1
 
         for tree in bundle:

From 7c8aa2598e287d40221f6a2562a204ee64dd37c5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 23 Oct 2024 17:37:21 +0200
Subject: [PATCH 1127/1374] More fixes.

---
 udapi/block/ud/fixadvmodbyupos.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index d5969624..78cf7561 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -47,9 +47,13 @@ def process_node(self, node):
         elif node.udeprel == 'mark':
             if node.upos in ['PRON', 'DET']:
                 node.deprel = 'nsubj' # it could be also obj, iobj, obl or nmod; just guessing what might be more probable
+            elif node.upos == 'INTJ':
+                node.deprel = 'discourse'
         elif node.udeprel == 'cc':
             if node.upos == 'AUX':
                 node.deprel = 'aux'
+            elif node.upos == 'INTJ':
+                node.deprel = 'discourse'
         elif node.udeprel == 'det':
             if node.upos == 'NOUN':
                 node.deprel = 'nmod'
@@ -57,6 +61,8 @@ def process_node(self, node):
                 node.deprel = 'amod'
             elif node.upos == 'ADV':
                 node.deprel = 'advmod'
+            elif node.upos == 'AUX':
+                node.deprel = 'aux'
             elif node.upos == 'X':
                 node.deprel = 'dep'
         elif node.udeprel == 'nummod':

From be36c70f8ab59fb01626d8485fd6470999be9395 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 23 Oct 2024 17:43:17 +0200
Subject: [PATCH 1128/1374] More fixes.

---
 udapi/block/ud/fixadvmodbyupos.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index 78cf7561..63ab6bea 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -63,6 +63,8 @@ def process_node(self, node):
                 node.deprel = 'advmod'
             elif node.upos == 'AUX':
                 node.deprel = 'aux'
+            elif node.upos == 'VERB':
+                node.deprel = 'dep'
             elif node.upos == 'X':
                 node.deprel = 'dep'
         elif node.udeprel == 'nummod':

From 098711f6a4738eb7f6fc7e09a307b3060e084743 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 23 Oct 2024 17:54:46 +0200
Subject: [PATCH 1129/1374] abychme

---
 udapi/block/ud/cs/addmwt.py | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 3cb6169f..a4f21b5c 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -5,16 +5,19 @@
 
 # Define static rules for 'aby', 'kdyby' and similar forms.
 MWTS = {
-    'abych': {'form': 'aby bych', 'feats': '_ Mood=Cnd|Number=Sing|Person=1|VerbForm=Fin'},
-    'kdybych': {'form': 'když bych', 'feats': '_ Mood=Cnd|Number=Sing|Person=1|VerbForm=Fin'},
-    'abys': {'form': 'aby bys', 'feats': '_ Mood=Cnd|Number=Sing|Person=2|VerbForm=Fin'},
-    'kdybys': {'form': 'když bys', 'feats': '_ Mood=Cnd|Number=Sing|Person=2|VerbForm=Fin'},
-    'aby': {'form': 'aby by', 'feats': '_ Mood=Cnd|VerbForm=Fin'},
-    'kdyby': {'form': 'když by', 'feats': '_ Mood=Cnd|VerbForm=Fin'},
-    'abychom': {'form': 'aby bychom', 'feats': '_ Mood=Cnd|Number=Plur|Person=1|VerbForm=Fin'},
-    'kdybychom': {'form': 'když bychom', 'feats': '_ Mood=Cnd|Number=Plur|Person=1|VerbForm=Fin'},
-    'abyste': {'form': 'aby byste', 'feats': '_ Mood=Cnd|Number=Plur|Person=2|VerbForm=Fin'},
-    'kdybyste': {'form': 'když byste', 'feats': '_ Mood=Cnd|Number=Plur|Person=2|VerbForm=Fin'},
+    'abych': {'form': 'aby bych', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Sing|Person=1|VerbForm=Fin'},
+    'kdybych': {'form': 'když bych', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Sing|Person=1|VerbForm=Fin'},
+    'abys': {'form': 'aby bys', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Sing|Person=2|VerbForm=Fin'},
+    'kdybys': {'form': 'když bys', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Sing|Person=2|VerbForm=Fin'},
+    'aby': {'form': 'aby by', 'feats': '_ Aspect=Imp|Mood=Cnd|VerbForm=Fin'},
+    'kdyby': {'form': 'když by', 'feats': '_ Aspect=Imp|Mood=Cnd|VerbForm=Fin'},
+    'abychom': {'form': 'aby bychom', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=1|VerbForm=Fin'},
+    'kdybychom': {'form': 'když bychom', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=1|VerbForm=Fin'},
+    # Old Czech 'abychme' == Modern Czech 'abychom'
+    'abychme': {'form': 'aby bychme', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=1|VerbForm=Fin'},
+    'kdybychme': {'form': 'když bychme', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=1|VerbForm=Fin'},
+    'abyste': {'form': 'aby byste', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=2|VerbForm=Fin'},
+    'kdybyste': {'form': 'když byste', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=2|VerbForm=Fin'},
 }
 for v in MWTS.values():
     v['upos'] = 'SCONJ AUX'

From a3145e8c9930e0d076c128e8304b3bfea435dfce Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 23 Oct 2024 22:09:28 +0200
Subject: [PATCH 1130/1374] =?UTF-8?q?"=C4=8D=C3=AD"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 8d5ea022..0ec8cb28 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -476,7 +476,7 @@ def process_node(self, node):
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
-            elif node.feats['Poss'] == 'Yes': # 'můj', 'tvůj', 'svůj'
+            elif re.match(r'^(můj|tvůj|svůj)$', node.lemma):
                 if node.feats['Reflex'] == 'Yes':
                     self.check_adjective_like(node, ['PronType', 'Poss', 'Reflex'], {
                         'PronType': ['Prs'],
@@ -490,6 +490,11 @@ def process_node(self, node):
                         'Person': ['1', '2'],
                         'Number[psor]': ['Sing', 'Plur']
                     })
+            elif node.lemma == 'čí':
+                self.check_adjective_like(node, ['PronType', 'Poss'], {
+                    'PronType': ['Int', 'Rel'],
+                    'Poss': ['Yes']
+                })
             elif re.match(r'^(sám|samý)$', node.lemma):
                 # The above condition looks at both lemma options, although only one lemma is assumed.
                 # However, in New Czech data the one lemma is "samý" while in Old Czech data it is "sám".

From e8f5191cec89f22ae0d4af92d7becf74acbf5635 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 23 Oct 2024 22:29:31 +0200
Subject: [PATCH 1131/1374] =?UTF-8?q?More=20derivatives=20of=20"=C4=8D?=
 =?UTF-8?q?=C3=AD".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 0ec8cb28..0ad0b30f 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -490,9 +490,9 @@ def process_node(self, node):
                         'Person': ['1', '2'],
                         'Number[psor]': ['Sing', 'Plur']
                     })
-            elif node.lemma == 'čí':
+            elif re.match(r'^(ně|lec|ni)?číž?(koliv?)?$', node.lemma):
                 self.check_adjective_like(node, ['PronType', 'Poss'], {
-                    'PronType': ['Int', 'Rel'],
+                    'PronType': ['Int', 'Rel', 'Ind', 'Neg'],
                     'Poss': ['Yes']
                 })
             elif re.match(r'^(sám|samý)$', node.lemma):

From 2efdcdb306e670a3eaaf25749b3d14905d4004b3 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 23 Oct 2024 22:41:24 +0200
Subject: [PATCH 1132/1374] =?UTF-8?q?co=C5=BEkoli,=20j=C3=ADch?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 0ad0b30f..77b76a6e 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -268,7 +268,7 @@ def process_node(self, node):
                     'Animacy': ['Anim'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Loc', 'Ins']
                 })
-            elif re.match(r'^(co|což|něco|lečco|lecco|nic|nicož)$', node.lemma):
+            elif re.match(r'^(co|což|což?koliv?|něco|lečco|lecco|nic|nicož)$', node.lemma):
                 # Although these pronouns behave by default as neuter singular,
                 # no Gender and Number is annotated. However, quite unusually,
                 # there is Animacy=Inan without Gender.
@@ -354,7 +354,7 @@ def process_node(self, node):
         elif node.upos == 'DET':
             # Possessive determiners 'jeho' and 'jejich' (formerly 'jich') do not inflect, i.e., no Gender, Number, Case.
             # Note that the possessive determiner 'její' (formerly 'jejie') does inflect, although it also has the lemma 'jeho'.
-            if re.match(r'^(je?ho|jejich|jich)$', node.form.lower()):
+            if re.match(r'^(je?ho|jejich|j[ií]ch)$', node.form.lower()):
                 self.check_required_features(node, ['PronType', 'Poss', 'Person', 'Number[psor]'])
                 self.check_allowed_features(node, {
                     'PronType': ['Prs'],
@@ -372,7 +372,7 @@ def process_node(self, node):
                 })
             # Relative possessive determiners 'jehož' and 'jejichž' behave similarly
             # to the personal possessive determiners but they do not have Person.
-            elif re.match(r'^(jeho|jejich|jich)ž(e|to)?$', node.form.lower()):
+            elif re.match(r'^(jeho|jejich|j[ií]ch)ž(e|to)?$', node.form.lower()):
                 self.check_required_features(node, ['PronType', 'Poss', 'Number[psor]'])
                 self.check_allowed_features(node, {
                     'PronType': ['Rel'],

From 4f9493c72dd81afedea48a0253a142f810455f90 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 23 Oct 2024 22:59:25 +0200
Subject: [PATCH 1133/1374] More fixes.

---
 udapi/block/ud/fixadvmodbyupos.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index 63ab6bea..5debcd8c 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -68,7 +68,9 @@ def process_node(self, node):
             elif node.upos == 'X':
                 node.deprel = 'dep'
         elif node.udeprel == 'nummod':
-            if node.upos == 'DET':
+            if node.upos == 'PRON':
+                node.deprel = 'nmod'
+            elif node.upos == 'DET':
                 node.deprel = 'det'
         elif node.udeprel == 'punct':
             if node.upos != 'PUNCT':

From 41e915ab717c2269ef47b146b1f9c594f1e7d01e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 31 Oct 2024 13:52:29 +0100
Subject: [PATCH 1134/1374] Run.execute() returns the block instances

---
 udapi/core/run.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/core/run.py b/udapi/core/run.py
index 912c12fc..75d2b935 100644
--- a/udapi/core/run.py
+++ b/udapi/core/run.py
@@ -200,6 +200,9 @@ def execute(self):
         for bname, block in blocks:
             block.process_end()
 
+        # Some users may use the block instances (e.g. to retrieve some variables).
+        return blocks
+
     # TODO: better implementation, included Scen
     def scenario_string(self):
         """Return the scenario string."""

From 79a3817fad6790aa822cbba8dcf3db2776abd531 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 31 Oct 2024 17:12:06 +0100
Subject: [PATCH 1135/1374] allow accessing the F1 score using a property f1

---
 udapi/block/eval/f1.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/udapi/block/eval/f1.py b/udapi/block/eval/f1.py
index ca5510e4..7ed5cd70 100644
--- a/udapi/block/eval/f1.py
+++ b/udapi/block/eval/f1.py
@@ -156,6 +156,13 @@ def process_tree(self, tree):
                 self._pred[x] += 1
                 self._total[x] += 1
 
+    @property
+    def f1(self):
+        pred, gold = self.pred or 1, self.gold or 1  # prevent division by zero
+        precision = self.correct / pred
+        recall = self.correct / gold
+        return 2 * precision * recall / ((precision + recall) or 1)
+
     def process_end(self):
         # Redirect the default filehandle to the file specified by self.files
         self.before_process_document(None)

From 4ec56f736d3c47e26cda36037ac0d113fb4754f0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Petr=20Ka=C5=A1p=C3=A1rek?=
 <115396156+petrkasp@users.noreply.github.com>
Date: Fri, 1 Nov 2024 08:59:42 +0100
Subject: [PATCH 1136/1374] Split the execute method in Run (#125)

---
 udapi/core/run.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/core/run.py b/udapi/core/run.py
index 75d2b935..f0cc976e 100644
--- a/udapi/core/run.py
+++ b/udapi/core/run.py
@@ -165,6 +165,9 @@ def execute(self):
         # Import blocks (classes) and construct block instances.
         blocks = _import_blocks(block_names, block_args)
 
+        return self.run_blocks(blocks)
+
+    def run_blocks(self, blocks):
         # Initialize blocks (process_start).
         for bname, block in blocks:
             block.process_start()

From 95480458606a43db37bb2e26f701770093054819 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 16 Nov 2024 23:52:13 +0100
Subject: [PATCH 1137/1374] =?UTF-8?q?Trying=20to=20fix=20"=D9=81=D9=90?=
 =?UTF-8?q?=D9=8A=5F=D8=AD=D9=90=D9=8A=D9=86=D9=8E".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index ad093e1c..fc411884 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -1,6 +1,5 @@
 """Block to fix case-enhanced dependency relations in Arabic."""
 from udapi.core.block import Block
-import logging
 import re
 
 class FixEdeprels(Block):
@@ -21,7 +20,7 @@ class FixEdeprels(Block):
         'مِثلَ': [],
         'لِأَنَّ':  [],
         'كَمَا': [],
-        'فِي_حِينَ': [],
+#        'فِي_حِينَ': [],
         'فَ':   []
     }
 
@@ -552,7 +551,6 @@ def process_node(self, node):
         for edep in node.deps:
             m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):', edep['deprel'])
             if m:
-                bdeprel = m.group(1)
                 solved = False
                 # Arabic clauses often start with وَ wa "and", which does not add
                 # much to the meaning but sometimes gets included in the enhanced
@@ -564,10 +562,12 @@ def process_node(self, node):
                 # If one of the following expressions occurs followed by another preposition
                 # or by morphological case, remove the additional case marking. For example,
                 # 'jako_v' becomes just 'jako'.
+                re_prefix = r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'
+                re_suffix = r'([_:].+)?$'
                 for x in self.outermost:
                     exceptions = self.outermost[x]
-                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'([_:].+)?$', edep['deprel'])
-                    if m and m.group(2) and not x+m.group(2) in exceptions:
+                    m = re.match(re_prefix + x + re_suffix, edep['deprel'])
+                    if m and (not m.group(2) or not (x + m.group(2)) in exceptions):
                         edep['deprel'] = m.group(1)+':'+x
                         solved = True
                         break

From de0dec4f182e12476f58a7bf8c3f7b81287e6a55 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 17 Nov 2024 00:14:36 +0100
Subject: [PATCH 1138/1374] =?UTF-8?q?=D9=84=D9=8E=5F=D8=B9=D9=8E=D9=84?=
 =?UTF-8?q?=D9=8E=D9=91?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index fc411884..99db7fa2 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -397,6 +397,7 @@ class FixEdeprels(Block):
         'كَمَا':              'كَمَا', # remove morphological case; kamā = as
         'كَي':               'لِكَي', # kay = in order to
         'لَ':                'لِ:gen',
+        'لَ_عَلَّ':                'لِ:gen',
         'لِ':                'لِ:gen', # li = to
         'لِ_أَجَلّ':            'لِ:gen',
         'لِ_إِلَى':            'لِ:gen',

From d626d4a1cd0c2268abef736478997e9f3794eaa1 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 18 Nov 2024 19:56:11 +0100
Subject: [PATCH 1139/1374] util.Eval mwt='print(mwt.form)'

---
 udapi/block/util/eval.py | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/udapi/block/util/eval.py b/udapi/block/util/eval.py
index df6aaabf..6e4f2ac9 100644
--- a/udapi/block/util/eval.py
+++ b/udapi/block/util/eval.py
@@ -30,7 +30,7 @@ class Eval(Block):
     def __init__(self, doc=None, bundle=None, tree=None, node=None, start=None, end=None,
                  before_doc=None, after_doc=None, before_bundle=None, after_bundle=None,
                  coref_mention=None, coref_entity=None, empty_nodes=False,
-                 expand_code=True, **kwargs):
+                 expand_code=True, mwt=None, **kwargs):
         super().__init__(**kwargs)
         self.doc = doc
         self.bundle = bundle
@@ -38,6 +38,7 @@ def __init__(self, doc=None, bundle=None, tree=None, node=None, start=None, end=
         self.node = node
         self.start = start
         self.end = end
+        self.mwt = mwt
         self.before_doc = before_doc
         self.after_doc = after_doc
         self.before_bundle = before_bundle
@@ -70,7 +71,7 @@ def process_document(self, document):
         if self.doc:
             exec(self.expand_eval_code(self.doc))
 
-        if self.bundle or self.before_bundle or self.after_bundle or self.tree or self.node:
+        if self.bundle or self.before_bundle or self.after_bundle or self.tree or self.node or self.mwt:
             for bundle in doc.bundles:
                 # TODO if self._should_process_bundle(bundle):
                 self.process_bundle(bundle)
@@ -96,7 +97,7 @@ def process_bundle(self, bundle):
         if self.bundle:
             exec(self.expand_eval_code(self.bundle))
 
-        if self.tree or self.node:
+        if self.tree or self.node or self.mwt:
             trees = bundle.trees
             for tree in trees:
                 if self._should_process_tree(tree):
@@ -121,6 +122,11 @@ def process_tree(self, tree):
                 this = node
                 exec(self.expand_eval_code(self.node))
 
+        if self.mwt:
+            for mwt in tree.multiword_tokens:
+                this = mwt
+                exec(self.expand_eval_code(self.mwt))
+
     def process_start(self):
         if self.start:
             exec(self.expand_eval_code(self.start))

From b42a18e824c01a54b530982736921ebc77a625db Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 22 Nov 2024 23:23:40 +0100
Subject: [PATCH 1140/1374] =?UTF-8?q?"a=C5=A5=5Fs:ins"=20-->=20"s:ins"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/fixedeprels.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index f2f76b4b..176962e7 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -1,6 +1,5 @@
 """Block to fix case-enhanced dependency relations in Czech."""
 from udapi.core.block import Block
-import logging
 import re
 
 class FixEdeprels(Block):
@@ -37,6 +36,7 @@ class FixEdeprels(Block):
         'ačkoliv':          'ačkoli',
         'ať':               'ať', # remove morphological case
         'ať_forma':         'formou:gen',
+        'ať_s':             's:ins',
         'ať_v':             'v:loc',
         'ať_z':             'z:gen',
         'ať_z_strana':      'ze_strany:gen',

From 28cf77238c8be0457c5a76e11669a86a663b4d32 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 27 Nov 2024 19:22:49 +0100
Subject: [PATCH 1141/1374] =?UTF-8?q?"a=C5=A5"=20+=20preposition=20in=20Cz?=
 =?UTF-8?q?ech.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/fixedeprels.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 176962e7..e99c2821 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -36,9 +36,12 @@ class FixEdeprels(Block):
         'ačkoliv':          'ačkoli',
         'ať':               'ať', # remove morphological case
         'ať_forma':         'formou:gen',
+        'ať_na':            'na:loc',
         'ať_s':             's:ins',
         'ať_v':             'v:loc',
+        'ať_v_oblast':      'v_oblasti:gen',
         'ať_z':             'z:gen',
+        'ať_z_hledisko':    'z_hlediska:gen',
         'ať_z_strana':      'ze_strany:gen',
         'až_do':            'do:gen',
         'až_o':             'o:acc',

From 0cf278700ecc300cb2d0809dc2d161137f670ee6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 22 Nov 2024 01:00:10 +0100
Subject: [PATCH 1142/1374] "udapy -HM" now always prints all trees in a bundle

if any node in any tree in the bundle is marked.
So either the whole bundle is printed, or the whole bundle is skipped.
The original behavior can be turned on using whole_bundle=0.
---
 udapi/block/write/textmodetrees.py     |  4 ++--
 udapi/block/write/textmodetreeshtml.py | 10 ++++++++--
 2 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index 41539670..0007205d 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -244,7 +244,7 @@ def should_print_tree(self, root, allnodes):
             return False
         return self.comment_mark_re.search(root.comment)
 
-    def process_tree(self, root):
+    def process_tree(self, root, force_print=False):
         """Print the tree to (possibly redirected) sys.stdout."""
         if self.print_empty:
             if root.is_root():
@@ -256,7 +256,7 @@ def process_tree(self, root):
                 allnodes.sort()
         else:
             allnodes = root.descendants(add_self=1)
-        if not self.should_print_tree(root, allnodes):
+        if not force_print and not self.should_print_tree(root, allnodes):
             return
         self._index_of = {allnodes[i].ord: i for i in range(len(allnodes))}
         self.lines = [''] * len(allnodes)
diff --git a/udapi/block/write/textmodetreeshtml.py b/udapi/block/write/textmodetreeshtml.py
index 5ccceb78..0ad39da4 100644
--- a/udapi/block/write/textmodetreeshtml.py
+++ b/udapi/block/write/textmodetreeshtml.py
@@ -26,7 +26,7 @@ class TextModeTreesHtml(TextModeTrees):
     This block is a subclass of `TextModeTrees`, see its documentation for more info.
     """
 
-    def __init__(self, color=True, title='Udapi visualization', zones_in_rows=True, **kwargs):
+    def __init__(self, color=True, title='Udapi visualization', zones_in_rows=True, whole_bundle=True, **kwargs):
         """Create new TextModeTreesHtml block object.
 
         Args: see `TextModeTrees`.
@@ -35,10 +35,14 @@ def __init__(self, color=True, title='Udapi visualization', zones_in_rows=True,
         (see the `mark` parameter) to be more eye-catching.
 
         title: What title metadata to use for the html?
+        zones_in_rows: print trees from the same bundle side by side (i.e. in the same row).
+        whole_bundle: always print the whole bundle (all its trees) if any of the trees is marked
+        (relevant only with marked_only=True and zones_in_rows=True)
         """
         super().__init__(color=color, **kwargs)
         self.title = title
         self.zones_in_rows = zones_in_rows
+        self.whole_bundle = whole_bundle
 
     def before_process_document(self, document):
         # TextModeTrees.before_process_document changes the color property,
@@ -97,10 +101,12 @@ def process_bundle(self, bundle):
                 if self.should_print_tree(tree, allnodes):
                     marked_trees.append(tree)
             if marked_trees:
+                if self.whole_bundle:
+                    marked_trees = bundle
                 print("<table><tr>")
                 for tree in marked_trees:
                     print("<td>")
-                    self.process_tree(tree)
+                    self.process_tree(tree, force_print=True)
                     print("</td>")
                 print("</tr></table>")
         else:

From 6877b0db27979f55423afdf5007f5deadb723a8e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 30 Nov 2024 15:58:34 +0100
Subject: [PATCH 1143/1374] allow util.See empty=1

---
 udapi/block/util/see.py | 7 +++++--
 udapi/core/node.py      | 8 ++++----
 2 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/udapi/block/util/see.py b/udapi/block/util/see.py
index aa7131b7..9a895b88 100644
--- a/udapi/block/util/see.py
+++ b/udapi/block/util/see.py
@@ -51,7 +51,7 @@
 class See(Block):
     """Print statistics about the nodes specified by the parameter `node`."""
 
-    def __init__(self, node, n=5, stats=STATS, **kwargs):
+    def __init__(self, node, n=5, stats=STATS, empty=False, **kwargs):
         """Args:
         `node`: Python expression to be evaluated for each node and if True,
             the node will be considered "matching".
@@ -62,6 +62,7 @@ def __init__(self, node, n=5, stats=STATS, **kwargs):
             `children` = number of children nodes,
             `p_lemma` = lemma of a parent node, etc).
             See `udapi.core.Node.get_attrs` for a full list of statistics.
+        `empty`: apply the code also on empty nodes
         """
         super().__init__(**kwargs)
         self.node = node
@@ -73,11 +74,13 @@ def __init__(self, node, n=5, stats=STATS, **kwargs):
             self.match[stat] = Counter()
             self.every[stat] = Counter()
         self.overall = Counter()
+        self.empty = empty
 
     def process_tree(self, root):
         self.overall['trees'] += 1
         tree_match = False
-        for node in root.descendants:
+        nodes = root.descendants_and_empty if self.empty else root.descendants
+        for node in nodes:
             matching = self.process_node(node)
             self.overall['nodes'] += 1
             if matching:
diff --git a/udapi/core/node.py b/udapi/core/node.py
index a543678a..3897c3a6 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -764,21 +764,21 @@ def is_leaf(self):
 
     def _get_attr(self, name):  # pylint: disable=too-many-return-statements
         if name == 'dir':
-            if self._parent.is_root():
+            if not self._parent or self._parent.is_root():
                 return 'root'
             return 'left' if self.precedes(self._parent) else 'right'
         if name == 'edge':
-            if self._parent.is_root():
+            if not self._parent or self._parent.is_root():
                 return 0
             return self._ord - self._parent._ord
         if name == 'children':
             return len(self._children)
         if name == 'siblings':
-            return len(self._parent._children) - 1
+            return 0 if not self._parent else len(self._parent._children) - 1
         if name == 'depth':
             value = 0
             tmp = self
-            while not tmp.is_root():
+            while tmp and not tmp.is_root():
                 tmp = tmp._parent
                 value += 1
             return value

From 7cfcfbed8f7ed766c6c0bfab7f7561d3ac19c15a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 4 Dec 2024 17:54:16 +0100
Subject: [PATCH 1144/1374] don't print underscore attributes from doc.meta

tree2docid can be very long, so let's make it
an underscore attribute in doc.meta.
Now we can use "udapy -TM util.Mark..." on UD_English-GUM files
and even if the code uses coreference, the TextModeTrees visualization
won't be cluttered by tree2docid mappings.
---
 udapi/block/write/textmodetrees.py | 3 ++-
 udapi/core/coref.py                | 8 ++++----
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index 0007205d..b39a45b1 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -353,7 +353,8 @@ def before_process_document(self, document):
             os.environ["FORCE_COLOR"] = "1"
         if self.print_doc_meta:
             for key, value in sorted(document.meta.items()):
-                print('%s = %s' % (key, value))
+                if key[0] != '_':
+                    print('%s = %s' % (key, value))
 
     def _add(self, idx, text):
         self.lines[idx] += text
diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index c2ebef2a..c17f239f 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -331,8 +331,8 @@ def eid(self, new_eid):
     def eid_or_grp(self):
         root = self._mentions[0].head.root
         meta = root.document.meta
-        if 'GRP' in meta['global.Entity'] and meta['tree2docid']:
-            docid = meta['tree2docid'][root]
+        if 'GRP' in meta['global.Entity'] and meta['_tree2docid']:
+            docid = meta['_tree2docid'][root]
             if self._eid.startswith(docid):
                 return self._eid.replace(docid, '', 1)
             else:
@@ -551,7 +551,7 @@ def load_coref_from_misc(doc, strict=True):
                     highest_doc_n += 1
                     docid = f"d{highest_doc_n}."
                 tree2docid[tree] = docid
-        doc.meta['tree2docid'] = tree2docid
+        doc.meta['_tree2docid'] = tree2docid
     elif 'eid' not in global_entity:
         raise ValueError("No eid in global.Entity = " + global_entity)
     fields = global_entity.split('-')
@@ -758,7 +758,7 @@ def store_coref_to_misc(doc):
     if not doc._eid_to_entity:
         return
 
-    tree2docid = doc.meta.get('tree2docid')
+    tree2docid = doc.meta.get('_tree2docid')
     global_entity = doc.meta.get('global.Entity')
     if not global_entity:
         global_entity = 'eid-etype-head-other'

From a19c7525937023f6f5800a46e61d0655c01ed82b Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 4 Dec 2024 18:11:39 +0100
Subject: [PATCH 1145/1374] more colors for coreference

---
 udapi/block/write/textmodetrees.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index b39a45b1..885f797f 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -14,6 +14,7 @@
     'upos': 'red',
     'deprel': 'blue',
     'ord': 'green',
+    'misc[Entity]': 'magenta',
 }
 
 # Too many instance variables, arguments, branches...

From bd2b9eba2a6cdcf423b05438173a58d9c377caaa Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 7 Dec 2024 21:16:28 +0100
Subject: [PATCH 1146/1374] Emph=Yes needed with other Czech UPOS.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

inhedž (ADV), viecež (ADV), budž (AUX), všakž (CCONJ)
---
 udapi/block/ud/cs/markfeatsbugs.py | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 77b76a6e..6e81672f 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -638,7 +638,8 @@ def process_node(self, node):
                         'Voice': ['Act'], # optional in Old Czech data, not used with imperatives in Modern Czech data (at least not yet)
                         'Person': ['1', '2', '3'], # 3rd person imperative occasionally occurs in old Czech (but the form is identical to 2nd person)
                         'Number': ['Sing', 'Dual', 'Plur'],
-                        'Polarity': ['Pos', 'Neg']
+                        'Polarity': ['Pos', 'Neg'],
+                        'Emph': ['Yes']
                     })
                 else: # indicative
                     self.check_required_features(node, ['Mood', 'Voice', 'Tense', 'Person', 'Number', 'Polarity'])
@@ -770,7 +771,8 @@ def process_node(self, node):
                     self.check_required_features(node, ['Degree', 'Polarity'])
                     self.check_allowed_features(node, {
                         'Degree': ['Pos', 'Cmp', 'Sup'],
-                        'Polarity': ['Pos', 'Neg']
+                        'Polarity': ['Pos', 'Neg'],
+                        'Emph': ['Yes']
                     })
         # ADPOSITIONS ##########################################################
         elif node.upos == 'ADP':
@@ -779,10 +781,15 @@ def process_node(self, node):
                 'AdpType': ['Prep', 'Voc'],
                 'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins']
             })
+        # COORDINATING CONJUNCTIONS ############################################
+        elif node.upos == 'CCONJ':
+            self.check_allowed_features(node, {
+                'Emph': ['Yes']
+            })
         # THE REST: NO FEATURES ################################################
         # (OR UNDEFINED UPOS) ##################################################
         else:
-            if not node.upos in ['CCONJ', 'SCONJ', 'PART', 'INTJ', 'PUNCT', 'SYM', 'X']:
+            if not node.upos in ['SCONJ', 'PART', 'INTJ', 'PUNCT', 'SYM', 'X']:
                 bugmsg = 'UnknownUpos'
                 if node.upos:
                     bugmsg += node.upos

From b00fd0e7459c2e43a7ae7b67a92fd20d195805c7 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 7 Dec 2024 22:42:32 +0100
Subject: [PATCH 1147/1374] =?UTF-8?q?"st=C4=9B":=20Number=3DDual=3F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 6e81672f..f6711502 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -580,11 +580,12 @@ def process_node(self, node):
                     # agreement they trigger on verbs (but they don't have Gender=Neut).
                     # It does not make much sense but we must allow Sing before a better
                     # approach is defined and implemented in the data.
+                    # On the other hand, we may want to allow Dual for "stě".
                     self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
                     self.check_allowed_features(node, {
                         'NumType': ['Card', 'Sets'],
                         'NumForm': ['Word'],
-                        'Number': ['Sing', 'Plur'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
         # VERBS AND AUXILIARIES ################################################

From 657a72da7a683474bf4715ec94781036adec43f2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 7 Dec 2024 22:58:54 +0100
Subject: [PATCH 1148/1374] Old Czech "nikde" can mean "nikdo".

---
 udapi/block/ud/cs/markfeatsbugs.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index f6711502..bb5622a8 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -255,10 +255,12 @@ def process_node(self, node):
                             'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                             'Variant': ['Short']
                         })
-            elif re.search(r'k[dt]o', node.lemma): # kdo (kto), kdož, někdo, nikdo
+            elif re.search(r'k[dt][oe]', node.lemma): # kdo (kto), kdož, někdo, nikdo
                 # There is no Number. Někdo and nikdo behave like singular;
                 # kdo is by default singular as well but it also occurs as subject
                 # of plural verbs ("ti, kdo nepřišli včas, byli vyloučeni").
+                # In Old Czech, "nikde" is a variant of the pronoun "nikdo" (nobody)
+                # (while in New Czech, "nikde" (nowhere) is a pronominal adverb only).
                 # Old Czech data disambiguate Int from Rel (Int is used only in direct questions with; indirect questions like "Ptal ses, kdo to je?" use Rel.)
                 # New Czech data, in particular PDT, use Int,Rel regardless of context.
                 self.check_required_features(node, ['PronType', 'Gender', 'Animacy', 'Case'])

From 30a6f3f23bdd4461493ea6885cd2c0d66c5b7117 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 8 Dec 2024 08:55:53 +0100
Subject: [PATCH 1149/1374] Splitting "myslilaj".

---
 udapi/block/ud/cs/addmwt.py | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index a4f21b5c..202579b9 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -88,6 +88,18 @@ def multiword_analysis(self, node):
                     'main':   0,
                     'shape':  'subtree' if node.upos in ['VERB'] else 'siblings',
                 }
+            if subtokens[1] == 'i':
+                node.misc['AddMwt'] = ''
+                return {
+                    'form':   subtokens[0] + ' i',
+                    'lemma':  '* i',
+                    'upos':   '* CCONJ',
+                    'xpos':   '* J^-------------',
+                    'feats':  '* _',
+                    'deprel': '* cc',
+                    'main':   0,
+                    'shape': 'subtree',
+                }
             if subtokens[1] == 'ť':
                 if token_from_subtokens != node.form:
                     logging.warning("Concatenation of MISC 'AddMwt=%s' does not yield the FORM '%s'." % (node.misc['AddMwt'], node.form))

From 8fcea8096ba07dc8a1cd2c2691a48e0dc10d0447 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 8 Dec 2024 09:18:56 +0100
Subject: [PATCH 1150/1374] We have not been allowing abbreviations so far?

---
 udapi/block/ud/cs/markfeatsbugs.py | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index bb5622a8..f20f9c16 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -782,17 +782,24 @@ def process_node(self, node):
             self.check_required_features(node, ['AdpType', 'Case'])
             self.check_allowed_features(node, {
                 'AdpType': ['Prep', 'Voc'],
-                'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins']
+                'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins'],
+                'Abbr': ['Yes']
             })
         # COORDINATING CONJUNCTIONS ############################################
         elif node.upos == 'CCONJ':
             self.check_allowed_features(node, {
                 'Emph': ['Yes']
             })
+        # PARTICLES ############################################################
+        elif node.upos == 'PART':
+            # "t." = "totiž"
+            self.check_allowed_features(node, {
+                'Abbr': ['Yes']
+            })
         # THE REST: NO FEATURES ################################################
         # (OR UNDEFINED UPOS) ##################################################
         else:
-            if not node.upos in ['SCONJ', 'PART', 'INTJ', 'PUNCT', 'SYM', 'X']:
+            if not node.upos in ['SCONJ', 'INTJ', 'PUNCT', 'SYM', 'X']:
                 bugmsg = 'UnknownUpos'
                 if node.upos:
                     bugmsg += node.upos

From b681e3d450dd33fdffd2cd31f718b141e78aff85 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 8 Dec 2024 10:31:15 +0100
Subject: [PATCH 1151/1374] High-value Czech numerals have gender.

---
 udapi/block/ud/cs/markfeatsbugs.py | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index f20f9c16..9c40d237 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -539,6 +539,7 @@ def process_node(self, node):
                 # 'tři', 'čtyři' have Number=Plur, Case: tři, třech, třem, třemi.
                 # 'pět' and more have Number=Plur, Case: pět, pěti.
                 # 'půl' has no Number and Case, although it behaves syntactically similarly to 'pět' (but genitive is still 'půl', not '*půli').
+                # 'sto', 'tisíc', 'milión', 'miliarda' etc. have Gender (+ possibly Animacy) and Number (depending on their form).
                 if node.lemma == 'jeden':
                     self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
                     self.check_allowed_features(node, {
@@ -576,6 +577,16 @@ def process_node(self, node):
                         'NumType': ['Card'],
                         'NumForm': ['Word']
                     })
+                elif re.match(r'^(sto|tisíc|.+ili[oó]n|.+iliarda)$', node.lemma):
+                    self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'NumType': ['Card', 'Sets'],
+                        'NumForm': ['Word'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
                 else:
                     # In PDT, cardinal numerals higher than four in nominative/accusative/vocative
                     # have Number=Sing instead of Plur! It may be motivated by the default

From 8b55bc95403343b2bdb031d43abf9ce7c74345ae Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 8 Dec 2024 11:05:44 +0100
Subject: [PATCH 1152/1374] Emph=Yes needed with other Czech UPOS.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

dokudž (SCONJ)
---
 udapi/block/ud/cs/markfeatsbugs.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 9c40d237..0e97b20f 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -796,6 +796,11 @@ def process_node(self, node):
                 'Case': ['Gen', 'Dat', 'Acc', 'Loc', 'Ins'],
                 'Abbr': ['Yes']
             })
+        # SUBORDINATING CONJUNCTIONS ###########################################
+        elif node.upos == 'SCONJ':
+            self.check_allowed_features(node, {
+                'Emph': ['Yes']
+            })
         # COORDINATING CONJUNCTIONS ############################################
         elif node.upos == 'CCONJ':
             self.check_allowed_features(node, {
@@ -810,7 +815,7 @@ def process_node(self, node):
         # THE REST: NO FEATURES ################################################
         # (OR UNDEFINED UPOS) ##################################################
         else:
-            if not node.upos in ['SCONJ', 'INTJ', 'PUNCT', 'SYM', 'X']:
+            if not node.upos in ['INTJ', 'PUNCT', 'SYM', 'X']:
                 bugmsg = 'UnknownUpos'
                 if node.upos:
                     bugmsg += node.upos

From 3a66df5fbdf9197adcf4a588d132bed27b41deb2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 8 Dec 2024 11:14:59 +0100
Subject: [PATCH 1153/1374] More fixes.

---
 udapi/block/ud/fixadvmodbyupos.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index 5debcd8c..d020b55f 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -52,6 +52,8 @@ def process_node(self, node):
         elif node.udeprel == 'cc':
             if node.upos == 'AUX':
                 node.deprel = 'aux'
+            elif node.upos == 'DET':
+                node.deprel = 'det'
             elif node.upos == 'INTJ':
                 node.deprel = 'discourse'
         elif node.udeprel == 'det':

From baf885f1a686c51b0d05628a0af6ba9a616c1e8a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 10 Dec 2024 13:55:31 +0100
Subject: [PATCH 1154/1374] Allowing supine in (Old) Czech.

---
 udapi/block/ud/cs/markfeatsbugs.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 0e97b20f..cf0964d2 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -608,14 +608,14 @@ def process_node(self, node):
             # because there are a few biaspectual verbs (e.g. 'analyzovat') that
             # do not have the feature.
             self.check_required_features(node, ['VerbForm'])
-            if node.feats['VerbForm'] == 'Inf':
+            if node.feats['VerbForm'] in ['Inf', 'Sup']:
                 # There is no voice. For some reason, PDT does not annotate that
                 # the infinitive form is active (while a passive infinitive is
                 # a combination of the infinitive with a passive participle).
                 self.check_required_features(node, ['Polarity'])
                 self.check_allowed_features(node, {
                     'Aspect': ['Imp', 'Perf'],
-                    'VerbForm': ['Inf'],
+                    'VerbForm': ['Inf', 'Sup'],
                     'Polarity': ['Pos', 'Neg']
                 })
             elif node.feats['VerbForm'] == 'Fin':

From 55261ce6729604b01dc177837977b854bc8e7188 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 10 Dec 2024 14:22:33 +0100
Subject: [PATCH 1155/1374] Report NonAuxLemma.

---
 udapi/block/ud/cs/markfeatsbugs.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index cf0964d2..59f07dbd 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -603,6 +603,11 @@ def process_node(self, node):
                     })
         # VERBS AND AUXILIARIES ################################################
         elif node.upos in ['VERB', 'AUX']:
+            # There are only three lemmas recognized as AUX in Czech. This is not
+            # about features and it would be caught by the UD validator, but it
+            # is error in morphology, so let's report it here as well.
+            if node.upos == 'AUX' and node.lemma not in ['být', 'bývat', 'bývávat']:
+                self.bug(node, 'NonAuxLemma')
             # All Czech verbs (and some adjectives and nouns) must have VerbForm.
             # Almost all verbs have lexical Aspect but we cannot require it
             # because there are a few biaspectual verbs (e.g. 'analyzovat') that

From a9ab0f2a653c6f5c736ac40f725730a5a2e4c097 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 14 Dec 2024 01:10:54 +0100
Subject: [PATCH 1156/1374] unify UDPipeOnline and UDPipe

---
 udapi/tool/udpipe.py       | 14 ++++++++++----
 udapi/tool/udpipeonline.py |  5 +----
 2 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/udapi/tool/udpipe.py b/udapi/tool/udpipe.py
index 5d4a4d9c..83e289a2 100644
--- a/udapi/tool/udpipe.py
+++ b/udapi/tool/udpipe.py
@@ -22,8 +22,10 @@ def __init__(self, model):
         self.conllu_reader = ConlluReader()
         self.tokenizer = self.tool.newTokenizer(Model.DEFAULT)
 
-    def tag_parse_tree(self, root):
+    def tag_parse_tree(self, root, tag=True, parse=True):
         """Tag (+lemmatize, fill FEATS) and parse a tree (already tokenized)."""
+        if not tag and not parse:
+            raise ValueError('tag_parse_tree(root, tag=False, parse=False) does not make sense.')
         descendants = root.descendants
         if not descendants:
             return
@@ -34,11 +36,15 @@ def tag_parse_tree(self, root):
             raise IOError("UDPipe error " + self.error.message)
         self.conllu_reader.files.filehandle = io.StringIO(out_data)
         parsed_root = self.conllu_reader.read_tree()
-        root.flatten()
+        attrs = 'upos xpos lemma feats'.split() if tag else []
+        if parse:
+            attrs.append('deprel')
+            root.flatten()
         for parsed_node in parsed_root.descendants:
             node = descendants[parsed_node.ord - 1]
-            node.parent = descendants[parsed_node.parent.ord - 1] if parsed_node.parent.ord else root
-            for attr in 'upos xpos lemma feats deprel'.split():
+            if parse:
+                node.parent = descendants[parsed_node.parent.ord - 1] if parsed_node.parent.ord else root
+            for attr in attrs:
                 setattr(node, attr, getattr(parsed_node, attr))
 
         # TODO: benchmark which solution is the fastest one. E.g. we could also do
diff --git a/udapi/tool/udpipeonline.py b/udapi/tool/udpipeonline.py
index 206719f5..f0a835c9 100644
--- a/udapi/tool/udpipeonline.py
+++ b/udapi/tool/udpipeonline.py
@@ -71,10 +71,7 @@ def tag_parse_tree(self, root, tag=True, parse=True):
             return
         in_data = " ".join([n.form for n in descendants])
         params = {"model": self.model, "data": in_data, "input":"horizontal", "tagger":""}
-        if tag:
-            attrs = 'upos xpos lemma feats'.split()
-        else:
-            attrs = []
+        attrs = 'upos xpos lemma feats'.split() if tag else []
         if parse:
             params["parser"] = ""
             attrs.append('deprel')

From 5b9c50b774c9c8cbeff7fea02c6a4066b0f2acba Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 14 Dec 2024 03:01:50 +0100
Subject: [PATCH 1157/1374] fix serialization of sentences with empty nodes
 only

They need the same trick as sentences witout any nodes.
---
 udapi/block/write/conllu.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index abe20963..2573b5ae 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -134,10 +134,10 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
                 '_' if node._feats is None else str(node.feats), head, node.deprel,
                 node.raw_deps, '_' if node._misc is None else str(node.misc))))
 
-        # Empty sentences are not allowed in CoNLL-U,
+        # Empty sentences (sentences with no non-empty nodes) are not allowed in CoNLL-U,
         # but with print_empty_trees==1 (which is the default),
         # we will print an artificial node, so we can print the comments.
-        if not nodes:
+        if not tree._descendants:
             print("1\t_\t_\t_\t_\t_\t0\t_\t_\tEmpty=Yes")
 
         # Empty line separates trees in CoNLL-U (and is required after the last tree as well)

From 8c43bcc8977619894d74e29320e395f1e205d888 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 16 Dec 2024 13:00:04 +0100
Subject: [PATCH 1158/1374] Batch launcher in Windows.

---
 bin/udapy.bat | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 bin/udapy.bat

diff --git a/bin/udapy.bat b/bin/udapy.bat
new file mode 100644
index 00000000..013e08e7
--- /dev/null
+++ b/bin/udapy.bat
@@ -0,0 +1,4 @@
+@REM The Python launcher "py" must be accessible via the PATH environment variable.
+@REM We assume that this batch script lies next to udapy in udapi-python/bin.
+@REM The PYTHONPATH environment variable must contain path to udapi-python.
+py %~dp$PATH:0\udapy %*

From 75a4303c469423f0858f98024eb968a17bd832d2 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 18 Dec 2024 11:34:45 +0100
Subject: [PATCH 1159/1374] minor bugfix in eval.F1

In the rare case of no matching aligned non-focused nodes,
we have `nf_common==[]` and `c==0`, so `if c == len(nf_common)`
is true in the first iteration of the while loop and we need
`find_lcs(pred_tokens[0:], gold_tokens[0:])`, not
`find_lcs(pred_tokens[1:], gold_tokens[1:])`, which would
exclude the very first token, which could be focused and matching.

In other cases, the i+1 and j+1 worked correctly
(and resulted in a tiny speed improvement because
it was guaranteed that `pred_tokens[i] != gold_tokens[j]`).
---
 udapi/block/eval/f1.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/eval/f1.py b/udapi/block/eval/f1.py
index 7ed5cd70..e4889770 100644
--- a/udapi/block/eval/f1.py
+++ b/udapi/block/eval/f1.py
@@ -126,7 +126,7 @@ def process_tree(self, tree):
             i, j, c, un_pred, un_gold, common  = 0, 0, 0, [], [], []
             while i < len(pred_tokens) and j < len(gold_tokens):
                 if c == len(nf_common):
-                    common += find_lcs(pred_tokens[i+1:], gold_tokens[j+1:])
+                    common += find_lcs(pred_tokens[i:], gold_tokens[j:])
                     break
                 while nf_common[c] != pred_tokens[i]:
                     un_pred.append(pred_tokens[i])

From e8b42d7267a05280a0c43559fd40179cb3f26d0a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 19 Dec 2024 17:29:24 +0100
Subject: [PATCH 1160/1374] MSFCase

---
 udapi/block/mwe/msfcase.py | 150 +++++++++++++++++++++++++++++++++++++
 1 file changed, 150 insertions(+)
 create mode 100644 udapi/block/mwe/msfcase.py

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/mwe/msfcase.py
new file mode 100644
index 00000000..df312b5c
--- /dev/null
+++ b/udapi/block/mwe/msfcase.py
@@ -0,0 +1,150 @@
+"""
+Morphosyntactic features (UniDive):
+Derive a MS Case feature from morphological case and adposition.
+"""
+from udapi.core.block import Block
+
+class MsfCase(Block):
+
+    adposmap = {
+        'v+Loc':          'Ine',
+        'uvnitř+Gen':     'Ine',
+        'uprostřed+Gen':  'Ces',
+        'mezi+Ins':       'Int',
+        'vně+Gen':        'Ext',
+        'na+Loc':         'Ade',
+        'vedle+Gen':      'Apu',
+        'u+Gen':          'Chz',
+        'kolem+Gen':      'Cir',
+        'dokola+Gen':     'Cir',
+        'okolo+Gen':      'Cir',
+        'blízko+Dat':     'Prx',
+        'blízko+Gen':     'Prx',
+        'nedaleko+Gen':   'Prx',
+        'poblíž+Gen':     'Prx',
+        'daleko_od+Gen':  'Dst',
+        'nad+Ins':        'Sup',
+        'pod+Ins':        'Sub',
+        'vespod+Gen':     'Sub',
+        'před+Ins':       'Ant',
+        'vpředu+Gen':     'Ant',
+        'za+Ins':         'Pst',
+        'naproti+Dat':    'Opp',
+        'od+Gen':         'Abl',
+        'z+Gen':          'Ela',
+        'zevnitř+Gen':    'Ela',
+        'zprostřed+Gen':  'Cne',
+        's+Gen':          'Del',
+        'zpod+Gen':       'Sbe',
+        'zpoza+Gen':      'Pse',
+        'po+Loc':         'Per',
+        'napříč+Gen':     'Crs',
+        'napříč+Ins':     'Crs',
+        'podél+Gen':      'Lng',
+        'skrz+Acc':       'Inx',
+        'přes+Acc':       'Spx',
+        'ob+Acc':         'Cix',
+        'po+Acc':         'Ter',
+        'do+Gen':         'Ill',
+        'dovnitř+Gen':    'Ill',
+        'doprostřed+Gen': 'Cnl',
+        'mezi+Acc':       'Itl',
+        'na+Acc':         'All',
+        'k+Dat':          'Apl',
+        'nad+Acc':        'Spl',
+        'pod+Acc':        'Sbl',
+        'před+Acc':       'Anl',
+        'za+Acc':         'Psl',
+        'dokud':          'Tan',
+        'nežli':          'Tan',
+        'v+Acc':          'Tem',
+        'počátkem+Gen':   'Din',
+        'začátkem+Gen':   'Din',
+        'během+Gen':      'Dur',
+        'postupem+Gen':   'Dur',
+        'při+Loc':        'Dur',
+        'za+Gen':         'Der',
+        'koncem+Gen':     'Dtr',
+        'závěrem+Gen':    'Dtr',
+        'jakmile':        'Tps',
+        'jen_co':         'Tps',
+        'počínaje+Ins':   'Teg',
+        'jménem+Nom':     'Atr',
+        'zdali':          'Atr',
+        'že':             'Atr',
+        's+Ins':          'Com',
+        'bez+Gen':        'Abe',
+        'včetně+Gen':     'Inc',
+        'kromě+Gen':      'Exc',
+        'mimo+Acc':       'Exc',
+        'mimo+Gen':       'Exc',
+        'vyjma+Gen':      'Exc',
+        'místo+Gen':      'Sbs',
+        'namísto+Gen':    'Sbs',
+        'jako':           'Ess',
+        'formou+Gen':     'Ess',
+        'oproti+Dat':     'Dsm',
+        'než':            'Cmp',
+        'o+Acc':          'Dif',
+        'kdežto':         'Cmt',
+        'přičemž':        'Cmt',
+        'zatímco':        'Cmt',
+        'kvůli+Dat':      'Cau',
+        'vinou+Gen':      'Cau',
+        'vlivem+Gen':     'Cau',
+        'zásluhou+Gen':   'Cau',
+        'jelikož':        'Cau',
+        'ježto':          'Cau',
+        'poněvadž':       'Cau',
+        'protože':        'Cau',
+        'takže':          'Cau',
+        'aby':            'Pur',
+        'ať':             'Ign',
+        'navzdory+Dat':   'Ccs',
+        'vzdor+Dat':      'Ccs',
+        'ač':             'Ccs',
+        'ačkoli':         'Ccs',
+        'byť':            'Ccs',
+        'přestože':       'Ccs',
+        'třebaže':        'Ccs',
+        'jestli':         'Cnd',
+        'jestliže':       'Cnd',
+        'ledaže':         'Cnd',
+        'li':             'Cnd',
+        'pakliže':        'Cnd',
+        'pokud':          'Cnd',
+        'zda':            'Cnd',
+        'o+Loc':          'The',
+        'stran+Gen':      'The',
+        'podle+Gen':      'Quo',
+        'dle+Gen':        'Quo',
+        'pomocí+Gen':     'Ins',
+        'prostřednictvím+Gen': 'Ins',
+        'pro+Acc':        'Ben',
+        'proti+Dat':      'Adv',
+        'kontra+Nom':     'Adv',
+        'versus+Nom':     'Adv',
+        'vůči+Dat':       'Adv',
+    }
+
+    def process_node(self, node):
+        """
+        Derives a case value from preposition and morphological case. Stores it
+        as MSFCase in MISC.
+        """
+        # Do not do anything for function words.
+        if node.udeprel in ['case', 'mark', 'cc', 'aux', 'cop']:
+            node.misc['MSFFunc'] = 'Yes'
+            return
+        else:
+            node.misc['MSFFunc'] = 'No'
+        adpositions = [x.lemma for x in node.children if x.udeprel == 'case']
+        msfcase = node.feats['Case']
+        if adpositions:
+            adpostring = '_'.join(adpositions)
+            caseadpostring = adpostring + '+' + msfcase
+            if caseadpostring in adposmap:
+                msfcase = adposmap[caseadpostring]
+            else:
+                msfcase = caseadpostring
+        node.misc['MSFCase'] = msfcase

From 5acf2f12f906ab709bd1e21fca66162e54e76722 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 19 Dec 2024 21:09:19 +0100
Subject: [PATCH 1161/1374] self

---
 udapi/block/mwe/msfcase.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/mwe/msfcase.py
index df312b5c..c9d12379 100644
--- a/udapi/block/mwe/msfcase.py
+++ b/udapi/block/mwe/msfcase.py
@@ -143,8 +143,8 @@ def process_node(self, node):
         if adpositions:
             adpostring = '_'.join(adpositions)
             caseadpostring = adpostring + '+' + msfcase
-            if caseadpostring in adposmap:
-                msfcase = adposmap[caseadpostring]
+            if caseadpostring in self.adposmap:
+                msfcase = self.adposmap[caseadpostring]
             else:
                 msfcase = caseadpostring
         node.misc['MSFCase'] = msfcase

From 5f09ee10ab6c112cfa10f957e18ae650f01eda3c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 19 Dec 2024 22:37:15 +0100
Subject: [PATCH 1162/1374] No MSF Case for determiners and adjectival
 modifiers.

---
 udapi/block/mwe/msfcase.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/mwe/msfcase.py
index c9d12379..43587498 100644
--- a/udapi/block/mwe/msfcase.py
+++ b/udapi/block/mwe/msfcase.py
@@ -133,9 +133,14 @@ def process_node(self, node):
         as MSFCase in MISC.
         """
         # Do not do anything for function words.
+        # Specifically for Case, also skip 'det' and 'amod' modifiers (congruent attributes)
+        # because their Case is only agreement feature inherited from the head noun.
         if node.udeprel in ['case', 'mark', 'cc', 'aux', 'cop']:
             node.misc['MSFFunc'] = 'Yes'
             return
+        elif node.udeprel in ['det', 'amod']:
+            node.misc['MSCFunc'] = 'No'
+            return
         else:
             node.misc['MSFFunc'] = 'No'
         adpositions = [x.lemma for x in node.children if x.udeprel == 'case']

From 96d003d5b8f3ed6096faa0c526892dede8e9e295 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 19 Dec 2024 22:46:16 +0100
Subject: [PATCH 1163/1374] Multiword adpositions.

---
 udapi/block/mwe/msfcase.py | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/mwe/msfcase.py
index 43587498..2bb0d2a5 100644
--- a/udapi/block/mwe/msfcase.py
+++ b/udapi/block/mwe/msfcase.py
@@ -143,7 +143,16 @@ def process_node(self, node):
             return
         else:
             node.misc['MSFFunc'] = 'No'
-        adpositions = [x.lemma for x in node.children if x.udeprel == 'case']
+        # Get all case markers (adpositions) attached to the current node.
+        adpositions = []
+        for c in node.children:
+            if c.udeprel == 'case':
+                lemma = c.lemma
+                # If it has outgoing 'fixed' relations, it is a multiword adposition.
+                fixedchildren = [x.lemma for x in c.children if x.udeprel == 'fixed']
+                if fixedchildren:
+                    lemma += '_'.join(fixedchildren)
+                adpositions.append(lemma)
         msfcase = node.feats['Case']
         if adpositions:
             adpostring = '_'.join(adpositions)

From 5f81c733fea23bbd8ead0c9101f073f781f96dd1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 19 Dec 2024 22:48:39 +0100
Subject: [PATCH 1164/1374] Bug fix.

---
 udapi/block/mwe/msfcase.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/mwe/msfcase.py
index 2bb0d2a5..94d59901 100644
--- a/udapi/block/mwe/msfcase.py
+++ b/udapi/block/mwe/msfcase.py
@@ -151,7 +151,7 @@ def process_node(self, node):
                 # If it has outgoing 'fixed' relations, it is a multiword adposition.
                 fixedchildren = [x.lemma for x in c.children if x.udeprel == 'fixed']
                 if fixedchildren:
-                    lemma += '_'.join(fixedchildren)
+                    lemma += '_' + '_'.join(fixedchildren)
                 adpositions.append(lemma)
         msfcase = node.feats['Case']
         if adpositions:

From 0ca5875078417696febb75e19bc55d2954c5a428 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 20 Dec 2024 17:51:54 +0100
Subject: [PATCH 1165/1374] MSF initialization: from FEATS to MISC.

In later blocks we will take MSF features (possibly already modified) as input.
---
 udapi/block/mwe/msfinit.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 udapi/block/mwe/msfinit.py

diff --git a/udapi/block/mwe/msfinit.py b/udapi/block/mwe/msfinit.py
new file mode 100644
index 00000000..be6c4261
--- /dev/null
+++ b/udapi/block/mwe/msfinit.py
@@ -0,0 +1,15 @@
+"""
+Morphosyntactic features (UniDive):
+Initialization. Copies features from FEATS as MSF* attributes to MISC.
+"""
+from udapi.core.block import Block
+
+class MsfInit(Block):
+
+
+    def process_node(self, node):
+        """
+        For every feature in FEATS, creates its MSF* counterpart in MISC.
+        """
+        for f in node.feats:
+            node.misc['MSF'+f] = node.feats[f]

From bff83c36f4211795ef665773f8bf57c322f2a1a0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 20 Dec 2024 18:02:42 +0100
Subject: [PATCH 1166/1374] Both input and output is MSFCase.

---
 udapi/block/mwe/msfcase.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/mwe/msfcase.py
index 94d59901..18aa1769 100644
--- a/udapi/block/mwe/msfcase.py
+++ b/udapi/block/mwe/msfcase.py
@@ -153,7 +153,9 @@ def process_node(self, node):
                 if fixedchildren:
                     lemma += '_' + '_'.join(fixedchildren)
                 adpositions.append(lemma)
-        msfcase = node.feats['Case']
+        # We assume that all features were copied from FEATS to MISC in mwe.MsfInit.
+        # They may have been further processed there, so we take the input from there.
+        msfcase = node.misc['MSFCase']
         if adpositions:
             adpostring = '_'.join(adpositions)
             caseadpostring = adpostring + '+' + msfcase

From b4bc8d7e14b253b06ab54805bede40670e16bc91 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 20 Dec 2024 21:12:34 +0100
Subject: [PATCH 1167/1374] Guess case of nominals that lack it.

---
 udapi/block/mwe/msfinit.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/udapi/block/mwe/msfinit.py b/udapi/block/mwe/msfinit.py
index be6c4261..33900a0c 100644
--- a/udapi/block/mwe/msfinit.py
+++ b/udapi/block/mwe/msfinit.py
@@ -13,3 +13,26 @@ def process_node(self, node):
         """
         for f in node.feats:
             node.misc['MSF'+f] = node.feats[f]
+        # We are particularly interested in the Case feature but some nominals
+        # lack it (e.g. acronyms or numbers). If there is a preposition, it may
+        # indicate the expected case of the nominal.
+        if not node.feats['Case']:
+            # Not any 'case' dependent is helpful. Here we really need single-word
+            # adposition.
+            adpositions = [x for x in node.children if x.udeprel == 'case' and x.upos == 'ADP']
+            if len(adpositions) == 1:
+                fixed = [x for x in adpositions[0].children if x.udeprel == 'fixed']
+                if not fixed and adpositions[0].feats['Case']:
+                    node.misc['MSFCase'] = adpositions[0].feats['Case']
+        # If we did not find a preposition to help us, we may be able to read
+        # the case off an adjectival modifier or determiner.
+        if not node.misc['MSFCase']:
+            modifiers = [x for x in node.children if x.udeprel in ['amod', 'det'] and x.feats['Case']]
+            if modifiers:
+                node.misc['MSFCase'] = modifiers[0].feats['Case']
+        # Finally, if the above did not help, we may guess the case from the deprel of the node itself.
+        if not node.misc['MSFCase']:
+            if node.udeprel == 'nsubj':
+                node.misc['MSFCase'] = 'Nom'
+            elif node.udeprel == 'obj':
+                node.misc['MSFCase'] = 'Acc'

From 26c23b984b60381cda76d31431fc0c0f8d4038cd Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 20 Dec 2024 21:24:29 +0100
Subject: [PATCH 1168/1374] Copy only selected features.

---
 udapi/block/mwe/msfinit.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/udapi/block/mwe/msfinit.py b/udapi/block/mwe/msfinit.py
index 33900a0c..c8ec8e64 100644
--- a/udapi/block/mwe/msfinit.py
+++ b/udapi/block/mwe/msfinit.py
@@ -12,7 +12,10 @@ def process_node(self, node):
         For every feature in FEATS, creates its MSF* counterpart in MISC.
         """
         for f in node.feats:
-            node.misc['MSF'+f] = node.feats[f]
+            # Only selected features will be copied. Certain features are not
+            # interesting for the morphosyntactic annotation.
+            if f not in ['AdpType', 'NameType', 'Style', 'Variant']:
+                node.misc['MSF'+f] = node.feats[f]
         # We are particularly interested in the Case feature but some nominals
         # lack it (e.g. acronyms or numbers). If there is a preposition, it may
         # indicate the expected case of the nominal.

From 0f69ba8d102919bba71c5ef9065d346e1199356a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 20 Dec 2024 21:32:53 +0100
Subject: [PATCH 1169/1374] Cleanup block: Function words should not keep the
 MS features.

---
 udapi/block/mwe/msfremovefunc.py | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 udapi/block/mwe/msfremovefunc.py

diff --git a/udapi/block/mwe/msfremovefunc.py b/udapi/block/mwe/msfremovefunc.py
new file mode 100644
index 00000000..02efaa3d
--- /dev/null
+++ b/udapi/block/mwe/msfremovefunc.py
@@ -0,0 +1,17 @@
+"""
+Morphosyntactic features (UniDive):
+Cleanup. Removes MSF* features from MISC for function nodes (MSFFunc=Yes).
+"""
+from udapi.core.block import Block
+
+class MsfRemoveFunc(Block):
+
+
+    def process_node(self, node):
+        """
+        Removes MSF* features if MSFFunc=Yes.
+        """
+        if node.misc['MSFFunc'] == 'Yes':
+            for msf in node.misc:
+                if msf.startswith('MSF'):
+                    node.misc[msf] = ''

From cd4a3ce77b2d7acadf55197523dda2dc78ed7adb Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 20 Dec 2024 21:35:27 +0100
Subject: [PATCH 1170/1374] List cannot change during iteration.

---
 udapi/block/mwe/msfremovefunc.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/udapi/block/mwe/msfremovefunc.py b/udapi/block/mwe/msfremovefunc.py
index 02efaa3d..ce974285 100644
--- a/udapi/block/mwe/msfremovefunc.py
+++ b/udapi/block/mwe/msfremovefunc.py
@@ -12,6 +12,6 @@ def process_node(self, node):
         Removes MSF* features if MSFFunc=Yes.
         """
         if node.misc['MSFFunc'] == 'Yes':
-            for msf in node.misc:
-                if msf.startswith('MSF'):
-                    node.misc[msf] = ''
+            msfeats = [x for x in node.misc if x.startswith('MSF')]
+            for msf in msfeats:
+                node.misc[msf] = ''

From ecd9135def66f7d1e96b582e56e942e35c25d1cc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 20 Dec 2024 21:43:29 +0100
Subject: [PATCH 1171/1374] Other less interesting features.

---
 udapi/block/mwe/msfinit.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/mwe/msfinit.py b/udapi/block/mwe/msfinit.py
index c8ec8e64..7f0eb185 100644
--- a/udapi/block/mwe/msfinit.py
+++ b/udapi/block/mwe/msfinit.py
@@ -14,7 +14,7 @@ def process_node(self, node):
         for f in node.feats:
             # Only selected features will be copied. Certain features are not
             # interesting for the morphosyntactic annotation.
-            if f not in ['AdpType', 'NameType', 'Style', 'Variant']:
+            if f not in ['Abbr', 'AdpType', 'Emph', 'Foreign', 'NameType', 'Style', 'Typo', 'Variant']:
                 node.misc['MSF'+f] = node.feats[f]
         # We are particularly interested in the Case feature but some nominals
         # lack it (e.g. acronyms or numbers). If there is a preposition, it may

From 41d85936874d92563cc045749db1acea8254456f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 20 Dec 2024 22:33:10 +0100
Subject: [PATCH 1172/1374] The real case of cardinal numeral cases is
 different from the genitive of the head noun.

---
 udapi/block/mwe/msfcase.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/mwe/msfcase.py
index 18aa1769..27c22285 100644
--- a/udapi/block/mwe/msfcase.py
+++ b/udapi/block/mwe/msfcase.py
@@ -3,6 +3,7 @@
 Derive a MS Case feature from morphological case and adposition.
 """
 from udapi.core.block import Block
+import logging
 
 class MsfCase(Block):
 
@@ -162,5 +163,6 @@ def process_node(self, node):
             if caseadpostring in self.adposmap:
                 msfcase = self.adposmap[caseadpostring]
             else:
+                logging.warn(f"No Case value found for '{caseadpostring}'.")
                 msfcase = caseadpostring
         node.misc['MSFCase'] = msfcase

From 3999f607e1d860c80c95ed3fa35c442f73598305 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 20 Dec 2024 22:35:25 +0100
Subject: [PATCH 1173/1374] The real case of cardinal numeral cases is
 different from the genitive of the head noun.

---
 udapi/block/mwe/msfnumphrase.py | 36 +++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 udapi/block/mwe/msfnumphrase.py

diff --git a/udapi/block/mwe/msfnumphrase.py b/udapi/block/mwe/msfnumphrase.py
new file mode 100644
index 00000000..ebcc0850
--- /dev/null
+++ b/udapi/block/mwe/msfnumphrase.py
@@ -0,0 +1,36 @@
+"""
+Morphosyntactic features (UniDive):
+Case in Number Phrases like 'pět mužů' (five men) in Czech.
+"""
+from udapi.core.block import Block
+
+class MsfNumPhrase(Block):
+
+
+    def process_node(self, node):
+        """
+        Nouns with a 'nummod:gov' dependent are morphologically in genitive,
+        but the case of the whole phrase (number + counted noun) is different,
+        probably nominative or accusative.
+        """
+        quantifiers = [x for x in node.children if x.deprel in ['nummod:gov', 'det:numgov']]
+        current_case = node.misc['MSFCase']
+        if (current_case == 'Gen' or current_case == '') and quantifiers:
+            quantifier_case = quantifiers[0].misc['MSFCase']
+            # The quantifier may lack the case feature (e.g. numbers expressed by digits)
+            # but we may be able to guess it from a preposition or other factors.
+            if quantifier_case == '':
+                # Not any 'case' dependent is helpful. Here we really need single-word
+                # adposition.
+                adpositions = [x for x in node.children if x.udeprel == 'case' and x.upos == 'ADP']
+                if len(adpositions) == 1:
+                    fixed = [x for x in adpositions[0].children if x.udeprel == 'fixed']
+                    if not fixed and adpositions[0].feats['Case']:
+                        quantifier_case = adpositions[0].feats['Case']
+            # Finally, if the above did not help, we may guess the case from the deprel of the node itself.
+            if quantifier_case == '':
+                if node.udeprel == 'nsubj':
+                    quantifier_case = 'Nom'
+                elif node.udeprel == 'obj':
+                    quantifier_case = 'Acc'
+            node.misc['MSFCase'] = quantifier_case

From 815aa273f311e1af7c299347429e276676f73cba Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 21 Dec 2024 12:55:30 +0100
Subject: [PATCH 1174/1374] Bug fix.

---
 udapi/block/mwe/msfcase.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/mwe/msfcase.py
index 27c22285..cb586951 100644
--- a/udapi/block/mwe/msfcase.py
+++ b/udapi/block/mwe/msfcase.py
@@ -140,7 +140,7 @@ def process_node(self, node):
             node.misc['MSFFunc'] = 'Yes'
             return
         elif node.udeprel in ['det', 'amod']:
-            node.misc['MSCFunc'] = 'No'
+            node.misc['MSFFunc'] = 'No'
             return
         else:
             node.misc['MSFFunc'] = 'No'

From d24c23828b2acda4650eb769e066b94db0113788 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 21 Dec 2024 13:04:20 +0100
Subject: [PATCH 1175/1374] Treat punctuation like function words.

---
 udapi/block/mwe/msfcase.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/mwe/msfcase.py
index cb586951..b48ee02c 100644
--- a/udapi/block/mwe/msfcase.py
+++ b/udapi/block/mwe/msfcase.py
@@ -136,7 +136,7 @@ def process_node(self, node):
         # Do not do anything for function words.
         # Specifically for Case, also skip 'det' and 'amod' modifiers (congruent attributes)
         # because their Case is only agreement feature inherited from the head noun.
-        if node.udeprel in ['case', 'mark', 'cc', 'aux', 'cop']:
+        if node.udeprel in ['case', 'mark', 'cc', 'aux', 'cop', 'punct']:
             node.misc['MSFFunc'] = 'Yes'
             return
         elif node.udeprel in ['det', 'amod']:

From ceb8f5cf3f436c74b283b36fec4a1afec9a3181f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 22 Dec 2024 11:40:13 +0100
Subject: [PATCH 1176/1374] Czech multiword prepositions.

---
 udapi/block/mwe/msfcase.py | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/mwe/msfcase.py
index b48ee02c..c47fcd86 100644
--- a/udapi/block/mwe/msfcase.py
+++ b/udapi/block/mwe/msfcase.py
@@ -66,6 +66,7 @@ class MsfCase(Block):
         'při+Loc':        'Dur',
         'za+Gen':         'Der',
         'koncem+Gen':     'Dtr',
+        'konec+Gen':      'Dtr',
         'závěrem+Gen':    'Dtr',
         'jakmile':        'Tps',
         'jen_co':         'Tps',
@@ -74,6 +75,7 @@ class MsfCase(Block):
         'zdali':          'Atr',
         'že':             'Atr',
         's+Ins':          'Com',
+        'spolu_s+Ins':    'Com',
         'bez+Gen':        'Abe',
         'včetně+Gen':     'Inc',
         'kromě+Gen':      'Exc',
@@ -83,9 +85,18 @@ class MsfCase(Block):
         'místo+Gen':      'Sbs',
         'namísto+Gen':    'Sbs',
         'jako':           'Ess',
+        'jako+':          'Ess',
+        'jako+Nom':       'Ess',
+        'jako+Acc':       'Ess',
+        'jako_u+Gen':     'Ess',
         'formou+Gen':     'Ess',
         'oproti+Dat':     'Dsm',
         'než':            'Cmp',
+        'než+Nom':        'Cmp',
+        'než+Gen':        'Cmp',
+        'než+Acc':        'Cmp',
+        'než_nad+Ins':    'Cmp',
+        'než_v+Loc':      'Cmp',
         'o+Acc':          'Dif',
         'kdežto':         'Cmt',
         'přičemž':        'Cmt',
@@ -93,7 +104,10 @@ class MsfCase(Block):
         'kvůli+Dat':      'Cau',
         'vinou+Gen':      'Cau',
         'vlivem+Gen':     'Cau',
+        'vliv+Gen':       'Cau',
         'zásluhou+Gen':   'Cau',
+        'zásluha+Gen':    'Cau',
+        'v_důsledek+Gen': 'Cau',
         'jelikož':        'Cau',
         'ježto':          'Cau',
         'poněvadž':       'Cau',

From bf876ac5685bad3c0356a9efb84d301834f42960 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 22 Dec 2024 11:56:41 +0100
Subject: [PATCH 1177/1374] Czech multiword prepositions.

---
 udapi/block/mwe/msfcase.py | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/mwe/msfcase.py
index c47fcd86..44fa162e 100644
--- a/udapi/block/mwe/msfcase.py
+++ b/udapi/block/mwe/msfcase.py
@@ -19,9 +19,11 @@ class MsfCase(Block):
         'kolem+Gen':      'Cir',
         'dokola+Gen':     'Cir',
         'okolo+Gen':      'Cir',
+        'v_oblast+Gen':   'Cir',
         'blízko+Dat':     'Prx',
         'blízko+Gen':     'Prx',
         'nedaleko+Gen':   'Prx',
+        'daleko+Gen':     'Prx', # lemma of 'nedaleko'
         'poblíž+Gen':     'Prx',
         'daleko_od+Gen':  'Dst',
         'nad+Ins':        'Sup',
@@ -64,6 +66,7 @@ class MsfCase(Block):
         'během+Gen':      'Dur',
         'postupem+Gen':   'Dur',
         'při+Loc':        'Dur',
+        'v_průběh+Gen':   'Dur',
         'za+Gen':         'Der',
         'koncem+Gen':     'Dtr',
         'konec+Gen':      'Dtr',
@@ -76,6 +79,7 @@ class MsfCase(Block):
         'že':             'Atr',
         's+Ins':          'Com',
         'spolu_s+Ins':    'Com',
+        'společně_s+Ins': 'Com',
         'bez+Gen':        'Abe',
         'včetně+Gen':     'Inc',
         'kromě+Gen':      'Exc',
@@ -88,7 +92,9 @@ class MsfCase(Block):
         'jako+':          'Ess',
         'jako+Nom':       'Ess',
         'jako+Acc':       'Ess',
+        'jako+Dat':       'Ess',
         'jako_u+Gen':     'Ess',
+        'jako_v+Loc':     'Ess',
         'formou+Gen':     'Ess',
         'oproti+Dat':     'Dsm',
         'než':            'Cmp',
@@ -96,11 +102,13 @@ class MsfCase(Block):
         'než+Gen':        'Cmp',
         'než+Acc':        'Cmp',
         'než_nad+Ins':    'Cmp',
+        'než_v+Acc':      'Cmp',
         'než_v+Loc':      'Cmp',
         'o+Acc':          'Dif',
         'kdežto':         'Cmt',
         'přičemž':        'Cmt',
         'zatímco':        'Cmt',
+        'díky+Dat':       'Cau',
         'kvůli+Dat':      'Cau',
         'vinou+Gen':      'Cau',
         'vlivem+Gen':     'Cau',
@@ -113,7 +121,12 @@ class MsfCase(Block):
         'poněvadž':       'Cau',
         'protože':        'Cau',
         'takže':          'Cau',
+        'následek+Gen':   'Cau',
         'aby':            'Pur',
+        'na_základ+Gen':  'Cns',
+        's_ohled_na+Acc': 'Cns',
+        'v_souvislost_s+Ins': 'Cns',
+        'vzhledem_k+Dat': 'Cns',
         'ať':             'Ign',
         'navzdory+Dat':   'Ccs',
         'vzdor+Dat':      'Ccs',
@@ -129,12 +142,16 @@ class MsfCase(Block):
         'pakliže':        'Cnd',
         'pokud':          'Cnd',
         'zda':            'Cnd',
+        'v_případ+Gen':   'Cnd',
         'o+Loc':          'The',
+        'ohledně+Gen':    'The',
         'stran+Gen':      'The',
+        'z_hledisko+Gen': 'The',
         'podle+Gen':      'Quo',
         'dle+Gen':        'Quo',
         'pomocí+Gen':     'Ins',
         'prostřednictvím+Gen': 'Ins',
+        'prostřednictví+Gen': 'Ins',
         'pro+Acc':        'Ben',
         'proti+Dat':      'Adv',
         'kontra+Nom':     'Adv',

From fe0261d2356202dc9760785ae8ffe07ce59f74bb Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 22 Dec 2024 12:05:18 +0100
Subject: [PATCH 1178/1374] Czech multiword prepositions.

---
 udapi/block/mwe/msfcase.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/mwe/msfcase.py
index 44fa162e..3a5946cf 100644
--- a/udapi/block/mwe/msfcase.py
+++ b/udapi/block/mwe/msfcase.py
@@ -14,6 +14,7 @@ class MsfCase(Block):
         'mezi+Ins':       'Int',
         'vně+Gen':        'Ext',
         'na+Loc':         'Ade',
+        'v_rámec+Gen':    'Ade', # ???
         'vedle+Gen':      'Apu',
         'u+Gen':          'Chz',
         'kolem+Gen':      'Cir',
@@ -61,6 +62,7 @@ class MsfCase(Block):
         'dokud':          'Tan',
         'nežli':          'Tan',
         'v+Acc':          'Tem',
+        'v_období+Gen':   'Tpx',
         'počátkem+Gen':   'Din',
         'začátkem+Gen':   'Din',
         'během+Gen':      'Dur',
@@ -97,6 +99,7 @@ class MsfCase(Block):
         'jako_v+Loc':     'Ess',
         'formou+Gen':     'Ess',
         'oproti+Dat':     'Dsm',
+        'na_rozdíl_od+Gen': 'Dsm',
         'než':            'Cmp',
         'než+Nom':        'Cmp',
         'než+Gen':        'Cmp',
@@ -104,6 +107,7 @@ class MsfCase(Block):
         'než_nad+Ins':    'Cmp',
         'než_v+Acc':      'Cmp',
         'než_v+Loc':      'Cmp',
+        'v_srovnání_s+Ins': 'Cmp',
         'o+Acc':          'Dif',
         'kdežto':         'Cmt',
         'přičemž':        'Cmt',
@@ -126,8 +130,10 @@ class MsfCase(Block):
         'na_základ+Gen':  'Cns',
         's_ohled_na+Acc': 'Cns',
         'v_souvislost_s+Ins': 'Cns',
+        'v_světlo+Gen':   'Cns',
         'vzhledem_k+Dat': 'Cns',
         'ať':             'Ign',
+        'bez_ohled_na+Acc': 'Ign',
         'navzdory+Dat':   'Ccs',
         'vzdor+Dat':      'Ccs',
         'ač':             'Ccs',

From bf9ea676376680537b694412ed0409cc6b098357 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 22 Dec 2024 15:23:49 +0100
Subject: [PATCH 1179/1374] Catch ill-annotated perposition-Case combinations.

---
 udapi/block/mwe/msfcase.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/mwe/msfcase.py
index 3a5946cf..3d04eebf 100644
--- a/udapi/block/mwe/msfcase.py
+++ b/udapi/block/mwe/msfcase.py
@@ -54,6 +54,7 @@ class MsfCase(Block):
         'doprostřed+Gen': 'Cnl',
         'mezi+Acc':       'Itl',
         'na+Acc':         'All',
+        'na+Gen':         'All', # annotation error
         'k+Dat':          'Apl',
         'nad+Acc':        'Spl',
         'pod+Acc':        'Sbl',
@@ -62,6 +63,7 @@ class MsfCase(Block):
         'dokud':          'Tan',
         'nežli':          'Tan',
         'v+Acc':          'Tem',
+        'v+Nom':          'Tem', # annotation error
         'v_období+Gen':   'Tpx',
         'počátkem+Gen':   'Din',
         'začátkem+Gen':   'Din',

From 722c1a9e02f1dab5e5caf25b1fb33288e451b4f2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 23 Dec 2024 09:32:57 +0100
Subject: [PATCH 1180/1374] =?UTF-8?q?Blocks=20from=20Lenka=20Krippnerov?=
 =?UTF-8?q?=C3=A1=20to=20recognize=20periphrastic=20verb=20forms=20in=20Sl?=
 =?UTF-8?q?avic=20languages.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/mwe/preprocessor.py         |  46 ++++++
 udapi/block/mwe/slavic_cond.py          |  92 +++++++++++
 udapi/block/mwe/slavic_future.py        | 201 ++++++++++++++++++++++++
 udapi/block/mwe/slavic_imperative.py    |  93 +++++++++++
 udapi/block/mwe/slavic_inf.py           |  90 +++++++++++
 udapi/block/mwe/slavic_past.py          | 156 ++++++++++++++++++
 udapi/block/mwe/slavic_pres.py          | 104 ++++++++++++
 udapi/block/mwe/slavic_transgressive.py |  96 +++++++++++
 8 files changed, 878 insertions(+)
 create mode 100644 udapi/block/mwe/preprocessor.py
 create mode 100644 udapi/block/mwe/slavic_cond.py
 create mode 100644 udapi/block/mwe/slavic_future.py
 create mode 100644 udapi/block/mwe/slavic_imperative.py
 create mode 100644 udapi/block/mwe/slavic_inf.py
 create mode 100644 udapi/block/mwe/slavic_past.py
 create mode 100644 udapi/block/mwe/slavic_pres.py
 create mode 100644 udapi/block/mwe/slavic_transgressive.py

diff --git a/udapi/block/mwe/preprocessor.py b/udapi/block/mwe/preprocessor.py
new file mode 100644
index 00000000..1ac8a6f1
--- /dev/null
+++ b/udapi/block/mwe/preprocessor.py
@@ -0,0 +1,46 @@
+#!/usr/bin/env python3
+
+from udapi.core.block import Block
+
+class Preprocessor(Block):
+		
+	def process_node(self,node):
+				
+		# in Belarusian, some adjectives formed from verbs are marked as verbs
+		# if the verb has case, then it is an adjective
+		if node.upos == 'VERB' and node.feats['Case'] != '':
+			node.upos = 'ADJ'
+			
+		# in Polish, the conditional mood for auxiliary verbs is marked as deprel == 'aux:cnd' and not as in the last Slavic languages ​​feats['Mood'] == 'Cnd'
+		if node.deprel == 'aux:cnd':
+			node.feats['Mood'] = 'Cnd'
+			
+		# sjednotit cas u dokonavych sloves vyjadrujici budoucnost
+		# chceme pritomny, nebo budouci? - s budoucim by se asi zjednodusilo dost veci
+		# jak ale poznat, ktery cas prepsat a ktery ne? - problem s makedonstinou
+		
+		# sjednotit passivum, rozhodnout, zda ma byt plnovyznamove sloveso znaceno jako ADJ, nebo VERB
+			
+		# unify polarities - some languages ​​mark only Neg (Russian), some mark both Neg and Pos (Czech)
+		if node.feats['Polarity'] == 'Pos':
+			node.feats['Polarity'] = ''
+		
+		# makedonstina tvori budouci cas pomoci pomocneho slova ќе, u nejz neni nijak vyznaceno, ze se podili na tvorbe budouciho casu
+		# stejne tak bulharstina pomoci pomocneho slova ще
+		# makedonstina a bulharstina
+		if node.feats['Tense'] == 'Pres':
+			aux = [x for x in node.children if x.lemma == 'ќе' or x.lemma == 'ще']
+			if len(aux) == 1:
+				aux[0].feats['Tense'] = 'Fut'
+				
+		# in Czech and in Old Church Slavonic, the participle is marked with the plural gender
+		if node.feats['Gender'] == 'Fem,Neut' or node.feats['Gender'] == 'Fem,Masc':
+			subj = [x for x in node.children if x.udeprel == 'nsubj']
+
+			# for relative pronouns, only one gender is indicated
+			if len(subj) == 1:
+				conj = [x for x in subj[0].children if x.deprel == 'conj']
+				if len(conj) == 0:
+					node.feats['Gender'] = subj[0].feats['Gender']
+					node.feats['Number'] = subj[0].feats['Number']
+				
diff --git a/udapi/block/mwe/slavic_cond.py b/udapi/block/mwe/slavic_cond.py
new file mode 100644
index 00000000..de7cd160
--- /dev/null
+++ b/udapi/block/mwe/slavic_cond.py
@@ -0,0 +1,92 @@
+#!/usr/bin/env python3
+
+# Conditional mood of Slavic languages
+
+from udapi.core.block import Block
+import importlib
+import sys
+
+class Slavic_cond(Block):
+	def __init__(self, writer_prefix='',**kwargs):
+		super().__init__(**kwargs)
+		if writer_prefix != '':
+			writer_module = ".".join([writer_prefix,'writer'])
+		else:
+			writer_module = 'writer'
+		try:
+			module = importlib.import_module(writer_module)
+		except ModuleNotFoundError as e:
+			print(e, file=sys.stderr)
+			print("Try to set writer_prefix parameter.", file=sys.stderr)
+			exit(1)
+
+		self.wr = module.Writer()
+
+	
+	def process_node(self, node):
+		if node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'Fin':
+			# in most Slavic languages, the verb has feats['VerbForm'] == 'Part' but in Polish the verb has feats['VerbForm'] == 'Fin'
+			
+			aux_cnd = [x for x in node.children if x.feats['Mood'] == 'Cnd' or x.deprel == 'aux:cnd'] # list for auxiliary verbs for forming the conditional mood
+			cop = [x for x in node.children if x.udeprel == 'cop'] # in some cases it may happen that the cop follows the noun, we don't want to these cases in this branch
+			# in Polish the auxiliary verbs for conditional mood have deprel == 'aux:cnd', in other languages the auxiliary verbs have x.feats['Mood'] == 'Cnd'
+			
+			# the conditional mood can be formed using the auxiliary verb or some conjunctions (such as 'aby, kdyby...' in Czech)
+			# so x.udeprel == 'aux' can't be required because it doesn't meet the conjunctions
+			
+			if len(aux_cnd) > 0 and len(cop) == 0:
+				aux = [x for x in node.children if x.udeprel == 'aux' or x.feats['Mood'] == 'Cnd'] # all auxiliary verbs and conjuctions with feats['Mood'] == 'Cnd'
+				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+				
+				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in refl] + [x.ord for x in neg]
+				phrase_ords.sort()
+			
+				auxVerb = aux_cnd[0]
+
+				person='3' # TODO there could be a problem in russian etc. (same as in past tense)
+				if auxVerb.feats['Person'] != '':
+					person=auxVerb.feats['Person']
+				
+					
+				self.wr.write_node_info(node,
+					person=person,
+					number=node.feats['Number'],
+					mood='Cnd',
+					form='Fin',
+					aspect=node.feats['Aspect'],
+					reflex=self.wr.get_is_reflex(node,refl),
+					polarity=self.wr.get_polarity(node,neg),
+					voice=self.wr.get_voice(node, refl),
+					ords=phrase_ords,
+					gender=node.feats['Gender'],
+					animacy=node.feats['Animacy']
+				)
+				return
+		
+					
+		cop = [x for x in node.children if x.udeprel == 'cop' and (x.feats['VerbForm'] == 'Part' or x.feats['VerbForm'] == 'Fin')]
+		aux_cnd = [x for x in node.children if x.feats['Mood'] == 'Cnd' or x.deprel=='aux:pass']
+			
+		if len(cop) > 0 and len(aux_cnd) > 0:
+			aux = [x for x in node.children if x.udeprel == 'aux' or x.feats['Mood'] == 'Cnd']
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			prep = [x for x in node.children if x.upos == 'ADP']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+
+			copVerb = cop[0]
+			phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in cop] + [x.ord for x in neg] + [x.ord for x in prep] + [x.ord for x in refl]
+			phrase_ords.sort()
+			self.wr.write_node_info(node,
+					person=copVerb.feats['Person'],
+					number=copVerb.feats['Number'],
+					mood='Cnd',
+					form='Fin',
+					voice=self.wr.get_voice(node, refl),
+					polarity=self.wr.get_polarity(copVerb,neg),
+					reflex=self.wr.get_is_reflex(node, refl),
+					ords=phrase_ords,
+					gender=copVerb.feats['Gender'],
+					animacy=copVerb.feats['Animacy']
+			)
+				
diff --git a/udapi/block/mwe/slavic_future.py b/udapi/block/mwe/slavic_future.py
new file mode 100644
index 00000000..21d13a52
--- /dev/null
+++ b/udapi/block/mwe/slavic_future.py
@@ -0,0 +1,201 @@
+#!/usr/bin/env python3
+
+# Future tense of Slavic languages
+
+from udapi.core.block import Block
+import importlib
+import sys
+
+class Slavic_future(Block):
+	def __init__(self, writer_prefix='',**kwargs):
+		super().__init__(**kwargs)
+		if writer_prefix != '':
+			writer_module = ".".join([writer_prefix,'writer'])
+		else:
+			writer_module = 'writer'
+		try:
+			module = importlib.import_module(writer_module)
+		except ModuleNotFoundError as e:
+			print(e, file=sys.stderr)
+			print("Try to set writer_prefix parameter.", file=sys.stderr)
+			exit(1)
+
+		self.wr = module.Writer()
+	
+	def process_node(self, node):
+		# future tense for Serbian and Croatian
+		aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Pres' and (x.lemma == 'hteti' or x.lemma == 'htjeti')]
+		if node.upos != 'AUX' and len(aux) != 0:
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			aux_other = [x for x in node.children if x.udeprel == 'aux'] # adding aux for passive voice
+			cop = [x for x in node.children if x.deprel == 'cop']
+			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg] + [x.ord for x in aux_other] + [x.ord for x in cop]
+			phrase_ords.sort()
+			
+			# u infinitivu neni vyznacen slovesny rod
+			# PhraseVoice ale chceme nastavit na activum, jelikoz se jedna o pomocne sloveso + infinitiv
+			voice=node.feats['Voice']
+			#if voice == '':
+			#	voice = 'Act'
+			if len(cop) == 0:
+				self.wr.write_node_info(node, 
+					tense='Fut',
+					person=aux[0].feats['Person'],
+					number=aux[0].feats['Number'],
+					mood='Ind',
+					voice=voice,
+					aspect=node.feats['Aspect'], # srbstina ani chorvatstina vidy nema
+					form='Fin',
+					polarity=self.wr.get_polarity(node,neg),
+					reflex=self.wr.get_is_reflex(node,refl),
+					gender=node.feats['Gender'],
+					animacy=node.feats['Animacy'],
+					ords=phrase_ords
+					)
+			else:
+				prep = [x for x in node.children if x.upos == 'ADP']
+				phrase_ords += [x.ord for x in prep]
+				phrase_ords.sort()
+
+				self.wr.write_node_info(node, 
+					tense='Fut',
+					person=aux[0].feats['Person'],
+					number=aux[0].feats['Number'],
+					mood='Ind',
+					voice=voice,
+					aspect=node.feats['Aspect'], 
+					form='Fin',
+					polarity=self.wr.get_polarity(node,neg),
+					reflex=self.wr.get_is_reflex(node,refl),
+					gender=node.feats['Gender'],
+					animacy=node.feats['Animacy'],
+					ords=phrase_ords
+					)
+				
+			return
+				
+		# Macedonian forms the future tense with the auxiliary word ќе and a verb in the present tense
+		# Bulgarian forms the future tense with the auxiliary word ще and a verb in the present tense
+		aux = [x for x in node.children if x.lemma == 'ќе' or x.lemma == 'ще']
+		
+		if node.feats['Tense'] == 'Pres' and len(aux) > 0:
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg] + [x.ord for x in aux]
+			phrase_ords.sort()
+			
+			self.wr.write_node_info(node, 
+				tense='Fut',
+				person=node.feats['Person'],
+				number=node.feats['Number'],
+				mood='Ind',
+				voice=node.feats['Voice'],
+				aspect=node.feats['Aspect'],
+				form='Fin',
+				polarity=self.wr.get_polarity(node,neg),
+				reflex=self.wr.get_is_reflex(node,refl),
+				ords=phrase_ords
+				)
+			return
+
+		# future tense of perfect verbs
+		# Upper Sorbian forms the future tense in this way, however, the feats[Aspect] are not listed in the data
+		# in some languages ​​(e.g. in Russian) these verbs have the Tense Fut, in others (e.g. in Czech) they have the Tense Pres
+		"""if node.feats['Aspect'] == 'Perf' and (node.feats['Tense'] == 'Pres' or node.feats['Tense'] == 'Fut') and node.feats['VerbForm'] != 'Conv':
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			
+			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+			phrase_ords.sort()
+			
+			self.wr.write_node_info(node, 
+				tense='Fut',
+				person=node.feats['Person'],
+				number=node.feats['Number'],
+				mood='Ind',
+				voice=self.wr.get_voice(node,refl),
+				form='Fin',
+				aspect='Perf',
+				polarity=self.wr.get_polarity(node,neg),
+				reflex=self.wr.get_is_reflex(node,refl),
+				ords=phrase_ords
+				)
+			return"""
+
+		
+		# future tense of imperfect verbs and passive voice
+		# in some languages ​​the verb is in the infinitive, in some it is in the l-participle
+		# the condition node.upos == 'ADJ' is due to the passive voice - the n-participle is marked as ADJ, but the auxiliary verb is not cop, but aux
+		if node.upos == 'VERB' or node.upos == 'ADJ':
+			
+			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Fut']
+			
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			if len(aux) > 0:
+				auxVerb = aux[0]
+				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in refl] + [x.ord for x in neg]
+				phrase_ords.sort()
+				self.wr.write_node_info(node,
+					tense='Fut',
+					person=auxVerb.feats['Person'],
+					number=auxVerb.feats['Number'],
+					mood='Ind',
+					voice=self.wr.get_voice(node,refl),
+					aspect=node.feats['Aspect'],
+					form='Fin',
+					polarity=self.wr.get_polarity(auxVerb,neg),
+					reflex=self.wr.get_is_reflex(node,refl),
+					ords=phrase_ords,
+					gender=node.feats['Gender'],
+					animacy=node.feats['Animacy']
+					)
+				return
+
+			# simple future tense - e.g. in Serbian, the future tense can be formed by combining a verb with a full meaning and an auxiliary verb into one word, i.e. without an auxiliary verb
+			# or verbs like pojede, půjdeme... in Czech
+			
+			if len(aux) == 0 and node.feats['Tense'] == 'Fut':
+				
+				phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+				phrase_ords.sort()
+				
+				self.wr.write_node_info(node,
+					tense='Fut',
+					person=node.feats['Person'],
+					number=node.feats['Number'],
+					mood='Ind',
+					voice=self.wr.get_voice(node,refl), # passivum se muze objevit (napr. pojede se), ale jmenny rod neni vyjadren
+					aspect=node.feats['Aspect'],
+					form='Fin',
+					polarity=self.wr.get_polarity(node,neg),
+					reflex=self.wr.get_is_reflex(node,refl),
+					ords=phrase_ords
+					)
+				return
+				
+				
+		cop = [x for x in node.children if x.udeprel == 'cop' and x.feats['Tense'] == 'Fut']
+		if len(cop) > 0:
+			copVerb = cop[0]
+			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Mood']=='Ind']
+			prep = [x for x in node.children if x.upos == 'ADP']
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+
+			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in aux] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
+			phrase_ords.sort()
+				
+			self.wr.write_node_info(node,
+					tense='Fut',
+					person=copVerb.feats['Person'],
+					number=copVerb.feats['Number'],
+					mood='Ind',
+					form='Fin',
+					voice=self.wr.get_voice(node, refl),
+					polarity=self.wr.get_polarity(copVerb,neg),
+					ords=phrase_ords
+				)
+
diff --git a/udapi/block/mwe/slavic_imperative.py b/udapi/block/mwe/slavic_imperative.py
new file mode 100644
index 00000000..02aad2e5
--- /dev/null
+++ b/udapi/block/mwe/slavic_imperative.py
@@ -0,0 +1,93 @@
+#!/usr/bin/env python3
+
+# Imperative of Slavic languages
+
+from udapi.core.block import Block
+import importlib
+import sys
+
+class Slavic_imperative(Block):
+	def __init__(self, writer_prefix='',**kwargs):
+		super().__init__(**kwargs)
+		if writer_prefix != '':
+			writer_module = ".".join([writer_prefix,'writer'])
+		else:
+			writer_module = 'writer'
+		try:
+			module = importlib.import_module(writer_module)
+		except ModuleNotFoundError as e:
+			print(e, file=sys.stderr)
+			print("Try to set writer_prefix parameter.", file=sys.stderr)
+			exit(1)
+
+		self.wr = module.Writer()
+	
+	def process_node(self, node):
+		# the condition node.upos == 'VERB' ensures that copulas do not enter this branch
+		if node.feats['Mood'] == 'Imp' and node.upos == 'VERB':
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			
+			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+			phrase_ords.sort()
+			
+			self.wr.write_node_info(node,
+				person=node.feats['Person'],
+				number=node.feats['Number'],
+				aspect=node.feats['Aspect'],
+				mood='Imp',
+				form='Fin',
+				voice='Act',
+				polarity=self.wr.get_polarity(node,neg),
+				reflex=self.wr.get_is_reflex(node,refl),
+				ords=phrase_ords
+				)
+			return
+			
+		# verbs in the passive forms are marked as ADJ
+		if node.upos == 'ADJ' and node.feats['Voice'] == 'Pass':
+			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Mood'] == 'Imp']
+			if len(aux) > 0:
+				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+				
+				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in neg]
+				phrase_ords.sort()
+				
+				self.wr.write_node_info(node,
+					person=aux[0].feats['Person'],
+					number=aux[0].feats['Number'],
+					mood='Imp',
+					voice='Pass',
+					aspect=node.feats['Aspect'],
+					form='Fin',
+					polarity=self.wr.get_polarity(node,neg),
+					ords=phrase_ords,
+					gender=node.feats['Gender'],
+					animacy=node.feats['Animacy']
+					)
+				return
+
+
+		cop = [x for x in node.children if x.udeprel == 'cop' and x.feats['Mood'] == 'Imp']
+		if len(cop) > 0:
+			prep = [x for x in node.children if x.upos == 'ADP']
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+
+			copVerb = cop[0]
+			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
+			phrase_ords.sort()
+				
+			self.wr.write_node_info(node,
+				person=copVerb.feats['Person'],
+				number=copVerb.feats['Number'],
+				mood='Imp',
+				form='Fin',
+				voice=self.wr.get_voice(node, refl),
+				reflex=self.wr.get_is_reflex(node, refl),
+				polarity=self.wr.get_polarity(node,neg),
+				ords=phrase_ords
+				)
+				
+
+
diff --git a/udapi/block/mwe/slavic_inf.py b/udapi/block/mwe/slavic_inf.py
new file mode 100644
index 00000000..7c7d2e39
--- /dev/null
+++ b/udapi/block/mwe/slavic_inf.py
@@ -0,0 +1,90 @@
+#!/usr/bin/env python3
+
+# Infinitive of Slavic languages
+
+from udapi.core.block import Block
+import importlib
+import sys
+
+class Slavic_inf(Block):
+	def __init__(self, writer_prefix='',**kwargs):
+		super().__init__(**kwargs)
+		if writer_prefix != '':
+			writer_module = ".".join([writer_prefix,'writer'])
+		else:
+			writer_module = 'writer'
+		try:
+			module = importlib.import_module(writer_module)
+		except ModuleNotFoundError as e:
+			print(e, file=sys.stderr)
+			print("Try to set writer_prefix parameter.", file=sys.stderr)
+			exit(1)
+
+		self.wr = module.Writer()
+		
+	def process_node(self,node):
+		if node.feats['VerbForm'] == 'Inf' and node.upos == 'VERB':
+			aux = [x for x in node.children if x.udeprel == 'aux']
+			if len(aux) == 0: # the list of auxiliary list must be empty - we don't want to mark infinitives which are part of any other phrase (for example the infinititive is part of the future tense in Czech)
+				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+				
+				phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+				phrase_ords.sort()
+				
+				voice='Act'
+				if self.wr.is_expl_pass(refl):
+					voice='Pass'
+				
+				self.wr.write_node_info(node,
+					aspect=node.feats['Aspect'],
+					voice=voice,
+					form='Inf',
+					polarity=self.wr.get_polarity(node,neg),
+					reflex=self.wr.get_is_reflex(node,refl),
+					ords=phrase_ords
+				)
+				return
+		
+		if node.upos == 'ADJ' and node.feats['Voice'] == 'Pass':
+			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['VerbForm'] == 'Inf']
+			aux_forb = [x for x in node.children if x.udeprel == 'aux' and x.feats['VerbForm'] != 'Inf']
+			if len(aux) > 0 and len(aux_forb) == 0:
+				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+
+				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in neg] + [x.ord for x in refl]
+				phrase_ords.sort()
+				
+				self.wr.write_node_info(node,
+					aspect=node.feats['Aspect'],
+					voice='Pass',
+					form='Inf',
+					polarity=self.wr.get_polarity(aux[0],neg),
+					reflex=self.wr.get_is_reflex(node, refl),
+					ords=phrase_ords,
+					gender=node.feats['Gender'],
+					animacy=node.feats['Animacy'],
+					number=node.feats['Number']
+					)
+				return
+					
+		
+
+		cop = [x for x in node.children if x.udeprel == 'cop' and x.feats['VerbForm'] == 'Inf']
+		aux_forb = [x for x in node.children if x.udeprel == 'aux']
+		if len(cop) > 0 and len(aux_forb) == 0:
+			prep = [x for x in node.children if x.upos == 'ADP']
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
+			phrase_ords.sort()
+			
+			self.wr.write_node_info(node,
+				voice=self.wr.get_voice(node, refl),
+				form='Inf',
+				polarity=self.wr.get_polarity(cop[0],neg),
+				reflex=self.wr.get_is_reflex(node, refl),
+				ords=phrase_ords
+				)
+							
diff --git a/udapi/block/mwe/slavic_past.py b/udapi/block/mwe/slavic_past.py
new file mode 100644
index 00000000..6f9a6816
--- /dev/null
+++ b/udapi/block/mwe/slavic_past.py
@@ -0,0 +1,156 @@
+#!/usr/bin/env python3
+
+# Past tense of Slavic languages
+
+from udapi.core.block import Block
+import importlib
+import sys
+
+class Slavic_past(Block):
+	def __init__(self, writer_prefix='',**kwargs):
+		super().__init__(**kwargs)
+		if writer_prefix != '':
+			writer_module = ".".join([writer_prefix,'writer'])
+		else:
+			writer_module = 'writer'
+		try:
+			module = importlib.import_module(writer_module)
+		except ModuleNotFoundError as e:
+			print(e, file=sys.stderr)
+			print("Try to set writer_prefix parameter.", file=sys.stderr)
+			exit(1)
+
+		self.wr = module.Writer()
+
+	def get_person_for_langs_with_simple_past(self, node, person):
+		"""
+		returns the person which is known from subject, languages with the simple past tense (e. g. Russian) do not express person in these verb forms
+		if the person was not taken from the subject, the third person would be filled in automatically due to languages ​​with a compound past but simple forms for the third person  (e. g. Czech)
+		"""
+		subj = [x for x in node.children if x.udeprel == "nsubj"]
+		if subj:
+			subj = subj[0]
+			if subj.feats['Person'] != '':
+				person = subj.feats['Person']
+		return person
+
+	def process_node(self, node):
+
+		cop = [x for x in node.children if x.udeprel == "cop" and x.feats['Tense'] == 'Past']
+
+		# compound past tense
+		if node.feats['VerbForm'] == 'Part' and node.upos == 'VERB' and node.feats['Voice'] != 'Pass':
+			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Pres']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			
+			phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in refl] + [x.ord for x in neg]
+			phrase_ords.sort()
+			
+			aux_cnd = [x for x in node.children if x.feats['Mood'] == 'Cnd' or x.deprel == 'aux:cnd'] # we don't want to mark l-participles in the conditional as past tense
+			if len(aux_cnd) == 0:
+				if len(aux) > 0:
+					person = aux[0].feats['Person']
+
+				elif len(aux) == 0:
+					person = '3'
+
+
+				self.wr.write_node_info(node,
+						tense='Past',
+						person=person,
+						number=node.feats['Number'],
+						mood='Ind',
+						voice=self.wr.get_voice(node,refl),
+						aspect=node.feats['Aspect'],
+						form='Fin',
+						polarity=self.wr.get_polarity(node,neg),
+						reflex=self.wr.get_is_reflex(node,refl),
+						ords=phrase_ords,
+						gender=node.feats['Gender'],
+						animacy=node.feats['Animacy']
+						)
+
+		# the past tense of some Slavic languages ​​is formed only by a verb without an auxiliary verb (e.g. Polish)
+		elif node.feats['Tense'] == 'Past' and node.upos == 'VERB' and node.feats['VerbForm'] != 'Conv':
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			
+			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+			phrase_ords.sort()
+
+			self.wr.write_node_info(node,
+				tense='Past',
+				person=node.feats['Person'],
+				number=node.feats['Number'],
+				mood='Ind',
+				voice=self.wr.get_voice(node,refl),
+				aspect=node.feats['Aspect'],
+				form=node.feats['VerbForm'],
+				polarity=self.wr.get_polarity(node,neg),
+				reflex=self.wr.get_is_reflex(node,refl),
+				ords=phrase_ords,
+				gender=node.feats['Gender'],
+				animacy=node.feats['Animacy']
+				)
+			
+			
+		# passivum
+		elif node.upos == 'ADJ' and node.feats['Voice'] == 'Pass' and len(cop) == 0:	
+			aux_past_tense = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Past']
+			aux_cnd = [x for x in node.children if x.feats['Mood'] == 'Cnd' or x.deprel == 'aux:cnd'] # we don't want to mark l-participles in the conditional as past tense
+			if len(aux_cnd) == 0:
+				if len(aux_past_tense) > 0:
+					aux_pres_tense = [x for x in  node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Pres'] # e. g. the auxiliary 'jsem' in the phrase 'byl jsem přinucen'
+					neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+					phrase_ords = [node.ord] + [x.ord for x in aux_past_tense] + [x.ord for x in aux_pres_tense] + [x.ord for x in neg]
+					phrase_ords.sort()
+					
+					person = '3'
+					if aux_pres_tense:
+						person = aux_pres_tense[0].feats['Person']
+					person = self.get_person_for_langs_with_simple_past(node, person)
+
+					self.wr.write_node_info(node,
+						tense='Past',
+						person=person,
+						number=aux_past_tense[0].feats['Number'],
+						mood='Ind',
+						voice='Pass',
+						form='Fin',
+						aspect=node.feats['Aspect'],
+						polarity=self.wr.get_polarity(aux_past_tense[0],neg),
+						ords=phrase_ords,
+						gender=node.feats['Gender'],
+						animacy=node.feats['Animacy']
+						)
+				
+		else:
+			aux_cnd = [x for x in node.children if x.feats['Mood'] == 'Cnd' or x.deprel == 'aux:cnd'] # we don't want to mark l-participles in the conditional as past tense
+			if len(cop) > 0 and len(aux_cnd) == 0:
+				aux_past_tense = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Pres']
+				prep = [x for x in node.children if x.upos == 'ADP']
+				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+
+				phrase_ords = [node.ord] + [x.ord for x in aux_past_tense] + [x.ord for x in cop] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
+				phrase_ords.sort()
+
+				person = '3'
+				if aux_past_tense:
+					person = aux_past_tense[0].feats["Person"]
+				person = self.get_person_for_langs_with_simple_past(node, person)
+				
+				self.wr.write_node_info(node,
+					tense='Past',
+					person=person,
+					number=cop[0].feats['Number'],
+					mood='Ind',
+					voice=self.wr.get_voice(node, refl),
+					form='Fin',
+					reflex=self.wr.get_is_reflex(node,refl),
+					polarity=self.wr.get_polarity(cop[0],neg),
+					ords=phrase_ords,
+					gender=cop[0].feats['Gender'],
+					animacy=cop[0].feats['Animacy']
+					)
diff --git a/udapi/block/mwe/slavic_pres.py b/udapi/block/mwe/slavic_pres.py
new file mode 100644
index 00000000..9ab9545d
--- /dev/null
+++ b/udapi/block/mwe/slavic_pres.py
@@ -0,0 +1,104 @@
+#!/usr/bin/env python3
+
+# Present tense of Slavic languages
+
+from udapi.core.block import Block
+import importlib
+import sys
+
+class Slavic_pres(Block):
+	def __init__(self, writer_prefix='',**kwargs):
+		super().__init__(**kwargs)
+		if writer_prefix != '':
+			writer_module = ".".join([writer_prefix,'writer'])
+		else:
+			writer_module = 'writer'
+		try:
+			module = importlib.import_module(writer_module)
+		except ModuleNotFoundError as e:
+			print(e, file=sys.stderr)
+			print("Try to set writer_prefix parameter.", file=sys.stderr)
+			exit(1)
+
+		self.wr = module.Writer()
+		
+	def process_node(self,node):
+		# the condition VerbForm == 'Fin' ensures that there are no transgressives between the found verbs
+		
+		if node.feats['Tense'] == 'Pres' and node.upos == 'VERB' and node.feats['VerbForm'] == 'Fin': #and node.feats['Aspect']=='Imp':
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			aux_forb = [x for x in node.children if x.upos == 'AUX' and (x.lemma == 'ќе' or x.lemma == 'ще' or x.feats['Mood'] == 'Cnd')] # forbidden auxiliaries for present tense (these auxiliaries are used for the future tense or the conditional mood)
+
+			if len(aux_forb) == 0:
+				phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+				phrase_ords.sort()
+				
+				self.wr.write_node_info(node,
+					tense='Pres',
+					person=node.feats['Person'],
+					number=node.feats['Number'],
+					mood='Ind',
+					aspect=node.feats['Aspect'],
+					voice=self.wr.get_voice(node,refl),
+					form='Fin',
+					polarity=self.wr.get_polarity(node,neg),
+					reflex=self.wr.get_is_reflex(node,refl),
+					ords=phrase_ords
+					)
+				return
+				
+
+		# passive voice
+		if node.upos == 'ADJ' and node.feats['Voice'] == 'Pass':
+			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Pres' and x.lemma != 'hteti' and x.lemma != 'htjeti']
+			aux_forb = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] != 'Pres'] # we don't want the past passive (e. g. 'byl jsem poučen' in Czech)
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			
+			phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in neg]
+			phrase_ords.sort()
+			
+			if len(aux) > 0 and len(aux_forb) == 0:
+				auxVerb = aux[0]
+
+				self.wr.write_node_info(node,
+					tense='Pres',
+					person=auxVerb.feats['Person'],
+					number=auxVerb.feats['Number'],
+					mood='Ind',
+					aspect=node.feats['Aspect'],
+					form='Fin',
+					voice='Pass',
+					polarity=self.wr.get_polarity(auxVerb,neg),
+					ords=phrase_ords,
+					gender=node.feats['Gender'],
+					animacy=node.feats['Animacy']
+					)
+				return
+
+		cop = [x for x in node.children if x.udeprel == "cop" and x.feats['Tense'] == "Pres"]
+		aux = [x for x in node.children if x.udeprel == "aux" and x.feats['Mood'] == "Ind" and x.feats['Tense'] == 'Pres']
+		aux_forb = [x for x in node.children if x.upos == 'AUX' and x.feats['Tense'] != 'Pres'] # in Serbian this can be a future tense
+		prep = [x for x in node.children if x.upos == 'ADP']
+		neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+		refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			
+		if len(cop) > 0 and len(aux_forb) == 0:
+			copVerb = cop[0]
+				
+			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in aux] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
+			phrase_ords.sort()
+				
+			self.wr.write_node_info(node,
+					tense='Pres',
+					person=copVerb.feats['Person'],
+					number=copVerb.feats['Number'],
+					aspect=node.feats['Aspect'],
+					mood='Ind',
+					form='Fin',
+					voice=self.wr.get_voice(node, refl),
+					reflex=self.wr.get_is_reflex(node, refl),
+					polarity=self.wr.get_polarity(copVerb,neg),
+					ords=phrase_ords
+				)
+
diff --git a/udapi/block/mwe/slavic_transgressive.py b/udapi/block/mwe/slavic_transgressive.py
new file mode 100644
index 00000000..4ffbdaea
--- /dev/null
+++ b/udapi/block/mwe/slavic_transgressive.py
@@ -0,0 +1,96 @@
+#!/usr/bin/env python3
+
+# Transgressives of Slavic languages
+
+from udapi.core.block import Block
+import importlib
+import sys
+
+class Slavic_transgressive(Block):
+	def __init__(self, writer_prefix='',**kwargs):
+		super().__init__(**kwargs)
+		if writer_prefix != '':
+			writer_module = ".".join([writer_prefix,'writer'])
+		else:
+			writer_module = 'writer'
+		try:
+			module = importlib.import_module(writer_module)
+		except ModuleNotFoundError as e:
+			print(e, file=sys.stderr)
+			print("Try to set writer_prefix parameter.", file=sys.stderr)
+			exit(1)
+
+		self.wr = module.Writer()
+	
+	def process_node(self, node):
+		# condition node.upos == 'VERB' to prevent copulas from entering this branch
+		if node.feats['VerbForm'] == 'Conv' and node.upos == 'VERB':
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			
+			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+			phrase_ords.sort()
+			
+			self.wr.write_node_info(node,
+				person=node.feats['Person'],
+				number=node.feats['Number'],
+				form='Conv',
+				tense=node.feats['Tense'],
+				aspect=node.feats['Aspect'],
+				polarity=self.wr.get_polarity(node,neg),
+				reflex=self.wr.get_is_reflex(node,refl),
+				ords=phrase_ords,
+				gender=node.feats['Gender'],
+				animacy=node.feats['Animacy'],
+				voice=self.wr.get_voice(node, refl)
+				)
+
+		# passive voice
+		elif node.upos == 'ADJ':
+			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['VerbForm'] == 'Conv']
+			
+			if len(aux) > 0:
+				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+				auxVerb = aux[0]
+				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in neg]
+				phrase_ords.sort()
+			
+				self.wr.write_node_info(node,
+					person=auxVerb.feats['Person'],
+					number=auxVerb.feats['Number'],
+					form='Conv',
+					tense=auxVerb.feats['Tense'],
+					aspect=node.feats['Aspect'],
+					polarity=self.wr.get_polarity(auxVerb,neg),
+					ords=phrase_ords,
+					gender=auxVerb.feats['Gender'],
+					animacy=auxVerb.feats['Animacy'],
+					voice='Pass'
+				)
+
+		# copulas
+		else:
+			cop = [x for x in node.children if x.udeprel == 'cop' and x.feats['VerbForm'] == 'Conv']
+			
+			if len(cop) > 0:
+				prep = [x for x in node.children if x.upos == 'ADP']
+				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			
+				copVerb = cop[0]
+				phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
+				phrase_ords.sort()
+
+				
+				self.wr.write_node_info(node,
+					person=copVerb.feats['Person'],
+					number=copVerb.feats['Number'],
+					tense=copVerb.feats['Tense'],
+					gender=copVerb.feats['Gender'],
+					animacy=copVerb.feats['Animacy'],
+					form='Conv',
+					polarity=self.wr.get_polarity(node,neg),
+					ords=phrase_ords,
+					voice=self.wr.get_voice(node, refl)
+					)
+

From c4784b639bc9f07ebf4f80085902f51f4522ffba Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 23 Dec 2024 22:54:39 +0100
Subject: [PATCH 1181/1374] Phrase features to MS features.

---
 udapi/block/mwe/msfinit.py | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/udapi/block/mwe/msfinit.py b/udapi/block/mwe/msfinit.py
index 7f0eb185..da83c19a 100644
--- a/udapi/block/mwe/msfinit.py
+++ b/udapi/block/mwe/msfinit.py
@@ -3,6 +3,7 @@
 Initialization. Copies features from FEATS as MSF* attributes to MISC.
 """
 from udapi.core.block import Block
+import re
 
 class MsfInit(Block):
 
@@ -39,3 +40,14 @@ def process_node(self, node):
                 node.misc['MSFCase'] = 'Nom'
             elif node.udeprel == 'obj':
                 node.misc['MSFCase'] = 'Acc'
+        # If the node contains Phrase features in MISC (periphrastic verb forms
+        # detected by Lenka's code), replace the MS features with them.
+        phrasefeatures = [x for x in node.misc if re.match(r"^Phrase[A-Z]", x)]
+        for pf in phrasefeatures:
+            msf = pf
+            if msf == 'PhraseForm':
+                msf = 'MSFVerbForm'
+            else:
+                msf = re.sub(r"Phrase", 'MSF', pf)
+            node.misc[msf] = node.misc[pf]
+            node.misc[pf] = ''

From 0890479e589100d8e94750d1f1f662457e07fe17 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 24 Dec 2024 15:59:44 +0100
Subject: [PATCH 1182/1374] Create abstract nodes for missing subjects.

---
 udapi/block/mwe/msfcreateabstract.py | 33 ++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 udapi/block/mwe/msfcreateabstract.py

diff --git a/udapi/block/mwe/msfcreateabstract.py b/udapi/block/mwe/msfcreateabstract.py
new file mode 100644
index 00000000..ca3521fd
--- /dev/null
+++ b/udapi/block/mwe/msfcreateabstract.py
@@ -0,0 +1,33 @@
+"""
+Morphosyntactic features (UniDive):
+Create abstract nodes representing dropped arguments of predicates (if verbal
+morphology signals that the subject is third person singular, and there is no
+subject node, create an abstract node and copy the features there).
+"""
+from udapi.core.block import Block
+import re
+
+class MsfCreateAbstract(Block):
+
+    def process_node(self, node):
+        """
+        If a node has MSFVerbForm=Fin and at least one of the agreement features
+        MSFNumber, MSFPerson, MSFGender, MSFAnimacy, MSFPolite, assume that these
+        features characterize the subject (this block is not suitable for languages
+        with polypersonal agreement). Check that the subject is present. If not,
+        create an abstract node to represent it.
+        """
+        if node.misc['MSFVerbForm'] == 'Fin' and any([node.misc[x] for x in ['MSFNumber', 'MSFPerson', 'MSFGender', 'MSFAnimacy', 'MSFPolite']]):
+            # Current node is a finite predicate. Does it have a subject? If not, create an abstract one.
+            if not any([x.udeprel in ['nsubj', 'csubj'] for x in node.children]):
+                # There could already be an abstract subject. We have to look for it in the enhanced graph.
+                if not any([re.match(r"^[nc]subj", edep['deprel']) for edep in node.deps]):
+                    # Create an abstract subject.
+                    subject = node.create_empty_child('nsubj')
+                    subject.upos = 'PRON'
+                    subject.feats['PronType'] = 'Prs'
+                    for f in ['Number', 'Person', 'Gender', 'Animacy', 'Polite']:
+                        msf = 'MSF' + f
+                        if node.misc[msf]:
+                            subject.feats[f] = node.misc[msf]
+                            subject.misc[msf] = node.misc[msf]

From 8c047c3d0cf330ca66b0a9c80fc31787288b7474 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 24 Dec 2024 16:09:01 +0100
Subject: [PATCH 1183/1374] Make sure that MS features of the abstract subject
 survive.

---
 udapi/block/mwe/msfcreateabstract.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/mwe/msfcreateabstract.py b/udapi/block/mwe/msfcreateabstract.py
index ca3521fd..7175eb9e 100644
--- a/udapi/block/mwe/msfcreateabstract.py
+++ b/udapi/block/mwe/msfcreateabstract.py
@@ -26,8 +26,10 @@ def process_node(self, node):
                     subject = node.create_empty_child('nsubj')
                     subject.upos = 'PRON'
                     subject.feats['PronType'] = 'Prs'
+                    subject.misc['MSFPronType'] = 'Prs'
                     for f in ['Number', 'Person', 'Gender', 'Animacy', 'Polite']:
                         msf = 'MSF' + f
                         if node.misc[msf]:
                             subject.feats[f] = node.misc[msf]
                             subject.misc[msf] = node.misc[msf]
+                    subject.misc['MSFFunc'] = 'No'

From 3cb1a53baa625befbc5e796861ba067dfbc87bc3 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 24 Dec 2024 16:17:03 +0100
Subject: [PATCH 1184/1374] Case for abstract subjects.

---
 udapi/block/mwe/msfcreateabstract.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/mwe/msfcreateabstract.py b/udapi/block/mwe/msfcreateabstract.py
index 7175eb9e..c3f08bdf 100644
--- a/udapi/block/mwe/msfcreateabstract.py
+++ b/udapi/block/mwe/msfcreateabstract.py
@@ -27,6 +27,8 @@ def process_node(self, node):
                     subject.upos = 'PRON'
                     subject.feats['PronType'] = 'Prs'
                     subject.misc['MSFPronType'] = 'Prs'
+                    subject.feats['Case'] = 'Nom'
+                    subject.misc['MSFCase'] = 'Nom'
                     for f in ['Number', 'Person', 'Gender', 'Animacy', 'Polite']:
                         msf = 'MSF' + f
                         if node.misc[msf]:

From 3b95c0e0044f670e1e77be06f1fea66b8dceb366 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 20 Jan 2025 16:39:49 +0100
Subject: [PATCH 1185/1374] Removed unused import.

---
 udapi/block/ud/fixpseudocop.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/udapi/block/ud/fixpseudocop.py b/udapi/block/ud/fixpseudocop.py
index ecc5f0bd..f4d9a1ec 100644
--- a/udapi/block/ud/fixpseudocop.py
+++ b/udapi/block/ud/fixpseudocop.py
@@ -2,7 +2,6 @@
    but they should be treated as normal verbs (with secondary predication)
    instead."""
 from udapi.core.block import Block
-import logging
 import re
 
 class FixPseudoCop(Block):

From ebf6e394b1dfc6ad29fe20b4dbd72d0c51a4a319 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 21 Jan 2025 10:59:18 +0100
Subject: [PATCH 1186/1374] Tokenization.

---
 tutorial/udapi-tutorial-dz.odt | Bin 201247 -> 201577 bytes
 tutorial/udapi-tutorial-dz.pdf | Bin 334412 -> 336517 bytes
 2 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/tutorial/udapi-tutorial-dz.odt b/tutorial/udapi-tutorial-dz.odt
index aba91234a8f850276b647e58bfb7810fc6d422be..73e4058852f195b87a156f7d11089b5a10b5abd0 100644
GIT binary patch
delta 59467
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
Vc=P|GRHr?o14v*ekN_Xb{|6!xzq|kd

delta 59255
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

diff --git a/tutorial/udapi-tutorial-dz.pdf b/tutorial/udapi-tutorial-dz.pdf
index 54b5f8d127fc025590b8f611683b1fd6ad5fb545..b58a13d29b2502af1106b0ebc6983f7ba58b075b 100644
GIT binary patch
delta 40950
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
K4ecE4mHrPs5bv)5

delta 39482
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


From d152845c0147a1612a2cdc27a5ebdec399c4bdee Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 7 Feb 2025 21:00:58 +0100
Subject: [PATCH 1187/1374] Minor.

---
 udapi/block/util/joinsentence.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/udapi/block/util/joinsentence.py b/udapi/block/util/joinsentence.py
index d83ba1c3..578f3865 100644
--- a/udapi/block/util/joinsentence.py
+++ b/udapi/block/util/joinsentence.py
@@ -3,7 +3,6 @@
 """
 import logging
 from udapi.core.block import Block
-from udapi.core.root import Root
 
 class JoinSentence(Block):
     """

From febfe532bb9f4ecaf1b55bb6258e7348fd1d88c8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Mar 2025 12:38:57 +0100
Subject: [PATCH 1188/1374] =?UTF-8?q?Czech=20compound=20preposition=20"tv?=
 =?UTF-8?q?=C3=A1=C5=99=C3=AD=20v=20tv=C3=A1=C5=99=20+=20dative".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index e99c2821..1b5980d4 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -156,6 +156,7 @@ class FixEdeprels(Block):
         'takže':            'takže', # remove morphological case
         'takže_a':          'takže',
         'třebaže':          'třebaže', # remove morphological case
+        'tvář_v_tvář':      'tváří_v_tvář:dat',
         'u':                'u:gen',
         'u_příležitost':    'u_příležitosti:gen',
         'uprostřed':        'uprostřed:gen',

From 9aba7037f8b80543bad8c46ac2a7922656c4f432 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Mar 2025 12:56:34 +0100
Subject: [PATCH 1189/1374] More Czech multiword prepositions.

---
 udapi/block/ud/cs/fixedeprels.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 1b5980d4..97ea2e95 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -19,10 +19,12 @@ class FixEdeprels(Block):
         'jakkoli': [], # 'jakkoliv' se převede na 'jakkoli' dole
         'jako':    [],
         'jakoby':  ['jakoby_pod:ins'], # these instances in FicTree should be spelled 'jako by'
+        'když':    [],
         'než':     ['než_aby'],
         'protože': [],
         'takže':   [],
-        'třebaže': []
+        'třebaže': [],
+        'že':      []
     }
 
     # Secondary prepositions sometimes have the lemma of the original part of
@@ -90,6 +92,7 @@ class FixEdeprels(Block):
         'na_od':            'na_rozdíl_od:gen',
         'na_podklad':       'na_podkladě:gen',
         'na_rozdíl_od':     'na_rozdíl_od:gen',
+        'na_účet':          'na_účet:gen',
         'na_újma':          'gen', # 'nebude na újmu' is a multi-word predicate but 'na újmu' is probably not used as an independent oblique modifier
         'na_úroveň':        'na_úrovni:gen',
         'na_úsek':          'na_úseku:gen',
@@ -162,8 +165,11 @@ class FixEdeprels(Block):
         'uprostřed':        'uprostřed:gen',
         'uvnitř':           'uvnitř:gen',
         'v_analogie_s':     'v_analogii_s:ins',
+        'v_blízkost':       'v_blízkosti:gen',
+        'v_čas':            'v_čase:gen',
         'v_čelo':           'v_čele:gen',
         'v_čelo_s':         'v_čele_s:ins',
+        'v_doba':           'v_době:gen',
         'v_dohoda_s':       'v_dohodě_s:ins',
         'v_duch':           'v_duchu:gen',
         'v_důsledek':       'v_důsledku:gen',
@@ -219,6 +225,7 @@ class FixEdeprels(Block):
         'vina':             'vinou:gen',
         'vliv':             'vlivem:gen',
         'vůči':             'vůči:dat',
+        'výměna_za':        'výměnou_za:acc',
         'vzhledem':         'vzhledem_k:dat',
         'vzhledem_k':       'vzhledem_k:dat',
         'z':                'z:gen',

From 944096eccbdb6e1c10a5ccaee4db55fd8e84a124 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Mar 2025 13:13:35 +0100
Subject: [PATCH 1190/1374] More Czech multiword prepositions.

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 97ea2e95..fe224ec0 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -115,6 +115,7 @@ class FixEdeprels(Block):
         'oproti':           'oproti:dat',
         'po_v':             'po:loc',
         'po_doba':          'po_dobu:gen',
+        'po_stránka':       'po_stránce:gen',
         'po_vzor':          'po_vzoru:gen',
         'poblíž':           'poblíž:gen',
         'počátek':          'počátkem:gen',

From c1a9cd5c2300bedafd3066794deba250906aaa5a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Mar 2025 14:07:43 +0100
Subject: [PATCH 1191/1374] More Czech multiword prepositions.

---
 udapi/block/ud/cs/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index fe224ec0..321e5c0c 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -73,6 +73,7 @@ class FixEdeprels(Block):
         'jako_kupříkladu':  'jako',
         'jakoby':           'jako',
         'jakoby_pod':       'pod:ins',
+        'jakožto':          'jako',
         'jelikož_do':       'jelikož',
         'jestli_že':        'jestliže',
         'k':                'k:dat',
@@ -119,6 +120,7 @@ class FixEdeprels(Block):
         'po_vzor':          'po_vzoru:gen',
         'poblíž':           'poblíž:gen',
         'počátek':          'počátkem:gen',
+        'počínaje':         'počínaje:ins',
         'počínat':          'počínaje:ins',
         'pod_dojem':        'pod_dojmem:gen',
         'pod_vliv':         'pod_vlivem:gen',

From fb951a87403f9efb7da4fb24cb32f7ab3c57e189 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Mar 2025 15:54:50 +0100
Subject: [PATCH 1192/1374] More Czech multiword prepositions.

---
 udapi/block/ud/cs/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 321e5c0c..19de03f1 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -13,6 +13,7 @@ class FixEdeprels(Block):
     outermost = {
         'ač':      [],
         'ačkoli':  [], # 'ačkoliv' se převede na 'ačkoli' dole
+        'ať':      [],
         'byť':     [],
         'i_když':  [],
         'jak':     [],
@@ -21,6 +22,7 @@ class FixEdeprels(Block):
         'jakoby':  ['jakoby_pod:ins'], # these instances in FicTree should be spelled 'jako by'
         'když':    [],
         'než':     ['než_aby'],
+        'nežli':   [],
         'protože': [],
         'takže':   [],
         'třebaže': [],

From 5f66efc8d5d3acbe5023873176f652f99ead2bc3 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Mar 2025 16:02:47 +0100
Subject: [PATCH 1193/1374] More Czech multiword prepositions.

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 19de03f1..68b9d8f5 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -11,6 +11,7 @@ class FixEdeprels(Block):
     # by all the inner cases.
     # The list in the value contains exceptions that should be left intact.
     outermost = {
+        'aby':     [],
         'ač':      [],
         'ačkoli':  [], # 'ačkoliv' se převede na 'ačkoli' dole
         'ať':      [],

From d54bb7015a788f3cc84289292f4b504676e3325a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Mar 2025 16:16:26 +0100
Subject: [PATCH 1194/1374] More Czech multiword prepositions.

---
 udapi/block/ud/cs/fixedeprels.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 68b9d8f5..8286c370 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -68,6 +68,7 @@ class FixEdeprels(Block):
         'do_rozpor_s':      'do_rozporu_s:ins',
         'do_soulad_s':      'do_souladu_s:ins',
         'forma':            'formou:gen',
+        'hledět_na':        'nehledě_na:acc',
         'i_když':           'i_když', # remove morphological case
         'jak_aby':          'jak',
         'jak_ad':           'jak',
@@ -81,6 +82,7 @@ class FixEdeprels(Block):
         'jestli_že':        'jestliže',
         'k':                'k:dat',
         'k_konec':          'ke_konci:gen',
+        'k_prospěch':       'ku_prospěchu:gen',
         'kdykoliv':         'kdykoli',
         'kol':              'kolem:gen',
         'kolem':            'kolem:gen',
@@ -105,6 +107,7 @@ class FixEdeprels(Block):
         'na_závěr':         'na_závěr:gen',
         'namísto':          'namísto:gen',
         'namísto_do':       'do:gen',
+        'napospas':         'napospas:dat',
         'narozdíl_od':      'na_rozdíl_od:gen',
         'následek':         'následkem:gen',
         'navzdory':         'navzdory:dat',
@@ -118,6 +121,7 @@ class FixEdeprels(Block):
         'okolo':            'okolo:gen',
         'oproti':           'oproti:dat',
         'po_v':             'po:loc',
+        'po_bok':           'po_boku:gen',
         'po_doba':          'po_dobu:gen',
         'po_stránka':       'po_stránce:gen',
         'po_vzor':          'po_vzoru:gen',
@@ -127,6 +131,7 @@ class FixEdeprels(Block):
         'počínat':          'počínaje:ins',
         'pod_dojem':        'pod_dojmem:gen',
         'pod_vliv':         'pod_vlivem:gen',
+        'pod_záminka':      'pod_záminkou:gen',
         'podle':            'podle:gen',
         'pomoc':            'pomocí:gen',
         'pomocí':           'pomocí:gen',
@@ -143,6 +148,7 @@ class FixEdeprels(Block):
         'přestože':         'přestože', # remove morphological case
         'při':              'při:loc',
         'při_příležitost':  'při_příležitosti:gen',
+        'ruka_v_ruka_s':    'ruku_v_ruce_s:ins',
         's_ohled_k':        's_ohledem_k:dat',
         's_ohled_na':       's_ohledem_na:acc',
         's_pomoc':          's_pomocí:gen',
@@ -199,6 +205,7 @@ class FixEdeprels(Block):
         'v_případ':         'v_případě:gen',
         'v_případ_že':      'v_případě_že',
         'v_rámec':          'v_rámci:gen',
+        'v_reakce_na':      'v_reakci_na:acc',
         'v_rozpor_s':       'v_rozporu_s:ins',
         'v_řada':           'v_řadě:gen',
         'v_shoda_s':        've_shodě_s:ins',
@@ -228,8 +235,10 @@ class FixEdeprels(Block):
         'v_znamení':        've_znamení:gen',
         'včetně':           'včetně:gen',
         'vedle':            'vedle:gen',
+        'versus':           'versus:nom',
         'vina':             'vinou:gen',
         'vliv':             'vlivem:gen',
+        'vlivem':           'vlivem:gen',
         'vůči':             'vůči:dat',
         'výměna_za':        'výměnou_za:acc',
         'vzhledem':         'vzhledem_k:dat',

From 1b3f0405f7140540a7a1e90b6acd62c51bba3770 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Mar 2025 21:59:51 +0100
Subject: [PATCH 1195/1374] More Czech multiword prepositions.

---
 udapi/block/ud/cs/fixedeprels.py | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 8286c370..1fe7f3bc 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -24,6 +24,7 @@ class FixEdeprels(Block):
         'když':    [],
         'než':     ['než_aby'],
         'nežli':   [],
+        'pokud':   [],
         'protože': [],
         'takže':   [],
         'třebaže': [],
@@ -55,8 +56,10 @@ class FixEdeprels(Block):
         'bez_ohled_na':     'bez_ohledu_na:acc',
         'bez_zřetel_k':     'bez_zřetele_k:dat',
         'bez_zřetel_na':    'bez_zřetele_na:acc',
+        'blízko':           'blízko:dat',
         'blíž':             'blízko:dat',
         'cesta':            'cestou:gen',
+        'coby':             'coby', # remove morphological case
         'daleko':           'nedaleko:gen',
         'daleko_od':        'od:gen',
         'dík':              'díky:dat',
@@ -68,8 +71,10 @@ class FixEdeprels(Block):
         'do_rozpor_s':      'do_rozporu_s:ins',
         'do_soulad_s':      'do_souladu_s:ins',
         'forma':            'formou:gen',
+        'formou':           'formou:gen',
         'hledět_na':        'nehledě_na:acc',
         'i_když':           'i_když', # remove morphological case
+        'i_pro':            'pro:acc',
         'jak_aby':          'jak',
         'jak_ad':           'jak',
         'jakkoliv':         'jakkoli',
@@ -89,6 +94,7 @@ class FixEdeprels(Block):
         'konec':            'koncem:gen',
         'krom':             'kromě:gen',
         'kromě':            'kromě:gen',
+        'li_jako':          'li',
         'liž':              'li',
         'mezi_uvnitř':      'uvnitř:gen',
         'na_báze':          'na_bázi:gen',
@@ -105,6 +111,7 @@ class FixEdeprels(Block):
         'na_základ':        'na_základě:gen',
         'na_základna':      'na_základně:gen',
         'na_závěr':         'na_závěr:gen',
+        'na_zda':           'na:loc', # na tom, zda a v jaké formě...
         'namísto':          'namísto:gen',
         'namísto_do':       'do:gen',
         'napospas':         'napospas:dat',
@@ -138,6 +145,7 @@ class FixEdeprels(Block):
         'postup':           'postupem:gen',
         'pouze_v':          'v:loc',
         'pro':              'pro:acc',
+        'pro_aby':          'pro:acc',
         'prostřednictví':   'prostřednictvím:gen',
         'prostřednictvím':  'prostřednictvím:gen',
         'proti':            'proti:dat',
@@ -147,6 +155,7 @@ class FixEdeprels(Block):
         'přes':             'přes:acc',
         'přestože':         'přestože', # remove morphological case
         'při':              'při:loc',
+        'při_pro':          'při:loc',
         'při_příležitost':  'při_příležitosti:gen',
         'ruka_v_ruka_s':    'ruku_v_ruce_s:ins',
         's_ohled_k':        's_ohledem_k:dat',
@@ -192,12 +201,14 @@ class FixEdeprels(Block):
         'v_konfrontace_s':  'v_konfrontaci_s:ins',
         'v_kontext_s':      'v_kontextu_s:ins',
         'v_na':             'na:loc',
+        'v_neprospěch':     'v_neprospěch:gen',
         'v_oblast':         'v_oblasti:gen',
         'v_oblast_s':       's:ins',
         'v_obor':           'v_oboru:gen',
         'v_otázka':         'v_otázce:gen',
         'v_podoba':         'v_podobě:gen',
         'v_poměr_k':        'v_poměru_k:dat',
+        'v_porovnání_s':    'v_porovnání_s:ins',
         'v_proces':         'v_procesu:gen',
         'v_prospěch':       've_prospěch:gen',
         'v_protiklad_k':    'v_protikladu_k:dat',
@@ -224,6 +235,8 @@ class FixEdeprels(Block):
         'v_s_spolupráce':   've_spolupráci_s:ins',
         'v_srovnání_s':     've_srovnání_s:ins',
         'v_srovnání_se':    've_srovnání_s:ins',
+        'v_stav':           've_stavu:gen',
+        'v_stín':           've_stínu:gen',
         'v_světlo':         've_světle:gen',
         'v_věc':            've_věci:gen',
         'v_vztah_k':        've_vztahu_k:dat',
@@ -251,6 +264,7 @@ class FixEdeprels(Block):
         'z_strana':         'ze_strany:gen',
         'z_nedostatek':     'z_nedostatku:gen',
         'z_titul':          'z_titulu:gen',
+        'z_začátek':        'ze_začátku:gen',
         'za_pomoc':         'za_pomoci:gen',
         'za_účast':         'za_účasti:gen',
         'za_účel':          'za_účelem:gen',

From 2a28f11915730d3cc2daf8128c42a0c57ea1dd2c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Mar 2025 15:24:38 +0100
Subject: [PATCH 1196/1374] A temporary hack to silence the UD validator about
 https://github.com/UniversalDependencies/UD_Czech-PDT/issues/10#issuecomment-2710721703

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 1fe7f3bc..df9699ee 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -54,6 +54,7 @@ class FixEdeprels(Block):
         'během':            'během:gen',
         'bez':              'bez:gen',
         'bez_ohled_na':     'bez_ohledu_na:acc',
+        'bez_na':           'bez_ohledu_na:acc', ###!!! a temporary hack to silence the validator about (https://github.com/UniversalDependencies/UD_Czech-PDT/issues/10#issuecomment-2710721703)
         'bez_zřetel_k':     'bez_zřetele_k:dat',
         'bez_zřetel_na':    'bez_zřetele_na:acc',
         'blízko':           'blízko:dat',

From 34c80eeb387ef7c5db7e8f134cb74bef004d255c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 10 Mar 2025 15:44:11 +0100
Subject: [PATCH 1197/1374] advcl:pro:acc (byl by pro, abychom...)

---
 udapi/block/ud/cs/fixedeprels.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index df9699ee..182acd0b 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -303,13 +303,13 @@ def process_node(self, node):
         for edep in node.deps:
             m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):', edep['deprel'])
             if m:
-                bdeprel = m.group(1)
                 solved = False
                 # Issues caused by errors in the original annotation must be fixed early.
                 # Especially if acl|advcl occurs with a preposition that unambiguously
                 # receives a morphological case in the subsequent steps, and then gets
                 # flagged as solved.
                 edep['deprel'] = re.sub(r'^advcl:do(?::gen)?$', r'obl:do:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
+                edep['deprel'] = re.sub(r'^advcl:pro(?::acc)?$', r'advcl:aby', edep['deprel']) # byl by pro, abychom... ###!!! Opravit i konverzi stromu.
                 edep['deprel'] = re.sub(r'^acl:k(?::dat)?$', r'acl', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:k(?::dat)?$', r'obl:k:dat', edep['deprel']) ###!!! Ale měli bychom opravit i závislost v základním stromu!
                 edep['deprel'] = re.sub(r'^advcl:místo(?::gen)?$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'

From 7fe5fbec5451438d5aab35fd155962b3314f6f18 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Mar 2025 18:16:07 +0100
Subject: [PATCH 1198/1374] Redundant.

Rules for compatibility between UPOS and DEPREL are now part of the UD validator and any updates, if needed, are done there.

https://github.com/UniversalDependencies/docs/issues/691#issuecomment-2725233714
---
 udapi/block/ud/markbugs.py | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index 2204eb4f..7161af86 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -180,14 +180,6 @@ def process_node(self, node):
         if upos == 'PUNCT' and node.is_nonprojective_gap() and not parent.is_nonprojective_gap():
             self.log(node, 'punct-nonproj-gap', 'upos=PUNCT and causing a non-projectivity')
 
-        # http://universaldependencies.org/u/dep/cc.html says
-        #   "cc is the relation between a conjunct and a preceding
-        #   [coordinating conjunction](http://universaldependencies.org/u/pos/CCONJ)."
-        # No other upos is allowed in the documentation, although e.g. PART is common in the data.
-        # There are clear cases of adverbs in role of cc (e.g. "respektive" in Swedish and Czech).
-        if udeprel == 'cc' and upos not in ('CCONJ', 'ADV'):
-            self.log(node, 'cc-upos', "deprel=cc upos!=CCONJ (but %s): " % upos)
-
         if udeprel == 'cop':
             lemma = node.lemma if node.lemma != '_' else form
             self.cop_nodes[lemma].append(node)

From 9d7af1b269cbbdce838e4c2d73524021cefa9efe Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Mar 2025 18:23:54 +0100
Subject: [PATCH 1199/1374] The Degree feature has become more complex over
 time.

The UD validator can now work with pre-registered language-upos-feature-value combinations and it seems better to let the validator alone identify such errors.

https://github.com/UniversalDependencies/docs/issues/691#issuecomment-2725233714
---
 udapi/block/ud/markbugs.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index 7161af86..5f8cd463 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -127,10 +127,6 @@ def process_node(self, node):
             if not feats['Mood']:
                 self.log(node, 'finverb-mood', 'VerbForm=Fin but Mood feature is missing')
 
-        if feats['Degree'] and upos not in ('ADJ', 'ADV'):
-            self.log(node, 'degree-upos',
-                     'Degree=%s upos!=ADJ|ADV (but %s)' % (feats['Degree'], upos))
-
         subject_children = [n for n in node.children if 'subj' in n.udeprel and n.sdeprel != 'outer']
         if len(subject_children) > 1:
             self.log(node, 'multi-subj', 'More than one (non-outer) [nc]subj child')

From 90df8d2478015b7895a2a4fd64c688b8102d1397 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Mar 2025 18:32:54 +0100
Subject: [PATCH 1200/1374] It is not clear whether "obj" and "ccomp" cannot
 co-occur (while two "obj" cannot).

https://github.com/UniversalDependencies/docs/issues/691#issuecomment-2725233714
---
 udapi/block/ud/markbugs.py | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index 5f8cd463..bf47ed75 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -131,7 +131,15 @@ def process_node(self, node):
         if len(subject_children) > 1:
             self.log(node, 'multi-subj', 'More than one (non-outer) [nc]subj child')
 
-        object_children = [n for n in node.children if n.udeprel in ('obj', 'ccomp')]
+        # Since "ccomp" is considered a clausal counterpart of "obj" in UD v2,
+        # one may conclude that "obj" and "ccomp" are mutually exclusive.
+        # However, this has always be a gray zone and people have occasionally
+        # brought up examples where they would want the two relations to co-occur.
+        # Also, there is no clausal counterpart for "iobj", which may cause some
+        # of the problems. It is probably safer not to consider "ccomp" in this
+        # test. Nevertheless, two "obj" under the same parent are definitely an
+        # error.
+        object_children = [n for n in node.children if n.udeprel == 'obj']
         if len(object_children) > 1:
             self.log(node, 'multi-obj', 'More than one obj|ccomp child')
 

From 2b1af68e441f0798ce61ce846ea9efc54fc466f5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 16 Mar 2025 20:55:07 +0100
Subject: [PATCH 1201/1374] "pod tlakem"

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 182acd0b..2ec8a0e9 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -138,6 +138,7 @@ class FixEdeprels(Block):
         'počínaje':         'počínaje:ins',
         'počínat':          'počínaje:ins',
         'pod_dojem':        'pod_dojmem:gen',
+        'pod_tlak':         'pod_tlakem:gen',
         'pod_vliv':         'pod_vlivem:gen',
         'pod_záminka':      'pod_záminkou:gen',
         'podle':            'podle:gen',

From 38ef7cd30634c5645b8fe43a3f5cb2f3aa42f6de Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 17 Mar 2025 12:25:12 +0100
Subject: [PATCH 1202/1374] =?UTF-8?q?Czech=20prep=20"na=20stran=C4=9B=20+?=
 =?UTF-8?q?=20gen".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 2ec8a0e9..b9b14317 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -105,6 +105,7 @@ class FixEdeprels(Block):
         'na_od':            'na_rozdíl_od:gen',
         'na_podklad':       'na_podkladě:gen',
         'na_rozdíl_od':     'na_rozdíl_od:gen',
+        'na_strana':        'na_straně:gen',
         'na_účet':          'na_účet:gen',
         'na_újma':          'gen', # 'nebude na újmu' is a multi-word predicate but 'na újmu' is probably not used as an independent oblique modifier
         'na_úroveň':        'na_úrovni:gen',

From 227a84721a71c43f9f228443ced5da63cd3c04b2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 17 Mar 2025 14:01:12 +0100
Subject: [PATCH 1203/1374] =?UTF-8?q?"kdy=C5=BE=20ne"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index b9b14317..8b48c5d3 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -323,6 +323,7 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^acl:v$', r'nmod:v:loc', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:v_duchu?(?::gen)?$', r'obl:v_duchu:gen', edep['deprel'])
+                edep['deprel'] = re.sub(r'^nmod:když.*$', r'nmod', edep['deprel']) # nadějí když ne na zbohatnutí, tak alespoň na dobrou obživu ###!!! perhaps "když" or "když ne" should be analyzed as "cc" here!
                 # Removing 'až' must be done early. The remainder may be 'počátek'
                 # and we will want to convert it to 'počátkem:gen'.
                 edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])

From f82f64adca33bcb181783dea9ad30a588b08c843 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 17 Mar 2025 15:25:27 +0100
Subject: [PATCH 1204/1374] =?UTF-8?q?Czech=20compound=20preposition=20"na?=
 =?UTF-8?q?=20za=C4=8D=C3=A1tku"=20+=20gen.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 8b48c5d3..81b2a211 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -110,6 +110,7 @@ class FixEdeprels(Block):
         'na_újma':          'gen', # 'nebude na újmu' is a multi-word predicate but 'na újmu' is probably not used as an independent oblique modifier
         'na_úroveň':        'na_úrovni:gen',
         'na_úsek':          'na_úseku:gen',
+        'na_začátek':       'na_začátku:gen',
         'na_základ':        'na_základě:gen',
         'na_základna':      'na_základně:gen',
         'na_závěr':         'na_závěr:gen',

From d18a3c565d4291748fa3561e21bed1f42d91afa3 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 18 Mar 2025 13:00:43 +0100
Subject: [PATCH 1205/1374] Czech secondary preposition "koncem".

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 81b2a211..df05789b 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -92,6 +92,7 @@ class FixEdeprels(Block):
         'kdykoliv':         'kdykoli',
         'kol':              'kolem:gen',
         'kolem':            'kolem:gen',
+        'koncem':           'koncem:gen',
         'konec':            'koncem:gen',
         'krom':             'kromě:gen',
         'kromě':            'kromě:gen',

From 7afb75bf21eda9540c616ca50b1a749e49768d82 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 18 Mar 2025 13:03:13 +0100
Subject: [PATCH 1206/1374] =?UTF-8?q?Czech=20secondary=20preposition=20"po?=
 =?UTF-8?q?=C4=8D=C3=A1tkem".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index df05789b..d1938ba4 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -138,6 +138,7 @@ class FixEdeprels(Block):
         'po_vzor':          'po_vzoru:gen',
         'poblíž':           'poblíž:gen',
         'počátek':          'počátkem:gen',
+        'počátkem':         'počátkem:gen',
         'počínaje':         'počínaje:ins',
         'počínat':          'počínaje:ins',
         'pod_dojem':        'pod_dojmem:gen',

From de64dd401f8598ee2ba3ec7a221ebfeb689fb0a6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 19 Mar 2025 15:18:45 +0100
Subject: [PATCH 1207/1374] __str__ for mentions and entities for easier
 debugging

---
 udapi/core/coref.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index c17f239f..98dc8d84 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -257,6 +257,10 @@ def span(self):
     def span(self, new_span):
         self.words = span_to_nodes(self._head.root, new_span)
 
+    def __str__(self):
+        """String representation of the CorefMention object: Mention<m.entity.eid: m.head>."""
+        return f"Mention<{self._entity._eid}: {self._head}>"
+
 
 @functools.total_ordering
 class CorefMentionSubspan(object):
@@ -386,6 +390,11 @@ def all_bridging(self):
                 for b in m._bridging:
                     yield b
 
+    def __str__(self):
+        """String representation of the CorefEntity object: Entity<e.eid: m.head>."""
+        first_mention_head = self._mentions[0].head.form if self._mentions else ""
+        return f"Entity<{self._eid}: {first_mention_head}>"
+
 
 # BridgingLink
 # Especially the relation should be mutable, so we cannot use

From 4c08d405b95dba452d4abbc1360fabee371010db Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 20 Mar 2025 23:01:20 +0100
Subject: [PATCH 1208/1374] mention.remove()

---
 udapi/core/coref.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/udapi/core/coref.py b/udapi/core/coref.py
index 98dc8d84..aa27e6a7 100644
--- a/udapi/core/coref.py
+++ b/udapi/core/coref.py
@@ -261,6 +261,11 @@ def __str__(self):
         """String representation of the CorefMention object: Mention<m.entity.eid: m.head>."""
         return f"Mention<{self._entity._eid}: {self._head}>"
 
+    def remove(self):
+        for word in self._words:
+            word._mentions.remove(self)
+        self._entity._mentions.remove(self)
+
 
 @functools.total_ordering
 class CorefMentionSubspan(object):

From 0044636282213f6fdd991a5bcfa0d15295b258c2 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 21 Mar 2025 20:48:54 +0100
Subject: [PATCH 1209/1374] udapy should end with a non-zero exit code (1) in
 case of exceptions

fixes #127
---
 bin/udapy | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/bin/udapy b/bin/udapy
index 528e3577..30cb2595 100755
--- a/bin/udapy
+++ b/bin/udapy
@@ -71,6 +71,20 @@ else:
 logging.basicConfig(format='%(asctime)-15s [%(levelname)7s] %(funcName)s - %(message)s',
                     level=level)
 
+# Global flag to track if an unhandled exception occurred
+_unhandled_exception_occurred = False
+
+def _custom_excepthook(exc_type, exc_value, traceback):
+    global _unhandled_exception_occurred
+    _unhandled_exception_occurred = True
+
+    # Call the default excepthook to allow normal error reporting
+    sys.__excepthook__(exc_type, exc_value, traceback)
+
+# Override the default excepthook
+sys.excepthook = _custom_excepthook
+
+
 # Process and provide the scenario.
 if __name__ == "__main__":
 
@@ -86,7 +100,13 @@ if __name__ == "__main__":
     # Udapi documents have a many cyclic references, so running GC is quite slow.
     if not args.gc:
         gc.disable()
-        atexit.register(os._exit, 0)
+        # When an exception/error has happened, udapy should exit with a non-zero exit code,
+        # so that users can use `udapy ... || echo "Error detected"` (or Makefile reports errors).
+        # However, we cannot use `atexit.register(lambda: os._exit(1 if sys.exc_info()[0] else 0))`
+        # because the Python has already exited the exception-handling block
+        # (the exception/error has been already reported and sys.exc_info()[0] is None).
+        # We thus keep record whether _unhandled_exception_occurred.
+        atexit.register(lambda: os._exit(1 if _unhandled_exception_occurred else 0))
         atexit.register(sys.stderr.flush)
     if args.save:
         args.scenario = args.scenario + ['write.Conllu']

From fae6dbde6c11e4ba8f6086ffa9a0a337c6288f52 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 23 Mar 2025 13:59:09 +0100
Subject: [PATCH 1210/1374] Tutorial: Coreference visualization.

---
 tutorial/udapi-tutorial-dz.odt | Bin 201577 -> 239910 bytes
 tutorial/udapi-tutorial-dz.pdf | Bin 336517 -> 365645 bytes
 2 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/tutorial/udapi-tutorial-dz.odt b/tutorial/udapi-tutorial-dz.odt
index 73e4058852f195b87a156f7d11089b5a10b5abd0..db90d7a2e334782fcfe337cc986446c352979ef5 100644
GIT binary patch
delta 74082
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
M9wg2J;KS&D0Ai9n<p2Nx

delta 35532
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

diff --git a/tutorial/udapi-tutorial-dz.pdf b/tutorial/udapi-tutorial-dz.pdf
index b58a13d29b2502af1106b0ebc6983f7ba58b075b..3eccd767a28ac84817a34dc95c91d19deead20c9 100644
GIT binary patch
delta 100041
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%0D}PY2*7F%_AQ99W(0_Yj_6yG`^(i
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

delta 71438
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


From bff06511c40e472b7e6e5014434252b04de0c51e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 23 Mar 2025 18:32:43 +0100
Subject: [PATCH 1211/1374] Saving an interesting query example provided by
 Martin.

---
 tutorial/udapi-tutorial-dz.odt | Bin 239910 -> 257678 bytes
 tutorial/udapi-tutorial-dz.pdf | Bin 365645 -> 380027 bytes
 2 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/tutorial/udapi-tutorial-dz.odt b/tutorial/udapi-tutorial-dz.odt
index db90d7a2e334782fcfe337cc986446c352979ef5..bf00a628f564bcfc07a48da573785d9089c6cd14 100644
GIT binary patch
delta 52625
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

delta 34927
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
AAOHXW

diff --git a/tutorial/udapi-tutorial-dz.pdf b/tutorial/udapi-tutorial-dz.pdf
index 3eccd767a28ac84817a34dc95c91d19deead20c9..417b3531c19167b27cd490fec76fa2b1c942c759 100644
GIT binary patch
delta 27750
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
Ai~s-t

delta 14426
zcma)Dd6-qjmH*zm_XhhR3bLcZLs8;J->SN|7Dc34T8*ek&}dqerfoqKS^*v7lBa^8
zxQs@f61NY&Bt$Seu6Zs|M-emPGRFADnZZaLClm9{%oqKVF^<N`{OaD<-S5_EG31YQ
zpFXGR)Ty)l&Z+C?caDDj{!v%0DLr0Z`N!Jqn@${j&Ga#Ae*gQwzjNifFLpdJa?}e)
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


From 948de6add7939ea1eea98a193293a8c6df7ff29c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 25 Mar 2025 17:58:55 +0100
Subject: [PATCH 1212/1374] Regular expressions and the None value.

---
 tutorial/udapi-tutorial-dz.odt | Bin 257678 -> 258101 bytes
 tutorial/udapi-tutorial-dz.pdf | Bin 380027 -> 381708 bytes
 2 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/tutorial/udapi-tutorial-dz.odt b/tutorial/udapi-tutorial-dz.odt
index bf00a628f564bcfc07a48da573785d9089c6cd14..945483c2ba23ed6879fd9565d67a9fd5fcbff3f2 100644
GIT binary patch
delta 35887
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
Y`|AgCApHAJ8;5+BL9s(KWRQ;i59hz)`Tzg`

delta 35501
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
GH1|IV9aiE1

diff --git a/tutorial/udapi-tutorial-dz.pdf b/tutorial/udapi-tutorial-dz.pdf
index 417b3531c19167b27cd490fec76fa2b1c942c759..f220f7c2c5de4ba8682dba33267aadaf086c0b19 100644
GIT binary patch
delta 88862
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

delta 87436
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


From f349b82569a64a53c46627baa018d8b072efb0f3 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 26 Mar 2025 18:48:20 +0100
Subject: [PATCH 1213/1374] more informative info messages

- report also the parameters of each block
- report the filename which is being opened by a reader

This could help debugging (e.g. to quickly see which file caused an error)
---
 udapi/core/basereader.py |  3 +++
 udapi/core/run.py        | 15 ++++++++-------
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 9367f4c4..786cf598 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -121,6 +121,7 @@ def try_fast_load(self, document):
             if filehandle is None:
                 self.finished = True
                 return True
+        logging.info(f"Reading {self.files.filename}")
 
         while True:
             try:
@@ -209,6 +210,7 @@ def process_document(self, document):
                 if filehandle is None:
                     self.finished = True
                     return
+                logging.info(f"Reading {self.files.filename}")
 
             trees_loaded = 0
             while True:
@@ -216,6 +218,7 @@ def process_document(self, document):
                 if root is None:
                     if (trees_loaded == 0 or self.merge) and self.files.has_next_file():
                         filehandle = self.next_filehandle()
+                        logging.info(f"Reading {self.files.filename}")
                         continue
                     self.finished = not self.files.has_next_file()
                     break
diff --git a/udapi/core/run.py b/udapi/core/run.py
index f0cc976e..8ac63e1e 100644
--- a/udapi/core/run.py
+++ b/udapi/core/run.py
@@ -134,7 +134,8 @@ def _import_blocks(block_names, block_args):
         command = "b%s(**kwargs)" % block_id
         logging.debug("Trying to evaluate this: %s", command)
         new_block_instance = eval(command)  # pylint: disable=eval-used
-        blocks.append((block_name, new_block_instance))
+        args = ' '.join(f"{k}={v}" for k,v in kwargs.items())
+        blocks.append((block_name, new_block_instance, args))
 
     return blocks
 
@@ -169,11 +170,11 @@ def execute(self):
 
     def run_blocks(self, blocks):
         # Initialize blocks (process_start).
-        for bname, block in blocks:
+        for _, block, _ in blocks:
             block.process_start()
 
         readers = []
-        for bname, block in blocks:
+        for _, block, _ in blocks:
             try:
                 block.finished  # pylint: disable=pointless-statement
                 readers.append(block)
@@ -183,15 +184,15 @@ def run_blocks(self, blocks):
             logging.info('No reader specified, using read.Conllu')
             conllu_reader = Conllu()
             readers = [conllu_reader]
-            blocks = [('read.Conllu', conllu_reader)] + blocks
+            blocks = [('read.Conllu', conllu_reader, {})] + blocks
 
         # Apply blocks on the data.
         finished = False
         while not finished:
             document = Document()
             logging.info(" ---- ROUND ----")
-            for bname, block in blocks:
-                logging.info(f"Executing block {bname}")
+            for bname, block, args in blocks:
+                logging.info(f"Executing block {bname} {args}")
                 block.apply_on_document(document)
 
             finished = True
@@ -200,7 +201,7 @@ def run_blocks(self, blocks):
                 finished = finished and reader.finished
 
         # 6. close blocks (process_end)
-        for bname, block in blocks:
+        for _, block, _ in blocks:
             block.process_end()
 
         # Some users may use the block instances (e.g. to retrieve some variables).

From 7644d48fdadcc3d540710a6c3ffadd48e36230fd Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 26 Mar 2025 18:54:24 +0100
Subject: [PATCH 1214/1374] node._children is slightly faster than
 node.children

so it makes speed-critical internal code faster
---
 udapi/block/read/conll.py | 2 +-
 udapi/core/root.py        | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/udapi/block/read/conll.py b/udapi/block/read/conll.py
index f64cd9ff..2e82ef96 100644
--- a/udapi/block/read/conll.py
+++ b/udapi/block/read/conll.py
@@ -138,7 +138,7 @@ def read_tree_from_lines(self, lines):
                     root._children.append(node)
                 else:
                     raise ValueError(f"Detected a cycle: {node} attached to itself")
-            elif node.children:
+            elif node._children:
                 climbing = parent._parent
                 while climbing:
                     if climbing is node:
diff --git a/udapi/core/root.py b/udapi/core/root.py
index 1fd99fc7..abf36a74 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -144,7 +144,7 @@ def remove(self, children=None):
             The default (None) is to delete them (and all their descendants).
             `warn` means to issue a warning.
         """
-        if children is not None and self.children:
+        if children is not None and self._children:
             logging.warning('%s is being removed by remove(children=%s), '
                             ' but it has (unexpected) children', self, children)
         self.bundle.trees = [root for root in self.bundle.trees if root != self]
@@ -278,10 +278,10 @@ def steal_nodes(self, nodes):
             node.ord = new_ord
             node._root = self
             if not whole_tree:
-                for child in [n for n in node.children if n not in nodes]:
+                for child in [n for n in node._children if n not in nodes]:
                     child._parent = old_root
-                    old_root._children = sorted(old_root.children + [child])
-                node._children = [n for n in node.children if n in nodes]
+                    old_root._children = sorted(old_root._children + [child])
+                node._children = [n for n in node._children if n in nodes]
             if node.parent == old_root or (not whole_tree and node.parent not in nodes):
                 node.parent._children = [n for n in node.parent._children if n != node]
                 node._parent = self

From d2364846c6630487e2796809af5dbbf2060335ce Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 26 Mar 2025 18:55:49 +0100
Subject: [PATCH 1215/1374] CoNLL-UPlus reader

---
 udapi/block/read/conllup.py | 98 +++++++++++++++++++++++++++++++++++++
 1 file changed, 98 insertions(+)
 create mode 100644 udapi/block/read/conllup.py

diff --git a/udapi/block/read/conllup.py b/udapi/block/read/conllup.py
new file mode 100644
index 00000000..6f3ad708
--- /dev/null
+++ b/udapi/block/read/conllup.py
@@ -0,0 +1,98 @@
+""""Conllup is a reader block for the CoNLL-UPlus format.
+
+Columns which don't have standardize attributes in Udapi/CoNLL-U
+are stored in MISC (as key=value pairs).
+"""
+import json
+import logging
+import re
+
+import udapi.block.read.conll
+from udapi.core.root import Root
+from udapi.core.node import Node
+
+RE_GLOBAL_COLUMNS = re.compile(r'^# global.columns\s*=\s*(.+)')
+COLUMN_MAP = {
+    'ID': 'ord',
+}
+NORMAL_ATTRS = 'form lemma upos xpos feats deprel misc'.split()
+
+class Conllup(udapi.block.read.conll.Conll):
+    """A reader of the CoNLL-UPlus files."""
+
+    def __init__(self, attributes='autodetect', **kwargs):
+        """Create the Conllup reader object.
+
+        Args:
+        attributes: comma-separated list of column names in the input files
+            (can be used if the global.columns header is missing or needs to be overriden).
+            Default='autodetect' which means the column names will be loaded from the global.columns header.
+            For ignoring a column, use "_" as its name.
+        """
+        super().__init__(**kwargs)
+        if attributes == 'autodetect':
+            self.node_attributes = None
+        else:
+            self.node_attributes = attributes.split(',')
+
+    def parse_comment_line(self, line, root):
+        if self.node_attributes is None:
+            global_columns_match = RE_GLOBAL_COLUMNS.match(line)
+            if global_columns_match is None:
+                return super().parse_comment_line(line, root)
+            global_columns = global_columns_match.group(1)
+            self.node_attributes = [COLUMN_MAP.get(v, v.lower()) for v in global_columns.split(" ")]
+            root.comment += line + '\n'
+            return
+        return super().parse_comment_line(line, root)
+
+    def parse_node_line(self, line, root, nodes, parents, mwts):
+        fields = line.split('\t')
+        if len(fields) != len(self.node_attributes):
+            if self.strict:
+                raise RuntimeError('Wrong number of columns in %r' % line)
+            fields.extend(['_'] * (len(self.node_attributes) - len(fields)))
+
+        # multi-word tokens will be processed later
+        if '-' in fields[0]:
+            mwts.append(fields)
+            return
+        if '.' in fields[0]:
+            raise NotImplementedError("Empty nodes in CoNLL-UPlus not implement yet in read.Conllup")
+
+        # This implementation is slower than in read.Conllu,
+        # but it allows for arbitrary columns
+        node = root.create_child()
+        nonstandard_attrs = []
+        for (n_attribute, attribute_name) in enumerate(self.node_attributes):
+            value = fields[n_attribute]
+            if attribute_name == 'head':
+                if value == '???':
+                    value = 0
+                try:
+                    parents.append(int(value))
+                except ValueError as exception:
+                    if not self.strict and value == '_':
+                        if self.empty_parent == 'warn':
+                            logging.warning("Empty parent/head index in '%s'", line)
+                        parents.append(0)
+                    else:
+                        raise exception
+            elif attribute_name == 'ord':
+                setattr(node, 'ord', int(value))
+            elif attribute_name == 'deps':
+                setattr(node, 'raw_deps', value)
+            elif value == '_' and attribute_name != 'form':
+                pass
+            elif attribute_name == '_':
+                pass
+            elif attribute_name in NORMAL_ATTRS:
+                setattr(node, attribute_name, value)
+            else:
+                nonstandard_attrs.append([attribute_name, value])
+
+        # This needs to be done after node.misc is created (if "misc" in node.attributes)
+        for attribute_name, value in nonstandard_attrs:
+            node.misc[attribute_name.capitalize()] = value
+
+        nodes.append(node)

From 9fe64bf24cba199cc4079747d669d77e95518246 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 27 Mar 2025 15:42:29 +0100
Subject: [PATCH 1216/1374] nicer code

---
 udapi/block/read/conll.py | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/udapi/block/read/conll.py b/udapi/block/read/conll.py
index 2e82ef96..2229482f 100644
--- a/udapi/block/read/conll.py
+++ b/udapi/block/read/conll.py
@@ -79,22 +79,23 @@ def parse_node_line(self, line, root, nodes, parents, mwts):
         # but it allows for arbitrary columns
         node = root.create_child()
         for (n_attribute, attribute_name) in enumerate(self.node_attributes):
+            value = fields[n_attribute]
             if attribute_name == 'head':
                 try:
-                    parents.append(int(fields[n_attribute]))
+                    parents.append(int(value))
                 except ValueError as exception:
-                    if not self.strict and fields[n_attribute] == '_':
+                    if not self.strict and value == '_':
                         if self.empty_parent == 'warn':
                             logging.warning("Empty parent/head index in '%s'", line)
                         parents.append(0)
                     else:
                         raise exception
             elif attribute_name == 'ord':
-                setattr(node, 'ord', int(fields[n_attribute]))
+                setattr(node, 'ord', int(value))
             elif attribute_name == 'deps':
-                setattr(node, 'raw_deps', fields[n_attribute])
-            elif attribute_name != '_' and fields[n_attribute] != '_':
-                setattr(node, attribute_name, fields[n_attribute])
+                setattr(node, 'raw_deps', value)
+            elif attribute_name != '_' and value != '_':
+                setattr(node, attribute_name, value)
 
         nodes.append(node)
 

From 0d1d6fddb3a97205042865eb62d90d9605017a50 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 27 Mar 2025 15:43:00 +0100
Subject: [PATCH 1217/1374] tiny speedup

---
 udapi/block/read/conllu.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index bb76bfee..b485c17d 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -201,7 +201,7 @@ def read_tree_from_lines(self, lines):
                     root._children.append(node)
                 else:
                     raise ValueError(f"Detected a cycle: {node} attached to itself")
-            elif node.children:
+            elif node._children:
                 climbing = parent._parent
                 while climbing:
                     if climbing is node:

From 38f8c0b9f1a342ee86daa6e9b708bfb419d8a9ee Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 27 Mar 2025 15:43:50 +0100
Subject: [PATCH 1218/1374] check if IDs (node.ord) form a valid sequence in
 *.conll and *.conllup

There are e.g. files with gaps (1,2,3,5). Failing to detect this
results in wrong parsing and even `fix_cycles=1` may result in infinite loop.

When a node is created using `root.create_child()`,
it already has `node.ord` set up correctly as the last node in the tree.

For *.conllu we could do the same, but we don't do that
because Read.Conllu is speed critical
and invalid files can be detected using `validate.py`.
---
 udapi/block/read/conll.py   | 3 ++-
 udapi/block/read/conllup.py | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/udapi/block/read/conll.py b/udapi/block/read/conll.py
index 2229482f..61f8e422 100644
--- a/udapi/block/read/conll.py
+++ b/udapi/block/read/conll.py
@@ -91,7 +91,8 @@ def parse_node_line(self, line, root, nodes, parents, mwts):
                     else:
                         raise exception
             elif attribute_name == 'ord':
-                setattr(node, 'ord', int(value))
+                if int(value) != node._ord:
+                    raise ValueError(f"Node {node} ord mismatch: {value}, but expecting {node._ord} at:\n{line}")
             elif attribute_name == 'deps':
                 setattr(node, 'raw_deps', value)
             elif attribute_name != '_' and value != '_':
diff --git a/udapi/block/read/conllup.py b/udapi/block/read/conllup.py
index 6f3ad708..688f4656 100644
--- a/udapi/block/read/conllup.py
+++ b/udapi/block/read/conllup.py
@@ -79,7 +79,8 @@ def parse_node_line(self, line, root, nodes, parents, mwts):
                     else:
                         raise exception
             elif attribute_name == 'ord':
-                setattr(node, 'ord', int(value))
+                if int(value) != node._ord:
+                    raise ValueError(f"Node {node} ord mismatch: {value}, but expecting {node._ord} at:\n{line}")
             elif attribute_name == 'deps':
                 setattr(node, 'raw_deps', value)
             elif value == '_' and attribute_name != 'form':

From bfbfbff933cdc4383bdd861e794ce8d1d69269f7 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 28 Mar 2025 11:59:37 +0100
Subject: [PATCH 1219/1374] dos->unix line ends in corefud.FixParentheses

---
 udapi/block/corefud/fixparentheses.py | 62 +++++++++++++--------------
 1 file changed, 31 insertions(+), 31 deletions(-)
 mode change 100755 => 100644 udapi/block/corefud/fixparentheses.py

diff --git a/udapi/block/corefud/fixparentheses.py b/udapi/block/corefud/fixparentheses.py
old mode 100755
new mode 100644
index 9baeca98..bc8e6504
--- a/udapi/block/corefud/fixparentheses.py
+++ b/udapi/block/corefud/fixparentheses.py
@@ -1,31 +1,31 @@
-from udapi.core.block import Block
-
-
-class FixParentheses(Block):
-    """Find mentions that contain opening parenthesis but do not contain the closing one (or the other way around).
-    If the missing parenthesis is an immediate neighbour of the mention span, add it to the span."""
-
-    def __init__(self, mark=True, **kwargs):
-        super().__init__(**kwargs)
-        self.mark = mark
-
-    def process_coref_mention(self, mention):
-        words = [word.lemma for word in mention.words]
-        pairs = ['()', '[]', '{}']
-        for pair in pairs:
-            if pair[0] in words:
-                if not pair[1] in words and pair[1] in [node.lemma for node in mention.head.root.descendants]:
-                    if mention.words[-1].ord == int(mention.words[-1].ord) and mention.words[-1].next_node and \
-                            mention.words[-1].next_node.lemma == pair[1]:
-                        next_node = mention.words[-1].next_node
-                        mention.words.append(next_node)
-                        if self.mark:
-                            next_node.misc['Mark'] = 1
-
-            elif pair[1] in words and pair[0] in [node.lemma for node in mention.head.root.descendants]:
-                if mention.words[0].ord == int(mention.words[0].ord) and mention.words[0].prev_node \
-                        and mention.words[0].prev_node.lemma == pair[0]:
-                    prev_node = mention.words[0].prev_node
-                    mention.words.append(prev_node)
-                    if self.mark:
-                        prev_node.misc['Mark'] = 1
+from udapi.core.block import Block
+
+
+class FixParentheses(Block):
+    """Find mentions that contain opening parenthesis but do not contain the closing one (or the other way around).
+    If the missing parenthesis is an immediate neighbour of the mention span, add it to the span."""
+
+    def __init__(self, mark=True, **kwargs):
+        super().__init__(**kwargs)
+        self.mark = mark
+
+    def process_coref_mention(self, mention):
+        words = [word.lemma for word in mention.words]
+        pairs = ['()', '[]', '{}']
+        for pair in pairs:
+            if pair[0] in words:
+                if not pair[1] in words and pair[1] in [node.lemma for node in mention.head.root.descendants]:
+                    if mention.words[-1].ord == int(mention.words[-1].ord) and mention.words[-1].next_node and \
+                            mention.words[-1].next_node.lemma == pair[1]:
+                        next_node = mention.words[-1].next_node
+                        mention.words.append(next_node)
+                        if self.mark:
+                            next_node.misc['Mark'] = 1
+
+            elif pair[1] in words and pair[0] in [node.lemma for node in mention.head.root.descendants]:
+                if mention.words[0].ord == int(mention.words[0].ord) and mention.words[0].prev_node \
+                        and mention.words[0].prev_node.lemma == pair[0]:
+                    prev_node = mention.words[0].prev_node
+                    mention.words.append(prev_node)
+                    if self.mark:
+                        prev_node.misc['Mark'] = 1

From 133dcc519f39c39b8f4638a6a2f294c7ffea6508 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 28 Mar 2025 12:05:36 +0100
Subject: [PATCH 1220/1374] corefud.MarkPairs could substitute the other
 corefud.Mark* blocks

---
 udapi/block/corefud/markpairs.py | 138 +++++++++++++++++++++++++++++++
 1 file changed, 138 insertions(+)
 create mode 100644 udapi/block/corefud/markpairs.py

diff --git a/udapi/block/corefud/markpairs.py b/udapi/block/corefud/markpairs.py
new file mode 100644
index 00000000..cc63b387
--- /dev/null
+++ b/udapi/block/corefud/markpairs.py
@@ -0,0 +1,138 @@
+from udapi.core.block import Block
+import udapi.core.coref
+import itertools
+from collections import Counter
+import logging
+
+class MarkPairs(Block):
+    """Find pairs of coreference mentions within the same sentence with given properties.
+    Mark these pairs of mentions (using `misc["Mark"]`), so they can be further
+    processed or printed.
+
+    Usage:
+    # Find pairs of mentions of the same entity within the same sentence:
+    cat my.conllu | udapy -TM corefud.MarkPairs same_entity=1 | less -R
+
+    Properties:
+    same_entity - both mentions belong to the same entity (cluster)
+    both_continuous - both mentions have continuous spans
+    both_discontinuous - both mentions have discontinuous spans
+    nested - span of one mention is nested (a subset of) in the span of the other mention
+    crossing - spans are crossing (i.e. intersecting, but neither is subset of the other)
+    interleaved - spans are interleaved (i.e. not intersecting, but neither span precedes the other)
+    same_head - the same node is a head of both mentions
+    same_span - both mentions have the same span (which is invalid according to UD's validate.py)
+    same_subspan - at least one of the mentions is discontinuous and one of its subspans
+                   is also a subspan (or span) of the other mention
+
+
+    You can combine any number of properties.
+    Each property can have one of the three values:
+    include - this is the default value: include pairs with this property, i.e. ignore the property
+    exclude - exclude (from the marking) pairs of mentions with this property
+    only - pairs of mentions without this property will be excluded
+
+    As a shortcut, you can use -1 and 1 instead of exclude and only, so e.g.
+     nested=only same_head=exclude
+    can be written as
+     nested=1 same_head=-1
+    """
+
+    def __init__(self, same_entity=0, both_continuous=0, both_discontinuous=0,
+                 nested=0, crossing=0, interleaved=0,
+                 same_head=0, same_span=0, same_subspan=0,
+                 print_form=False, print_total=True, log=True, mark=True, **kwargs):
+        super().__init__(**kwargs)
+
+
+        self.same_entity = self._convert(same_entity)
+        self.both_continuous = self._convert(both_continuous)
+        self.both_discontinuous = self._convert(both_discontinuous)
+        self.nested = self._convert(nested)
+        self.crossing = self._convert(crossing)
+        self.interleaved = self._convert(interleaved)
+        self.same_head = self._convert(same_head)
+        self.same_span = self._convert(same_span)
+        self.same_subspan = self._convert(same_subspan)
+
+        self.print_form = print_form
+        self.print_total = print_total
+        self.log = log
+        self.mark = mark
+        self.counter = Counter()
+
+    def _convert(self, value):
+        if value in {-1, 0, 1}:
+            return value
+        if value == 'include':
+            return 0
+        if value == 'only':
+            return 1
+        if value == 'exclude':
+            return -1
+        raise ValueError('unknown value ' + value)
+
+    def _ok(self, condition, value):
+        if value == 0:
+            return True
+        return (condition and value == 1) or (not condition and value==-1)
+
+    def _print(self, mention):
+        if self.print_form:
+            return mention.entity.eid + ':' + ' '.join([w.form for w in mention.words])
+        else:
+            return mention.entity.eid + ':' + mention.span
+
+    def process_tree(self, tree):
+        mentions = set()
+        for node in tree.descendants_and_empty:
+            for m in node.coref_mentions:
+                mentions.add(m)
+        self.counter['mentions'] += len(mentions)
+
+        for mA, mB in itertools.combinations(mentions, 2):
+            self.counter['pairs'] += 1
+            if not self._ok(mA.entity == mB.entity, self.same_entity):
+                continue
+            if not self._ok(mA.head == mB.head, self.same_head):
+                continue
+
+            if self.both_continuous or self.both_discontinuous or self.same_span or self.same_subspan:
+                sA, sB = mA.span, mB.span
+                cA, cB = ',' not in sA, ',' not in sB
+                if not self._ok(cA and cB, self.both_continuous):
+                    continue
+                if not self._ok(not cA and not cB, self.both_discontinuous):
+                    continue
+                if not self._ok(sA == sB, self.same_span):
+                    continue
+                if not self._ok(set(sA.split(',')).intersection(set(sB.split(','))), self.same_subspan):
+                    continue
+
+            if self.nested or self.crossing or self.interleaved:
+                wA, wB = set(mA.words), set(mB.words)
+                if not self._ok(wA <= wB or wB <= wA, self.nested):
+                    continue
+                if not self._ok(wA.intersection(wB) and not wA <= wB and not wB <= wA, self.crossing):
+                    continue
+                if self.interleaved:
+                    a_precedes_b = mA.words[0] < mB.words[0] and mA.words[-1] < mB.words[0]
+                    b_precedes_a = mB.words[0] < mA.words[0] and mB.words[-1] < mA.words[0]
+                    if not self._ok(not wA.intersection(wB) and not a_precedes_b and not b_precedes_a, self.interleaved):
+                        continue
+
+            self.counter['matching'] += 1
+            if self.mark:
+                for w in mA.words + mB.words:
+                    w.misc['Mark'] = 1
+                mA.words[0].misc['Mark'] = f"{self._print(mA)}+{self._print(mB)}"
+            if self.log:
+                logging.info(f"Found mentions at {tree.sent_id}: {self._print(mA)} + {self._print(mB)}")
+
+    def after_process_document(self, doc):
+        if self.print_total:
+            #if self.max_trees and seen_trees > self.max_trees:
+            #    print(f'######## Only first {self.max_trees} matching mentions printed. Use max_trees=0 to see all.')
+            msg = f'######## Mentions = {self.counter["mentions"]}, matching/all pairs = {self.counter["matching"]} / {self.counter["pairs"]}'
+            logging.info(msg)
+            doc.meta["corefud.MarkPairs"] = msg

From d979bb8a73467f813f7521d2c01686b4fa47e548 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 28 Mar 2025 12:19:47 +0100
Subject: [PATCH 1221/1374] prepare release 0.4.0 of udapi

---
 CHANGES.txt | 5 +++++
 setup.cfg   | 4 ++--
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/CHANGES.txt b/CHANGES.txt
index 67ced748..49dfd40e 100644
--- a/CHANGES.txt
+++ b/CHANGES.txt
@@ -2,6 +2,11 @@ Udapi Change Log
 ----------------
 See https://github.com/udapi/udapi-python/commits/master for details.
 
+0.4.0 2024-03-28
+ - support for CorefUD 1.3
+ - edits by Dan Zeman in block.ud.*
+ - requires Python 3.9+ (difficult to test older versions in Circle-CI)
+
 0.3.0 2022-04-06
  - support for CorefUD 1.0 (new CoNLL-U format for coreference annotation)
  - edits by Dan Zeman in block.ud.*
diff --git a/setup.cfg b/setup.cfg
index a14145ab..3ac1ebf2 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -1,6 +1,6 @@
 [metadata]
 name = udapi
-version = 0.3.0
+version = 0.4.0
 author = Martin Popel
 author_email = popel@ufal.mff.cuni.cz
 description = Python framework for processing Universal Dependencies data
@@ -14,7 +14,7 @@ classifiers =
 
 [options]
 packages = find:
-python_requires = >=3.6
+python_requires = >=3.9
 include_package_data = True
 scripts =
     bin/udapy

From b86ac4c1cd28a28e3ca42d23dc31d34768dffd70 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 29 Mar 2025 21:47:40 +0100
Subject: [PATCH 1222/1374] =?UTF-8?q?"a=C4=8Dkoliv"=20=3D=20"a=C4=8Dkoli"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index d1938ba4..e4ddcbd6 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -14,6 +14,7 @@ class FixEdeprels(Block):
         'aby':     [],
         'ač':      [],
         'ačkoli':  [], # 'ačkoliv' se převede na 'ačkoli' dole
+        'ačkoliv': [], # ... ale možná ne když je doprovázeno předložkou
         'ať':      [],
         'byť':     [],
         'i_když':  [],

From e941cadbf673afb299430d1ff1b4759ac9155625 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 29 Mar 2025 22:05:29 +0100
Subject: [PATCH 1223/1374] =?UTF-8?q?"a=C4=8Dkoliv"=20=3D=20"a=C4=8Dkoli"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index e4ddcbd6..97cadb8d 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -328,6 +328,7 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:v_duchu?(?::gen)?$', r'obl:v_duchu:gen', edep['deprel'])
                 edep['deprel'] = re.sub(r'^nmod:když.*$', r'nmod', edep['deprel']) # nadějí když ne na zbohatnutí, tak alespoň na dobrou obživu ###!!! perhaps "když" or "když ne" should be analyzed as "cc" here!
+                edep['deprel'] = re.sub(r'^obl:ačkoli.*$', r'obl', edep['deprel']) # nadějí když ne na zbohatnutí, tak alespoň na dobrou obživu ###!!! perhaps "když" or "když ne" should be analyzed as "cc" here!
                 # Removing 'až' must be done early. The remainder may be 'počátek'
                 # and we will want to convert it to 'počátkem:gen'.
                 edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])

From 091bf8578bd86e8ad861f8156cd924e1c6abf6c5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 29 Mar 2025 22:23:42 +0100
Subject: [PATCH 1224/1374] =?UTF-8?q?"na=5Fpo=C4=8D=C3=A1tku:gen"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 97cadb8d..d31e1483 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -105,6 +105,7 @@ class FixEdeprels(Block):
         'na_mimo':          'na:loc', # na kurtě i mimo něj
         'na_než':           'na:acc', # na víc než čtyři a půl kilometru
         'na_od':            'na_rozdíl_od:gen',
+        'na_počátek':       'na_počátku:gen',
         'na_podklad':       'na_podkladě:gen',
         'na_rozdíl_od':     'na_rozdíl_od:gen',
         'na_strana':        'na_straně:gen',

From 116fe7b53e37c63d36e6b2196d136cf46e449964 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 29 Mar 2025 15:38:01 +0100
Subject: [PATCH 1225/1374] bugfix for read.Conll(up) fix_cycles=1

`node._parent = parent` will be called anyway even after fixing a cycle
The original code could result in not fixing the cycle
and then an infinite loop (when checking another node using "climbing").
---
 udapi/block/read/conll.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/udapi/block/read/conll.py b/udapi/block/read/conll.py
index 61f8e422..d0aef1ee 100644
--- a/udapi/block/read/conll.py
+++ b/udapi/block/read/conll.py
@@ -136,8 +136,7 @@ def read_tree_from_lines(self, lines):
             if node is parent:
                 if self.fix_cycles:
                     logging.warning("Ignoring a cycle (attaching to the root instead):\n%s", node)
-                    node._parent = root
-                    root._children.append(node)
+                    parent = root
                 else:
                     raise ValueError(f"Detected a cycle: {node} attached to itself")
             elif node._children:

From a8053df6911d12af9e0f33e2ad95f821e2ff1507 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 29 Mar 2025 16:46:42 +0100
Subject: [PATCH 1226/1374] read.Conllup save_global_columns

Don't store the `global.columns` header by default
(in Udapi docs and thus in CoNLL-U files)
---
 udapi/block/read/conllup.py | 10 ++++++++--
 udapi/core/basereader.py    |  2 +-
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/udapi/block/read/conllup.py b/udapi/block/read/conllup.py
index 688f4656..c87d729d 100644
--- a/udapi/block/read/conllup.py
+++ b/udapi/block/read/conllup.py
@@ -20,7 +20,7 @@
 class Conllup(udapi.block.read.conll.Conll):
     """A reader of the CoNLL-UPlus files."""
 
-    def __init__(self, attributes='autodetect', **kwargs):
+    def __init__(self, attributes='autodetect', save_global_columns=False, **kwargs):
         """Create the Conllup reader object.
 
         Args:
@@ -28,8 +28,13 @@ def __init__(self, attributes='autodetect', **kwargs):
             (can be used if the global.columns header is missing or needs to be overriden).
             Default='autodetect' which means the column names will be loaded from the global.columns header.
             For ignoring a column, use "_" as its name.
+        save_global_columns: keep the "global.columns" header in root.comments. Default=False.
+            Note that when saving the output to CoNLL-U, the comment is not needed
+            and it may be even misleading. It could be helpful only once write.Conllup is implemented
+            (with the possibility to use the same columns as in the input file).
         """
         super().__init__(**kwargs)
+        self.save_global_columns = save_global_columns
         if attributes == 'autodetect':
             self.node_attributes = None
         else:
@@ -42,7 +47,8 @@ def parse_comment_line(self, line, root):
                 return super().parse_comment_line(line, root)
             global_columns = global_columns_match.group(1)
             self.node_attributes = [COLUMN_MAP.get(v, v.lower()) for v in global_columns.split(" ")]
-            root.comment += line + '\n'
+            if self.save_global_columns:
+                root.comment += line[1:] + '\n'
             return
         return super().parse_comment_line(line, root)
 
diff --git a/udapi/core/basereader.py b/udapi/core/basereader.py
index 786cf598..c3bcf918 100644
--- a/udapi/core/basereader.py
+++ b/udapi/core/basereader.py
@@ -33,7 +33,7 @@ def __init__(self, files='-', filehandle=None, zone='keep', bundles_per_doc=0, e
         self.max_docs = max_docs
         self._docs_loaded = 0
         # `global.Entity` is a header stored in a comment before the first tree of each document in a given CoNLL-U file.
-        # In Udapi, it is stored in `document.meta['global.Entity']`, but for technical reasons, we need to temporarily store it in here, the reader.
+        # In Udapi, it is stored in `document.meta['global.Entity']`, but for technical reasons, we need to temporarily store it here, in the reader.
         # The reason is that `read.Conllu` uses a fast loading interface with `read_trees()`,
         # which reads all the trees in a file at once, but it does not have access to the document instance,
         # it just returns a sequence of trees (which may be split into multiple documents if `bundles_per_doc` is set).

From 74954b938b1c3c0e5f8338def8b947a32c6a4372 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 31 Mar 2025 15:25:26 +0200
Subject: [PATCH 1227/1374] =?UTF-8?q?"s=20v=C3=BDjimkou,=20=C5=BEe"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index d31e1483..086e468a 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -172,6 +172,7 @@ class FixEdeprels(Block):
         's_přihlédnutí_k':  's_přihlédnutím_k:dat',
         's_přihlédnutí_na': 's_přihlédnutím_na:acc',
         's_výjimka':        's_výjimkou:gen',
+        's_výjimka_že':     's_výjimkou_že',
         's_vyloučení':      's_vyloučením:gen',
         's_zřetel_k':       'se_zřetelem_k:dat',
         's_zřetel_na':      'se_zřetelem_na:acc',

From efea21caeee6422b763bf38ffee981050bccfd5e Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 31 Mar 2025 15:46:34 +0200
Subject: [PATCH 1228/1374] obl:jestli:gen

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 086e468a..b0bf1460 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -331,6 +331,7 @@ def process_node(self, node):
                 edep['deprel'] = re.sub(r'^advcl:v_duchu?(?::gen)?$', r'obl:v_duchu:gen', edep['deprel'])
                 edep['deprel'] = re.sub(r'^nmod:když.*$', r'nmod', edep['deprel']) # nadějí když ne na zbohatnutí, tak alespoň na dobrou obživu ###!!! perhaps "když" or "když ne" should be analyzed as "cc" here!
                 edep['deprel'] = re.sub(r'^obl:ačkoli.*$', r'obl', edep['deprel']) # nadějí když ne na zbohatnutí, tak alespoň na dobrou obživu ###!!! perhaps "když" or "když ne" should be analyzed as "cc" here!
+                edep['deprel'] = re.sub(r'^obl:jestli(?::gen)?$', r'obl:gen', edep['deprel']) # nevím, jestli osmého nebo devátého září
                 # Removing 'až' must be done early. The remainder may be 'počátek'
                 # and we will want to convert it to 'počátkem:gen'.
                 edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])

From 987ef5b885832a2aa603673cab893720599e336a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 31 Mar 2025 23:54:34 +0200
Subject: [PATCH 1229/1374] tiny typo

---
 udapi/block/read/conllup.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/udapi/block/read/conllup.py b/udapi/block/read/conllup.py
index c87d729d..2e66da52 100644
--- a/udapi/block/read/conllup.py
+++ b/udapi/block/read/conllup.py
@@ -1,9 +1,8 @@
-""""Conllup is a reader block for the CoNLL-UPlus format.
+"""Conllup is a reader block for the CoNLL-UPlus format.
 
 Columns which don't have standardize attributes in Udapi/CoNLL-U
 are stored in MISC (as key=value pairs).
 """
-import json
 import logging
 import re
 

From 07c6e7a10c73ba17b554c8a2a5614bcd3d2ce259 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 31 Mar 2025 23:55:22 +0200
Subject: [PATCH 1230/1374] corefud.Link2Cluster can convert bridging, added
 params and documentation

---
 udapi/block/corefud/link2cluster.py | 97 +++++++++++++++++++++++++----
 1 file changed, 85 insertions(+), 12 deletions(-)

diff --git a/udapi/block/corefud/link2cluster.py b/udapi/block/corefud/link2cluster.py
index 3f9f9bb3..08296531 100644
--- a/udapi/block/corefud/link2cluster.py
+++ b/udapi/block/corefud/link2cluster.py
@@ -2,17 +2,66 @@
 from udapi.core.block import Block
 
 class Link2Cluster(Block):
-    """Block corefud.Link2Cluster converts link-based coreference annotation to the (cluster-based) CorefUD format."""
+    """Block corefud.Link2Cluster converts link-based coreference annotation to the (cluster-based) CorefUD format.
 
-    def __init__(self, id_attr='proiel-id', ante_attr='antecedent-proiel-id', delete_orig_attrs=True, **kwargs):
+    Params:
+    id_attr: name of the attribute in MISC that stores the original-format IDs of nodes
+    ante_attr: name of the attribute in MISC that stores the ID of the antecedent
+        of the current node (in the same format as `id_attr`).
+    delete_orig_attrs: Should we delete the MISC attributes that were used for the conversion?
+        (i.e. id_attr and ante_attr, plus possibly also infstat_attr, coreftype_attr,
+        bridge_attr, bridge_relation_attr if these are used). Default=True.
+    infstat_attr: name of the attribute in MISC that stores the information status of a given mention
+        Will be stored in `mention.other['infstat']`. Use None for ignoring this.
+    coreftype_attr: name of the attribute in MISC that stores the coreference type of a given mention
+        Will be stored in `mention.other['coreftype']`. Use None for ignoring this.
+    bridge_attr: name of the attribute in MISC that stores the ID of the bridging antecedent
+        of the current node/mention (in the same format as `id_attr`).
+        Default=None, i.e. ignore this parameter.
+    bridge_relation_attr:  name of the attribute in MISC that stores the bridging relation type
+        (e.g. "part" or "subset"). Default=None, i.e. ignore this parameter.
+    eid_counter: use a global counter of entity.eid and start with a given number. Default=1.
+        The main goal of this parameter is to make eid unique across multiple documents.
+        If you use eid_counter=0, this feature will be turned off,
+        so entities will be created using `root.document.create_coref_entity()`,
+        with no eid parameter, so that the eid will start from "e1" in each document processed by this block.
+    """
+    def __init__(self, id_attr='proiel-id', ante_attr='antecedent-proiel-id', delete_orig_attrs=True,
+                 infstat_attr='information-status', coreftype_attr='coreftype',
+                 bridge_attr=None, bridge_relation_attr=None, eid_counter=1, **kwargs):
         super().__init__(**kwargs)
         self.id_attr = id_attr
         self.ante_attr = ante_attr
         self.delete_orig_attrs = delete_orig_attrs
+        self.infstat_attr = infstat_attr
+        self.coreftype_attr = coreftype_attr
+        self.bridge_attr = bridge_attr
+        self.bridge_relation_attr = bridge_relation_attr
+        self.eid_counter = int(eid_counter)
+
+    def _new_entity(self, doc):
+        if not self.eid_counter:
+            return doc.create_coref_entity()
+        entity = doc.create_coref_entity(eid=f"e{self.eid_counter}")
+        self.eid_counter += 1
+        return entity
+
+    def _new_mention(self, entity, node):
+        mention = entity.create_mention(head=node, words=[node])
+        if self.infstat_attr and node.misc[self.infstat_attr]:
+            mention.other['infstat'] = node.misc[self.infstat_attr]
+            if self.delete_orig_attrs:
+                del node.misc[self.infstat_attr]
+        if self.coreftype_attr and node.misc[self.coreftype_attr]:
+            mention.other['coreftype'] = node.misc[self.coreftype_attr]
+            if self.delete_orig_attrs:
+                del node.misc[self.coreftype_attr]
+        return mention
 
     def process_document(self, doc):
         id2node = {}
         links = []
+        bridges = []
         for node in doc.nodes_and_empty:
             this_id = node.misc[self.id_attr]
             if this_id != '':
@@ -26,6 +75,16 @@ def process_document(self, doc):
                 if self.delete_orig_attrs:
                     for attr in (self.id_attr, self.ante_attr):
                         del node.misc[attr]
+                if self.bridge_attr:
+                    bridge_id = node.misc[self.bridge_attr]
+                    if bridge_id != '':
+                        if bridge_id == this_id:
+                            logging.warning(f"{node} has a self-reference bridging {self.bridge_attr}={bridge_id}")
+                        else:
+                            bridges.append([bridge_id, this_id, node.misc[self.bridge_relation_attr]])
+                        if self.delete_orig_attrs:
+                            for attr in (self.bridge_attr, self.bridge_relation_attr):
+                                del node.misc[attr]
 
         # It seems faster&simpler to process the links in any order and implement entity merging,
         # rather than trying to sort the links so that no entity merging is needed.
@@ -36,14 +95,9 @@ def process_document(self, doc):
                 ante_node, this_node = id2node[ante_id], id2node[this_id]
                 if not this_node.coref_mentions and not ante_node.coref_mentions:
                     # None of the nodes is part of any mention/entity. Let's create them.
-                    entity = this_node.root.document.create_coref_entity()
-                    m_ante = entity.create_mention(head=ante_node, words=[ante_node])
-                    m_this = entity.create_mention(head=this_node, words=[this_node])
-                    for node, mention in ((ante_node, m_ante), (this_node, m_this)):
-                        if node.misc['information-status']:
-                            mention.other['infstat'] = node.misc['information-status']
-                            if self.delete_orig_attrs:
-                                del node.misc['information-status']
+                    entity = self._new_entity(this_node.root.document)
+                    self._new_mention(entity, ante_node)
+                    self._new_mention(entity, this_node)
                 elif this_node.coref_mentions and ante_node.coref_mentions:
                     # Both of the nodes are part of mentions in different entities.
                     # Let's merge the two entities (i.e. "steal" all mentions from the "ante" entity to "this" entity).
@@ -59,6 +113,25 @@ def process_document(self, doc):
                 else:
                     # Only one of the nodes is part of an entity. Let's add the second one to this entity.
                     if ante_node.coref_mentions:
-                        ante_node.coref_entities[0].create_mention(head=this_node, words=[this_node])
+                        self._new_mention(ante_node.coref_entities[0], this_node)
                     else:
-                        this_node.coref_entities[0].create_mention(head=ante_node, words=[ante_node])
+                        self._new_mention(this_node.coref_entities[0], ante_node)
+
+        # Bridging
+        for ante_id, this_id, relation in bridges:
+            if ante_id not in id2node:
+                logging.warning(f"{ante_id} is referenced in {self.bridge_attr}, but not in {self.id_attr}")
+            else:
+                ante_node, this_node = id2node[ante_id], id2node[this_id]
+                if ante_node.coref_mentions:
+                    m_ante = next(m for m in ante_node.coref_mentions if m.head is ante_node)
+                    e_ante = m_ante.entity
+                else:
+                    e_ante = self._new_entity(ante_node.root.document)
+                    m_ante = self._new_mention(e_ante, ante_node)
+                if this_node.coref_mentions:
+                    m_this = next(m for m in this_node.coref_mentions if m.head is this_node)
+                else:
+                    e_this = self._new_entity(this_node.root.document)
+                    m_this = self._new_mention(e_this, this_node)
+                m_this.bridging.append((e_ante, relation))

From efc1587a57f55b26c72e4c3fcd34337b34c31de7 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 1 Apr 2025 00:29:36 +0200
Subject: [PATCH 1231/1374] documenting that read.Conllup is not being used
 anywhere yet

---
 udapi/block/read/conllup.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/read/conllup.py b/udapi/block/read/conllup.py
index 2e66da52..16d83d07 100644
--- a/udapi/block/read/conllup.py
+++ b/udapi/block/read/conllup.py
@@ -2,6 +2,9 @@
 
 Columns which don't have standardize attributes in Udapi/CoNLL-U
 are stored in MISC (as key=value pairs).
+
+This code has been only tested on Hungarian KorKor files for CorefUD so far.
+However, in the end, it is not used there (xtsv files are used instead conllup).
 """
 import logging
 import re

From 63e3ba5349a9670667ff9a739e5146ad757deee5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 12 Apr 2025 15:38:37 +0200
Subject: [PATCH 1232/1374] =?UTF-8?q?-=C5=A5=20=3D=20-t=C4=9B=20=3D=20-ti.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/addmwt.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 202579b9..6ea27818 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -100,13 +100,13 @@ def multiword_analysis(self, node):
                     'main':   0,
                     'shape': 'subtree',
                 }
-            if subtokens[1] == 'ť':
+            if subtokens[1] in ['ť', 'tě', 'ti']:
                 if token_from_subtokens != node.form:
                     logging.warning("Concatenation of MISC 'AddMwt=%s' does not yield the FORM '%s'." % (node.misc['AddMwt'], node.form))
                     return None
                 node.misc['AddMwt'] = ''
                 return {
-                    'form':   node.form.lower()[:-1] + ' ť',
+                    'form':   node.form.lower()[:-1] + ' ' + subtokens[1],
                     'lemma':  '* ť',
                     'upos':   '* PART',
                     'xpos':   '* TT-------------',

From b799ee3e91b3a417e1d0ae70aeb7ed0b886badeb Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 12 Apr 2025 15:40:11 +0200
Subject: [PATCH 1233/1374] Bug fix.

---
 udapi/block/ud/cs/addmwt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 6ea27818..8bdebec8 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -106,7 +106,7 @@ def multiword_analysis(self, node):
                     return None
                 node.misc['AddMwt'] = ''
                 return {
-                    'form':   node.form.lower()[:-1] + ' ' + subtokens[1],
+                    'form':   subtokens[0] + ' ' + subtokens[1],
                     'lemma':  '* ť',
                     'upos':   '* PART',
                     'xpos':   '* TT-------------',

From 75cc308ae945377f2c67cc3532d0646c77f5fbea Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 12 Apr 2025 16:04:40 +0200
Subject: [PATCH 1234/1374] =?UTF-8?q?Old=20Czech=20"aby=C5=A1ta",=20"kdyby?=
 =?UTF-8?q?=C5=A1ta".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/addmwt.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 8bdebec8..7f3a4283 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -18,6 +18,9 @@
     'kdybychme': {'form': 'když bychme', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=1|VerbForm=Fin'},
     'abyste': {'form': 'aby byste', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=2|VerbForm=Fin'},
     'kdybyste': {'form': 'když byste', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=2|VerbForm=Fin'},
+    # Old Czech 'abyšta' == dual number; 2nd or 3rd person, the one example in data so far is 3rd.
+    'abyšta': {'form': 'aby byšta', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Dual|Person=3|VerbForm=Fin'},
+    'kdybyšta': {'form': 'když byšta', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Dual|Person=3|VerbForm=Fin'},
 }
 for v in MWTS.values():
     v['upos'] = 'SCONJ AUX'

From 78b54270e86f3581eb1d535e08b4b331e2f78f29 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 13 Apr 2025 13:12:15 +0200
Subject: [PATCH 1235/1374] Remove agreement features from predicates.

---
 udapi/block/mwe/msfcreateabstract.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/udapi/block/mwe/msfcreateabstract.py b/udapi/block/mwe/msfcreateabstract.py
index c3f08bdf..9a1c774a 100644
--- a/udapi/block/mwe/msfcreateabstract.py
+++ b/udapi/block/mwe/msfcreateabstract.py
@@ -35,3 +35,11 @@ def process_node(self, node):
                             subject.feats[f] = node.misc[msf]
                             subject.misc[msf] = node.misc[msf]
                     subject.misc['MSFFunc'] = 'No'
+            # Regardless of whether it had a subject or not, the agreement features
+            # should be removed from the verb.
+            ###!!! We also may want to check if the pre-existing subject has all the features.
+            node.misc['MSFNumber'] = ''
+            node.misc['MSFPerson'] = ''
+            node.misc['MSFGender'] = ''
+            node.misc['MSFAnimacy'] = ''
+            node.misc['MSFPolite'] = ''

From c52c3dfbb573d87663a936a4950ea14068b9aba5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 13 Apr 2025 21:19:25 +0200
Subject: [PATCH 1236/1374] Czech compound case markers.

---
 udapi/block/mwe/msfcase.py | 241 +++++++++++++++++++++++++++++++++++++
 1 file changed, 241 insertions(+)

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/mwe/msfcase.py
index 3d04eebf..f5516d0b 100644
--- a/udapi/block/mwe/msfcase.py
+++ b/udapi/block/mwe/msfcase.py
@@ -10,19 +10,35 @@ class MsfCase(Block):
     adposmap = {
         'v+Loc':          'Ine',
         'uvnitř+Gen':     'Ine',
+        'uvnitř+':        'Ine',
+        'mezi_uvnitř+Gen': 'Ine', # annotation error?
         'uprostřed+Gen':  'Ces',
         'mezi+Ins':       'Int',
+        'mezi+Nom':       'Int', # annotation error
+        'mezi+Voc':       'Int', # annotation error
         'vně+Gen':        'Ext',
+        'stranou+Gen':    'Ext',
+        'stranou+Dat':    'Ext',
         'na+Loc':         'Ade',
+        'na_mimo+Loc':    'Ade', # annotation error?
+        'na_úroveň+Gen':  'Ade',
+        'na_úroveň+':     'Ade',
+        'v_proces+Gen':   'Ade', # ???
         'v_rámec+Gen':    'Ade', # ???
+        'v_rámec+':       'Ade', # ???
+        'v_řada+Gen':     'Ade', # ???
+        'z_oblast+Gen':   'Ade', # ???
         'vedle+Gen':      'Apu',
         'u+Gen':          'Chz',
         'kolem+Gen':      'Cir',
+        'kol+Gen':        'Cir',
         'dokola+Gen':     'Cir',
         'okolo+Gen':      'Cir',
         'v_oblast+Gen':   'Cir',
+        'v_oblast+':      'Cir',
         'blízko+Dat':     'Prx',
         'blízko+Gen':     'Prx',
+        'blízko+':        'Prx',
         'nedaleko+Gen':   'Prx',
         'daleko+Gen':     'Prx', # lemma of 'nedaleko'
         'poblíž+Gen':     'Prx',
@@ -32,66 +48,134 @@ class MsfCase(Block):
         'vespod+Gen':     'Sub',
         'před+Ins':       'Ant',
         'vpředu+Gen':     'Ant',
+        'na_čelo+Gen':    'Ant',
+        'v_čelo+Gen':     'Ant',
+        'v_čelo+':        'Ant',
         'za+Ins':         'Pst',
         'naproti+Dat':    'Opp',
         'od+Gen':         'Abl',
+        'od+Dat':         'Abl', # annotation error
+        'směr_od+Gen':    'Abl',
+        'z_strana+Gen':   'Abl',
+        'z_strana+':      'Abl',
         'z+Gen':          'Ela',
+        'z+Nom':          'Ela', # annotation error
+        'z+Dat':          'Ela', # annotation error
         'zevnitř+Gen':    'Ela',
         'zprostřed+Gen':  'Cne',
         's+Gen':          'Del',
         'zpod+Gen':       'Sbe',
         'zpoza+Gen':      'Pse',
         'po+Loc':         'Per',
+        'cesta+Gen':      'Per',
+        'cesta+Ins':      'Per',
         'napříč+Gen':     'Crs',
         'napříč+Ins':     'Crs',
         'podél+Gen':      'Lng',
         'skrz+Acc':       'Inx',
         'přes+Acc':       'Spx',
+        'přes+Nom':       'Spx', # annotation error
         'ob+Acc':         'Cix',
         'po+Acc':         'Ter',
+        'po+Nom':         'Ter', # annotation error
+        'po+Gen':         'Ter', # annotation error
         'do+Gen':         'Ill',
+        'do+Acc':         'Ill', # annotation error
+        'do_/+Gen':       'Ill',
         'dovnitř+Gen':    'Ill',
         'doprostřed+Gen': 'Cnl',
         'mezi+Acc':       'Itl',
         'na+Acc':         'All',
+        'na+Nom':         'All', # annotation error
         'na+Gen':         'All', # annotation error
         'k+Dat':          'Apl',
+        'k+Nom':          'Apl', # annotation error
+        'vstříc+Dat':     'Apl',
+        'do_oblast+Gen':  'Apl',
+        'směr+':          'Apl',
+        'směr_k+Dat':     'Apl',
+        'směr_k+':        'Apl',
+        'směr_na+Acc':    'Apl',
+        'v_směr_k+Dat':   'Apl',
         'nad+Acc':        'Spl',
+        'nad+Nom':        'Spl', # annotation error
         'pod+Acc':        'Sbl',
         'před+Acc':       'Anl',
+        'před+Gen':       'Anl', # annotation error
         'za+Acc':         'Psl',
+        'dík_za+Acc':     'Psl', # annotation error?
         'dokud':          'Tan',
         'nežli':          'Tan',
         'v+Acc':          'Tem',
         'v+Nom':          'Tem', # annotation error
+        'v+Gen':          'Tem', # annotation error
+        'při_příležitost+Gen': 'Tem',
+        'současně_s+Ins': 'Tem',
+        'u_příležitost+Gen': 'Tem',
         'v_období+Gen':   'Tpx',
         'počátkem+Gen':   'Din',
+        'počátek+Gen':    'Din',
+        'počínat+Ins':    'Din',
+        'počínat+':       'Din',
         'začátkem+Gen':   'Din',
+        'začátek+Gen':    'Din',
         'během+Gen':      'Dur',
         'postupem+Gen':   'Dur',
+        'postup+Gen':     'Dur',
         'při+Loc':        'Dur',
         'v_průběh+Gen':   'Dur',
         'za+Gen':         'Der',
         'koncem+Gen':     'Dtr',
         'konec+Gen':      'Dtr',
+        'k_konec+Gen':    'Dtr',
+        'končit+Ins':     'Dtr',
         'závěrem+Gen':    'Dtr',
+        'závěr+Gen':      'Dtr',
+        'na_závěr+Gen':   'Dtr',
+        'v_závěr+Gen':    'Dtr',
         'jakmile':        'Tps',
         'jen_co':         'Tps',
+        'před_po+Loc':    'Tps',
         'počínaje+Ins':   'Teg',
         'jménem+Nom':     'Atr',
+        'jméno+Nom':      'Atr',
         'zdali':          'Atr',
         'že':             'Atr',
+        'z_řada+Gen':     'Gen',
         's+Ins':          'Com',
+        's+Nom':          'Com', # annotation error
         'spolu_s+Ins':    'Com',
+        'spolu_s+':       'Com',
         'společně_s+Ins': 'Com',
+        'společně_s+':    'Com',
+        'v_čelo_s+Ins':   'Com',
+        'v_spolupráce_s+Ins': 'Com',
         'bez+Gen':        'Abe',
         'včetně+Gen':     'Inc',
+        'nad_rámec+Gen':  'Add',
         'kromě+Gen':      'Exc',
+        'krom+Gen':       'Exc',
         'mimo+Acc':       'Exc',
         'mimo+Gen':       'Exc',
         'vyjma+Gen':      'Exc',
+        'až_na+Acc':      'Exc',
+        's_výjimka+Gen':  'Exc',
+        's_výjimka+':     'Exc',
         'místo+Gen':      'Sbs',
+        'místo+Ins':      'Sbs', # něčím místo něčím jiným
+        'místo+Loc':      'Sbs', # annotation error
+        'místo_do+Gen':   'Sbs',
+        'místo_k+Dat':    'Sbs',
+        'místo_na+Acc':   'Sbs',
+        'místo_na+':      'Sbs',
+        'místo_po+Loc':   'Sbs',
+        'místo_v+Acc':    'Sbs',
+        'místo_v+':       'Sbs',
+        'místo_za+Acc':   'Sbs',
         'namísto+Gen':    'Sbs',
+        'namísto_do+Gen': 'Sbs',
+        'v_zastoupení+Gen': 'Sbs',
+        'výměna_za+Acc':  'Sbs',
         'jako':           'Ess',
         'jako+':          'Ess',
         'jako+Nom':       'Ess',
@@ -100,8 +184,24 @@ class MsfCase(Block):
         'jako_u+Gen':     'Ess',
         'jako_v+Loc':     'Ess',
         'formou+Gen':     'Ess',
+        'forma+Gen':      'Ess',
+        'v_forma+Gen':    'Ess',
+        'v_podoba+Gen':   'Ess',
+        'v_podoba+':      'Ess',
+        'shoda+Gen':      'Equ',
+        'v_shoda_s+Ins':  'Equ',
+        'do_soulad_s+Ins': 'Sem',
+        'na_způsob+Gen':  'Sem',
+        'po_vzor+Gen':    'Sem',
+        'úměrně+Dat':     'Sem',
+        'úměrně_k+Dat':   'Sem',
+        'úměrně_s+Ins':   'Sem',
+        'v_analogie_s+Ins': 'Sem',
+        'v_duch+Gen':     'Sem',
+        'v_smysl+Gen':    'Sem',
         'oproti+Dat':     'Dsm',
         'na_rozdíl_od+Gen': 'Dsm',
+        'na_rozdíl_od+':  'Dsm',
         'než':            'Cmp',
         'než+Nom':        'Cmp',
         'než+Gen':        'Cmp',
@@ -109,18 +209,33 @@ class MsfCase(Block):
         'než_nad+Ins':    'Cmp',
         'než_v+Acc':      'Cmp',
         'než_v+Loc':      'Cmp',
+        'v_poměr_k+Dat':  'Cmp',
+        'v_poměr_k+':     'Cmp',
+        'v_porovnání_k+Dat': 'Cmp',
+        'v_porovnání_s+Ins': 'Cmp',
+        'v_porovnání_s+': 'Cmp',
         'v_srovnání_s+Ins': 'Cmp',
+        'v_srovnání_s+':  'Cmp',
         'o+Acc':          'Dif',
+        'o+Nom':          'Dif', # annotation error
+        'o+Gen':          'Dif', # annotation error
+        'o+Dat':          'Dif', # annotation error
+        'o_o+Acc':        'Dif', # annotation error
         'kdežto':         'Cmt',
         'přičemž':        'Cmt',
         'zatímco':        'Cmt',
         'díky+Dat':       'Cau',
+        'dík+Dat':        'Cau',
         'kvůli+Dat':      'Cau',
         'vinou+Gen':      'Cau',
         'vlivem+Gen':     'Cau',
         'vliv+Gen':       'Cau',
+        'vliv+':          'Cau',
+        'vinou+Gen':      'Cau',
+        'vina+Gen':       'Cau',
         'zásluhou+Gen':   'Cau',
         'zásluha+Gen':    'Cau',
+        'z_důvod+Gen':    'Cau',
         'v_důsledek+Gen': 'Cau',
         'jelikož':        'Cau',
         'ježto':          'Cau',
@@ -129,15 +244,30 @@ class MsfCase(Block):
         'takže':          'Cau',
         'následek+Gen':   'Cau',
         'aby':            'Pur',
+        'jméno+Gen':      'Pur',
+        'pro_případ+Gen': 'Pur',
+        'v_jméno+Gen':    'Pur',
+        'v_zájem+Gen':    'Pur',
+        'za_účel+Gen':    'Pur',
         'na_základ+Gen':  'Cns',
+        'pod_vliv+Gen':   'Cns',
         's_ohled_na+Acc': 'Cns',
+        's_přihlédnutí_k+Dat': 'Cns',
+        's_přihlédnutí_na+Acc': 'Cns',
         'v_souvislost_s+Ins': 'Cns',
+        'v_souvislost_s+': 'Cns',
         'v_světlo+Gen':   'Cns',
         'vzhledem_k+Dat': 'Cns',
+        'v_soulad_s+Ins': 'Cns',
+        'v_soulad_s+':    'Cns',
+        'z_titul+Gen':    'Cns',
         'ať':             'Ign',
         'bez_ohled_na+Acc': 'Ign',
+        'nehledě_k+Dat':  'Ign',
+        'nehledě_na+Acc': 'Ign',
         'navzdory+Dat':   'Ccs',
         'vzdor+Dat':      'Ccs',
+        'v_rozpor_s+Ins': 'Ccs',
         'ač':             'Ccs',
         'ačkoli':         'Ccs',
         'byť':            'Ccs',
@@ -149,22 +279,100 @@ class MsfCase(Block):
         'li':             'Cnd',
         'pakliže':        'Cnd',
         'pokud':          'Cnd',
+        'pokud+Nom':      'Cnd',
         'zda':            'Cnd',
         'v_případ+Gen':   'Cnd',
+        'v_případ+':      'Cnd',
+        'v_závislost_na+Loc': 'Cnd',
+        'v_závislost_s+Ins': 'Cnd',
         'o+Loc':          'The',
         'ohledně+Gen':    'The',
         'stran+Gen':      'The',
+        'co_do+Gen':      'The',
+        'na_téma+Gen':    'The',
+        'na_téma+Nom':    'The',
+        'na_téma+':       'The',
+        'na_úsek+Gen':    'The',
+        'po_stránka+Gen': 'The',
+        'v_obor+Gen':     'The',
+        'v_otázka+Gen':   'The',
+        'v_spojení_s+Ins': 'The',
+        'v_věc+Gen':      'The',
+        'v_vztah_k+Dat':  'The',
+        'v_vztah_k+':     'The',
+        'v_záležitost+Gen': 'The',
+        'v_znamení+Gen':  'The',
         'z_hledisko+Gen': 'The',
+        'z_hledisko+':    'The',
         'podle+Gen':      'Quo',
         'dle+Gen':        'Quo',
         'pomocí+Gen':     'Ins',
+        's_pomoc+Gen':    'Ins',
         'prostřednictvím+Gen': 'Ins',
         'prostřednictví+Gen': 'Ins',
+        'prostřednictví+Ins': 'Ins', # annotation error
+        'prostřednictví+': 'Ins',
+        'za_pomoc+Gen':   'Ins',
         'pro+Acc':        'Ben',
+        'pro+Nom':        'Ben', # annotation error
+        'pro+Gen':        'Ben', # annotation error
+        'pro+Ins':        'Ben', # annotation error
+        'napospas+Dat':   'Ben',
+        'k_prospěch+Gen': 'Ben',
+        'na_úkor+Gen':    'Ben',
+        'na_vrub+Gen':    'Ben',
+        'v_prospěch+Gen': 'Ben',
+        'v_neprospěch+Gen': 'Ben',
+        'v_služba+Gen':   'Ben',
         'proti+Dat':      'Adv',
+        'proti+Gen':      'Adv',
         'kontra+Nom':     'Adv',
         'versus+Nom':     'Adv',
         'vůči+Dat':       'Adv',
+        # subordinators
+        'dokud':          'Tan',
+        'nežli':          'Tan',
+        'jakmile':        'Tps',
+        'jen_co':         'Tps',
+        'zdali':          'Atr',
+        'že':             'Atr',
+        'jako':           'Ess',
+        'než':            'Cmp',
+        'kdežto':         'Cmt',
+        'přičemž':        'Cmt',
+        'zatímco':        'Cmt',
+        'jelikož':        'Cau',
+        'ježto':          'Cau',
+        'poněvadž':       'Cau',
+        'protože':        'Cau',
+        'takže':          'Cau',
+        'aby':            'Pur',
+        'ať':             'Ign',
+        'ač':             'Ccs',
+        'ačkoli':         'Ccs',
+        'byť':            'Ccs',
+        'přestože':       'Ccs',
+        'třebaže':        'Ccs',
+        'jestli':         'Cnd',
+        'jestliže':       'Cnd',
+        'ledaže':         'Cnd',
+        'li':             'Cnd',
+        'pakliže':        'Cnd',
+        'pokud':          'Cnd',
+        'zda':            'Cnd',
+        # coordinators
+        'a':              'Conj',
+        'i':              'Conj',
+        'ani':            'Nnor',
+        'nebo':           'Disj',
+        'či':             'Disj',
+        'ale':            'Advs',
+        'avšak':          'Advs',
+        'však':           'Advs',
+        'nýbrž':          'Advs',
+        'neboť':          'Reas',
+        'tedy':           'Cnsq',
+        'tak':            'Cnsq'
     }
 
     def process_node(self, node):
@@ -204,4 +412,37 @@ def process_node(self, node):
             else:
                 logging.warn(f"No Case value found for '{caseadpostring}'.")
                 msfcase = caseadpostring
+        # Omer wants to collect cases from both adpositions and subordinators
+        # but we will consider subordinators only if we do not have any case
+        # from morphology or adpositions.
+        if not msfcase:
+            subordinators = []
+            for c in node.children:
+                if c.udeprel == 'mark':
+                    lemma = c.lemma
+                    # If it has outgoing 'fixed' relations, it is a multiword adposition.
+                    fixedchildren = [x.lemma for x in c.children if x.udeprel == 'fixed']
+                    if fixedchildren:
+                        lemma += '_' + '_'.join(fixedchildren)
+                    subordinators.append(lemma)
+            if subordinators:
+                subordstring = '_'.join(subordinators)
+                if subordstring in self.adposmap:
+                    msfcase = self.adposmap[subordstring]
+        # To lump coordinators with all the above makes even less sense but for
+        # the moment we do it.
+        if not msfcase:
+            coordinators = []
+            for c in node.children:
+                if c.udeprel == 'cc':
+                    lemma = c.lemma
+                    # If it has outgoing 'fixed' relations, it is a multiword adposition.
+                    fixedchildren = [x.lemma for x in c.children if x.udeprel == 'fixed']
+                    if fixedchildren:
+                        lemma += '_' + '_'.join(fixedchildren)
+                    coordinators.append(lemma)
+            if coordinators:
+                coordstring = '_'.join(coordinators)
+                if coordstring in self.adposmap:
+                    msfcase = self.adposmap[coordstring]
         node.misc['MSFCase'] = msfcase

From fdbfe58fc03e32d287346c44f7538e4923752a59 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Apr 2025 10:43:50 +0200
Subject: [PATCH 1237/1374] The phrase Writer module remodeled as an abstract
 block, providing methods to inherit.

---
 udapi/block/mwe/msfphrase.py | 76 ++++++++++++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 udapi/block/mwe/msfphrase.py

diff --git a/udapi/block/mwe/msfphrase.py b/udapi/block/mwe/msfphrase.py
new file mode 100644
index 00000000..566663df
--- /dev/null
+++ b/udapi/block/mwe/msfphrase.py
@@ -0,0 +1,76 @@
+"""
+Morphosyntactic features (UniDive):
+An abstract block as a base for derivation of blocks that discover periphrastic
+verb forms and save them as Phrase features in MISC. This block provides the
+methods that save the features in MISC. It is based on the Writer module by
+Lenka Krippnerová.
+"""
+from udapi.core.block import Block
+import logging
+
+class MsfPhrase(Block):
+
+    def process_node(self, node):
+        """
+        Override this in a derived class!
+        """
+        logging.fatal('process_node() not implemented.')
+
+    dictionary = {
+		'person': 'PhrasePerson',
+		'number': 'PhraseNumber',
+		'mood': 'PhraseMood',
+		'tense': 'PhraseTense',
+		'voice': 'PhraseVoice',
+		'aspect':'PhraseAspect',
+		'form': 'PhraseForm',
+		'reflex': 'PhraseReflex',
+		'polarity': 'PhrasePolarity',
+		'gender':'PhraseGender',
+		'animacy':'PhraseAnimacy',
+		'ords':'Phrase'
+		}
+
+    def write_node_info(self, node,
+			tense = None,
+			person = None,
+			number = None,
+			mood = None,
+			voice = None,
+			form = None,
+			reflex = None,
+			polarity = None,
+			ords = None,
+			gender = None,
+			animacy = None,
+			aspect = None):
+        arguments = locals()
+        del arguments['self'] # delete self and node from arguments,
+        del arguments['node'] # we want only grammatical categories 
+        for key,val in arguments.items():
+            if val != None: 
+                node.misc[self.dictionary[key]] = val
+
+    def get_polarity(self, node, neg):
+        if node.feats['Polarity'] != "":
+            return node.feats['Polarity']
+        if len(neg) == 0:
+            return None
+        return 'Neg'
+		
+    def get_is_reflex(self,node,refl):
+        if len(refl) == 0:
+            return node.feats['Reflex']
+        return 'Yes'
+
+    def is_expl_pass(self,refl):
+        if len(refl) == 0:
+            return False
+        return refl[0].deprel == 'expl:pass'
+		
+    def get_voice(self,node,refl):
+        voice = node.feats['Voice']
+        if self.is_expl_pass(refl):
+            return 'Pass'
+        return voice
+		

From 3b6ce6c7eb97a1fccd39c5f1727b4372a0e6e0df Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Apr 2025 10:53:45 +0200
Subject: [PATCH 1238/1374] Slavic periphrastic blocks moved to their own
 folder.

---
 udapi/block/mwe/{slavic_cond.py => slavic/conditional.py}      | 0
 udapi/block/mwe/{slavic_transgressive.py => slavic/converb.py} | 0
 udapi/block/mwe/{slavic_future.py => slavic/future.py}         | 0
 udapi/block/mwe/{slavic_imperative.py => slavic/imperative.py} | 0
 udapi/block/mwe/{slavic_inf.py => slavic/infinitive.py}        | 0
 udapi/block/mwe/{slavic_past.py => slavic/past.py}             | 0
 udapi/block/mwe/{slavic_pres.py => slavic/present.py}          | 0
 7 files changed, 0 insertions(+), 0 deletions(-)
 rename udapi/block/mwe/{slavic_cond.py => slavic/conditional.py} (100%)
 rename udapi/block/mwe/{slavic_transgressive.py => slavic/converb.py} (100%)
 rename udapi/block/mwe/{slavic_future.py => slavic/future.py} (100%)
 rename udapi/block/mwe/{slavic_imperative.py => slavic/imperative.py} (100%)
 rename udapi/block/mwe/{slavic_inf.py => slavic/infinitive.py} (100%)
 rename udapi/block/mwe/{slavic_past.py => slavic/past.py} (100%)
 rename udapi/block/mwe/{slavic_pres.py => slavic/present.py} (100%)

diff --git a/udapi/block/mwe/slavic_cond.py b/udapi/block/mwe/slavic/conditional.py
similarity index 100%
rename from udapi/block/mwe/slavic_cond.py
rename to udapi/block/mwe/slavic/conditional.py
diff --git a/udapi/block/mwe/slavic_transgressive.py b/udapi/block/mwe/slavic/converb.py
similarity index 100%
rename from udapi/block/mwe/slavic_transgressive.py
rename to udapi/block/mwe/slavic/converb.py
diff --git a/udapi/block/mwe/slavic_future.py b/udapi/block/mwe/slavic/future.py
similarity index 100%
rename from udapi/block/mwe/slavic_future.py
rename to udapi/block/mwe/slavic/future.py
diff --git a/udapi/block/mwe/slavic_imperative.py b/udapi/block/mwe/slavic/imperative.py
similarity index 100%
rename from udapi/block/mwe/slavic_imperative.py
rename to udapi/block/mwe/slavic/imperative.py
diff --git a/udapi/block/mwe/slavic_inf.py b/udapi/block/mwe/slavic/infinitive.py
similarity index 100%
rename from udapi/block/mwe/slavic_inf.py
rename to udapi/block/mwe/slavic/infinitive.py
diff --git a/udapi/block/mwe/slavic_past.py b/udapi/block/mwe/slavic/past.py
similarity index 100%
rename from udapi/block/mwe/slavic_past.py
rename to udapi/block/mwe/slavic/past.py
diff --git a/udapi/block/mwe/slavic_pres.py b/udapi/block/mwe/slavic/present.py
similarity index 100%
rename from udapi/block/mwe/slavic_pres.py
rename to udapi/block/mwe/slavic/present.py

From 06775c0e1cdb8720a9b63f0bc5145da072bcf7dc Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Apr 2025 11:05:55 +0200
Subject: [PATCH 1239/1374] Slavic conditional: Use MsfPhrase instead of the
 Writer module.

---
 udapi/block/mwe/slavic/conditional.py | 27 ++++-----------------------
 1 file changed, 4 insertions(+), 23 deletions(-)

diff --git a/udapi/block/mwe/slavic/conditional.py b/udapi/block/mwe/slavic/conditional.py
index de7cd160..2f6aa2dc 100644
--- a/udapi/block/mwe/slavic/conditional.py
+++ b/udapi/block/mwe/slavic/conditional.py
@@ -2,26 +2,9 @@
 
 # Conditional mood of Slavic languages
 
-from udapi.core.block import Block
-import importlib
-import sys
-
-class Slavic_cond(Block):
-	def __init__(self, writer_prefix='',**kwargs):
-		super().__init__(**kwargs)
-		if writer_prefix != '':
-			writer_module = ".".join([writer_prefix,'writer'])
-		else:
-			writer_module = 'writer'
-		try:
-			module = importlib.import_module(writer_module)
-		except ModuleNotFoundError as e:
-			print(e, file=sys.stderr)
-			print("Try to set writer_prefix parameter.", file=sys.stderr)
-			exit(1)
-
-		self.wr = module.Writer()
+from udapi.block.mwe.MsfPhrase import MsfPhrase
 
+class conditional(MsfPhrase):
 	
 	def process_node(self, node):
 		if node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'Fin':
@@ -48,8 +31,7 @@ def process_node(self, node):
 				if auxVerb.feats['Person'] != '':
 					person=auxVerb.feats['Person']
 				
-					
-				self.wr.write_node_info(node,
+				self.write_node_info(node,
 					person=person,
 					number=node.feats['Number'],
 					mood='Cnd',
@@ -63,7 +45,6 @@ def process_node(self, node):
 					animacy=node.feats['Animacy']
 				)
 				return
-		
 					
 		cop = [x for x in node.children if x.udeprel == 'cop' and (x.feats['VerbForm'] == 'Part' or x.feats['VerbForm'] == 'Fin')]
 		aux_cnd = [x for x in node.children if x.feats['Mood'] == 'Cnd' or x.deprel=='aux:pass']
@@ -77,7 +58,7 @@ def process_node(self, node):
 			copVerb = cop[0]
 			phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in cop] + [x.ord for x in neg] + [x.ord for x in prep] + [x.ord for x in refl]
 			phrase_ords.sort()
-			self.wr.write_node_info(node,
+			self.write_node_info(node,
 					person=copVerb.feats['Person'],
 					number=copVerb.feats['Number'],
 					mood='Cnd',

From a1089bf421ccd932a744cd66dda0dfe1258dc528 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Apr 2025 11:10:59 +0200
Subject: [PATCH 1240/1374] Fixed class derivation.

---
 udapi/block/mwe/slavic/conditional.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/mwe/slavic/conditional.py b/udapi/block/mwe/slavic/conditional.py
index 2f6aa2dc..ae56866d 100644
--- a/udapi/block/mwe/slavic/conditional.py
+++ b/udapi/block/mwe/slavic/conditional.py
@@ -2,9 +2,9 @@
 
 # Conditional mood of Slavic languages
 
-from udapi.block.mwe.MsfPhrase import MsfPhrase
+import udapi.block.mwe.msfphrase
 
-class conditional(MsfPhrase):
+class conditional(udapi.block.mwe.msfphrase.MsfPhrase):
 	
 	def process_node(self, node):
 		if node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'Fin':

From 9afb712e25dc46e02e6196d7c97a7a47be95c573 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Apr 2025 11:12:08 +0200
Subject: [PATCH 1241/1374] Typo.

---
 udapi/block/mwe/slavic/conditional.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/mwe/slavic/conditional.py b/udapi/block/mwe/slavic/conditional.py
index ae56866d..bafbb68c 100644
--- a/udapi/block/mwe/slavic/conditional.py
+++ b/udapi/block/mwe/slavic/conditional.py
@@ -4,7 +4,7 @@
 
 import udapi.block.mwe.msfphrase
 
-class conditional(udapi.block.mwe.msfphrase.MsfPhrase):
+class Conditional(udapi.block.mwe.msfphrase.MsfPhrase):
 	
 	def process_node(self, node):
 		if node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'Fin':

From 82c3ccd83d94d1ddb15b2d958c4cb9be3ed31489 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Apr 2025 11:14:00 +0200
Subject: [PATCH 1242/1374] Bug fix.

---
 udapi/block/mwe/slavic/conditional.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/udapi/block/mwe/slavic/conditional.py b/udapi/block/mwe/slavic/conditional.py
index bafbb68c..615878f2 100644
--- a/udapi/block/mwe/slavic/conditional.py
+++ b/udapi/block/mwe/slavic/conditional.py
@@ -37,9 +37,9 @@ def process_node(self, node):
 					mood='Cnd',
 					form='Fin',
 					aspect=node.feats['Aspect'],
-					reflex=self.wr.get_is_reflex(node,refl),
-					polarity=self.wr.get_polarity(node,neg),
-					voice=self.wr.get_voice(node, refl),
+					reflex=self.get_is_reflex(node,refl),
+					polarity=self.get_polarity(node,neg),
+					voice=self.get_voice(node, refl),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy']
@@ -63,9 +63,9 @@ def process_node(self, node):
 					number=copVerb.feats['Number'],
 					mood='Cnd',
 					form='Fin',
-					voice=self.wr.get_voice(node, refl),
-					polarity=self.wr.get_polarity(copVerb,neg),
-					reflex=self.wr.get_is_reflex(node, refl),
+					voice=self.get_voice(node, refl),
+					polarity=self.get_polarity(copVerb,neg),
+					reflex=self.get_is_reflex(node, refl),
 					ords=phrase_ords,
 					gender=copVerb.feats['Gender'],
 					animacy=copVerb.feats['Animacy']

From f18143a06ed989770b710379f3db3cdc67673a55 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Apr 2025 12:35:13 +0200
Subject: [PATCH 1243/1374] Update od Lenky.

---
 udapi/block/mwe/slavic/conditional.py  |  19 ++--
 udapi/block/mwe/slavic/converb.py      |   6 +-
 udapi/block/mwe/slavic/future.py       |  12 +--
 udapi/block/mwe/slavic/imperative.py   |   6 +-
 udapi/block/mwe/slavic/infinitive.py   |  26 +++++-
 udapi/block/mwe/slavic/past.py         | 115 ++++++++++++++++++-------
 udapi/block/mwe/slavic/preprocessor.py |  69 +++++++++++++++
 udapi/block/mwe/slavic/present.py      |   6 +-
 8 files changed, 199 insertions(+), 60 deletions(-)
 create mode 100644 udapi/block/mwe/slavic/preprocessor.py

diff --git a/udapi/block/mwe/slavic/conditional.py b/udapi/block/mwe/slavic/conditional.py
index 615878f2..9573d377 100644
--- a/udapi/block/mwe/slavic/conditional.py
+++ b/udapi/block/mwe/slavic/conditional.py
@@ -7,7 +7,7 @@
 class Conditional(udapi.block.mwe.msfphrase.MsfPhrase):
 	
 	def process_node(self, node):
-		if node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'Fin':
+		if (node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'PartRes') or node.feats['VerbForm'] == 'Fin':
 			# in most Slavic languages, the verb has feats['VerbForm'] == 'Part' but in Polish the verb has feats['VerbForm'] == 'Fin'
 			
 			aux_cnd = [x for x in node.children if x.feats['Mood'] == 'Cnd' or x.deprel == 'aux:cnd'] # list for auxiliary verbs for forming the conditional mood
@@ -19,7 +19,7 @@ def process_node(self, node):
 			
 			if len(aux_cnd) > 0 and len(cop) == 0:
 				aux = [x for x in node.children if x.udeprel == 'aux' or x.feats['Mood'] == 'Cnd'] # all auxiliary verbs and conjuctions with feats['Mood'] == 'Cnd'
-				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 				
 				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in refl] + [x.ord for x in neg]
@@ -27,10 +27,11 @@ def process_node(self, node):
 			
 				auxVerb = aux_cnd[0]
 
-				person='3' # TODO there could be a problem in russian etc. (same as in past tense)
+				person='3' # TODO there is a problem in russian etc. (same as in past tense)
 				if auxVerb.feats['Person'] != '':
 					person=auxVerb.feats['Person']
 				
+					
 				self.write_node_info(node,
 					person=person,
 					number=node.feats['Number'],
@@ -45,29 +46,31 @@ def process_node(self, node):
 					animacy=node.feats['Animacy']
 				)
 				return
+		
 					
 		cop = [x for x in node.children if x.udeprel == 'cop' and (x.feats['VerbForm'] == 'Part' or x.feats['VerbForm'] == 'Fin')]
-		aux_cnd = [x for x in node.children if x.feats['Mood'] == 'Cnd' or x.deprel=='aux:pass']
+		aux_cnd = [x for x in node.children if x.feats['Mood'] == 'Cnd' or x.deprel=='aux:cnd']
 			
 		if len(cop) > 0 and len(aux_cnd) > 0:
-			aux = [x for x in node.children if x.udeprel == 'aux' or x.feats['Mood'] == 'Cnd']
+			# there can be a copula with Mood='Cnd' (i. e. in Old East Slavonic), we don't want to count these copula in phrase_ords twice, so there is x.udeprel != 'cop' in aux list
+			aux = [x for x in node.children if (x.udeprel == 'aux' or x.feats['Mood'] == 'Cnd') and x.udeprel != 'cop']
 			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			prep = [x for x in node.children if x.upos == 'ADP']
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 
 			copVerb = cop[0]
 			phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in cop] + [x.ord for x in neg] + [x.ord for x in prep] + [x.ord for x in refl]
 			phrase_ords.sort()
 			self.write_node_info(node,
+					aspect=copVerb.feats['Aspect'],
 					person=copVerb.feats['Person'],
 					number=copVerb.feats['Number'],
 					mood='Cnd',
 					form='Fin',
-					voice=self.get_voice(node, refl),
+					voice=self.get_voice(copVerb, refl),
 					polarity=self.get_polarity(copVerb,neg),
 					reflex=self.get_is_reflex(node, refl),
 					ords=phrase_ords,
 					gender=copVerb.feats['Gender'],
 					animacy=copVerb.feats['Animacy']
 			)
-				
diff --git a/udapi/block/mwe/slavic/converb.py b/udapi/block/mwe/slavic/converb.py
index 4ffbdaea..612fbd6a 100644
--- a/udapi/block/mwe/slavic/converb.py
+++ b/udapi/block/mwe/slavic/converb.py
@@ -25,7 +25,7 @@ def __init__(self, writer_prefix='',**kwargs):
 	def process_node(self, node):
 		# condition node.upos == 'VERB' to prevent copulas from entering this branch
 		if node.feats['VerbForm'] == 'Conv' and node.upos == 'VERB':
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			
 			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
@@ -75,7 +75,7 @@ def process_node(self, node):
 			if len(cop) > 0:
 				prep = [x for x in node.children if x.upos == 'ADP']
 				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
-				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			
 				copVerb = cop[0]
 				phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
@@ -91,6 +91,6 @@ def process_node(self, node):
 					form='Conv',
 					polarity=self.wr.get_polarity(node,neg),
 					ords=phrase_ords,
-					voice=self.wr.get_voice(node, refl)
+					voice=self.wr.get_voice(copVerb, refl)
 					)
 
diff --git a/udapi/block/mwe/slavic/future.py b/udapi/block/mwe/slavic/future.py
index 21d13a52..12e1574c 100644
--- a/udapi/block/mwe/slavic/future.py
+++ b/udapi/block/mwe/slavic/future.py
@@ -26,7 +26,7 @@ def process_node(self, node):
 		# future tense for Serbian and Croatian
 		aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Pres' and (x.lemma == 'hteti' or x.lemma == 'htjeti')]
 		if node.upos != 'AUX' and len(aux) != 0:
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			aux_other = [x for x in node.children if x.udeprel == 'aux'] # adding aux for passive voice
 			cop = [x for x in node.children if x.deprel == 'cop']
@@ -80,7 +80,7 @@ def process_node(self, node):
 		aux = [x for x in node.children if x.lemma == 'ќе' or x.lemma == 'ще']
 		
 		if node.feats['Tense'] == 'Pres' and len(aux) > 0:
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg] + [x.ord for x in aux]
 			phrase_ords.sort()
@@ -103,7 +103,7 @@ def process_node(self, node):
 		# Upper Sorbian forms the future tense in this way, however, the feats[Aspect] are not listed in the data
 		# in some languages ​​(e.g. in Russian) these verbs have the Tense Fut, in others (e.g. in Czech) they have the Tense Pres
 		"""if node.feats['Aspect'] == 'Perf' and (node.feats['Tense'] == 'Pres' or node.feats['Tense'] == 'Fut') and node.feats['VerbForm'] != 'Conv':
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			
 			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			
@@ -132,7 +132,7 @@ def process_node(self, node):
 			
 			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Fut']
 			
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			if len(aux) > 0:
 				auxVerb = aux[0]
@@ -183,7 +183,7 @@ def process_node(self, node):
 			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Mood']=='Ind']
 			prep = [x for x in node.children if x.upos == 'ADP']
 			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 
 			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in aux] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
 			phrase_ords.sort()
@@ -194,7 +194,7 @@ def process_node(self, node):
 					number=copVerb.feats['Number'],
 					mood='Ind',
 					form='Fin',
-					voice=self.wr.get_voice(node, refl),
+					voice=self.wr.get_voice(copVerb, refl),
 					polarity=self.wr.get_polarity(copVerb,neg),
 					ords=phrase_ords
 				)
diff --git a/udapi/block/mwe/slavic/imperative.py b/udapi/block/mwe/slavic/imperative.py
index 02aad2e5..cbb521ac 100644
--- a/udapi/block/mwe/slavic/imperative.py
+++ b/udapi/block/mwe/slavic/imperative.py
@@ -25,7 +25,7 @@ def __init__(self, writer_prefix='',**kwargs):
 	def process_node(self, node):
 		# the condition node.upos == 'VERB' ensures that copulas do not enter this branch
 		if node.feats['Mood'] == 'Imp' and node.upos == 'VERB':
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			
 			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
@@ -72,7 +72,7 @@ def process_node(self, node):
 		if len(cop) > 0:
 			prep = [x for x in node.children if x.upos == 'ADP']
 			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 
 			copVerb = cop[0]
 			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
@@ -83,7 +83,7 @@ def process_node(self, node):
 				number=copVerb.feats['Number'],
 				mood='Imp',
 				form='Fin',
-				voice=self.wr.get_voice(node, refl),
+				voice=self.wr.get_voice(copVerb, refl),
 				reflex=self.wr.get_is_reflex(node, refl),
 				polarity=self.wr.get_polarity(node,neg),
 				ords=phrase_ords
diff --git a/udapi/block/mwe/slavic/infinitive.py b/udapi/block/mwe/slavic/infinitive.py
index 7c7d2e39..7932e8e8 100644
--- a/udapi/block/mwe/slavic/infinitive.py
+++ b/udapi/block/mwe/slavic/infinitive.py
@@ -26,7 +26,7 @@ def process_node(self,node):
 		if node.feats['VerbForm'] == 'Inf' and node.upos == 'VERB':
 			aux = [x for x in node.children if x.udeprel == 'aux']
 			if len(aux) == 0: # the list of auxiliary list must be empty - we don't want to mark infinitives which are part of any other phrase (for example the infinititive is part of the future tense in Czech)
-				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 				
 				phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
@@ -51,7 +51,7 @@ def process_node(self,node):
 			aux_forb = [x for x in node.children if x.udeprel == 'aux' and x.feats['VerbForm'] != 'Inf']
 			if len(aux) > 0 and len(aux_forb) == 0:
 				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
-				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 
 				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in neg] + [x.ord for x in refl]
 				phrase_ords.sort()
@@ -76,15 +76,33 @@ def process_node(self,node):
 		if len(cop) > 0 and len(aux_forb) == 0:
 			prep = [x for x in node.children if x.upos == 'ADP']
 			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
 			phrase_ords.sort()
 			
 			self.wr.write_node_info(node,
-				voice=self.wr.get_voice(node, refl),
+				voice=self.wr.get_voice(cop[0], refl),
 				form='Inf',
 				polarity=self.wr.get_polarity(cop[0],neg),
 				reflex=self.wr.get_is_reflex(node, refl),
 				ords=phrase_ords
 				)
+			
+		# there is a rare verb form called supine in Slovenian, it is used instead of infinitive as the argument of motion verbs
+		if node.feats['VerbForm'] == 'Sup':
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+
+			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+			phrase_ords.sort()
+
+			self.wr.write_node_info(node,
+					aspect=node.feats['Aspect'],
+					voice='Act',
+					form='Sup',
+					polarity=self.wr.get_polarity(node,neg),
+					reflex=self.wr.get_is_reflex(node, refl),
+					ords=phrase_ords
+					)
+
 							
diff --git a/udapi/block/mwe/slavic/past.py b/udapi/block/mwe/slavic/past.py
index 6f9a6816..3f341f5b 100644
--- a/udapi/block/mwe/slavic/past.py
+++ b/udapi/block/mwe/slavic/past.py
@@ -27,7 +27,7 @@ def get_person_for_langs_with_simple_past(self, node, person):
 		returns the person which is known from subject, languages with the simple past tense (e. g. Russian) do not express person in these verb forms
 		if the person was not taken from the subject, the third person would be filled in automatically due to languages ​​with a compound past but simple forms for the third person  (e. g. Czech)
 		"""
-		subj = [x for x in node.children if x.udeprel == "nsubj"]
+		subj = [x for x in node.children if x.udeprel == 'nsubj']
 		if subj:
 			subj = subj[0]
 			if subj.feats['Person'] != '':
@@ -35,19 +35,45 @@ def get_person_for_langs_with_simple_past(self, node, person):
 		return person
 
 	def process_node(self, node):
+		
+		past_tenses = ['Past', 'Imp', 'Pqp']
+		cop = [x for x in node.children if x.udeprel == 'cop' and (x.feats['Tense'] in past_tenses)]
+
+		# there is person 0 in Polish and Ukrainian which is for impersonal statements
+		# in Polish, verbs with Person=0 have also Tense=Past, in Ukrainian the tense is not specified
+		if node.feats['Person'] == '0':
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
+			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+
+			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+			phrase_ords.sort()
 
-		cop = [x for x in node.children if x.udeprel == "cop" and x.feats['Tense'] == 'Past']
+			self.wr.write_node_info(node,
+						tense=node.feats['Tense'],
+						person=node.feats['Person'],
+						number=node.feats['Number'],
+						mood=node.feats['Mood'],
+						voice='Pass',
+						aspect=node.feats['Aspect'],
+						form=node.feats['VerbForm'],
+						polarity=self.wr.get_polarity(node,neg),
+						reflex=self.wr.get_is_reflex(node,refl),
+						ords=phrase_ords,
+						gender=node.feats['Gender'],
+						animacy=node.feats['Animacy']
+						)
 
 		# compound past tense
-		if node.feats['VerbForm'] == 'Part' and node.upos == 'VERB' and node.feats['Voice'] != 'Pass':
+		if (node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'PartRes') and node.upos == 'VERB' and node.feats['Voice'] != 'Pass':
 			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Pres']
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			aux_pqp = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] in past_tenses]
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			
-			phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in refl] + [x.ord for x in neg]
+			phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in refl] + [x.ord for x in neg] + [x.ord for x in aux_pqp]
 			phrase_ords.sort()
 			
-			aux_cnd = [x for x in node.children if x.feats['Mood'] == 'Cnd' or x.deprel == 'aux:cnd'] # we don't want to mark l-participles in the conditional as past tense
+			aux_cnd = [x for x in node.children if (x.feats['Mood'] == 'Cnd' or x.deprel == 'aux:cnd') and x.udeprel != 'conj'] # we don't want to mark l-participles in the conditional as past tense
 			if len(aux_cnd) == 0:
 				if len(aux) > 0:
 					person = aux[0].feats['Person']
@@ -55,9 +81,19 @@ def process_node(self, node):
 				elif len(aux) == 0:
 					person = '3'
 
+				if len(aux_pqp) > 0:
+					person = aux_pqp[0].feats['Person']
+				
+				# in Slovenian, the participles are not annotated as Tense='Past', the Tense feature is missing here
+				# but in Bulgarian, there are cases where the participles are annotated as Tense='Imp'
+				tense = 'Past'
+				if node.feats['Tense'] == 'Imp':
+					tense = 'Imp'
+				if node.feats['Tense'] == 'Pqp':
+					tense = 'Pqp'
 
 				self.wr.write_node_info(node,
-						tense='Past',
+						tense=tense,
 						person=person,
 						number=node.feats['Number'],
 						mood='Ind',
@@ -70,34 +106,43 @@ def process_node(self, node):
 						gender=node.feats['Gender'],
 						animacy=node.feats['Animacy']
 						)
+				
 
 		# the past tense of some Slavic languages ​​is formed only by a verb without an auxiliary verb (e.g. Polish)
-		elif node.feats['Tense'] == 'Past' and node.upos == 'VERB' and node.feats['VerbForm'] != 'Conv':
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+		# or imperfect (special case of the past tense) e.g. in Bulgarian or Croatian 
+		elif (node.feats['Tense'] in past_tenses) and node.upos == 'VERB' and node.feats['VerbForm'] != 'Conv':
+
+			# the past tense is formed only by a content verb, not with an auxiliary
+			aux_forb = [x for x in node.children if x.udeprel == 'aux']
+
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+
+			if not aux_forb:
 			
-			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
-			phrase_ords.sort()
+				phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+				phrase_ords.sort()
 
-			self.wr.write_node_info(node,
-				tense='Past',
-				person=node.feats['Person'],
-				number=node.feats['Number'],
-				mood='Ind',
-				voice=self.wr.get_voice(node,refl),
-				aspect=node.feats['Aspect'],
-				form=node.feats['VerbForm'],
-				polarity=self.wr.get_polarity(node,neg),
-				reflex=self.wr.get_is_reflex(node,refl),
-				ords=phrase_ords,
-				gender=node.feats['Gender'],
-				animacy=node.feats['Animacy']
-				)
+				self.wr.write_node_info(node,
+					tense=node.feats['Tense'],
+					person=node.feats['Person'],
+					number=node.feats['Number'],
+					mood='Ind',
+					voice=self.wr.get_voice(node,refl),
+					aspect=node.feats['Aspect'],
+					form=node.feats['VerbForm'],
+					polarity=self.wr.get_polarity(node,neg),
+					reflex=self.wr.get_is_reflex(node,refl),
+					ords=phrase_ords,
+					gender=node.feats['Gender'],
+					animacy=node.feats['Animacy']
+					)
 			
+				
 			
-		# passivum
+		# passive
 		elif node.upos == 'ADJ' and node.feats['Voice'] == 'Pass' and len(cop) == 0:	
-			aux_past_tense = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Past']
+			aux_past_tense = [x for x in node.children if x.udeprel == 'aux' and (x.feats['Tense'] in past_tenses)]
 			aux_cnd = [x for x in node.children if x.feats['Mood'] == 'Cnd' or x.deprel == 'aux:cnd'] # we don't want to mark l-participles in the conditional as past tense
 			if len(aux_cnd) == 0:
 				if len(aux_past_tense) > 0:
@@ -112,7 +157,7 @@ def process_node(self, node):
 					person = self.get_person_for_langs_with_simple_past(node, person)
 
 					self.wr.write_node_info(node,
-						tense='Past',
+						tense=aux_past_tense[0].feats['Tense'],
 						person=person,
 						number=aux_past_tense[0].feats['Number'],
 						mood='Ind',
@@ -131,22 +176,26 @@ def process_node(self, node):
 				aux_past_tense = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Pres']
 				prep = [x for x in node.children if x.upos == 'ADP']
 				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
-				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 
 				phrase_ords = [node.ord] + [x.ord for x in aux_past_tense] + [x.ord for x in cop] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
 				phrase_ords.sort()
 
 				person = '3'
 				if aux_past_tense:
-					person = aux_past_tense[0].feats["Person"]
-				person = self.get_person_for_langs_with_simple_past(node, person)
+					person = aux_past_tense[0].feats['Person']
+
+				# In ru, be, uk, the person is not expressed in past tense and the verbform is Fin, not Part
+				if cop[0].feats['VerbForm'] == 'Fin':
+					person = ''
 				
 				self.wr.write_node_info(node,
-					tense='Past',
+					aspect=cop[0].feats['Aspect'],
+					tense=cop[0].feats['Tense'],
 					person=person,
 					number=cop[0].feats['Number'],
 					mood='Ind',
-					voice=self.wr.get_voice(node, refl),
+					voice=self.wr.get_voice(cop[0], refl),
 					form='Fin',
 					reflex=self.wr.get_is_reflex(node,refl),
 					polarity=self.wr.get_polarity(cop[0],neg),
diff --git a/udapi/block/mwe/slavic/preprocessor.py b/udapi/block/mwe/slavic/preprocessor.py
new file mode 100644
index 00000000..c6a2dcbe
--- /dev/null
+++ b/udapi/block/mwe/slavic/preprocessor.py
@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+
+from udapi.core.block import Block
+
+class Preprocessor(Block):
+		
+	def process_node(self,node):
+
+		# in Ukrainian the active verb forms are not marked as PhraseVoice=Act
+		if (node.upos == 'VERB' or (node.upos == 'AUX' and node.feats['VerbForm'] == 'Fin')) and node.feats['Voice'] == '':
+			node.feats['Voice'] = 'Act'
+				
+		# in Belarusian, some adjectives formed from verbs are marked as verbs
+		# if the verb has case, then it is an adjective
+		if node.upos == 'VERB' and node.feats['Case'] != '':
+			node.upos = 'ADJ'
+			
+		# in Polish, the conditional mood for auxiliary verbs is marked as deprel == 'aux:cnd' and not as in the last Slavic languages ​​feats['Mood'] == 'Cnd'
+		if node.deprel == 'aux:cnd':
+			node.feats['Mood'] = 'Cnd'
+			
+		# unify polarities - some languages ​​mark only Neg (Russian), some mark both Neg and Pos (Czech)
+		if node.feats['Polarity'] == 'Pos':
+			node.feats['Polarity'] = ''
+		
+		# makedonstina tvori budouci cas pomoci pomocneho slova ќе, u nejz neni nijak vyznaceno, ze se podili na tvorbe budouciho casu
+		# stejne tak bulharstina pomoci pomocneho slova ще
+		# makedonstina a bulharstina
+		if node.feats['Tense'] == 'Pres':
+			aux = [x for x in node.children if x.lemma == 'ќе' or x.lemma == 'ще']
+			if len(aux) == 1:
+				aux[0].feats['Tense'] = 'Fut'
+				
+		# in Czech and in Old Church Slavonic, the participles are sometimes marked with the plural gender
+		if node.feats['Gender'] == 'Fem,Neut' or node.feats['Gender'] == 'Fem,Masc':
+			subj = [x for x in node.children if x.udeprel == 'nsubj']
+
+			# for relative pronouns, only one gender is indicated
+			if len(subj) == 1:
+				conj = [x for x in subj[0].children if x.deprel == 'conj']
+				if len(conj) == 0:
+					node.feats['Gender'] = subj[0].feats['Gender']
+					node.feats['Number'] = subj[0].feats['Number']
+
+		# participles in passive are sometimes annotated as VERB, sometimes as ADJ
+		if node.upos == 'VERB' and node.feats['Voice'] == 'Pass':
+			node.upos = 'ADJ'
+
+		# there are cases where the node has deprel=='expl:pv' or 'expl:pass' or 'expl:impers' and Reflex is not Yes (i.e. Macedonian treebank)
+		# we add the Reflex=Yes feature
+		if node.deprel == 'expl:pv' or node.deprel == 'expl:pass' or node.deprel == 'expl:impers':
+			node.feats['Reflex'] = 'Yes'
+
+		# fixing the mistake in Macedonian treebank (mk_mtb-ud-test.conllu), in sent_id=other0010, there is personal pronoun 'ми' marked as expl:pv, it should be iobj
+		if node.deprel == 'expl:pv' and node.lemma == 'ми' and node.feats['PronType'] == 'Prs':
+			node.deprel = ''
+			node.udeprel = 'iobj'
+
+		# in Old Church Slavonic, there is feature Mood=Sub, but this is a notation for conditional mood
+		if node.feats['Mood'] == 'Sub':
+			node.feats['Mood'] = 'Cnd'
+
+		# TODO maybe we want to set Tense=Fut for the perfective verbs with Tense=Pres? This could solve the problem with the simplified detection of the future tense in Czech
+		# but there are many verbs with no Aspect value, so the problem is still there 
+
+
+
+		
+				
diff --git a/udapi/block/mwe/slavic/present.py b/udapi/block/mwe/slavic/present.py
index 9ab9545d..bca03666 100644
--- a/udapi/block/mwe/slavic/present.py
+++ b/udapi/block/mwe/slavic/present.py
@@ -26,7 +26,7 @@ def process_node(self,node):
 		# the condition VerbForm == 'Fin' ensures that there are no transgressives between the found verbs
 		
 		if node.feats['Tense'] == 'Pres' and node.upos == 'VERB' and node.feats['VerbForm'] == 'Fin': #and node.feats['Aspect']=='Imp':
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			aux_forb = [x for x in node.children if x.upos == 'AUX' and (x.lemma == 'ќе' or x.lemma == 'ще' or x.feats['Mood'] == 'Cnd')] # forbidden auxiliaries for present tense (these auxiliaries are used for the future tense or the conditional mood)
 
@@ -81,7 +81,7 @@ def process_node(self,node):
 		aux_forb = [x for x in node.children if x.upos == 'AUX' and x.feats['Tense'] != 'Pres'] # in Serbian this can be a future tense
 		prep = [x for x in node.children if x.upos == 'ADP']
 		neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
-		refl = [x for x in node.children if x.feats['Reflex'] == 'Yes']
+		refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			
 		if len(cop) > 0 and len(aux_forb) == 0:
 			copVerb = cop[0]
@@ -96,7 +96,7 @@ def process_node(self,node):
 					aspect=node.feats['Aspect'],
 					mood='Ind',
 					form='Fin',
-					voice=self.wr.get_voice(node, refl),
+					voice=self.wr.get_voice(copVerb, refl),
 					reflex=self.wr.get_is_reflex(node, refl),
 					polarity=self.wr.get_polarity(copVerb,neg),
 					ords=phrase_ords

From 0a3c623d841f9fc16b38704860ebe6e362622ccb Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Apr 2025 13:07:27 +0200
Subject: [PATCH 1244/1374] =?UTF-8?q?Len=C4=8Diny=20bloky=20p=C5=99izp?=
 =?UTF-8?q?=C5=AFsobeny=20integraci=20do=20Udapi=20podobn=C4=9B=20jako=20u?=
 =?UTF-8?q?=C5=BE=20d=C5=99=C3=ADve=20slavic.Conditional.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/mwe/slavic/conditional.py  |  8 ++-
 udapi/block/mwe/slavic/converb.py      | 46 ++++++----------
 udapi/block/mwe/slavic/future.py       | 76 +++++++++++---------------
 udapi/block/mwe/slavic/imperative.py   | 48 ++++++----------
 udapi/block/mwe/slavic/infinitive.py   | 58 +++++++-------------
 udapi/block/mwe/slavic/past.py         | 62 ++++++++-------------
 udapi/block/mwe/slavic/preprocessor.py |  7 ++-
 udapi/block/mwe/slavic/present.py      | 49 ++++++-----------
 8 files changed, 136 insertions(+), 218 deletions(-)

diff --git a/udapi/block/mwe/slavic/conditional.py b/udapi/block/mwe/slavic/conditional.py
index 9573d377..40f96579 100644
--- a/udapi/block/mwe/slavic/conditional.py
+++ b/udapi/block/mwe/slavic/conditional.py
@@ -1,6 +1,8 @@
-#!/usr/bin/env python3
-
-# Conditional mood of Slavic languages
+"""
+Morphosyntactic features (UniDive, Lenka Krippnerová):
+This block detects conditional verb forms in Slavic languages and saves their
+features as Phrase* attributes in MISC of their head word.
+"""
 
 import udapi.block.mwe.msfphrase
 
diff --git a/udapi/block/mwe/slavic/converb.py b/udapi/block/mwe/slavic/converb.py
index 612fbd6a..66a4131f 100644
--- a/udapi/block/mwe/slavic/converb.py
+++ b/udapi/block/mwe/slavic/converb.py
@@ -1,26 +1,12 @@
-#!/usr/bin/env python3
+"""
+Morphosyntactic features (UniDive, Lenka Krippnerová):
+This block detects converb (transgressive) forms in Slavic languages and saves their
+features as Phrase* attributes in MISC of their head word.
+"""
 
-# Transgressives of Slavic languages
+import udapi.block.mwe.msfphrase
 
-from udapi.core.block import Block
-import importlib
-import sys
-
-class Slavic_transgressive(Block):
-	def __init__(self, writer_prefix='',**kwargs):
-		super().__init__(**kwargs)
-		if writer_prefix != '':
-			writer_module = ".".join([writer_prefix,'writer'])
-		else:
-			writer_module = 'writer'
-		try:
-			module = importlib.import_module(writer_module)
-		except ModuleNotFoundError as e:
-			print(e, file=sys.stderr)
-			print("Try to set writer_prefix parameter.", file=sys.stderr)
-			exit(1)
-
-		self.wr = module.Writer()
+class Converb(udapi.block.mwe.msfphrase.MsfPhrase):
 	
 	def process_node(self, node):
 		# condition node.upos == 'VERB' to prevent copulas from entering this branch
@@ -31,18 +17,18 @@ def process_node(self, node):
 			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
 			phrase_ords.sort()
 			
-			self.wr.write_node_info(node,
+			self.write_node_info(node,
 				person=node.feats['Person'],
 				number=node.feats['Number'],
 				form='Conv',
 				tense=node.feats['Tense'],
 				aspect=node.feats['Aspect'],
-				polarity=self.wr.get_polarity(node,neg),
-				reflex=self.wr.get_is_reflex(node,refl),
+				polarity=self.get_polarity(node,neg),
+				reflex=self.get_is_reflex(node,refl),
 				ords=phrase_ords,
 				gender=node.feats['Gender'],
 				animacy=node.feats['Animacy'],
-				voice=self.wr.get_voice(node, refl)
+				voice=self.get_voice(node, refl)
 				)
 
 		# passive voice
@@ -55,13 +41,13 @@ def process_node(self, node):
 				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in neg]
 				phrase_ords.sort()
 			
-				self.wr.write_node_info(node,
+				self.write_node_info(node,
 					person=auxVerb.feats['Person'],
 					number=auxVerb.feats['Number'],
 					form='Conv',
 					tense=auxVerb.feats['Tense'],
 					aspect=node.feats['Aspect'],
-					polarity=self.wr.get_polarity(auxVerb,neg),
+					polarity=self.get_polarity(auxVerb,neg),
 					ords=phrase_ords,
 					gender=auxVerb.feats['Gender'],
 					animacy=auxVerb.feats['Animacy'],
@@ -82,15 +68,15 @@ def process_node(self, node):
 				phrase_ords.sort()
 
 				
-				self.wr.write_node_info(node,
+				self.write_node_info(node,
 					person=copVerb.feats['Person'],
 					number=copVerb.feats['Number'],
 					tense=copVerb.feats['Tense'],
 					gender=copVerb.feats['Gender'],
 					animacy=copVerb.feats['Animacy'],
 					form='Conv',
-					polarity=self.wr.get_polarity(node,neg),
+					polarity=self.get_polarity(node,neg),
 					ords=phrase_ords,
-					voice=self.wr.get_voice(copVerb, refl)
+					voice=self.get_voice(copVerb, refl)
 					)
 
diff --git a/udapi/block/mwe/slavic/future.py b/udapi/block/mwe/slavic/future.py
index 12e1574c..0e53a986 100644
--- a/udapi/block/mwe/slavic/future.py
+++ b/udapi/block/mwe/slavic/future.py
@@ -1,26 +1,12 @@
-#!/usr/bin/env python3
+"""
+Morphosyntactic features (UniDive, Lenka Krippnerová):
+This block detects future tense forms in Slavic languages and saves their
+features as Phrase* attributes in MISC of their head word.
+"""
 
-# Future tense of Slavic languages
+import udapi.block.mwe.msfphrase
 
-from udapi.core.block import Block
-import importlib
-import sys
-
-class Slavic_future(Block):
-	def __init__(self, writer_prefix='',**kwargs):
-		super().__init__(**kwargs)
-		if writer_prefix != '':
-			writer_module = ".".join([writer_prefix,'writer'])
-		else:
-			writer_module = 'writer'
-		try:
-			module = importlib.import_module(writer_module)
-		except ModuleNotFoundError as e:
-			print(e, file=sys.stderr)
-			print("Try to set writer_prefix parameter.", file=sys.stderr)
-			exit(1)
-
-		self.wr = module.Writer()
+class Future(udapi.block.mwe.msfphrase.MsfPhrase):
 	
 	def process_node(self, node):
 		# future tense for Serbian and Croatian
@@ -39,7 +25,7 @@ def process_node(self, node):
 			#if voice == '':
 			#	voice = 'Act'
 			if len(cop) == 0:
-				self.wr.write_node_info(node, 
+				self.write_node_info(node, 
 					tense='Fut',
 					person=aux[0].feats['Person'],
 					number=aux[0].feats['Number'],
@@ -47,8 +33,8 @@ def process_node(self, node):
 					voice=voice,
 					aspect=node.feats['Aspect'], # srbstina ani chorvatstina vidy nema
 					form='Fin',
-					polarity=self.wr.get_polarity(node,neg),
-					reflex=self.wr.get_is_reflex(node,refl),
+					polarity=self.get_polarity(node,neg),
+					reflex=self.get_is_reflex(node,refl),
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
 					ords=phrase_ords
@@ -58,7 +44,7 @@ def process_node(self, node):
 				phrase_ords += [x.ord for x in prep]
 				phrase_ords.sort()
 
-				self.wr.write_node_info(node, 
+				self.write_node_info(node, 
 					tense='Fut',
 					person=aux[0].feats['Person'],
 					number=aux[0].feats['Number'],
@@ -66,8 +52,8 @@ def process_node(self, node):
 					voice=voice,
 					aspect=node.feats['Aspect'], 
 					form='Fin',
-					polarity=self.wr.get_polarity(node,neg),
-					reflex=self.wr.get_is_reflex(node,refl),
+					polarity=self.get_polarity(node,neg),
+					reflex=self.get_is_reflex(node,refl),
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
 					ords=phrase_ords
@@ -85,7 +71,7 @@ def process_node(self, node):
 			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg] + [x.ord for x in aux]
 			phrase_ords.sort()
 			
-			self.wr.write_node_info(node, 
+			self.write_node_info(node, 
 				tense='Fut',
 				person=node.feats['Person'],
 				number=node.feats['Number'],
@@ -93,8 +79,8 @@ def process_node(self, node):
 				voice=node.feats['Voice'],
 				aspect=node.feats['Aspect'],
 				form='Fin',
-				polarity=self.wr.get_polarity(node,neg),
-				reflex=self.wr.get_is_reflex(node,refl),
+				polarity=self.get_polarity(node,neg),
+				reflex=self.get_is_reflex(node,refl),
 				ords=phrase_ords
 				)
 			return
@@ -110,16 +96,16 @@ def process_node(self, node):
 			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
 			phrase_ords.sort()
 			
-			self.wr.write_node_info(node, 
+			self.write_node_info(node, 
 				tense='Fut',
 				person=node.feats['Person'],
 				number=node.feats['Number'],
 				mood='Ind',
-				voice=self.wr.get_voice(node,refl),
+				voice=self.get_voice(node,refl),
 				form='Fin',
 				aspect='Perf',
-				polarity=self.wr.get_polarity(node,neg),
-				reflex=self.wr.get_is_reflex(node,refl),
+				polarity=self.get_polarity(node,neg),
+				reflex=self.get_is_reflex(node,refl),
 				ords=phrase_ords
 				)
 			return"""
@@ -138,16 +124,16 @@ def process_node(self, node):
 				auxVerb = aux[0]
 				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in refl] + [x.ord for x in neg]
 				phrase_ords.sort()
-				self.wr.write_node_info(node,
+				self.write_node_info(node,
 					tense='Fut',
 					person=auxVerb.feats['Person'],
 					number=auxVerb.feats['Number'],
 					mood='Ind',
-					voice=self.wr.get_voice(node,refl),
+					voice=self.get_voice(node,refl),
 					aspect=node.feats['Aspect'],
 					form='Fin',
-					polarity=self.wr.get_polarity(auxVerb,neg),
-					reflex=self.wr.get_is_reflex(node,refl),
+					polarity=self.get_polarity(auxVerb,neg),
+					reflex=self.get_is_reflex(node,refl),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy']
@@ -162,16 +148,16 @@ def process_node(self, node):
 				phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
 				phrase_ords.sort()
 				
-				self.wr.write_node_info(node,
+				self.write_node_info(node,
 					tense='Fut',
 					person=node.feats['Person'],
 					number=node.feats['Number'],
 					mood='Ind',
-					voice=self.wr.get_voice(node,refl), # passivum se muze objevit (napr. pojede se), ale jmenny rod neni vyjadren
+					voice=self.get_voice(node,refl), # passivum se muze objevit (napr. pojede se), ale jmenny rod neni vyjadren
 					aspect=node.feats['Aspect'],
 					form='Fin',
-					polarity=self.wr.get_polarity(node,neg),
-					reflex=self.wr.get_is_reflex(node,refl),
+					polarity=self.get_polarity(node,neg),
+					reflex=self.get_is_reflex(node,refl),
 					ords=phrase_ords
 					)
 				return
@@ -188,14 +174,14 @@ def process_node(self, node):
 			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in aux] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
 			phrase_ords.sort()
 				
-			self.wr.write_node_info(node,
+			self.write_node_info(node,
 					tense='Fut',
 					person=copVerb.feats['Person'],
 					number=copVerb.feats['Number'],
 					mood='Ind',
 					form='Fin',
-					voice=self.wr.get_voice(copVerb, refl),
-					polarity=self.wr.get_polarity(copVerb,neg),
+					voice=self.get_voice(copVerb, refl),
+					polarity=self.get_polarity(copVerb,neg),
 					ords=phrase_ords
 				)
 
diff --git a/udapi/block/mwe/slavic/imperative.py b/udapi/block/mwe/slavic/imperative.py
index cbb521ac..edfed5d9 100644
--- a/udapi/block/mwe/slavic/imperative.py
+++ b/udapi/block/mwe/slavic/imperative.py
@@ -1,26 +1,12 @@
-#!/usr/bin/env python3
+"""
+Morphosyntactic features (UniDive, Lenka Krippnerová):
+This block detects imperative verb forms in Slavic languages and saves their
+features as Phrase* attributes in MISC of their head word.
+"""
 
-# Imperative of Slavic languages
+import udapi.block.mwe.msfphrase
 
-from udapi.core.block import Block
-import importlib
-import sys
-
-class Slavic_imperative(Block):
-	def __init__(self, writer_prefix='',**kwargs):
-		super().__init__(**kwargs)
-		if writer_prefix != '':
-			writer_module = ".".join([writer_prefix,'writer'])
-		else:
-			writer_module = 'writer'
-		try:
-			module = importlib.import_module(writer_module)
-		except ModuleNotFoundError as e:
-			print(e, file=sys.stderr)
-			print("Try to set writer_prefix parameter.", file=sys.stderr)
-			exit(1)
-
-		self.wr = module.Writer()
+class Imperative(udapi.block.mwe.msfphrase.MsfPhrase):
 	
 	def process_node(self, node):
 		# the condition node.upos == 'VERB' ensures that copulas do not enter this branch
@@ -31,15 +17,15 @@ def process_node(self, node):
 			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
 			phrase_ords.sort()
 			
-			self.wr.write_node_info(node,
+			self.write_node_info(node,
 				person=node.feats['Person'],
 				number=node.feats['Number'],
 				aspect=node.feats['Aspect'],
 				mood='Imp',
 				form='Fin',
 				voice='Act',
-				polarity=self.wr.get_polarity(node,neg),
-				reflex=self.wr.get_is_reflex(node,refl),
+				polarity=self.get_polarity(node,neg),
+				reflex=self.get_is_reflex(node,refl),
 				ords=phrase_ords
 				)
 			return
@@ -53,14 +39,14 @@ def process_node(self, node):
 				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in neg]
 				phrase_ords.sort()
 				
-				self.wr.write_node_info(node,
+				self.write_node_info(node,
 					person=aux[0].feats['Person'],
 					number=aux[0].feats['Number'],
 					mood='Imp',
 					voice='Pass',
 					aspect=node.feats['Aspect'],
 					form='Fin',
-					polarity=self.wr.get_polarity(node,neg),
+					polarity=self.get_polarity(node,neg),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy']
@@ -78,16 +64,14 @@ def process_node(self, node):
 			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
 			phrase_ords.sort()
 				
-			self.wr.write_node_info(node,
+			self.write_node_info(node,
 				person=copVerb.feats['Person'],
 				number=copVerb.feats['Number'],
 				mood='Imp',
 				form='Fin',
-				voice=self.wr.get_voice(copVerb, refl),
-				reflex=self.wr.get_is_reflex(node, refl),
-				polarity=self.wr.get_polarity(node,neg),
+				voice=self.get_voice(copVerb, refl),
+				reflex=self.get_is_reflex(node, refl),
+				polarity=self.get_polarity(node,neg),
 				ords=phrase_ords
 				)
-				
-
 
diff --git a/udapi/block/mwe/slavic/infinitive.py b/udapi/block/mwe/slavic/infinitive.py
index 7932e8e8..96aa241b 100644
--- a/udapi/block/mwe/slavic/infinitive.py
+++ b/udapi/block/mwe/slavic/infinitive.py
@@ -1,26 +1,12 @@
-#!/usr/bin/env python3
+"""
+Morphosyntactic features (UniDive, Lenka Krippnerová):
+This block detects infinitive verb forms in Slavic languages and saves their
+features as Phrase* attributes in MISC of their head word.
+"""
 
-# Infinitive of Slavic languages
+import udapi.block.mwe.msfphrase
 
-from udapi.core.block import Block
-import importlib
-import sys
-
-class Slavic_inf(Block):
-	def __init__(self, writer_prefix='',**kwargs):
-		super().__init__(**kwargs)
-		if writer_prefix != '':
-			writer_module = ".".join([writer_prefix,'writer'])
-		else:
-			writer_module = 'writer'
-		try:
-			module = importlib.import_module(writer_module)
-		except ModuleNotFoundError as e:
-			print(e, file=sys.stderr)
-			print("Try to set writer_prefix parameter.", file=sys.stderr)
-			exit(1)
-
-		self.wr = module.Writer()
+class Infinitive(udapi.block.mwe.msfphrase.MsfPhrase):
 		
 	def process_node(self,node):
 		if node.feats['VerbForm'] == 'Inf' and node.upos == 'VERB':
@@ -33,15 +19,15 @@ def process_node(self,node):
 				phrase_ords.sort()
 				
 				voice='Act'
-				if self.wr.is_expl_pass(refl):
+				if self.is_expl_pass(refl):
 					voice='Pass'
 				
-				self.wr.write_node_info(node,
+				self.write_node_info(node,
 					aspect=node.feats['Aspect'],
 					voice=voice,
 					form='Inf',
-					polarity=self.wr.get_polarity(node,neg),
-					reflex=self.wr.get_is_reflex(node,refl),
+					polarity=self.get_polarity(node,neg),
+					reflex=self.get_is_reflex(node,refl),
 					ords=phrase_ords
 				)
 				return
@@ -56,12 +42,12 @@ def process_node(self,node):
 				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in neg] + [x.ord for x in refl]
 				phrase_ords.sort()
 				
-				self.wr.write_node_info(node,
+				self.write_node_info(node,
 					aspect=node.feats['Aspect'],
 					voice='Pass',
 					form='Inf',
-					polarity=self.wr.get_polarity(aux[0],neg),
-					reflex=self.wr.get_is_reflex(node, refl),
+					polarity=self.get_polarity(aux[0],neg),
+					reflex=self.get_is_reflex(node, refl),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
@@ -80,11 +66,11 @@ def process_node(self,node):
 			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
 			phrase_ords.sort()
 			
-			self.wr.write_node_info(node,
-				voice=self.wr.get_voice(cop[0], refl),
+			self.write_node_info(node,
+				voice=self.get_voice(cop[0], refl),
 				form='Inf',
-				polarity=self.wr.get_polarity(cop[0],neg),
-				reflex=self.wr.get_is_reflex(node, refl),
+				polarity=self.get_polarity(cop[0],neg),
+				reflex=self.get_is_reflex(node, refl),
 				ords=phrase_ords
 				)
 			
@@ -96,13 +82,11 @@ def process_node(self,node):
 			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
 			phrase_ords.sort()
 
-			self.wr.write_node_info(node,
+			self.write_node_info(node,
 					aspect=node.feats['Aspect'],
 					voice='Act',
 					form='Sup',
-					polarity=self.wr.get_polarity(node,neg),
-					reflex=self.wr.get_is_reflex(node, refl),
+					polarity=self.get_polarity(node,neg),
+					reflex=self.get_is_reflex(node, refl),
 					ords=phrase_ords
 					)
-
-							
diff --git a/udapi/block/mwe/slavic/past.py b/udapi/block/mwe/slavic/past.py
index 3f341f5b..3e2b8d7e 100644
--- a/udapi/block/mwe/slavic/past.py
+++ b/udapi/block/mwe/slavic/past.py
@@ -1,26 +1,12 @@
-#!/usr/bin/env python3
+"""
+Morphosyntactic features (UniDive, Lenka Krippnerová):
+This block detects past tense forms in Slavic languages and saves their
+features as Phrase* attributes in MISC of their head word.
+"""
 
-# Past tense of Slavic languages
+import udapi.block.mwe.msfphrase
 
-from udapi.core.block import Block
-import importlib
-import sys
-
-class Slavic_past(Block):
-	def __init__(self, writer_prefix='',**kwargs):
-		super().__init__(**kwargs)
-		if writer_prefix != '':
-			writer_module = ".".join([writer_prefix,'writer'])
-		else:
-			writer_module = 'writer'
-		try:
-			module = importlib.import_module(writer_module)
-		except ModuleNotFoundError as e:
-			print(e, file=sys.stderr)
-			print("Try to set writer_prefix parameter.", file=sys.stderr)
-			exit(1)
-
-		self.wr = module.Writer()
+class Past(udapi.block.mwe.msfphrase.MsfPhrase):
 
 	def get_person_for_langs_with_simple_past(self, node, person):
 		"""
@@ -48,7 +34,7 @@ def process_node(self, node):
 			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
 			phrase_ords.sort()
 
-			self.wr.write_node_info(node,
+			self.write_node_info(node,
 						tense=node.feats['Tense'],
 						person=node.feats['Person'],
 						number=node.feats['Number'],
@@ -56,8 +42,8 @@ def process_node(self, node):
 						voice='Pass',
 						aspect=node.feats['Aspect'],
 						form=node.feats['VerbForm'],
-						polarity=self.wr.get_polarity(node,neg),
-						reflex=self.wr.get_is_reflex(node,refl),
+						polarity=self.get_polarity(node,neg),
+						reflex=self.get_is_reflex(node,refl),
 						ords=phrase_ords,
 						gender=node.feats['Gender'],
 						animacy=node.feats['Animacy']
@@ -92,16 +78,16 @@ def process_node(self, node):
 				if node.feats['Tense'] == 'Pqp':
 					tense = 'Pqp'
 
-				self.wr.write_node_info(node,
+				self.write_node_info(node,
 						tense=tense,
 						person=person,
 						number=node.feats['Number'],
 						mood='Ind',
-						voice=self.wr.get_voice(node,refl),
+						voice=self.get_voice(node,refl),
 						aspect=node.feats['Aspect'],
 						form='Fin',
-						polarity=self.wr.get_polarity(node,neg),
-						reflex=self.wr.get_is_reflex(node,refl),
+						polarity=self.get_polarity(node,neg),
+						reflex=self.get_is_reflex(node,refl),
 						ords=phrase_ords,
 						gender=node.feats['Gender'],
 						animacy=node.feats['Animacy']
@@ -123,16 +109,16 @@ def process_node(self, node):
 				phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
 				phrase_ords.sort()
 
-				self.wr.write_node_info(node,
+				self.write_node_info(node,
 					tense=node.feats['Tense'],
 					person=node.feats['Person'],
 					number=node.feats['Number'],
 					mood='Ind',
-					voice=self.wr.get_voice(node,refl),
+					voice=self.get_voice(node,refl),
 					aspect=node.feats['Aspect'],
 					form=node.feats['VerbForm'],
-					polarity=self.wr.get_polarity(node,neg),
-					reflex=self.wr.get_is_reflex(node,refl),
+					polarity=self.get_polarity(node,neg),
+					reflex=self.get_is_reflex(node,refl),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy']
@@ -156,7 +142,7 @@ def process_node(self, node):
 						person = aux_pres_tense[0].feats['Person']
 					person = self.get_person_for_langs_with_simple_past(node, person)
 
-					self.wr.write_node_info(node,
+					self.write_node_info(node,
 						tense=aux_past_tense[0].feats['Tense'],
 						person=person,
 						number=aux_past_tense[0].feats['Number'],
@@ -164,7 +150,7 @@ def process_node(self, node):
 						voice='Pass',
 						form='Fin',
 						aspect=node.feats['Aspect'],
-						polarity=self.wr.get_polarity(aux_past_tense[0],neg),
+						polarity=self.get_polarity(aux_past_tense[0],neg),
 						ords=phrase_ords,
 						gender=node.feats['Gender'],
 						animacy=node.feats['Animacy']
@@ -189,16 +175,16 @@ def process_node(self, node):
 				if cop[0].feats['VerbForm'] == 'Fin':
 					person = ''
 				
-				self.wr.write_node_info(node,
+				self.write_node_info(node,
 					aspect=cop[0].feats['Aspect'],
 					tense=cop[0].feats['Tense'],
 					person=person,
 					number=cop[0].feats['Number'],
 					mood='Ind',
-					voice=self.wr.get_voice(cop[0], refl),
+					voice=self.get_voice(cop[0], refl),
 					form='Fin',
-					reflex=self.wr.get_is_reflex(node,refl),
-					polarity=self.wr.get_polarity(cop[0],neg),
+					reflex=self.get_is_reflex(node,refl),
+					polarity=self.get_polarity(cop[0],neg),
 					ords=phrase_ords,
 					gender=cop[0].feats['Gender'],
 					animacy=cop[0].feats['Animacy']
diff --git a/udapi/block/mwe/slavic/preprocessor.py b/udapi/block/mwe/slavic/preprocessor.py
index c6a2dcbe..833f3de0 100644
--- a/udapi/block/mwe/slavic/preprocessor.py
+++ b/udapi/block/mwe/slavic/preprocessor.py
@@ -1,4 +1,9 @@
-#!/usr/bin/env python3
+"""
+Morphosyntactic features (UniDive, Lenka Krippnerová):
+This block serves as a preprocessor for Slavic languages before the other blocks
+are applied to detect periphrastic verb forms. It improves harmonization of
+annotations across the treebanks by addressing some known divergences.
+"""
 
 from udapi.core.block import Block
 
diff --git a/udapi/block/mwe/slavic/present.py b/udapi/block/mwe/slavic/present.py
index bca03666..7b83aede 100644
--- a/udapi/block/mwe/slavic/present.py
+++ b/udapi/block/mwe/slavic/present.py
@@ -1,26 +1,12 @@
-#!/usr/bin/env python3
+"""
+Morphosyntactic features (UniDive, Lenka Krippnerová):
+This block detects present tense forms in Slavic languages and saves their
+features as Phrase* attributes in MISC of their head word.
+"""
 
-# Present tense of Slavic languages
+import udapi.block.mwe.msfphrase
 
-from udapi.core.block import Block
-import importlib
-import sys
-
-class Slavic_pres(Block):
-	def __init__(self, writer_prefix='',**kwargs):
-		super().__init__(**kwargs)
-		if writer_prefix != '':
-			writer_module = ".".join([writer_prefix,'writer'])
-		else:
-			writer_module = 'writer'
-		try:
-			module = importlib.import_module(writer_module)
-		except ModuleNotFoundError as e:
-			print(e, file=sys.stderr)
-			print("Try to set writer_prefix parameter.", file=sys.stderr)
-			exit(1)
-
-		self.wr = module.Writer()
+class Present(udapi.block.mwe.msfphrase.MsfPhrase):
 		
 	def process_node(self,node):
 		# the condition VerbForm == 'Fin' ensures that there are no transgressives between the found verbs
@@ -34,16 +20,16 @@ def process_node(self,node):
 				phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
 				phrase_ords.sort()
 				
-				self.wr.write_node_info(node,
+				self.write_node_info(node,
 					tense='Pres',
 					person=node.feats['Person'],
 					number=node.feats['Number'],
 					mood='Ind',
 					aspect=node.feats['Aspect'],
-					voice=self.wr.get_voice(node,refl),
+					voice=self.get_voice(node,refl),
 					form='Fin',
-					polarity=self.wr.get_polarity(node,neg),
-					reflex=self.wr.get_is_reflex(node,refl),
+					polarity=self.get_polarity(node,neg),
+					reflex=self.get_is_reflex(node,refl),
 					ords=phrase_ords
 					)
 				return
@@ -61,7 +47,7 @@ def process_node(self,node):
 			if len(aux) > 0 and len(aux_forb) == 0:
 				auxVerb = aux[0]
 
-				self.wr.write_node_info(node,
+				self.write_node_info(node,
 					tense='Pres',
 					person=auxVerb.feats['Person'],
 					number=auxVerb.feats['Number'],
@@ -69,7 +55,7 @@ def process_node(self,node):
 					aspect=node.feats['Aspect'],
 					form='Fin',
 					voice='Pass',
-					polarity=self.wr.get_polarity(auxVerb,neg),
+					polarity=self.get_polarity(auxVerb,neg),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy']
@@ -89,16 +75,15 @@ def process_node(self,node):
 			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in aux] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
 			phrase_ords.sort()
 				
-			self.wr.write_node_info(node,
+			self.write_node_info(node,
 					tense='Pres',
 					person=copVerb.feats['Person'],
 					number=copVerb.feats['Number'],
 					aspect=node.feats['Aspect'],
 					mood='Ind',
 					form='Fin',
-					voice=self.wr.get_voice(copVerb, refl),
-					reflex=self.wr.get_is_reflex(node, refl),
-					polarity=self.wr.get_polarity(copVerb,neg),
+					voice=self.get_voice(copVerb, refl),
+					reflex=self.get_is_reflex(node, refl),
+					polarity=self.get_polarity(copVerb,neg),
 					ords=phrase_ords
 				)
-

From 2ecb4e1acbbb54020894193d59dc8462faaf1a6a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Apr 2025 13:10:34 +0200
Subject: [PATCH 1245/1374] Reorganized: mwe and msf are quite different
 projects and sets of blocks.

---
 udapi/block/{mwe => msf}/msfcase.py           |  0
 udapi/block/{mwe => msf}/msfcreateabstract.py |  0
 udapi/block/{mwe => msf}/msfinit.py           |  0
 udapi/block/{mwe => msf}/msfnumphrase.py      |  0
 udapi/block/{mwe => msf}/msfphrase.py         |  0
 udapi/block/{mwe => msf}/msfremovefunc.py     |  0
 .../block/{mwe => msf}/slavic/conditional.py  |  0
 udapi/block/{mwe => msf}/slavic/converb.py    |  0
 udapi/block/{mwe => msf}/slavic/future.py     |  0
 udapi/block/{mwe => msf}/slavic/imperative.py |  0
 udapi/block/{mwe => msf}/slavic/infinitive.py |  0
 udapi/block/{mwe => msf}/slavic/past.py       |  0
 .../block/{mwe => msf}/slavic/preprocessor.py |  0
 udapi/block/{mwe => msf}/slavic/present.py    |  0
 udapi/block/mwe/preprocessor.py               | 46 -------------------
 15 files changed, 46 deletions(-)
 rename udapi/block/{mwe => msf}/msfcase.py (100%)
 rename udapi/block/{mwe => msf}/msfcreateabstract.py (100%)
 rename udapi/block/{mwe => msf}/msfinit.py (100%)
 rename udapi/block/{mwe => msf}/msfnumphrase.py (100%)
 rename udapi/block/{mwe => msf}/msfphrase.py (100%)
 rename udapi/block/{mwe => msf}/msfremovefunc.py (100%)
 rename udapi/block/{mwe => msf}/slavic/conditional.py (100%)
 rename udapi/block/{mwe => msf}/slavic/converb.py (100%)
 rename udapi/block/{mwe => msf}/slavic/future.py (100%)
 rename udapi/block/{mwe => msf}/slavic/imperative.py (100%)
 rename udapi/block/{mwe => msf}/slavic/infinitive.py (100%)
 rename udapi/block/{mwe => msf}/slavic/past.py (100%)
 rename udapi/block/{mwe => msf}/slavic/preprocessor.py (100%)
 rename udapi/block/{mwe => msf}/slavic/present.py (100%)
 delete mode 100644 udapi/block/mwe/preprocessor.py

diff --git a/udapi/block/mwe/msfcase.py b/udapi/block/msf/msfcase.py
similarity index 100%
rename from udapi/block/mwe/msfcase.py
rename to udapi/block/msf/msfcase.py
diff --git a/udapi/block/mwe/msfcreateabstract.py b/udapi/block/msf/msfcreateabstract.py
similarity index 100%
rename from udapi/block/mwe/msfcreateabstract.py
rename to udapi/block/msf/msfcreateabstract.py
diff --git a/udapi/block/mwe/msfinit.py b/udapi/block/msf/msfinit.py
similarity index 100%
rename from udapi/block/mwe/msfinit.py
rename to udapi/block/msf/msfinit.py
diff --git a/udapi/block/mwe/msfnumphrase.py b/udapi/block/msf/msfnumphrase.py
similarity index 100%
rename from udapi/block/mwe/msfnumphrase.py
rename to udapi/block/msf/msfnumphrase.py
diff --git a/udapi/block/mwe/msfphrase.py b/udapi/block/msf/msfphrase.py
similarity index 100%
rename from udapi/block/mwe/msfphrase.py
rename to udapi/block/msf/msfphrase.py
diff --git a/udapi/block/mwe/msfremovefunc.py b/udapi/block/msf/msfremovefunc.py
similarity index 100%
rename from udapi/block/mwe/msfremovefunc.py
rename to udapi/block/msf/msfremovefunc.py
diff --git a/udapi/block/mwe/slavic/conditional.py b/udapi/block/msf/slavic/conditional.py
similarity index 100%
rename from udapi/block/mwe/slavic/conditional.py
rename to udapi/block/msf/slavic/conditional.py
diff --git a/udapi/block/mwe/slavic/converb.py b/udapi/block/msf/slavic/converb.py
similarity index 100%
rename from udapi/block/mwe/slavic/converb.py
rename to udapi/block/msf/slavic/converb.py
diff --git a/udapi/block/mwe/slavic/future.py b/udapi/block/msf/slavic/future.py
similarity index 100%
rename from udapi/block/mwe/slavic/future.py
rename to udapi/block/msf/slavic/future.py
diff --git a/udapi/block/mwe/slavic/imperative.py b/udapi/block/msf/slavic/imperative.py
similarity index 100%
rename from udapi/block/mwe/slavic/imperative.py
rename to udapi/block/msf/slavic/imperative.py
diff --git a/udapi/block/mwe/slavic/infinitive.py b/udapi/block/msf/slavic/infinitive.py
similarity index 100%
rename from udapi/block/mwe/slavic/infinitive.py
rename to udapi/block/msf/slavic/infinitive.py
diff --git a/udapi/block/mwe/slavic/past.py b/udapi/block/msf/slavic/past.py
similarity index 100%
rename from udapi/block/mwe/slavic/past.py
rename to udapi/block/msf/slavic/past.py
diff --git a/udapi/block/mwe/slavic/preprocessor.py b/udapi/block/msf/slavic/preprocessor.py
similarity index 100%
rename from udapi/block/mwe/slavic/preprocessor.py
rename to udapi/block/msf/slavic/preprocessor.py
diff --git a/udapi/block/mwe/slavic/present.py b/udapi/block/msf/slavic/present.py
similarity index 100%
rename from udapi/block/mwe/slavic/present.py
rename to udapi/block/msf/slavic/present.py
diff --git a/udapi/block/mwe/preprocessor.py b/udapi/block/mwe/preprocessor.py
deleted file mode 100644
index 1ac8a6f1..00000000
--- a/udapi/block/mwe/preprocessor.py
+++ /dev/null
@@ -1,46 +0,0 @@
-#!/usr/bin/env python3
-
-from udapi.core.block import Block
-
-class Preprocessor(Block):
-		
-	def process_node(self,node):
-				
-		# in Belarusian, some adjectives formed from verbs are marked as verbs
-		# if the verb has case, then it is an adjective
-		if node.upos == 'VERB' and node.feats['Case'] != '':
-			node.upos = 'ADJ'
-			
-		# in Polish, the conditional mood for auxiliary verbs is marked as deprel == 'aux:cnd' and not as in the last Slavic languages ​​feats['Mood'] == 'Cnd'
-		if node.deprel == 'aux:cnd':
-			node.feats['Mood'] = 'Cnd'
-			
-		# sjednotit cas u dokonavych sloves vyjadrujici budoucnost
-		# chceme pritomny, nebo budouci? - s budoucim by se asi zjednodusilo dost veci
-		# jak ale poznat, ktery cas prepsat a ktery ne? - problem s makedonstinou
-		
-		# sjednotit passivum, rozhodnout, zda ma byt plnovyznamove sloveso znaceno jako ADJ, nebo VERB
-			
-		# unify polarities - some languages ​​mark only Neg (Russian), some mark both Neg and Pos (Czech)
-		if node.feats['Polarity'] == 'Pos':
-			node.feats['Polarity'] = ''
-		
-		# makedonstina tvori budouci cas pomoci pomocneho slova ќе, u nejz neni nijak vyznaceno, ze se podili na tvorbe budouciho casu
-		# stejne tak bulharstina pomoci pomocneho slova ще
-		# makedonstina a bulharstina
-		if node.feats['Tense'] == 'Pres':
-			aux = [x for x in node.children if x.lemma == 'ќе' or x.lemma == 'ще']
-			if len(aux) == 1:
-				aux[0].feats['Tense'] = 'Fut'
-				
-		# in Czech and in Old Church Slavonic, the participle is marked with the plural gender
-		if node.feats['Gender'] == 'Fem,Neut' or node.feats['Gender'] == 'Fem,Masc':
-			subj = [x for x in node.children if x.udeprel == 'nsubj']
-
-			# for relative pronouns, only one gender is indicated
-			if len(subj) == 1:
-				conj = [x for x in subj[0].children if x.deprel == 'conj']
-				if len(conj) == 0:
-					node.feats['Gender'] = subj[0].feats['Gender']
-					node.feats['Number'] = subj[0].feats['Number']
-				

From 6e35bc6938f05e254a74a1fdeeb7b804c9653d8f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Apr 2025 13:19:28 +0200
Subject: [PATCH 1246/1374] Fixed paths.

---
 udapi/block/msf/slavic/conditional.py | 4 ++--
 udapi/block/msf/slavic/converb.py     | 4 ++--
 udapi/block/msf/slavic/future.py      | 4 ++--
 udapi/block/msf/slavic/imperative.py  | 4 ++--
 udapi/block/msf/slavic/infinitive.py  | 4 ++--
 udapi/block/msf/slavic/past.py        | 4 ++--
 udapi/block/msf/slavic/present.py     | 4 ++--
 7 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/udapi/block/msf/slavic/conditional.py b/udapi/block/msf/slavic/conditional.py
index 40f96579..b6918111 100644
--- a/udapi/block/msf/slavic/conditional.py
+++ b/udapi/block/msf/slavic/conditional.py
@@ -4,9 +4,9 @@
 features as Phrase* attributes in MISC of their head word.
 """
 
-import udapi.block.mwe.msfphrase
+import udapi.block.msf.msfphrase
 
-class Conditional(udapi.block.mwe.msfphrase.MsfPhrase):
+class Conditional(udapi.block.msf.msfphrase.MsfPhrase):
 	
 	def process_node(self, node):
 		if (node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'PartRes') or node.feats['VerbForm'] == 'Fin':
diff --git a/udapi/block/msf/slavic/converb.py b/udapi/block/msf/slavic/converb.py
index 66a4131f..e63bbadd 100644
--- a/udapi/block/msf/slavic/converb.py
+++ b/udapi/block/msf/slavic/converb.py
@@ -4,9 +4,9 @@
 features as Phrase* attributes in MISC of their head word.
 """
 
-import udapi.block.mwe.msfphrase
+import udapi.block.msf.msfphrase
 
-class Converb(udapi.block.mwe.msfphrase.MsfPhrase):
+class Converb(udapi.block.msf.msfphrase.MsfPhrase):
 	
 	def process_node(self, node):
 		# condition node.upos == 'VERB' to prevent copulas from entering this branch
diff --git a/udapi/block/msf/slavic/future.py b/udapi/block/msf/slavic/future.py
index 0e53a986..5a64f76c 100644
--- a/udapi/block/msf/slavic/future.py
+++ b/udapi/block/msf/slavic/future.py
@@ -4,9 +4,9 @@
 features as Phrase* attributes in MISC of their head word.
 """
 
-import udapi.block.mwe.msfphrase
+import udapi.block.msf.msfphrase
 
-class Future(udapi.block.mwe.msfphrase.MsfPhrase):
+class Future(udapi.block.msf.msfphrase.MsfPhrase):
 	
 	def process_node(self, node):
 		# future tense for Serbian and Croatian
diff --git a/udapi/block/msf/slavic/imperative.py b/udapi/block/msf/slavic/imperative.py
index edfed5d9..ef819f08 100644
--- a/udapi/block/msf/slavic/imperative.py
+++ b/udapi/block/msf/slavic/imperative.py
@@ -4,9 +4,9 @@
 features as Phrase* attributes in MISC of their head word.
 """
 
-import udapi.block.mwe.msfphrase
+import udapi.block.msf.msfphrase
 
-class Imperative(udapi.block.mwe.msfphrase.MsfPhrase):
+class Imperative(udapi.block.msf.msfphrase.MsfPhrase):
 	
 	def process_node(self, node):
 		# the condition node.upos == 'VERB' ensures that copulas do not enter this branch
diff --git a/udapi/block/msf/slavic/infinitive.py b/udapi/block/msf/slavic/infinitive.py
index 96aa241b..e0b8f7d5 100644
--- a/udapi/block/msf/slavic/infinitive.py
+++ b/udapi/block/msf/slavic/infinitive.py
@@ -4,9 +4,9 @@
 features as Phrase* attributes in MISC of their head word.
 """
 
-import udapi.block.mwe.msfphrase
+import udapi.block.msf.msfphrase
 
-class Infinitive(udapi.block.mwe.msfphrase.MsfPhrase):
+class Infinitive(udapi.block.msf.msfphrase.MsfPhrase):
 		
 	def process_node(self,node):
 		if node.feats['VerbForm'] == 'Inf' and node.upos == 'VERB':
diff --git a/udapi/block/msf/slavic/past.py b/udapi/block/msf/slavic/past.py
index 3e2b8d7e..00f2836e 100644
--- a/udapi/block/msf/slavic/past.py
+++ b/udapi/block/msf/slavic/past.py
@@ -4,9 +4,9 @@
 features as Phrase* attributes in MISC of their head word.
 """
 
-import udapi.block.mwe.msfphrase
+import udapi.block.msf.msfphrase
 
-class Past(udapi.block.mwe.msfphrase.MsfPhrase):
+class Past(udapi.block.msf.msfphrase.MsfPhrase):
 
 	def get_person_for_langs_with_simple_past(self, node, person):
 		"""
diff --git a/udapi/block/msf/slavic/present.py b/udapi/block/msf/slavic/present.py
index 7b83aede..9de546aa 100644
--- a/udapi/block/msf/slavic/present.py
+++ b/udapi/block/msf/slavic/present.py
@@ -4,9 +4,9 @@
 features as Phrase* attributes in MISC of their head word.
 """
 
-import udapi.block.mwe.msfphrase
+import udapi.block.msf.msfphrase
 
-class Present(udapi.block.mwe.msfphrase.MsfPhrase):
+class Present(udapi.block.msf.msfphrase.MsfPhrase):
 		
 	def process_node(self,node):
 		# the condition VerbForm == 'Fin' ensures that there are no transgressives between the found verbs

From b715ced7ee1f3ee6678dd0b9edfa4088bf4249ff Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Apr 2025 13:50:41 +0200
Subject: [PATCH 1247/1374] Simplified block names.

---
 udapi/block/msf/{msfphrase.py => phrase.py} | 2 +-
 udapi/block/msf/slavic/conditional.py       | 4 ++--
 udapi/block/msf/slavic/converb.py           | 4 ++--
 udapi/block/msf/slavic/future.py            | 4 ++--
 udapi/block/msf/slavic/imperative.py        | 4 ++--
 udapi/block/msf/slavic/infinitive.py        | 4 ++--
 udapi/block/msf/slavic/past.py              | 4 ++--
 udapi/block/msf/slavic/present.py           | 4 ++--
 8 files changed, 15 insertions(+), 15 deletions(-)
 rename udapi/block/msf/{msfphrase.py => phrase.py} (98%)

diff --git a/udapi/block/msf/msfphrase.py b/udapi/block/msf/phrase.py
similarity index 98%
rename from udapi/block/msf/msfphrase.py
rename to udapi/block/msf/phrase.py
index 566663df..6c5c587a 100644
--- a/udapi/block/msf/msfphrase.py
+++ b/udapi/block/msf/phrase.py
@@ -8,7 +8,7 @@
 from udapi.core.block import Block
 import logging
 
-class MsfPhrase(Block):
+class Phrase(Block):
 
     def process_node(self, node):
         """
diff --git a/udapi/block/msf/slavic/conditional.py b/udapi/block/msf/slavic/conditional.py
index b6918111..f5206519 100644
--- a/udapi/block/msf/slavic/conditional.py
+++ b/udapi/block/msf/slavic/conditional.py
@@ -4,9 +4,9 @@
 features as Phrase* attributes in MISC of their head word.
 """
 
-import udapi.block.msf.msfphrase
+import udapi.block.msf.phrase
 
-class Conditional(udapi.block.msf.msfphrase.MsfPhrase):
+class Conditional(udapi.block.msf.phrase.Phrase):
 	
 	def process_node(self, node):
 		if (node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'PartRes') or node.feats['VerbForm'] == 'Fin':
diff --git a/udapi/block/msf/slavic/converb.py b/udapi/block/msf/slavic/converb.py
index e63bbadd..df778d60 100644
--- a/udapi/block/msf/slavic/converb.py
+++ b/udapi/block/msf/slavic/converb.py
@@ -4,9 +4,9 @@
 features as Phrase* attributes in MISC of their head word.
 """
 
-import udapi.block.msf.msfphrase
+import udapi.block.msf.phrase
 
-class Converb(udapi.block.msf.msfphrase.MsfPhrase):
+class Converb(udapi.block.msf.phrase.Phrase):
 	
 	def process_node(self, node):
 		# condition node.upos == 'VERB' to prevent copulas from entering this branch
diff --git a/udapi/block/msf/slavic/future.py b/udapi/block/msf/slavic/future.py
index 5a64f76c..a4392fe2 100644
--- a/udapi/block/msf/slavic/future.py
+++ b/udapi/block/msf/slavic/future.py
@@ -4,9 +4,9 @@
 features as Phrase* attributes in MISC of their head word.
 """
 
-import udapi.block.msf.msfphrase
+import udapi.block.msf.phrase
 
-class Future(udapi.block.msf.msfphrase.MsfPhrase):
+class Future(udapi.block.msf.phrase.Phrase):
 	
 	def process_node(self, node):
 		# future tense for Serbian and Croatian
diff --git a/udapi/block/msf/slavic/imperative.py b/udapi/block/msf/slavic/imperative.py
index ef819f08..137eb851 100644
--- a/udapi/block/msf/slavic/imperative.py
+++ b/udapi/block/msf/slavic/imperative.py
@@ -4,9 +4,9 @@
 features as Phrase* attributes in MISC of their head word.
 """
 
-import udapi.block.msf.msfphrase
+import udapi.block.msf.phrase
 
-class Imperative(udapi.block.msf.msfphrase.MsfPhrase):
+class Imperative(udapi.block.msf.phrase.Phrase):
 	
 	def process_node(self, node):
 		# the condition node.upos == 'VERB' ensures that copulas do not enter this branch
diff --git a/udapi/block/msf/slavic/infinitive.py b/udapi/block/msf/slavic/infinitive.py
index e0b8f7d5..775b21bd 100644
--- a/udapi/block/msf/slavic/infinitive.py
+++ b/udapi/block/msf/slavic/infinitive.py
@@ -4,9 +4,9 @@
 features as Phrase* attributes in MISC of their head word.
 """
 
-import udapi.block.msf.msfphrase
+import udapi.block.msf.phrase
 
-class Infinitive(udapi.block.msf.msfphrase.MsfPhrase):
+class Infinitive(udapi.block.msf.phrase.Phrase):
 		
 	def process_node(self,node):
 		if node.feats['VerbForm'] == 'Inf' and node.upos == 'VERB':
diff --git a/udapi/block/msf/slavic/past.py b/udapi/block/msf/slavic/past.py
index 00f2836e..34dcd354 100644
--- a/udapi/block/msf/slavic/past.py
+++ b/udapi/block/msf/slavic/past.py
@@ -4,9 +4,9 @@
 features as Phrase* attributes in MISC of their head word.
 """
 
-import udapi.block.msf.msfphrase
+import udapi.block.msf.phrase
 
-class Past(udapi.block.msf.msfphrase.MsfPhrase):
+class Past(udapi.block.msf.phrase.Phrase):
 
 	def get_person_for_langs_with_simple_past(self, node, person):
 		"""
diff --git a/udapi/block/msf/slavic/present.py b/udapi/block/msf/slavic/present.py
index 9de546aa..ce6b40c4 100644
--- a/udapi/block/msf/slavic/present.py
+++ b/udapi/block/msf/slavic/present.py
@@ -4,9 +4,9 @@
 features as Phrase* attributes in MISC of their head word.
 """
 
-import udapi.block.msf.msfphrase
+import udapi.block.msf.phrase
 
-class Present(udapi.block.msf.msfphrase.MsfPhrase):
+class Present(udapi.block.msf.phrase.Phrase):
 		
 	def process_node(self,node):
 		# the condition VerbForm == 'Fin' ensures that there are no transgressives between the found verbs

From 572cd4a978c9a3a237c60e184db51993bf8b12c2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 15 Apr 2025 13:56:21 +0200
Subject: [PATCH 1248/1374] Simplified block names.

---
 udapi/block/msf/{msfcase.py => case.py}                     | 2 +-
 udapi/block/msf/{msfcreateabstract.py => createabstract.py} | 2 +-
 udapi/block/msf/{msfinit.py => init.py}                     | 2 +-
 udapi/block/msf/{msfnumphrase.py => numphrase.py}           | 2 +-
 udapi/block/msf/{msfremovefunc.py => removefunc.py}         | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)
 rename udapi/block/msf/{msfcase.py => case.py} (99%)
 rename udapi/block/msf/{msfcreateabstract.py => createabstract.py} (98%)
 rename udapi/block/msf/{msfinit.py => init.py} (99%)
 rename udapi/block/msf/{msfnumphrase.py => numphrase.py} (98%)
 rename udapi/block/msf/{msfremovefunc.py => removefunc.py} (94%)

diff --git a/udapi/block/msf/msfcase.py b/udapi/block/msf/case.py
similarity index 99%
rename from udapi/block/msf/msfcase.py
rename to udapi/block/msf/case.py
index f5516d0b..7d362c7f 100644
--- a/udapi/block/msf/msfcase.py
+++ b/udapi/block/msf/case.py
@@ -5,7 +5,7 @@
 from udapi.core.block import Block
 import logging
 
-class MsfCase(Block):
+class Case(Block):
 
     adposmap = {
         'v+Loc':          'Ine',
diff --git a/udapi/block/msf/msfcreateabstract.py b/udapi/block/msf/createabstract.py
similarity index 98%
rename from udapi/block/msf/msfcreateabstract.py
rename to udapi/block/msf/createabstract.py
index 9a1c774a..fbdf73e5 100644
--- a/udapi/block/msf/msfcreateabstract.py
+++ b/udapi/block/msf/createabstract.py
@@ -7,7 +7,7 @@
 from udapi.core.block import Block
 import re
 
-class MsfCreateAbstract(Block):
+class CreateAbstract(Block):
 
     def process_node(self, node):
         """
diff --git a/udapi/block/msf/msfinit.py b/udapi/block/msf/init.py
similarity index 99%
rename from udapi/block/msf/msfinit.py
rename to udapi/block/msf/init.py
index da83c19a..ceca12af 100644
--- a/udapi/block/msf/msfinit.py
+++ b/udapi/block/msf/init.py
@@ -5,7 +5,7 @@
 from udapi.core.block import Block
 import re
 
-class MsfInit(Block):
+class Init(Block):
 
 
     def process_node(self, node):
diff --git a/udapi/block/msf/msfnumphrase.py b/udapi/block/msf/numphrase.py
similarity index 98%
rename from udapi/block/msf/msfnumphrase.py
rename to udapi/block/msf/numphrase.py
index ebcc0850..22f68c9d 100644
--- a/udapi/block/msf/msfnumphrase.py
+++ b/udapi/block/msf/numphrase.py
@@ -4,7 +4,7 @@
 """
 from udapi.core.block import Block
 
-class MsfNumPhrase(Block):
+class NumPhrase(Block):
 
 
     def process_node(self, node):
diff --git a/udapi/block/msf/msfremovefunc.py b/udapi/block/msf/removefunc.py
similarity index 94%
rename from udapi/block/msf/msfremovefunc.py
rename to udapi/block/msf/removefunc.py
index ce974285..e169a2de 100644
--- a/udapi/block/msf/msfremovefunc.py
+++ b/udapi/block/msf/removefunc.py
@@ -4,7 +4,7 @@
 """
 from udapi.core.block import Block
 
-class MsfRemoveFunc(Block):
+class RemoveFunc(Block):
 
 
     def process_node(self, node):

From 9b9861562c74dc6596dad05029af230204ad48ee Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 22 Apr 2025 10:31:54 +0200
Subject: [PATCH 1249/1374] Updated Slavic preprocessor.

---
 udapi/block/msf/slavic/preprocessor.py | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/udapi/block/msf/slavic/preprocessor.py b/udapi/block/msf/slavic/preprocessor.py
index 833f3de0..5d090a2c 100644
--- a/udapi/block/msf/slavic/preprocessor.py
+++ b/udapi/block/msf/slavic/preprocessor.py
@@ -8,16 +8,16 @@
 from udapi.core.block import Block
 
 class Preprocessor(Block):
-		
+
 	def process_node(self,node):
 
 		# in Ukrainian the active verb forms are not marked as PhraseVoice=Act
 		if (node.upos == 'VERB' or (node.upos == 'AUX' and node.feats['VerbForm'] == 'Fin')) and node.feats['Voice'] == '':
 			node.feats['Voice'] = 'Act'
 				
-		# in Belarusian, some adjectives formed from verbs are marked as verbs
-		# if the verb has case, then it is an adjective
-		if node.upos == 'VERB' and node.feats['Case'] != '':
+		# in some languages, participles are annotated with UPOS=VERB, while in others they are annotated with UPOS=ADJ
+		# we change the UPOS to ADJ when a participle expresses case
+		if node.upos == 'VERB' and node.feats['VerbForm'] == 'Part' and node.feats['Case'] != '':
 			node.upos = 'ADJ'
 			
 		# in Polish, the conditional mood for auxiliary verbs is marked as deprel == 'aux:cnd' and not as in the last Slavic languages ​​feats['Mood'] == 'Cnd'
@@ -27,6 +27,13 @@ def process_node(self,node):
 		# unify polarities - some languages ​​mark only Neg (Russian), some mark both Neg and Pos (Czech)
 		if node.feats['Polarity'] == 'Pos':
 			node.feats['Polarity'] = ''
+
+		# In Ukrainian, there is no explicit annotation of reflexive verbs
+		# We decided to unify the annotation of reflexive verbs with Russian and Belarusian, where reflexive verbs are formed similarly
+		# We add the feature Voice=Mid to reflexive verbs
+		# This feature is added only to Ukrainian data (for example, there are some verbs in Old Church Slavonic that end in 'сь' but are not reflexive)
+		if node.upos == 'VERB' and (node.form.endswith('сь') or node.form.endswith('ся')) and self.lang == 'uk':
+			node.feats['Voice'] = 'Mid'
 		
 		# makedonstina tvori budouci cas pomoci pomocneho slova ќе, u nejz neni nijak vyznaceno, ze se podili na tvorbe budouciho casu
 		# stejne tak bulharstina pomoci pomocneho slova ще
@@ -67,8 +74,3 @@ def process_node(self,node):
 
 		# TODO maybe we want to set Tense=Fut for the perfective verbs with Tense=Pres? This could solve the problem with the simplified detection of the future tense in Czech
 		# but there are many verbs with no Aspect value, so the problem is still there 
-
-
-
-		
-				

From 27dd0171fd59d7a9f6f7aa28d6e22121f014bdb7 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 22 Apr 2025 10:43:37 +0200
Subject: [PATCH 1250/1374] Updated Slavic converb.

---
 udapi/block/msf/slavic/converb.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/msf/slavic/converb.py b/udapi/block/msf/slavic/converb.py
index df778d60..e517a5c8 100644
--- a/udapi/block/msf/slavic/converb.py
+++ b/udapi/block/msf/slavic/converb.py
@@ -7,7 +7,7 @@
 import udapi.block.msf.phrase
 
 class Converb(udapi.block.msf.phrase.Phrase):
-	
+
 	def process_node(self, node):
 		# condition node.upos == 'VERB' to prevent copulas from entering this branch
 		if node.feats['VerbForm'] == 'Conv' and node.upos == 'VERB':
@@ -69,6 +69,7 @@ def process_node(self, node):
 
 				
 				self.write_node_info(node,
+					aspect=copVerb.feats['Aspect'],
 					person=copVerb.feats['Person'],
 					number=copVerb.feats['Number'],
 					tense=copVerb.feats['Tense'],
@@ -79,4 +80,3 @@ def process_node(self, node):
 					ords=phrase_ords,
 					voice=self.get_voice(copVerb, refl)
 					)
-

From 6837d8963d2253d85afe0a2b2c64e394ee7950f6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 22 Apr 2025 10:49:46 +0200
Subject: [PATCH 1251/1374] Updated Slavic future tense.

---
 udapi/block/msf/slavic/future.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/msf/slavic/future.py b/udapi/block/msf/slavic/future.py
index a4392fe2..2d48f86c 100644
--- a/udapi/block/msf/slavic/future.py
+++ b/udapi/block/msf/slavic/future.py
@@ -175,6 +175,7 @@ def process_node(self, node):
 			phrase_ords.sort()
 				
 			self.write_node_info(node,
+					aspect=copVerb.feats['Aspect'],
 					tense='Fut',
 					person=copVerb.feats['Person'],
 					number=copVerb.feats['Number'],

From 8213f541ee675fdbdb46b84e60c8965d99954097 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 22 Apr 2025 10:58:48 +0200
Subject: [PATCH 1252/1374] Updated Slavic imperative.

---
 udapi/block/msf/slavic/imperative.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/msf/slavic/imperative.py b/udapi/block/msf/slavic/imperative.py
index 137eb851..209406e9 100644
--- a/udapi/block/msf/slavic/imperative.py
+++ b/udapi/block/msf/slavic/imperative.py
@@ -7,7 +7,7 @@
 import udapi.block.msf.phrase
 
 class Imperative(udapi.block.msf.phrase.Phrase):
-	
+
 	def process_node(self, node):
 		# the condition node.upos == 'VERB' ensures that copulas do not enter this branch
 		if node.feats['Mood'] == 'Imp' and node.upos == 'VERB':
@@ -65,6 +65,7 @@ def process_node(self, node):
 			phrase_ords.sort()
 				
 			self.write_node_info(node,
+				aspect=copVerb.feats['Aspect'],
 				person=copVerb.feats['Person'],
 				number=copVerb.feats['Number'],
 				mood='Imp',
@@ -74,4 +75,3 @@ def process_node(self, node):
 				polarity=self.get_polarity(node,neg),
 				ords=phrase_ords
 				)
-

From e321d4d53b535d61ce61d41683d02a977c5ca86d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 22 Apr 2025 11:05:48 +0200
Subject: [PATCH 1253/1374] Updated Slavic infinitive.

---
 udapi/block/msf/slavic/infinitive.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/msf/slavic/infinitive.py b/udapi/block/msf/slavic/infinitive.py
index 775b21bd..00c1bcf6 100644
--- a/udapi/block/msf/slavic/infinitive.py
+++ b/udapi/block/msf/slavic/infinitive.py
@@ -7,7 +7,7 @@
 import udapi.block.msf.phrase
 
 class Infinitive(udapi.block.msf.phrase.Phrase):
-		
+
 	def process_node(self,node):
 		if node.feats['VerbForm'] == 'Inf' and node.upos == 'VERB':
 			aux = [x for x in node.children if x.udeprel == 'aux']
@@ -67,6 +67,7 @@ def process_node(self,node):
 			phrase_ords.sort()
 			
 			self.write_node_info(node,
+				aspect=cop[0].feats['Aspect'],
 				voice=self.get_voice(cop[0], refl),
 				form='Inf',
 				polarity=self.get_polarity(cop[0],neg),

From fc180b998456798fade5cb39edd627f898b63514 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 22 Apr 2025 11:14:49 +0200
Subject: [PATCH 1254/1374] Updated Slavic present tense.

---
 udapi/block/msf/slavic/present.py | 37 +++++++++++++++++++++++++------
 1 file changed, 30 insertions(+), 7 deletions(-)

diff --git a/udapi/block/msf/slavic/present.py b/udapi/block/msf/slavic/present.py
index ce6b40c4..e579c122 100644
--- a/udapi/block/msf/slavic/present.py
+++ b/udapi/block/msf/slavic/present.py
@@ -7,11 +7,11 @@
 import udapi.block.msf.phrase
 
 class Present(udapi.block.msf.phrase.Phrase):
-		
+
 	def process_node(self,node):
 		# the condition VerbForm == 'Fin' ensures that there are no transgressives between the found verbs
-		
-		if node.feats['Tense'] == 'Pres' and node.upos == 'VERB' and node.feats['VerbForm'] == 'Fin': #and node.feats['Aspect']=='Imp':
+		# the aspect is not always given in Czech treebanks, so we can't rely on the fact that the imperfect aspect is specified 
+		if node.feats['Tense'] == 'Pres' and node.upos == 'VERB' and node.feats['VerbForm'] == 'Fin': #and node.feats['Aspect']=='Imp': 
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			aux_forb = [x for x in node.children if x.upos == 'AUX' and (x.lemma == 'ќе' or x.lemma == 'ще' or x.feats['Mood'] == 'Cnd')] # forbidden auxiliaries for present tense (these auxiliaries are used for the future tense or the conditional mood)
@@ -33,7 +33,6 @@ def process_node(self,node):
 					ords=phrase_ords
 					)
 				return
-				
 
 		# passive voice
 		if node.upos == 'ADJ' and node.feats['Voice'] == 'Pass':
@@ -61,9 +60,33 @@ def process_node(self,node):
 					animacy=node.feats['Animacy']
 					)
 				return
+			
+		# participles
+		# in some languages, participles are used as attributes (they express case and degree)
+		if node.upos == 'ADJ' and node.feats['VerbForm'] == 'Part':
+			aux_forb = [x for x in node.children if x.udeprel == 'aux']
+			cop = [x for x in node.children if x.udeprel == 'cop']
+			
+			if not aux_forb and not cop:
+				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
+				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+				phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+				phrase_ords.sort()
+
+				self.write_node_info(node,
+					aspect=node.feats['Aspect'],
+					tense=node.feats['Tense'],
+					number=node.feats['Number'],
+					form='Part',
+					voice=self.get_voice(node, refl),
+					reflex=self.get_is_reflex(node, refl),
+					polarity=self.get_polarity(node,neg),
+					ords=phrase_ords
+				)
+				return
 
-		cop = [x for x in node.children if x.udeprel == "cop" and x.feats['Tense'] == "Pres"]
-		aux = [x for x in node.children if x.udeprel == "aux" and x.feats['Mood'] == "Ind" and x.feats['Tense'] == 'Pres']
+		cop = [x for x in node.children if x.udeprel == 'cop' and x.feats['Tense'] == 'Pres']
+		aux = [x for x in node.children if x.udeprel == "aux" and x.feats['Mood'] == 'Ind' and x.feats['Tense'] == 'Pres']
 		aux_forb = [x for x in node.children if x.upos == 'AUX' and x.feats['Tense'] != 'Pres'] # in Serbian this can be a future tense
 		prep = [x for x in node.children if x.upos == 'ADP']
 		neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
@@ -76,10 +99,10 @@ def process_node(self,node):
 			phrase_ords.sort()
 				
 			self.write_node_info(node,
+					aspect=copVerb.feats['Aspect'],
 					tense='Pres',
 					person=copVerb.feats['Person'],
 					number=copVerb.feats['Number'],
-					aspect=node.feats['Aspect'],
 					mood='Ind',
 					form='Fin',
 					voice=self.get_voice(copVerb, refl),

From 3cd92e21e1284272eeeb209423623df6e22b87b7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lenka=20Krippnerov=C3=A1?= <14723289@cuni.cz>
Date: Wed, 23 Apr 2025 22:06:34 +0200
Subject: [PATCH 1255/1374] Update get_is_reflex() to return Yes when Voice=Mid

---
 udapi/block/msf/phrase.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/msf/phrase.py b/udapi/block/msf/phrase.py
index 6c5c587a..c92e5e91 100644
--- a/udapi/block/msf/phrase.py
+++ b/udapi/block/msf/phrase.py
@@ -59,6 +59,8 @@ def get_polarity(self, node, neg):
         return 'Neg'
 		
     def get_is_reflex(self,node,refl):
+        if node.feats['Voice'] == 'Mid':
+            return 'Yes'
         if len(refl) == 0:
             return node.feats['Reflex']
         return 'Yes'

From 6bc39501bd49f05be70c89f888210cbdf8c98ef7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lenka=20Krippnerov=C3=A1?= <14723289@cuni.cz>
Date: Wed, 23 Apr 2025 22:10:41 +0200
Subject: [PATCH 1256/1374] Change PhraseVoice value from Pass to Act for
 impersonal forms in Polish and Ukrainian

---
 udapi/block/msf/slavic/past.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/msf/slavic/past.py b/udapi/block/msf/slavic/past.py
index 34dcd354..d4f3c7cd 100644
--- a/udapi/block/msf/slavic/past.py
+++ b/udapi/block/msf/slavic/past.py
@@ -39,7 +39,7 @@ def process_node(self, node):
 						person=node.feats['Person'],
 						number=node.feats['Number'],
 						mood=node.feats['Mood'],
-						voice='Pass',
+						voice='Act', #In Polish, impersonal statements are annotated with Voice=Act. In Ukrainian, the Voice feature is missing; therefore, we decided to annotate these phrases with PhraseVoice=Act
 						aspect=node.feats['Aspect'],
 						form=node.feats['VerbForm'],
 						polarity=self.get_polarity(node,neg),

From 7841d88415f7f01e7d9cc2f6f3e5aea766dbc97a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lenka=20Krippnerov=C3=A1?= <14723289@cuni.cz>
Date: Wed, 23 Apr 2025 22:12:19 +0200
Subject: [PATCH 1257/1374] Remove Tense from infinitives in Old Church
 Slavonic

---
 udapi/block/msf/slavic/preprocessor.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/udapi/block/msf/slavic/preprocessor.py b/udapi/block/msf/slavic/preprocessor.py
index 5d090a2c..e9a5e90b 100644
--- a/udapi/block/msf/slavic/preprocessor.py
+++ b/udapi/block/msf/slavic/preprocessor.py
@@ -31,8 +31,7 @@ def process_node(self,node):
 		# In Ukrainian, there is no explicit annotation of reflexive verbs
 		# We decided to unify the annotation of reflexive verbs with Russian and Belarusian, where reflexive verbs are formed similarly
 		# We add the feature Voice=Mid to reflexive verbs
-		# This feature is added only to Ukrainian data (for example, there are some verbs in Old Church Slavonic that end in 'сь' but are not reflexive)
-		if node.upos == 'VERB' and (node.form.endswith('сь') or node.form.endswith('ся')) and self.lang == 'uk':
+		if node.upos == 'VERB' and (node.lemma.endswith('сь') or node.lemma.endswith('ся')):
 			node.feats['Voice'] = 'Mid'
 		
 		# makedonstina tvori budouci cas pomoci pomocneho slova ќе, u nejz neni nijak vyznaceno, ze se podili na tvorbe budouciho casu
@@ -72,5 +71,9 @@ def process_node(self,node):
 		if node.feats['Mood'] == 'Sub':
 			node.feats['Mood'] = 'Cnd'
 
+		# # although infinitives in Old Church Slavonic are annotated with Tense=Pres, they do not convey tense; therefore, we remove this annotation
+		if node.feats['VerbForm'] == 'Inf':
+			node.feats['Tense'] = ''
+
 		# TODO maybe we want to set Tense=Fut for the perfective verbs with Tense=Pres? This could solve the problem with the simplified detection of the future tense in Czech
 		# but there are many verbs with no Aspect value, so the problem is still there 

From 7903be388594cdd17938a7f1c5f0ef9162243a26 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 27 Apr 2025 15:49:24 +0200
Subject: [PATCH 1258/1374] Czech "kolem dokola + Gen".

---
 udapi/block/ud/cs/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index b0bf1460..c2ad1813 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -93,6 +93,7 @@ class FixEdeprels(Block):
         'kdykoliv':         'kdykoli',
         'kol':              'kolem:gen',
         'kolem':            'kolem:gen',
+        'kolem_dokola':     'kolem:gen',
         'koncem':           'koncem:gen',
         'konec':            'koncem:gen',
         'krom':             'kromě:gen',

From 105ba96b0431959166dc272731cf13d4967d8636 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 28 Apr 2025 13:00:17 +0200
Subject: [PATCH 1259/1374] Improving conversion of PDT-C 2.0.

---
 udapi/block/ud/cs/fixedeprels.py | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index c2ad1813..e90a4e41 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -38,6 +38,7 @@ class FixEdeprels(Block):
     # case. And include all other prepositions that have unambiguous morphological
     # case, even if they are not secondary.
     unambiguous = {
+        'á':                'na:acc', # "á konto té záležitosti", ovšem "á konto" není ani spojeno jako složená předložka (význam = "na konto")
         'abi':              'aby',
         'aby_na':           'na:loc',
         'ačkoliv':          'ačkoli',
@@ -59,6 +60,7 @@ class FixEdeprels(Block):
         'bez_zřetel_k':     'bez_zřetele_k:dat',
         'bez_zřetel_na':    'bez_zřetele_na:acc',
         'blízko':           'blízko:dat',
+        'blízko_k':         'blízko:dat',
         'blíž':             'blízko:dat',
         'cesta':            'cestou:gen',
         'coby':             'coby', # remove morphological case
@@ -86,6 +88,8 @@ class FixEdeprels(Block):
         'jakoby_pod':       'pod:ins',
         'jakožto':          'jako',
         'jelikož_do':       'jelikož',
+        'jenom':            'jen',
+        'jesli':            'jestli',
         'jestli_že':        'jestliže',
         'k':                'k:dat',
         'k_konec':          'ke_konci:gen',
@@ -98,6 +102,7 @@ class FixEdeprels(Block):
         'konec':            'koncem:gen',
         'krom':             'kromě:gen',
         'kromě':            'kromě:gen',
+        'leda_když':        'ledaže',
         'li_jako':          'li',
         'liž':              'li',
         'mezi_uvnitř':      'uvnitř:gen',
@@ -131,6 +136,7 @@ class FixEdeprels(Block):
         'o_jako':           'jako',
         'o_o':              'o:acc',
         'od':               'od:gen',
+        'od_počínaje':      'počínaje:ins', # od brambor počínaje a základní zeleninou konče
         'ohledně':          'ohledně:gen',
         'okolo':            'okolo:gen',
         'oproti':           'oproti:dat',
@@ -162,6 +168,7 @@ class FixEdeprels(Block):
         'před_během':       'během:gen', # před a během utkání
         'před_po':          'po:loc', # před a po vyloučení Schindlera
         'přes':             'přes:acc',
+        'přes_přes':        'přes:acc', # annotation error
         'přestože':         'přestože', # remove morphological case
         'při':              'při:loc',
         'při_pro':          'při:loc',
@@ -183,6 +190,7 @@ class FixEdeprels(Block):
         'směr_k':           'směrem_k:dat',
         'směr_na':          'směrem_na:acc',
         'směr_od':          'směrem_od:gen',
+        'směr_přes':        'směrem_přes:acc',
         'společně_s':       'společně_s:ins',
         'spolu':            'spolu_s:ins',
         'spolu_s':          'spolu_s:ins',
@@ -233,6 +241,7 @@ class FixEdeprels(Block):
         'v_služba':         've_službách:gen',
         'v_směr':           've_směru:gen',
         'v_směr_k':         've_směru_k:dat',
+        'v_směr_na':        've_směru_k:dat', # same meaning as ve_směru_na:acc
         'v_smysl':          've_smyslu:gen',
         'v_součinnost_s':   'v_součinnosti_s:ins',
         'v_souhlas_s':      'v_souhlasu_s:ins',
@@ -319,6 +328,7 @@ def process_node(self, node):
                 # flagged as solved.
                 edep['deprel'] = re.sub(r'^advcl:do(?::gen)?$', r'obl:do:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
                 edep['deprel'] = re.sub(r'^advcl:pro(?::acc)?$', r'advcl:aby', edep['deprel']) # byl by pro, abychom... ###!!! Opravit i konverzi stromu.
+                edep['deprel'] = re.sub(r'^advcl:s(?::ins)?$', r'advcl', edep['deprel']) ###!!! "seděli jsme tam s Člověče, nezlob se!" Měla by se opravit konverze stromu.
                 edep['deprel'] = re.sub(r'^acl:k(?::dat)?$', r'acl', edep['deprel'])
                 edep['deprel'] = re.sub(r'^advcl:k(?::dat)?$', r'obl:k:dat', edep['deprel']) ###!!! Ale měli bychom opravit i závislost v základním stromu!
                 edep['deprel'] = re.sub(r'^advcl:místo(?::gen)?$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'

From 08aabb73267873257dd1e7bf17326e35d19664c1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 30 Apr 2025 22:56:45 +0200
Subject: [PATCH 1260/1374] Czech fixed expressions.

---
 udapi/block/ud/cs/fixedeprels.py | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index e90a4e41..bd85e1b4 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -62,6 +62,8 @@ class FixEdeprels(Block):
         'blízko':           'blízko:dat',
         'blízko_k':         'blízko:dat',
         'blíž':             'blízko:dat',
+        'blíže':            'blízko:dat',
+        'bok_po_bok_s':     'bok_po_boku_s:ins',
         'cesta':            'cestou:gen',
         'coby':             'coby', # remove morphological case
         'daleko':           'nedaleko:gen',
@@ -70,10 +72,13 @@ class FixEdeprels(Block):
         'díky':             'díky:dat',
         'dle':              'dle:gen',
         'do':               'do:gen',
+        'do_čelo':          'do_čela:gen',
         'do_k':             'k:dat',
         'do_oblast':        'do_oblasti:gen',
         'do_rozpor_s':      'do_rozporu_s:ins',
+        'do_ruka':          'do_rukou:gen',
         'do_soulad_s':      'do_souladu_s:ins',
+        'důsledkem':        'v_důsledku:gen',
         'forma':            'formou:gen',
         'formou':           'formou:gen',
         'hledět_na':        'nehledě_na:acc',
@@ -91,6 +96,7 @@ class FixEdeprels(Block):
         'jenom':            'jen',
         'jesli':            'jestli',
         'jestli_že':        'jestliže',
+        'jménem':           'jménem:gen',
         'k':                'k:dat',
         'k_konec':          'ke_konci:gen',
         'k_prospěch':       'ku_prospěchu:gen',
@@ -102,22 +108,26 @@ class FixEdeprels(Block):
         'konec':            'koncem:gen',
         'krom':             'kromě:gen',
         'kromě':            'kromě:gen',
+        'kvůli':            'kvůli:dat',
         'leda_když':        'ledaže',
         'li_jako':          'li',
         'liž':              'li',
         'mezi_uvnitř':      'uvnitř:gen',
+        'na:ins':           'na:acc',
         'na_báze':          'na_bázi:gen',
         'na_čelo':          'na_čele:gen',
         'na_mimo':          'na:loc', # na kurtě i mimo něj
         'na_než':           'na:acc', # na víc než čtyři a půl kilometru
         'na_od':            'na_rozdíl_od:gen',
         'na_počátek':       'na_počátku:gen',
+        'na_počest':        'na_počest:gen', # appears also with :dat but the meaning is same
         'na_podklad':       'na_podkladě:gen',
         'na_rozdíl_od':     'na_rozdíl_od:gen',
         'na_strana':        'na_straně:gen',
         'na_účet':          'na_účet:gen',
         'na_újma':          'gen', # 'nebude na újmu' is a multi-word predicate but 'na újmu' is probably not used as an independent oblique modifier
         'na_úroveň':        'na_úrovni:gen',
+        'na_úroveň_okolo':  'na_úrovni:gen',
         'na_úsek':          'na_úseku:gen',
         'na_začátek':       'na_začátku:gen',
         'na_základ':        'na_základě:gen',
@@ -150,10 +160,13 @@ class FixEdeprels(Block):
         'počátkem':         'počátkem:gen',
         'počínaje':         'počínaje:ins',
         'počínat':          'počínaje:ins',
+        'počínat_od':       'počínaje:ins',
         'pod_dojem':        'pod_dojmem:gen',
         'pod_tlak':         'pod_tlakem:gen',
         'pod_vliv':         'pod_vlivem:gen',
         'pod_záminka':      'pod_záminkou:gen',
+        'pod_záminka_že':   'pod_záminkou_že',
+        'podél':            'podél:gen',
         'podle':            'podle:gen',
         'pomoc':            'pomocí:gen',
         'pomocí':           'pomocí:gen',
@@ -164,6 +177,7 @@ class FixEdeprels(Block):
         'prostřednictví':   'prostřednictvím:gen',
         'prostřednictvím':  'prostřednictvím:gen',
         'proti':            'proti:dat',
+        'proto_aby':        'aby',
         'protože':          'protože', # remove morphological case
         'před_během':       'během:gen', # před a během utkání
         'před_po':          'po:loc', # před a po vyloučení Schindlera
@@ -174,12 +188,15 @@ class FixEdeprels(Block):
         'při_pro':          'při:loc',
         'při_příležitost':  'při_příležitosti:gen',
         'ruka_v_ruka_s':    'ruku_v_ruce_s:ins',
+        's_cíl':            's_cílem', # s cílem projednat X
         's_ohled_k':        's_ohledem_k:dat',
         's_ohled_na':       's_ohledem_na:acc',
         's_pomoc':          's_pomocí:gen',
+        's_postup':         'postupem:gen',
         's_přihlédnutí_k':  's_přihlédnutím_k:dat',
         's_přihlédnutí_na': 's_přihlédnutím_na:acc',
         's_výjimka':        's_výjimkou:gen',
+        's_výjimka_z':      's_výjimkou:gen',
         's_výjimka_že':     's_výjimkou_že',
         's_vyloučení':      's_vyloučením:gen',
         's_zřetel_k':       'se_zřetelem_k:dat',
@@ -191,10 +208,13 @@ class FixEdeprels(Block):
         'směr_na':          'směrem_na:acc',
         'směr_od':          'směrem_od:gen',
         'směr_přes':        'směrem_přes:acc',
+        'směr_z':           'směrem_z:gen',
         'společně_s':       'společně_s:ins',
         'spolu':            'spolu_s:ins',
         'spolu_s':          'spolu_s:ins',
+        'spolu_se':         'spolu_s:ins',
         'stranou':          'stranou:gen',
+        'stranou_od':       'stranou:gen',
         'takže':            'takže', # remove morphological case
         'takže_a':          'takže',
         'třebaže':          'třebaže', # remove morphological case
@@ -203,6 +223,7 @@ class FixEdeprels(Block):
         'u_příležitost':    'u_příležitosti:gen',
         'uprostřed':        'uprostřed:gen',
         'uvnitř':           'uvnitř:gen',
+        'v:ins':            'v:loc', # ve skutečností (překlep)
         'v_analogie_s':     'v_analogii_s:ins',
         'v_blízkost':       'v_blízkosti:gen',
         'v_čas':            'v_čase:gen',
@@ -248,6 +269,7 @@ class FixEdeprels(Block):
         'v_soulad_s':       'v_souladu_s:ins',
         'v_souvislost_s':   'v_souvislosti_s:ins',
         'v_spojení_s':      've_spojení_s:ins',
+        'v_spojení_se':     've_spojení_s:ins',
         'v_spojený_s':      've_spojení_s:ins',
         'v_spojitost_s':    've_spojitosti_s:ins',
         'v_spolupráce_s':   've_spolupráci_s:ins',
@@ -257,8 +279,10 @@ class FixEdeprels(Block):
         'v_stav':           've_stavu:gen',
         'v_stín':           've_stínu:gen',
         'v_světlo':         've_světle:gen',
+        'v_úroveň':         'v_úrovni:gen',
         'v_věc':            've_věci:gen',
         'v_vztah_k':        've_vztahu_k:dat',
+        'v_vztah_s':        've_vztahu_k:dat',
         'v_zájem':          'v_zájmu:gen',
         'v_záležitost':     'v_záležitosti:gen',
         'v_závěr':          'v_závěru:gen',

From 14e92924fcb69d2e707e416cf1a878e5fe18eb9a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 11 May 2025 20:11:51 +0200
Subject: [PATCH 1261/1374] Fixes #129.

---
 udapi/block/ud/markbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index bf47ed75..959b484e 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -154,7 +154,7 @@ def process_node(self, node):
         #       so there should be no false alarms. Some errors are not reported, i.e. the cases
         #       when advmod incorrectly depends on a function word ("right before midnight").
         if parent.udeprel in ('aux', 'cop', 'mark', 'clf', 'case'):
-            if udeprel not in ('conj', 'cc', 'punct', 'fixed', 'goeswith', 'advmod'):
+            if udeprel not in ('conj', 'cc', 'punct', 'fixed', 'goeswith', 'advmod', 'reparandum'):
                 self.log(node, parent.deprel + '-child',
                          'parent.deprel=%s deprel!=conj|cc|punct|fixed|goeswith' % parent.deprel)
 

From 540fe0467757247e3f3cf71e2d4555c784d4ddd8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 26 May 2025 21:13:12 +0200
Subject: [PATCH 1262/1374] Fix deprel by upos.

---
 udapi/block/ud/fixadvmodbyupos.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index d020b55f..17f0d96e 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -44,6 +44,8 @@ def process_node(self, node):
         elif node.udeprel == 'case':
             if node.upos == 'DET':
                 node.deprel = 'det'
+            elif node.upos == 'PRON':
+                node.deprel = 'nmod'
         elif node.udeprel == 'mark':
             if node.upos in ['PRON', 'DET']:
                 node.deprel = 'nsubj' # it could be also obj, iobj, obl or nmod; just guessing what might be more probable

From 4d9f24c2b616419ebda298be77ef224bd2e8620d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 26 May 2025 22:26:48 +0200
Subject: [PATCH 1263/1374] Fix more errors.

---
 udapi/block/ud/fixadvmodbyupos.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index 17f0d96e..e7aa2fed 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -36,6 +36,8 @@ def process_node(self, node):
                 node.deprel = 'aux'
             elif node.upos == 'ADP':
                 node.deprel = 'case'
+            elif node.upos == 'ADV':
+                node.deprel = 'advmod'
             elif node.upos == 'CCONJ':
                 node.deprel = 'cc'
         elif node.udeprel in ['aux', 'cop']:

From 0abec004793563d0a09977441baa49d197d33539 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 27 May 2025 12:50:04 +0200
Subject: [PATCH 1264/1374] Czech adjectival numerals can have Variant=Short.

---
 udapi/block/ud/cs/markfeatsbugs.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 59f07dbd..cbf57605 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -107,6 +107,7 @@ def process_node(self, node):
                         'Animacy': ['Anim', 'Inan'],
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Variant': ['Short'], # sedmer (Mult Short) duch tvój; pól čtverta (Ord Short) komára
                         'Emph': ['Yes'],
                         'Foreign': ['Yes']})
                 else:
@@ -116,6 +117,7 @@ def process_node(self, node):
                         'Gender': ['Masc', 'Fem', 'Neut'],
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                        'Variant': ['Short'],
                         'Emph': ['Yes'],
                         'Foreign': ['Yes']})
             elif node.feats['VerbForm'] == 'Part': # participles (except l-participles) are a subtype of adjectives
@@ -390,7 +392,7 @@ def process_node(self, node):
                     # there the form changes after preposition and PrepCase must be annotated (muž, jehož se bojím VS. muž, bez něhož se neobejdeme).
                 })
             # Feminine personal possessive determiner.
-            elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)$', node.form.lower()):
+            elif re.match(r'^(její|jeje|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)$', node.form.lower()):
                 # The feminine possessive 'její' slightly inflects, unlike 'jeho' and 'jejich'.
                 # Congruent gender:
                 # - in PDT, only in singular; masculine and neuter are merged even in nominative
@@ -436,7 +438,7 @@ def process_node(self, node):
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
             # Feminine relative possessive determiner.
-            elif re.match(r'^(její|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)(ž(e|to)?)$', node.form.lower()):
+            elif re.match(r'^(její|jeje|jejie|jejího|jejieho|jejímu|jejiemu|jejím|jejiem|jejiej|jejíma|jejiema|jejích|jejiech|jejími|jejiemi)(ž(e|to)?)$', node.form.lower()):
                 # The feminine possessive 'jejíž' slightly inflects, unlike 'jehož' and 'jejichž'.
                 # Congruent gender:
                 # - in PDT, only in singular; masculine and neuter are merged even in nominative

From 7459d350b0418c7097be1bccd98683b35b8d7fba Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 29 May 2025 22:23:20 +0200
Subject: [PATCH 1265/1374] Updated processing of Old Czech data.

---
 udapi/block/ud/cs/addmwt.py        |  2 +-
 udapi/block/ud/cs/markfeatsbugs.py | 15 ++++++++++-----
 udapi/block/ud/fixadvmodbyupos.py  |  4 ++++
 3 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 7f3a4283..c1b3783a 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -126,7 +126,7 @@ def multiword_analysis(self, node):
             # could be masculine or neuter. We pick Gender=Masc and Animacy=Anim
             # by default, unless the original token was annotated as Animacy=Inan
             # or Gender=Neut.
-            m = re.match(r"^(na|o|pro|přěde|ski?rz[eě]|za)[nň](ž?)$", node.form.lower())
+            m = re.match(r"^(na|nade|o|pro|přěde|ski?rz[eě]|za)[nň](ž?)$", node.form.lower())
             if m:
                 node.misc['AddMwt'] = ''
                 # Remove vocalization from 'přěde' (přěd něj) but keep it in 'skrze'
diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index cbf57605..6c3672ac 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -37,7 +37,8 @@ def process_node(self, node):
                     'Gender': ['Neut'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'Foreign': ['Yes']
+                    'Foreign': ['Yes'],
+                    'Abbr': ['Yes']
                 })
             elif node.feats['Gender'] == 'Masc':
                 self.check_required_features(node, ['Animacy'])
@@ -46,13 +47,15 @@ def process_node(self, node):
                     'Animacy': ['Anim', 'Inan'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'Foreign': ['Yes']})
+                    'Foreign': ['Yes'],
+                    'Abbr': ['Yes']})
             else:
                 self.check_allowed_features(node, {
                     'Gender': ['Masc', 'Fem', 'Neut'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'Foreign': ['Yes']})
+                    'Foreign': ['Yes'],
+                    'Abbr': ['Yes']})
         # PROPER NOUNS #########################################################
         elif node.upos == 'PROPN':
             self.check_required_features(node, ['Gender', 'Number', 'Case'])
@@ -64,14 +67,16 @@ def process_node(self, node):
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                     'NameType': ['Giv', 'Sur', 'Geo', 'Nat'],
-                    'Foreign': ['Yes']})
+                    'Foreign': ['Yes'],
+                    'Abbr': ['Yes']})
             else:
                 self.check_allowed_features(node, {
                     'Gender': ['Masc', 'Fem', 'Neut'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                     'NameType': ['Giv', 'Sur', 'Geo', 'Nat'],
-                    'Foreign': ['Yes']})
+                    'Foreign': ['Yes'],
+                    'Abbr': ['Yes']})
         # ADJECTIVES ###########################################################
         elif node.upos == 'ADJ':
             if node.feats['Poss'] == 'Yes': # possessive adjectives
diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index e7aa2fed..916910b5 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -51,6 +51,8 @@ def process_node(self, node):
         elif node.udeprel == 'mark':
             if node.upos in ['PRON', 'DET']:
                 node.deprel = 'nsubj' # it could be also obj, iobj, obl or nmod; just guessing what might be more probable
+            elif node.upos == 'NOUN':
+                node.deprel = 'obl'
             elif node.upos == 'INTJ':
                 node.deprel = 'discourse'
         elif node.udeprel == 'cc':
@@ -71,6 +73,8 @@ def process_node(self, node):
                 node.deprel = 'aux'
             elif node.upos == 'VERB':
                 node.deprel = 'dep'
+            elif node.upos == 'SCONJ':
+                node.deprel = 'mark'
             elif node.upos == 'X':
                 node.deprel = 'dep'
         elif node.udeprel == 'nummod':

From ac391d50696c392c5be1d3c2268627f765bcbd2e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lenka=20Krippnerov=C3=A1?= <14723289@cuni.cz>
Date: Tue, 10 Jun 2025 22:26:46 +0200
Subject: [PATCH 1266/1374] Improve handling of negation detection in Slavic
 blocks

---
 udapi/block/msf/phrase.py              | 73 +++++++++++++++++++---
 udapi/block/msf/slavic/conditional.py  | 25 +++++---
 udapi/block/msf/slavic/converb.py      | 33 ++++++----
 udapi/block/msf/slavic/future.py       | 84 +++++++++++++++-----------
 udapi/block/msf/slavic/imperative.py   | 31 ++++++----
 udapi/block/msf/slavic/infinitive.py   | 50 +++++++++------
 udapi/block/msf/slavic/past.py         | 66 ++++++++++++--------
 udapi/block/msf/slavic/preprocessor.py |  6 +-
 udapi/block/msf/slavic/present.py      | 60 +++++++++++-------
 9 files changed, 285 insertions(+), 143 deletions(-)

diff --git a/udapi/block/msf/phrase.py b/udapi/block/msf/phrase.py
index c92e5e91..e39fc131 100644
--- a/udapi/block/msf/phrase.py
+++ b/udapi/block/msf/phrase.py
@@ -30,6 +30,31 @@ def process_node(self, node):
 		'animacy':'PhraseAnimacy',
 		'ords':'Phrase'
 		}
+    
+    # a dictionary where the key is the lemma of a negative particle and the value is a list of the lemmas of their possible children that have a 'fixed' relation
+    # we do not want to include these negative particles in the phrase; these are expressions like "never", etc.
+    negation_fixed = {
+        # Belarusian
+        'ні' : ['раз'],
+        'ня' : ['толькі'],
+
+        # Upper Sorbian
+        'nic' : ['naposledku'],
+
+        # Polish
+        'nie' : ['mało'],
+
+        # Pomak
+        'néma' : ['kak'],
+
+        # Slovenian
+        'ne' : ['le'],
+
+        # Russian and Old East Slavic
+        'не' : ['то', 'токмо'],
+        'ни' : ['в', 'раз', 'шатко'],
+        'нет' : ['нет']
+    }
 
     def write_node_info(self, node,
 			tense = None,
@@ -51,12 +76,46 @@ def write_node_info(self, node,
             if val != None: 
                 node.misc[self.dictionary[key]] = val
 
-    def get_polarity(self, node, neg):
-        if node.feats['Polarity'] != "":
-            return node.feats['Polarity']
-        if len(neg) == 0:
-            return None
-        return 'Neg'
+    def has_fixed_children(self, node):
+        """
+        Returns True if the node has any children with the 'fixed' relation and the node's lemma along with the child's lemma are listed in self.negation_fixed.
+        """
+        fixed_children = [x for x in node.children if x.udeprel == 'fixed']
+
+        if fixed_children:
+            if fixed_children[0].lemma in self.negation_fixed.get(node.lemma, []):
+                return True
+        return False
+
+    def get_polarity(self, nodes):
+        """
+        Returns 'Neg' if there is exactly one node with Polarity='Neg' among the given nodes.
+        Returns an empty string if there are zero or more than one such nodes.
+        """
+        neg_count = 0
+        for node in nodes:
+            if node.feats['Polarity'] == 'Neg':
+                neg_count += 1
+
+        if neg_count == 1:
+            return 'Neg'
+        
+        # neg_count can be zero or two, in either case we want to return an empty string so that the PhrasePolarity attribute is not generated
+        else:
+            return ''
+               
+    def get_negative_particles(self, nodes):
+        """
+        Returns a list of all negative particles found among the children 
+        of the specified nodes, except for negative particles with fixed children specified in self.negation_fixed.
+        """
+        neg_particles = []
+        for node in nodes:
+            neg = [x for x in node.children if x.upos == 'PART' and x.feats['Polarity'] == 'Neg' and x.udeprel == 'advmod' and not self.has_fixed_children(x)]
+            if neg:
+                neg_particles += neg
+        return neg_particles
+            
 		
     def get_is_reflex(self,node,refl):
         if node.feats['Voice'] == 'Mid':
@@ -75,4 +134,4 @@ def get_voice(self,node,refl):
         if self.is_expl_pass(refl):
             return 'Pass'
         return voice
-		
+
diff --git a/udapi/block/msf/slavic/conditional.py b/udapi/block/msf/slavic/conditional.py
index f5206519..89eafd6c 100644
--- a/udapi/block/msf/slavic/conditional.py
+++ b/udapi/block/msf/slavic/conditional.py
@@ -19,12 +19,16 @@ def process_node(self, node):
 			# the conditional mood can be formed using the auxiliary verb or some conjunctions (such as 'aby, kdyby...' in Czech)
 			# so x.udeprel == 'aux' can't be required because it doesn't meet the conjunctions
 			
-			if len(aux_cnd) > 0 and len(cop) == 0:
+			if aux_cnd and not cop:
 				aux = [x for x in node.children if x.udeprel == 'aux' or x.feats['Mood'] == 'Cnd'] # all auxiliary verbs and conjuctions with feats['Mood'] == 'Cnd'
 				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+
+				phrase_nodes = [node] + aux + refl
 				
-				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in refl] + [x.ord for x in neg]
+				neg = self.get_negative_particles(phrase_nodes)
+				phrase_nodes += neg
+
+				phrase_ords = [x.ord for x in phrase_nodes]
 				phrase_ords.sort()
 			
 				auxVerb = aux_cnd[0]
@@ -41,7 +45,7 @@ def process_node(self, node):
 					form='Fin',
 					aspect=node.feats['Aspect'],
 					reflex=self.get_is_reflex(node,refl),
-					polarity=self.get_polarity(node,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					voice=self.get_voice(node, refl),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
@@ -53,15 +57,18 @@ def process_node(self, node):
 		cop = [x for x in node.children if x.udeprel == 'cop' and (x.feats['VerbForm'] == 'Part' or x.feats['VerbForm'] == 'Fin')]
 		aux_cnd = [x for x in node.children if x.feats['Mood'] == 'Cnd' or x.deprel=='aux:cnd']
 			
-		if len(cop) > 0 and len(aux_cnd) > 0:
+		if cop and aux_cnd:
 			# there can be a copula with Mood='Cnd' (i. e. in Old East Slavonic), we don't want to count these copula in phrase_ords twice, so there is x.udeprel != 'cop' in aux list
 			aux = [x for x in node.children if (x.udeprel == 'aux' or x.feats['Mood'] == 'Cnd') and x.udeprel != 'cop']
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			prep = [x for x in node.children if x.upos == 'ADP']
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 
+			phrase_nodes = [node] + aux + prep + refl + cop
+			neg = self.get_negative_particles(phrase_nodes)
+			phrase_nodes += neg
+
 			copVerb = cop[0]
-			phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in cop] + [x.ord for x in neg] + [x.ord for x in prep] + [x.ord for x in refl]
+			phrase_ords = [x.ord for x in phrase_nodes]
 			phrase_ords.sort()
 			self.write_node_info(node,
 					aspect=copVerb.feats['Aspect'],
@@ -70,9 +77,9 @@ def process_node(self, node):
 					mood='Cnd',
 					form='Fin',
 					voice=self.get_voice(copVerb, refl),
-					polarity=self.get_polarity(copVerb,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					reflex=self.get_is_reflex(node, refl),
 					ords=phrase_ords,
 					gender=copVerb.feats['Gender'],
 					animacy=copVerb.feats['Animacy']
-			)
+			)
\ No newline at end of file
diff --git a/udapi/block/msf/slavic/converb.py b/udapi/block/msf/slavic/converb.py
index e517a5c8..6b725d56 100644
--- a/udapi/block/msf/slavic/converb.py
+++ b/udapi/block/msf/slavic/converb.py
@@ -12,9 +12,12 @@ def process_node(self, node):
 		# condition node.upos == 'VERB' to prevent copulas from entering this branch
 		if node.feats['VerbForm'] == 'Conv' and node.upos == 'VERB':
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
-			
-			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+
+			phrase_nodes = [node] + refl
+			neg = self.get_negative_particles(phrase_nodes)
+			phrase_nodes += neg
+
+			phrase_ords = [x.ord for x in phrase_nodes]
 			phrase_ords.sort()
 			
 			self.write_node_info(node,
@@ -23,7 +26,7 @@ def process_node(self, node):
 				form='Conv',
 				tense=node.feats['Tense'],
 				aspect=node.feats['Aspect'],
-				polarity=self.get_polarity(node,neg),
+				polarity=self.get_polarity(phrase_nodes),
 				reflex=self.get_is_reflex(node,refl),
 				ords=phrase_ords,
 				gender=node.feats['Gender'],
@@ -35,10 +38,13 @@ def process_node(self, node):
 		elif node.upos == 'ADJ':
 			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['VerbForm'] == 'Conv']
 			
-			if len(aux) > 0:
-				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			if aux:
 				auxVerb = aux[0]
-				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in neg]
+
+				phrase_nodes = [node] + aux
+				neg = self.get_negative_particles(phrase_nodes)
+				phrase_nodes += neg
+				phrase_ords = [x.ord for x in phrase_nodes]
 				phrase_ords.sort()
 			
 				self.write_node_info(node,
@@ -47,7 +53,7 @@ def process_node(self, node):
 					form='Conv',
 					tense=auxVerb.feats['Tense'],
 					aspect=node.feats['Aspect'],
-					polarity=self.get_polarity(auxVerb,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords,
 					gender=auxVerb.feats['Gender'],
 					animacy=auxVerb.feats['Animacy'],
@@ -58,13 +64,16 @@ def process_node(self, node):
 		else:
 			cop = [x for x in node.children if x.udeprel == 'cop' and x.feats['VerbForm'] == 'Conv']
 			
-			if len(cop) > 0:
+			if cop:
 				prep = [x for x in node.children if x.upos == 'ADP']
-				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			
 				copVerb = cop[0]
-				phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
+
+				phrase_nodes = [node] + cop + prep + refl
+				neg = self.get_negative_particles(phrase_nodes)
+				phrase_nodes += neg
+				phrase_ords = [x.ord for x in phrase_nodes]
 				phrase_ords.sort()
 
 				
@@ -76,7 +85,7 @@ def process_node(self, node):
 					gender=copVerb.feats['Gender'],
 					animacy=copVerb.feats['Animacy'],
 					form='Conv',
-					polarity=self.get_polarity(node,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords,
 					voice=self.get_voice(copVerb, refl)
 					)
diff --git a/udapi/block/msf/slavic/future.py b/udapi/block/msf/slavic/future.py
index 2d48f86c..02452c36 100644
--- a/udapi/block/msf/slavic/future.py
+++ b/udapi/block/msf/slavic/future.py
@@ -11,29 +11,29 @@ class Future(udapi.block.msf.phrase.Phrase):
 	def process_node(self, node):
 		# future tense for Serbian and Croatian
 		aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Pres' and (x.lemma == 'hteti' or x.lemma == 'htjeti')]
-		if node.upos != 'AUX' and len(aux) != 0:
+		if node.upos != 'AUX' and aux:
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			aux_other = [x for x in node.children if x.udeprel == 'aux'] # adding aux for passive voice
 			cop = [x for x in node.children if x.deprel == 'cop']
-			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg] + [x.ord for x in aux_other] + [x.ord for x in cop]
+
+			phrase_nodes = [node] + refl + aux_other + cop
+			neg = self.get_negative_particles(phrase_nodes)
+			phrase_nodes += neg
+
+			phrase_ords = [x.ord for x in phrase_nodes]
 			phrase_ords.sort()
 			
-			# u infinitivu neni vyznacen slovesny rod
-			# PhraseVoice ale chceme nastavit na activum, jelikoz se jedna o pomocne sloveso + infinitiv
-			voice=node.feats['Voice']
-			#if voice == '':
-			#	voice = 'Act'
-			if len(cop) == 0:
+			
+			if not cop:
 				self.write_node_info(node, 
 					tense='Fut',
 					person=aux[0].feats['Person'],
 					number=aux[0].feats['Number'],
 					mood='Ind',
-					voice=voice,
+					voice=node.feats['Voice'],
 					aspect=node.feats['Aspect'], # srbstina ani chorvatstina vidy nema
 					form='Fin',
-					polarity=self.get_polarity(node,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					reflex=self.get_is_reflex(node,refl),
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
@@ -41,6 +41,7 @@ def process_node(self, node):
 					)
 			else:
 				prep = [x for x in node.children if x.upos == 'ADP']
+				phrase_nodes += prep
 				phrase_ords += [x.ord for x in prep]
 				phrase_ords.sort()
 
@@ -49,10 +50,10 @@ def process_node(self, node):
 					person=aux[0].feats['Person'],
 					number=aux[0].feats['Number'],
 					mood='Ind',
-					voice=voice,
+					voice=node.feats['Voice'],
 					aspect=node.feats['Aspect'], 
 					form='Fin',
-					polarity=self.get_polarity(node,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					reflex=self.get_is_reflex(node,refl),
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
@@ -65,10 +66,14 @@ def process_node(self, node):
 		# Bulgarian forms the future tense with the auxiliary word ще and a verb in the present tense
 		aux = [x for x in node.children if x.lemma == 'ќе' or x.lemma == 'ще']
 		
-		if node.feats['Tense'] == 'Pres' and len(aux) > 0:
+		if node.feats['Tense'] == 'Pres' and aux:
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
-			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg] + [x.ord for x in aux]
+
+			phrase_nodes = [node] + refl + aux
+			neg = self.get_negative_particles(phrase_nodes)
+			phrase_nodes += neg
+
+			phrase_ords = [x.ord for x in phrase_nodes]
 			phrase_ords.sort()
 			
 			self.write_node_info(node, 
@@ -79,7 +84,7 @@ def process_node(self, node):
 				voice=node.feats['Voice'],
 				aspect=node.feats['Aspect'],
 				form='Fin',
-				polarity=self.get_polarity(node,neg),
+				polarity=self.get_polarity(phrase_nodes),
 				reflex=self.get_is_reflex(node,refl),
 				ords=phrase_ords
 				)
@@ -91,9 +96,11 @@ def process_node(self, node):
 		"""if node.feats['Aspect'] == 'Perf' and (node.feats['Tense'] == 'Pres' or node.feats['Tense'] == 'Fut') and node.feats['VerbForm'] != 'Conv':
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			phrase_nodes = [node] + refl
+			neg = self.get_negative_particles(phrase_nodes)
+			phrase_nodes += neg
 			
-			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+			phrase_ords = [x.ord for x in phrase_nodes]
 			phrase_ords.sort()
 			
 			self.write_node_info(node, 
@@ -104,7 +111,7 @@ def process_node(self, node):
 				voice=self.get_voice(node,refl),
 				form='Fin',
 				aspect='Perf',
-				polarity=self.get_polarity(node,neg),
+				polarity=self.get_polarity(phrase_nodes),
 				reflex=self.get_is_reflex(node,refl),
 				ords=phrase_ords
 				)
@@ -119,11 +126,16 @@ def process_node(self, node):
 			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Fut']
 			
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
-			if len(aux) > 0:
+			
+			phrase_nodes = [node] + aux + refl
+			neg = self.get_negative_particles(phrase_nodes)
+			phrase_nodes += neg
+
+			phrase_ords = [x.ord for x in phrase_nodes]
+			phrase_ords.sort()
+
+			if aux:
 				auxVerb = aux[0]
-				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in refl] + [x.ord for x in neg]
-				phrase_ords.sort()
 				self.write_node_info(node,
 					tense='Fut',
 					person=auxVerb.feats['Person'],
@@ -132,7 +144,7 @@ def process_node(self, node):
 					voice=self.get_voice(node,refl),
 					aspect=node.feats['Aspect'],
 					form='Fin',
-					polarity=self.get_polarity(auxVerb,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					reflex=self.get_is_reflex(node,refl),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
@@ -143,20 +155,17 @@ def process_node(self, node):
 			# simple future tense - e.g. in Serbian, the future tense can be formed by combining a verb with a full meaning and an auxiliary verb into one word, i.e. without an auxiliary verb
 			# or verbs like pojede, půjdeme... in Czech
 			
-			if len(aux) == 0 and node.feats['Tense'] == 'Fut':
-				
-				phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
-				phrase_ords.sort()
-				
+			if not aux and node.feats['Tense'] == 'Fut':
+						
 				self.write_node_info(node,
 					tense='Fut',
 					person=node.feats['Person'],
 					number=node.feats['Number'],
 					mood='Ind',
-					voice=self.get_voice(node,refl), # passivum se muze objevit (napr. pojede se), ale jmenny rod neni vyjadren
+					voice=self.get_voice(node,refl),
 					aspect=node.feats['Aspect'],
 					form='Fin',
-					polarity=self.get_polarity(node,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					reflex=self.get_is_reflex(node,refl),
 					ords=phrase_ords
 					)
@@ -164,14 +173,17 @@ def process_node(self, node):
 				
 				
 		cop = [x for x in node.children if x.udeprel == 'cop' and x.feats['Tense'] == 'Fut']
-		if len(cop) > 0:
+		if cop:
 			copVerb = cop[0]
 			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Mood']=='Ind']
 			prep = [x for x in node.children if x.upos == 'ADP']
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 
-			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in aux] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
+			phrase_nodes = [node] + cop + aux + prep + refl
+			neg = self.get_negative_particles(phrase_nodes)
+			phrase_nodes += neg
+
+			phrase_ords = [x.ord for x in phrase_nodes]
 			phrase_ords.sort()
 				
 			self.write_node_info(node,
@@ -182,7 +194,7 @@ def process_node(self, node):
 					mood='Ind',
 					form='Fin',
 					voice=self.get_voice(copVerb, refl),
-					polarity=self.get_polarity(copVerb,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords
 				)
 
diff --git a/udapi/block/msf/slavic/imperative.py b/udapi/block/msf/slavic/imperative.py
index 209406e9..d4fedd50 100644
--- a/udapi/block/msf/slavic/imperative.py
+++ b/udapi/block/msf/slavic/imperative.py
@@ -12,9 +12,12 @@ def process_node(self, node):
 		# the condition node.upos == 'VERB' ensures that copulas do not enter this branch
 		if node.feats['Mood'] == 'Imp' and node.upos == 'VERB':
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			
-			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+			phrase_nodes = [node] + refl
+			neg = self.get_negative_particles(phrase_nodes)
+			phrase_nodes += neg
+			
+			phrase_ords = [x.ord for x in phrase_nodes]
 			phrase_ords.sort()
 			
 			self.write_node_info(node,
@@ -24,7 +27,7 @@ def process_node(self, node):
 				mood='Imp',
 				form='Fin',
 				voice='Act',
-				polarity=self.get_polarity(node,neg),
+				polarity=self.get_polarity(phrase_nodes),
 				reflex=self.get_is_reflex(node,refl),
 				ords=phrase_ords
 				)
@@ -33,10 +36,12 @@ def process_node(self, node):
 		# verbs in the passive forms are marked as ADJ
 		if node.upos == 'ADJ' and node.feats['Voice'] == 'Pass':
 			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Mood'] == 'Imp']
-			if len(aux) > 0:
-				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			if aux:
+				phrase_nodes = [node] + aux
+				neg = self.get_negative_particles(phrase_nodes)
+				phrase_nodes += neg
 				
-				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in neg]
+				phrase_ords = [x.ord for x in phrase_nodes]
 				phrase_ords.sort()
 				
 				self.write_node_info(node,
@@ -46,7 +51,7 @@ def process_node(self, node):
 					voice='Pass',
 					aspect=node.feats['Aspect'],
 					form='Fin',
-					polarity=self.get_polarity(node,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy']
@@ -55,13 +60,17 @@ def process_node(self, node):
 
 
 		cop = [x for x in node.children if x.udeprel == 'cop' and x.feats['Mood'] == 'Imp']
-		if len(cop) > 0:
+		if cop:
 			prep = [x for x in node.children if x.upos == 'ADP']
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 
 			copVerb = cop[0]
-			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
+
+			phrase_nodes = [node] + cop + prep + refl
+			neg = self.get_negative_particles(phrase_nodes)
+			phrase_nodes += neg
+
+			phrase_ords = [x.ord for x in phrase_nodes]
 			phrase_ords.sort()
 				
 			self.write_node_info(node,
@@ -72,6 +81,6 @@ def process_node(self, node):
 				form='Fin',
 				voice=self.get_voice(copVerb, refl),
 				reflex=self.get_is_reflex(node, refl),
-				polarity=self.get_polarity(node,neg),
+				polarity=self.get_polarity(phrase_nodes),
 				ords=phrase_ords
 				)
diff --git a/udapi/block/msf/slavic/infinitive.py b/udapi/block/msf/slavic/infinitive.py
index 00c1bcf6..f39a2646 100644
--- a/udapi/block/msf/slavic/infinitive.py
+++ b/udapi/block/msf/slavic/infinitive.py
@@ -11,22 +11,22 @@ class Infinitive(udapi.block.msf.phrase.Phrase):
 	def process_node(self,node):
 		if node.feats['VerbForm'] == 'Inf' and node.upos == 'VERB':
 			aux = [x for x in node.children if x.udeprel == 'aux']
-			if len(aux) == 0: # the list of auxiliary list must be empty - we don't want to mark infinitives which are part of any other phrase (for example the infinititive is part of the future tense in Czech)
+			if not aux: # the list of auxiliary list must be empty - we don't want to mark infinitives which are part of any other phrase (for example the infinititive is part of the future tense in Czech)
 				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 				
-				phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
-				phrase_ords.sort()
+				phrase_nodes = [node] + refl
+				neg = self.get_negative_particles(phrase_nodes)
+				phrase_nodes == neg
 				
-				voice='Act'
-				if self.is_expl_pass(refl):
-					voice='Pass'
+				phrase_ords = [x.ord for x in phrase_nodes]
+				phrase_ords.sort()
 				
+		
 				self.write_node_info(node,
 					aspect=node.feats['Aspect'],
-					voice=voice,
+					voice=self.get_voice(node,refl),
 					form='Inf',
-					polarity=self.get_polarity(node,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					reflex=self.get_is_reflex(node,refl),
 					ords=phrase_ords
 				)
@@ -35,18 +35,21 @@ def process_node(self,node):
 		if node.upos == 'ADJ' and node.feats['Voice'] == 'Pass':
 			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['VerbForm'] == 'Inf']
 			aux_forb = [x for x in node.children if x.udeprel == 'aux' and x.feats['VerbForm'] != 'Inf']
-			if len(aux) > 0 and len(aux_forb) == 0:
-				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			if aux and not aux_forb:
 				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 
-				phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in neg] + [x.ord for x in refl]
+				phrase_nodes = [node] + aux + refl
+				neg = self.get_negative_particles(phrase_nodes)
+				phrase_nodes += neg
+
+				phrase_ords = [x.ord for x in phrase_nodes]
 				phrase_ords.sort()
 				
 				self.write_node_info(node,
 					aspect=node.feats['Aspect'],
 					voice='Pass',
 					form='Inf',
-					polarity=self.get_polarity(aux[0],neg),
+					polarity=self.get_polarity(phrase_nodes),
 					reflex=self.get_is_reflex(node, refl),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
@@ -59,18 +62,22 @@ def process_node(self,node):
 
 		cop = [x for x in node.children if x.udeprel == 'cop' and x.feats['VerbForm'] == 'Inf']
 		aux_forb = [x for x in node.children if x.udeprel == 'aux']
-		if len(cop) > 0 and len(aux_forb) == 0:
+		if cop and not aux_forb:
 			prep = [x for x in node.children if x.upos == 'ADP']
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
+
+			phrase_nodes = [node] + cop + prep + refl
+			neg = self.get_negative_particles(phrase_nodes)
+			phrase_nodes += neg
+
+			phrase_ords = [x.ord for x in phrase_nodes]
 			phrase_ords.sort()
 			
 			self.write_node_info(node,
 				aspect=cop[0].feats['Aspect'],
 				voice=self.get_voice(cop[0], refl),
 				form='Inf',
-				polarity=self.get_polarity(cop[0],neg),
+				polarity=self.get_polarity(phrase_nodes),
 				reflex=self.get_is_reflex(node, refl),
 				ords=phrase_ords
 				)
@@ -78,16 +85,19 @@ def process_node(self,node):
 		# there is a rare verb form called supine in Slovenian, it is used instead of infinitive as the argument of motion verbs
 		if node.feats['VerbForm'] == 'Sup':
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			
+			phrase_nodes = [node] + refl
+			neg = self.get_negative_particles(phrase_nodes)
+			phrase_nodes += neg
 
-			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+			phrase_ords = [x.ord for x in phrase_nodes]
 			phrase_ords.sort()
 
 			self.write_node_info(node,
 					aspect=node.feats['Aspect'],
 					voice='Act',
 					form='Sup',
-					polarity=self.get_polarity(node,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					reflex=self.get_is_reflex(node, refl),
 					ords=phrase_ords
 					)
diff --git a/udapi/block/msf/slavic/past.py b/udapi/block/msf/slavic/past.py
index d4f3c7cd..423bff45 100644
--- a/udapi/block/msf/slavic/past.py
+++ b/udapi/block/msf/slavic/past.py
@@ -29,9 +29,12 @@ def process_node(self, node):
 		# in Polish, verbs with Person=0 have also Tense=Past, in Ukrainian the tense is not specified
 		if node.feats['Person'] == '0':
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			
+			phrase_nodes = [node] + refl
+			neg = self.get_negative_particles(phrase_nodes)
+			phrase_nodes += neg
 
-			phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+			phrase_ords = [x.ord for x in phrase_nodes]
 			phrase_ords.sort()
 
 			self.write_node_info(node,
@@ -42,7 +45,7 @@ def process_node(self, node):
 						voice='Act', #In Polish, impersonal statements are annotated with Voice=Act. In Ukrainian, the Voice feature is missing; therefore, we decided to annotate these phrases with PhraseVoice=Act
 						aspect=node.feats['Aspect'],
 						form=node.feats['VerbForm'],
-						polarity=self.get_polarity(node,neg),
+						polarity=self.get_polarity(phrase_nodes),
 						reflex=self.get_is_reflex(node,refl),
 						ords=phrase_ords,
 						gender=node.feats['Gender'],
@@ -54,20 +57,23 @@ def process_node(self, node):
 			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Pres']
 			aux_pqp = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] in past_tenses]
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+
+			phrase_nodes = [node] + aux + refl + aux_pqp
+			neg = self.get_negative_particles(phrase_nodes)
+			phrase_nodes += neg
 			
-			phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in refl] + [x.ord for x in neg] + [x.ord for x in aux_pqp]
+			phrase_ords = [x.ord for x in phrase_nodes]
 			phrase_ords.sort()
 			
 			aux_cnd = [x for x in node.children if (x.feats['Mood'] == 'Cnd' or x.deprel == 'aux:cnd') and x.udeprel != 'conj'] # we don't want to mark l-participles in the conditional as past tense
-			if len(aux_cnd) == 0:
-				if len(aux) > 0:
+			if not aux_cnd:
+				if aux:
 					person = aux[0].feats['Person']
 
-				elif len(aux) == 0:
+				elif not aux:
 					person = '3'
 
-				if len(aux_pqp) > 0:
+				if aux_pqp:
 					person = aux_pqp[0].feats['Person']
 				
 				# in Slovenian, the participles are not annotated as Tense='Past', the Tense feature is missing here
@@ -86,7 +92,7 @@ def process_node(self, node):
 						voice=self.get_voice(node,refl),
 						aspect=node.feats['Aspect'],
 						form='Fin',
-						polarity=self.get_polarity(node,neg),
+						polarity=self.get_polarity(phrase_nodes),
 						reflex=self.get_is_reflex(node,refl),
 						ords=phrase_ords,
 						gender=node.feats['Gender'],
@@ -100,13 +106,16 @@ def process_node(self, node):
 
 			# the past tense is formed only by a content verb, not with an auxiliary
 			aux_forb = [x for x in node.children if x.udeprel == 'aux']
+			
+			if not aux_forb:
 
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 
-			if not aux_forb:
+				phrase_nodes = [node] + refl
+				neg = self.get_negative_particles(phrase_nodes)
+				phrase_nodes += neg
 			
-				phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+				phrase_ords = [x.ord for x in phrase_nodes]
 				phrase_ords.sort()
 
 				self.write_node_info(node,
@@ -117,7 +126,7 @@ def process_node(self, node):
 					voice=self.get_voice(node,refl),
 					aspect=node.feats['Aspect'],
 					form=node.feats['VerbForm'],
-					polarity=self.get_polarity(node,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					reflex=self.get_is_reflex(node,refl),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
@@ -127,14 +136,18 @@ def process_node(self, node):
 				
 			
 		# passive
-		elif node.upos == 'ADJ' and node.feats['Voice'] == 'Pass' and len(cop) == 0:	
+		elif node.upos == 'ADJ' and node.feats['Voice'] == 'Pass' and not cop:	
 			aux_past_tense = [x for x in node.children if x.udeprel == 'aux' and (x.feats['Tense'] in past_tenses)]
 			aux_cnd = [x for x in node.children if x.feats['Mood'] == 'Cnd' or x.deprel == 'aux:cnd'] # we don't want to mark l-participles in the conditional as past tense
-			if len(aux_cnd) == 0:
-				if len(aux_past_tense) > 0:
+			if not aux_cnd:
+				if aux_past_tense:
 					aux_pres_tense = [x for x in  node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Pres'] # e. g. the auxiliary 'jsem' in the phrase 'byl jsem přinucen'
-					neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
-					phrase_ords = [node.ord] + [x.ord for x in aux_past_tense] + [x.ord for x in aux_pres_tense] + [x.ord for x in neg]
+					
+					phrase_nodes = [node] + aux_past_tense + aux_pres_tense
+					neg = self.get_negative_particles(phrase_nodes)
+					phrase_nodes += neg
+
+					phrase_ords = [x.ord for x in phrase_nodes]
 					phrase_ords.sort()
 					
 					person = '3'
@@ -150,7 +163,7 @@ def process_node(self, node):
 						voice='Pass',
 						form='Fin',
 						aspect=node.feats['Aspect'],
-						polarity=self.get_polarity(aux_past_tense[0],neg),
+						polarity=self.get_polarity(phrase_nodes),
 						ords=phrase_ords,
 						gender=node.feats['Gender'],
 						animacy=node.feats['Animacy']
@@ -158,13 +171,16 @@ def process_node(self, node):
 				
 		else:
 			aux_cnd = [x for x in node.children if x.feats['Mood'] == 'Cnd' or x.deprel == 'aux:cnd'] # we don't want to mark l-participles in the conditional as past tense
-			if len(cop) > 0 and len(aux_cnd) == 0:
+			if cop and not aux_cnd:
 				aux_past_tense = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Pres']
 				prep = [x for x in node.children if x.upos == 'ADP']
-				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
 				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 
-				phrase_ords = [node.ord] + [x.ord for x in aux_past_tense] + [x.ord for x in cop] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
+				phrase_nodes = [node] + aux_past_tense + cop + prep + refl
+				neg = self.get_negative_particles(phrase_nodes)
+				phrase_nodes += neg
+
+				phrase_ords = [x.ord for x in phrase_nodes]
 				phrase_ords.sort()
 
 				person = '3'
@@ -184,7 +200,7 @@ def process_node(self, node):
 					voice=self.get_voice(cop[0], refl),
 					form='Fin',
 					reflex=self.get_is_reflex(node,refl),
-					polarity=self.get_polarity(cop[0],neg),
+					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords,
 					gender=cop[0].feats['Gender'],
 					animacy=cop[0].feats['Animacy']
diff --git a/udapi/block/msf/slavic/preprocessor.py b/udapi/block/msf/slavic/preprocessor.py
index e9a5e90b..804a081f 100644
--- a/udapi/block/msf/slavic/preprocessor.py
+++ b/udapi/block/msf/slavic/preprocessor.py
@@ -71,9 +71,13 @@ def process_node(self,node):
 		if node.feats['Mood'] == 'Sub':
 			node.feats['Mood'] = 'Cnd'
 
-		# # although infinitives in Old Church Slavonic are annotated with Tense=Pres, they do not convey tense; therefore, we remove this annotation
+		# although infinitives in Old Church Slavonic are annotated with Tense=Pres, they do not convey tense; therefore, we remove this annotation
 		if node.feats['VerbForm'] == 'Inf':
 			node.feats['Tense'] = ''
 
+		# in the russian Syntagrus corpus, the negative particles have no Polarity=Neg feature
+		if node.lemma == 'не' and node.upos == 'PART' and node.udeprel == 'advmod':
+			node.feats['Polarity'] = 'Neg'
+
 		# TODO maybe we want to set Tense=Fut for the perfective verbs with Tense=Pres? This could solve the problem with the simplified detection of the future tense in Czech
 		# but there are many verbs with no Aspect value, so the problem is still there 
diff --git a/udapi/block/msf/slavic/present.py b/udapi/block/msf/slavic/present.py
index e579c122..9a743a9e 100644
--- a/udapi/block/msf/slavic/present.py
+++ b/udapi/block/msf/slavic/present.py
@@ -12,12 +12,17 @@ def process_node(self,node):
 		# the condition VerbForm == 'Fin' ensures that there are no transgressives between the found verbs
 		# the aspect is not always given in Czech treebanks, so we can't rely on the fact that the imperfect aspect is specified 
 		if node.feats['Tense'] == 'Pres' and node.upos == 'VERB' and node.feats['VerbForm'] == 'Fin': #and node.feats['Aspect']=='Imp': 
-			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
+			
 			aux_forb = [x for x in node.children if x.upos == 'AUX' and (x.lemma == 'ќе' or x.lemma == 'ще' or x.feats['Mood'] == 'Cnd')] # forbidden auxiliaries for present tense (these auxiliaries are used for the future tense or the conditional mood)
 
-			if len(aux_forb) == 0:
-				phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+			if not aux_forb:
+				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
+
+				phrase_nodes = [node] + refl
+				neg = self.get_negative_particles(phrase_nodes)
+				phrase_nodes += neg
+
+				phrase_ords = [x.ord for x in phrase_nodes]
 				phrase_ords.sort()
 				
 				self.write_node_info(node,
@@ -28,7 +33,7 @@ def process_node(self,node):
 					aspect=node.feats['Aspect'],
 					voice=self.get_voice(node,refl),
 					form='Fin',
-					polarity=self.get_polarity(node,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					reflex=self.get_is_reflex(node,refl),
 					ords=phrase_ords
 					)
@@ -38,12 +43,15 @@ def process_node(self,node):
 		if node.upos == 'ADJ' and node.feats['Voice'] == 'Pass':
 			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Pres' and x.lemma != 'hteti' and x.lemma != 'htjeti']
 			aux_forb = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] != 'Pres'] # we don't want the past passive (e. g. 'byl jsem poučen' in Czech)
-			neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
-			
-			phrase_ords = [node.ord] + [x.ord for x in aux] + [x.ord for x in neg]
-			phrase_ords.sort()
 			
-			if len(aux) > 0 and len(aux_forb) == 0:
+			if aux and not aux_forb:
+				phrase_nodes = [node] + aux
+				neg = self.get_negative_particles(phrase_nodes)
+				phrase_nodes += neg
+
+				phrase_ords = [x.ord for x in phrase_nodes]
+				phrase_ords.sort()
+
 				auxVerb = aux[0]
 
 				self.write_node_info(node,
@@ -54,7 +62,7 @@ def process_node(self,node):
 					aspect=node.feats['Aspect'],
 					form='Fin',
 					voice='Pass',
-					polarity=self.get_polarity(auxVerb,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy']
@@ -69,8 +77,12 @@ def process_node(self,node):
 			
 			if not aux_forb and not cop:
 				refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-				neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
-				phrase_ords = [node.ord] + [x.ord for x in refl] + [x.ord for x in neg]
+
+				phrase_nodes = [node] + refl
+				neg = self.get_negative_particles(phrase_nodes)
+				phrase_nodes += neg
+
+				phrase_ords = [x.ord for x in phrase_nodes]
 				phrase_ords.sort()
 
 				self.write_node_info(node,
@@ -80,22 +92,26 @@ def process_node(self,node):
 					form='Part',
 					voice=self.get_voice(node, refl),
 					reflex=self.get_is_reflex(node, refl),
-					polarity=self.get_polarity(node,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords
 				)
 				return
 
 		cop = [x for x in node.children if x.udeprel == 'cop' and x.feats['Tense'] == 'Pres']
-		aux = [x for x in node.children if x.udeprel == "aux" and x.feats['Mood'] == 'Ind' and x.feats['Tense'] == 'Pres']
 		aux_forb = [x for x in node.children if x.upos == 'AUX' and x.feats['Tense'] != 'Pres'] # in Serbian this can be a future tense
-		prep = [x for x in node.children if x.upos == 'ADP']
-		neg = [x for x in node.children if x.feats['Polarity'] == 'Neg' and x.upos == 'PART']
-		refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
-			
-		if len(cop) > 0 and len(aux_forb) == 0:
+					
+		if cop and not aux_forb:
+			aux = [x for x in node.children if x.udeprel == "aux" and x.feats['Mood'] == 'Ind' and x.feats['Tense'] == 'Pres']
+			prep = [x for x in node.children if x.upos == 'ADP']
+			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
+
+			phrase_nodes = [node] + cop + aux + prep + refl
+			neg = self.get_negative_particles(phrase_nodes)
+			phrase_nodes += neg
+
 			copVerb = cop[0]
 				
-			phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in aux] + [x.ord for x in prep] + [x.ord for x in neg] + [x.ord for x in refl]
+			phrase_ords = [x.ord for x in phrase_nodes]
 			phrase_ords.sort()
 				
 			self.write_node_info(node,
@@ -107,6 +123,6 @@ def process_node(self,node):
 					form='Fin',
 					voice=self.get_voice(copVerb, refl),
 					reflex=self.get_is_reflex(node, refl),
-					polarity=self.get_polarity(copVerb,neg),
+					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords
 				)

From 690281b03466d988d355fbc489e1171f77bfb6e5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 20 Jun 2025 13:00:30 +0200
Subject: [PATCH 1267/1374] Minor addition to the tutorial.

---
 tutorial/udapi-tutorial-dz.odt | Bin 258101 -> 258529 bytes
 tutorial/udapi-tutorial-dz.pdf | Bin 381708 -> 380779 bytes
 2 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/tutorial/udapi-tutorial-dz.odt b/tutorial/udapi-tutorial-dz.odt
index 945483c2ba23ed6879fd9565d67a9fd5fcbff3f2..a954e9f3441b094b7fcd37ea1d91b89be93eb12b 100644
GIT binary patch
delta 36334
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%0AhR4H7jHHv+>yqXc)u
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
F{{a~(YySWM

delta 35914
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

diff --git a/tutorial/udapi-tutorial-dz.pdf b/tutorial/udapi-tutorial-dz.pdf
index f220f7c2c5de4ba8682dba33267aadaf086c0b19..913121876c1ad91c7d6405b32b2a1d76b51e0edf 100644
GIT binary patch
delta 88799
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
XkyEGhynRFmkR|SG*6ghQ-F^QLrXo$_

delta 90379
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


From 5122149a994f316451a73468dde6547d6b3740c3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lenka=20Krippnerov=C3=A1?= <14723289@cuni.cz>
Date: Thu, 26 Jun 2025 20:26:12 +0200
Subject: [PATCH 1268/1374] Add attribute PhraseExpl.

---
 udapi/block/msf/phrase.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/udapi/block/msf/phrase.py b/udapi/block/msf/phrase.py
index e39fc131..90ea5d2d 100644
--- a/udapi/block/msf/phrase.py
+++ b/udapi/block/msf/phrase.py
@@ -28,7 +28,8 @@ def process_node(self, node):
 		'polarity': 'PhrasePolarity',
 		'gender':'PhraseGender',
 		'animacy':'PhraseAnimacy',
-		'ords':'Phrase'
+		'ords':'Phrase',
+        'expl':'PhraseExpl',
 		}
     
     # a dictionary where the key is the lemma of a negative particle and the value is a list of the lemmas of their possible children that have a 'fixed' relation
@@ -68,7 +69,8 @@ def write_node_info(self, node,
 			ords = None,
 			gender = None,
 			animacy = None,
-			aspect = None):
+			aspect = None,
+            expl=None):
         arguments = locals()
         del arguments['self'] # delete self and node from arguments,
         del arguments['node'] # we want only grammatical categories 

From 7259c8767ec453df9fa45ce8a45243f9bba470ce Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Thu, 26 Jun 2025 22:32:38 +0200
Subject: [PATCH 1269/1374] Add block for Romance languages (currently only
 Portuguese)

---
 udapi/block/msf/romance/romance.py | 523 +++++++++++++++++++++++++++++
 1 file changed, 523 insertions(+)
 create mode 100644 udapi/block/msf/romance/romance.py

diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
new file mode 100644
index 00000000..dd2393f7
--- /dev/null
+++ b/udapi/block/msf/romance/romance.py
@@ -0,0 +1,523 @@
+
+import udapi.block.msf.phrase
+from enum import Enum
+
+class Aspect(str, Enum):
+    IMP = 'Imp'
+    IMPPROG = 'ImpProg'
+    PERF = 'Perf'
+    PERFPROG = 'PerfProg'
+    PROG = 'Prog'
+    PQP = 'Pqp'
+
+class Tense(str, Enum):
+    FUT = 'Fut'
+    FUTFUT = 'FutFut'
+    PAST = 'Past'
+    PASTFUT = 'PastFut'
+    PASTPRES = 'PastPres'
+    PRES = 'Pres'
+
+class Romance(udapi.block.msf.phrase.Phrase):
+
+    def process_node(self, node):
+
+        cop = [x for x in node.children if x.udeprel == 'cop']
+        
+        # only expl or expl:pv, no expl:impers or expl:pass
+        refl = [x for x in node.children if x.lemma == 'se' and x.upos == 'PRON' and x.udeprel == 'expl' and x.udeprel != 'expl:impers' and x.udeprel != 'expl:pass']
+        
+        if refl:
+            expl='Pv'
+        else:
+            expl=None
+   
+        if cop:
+            auxes = [x for x in node.children if x.udeprel == 'aux']
+            if auxes:
+                self.process_periphrastic_verb_forms(cop[0], auxes, refl, auxes + cop, node)
+            else:
+                # no auxiliaries, only cop
+                self.process_copulas(node,cop,auxes,refl,expl)
+            return
+
+        if node.upos == 'VERB':
+            auxes = [x for x in node.children if x.udeprel == 'aux']
+            aux_pass = [x for x in node.children if x.deprel == 'aux:pass']
+            auxes_without_pass = [x for x in node.children if x.udeprel == 'aux' and x.deprel != 'aux:pass']
+
+            # infinitive with a subject is a subjunctive
+            subj = [x for x in node.children if x.udeprel == 'subj']
+            if node.feats['VerbForm'] == 'Inf' and subj:
+                self.write_node_info(node,
+                        person=node.feats['Person'],
+                        number=node.feats['Number'],
+                        mood='Sub',
+                        form='Fin',
+                        tense=Tense.FUT.value,
+                        gender=node.feats['Gender'],
+                        voice=node.feats['Voice'],
+                        expl=expl,
+                        ords=[node.ord]
+                    )
+                return
+            
+            if not auxes:
+                    phrase_ords = [node.ord] + [r.ord for r in refl]
+                    phrase_ords.sort()
+
+                    # presente -> PhraseTense=Pres, PhraseAspect=''
+                    # Futuro do presente -> PhraseTense=Fut, PhraseAspect=''
+                    aspect = ''
+                    tense = node.feats['Tense']
+
+                    if node.feats['Mood'] == 'Ind':
+
+                        # pretérito imperfeito -> PhraseTense=Past, PhraseAspect=Imp
+                        if node.feats['Tense'] == 'Imp':
+                            tense=Tense.PAST.value
+                            aspect=Aspect.IMP.value
+
+                        # pretérito perfeito -> PhraseTense=Past, PhraseAspect=Perf
+                        if node.feats['Tense'] == 'Past':
+                            aspect=Aspect.PERF.value
+
+                        # pretérito mais que perfeito simples -> PhraseTense=Past, PhraseAspect=Pqp
+                        if node.feats['Tense'] == 'Pqp':
+                            tense=Tense.PAST.value
+                            aspect=Aspect.PQP.value
+                            
+                    # subjunctive presente -> PhraseTense=Pres, PhraseAspect=''
+                    # subjunctive futuro -> PhraseTense=Fut, PhraseAspect=''
+                    if node.feats['Mood'] == 'Sub':
+
+                        if node.feats['Tense'] == 'Past':
+                            aspect=Aspect.IMP.value
+
+                        # subjunctive pretérito imperfeito -> PhraseTense=Past, PhraseAspect=Imp
+                        if node.feats['Tense']  == 'Imp':
+                            tense=Tense.PAST.value
+                            aspect=Aspect.IMP.value
+
+                    # Futuro do pretérito (cnd) -> PhraseTense=Pres, PhraseAspect='', PhraseMood=Cnd
+                    if node.feats['Mood'] == 'Cnd':
+                        aspect=''
+                        tense=Tense.PRES.value
+
+                    
+                    self.write_node_info(node,
+                        person=node.feats['Person'],
+                        aspect=aspect,
+                        number=node.feats['Number'],
+                        mood=node.feats['Mood'],
+                        form=node.feats['VerbForm'],
+                        tense=tense,
+                        gender=node.feats['Gender'],
+                        voice=node.feats['Voice'],
+                        expl=expl,
+                        ords=phrase_ords
+                    )
+
+
+            else:
+                # no passive auxiliaries
+                if not aux_pass:
+                    self.process_periphrastic_verb_forms(node, auxes, refl, auxes, node)
+
+                # head verb has one passive auxiliary and no more other auxiliaries
+                # TODO complete the tenses and aspects for individual verb forms
+                elif not auxes_without_pass:
+                    phrase_ords = [node.ord] + [x.ord for x in auxes] + [r.ord for r in refl]
+                    phrase_ords.sort()
+
+                    self.write_node_info(node,
+                        person=aux_pass[0].feats['Person'],
+                        number=aux_pass[0].feats['Number'],
+                        mood=aux_pass[0].feats['Mood'],
+                        form='Fin',
+                        tense=aux_pass[0].feats['Tense'],
+                        gender=node.feats['Gender'],
+                        voice='Pass',
+                        expl=expl,
+                        ords=phrase_ords
+                    )
+
+                # head verb has passive auxiliary and also other auxiliaries
+                else:
+                    self.process_periphrastic_verb_forms(aux_pass[0], auxes_without_pass, refl, auxes, node)
+
+
+    def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_node):
+        """
+        Parameters
+        - node: if there is no passive then the node is the head verb, if the head verb is in the passive, then the node is the passive auxiliary
+        - auxes: list of all auxiliaries except the passive auxes
+        - refl: list of reflexives which should be included into the periphrastic phrase
+        - all_auxes: list of all auxiliaries (passive auxes are included)
+        - head_node: the node which should have the Phrase* attributes, i. e. the head of the phrase
+
+        annotates periphrastic verb forms with the Phrase* attributes
+        """
+
+        if refl:
+            expl='Pv'
+        else:
+            expl=None
+
+        if len(auxes)  == 1:
+            # Cnd
+            if ((auxes[0].lemma == 'ter' and node.feats['VerbForm'] == 'Part') or (auxes[0].lemma == 'estar' and node.feats['VerbForm'] == 'Ger')) and auxes[0].feats['Mood'] == 'Cnd':
+                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                # aux estar cond + gerund -> PhraseTense=Pres, PhraseAspect=Prog, PhraseMood=Cnd
+                if auxes[0].lemma == 'estar':
+                    tense=Tense.PRES.value
+                    aspect=Aspect.PROG.value
+
+                # Futuro do pretérito composto -> PhraseTense=Past, PhraseAspect=Perf, PhraseMood=Cnd
+                else:
+                    tense=Tense.PAST.value
+                    aspect=Aspect.PERF.value
+
+                self.write_node_info(head_node,
+                    tense=tense,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    aspect=aspect,
+                    mood='Cnd',
+                    form='Fin',
+                    expl=expl,
+                    voice=head_node.feats['Voice'],
+                    ords=phrase_ords)
+                return
+                
+            # Auxiliary 'estar' followed by a gerund 
+            if auxes[0].lemma == 'estar' and node.feats['VerbForm'] == 'Ger':
+                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                # pretérito imperfeito (aux estar) -> PhraseTense=Past, PhraseAspect=ImpProg
+                # subjunctive pretérito imperfeito (aux estar) -> PhraseTense=Past, PhraseAspect=ImpProg, PhraseMood=Sub
+                if auxes[0].feats['Tense'] == 'Imp':
+                    tense=Tense.PAST.value
+                    aspect=Aspect.IMPPROG.value
+
+                # pretérito perfeito (aux estar) -> PhraseTense=Past, PhraseAspect=PerfProg
+                elif auxes[0].feats['Tense'] == 'Past':
+                    tense=Tense.PAST.value
+                    aspect=Aspect.PERFPROG.value
+
+                # conditional (aux estar) -> PhraseTense=Pres, PhraseAspect=Prog, PhraseMood=Cnd
+                elif auxes[0].feats['Mood'] == 'Cnd':
+                    tense=Tense.PRES.value
+                    aspect=Aspect.PROG.value
+
+                # presente (aux estar) -> PhraseTense=Pres, PhraseAspect=Prog
+                # futuro do presente (aux estar) -> PhraseTense=Fut, PhraseAspect=Prog
+                # subjunctive presente (aux estar) -> PhraseTense=Pres, PhraseAspect=Prog, PhraseMood=Sub
+                # subjunctive futuro (aux estar) -> PhraseTense=Fut, PhraseAspect=Prog, PhraseMood=Sub
+                else:
+                    tense=auxes[0].feats['Tense']
+                    aspect=Aspect.PROG.value
+
+                self.write_node_info(head_node,
+                    tense=tense,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood=auxes[0].feats['Mood'],
+                    form='Fin',
+                    voice=head_node.feats['Voice'],
+                    aspect=aspect,
+                    expl=expl,
+                    ords=phrase_ords)
+
+            # Auxiliary 'ter' followed by a participle
+            if auxes[0].lemma == 'ter' and node.feats['VerbForm'] == 'Part':
+                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                # futuro do presente composto (aux ter) -> PhraseTense=Fut, PhraseAspect=Perf
+                aspect=Aspect.PERF.value
+                tense=auxes[0].feats['Tense']
+
+                # pretérito perfeito composto (aux ter) -> PhraseTense=PastPres, PhraseAspect=Perf
+                # subjonctive pretérito perfeito composto (aux ter) -> PhraseTense=PastPres, PhraseAspect=Perf, PhraseMood=Sub
+                if auxes[0].feats['Tense'] == 'Pres':
+                    tense=Tense.PASTPRES.value
+
+                # pretérito mais que perfeito composto (aux ter/haver) -> PhraseTense=Past, PhraseAspect=Pqp
+                # subjonctive pretérito mais-que-perfeito composto (aux ter) -> PhraseTense=Past, PhraseAspect=Pqp, PhraseMood=Sub
+                elif auxes[0].feats['Tense'] in ['Imp', 'Past']: # TODO prej neni v Past, jenom Imp
+                    tense=Tense.PAST.value
+                    aspect=Aspect.PQP.value
+
+                self.write_node_info(head_node,
+                    tense=tense,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood=auxes[0].feats['Mood'],
+                    aspect=aspect,
+                    form='Fin',
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    ords=phrase_ords)
+                
+            if auxes[0].lemma == 'haver' and auxes[0].feats['Tense'] == 'Imp' and node.feats['VerbForm'] == 'Part':
+                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                self.write_node_info(head_node,
+                    tense=Tense.PAST.value,
+                    aspect=Aspect.PERF.value,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood=auxes[0].feats['Mood'],
+                    form='Fin',
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    ords=phrase_ords)
+                
+            if auxes[0].lemma == 'vir' and auxes[0].feats['Tense'] in ['Pres', 'Imp', 'Past'] and node.feats['VerbForm'] == 'Ger':
+                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                # aux Pres (vir) + gerund -> PhraseTense=PastPres, PraseAspect=Prog
+                if auxes[0].feats['Tense'] == 'Pres':
+                    tense=Tense.PASTPRES.value
+
+
+                elif auxes[0].feats['Tense'] in ['Imp', 'Past']: 
+                    tense=Tense.PAST.value
+
+                self.write_node_info(head_node,
+                    tense=tense,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood=auxes[0].feats['Mood'],
+                    form='Fin',
+                    aspect=Aspect.PROG.value,
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    ords=phrase_ords)
+
+            
+            # auxiliary 'ir' followed by infinitive
+            if auxes[0].lemma == 'ir' and node.feats['VerbForm'] == 'Inf':
+                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                tense=node.feats['Tense']
+                aspect=''
+
+                # Futuro perifrástico -> PhraseTense=Fut, PhraseAspect=''
+                if auxes[0].feats['Tense'] == 'Pres': 
+                    tense=Tense.FUT.value
+                    aspect=''
+
+                # Futuro perifrástico passado imp -> PhraseTense=PastFut, PhraseAspect=Imp
+                elif auxes[0].feats['Tense'] == 'Imp':
+                    tense=Tense.PASTFUT.value
+                    aspect=Aspect.IMP.value
+
+                # Futuro perifrástico in the future -> PhraseTense=FutFut, PhraseAspect=''
+                elif auxes[0].feats['Tense'] == 'Fut':
+                    tense=Tense.FUTFUT.value
+                    aspect=''
+
+                # Futuro perifrástico passado perf -> PhraseTense=PastFut, PhraseAspect=Perf
+                elif auxes[0].feats['Tense'] == 'Past':
+                    tense=Tense.PASTFUT.value
+                    aspect=Aspect.PERF.value
+
+                
+
+                self.write_node_info(head_node,
+                    tense=tense,
+                    aspect=aspect,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood=auxes[0].feats['Mood'],
+                    form='Fin',
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    ords=phrase_ords)
+                
+            if auxes[0].lemma == 'ir' and node.feats['VerbForm'] == 'Ger':
+                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                # aux Pres (ir) + gerund -> PhraseTense=Pres, PhraseAspect=Prog
+                tense = auxes[0].feats['Tense']
+                aspect = Aspect.PROG.value
+
+                # aux Imp (ir) + gerund -> PhraseTense=Past, PhraseAspect=Prog
+                if auxes[0].feats['Tense'] == 'Imp':
+                    tense=Tense.PAST.value
+                    aspect=Aspect.PROG.value
+
+                self.write_node_info(head_node,
+                    tense=tense,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood=auxes[0].feats['Mood'],
+                    aspect=aspect,
+                    form='Fin',
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    ords=phrase_ords)
+                
+        elif len(auxes) == 2:
+            # auxiliry 'ir' followed by auxiliary 'estar' in infinitive and a gerund
+            if auxes[0].lemma == 'ir' and auxes[1].lemma == 'estar' and node.feats['VerbForm'] == 'Ger':
+                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                # Futuro perifrástico -> PhraseTense=Fut, PhraseAspect=Prog
+                if auxes[0].feats['Tense'] == 'Pres':
+                    tense=Tense.FUT.value
+                    aspect=Aspect.PROG.value
+
+                # Futuro perifrástico passado imp -> PhraseTense=PastFut, PhraseAspect=ImpProg
+                if auxes[0].feats['Tense'] == 'Imp':
+                    tense=Tense.PASTFUT.value
+                    aspect=Aspect.IMPPROG.value
+
+                # Futuro perifrástico in the future -> PhraseTense=FutFut, PhraseAspect=Prog
+                if auxes[0].feats['Tense'] == 'Fut':
+                    tense=Tense.FUTFUT.value
+                    aspect=Aspect.PROG.value
+
+                if auxes[0].feats['Tense'] == 'Past':
+                    tense=Tense.PASTFUT.value
+                    aspect=Aspect.PERFPROG.value
+
+                self.write_node_info(head_node,
+                    tense=tense,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood=auxes[0].feats['Mood'],
+                    form='Fin',
+                    aspect=aspect,
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    ords=phrase_ords)
+
+            # auxiliriy 'ir' in present or future tense followed by auxiliary 'ter' in infinitive and a participle
+            if auxes[0].lemma == 'ir' and (auxes[0].feats['Tense'] in ['Pres', 'Fut']) and auxes[1].lemma == 'ter' and node.feats['VerbForm'] == 'Part':
+                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                # Futuro perifrástico -> PhraseTense=FutFut, PhraseAspect=Perf
+                if auxes[0].feats['Tense'] == 'Fut':
+                    tense=Tense.FUTFUT.value
+                    aspect=Aspect.PERF.value
+
+                # aux Pres (ir) + aux ter inf + pp -> PhraseTense=Fut, PhraseAspect=Perf
+                if auxes[0].feats['Tense'] == 'Pres':
+                    tense=Tense.FUT.value
+                    aspect=Aspect.PERF.value
+
+                self.write_node_info(head_node,
+                    tense=tense,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood=auxes[0].feats['Mood'],
+                    aspect=aspect,
+                    form='Fin',
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    ords=phrase_ords)    
+                
+            
+                
+            # Cnd (only ter), Sub and Past,Pres,Fut tenses: 2 auxes - ter + estar
+            if auxes[0].lemma in ['ter', 'haver'] and auxes[1].lemma == 'estar' and node.feats['VerbForm'] == 'Ger':
+                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                tense = auxes[0].feats['Tense']
+                aspect = Aspect.PERFPROG.value
+
+                # aux ter cond + estar pp + gerund -> PhraseTense=Past, PhraseAspect=Prog, PhraseMood=Cnd
+                if auxes[0].feats['Mood'] == 'Cnd':
+                    tense=Tense.PAST.value
+                    aspect=Aspect.PROG.value
+
+                # Pretérito perfeito composto -> PhraseTense=PastPres, PhraseAspect=PerfProg
+                # subjonctive Pretérito perfeito composto -> PhraseTense=PastPres, PhraseAspect=PerfProg, PhraseMood=Sub
+                elif auxes[0].feats['Tense'] == 'Pres':
+                    tense=Tense.PASTPRES.value
+
+                # Pretérito mais que perfeito composto -> PhraseTense=Past, PhraseAspect=ImpProg
+                # subjonctive Pretérito mais que perfeito composto -> PhraseTense=Past, PhraseAspect=ImpProg, PhraseMood=Sub
+                elif auxes[0].feats['Tense'] in ['Imp', 'Past']:
+                    tense=Tense.PAST.value
+                    aspect=Aspect.IMPPROG.value
+
+                # Futuro do presente composto -> PhraseTense=Fut, PhraseAspect=PerfProg
+                elif auxes[0].feats['Tense'] == 'Fut' and auxes[0].lemma == 'ter':
+                    tense=Tense.FUT.value
+
+                self.write_node_info(head_node,
+                    tense=tense,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood=auxes[0].feats['Mood'],
+                    form='Fin',
+                    aspect=aspect,
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    ords=phrase_ords,
+                )
+                return
+                
+    def process_copulas(self, node, cop, auxes, refl, expl):
+        
+        if not auxes:
+            tense = cop[0].feats['Tense']
+            number=cop[0].feats['Number']
+            person=cop[0].feats['Person']
+            mood=cop[0].feats['Mood']
+
+            if cop[0].feats['Tense'] in ['Pres', 'Fut']:
+                if cop[0].lemma == 'ser':
+                    aspect=Aspect.PERF.value
+                elif cop[0].lemma == 'estar':
+                    aspect=Aspect.IMP.value
+            
+            elif cop[0].feats['Tense'] == 'Imp':
+                tense=Tense.PAST.value
+                aspect=Aspect.IMP.value
+            
+            elif cop[0].feats['Tense'] == 'Past':
+                aspect=Aspect.PERF.value
+            else:
+                # i.e. copulas in infinitive
+                aspect=''
+
+        else: 
+            tense = auxes[0].feats['Tense']
+            number=auxes[0].feats['Number']
+            person=auxes[0].feats['Person']
+            mood=auxes[0].feats['Mood']
+            aspect=''
+
+            
+            if auxes[0].lemma == 'estar': 
+                aspect=Aspect.IMPPROG.value
+
+        phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in auxes] + [r.ord for r in refl]
+        phrase_ords.sort()
+      
+        self.write_node_info(node,
+                    tense=tense,
+                    number=number,
+                    person=person,
+                    mood=mood,
+                    form='Fin',
+                    aspect=aspect,
+                    voice=node.feats['Voice'],
+                    expl=expl,
+                    ords=phrase_ords,
+                )

From 3f80400830fa4479ecdf4bdb427797f28bf11720 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 1 Jul 2025 15:42:38 +0200
Subject: [PATCH 1270/1374] Fix verbal "fixed" expressions in Romanian.

---
 udapi/block/ud/ro/fixfixed.py | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 udapi/block/ud/ro/fixfixed.py

diff --git a/udapi/block/ud/ro/fixfixed.py b/udapi/block/ud/ro/fixfixed.py
new file mode 100644
index 00000000..b8309ad9
--- /dev/null
+++ b/udapi/block/ud/ro/fixfixed.py
@@ -0,0 +1,24 @@
+"""Block ud.ro.FixFixed
+
+Author: Dan Zeman
+"""
+import logging
+
+from udapi.core.block import Block
+
+
+class FixFixed(Block):
+    """Block for fixing verbal 'fixed' expressions."""
+
+    def process_node(self, node):
+        if node.upos=='VERB':
+            fixchildren = [x for x in node.children if x.udeprel=='fixed']
+            nfc = len(fixchildren)
+            if nfc==1 and fixchildren[0].upos == 'NOUN':
+                fixchildren[0].deprel = 'obj'
+            elif nfc==2 and fixchildren[1].upos == 'NOUN':
+                fixchildren[0].parent = fixchildren[1]
+                fixchildren[0].deprel = 'case'
+                fixchildren[1].deprel = 'obl'
+            elif nfc>0:
+                logging.info('Another case: '+node.lemma+' '+' '.join([x.form for x in fixchildren]))

From 12c96924eb5168897bdd452ef3eb85ebc41cfcc8 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 1 Jul 2025 16:08:56 +0200
Subject: [PATCH 1271/1374] New fixed expr

---
 udapi/block/ud/ro/fixfixed.py | 17 ++++++-----------
 1 file changed, 6 insertions(+), 11 deletions(-)

diff --git a/udapi/block/ud/ro/fixfixed.py b/udapi/block/ud/ro/fixfixed.py
index b8309ad9..9e285684 100644
--- a/udapi/block/ud/ro/fixfixed.py
+++ b/udapi/block/ud/ro/fixfixed.py
@@ -11,14 +11,9 @@ class FixFixed(Block):
     """Block for fixing verbal 'fixed' expressions."""
 
     def process_node(self, node):
-        if node.upos=='VERB':
-            fixchildren = [x for x in node.children if x.udeprel=='fixed']
-            nfc = len(fixchildren)
-            if nfc==1 and fixchildren[0].upos == 'NOUN':
-                fixchildren[0].deprel = 'obj'
-            elif nfc==2 and fixchildren[1].upos == 'NOUN':
-                fixchildren[0].parent = fixchildren[1]
-                fixchildren[0].deprel = 'case'
-                fixchildren[1].deprel = 'obl'
-            elif nfc>0:
-                logging.info('Another case: '+node.lemma+' '+' '.join([x.form for x in fixchildren]))
+        fixchildren = [x for x in node.children if x.udeprel=='fixed']
+        nfc = len(fixchildren)
+        if nfc>0 and node.udeprel=="advmod":
+            node.feats['ExtPos'] = 'ADV'
+        #elif nfc>0:
+        #    logging.info('Another case: '+node.lemma+' '+' '.join([x.form for x in fixchildren]))

From 5b19027f33d17286377b2eb381e33cbcd44b5e5b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 1 Jul 2025 16:26:12 +0200
Subject: [PATCH 1272/1374] Romanian fixed expressions.

---
 udapi/block/ud/ro/fixfixed.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/ro/fixfixed.py b/udapi/block/ud/ro/fixfixed.py
index 9e285684..14d16464 100644
--- a/udapi/block/ud/ro/fixfixed.py
+++ b/udapi/block/ud/ro/fixfixed.py
@@ -8,12 +8,13 @@
 
 
 class FixFixed(Block):
-    """Block for fixing verbal 'fixed' expressions."""
+    """Block for fixing annotation of some 'fixed' expressions."""
 
     def process_node(self, node):
         fixchildren = [x for x in node.children if x.udeprel=='fixed']
         nfc = len(fixchildren)
-        if nfc>0 and node.udeprel=="advmod":
-            node.feats['ExtPos'] = 'ADV'
-        #elif nfc>0:
-        #    logging.info('Another case: '+node.lemma+' '+' '.join([x.form for x in fixchildren]))
+        if nfc > 0:
+            if node.udeprel == 'advmod' and node.feats['ExtPos'] == '':
+                node.feats['ExtPos'] = 'ADV'
+            elif node.feats['ExtPos'] == '':
+                logging.info('Another case: '+node.lemma+' '+' '.join([x.form for x in fixchildren]))

From 0bfdccb3ad64c3af2b72affb03769dcad560ccf5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 2 Jul 2025 22:21:48 +0200
Subject: [PATCH 1273/1374] Czech features.

---
 udapi/block/ud/cs/markfeatsbugs.py | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 6c3672ac..5a61d1c3 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -646,6 +646,15 @@ def process_node(self, node):
                             'VerbForm': ['Fin'],
                             'Mood': ['Cnd']
                         })
+                    elif node.form.lower() == 'byšta':
+                        self.check_required_features(node, ['Mood', 'Person', 'Number'])
+                        self.check_allowed_features(node, {
+                            'Aspect': ['Imp'],
+                            'VerbForm': ['Fin'],
+                            'Mood': ['Cnd'],
+                            'Person': ['2', '3'],
+                            'Number': ['Dual']
+                        })
                     else:
                         self.check_required_features(node, ['Mood', 'Person', 'Number'])
                         self.check_allowed_features(node, {
@@ -798,7 +807,8 @@ def process_node(self, node):
                     self.check_allowed_features(node, {
                         'Degree': ['Pos', 'Cmp', 'Sup'],
                         'Polarity': ['Pos', 'Neg'],
-                        'Emph': ['Yes']
+                        'Emph': ['Yes'],
+                        'Abbr': ['Yes']
                     })
         # ADPOSITIONS ##########################################################
         elif node.upos == 'ADP':

From 0370f2b5c2fd6c3390dd94fc986738733838dc3a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 3 Jul 2025 13:31:06 +0200
Subject: [PATCH 1274/1374] Allow empty aspect for participles of biaspectual
 verbs.

---
 udapi/block/ud/cs/markfeatsbugs.py | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 5a61d1c3..1e889154 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -129,7 +129,8 @@ def process_node(self, node):
                 self.check_required_features(node, ['VerbForm', 'Voice'])
                 if node.feats['Voice'] == 'Act': # active participles have tense, passives don't but they have degree
                     if node.feats['Gender'] == 'Masc':
-                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Tense', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity'])
+                        # Aspect is not required in general because it is omitted for participles of biaspectual verbs (e.g. 'analyzující').
+                        self.check_required_features(node, ['VerbForm', 'Voice', 'Tense', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity'])
                         self.check_allowed_features(node, {
                             'VerbForm': ['Part'],
                             'Aspect': ['Imp', 'Perf'],
@@ -144,7 +145,8 @@ def process_node(self, node):
                             'Emph': ['Yes'],
                             'Foreign': ['Yes']})
                     else:
-                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Tense', 'Gender', 'Number', 'Case', 'Polarity'])
+                        # Aspect is not required in general because it is omitted for participles of biaspectual verbs (e.g. 'analyzující').
+                        self.check_required_features(node, ['VerbForm', 'Voice', 'Tense', 'Gender', 'Number', 'Case', 'Polarity'])
                         self.check_allowed_features(node, {
                             'VerbForm': ['Part'],
                             'Aspect': ['Imp', 'Perf'],
@@ -159,7 +161,8 @@ def process_node(self, node):
                             'Foreign': ['Yes']})
                 else:
                     if node.feats['Gender'] == 'Masc':
-                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity', 'Degree'])
+                        # Aspect is not required in general because it is omitted for participles of biaspectual verbs (e.g. 'analyzovaný').
+                        self.check_required_features(node, ['VerbForm', 'Voice', 'Gender', 'Animacy', 'Number', 'Case', 'Polarity', 'Degree'])
                         self.check_allowed_features(node, {
                             'VerbForm': ['Part'],
                             'Aspect': ['Imp', 'Perf'],
@@ -174,7 +177,8 @@ def process_node(self, node):
                             'Emph': ['Yes'],
                             'Foreign': ['Yes']})
                     else:
-                        self.check_required_features(node, ['VerbForm', 'Aspect', 'Voice', 'Gender', 'Number', 'Case', 'Polarity', 'Degree'])
+                        # Aspect is not required in general because it is omitted for participles of biaspectual verbs (e.g. 'analyzovaný').
+                        self.check_required_features(node, ['VerbForm', 'Voice', 'Gender', 'Number', 'Case', 'Polarity', 'Degree'])
                         self.check_allowed_features(node, {
                             'VerbForm': ['Part'],
                             'Aspect': ['Imp', 'Perf'],

From 7d531c08796e692cc4b19e3cb85497266dbd57e5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 3 Jul 2025 15:27:47 +0200
Subject: [PATCH 1275/1374] =?UTF-8?q?Variant=3DShort=20pro=20"ve=C5=A1kere?=
 =?UTF-8?q?n".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 1e889154..17570ee2 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -513,6 +513,9 @@ def process_node(self, node):
                 # However, in New Czech data the one lemma is "samý" while in Old Czech data it is "sám".
                 # Unlike other determiners, it allows Variant=Short: sám, sama, samu, samo, sami, samy.
                 self.check_adjective_like(node, ['PronType'], {'PronType': ['Emp'], 'Variant': ['Short']})
+            elif node.lemma == 'veškerý':
+                # In Old Czech, this determiner also allows Variant=Short: veškeren, veškera, veškeru, veškero, veškeři, veškery.
+                self.check_adjective_like(node, ['PronType'], {'PronType': ['Tot'], 'Variant': ['Short']})
             elif node.lemma == 'žádný':
                 # In Old Czech, this determiner also allows Variant=Short: žáden, žádna, žádnu, žádno, žádni, žádny.
                 self.check_adjective_like(node, ['PronType'], {'PronType': ['Neg'], 'Variant': ['Short']})

From 4b0c5cdc987d8c05ace505512587675592165527 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 3 Jul 2025 17:41:51 +0200
Subject: [PATCH 1276/1374] A new block to split a token marked as erroneous.

---
 udapi/block/ud/splittoken.py | 107 +++++++++++++++++++++++++++++++++++
 1 file changed, 107 insertions(+)
 create mode 100644 udapi/block/ud/splittoken.py

diff --git a/udapi/block/ud/splittoken.py b/udapi/block/ud/splittoken.py
new file mode 100644
index 00000000..16c60a38
--- /dev/null
+++ b/udapi/block/ud/splittoken.py
@@ -0,0 +1,107 @@
+"""
+Block ud.SplitToken will split a given token into multiple tokens.
+"""
+from udapi.core.block import Block
+import re
+import logging
+
+
+class SplitToken(Block):
+    """
+    Split a token into two or more. A MISC attribute is used to mark the tokens
+    that should be split. (The attribute may have been set by an annotator or
+    by a previous block that tests the specific conditions under which splitting
+    is desired.) Multiword tokens are currently not supported: The node to be
+    split cannot belong to a MWT. Note that the result will not be a MWT either
+    (use the block ud.AddMwt if that is desired). There will be simply a new
+    attribute SpaceAfter=No, possibly accompanied by CorrectSpaceAfter=Yes
+    (indicating that this was an error in the source text).
+    """
+
+    def __init__(self, misc_name='SplitToken', **kwargs):
+        """
+        Args:
+        misc_name: name of the MISC attribute that can trigger the splitting
+            default: SplitToken
+            The value of the attribute should indicate where to split the token.
+            It should be a string that is identical to node.form except that
+            there is one or more spaces where the token should be split.
+        """
+        super().__init__(**kwargs)
+        self.misc_name = misc_name
+
+    def process_node(self, node):
+        """
+        The SplitToken (or equivalent) attribute in MISC will trigger action.
+        Either the current node will be split to multiple nodes and the
+        attribute will be removed from MISC, or a warning will be issued that
+        the splitting cannot be done and the attribute will stay in MISC. Note
+        that multiword token lines and empty nodes are not even scanned for
+        the attribute, so if it is there, it will stay there but no warning
+        will be printed.
+        """
+        value = node.misc[self.misc_name]
+        if value == '':
+            return
+        if node.multiword_token:
+            logging.warning(f"MISC {self.misc_name} cannot be used if the node belongs to a multiword token.")
+            node.misc['Bug'] = 'SplittingTokenNotSupportedHere'
+            return
+        ###!!! This block currently must not be applied on data containing
+        ###!!! enhanced dependencies. We must first implement adjustments of
+        ###!!! the enhanced structure.
+        if node.deps:
+            logging.fatal('At present this block cannot be applied to data with enhanced dependencies.')
+        # Verify that the value of the MISC attribute can be used as specification
+        # of the split.
+        if re.match(r'^\s', value) or re.search(r'\s$', value) or re.search(r'\s\s', value):
+            logging.warning(f"MISC {self.misc_name} is '{value}'; leading spaces, trailing spaces or multiple consecutive spaces are not allowed.")
+            node.misc['Bug'] = f'{self.misc_name}BadValue'
+            return
+        if re.search(r'\s', node.form):
+            logging.warning(f"MISC {self.misc_name} cannot be used with nodes whose forms contain a space (here '{node.form}').")
+            node.misc['Bug'] = 'SplittingTokenNotSupportedHere'
+            return
+        if re.sub(r' ', '', value) != node.form:
+            logging.warning(f"MISC {self.misc_name} value '{value}' does not match the word form '{node.form}'.")
+            node.misc['Bug'] = f'{self.misc_name}BadValue'
+            return
+        # Do the split.
+        space_after = node.misc['SpaceAfter']
+        forms = value.split(' ')
+        # Optionally, SplitTokenMorpho in MISC can have the morphological annotation
+        # of the new tokens. For example:
+        # SplitTokenMorpho=LEMMA=popisovat\tUPOS=VERB\tFEATS=Aspect=Imp\\pMood=Ind\\pNumber=Sing\\pPerson=3\\pPolarity=Pos\\pTense=Pres\\pVerbForm=Fin\\pVoice=Act
+        if node.misc['SplitTokenMorpho'] != '':
+            morphoblocks = [''] + node.misc['SplitTokenMorpho'].split(' ')
+            del node.misc['SplitTokenMorpho']
+        else:
+            morphoblocks = ['' for x in forms]
+        node.form = forms[0]
+        last_node = node
+        for form, morpho in zip(forms[1:], morphoblocks[1:]):
+            last_node.misc['SpaceAfter'] = 'No'
+            last_node.misc['CorrectSpaceAfter'] = 'Yes'
+            lemma = form
+            upos = node.upos
+            feats = str(node.feats)
+            xpos = node.xpos
+            if morpho != '':
+                cols = morpho.split('\\t')
+                for c in cols:
+                    colname, value = c.split('=', 1)
+                    if colname == 'LEMMA':
+                        lemma = value
+                    elif colname == 'UPOS':
+                        upos = value
+                    elif colname == 'FEATS':
+                        feats = re.sub(r'\\p', '|', value)
+                    elif colname == 'XPOS':
+                        xpos = value
+                    else:
+                        logging.fatal(f"c = {c}")
+            new_node = node.create_child(form=form, lemma=lemma, upos=upos, feats=feats, xpos=xpos, deprel='dep')
+            new_node.shift_after_node(last_node)
+            last_node = new_node
+        last_node.misc['SpaceAfter'] = space_after
+        del node.misc[self.misc_name]

From 057d4830bdd91d0458f78c292d27bad4e1030f3c Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 29 Jul 2025 13:17:28 +0200
Subject: [PATCH 1277/1374] add root.prev_tree and root.next_tree

---
 udapi/core/root.py | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/udapi/core/root.py b/udapi/core/root.py
index abf36a74..d5e0f4a8 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -314,3 +314,25 @@ def flatten(self, deprel='root'):
         for node in self._children:
             node._parent = self
             node._children.clear()
+
+    @property
+    def prev_tree(self):
+        """Return the previous tree (root) in the document (from the same zone)."""
+        doc = self._bundle._document
+        num = self._bundle.number
+        if len(doc.bundles) <= num - 1 or doc.bundles[num - 1] is not self._bundle:
+            num = doc.bundles.index(self._bundle) + 1
+        if num == 1:
+            return None
+        return doc.bundles[num - 2].get_tree(zone=self._zone)
+
+    @property
+    def next_tree(self):
+        """Return the next tree (root) in the document (from the same zone)."""
+        doc = self._bundle._document
+        num = self._bundle.number
+        if len(doc.bundles) <= num - 1 or doc.bundles[num - 1] is not self._bundle:
+            num = doc.bundles.index(self._bundle) + 1
+        if len(doc.bundles) <= num:
+            return None
+        return doc.bundles[num].get_tree(zone=self._zone)

From cecb9ebd1fb29fa4f8ea034f05f873fecc3830a5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 14 Aug 2025 09:39:35 +0200
Subject: [PATCH 1278/1374] Fixes #131.

---
 udapi/block/ud/markbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/markbugs.py b/udapi/block/ud/markbugs.py
index 959b484e..ee58084a 100644
--- a/udapi/block/ud/markbugs.py
+++ b/udapi/block/ud/markbugs.py
@@ -118,7 +118,7 @@ def process_node(self, node):
             if upos == i_upos and not feats[i_feat]:
                 # Some languages do not distinguish finite and non-finite forms of verbs.
                 # The VerbForm feature is not obligatory in those languages.
-                if i_feat != 'VerbForm' or not node.root.zone.split('_')[0] in {'id', 'jv', 'tl', 'hil', 'ifb'}:
+                if i_feat != 'VerbForm' or not node.root.zone.split('_')[0] in {'id', 'jv', 'tl', 'hil', 'ifb', 'naq'}:
                     self.log(node, 'no-' + i_feat, 'upos=%s but %s feature is missing' % (upos, i_feat))
 
         if feats['VerbForm'] == 'Fin':

From 5a7dd36cd09773ed04485456b05732d159ddc9c1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 10 Sep 2025 17:56:19 +0200
Subject: [PATCH 1279/1374] Similarly to FixMultiSubjects, we need
 FixMultiObjects.

---
 udapi/block/ud/fixmultiobjects.py | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 udapi/block/ud/fixmultiobjects.py

diff --git a/udapi/block/ud/fixmultiobjects.py b/udapi/block/ud/fixmultiobjects.py
new file mode 100644
index 00000000..df7d5a44
--- /dev/null
+++ b/udapi/block/ud/fixmultiobjects.py
@@ -0,0 +1,18 @@
+"""
+Block ud.FixMultiObjects will ensure that no node has more than one (direct) object child.
+"""
+from udapi.core.block import Block
+
+
+class FixMultiObjects(Block):
+    """
+    Make sure there is at most one object.
+    """
+
+    def process_node(self, node):
+        objects = [x for x in node.children if x.udeprel == 'obj']
+        # For the moment, we take the dummiest approach possible: The first object survives and all others are forced to a different deprel.
+        if len(objects) > 1:
+            objects = objects[1:]
+            for o in objects:
+                o.deprel = 'iobj'

From 3e25850aa825ceda1bb0d98fb80bf79fad16c7b3 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Wed, 10 Sep 2025 20:21:37 +0200
Subject: [PATCH 1280/1374] Extend Romance block to support Spanish

---
 udapi/block/msf/romance/romance.py | 85 +++++++++++++++++++++++++-----
 1 file changed, 72 insertions(+), 13 deletions(-)

diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
index dd2393f7..782944fb 100644
--- a/udapi/block/msf/romance/romance.py
+++ b/udapi/block/msf/romance/romance.py
@@ -2,6 +2,9 @@
 import udapi.block.msf.phrase
 from enum import Enum
 
+AUXES_HAVE = ['ter', 'haber']
+AUXES_BE = ['estar']
+
 class Aspect(str, Enum):
     IMP = 'Imp'
     IMPPROG = 'ImpProg'
@@ -41,7 +44,7 @@ def process_node(self, node):
                 self.process_copulas(node,cop,auxes,refl,expl)
             return
 
-        if node.upos == 'VERB':
+        if node.upos == 'VERB': #TODO maybe add 'or node.feats['VerbForm'] == 'Part'?
             auxes = [x for x in node.children if x.udeprel == 'aux']
             aux_pass = [x for x in node.children if x.deprel == 'aux:pass']
             auxes_without_pass = [x for x in node.children if x.udeprel == 'aux' and x.deprel != 'aux:pass']
@@ -66,29 +69,48 @@ def process_node(self, node):
                     phrase_ords = [node.ord] + [r.ord for r in refl]
                     phrase_ords.sort()
 
+                    # Portuguese
                     # presente -> PhraseTense=Pres, PhraseAspect=''
                     # Futuro do presente -> PhraseTense=Fut, PhraseAspect=''
+
+                    # Spanish
+                    # presente -> PhraseTense=Pres, PhraseAspect=''
+                    # futuro simple -> PhraseTense=Fut, PhraseAspect=''
                     aspect = ''
                     tense = node.feats['Tense']
 
                     if node.feats['Mood'] == 'Ind':
-
+                        
+                        # Portuguese
                         # pretérito imperfeito -> PhraseTense=Past, PhraseAspect=Imp
+
+                        # Spanish
+                        # pretérito imperfecto -> PhraseTense=Past, PhraseAspect=Imp
                         if node.feats['Tense'] == 'Imp':
                             tense=Tense.PAST.value
                             aspect=Aspect.IMP.value
 
+                        # Portuguese
                         # pretérito perfeito -> PhraseTense=Past, PhraseAspect=Perf
+
+                        # Spanish
+                        # pretérito perfecto -> PhraseTense=Past, PhraseAspect=Perf
                         if node.feats['Tense'] == 'Past':
                             aspect=Aspect.PERF.value
 
+                        # Portuguese
                         # pretérito mais que perfeito simples -> PhraseTense=Past, PhraseAspect=Pqp
                         if node.feats['Tense'] == 'Pqp':
                             tense=Tense.PAST.value
                             aspect=Aspect.PQP.value
                             
+                    # Portuguese
                     # subjunctive presente -> PhraseTense=Pres, PhraseAspect=''
                     # subjunctive futuro -> PhraseTense=Fut, PhraseAspect=''
+
+                    # Spanish
+                    # subjunctive presente -> PhraseTense=Pres, PhraseAspect=''
+                    # subjunctive futuro -> PhraseTense=Fut, PhraseAspect='' TODO not annotated in treebanks?
                     if node.feats['Mood'] == 'Sub':
 
                         if node.feats['Tense'] == 'Past':
@@ -99,7 +121,11 @@ def process_node(self, node):
                             tense=Tense.PAST.value
                             aspect=Aspect.IMP.value
 
+                    # Portuguese
                     # Futuro do pretérito (cnd) -> PhraseTense=Pres, PhraseAspect='', PhraseMood=Cnd
+
+                    # Spanish
+                    # pospretérito (cnd) -> PhraseTense=Pres, PhraseAspect='', PhraseMood=Cnd
                     if node.feats['Mood'] == 'Cnd':
                         aspect=''
                         tense=Tense.PRES.value
@@ -146,7 +172,6 @@ def process_node(self, node):
                 else:
                     self.process_periphrastic_verb_forms(aux_pass[0], auxes_without_pass, refl, auxes, node)
 
-
     def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_node):
         """
         Parameters
@@ -166,19 +191,24 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
 
         if len(auxes)  == 1:
             # Cnd
-            if ((auxes[0].lemma == 'ter' and node.feats['VerbForm'] == 'Part') or (auxes[0].lemma == 'estar' and node.feats['VerbForm'] == 'Ger')) and auxes[0].feats['Mood'] == 'Cnd':
+            if ((auxes[0].lemma in AUXES_HAVE and node.feats['VerbForm'] == 'Part') or (auxes[0].lemma in AUXES_BE and node.feats['VerbForm'] == 'Ger')) and auxes[0].feats['Mood'] == 'Cnd':
                 phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl] + [r.ord for r in refl]
                 phrase_ords.sort()
 
+                # Portuguese
                 # aux estar cond + gerund -> PhraseTense=Pres, PhraseAspect=Prog, PhraseMood=Cnd
                 if auxes[0].lemma == 'estar':
                     tense=Tense.PRES.value
                     aspect=Aspect.PROG.value
 
-                # Futuro do pretérito composto -> PhraseTense=Past, PhraseAspect=Perf, PhraseMood=Cnd
+                # Portuguese
+                # Futuro do pretérito composto -> PhraseTense=Past, PhraseAspect='', PhraseMood=Cnd
+
+                # Spanish
+                # Antepospretérito -> PhraseTense=Past, PhraseAspect='', PhraseMood=Cnd
                 else:
                     tense=Tense.PAST.value
-                    aspect=Aspect.PERF.value
+                    aspect=''
 
                 self.write_node_info(head_node,
                     tense=tense,
@@ -193,26 +223,30 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                 return
                 
             # Auxiliary 'estar' followed by a gerund 
-            if auxes[0].lemma == 'estar' and node.feats['VerbForm'] == 'Ger':
+            if auxes[0].lemma in AUXES_BE and node.feats['VerbForm'] == 'Ger':
                 phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
                 phrase_ords.sort()
 
+                # Portuguese + Spanish
                 # pretérito imperfeito (aux estar) -> PhraseTense=Past, PhraseAspect=ImpProg
                 # subjunctive pretérito imperfeito (aux estar) -> PhraseTense=Past, PhraseAspect=ImpProg, PhraseMood=Sub
                 if auxes[0].feats['Tense'] == 'Imp':
                     tense=Tense.PAST.value
                     aspect=Aspect.IMPPROG.value
 
+                # Portuguese + Spanish
                 # pretérito perfeito (aux estar) -> PhraseTense=Past, PhraseAspect=PerfProg
                 elif auxes[0].feats['Tense'] == 'Past':
                     tense=Tense.PAST.value
                     aspect=Aspect.PERFPROG.value
 
+                # Portuguese + Spanish
                 # conditional (aux estar) -> PhraseTense=Pres, PhraseAspect=Prog, PhraseMood=Cnd
                 elif auxes[0].feats['Mood'] == 'Cnd':
                     tense=Tense.PRES.value
                     aspect=Aspect.PROG.value
 
+                # Portuguese + Spanish
                 # presente (aux estar) -> PhraseTense=Pres, PhraseAspect=Prog
                 # futuro do presente (aux estar) -> PhraseTense=Fut, PhraseAspect=Prog
                 # subjunctive presente (aux estar) -> PhraseTense=Pres, PhraseAspect=Prog, PhraseMood=Sub
@@ -232,22 +266,38 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     expl=expl,
                     ords=phrase_ords)
 
-            # Auxiliary 'ter' followed by a participle
-            if auxes[0].lemma == 'ter' and node.feats['VerbForm'] == 'Part':
+            # Auxiliary 'ter' / 'haber' followed by a participle
+            if auxes[0].lemma in AUXES_HAVE and node.feats['VerbForm'] == 'Part':
                 phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
                 phrase_ords.sort()
 
+                # Portuguese
                 # futuro do presente composto (aux ter) -> PhraseTense=Fut, PhraseAspect=Perf
+
+                # Spanish
+                # Futuro compuesto antefuturo -> PhraseTense=Fut, PhraseAspect=Perf
                 aspect=Aspect.PERF.value
                 tense=auxes[0].feats['Tense']
 
+                # Portuguese
                 # pretérito perfeito composto (aux ter) -> PhraseTense=PastPres, PhraseAspect=Perf
                 # subjonctive pretérito perfeito composto (aux ter) -> PhraseTense=PastPres, PhraseAspect=Perf, PhraseMood=Sub
+
                 if auxes[0].feats['Tense'] == 'Pres':
-                    tense=Tense.PASTPRES.value
 
-                # pretérito mais que perfeito composto (aux ter/haver) -> PhraseTense=Past, PhraseAspect=Pqp
+                    # Spanish
+                    # Pretérito perfecto compuesto ante presente -> PhraseTense=Past, PhraseAspect=Perf
+                    if auxes[0].lemma == 'haber' and auxes[0].feats['Mood'] != 'Sub':
+                        tense = Tense.PAST.value
+                    else:
+                        tense=Tense.PASTPRES.value
+
+                # Portuguese
+                # pretérito mais que perfeito composto (aux ter) -> PhraseTense=Past, PhraseAspect=Pqp
                 # subjonctive pretérito mais-que-perfeito composto (aux ter) -> PhraseTense=Past, PhraseAspect=Pqp, PhraseMood=Sub
+
+                # Spanish
+                # pretérito pluscuamperfecto -> PhraseTense=Past, PhraseAspect=Pqp
                 elif auxes[0].feats['Tense'] in ['Imp', 'Past']: # TODO prej neni v Past, jenom Imp
                     tense=Tense.PAST.value
                     aspect=Aspect.PQP.value
@@ -263,6 +313,8 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     expl=expl,
                     ords=phrase_ords)
                 
+            # Portuguese
+            # pretérito mais que perfeito composto (aux haver) -> PhraseTense=Past, PhraseAspect=Perf
             if auxes[0].lemma == 'haver' and auxes[0].feats['Tense'] == 'Imp' and node.feats['VerbForm'] == 'Part':
                 phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
                 phrase_ords.sort()
@@ -303,6 +355,7 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
 
             
             # auxiliary 'ir' followed by infinitive
+            # TODO solve these verb forms for Spanish (VERB 'ir' + ADP 'a' + infinitive)
             if auxes[0].lemma == 'ir' and node.feats['VerbForm'] == 'Inf':
                 phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
                 phrase_ords.sort()
@@ -368,7 +421,11 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     ords=phrase_ords)
                 
         elif len(auxes) == 2:
+            # Portuguese
             # auxiliry 'ir' followed by auxiliary 'estar' in infinitive and a gerund
+
+            # TODO Spanish
+            # VERB 'ir' + ADP 'a' + AUX 'estar'.Inf + gerund
             if auxes[0].lemma == 'ir' and auxes[1].lemma == 'estar' and node.feats['VerbForm'] == 'Ger':
                 phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
                 phrase_ords.sort()
@@ -431,8 +488,8 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                 
             
                 
-            # Cnd (only ter), Sub and Past,Pres,Fut tenses: 2 auxes - ter + estar
-            if auxes[0].lemma in ['ter', 'haver'] and auxes[1].lemma == 'estar' and node.feats['VerbForm'] == 'Ger':
+            # Cnd (only ter/haber), Sub and Past,Pres,Fut tenses: 2 auxes - ter/haber + estar
+            if auxes[0].lemma in AUXES_HAVE and auxes[1].lemma == 'estar' and node.feats['VerbForm'] == 'Ger':
                 phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
                 phrase_ords.sort()
 
@@ -473,6 +530,8 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                 return
                 
     def process_copulas(self, node, cop, auxes, refl, expl):
+
+        aspect = ''
         
         if not auxes:
             tense = cop[0].feats['Tense']

From 89b3a7668db86eb06e1a07863c71cc3aac8e74b2 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 11 Sep 2025 15:13:12 +0200
Subject: [PATCH 1281/1374] Quick fixes.

---
 udapi/block/ud/fixadvmodbyupos.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index 916910b5..d6e51e1f 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -53,6 +53,8 @@ def process_node(self, node):
                 node.deprel = 'nsubj' # it could be also obj, iobj, obl or nmod; just guessing what might be more probable
             elif node.upos == 'NOUN':
                 node.deprel = 'obl'
+            elif node.upos == 'ADJ':
+                node.deprel = 'amod'
             elif node.upos == 'INTJ':
                 node.deprel = 'discourse'
         elif node.udeprel == 'cc':

From 4694a5b4fe7e6dd6e82a012774a4800a4e73f30c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 11 Sep 2025 15:49:41 +0200
Subject: [PATCH 1282/1374] =?UTF-8?q?"je=C5=A1to"=20+=20"jest"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/addmwt.py | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index c1b3783a..37c6d94e 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -91,6 +91,18 @@ def multiword_analysis(self, node):
                     'main':   0,
                     'shape':  'subtree' if node.upos in ['VERB'] else 'siblings',
                 }
+            if subtokens[1] == 'jest':
+                node.misc['AddMwt'] = ''
+                return {
+                    'form':   subtokens[0] + ' jest',
+                    'lemma':  '* být',
+                    'upos':   '* AUX',
+                    'xpos':   '* VB-S---3P-AAI-2',
+                    'feats':  '* Aspect=Imp|Mood=Ind|Number=Sing|Person=3|Polarity=Pos|Tense=Pres|VerbForm=Fin|Voice=Act',
+                    'deprel': '* aux',
+                    'main':   0,
+                    'shape':  'subtree' if node.upos in ['VERB'] else 'siblings',
+                }
             if subtokens[1] == 'i':
                 node.misc['AddMwt'] = ''
                 return {

From 203df64efd72722f6ee9ade58988ea5286b2da63 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Thu, 11 Sep 2025 19:52:26 +0200
Subject: [PATCH 1283/1374] Remove lemmas from some rules

---
 udapi/block/msf/romance/romance.py | 150 ++++++++++++++---------------
 1 file changed, 74 insertions(+), 76 deletions(-)

diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
index 782944fb..b2441364 100644
--- a/udapi/block/msf/romance/romance.py
+++ b/udapi/block/msf/romance/romance.py
@@ -191,7 +191,7 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
 
         if len(auxes)  == 1:
             # Cnd
-            if ((auxes[0].lemma in AUXES_HAVE and node.feats['VerbForm'] == 'Part') or (auxes[0].lemma in AUXES_BE and node.feats['VerbForm'] == 'Ger')) and auxes[0].feats['Mood'] == 'Cnd':
+            if auxes[0].feats['Mood'] == 'Cnd' and (node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'Ger'):
                 phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl] + [r.ord for r in refl]
                 phrase_ords.sort()
 
@@ -221,9 +221,76 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     voice=head_node.feats['Voice'],
                     ords=phrase_ords)
                 return
+            
+            if auxes[0].lemma == 'vir' and auxes[0].feats['Tense'] in ['Pres', 'Imp', 'Past'] and node.feats['VerbForm'] == 'Ger':
+                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                # aux Pres (vir) + gerund -> PhraseTense=PastPres, PraseAspect=Prog
+                if auxes[0].feats['Tense'] == 'Pres':
+                    tense=Tense.PASTPRES.value
+
+
+                elif auxes[0].feats['Tense'] in ['Imp', 'Past']: 
+                    tense=Tense.PAST.value
+
+                self.write_node_info(head_node,
+                    tense=tense,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood=auxes[0].feats['Mood'],
+                    form='Fin',
+                    aspect=Aspect.PROG.value,
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    ords=phrase_ords)      
+                return
+            
+            if auxes[0].lemma == 'ir' and node.feats['VerbForm'] == 'Ger':
+                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                # aux Pres (ir) + gerund -> PhraseTense=Pres, PhraseAspect=Prog
+                tense = auxes[0].feats['Tense']
+                aspect = Aspect.PROG.value
+
+                # aux Imp (ir) + gerund -> PhraseTense=Past, PhraseAspect=Prog
+                if auxes[0].feats['Tense'] == 'Imp':
+                    tense=Tense.PAST.value
+                    aspect=Aspect.PROG.value
+
+                self.write_node_info(head_node,
+                    tense=tense,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood=auxes[0].feats['Mood'],
+                    aspect=aspect,
+                    form='Fin',
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    ords=phrase_ords)
+                return
+            
+            # Portuguese
+            # pretérito mais que perfeito composto (aux haver) -> PhraseTense=Past, PhraseAspect=Perf
+            if auxes[0].lemma == 'haver' and auxes[0].feats['Tense'] == 'Imp' and node.feats['VerbForm'] == 'Part':
+                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                self.write_node_info(head_node,
+                    tense=Tense.PAST.value,
+                    aspect=Aspect.PERF.value,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood=auxes[0].feats['Mood'],
+                    form='Fin',
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    ords=phrase_ords)
+                return
                 
             # Auxiliary 'estar' followed by a gerund 
-            if auxes[0].lemma in AUXES_BE and node.feats['VerbForm'] == 'Ger':
+            if node.feats['VerbForm'] == 'Ger':
                 phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
                 phrase_ords.sort()
 
@@ -240,12 +307,6 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     tense=Tense.PAST.value
                     aspect=Aspect.PERFPROG.value
 
-                # Portuguese + Spanish
-                # conditional (aux estar) -> PhraseTense=Pres, PhraseAspect=Prog, PhraseMood=Cnd
-                elif auxes[0].feats['Mood'] == 'Cnd':
-                    tense=Tense.PRES.value
-                    aspect=Aspect.PROG.value
-
                 # Portuguese + Spanish
                 # presente (aux estar) -> PhraseTense=Pres, PhraseAspect=Prog
                 # futuro do presente (aux estar) -> PhraseTense=Fut, PhraseAspect=Prog
@@ -265,9 +326,11 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     aspect=aspect,
                     expl=expl,
                     ords=phrase_ords)
+                
+                return
 
             # Auxiliary 'ter' / 'haber' followed by a participle
-            if auxes[0].lemma in AUXES_HAVE and node.feats['VerbForm'] == 'Part':
+            if node.feats['VerbForm'] == 'Part':
                 phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
                 phrase_ords.sort()
 
@@ -312,48 +375,8 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     ords=phrase_ords)
+                return
                 
-            # Portuguese
-            # pretérito mais que perfeito composto (aux haver) -> PhraseTense=Past, PhraseAspect=Perf
-            if auxes[0].lemma == 'haver' and auxes[0].feats['Tense'] == 'Imp' and node.feats['VerbForm'] == 'Part':
-                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
-                phrase_ords.sort()
-
-                self.write_node_info(head_node,
-                    tense=Tense.PAST.value,
-                    aspect=Aspect.PERF.value,
-                    number=auxes[0].feats['Number'],
-                    person=auxes[0].feats['Person'],
-                    mood=auxes[0].feats['Mood'],
-                    form='Fin',
-                    voice=head_node.feats['Voice'],
-                    expl=expl,
-                    ords=phrase_ords)
-                
-            if auxes[0].lemma == 'vir' and auxes[0].feats['Tense'] in ['Pres', 'Imp', 'Past'] and node.feats['VerbForm'] == 'Ger':
-                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
-                phrase_ords.sort()
-
-                # aux Pres (vir) + gerund -> PhraseTense=PastPres, PraseAspect=Prog
-                if auxes[0].feats['Tense'] == 'Pres':
-                    tense=Tense.PASTPRES.value
-
-
-                elif auxes[0].feats['Tense'] in ['Imp', 'Past']: 
-                    tense=Tense.PAST.value
-
-                self.write_node_info(head_node,
-                    tense=tense,
-                    number=auxes[0].feats['Number'],
-                    person=auxes[0].feats['Person'],
-                    mood=auxes[0].feats['Mood'],
-                    form='Fin',
-                    aspect=Aspect.PROG.value,
-                    voice=head_node.feats['Voice'],
-                    expl=expl,
-                    ords=phrase_ords)
-
-            
             # auxiliary 'ir' followed by infinitive
             # TODO solve these verb forms for Spanish (VERB 'ir' + ADP 'a' + infinitive)
             if auxes[0].lemma == 'ir' and node.feats['VerbForm'] == 'Inf':
@@ -381,9 +404,7 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                 # Futuro perifrástico passado perf -> PhraseTense=PastFut, PhraseAspect=Perf
                 elif auxes[0].feats['Tense'] == 'Past':
                     tense=Tense.PASTFUT.value
-                    aspect=Aspect.PERF.value
-
-                
+                    aspect=Aspect.PERF.value                
 
                 self.write_node_info(head_node,
                     tense=tense,
@@ -396,29 +417,6 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     expl=expl,
                     ords=phrase_ords)
                 
-            if auxes[0].lemma == 'ir' and node.feats['VerbForm'] == 'Ger':
-                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
-                phrase_ords.sort()
-
-                # aux Pres (ir) + gerund -> PhraseTense=Pres, PhraseAspect=Prog
-                tense = auxes[0].feats['Tense']
-                aspect = Aspect.PROG.value
-
-                # aux Imp (ir) + gerund -> PhraseTense=Past, PhraseAspect=Prog
-                if auxes[0].feats['Tense'] == 'Imp':
-                    tense=Tense.PAST.value
-                    aspect=Aspect.PROG.value
-
-                self.write_node_info(head_node,
-                    tense=tense,
-                    number=auxes[0].feats['Number'],
-                    person=auxes[0].feats['Person'],
-                    mood=auxes[0].feats['Mood'],
-                    aspect=aspect,
-                    form='Fin',
-                    voice=head_node.feats['Voice'],
-                    expl=expl,
-                    ords=phrase_ords)
                 
         elif len(auxes) == 2:
             # Portuguese

From e8a1d91bbe139789e2a0eb099468fc5300dc92ea Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Thu, 11 Sep 2025 20:46:24 +0200
Subject: [PATCH 1284/1374] Extend Romance block to support Italian

---
 udapi/block/msf/romance/romance.py | 59 ++++++++++++++++++++++++------
 1 file changed, 47 insertions(+), 12 deletions(-)

diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
index b2441364..fee863c5 100644
--- a/udapi/block/msf/romance/romance.py
+++ b/udapi/block/msf/romance/romance.py
@@ -2,8 +2,8 @@
 import udapi.block.msf.phrase
 from enum import Enum
 
-AUXES_HAVE = ['ter', 'haber']
-AUXES_BE = ['estar']
+AUXES_HAVE = ['ter', 'haber', 'avere']
+AUXES_BE = ['estar', 'essere']
 
 class Aspect(str, Enum):
     IMP = 'Imp'
@@ -44,7 +44,7 @@ def process_node(self, node):
                 self.process_copulas(node,cop,auxes,refl,expl)
             return
 
-        if node.upos == 'VERB': #TODO maybe add 'or node.feats['VerbForm'] == 'Part'?
+        if node.upos == 'VERB': #TODO maybe add "or node.feats['VerbForm'] == 'Part'"?
             auxes = [x for x in node.children if x.udeprel == 'aux']
             aux_pass = [x for x in node.children if x.deprel == 'aux:pass']
             auxes_without_pass = [x for x in node.children if x.udeprel == 'aux' and x.deprel != 'aux:pass']
@@ -76,6 +76,11 @@ def process_node(self, node):
                     # Spanish
                     # presente -> PhraseTense=Pres, PhraseAspect=''
                     # futuro simple -> PhraseTense=Fut, PhraseAspect=''
+
+                    # Italian
+                    # presente -> PhraseTense=Pres, PhraseAspect=''
+                    # futuro semplice -> PhraseTense=Fut, PhraseAspect=''
+
                     aspect = ''
                     tense = node.feats['Tense']
 
@@ -86,6 +91,9 @@ def process_node(self, node):
 
                         # Spanish
                         # pretérito imperfecto -> PhraseTense=Past, PhraseAspect=Imp
+
+                        # Italian
+                        # imperfetto -> PhraseTense=Past, PhraseAspect=Imp
                         if node.feats['Tense'] == 'Imp':
                             tense=Tense.PAST.value
                             aspect=Aspect.IMP.value
@@ -95,6 +103,9 @@ def process_node(self, node):
 
                         # Spanish
                         # pretérito perfecto -> PhraseTense=Past, PhraseAspect=Perf
+
+                        # Italian
+                        # pass remoto -> PhraseTense=Past, PhraseAspect=Perf
                         if node.feats['Tense'] == 'Past':
                             aspect=Aspect.PERF.value
 
@@ -111,12 +122,22 @@ def process_node(self, node):
                     # Spanish
                     # subjunctive presente -> PhraseTense=Pres, PhraseAspect=''
                     # subjunctive futuro -> PhraseTense=Fut, PhraseAspect='' TODO not annotated in treebanks?
+
+                    # Italian
+                    # Congiuntivo presente -> PhraseTense=Pres, PhraseAspect=''
                     if node.feats['Mood'] == 'Sub':
 
                         if node.feats['Tense'] == 'Past':
                             aspect=Aspect.IMP.value
 
+                        # Portuguese
                         # subjunctive pretérito imperfeito -> PhraseTense=Past, PhraseAspect=Imp
+
+                        # Spanish
+                        # Pretérito imperfecto -> PhraseTense=Past, PhraseAspect=Imp
+
+                        # Italian
+                        # Congiuntivo imperfetto -> PhraseTense=Past, PhraseAspect=Imp
                         if node.feats['Tense']  == 'Imp':
                             tense=Tense.PAST.value
                             aspect=Aspect.IMP.value
@@ -126,6 +147,9 @@ def process_node(self, node):
 
                     # Spanish
                     # pospretérito (cnd) -> PhraseTense=Pres, PhraseAspect='', PhraseMood=Cnd
+
+                    # Italian
+                    # Condizionale presente -> PhraseTense=Pres, PhraseAspect='', PhraseMood=Cnd
                     if node.feats['Mood'] == 'Cnd':
                         aspect=''
                         tense=Tense.PRES.value
@@ -206,6 +230,9 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
 
                 # Spanish
                 # Antepospretérito -> PhraseTense=Past, PhraseAspect='', PhraseMood=Cnd
+
+                # Italian
+                # Condizionale passato -> PhraseTense=Past, PhraseAspect='', PhraseMood=Cnd
                 else:
                     tense=Tense.PAST.value
                     aspect=''
@@ -329,7 +356,7 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                 
                 return
 
-            # Auxiliary 'ter' / 'haber' followed by a participle
+            # Auxiliary 'ter' / 'haber' / 'avere' / 'essere' followed by a participle
             if node.feats['VerbForm'] == 'Part':
                 phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
                 phrase_ords.sort()
@@ -339,21 +366,26 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
 
                 # Spanish
                 # Futuro compuesto antefuturo -> PhraseTense=Fut, PhraseAspect=Perf
+
+                # Italian
+                # Futuro anteriore -> PhraseTense=Fut, PhraseAspect=Perf
                 aspect=Aspect.PERF.value
                 tense=auxes[0].feats['Tense']
 
-                # Portuguese
-                # pretérito perfeito composto (aux ter) -> PhraseTense=PastPres, PhraseAspect=Perf
-                # subjonctive pretérito perfeito composto (aux ter) -> PhraseTense=PastPres, PhraseAspect=Perf, PhraseMood=Sub
+                # Spanish
+                # Pretérito perfecto compuesto ante presente -> PhraseTense=Past, PhraseAspect=Perf
 
+                # Italian
+                # Passato prossimo (aux avere/essere) -> PhraseTense=Past, PhraseAspect=Perf
                 if auxes[0].feats['Tense'] == 'Pres':
 
-                    # Spanish
-                    # Pretérito perfecto compuesto ante presente -> PhraseTense=Past, PhraseAspect=Perf
-                    if auxes[0].lemma == 'haber' and auxes[0].feats['Mood'] != 'Sub':
-                        tense = Tense.PAST.value
+                    # Portuguese
+                    # pretérito perfeito composto (aux ter) -> PhraseTense=PastPres, PhraseAspect=Perf
+                    # subjonctive pretérito perfeito composto (aux ter) -> PhraseTense=PastPres, PhraseAspect=Perf, PhraseMood=Sub
+                    if auxes[0].lemma == 'ter' or auxes[0].feats['Mood'] == 'Sub':
+                        tense = Tense.PASTPRES.value
                     else:
-                        tense=Tense.PASTPRES.value
+                        tense=Tense.PAST.value
 
                 # Portuguese
                 # pretérito mais que perfeito composto (aux ter) -> PhraseTense=Past, PhraseAspect=Pqp
@@ -361,6 +393,9 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
 
                 # Spanish
                 # pretérito pluscuamperfecto -> PhraseTense=Past, PhraseAspect=Pqp
+
+                # Italian
+                # Trapassato prossimo -> PhraseTense=Past, PhraseAspect=Pqp
                 elif auxes[0].feats['Tense'] in ['Imp', 'Past']: # TODO prej neni v Past, jenom Imp
                     tense=Tense.PAST.value
                     aspect=Aspect.PQP.value

From 1d7152d4be17e39b73fca57f1e231c77ea920614 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Fri, 12 Sep 2025 22:13:43 +0200
Subject: [PATCH 1285/1374] Add modal verbs detection

---
 udapi/block/msf/romance/romance.py | 316 +++++++++++++++++------------
 1 file changed, 190 insertions(+), 126 deletions(-)

diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
index fee863c5..6a0a6cd9 100644
--- a/udapi/block/msf/romance/romance.py
+++ b/udapi/block/msf/romance/romance.py
@@ -1,9 +1,10 @@
-
 import udapi.block.msf.phrase
 from enum import Enum
 
 AUXES_HAVE = ['ter', 'haber', 'avere']
 AUXES_BE = ['estar', 'essere']
+MODALS = ['poder', 'deber', 'querer', 'saber', # Spanish + Portuguese
+          'potere', 'dovere', 'volere', 'sapere'] # Italian
 
 class Aspect(str, Enum):
     IMP = 'Imp'
@@ -28,7 +29,7 @@ def process_node(self, node):
         cop = [x for x in node.children if x.udeprel == 'cop']
         
         # only expl or expl:pv, no expl:impers or expl:pass
-        refl = [x for x in node.children if x.lemma == 'se' and x.upos == 'PRON' and x.udeprel == 'expl' and x.udeprel != 'expl:impers' and x.udeprel != 'expl:pass']
+        refl = [x for x in node.children if x.lemma == 'se' and x.upos == 'PRON' and x.udeprel == 'expl' and x.deprel != 'expl:impers' and x.deprel != 'expl:pass']
         
         if refl:
             expl='Pv'
@@ -36,7 +37,13 @@ def process_node(self, node):
             expl=None
    
         if cop:
-            auxes = [x for x in node.children if x.udeprel == 'aux']
+            # find auxiliary verbs, modal verbs, and auxiliary verbs related to modal verbs among the children of the content verb and separate them from each other 
+            auxes, modals, modal_auxes = self.find_auxes(node)
+
+            if modals:
+                # we consider modals themselves to be separate verb forms
+                self.process_modal_verbs(modals, modal_auxes)
+
             if auxes:
                 self.process_periphrastic_verb_forms(cop[0], auxes, refl, auxes + cop, node)
             else:
@@ -45,9 +52,11 @@ def process_node(self, node):
             return
 
         if node.upos == 'VERB': #TODO maybe add "or node.feats['VerbForm'] == 'Part'"?
-            auxes = [x for x in node.children if x.udeprel == 'aux']
-            aux_pass = [x for x in node.children if x.deprel == 'aux:pass']
-            auxes_without_pass = [x for x in node.children if x.udeprel == 'aux' and x.deprel != 'aux:pass']
+
+            # find auxiliary verbs, modal verbs, and auxiliary verbs related to modals among the children of the content verb and separate them from each other 
+            auxes, modals, modal_auxes = self.find_auxes(node)
+            aux_pass = [x for x in auxes if x.deprel == 'aux:pass']
+            auxes_without_pass = [x for x in auxes if x.deprel != 'aux:pass']
 
             # infinitive with a subject is a subjunctive
             subj = [x for x in node.children if x.udeprel == 'subj']
@@ -65,147 +74,202 @@ def process_node(self, node):
                     )
                 return
             
+            if modals:
+                # we consider modals themselves to be separate verb forms
+                self.process_modal_verbs(modals, modal_auxes)
+            
             if not auxes:
-                    phrase_ords = [node.ord] + [r.ord for r in refl]
+                phrase_ords = [node.ord] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                self.process_simple_verb_forms(node, expl, phrase_ords, node)
+
+
+            else:
+                # no passive auxiliaries
+                if not aux_pass:
+                    self.process_periphrastic_verb_forms(node, auxes, refl, auxes, node)
+
+                # head verb has only passive auxiliary and no more other auxiliaries
+                elif not auxes_without_pass:
+                    phrase_ords = [node.ord] + [x.ord for x in auxes] + [r.ord for r in refl]
                     phrase_ords.sort()
 
-                    # Portuguese
-                    # presente -> PhraseTense=Pres, PhraseAspect=''
-                    # Futuro do presente -> PhraseTense=Fut, PhraseAspect=''
-
-                    # Spanish
-                    # presente -> PhraseTense=Pres, PhraseAspect=''
-                    # futuro simple -> PhraseTense=Fut, PhraseAspect=''
-
-                    # Italian
-                    # presente -> PhraseTense=Pres, PhraseAspect=''
-                    # futuro semplice -> PhraseTense=Fut, PhraseAspect=''
-
-                    aspect = ''
-                    tense = node.feats['Tense']
-
-                    if node.feats['Mood'] == 'Ind':
-                        
-                        # Portuguese
-                        # pretérito imperfeito -> PhraseTense=Past, PhraseAspect=Imp
-
-                        # Spanish
-                        # pretérito imperfecto -> PhraseTense=Past, PhraseAspect=Imp
-
-                        # Italian
-                        # imperfetto -> PhraseTense=Past, PhraseAspect=Imp
-                        if node.feats['Tense'] == 'Imp':
-                            tense=Tense.PAST.value
-                            aspect=Aspect.IMP.value
-
-                        # Portuguese
-                        # pretérito perfeito -> PhraseTense=Past, PhraseAspect=Perf
-
-                        # Spanish
-                        # pretérito perfecto -> PhraseTense=Past, PhraseAspect=Perf
-
-                        # Italian
-                        # pass remoto -> PhraseTense=Past, PhraseAspect=Perf
-                        if node.feats['Tense'] == 'Past':
-                            aspect=Aspect.PERF.value
-
-                        # Portuguese
-                        # pretérito mais que perfeito simples -> PhraseTense=Past, PhraseAspect=Pqp
-                        if node.feats['Tense'] == 'Pqp':
-                            tense=Tense.PAST.value
-                            aspect=Aspect.PQP.value
-                            
-                    # Portuguese
-                    # subjunctive presente -> PhraseTense=Pres, PhraseAspect=''
-                    # subjunctive futuro -> PhraseTense=Fut, PhraseAspect=''
+                    # TODO phrase-level features are currently determined based on the first passive auxiliary, but it can happen that there are more than one passive auxiliary
+                    self.process_simple_verb_forms(auxes[0], expl, phrase_ords, node)
 
-                    # Spanish
-                    # subjunctive presente -> PhraseTense=Pres, PhraseAspect=''
-                    # subjunctive futuro -> PhraseTense=Fut, PhraseAspect='' TODO not annotated in treebanks?
+                # head verb has passive auxiliary and also other auxiliaries
+                else:
+                    self.process_periphrastic_verb_forms(aux_pass[0], auxes_without_pass, refl, auxes, node)
 
-                    # Italian
-                    # Congiuntivo presente -> PhraseTense=Pres, PhraseAspect=''
-                    if node.feats['Mood'] == 'Sub':
+    def find_auxes(self, node):
+        """
+        Find all auxiliaries among node.children and classifies them.
 
-                        if node.feats['Tense'] == 'Past':
-                            aspect=Aspect.IMP.value
+        Parameters:
+            node (udapi.core.node.Node): head word, look for auxiliaries in its children
 
-                        # Portuguese
-                        # subjunctive pretérito imperfeito -> PhraseTense=Past, PhraseAspect=Imp
+        Returns:
+            tuple: a classification of auxiliaries consisting of:
+                - auxiliaries directly modifying the node,
+                - modal verbs,
+                - auxiliaries modifying a modal verb.
+        """
 
-                        # Spanish
-                        # Pretérito imperfecto -> PhraseTense=Past, PhraseAspect=Imp
+        node_auxes = []
+        modals = []
+        modal_auxes = []
 
-                        # Italian
-                        # Congiuntivo imperfetto -> PhraseTense=Past, PhraseAspect=Imp
-                        if node.feats['Tense']  == 'Imp':
-                            tense=Tense.PAST.value
-                            aspect=Aspect.IMP.value
+        for child in node.children:
+            if child.udeprel == 'aux':
+                if child.lemma in MODALS:
+                    modals.append(child)
+                    modal_auxes = node_auxes # auxiliaries found so far are assumed to modify the modal verb (they come before it)
+                    node_auxes = []
+                else:
+                    node_auxes.append(child)
 
-                    # Portuguese
-                    # Futuro do pretérito (cnd) -> PhraseTense=Pres, PhraseAspect='', PhraseMood=Cnd
+        return node_auxes, modals, modal_auxes
+    
+    def process_modal_verbs(self, modals, modal_auxes):
+        """
+        Annotates modal verb forms with the Phrase* attributes.
+        The modal verbs are kept as a single verb form, without including the infinitive of the content word.
 
-                    # Spanish
-                    # pospretérito (cnd) -> PhraseTense=Pres, PhraseAspect='', PhraseMood=Cnd
+        Parameters:
+            modals (list): all modal verbs among the children of the head content verb (currently assumes there is only one.)
+            modal_auxes (list): auxiliaries of the modal verb(s)
+        
+        """
 
-                    # Italian
-                    # Condizionale presente -> PhraseTense=Pres, PhraseAspect='', PhraseMood=Cnd
-                    if node.feats['Mood'] == 'Cnd':
-                        aspect=''
-                        tense=Tense.PRES.value
+        if not modal_auxes:
+            self.process_simple_verb_forms(modals[0], '', [modals[0].ord], modals[0]) 
 
-                    
-                    self.write_node_info(node,
-                        person=node.feats['Person'],
-                        aspect=aspect,
-                        number=node.feats['Number'],
-                        mood=node.feats['Mood'],
-                        form=node.feats['VerbForm'],
-                        tense=tense,
-                        gender=node.feats['Gender'],
-                        voice=node.feats['Voice'],
-                        expl=expl,
-                        ords=phrase_ords
-                    )
+        else:
+            self.process_periphrastic_verb_forms(modals[0], modal_auxes, [], modal_auxes, modals[0])
 
 
-            else:
-                # no passive auxiliaries
-                if not aux_pass:
-                    self.process_periphrastic_verb_forms(node, auxes, refl, auxes, node)
+    def process_simple_verb_forms(self, node, expl, phrase_ords, head_node):
+        """
+        Annotate simple verb forms or passive verb forms that contain only a passive auxiliary.
 
-                # head verb has one passive auxiliary and no more other auxiliaries
-                # TODO complete the tenses and aspects for individual verb forms
-                elif not auxes_without_pass:
-                    phrase_ords = [node.ord] + [x.ord for x in auxes] + [r.ord for r in refl]
-                    phrase_ords.sort()
+        Parameters
+            node (udapi.core.node.Node): The relevant node. If there is no passive construction, this is the head verb. If the head verb is passive, this is the passive auxiliary.
+            expl (str): The value of the PhraseExpl attribute.
+            phrase_ords (list[int]): The ord values of all member words of the verb form.
+            head_node (udapi.core.node.Node): The node that should receive the Phrase* attributes, i.e., the head of the phrase.
+        """
 
-                    self.write_node_info(node,
-                        person=aux_pass[0].feats['Person'],
-                        number=aux_pass[0].feats['Number'],
-                        mood=aux_pass[0].feats['Mood'],
-                        form='Fin',
-                        tense=aux_pass[0].feats['Tense'],
-                        gender=node.feats['Gender'],
-                        voice='Pass',
-                        expl=expl,
-                        ords=phrase_ords
-                    )
+        # Portuguese
+        # presente -> PhraseTense=Pres, PhraseAspect=''
+        # Futuro do presente -> PhraseTense=Fut, PhraseAspect=''
+
+        # Spanish
+        # presente -> PhraseTense=Pres, PhraseAspect=''
+        # futuro simple -> PhraseTense=Fut, PhraseAspect=''
+
+        # Italian
+        # presente -> PhraseTense=Pres, PhraseAspect=''
+        # futuro semplice -> PhraseTense=Fut, PhraseAspect=''
+
+        aspect = ''
+        tense = node.feats['Tense']
+
+        if node.feats['Mood'] == 'Ind':
+            
+            # Portuguese
+            # pretérito imperfeito -> PhraseTense=Past, PhraseAspect=Imp
+
+            # Spanish
+            # pretérito imperfecto -> PhraseTense=Past, PhraseAspect=Imp
+
+            # Italian
+            # imperfetto -> PhraseTense=Past, PhraseAspect=Imp
+            if node.feats['Tense'] == 'Imp':
+                tense=Tense.PAST.value
+                aspect=Aspect.IMP.value
+
+            # Portuguese
+            # pretérito perfeito -> PhraseTense=Past, PhraseAspect=Perf
+
+            # Spanish
+            # pretérito perfecto -> PhraseTense=Past, PhraseAspect=Perf
+
+            # Italian
+            # pass remoto -> PhraseTense=Past, PhraseAspect=Perf
+            if node.feats['Tense'] == 'Past':
+                aspect=Aspect.PERF.value
+
+            # Portuguese
+            # pretérito mais que perfeito simples -> PhraseTense=Past, PhraseAspect=Pqp
+            if node.feats['Tense'] == 'Pqp':
+                tense=Tense.PAST.value
+                aspect=Aspect.PQP.value
+                
+        # Portuguese
+        # subjunctive presente -> PhraseTense=Pres, PhraseAspect=''
+        # subjunctive futuro -> PhraseTense=Fut, PhraseAspect=''
+
+        # Spanish
+        # subjunctive presente -> PhraseTense=Pres, PhraseAspect=''
+        # subjunctive futuro -> PhraseTense=Fut, PhraseAspect='' TODO not annotated in treebanks?
+
+        # Italian
+        # Congiuntivo presente -> PhraseTense=Pres, PhraseAspect=''
+        if node.feats['Mood'] == 'Sub':
+
+            if node.feats['Tense'] == 'Past':
+                aspect=Aspect.IMP.value
+
+            # Portuguese
+            # subjunctive pretérito imperfeito -> PhraseTense=Past, PhraseAspect=Imp
+
+            # Spanish
+            # Pretérito imperfecto -> PhraseTense=Past, PhraseAspect=Imp
+
+            # Italian
+            # Congiuntivo imperfetto -> PhraseTense=Past, PhraseAspect=Imp
+            if node.feats['Tense']  == 'Imp':
+                tense=Tense.PAST.value
+                aspect=Aspect.IMP.value
+
+        # Portuguese
+        # Futuro do pretérito (cnd) -> PhraseTense=Pres, PhraseAspect='', PhraseMood=Cnd
+
+        # Spanish
+        # pospretérito (cnd) -> PhraseTense=Pres, PhraseAspect='', PhraseMood=Cnd
+
+        # Italian
+        # Condizionale presente -> PhraseTense=Pres, PhraseAspect='', PhraseMood=Cnd
+        if node.feats['Mood'] == 'Cnd':
+            aspect=''
+            tense=Tense.PRES.value
+
+        
+        self.write_node_info(head_node,
+            person=node.feats['Person'],
+            aspect=aspect,
+            number=node.feats['Number'],
+            mood=node.feats['Mood'],
+            form=node.feats['VerbForm'],
+            tense=tense,
+            gender=head_node.feats['Gender'],
+            voice=head_node.feats['Voice'],
+            expl=expl,
+            ords=phrase_ords
+        )
 
-                # head verb has passive auxiliary and also other auxiliaries
-                else:
-                    self.process_periphrastic_verb_forms(aux_pass[0], auxes_without_pass, refl, auxes, node)
 
     def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_node):
         """
-        Parameters
-        - node: if there is no passive then the node is the head verb, if the head verb is in the passive, then the node is the passive auxiliary
-        - auxes: list of all auxiliaries except the passive auxes
-        - refl: list of reflexives which should be included into the periphrastic phrase
-        - all_auxes: list of all auxiliaries (passive auxes are included)
-        - head_node: the node which should have the Phrase* attributes, i. e. the head of the phrase
+        Annotate periphrastic verb forms with the Phrase* attributes.
 
-        annotates periphrastic verb forms with the Phrase* attributes
+        Parameters
+            node (udapi.core.node.Node): The relevant node. If there is no passive construction, this is the head verb. If the head verb is passive, this is the passive auxiliary.
+            auxes (list[udapi.core.node.Node]): All auxiliaries except the passive auxiliaries.
+            refl (list[udapi.core.node.Node]): Reflexives that should be included in the periphrastic phrase.
+            all_auxes (list[udapi.core.node.Node]): All auxiliaries, including the passive auxiliaries.
+            head_node (udapi.core.node.Node): The node that should receive the Phrase* attributes, i.e., the head of the phrase.
         """
 
         if refl:
@@ -216,7 +280,7 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
         if len(auxes)  == 1:
             # Cnd
             if auxes[0].feats['Mood'] == 'Cnd' and (node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'Ger'):
-                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl] + [r.ord for r in refl]
+                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
                 phrase_ords.sort()
 
                 # Portuguese

From 0bf7f7aa277480ba35207dcbb8946c588e532186 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 13 Sep 2025 12:14:41 +0200
Subject: [PATCH 1286/1374] Allow gender with set numerals in Czech.

---
 udapi/block/ud/cs/markfeatsbugs.py | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 17570ee2..c83678f8 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -548,13 +548,27 @@ def process_node(self, node):
                     'NumForm': ['Digit', 'Roman']
                 })
             else:
+                if node.feats['NumType'] == 'Sets':
+                    # 'jedny', 'dvoje', 'troje', 'čtvery'
+                    # Number should perhaps be only Plur because the counted noun will be Plur.
+                    # Gender is not annotated in PDT but there are different forms ('jedni' vs. 'jedny',
+                    # and in Old Czech also 'dvoji' vs. 'dvoje'), so we should allow Gender (and Animacy).
+                    self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'NumType': ['Sets'],
+                        'NumForm': ['Word'],
+                        'Gender': ['Masc', 'Fem', 'Neut'],
+                        'Animacy': ['Anim', 'Inan'],
+                        'Number': ['Sing', 'Dual', 'Plur'],
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
                 # 'jeden' has Gender, Animacy, Number, Case: jeden, jedna, jedno, jednoho, jednomu, jednom, jedním, jedné, jednu, jednou, jedni, jedny, jedněch, jedněm, jedněmi.
                 # 'dva', 'oba' have Gender, Number=Dual(Plur in modern Czech), Case: dva, dvě, dvou, dvěma.
                 # 'tři', 'čtyři' have Number=Plur, Case: tři, třech, třem, třemi.
                 # 'pět' and more have Number=Plur, Case: pět, pěti.
                 # 'půl' has no Number and Case, although it behaves syntactically similarly to 'pět' (but genitive is still 'půl', not '*půli').
                 # 'sto', 'tisíc', 'milión', 'miliarda' etc. have Gender (+ possibly Animacy) and Number (depending on their form).
-                if node.lemma == 'jeden':
+                elif node.lemma == 'jeden':
                     self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
                     self.check_allowed_features(node, {
                         'NumType': ['Card'],
@@ -594,7 +608,7 @@ def process_node(self, node):
                 elif re.match(r'^(sto|tisíc|.+ili[oó]n|.+iliarda)$', node.lemma):
                     self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
                     self.check_allowed_features(node, {
-                        'NumType': ['Card', 'Sets'],
+                        'NumType': ['Card'],
                         'NumForm': ['Word'],
                         'Gender': ['Masc', 'Fem', 'Neut'],
                         'Animacy': ['Anim', 'Inan'],
@@ -610,7 +624,7 @@ def process_node(self, node):
                     # On the other hand, we may want to allow Dual for "stě".
                     self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
                     self.check_allowed_features(node, {
-                        'NumType': ['Card', 'Sets'],
+                        'NumType': ['Card'],
                         'NumForm': ['Word'],
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']

From 626dbf73dfee7c886e1ca62bbb665f04f2e57a8a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 13 Sep 2025 13:12:28 +0200
Subject: [PATCH 1287/1374] cos, cosi

---
 udapi/block/ud/cs/markfeatsbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index c83678f8..d353a127 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -281,7 +281,7 @@ def process_node(self, node):
                     'Animacy': ['Anim'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Loc', 'Ins']
                 })
-            elif re.match(r'^(co|což|což?koliv?|něco|lečco|lecco|nic|nicož)$', node.lemma):
+            elif re.match(r'^(co(si?)?|což|což?koliv?|něco|lečco|lecco|nic|nicož)$', node.lemma):
                 # Although these pronouns behave by default as neuter singular,
                 # no Gender and Number is annotated. However, quite unusually,
                 # there is Animacy=Inan without Gender.

From 2e10a33ffccd90e542715f4e2fd0a247d26e4146 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 13 Sep 2025 19:15:27 +0200
Subject: [PATCH 1288/1374] Some notes.

---
 tutorial/udapi-tutorial-dz.odt | Bin 258529 -> 259128 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/tutorial/udapi-tutorial-dz.odt b/tutorial/udapi-tutorial-dz.odt
index a954e9f3441b094b7fcd37ea1d91b89be93eb12b..9590a314d6a77d3f594769c7a2363636d2037ce3 100644
GIT binary patch
delta 55065
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
aYt#OB&*J<G<?an@KL*lZtnUHu+W!NhuxP#j

delta 54419
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


From 78dfb79e030f69e0b5f2c951934918fc5eb9adfd Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Tue, 16 Sep 2025 19:16:35 +0200
Subject: [PATCH 1289/1374] Improve copula processing

---
 udapi/block/msf/romance/romance.py | 71 ++++++++++--------------------
 1 file changed, 23 insertions(+), 48 deletions(-)

diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
index 6a0a6cd9..393e79f7 100644
--- a/udapi/block/msf/romance/romance.py
+++ b/udapi/block/msf/romance/romance.py
@@ -48,7 +48,7 @@ def process_node(self, node):
                 self.process_periphrastic_verb_forms(cop[0], auxes, refl, auxes + cop, node)
             else:
                 # no auxiliaries, only cop
-                self.process_copulas(node,cop,auxes,refl,expl)
+                self.process_copulas(node,cop,refl,expl)
             return
 
         if node.upos == 'VERB': #TODO maybe add "or node.feats['VerbForm'] == 'Part'"?
@@ -626,54 +626,29 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                 )
                 return
                 
-    def process_copulas(self, node, cop, auxes, refl, expl):
-
-        aspect = ''
-        
-        if not auxes:
-            tense = cop[0].feats['Tense']
-            number=cop[0].feats['Number']
-            person=cop[0].feats['Person']
-            mood=cop[0].feats['Mood']
-
-            if cop[0].feats['Tense'] in ['Pres', 'Fut']:
-                if cop[0].lemma == 'ser':
-                    aspect=Aspect.PERF.value
-                elif cop[0].lemma == 'estar':
-                    aspect=Aspect.IMP.value
-            
-            elif cop[0].feats['Tense'] == 'Imp':
-                tense=Tense.PAST.value
-                aspect=Aspect.IMP.value
-            
-            elif cop[0].feats['Tense'] == 'Past':
-                aspect=Aspect.PERF.value
-            else:
-                # i.e. copulas in infinitive
-                aspect=''
+    def process_copulas(self, node, cop, refl, expl):
+        """
+        Annotate non-verbal predicates with copula using the Phrase* attributes.
 
-        else: 
-            tense = auxes[0].feats['Tense']
-            number=auxes[0].feats['Number']
-            person=auxes[0].feats['Person']
-            mood=auxes[0].feats['Mood']
-            aspect=''
+        This method is specialized for non-periphrastic copulas. 
+        If any auxiliaries are present, process_periphrastic_verb_forms() is called instead.
 
-            
-            if auxes[0].lemma == 'estar': 
-                aspect=Aspect.IMPPROG.value
+        Parameters
+            node (udapi.core.node.Node): The non-verbal predicate that should receive the Phrase* attributes, i.e., the head of the phrase.
+            cop (list[udapi.core.node.Node]): The copula nodes.
+            refl (list[udapi.core.node.Node]): Reflexives that should be included in the periphrastic phrase.
+            expl (str): The value of the PhraseExpl attribute.
+        """
 
-        phrase_ords = [node.ord] + [x.ord for x in cop] + [x.ord for x in auxes] + [r.ord for r in refl]
+        phrase_ords = [node.ord] + [x.ord for x in cop] + [r.ord for r in refl]
         phrase_ords.sort()
-      
-        self.write_node_info(node,
-                    tense=tense,
-                    number=number,
-                    person=person,
-                    mood=mood,
-                    form='Fin',
-                    aspect=aspect,
-                    voice=node.feats['Voice'],
-                    expl=expl,
-                    ords=phrase_ords,
-                )
+
+        # classify the morphological features of the copula node and propagate them to the entire phrase (treating the copula as the content verb)
+        self.process_simple_verb_forms(cop[0], expl, phrase_ords, node)
+
+        # adjust PhraseAspect based on the lemma of the copula
+        if cop[0].feats['Tense'] in ['Pres', 'Fut']:
+            if cop[0].lemma == 'ser':
+                node.misc['PhraseAspect'] = Aspect.PERF.value
+            elif cop[0].lemma == 'estar':
+                node.misc['PhraseAspect'] = Aspect.IMP.value

From 57409cf562219ed3c44580b9fd764ed2f00b9292 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Fri, 19 Sep 2025 12:32:09 +0200
Subject: [PATCH 1290/1374] Add negation detection

---
 udapi/block/msf/romance/romance.py | 184 ++++++++++++++++++++---------
 1 file changed, 129 insertions(+), 55 deletions(-)

diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
index 393e79f7..81041e55 100644
--- a/udapi/block/msf/romance/romance.py
+++ b/udapi/block/msf/romance/romance.py
@@ -24,6 +24,14 @@ class Tense(str, Enum):
 
 class Romance(udapi.block.msf.phrase.Phrase):
 
+    def __init__(self, neg=True, **kwargs):
+        """
+        Parameters:
+        neg (bool) - If True, process negation and generate the PhrasePolarity=Neg attribute.
+        """
+        super().__init__(**kwargs)
+        self.neg = neg
+
     def process_node(self, node):
 
         cop = [x for x in node.children if x.udeprel == 'cop']
@@ -38,23 +46,42 @@ def process_node(self, node):
    
         if cop:
             # find auxiliary verbs, modal verbs, and auxiliary verbs related to modal verbs among the children of the content verb and separate them from each other 
-            auxes, modals, modal_auxes = self.find_auxes(node)
+            auxes, neg, modals, modal_auxes, modal_neg = self.find_auxes_and_neg(node)
+            adp = [x for x in node.children if x.upos == 'ADP']
 
             if modals:
                 # we consider modals themselves to be separate verb forms
-                self.process_modal_verbs(modals, modal_auxes)
+                self.process_modal_verbs(modals, modal_auxes, modal_neg)
 
             if auxes:
-                self.process_periphrastic_verb_forms(cop[0], auxes, refl, auxes + cop, node)
+                polarity = ''
+                if self.neg is True:
+                    phrase_ords = [node.ord] + [c.ord for c in cop] + [a.ord for a in auxes] + [r.ord for r in refl] + [a.ord for a in adp] + [n.ord for n in neg] 
+                    if neg:
+                        polarity = 'Neg'
+                else:
+                    phrase_ords = [node.ord] + [c.ord for c in cop] + [a.ord for a in auxes] + [a.ord for a in adp] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                self.process_periphrastic_verb_forms(cop[0], auxes, expl, polarity, phrase_ords, node)
             else:
                 # no auxiliaries, only cop
-                self.process_copulas(node,cop,refl,expl)
+                polarity = ''
+                if self.neg is True:
+                    phrase_ords = [node.ord] + [c.ord for c in cop] + [r.ord for r in refl] + [a.ord for a in adp] + [n.ord for n in neg]
+                    if neg:
+                        polarity = 'Neg'
+                else:
+                    phrase_ords = [node.ord] + [c.ord for c in cop] + [a.ord for a in adp] + [r.ord for r in refl]
+                phrase_ords.sort()
+
+                self.process_copulas(node, cop, expl, polarity, phrase_ords)
             return
 
         if node.upos == 'VERB': #TODO maybe add "or node.feats['VerbForm'] == 'Part'"?
 
             # find auxiliary verbs, modal verbs, and auxiliary verbs related to modals among the children of the content verb and separate them from each other 
-            auxes, modals, modal_auxes = self.find_auxes(node)
+            auxes, neg, modals, modal_auxes, modal_neg = self.find_auxes_and_neg(node)
             aux_pass = [x for x in auxes if x.deprel == 'aux:pass']
             auxes_without_pass = [x for x in auxes if x.deprel != 'aux:pass']
 
@@ -76,35 +103,67 @@ def process_node(self, node):
             
             if modals:
                 # we consider modals themselves to be separate verb forms
-                self.process_modal_verbs(modals, modal_auxes)
+                self.process_modal_verbs(modals, modal_auxes, modal_neg)
             
             if not auxes:
-                phrase_ords = [node.ord] + [r.ord for r in refl]
+                polarity = ''
+                if self.neg is True:
+                    phrase_ords = [node.ord] + [r.ord for r in refl] + [n.ord for n in neg]
+                    if neg:
+                        polarity = 'Neg'
+                else:
+                    phrase_ords = [node.ord] + [r.ord for r in refl]
                 phrase_ords.sort()
 
-                self.process_simple_verb_forms(node, expl, phrase_ords, node)
+                self.process_simple_verb_forms(node, expl, polarity, phrase_ords, node)
 
 
             else:
                 # no passive auxiliaries
                 if not aux_pass:
-                    self.process_periphrastic_verb_forms(node, auxes, refl, auxes, node)
+                    polarity = ''
+                    if self.neg is True:
+                        phrase_ords = [node.ord] + [a.ord for a in auxes] + [r.ord for r in refl] + [n.ord for n in neg]
+                        if neg:
+                            polarity = 'Neg'
+                    else:
+                        phrase_ords = [node.ord] + [a.ord for a in auxes] + [r.ord for r in refl]
+                    phrase_ords.sort()
+
+                    self.process_periphrastic_verb_forms(node, auxes, expl, polarity, phrase_ords, node)
 
                 # head verb has only passive auxiliary and no more other auxiliaries
                 elif not auxes_without_pass:
-                    phrase_ords = [node.ord] + [x.ord for x in auxes] + [r.ord for r in refl]
+                    polarity = ''
+
+                    if self.neg is True:
+                        phrase_ords = [node.ord] + [a.ord for a in auxes] + [r.ord for r in refl] + [n.ord for n in neg]
+                        if neg:
+                            polarity = 'Neg'
+                    else:
+                        phrase_ords = [node.ord] + [a.ord for a in auxes] + [r.ord for r in refl]
                     phrase_ords.sort()
 
                     # TODO phrase-level features are currently determined based on the first passive auxiliary, but it can happen that there are more than one passive auxiliary
-                    self.process_simple_verb_forms(auxes[0], expl, phrase_ords, node)
+                    self.process_simple_verb_forms(auxes[0], expl, polarity, phrase_ords, node)
 
                 # head verb has passive auxiliary and also other auxiliaries
                 else:
-                    self.process_periphrastic_verb_forms(aux_pass[0], auxes_without_pass, refl, auxes, node)
+                    polarity = ''
 
-    def find_auxes(self, node):
+                    if self.neg is True:
+                        phrase_ords = [node.ord] + [a.ord for a in auxes] + [r.ord for r in refl] + [n.ord for n in neg]
+                        if neg:
+                            polarity = 'Neg'
+                    else:
+                        phrase_ords = [node.ord] + [a.ord for a in auxes] + [r.ord for r in refl]
+                    phrase_ords.sort()
+
+                    self.process_periphrastic_verb_forms(aux_pass[0], auxes_without_pass, expl, polarity, phrase_ords, node)
+
+    def find_auxes_and_neg(self, node):
         """
-        Find all auxiliaries among node.children and classifies them.
+        Find all auxiliaries and negative adverbials among node.children and classifies them.
 
         Parameters:
             node (udapi.core.node.Node): head word, look for auxiliaries in its children
@@ -112,13 +171,17 @@ def find_auxes(self, node):
         Returns:
             tuple: a classification of auxiliaries consisting of:
                 - auxiliaries directly modifying the node,
+                - negative adverbs modifying the node,
                 - modal verbs,
-                - auxiliaries modifying a modal verb.
+                - auxiliaries modifying a modal verb,
+                - negative adverbs modifying a modal verb.
         """
 
         node_auxes = []
+        node_neg = []
         modals = []
         modal_auxes = []
+        modal_neg = []
 
         for child in node.children:
             if child.udeprel == 'aux':
@@ -126,12 +189,19 @@ def find_auxes(self, node):
                     modals.append(child)
                     modal_auxes = node_auxes # auxiliaries found so far are assumed to modify the modal verb (they come before it)
                     node_auxes = []
+
+                    modal_neg = node_neg
+                    node_neg = []
+
                 else:
                     node_auxes.append(child)
 
-        return node_auxes, modals, modal_auxes
+            elif child.upos == 'ADV' and child.feats['Polarity'] == 'Neg':
+                node_neg.append(child)
+
+        return node_auxes, node_neg, modals, modal_auxes, modal_neg
     
-    def process_modal_verbs(self, modals, modal_auxes):
+    def process_modal_verbs(self, modals, modal_auxes, modal_neg):
         """
         Annotates modal verb forms with the Phrase* attributes.
         The modal verbs are kept as a single verb form, without including the infinitive of the content word.
@@ -139,23 +209,42 @@ def process_modal_verbs(self, modals, modal_auxes):
         Parameters:
             modals (list): all modal verbs among the children of the head content verb (currently assumes there is only one.)
             modal_auxes (list): auxiliaries of the modal verb(s)
+            modal_neg (list): negative adverbs of the modal verb(s)
         
         """
-
         if not modal_auxes:
-            self.process_simple_verb_forms(modals[0], '', [modals[0].ord], modals[0]) 
+            polarity = ''
+            if self.neg is True:
+                phrase_ords = [modals[0].ord] + [n.ord for n in modal_neg]
+                phrase_ords.sort()
+
+                if modal_neg:
+                    polarity='Neg'
+            else:
+                phrase_ords = [modals[0].ord]
+            self.process_simple_verb_forms(modals[0], '', polarity, phrase_ords, modals[0]) 
 
         else:
-            self.process_periphrastic_verb_forms(modals[0], modal_auxes, [], modal_auxes, modals[0])
+            polarity = ''
+            if self.neg is True:
+                phrase_ords = [modals[0].ord] + [a.ord for a in modal_auxes] + [n.ord for n in modal_neg]
+                if modal_neg:
+                    polarity='Neg'
+            else:
+                phrase_ords = [modals[0].ord] + [a.ord for a in modal_auxes]
+            phrase_ords.sort()
+
+            self.process_periphrastic_verb_forms(modals[0], modal_auxes, '', polarity, phrase_ords, modals[0])
 
 
-    def process_simple_verb_forms(self, node, expl, phrase_ords, head_node):
+    def process_simple_verb_forms(self, node, expl, polarity, phrase_ords, head_node):
         """
         Annotate simple verb forms or passive verb forms that contain only a passive auxiliary.
 
         Parameters
             node (udapi.core.node.Node): The relevant node. If there is no passive construction, this is the head verb. If the head verb is passive, this is the passive auxiliary.
             expl (str): The value of the PhraseExpl attribute.
+            polarity (str): The value of the PhrasePolarity attribute.
             phrase_ords (list[int]): The ord values of all member words of the verb form.
             head_node (udapi.core.node.Node): The node that should receive the Phrase* attributes, i.e., the head of the phrase.
         """
@@ -256,32 +345,27 @@ def process_simple_verb_forms(self, node, expl, phrase_ords, head_node):
             gender=head_node.feats['Gender'],
             voice=head_node.feats['Voice'],
             expl=expl,
+            polarity=polarity,
             ords=phrase_ords
         )
 
 
-    def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_node):
+    def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_ords, head_node):
         """
         Annotate periphrastic verb forms with the Phrase* attributes.
 
         Parameters
             node (udapi.core.node.Node): The relevant node. If there is no passive construction, this is the head verb. If the head verb is passive, this is the passive auxiliary.
             auxes (list[udapi.core.node.Node]): All auxiliaries except the passive auxiliaries.
-            refl (list[udapi.core.node.Node]): Reflexives that should be included in the periphrastic phrase.
-            all_auxes (list[udapi.core.node.Node]): All auxiliaries, including the passive auxiliaries.
+            expl (str): The value of the PhraseExpl attribute.
+            polarity (str): The value of the PhrasePolarity attribute.
+            phrase_ords (list[int]): The ord values of all member words in the verb form.
             head_node (udapi.core.node.Node): The node that should receive the Phrase* attributes, i.e., the head of the phrase.
         """
 
-        if refl:
-            expl='Pv'
-        else:
-            expl=None
-
         if len(auxes)  == 1:
             # Cnd
             if auxes[0].feats['Mood'] == 'Cnd' and (node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'Ger'):
-                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
-                phrase_ords.sort()
 
                 # Portuguese
                 # aux estar cond + gerund -> PhraseTense=Pres, PhraseAspect=Prog, PhraseMood=Cnd
@@ -309,13 +393,12 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     mood='Cnd',
                     form='Fin',
                     expl=expl,
+                    polarity=polarity,
                     voice=head_node.feats['Voice'],
                     ords=phrase_ords)
                 return
             
             if auxes[0].lemma == 'vir' and auxes[0].feats['Tense'] in ['Pres', 'Imp', 'Past'] and node.feats['VerbForm'] == 'Ger':
-                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
-                phrase_ords.sort()
 
                 # aux Pres (vir) + gerund -> PhraseTense=PastPres, PraseAspect=Prog
                 if auxes[0].feats['Tense'] == 'Pres':
@@ -334,12 +417,11 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     aspect=Aspect.PROG.value,
                     voice=head_node.feats['Voice'],
                     expl=expl,
+                    polarity=polarity,
                     ords=phrase_ords)      
                 return
             
             if auxes[0].lemma == 'ir' and node.feats['VerbForm'] == 'Ger':
-                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
-                phrase_ords.sort()
 
                 # aux Pres (ir) + gerund -> PhraseTense=Pres, PhraseAspect=Prog
                 tense = auxes[0].feats['Tense']
@@ -359,14 +441,13 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     form='Fin',
                     voice=head_node.feats['Voice'],
                     expl=expl,
+                    polarity=polarity,
                     ords=phrase_ords)
                 return
             
             # Portuguese
             # pretérito mais que perfeito composto (aux haver) -> PhraseTense=Past, PhraseAspect=Perf
             if auxes[0].lemma == 'haver' and auxes[0].feats['Tense'] == 'Imp' and node.feats['VerbForm'] == 'Part':
-                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
-                phrase_ords.sort()
 
                 self.write_node_info(head_node,
                     tense=Tense.PAST.value,
@@ -377,13 +458,12 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     form='Fin',
                     voice=head_node.feats['Voice'],
                     expl=expl,
+                    polarity=polarity,
                     ords=phrase_ords)
                 return
                 
             # Auxiliary 'estar' followed by a gerund 
             if node.feats['VerbForm'] == 'Ger':
-                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
-                phrase_ords.sort()
 
                 # Portuguese + Spanish
                 # pretérito imperfeito (aux estar) -> PhraseTense=Past, PhraseAspect=ImpProg
@@ -416,14 +496,13 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     voice=head_node.feats['Voice'],
                     aspect=aspect,
                     expl=expl,
+                    polarity=polarity,
                     ords=phrase_ords)
                 
                 return
 
             # Auxiliary 'ter' / 'haber' / 'avere' / 'essere' followed by a participle
             if node.feats['VerbForm'] == 'Part':
-                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
-                phrase_ords.sort()
 
                 # Portuguese
                 # futuro do presente composto (aux ter) -> PhraseTense=Fut, PhraseAspect=Perf
@@ -473,14 +552,13 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     form='Fin',
                     voice=head_node.feats['Voice'],
                     expl=expl,
+                    polarity=polarity,
                     ords=phrase_ords)
                 return
                 
             # auxiliary 'ir' followed by infinitive
             # TODO solve these verb forms for Spanish (VERB 'ir' + ADP 'a' + infinitive)
             if auxes[0].lemma == 'ir' and node.feats['VerbForm'] == 'Inf':
-                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
-                phrase_ords.sort()
 
                 tense=node.feats['Tense']
                 aspect=''
@@ -514,6 +592,7 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     form='Fin',
                     voice=head_node.feats['Voice'],
                     expl=expl,
+                    polarity=polarity,
                     ords=phrase_ords)
                 
                 
@@ -524,8 +603,6 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
             # TODO Spanish
             # VERB 'ir' + ADP 'a' + AUX 'estar'.Inf + gerund
             if auxes[0].lemma == 'ir' and auxes[1].lemma == 'estar' and node.feats['VerbForm'] == 'Ger':
-                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
-                phrase_ords.sort()
 
                 # Futuro perifrástico -> PhraseTense=Fut, PhraseAspect=Prog
                 if auxes[0].feats['Tense'] == 'Pres':
@@ -555,12 +632,11 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     aspect=aspect,
                     voice=head_node.feats['Voice'],
                     expl=expl,
+                    polarity=polarity,
                     ords=phrase_ords)
 
             # auxiliriy 'ir' in present or future tense followed by auxiliary 'ter' in infinitive and a participle
             if auxes[0].lemma == 'ir' and (auxes[0].feats['Tense'] in ['Pres', 'Fut']) and auxes[1].lemma == 'ter' and node.feats['VerbForm'] == 'Part':
-                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
-                phrase_ords.sort()
 
                 # Futuro perifrástico -> PhraseTense=FutFut, PhraseAspect=Perf
                 if auxes[0].feats['Tense'] == 'Fut':
@@ -581,14 +657,13 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     form='Fin',
                     voice=head_node.feats['Voice'],
                     expl=expl,
+                    polarity=polarity,
                     ords=phrase_ords)    
                 
             
                 
             # Cnd (only ter/haber), Sub and Past,Pres,Fut tenses: 2 auxes - ter/haber + estar
             if auxes[0].lemma in AUXES_HAVE and auxes[1].lemma == 'estar' and node.feats['VerbForm'] == 'Ger':
-                phrase_ords = [head_node.ord] + [x.ord for x in all_auxes] + [r.ord for r in refl]
-                phrase_ords.sort()
 
                 tense = auxes[0].feats['Tense']
                 aspect = Aspect.PERFPROG.value
@@ -622,11 +697,12 @@ def process_periphrastic_verb_forms(self, node, auxes, refl, all_auxes, head_nod
                     aspect=aspect,
                     voice=head_node.feats['Voice'],
                     expl=expl,
+                    polarity=polarity,
                     ords=phrase_ords,
                 )
                 return
                 
-    def process_copulas(self, node, cop, refl, expl):
+    def process_copulas(self, node, cop, expl, polarity, phrase_ords):
         """
         Annotate non-verbal predicates with copula using the Phrase* attributes.
 
@@ -636,15 +712,13 @@ def process_copulas(self, node, cop, refl, expl):
         Parameters
             node (udapi.core.node.Node): The non-verbal predicate that should receive the Phrase* attributes, i.e., the head of the phrase.
             cop (list[udapi.core.node.Node]): The copula nodes.
-            refl (list[udapi.core.node.Node]): Reflexives that should be included in the periphrastic phrase.
             expl (str): The value of the PhraseExpl attribute.
+            polarity (str): The value of the PhrasePolarity attribute.
+            phrase_ords (list[int]): The ord values of all member words in the verb form.
         """
 
-        phrase_ords = [node.ord] + [x.ord for x in cop] + [r.ord for r in refl]
-        phrase_ords.sort()
-
         # classify the morphological features of the copula node and propagate them to the entire phrase (treating the copula as the content verb)
-        self.process_simple_verb_forms(cop[0], expl, phrase_ords, node)
+        self.process_simple_verb_forms(cop[0], expl, polarity, phrase_ords, node)
 
         # adjust PhraseAspect based on the lemma of the copula
         if cop[0].feats['Tense'] in ['Pres', 'Fut']:

From 7447947417d9f41270ced60a0153370c874e5a0b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 3 Oct 2025 16:24:41 +0200
Subject: [PATCH 1291/1374] Make fixedeprels reach empty nodes.

---
 udapi/block/ud/cs/fixedeprels.py | 497 ++++++++++++++++---------------
 1 file changed, 250 insertions(+), 247 deletions(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index bd85e1b4..9416876e 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -336,265 +336,268 @@ def copy_case_from_adposition(self, node, adposition):
         else:
             return None
 
-    def process_node(self, node):
+    def process_tree(self, tree):
         """
         Occasionally the edeprels automatically derived from the Czech basic
         trees do not match the whitelist. For example, the noun is an
         abbreviation and its morphological case is unknown.
+
+        We cannot use the process_node() method because it ignores empty nodes.
         """
-        for edep in node.deps:
-            m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):', edep['deprel'])
-            if m:
-                solved = False
-                # Issues caused by errors in the original annotation must be fixed early.
-                # Especially if acl|advcl occurs with a preposition that unambiguously
-                # receives a morphological case in the subsequent steps, and then gets
-                # flagged as solved.
-                edep['deprel'] = re.sub(r'^advcl:do(?::gen)?$', r'obl:do:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
-                edep['deprel'] = re.sub(r'^advcl:pro(?::acc)?$', r'advcl:aby', edep['deprel']) # byl by pro, abychom... ###!!! Opravit i konverzi stromu.
-                edep['deprel'] = re.sub(r'^advcl:s(?::ins)?$', r'advcl', edep['deprel']) ###!!! "seděli jsme tam s Člověče, nezlob se!" Měla by se opravit konverze stromu.
-                edep['deprel'] = re.sub(r'^acl:k(?::dat)?$', r'acl', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:k(?::dat)?$', r'obl:k:dat', edep['deprel']) ###!!! Ale měli bychom opravit i závislost v základním stromu!
-                edep['deprel'] = re.sub(r'^advcl:místo(?::gen)?$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
-                edep['deprel'] = re.sub(r'^acl:na_způsob(?::gen)?$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
-                edep['deprel'] = re.sub(r'^acl:od(?::gen)?$', r'nmod:od:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:od(?::gen)?$', r'obl:od:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
-                edep['deprel'] = re.sub(r'^advcl:podle(?::gen)?$', r'obl:podle:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:pro(?::acc)?$', r'obl:pro:acc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^acl:v$', r'nmod:v:loc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
-                edep['deprel'] = re.sub(r'^advcl:v_duchu?(?::gen)?$', r'obl:v_duchu:gen', edep['deprel'])
-                edep['deprel'] = re.sub(r'^nmod:když.*$', r'nmod', edep['deprel']) # nadějí když ne na zbohatnutí, tak alespoň na dobrou obživu ###!!! perhaps "když" or "když ne" should be analyzed as "cc" here!
-                edep['deprel'] = re.sub(r'^obl:ačkoli.*$', r'obl', edep['deprel']) # nadějí když ne na zbohatnutí, tak alespoň na dobrou obživu ###!!! perhaps "když" or "když ne" should be analyzed as "cc" here!
-                edep['deprel'] = re.sub(r'^obl:jestli(?::gen)?$', r'obl:gen', edep['deprel']) # nevím, jestli osmého nebo devátého září
-                # Removing 'až' must be done early. The remainder may be 'počátek'
-                # and we will want to convert it to 'počátkem:gen'.
-                edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
-                # If one of the following expressions occurs followed by another preposition
-                # or by morphological case, remove the additional case marking. For example,
-                # 'jako_v' becomes just 'jako'.
-                for x in self.outermost:
-                    exceptions = self.outermost[x]
-                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'([_:].+)?$', edep['deprel'])
-                    if m and m.group(2) and not x+m.group(2) in exceptions:
-                        edep['deprel'] = m.group(1)+':'+x
-                        solved = True
-                        break
-                if solved:
-                    continue
-                for x in self.unambiguous:
-                    # All secondary prepositions have only one fixed morphological case
-                    # they appear with, so we can replace whatever case we encounter with the correct one.
-                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?$', edep['deprel'])
-                    if m:
-                        edep['deprel'] = m.group(1)+':'+self.unambiguous[x]
-                        solved = True
-                        break
-                if solved:
-                    continue
-                # The following prepositions have more than one morphological case
-                # available. Thanks to the Case feature on prepositions, we can
-                # identify the correct one.
-                m = re.match(r'^(obl(?::arg)?|nmod):(mezi|na|nad|o|po|pod|před|v|za)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
+        for node in tree.descendants_and_empty:
+            for edep in node.deps:
+                m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):', edep['deprel'])
                 if m:
-                    adpcase = self.copy_case_from_adposition(node, m.group(2))
-                    if adpcase and not re.search(r':(nom|gen|dat|voc)$', adpcase):
-                        edep['deprel'] = m.group(1)+':'+adpcase
+                    solved = False
+                    # Issues caused by errors in the original annotation must be fixed early.
+                    # Especially if acl|advcl occurs with a preposition that unambiguously
+                    # receives a morphological case in the subsequent steps, and then gets
+                    # flagged as solved.
+                    edep['deprel'] = re.sub(r'^advcl:do(?::gen)?$', r'obl:do:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
+                    edep['deprel'] = re.sub(r'^advcl:pro(?::acc)?$', r'advcl:aby', edep['deprel']) # byl by pro, abychom... ###!!! Opravit i konverzi stromu.
+                    edep['deprel'] = re.sub(r'^advcl:s(?::ins)?$', r'advcl', edep['deprel']) ###!!! "seděli jsme tam s Člověče, nezlob se!" Měla by se opravit konverze stromu.
+                    edep['deprel'] = re.sub(r'^acl:k(?::dat)?$', r'acl', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^advcl:k(?::dat)?$', r'obl:k:dat', edep['deprel']) ###!!! Ale měli bychom opravit i závislost v základním stromu!
+                    edep['deprel'] = re.sub(r'^advcl:místo(?::gen)?$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
+                    edep['deprel'] = re.sub(r'^acl:na_způsob(?::gen)?$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
+                    edep['deprel'] = re.sub(r'^acl:od(?::gen)?$', r'nmod:od:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^advcl:od(?::gen)?$', r'obl:od:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
+                    edep['deprel'] = re.sub(r'^advcl:podle(?::gen)?$', r'obl:podle:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^advcl:pro(?::acc)?$', r'obl:pro:acc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^acl:v$', r'nmod:v:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^advcl:v_duchu?(?::gen)?$', r'obl:v_duchu:gen', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^nmod:když.*$', r'nmod', edep['deprel']) # nadějí když ne na zbohatnutí, tak alespoň na dobrou obživu ###!!! perhaps "když" or "když ne" should be analyzed as "cc" here!
+                    edep['deprel'] = re.sub(r'^obl:ačkoli.*$', r'obl', edep['deprel']) # nadějí když ne na zbohatnutí, tak alespoň na dobrou obživu ###!!! perhaps "když" or "když ne" should be analyzed as "cc" here!
+                    edep['deprel'] = re.sub(r'^obl:jestli(?::gen)?$', r'obl:gen', edep['deprel']) # nevím, jestli osmého nebo devátého září
+                    # Removing 'až' must be done early. The remainder may be 'počátek'
+                    # and we will want to convert it to 'počátkem:gen'.
+                    edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
+                    # If one of the following expressions occurs followed by another preposition
+                    # or by morphological case, remove the additional case marking. For example,
+                    # 'jako_v' becomes just 'jako'.
+                    for x in self.outermost:
+                        exceptions = self.outermost[x]
+                        m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'([_:].+)?$', edep['deprel'])
+                        if m and m.group(2) and not x+m.group(2) in exceptions:
+                            edep['deprel'] = m.group(1)+':'+x
+                            solved = True
+                            break
+                    if solved:
                         continue
-            if re.match(r'^(acl|advcl):', edep['deprel']):
-                # We do not include 'i' in the list of redundant prefixes because we want to preserve 'i když' (but we want to discard the other combinations).
-                edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(acl|advcl):kdy$', r'\1', edep['deprel'])
-                edep['deprel'] = re.sub(r'^(advcl):neboť$', r'\1', edep['deprel']) # 'neboť' is coordinating
-                edep['deprel'] = re.sub(r'^(advcl):nechť$', r'\1', edep['deprel'])
-                if edep['deprel'] == 'acl:v' and node.form == 'patře':
-                    edep['deprel'] = 'nmod:v:loc'
-                    node.deprel = 'nmod'
-                    node.lemma = 'patro'
-                    node.upos = 'NOUN'
-                    node.xpos = 'NNNS6-----A----'
-                    node.feats['Aspect'] = ''
-                    node.feats['Gender'] = 'Neut'
-                    node.feats['Tense'] = ''
-                    node.feats['VerbForm'] = ''
-                    node.feats['Voice'] = ''
-            elif re.match(r'^(nmod|obl(:arg)?):', edep['deprel']):
-                if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
-                    # This is a same-case noun-noun modifier, which just happens to be in the locative.
-                    # For example, 'v Ostravě-Porubě', 'Porubě' is attached to 'Ostravě', 'Ostravě' has
-                    # nmod:v:loc, which is OK, but for 'Porubě' the case does not say anything significant.
-                    edep['deprel'] = 'nmod'
-                elif edep['deprel'] == 'obl:loc':
-                    # Annotation error. The first occurrence in PDT dev:
-                    # 'V Rapaportu, ceníku Antverpské burzy i Diamantberichtu jsou uvedeny ceny...'
-                    # The preposition 'V' should modify coordination 'Rapaportu i Diamantberichtu'.
-                    # However, 'Rapaportu' is attached as 'obl' to 'Diamantberichtu'.
-                    edep['deprel'] = 'obl:v:loc'
-                elif edep['deprel'] == 'obl:arg:loc':
-                    # Annotation error. The first occurrence in PDT dev:
-                    edep['deprel'] = 'obl:arg:na:loc'
-                elif edep['deprel'] == 'nmod:loc':
-                    # 'působil v kanadském Edmontonu Oilers', 'Edmontonu' attached to 'Oilers' and not vice versa.
-                    edep['deprel'] = 'nmod:nom'
-                elif edep['deprel'] == 'obl:nom' or edep['deprel'] == 'obl:voc':
-                    # Possibly an annotation error, nominative should be accusative, and the nominal should be direct object?
-                    # However, there seems to be a great variability in the causes, some are subjects and many are really obliques, so let's go just with 'obl' for now.
-                    edep['deprel'] = 'obl'
-                elif edep['deprel'] == 'nmod:voc':
-                    # 'v 8. čísle tiskoviny Ty rudá krávo'
-                    edep['deprel'] = 'nmod:nom'
-                elif edep['deprel'] == 'nmod:co:nom':
-                    # Annotation error: 'kompatibilní znamená tolik co slučitelný'
-                    # 'co' should be relative pronoun rather than subordinating conjunction.
-                    edep['deprel'] = 'acl:relcl'
-                    node.deprel = 'acl:relcl'
-                elif re.match(r'^(obl(:arg)?):li$', edep['deprel']):
-                    edep['deprel'] = 'advcl:li'
-                elif re.match(r'^(nmod|obl(:arg)?):mezi:voc$', edep['deprel']):
-                    edep['deprel'] = re.sub(r':voc$', r':acc', edep['deprel'])
-                elif re.match(r'^(nmod|obl(:arg)?):mezi$', edep['deprel']):
-                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):mimo$', edep['deprel']):
-                    edep['deprel'] += ':acc'
-                elif re.match(r'^(nmod|obl(:arg)?):místo$', edep['deprel']):
-                    edep['deprel'] += ':gen'
-                elif re.match(r'^obl:místo_za:acc$', edep['deprel']):
-                    # 'chytají krávu místo za rohy spíše za ocas'
-                    # This should be treated as coordination; 'místo' and 'spíše' are adverbs (???); 'case' for 'místo' does not seem to be the optimal solution.
-                    for c in node.children:
-                        if c.form == 'místo':
-                            c.upos = 'ADV'
-                            c.deprel = 'cc'
-                    edep['deprel'] = 'obl:za:acc'
-                elif re.match(r'^(nmod|obl(:arg)?):místo[_:].+$', edep['deprel']) and not re.match(r'^(nmod|obl(:arg)?):místo_aby$', edep['deprel']):
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):místo[_:].+$', r'\1:místo:gen', edep['deprel'])
-                elif re.match(r'^(nmod|obl(:arg)?):na(:gen)?$', edep['deprel']):
-                    edep['deprel'] = re.sub(r':gen$', '', edep['deprel'])
-                    # The case is unknown. We need 'acc' or 'loc'.
-                    # The locative is probably more frequent but it is not so likely with every noun.
-                    # If there is an nummod:gov child, it must be accusative and not locative.
-                    # (The case would be taken from the number but if it is expressed as digits, it does not have the case feature.)
-                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    elif re.match(r'^(adresát|AIDS|DEM|frank|h|ha|hodina|Honolulu|jméno|koruna|litr|metr|míle|miliarda|milión|mm|MUDr|NATO|obyvatel|OSN|počet|procento|příklad|rok|SSSR|vůz)$', node.lemma):
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':loc'
-                elif re.match(r'^obl:arg:na_konec$', edep['deprel']):
-                    # Annotation error. It should have been two prepositional phrases: 'snížil na 225 tisíc koncem minulého roku'
-                    edep['deprel'] = 'obl:arg:na:acc'
-                elif re.match(r'^(nmod|obl(:arg)?):nad$', edep['deprel']):
-                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                    for x in self.unambiguous:
+                        # All secondary prepositions have only one fixed morphological case
+                        # they appear with, so we can replace whatever case we encounter with the correct one.
+                        m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?$', edep['deprel'])
+                        if m:
+                            edep['deprel'] = m.group(1)+':'+self.unambiguous[x]
+                            solved = True
+                            break
+                    if solved:
+                        continue
+                    # The following prepositions have more than one morphological case
+                    # available. Thanks to the Case feature on prepositions, we can
+                    # identify the correct one.
+                    m = re.match(r'^(obl(?::arg)?|nmod):(mezi|na|nad|o|po|pod|před|v|za)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
+                    if m:
+                        adpcase = self.copy_case_from_adposition(node, m.group(2))
+                        if adpcase and not re.search(r':(nom|gen|dat|voc)$', adpcase):
+                            edep['deprel'] = m.group(1)+':'+adpcase
+                            continue
+                if re.match(r'^(acl|advcl):', edep['deprel']):
+                    # We do not include 'i' in the list of redundant prefixes because we want to preserve 'i když' (but we want to discard the other combinations).
+                    edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(acl|advcl):i_(aby|až|jestliže|li|pokud)$', r'\1:\2', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(acl|advcl):(aby|až|jestliže|když|li|pokud|protože|že)_(?:ale|tedy|totiž|už|však)$', r'\1:\2', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(acl|advcl):co_když$', r'\1', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(acl|advcl):kdy$', r'\1', edep['deprel'])
+                    edep['deprel'] = re.sub(r'^(advcl):neboť$', r'\1', edep['deprel']) # 'neboť' is coordinating
+                    edep['deprel'] = re.sub(r'^(advcl):nechť$', r'\1', edep['deprel'])
+                    if edep['deprel'] == 'acl:v' and node.form == 'patře':
+                        edep['deprel'] = 'nmod:v:loc'
+                        node.deprel = 'nmod'
+                        node.lemma = 'patro'
+                        node.upos = 'NOUN'
+                        node.xpos = 'NNNS6-----A----'
+                        node.feats['Aspect'] = ''
+                        node.feats['Gender'] = 'Neut'
+                        node.feats['Tense'] = ''
+                        node.feats['VerbForm'] = ''
+                        node.feats['Voice'] = ''
+                elif re.match(r'^(nmod|obl(:arg)?):', edep['deprel']):
+                    if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
+                        # This is a same-case noun-noun modifier, which just happens to be in the locative.
+                        # For example, 'v Ostravě-Porubě', 'Porubě' is attached to 'Ostravě', 'Ostravě' has
+                        # nmod:v:loc, which is OK, but for 'Porubě' the case does not say anything significant.
+                        edep['deprel'] = 'nmod'
+                    elif edep['deprel'] == 'obl:loc':
+                        # Annotation error. The first occurrence in PDT dev:
+                        # 'V Rapaportu, ceníku Antverpské burzy i Diamantberichtu jsou uvedeny ceny...'
+                        # The preposition 'V' should modify coordination 'Rapaportu i Diamantberichtu'.
+                        # However, 'Rapaportu' is attached as 'obl' to 'Diamantberichtu'.
+                        edep['deprel'] = 'obl:v:loc'
+                    elif edep['deprel'] == 'obl:arg:loc':
+                        # Annotation error. The first occurrence in PDT dev:
+                        edep['deprel'] = 'obl:arg:na:loc'
+                    elif edep['deprel'] == 'nmod:loc':
+                        # 'působil v kanadském Edmontonu Oilers', 'Edmontonu' attached to 'Oilers' and not vice versa.
+                        edep['deprel'] = 'nmod:nom'
+                    elif edep['deprel'] == 'obl:nom' or edep['deprel'] == 'obl:voc':
+                        # Possibly an annotation error, nominative should be accusative, and the nominal should be direct object?
+                        # However, there seems to be a great variability in the causes, some are subjects and many are really obliques, so let's go just with 'obl' for now.
+                        edep['deprel'] = 'obl'
+                    elif edep['deprel'] == 'nmod:voc':
+                        # 'v 8. čísle tiskoviny Ty rudá krávo'
+                        edep['deprel'] = 'nmod:nom'
+                    elif edep['deprel'] == 'nmod:co:nom':
+                        # Annotation error: 'kompatibilní znamená tolik co slučitelný'
+                        # 'co' should be relative pronoun rather than subordinating conjunction.
+                        edep['deprel'] = 'acl:relcl'
+                        node.deprel = 'acl:relcl'
+                    elif re.match(r'^(obl(:arg)?):li$', edep['deprel']):
+                        edep['deprel'] = 'advcl:li'
+                    elif re.match(r'^(nmod|obl(:arg)?):mezi:voc$', edep['deprel']):
+                        edep['deprel'] = re.sub(r':voc$', r':acc', edep['deprel'])
+                    elif re.match(r'^(nmod|obl(:arg)?):mezi$', edep['deprel']):
+                        if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                            edep['deprel'] += ':acc'
+                        else:
+                            edep['deprel'] += ':ins'
+                    elif re.match(r'^(nmod|obl(:arg)?):mimo$', edep['deprel']):
                         edep['deprel'] += ':acc'
-                    else:
+                    elif re.match(r'^(nmod|obl(:arg)?):místo$', edep['deprel']):
+                        edep['deprel'] += ':gen'
+                    elif re.match(r'^obl:místo_za:acc$', edep['deprel']):
+                        # 'chytají krávu místo za rohy spíše za ocas'
+                        # This should be treated as coordination; 'místo' and 'spíše' are adverbs (???); 'case' for 'místo' does not seem to be the optimal solution.
+                        for c in node.children:
+                            if c.form == 'místo':
+                                c.upos = 'ADV'
+                                c.deprel = 'cc'
+                        edep['deprel'] = 'obl:za:acc'
+                    elif re.match(r'^(nmod|obl(:arg)?):místo[_:].+$', edep['deprel']) and not re.match(r'^(nmod|obl(:arg)?):místo_aby$', edep['deprel']):
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):místo[_:].+$', r'\1:místo:gen', edep['deprel'])
+                    elif re.match(r'^(nmod|obl(:arg)?):na(:gen)?$', edep['deprel']):
+                        edep['deprel'] = re.sub(r':gen$', '', edep['deprel'])
+                        # The case is unknown. We need 'acc' or 'loc'.
+                        # The locative is probably more frequent but it is not so likely with every noun.
+                        # If there is an nummod:gov child, it must be accusative and not locative.
+                        # (The case would be taken from the number but if it is expressed as digits, it does not have the case feature.)
+                        if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                            edep['deprel'] += ':acc'
+                        elif re.match(r'^(adresát|AIDS|DEM|frank|h|ha|hodina|Honolulu|jméno|koruna|litr|metr|míle|miliarda|milión|mm|MUDr|NATO|obyvatel|OSN|počet|procento|příklad|rok|SSSR|vůz)$', node.lemma):
+                            edep['deprel'] += ':acc'
+                        else:
+                            edep['deprel'] += ':loc'
+                    elif re.match(r'^obl:arg:na_konec$', edep['deprel']):
+                        # Annotation error. It should have been two prepositional phrases: 'snížil na 225 tisíc koncem minulého roku'
+                        edep['deprel'] = 'obl:arg:na:acc'
+                    elif re.match(r'^(nmod|obl(:arg)?):nad$', edep['deprel']):
+                        if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                            edep['deprel'] += ':acc'
+                        else:
+                            edep['deprel'] += ':ins'
+                    elif re.match(r'^(nmod|obl(:arg)?):o$', edep['deprel']):
+                        if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                            edep['deprel'] += ':acc'
+                        else:
+                            edep['deprel'] += ':loc'
+                    elif re.match(r'^(nmod|obl(:arg)?):ohled_na:ins$', edep['deprel']):
+                        # Annotation error.
+                        if node.form == 's':
+                            ohled = node.next_node
+                            na = ohled.next_node
+                            noun = na.next_node
+                            self.set_basic_and_enhanced(noun, node.parent, 'obl', 'obl:s_ohledem_na:acc')
+                            self.set_basic_and_enhanced(ohled, node, 'fixed', 'fixed')
+                            self.set_basic_and_enhanced(na, node, 'fixed', 'fixed')
+                            self.set_basic_and_enhanced(node, noun, 'case', 'case')
+                    elif re.match(r'^nmod:pára:nom$', edep['deprel']):
+                        # Annotation error: 'par excellence'.
+                        edep['deprel'] = 'nmod'
+                        for c in node.children:
+                            if c.udeprel == 'case' and c.form.lower() == 'par':
+                                c.lemma = 'par'
+                                c.upos = 'ADP'
+                                c.xpos = 'RR--X----------'
+                                c.feats['Case'] = ''
+                                c.feats['Gender'] = ''
+                                c.feats['Number'] = ''
+                                c.feats['Polarity'] = ''
+                                c.feats['AdpType'] = 'Prep'
+                    elif re.match(r'^(nmod|obl(:arg)?):po$', edep['deprel']):
+                        if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                            edep['deprel'] += ':acc'
+                        else:
+                            edep['deprel'] += ':loc'
+                    elif re.match(r'^(nmod|obl(:arg)?):pod$', edep['deprel']):
+                        if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                            edep['deprel'] += ':acc'
+                        else:
+                            edep['deprel'] += ':ins'
+                    elif re.match(r'^(nmod|obl(:arg)?):před$', edep['deprel']):
+                        # Accusative would be possible but unlikely.
                         edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):o$', edep['deprel']):
-                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':loc'
-                elif re.match(r'^(nmod|obl(:arg)?):ohled_na:ins$', edep['deprel']):
-                    # Annotation error.
-                    if node.form == 's':
-                        ohled = node.next_node
-                        na = ohled.next_node
-                        noun = na.next_node
-                        self.set_basic_and_enhanced(noun, node.parent, 'obl', 'obl:s_ohledem_na:acc')
-                        self.set_basic_and_enhanced(ohled, node, 'fixed', 'fixed')
-                        self.set_basic_and_enhanced(na, node, 'fixed', 'fixed')
-                        self.set_basic_and_enhanced(node, noun, 'case', 'case')
-                elif re.match(r'^nmod:pára:nom$', edep['deprel']):
-                    # Annotation error: 'par excellence'.
-                    edep['deprel'] = 'nmod'
-                    for c in node.children:
-                        if c.udeprel == 'case' and c.form.lower() == 'par':
-                            c.lemma = 'par'
-                            c.upos = 'ADP'
-                            c.xpos = 'RR--X----------'
-                            c.feats['Case'] = ''
-                            c.feats['Gender'] = ''
-                            c.feats['Number'] = ''
-                            c.feats['Polarity'] = ''
-                            c.feats['AdpType'] = 'Prep'
-                elif re.match(r'^(nmod|obl(:arg)?):po$', edep['deprel']):
-                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
-                        edep['deprel'] += ':loc'
-                elif re.match(r'^(nmod|obl(:arg)?):pod$', edep['deprel']):
-                    if re.match(r'[0-9]', node.lemma) or len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
-                        edep['deprel'] += ':acc'
-                    else:
+                    elif re.match(r'^(nmod|obl(:arg)?):s$', edep['deprel']):
+                        # Genitive would be possible but unlikely.
                         edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):před$', edep['deprel']):
-                    # Accusative would be possible but unlikely.
-                    edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):s$', edep['deprel']):
-                    # Genitive would be possible but unlikely.
-                    edep['deprel'] += ':ins'
-                elif re.match(r'^(nmod|obl(:arg)?):v_s(:loc)?$', edep['deprel']) and node.form == 'spolupráci':
-                    # Annotation error. 'Ve spolupráci s' should be analyzed as a multi-word preposition.
-                    # Find the content nominal.
-                    cnouns = [x for x in node.children if x.ord > node.ord and re.match(r'^(nmod|obl)', x.udeprel)]
-                    vs = [x for x in node.children if x.ord < node.ord and x.lemma == 'v']
-                    if len(cnouns) > 0 and len(vs) > 0:
-                        cnoun = cnouns[0]
-                        v = vs[0]
-                        self.set_basic_and_enhanced(cnoun, node.parent, 'obl', 'obl:ve_spolupráci_s:ins')
-                        self.set_basic_and_enhanced(v, cnoun, 'case', 'case')
-                        self.set_basic_and_enhanced(node, v, 'fixed', 'fixed')
-                elif re.match(r'^(nmod|obl(:arg)?):v(:nom)?$', edep['deprel']):
-                    # ':nom' occurs in 'karneval v Rio de Janeiro'
-                    edep['deprel'] = re.sub(r':nom$', '', edep['deprel'])
-                    if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                    elif re.match(r'^(nmod|obl(:arg)?):v_s(:loc)?$', edep['deprel']) and node.form == 'spolupráci':
+                        # Annotation error. 'Ve spolupráci s' should be analyzed as a multi-word preposition.
+                        # Find the content nominal.
+                        cnouns = [x for x in node.children if x.ord > node.ord and re.match(r'^(nmod|obl)', x.udeprel)]
+                        vs = [x for x in node.children if x.ord < node.ord and x.lemma == 'v']
+                        if len(cnouns) > 0 and len(vs) > 0:
+                            cnoun = cnouns[0]
+                            v = vs[0]
+                            self.set_basic_and_enhanced(cnoun, node.parent, 'obl', 'obl:ve_spolupráci_s:ins')
+                            self.set_basic_and_enhanced(v, cnoun, 'case', 'case')
+                            self.set_basic_and_enhanced(node, v, 'fixed', 'fixed')
+                    elif re.match(r'^(nmod|obl(:arg)?):v(:nom)?$', edep['deprel']):
+                        # ':nom' occurs in 'karneval v Rio de Janeiro'
+                        edep['deprel'] = re.sub(r':nom$', '', edep['deprel'])
+                        if len([x for x in node.children if x.deprel == 'nummod:gov']) > 0:
+                            edep['deprel'] += ':acc'
+                        else:
+                            edep['deprel'] += ':loc'
+                    elif re.match(r'^obl:v_čel[eo]_s:ins$', edep['deprel']):
+                        # There is just one occurrence and it is an error:
+                        # 'Předloňský kůň roku Law Soziri šel již v Lahovickém oblouku v čele s Raddelliosem a tato dvojice také nakonec zahanbila ostatní soupeře...'
+                        # There should be two independent oblique modifiers, 'v čele' and 's Raddelliosem'.
+                        edep['deprel'] = 'obl:s:ins'
+                    elif re.match(r'^(nmod|obl(:arg)?):za$', edep['deprel']):
+                        # Instrumental would be possible but unlikely.
                         edep['deprel'] += ':acc'
                     else:
-                        edep['deprel'] += ':loc'
-                elif re.match(r'^obl:v_čel[eo]_s:ins$', edep['deprel']):
-                    # There is just one occurrence and it is an error:
-                    # 'Předloňský kůň roku Law Soziri šel již v Lahovickém oblouku v čele s Raddelliosem a tato dvojice také nakonec zahanbila ostatní soupeře...'
-                    # There should be two independent oblique modifiers, 'v čele' and 's Raddelliosem'.
-                    edep['deprel'] = 'obl:s:ins'
-                elif re.match(r'^(nmod|obl(:arg)?):za$', edep['deprel']):
-                    # Instrumental would be possible but unlikely.
-                    edep['deprel'] += ':acc'
-                else:
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_?l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(jak_)?ad([_:].+)?$', r'\1', edep['deprel']) # ad infinitum
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):co(:nom)?$', r'advmod', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):de([_:].+)?$', r'\1', edep['deprel']) # de facto
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):di([_:].+)?$', r'\1', edep['deprel']) # Lido di Jesolo
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):en([_:].+)?$', r'\1', edep['deprel']) # bienvenue en France
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):in([_:].+)?$', r'\1', edep['deprel']) # made in NHL
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):into([_:].+)?$', r'\1', edep['deprel']) # made in NHL
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno:nom$', r'\1:jménem:nom', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno(:gen)?$', r'\1:jménem:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi:(nom|dat)$', r'\1:mezi:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o:(nom|gen|dat)$', r'\1:o:acc', edep['deprel']) # 'zájem o obaly'
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):of([_:].+)?$', r'\1', edep['deprel']) # University of North Carolina
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):per([_:].+)?$', r'\1', edep['deprel']) # per rollam
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po:(nom|gen)$', r'\1:po:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před:gen$', r'\1:před:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přestože[_:].+$', r'\1:přestože', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):se?:(nom|acc|ins)$', r'\1:s:ins', edep['deprel']) # accusative: 'být s to' should be a fixed expression and it should be the predicate!
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):shoda(:gen)?$', r'\1', edep['deprel']) # 'shodou okolností' is not a prepositional phrase
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v:gen$', r'\1:v:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vo:acc$', r'\1:o:acc', edep['deprel']) # colloquial: vo všecko
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):von([_:].+)?$', r'\1', edep['deprel']) # von Neumannem
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):voor([_:].+)?$', r'\1', edep['deprel']) # Hoge Raad voor Diamant
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:nom$', r'\1:z:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:ins$', r'\1:s:ins', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za:nom$', r'\1:za:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^nmod:že:gen$', 'acl:že', edep['deprel'])
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a([_:].+)?$', r'\1', edep['deprel']) # ala vršovický dloubák
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):a_?l[ae]([_:].+)?$', r'\1', edep['deprel']) # a la bondovky
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):(jak_)?ad([_:].+)?$', r'\1', edep['deprel']) # ad infinitum
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):ať:.+$', r'\1:ať', edep['deprel'])
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):beyond([_:].+)?$', r'\1', edep['deprel']) # Beyond the Limits
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):co(:nom)?$', r'advmod', edep['deprel'])
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):de([_:].+)?$', r'\1', edep['deprel']) # de facto
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):di([_:].+)?$', r'\1', edep['deprel']) # Lido di Jesolo
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):en([_:].+)?$', r'\1', edep['deprel']) # bienvenue en France
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):in([_:].+)?$', r'\1', edep['deprel']) # made in NHL
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):into([_:].+)?$', r'\1', edep['deprel']) # made in NHL
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno:nom$', r'\1:jménem:nom', edep['deprel'])
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):jméno(:gen)?$', r'\1:jménem:gen', edep['deprel'])
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):mezi:(nom|dat)$', r'\1:mezi:ins', edep['deprel'])
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):o:(nom|gen|dat)$', r'\1:o:acc', edep['deprel']) # 'zájem o obaly'
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):of([_:].+)?$', r'\1', edep['deprel']) # University of North Carolina
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):per([_:].+)?$', r'\1', edep['deprel']) # per rollam
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):po:(nom|gen)$', r'\1:po:acc', edep['deprel'])
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):před:gen$', r'\1:před:ins', edep['deprel'])
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):přestože[_:].+$', r'\1:přestože', edep['deprel'])
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):se?:(nom|acc|ins)$', r'\1:s:ins', edep['deprel']) # accusative: 'být s to' should be a fixed expression and it should be the predicate!
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):shoda(:gen)?$', r'\1', edep['deprel']) # 'shodou okolností' is not a prepositional phrase
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):v:gen$', r'\1:v:loc', edep['deprel'])
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):vo:acc$', r'\1:o:acc', edep['deprel']) # colloquial: vo všecko
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):von([_:].+)?$', r'\1', edep['deprel']) # von Neumannem
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):voor([_:].+)?$', r'\1', edep['deprel']) # Hoge Raad voor Diamant
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:nom$', r'\1:z:gen', edep['deprel'])
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):z:ins$', r'\1:s:ins', edep['deprel'])
+                        edep['deprel'] = re.sub(r'^(nmod|obl(:arg)?):za:nom$', r'\1:za:acc', edep['deprel'])
+                        edep['deprel'] = re.sub(r'^nmod:že:gen$', 'acl:že', edep['deprel'])
 
     def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
         '''

From dae8dd9b0c8cd253b418b0b7cc683db3121e11a6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 3 Oct 2025 16:58:44 +0200
Subject: [PATCH 1292/1374] More rules for Czech fixedeprels.

---
 udapi/block/ud/cs/fixedeprels.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 9416876e..175ff609 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -44,6 +44,7 @@ class FixEdeprels(Block):
         'ačkoliv':          'ačkoli',
         'ať':               'ať', # remove morphological case
         'ať_forma':         'formou:gen',
+        'ať_jako':          'jako',
         'ať_na':            'na:loc',
         'ať_s':             's:ins',
         'ať_v':             'v:loc',
@@ -65,6 +66,7 @@ class FixEdeprels(Block):
         'blíže':            'blízko:dat',
         'bok_po_bok_s':     'bok_po_boku_s:ins',
         'cesta':            'cestou:gen',
+        'co_jako':          'jako',
         'coby':             'coby', # remove morphological case
         'daleko':           'nedaleko:gen',
         'daleko_od':        'od:gen',

From 183da4ea4ffbb92ed430978cd25ed5f64354fd95 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 4 Oct 2025 16:55:35 +0200
Subject: [PATCH 1293/1374] Partially cleaned up the code of Czech FixEdeprels.

---
 udapi/block/ud/cs/fixedeprels.py | 131 +++++++++++++++++++++++--------
 1 file changed, 98 insertions(+), 33 deletions(-)

diff --git a/udapi/block/ud/cs/fixedeprels.py b/udapi/block/ud/cs/fixedeprels.py
index 175ff609..4e2be633 100644
--- a/udapi/block/ud/cs/fixedeprels.py
+++ b/udapi/block/ud/cs/fixedeprels.py
@@ -338,6 +338,30 @@ def copy_case_from_adposition(self, node, adposition):
         else:
             return None
 
+    @staticmethod
+    def compose_edeprel(bdeprel, cdeprel):
+        """
+        Composes enhanced deprel from the basic part and optional case
+        enhancement.
+
+        Parameters
+        ----------
+        bdeprel : str
+            Basic deprel (can include subtype, e.g., 'acl:relcl').
+        cdeprel : TYPE
+            Case enhancement (can be composed of adposition and morphological
+            case, e.g., 'k:dat'). It is optional and it can be None or empty
+            string if there is no case enhancement.
+
+        Returns
+        -------
+        Full enhanced deprel (str).
+        """
+        edeprel = bdeprel
+        if cdeprel:
+            edeprel += ':'+cdeprel
+        return edeprel
+
     def process_tree(self, tree):
         """
         Occasionally the edeprels automatically derived from the Czech basic
@@ -348,41 +372,78 @@ def process_tree(self, tree):
         """
         for node in tree.descendants_and_empty:
             for edep in node.deps:
-                m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):', edep['deprel'])
+                m = re.fullmatch(r'(obl(?::arg)?|nmod|advcl(?::pred)?|acl(?::relcl)?):(.+)', edep['deprel'])
                 if m:
+                    bdeprel = m.group(1)
+                    cdeprel = m.group(2)
                     solved = False
                     # Issues caused by errors in the original annotation must be fixed early.
                     # Especially if acl|advcl occurs with a preposition that unambiguously
                     # receives a morphological case in the subsequent steps, and then gets
                     # flagged as solved.
-                    edep['deprel'] = re.sub(r'^advcl:do(?::gen)?$', r'obl:do:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
-                    edep['deprel'] = re.sub(r'^advcl:pro(?::acc)?$', r'advcl:aby', edep['deprel']) # byl by pro, abychom... ###!!! Opravit i konverzi stromu.
-                    edep['deprel'] = re.sub(r'^advcl:s(?::ins)?$', r'advcl', edep['deprel']) ###!!! "seděli jsme tam s Člověče, nezlob se!" Měla by se opravit konverze stromu.
-                    edep['deprel'] = re.sub(r'^acl:k(?::dat)?$', r'acl', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^advcl:k(?::dat)?$', r'obl:k:dat', edep['deprel']) ###!!! Ale měli bychom opravit i závislost v základním stromu!
-                    edep['deprel'] = re.sub(r'^advcl:místo(?::gen)?$', r'obl:místo:gen', edep['deprel']) # 'v poslední době se množí bysem místo bych'
-                    edep['deprel'] = re.sub(r'^acl:na_způsob(?::gen)?$', r'nmod:na_způsob:gen', edep['deprel']) # 'střídmost na způsob Masarykova "jez dopolosyta"'
-                    edep['deprel'] = re.sub(r'^acl:od(?::gen)?$', r'nmod:od:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^advcl:od(?::gen)?$', r'obl:od:gen', edep['deprel']) # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
-                    edep['deprel'] = re.sub(r'^advcl:podle(?::gen)?$', r'obl:podle:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^advcl:pro(?::acc)?$', r'obl:pro:acc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^acl:v$', r'nmod:v:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^advcl:v$', r'obl:v:loc', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^advcl:v_duchu?(?::gen)?$', r'obl:v_duchu:gen', edep['deprel'])
-                    edep['deprel'] = re.sub(r'^nmod:když.*$', r'nmod', edep['deprel']) # nadějí když ne na zbohatnutí, tak alespoň na dobrou obživu ###!!! perhaps "když" or "když ne" should be analyzed as "cc" here!
-                    edep['deprel'] = re.sub(r'^obl:ačkoli.*$', r'obl', edep['deprel']) # nadějí když ne na zbohatnutí, tak alespoň na dobrou obživu ###!!! perhaps "když" or "když ne" should be analyzed as "cc" here!
-                    edep['deprel'] = re.sub(r'^obl:jestli(?::gen)?$', r'obl:gen', edep['deprel']) # nevím, jestli osmého nebo devátého září
-                    # Removing 'až' must be done early. The remainder may be 'počátek'
-                    # and we will want to convert it to 'počátkem:gen'.
-                    edep['deprel'] = re.sub(r'^(nmod|obl(?::arg)?):až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2:\3', edep['deprel'])
+                    if re.match(r'advcl', bdeprel):
+                        # The following advcl should in fact be obl.
+                        if re.fullmatch(r'do(?::gen)?', cdeprel): # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
+                            bdeprel = 'obl'
+                            cdeprel = 'do:gen'
+                        elif re.fullmatch(r'k(?::dat)?', cdeprel): ###!!! Ale měli bychom opravit i závislost v základním stromu!
+                            bdeprel = 'obl'
+                            cdeprel = 'k:dat'
+                        elif re.fullmatch(r'místo(?::gen)?', cdeprel): # 'v poslední době se množí bysem místo bych'
+                            bdeprel = 'obl'
+                            cdeprel = 'místo:gen'
+                        elif re.fullmatch(r'od(?::gen)?', cdeprel): # od nevidím do nevidím ###!!! Ale měli bychom opravit i závislost v základním stromu!
+                            bdeprel = 'obl'
+                            cdeprel = 'od:gen'
+                        elif re.fullmatch(r'podle(?::gen)?', cdeprel):
+                            bdeprel = 'obl'
+                            cdeprel = 'podle:gen'
+                        elif re.fullmatch(r's(?::ins)?', cdeprel): ###!!! "seděli jsme tam s Člověče, nezlob se!" Měla by se opravit konverze stromu.
+                            bdeprel = 'obl'
+                            cdeprel = 's:ins'
+                        elif re.fullmatch(r'v_duchu?(?::gen)?', cdeprel):
+                            bdeprel = 'obl'
+                            cdeprel = 'v_duchu:gen'
+                        elif re.fullmatch(r'v', cdeprel):
+                            bdeprel = 'obl'
+                            cdeprel = 'v:loc'
+                        # byl by pro, abychom... ###!!! Opravit i konverzi stromu.
+                        elif re.fullmatch(r'pro(?::acc)?', cdeprel):
+                            cdeprel = 'aby'
+                    elif re.match(r'acl', bdeprel):
+                        # The following acl should in fact be nmod.
+                        if re.fullmatch(r'k(?::dat)?', cdeprel):
+                            bdeprel = 'nmod'
+                            cdeprel = 'k:dat'
+                        elif re.fullmatch(r'na_způsob(?::gen)?', cdeprel): # 'střídmost na způsob Masarykova "jez dopolosyta"'
+                            bdeprel = 'nmod'
+                            cdeprel = 'na_způsob:gen'
+                        elif re.fullmatch(r'od(?::gen)?', cdeprel):
+                            bdeprel = 'nmod'
+                            cdeprel = 'od:gen'
+                        elif re.fullmatch(r'v', cdeprel):
+                            bdeprel = 'nmod'
+                            cdeprel = 'v:loc'
+                    else: # bdeprel is 'obl' or 'nmod'
+                        # The following subordinators should be removed if they occur with nominals.
+                        if re.match(r'(ačkoli|když)', cdeprel): # nadějí když ne na zbohatnutí, tak alespoň na dobrou obživu ###!!! perhaps "když" or "když ne" should be analyzed as "cc" here!
+                            cdeprel = ''
+                        # Removing 'až' must be done early. The remainder may be 'počátek'
+                        # and we will want to convert it to 'počátkem:gen'.
+                        elif re.match(r'až_(.+):(gen|dat|acc|loc|ins)', cdeprel):
+                            cdeprel = re.sub(r'až_(.+):(gen|dat|acc|loc|ins)', r'\1:\2', cdeprel)
+                        elif re.fullmatch(r'jestli(?::gen)?', cdeprel): # nevím, jestli osmého nebo devátého září
+                            cdeprel = 'gen'
+                    edep['deprel'] = self.compose_edeprel(bdeprel, cdeprel)
                     # If one of the following expressions occurs followed by another preposition
                     # or by morphological case, remove the additional case marking. For example,
                     # 'jako_v' becomes just 'jako'.
                     for x in self.outermost:
                         exceptions = self.outermost[x]
-                        m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'([_:].+)?$', edep['deprel'])
-                        if m and m.group(2) and not x+m.group(2) in exceptions:
-                            edep['deprel'] = m.group(1)+':'+x
+                        m = re.fullmatch(x+r'([_:].+)?', cdeprel)
+                        if m and m.group(1) and not x+m.group(1) in exceptions:
+                            cdeprel = x
+                            edep['deprel'] = self.compose_edeprel(bdeprel, cdeprel)
                             solved = True
                             break
                     if solved:
@@ -390,9 +451,10 @@ def process_tree(self, tree):
                     for x in self.unambiguous:
                         # All secondary prepositions have only one fixed morphological case
                         # they appear with, so we can replace whatever case we encounter with the correct one.
-                        m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?$', edep['deprel'])
+                        m = re.fullmatch(x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?', cdeprel)
                         if m:
-                            edep['deprel'] = m.group(1)+':'+self.unambiguous[x]
+                            cdeprel = self.unambiguous[x]
+                            edep['deprel'] = self.compose_edeprel(bdeprel, cdeprel)
                             solved = True
                             break
                     if solved:
@@ -400,12 +462,15 @@ def process_tree(self, tree):
                     # The following prepositions have more than one morphological case
                     # available. Thanks to the Case feature on prepositions, we can
                     # identify the correct one.
-                    m = re.match(r'^(obl(?::arg)?|nmod):(mezi|na|nad|o|po|pod|před|v|za)(?::(?:nom|gen|dat|voc))?$', edep['deprel'])
-                    if m:
-                        adpcase = self.copy_case_from_adposition(node, m.group(2))
-                        if adpcase and not re.search(r':(nom|gen|dat|voc)$', adpcase):
-                            edep['deprel'] = m.group(1)+':'+adpcase
-                            continue
+                    if re.match(r'(obl|nmod)', bdeprel):
+                        m = re.fullmatch(r'(mezi|na|nad|o|po|pod|před|v|za)(?::(?:nom|gen|dat|voc))?', cdeprel)
+                        if m:
+                            adpcase = self.copy_case_from_adposition(node, m.group(1))
+                            if adpcase and not re.search(r':(nom|gen|dat|voc)$', adpcase):
+                                cdeprel = adpcase
+                                edep['deprel'] = self.compose_edeprel(bdeprel, cdeprel)
+                                continue
+                ###!!! bdeprel and cdeprel are not visible from here on but we may want to use them there as well.
                 if re.match(r'^(acl|advcl):', edep['deprel']):
                     # We do not include 'i' in the list of redundant prefixes because we want to preserve 'i když' (but we want to discard the other combinations).
                     edep['deprel'] = re.sub(r'^(acl|advcl):(?:a|alespoň|až|jen|hlavně|například|ovšem_teprve|protože|teprve|totiž|zejména)_(aby|až|jestliže|když|li|pokud|protože|že)$', r'\1:\2', edep['deprel'])
@@ -427,7 +492,7 @@ def process_tree(self, tree):
                         node.feats['VerbForm'] = ''
                         node.feats['Voice'] = ''
                 elif re.match(r'^(nmod|obl(:arg)?):', edep['deprel']):
-                    if edep['deprel'] == 'nmod:loc' and node.parent.feats['Case'] == 'Loc' or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
+                    if edep['deprel'] == 'nmod:loc' and (node.parent == None or node.parent.feats['Case'] == 'Loc') or edep['deprel'] == 'nmod:voc' and node.parent.feats['Case'] == 'Voc':
                         # This is a same-case noun-noun modifier, which just happens to be in the locative.
                         # For example, 'v Ostravě-Porubě', 'Porubě' is attached to 'Ostravě', 'Ostravě' has
                         # nmod:v:loc, which is OK, but for 'Porubě' the case does not say anything significant.

From 664e8f2b0ed8129400a92f4f831c4ff7d35ea026 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 4 Oct 2025 23:24:00 +0200
Subject: [PATCH 1294/1374] Partially cleaned up the code of Arabic
 FixEdeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 158 +++++++++++++++++++++----------
 1 file changed, 106 insertions(+), 52 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 99db7fa2..f06ed9d4 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -136,6 +136,7 @@ class FixEdeprels(Block):
         'بِ_صَدَد':            'بِصَدَدِ:gen', # biṣadadi = with respect to
         'بِ_صَرف_نَظَر_عَن':     'بِصَرفِ_اَلنَّظَرِ_عَن:gen', # biṣarfi an-naẓari ʿan = regardless of
         'بِ_صِفَة':            'بِصِفَةِ:gen', # biṣifati = as
+        'بِ_صُورَة':            'بِ:gen',
         'بِ_عَكس':            'بِ:gen',
         'بِ_عَلَى':            'بِ:gen',
         'بِ_عَن':             'بِ:gen',
@@ -196,6 +197,7 @@ class FixEdeprels(Block):
         'بَينَ':              'بَينَ:gen', # bayna = between
         'بَينَ_حَوَالَى':        'بَينَ:gen', # bayna hawala
         'بينا':             'بَينَ:gen', # bayna = between
+        'بَينَ_وَ_وَ_وَ':             'بَينَ:gen', # bayna = between
         'بَينَمَا':            'بَينَ:gen',
         'بَينَمَا_لَم':         'بَينَ:gen',
         'تُجَاهَ':             'تُجَاهَ:gen', # tuǧāha = towards, facing
@@ -222,8 +224,10 @@ class FixEdeprels(Block):
         'خَارِجَ':             'خَارِجَ:gen', # ḫāriǧa = outside
         'خِلَالَ':              'خِلَالَ:gen', # ḫilāla = during
         'خَلفَ':              'خَلفَ:gen', # ḫalfa = behind
-        'دَاخِل':             'دَاخِلَ:gen', # dāḫila = inside of
-        'دَاخِلَ':             'دَاخِلَ:gen', # dāḫila = inside of
+        'دَاخِل':
+                    'دَاخِلَ:gen', # dāḫila = inside of
+        'دَاخِلَ':
+                    'دَاخِلَ:gen', # dāḫila = inside of
         'دُونَ':              'دُونَ:gen', # dūna = without
         'دُونَ_أَن':           'دُونَ:gen', # dūna ʾan = without
         'دُونَ_سِوَى':          'دُونَ:gen', # dūna siwā = without
@@ -245,9 +249,12 @@ class FixEdeprels(Block):
         'سِوَى_لِ':            'سِوَى:gen', # siwā = except for
         'ضِدَّ':               'ضِدَّ:gen', # ḍidda = against
         'ضِمنَ':              'ضِمنَ:gen', # ḍimna = within, inside, among
-        'طَالَمَا':            'طَالَمَا', # ṭālamā = as long as
-        'طالَما':            'طَالَمَا:gen',
-        'طَالَمَا_أَنَّ':         'طَالَمَا', # ṭālamā = as long as
+        'طَالَمَا':
+                    'طَالَمَا', # ṭālamā = as long as
+        'طالَما':
+                    'طَالَمَا', # ṭālamā = as long as
+        'طَالَمَا_أَنَّ':
+                    'طَالَمَا', # ṭālamā = as long as
         'طِوَالَ':             'طِوَالَ:gen', # ṭiwāla = throughout
         'طِيلَةَ':             'طِيلَةَ:gen', # ṭīlata = during
         'عبر':              'عَبرَ:gen',
@@ -265,18 +272,32 @@ class FixEdeprels(Block):
         'عَلَى_أَسَاس_أَنَّ':      'عَلَى_أَسَاسٍ:gen', # ʿalā ʾasāsin = based on
         'عَلَى_اِعتِبَار_أَنَّ':    'عَلَى_اِعتِبَارِ_أَنَّ', # ʿalā iʿtibāri ʾanna = considering that
         'عَلَى_إِلَّا':           'إِلَّا', # ʾillā = except, unless
-        'عَلَى_الفور':        'عَلَى:gen',
-        'عَلَى_إِلَى':          'عَلَى:gen',
-        'عَلَى_أَن':           'عَلَى:gen', # ʿalā = on
-        'عَلَى_أَنَّ':           'عَلَى:gen', # ʿalā = on
-        'عَلَى_أَن_بِ':         'عَلَى:gen', # ʿalā = on
-        'عَلَى_أَنَّ_مِن_شَأن':    'عَلَى:gen', # ʿalā = on
-        'عَلَى_أَنَّ_هُوَ':        'عَلَى:gen', # ʿalā = on
-        'عَلَى_أَنَّ_هُوَ_لَدَى':    'عَلَى:gen', # ʿalā = on
-        'عَلَى_بِ':            'عَلَى:gen',
-        'عَلَى_بِ_فِي':         'عَلَى:gen',
-        'عَلَى_بَينَ':          'عَلَى:gen',
-        'عَلَى_حَدّ':           'عَلَى:gen',
+        'عَلَى_الفور':
+                       'عَلَى:gen', # ʿalā = on
+        'عَلَى_إِلَى':
+                       'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَن':
+                       'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَنَّ':
+                       'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَن_بِ':
+                       'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَنَّ_عَلَى':
+                       'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَنَّ_مِن_شَأن':
+                       'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَنَّ_هُوَ':
+                       'عَلَى:gen', # ʿalā = on
+        'عَلَى_أَنَّ_هُوَ_لَدَى':
+                       'عَلَى:gen', # ʿalā = on
+        'عَلَى_بِ':
+                       'عَلَى:gen', # ʿalā = on
+        'عَلَى_بِ_فِي':
+                       'عَلَى:gen', # ʿalā = on
+        'عَلَى_بَينَ':
+                       'عَلَى:gen', # ʿalā = on
+        'عَلَى_حَدّ':
+                       'عَلَى:gen', # ʿalā = on
         'عَلَى_حِسَاب':         'عَلَى_حِسَابِ:gen', # ʿalā ḥisābi = at the expense of
         'عَلَى_حَسَبَ':          'حَسَبَ:gen', # ḥasaba = according to, depending on
         'عَلَى_حَولَ':          'عَلَى:gen',
@@ -526,6 +547,7 @@ class FixEdeprels(Block):
         'وَرَاءَ':             'وَرَاءَ:gen', # warāʾa = behind, past, beyond
         'وَسطَ':              'وَسطَ:gen', # wasṭa = in the middle
         'وِفقَ':              'وِفقَ:gen', # wifqa = according to
+        'وِفق_لِ':            'وِفقَ:gen', # wifqa = according to
         'ولو':              'إِذَا', # walaw = even if
         'ولو_أَنَّ':           'إِذَا' # walaw = even if
     }
@@ -543,47 +565,79 @@ def copy_case_from_adposition(self, node, adposition):
         else:
             return None
 
-    def process_node(self, node):
+    @staticmethod
+    def compose_edeprel(bdeprel, cdeprel):
+        """
+        Composes enhanced deprel from the basic part and optional case
+        enhancement.
+
+        Parameters
+        ----------
+        bdeprel : str
+            Basic deprel (can include subtype, e.g., 'acl:relcl').
+        cdeprel : TYPE
+            Case enhancement (can be composed of adposition and morphological
+            case, e.g., 'k:dat'). It is optional and it can be None or empty
+            string if there is no case enhancement.
+
+        Returns
+        -------
+        Full enhanced deprel (str).
+        """
+        assert(bdeprel[-1] != ':')
+        edeprel = bdeprel
+        if cdeprel:
+            assert(cdeprel[0] != ':')
+            edeprel += ':'+cdeprel
+        return edeprel
+
+    def process_tree(self, tree):
         """
         Occasionally the edeprels automatically derived from the Czech basic
         trees do not match the whitelist. For example, the noun is an
         abbreviation and its morphological case is unknown.
+
+        We cannot use the process_node() method because it ignores empty nodes.
         """
-        for edep in node.deps:
-            m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):', edep['deprel'])
-            if m:
-                solved = False
-                # Arabic clauses often start with وَ wa "and", which does not add
-                # much to the meaning but sometimes gets included in the enhanced
-                # case label. Remove it if there are more informative subsequent
-                # morphs.
-                edep['deprel'] = re.sub(r':وَ_', r':', edep['deprel'])
-                edep['deprel'] = re.sub(r':وَ:', r':', edep['deprel'])
-                edep['deprel'] = re.sub(r':وَ$', r'', edep['deprel'])
-                # If one of the following expressions occurs followed by another preposition
-                # or by morphological case, remove the additional case marking. For example,
-                # 'jako_v' becomes just 'jako'.
-                re_prefix = r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'
-                re_suffix = r'([_:].+)?$'
-                for x in self.outermost:
-                    exceptions = self.outermost[x]
-                    m = re.match(re_prefix + x + re_suffix, edep['deprel'])
-                    if m and (not m.group(2) or not (x + m.group(2)) in exceptions):
-                        edep['deprel'] = m.group(1)+':'+x
-                        solved = True
-                        break
-                if solved:
-                    continue
-                for x in self.unambiguous:
-                    # All secondary prepositions have only one fixed morphological case
-                    # they appear with, so we can replace whatever case we encounter with the correct one.
-                    m = re.match(r'^(obl(?::arg)?|nmod|advcl|acl(?::relcl)?):'+x+r'(?::(?:nom|gen|dat|acc|voc|loc|ins))?$', edep['deprel'])
-                    if m:
-                        edep['deprel'] = m.group(1)+':'+self.unambiguous[x]
-                        solved = True
-                        break
-                if solved:
+        for node in tree.descendants_and_empty:
+            for edep in node.deps:
+                if edep['deprel'] == 'advcl:pred:إِذَن':
+                    edep['deprel'] = 'advcl:pred'
                     continue
+                m = re.fullmatch(r'(obl(?::arg)?|nmod|advcl(?::pred)?|acl(?::relcl)?):(.+)', edep['deprel'])
+                if m:
+                    bdeprel = m.group(1)
+                    cdeprel = m.group(2)
+                    solved = False
+                    # Arabic clauses often start with وَ wa "and", which does not add
+                    # much to the meaning but sometimes gets included in the enhanced
+                    # case label. Remove it if there are more informative subsequent
+                    # morphs.
+                    cdeprel = re.sub(r'^وَ_', r'', cdeprel)
+                    cdeprel = re.sub(r'^وَ:', r'', cdeprel)
+                    cdeprel = re.sub(r'^وَ$', r'', cdeprel)
+                    edep['deprel'] = self.compose_edeprel(bdeprel, cdeprel)
+                    # If one of the following expressions occurs followed by another preposition
+                    # or by morphological case, remove the additional case marking.
+                    for x in self.outermost:
+                        exceptions = self.outermost[x]
+                        m = re.fullmatch(x+r'([_:].+)?', cdeprel)
+                        if m and m.group(1) and not x+m.group(1) in exceptions:
+                            cdeprel = x
+                            edep['deprel'] = self.compose_edeprel(bdeprel, cdeprel)
+                            solved = True
+                            break
+                    if solved:
+                        continue
+                    # Split preposition from morphological case (if any), normalize
+                    # the preposition and add the fixed morphological case where
+                    # applicable.
+                    m = re.fullmatch(r'([^:]+):(nom|gen|acc)', cdeprel)
+                    adposition = m.group(1) if m else cdeprel
+                    if adposition in self.unambiguous:
+                        cdeprel = self.unambiguous[adposition]
+                        edep['deprel'] = self.compose_edeprel(bdeprel, cdeprel)
+                        continue
 
     def set_basic_and_enhanced(self, node, parent, deprel, edeprel):
         '''

From e66067d75dc2828406c87167cbdd44c5bdf901b5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 4 Oct 2025 23:57:42 +0200
Subject: [PATCH 1295/1374] Partially cleaned up the code of Arabic
 FixEdeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index f06ed9d4..db0dc600 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -365,14 +365,20 @@ class FixEdeprels(Block):
         'فِي_حَقّ':            'فِي:gen',
         'فِي_حُكم':           'فِي:gen',
         'فِي_حَوَالَى':         'فِي:gen', # fi hawala = in around X
-        'فِي_حِين':           'فِي_حِينِ', # fī ḥīni = while
-        'فِي_حِينَ':           'فِي_حِينِ', # fī ḥīni = while
-        'فِي_حِين_أَنَّ':        'فِي_حِينِ',
+        'فِي_حِين':
+                    'فِي_حِينِ', # fī ḥīni = while
+        'فِي_حِينَ':
+                    'فِي_حِينِ', # fī ḥīni = while
+        'فِي_حِين_أَنَّ':
+                    'فِي_حِينِ', # fī ḥīni = while
+        'فِي_حِينَ_أَنَّ_هُوَ':
+                    'فِي_حِينِ', # fī ḥīni = while
         'فِي_خَارِجَ':          'خَارِجَ:gen', # ḫāriǧa = outside
         'فِي_خِتَام':          'فِي_خِتَامِ:gen', # fī ḫitāmi = in conclusion
         'فِي_خِتَامِ':          'فِي_خِتَامِ:gen', # fī ḫitāmi = in conclusion
         'فِي_خِلَالَ':           'فِي:gen',
-        'فِي_دَاخِل':          'دَاخِل:gen',
+        'فِي_دَاخِل':
+                      'دَاخِلَ:gen',
         'فِي_دَاخِلَ':          'فِي:gen',
         'فِي_سَبِيل':          'فِي_سَبِيلِ:gen', # fī sabīli = in order to
         'فِي_سِيَاق':          'فِي:gen',
@@ -601,9 +607,12 @@ def process_tree(self, tree):
         """
         for node in tree.descendants_and_empty:
             for edep in node.deps:
-                if edep['deprel'] == 'advcl:pred:إِذَن':
+                if edep['deprel'] == 'advcl:pred:إِذَن' or edep['deprel'] == 'advcl:pred:كدا' or edep['deprel'] == 'advcl:pred:لكن':
                     edep['deprel'] = 'advcl:pred'
                     continue
+                if edep['deprel'] == 'nmod:بِأَسْرِ:gen':
+                    edep['deprel'] = 'nmod'
+                    continue
                 m = re.fullmatch(r'(obl(?::arg)?|nmod|advcl(?::pred)?|acl(?::relcl)?):(.+)', edep['deprel'])
                 if m:
                     bdeprel = m.group(1)

From 35e138aecfd798ca1289b1dae18e893afabc3f4d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 7 Oct 2025 02:28:38 +0200
Subject: [PATCH 1296/1374] ud.JoinAsMwt more general, so one can inherit from
 that class

---
 udapi/block/ud/joinasmwt.py | 35 +++++++++++++++++++++++------------
 1 file changed, 23 insertions(+), 12 deletions(-)

diff --git a/udapi/block/ud/joinasmwt.py b/udapi/block/ud/joinasmwt.py
index 02c54206..8cedec68 100644
--- a/udapi/block/ud/joinasmwt.py
+++ b/udapi/block/ud/joinasmwt.py
@@ -22,19 +22,30 @@ def process_node(self, node):
         if node.multiword_token:
             return
         mwt_nodes = [node]
-        while (node.no_space_after and node.next_node and not node.next_node.multiword_token
-               and node.form[-1].isalpha() and node.next_node.form[0].isalpha()):
+        while (node.next_node and not node.next_node.multiword_token
+               and self.should_join(node, node.next_node)):
             node = node.next_node
             mwt_nodes.append(node)
         if len(mwt_nodes) > 1:
-            mwt_form = ''.join([n.form for n in mwt_nodes])
-            mwt = node.root.create_multiword_token(mwt_nodes, mwt_form)
-            if node.misc['SpaceAfter'] == 'No':
-                mwt.misc['SpaceAfter'] = 'No'
+            self.create_mwt(mwt_nodes)
+
+    def should_join(self, node, next_node):
+        return node.no_space_after and node.form[-1].isalpha() and next_node.form[0].isalpha()
+
+    def create_mwt(self, mwt_nodes):
+        mwt_form = ''.join([n.form for n in mwt_nodes])
+        mwt = node.root.create_multiword_token(mwt_nodes, mwt_form)
+        if node.misc['SpaceAfter'] == 'No':
+            mwt.misc['SpaceAfter'] = 'No'
+        for mwt_node in mwt_nodes:
+            del mwt_node.misc['SpaceAfter']
+        if self.revert_orig_form:
             for mwt_node in mwt_nodes:
-                del mwt_node.misc['SpaceAfter']
-            if self.revert_orig_form:
-                for mwt_node in mwt_nodes:
-                    if mwt_node.misc['OrigForm']:
-                        mwt_node.form = mwt_node.misc['OrigForm']
-                        del mwt_node.misc['OrigForm']
+                if mwt_node.misc['OrigForm']:
+                    mwt_node.form = mwt_node.misc['OrigForm']
+                    del mwt_node.misc['OrigForm']
+        self.postprocess_mwt()
+
+    # a helper method to be overriden
+    def postprocess_mwt(self, mwt):
+        pass

From c068a44a78ed21b9c000e254aabdd59a0d38c21a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Oct 2025 18:06:22 +0200
Subject: [PATCH 1297/1374] Tutorial: Missing udapi.core.mwt.feats.

---
 tutorial/udapi-tutorial-dz.odt | Bin 259128 -> 259240 bytes
 tutorial/udapi-tutorial-dz.pdf | Bin 380779 -> 400743 bytes
 2 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/tutorial/udapi-tutorial-dz.odt b/tutorial/udapi-tutorial-dz.odt
index 9590a314d6a77d3f594769c7a2363636d2037ce3..02889aed444fc65ac003bacf0cad4f4a921d86c7 100644
GIT binary patch
delta 37978
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
Qb>_=M_EHhC3A&8_5B_oVC;$Ke

delta 37889
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

diff --git a/tutorial/udapi-tutorial-dz.pdf b/tutorial/udapi-tutorial-dz.pdf
index 913121876c1ad91c7d6405b32b2a1d76b51e0edf..278a5e937604452efdbb59a71d92a29ba44cd6fd 100644
GIT binary patch
delta 113907
zcmV)7K*zu9o)_o37?4SSwOU(??6?trpI>3fTj2PpN|Gf*(=hIK=R)>jvjceudD!eF
zY?3|69u92s?^BXWH(S!o9tZ<HZMP+rs=oT_B8wTOpP$}8fBf{r_g{bWY1+QHJ^eI^
zNz4N6q*pzo(UVm$+XbeN-#z{5*VBimot}FCTew`_e{uWWeG=Dy>vrdH^!M>^Put6r
zUS>NP`V@AZUcQ~)KVSko<Mi_VpDzNgcoBGgN1yTv7oq%Def`VJ@1ORUr!T`2U;X>*
z4{;IbFCt}L1Se2&32;le72Nc6p~d3=8~<r(Ir?!GNDqWt&xiH@@WY3H#PzXSf7Sxl
zMHs6jivlEz)IDK;wsNtXxQpFO#{xb4=jv{*m++In1;P!wU*E~F2~79JmPP$(0xuNl
zx0d0XAD;y2=jXG?fBempnBKv>Oh3{fOAq;re@<VuR4-eqmq6HPZubIkeffLGjH+)&
zVP_+GDmg(yiWSa|z;^U7p^u=s@acYVb|ssx@j|mj-RDMsH=o_0En-gG+%xwu>+ZCQ
z@!^NR34(SJ7Xt)I&pmjopUTjmUmZNSK-1!GC<Ku(qngD6!*=z;ryT@=_9)UGCb2BP
zgmr*P{R$@KO4iXm&2C{Me%D~Zxg<OnJ92m<q_K9QNU)JEbQ&l&($oz$me<gz1~3nT
zcwm|lFqH#;rdVegE;_(mnqU&>ouIjCxL*}*f%Lkw{BpoKrVG|(#To2LrO)i5!PT81
z1Bfc)+lXdEppo(N!8iy?j(~GtJvaiCEJ<G>yFh1zIwKq&!l0lD(2Ic1yody{@T<-<
zWx!%WIj<U*@<S|%YEbdbz1kmY+Kr$Gc&Eny{thpHM|Z^Fjd2lq)#`$aTidv;>|O*0
zT9^SgcW+=N+qaU@^K!<(l7kNmMB>JsuvNV3jbGnfqnidFIq^c)JY3SH<rTtB9^{v^
z<S`~)daXrO6$URUDGXz^+-Sse+JP4-NzLGiF!IK7sG=c}cmk^+TL^ehn+wC{g4REk
zw(`h-3V7zgQxKTsZN#YxRXoy=q3PDX>GYZdOEw+n4cV81a9gd6gDXV+WrHMRM}-H<
z^HePZK1}jO&ETyDmf<7}h}us$B5y^y&R}=8z%`>{FDy3F5;PMmiFnkL%2Bh(d^}ja
zpAVL3rdLwSS?QiF9A>n2-s`tV6hOElY&&g#z>T$SBR1(y&?|#xWn=Lr8$zamLxo@;
zHwtHcj&&iZ5``^^HjBuci~u<=#b*M$H#xG16~xUcr3hmm42YBilzb3*#1R@uP8cfh
zj4tYx$=Rw0B2B7MSJB}>J2{I<Vr(NFHnX~*L(0?Fb8u_sCkgbJ_<~sHktsiBxQ@Ah
zM5ULc^|X^xM<L+2C}mhxNwLA-N>vn#(2b~1`YHP?geZoF)f<_gfGgweusnn07z}Ys
zisc<T55QXpcPc@Ie#988!z|H|K}*bvz?(G*lyAU&KYLy%>rv-WCkn<q@uCm8UKQcC
zamMiCJ1rD(F8oqu1_$t&`i4zUaANL%;AuGSL<JNzAm+rma4^pW%{Y|88(yLC7>+~9
z0#Wa*>OD{vCmfu;dnpVS`Tc;zMz+yi+i0t2d*;u=HlPW!F*e_l+<wDriYPi~A0cvi
z93Cp7peiQY=t(+6wgY4J?H_Z^gn=NB=jWJy)W&SD@H#GFEv6YH5eL9kN($+Jb}Ryu
zCik)usf;2Qsy<p)aqibGU7=lWcndF7s<bMsM+wJNITlfl(`90zr1v7bD_pG;a8Q%}
za^Z^ilnWk{AX5*wF{4j`=(ET*@pwu<BRYUn$w%_F0^yj8>}s#A(%r)}NzJ*I%dWcS
zwNy8@OfoiazuMCpXLEAk7!b05AHsbca{HBv#&yOMfG8cW48G*@G6&BS=V7G0in?0i
z+ef}V<zF6pxvET2F%f8viyLn^<#0vCQ@Cw5?4xjP&mf#`=Q6Y`EUN0~$hu_*1lHGD
zAlA5UKwH26w-yLq&N~ew@-91_l3Lz3c1o0KbV^>n`_HFeq4?{+zWr~1YGSrqwNlMX
zTSqR3j2?3wWV(Y!Zif9vE>YRMoa5x~FcQN+K@gEsJYcpm<ddOdM?%Izy(qxTQg~@r
zjK455g4O-6%Y?|FMb39(!jP3<qkGd7AjXQw)0vj*I8oDToi_xG+mb8}eaHcUVZZKD
z>oUWcz`S^c1C1tc79<pZq^Sa}X4esAgEliZGvyUdlO<85>y<eIC*_NfoOF_sgrjrM
z4Pr!qh{LMlX*HT7ZHA6qB<+~7Hp?XJaOsg@>b4Uyg-OE4p=>MUS@}8iIi2-r!_Y8y
zGu^YyP$TD&yCXq9T6~lEO79N)S+g?htj|@b3jLlSKR18s?f8U$QpFZ))K66&C$N*}
zo;)b!s@Z>zB`)Wzbvjk@L!C6AGP1YYkB1*qIh8w-H_sle7Atb4im|h@q;-M-BeV2V
zUA4$roFl1;WkE;J$L0vwszTw!q(EYDMc4}uY0w`g<FyWK4hk;{q*Dhq#+N>_D?&YS
zd)32tRn4KgJxg<c=iaFbTZq<qu-_NHRCJ3Es5<uzt0PPEN^%qos+L)u{p@Y2k?(50
ztD7E?28wXEC-zAOW10y@JvLZj%k9%vmQ)G;#vEyJ4~<Tfu$i8dgtP7_DV-*9Qz4=$
zd<clm##~FWcUI|b%2ZC};@*WvSshjdcRJUUQYuz)M1GNf2W*I;tSV`JL<s#(y`l_o
zJrlyY=YC7vxmHIVY5#}gu@v~EE~CpP>X=wnNZOyuVpfqY*!QgZv6Q|%V&RGdJWr;F
z6e|^1u}mo9s_~&A2a&qn8{B6t`kwvsr2NdlRI>j%h5|XuZX>F|sXy~T*G*ucAv)Fi
zRs-gy{T9oA##4W;N|fa}#`5o#gOr4kkCyl_#-=XrVCVhPLQ?9Nnmx+|5E4lDIz~T<
zl+AS4Eb~&&XR7&xaxa?rIJ@xKKdFsAH~->?^Xi>`0r40mu(FvAqk`k&X)|tFbW08<
zZDz%2RDVZ<$#Uv8FRKDDi!$!TAtSW4C^gbWq+*DFAqOqY*jdbi7%bOJNpMv}=sjzU
zHQem?NKi-ll7^irp9#SIDVq^QD)CwRT|Y;^Qkj8%M=$2|X+tii!SKE=Z>6U$Y}3Z%
znms!Ovg&mRQ+6E7!-XPTVWRfc4`RyL<J$qAqFlCEk#(+({jtE7j%|)-c!whff1~PR
z9+T#OoaoS#rVav`<%$gG*!|rOG+**M*BAqeQv-_A&>;8Ja!wo6<!Qk|w6eHOVY&Cx
zRm^g3MXJiDrooiY)p2HOBYMo_2wuHa6>S>hGgrZdNn9ux1p(FXQAo;E&R)HE?Rat?
zct?|t*Ts=fIqO>-TQymjit>(tZy<KnETchxE}tP?#j_BnQaE=eb1n+5A-{pj@olg`
zlXua-PWa2EEg82={nNY%N6RO{HPr;W3(kZ2n|Uv4)tz);C7mc1%E=b!p~yMRTN4Vf
zgN32Bu*(KNL**J<00|C8!E-%rVx^pN@j`Eo9Dqb8_P*0r&=-(6Hi4Ec;lZL4zO~?g
zP<ZtUUclP!M&5uIt(zteAZ$+RSaFS7Ad{|MKX$l@<&{m4H#%=^D#yQkEbf4V`AusR
zoW^uEaT^N!nwLr{&Q(X?9VFaIXoApSg|&%rA$kHkJpct3aIa&pBjFeEitqvYLgaU(
z(lU~!_V9;?2re+d&eHT!@UMBbr+0-hEm;zFbS-xJPk)lWFGLs=Ls1Zx;y3MCdUfBO
z=LzjGM<Z#>Ldd&Sf_*vt4}sHYB$F{z6AUvTFd%PYY6>zqG&PfT2|<62S50r^HVnP{
zSLj?|JR)UTGB7YOpY0Z1py>|KL(xOJ%?4?kWD{hu=)W&TQL^l@XNv%nu`HWUe2<SD
zU4!~st+%gl51(#7zNy{&ef6TW(zQmfY-ek9R`~{M--3F*tA71XJyl2AwLU%Ee|f#z
zY}W7h?+!}${qC@@Zq$E^vTf}YdRK$*=s&8a^ZC&iUZDWInzy3q)W^qa{qE5ib$C`c
zF~*0_w@)bo3=zJCk9W}D>wUF5R}{o6v{*X|a{g1TPeuW%^QYf7*!I?Lv;pXGqiw%}
z4Yc{IZu#@n(}&kaJJ5Q|dwlvvkGh`stZ)NJmwSypuN(Rj7cqanfcMa2^uc%Zk>1HK
z=Qt6A<F)V{U&@6xxTlTi!v!A0SLjVZPA_o`0W?IoDJlmt(9sRxcSKyY-3xZh0Rw78
zdOyeEML>C^0Lws+{JiA{d~b1M+KAGH1Wh9Kzn_1sj^}EION?C3@nn46UGSuvm_kOp
zEsnV(7|zHQ9^!vJP7pyl%ChHF`3MVhayg|!Xe)e63c}Jib3mZNqVJoemxK%=u-2Er
zn79=tU{K;pNsA%jfQC}s#N)=h&7iV<#EF?OMk`tZM9V7l6sO6r6b<&aA!rj~e!xVF
zS*8Vm%b95b1ugjo69WQ;rPYY6IF*3{zGl(tj+3o-dVhaK7tJC7=yYxUg)a7y5k9#W
z7D7pKo?*ySswPfjN!BjapdrGggt&$?wTW#%5&`)M$}1cqD}UgGpm-_EBD^pm1!kC~
zs5{x(3H^kr2N(2#0bn9}rqUr6`YLH7iq*<XF}ahQ>>Aa0I=^7CgBOXzh4T-bO}H_x
zZtN^O!2y5He=QJgmx*>wtuG8f4z9hFaXt`(4wC0nP|XY{%=Ud*G;^7cZaER>PY+Lj
zC(P{#b8R(rt#-aK0w1W4xdr@0<2I+1+6U_)UNrKF;e1DdD_SNgum(r=lZ2a^h^QiI
zM_j!rBqA3@J1aeO;5wr4LE9p+;8n?B#I+6-W0!wzlha&?12{Y65Tj&JYu9x7^)hw8
zd|zp`g1S+U3R_=ey!c0bn3Ij0lTBl7-PtAK9AXVOgDlFzk7|HeXrYOT=C62^UzV<=
zVz~6EW3qPKh%+U2{YAZs*Wlpxtk2y<vTUgA6UJ=}ZP9!~XYY%xAQ_&&=ugyMEI+_=
zO>BP@I2)uKLs$eR=`eg9w3wS{T6ATM<U^iIH6Aj1cOiIwI*vhCDCm|cX!P9pupK!m
zMR(B-j>+h+h66np4|HgPqktrMVCN%olfhePL+at6JL(XJFf|Q#sKibb|DgAH#U}yg
zLSx(1cHyk73QV(Nq6Q~ip&i#mTNuPJ!}5O!lG}lm-q;o@8n|AfQ<QkjYM4s&|4)su
zJT?NFy1gvDl6R2lE+fuex|qIlmo_q0lzlU$R>LH<#fe6l99q5Ji&>YG3Qu_{DKf}W
z$|bX@WQ+0}{Uq=K3YgisKObTu{9#DJEk%{?;EMFe+FbO31os+C%Tpw1`cb$r+@D{{
zu3qXYW{h$+wE7u?nbO6*(-<#1y_hOZ;-@Tz^iE0Lc5<lvqnJ*1{`d3U`sdsGho{@O
zhvz3c@s~f|!rJNi`R(qt>U%YFW<$R@E&WQZaXK3r7}flZ`VZFxT(OfeR1*y|Fd#4>
zZ(?c+F)}nTv(^p0Mt|L0S&tmI5q{raF+kn|Y>O<CO*XI?V9p${0XtqG4@MqjTQ-!~
zk|QW^{O?m_@$4>gMr%I>3$1p0x{G9;Umd+-lDl6XUL8JseEa?DZ$IvipPwH7y%Rez
z32-~Jm<g=eIV~qQ%iV`J4}bsT?%l%$?|Svs&#&J-J-zz;^naK0PVD!`b9@rNKK$@-
ze10(V<aXB1lTgd<`Mce#>%5b4_x$~nkOG9-KmYUL^8E1SmYn3sA)&b?XEQl@k!NA0
z5)1x2ijz1CB`)|i<5E{4`%3}0lyt7UbuA2TeipV*Q*kr_<eFyLf1j4lv?e3ug6lf1
z8nSNE9kNaw`hSECyGayum&tuvb4^QTT5f_4Ej)%e;$pKrfWhAsifrlAx7=P8h?g+b
zRkT``CbG86&=YvYJ%RFCAQf&O@OK+@A|3*Np7FQyi1iD19Br2#yW~LEWHvon6LY4=
z8!4n$Ul@>N&Cf{aigUnj37l?_YnbIEN2(z;NYCY=tAAjPO~T@Z$SxoOoq{xefgrrb
zT?`h|eIKXnBwbub;gNBjub;r};R&h3{t^FI;<}el@+2(ibP44upU`d1`$zmJe5bnr
zx1t1HFh~U@;vYDK`{X{53%>{*C?Kg*yxkJfB|hTsgLFr;6DM6>!G8z;*d-IT>Ctik
z`oPhh;eTS<OQ3+e&X1USrxu^NL@G`a6}A7z^Iv<MW?hp8H3`%5`lbFv&g=>p?Pk-F
zW@1|q&1mziuOc;(%e4GveRl(WuNTNWmq($L_M*53nFakgdbvoGrFtZ(4)o|s`f&*g
zkYpb}_0Q%Tt#^un7|{kJUAhpKM9Th7ulJDD-hV$d)7^Mmpa=Or@39U=NnO!ZIuS^3
z$A@e`@kf&>tMs4?$~crC>zqk`0;YMZ7?s5)3-LDFT1Yl3WI)&#oP*sYt4``A(w&t%
zsE<QZ3C9+meTixN*#<%HjedfeOl=Q%ze4WKnRkhiaa)<gP;)O?bMQQXfT~s!lCh@+
z2Y=jc*$K%Xpg0`5U`Wj9_@ZVhxsdLNxco5-l6Eza4)lTM>}JN<e^SJjmJg24Z~pu7
z4<NpI|J|>7BW#Q$_|)tq>dDi{rhx^apmm4X*D)%<#(X0mQ<RY;D=&sK=@*5X<oSb2
zoYP~;uoQltE|iDpvt)+k%aem=97)uo%74V^p$jSfwFESJARGTk`fRKx>CcGRH@1lf
zaeJLi(e9gF1SR*{9ef^;%kv*D!H}d~M{qhWvD52*<E0u0*K?vN;EVYAB@wNx&t-?8
zvoU7gMmMaI6HZ<^3WPaJC78;Ws3dEW!zD@bk_D4xR7ZE)LV~d;g+5@K4NPhqsDF%?
z6*}nb`|?)WL-@T&{M6r#9s%{nZy%BaI^h)+eNEiF7YanD6g>~|vk_HdSOvKhu`}VB
zyrHN@;GN@%WI(1DoxgXx+t@hb77Kcm5fkR$4ZkvwM^7fbOpa3D17Lv%JqW9m=}5%$
zCj{gR9mAv`H5aW6@M0-UDyUV|Vt)*Fn1dC{NsZajhf%XKlh}sg6<D1M;HfNZYnoLM
z6!g$#gO!6VlEPOJ8_KzOHHtf`U0q|;C4Q&tt}*u-L=}LB5Qfx=&P7ZotM{Txcq+R%
zQ=yRtq-<e)1}Q<F=>7a7XKzghfA1;Sm)lF1P<@>&5TiySWsxh1RJzG@{C`2>RgPE1
zIX^-bZ>)3~C`C-80J0hD;{3@r8=f$^*<9`*pOZ+zwOF+OF+HP19fAoEHUO_limr7`
zIR<VXGQi6)u;aWd7c^&8%134W(OOcMN*79m+eVL(K>JV`Gwf+uXK9H00F#>q0oa``
zOR;cIs<~aDO?4Vy1g!$a2!C6FW>6awYg8$x5CB>AH|cHzi_eks1!`qsDGs+0=Uuc&
z)TXqkNGQDuB({X0I=y*`YN2OHHe4TKAaKPOhP=Ry)05p=@F(e$Vqq}iUu|0YtU@6k
zlZSxa&Uh{eNZx-9>TrrL)Ji!y(>sy(KA2Ytxp(5Jau!LuLb%kG+ka?{Hs?h#CytDX
zt{VMa@ZlZ&y+R)ee^-KJe8noTl&6_s7>uFvUn61l(Vdy?q_?&iQmZyGZi`gM6xr@i
zLnLv5h#VVtyf$kS!=8^^I)TWci3D!caib01IfSbe<V(&~oGo9(+gKfADT$i%fvILp
z^j`8X5)TU}Nj%yV*ME6$M@F&WF|=eFdbXh#(`?UP`tD5?jr7x6G>XN7lxy>cxu-|N
zq7ksVf1&}gg)4G{lN0d7eyiuwY+%%4AddmD+O2af5mFl^3+&G4P<V!L7I_tPp3$!P
zW*b14yoG@Xb#~u%>%*f1o|qA5-01~`PiN!>zZCu)Yd`oC@_$~K!28Q!QP%H8QFF@<
zPrx_fob54WD8~7Q7-7+q?$Gt-c=7xh(C>8NY>()uZKWM2JEc0L5PJ1Vu`pC=F?AH-
zmcKEqaj99X51RdrcWj4Yvz0|o%5@EExW8gX)4XUY?X0cu*jr(o17!ezNz#`pEw-qx
z^nDENFW0ZSA%F1TijxT&$x>oYWt&_u&Un?v(o9>J3I(<lvYXl_M1-|QHB~{6?`)V{
zx0vgUC{@y8od$C0NV<%aj;Up~$|kGQzy|E4dcTWRgYscKca3LM0}h&^{|Y#S3%1VM
zZ*??GAF1gD9mTekvPxrMRWMFWxFi9sO00(hkOG=DzJKi^=d{~4^Xb)32p^V?hB29Q
zRh?;_UfoW>l4>xe8N(pb8lJUfqY=mX2Bx&W($?_2>H;o^2QK0W3+C^ATjXnavzm<Q
zNVA~W)RxV)PnRr6QrG5=GNtL)<+N2?330_p2>qzgqsVzkEtHixmLeQwB*9f&`rT)y
z1p#QcB7c^VQ}?Y_=MjuH{hF0Fm?nPeV3T2ERe;eAz29T9Y37S3VYG?g{2j1)=KEe@
zwyAT10Wo$qgeIDJVgobzGi0*;fTg7>9dfyo^CU@2&!Hwp-WQd_CxJ0UQN|ZMl~<;q
zcq)9ReYA=RnRn<RB$4-uZqRG~K)dF?XZF#0Yky42QN(n2xWW=j=+@YT^6mh=vafb~
zJz7U!CWodN%~!xnTxNY_T}z-{tn%b4e%E%KD4M#Dkc+=cJz+|SeuRqls_Kb{q`s-{
zroyz0jnFil;IcD(LFIGqXV(gi*=~y;Y}-E1F^raCJ-+iM(k#W8$N`Rc>On3uv(8*<
z+kZJn=-s#EK70G_UzuF%Eb9~`Qa0Lmvv?Mv>K(FbNvdtpu#nX8yYJjJg>7m-75tG(
z+bzVnM2(Dvw_|D$=%Q8-f7uLORDtF&+y&D_PEn_dIJh_+Q_kh0Iuba-z?LB@b(x_k
zMoN^>X|-JZ_NNCi+1)Q&rvL3v4`TNyQGZi@+M&&3j0wN|xciEg-f}~Fq~2!XIyJ-)
zc?UmogC_AK7QK^gFb8fHzVEn;o7CpC%|t059F4(%&^hBdAk~daLwA!$={($x&UIC2
zj6KHKNL>xQWPj&UgQ7t1T=p#mPmhR0r=vuJTSFcJ1m;$F^8Wz<+R$-;GDWb4QGWyH
zWcv*PrGabER3{u1wo{X>0(+smR*un(F;(gljI%Ubs;)>4baMecbzN%yURKfp8%3Lo
z)N6q@8ACI*pks9(O2L>?z*DOSE=6xsapY2mU#J78gOcCYjocO=k44AU;z)EbPkIaF
z*`d5jW|?`v5s#B*Q~K<-IbD;DMt?xFPBKgwHp@)6RpCC4{4gVk)f`_>Y^$l6&B98P
zbC9dCk#J8`Bx=u|Z<<yg#9}VM%sMgY(<wWv(AkM_DxPrzM%dgcCXQ`mh7J;j0@PBs
zGiW&#M*KvaQ~;VVt8Ebo1<w1(4Ry*E?jMb01PZ+pfhnOmsDH+&zCRMGAb(UzC{3ev
z!KCg!oxPgL%S}7oR&Oe$u3}XqB;}(IC#9!RZfN`20I=CW8vb@67MVCX)l@kiv-Du=
zB1(dt=F*@rwHb5Tjt`VV8bE7hNhlR4Z&qJ&*^lj4*7d@szE>3vgG68{8d+>MaHBhx
zUaC3a^u;5=wtP6U%|84G9)JEv4pb$=n2c0IiDd>41)<PE%sGrC2HTKS<;k8f;A<KO
zoCkc*P1$6Hhz+?4RlD7}q>?FXY%@SIb()Dh2ZKE%1ICM1J&ndD(H)#B9}?#$A0bC%
zMdN!}4&M5QFG$=T7Pf5aL}Hr71RaB7hO_E8Rs}ZKOa_q!q7#zbV}C)dM9yyN0Ut<q
zRoGQJ(nY~5H`t7{v2&s{I~AkBc3QQ(@{y9F5g+?CKR{P!Us6Z1Y+=nUYnu0zku2MN
zT@b`{XnjJ8?7Dfv3pVO*HCp8i-Aya%4iBggUS(uSj=QUl?XH3VmKgfD84W<DZK4jw
z#;TAKb3pv=-~?y5;D7&Dyw8LNI0i{2$}_1&i%<Jz<RZ{Bs}Qlmu&*2_sngtcNl8I5
zrNpw)+znPE*|9#K-n(HJ06epT-*XPavHna+JwdyLY={RWe;Hv8$M<wY@04fTtv#}K
zO}$fokA4vFD#d^#-`{n8(GK>v6np;U-YLJB8}(}zHbJI2jei&McVUfO!`$WXO&wU+
zOhX%Z5r6ed_^VCVj1Wl<J1Ps`YYQ*azKp}2cLSFWe{c5wmwxz^3zx~Q@lzRPFNn4R
z@u`lJ-m+_FS78I?R&CE*3~H<B1Z`~T>M~P%>t;cLxv{!u08(Wt6*$rY73Q~;(8Y^&
zQK&%Tx@Mmjq<^$0<bAdSx&qPM3@%OnA#hy!T|epAOw1DADrKQmSjxkmHURPRN?pE_
zI2D_sWnR5ID10sNygWjD^M&4dVaq8o<I1U0(-mpQFjgF?i^I!Z#bG)BKNj|F%Ccj1
z>KGqrEBH(Wym~NfuTH#=9@69jVz20(7<y-oAMb`?)qfjz*?9-3BfC)a-gL-6`{u_&
zk^fsA+V5Vgl4QA50U7<R0KrDL1=hsYBYh*1{ND$VK0Y)wtCybCrSX5%u&Lj5ZOaYo
z;!CgoS=B+B7n-Yg2nT#-t3$+R=}KI>kI!t-BtF-~a?H#Sc|?>AoD$5M>YCG4S*|I^
zrh3t->VIM<_myfO)xc4CAEFcqE5V>D54g+5=)he+H2G=FWur%6ZcVGoMsNJN5Ghy$
zOgdbXTroD3=tHTjluAnzJ}PokFD<ph<|T!Cxa-)C7OaCt{zF2z`R8AMe)H;!*FU^{
z_xj`8_wVpf|M}*lzjl59{^Oeu5BvR&iLwfOcM=l;A*_q1>e}$=%iaF~l={~ClQC2j
zlaFBu135J}lbc~df6ZG<izLSpzR$1dvtep8BA*3ALqCm;1hzHcgYaP`OJZ$lB`s@&
z|Gguhm02B`J=N%7hTWO&s*22be-RlaCfNP<^zQKK^M~)>fBSiN{POhl>rU*%B+%{j
ztS7X3=M+rN!0yv`Pk;Zz?&H&i?t1sdH$T3-y!-O>r}IwifA`08dXRoT{qS^reX?qD
zJ8R`MyLtEe&)vJL+X3!gzkd<1fBo0f<@M>Wk<wScy#JU<0Y_@aH7UCT@TA}%v^a}H
zpCEDs0p<x?iZX8Q>lY#AMMxrvFTx4jKhtmA!wa0m)qemKGa>+8hjbk*T^D-)Om}Je
z9lr6;NxI|ef3G>BM^}lir8{Kvbfg|1IEIz|o&GV9bn8ry<i|Z}`iOBS!h{vi`+vOt
zx#GT3jO;5$&6D1u7}ZxyO{yqH3#9GOBh_eDHK^A#SE>OMq#zuL<w(DS6i6zvmV6da
zP=Zc^4yp)}1QB#ge?U@{*GQ7GP1l6CgQ!)czk)_Ef2i=JM7Xokexu)LJ;$_cQYmUk
zbmdB8wNMNv6eZ*&H7{u?g(2QAk_018V(!b^vZS?{K(hk(8|@NveS45NNx32gt9^a(
z;p4wEsktFFX#ukl)+w2(nu&rCNA_zk<U`RMxae5%gG&G73nVorB^^P)364>37EE=w
zAe{$2f4ijk@Ob?88Ozt?{|<H5GC5>={8Wtb6rVJUFGoW=B)jo3p}*!cB&)JH1O;;9
zLN`~IeMt}4M4E0p`i(8-_3I9TRAJW&@!OxC#AJ8B-HQBge|!?VXPDIPr=8S#n&XEb
zcVDsLnhpI*<79doqj;rgpXAG~c$*9o!E=&wf7FPJOa}H*4xI)DX#@0RZz2gP&yp-<
zlyZ*i5)brcR1WGAijT=_QB}eZH%9NyE??gpVooN#iaB)kn%0EEAyEkIMnj#e&=G7b
zDtfW*u{hYICzT69q!vgHBDBz%G=bzBC2&iH78Lz`5QtXll>;wX2Ks5n%rMDK`M;lM
ze;Qh4<9^ecbcf<HpvtEjvQO2LU88_YOcL1%F@J&4=Yo+Wr7o^sl64FPn6#MUe{tsg
zfdArD)1aK6Gli?rKu$$DWku7lH>Oum3$r848_Kj|=&-QZ9$<hSn#iQsc$3c-RFlPW
zs6$RIV=e8ZH7n#{dI2^MMmr$Og4;xJe<O{>WoXApmy+%VcnR1P8CTVU0ZcgHfX$Eq
zVoj`=vU#I1&n#hWTe54^B#5pz0E%K!jWJoaNXey-E{c<nZ9$OFc+V{;%=Znk>l!{W
z%zG?}Ij<QX>;dwuX3<8}0dnrzs|)tZNOEYe$R@(1Z7I1t7=k$=krg_O?(Gv^fBbj^
z3CHlUtA!>4NxUvO&6e+_NWMEqMO?f~BoPPP+!Pf#GgkOTq_`7(D8TT1E$I6gpAY6$
zX>17^9e%@xGdfT4C<1_{1Tzb^&-~oUg2;k`q!KU;Dj?5NFXQl8yk{k#XMAal56<3_
z;o`B5myRm3D<4ulai~MA4Usq3e;k)kbrko^!Fb671yEiq?`!Is=)hf*sPhHL9Mvyk
zalJ?=`B!U#I=N&=wb_c*zIgFSTb)8ZXiJC*Zyl(`ZW(2xM^9PCX{W6zhR8JB3kzr{
zD^EhVo4LhLZ4@VyuwW_l`ttN7E@%fKgoQp5XOE>jA|M;vBT3vPZi6Rhf7RCsFam53
zZ({*dL)j{ex29Nw)VW3nQKwm+4LERP$?`xfXjwbFZSYirt;I@JpU@P;jF^cvi&p}u
zAQhaX-XwAsWk{(fY`0U&*kcz3Ba0mZ3f9_fYqns&x^8HdZi|=1L7WB@dC(C0U=7JN
z0*=Wdmzq)6OZu+CL#cI2e^kl^?TO6puoxQTu1t$Cn^NoIo%upYz(0S@(Ka=EDAbtT
zmU&a-CWnaFxxr!Mrpd7z8aI+f08wWO767olZzK6cru1Z5(oI~T@)|c(*PV*E?p@4d
z{@DPIHsF6&0$@nwP?es^ihbcJ4f(qFU&IsLMfEU*A~bt9IBCV1e=v4mYHScE0@JKn
zv5lNtvavZjH$jP6Zg6hN#=vMOHLVf?&mO7`=&?Zz0KIwC1lbmMTPMBMhgaDplvl}-
zLR5g48od`B1G;H|mGyi>#G;2I7}2jMi%0=2LD5j8R?hE@Gg)nwgW5Kq4Dm&Pho)v9
ztCB*>HT_?3A(~xUf0$#(_TH}*)l512HlVJG=!-aK_PEd%@ngeSTlp{TWg9RXi{def
zt7PZ;bRwXDj0UTQRw93`C7VHFE4Wnlr3TjxNX*>=8!xdbq!W2nZhyA1yuE9ro_-2d
zPBIOI4BjhHo^VlAQ08V{>oK1AgmSu)mnw#KNyX8kztOhYe>_d0&v$Q|jWY--1d4)x
z2C-4Gxrz{!kJTOV#J25V>xxZN+IWc*!mu|a2{8qewCiq{UR57Mi7CEt5N=YsU3k>&
z9LS0<1}OHg=~wYJ7k8KO*4eBAb5!=7t>1-wip?{qtv~PSZoF#Sl&<v{J7u@8-1u#X
zN%830=t=S1f4?0vDgLYr9Kqd=G0Kc3ZQuoSt3ID6rT}ya*Hf>`w`SllVv&tP(I=!~
z+Sw3)2AnMcVgjSA(9WTx57OpO^ueT+$d!>_361|59M19$Eg`!b&!!1J`gnBaKY6JR
z78!&Lgh_1|kH+od;a0jU9zH5~@pLwR5HpZC*prqKe?x4Hh$0e(=_213k=`yMZY8ur
zjf!i{x_8*QoM8b-8+L9t@0?xfu5$U-Jt?=haYm`h4+dFSSFUUc49^JKI6r$sTxpyY
zkr$H=-x{<kM{v<&t2(ahuWDGwMk<I*hwOEv69bPip;gZgsLb=F-LP?E_+r!9E>SUL
zLO#TVe-zMT!51bTN0MF0AtQX#Ps=VNV{Pci7%{fXh#PL7PvNfX<Z_k+tYz4=9YcmS
z%(3;|kYU{Rkio5VFJu_Lzve?mXXD+FF&N+x4`~->kEnRIO2~lZb>do^F5J<-WfQnW
z(bw33Se3g?`IkxB9uM+J(nNV8Y-sQZ;b2U7e|ZA^JNy5s2==hVcNxxj939$PzG)N;
z(7@!j8=zI&4Uk*uo&j3Ev+fPBvvGFhW3YgE%=jF3S$b2xvTRI1LRlT1tS40(VtqU=
zm0^w_?(26u9%om2OV)F2>W;gYNQ&6Jdk5Qh&#iRNI$ftom)(tTv`+U}22a+>vJ?~&
ze`dlCq12vZSQ#pa&E{x2`WacOWBobm8mNSSK-XrwuDO*66O2SKNa2En{lLB-Na5T{
zcWtzv!aEz^XruFk={wpe%hH=7=*%YR6hS$%@t9?#lNldF{mS)Ok!SB<Lq_`9*+c&a
zx+(Ma?98ro&$i}ncJ6Kb!FIviFS^NZe;?_n%-f4@cBKYt232o^nsYyO`<~_ljgWbJ
z>SkBEr+g6IURrPGHa0l7>)$in6_dh8x-JBsx66rJO1e5;`9gMadS9QftLAuzw+cCE
z^^zF-97EOW)uqdg`Fu(5!G+^5-}ViM5#i5pZ5|C+3%+wNsBG8ms`a6(tA=bve;KZb
zM|F7)!XJ5tgAuBeX)kdWvVAFNeGFL5n3vN;^wWK|bn3(Gd11PG72@_Vv5Y*ob8vBn
z3^1MRT5-waW94uzjS#p%q?((%8Fi0uDh%b@M?b!rEtuqY)hU0D9(CHRx>2Wci%yq=
zqu#Jxb%b5cYVr$ZHqGL$&n<5bf3~xo`7yu){TU~1vNc4FrMbR1k(=jh4!47VWrnAE
zJHlnV%%knq$zC;LQVlkS<N1^Sf2gEByaekebK`bz7yccK?57{ldcpR;t3~z@X|Tw8
z)&Kt}bKR%m5HeB3WR=NO4q5;A-mq!T-LLhTdiB;#KCWxty18+#YVx@`f45%^FAQHg
z>X+l-$H;Hb(3vf>EOX<wVaPhYg_ciO^RPZA^BZ$+Uh-wQ=>rD<#k?pRhnw+MW|7Gg
znMWCxuHJ2`2ln#ou=(wb<?(bw8Ue3Ikk+FCBm3-(`P9?a^q6{ChL12$Al(^0s;2a-
z`Q~b({<-BL@>W*P(;?mAf1kmdUib9KwpxN7XE&+agKy8L^lv0#3{i0^sf+;nJ)h$(
zp5qWS=9CxqV3*nBB!Zi<`PIZ%lbnj$*#Yx%bDp1BCfu_$gObu5l^;^duW24zZ&%d>
zPwgu?DpoUA(HiskLOW4L#u^4H!!2rWTu%x;m64WS|NF~#@BZ@sGKUWz-+%t_^GDL&
zf4=$bzq|hY^XKnAJ?-~9Mtu_fOo*PB!Z}YZsusHcb@xAJ=lhqFF;o)`I5!|LAa7!7
z3Ntb?H<SNtLw~hg-HRi+5r3b*!jQMX_Uf~x24k>2HYDUAM+Wk6<Y70rcU%a&mt{h7
z|9wg-eU!ROZMSE`!t6}9T#~9vRloX>#UOY8d3t~R`ufXHAO8NjJAHS4`qxhE#2}R4
z*~t#d*_}6X@T1&){q*$L-|s#@U0_uEnfT-{zkc|<-+#aV?)-=6oj4p$&xscN`}*_K
z>E+3egWox)hsjU7mmhcUuX-od?&YT+_R=2AUO3_9cz7rGLLJ_zz3}0o#y_NzE<SYP
z0#D>#%7Y4TkMRSi^bsx3;)-v>pBBcX&xMhJW*Qhsz-SzXZ=^^=BS|UZSh-gkK5Gtf
z5*y#(sDBeYj`S7$a*mHKIJd`f`Mpf@$9M6w@H1~RZX*qeYq|)nOd@cNi(G8c!^)h*
z)xod$I!r}K3Vrz7%O9UEFHhg!BQVJc%#3arTZy@ylpryfPHNbA*!pyM`N!S!C{{6q
z8&pR#GT&5S%%&~rz7E1qr{_C5D=9~q#o@lT?0?E|Q%Nxe?$No@uJ-cSQvcJ(e`Zpa
zBjrq3wN``9lzgHj<d$`g9PvrbiN96Ij%5eTVA^?zko6@W(4yu_1og(_jt9uevk_Iz
z;~_exljfvtPKv~Xaz#Ue7DFvY)A=I3c<OyNIXEKl0GH9KACa2xOAT~;dYjayzSJo3
zZ-1f4k~Q4Y*r3UDvbpHSL$tQ<vR!T%y+M-2SUPkGOXKH=B^Kx{F6b$;&^pS1mN&|m
zj!r8rGDd@+*5RUg&Fc&%NS>9={vf;!o5%mr8gH|@tl5n=YV>-r3vMglsw`MeWIZy%
z;kr-`O6trmhi)}F*J@8;c=nQs!kD;Wvwv&5L<9UT4k)97he|G5p68DEN{=P}S%&NO
zZFcr?QN?rRxA=eJbWia4WT#c)ilc{28)&H|Z9pQv@<-&6=#P&xF*ZWueOMIQs0NXR
zHs<pP-W<;1C|r9I8=9=M^3$AVIpcDLR^yFiwihE<U!K+|rf4rt>ZnejG?x|Htbcow
z);_dQ>W&60<ODqOMpwF{>MmM~XV40@LY?<Q-uIR&om!JnG4Ya+0|Uzv14KK*8IpOK
zpm!r^!Lv9DDV=oi)9Z^mN~y1)tTG%`7$<`n0gEcg=VsPi2UP{_H~T;Z&egT5YP&Y8
z{V>`G#4>R^Mg2BzkPJ#tutLBH&40RKC-MUS!1~{}FTJuR#rh>JB)=pDtbuuDgf8Lu
zjnPKq&k3F$;U_Es76a-I|3(;lU1N&k0kXGqu9Q=M1oD@;_iae>c0?+`!aSpIt+9`I
zM}S?5F-*_m3NF7-kp;HknN&;h9<@@{bPVHU;26LrL!{}1^<HVK;E!wqq<?NqAUl_b
zpsPO{3w7Z<_7;AFwY)J=s>|Ek;%70VG}A-OogQIsvfDg&<pMf3!4(e_T>y#?aagkl
zOing<0G7kyBp=0b3%u1Uu3Pv)Eu&9)@M7N}$PAx?AtqtF1{DGL0N^l16)u93F~#O{
zVBF%e5^^Mb0tQtUK%FQZ6Mw>Mv02GQWLTs!D#}>6BEr0~1a4CTAyL33M$Ao<9QP#~
zBoI~S$_!uN-Xa0AHHh!qG&{*fWF7qOAti~@j%W_(TC+WrwQMx#bNa`Wv02~?RGmpD
zyv!nDA_t13;{xAhKpugz%&;1{#t3i@ja6Ptp%ted8(kw(xnigy$A7&HYFuG>gM#6c
zQwKJ0lOgLxP=;VI<nq*|3||&O*$DDmv?uAD4`31jYNUt}CX4_}1&>2ar>-cq`T|4L
zup#^~>a}Y>DxX)w0nI{U+@00K=pP6NH0!;hFKlSu;~KQ<h66mU4dH<1eOPoW+ZQ_B
z6%O!pZ-xVgcUUnTV1G%jhXY3T!U3Mxo1y`2WEcsbfb%Ki?*VVG@Y1L*h7VzZ^Yd_}
z56r`4Vev5SDUPu5`6Vv`7UzRS5~I8V@bCfd!;@$FR}5Fi{7hT;C-c@r2m@Q`A26f)
zdr^AuOlo>H9$AYs44=szCw{7LA7>cWngGA%yS*Q18rGO-FMj}N@(jGSMivYkAv!C(
z8D<#Pj2IPd6u-h1Vh=%KqjhJh)iA@dR>hd{QQq24A!dA3`j&;fW>Syv*6N3NJ9UoF
ztsuklz(M-%(Z9vr6<-bbe_F8jff&QG$1Tng(gh_IV+-0LC|&vpb^-{ACCT_}d^c@^
zT$Ybl1@O$a%YUGWd|#9J7+lnxc#B3ubR%n8Jd{5HD8~RuAK_PU<s>DHxJ=KYfr!Qw
zZZ>>e#~*^$N?SCIC=V;GDzFEpf?wxzNt}u)0o0_gPY8Hk1ZWl*caH@iM299&(J^HX
z=E6q&7$To-l3{Hfs>kRDvjD>iHKEAmI4^t0g{RWW0)H}Zsf)!zHys(HTt`OI0IG>4
z`t_0$0T;%m4a9||NL1wHes3eW#?Zt<xX@k-|FlgkY>^GcVoa@j{a;V*$Ya!WYUwi8
zPHoN(<WP22{2Wu7LgyEjlws5}Qp$1Yvd|M0US8Eyf_>5rktpDK&zX&}rV7$2yUCN6
zPyc=WoqrM^zx?=HVGZjS0ecRz<%}tu!9)O_^9fZ3pWW6BZUL+x)ovUdFPr_g%InA`
zI<%X5^nchdlPfWskyYW;<YKbrXvH61#GDUlyNNoWNX?EUB{mwnu^;&x<p;ft{E6Ks
zDUWQ0T$30hX@G1W=GJbpep1TB>S^vcdQ2->Jb$62i$bG2?5X7=ld=E<HVKH1<LXvL
zWTAsHx<kGd8s~08LZwNBHdSB{K~P84cw|e=#!Mem+NRX9(Zo$z*&mZ5AAsm-nAYX^
zm?>d>jWIAAFF^2RTe@%fn8d0M`QStj+U+$cr9e+QPgj<tWo!p(dexEyw%G;O?|Xot
zVt?>UQ%7^GA!nI^UPd7amQs(m(G)hG@P-*IMwj}`HY+)$hY3lYVp9ns$~XXUB<^Kd
zA~@*`-flV6Wc6~thpTu=)MguF4!Oy~Hyt2K=j`V;;q{9sI&_RK5v<8@n<mo3()3hS
zD{e9-+eyo2wJb)5BvQ<C6HTanl(`3~r+*^|UY;Xfw<ZK0r60znR+*GHu6TwrD-py<
zrba|DuWa$m#IqqO_HFt%J$akER23L5S}&;hxT!7`eQRqJ+r-wdq-f`vN=mHy%xWdH
ztWfF+mG6tvO3B5i2*b)!gg}Fzj#^S{M2OOZw-I#5j@Wy2oJ%j?20p~W(B-6B0e>l<
zRBJ}6Y}s>B^xFodBnC;kteTK&1ytv)ZIfOfN$F8BHI!Tj^T67~BS|brDA+YfibQ6l
z9JFW~Bkg(1hE2vmqWFrTZrJNP0o}Y3hdKmgZ90JT)E5w^Ru^Y6h}M0CL8G2*7z+0a
z6Y6Qy<Mu9V*Uvxc&||r*X39f}s(*7ETiq23wD#wrf55t9RQ2{qlKM6A>B=5PRETO9
zC7~OR#hSBf`vZ^FfyV4!a}KFDt@Z4@B|=mexg>?6HR_ajO8JT`DHm)4Dnm?goP?(u
zOAS{&)e!m23#|(b(OQIU;_jycwVDROc}fzg)D@G2O(Ra(1a54({YcJMy?=m^_rqK^
zxbo(dEu0g>kkzf8sz{tnS(_a&S96hpUQF~HOFedD+QzZL3UXLjrh&ErxyZqy<r$W=
z4kbGN#`zTOEJ>=A#%g;uat+<a28xk6zgyLbjZ&0#AwAS=x0D^#yd-*K1~xKLP7cC$
z7#fXbv{9GBry2Ur0BI}G^nZNQpB01d?Dtmf`o?^G?M1{COn3LGxgzH+Pqp3sNSSfU
z&Dkp9+~NW`^tX*qeL$`}+tn1!gssSx_|<e+=UQFtg7mccr@`Oob`xB#p$-ql@<GVE
zUd_Lk;NUusN|WtrtYEoJR!(Z>b_n)LQDctYE5SJIT=sR!P4<@(X@BX*x|w_*gNH-5
zxRaz^tQ;$_OwXZfWRo_pTuN#tqgSos%?K)z6Q`%N;XdKB664r}6qFWCOa5E@sOQsc
zW(<apW!zT7=lPu4D1zbZaf{&T()0&bkm=iM8oo#pfD}h!2CF*p6k42Oem`MRavPE)
z1r+84O0dxuaUw;X%71gSl3BS>Ibx7DW_!I&IDHqatYHdTB!X8qtB)i2ni>na%y!_x
zCYaL{ga`5EtV2&xBUBtx_4zc+L2wn5k*2}aqH;Ee55)7A^(kuc>s6sy?JYu|f{<m+
zcDRB$3r0(TgG4=KhJbS?j5@VO@bpZ*?lvj*%aTg7_r7L9+J9BJ==T(+MZ&(6O4njF
z=_{qtWr#VX3mpd)l18EAB*8T&8LQ;Z_~@FX5Q7T6b+bIou@FbwcDwWbGI5ee?A+RP
zfsY3=QV!Pk*xR=s3(d~)ZN#uSKU<9m326|IM{TJt)-O=${7|GcDR1a=vT~CIrhWn#
zw5ImYwUDLFw|^L71L6^7%q~e>7k|EOp)9tNdK_fC(z(mtq#rCS2<?ux!w&9Fy3AM7
zD~}pq(-i8{UHBHykQ~tb%3nUK${(~vBt<{VW$BJ2=diU)Vq(Ed$Wu!D4f)RE3L{KB
zm%JYG{n*(pV63QWT`K4BYl}a<@Soa^RrXrjc+}4>fPWzv%+jV{zjz7L$dzlKqm#L7
zgq7!j01a-N15mm+aFK75(iGafSKFpUT$6AlDT(6erg=W53rCqRa%fa@R-(zHQgE}@
z***1<jr6h_?Jb?%6YFPVXLm#Mo^HIUabrzqH&1KJMNh%^qQutj%_{{pxU09DCp^W5
z<F%`vf`7NtvALV2dE>69U|WtucQ;RM*4>>kLha;^J2-{zW6<n#P)yKHuSa-hut|FP
zX|Ud_&5TkQZk4E?qhl_8zM(N%3jXHrIPr7U&S;|mmKrgdzzhU;Z|IMfg70Q_8p7IU
zCHJ?;O3`g-=J|MYjeI+SoaU0bzeO72_I{^vXMdF|)X4WdY-!}Rs;gV8ZPJqeqJz-Z
z{1}J%JNS4V_fak2@8IKo+y^*p9^o+dHg`DOG)r%!8}5QXvWtGfN``Q0LF|Uu*u(2Y
zOYAM(*OI^Xk1JN5DU@O|<o^6a$(b5jJZQ>uE~ZIyh+hko4Z0$g5pt&z%ha};y<~a`
zqJK#xN!FE=-3nov7L8zE$pH38kI?QCH<g-vBkF65B^$r?q@Qg7Q^C|h-%>V_k~N*q
z492$8ts{;bv+!S00Gbk#l$~9XPV_6SF&8LX0{0wlOQJBOBfGTTZQ~68tp-Y%xggf>
z+1;9jHP%YYU|3nkWCa9cqNiD~RZ~ITrhoQ^mn3PHlOTo^S5tCtdDoR*=*Gt`^}{#y
zo@b@SB7b7BTF|BiQ_;mX8N7}1>emk@Qycr<rpNv7e4umOld014X7UZ?rbT<eLq}hA
z8g$2yN8nf%(+Hatywj1ZLLQ;Vw5?xembE)%QmKP#F1V9Qe(ln7wT{O2N9U-y`A%ZQ
zdKwl9rAuDXC330?ji#G=assBk{Pydo_kaHI^Dm!2y#Dg#GcfbtA78_>>z6ODpT0gF
z4m(E4wF+feJ1y#&dt)1EeZTu3Q>SaGlQC2ilg@ey1T--;G?UzVLw~JXTdN$o5q>|v
zVx9wTt4dN!4TpibHA!G0OAh40<iXkXF3y9!F%BXBK2^G_Thh!q8wStJ>Fz1jT~(jT
zVuHhep5C9negFK+$Dh6*&Ocn9{&f%sF$uH>z32&zK3D~lo#F89)6?JnaQO0cqo?ZM
zxGR7C?c<l{=l4Hc{(p2mh~x2m4YcU>?boOC%afibdoV^$i(L*cKOf$&@&I^v`Q^hi
zm?Jz3BP_j;z5*QI;WJoa0L4v6aXKR3mtu7{5Ver>5PcQGf)1A*738n^CyT#8bkdJA
z#dCZbFZ5HX_z#?!%9Y<FQGDm9%*S`cm4NveNEup`iO^+7#eY4$3WLJYVAjwHfhaEi
zt`^!o&NLF2L0%m$SSM7X%o6(_Id&y+;E2*i<^$x8hvVO0{`_=%dHV4YGeO@>+DuAr
z%@md;{W)&&Dx^fX!kIX`fj%nMq$b^nf>qB~!KM=&*whBR`1IA?W~;tR0Bi|>peAzL
zN(6HNAQ4!jD1T1kBD@V*e+#Ys^3R8tl+7irnWXM%&3TJc&Q=So1A4J>QD)r<m5l5?
zFT6`)*y+oY**bA}${ES)-g`~utU=?^3`olda|YM*A12zwKYq(**?5bbCu~d3-uMc|
zs=hNSF~L4(T-aSmRUvb5Q2S5sQb(<x;k<FDazWi+5P$46#|7u;I!aKKidmRis*>c~
zB59W`$>fdDCuK@f5J)Zaq&lQ#vA|5ipYeoe@{?Piv~6(-TEB(OrJyxw0SoEJDw)a7
z*kySk@1s|rI5hVWu(ro37#vs!Qoe&Sb_I6$)0AOn&Ja>iqB^;pvAB269{{ZI1pzDy
z0ql2_4u3_Iio&v)YdGXa3I%L2>D^Mu$?Qb7MEB~~0xL(9o2d)LGR<w$Xaq<S)Cs`e
zKf3_)?~4;|Au%tsJoy{FW_orV3fByBTon6A$wCS`*57TLNGg)eFebKp3cJf=Gl(VS
zpt-}NA_c7Et9_EDNpdzl4hN)i@J{oh0L-im7k_L<Xlqewq(5R5f{aU1)zvXFnesAN
zZfSCEyY6^TyVwkACFZVdol}%1(b}ZTwz_QFw(Tz4w!5mnvTfV$vTfV8ZT@}E`q#`{
z%<W#8m$~za{l<=PyYT{IpTHzLx@d}g#kiUuURj}6j|>FQWGa8GhYt&V+K6H_O@Zcl
zKT_nkwaybTB3|7gKS^(nl0>9*Aiw2l;1BSDP?xw+oEoVeMxTE^wZ^9A#`ycXo&mTS
zHVWPTTvB<D?m6$#Qtza#K|v{`!_WMCnXbOLbr}J(&L1~1t5NFsvqwW*v_+_+XK7gD
zqf7UMAR<;P(v(C)^>a~AJ)r8YYedxSrMa&#j!|6GTzNF0-a}3|uvEwpJpEm86Wq#}
z>x}*@Y=v*QjZ~ur$3F>x`}<N!=K(+#7DG<ta&CrO>0EViMsAO~;niI)&qC*Qk(WJL
zlkgnEsT7`Nt)Ua6gxpOOFk1=Um78E|QA+EAe7;#WuS)kv={`{Ds!2|c-PG{QV~#^q
z_0D-K8@u2YR$mczT}fD_t$YdfDE>TyEvv{#=2XkGTt1D8_QSF;`y~2!zZ+m1RSl7d
zXc%*N*}8ouh1fR(Lt}U}H7(sHgnugdtQ3M}pv;#<M0=$swTCfv!BgwZ`c*T8=;!y~
z+T~cci(@+b8hfhe>V6F5PkL5u1H@Mv&$T0Co{a_&-1Ek&yv2p+8Q+zfi%U%5Q*pCy
z6R+%6(q?s6#_8xF#b0b_um{9*x%AjJZZfu9Hd^D*WWEr=%Kbj9f0(C!SKj&Kj1Xp;
zBH6rV65au!|A4W(;5AuK1bTvJxUgUPiRaE&+S>5rGu|Bhc6l*S+7dd5o5Wt4)<yiB
z;;RKDA3u)ZfeCJjT5t!!atQiC7)+cUP*vnuzLVtX)sl#w&g!HcBncq0^`Krg?o=9M
zKP6#3kWI!cmxbk9>rLFKjvIt_kzhk$)8^A_wo9<dN2}mcATfLg&n|H%Y5^~}_<;yu
zwWb{a_Ys>>ef$>qDzZ^SDl_PKwHCx(+ti*b>lOtyl7Sr&f>n)e3GV_KRhq(^ZK<d|
zR_(*1l%QTPeXr@LGy~w@`dB6&VvZ}-2PeFCH_F9~6Wo_TC3`rC^OPNncT@tiEJmLP
zFlS`JyHzTw$d&LwgGFBW)m$$OdG^C^A>#60qYpx-C8|0USZnF{J5qg5xBjNO2JiDs
zreS!?DHWW_(FNi*y~WU@4syeln_;>)?UlZ&_)fnej9i*wvI1OBh-r6UjwkD(KZi(5
zb?!+?>tsJ7IFgV(^fZ7Z{CV~oMfqb3G=waMG~rsThU))f5SIZ}KV4BePBDrFF`r)J
z5`ny)?b5TuOj23rLb?!Vym6AI9B+4M@w0DgnV*ly;Iqzh1){qyr!t`_H4dX*O!ZYg
zw`kj-Mvf<1dkx@#ksj#&ZM5m!d2?!pWkq&060v_km|}M<fjG^c-Z^1}b0sF8vd+65
z%;ef&at8^ChYvaEgmn*7Hbp?u_zMRly<M{yh^^Ir$-d#yPt5)4&kp2zFl2w`V@Ic0
zk7Tv4dXF)svz<5=bq9Qe1RF0$Ae{NeoIUDj71Z+|<X`}~NMYMAL%34$VPeeT>@a$*
zky$#7R^-EOhTLv!^|f~)h*jL{;gSj+3bt%ut4FybDz>N?m&<K818_70@wOBZSYz1S
z%qLrYa}q*DM^$-)APf%o&S=md6y45^FRdEJYj`$QcH0szdzA`S2Sn{`=IaAet%Nn%
zlvWdd5MMyB2fEq;1s1*kF_}o7-gpxbvWx&_9?{CBeO@YxHzl?`9;D(j(DbR3EFpig
zZHIr1m4`dspVOus$#`fSXuQ&>g7`XezvYv^w(k<}PD*dRY-=IhwN8({Z~YiKF#rCh
z!yR`RRqdjmH20W(oImD`6nr64{?=~d+CZy{`w##egHa(pYPh~CZBm3kk{L0#n{>e%
z0apXy)11iHVRI;Radg{SC9y%LI-jX*vWjOwm~><b`xc`YN*iD=QJ1R{a7BOHKE{|*
ziX9T=wgKEMa>>79S}ksN4J-yKR>M9bGw!7E2Ed!JZMCm_bTVUX9LUySW?)Y^=Ju^e
z;F$o~vK|X`zpF4f3wd;*QF*vGIwH=}YV4St53bL+r)=0OgS^`Ei}nrr4GXar<n}ll
zWg4vRwwWTm1=G4fzuq(vGN~IiR0@wWD9{&)>Tr@Snl^#(9!0Xb*c4UOt2adyL5Ek$
zJMwDwrPZbI(5yD)hL<C~5F9}eCmGp?s?!1F5~qkaF7j<dDPvBORcRXuo(FwNCd9if
zLS=!q9vl^jXAoAbK7_i|=^f4F^c@YF*3P3#qMn~bU!*#di7nE*b?HXf-;>sMitfMs
zTAVOz(tzlgUao+O-7;OPTJNhzLko9-_C_VRyT&ERkJ=2%ic!Ea7n~IbJtHfAmDd82
zk#C%tnXP*UlU4U4e8OpbFh(H_p^a+f;e>}LmhzqDYheacK)jAulQ^%_T6v3_b$^f4
z`KcZArn=6`xsbaMxG+rn+L5-ZL$}Ba364CZaaL=l*xRKU8gP0-`aH3tdCh-7Grk05
zHP@v!6P9pQz^L4#nkyK_O}_`@(iZ@jLPjq1E%8RrmO(#aYMuYG7wU5C-Tf8wlXZvK
ze4IeGu?5<6<6(Se&1$I{kF?sYmwH0>K~%FQ(D5rVYiq-;PE-})c?ODQ`TD|4o*sD7
z=Cu>N+m0&*?baF;5IsRdIOP3p2U$cZm3vzAfl6?C-TDZ`mDpo<E6mfLvg-%XH3#eK
zwP<s0XkdVv-jbLtLyrZ+mmVEsX#-OD)W4e?$TO@?H`GfIf?#xSBhYE?K}D_REo>Z6
z;7WQLwR7{MQY%6Y>gRk64&JjMLZlFhA5ZN=u}zwjJ7sU9pka3KDa>f<bsfRC{WycX
z+~oA$BAo1K$laB|QhfPl<*x+%{c033xyKawbrQocTx+hbZN>n6T)11;%CTD}um$nh
zy+PTI%eDf~+tlil)bs8A>lXRyW?mz5rK2>iITxob-Ug0KH}>zrO1TAH$dnO$!4_}U
z*l$H9BvrVFBm?yfQ7p1jw+3S@lNwBV^JU$|f{mMbPfYjRK%#GU7i(F7J_A<xI4at2
zM4)c)vOJNU3DVP~jAW4ERaLJIh?GPN5c7zi@5b$5hLmUTI<cH>3+uZY61pqyOl6wW
zlJO7~IT?aMuxqTB-yg=#ghRKp7!lZKl|GXs(F^KhGumbtDQ4KgL!47=#kTogrM4_e
zF%{?@<!b}$Tv{p*8nHJz=(ep9K<<bG?9k+0V!eECR(>ZdzAp#Fgh#=gE9+kZ4n+g0
zKi|)1U;6yt?{5<$H@Q8&L|fk<1Uql*?@t#m3OhM5BO(KdMgM@{k~}AONhke$WZ(yA
z4Wo|zKWYboiG%6?%v9OA5?Mn;0ot08r2iz(jlR-M$h6X_Bvn3D842n}-R=;)uf`{1
zvw7;>z@-<a@#hU5x3GknB-@q&OnYTLv+Lm7(64_yeI}qlK(F89^Zj<P)015zu=!8(
zpinSDpUImsB{m)(vdY?pEUYLf0N%FFCKe*xeO@2z33@s^y<hj9LqDVdSu-ntyioM@
z0iNyM{OO)f6xK_Ptw)dVu?wMc*@8KGfbTOg4My`X;-uEB+&wX!U|s>4Pw(%G3xeF`
zl~RIOXCRKyhD7!&(q}Ng#Mi!?{{7zCpUWu9He}$%Ls|PRn5@<5*8Nw+<GRn**9pye
zZFlx}@ETz$M}(b$$i+v1Zj<?^1j(+!ZqG>1y%@FkVqOy1wGnLWlzIAfuN)N=fml0|
znHu3;CTBB<H>Nu918f<m!aMPHBni|3!yx=_iH%08ccwHNg&^IL2{*S=riKy?NBO(f
z+-2S{E<|;cQ6y!HS`w*X(lqyG)Y%5(chfoJ1$L8JgI7X{4jLzbYIg75&eE2h-eoMZ
zLLHM86MyOKz(L)*nc{#hWYQXbTp}0()iaUXTpq-NKhaj~7Q<G{P1f|;*f*ECOU830
z!MU3(Vu1aa;HYQE6L$rtz4B`+QaXXzRM{NYkdS7j1*1v!-Js9{BpK)2IR@Kt-K+^o
zj!0`%ry%0q@WJC>`Up^A5g}jw(A~-$T=L{9mMk2GYgIdfNyDQlsF@Z5b*kd?sc~F;
z=q=V2uPp=DQi@%Lnr!z0i5`-$BOFX1_ciS+vED2dzGzR<9NibH3_^Dy?;tsk<zbO*
zhtNGL-$aM<J$ba6as<}Nz%6V;QXC)DPOZbu2Xft+0-X^+OID$(;y0l9giug^5+jQ>
ziL9H3ra_98@{isoD*>)hskcjU9h~&K^E~65v4%=xn~Z0qZ#%5-m>XT8^g0jkHb~}h
zkxN)~24AOc?)(U;cj!uu$B1N)_j;fyGoBEH2h$@i%5;WPm!YbRkmDD=?u*LdrNR7&
zhP;7DWE~IySzR1+D0uS;7migZ4a{M^EcH4(Zti%~6PA8!H^WW4Z*Q#1BsyW#o4#;s
z`OJYC1VgoP!K%fv0T&Nn$3u6Io)8BJ?Eq=TW26^%wG+#H(F`RN3;y~d=0T82B54@D
zmZ+rnZG01mW!t=;Bhv3iYJYadjU@!XO&@-`V;>tp{~FL&CYR&Kdd{qnLGZhratt`n
zT!e*?@QN0V#AKUaYnUA~Bf3WjY&hNMLlZ1cPw&f&6k;ru$SD2T?KC|k$8n4U*Xs@i
z;&wv9hdz*M6$*0tNv(FacGgA>4hw`rI(ZQk`Y$rA^k@O7E176*X0Aw@L0u&WUY$jb
z7o#yCTq1F3u{*EG{KQ(FA~`;CINV|1!8Jv#<>Po644+VE5Dtf*$3bCC*fcANU>Vkt
zG0kU%y~r)`((d5f0k%p(Ch8zth``3kbB7!w`g(f}ETk@UL$PXtW(i9*y-yMJ*T}uI
zuSqYax|}0MRChyc{ajoZ6{1<n4QdXe<>xw}xBRz}jpBx)2k$*od&^P$Po@8lwPP7R
zfE&UO1xk1sB#J{TMG)v)cTyW^dxrAjUx?9JZFPRmz$d;UU>;^0VA~JN*9FUMK>*rb
z7z;qslDjqxvW5p23hT{k-l+j$#-u%yxHmIa)PWBpp*)Mo)T0a{OcD#1E~`{%f9(f+
za%#vB)L3w^B*`5P+0X{DEG5@{h?D&tFn#;s0IXyf==Vo?aPjK=hF%GAj)#UFrb0lQ
zMEWS_-<@lqI`WYp!`9_f1p&qSYx-CF*%-qIo|AblSpHI@8v}V|1W3Ap2&qw&c3!hc
z*#0pDSCkRbi|kuB=w*wnU{<ld`V}4!X4}ey0k?;%JEqUOibld85AP(c9hIHU$EQJp
zbGm5L(d_sOC#=uUMn@^~yxh699R;Ig%^ZQp`a&ffeK^=9fS@b|SS+{%DZ3okOCP|z
ze8X1eK9S<eTfNxPG~<;$Tyce0&$h2ypZ#b0z}p2!cEqbtymuQO%lHgCrwSQhcC+m~
z=S#`FPLydk=ZLbrV|2NwNSHoG>reX^SH}R04-$zpAEhr<x7D`}YFPrA_H|pnAu7US
zxJ*GurC_qTUv#90`u4K>2b7~gGpVk)Ef5h!SLjju5EljKpv}uj&vH_76{b}zqsWei
zblNChG^MG9I#+y8?}by4VwnQ4kW)W9Ld1kZcL;N`k)A%<zz7)4Hr+N)q4dd1=J%Ud
zc4joBq2iaPU)c0rs3XL*z&50A2t5-<a+m({|B`mPzfsB{ex9=nW|9YMwS6O%5M66B
z>|dcg6lLt&QgNCK3n*F`&_+IQqU_MAOJ5BUKJi>551@@#pJCg;8<PhxFX{FeSISaE
zyM^km6iy~hzS>4y8Y|H0q(XPHr?iqQ7<C{>0W8hy8#%4EIiBR{+Yk@Y{WMNi<&h74
z#0-S`3(_gP(w_+e%#RFt&oo}oq|cHuO+zE9h{cT#ojDSqloH0}|G9^gxhC89epg@G
zW?YcCHuWCHOf6ZpRKo+<_64MQ*+gbg?3Mc#oGN+a|Bj(?mBznR^yGB%IycWqsUv~z
zJI93e#q>eIx0BZo33@)cPGLP?3CDy_>mMT_^;^1W!+_@RsB#_~jpL!-Dpj(JBPO=#
z9e~n3U!a;!6~%o20y)#VN4tjjWvraY_UG3ED-<$iY0IwZ%b__SR4sp^xr2>h!7;e;
zPG&5q=32TbeH3=_*zEW9<duu-Bj@>_6)Lxq)w;L)I{SvkvkEz(#4X|4{A)4S_G09k
zL7*4$>SvtN@zycs5sL!NnrN?eOcnEp_eMz^TUeBENZJ0n)PiuNYC9t93~J(0Sn1&T
zT)MV)Y1R+%yBkvgzul|=TM?;jLNhEy8igcZEfjbldhpROmCpc!sU{&17X9Y*BiD9^
zc;K(SPr=TOqmE#TaJw-ZiyUuke>`Dwm0^LqJ|%tcYt$%dsG6Y`FAm!V&84ND-@Pnu
zzeQF_3Cgl)w)4+u=Lc%u+b>c@EK^ZKh2@snh9TW=S7BTLWN-snG<8@~=wKx?I)ddf
zvSogb6(qk|MQnHfyfC=Q^59rj>@20oD>#JJmPco_pD@wlYE&k4imN<yVS^{KT^;_+
zxIIof<0{J;coE;4J2S4yq^g*>!WBnULb8<Qd5yjN#-yS<umBe-5SvwufyozBTT%~L
z9|{vUx=AGmIOTBZBss~$Hy6v1E8s+F7VJ|6k}21*$yK*m8xX{l=#VrcJJ84H!R;gg
zq3g&yKT)b$&EEJq@T)fHiwV}<0U>1^vSq1kiW`~2g43lKNHiJzOYfWJeKLs>2pOoP
z_3Nz*90_uw>zw<37nD6OW>t(>6ZI@1@r6dOM<?V0$jvGV@(1yu-v3@x!v&WS*}YOE
z9fUok@+7Y>jKUekm05}xk4+sJH@kx+zRF9`!cDI`2dnJ!6z<*$EskWui~rS>3W6mq
zNfl4Esq%!XI-fvQkZIi$|AD3g38eYiqh8MTac&HXHd+*OM}d{_q{*4%%p<-Gcg*rU
z9eiy7p!)O=(j<hkUcQ%%v>nGfO|lo^W=WqucIFy^^{#5Bc3Zw~j%Og(Gb4!8wPjZ)
z{y8n9Q<sl2*|bl2uc1#ph!)>0$kt0r7T^B-@RwY3ftX*|o&rPv3U{!o9FXi!YuduS
ztdhUrv7P|`fI`{ej}LNXcIMS+Z@84jCCs-3(0ruGm2ob?$+Ntb3WsW_v+02Hl^3;N
zf>=|gfQ-c3Lt7`x@PV<BZ7jI;1+2i#&r<E(fvhiPUo3(q)!ySSTG|;4f6r=sWFcz=
z1&pjFS;bcrIG~?xLCu<-RK--#7jWZV4dNi&m~p1#lVM0Zn}@n@TQkqYojt3`|9XD`
z7+Q8n7gRLBj;P@2(H(w_zf`7ETNj1#uLBvUFG`pcU;U+yM>VveKv#`m09)&~%~I8{
z@mn)QDbfAptb7#7IhZkJaLSOA;1#`Jc99|-XGTR6Q=~oMS!g?mwbnj~wQkt(u?}*#
zNm(WbBJ%A}rBJCARn9bSP4wkKZ2YJBq{J{wD>&6$;msA?8cJyCV@(&DpjFYZWwsiE
z;N#@f6jS{it#anZ+$R6f?dAB~OINO=(zS^#f7eskQkrr(rSYlIjgK8wgvjl7eNK|5
zj^?M~Sr)`%0l_-AEWF&-r5NA!(IW4&8Fy`9t#u+uE2QY!+=)?#hb9=Hq71GBVs(Eq
zyCMbfsBCZb-9SHbwN;^jYbWRWFD^yJ#j=O4XY6z){Jmq9t^%~YNxi(AEn|Z3qLbQT
zvEH^atO?4CXY>QpC<eaZR521LL<6*m^I*Tn!k?=0-wY4G8#Ur(sH!WwsYC;Inp0oJ
zf&7I>Cyh3iXOsf#Bs1_<w8*9bUpF%`0!q+%7B4LGFl$@NX%%;w>t9v1M9bJ9B;Ql#
z>y~0`ag>-{ol(<8v_A9rckP_SaRDKI%^eIQ+-Xg-C2O`dLJ#E^ZZ>;llN6Chh)iSs
z<d)^dBcxAu+Y0Km*$+01QUkD;s~%=yLd1Ld8cNsRN8|ks!K(D8GSyi!r4>}F)g|rj
zgt1gqFLe&FwLf213!wr&pGOa=u{-=f@8B=rH$6TNE6w_VujjLig*R`bC~z4sYk4y&
zI{bRxt(@G?yGH>^l`4b(4z%zSV8B?|7&#JY6aFjiaL4|W>^nCDk<5HAZ-M<j$WH5V
z*UJwjFxu=EPf*kp$MpRY6UJLf-O&CA36y2a)nph?UvxMO+U>{36Y%-`^-xRjbLZp!
ze)f5Plf4=)CE3H$Cp({>y~5}T+hL!p=leErJu!iv>-Dp;BjCGsv-9Kfy<kd#5V}AH
z=n5Cu@%_Wq)s4yXmhEf>!+)vw)Ak3T!V}lAqAzecB(;f9m#Q^7z|;0i8W%C4rli&Z
zBZZ#R!JB9o_4pRynJ_p3q84`Vj)~z@=)hQOcIuVAJAfe8TL_pRC$+t#>5gq1N4@=i
z#NGR0oOPBbzOhsA{UV6_^Xh4aVPz#1kh^jz66-_OPdcdsWC!U7vT98eEl%FJBE)5R
zn9fh2_rta-=*Dr&sL7I07tmW^7$Rb%hjPFV+i+{4C`h_S>|X_eLKeABu{K^-MrT;|
zmu}a-R4wToRFqqU7)(_OH(rI+eb$26gQ43|8e?z&SG%;r9Lkwkrp@l8_W>j&Kv>f2
z<;^yI5{N+jL3w_U`ju#6!2dA1fr+y<&tb2T2!anIP`Gy7sBVln2t!=bFc?SM|BUWz
zz-i3J1Y}rd&5cS@2At=tPnn{%Uo0yL1*K-6S#R~p0t}Cwi&$9-I3OyP)L;$Ch8ePv
z{nH1<+_CTDum~f!%a-Z5BZqhkkkCN<LQ)gsMNo^`PJ_*c@xdNE3!ehhwTd8jKy3HA
z?lEQuG%w6+kEtj!WfBPCpvEH&DUW$m%#6|_C<yOaEtp(=nebkp{_7<As(ns)AVg^=
z-frcl5k}-}n+@pnJ-eACq@}FEKA|Sj_)K|od$sN&mU}e6bSKe%r4MctP#m~X@#DwL
zKb`tnNDJ%s6$x4lZ>Q|ZC%7kv!~&rhC7|-DaE4zV0Zede766j9&iVT`@UBMK+NOIo
zN%NHm<|<2hUrsNZUwC(9PsbkO+k>k}?k?OzY*E6)vh`j!OjP%xvIfN)Ln5p^LTc8V
zfL%EfcYyA~iwdK>*TxhE;G%57ijKs(I^vk-nnjJ}yB1N&EGokpmEh86AJk82KMV)U
z4+5Wx!pvuHWakd8QKXuS!jMJTL9A3Gm;eGZU&9o+^5pT;3bhdS$4tu*aY`aRg%*py
zKtQtf0pp7B00$ZCL}I$&$TwPwiO6n`a1DN3Nd}|K8-9(M7Cbu%u=fi)^KV~(BQn^p
z0+T&D=7L>v+;v#JI2WONKB_rb6khf*B-4<YyDt3A;jKp^U6T*fAW~Gp@gy`_Jz7Fz
zN06djScF(X9PefDo2*&#>ro&d|B2?ot)Wq+O>E~2Z1;B0xjoeFp$kj>);LWJ_|^a%
zESeb`1}&=^%yngQfb@HY-Xn5ug-L!ZI{lW0HTy)=Xr>mVmE%F8TY<Yxzam%2ftu02
zre^-5^F57LOp0O3;BWw8zJ1L(TsllJj$0|*c;dt|N@4i$iV2M6la<eiQEJ+mtapW$
z7fwq;z6krB$*C%6cA`&uGv_JhpLb=Ey+G=1lpmm&SE=+i0EiQac$iOLk^!<=VsdbF
zL0zm2h^zs`_>>y1m_sHcY}9aO)#_g|Xs);9z`yL$k_!J2O`wI{qOuM6kampb@P5|c
zil$Fn`lf2!I<wu5&F9u<^v@uU^majMiAKcmhUk!JJW71DO5$roWl^I!Ocza{7UoY?
zNleh2PNg^vz+LXU!f6b)A@Pm{QN!pLbp3l&OQO!&_<H_(cp*~gaiOrXRI*NtU+Uf;
zuFsKOZOm@6Lkv{;#QBX6s+#81q){^zeYroPt8>Fuiy)FW%Sgd)bwtCy{+3UN$4<20
z-olb{rp|(}tu{--^^rkrtz&SigUgbPMLX@|D6P$_fJ#qdt#vgTb2!#$_(ToRDd(}x
z7ILL2XB;g$Pq~elKB%}Rrb349I0N;SDU#ATOQQG7QSFRxMGSSOTGOAuVg#25?0eZ5
zK5A6sGQeEW!XATcR3Guis%VTd&Yi%8r=r8<a!tBu-Q~4RhpZ4X-LCv~WcRFnO>D8&
zLiiwDfP3_W5rk|8r)a!PEe9bg%wxk^+y3(OF43<{E|la7%zDkLK~9pMl;z57>9mpS
zG6+*7*(sh5yb7~$(`!!WKpfL>8^<w7e8o-7PHftWf%Q3)kXp^}%I2p)C^1)HV!>Xc
zKg}->Kw_?ah@5Hte${f`P67jV#D+`##baTc05i=noJA81rcY3Gs#lU3%<<U$sB8OR
zA!|rvQonr#h~L6a`8h}NfCW4tI{I<T!suH}G9b8anS_DHyf-<;Q1{I;_s5w2Kds;J
zf&Jh=dVNyS_LS?eD<^n&SJlsc^|6c<fw`9%N@#Q}CRENSLXsi*5Y@a)hLXbXF4k)&
zfF6lymsB=X+Gbc+vod&K)k)%yR>}rpcvBcBTI~7@>LNMzEfE_pwl=m*e-6R^IQVk`
z0wHAWPEV6VVp=@O+Z#<tEtr2cg0GPm?MegoGfT4!+CVl;k1gXz>~9~lXWPY3jLL5!
zwd&kY6kmq|qj>V)s>vbouaN<<Yv)N~fGKLcL-2zWDzAZ%omg$Jbr<;oKcCR4!QryV
zq`Jv9C<SEBr7#iZftg8UpFh0BmUnT4#Wh#y7$bkj>Nz8CL$14o203M{k(Z(B2fDRc
zqLGPjs%HmAK{;X)To#Vq(+1=5jQLy(+F<3XEm4s4o953%ixzzoe5i|!Npd^J0T|$0
zorQHacws`eF2zm0qP5hgQq@MlRBHHplETIqhrFAPlFnl)OZ$2Tu*tY=1%{l@ZzLNH
zMP{|b^Woczk7z@9%y{hqj;0r%b=q4J{5oYCHQdM@pur`wr}K95xXr3I4&fxrT*m$}
zkv<i!DOd?H@UNkXyJQ=b*Y5MAfE+>>40JXxj%Pgea!g+}=*mm&z$%pB5Eba=B;l>&
z?k{8bZS}L?5al0c2b|<F7u$E|=~NCj_=cV^%!LNHtmt^5@MJlU-OLNZYbiNXt^Fbf
zZ3s)jH=P|vstGUL(9-^?l<)~7!_&9TP+$-wimB{pi|BY*i?%e^Y4nRJ0P$E&`flA-
zTE??5O!v-YFVx8K2&q`jERjk%wT~$YONj}Z2fyvf%(Qv(sPuJ{0-W&ucnd%qoijn`
zFD&k<)#A37{;5f74GL}l;V95(7c+RC5Hw!v$UWO@@;d2LmFFzFb-TR2Xz>XN?aeGh
zPi?TiRZb(y6s=5~Q3<~gfGFZMJBX=42Xquu$m<7P-h9lAXAwKiY6C<vMNU(An05=H
zye(Xg#+P_yf=@+}jO)q(<Gh<;!XqPmvj+Ex&7))2Cnls6bfTUsV;!~F&E`uioHZ<!
z>vLIg-&gIk0Vx|=CQJEdeoghrcm95xOU?Kysdy+Sar*n8t8gQ3fYGkF`Q;7?h+PR7
zX8jP$j#8wjW1i5~$0pTKb$F8-?gHt#$%brYSHHJ|hSHtzB@9dI8H{faZa`b%ax||W
z*HA4^aqM*IGy>XN(%1|F?o~bATGr``oy%2!3HYzze!S~;E{NaZSRTWA&=3#D$<t$|
z(MvZrn?rTXL4S3A1OBKcg+dRyI^O1d)Ow>dT8*p+Gc{vy>+^5BS2D#J-6>VR4hc{>
zb3n}R>bidtK7F-?^1qO{byS|>D%HkPdzlj~wYU1@h)gu$*AEf8<lrTQA89z0Chx!n
zE{<6?gel1&>WgPI7xrXXhle6eY3|$d&#27c<*3ZGo(O-P0@!Y~y$0*Nx*F_T*25m^
z8ls(X3-NN+^LDy9%-Z_G8k#9?S>3ll0%v1yoL-0sB1Db7<pTpnYbiVwgYDKB|0JyW
z5)mJwK};r~PdM`;E)I=GZV)7G%<SVHYF6-~JT^uRTf$oyc;W?Jo4p<(le#z#U-r^~
zX1Uk1h&AvP0n`UJsY_^)1L2-9ThntLz%7dX)MIQm#^R=7j&2vGhT)Gbshoy<Q9_pz
zfaD{+@3WSN$%rUh=t)mUiCul5Dt;_jZcZEqbzq&gvHyDapd{IiGEgxomcJdeJ$(VT
z@+~6?25o=z-2-&&7~!-vQtran9y*`QFF@fuDt}m20ioy9fvAT(Jh4A-;1=|@c%l1`
z(WE{h5Xc=m0;-$Y2!6VJ>I|TDvj_;R3lZgJ(u`r1Q6HcrylM-Cr6*vsa%z~Y<Q%EJ
ziWi$~zFG%cXvH9MNKfE1EP%97Gt&zrJEGk7lQlbKX_Czbi_os^py^NX?f%d6<#boB
za}Jz0fb;+tIvK|R;Xp)QNu604+tSKdzc;>uWllN!>Le|#`Cn6_FzHCwY&?nU%)6KE
zM)w>dS?7P~Xz~nYJ@eC5%kuhLHAu_zYv(3+`{(GuKDWpF^ZV`M*WxnZ`#Za4tK0YM
z`)p%kukPYhCck2GI>>cV=hOaRrsD^6K4*dNzk(<u`=20UVPs1z%N7B2X=~Tww!r_#
z;g<{RQPsiPYvjMx(9o3!oN)}~!}z{iBEQ@0h%z8H3(!w!k75-W>yTH%_3$y9juMSW
zd%Htbm%YE8Sh#o?QMl>(^Kn%=a8!9xnv1wkNS@!{H|?gpjUN!N;&6X^x3!?}>->7#
z*sF5I<8qRjyY0(~uMYq`eSTaBWyz;nW5fFL`~J9ide+;)K;AsDhQ8h2zYJVt@=LmU
zyj@QzwI*`IFm%F6!&cLNk_V-HKf+w^$lp^Y&k{q4aok#Zh!3cEe5Bja-?b55o+b14
zU$K1MSYm#PQByf)cnC<whX@=@eZGR1<hAH};fMwx3lgUBK?6dF`%P}?WqS_q?8O=%
zYhpyi95dz&ix%|tzi%5md3}6hxyef9NxUoN0C6ado=F@?=hQhuldw>yLCYY6p*;O#
zVtK=6bP5bVt$%!nGE^$Z>Yjs&1(@5fd0@T0x?C~1awq>fMHkt<M`0{SG4)1``6LCr
zaA3e0tSoVzY65ag1S98mc0p^$a&~2Q!4k+7D}U(<&d7Mn>&*!eus7``<$DYMURgJY
zt_}{)1utO-Ddpg4_>q>Vt0I}UQ^wQwkKwnk4n;eB-!3>AW6TulyY33eP6jFLyJ6W>
z%EN)pErTVSz8yF{XWH^uc9JhRvKq76;uT4X+=Dc^qXJ0smc;hTRR(7T9kJDGzi3XP
zoa81KB!5V#^Ec?_Z<^ScpWR2uJFd|-LVE_H5r2`ofB30^Hzy+9@?L|T8SwB+Oe_rB
zRM8X-?i8B$q7RN9-(0=pjICPWlA&5DzeuUwXm=vI?{@PBiXy12>j|6Q-c)@05E2p8
zDhZzuSpe+GOk56Luz_=h$If6r!M{Uww^9wG&l5ulIS1%nfaAeUJSxpVRU*gcbxS+P
zK8C=;$f}aYWpudK(7yF|A@y)2dqb3~MHS$+OYI>lNp?(vv--^XPNUtbb1%(SIV605
z4}@lcAw7nxfX{~}fv6$WXVau4hnQ%y_pae!g8&L-ciH1gr#Vp&1$Vm-US8m1a8m&X
zx(C{f$8h7^3oM@Ws#;jCjSri;GHm~ndL;U<ntNkQHYteE^T!N6;8`bzr#M6JJAz)0
zM=w!(cJSiPaxBZsI7K4d(4cwslHK7yA$Vl7$acBGWQydALt%_W?2<Gps2G9s&|mFT
zmjRRG;+h#t)4mx39pwy|rz)JRPvr9j0+lHG&C$X8#mbb)B$n5k!x8W;)T8ArLxHo+
z1T=Ko6{FyD#^a07aMyz70TJE8Dd2qlwKLFQ#mdHXs-j*MZzA+k_yOP%VoOLE<YlL{
z>g<9JAPq_$z>t~)(}fm-cS!7MQtL7De*wM1f<QcVizc-usu;_*st&p+vk00zE>yrz
z<FIGacoQt`Wve6mHZ_e>l#e>ntkfVCDDoi|4DsS+_zK0nG$nf8lbp0MG4dk=r{-CQ
zFa&kK>&;9kE8&&K6+0AqK@9Z$&R@%xohw|FU3ES0gQ+u56J>roO*{}%SMW2otOKqM
zm0%aVYB<7Rzaxng;b1@^DUb)r!Hg*5hq8+836T$H4PA_!{hhMKXow()^x%bgdoj9X
zXv@fZv-0Rc3xw;%{3Xg{0h*kt>vt%W3crK$gA_Eh&*R%!2`0tTxKRZqKLwJS+H=9`
zT9-Qfz|CIX0sp2y1oc8(-ROm@`heb&zVj=TFFz!>?<@i>UYyz^8}bcJADG&64bFsg
zySWU8bV4CL)54g+D8(u{fA?bbIO?*T(q0I%Kb&I@q!kQ<nD#0<>Y@{dUQ;d`^x(6r
z?TqXd$9B7X9o@z~Ninluigur!%jK2#(@brLMFd7E6RW^Ot;*djr2$Cnya0=x6C*P%
z(Q!!f?(9Bs85MMN+O;UgYiSEZx`an*S~YK$Qr!7VO1x8FZbn72E16I}ohManCSF+<
zg&uE4#e&OM=2be!Sh(SzZ0f?7{BC5k;CGaY5~>u6q~alzd{9iZXk6%%Ruw2YgK-%M
zNWO?e@1)9yM8(0D_39#{2SAXhg=vS=n07yi#gIzQ4FtxGoUsNBgbVxG_qnd)>SY&w
zyPA2lpM@w~vWJ{~tOd~mg+42xY}1C__>kOzI~?y-!Twds?KT2;$!<!^R5eKHkw)Lu
zU&Fu-;)3&RWjJDm1_ySr@;r)#n$CW8mN~Xxw9$Kj{a^p~h`KciZNLb%o5UT5$X_fn
z?6I~lNB>O+O@Q~$Uan~sd-t-pDDE<Jl|`%LPTuwmdO3lkPbcHQSk}9QctHIy_~yc4
znAC^a8rT{cItEptu2Z>@n!e&$Ksm8qxv|gsY@$)B>0U}%VxG+Wu<3Y&=E|@1n8g(3
z(V~G^*2GTZ0_DKsZ~&q1VfgO`>{)fktz5(e8#2Ud%kHl|=o-YHOZc~w9sckE8q#q9
zkid)I%-OzvsJ+IG5lbXAej&jPWVjtfZW9EF@Z692trm-|z?=n*8oOh*su<l$v9HrF
zU{8q^<O3Zj5b3XHRWU5Jliz<^hWOsRS@?f*ZD7(5B`EjNO94_85=0S6G#NZ9Y4_S-
za?hhQSjE?AUz$N?usMPu%VPuP4ej{Xs)47?SBBJ{NmQO2+Lygx{``brimpRM3)SDY
zfN@tA9)q+9zgsUltUqd)Ft~Vk^^N|EXjz8#F0KpGDIBj&{?n(Xw-p7~(iap=B*|p<
z$05BuIe%SaH6IY2-e`-iJ}x4sI3YZgV)$#m(WBaUY+ivlMT`KV%EWd=_Ac%hNsBr;
zmZc>hS-NGNG>;%Akn<+K;p=IG=D}YIe>g{7#B3JGRSZT@c^I`i{M3M(XiG|ckL<a5
z54e1$eRgYYSXrYAqBtsI%s6-~jVK8uVf)ZpxMp3`C>B5?+oi8{5w%zl8h8aZ8F(n0
zEk|-9gMt~FEOfhL1g~-vo1JZtJd?D~cIZ2h<P?jF5~`r?Ih5jRhfe0ZO2JL@(sp*v
zv#C6r7OD0dwFIwy!(=rNyiVBEl@&(ondefmMa!69rn2kA;*8X9q8il>ldWi{vFwUl
z8h21NNML}~?;T~`<tZVe4G$rLm6QEx5xy7yP?!iqOlbsSE@^mW9#ChS{D+)*x(B@F
zAd-phL~GgVGt3rdtdnueqjo8rfMIddMTRip8=7{xzGOvMW+8gPyyQD*x_Qd6)QjyJ
zHh7i}{@PM;P3zySGFh$@8p%P09^$FksiYNx4jTY!Q=Vn)Wu@j=m86Emtx)94rt<bf
z_Fzb9L}bCHD=F<t8w?#N7O^>pG47?mHmS~Y*3oifCe|iXzQPS817Zd`?}c%tgfN5F
z()VA@&z?Ogf%$jCdv_5{+F!{DSatS0*fHRw>r;5fNg_0!v?E%yQr^Gnbe$C;c8QTj
zHRS;7_Xup<c$8yLdkD`)r#>#8(?+SdSu<htFewrFRnRNw79ehN*5Oudjk}BXR;I|y
zipl9m)EGC4ex(a^!L)q*fkC)~TAop8vWM4Wz{!&{jc^V}rgCp7PD1TvRN7ei+y{N`
zDXB3-X2X+7Z&or@+ZB)$bTQz@!&J0mo)Z8!$>;c4(5%8EQf^=?IxJ_!GHg)m$m2mK
z6n`-y6zxGREVU-3*^UzYFmS|b2rCoda5yg>?+Lb|g;4e{d!K>Dp=wP66<dk=8K$=s
zB%K4_c9@RFYPESmJnMb)>RTGY4Mv?e-aHrn$hNf}xo9VQD4cXVAe$n+v!f*;k{STD
zU`qrlDN9pODRBphVGPA}BSh)=M|1Yp6OrutXN&w`_{9{q@x4_LsaS`hN|tDvN_#Tu
z=1gn6S+zC^47liJA$vyelj0U_hTkuWt@A(b!m(Qxb=GCsFmkgybf3V@V6WROmdXpQ
zi??59id;P8FU(MzsjOHi^R-o|>^6XIoxiBu0m@_aV{Pw#qz`?CLys&qk8aVF^qGB%
zJRq2bwH`BOv5fX3v?X|1Wp5SE3x*PY?!(5Be!tiiGl6tWuGP%2@h1(qoq;Q`O{r&c
z1!Qcf0Xnbbc%!^&%DQsA9<uvyL5v&M_Y(8V$Z^(9gZ$iXi~0jqp53N8899LdVuB}^
z*ZMP4zN~w`=)n-1bCm4AQYx^#8TqSDESP@gSi{lGLJlg!bcelM?(CA>edHI5<}S++
zX5rPhm^`(uV}!LEbB4~CjkR^CG?#_L!}?;jG%46o!tYt-?q&-x&`P-9@evr4DxzvZ
zMkc&mIe$-#2~B#^#jHkf<52+Y+o@_BwX>9eoW9evP~G6P-(oOABUt)1u8j;pVRidR
zZv9F%``4j@eHN`0r6Ieikh4@bVzjj8JGn>K5{^B}(6}b%u`<#LW43W|{gc)!u5Kx<
zHkjFIb`o}6a6Fa`noGE8*^K-vnzHYyPIS+>9{(5=!ELtLz(y|$PYMIhB|B~Fl+UG!
zPVRBkIEgDWc&CcaO4MB*#x0n5!7a-jtWs18Cbr@^>cV~zVqkdU{XT;{>ufimqmbh^
zS;XpjZ${Z2N=H4f&S)4{BBjcv@=0A1x}LYmod&^i)_?4<|B0qJ`ePbI;k>+H7YJ>_
z_f9=Dn#TewTl_HU{}2f<dOg>__-QwNUi6i5>7Pm?+d@-Bhg_-;Jd&~T<l;oADo;v@
z>xQe6Q|G1OlSVU&PHw59@(GMmIf!AWlk+l2PyP9PyngzprhdK$HWY3EpFkKNFFX8u
zT^q3izFsePXD-~gJ7z=Eub#>q&u9zHD!x9i3~t@l&oHKTCeDfMstAcS<uIfyY-}w5
zS@}<c4-7La>;JkUd3hORP3_EGEC`ud*;4ydfk^<>TDJB$5(wWl`hRl~N4+?2V4*-r
zHL0~4dyCm-5r=#voh^4ehArWK4SjtaIOw^V4dG4LA@#<)HQ^$>#d(ivGWFlC9Gm^T
zy8LW(yeJIpg&rJF5JE7)oI$drD{-@Uz!$bK^7^iRe#Y(@I``{ueLjwKgkC)#haR-F
z1g-+E5L(WpK3`rPom)3BdEWcD*yMe&ufO>=vzCCIT0gE*>9X9sXr4Pb>d;{}ucJ33
z9uS%d?=F-i+w%m0E^kFXy<l33`g-<=w|UgukMO~KiJ>(wl{DTD9e_XW`*RalJ5gZJ
zLVTHMK!gxKe=7ymh$tzZYvOowelzj`D7^r=!HLA58Td&;a#TZ1Ff5jHWjZ=Udi~ne
z-{(n<w~gX$3Ln*1$w8_G0eTtN3yGR6O&=>;?wJc)$5+J<23wxP(OPubp~9w38!;wh
zQf^+0CFoZWKxkd)_@+Bw=3*K9MV=g54JBp5J0E2=Qi^eY!+xmgS~mvT-s~UvQ&fNk
zxs}hp^wt32$E$+2Y)QW8g$!N6s*Rz#`Kta|Uw_@A_Elh`jlJbDVY+AB;Pgod8Gj@p
zY9Xblc+DeA_DV!1f#g3QXkL5rUXNiyowWl2ysDv*(OS5*K)Jf1O&BCPhoqbAS0a0%
zts1J--aG1+P|w+7Tki$C5}Ci6*8T#tFo}ZE?Y6pdg1;KkH0wYv3QCBr8WaD`$~xlC
zvl+K#Oi6wHp_}fs{H0~&+!kqMTn(XZlz^C`pN}#`5{n37L3zf}4KYx=#UAmCN`5Ga
zgxoL;oY6gguz5tXE5u3a<;>eOG}NOa94YT|g)C$V&sgk$`rXOw=6-j{)rAAV3w@>z
zcTFHY6`5fd_lq<dpwIsFURKO*j>JLrf`%zt&2XCpLwBO-PH5VVVG0UIU-!d~k+)Jq
zpj3CLW2-ZjP0%TYZ6F!#CM$KhuJtDOLryrt%B*aK03d*r``1$f-h{cYC39cj_e2=$
zh<W5w0vcLbz2pR-i4wdRlV|~jarn!RsD61coJvVZb7~qW`}%O&e@A*C9pS!3NwaSe
z!klM56X4BkOORZeK-|djp|bGb;%Gl+x2uR7N^^bXh?f&}&h<_Ax1DH3^752XC+DT9
zNbe)YCz~))#I~hOnsQ(ajiC8c_d^QRWU2p}r-pHeOy-t0^2LlTdlmsUNYdQ?q!t4s
z%=~M@cnHW8H`X`+$ElVvw)S)Zn>T7Ou+oNm6kmRMLHwbsUnf<hNT*zmK-T7vr+3Wu
z*{dOvfD{;F;QoTAQycg*aP+Tl!0CC}a_%!LLA`K=$cehM#GG>Mk*qzf$RrQFpzX#=
z2r2<t&~Of#Av|Mdy~q}@Nv;~F3>g+n9FGcanlF=RN!DtVKZ;<g302W$K%Ksq(LfDX
z&9e<y-+kGul{xu(of3z$2O{}e$SWq0`@H|SMcqLCODaRcr%F>3s{Ke9?~~o1rco=S
z@0DM&%p(>Y4Y6>%(I#=b=qJ-%O-WcW>zB>!DQWkMuA!Pm)@l=g`}E+-k?SDg<9(-D
zMo?pGVKU|%;e=(<%6a}|xJ+-(-IlqaW98{o=_L6pf=%kP)428YNPAaj$(XXaU5ta0
z^rF_18Er>LK_-1gmE)=6T-+9-N3CT_(Z(^-c6j1<%Y`ij!zFl==-(!=EYIYU87A4o
z-b!hK4N1xzLliuKnb<Q9^pvyges5<h4NiEi*biIo+F*tC`=kDZc@}CQ`iniiTg;Xg
zgCZMF*))WhrYE0fhI6DkFh>^cWswNT)=OOBn?n@xAoSPzrv8Js!#q*fB8<+=7aLCN
zUqrn%6^S%}oSW)A-BVA@hc$ZwG{DKJaO$%c&5H7*4aWme(Uu=KpBBSE-&L-XJ2}29
z5xw0QsfH>wX`bFSH0S-BWn!0qNkg3g_FuV?YR=i&AWJ!1C`q6s*!o?Gl$h>b;z>o~
zSmBgdehMq;kZeGYbJ{FSw(AlrOI(b%C=%y#edi2y<DXr2o?PWen=bh=;T}5r(yY?a
z7ec1<^!#{0_WGPJx#+)qtgqwJU#wIwA)iW8Y?{d};ZKq6h;S!lX|Q2ZA#+{4%cv)>
zg4c4%8%EJXSp;FZk|wpL9-+@@6xBBo4J5e=X5kKLJacb0mRyv%rTeAtig|D=AN)Ee
z&hzzK+7X~!iAOg7zUAZV4(xQ6hEHBG3Y^pZMidA@*8|WuX0^+QjiT5>@<d!9M`h9^
zWy7ZPmx<XX!ep^gH!D_C?!J;j%&|y9%c{3mUX!LWgC2MA=;>Q5-Pjx;!#a}K%e)NT
zn@KSeHLfl(yRUmn4_7hY3HcJP5!#0fp`x|cLBYIg=pj`i-I?%kb2mpu>JteY%a5^I
z2u1?%R|9b1fzt#xDF-R+0Jo@BKur|y7Sp3KoS$6cG{EC$fF@%4cW--G!z|zSbZ*Uu
z>IHX(owi|CQmrKCT%t;VOrR|Re0O%i*XKD%cS4rtm?+QQs&9xgsDD}|Q<lm;UdLwq
z$c_J)<yRPk3RFN1)#>E+9<>5DHKGdK0xlPT-bt8;wM_ojy8?eNpUYX@nIe8+tYExx
z`0IORC(>3k;iw-9uOmt65bpXRst(kAqP|p$-qa`hfp`M(TqJ8*W{LGGX}hP4T8tii
zgq1nmS)h2d!82_CY%03hj}@Bg6NajnYiTnAPOsA;9)b_7lOqXVjE6hMq$K^LNNXNo
zaW_fTWqQHvNzA&EYU~VR8sZ(?lTfAI$Uc``sxgKS9ZCc>jeZWxR=q7yc5+ma(<(>9
z)iry{j&$<x;@IkA1-zHSuS^w6dKNi!xRe`35k|js@wWm418XT4A-c*(;TSWp1g()3
zFt8tb@Swydvp!Qv(idF`f*EJQsuBV~nJ)f9?ByOOyo^3#=hB@egYaqu=2oG9rQQ@Q
z9!q%nPA7`3`-+(>Mlnmcz!IM}H>+RB<eOk&`>m;rQxL<xU=LKc%~bSrxoP#ueT+@>
zu^+TbkN7J{#alIn23@V;uKd*Q6RO+!+_zfESf2f+ZX|6j<Z;vZAFriF!ly!jji!Zm
z9s&riwm&qm<fNYJB%ZbbG*DBS@B4Y!iN4m~y`u!J@10P;sFw}*mi6nO-;Cvy20>$D
zhbxS2w_2X|=yXmmJp%ljpATCjAEE9FFS!J>%7E{8w3=)IfbaWl>)I7W$d5Em%#pB_
zKK|i(pjO(q_s`wT2;$Id`E(aMUN@ZIsUj#ytcL$0CE6c%%q!O9RI{GJix4$LjyvOz
z%@2jlOnU(-#DS|5qMA3iSAiRWh`Rrr{A2%Pxc}ukW>$8t|BHK^Oo@B&w29XBRFIs^
z|DI5WN%hA9MoneR0wHafuU8<Z`|t99*pQQho#X#`@&Ch#od3&-TiP2j|9a4Tc4{pM
z?ID`QFvjfI88HpK=-YZB_C5T0!93$^#uSZYV(R=4dJxC<i%037WB%<QjJ)gV*M^C%
zT(0MFB;s73pSS0aXK!B}D?9v%7wRXW0C*#$LLi>Bp(w`8J}a(uDTLf@{?Dh#y@7$H
zt*7$|4gp+*+HP*Z&mD8vfn(PoL;DZE&rcmc-=tUL0B@z^--+ADt=n@mNa%ruj=;E)
zQUI?`E`IlLeD~YgQz&cFVTe{9o)v!4qliDs?l+5YWMbN(9PNBh=r^d}AHS@8eEmJu
zA2%dv-C&e=N<=%=mx3Z*{(hnLTea!$Xhw;baNvXM&R|49Qpc`c&X!Hh^?BjP2b$hj
z_MS0WbXqXk4$#Xtw)k(AR`sEqs<W}P7>AyZoIl+J`g0VmXTa0*a#EwtxC6trL-8rE
zi)Wa6x0aS@oV(b;+}~ek3V1vf-G!5^(^kfkI@r_J)6USaP|l8kWbjcLW^Q?_h+0Kl
z!XR+G%d>BQ6g#xLjPqjC)3poq_F2e7$&h*bNDzmIbt^s{u0V!+brBa0RiPG3v4<Nz
zDAUzYt)WDtQBcg@(RqrmD@MGTG3o{U@BQ*GNpe)M0SfE4SX$qt>j8sE1jm(y9+aZ>
zrkTZ9;-)CC#26io7GEO6L^YiI1)kLouId%@f94xNKZJ!c<uNpZEn4?b*bt-MK&#H=
z7}XS|zbL|CoTD99TI^k4snPKx&^~SMsX8v18H=7kG7+#Y91-ot>xf`8>A9}x?)ZsO
z{W#ciG|LFXWt-!52eN@qGm~cBbfA()CUX@Cf5M-NXEV_<i+DKTXG)5jxiB`&oIVaa
zx`YwHZ%2d|-P1xT?7Z?BX!}$Y^HU#A6z}Nc8R!&zLnwB0oDaw|TzP|iS31V4TU#x@
zkn3iI%hsXiE#eX-+ekbncMWk082iQ6JL;h`8Z%MrC^;~QDslG|ZY|BypuAdWC{y2E
zgMeYAdC?+iL%9lVgj6qKhUB2QTU+d*da-Lj(ew^jtT!@nJ*c$=7F#Up1=Y=yoxeuA
zeC{RlznizILBfH9(s9g>)GOqpP%nu-_Z)HyP`P5?@0YdMG{0p|d~Uc>6R&?du<{P6
z@?3RVd}U=oBDG24CV|}~UAC?dEzy0Gk!RnL)@Ip!67Soy*l?V}u#$}0YF5&>B~3U0
zTzy(z3ufc|9q~RWoM-<-);qs-0=50xxu%+I+qP}nwmsFPZ?<jQw(Xj1+ctLhgT3G5
zcz<1gz*_6NJ~&NLa%SvEq*DuZI_*zlDUo$7)B^sEnv@}lk)1dy<shed=PN}GJ&;Q2
zcx7HiPN~T+%e}D9_pQ4>$UP!J7Du-&fDquJ#a87)QpTA8MT3f#f|iX;&TyWjaG*x~
z%l6ASccl|AxG%I7%YimmRegL07}e`PkTE)o)?_U0t?lq9Y|v|ipo2KDj~Ksbdoje%
zO0$hc9WmeD&@!Qo|07PFU6M}z#Yu;gIZIvZge{)|A`NX2UBoN?2$Q4<rd+BQE<LP?
zDLt0;Te$*zpS!eust$xw#s8R1v|b5!h3fQ;wPnSUj&$Upl*E$EHZ>Rk&`EWCVb;-p
z!W%<VrqsE%JPSe6`4_jv61FopXY2->J>TqvplK|~_1mZV?BL#05c!N07QDrabBpo=
z*&bo3s6RtGR-D3^9{07Gml!xop@4=kRUy8-t<5N~rM?kCf>0OsQi|sI<9$uXfD*EO
z8>-q;{wW#Pc|KJi89{{w!0k7vqUJ!oNT|2Sw>V>WGtXF1FSSL#Dg6WX$V${}D%&AM
z!Z80RsDn%mO=_hINGKKC<{F`g8<8M2w0ys2Ac`2P@T?_yX*tGC9?o@3#5+_Ag8E(5
zAP+4s)Gf80C`CgWLMR+~Z>Lp78rhLf4{kpfSM*bWWUJguX{DY8Ah&E}KO{A5uUelr
znB-&uEh?+%rYK7l4<)H$ExR$tgB7hFJk0in5}&-`sGThWpD*(%IM5<lQtgOBs?|Z>
zq%)6pRfI;8{l%JZ88i=X4^qo1Fz}9k>>OjkRuG0yRQO5?(+#uOU~}Z2)aXneu1KU_
znJReetl)12ujpk8aJKIOt9Ri^)u#7A`Hnyut$)%0sR&WB>Owg*md@qk@|R_iH@86x
zLqeQlB%>v46wt)jLj8zupoPuK6f5jNQ>nnoZuSMXT#(y@HOMfKLD<r*T0rq0_`9_k
za&WEVK-tpaxyseBv^}HNEZu*TcKpw#p~(?(8trV1C>J#nP|;yyL4%{-fqiK6?l;e3
z5^&lQ>69!{LcyM;ORJ5+sQ5hA4754!5lQPWW)x4L(3~X&PWdc^PPts96RXv#ttx|t
zQ<FE5Oe?^j{0|Cxt-U+W)o99Ht_k<Si=f1`gk;*#KA}?ny(wLM>V|JE8i~)qSsu%y
zQFLm=6s{~C;K1kHU}2S8)E=Lc_8Y0PM-W7P-0`-kmD0`$h`_W5Y<&fxV%4o_WojMX
ziBcvpuKY{1nPA9lfPJ=(jE37!;X@<ETyu~>`_5}d)Fva44rDp_PFsNkw0!w+?74{Z
z8C-i@DC~6M-^3z2pF^=J7CpfXNBL{*z8gmye4MsBVEei%%~o88p95OChKssNQT2~C
z7x<u7U~)o08J!+=vP#8Rw1LKiU16tHBcHnRgbEupKv+YSMn9}pi}&FhM$I~cr|Wa(
z{#u~(^<|TOm4T+hNgDq++fe7b0zS={%weUDSNmcSESl3r2LDgXpn*^kIecW6W|#G1
z(J-zhpo{s$r~2`iUpl&(J&F*seM~|X5Jxs!tX{y6^-^ffSP1S|h$O-niA-k=jYwR{
zlHJg)P67>;)GD0QYzg+HuDIDIH8`7ADy>GJ53hMBOv1e(wV;);M0cptdcQ9XY_RZ8
z8I<edh1%P{eQDDSQ<akjNk%NEIA#g8ysj2fKz<;mzH>zVzom^vNNDqX`U51tihiu!
z*+P^s6qrH@p8g3{p@xGYV1-d<E68H0%pp;|L)Il|ebz|l9TGIs!bNg?5-al_(FRpb
z`FRT28OWq3l^mP$`@i;6-g$DC&o{J&9V7QZB2$tg)k)D*4rQ)<C&99~QmlxdksGGk
zfXt&vf0}+|*GNMM(!TLDY6Au4u*=iTD15GMZTnl}Uy~r&p2(~#55E`%-WpErd5bfJ
z1v8m)lbStecD*m<`<T*gQ?pK=d}`-}2IV=8^X*#Zk@Q;NAOsS`k-^VL>&*ZoLgfi6
zhm)dC-&M58l7`StBB+^HR(^^~sS#~ifQ<PkK!G+8Y6fp;;>%b&*a1%E=}3GE<FRNk
z`DRJMIW88(qL~}VKYuCpJXct3h~)Ay(yo5QK_iB}%~|-xlGt+g#qLT12nueC!tgEx
zyvt#&A@JqQI}_)6PoXBRb<w{v<!}our!HrhRjv`jSRg!#lT{Jl+0Sp#1hs|H0E<dd
zLwRwaU#UqK{NgO3zjFx}@y)T@BsX=*@s>GvMeG_an*w=R%>kkQ>-`isOejhiMIGcT
z0)?Y1Rj|C5DHX7e$F0#}%BFq1BXyDZxFb#)RyUrw%Ymx}GB&aPmZCK4izEoN+=ld|
z>Lq#$9dET&i<4|K#mv&SdOTF?03%q^X3Uy|u<<@6tWZz9vx<UVMpoW7v$H}T;RUTS
z+)dSn&j^$Wjz!@Twk=Ova}K@A#A4j)Nfl_0KGpCn=6^KGNo!y2oLD}`8z)~lix)?&
z6h-J|ZV*R*&<VBJH#y~#J6bU|Zaq@TF*qi0pKMo{V8lMlHS0^^%}%Fp0r^pS3%{q=
zTJb1E%3Om~u1jTumq{XVSox3DY|4Fri6O&`UqBxNh%F466+(`L*Z!sM&adxoqEE88
z&LPO`l3xMaF$9iJAPxdM3}EwE$I513%gT;AC=6qcOjt#OOntUJ20=OKZ(IG7!Z)5;
z$%M>31bF%~E^~Bm?=2IP12B{KwP~zBxJV+~d$91t$xcZpt$5ow|4fxw3)C1TRg|pm
z7|d+i7q*cj2^8ebZsnTcgLgb-YbZePr$!GIFbF|^7m#EIygo{9wC#<Gw=;6m&u#ZR
zmU<x!OKhy@LYeEAmg`fIxe_}shI?q{-`?R9VCUD=N-xhI>k7o90CHm=f;Lt3PZHe2
zcoCPp?9(;!g+E>o4O=2|0<{O@E$mty;8ONV%fNxJ)|sqrt`gR_<Tc*n{T70eh4)|L
zEEBIRq>m-9QNpZtMAB$jNm~B#n$=SxaU&veIeRA;Kjfl@NIqE2<K7;Bt{DV{#~d|i
zM7Foj3A-&L{jrob1$f#ucF0bY477g>7k0xD^f@uvE*>tArf%EGDJkA%6!V~)I)_d6
zWTN!_3zb@DDa~rGrI7hTk#zNr*SqU$Di^eb^ZX-k9yA~8+$~?^UIkbY^pR9BVrm?O
zK_@K@WZ@_COW{f=qlc1E=XaHVN3yNtRa3u^hP$p29izfX1vJCAnzEUf?7>s{iyt0_
zme>{~u73oV#v}hA$3xHZojC@nVxtlM$r?9*_`H4%@Hf0#*|A{}rbtezQCp1-Iq+j^
zigJ$A+|FWz&qf39Q|C4+Kf2gWRe8DE3LKola?clY;L$A>dPmr^;gKX=H*!a;V3K8O
z4me3Agsy*D13ro`yclI-@ceavlh{6daeU+YdYy8gKAuJ(cR4m@wAa56pW%(%A2uFG
z1Yh+FcQWvU?N@LN+G-#c9W%#A(8C7T>;e!k?UdJ;g`Jq)-wsP!YQ8?+-k<UH_<O!z
z`lc?n?Xy44TVn8YwtYM}@F2<f4PC97V4T4;Ys8ygV3yC~^x?n3NfINf|1*5TF>(Cw
z@X5@|#+kDH42A~%KiUE_6XSnt3qv~E5j6kJ&YtnREQr@i2{tsSjztibLAx`!bI4p7
zCdA<mK^FS*mMZdelVsj+`gL?MJ^dh|+fvg_rK&Ac`#v)fvVTm^@AG|YukTt?Gfn@!
z7M7J7=)&D~BB|Bo%={lT*S#D4Py52v`~+&v+s%mmciT4L<?Q2q0w9M2S0epE^!5B2
zk}|&@kwxCppe7rk?P?F$_HJ#%9o<}i_5==T0d(qY>vh9Xf4&~a<jg7c(l(7gD!D=m
zNK-l@s!2G4gw@a)ozl~`6$wsAHd|LXWNh#3orPn!4s@d5-B3O6xw{APLhTBG;1q6W
zZy}L)0s$yHVW_Kb0am0mndZAS1?;_V*8S)o<{tNd91G~Vys!b5YqBHT52hYr>bvmB
z%Z{xDo0U`p`8BtAmj7-_wk3<`OD<XU{E&hs27CnhkWNx-?2@xSZ8dZ-np|Ga*YUYL
z)V&j|m^GUe-*rf$xT_yY60+-0q`<(%HUlcA(29bX)34kq08C<@Vv@Q`-P>T`CGyAj
zQjO!+$KBi1tbNQrHSbd8DQj<CvpZ2Fw^@GI*h|k**+;IQZm)bby;KyrgMr_<zrw5I
zZS}|cWuGufJG$e~i!exY6wLydR&vk2&|oSo&dKJlZt+CL0oDDDVPCoblwBP6`Fn~_
zM%LALsgo7R0I9$qs2F%k$|^nMI7_$ex_fXQTc8m8f~#HqvVrh`PQ{*r?`c{M-J+=j
zM1B%=Uy4+8GhdWmG9;#0O@le@($*l)9x+o11?*I!Kkk3jxH!;kI@Bm$rQDk}a|>#s
zG4bYRY4?=Gbg>tgs3uG==-)h7FvEF@3kkAJ;H96s0D)j?E|4$5{nQm0w!aILvJ%Z?
z8}Wyr9}>FyfVRmFJhP|F__w~S4g7&YfG2SJy{%ZMP{F`AVnNeZZJ-F2B1{qHLP54_
zVxV|{)CBO86M;l29g8b!N`JpWyyc;YNi_8jYl*R?fMcSrJyK$>nxL6hqDL_K>`%2K
z9d?(d0$x5Un7<lc!qQ2@y>C%~=&DvimjA}&KVMFmjSzHbkliO<*tCb&FGrZJ-s0sX
z<No#}T<Pe&lUse~RODVSTz;>=AB!=uN27L?w+j~x<xkO{KT~pFy}kA%{I?i&vCO(w
zI#xzr8ggN*+kiH}`!Pc-c>z34-U<#}*@LWq44{E)(`#6?mk>lMeUmpT4okejQqu3=
z8SG-Gd{S-B1RG8iSpzLn5B3=rL1-@3iw+IFSf=q{1Mkf)(=^f}hc=+1L`^05Xrg+V
ztI7w@on8(T=;fSGmhr2f>sPHyA2_5)h$%F!!$;-)wK@KdXGXJHncJzvTA|8f!>%id
z2B;Udkb2cQCDj~-8?Ih93gq|q!}gZ~%2!mVXTU!5H%r*Ar}Ldt;edQf)O6O0wUz=~
zo`4Ony5Lz?hfhS4!AMBKZ-g2AyHjN2`pXPy6pg)h$v{ZWH~@xIhDqxXL<0Sj7i|JT
zh|}TfTbqWO&79JhY`y%HH?MNVgw2}M60n3;AfaZ{o-dJ|MFBoU99Q{PyIDEps;FT0
zS127}8~dWapOk}l%r(P}O<Ac;NL1bls(iR~QdhO+fV|m@Fi>3^t;C}?L(XyWusfno
zfG-357es}bX;@yA%6R{4=SkBcRT6~ig2NCSBP8p2<?2ufYsDFP1m;-M#@<Ug79c8g
zCp}xjR=U-o(S@_j2w4&ey(!V|On7%re8G&COlLOTK?LtjpmmalXvm?g<*$0Hy9rAX
ztpPPk4?f+`=JEO6R><rKc)oSaN^kku*v!mtegyWU+Grb_#q1J0W^j_n*YtqzzAN>o
zPY3mEx)#0_$BUGq9vEhQO}em_12E1hecTZ{cJ&4nEr-~dqwp{%{bqw{JH{>)c$e6+
z+Q@{c(?wDwS;`=DDnN`XhuXt!%7nOqj<eJhyP6vPg&!uu3C&0t3}WA*!UNGl=|$Ed
znitdh(I!jl*MMV<WKxl3VOdApUH`plg;B{+$N39;7%hj}tXvO^bVhTm1dyuqnPqJ1
zjVL@~NC;>ywiePnB}s5LQWeZAn9}fq*E>5XY_C&#2t{Gw0=h~|<sikCK9b5hHpmm2
ztRQ9-dRb2o<<QApK&S{J{w$Fqe6&=>Z4@qBl_80`)?_h4M;1eeaO5o=(oP%%OxLHA
zPs|ypF8y<Dw2eKNney(Y1?Z=B+&vbuaa9-kLtf~$uSBFwVVY@hB*FdZO5VabQ)%E7
zhhZ<vmMge}u&(D64@g7XT-3M;4%I7I=%@Bh)ndue5^BYmdiXI-`p2Imm>=T6BExHU
z$|~oHJ*tTezbt{E)(Rf2pFsY3q_s?e>L>KT0=26yw{q5xj)3Mv1gs|gR&R4KIgq|R
z13Qh6zQ3>Zoh&kj_?U%C6*gFdj$OacBe0fit#I^pzoEMyABr1@TQ-^qQ?GklQG^Wp
ztH&YbJ<&A;#_<PnI&j_nd)hH5Ew{^$lhdR(sayH3<WlM{%RZ?REqujQC&_@9NeVoH
zwTrC7RQ7q%upA3zAwW(}ZhuI_mP)@rM@g6mN~Q{iEG!Va*Fq}xPp~wzi=TR&^$Xg7
zRlUg%9?_sjx%gVRq0SQ1eqkTVxH;q|YNmTmPN|_7I{-Oj(chSQ?Dl@05YoN{w|1=m
zwWvy?z?wWfI*2W0oSfNaJ5M{5?`RS!A5upfi)Eg9>=wx?2+$0wYEct!DcoE&Ahnb^
z>o0vo8<Q7bfo1Y*C$?eOnttJvKjh42x&nosXA;;j;r@4}y#^P;#o<2#?B=L-r`mZH
zCfbwa@OsrkO8yLtO@vFFzg>EYH@<PbG@`L;GR;XZiU-Uz{IS&)0!dVfav@E(X)8Td
zfe*v**`7smR)ET&J9ZsORK(E*vl6V@^s#oPnMPYYaRJ=Z<{6oTdKod^inXm;%*OLa
zrynH!i_;~oDx2+C?1;Oj(g<s`ohm^+^!Wx8=4tTHg`S5k-K<}X%XTPL^l1QHgU_Kj
z19WbUZojH12}`;;Ohg8Zvp~@9I@F7Hs_}}|mM%TL2{<!5+%udF2`_#iN9<%0ZqKsB
zJWZC5IB=7b&1Y6I)_z@kx4e@+np#LHO$d)XMqVasQ?E@*$zvcnB(dQ6r+vG^v9Ad=
zl$h~y+7B%ud5sH_II>nc0huy7m9Q8R6<gQ;j@rQz%<IAd4cda4cw-l3buSJt<jdtO
z%r&L=0SFAzT&tqOAK9G71Sxn{_(d(ueZHr^w!v!QkzL&^=BcvucnbL!+SH^ud1a&T
z+$z20id2$q#!TF*_*W@^bJf2qm4C^{U`q1si?7Hu^LI&Y>E6f5%m=ZiTHR#i-}@NU
zu)~408I6%QwpL@#R+5il$1io4Kbyz&t=3&^P=M)8i6sFAdhH_8uIp_skD13z5cM%;
zt3wcPeN`BbfoU^>&Ze*t&}Sa<Z2`Q|tu3-#joW>e>3tS-5OhsbDZ|Q4A$9+NCZ(>W
ztX;kx#><~UM^aNV<Uf*QY(C=c*ar>mp&lB}U7#!$%bxbOc-{=wy0~NNS<iXSw!ZqM
zUw~N0u=LgO0Au}H+%`Zxq0uT$!2=KG6xAo<taDZ$7;9Pgo^iVxHE=}BqsLrO^+R&5
zKydGy>f(HYvDUTw1(}<Pbmp8xr+QdR^u97XQze+mxw6R_!njVwAT@Q!q>0SZAY2hM
zDl&z$N7_ws-2GIapgBjWu#rAtokn~4BEX*NB<%j*?@R%3=+HVQ1wOz**`JE{$;N3z
z8?3*{<cCHt77{%=0dI-qG1cP@N=nqJ@*r~!=A%sL2n_>~U_RVEwypVO-e+h0>MiMa
z|EMGuZ`kbfcnTUUJ~}qM-nPt4n&JXvOMF;HPSxTs^5R_k;wO_Ln~J`RmNlMJ#Q-e>
zX5G1JkfvDeffMvu1m`MJ=i(50`%a4o0EaIJpG+dkro?kOcZ%Z!B@Jq~()9C0D$&9(
zp{1N4=b*EGQU)s7%~=d*PMmpW>dPCg`6d0FZC1Z>V}270nq(C)V@%$@=FV9>Eq3|$
z(NK`~#?SFI7mOK;5`C5iF}?#gTfp#?+-~W9L4wH?G6yl?yBEmO*=nG^BW&;OK#n17
z?rI}H1cH(`-X#^}=g_`&i}C>T^Sj|h&PZ@t*-<p|l93qG4*A99&MHST$cyW~$6`9D
zP4@l;D@wdmxrGT{hc3P@Nz*JMB=e&HonHEMnJ%6+&U`JLQ}Bve>%GFo9N-v{;8@aj
z6``q#o?1=AImdtIbcL+X)GL)*zT{}Y@62w(#!9E0<(G3|a+!+RhBt{#32o=kwem!1
zZ^Yaj@6>fNKP^&DU^mydSiD&4(Mm@ig|@F2qq?Nr74!U*{3S{GV);4kAb|>A;`OAH
z^-{#ap}INa(&!XBJ54@F4v=uZ3U8}(kyig;h#?mprTPFiqD{gMmp!Y%Qk(Mg=CYJ&
znh8!=Vo%}rgb(`tty28^_}vuh%kui#IX4K`HcGiW)owC-7?OZ|wI4KCH~b8vS{B|7
z3sw4<)A5*ju|M*O52e&*I0<Aa;;DG({yPgq-Ru2&X50H^egxm=gYMyWB8K0)KkMuB
z68(GYvLvV5>-qK2Va4&1YoA*q{pVgQQSEs=|KTbJaA)TJXRM?9nce<JQ)Fgg|9{dT
zGspj58f5-oX|U;szx-3f@ZbDpsn=;53#?*~_PXCNdOSM;w}Q=05ni*^L6NsTZYBrR
zcdG%Bnz0Lui)pvfFWr--*!-XGrvnqq_BnvJmlpey{gCr{e))?*HnI)LYY$|#oXoup
z=8uQR`S~0l=eIkTfEK<FwagiOpVqId$HAY16js0&+}D3tWw%d-Q%7=3{X$OsU7w#1
zyVLR;y{`8BpRY6vqM55%l4Nu<ACnJ3Ic<;M2XOcp?!7xXH^~QI!d^Zj_Ajj8(0X?<
zw^Qeb^!7b~_AcH}43dxi8vGs-%vT+;CVQ$e3VEH}KqZ*pdz%6REAk<@908Yx1?W9p
zv4ES;#cQ94ZLZi+n8{4_3F^>oC%gyWoIZW=54qr;HmDd@s{;q_7dU>WK3toy4nIs6
zjjf%Lx2~6HQRAYTeSTVJJyajr@)epKu((apKJKlTJsi=!loxR{;o>R<4IhTTyH7O!
z0dR@bmSg{fED-8xKlolG=)6dd_~MP6s{xOSabM|Gdxz|OFoNz;!O!}5#{2PZ)Z&`<
z)2&y$V(Fas2kf=LJ$+ZLe&I_4hi*3^Q8D%N0Z)!CXMbR7_USC>5b+?tH|j406Dbz6
zt1yK@m!T%Wdy;0y`v~eI!r1e9o@uNls2z_6voTK2;sfk<1v#Gy4!SSuVNIk~VE}XE
zwN0Tu0=vE9iZ>MJtXfCWqJ(0kjLM;U=(r{HgHjU=?$I+MS#q5i#2RCXI1h(?`OpL;
zzk6fn1%EeYQ&{B>^SS%0p)F384M%jcJkyA2-qu4|>l*3<3#DE-kKwgR$m*Irc{g~+
zU-FIqjmAY%Ewxgh@Nyp-CvY!=O$Bg_wNhydo**gB5CKYzFX_>SRit|0Cw?UXQ0`es
z7rH9rtjH?PE5_m!RE<!*j6#~4Vq#RtaBeGR77fFy7Gzc>QECE^B6wUuu%M{{XKnmh
z8zL!Ac_#5fGx<yOoIs2w%1T>j2QkHDSr!MB8v#oTynGLEe(dKfW`)tG3jjeS${E@V
zBbrMdHHc+(%_7M~CCNP#LtW|>m4J5h5qP*PENFX~6<%nl^g<?47c|9m9ZSb~nu-1x
zvnz39w)sO-<N<|Sp@eV<N;VSN-tz{8zG#shA^Y;=zU)@~{b`(H#%mUPx~G1W`AKf|
zz65pGL$uC^r<gH4yT+7QR{*oHci;Ve(^K1NB9-n4Ngen;L2V}eXb5tZe2K@92^9Xq
zBt_};PAoOWH8*IYsVhZZb?tiA?U3ETDhe8Q1pWnV#QISDfTENHZvvoB<@7XT74>+D
z;{4Xnbd6I(sTZ<4fJ07_ZeGn7W733KUtS$s4L7_5{P(jVht{l{DBx<~W+!~brwN=k
zJ;O}$!-leKMdstrEd3J>83$0zsTlS5k;<V9qp2BUyOb#3q-c?7hQKv+iuVC;(R12!
zZ#p--!BhY~PJ5`vK@kSA>{Yk8QXf8;U@3ur?m%ZHn7%ee+5J$+FAS<t3sH(>7&jPB
zr)RrP*^mlD(mnRka6p!>w^J{|zBOLtloXMOBS<{MDe$$`WL{R61o*b4#xCkeiF%|x
zd6Q0>6Nie_h}ju*$HU~n!^WY?pPY1R<>>iXdY%Rio6KOZ9B{ZqQT=Sa<h%x{5knTf
z6MCZ+{3O)wyIFAO5Jx@)1G`i@%8;<qCvUP{Bg!w{Pw?RbHGs#Qe)=V}GU+i&z}9QA
zxC$y!IdAlZVgCK>1pM23YODX}Cv4iU3XqP^(HAJ88OFwDn|04(s~8F>&2ol=MOa}I
z{5zENVk>CIpPn<AV%k!8L*J1cCPV_muZujZz?)D%4nz6T3`fG>@oOSWEb}i_L>vfD
zrfB{|odNxjcmT|J?R=j=xxEEYfPfx56~^4Jku_%LlS)>W97dO9f`}2`xSrD1D2ftV
zBNTQKtN`Emu9Y+;CP~adla{^Baah~~+eCQyf_>X9W~mBLAS7JyJw?r(ej^m5x4Q7(
zAgAs#ex?iBD~n*gOr=C7D~iP2;y{12Hu-$HoZvE8eE|r|14p4S_M%w*E^py!&2$@a
zP|8Nl#yhZ_yL?z$RC5M~Md9ZsNg<pILbi8*qhi@&Wr-N(qC^wsl|LM;%*GACfT}g3
z?45l{KQd37M2=|cX~fzoz?AZawj`;h^XkyNka<~#|Ja(b*%4oz=q2^1@~_$qjiqLG
zCv!H2J_CpVx{}-?|0t@~F3sLY$IYQo^CVw-chJTU_birFj)hS6rOK$*BoWCLtdnLz
zGYmeVI?t^sXKWvP<K<hqrOW?>MwJ%_eIkp?i^M}Aj4_JkuQQYwe+*zpr<bbIc$9ON
zxZ_w2tWtB#+(tc<cH46HnUwh-edKx99CaG|ngW(Ol&R{B;`YM%59;N)9y%&74<X<8
zPErJ3+KM%dB&Eb9TP8JwqCu_`C@58FX?K`cng3~S+_|C*9q}45N^sr8I+-d_P*r8J
z9D61zW}Grto_gy_TCFj0I=RE;sg-sai&o9R3nlGgpXZCG!q{UGan^E3J?6<&P|&^=
zF#@#YnoX3E0$*7MJtC(HXEg{(FQ16Aq~Zs<ZP-(wn+vwZGKLp%g0rMpsc<KP+Wapy
z9t7(n8uNe$)7KxH?E=f@tytvL7Cy!$?-LA2Rs4WRhsJIr^QPnn%NiR<Z1*=5L;m?y
za;3M=3!!T#Of(F2{a|BOJ6cI|0$8TpOaZ}+!Y2>IF1DfBrHJ%<Hyo~TXA1~}5=Cr9
z<Yssbm**xK^84YyMi*=Z<`89GMJJVHMB<>8d>s%e8b<G4D8<tGMKVz(+l|uBS?^l#
zs&B<Q&rv>mHFA@8rQ{t0<~hl!1f~KQaNoBl%5(pwQ&20vJ8`^@e|3y&is#cW#siX`
zkM3JsoaS}Q5~)-<=P3PcV~jG&SyV?7Rr(HO{en^bW6ntaGMjmyb*aY(`V3l#7q~;D
zzFD#k1U?RUK_~4W^>hdd-`8v@pY<U4VqYc3esO73^O@PsEEELD5KxA%K^>n-y=6O7
zvE~dH)g3m=m*qredbB@9i@Mz`5d%UkXhYa7MdU`@*;et;;;Yf29atiIU-7l%<!%$7
ziZOtS;%Sz5J7r&3ds=aqXBV;lau7{|;SDALH?k->3GZjYk!!lyD>`Q5CjhvC=<2<?
ziK=+G#p#q9WFI*u`hBL{J!k45@-GMBC6^BhZvw2QQBm?<rKJxKnzJ0*Hvqdef1y!L
zvl}}5dqBH)(#sdKi5mjKi<HH|=;N7MRC*ynm%a)5$0eNuiHdM$0~XGB4s|A=*zVO^
z_3~A2i)2&!v+r?{*NUZ1-fZi!)6az=ZJoqhy@zQ)qJZW_(P@VaP?%@6H9rZU6b6n*
z%41(vWE{Hv*)hSSlN{9~F9Ef$>7**oE+B1O2EW8}E%FRnO^`KCq3Xs|TUa8<$T-U6
zuA&v|o7=(JOy}!EehgRh!cZicn<`a&X;f7s^|3u0#5J!nWg!6_{AH-j6XS`REx)$P
z=&Kq{G@J+g(V>tc8i}7Ht=NL~@lmvS`NLudZkxdC3a1{0wZNsNXaKtsXG|Z<mnX?|
zovO3$V(n~~^eH`O?PE~hb5vV2bhiki-Mx^gR9^GJT`q*Ix7sfQ-}5?+#f9dW?t7EI
zQ5qFctphs@9eC|dYacdZuq8_<%!M3Bsb$ykym<P?ldpSG`eE)3Q_zZ=K8r6e-zdPS
zeoUnr?QuUHi6kH=xByzOTqyC7Pw#$t9xQbAs|;Z=Mm*h;E0{v`peH|<B2xq3IOq}O
z9uAp03jw(|d1n1463VU*Y$<k$gQN2RyqZAMi~G3g;a}r8yBB^4$@%RJ%TAo>H|l$t
zeWx9ze7qrHMm+IiMdPHc9wc-n(KDa}<QD3qi%;cyJ8XZ4umB{||MdSHNB%7W!6`xs
zR*^v{M9}kHyf97ab}w26R-ib}o9cIQ&Lj(5cU{JN<8MVS2|4LapISIiVg>**Mz&-6
zsWG`r%^Y6V>hv))g-&(bAX_jVUWRkkl!LY$<>lZ*Soy14)70*VVBfPdV2#unu%p<u
zr-jXU;2F7}NA=eF%{byE47Fdk0P=&8e+6iJCc4i&FQ|WOue7YveFGF~kJkY{KR<GK
ze8AVo;eN|Zj~B4!*W<GN*Xn1Aez*7An@d|J#4G8f8S9{`8_i#}kWTfEPxm+a!>;(o
z{~k;JpW5^TGy1=dMHU9;|Cv_)U$TXTf#tu|rzuTs>kTm!pKblTWB(@SX&rE(S}n;~
zq1-$eZzyjE<&jndZZ^20?{0Itx#&h_Eo}t~;1O;t@8hp2c0Dzr+h;p~`(N)DkN3kS
z3w}Je8E|Tiv00S*cv34(4B#R~h0cvjpZ7BNjmJjo@AK#Nk@hVBkIxD85{oVRRv~~M
z@Z9m#m{3jvWkQ--&he>v0jURsR#KB=4e@*72L-=j@OzYln}vgx0WMy$!vJW*-*Y_8
z%I<`fhaR^d<dflnr`N9;1`C4_KVLm^dv#v!G7@eJYj+MXcU5TG5)u-##baMsrU)ME
z$JWbeQ(GL{0c0m6arKy{n~GU`9iq?*xF0*tg?EgVtu*(QB>&8}9Bdu6tnq~WM=m~3
zuQ)8Q*5w1q2`g^U2Vw8S|Jivi-yxrp6y#-!Nsro7YNI2OVS*oBo5#uDC99wBxK3k)
zi<-_hK9M`gWaJ^tqWn~)`Viz?_M|;LIkdAI2Z|?+>V>%%t$9gPIzm*BrzJ%OIKi5#
z%<2N)<vTH<6mOW|L4+6qRh9CLBz)+O8SQVwd5?v-mKHTo7DNx)4~F<pj2674he_6V
zl?*{F<-)0RGnA%WOI9+oWX1I`wWQ7(PT7ALsTE4GyNBIIGS@9=griN-JCw`IFvOX1
zBjLjUvPP`kpBWR=3Xb;?O?4VTgE=HxZuzAX(>`Umz98Ib<-qw1FV-yzg;=VzgY4>N
z$8}IQ9_^rxX@^H&drImr=Z-gz>XrIle4No}3Z)*Rsm0wa7hG@__EH-*v+#K_x^Z?6
zIIp5vq>yH3pNC$-(?uvgk8#=dyTo7UG2&x-ozy>e1Rt}_XEJ2WTdlc(bcVEeJj<DH
z9M5C7>v9-S-YTJCp_<4LVG-KAYwRLj_G%QR0~pG`n!2!*S>~}k)1!);sZ=&68w9Bk
zGWj7T^Gd?`=U)E9!(#U4P{ew)Gi?-3SA1F>Mr=HA2wWEGa|HL6I~w7PzsrFf8X;kq
zOXZ7p8mSg>eyUu1DLMK8B#g0#JXT8TyWv=&M~gwOCRrJw+1bF@60oLI=ZSw4iLl``
zi+xAU@a9Pv!$xK4ih0yn4U@`|fV6(u4i%WqVH_Zxf~p)uBjUVRR3H_Nt`NOVYJ)Zp
z;h+-fSECv;pMnx&gd#B;gqK&Ameb<Z7QH=F@3c}PO|gq2IeSq8RztZ_bFh<thbuQ&
zrT6o+uONjRtYU&hQE$S``wA~~gOuyM`xDt|O+-rpdkh2Vj)QL<Q<7Ga>gKKZ;kE&J
zUd#t-^BKD~feegQo(Le5V=zcK<8@JLiobh$6q}#Bh^!P?{{ACdbuQbaP;SD6Y1^e0
zPLco>RWzQfTfkikhz~_g`s2reh^I(RdR$ASH=m-+P&DSz<`1FGM5CxDf}psS-qrbZ
zq<RJ-Mg)4+06TvL^;>9t`{SsDyLCX<U62nN4#0MPFNgzYP3Iq&vuW5HVF_2Dv#58}
z_qq|HD3=o_TDaoxh24KiTWZg!d+a;X@^wG7+1io%82^3_P{4nR!fxz&)RRE28D(h3
zx-zy~OLjUMC&j!cN<TjUALBZ|`k1B?J$sauNB3LJfgIGB+$wpfJrdOecA`Wsa29<t
zP?F-jWFC00X@n<hN<rs8_1z-yVW=w2d>a#K0x@fz$Z4!oeGSN1NKWCuj*e>R{E!Uj
z68^f8r8zqU%)Ar#v5)1jT&cbeyt=+7u(Z(uT1O{xST;~!2NFES8-jCVzufLZ6oQ5t
zJM95$^45Uu(Ftz3lKN>?FFd^K(mHPHAC={Vg_$~SlVlj7&~`Y{y23lIdy&v&zq7xa
zhjK{4_i`QM=2A+ABnhLuGK5+o0}8B3!y`xCaNZ3-WODy7^W5=C-|`F}(^3O3A9L`t
zj?%kayLou<c&@ijCvv>Yr)r`xQQZ>)TF6I*u^t%sj7jOB>=e+<2|pG><WyB9406#g
zgu({(CYxgL#=pN%8%t)j!=L5e=<+Ls@9|o{<o80(4ZkY8IpRb81{sU5f&I_h;OydL
zYM8*K0t3tNziTT-R>l-`BH)~c%SR((I2K0s|9Lk!8CaN7@>GC-;CNcv)+Fp`|3!*`
zp*ugJv%uQ8qGR(D2xdJXJTPQSgGC;d8RnpQzkWXPDVK`poieh}(T$IuRy}@Sun9ip
z4|xwcPLc2F`F=Fz`o3|0;i?Opid>iEWOXheqc&{DDn5n}$@yaR=F@Tf5k6jT-M<I+
z-BQA`<c_7&LjZsoeE8#%fVqaOLgWTSJC8Tpc6|eosJ(2T@7K}AFnqzBol!J0Iky*}
zFTq{N)OlPVt?#i91e}ZSKVSNYTUqnuK8Q=cOlWum6*pBd-+FSVs0oINk8`O6`Fn!|
zfLr>uz7YNFZhoB{xa<7t@3-^M<4W3xCRU^1%BoafNL|3LN4&TKg%ZTS4HzUvl!jA8
z(zg*v7U{ppc>Y(tf{BzM?wKTGLLC0g0m@hYXbv*p9^A|U*I*hta}sFXM~2aq`>jyx
z6ZYkiFYZGvhU^gAsW+(AW2QL92{iOV%fAb=Ldq1$#@iC>sIFuaK6@$M$)a!a(abpR
z=l%b*0%ic5o-*1h7RwYts~pdS!{A~n+uohmd><;V=X`db<HwDnctqq8R7*F|ki`6G
zp!sc|Uou#VtdZKZ!9n8H{^*A1gGdO9;=(qTH}WG*AN8e-96r23iUQ3ozu>-#O|NrX
zjl#ZUxrSu<lyd&{S_C^dHM4^U<Db}vC+-bJwFCm}xM0xvct8K$cAUKH8a1sK*{ZOu
z`k7SAkrJE!<^hS|s=3E5_vt+H2~W7l!aAkYGD-}TiCS%g#x}ZkX8cYn_AEzWOez4(
zJ1Bxs%Qr2$Vb>fxn(Q_f_GwmI2qW!oj4yR0RvUK5G+40ynS(G!qZ{B!@&-6EPUvQf
zasC5fSqLsp&LB-l<9x`HQr94rkP;i=3K#goB}?;3g=ljON!7<v%~+xghA5FX4>%DV
z-pxxI)jzgRAn8}jJZtY)rxWBL6(Naud(l7}ly&mJZWO-R88LKRknsWs!Y0Wu!h)H-
zrIk;_H@G78T3C7s`%7s}1ns>5!KKtH`APtYs@B6<G)W#rG21;Qq&ayfo|L{+z;Yzb
zWjx^ESBzXznp-S@r8e_}iLEBX4^1QZ1@5b*pjn2);VZB1dhO=GGe)u%1|Yve<_v+u
zD5ozfxhE_ERK^ONmBMxxXge(@{eMQNHzGek@=^6S`X{;Nd<=A)ZoUxou=51>6Yc<b
zSfOz(CnUAnml!Uk309{hH0NgrE8y}{`r3_yUnf&qn<|inj+;@DjaF*@3L}B6%<Dm!
z1L>EbaEriWbh`xIMs?THtyKgD74sXt3Tf)+eh1Fxn=K2VKH9tt<<u@3@a_$GzD>Nx
zx!j%BPNME!5uPu$fBHtV<+P)ybdCU@YAO=!0k%7bKte>h-V(YN!;{qp8VfAO8}6mY
zguAA`tA97*6<kHSenIjRU@ZTk!c;U3G~XD|U6}zgdwgf_vjsJ8GITl<unDF|1ye^!
z>d1c(z&h5Wudry*<|0SwCQ%}AQ~&E@<+Huin<SU@5W!<hVev=z`OYi|Tet?0vp&4m
zPaY@-6=<ER0c>pb58Vn0gmLeso+zzu_!n``QwHyb1gP*(Gl#JPT2?H90n?C`aGv8Z
z95n?tED{F<bf<7&EUvma#J%Lv2t&9iJE8KgByV%Pi|H6_V$9mK6N|j#P>_P-Uuy;=
zYHP0S7ICd1)|!Ukyy1UfEr+@QWaOmC_oA~F(81?i5CxJWc8j_#PTK>Qc}rOSb1Ez)
zU?fBmT8f%MQBW%;tG4`ch9|p$Ra8V<h0A31)YU=8h8RR&M$}w|SgXlFnox7`zHB8F
z#s0ODA}T;3cSyiP;$ZW^wVS>d`2)olVET$bp-ee)H%R98x@DPd>)~mDoxBA}O&rEn
z-@aH>s4qia-zaNVASd(&k+fju#NJ=zxxt6P^9eX;u58PV)+qY09RHI}*CHBpth0(z
zn!&U55W*lfaEVEG{{UyiQN0E~0!hS7M}ETJOCr`=zgv~6#pD{j$%)L6YYO$$;+0yg
zhr*^f7Hib_@{tVD(y5977lh(QybDm)N-)A9d7CQ!8RfrpM#J2ro7qnDe(a0=nnQVG
z;e)B9JW@LebZPpyoc|uPC=h3^nc@<!TE&H>l}(}lS+v;`xaQNXVa@~=gsf`qC><OH
zuyFgw_mJU~XCyrhQK&$UFVxUTSL1D1ac5*ilh6)Lwz)tC0(C$DG}B-X+ak0c-O8Wz
zDhli}?ehVuL!2NZj@_vF-Aa1~_hn7ju)-@2H&gGpthPl;HAI_amHVD$#~3w3?e)!8
z0+85BfSL;-*>1Y3T@bUJw8D@RS(5bRj@*1;gtZ<_4dUyEnk9~>6tivpVy(Kf;T8g*
zY2vugbArGZW^`@97ZOh#W2>o!5qAM1Y4uVC1Kvc18PYq#01k}>53Z)`c0PoWHMoJ|
z7nA>2{;!VKc-^2afzfcY?HR<!wQRM3A-nuPtqBbmPz}V@La7<8jAn0m*ia3!cCZJN
z+!2;8jmO&4LY{n+%2F@-Cg1&pEJmY&9btsXd+V$T7pPJIN$BOK6=5ZbeuhbsjlyWv
zE(V-=srVKP(o-Gri1awu+ENQztn*)Lz;!KAo#WtD>-x83PRr2vPPAdh!&>F)A2@X4
z=`hA4o?)d&sO;M+Kt!giXgo+}=^J@2y!WMX)ajcZoeh?r=&e4&K_ei^3H)LMp^cS1
z`4`Vw1Q#>_?VgU;p1aU6HkZ@V$0|LY*bZeh1k+Qdz?PwG=3iqoq6%h&#?DFLi)Ho(
zgsMH;1FhDLM;c0?vn|<9g*^)^g!3;JV>2eTrg8#nixcyIB0OYe&wjZaa9Yu~m0Wc1
zE}>;`h$&c~6K%r}K(OsShQr^H@f0O;z~g1iPxk5pB>3C=qw##BY_>0s3eg%At<NVO
z?tcU2Abox)Pnk{O0~PO2+cwzTU8e_QU*F%KEJ8?VJWqnHnR%L<xjyd4poX;}sO7;P
zl?z<MQOf{P7Y)2H=1B}Z6&e_osTtG=2K=U7xL^u`=EY(~e7xwbnfg+)=+cdT`}52k
z!pbKISSJl)BEq6tC=@7yjayW)Kq;0rliOp=Q>FJ$uhbHq+4b<RI{!BpzJDhyw=p>n
z_<nQv-hYqD;p+jsJ{&UJ-CYBEUaphr_4W98@a0O%5RY`;KU6#!yb{eX;MBC}bNIeK
zKk`npqDS23mn9q0jLC~;{lEC6-#nSTj^dNZ@Z)@bZ|Bp{Z}jwX5>4K8E!P0>u6o{;
zp_z5NWfV6$P5~hf!ni-%0MwLD17IkypY$VhN{k^GcEZhXoD_K?U@Ayvj-OxM|2OT}
z(n18h!3g(X=l_X2GBUBVaHLF=ga2QzDhtbhc~!{)*dvHPn*zoeVAqAkXCN?OxUnfe
zjL?1XJAwm2M-yR5npJ-g;%~l1w?`Sbg#5Z$D^79sKe+m;>Zq%*^ELAJaydOe$gj<3
z{o==r`+0igjFrjOtc83ty9E={NwtB8*U$NFA9ioA_C00$?)TTtk%8SQ_G5lMGFP7J
zlov9<m)F;=rMI_|M{@$Bk=_MU*O#-$JrUW?{5iZm{3PC?-|ap#zc0}6!!0J<#bIa<
z4e~BTkMEE?4m}7?+k23D+FcCR&dbIxdgcH?V8rqb!^rtnK@U_owO21aZfW2)QRP@~
zD>t>zQR^J*-NE(l5OFFfjLULkYcKfkI~oCiC=$*#ayIER6#4-o9@+!@hq52*0VhK9
zZTB(#1`ImUgeiC$pBWu)-VYV|`@zNA`^~im`Q%(AO*6bot~U%(Jt+<JnUN_8177K7
zgWq%295o0=j~E2iyuSSoOU3!hNySi$ZT101gNU_7I&p|O#wj?LfB!X5U~+r71>_Ha
z<R`V@sTR;KqJ~`ujR<y;UA`c~wgc<mV665}k9f-tsY8)L827e2nk3_L%N}YZyR&3a
zmBeeHxcXmtzLiM5H|l3UKhpNo_%HtltyYn|KCzr$#cWY1OUDvc7rJkjzjPK9)*YqQ
zy@GdJRV!Z~yZb!}D<Y)Lnv5DO%xd8P3c<WVn{*-`6FL2FRJ3nXkRDi>NA2zJhryfu
z8c!_1=O=PTwqf$TJTiI%6yV$Zt-8o?b*`4d_G$}n@UYZIF?RVEeRh+_kvLkB)&t4%
zeZEz^8HfXjp*bXDX=ack*=ic7MWJCPNJFfviOal$VOr4H=ug9`8|VBpXksm3%Mi6C
z372$U8IeMR;RsBZE4`wHZV&qjuMnEg0XY)67+Cb$KMS>`GdE3pYxN5bD&QO?g#zDy
zxp-u{bro5(7CJ}YXjDpX>hFdFTww`KM&#t--BwV<p{)z)MWw2;c1YZw?GNK{(gxla
z8>kG21PVbFY1d(gOge(jcgO`$N|f1kaPR>lYiNk1H>;1*!C@^BgLvW3^17m*n?~qJ
zX|}jtCb5Ri&BL<Kv&@aj)<X30jdQgv!EExY!fbOj6n-aOBt6q9sDkqC03&g)gbsMb
z1oGCW$>cKw2h6$kHy(F<>Iqg>^Ms9?g>n$NOIYs;=WIj3OY+@ZBDxCzDdEiDwm84w
zl0{f%CAzr*LHiTizMB}AJs=d7xki1#QWTwG8diax+!aKCn~S-z0yxO*189mdmMsk}
z)ak@lUFH}QNvat7!&IOUU$s#wN&;#ZvifCahyQq+TF2Xlhx-%G0+k@+ce#TgqV;*S
zVlvDSdKd{q*o`_XJJU75-SQp;XGV8ApJXjfwKX`=Le9Sjic;Q2v`}r4R{`W(GAshV
z)uumtw)ls>!V29ljHe@h()$i67^Ok()|@JGbpr*?uS9;0Z_#LQ7~7`H{cS+xJMMLB
zfsW#3TH%sIXVC|}UyplLl~ZXAi&NgxLiS0bIwKx;YdnU54}=AnkAiZ5H$Uektl`-6
z?cn1p3o3-sAJMHJrs?~b^i3eE2A89myh+Wx2^VwVg5k`q#P^5%h)i8Sh{E<`i%9l2
z49!tS!RO?+?<brSo3xEbpn`I%Juof}DLKg=b<_^l4PMX15Q{Nw;$sX=)lMc=+t`5y
z`JL8r5>&VO850LU|8r)5&yfDBk@2_$qh*45^=*l-z<+ay;_C>TveVY-j3L|M^u$_(
zK5BLcPJnfr=;rupN7;fn+ta+pJf(Y7xHV*X`o+Y<S}+6R=qb2@h?Gr&8*HPASHzq8
zY88)0uXYqlXM;RPjy8?*a=#~LY)<fCtYXkqzLdmdm2($>G`Qa^E~*kSY=3#MIn>2F
zUMYfqo8+s>6Izj&)=?+@z^G^Vpou4}i2i(YJx?o+e#iK+x8x@s!GC=60dhXNI0RI~
zSUm=Lt2G4WiAC7#j!?(>(0V_6^kQhSGdkdKY+ETdcyKvnZ`|aLP;o0$;)xC7<~ukr
z?m#`2IZq8xG`cW^5BcU!q*%3AFiPks6rls{jdrD5CwHzHJlbnXqImr|w-+WFjx%jd
z<NK1>i1R>z*|a}w7(but;tv%>+St<OaYAlu=kf{exF(KUn1FS|aAdZ}Rq%oZ^seE_
zyXPhj@IJ*%AOX&~SvJBPK+}Joe)J&6qOrv(T>#vU#CY0v&6uZgi3e<8KAAR8+lGF+
z<AsV_k$I{zk-S^s7^u((1R+n73q=?2#-!yvXIg;#ve(=(@*oOOqj*e0h3ZQK^Ba@C
zFyA$jU`zeXJS6Rp!qgT$tj_5cDb+^-R@@Cb_6R?0#CZ6k#MQV=Om>y`X5n2?zaS#L
z4VYAiS6-)o+$U%h)8+SE=l(^Tz<gO+e00USNKs=4C>)Tqm`yf1D?69TO5|q8jjOSm
zj{n-LZrO#YQ=Q0U3(QfL<Z#i{bK34jEPE5lraLAUJ{1QRgl{Nv=sczL%%dyn3opr>
zJCf{>UJvuO>w(aDQ+1gQ@<!QCZ{I091UUEGQmv`RIJNJ|H$aM%Uzfp)PL3U+si$}Q
zvUKgz(OY8op+NnM##On@Eblo=`7@7QRFyS`5^VP<yq+ah!%T}^H8j3pG2hWh>Xb1f
zVjK`vl@z6DC)`3M-+@x*9E~lvk3uW$IHhcuAaL#~m>v>(ck7BouHWoqrrDx;3P`9o
zNwMxk!KIbN%#;OhtlhdvENNHWlfe8$5tdj#!6khrcv-sekNymWWOusOMSy6vn9M?`
zAj!o7tBq$f?pyUaXPX3W$`~}QHCaXpCVAh4h`1pf;{(C?BOe~<<9HT_X9w+oq}^)^
z`z~F+U4W{S+}<)?IwEZiU-@iY0sw{=9O_6x9CP(d4qGixr?5=%fGi`c#}d|G%p8YE
z9{rfJYyXwMn$hZ#&C{T%@6VHFV6bf~53n1q4E^hga?I!(CN{u0v_tBoYPLc|zspBN
zp7p2n-naYWPfyT(bX?mMQA3Or3&C#)os<QDhCnnFOUzL3g^h}Aey^|dI-n+Vg!<ll
z*OF;KQFb=ym<AJR3{Edf2qlR;A`Cc8ye+syDv~H6h#S=da!i;!DNO9a_NQEc&q;(?
zPxHZ5$*wTK$25U{76Wc0e{nnsGQTk3%5^ST)Fm=jc($&_R)GA*MxoAnS}SOc6u1+(
z$7Jy&iDXjna+`2R4bwae77*uv^=qfDf^k%=_)q5=v7C)c&a)0ugxJH6k#wBVpm6pJ
z6Cx(DO0qwTQ=C<lT#7;2AJ<;eX;A6j9dz#Tg*tnj1S`8B5JxtP71?37xnt@CnUln3
z8h0pie$?1L)H(;{ptCgmG>Il`Ogy4u(jU3P;L+kpqIxP)%}B+h96+owq%*(IlRi2-
zwID;)pxq?%uvqcwcii-b35wnhW}hlBBLMM+c8yYk(cDEupf?0_g>jI@kLw46bV9)O
zT|e`89BH_xOQg`%K9}Hwwi^ezNkAhdWV&+-+}~N}c5>O+Wa6((exoTT9qw@=gx2Lx
zE*agujTJ=l_<<$L0&uXBJvS&T<X@Ly#E=G_xG*O@EO87wwmJj9Hd1Dy6-&T;UC7|O
zHXoA8a%jHy7t=Yzp>YMrZbwK>`mgQN()b_k;~E`&pk#P<VPMz?(>F^b8tK#DOX8S;
z87RMHa9jftr&Cp;TjL`#bi9#+TJjARC3Hawya>ifLFBvfbO6+C^^k+^Kr}^}IPFTe
zej2(2CdNcC{*k^NU~8z!Dk~ak!acgbNAJDrGtcTtyw;c(<N;bxH1@EsMLe+rJX6QY
zc)}NrnQYJ7CcYeFsY(&psPsN7OS+?@^gW5!_&A&#Gw{QL5y&P;Oz1<oiO(`Vq%~9%
zec5q{Cp@DXIRML<TO3?<t>J$A;uNJ)&2p^|P7%xH2zAE?Al}`*5GFC={mV$m!VF=%
zvX><&j~*--t)wGGbl+#BaZ;ZD!`3%OXSS@}#!fo6ZQD-A>e#l;w`1G3ZFlUX<8*A>
z#?9X6JKx#&p8L1Psv1wtwZ^J?H0RxPVet<Z4<am(A9{J$QVLBu*A*QAw1|$!cxgpa
zBbmh?2fdK{YS^@3b)8<<4Ih27R1)!aj{CbbbZdQagzHYMU(Ah-x&3R4Se|kl!)-Ok
zDJDYnMf+`3<MAlZ?ego^AH*^$A;;c_CN{~7yK(t_3h7b#u*jn<nsHRvm;|WpmYez_
zGW=aSgO_VXV}of)rL@klVHuk>Bee64;+`idhC)~G-o5znJ>O4pMgoMe=46bsh_2FQ
zgg)r14?qm>0Gs+C<44mUF8#+^Mm%$U@MRYfxSG;M1}M(T_Y|T~N_NAj<<zEu=m^l}
zg+U3HWX+Z|@Gi^p*S+v`7d{tOCmDV@(mKCG(VCn)iw7slnLGK0T0k`y(xFS?z=0YF
zeh{B|>*QGm>%4O@K5>!{gi*^jX&#9<xlBRy&dmBAiF)Ia0=zJqZeO}{HoKq4I|u~4
zy&w1cOJYi!K0kINIv#G0=TaVXa-xUJ@;It>u4U;=P?^AG+oW{3R$JyiftAvLX}+8@
zR65rGEg)s#VE<31mhImW_kUz+**O1)gHT%|=8IeAZ~qITc#t|?mc90iS|%FztMW;g
z@S8Y3sswxDKs^a1<ISaV=jZ_wB%H|Xh4VL!%G-(nQ<O7b9}l;;uf+1V%kIy5t#1CV
zH?v_^Yr|4E$2b(~wmA@TzW$5bkd$uUrq?^iyp|20*YQ{RnwraB{O{YHMj?QH&xg&z
zPyWxR`d?im9<w|}PmM<=j}I~H9W<N37aP7$7fDpEyjwI{SojZjHKw?xw|<7$tUi@X
z-b<kG2$_<%D5aq9o=tYE9Br@Qh||^0EiuOoj|GhtGb{)ZpOn@^Lihs}TFK3zx5Zuo
zuK+ZyBb^o0=V!vf3a{bVqildGYkuKnIB1{>UC;$pi1L~mi;Zh@cRSnrwc^tI61WE`
zaa_iRvo_;!J8EK*mjuk(2EglecYObRKcmXsU5op!see^qor79PL~mM2)?dxvRf&xG
zF?rlMkfpK_v{Y@r4JP&nu|yX&)N9Z8_(GY;yt&JB%Y!zIU^Ng|EGR(FyA@XDH^%N+
z%?Awpdn$*@Ss;1tZ!li>6b>)-+*t+dRoIS??9eOTXU8sHVr;dip?6^K(C!Av(dOz2
zchnmCdg$76(y@b`ptXi*GR(#-%0AaOi}9Yz^kseV(|S?^Ma3RSK$hrZt!RUViz8&S
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

delta 94908
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
IA2^c!Kgt`evH$=8


From 30d59d4facc79e2d540682b03f46a827708f03ee Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 11 Oct 2025 18:29:58 +0200
Subject: [PATCH 1298/1374] Refactor+fix corefud.Delete (#124)

* refactor corefud.Delete

It may be subjective, but I find this easier to understand the code.

* corefud.Delete bugfix: Functor may refere even to nodes outside DEPS

* simplify the corefud.Delete code by using deps instead of raw_deps

Fix node.raw_deps, so that it always sorts and removes duplicates,
so that the output CoNLL-U files are valid.
Add tests.
---
 udapi/block/corefud/delete.py    | 61 ++++++++++++++------------------
 udapi/core/node.py               |  2 +-
 udapi/core/tests/test_enhdeps.py |  2 +-
 udapi/core/tests/test_node.py    | 20 +++++++++++
 4 files changed, 48 insertions(+), 37 deletions(-)

diff --git a/udapi/block/corefud/delete.py b/udapi/block/corefud/delete.py
index 4e68e8dd..5aaf94e7 100644
--- a/udapi/block/corefud/delete.py
+++ b/udapi/block/corefud/delete.py
@@ -25,19 +25,15 @@ def is_root_reachable_by_deps(self, node, parents_to_ignore=None):
             proc_node, path = stack.pop()
             # root is reachable
             if proc_node == node.root:
-                break
+                return True
             # path forms a cycle, the root cannot be reached through this branch
-            if proc_node in path:
-                continue
-            for dep in proc_node.deps:
-                # the root cannot be reached through ignored nodes
-                if dep['parent'] in parents_to_ignore:
-                    continue
-                # process the parent recursively
-                stack.append((dep['parent'], path + [proc_node]))
-        else:
-            return False
-        return True
+            if proc_node not in path:
+                for dep in proc_node.deps:
+                    # the root cannot be reached through ignored nodes
+                    if dep['parent'] not in parents_to_ignore:
+                        # process the parent recursively
+                        stack.append((dep['parent'], path + [proc_node]))
+        return False
 
     def _deps_ignore_nodes(self, node, parents_to_ignore):
         """ Retrieve deps from the node, recursively ignoring specified parents.
@@ -46,18 +42,16 @@ def _deps_ignore_nodes(self, node, parents_to_ignore):
         stack = [(node, [])]
         while stack:
             proc_node, skipped_nodes = stack.pop()
-            # if there is a cycle of skipped nodes, ground the subtree to the root
-            if proc_node in skipped_nodes:
-                newdeps.append({'parent': node.root, 'deprel': 'root'})
-                continue
-            for dep in proc_node.deps:
-                # keep deps with a parent that shouldn't be ignored
-                if not dep['parent'] in parents_to_ignore:
-                    newdeps.append(dep)
-                    continue
-                # process the ignored parent recursively
-                stack.append((dep['parent'], skipped_nodes + [proc_node]))
-        return newdeps
+            if proc_node not in skipped_nodes:
+                for dep in proc_node.deps:
+                    if dep['parent'] in parents_to_ignore:
+                        # process the ignored parent recursively
+                        stack.append((dep['parent'], skipped_nodes + [proc_node]))
+                    else:
+                        # keep deps with a parent that shouldn't be ignored
+                        newdeps.append(dep)
+        # If no newdeps were found (because of a cycle), return the root.
+        return newdeps if newdeps else [{'parent': node.root, 'deprel': 'root'}]
 
     def process_document(self, doc):
         # This block should work both with coreference loaded (deserialized) and not.
@@ -67,17 +61,14 @@ def process_document(self, doc):
             if self.empty:
                 for node in root.descendants:
                     # process only the nodes dependent on empty nodes
-                    if not '.' in node.raw_deps:
-                        continue
-                    # just remove empty parents if the root remains reachable
-                    if self.is_root_reachable_by_deps(node, root.empty_nodes):
-                        node.deps = [dep for dep in node.deps if not dep['parent'] in root.empty_nodes]
-                    # otherwise propagate to non-empty ancestors
-                    else:
-                        newdeps = self._deps_ignore_nodes(node, root.empty_nodes)
-                        newdeps_sorted = sorted(set((dep['parent'].ord, dep['deprel']) for dep in newdeps))
-                        node.raw_deps = '|'.join(f"{p}:{r}" for p, r in newdeps_sorted)
-
+                    if '.' in node.raw_deps:
+                        # just remove empty parents if the root remains reachable
+                        if self.is_root_reachable_by_deps(node, root.empty_nodes):
+                            node.deps = [dep for dep in node.deps if not dep['parent'] in root.empty_nodes]
+                        # otherwise propagate to non-empty ancestors
+                        else:
+                            node.deps = self._deps_ignore_nodes(node, root.empty_nodes)
+                    # This needs to be done even if '.' not in node.raw_deps.
                     if '.' in node.misc['Functor'].split(':')[0]:
                         del node.misc['Functor']
                 root.empty_nodes = []
diff --git a/udapi/core/node.py b/udapi/core/node.py
index 3897c3a6..b5b0ea06 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -252,7 +252,7 @@ def raw_deps(self):
         #if self._raw_deps is not None:
         #    return self._raw_deps
         if self._deps:
-            self._raw_deps = '|'.join(f"{dep['parent']._ord}:{dep['deprel']}" for dep in self._deps)
+            self._raw_deps = '|'.join(f"{p}:{r}" for p, r in sorted(set((d['parent'].ord, d['deprel']) for d in self._deps)))
         return self._raw_deps
 
     @raw_deps.setter
diff --git a/udapi/core/tests/test_enhdeps.py b/udapi/core/tests/test_enhdeps.py
index 3f473bf3..53a74389 100644
--- a/udapi/core/tests/test_enhdeps.py
+++ b/udapi/core/tests/test_enhdeps.py
@@ -57,7 +57,7 @@ def test_create_deps2empty(self):
         e.deps.append({'parent': h, 'deprel':'dep:e2h'})
         d.deps.append({'parent': e, 'deprel': 'dep:d2e'})
         self.assertEqual("2:dep:e2h", e.raw_deps, )
-        self.assertEqual("5:conj|3.1:dep:d2e", d.raw_deps)
+        self.assertEqual("3.1:dep:d2e|5:conj", d.raw_deps)
         self.assertEqual(self.tree.descendants_and_empty, self.nodes[:3] + [e] + self.nodes[3:])
 
 
diff --git a/udapi/core/tests/test_node.py b/udapi/core/tests/test_node.py
index 83348c67..f2b64a3d 100755
--- a/udapi/core/tests/test_node.py
+++ b/udapi/core/tests/test_node.py
@@ -245,5 +245,25 @@ def test_empty_nodes(self):
         self.assertEqual(root.descendants_and_empty, [e1, e2, e3, e4, e6, e7])
         self.assertEqual([n.ord for n in root.descendants_and_empty], [0.1, 0.2, 0.3, 0.4, 0.5, 0.6])
 
+    def test_enh_deps_and_reordering(self):
+        """Test reordering of node ord in enhanced deps when reorderin/removing nodes."""
+        root = Root()
+        for i in range(3):
+            root.create_child(form=f'node{i+1}')
+
+        n1, n2, n3 = root.descendants()
+        n1.raw_deps = '2:nsubj|3:obj'
+        self.assertEqual(n1.raw_deps, '2:nsubj|3:obj')
+        self.assertEqual(n1.deps, [{'parent': n2, 'deprel': 'nsubj'}, {'parent': n3, 'deprel': 'obj'}])
+        n2.shift_after_node(n3)
+        self.assertEqual(n1.raw_deps, '2:obj|3:nsubj')
+        # TODO only node.raw_deps are currently guaranteed to return the deps sorted, not node.deps
+        #self.assertEqual(n1.deps, [{'parent': n3, 'deprel': 'obj'}, {'parent': n2, 'deprel': 'nsubj'}])
+        # TODO: after removing a node, all deps should be updated
+        #n2.remove()
+        #self.assertEqual(n1.raw_deps, '2:nsubj')
+        #self.assertEqual(n1.deps, [{'parent': n3, 'deprel': 'obj'}])
+
+
 if __name__ == "__main__":
     unittest.main()

From 2929fb43883eb7173fc50d38865b240597179a70 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 11 Oct 2025 18:51:14 +0200
Subject: [PATCH 1299/1374] implement mwt.feats

fix #132
---
 udapi/block/read/conllu.py  |  2 +-
 udapi/block/write/conllu.py |  4 +++-
 udapi/core/mwt.py           | 25 ++++++++++++++++++++++---
 udapi/core/root.py          |  7 ++++---
 4 files changed, 30 insertions(+), 8 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index b485c17d..9151a216 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -223,6 +223,6 @@ def read_tree_from_lines(self, lines):
                 logging.warning(f"Wrong MWT range in\n{fields[0]}\n\n{lines}")
                 raise
             words = nodes[int(range_start):int(range_end) + 1]
-            root.create_multiword_token(words, form=fields[1], misc=fields[-1])
+            root.create_multiword_token(words, form=fields[1], feats=fields[5], misc=fields[9])
 
         return root
diff --git a/udapi/block/write/conllu.py b/udapi/block/write/conllu.py
index 2573b5ae..ad647477 100644
--- a/udapi/block/write/conllu.py
+++ b/udapi/block/write/conllu.py
@@ -117,7 +117,9 @@ def process_tree(self, tree):  # pylint: disable=too-many-branches
             if mwt and node._ord > last_mwt_id:
                 print('\t'.join((mwt.ord_range,
                                  '_' if mwt.form is None else mwt.form,
-                                 '_\t_\t_\t_\t_\t_\t_',
+                                 '_\t_\t_',
+                                 '_' if mwt._feats is None else str(mwt.feats),
+                                 '_\t_\t_',
                                  '_' if mwt._misc is None else str(mwt.misc))))
                 last_mwt_id = mwt.words[-1]._ord
 
diff --git a/udapi/core/mwt.py b/udapi/core/mwt.py
index 3cc95cac..087b30a3 100644
--- a/udapi/core/mwt.py
+++ b/udapi/core/mwt.py
@@ -1,19 +1,38 @@
 """MWT class represents a multi-word token."""
 from udapi.core.dualdict import DualDict
-
+from udapi.core.feats import Feats
 
 class MWT(object):
     """Class for representing multi-word tokens in UD trees."""
-    __slots__ = ['words', 'form', '_misc', 'root']
+    __slots__ = ['words', 'form', '_feats', '_misc', 'root']
 
-    def __init__(self, words=None, form=None, misc=None, root=None):
+    def __init__(self, words=None, form=None, feats=None, misc=None, root=None):
         self.words = words if words is not None else []
         self.form = form
+        self._feats = Feats(feats) if feats and feats != '_' else None
         self._misc = DualDict(misc) if misc and misc != '_' else None
         self.root = root
         for word in self.words:
             word._mwt = self  # pylint: disable=W0212
 
+    @property
+    def feats(self):
+        """Property `feats` in MWT should be used only for `Typo=Yes`.
+
+        See https://universaldependencies.org/changes.html#typos-in-multiword-tokens
+        However, Udapi does not enforce this restriction and mwt.feats works exactly the same as node.feats.
+        """
+        if self._feats is None:
+            self._feats = Feats()
+        return self._feats
+
+    @feats.setter
+    def feats(self, value):
+        if self._feats is None:
+            self._feats = Feats(value)
+        else:
+            self._feats.set_mapping(value)
+
     @property
     def misc(self):
         """Property for MISC attributes stored as a `DualDict` object.
diff --git a/udapi/core/root.py b/udapi/core/root.py
index d5e0f4a8..15f31e58 100644
--- a/udapi/core/root.py
+++ b/udapi/core/root.py
@@ -167,14 +167,15 @@ def create_empty_child(self, **kwargs):
         return new_node
 
     # TODO document whether misc is a string or dict or it can be both
-    def create_multiword_token(self, words=None, form=None, misc=None):
+    def create_multiword_token(self, words=None, form=None, feats=None, misc=None):
         """Create and return a new multi-word token (MWT) in this tree.
 
         The new MWT can be optionally initialized using the following args.
         Args:
         words: a list of nodes which are part of the new MWT
         form: string representing the surface form of the new MWT
-        misc: misc attribute of the new MWT
+        misc: FEATS attribute of the new MWT (only `Typo=Yes` allowed there in UD guidelines)
+        misc: MISC attribute of the new MWT
         """
         # Nested or overlapping MWTs are not allowed in CoNLL-U,
         # so first remove all previous MWTs containing any of words.
@@ -182,7 +183,7 @@ def create_multiword_token(self, words=None, form=None, misc=None):
             if w.multiword_token:
                 w.multiword_token.remove()
         # Now, create the new MWT.
-        mwt = MWT(words, form, misc, root=self)
+        mwt = MWT(words, form, feats, misc, root=self)
         self._mwts.append(mwt)
         if words[-1].misc["SpaceAfter"] == "No":
             mwt.misc["SpaceAfter"] = "No"

From e613cd920eab5065850db42acdf10f46f8202479 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 11 Oct 2025 19:53:30 +0200
Subject: [PATCH 1300/1374] Update: FEATS and multiword tokens.

---
 tutorial/udapi-tutorial-dz.odt | Bin 259240 -> 259171 bytes
 tutorial/udapi-tutorial-dz.pdf | Bin 400743 -> 399438 bytes
 2 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/tutorial/udapi-tutorial-dz.odt b/tutorial/udapi-tutorial-dz.odt
index 02889aed444fc65ac003bacf0cad4f4a921d86c7..d27ff8c4c5d7875cd5f5a43c539907b47cd5774b 100644
GIT binary patch
delta 37875
zcmZ6xbC4L%7w(-!*0wim+s<Z{HM6#DYqGX&+qP|6S=;tazQ20kx^?G|o=^9AdS<Go
zr|LPUr}!9g_XrVAP7(|p?aLRaFJBTOW8fq~6C&gAK#5~K(Ed_P4C}vki1Xhl2*|(A
zzhImi$iHZu4G7P_a13$WBnZks8X}GZ2gUfGiv91YP6?C`1W1UK)cEp$9WZ~{!O_jq
z$bsI~%JN)OqiU@g+557J5zTVTk#^<q<iOAeV%d6?6qof_=(RSRY}Gi56b8-7@^Hz;
zHI7mu-icm(`oYj=gY6J^(w372Pdk1|fbhoBIZ92$)DE}bM4quv<cFeyrHvop`Ai11
zBY1n?1}!<(5kYGgu$DMzURCc5!Ktw5(w8O>Z$hxqD5L$#S4XEDS_q|}QQzrhtgyV3
z2%V*i--O_q99!_D$3oi)uRZrf7CCgdU(4ojEX@~62*AZ5XJtU9I4vi+i;mf;L~h%<
zoO+O?V(x5dNs%n|DHQjku}BnGN*xF60t2ee39<$p{3e*h6z@@0HOS27OU6+w9UMIW
zD5iW}JTM|7Oz{ch>LW91uYnYLEr|uk@EpNNtTp1!@Jex(a_q{m%zmvfIf=v9kCP_r
z!RN`lzf+6VO=~N@WiyToisC$xX7wNQX4QTOw;iW-WrmTJOJpr9DJ3He4P^j;ELe3)
z-Xc5a))ay}MqiO3|6O^2B`I5!VY=qtrqPOdCUEhqDs*j9ViY2ov2e5;`HFG|L2G32
zL!Ns7jHYgCe9f-gfh@MKc{a9}e<L@GI^XiDwOT5I1f&JsVRTHlO0S3SV^yk@xUDg9
z1@>yTu0&ruj5vt3&{)EN6%7zg(s>*H;r;;<e4|6S*%XqxulO#c%VU?xs2~$5A8;W>
zH^EmJdiWdax?^}<&;*2MKiU|3*0~;I;`UF38W9JY@({d)ZSoFj*=D=)_8RNdybV+8
z+8;h2&2Jle4?Y;I$%2#2)9HpoYk#7O^B1!4(#_$FGb+FGukU~wqxS-QMO4NjkP0Z7
z-EUUIAVoc%wfb4|^3w8Bf5<77&&7YiA3H^1#UOuvS;!unAl(4B^|cQ_Fr7AyODIE)
z%|&ImV2V3u)3SWiw2wj`dRDZ&_8|>dcI-3x6z<aBSs3f_!rb6jkSQQD<ek|3xVNdB
zvgyD<$nEk%`heg%x@7`%<}AP0A=I1;E770__PasRi0~2Zv5W{T4gCHccs1{q{K}kX
zt)c;)XB5g&Jb4GvcUS&vm09WHCkj^i2YzC;soo&8<<EXb>d7Pgz*UAkInxgHOdaj)
zTU~Nxd)4{c@*GV%Yj$YTXn3vjoU-UdP4YY6z?~-J5@*VSSEPF2YhPf{+Ba?u^5<{Y
zM@U@pkwj;twyFt~KFpl!@}ivzHAgT<JML(n3=j!-In^K1=M9kfM~c{rXc3^_(jVA|
zRfm@*#*G>K`L^5S&Y9RL%gT{xkcI52xlxJ4K?!qH6^RI1$*2lpLTl}V!oQSkr|N;@
zGAHxJb}I`l2*`m0zBJR!QqWk%NM6F?OZz`#^yN{4txEWm@`~i=9DhM)-C1mQ2b^?(
zETBV3qUlfmYNt}!DIXLyqV9Lth7oYOyQ9<j;}xqNQ}sOxlPt*!o4S#0_3!6B5(sWC
zHkrNE^l5$;$fabtjc<s}rCSh4!s34ejqV3RCyZl{m!Sm(%(R-&ZOC<9z=@RULD>jA
zd=1r72}JC08bMy~o=?W_fp-$qoPj^y7|PBVmpMp|l}TMe6y?K~lEvn<kl%oSO`wGu
z2W~A~XkD746>*Fy1L6rKM2rYVe#*EaItSUg;RZJ|%Iqo#dD9Ne&y`Q6aiw8N8)=cY
zD|?0TLXd+4dA@$(0U8{l<+grSYa(ZosAS_xX;9if4!Vd9Ep7VAC0pr7Z6kjYokH(U
zdbu#1njijn`GC`l&aO2lg(qfKy0(>7;|4|Di)?1^e$iD$tO;=aktqj>yvQ7@w>Gwb
zJcZ*3)`g-MGtxYvJ4}3#NzG~KcnKARK_OTYFW8g}T=s9rj?+?ruYo#IK_O=mCqiuU
znx(^#!xk#~d*Hske|Qg2Hq=Ho@tB%M#`o#{f{9VH?8Y>G@<M*^EIgi(hsDcB8`3F?
zb&td%6{%LIGS9gUC=XbDVB6QkBmSO(#<2R9^qtoC49CbiV`kj1JRU}kD#tP^a-jt7
zc*MybKs8g?XxegVQ@d}UVC?8$-dejSwb<Kza1C5*>SMf9cGC$Zz#BNWEL$-9jkxur
zseMzB73!05)t>=kHt;S)jsONxb#@F6zv4^k%3hIwQ3etLn)7BfPgg3AeQolJUhRfm
z4egJwOe+$XIm2$_S7NcU<gMvQ=lFzLQui}9z+vt|yjkk@CUJ|Rx9AdxB-34Ye8ugJ
zqC#Ukq@oJ5{iUiC)ojyvg!G>5Zl=3Z12jVMf}Vp63Xo~<^?gN35i%KwkCLJhuOMP|
z<O?2=c|d5q3o>zJB7Vhnsxh$-`b^<mLQfxdy1ru0MXq~dLfuCTjtk{g9GguYJ089Q
zIw+eBOlkooWKK2_+5wrR`t$pfhC;QIDI`e~hw^4Px8x>x8AKPb=(i}l@PTFnTJLHD
z+ROo_M9i%*rkyZIo<KvldIQ(ytP89$yCKyN-62)}FoUBX_dJ}UXadVjq+@ybeSPoX
zL)}v2@U)XV0$p;{ge6a&;C0yFOthAP#}ZaTWr({A%yo!7;)>u_omT!fQ$8WWJN@g2
zUV8{a8_)e(W+u8tVO95VZ3n5eCd}7Q)mK1YwLL;G-2j`NxDOsOA|idI+9a9vx&D~T
z`9XFxSmv1b%KKo?Y=wm{>zM2?rjB__!!Pr0GGt|U6EB(H^98q+Ai!lCYpWQz)27Q<
zFXy!dRrkL9j^l4axybzx?N{eQ43DOYfqVjeC0C3+KOV?h^zcBn+?{K!O(=YI$bF*a
zGZ3?hQ{SYfgBWz-q%0VAP%bA?tY<Sezu#o)A3-qj^Tg*&oSNXK<a9{TU%95E@^;e>
zAHj;(g}%iS{S{LQ%oASPUM3T$7Fbd%ER^gBED1D`>M=$zo{hh+jeNfwl;(`f+JCAI
zDDtxo#Y)nb^Hz(f7%Ir{#dd?A^mb&mdiluByt*?s>{TRGgUu#hkuS6vJO6s&-Nv1K
z5ApH2tmZLa;pz^KziPmyWecSqGFN?EUVDkH@gYa6TW>6FmHYF+OBxEGLcj}4<O4-*
zi`rCQ=iio3Z~b<xsO5as%_ectD8)->&9J1mFE`e9e>Eap@JOa)vzi|<F<2tt(M2Wk
z=gU5VWZ$oWMZDQ!L&!pe0dcotn8dX|Mb1@3riCpj-q6Y$tpvJpjtLk);7P(@EVWs3
z*rMe{8v|U~c;_p?X1vCLLHG&gR>&k(!UYfkCD+6f2q&=8DN@vkhAUi)Ykk@wRmrZJ
zM2128aHk87#pkdZJOiz#2&exdN!|upomgW`iwRq*D*s8&ITr8#NjCmUZuM!KC?iBm
zXOBKdG__)_`h4v*L*S<ZEiJsF=a7DQi8klNhiw5u7-9D_6)(fv1V#<6!&SKO2I!4L
z<u`gY6M4=iJNq?9Q=Xp`gFIS7n)&=+N2+}bJ@jIf{fL-0=gjZTg4?w^Tg;lWg%)Qr
z>XnDD0xfW;P{;*1Fv*~c3k0H;1=H+w8psq0shq!<r>QvEUXG;dLDK5sD}^p=)mhXb
zR^|f5zjCJ%LrAU(wnRU$cTsmRqR^IhdFT+x^piH`SUN?=Ox;pzs*Z1NAf$CQTf<FT
z`V~nt+rpQ+*+q5&#*%+CMB@Hp(tg0kv<n}?av4$}AlZbMCM7VkQb=uz3Jb&1Dq~%8
zxw1BR-A@T`e(+<lyMne8i=9UDEK(%o=Q{zk!a7-aoOE*e50Of=3d!fTyG}#nCYaEw
zhH@ldrP~ixrAZ}KsUo9W+fI_)@Zf&q@sWxU!Z7UAQHI{{N025LC4{Bb(b&Aq5`W{l
ziDoA5q+W7MXP%7y03Yo9cEh{jkSYRt#>QMRoo};r7u*!i8e~uv`}2*(fBM;j>8B=;
zSIQ>l=!~w_h_lS8Tor{O(}jP$8{fF$XJ3S=dN{CkKh33AFF3nH;^+l+@on4}_uy!n
znmS%-JMX-`VxWjQbk<wARE@^+LbTyf*hJoQ17Y6tJGjsnff!exkUZBfe(XDG=|sVg
zGGGP7GV{L0iQ)^B*_lk8>(<k+79*YjE%msm%MHG7tU!~rE)IS+IoDFI?r3C;)?*~Z
z#+n%$!@ME<%*ocTLV@C#^~A)Ey~5AhL^)-h2~29`JU&*pP)mHiva)IE40ycHsg4pA
zRC^`1UDNR@+<-rkCl_Q5d?CsQEL#hWA!?B=JW;LPG}6x|J^}*=x*9NY3n_#0+i(<`
z=FYgJY;ln1HW)FLIdtt*Ws)YNcs8p@%647!?jpw%ZN_PjXA7z8HD{hrHumnfgmRLQ
zP?}{Jx!!PJzCcTS`SQOs2?`48Z<-V*jYI*EckV5!S{eHx!IDNFnIfgdSY(OAm*8_<
z7`l3-Yf#{~ely45`h3g^W7yd2NKgHPZCMn)89+Ly_eCA6#IXbR@-Zt{+Et}vEwzY(
z?6)|{B*ip6x6iIm(@CWCEIqHr1l*<45UYUTP`Ym6*ACU?RAYl2F8y(OUhXAke~3On
zxPNdlSU)}Y*ds>=rvT7->b%_L$5vBFB*R(wny}N`V6qk-j|PQ<^>U090<FHRm-&gW
zr@I6;uRMC7EZO-E{+zmgeWWJ%$q#pMtpb}FxKP_Fv}4XwsG`m_koHsc&*bt6$r4QJ
zAByzm&D^wML%c4}lVO#BQ2kJnbkTfZ8Fe%^cAJ<SJ2R7Os=<Kft46t+u&wZLW;|^k
zZGoL&Z2Nln;@7lN-@A?@?pPC^gVN6PkpqWoFZ$~!&vO(&7)(pV^d>MXAf!^z51-;a
z7XhO)(jw3lV{W;NkRX1msMF)EW`yvTRh22Kg01U2r$4IrX!xFO_V@g8Lu!A3mbtfP
zJS%qm^NS5*fdgjM*C3IW4pbUF|8Qqz{K=-C1kP@m7Kl=h5e@XSpyI6w<aB?tld*`?
zbe+~oD&%mxAw+oL-t>mGfDcL;v7P=?Nm~}k2|cV2y4A{`FF5t>jqQB&FjPmh_k*Kk
zshCF0K?5@y{$OpUW<N#;^4@dUPohQzm+ZI8I*j7hbyksnX*fE8Ojih`oiO}cIvB+H
zh9sb0zLbLhKTD?wg%%JON@bMhhJ}V!LBaYqp}93)`9&wZ!@xu6>5;+>GnFJ-;k(x;
zxHFk#BEMJcL{b$4>isr$d7P+Dd?Y_XBLDA5Y2y2%+`DNTy!3=l?T`BbxFF_0bNwAl
z&{aatD*{40!Yilq(&r`2g7K45WSQ1d3{=}+geuZ7?jP#+_jABPcKK6(a@g$hYrQ)C
z9PBeHVFZ3c6e6PR==0}okxu-)Y}jGZ-0{$H(bd_^^RpY5ClA2N?oKI|Mo$ZH>!{WY
zt5kAPX-&Q}a(v!MUQ2u&es@ofw&6!3jH?YpQCIOwWYlu4s6XlW?7GFzilPnf6qmfU
zd7~Y$iJ!@v-3Lb0_7(S^B%dqNCybhOk5pg;)}=4<q~2WbOQ)s~T{Q3LhG$&wYollm
zgDBR-FC!-EVW9&N=7)Ynb<>$)VdZ^4nk{Jh`#t5ASS(86ucv@7iW9=@vts~^$j3hO
z(Cy!E7S+n~XxsgeZA{Wy+EZxh7Tjn?R?wz-EcaKJc>wNL&(?kN*!6~Id+m~RE4rl-
zAK&*PNu;s3Z9zvDt5P}Qi^j9m>rE+Tm?}Jce3iz#dqe|rulNQ$Cj*0bneKTMmbm9u
z`4wRX3KybxQ<Y;jgUpA-4V(8_q#6$AiPff!$-+|~-({iM>L-xC*)EWLt?dH6X#8WW
z^Pqf02B0&d!Mzyn$Joz)76_x3KLovmz97n>fivFbXLBEtA{(ag^(%-7?&|qkZ$UlT
z2S4*}%~gM8<>o+oBvCPxK(Lb*8~xc5-VR07!Ay73!DO?%2m6`IUZnO6nNnao*VWg=
zz3A#_-?wZewHB1eqslVV^=N}yPFb|CGuE65_YDyL)`Fr9=kJ%{zrbQ)r+83%WHV*R
zzNt-2-ajXl3e^?5bp}x_AM5Ck?&V`tloX1kg7%z=>1-uqndOG){{8rS=>^MOGyHYk
zXD}2thSBC8|5_K(QT?TEM|c2C_a*@X6F#SuS`8muFz4X;!QGOA==_8s@g2@hn;<tD
z_7(t^MK{NT0=O&0sV}dP=Ms~N;dHFslAmKyK(9X705yLifA+AKr<7|x^P5M$LMV&L
zz-){-p0QkK^6^mS1`GCrV>B^0{3(vu;;9RtRhp>&sS%p?ZZn$D!trrA?#7jlylWdZ
z8+GYF=@0WOt;dS*8t$FxM;3;{`4%w>kOz!^FD}!6_z~a-mgtU}qokEz38uPKk4eJG
zw;x=W&|O13%h=Tz$zs3u=!v$l=wyTkDL<8y5Zi?qr&QBz8Em?ao~71YtG`O{cDmZ?
zm)55j4Myy!D-Rpn#^u_nnC&cw@uX&Ra0P1)$N8hR`-ptj2uEAt#=p~HBG@?m{1X5n
zCVXf&d}wstKmk)Vq(KD!m{2Y;9C6Yq!3y{Okh@sVtASof<tc$KyA?FDT9m`<pbT`@
zAcGAZ&CbbiGyke_1$RQIUlysT(H%gq`voZ}yuArQ5tB`UzNVoQ-V7i8n`xk>xw#A~
zNx?X4{?(ST940qJ;7jXo-r5sPOHaUMQit*=?fb`RHd^0$`}F;2w)EY3p5?UC@k}V|
zzMa0^AGvS>q@1oE+~TJR?Hud+xRI%ZCbmTWau2w&E)EW2cmtC0^;|V$IaKFXi$YeB
zJ><*Q-<o2?=WJYXjCk+h^+Z}RGUgKBb_byHf-7OsO+w2cNAEXB!6$OPkEQ@q5groR
zBC-}9d5Zl@s6M;1R8?Gj$ZQv;3l-#xJlQOotf?t}D~1M(@f%;iz1_IE(MCvCI+9p=
z1>`)nWkIbGR{JmnSAH^}{;62x2g(x$tm6sh`URHvZ?>N;-aU=Z2LfM-I>8LvnS%HP
z)U>u>a3Z2^&i3WV-kJk#Wyt`daL>)WwYKyh0)F>w^)R%A0>!um)%Ss?;wL6bMbID*
zHgLofZ}UNVO4}wd>m4n=Im2j>#`39!(T;{v=Zs=<3&L-#wd8X?KVqtikBw8!f)J9+
z9^re}xTV%y6Y8t!PqZzKPPP{6ybQmx>4A@yL&RO0BSqpwgZ=hkfOY}yarE+iF_ry7
z9lKDSNmGJhM-Kf4I=^n;g6+ML|L}e|G5r`|pPsP%^4m=k=^z)6jwqrRQyB5_C?u6~
z`!%qxWblB>YXSRVFmZ4stTQu*+7L{(97ZiZ?Y5NiZHNgyCUQ0F!S*L|FHcvw!K6e+
z%DC34uz}<dOAlNJy;eMsqU+CC3ROHr^y!=!DF};*xPbvSxIt{B{ap_Jh(F9W6S_r+
z@Ox3IVrwlnLK0(UO8kalraSWIL+_flR1bYbZexjq;W@5E$|;9fvxiw3MSKKCpf1yE
z754;R=H0Y4Z3G$eSK4rY>4Wb>cFMJ$qsb&xi1X{8w9t;%je4d4v-+;7e^oW_yvV4>
zY<T!xTXk$Sx29KT)jhXnk-)O|pseN{N4)J0G%IkK)=fzDjX26}o`62|mCy(gut&%D
zq3;}UPB7Jt?Dwak^_$=+X){jELSb_%ze!AY3bZpY>gAwm;mFAv$R~gMR=UDu&aN-s
z5)B(8+KnjQ@i7XlBvRt-ZOO%V?3Up(tWEpJo1-PYap(H8;ZZOPdLF4^?0zLD0~f{j
z=f%Puh{G40s0t+JQIA3VGlD@67Jb(me;8}qiKw)`OkASs*|fEz4qzSyX?6=jI6V9B
zq>rp4G4N<T(J3T8+v`lDz&x~dK26~6Z9}*|Psm=5o_c?acYXfPU+%ULID-Byyf1S8
ze<tC7W%#;%97x@N<?{=7W($OW<#WRsDEhg$FJI>3k{GK%@RByJ!7!5ysz6Zc91h0f
z{z{v^yMyfftIs!)R)P3%{ez+-kguNqpwbZZN$MXI*MJ5B|A3JROhxb?gxG^!g8YRf
zcSkTHVDG0r{S%M{y7SW@pDJbiHGr;B#_89+qgh$$SnF~s_Wf~%2<T7p!szb^ziDHg
zNb9_V8?<<gXA#d4-<Ov-ZDwU_y+gi4W1`p^f=VenNTnVdg9bw(A|iHqe;|IkvOI>%
z%3!tl0Cw}%jgfFeO`vP{RrHbG?Qai`j(1Tyz^Bb8l2lRUe)^hELpqPQr}<ZJxKE4j
zHE+ksE^RzIp-)~$5)SUii5Aq1p+&c9ThI4Jw})c~9LaYwDEdfayLL_io<7W{5Mw0m
z3@7!9P3+G$Z+9Ft{A2PPnIaG==T1fgmz@eY_uZC{A;aa<)6)Z|q(IB4p<R}jUjpVD
zz=%Vb(b0@zqtk&a0s=-xL)tmZ``LQPMDA^$Nu6Tojz$$D_VM=FT8#rLrWbbBL?<r&
zj)!wLfWaO1EgaR||G;S`=1NVs@J!cvxgo4;vq9zO-Ek?S55Lw%&Hdsy9Bf=Dfp$(E
z7geX^o$Z4az?H?Rx4oZM(^4~It66yo@G&gq;PU7l*qv?;(aqJx1{DoNF^!kRr5BnZ
zP3Bn*K?feCUr*7XwSP`WO&#SJ4(Wzcc?7A1kfuUN5(b0MN=h%bsBz|m38WBoICtIz
z{NiV=y37!1a|)aywMZXuxU>%O={gbX$nLjH&>i<A;#n&>b$wYTMcsHw`No+6h!xTQ
zJYrN$H`$!@wzeLu<5^_p_5c%@1v=a^BsOfd<JqoO5`-)QE^@DYc8gRJ5w_Z>8XaA?
zS*wdq%XHGB@y9Q97ap*^d!GI6`Bol>J8zE#I^5njQ@I>iyp|^btU}Cz!mLd*l^iP@
zBRbbA4~QoCVV^nKN{9EhJz-%$o@4W2a39g+X^krMsqRjdWaK6?z0(BUhs9j*^2nkB
z?CL?-WQ4FV8#Y}=dW@?9e=Mx?0}?}ZBn$q-WxX;iZ;Ae=05`~BS~p@OT=eYAOv~wp
zHs1TDCisks#nd%nRCt2y?ro7uB;qR~s5QZ|%uy9@t*rrUvggSr=fe!3wjI*J@m@UK
zf7Jqt8dkYMxyoK8YkU+NjVcAt&qc?|;aT0i*Q;x7O{Ts*LPxj6?qHh8ub8Yo5M*^}
zvA#y>e9$(%6JZe`h$dyQJ9Xd^>2cV;m|13IZR5xJO=8-OIrDSw)4Cn-K7?!H*Lo*<
zBk-SnU3(_IY8<!RAG!lbinBxzf_u~Ef`JL_y$&9r>#hkd`mOquKYfD?dtqzB2yTep
zxkB+phM4)dOXc9DG9$czyoFKdmYNll<sIw|gpT<oNzwb1XGj?ALa69I$17hT^0DU_
z^g@^-T#JIau&2f3MMd%!X0!UwRWBj!wCoO&sM`m_3&wArT|A%?q!~nmu8ht65n@Fr
zb|t-%&rfNX_9PSCd9?fr1;cMF4gBFegJ#@v7N40QQA$AU!sMxCL!&>XtA^>oS9@Fi
zII9Z((HvqOBHY*}Z^m{W2XXw>EI(^R3dzJ4rZndG)XfmcPbky5_h;_9O}_)<t-H6$
zBirNRaPj7Qeg`ftDWayK23(poRuHzt_7aT{eTD~$R>~|>X~ZV3Riaj-E;(E$A)OZP
z8tpKzB8)U19g@5c=pklxy3)SRqYj8K0m=A{kbcTKj1xV6!8nT!OTyB)h}((pY!q~5
zadllMDLnZ@&0MD2Kr3a?P~XLinGQMxXVeZj-eUFC2p}?REsMu<Si5Z!%Ao70i&rf+
zBKO;&{K0X0)t&=wFP)dDc0}zpo@saMY4O_3HC|)MI$@>lvF3Qq*c8?f!ZfQ;F+A3H
zC26*YCbh#|l=1cC?$qP(7)~@U(J*ttEabH{-N#N;`SIg@W@_C|h9hc`e#x$lJK<jY
z)`-z64L}{?Et^9;RcfDaCH!%1u2R%`uxX%y@B`3?e|<zP6F91;6RYj#jvu3gOk5&P
zKFm3e-hU7iP>jkhm2q3EebFo1u(MaT;W5zI!8?jq&{I~<Cb(TUz0X;4c|DS#kIX`*
zt&9(>>l!#W0Gw4E9%=<Pj_1$dFSiKq!*%W2fK$<XrY*;HbSm$RjfCWPTI&-j$n*Ar
z85Z9GzHk#M{;89@FuHgGt~l$>`~E2?Wx0$Ox%vAle`Vwz@~h3uBhO2vqDr(v*f4)$
z{XEgu`O;XlB)XpqA!c6fFia{?iHBde2juZmz58!tz_qEB)VY24UDP)s6C4=tSY9<h
zfD7{o-3Y6)xv7wd6O)IQ!64|Yi#42?_>pk647S+{l5Z*H<y+=ybLk6ZCJ!T+3oU`>
z`(c8>YS-F%he>C#j2eymFXzCx7`D-z5O?w<jgvO1HpHV$YKc`rU>*DJf}+CvAo}O)
zm3xJeY{mLhy!$~k<)abj39Hd5vd@AUFd))WVWE+s9T~U%rKO^&t<no>y|6?Fw(0&v
zX}ay*Y-(h?OwVLJL*k9RgF)zB`Lxn(2~l8H!(Zi&<$k(6@~2I0t&dSES8A-gXti%&
z6bR<(z0U^DyixIkvr5^5fdflu#+4(8dc8Y!j&bWCeC*9`sV;KdVn{3@zKNYXa6VY4
zm=(G%b-CIu4Wn88FnwPoQ-kv5&?BKlY8mx3g1n=W^gUa}WK};$Qn}qX$YsabBd(E+
zs=m@sVeG{5HdV-Be$4K+)C9a`VSy^qNQKcXqA(VHzT^O%3%Eg7DmqB`*@Ye17AGIc
z<HgFZ(MamOST#q*&HB1XNfBoam^QrNi^F{Xywb`PVGWNlb2*cj#u4pONIJ~C$s5X0
zUK{6{eZiht=(8xTrv01W$b{OGPB(6q(flgcDe0;cjjS(>qf&UN=B(uwsr^C+ep^0|
z*g`>Ht+5f3pqP`N#YIVvHD96tQ%tJbQ|UA#GK=}ZG!<0Rc?7RcXF{6-9B#kvg;G9r
zWFAYMw3a{wRoP(VVq*y@SJ9{9|L!c|!*_vw@HSbmbFg=N+3<GZ*320%r7#Fv*M2k_
z{_28nmg-XZi*f2CzL`5}Fp;nF%9OV~N;b?l<H>uApuMLrDBolEx;`WBOHNiv1brV&
z98a4L<p_1T!wT4lltpS1@RXfZ5@m?KxNzoUxY)cj2`zDCazdi!)OxpDC|U4@C*Ww7
z@L{4|0{mUd%hBzreva6YNn<01tul^2fjr?NioPRf;bc)fNnzB9XiF?aH-5vKs{)Tt
zU7&6O`k{^Lt%$4y3s1R}N&o_M9%r6?&Cgq=T!xRNTd!2k?VRrk*r8TpxzyGa?S_Ke
zMS;@^HdeM!z=azv{(=9iU&?&uD-?<9dY?sHfOXFVeANR69$z~<mzhhswM@llKFhJA
zh-pUKY(Zq`Eh}mP-_Zf5!~%;iI-dHxr--O`XNwwotoI+DwdOpzO}6Pl+5?Xzmg%k;
z-X{vSg!$_;8*#}^AoL>9ll9qY%!K8_TnD8OpHG(*2t&eM+whh#%J{pa`~7BxU*j%Z
z<4L0CS$xSBODvRYeXqAw4$uS%PuDW!ZQP5>i&4BRHQ_;bKA4$Ut@7{kR+N)WnD~q9
z<w0V=CCiog5*TVM9v$8?Pq2GX5CtZ6q`Voe2!43;>dtooXI#<DBZ45T>bo&4lj6H7
zQ&5SnPlE41evXE+BibP#NNBMJX|W*cYVnb%?&S11CK;eer$Oq*I+snJjf+p2yEu#!
z--jDQw^4<kAe+q)TYj#?RcU^*B49AuS$M}kuaO2DSiUZrJHIH;_6FgkZ1zje@kC%0
zide}O6=HG$$GjZo-<~1Ga}2l^=?+~eV`l`IUh^(C8vA!2c<MD?727U%>ZmPrDTKyS
z_cS+8u%YD%Hls9$by`PK7G5ORD!3(2D+G&-4%yhYO-Lm<-&S9K{N(WaaCL7As5SX{
zve;LIiN=Mb5v*|UQ(UL%y?!oD&V})6XxTVai~9!zKtJCRG3?mR&dLiaEm%6PH*Yc*
z5vBWvx%aA5xh-{0<*MP_v{R>5nI!!S<4E_9qq-Z6kLT@aaZ9Nyw2mm(BKz^LjR0*)
zj&xG{wOY}GkH`0HyaLp=rIUlbx+9YZD6KXAa$^ou3w?v$jSi(hCZrag$<`cxjdQ8P
zsyA2i0BacM9fWe1)n-Jge2Gw1?*+#z@piTaBE{eL@{$ttZJS{Aaz33yZ5giE=gtj7
zXkdeItN{}R<CNl|*36lkYb5jpdj#cVo{C1j7fkd7mJp(6_ENU6YC(Tf2sW>e*s7wR
z$MeuAr}_qCcEOp4KfRYWW#8btb1k_d%aUvbkXdpc&x>S>%J7SMhPxxkcO%x3*c)$C
zXv{hyqvE2cv^{7ahx$CcH6KIWH8%-&u7Bp?7}eCN!dfF5*{&sr|AIAdXV?13)1#>0
zRd*#(R}{B&cGJXgrO)RJ$DO^<=dzWkg-Qf&TBgN@P%BRr^83NYQm}jOlLE(`e+T_N
zaG}9wQ}Wuy#J~|B(VA%9SdpW4s=%S-*Ir<)As%tNF^y!tni{#_qVA`j)QTNkZdf6*
z5Q;LMlBZxvG5rxAIW`e&qy@P`0H@wy{+yH+GnTq&-Y`vD;ZotDEG<m2%XIyjiC!3l
z`I#m-*^X|uwVA(hq1&g(@Y`e(Y<wvK*uHlzyLZ{=yK$;~%eiAH<HN5v^z6D-AAnKK
z!5uemqHx0LNJ_h&@>sGv%%H)NFDFdscr7bfHy)R%M~Dg4;<`K8H%2Nep8wHw>FC}x
zPu+Y%mk!u4OT&{Qm(h5Ti?{J*$be5Yn|}*YEpuy^M5iG?zKBxC%6+{-5H_0tAPf>c
zzKwv`hp6tau!ti>OZKPEWQyM~J{B!YHn@l`&-)N2Blm}HZjv44#2B*NDW};?n@5<_
z)i<w)7cLmVJHKvNcWh=}Wb$cf_@}a9NrOYnCvA)x7}(y1ld1wqS}76<D_LH~^qVcw
zz4rP^mWgB5BG=74e7_gedp2ePnCW7t&kl+$5e0;=iVPLSdn+yrvK{q}HJ2ritI8&%
z#q*tK7hJrJkme8lP4@C41urE@&TD%m8GlvGkE5BflI{yz*&QQ>q?9TxXZUCE)GXsJ
zt%4r4xb^JBl=7;m$PaiHEBee*=O1#h;EgLm-j|03Yq$u)ha%3hi!Ok+D-m0b#6HJ`
z?O!(r%GokDQFs|t!(dKye>P^k^#m!MxiT2{6a|^iTfNfMNscK5t!_mTs9T|LWhg)m
z=%ofv$t-}c5&c$#?dg|LTmYxR-&~o1b8p9ckb9<w9O6Puh$xrmMhHYo5b^1pCn24a
zey$oD=IU_v;%VkD5C=$Y@gz<BetTf7Kn~iZWn3VpdES>vgQdj2|3Tws9O0)t&o3iQ
zxo1=@weQjerp+`^1cv^6fA{_SfXj1!sc*gk<;UI@%*inNp>BnD?^xtKt21CJ#BGG5
z8v*kQ+&n@*NuFDh%vxRxW-m-mw~tlgSQ;tcow;)m1-qDAZvgMTwY+HkKK$P1M^4Yt
znVLjg8&&C9?-uk+?_TG;04c?dSyf%uV<$4faJ~C$J$8<-irjL1a+VyI{m_s&gvxNr
zsL0e&h)qEi&SLucmh8?|16{PqfBIZ6!BJ^5<U8Wn=zp6pJ9ytFmisF=8HkU<bF?K~
zzJFVuT*i<VcLsj_BF#2O7D_wsKor6#<0}h+3Ua5B9oiV#NcQ$1@6Ei;ywr@;l}Ol%
z*>JYeg-LzZwq{S*6i7%v{vKQ1wgUbl*PMi*fclu&>Be)A9iRpFXljPfUBk|!fJv6f
zX89;D$4gt&3f9I}Oq1qR_v|RIA8{;zC|&N(Rp!Wf!U#m_b)^472A|<Wcsrq?<Y@bK
z`R<z@-rCq-xncR~iG`WZoM5iscyc?_<`)AM?^u^}E3`1^xT;*lP!h3nmj9-!h^g3d
zV|hE7EpQ&j7|E`IAb`cS?|^v<iO7)OR9{TTc5L-NOwM=P`Lbx9Sl1_QE>h-s{iefS
ztHFwLAp;m@1MQF+90H!=gsPBR8!SXF%^k2vH<htLH~zE^o{Law@M57IR9*7i3-K$p
zbqAiyC6F4a2aAfh)dT*u6*989nKs9XuX0UYMzVBeB&i<ztMQ&P_S1)@M^uLaUVU^n
zBh{DTZHgg)lcdm6Up3)^#7PZd)1CiDRntzTFfc(^R*q%YKs~(srorn{k+9yg4-)g}
z<pSp+R7BBRnjnOuLUt-KoZxp2z<Fe3a-mOXd73OS7M+|P4ZKl75@B#KWhL+C97QGw
zK_@xpNgmXLEstm3Fa7nzd^78W#Wx-d4h&lUUN)4~1esJ`Hs`D^BXDK1y3ynV)@FXL
z02Ia}iG;z{EbKK%UF+Dbl(cgnJ!Rd!Vi`f|u%0pOeh9yHYCIKqB^lZ8i}}`KIWD;h
zO|fEvl0`fjb&{A$pjfWKoXp8?3?cEAXkD01@ibc>{?5&<*yp3hGv7yNtH5eiNN@zM
zLb*%P#$c=wX|PE<l1en!@1S552PqgI;F01I*J$_aAtjKe=<6H?kM~1a`aU&_knP1o
zEQ;SI5Z`^!wEw+7;o8^C#ZsJIRU=qcGZ3@zU_P-Sy}TXG$TX@|NPI)A&7F4(nQ}EU
zpSMtpFZ;5X!@NOc&=+Z@Y1Dx>%VQtJe<pj$Dhv*v2*oDhE`F-x#>1F3`C+04FqH{%
zm>NFx=6noK$2?(NhNbD`S&6a7Q>JqJ>%O}vdJ;^>a%9T%BTyWYv<x&9@(bfiNML+m
z?7olL?Pj1>gvna;lAxH>FGzeP0ymNO(ZOwq=Tg9IFjRTKkjk;{;z2iCw1*mdb(m~o
z{WwaQ6ef)=4T`2^DgtwID@&LM2C@@$Iy(f*_Ji-3iFgfCxb8JFV!|~Lh{u6LiIbhg
z*~KI8KX$i@{7vbZI12m$ash~fNz(i!KJ@5<Xp8m&XQ1rOI;h$G>yjG#uQCC2Ophl{
z0o(aTA-rlo(tD`g1o<CFTbGv@A49n#_t3?QQ#R@79<@p3321Gba19xNw)(@p`<*8B
zE|!ZGzg3$CKU?rK;Q}y*u62&e+~3NUHcR93_S1u<ccd*{g25N6+Z(F-7e;?@9yjPj
zn73x#hdVECQ0gn2k>B_lr(79NHeJ$G910Ps`6|&85Z)7uDP1bRR1`ks&y{B65lBs)
ztmGvsdJt9M`76*44898jl6z_K27DJ5h~vsGh7qTmU|gEJn~Q7g8gnm89!P({dF%#!
zB+s>UaW4CWslS(PPLF=qSQwB;gaEF-pYlPu4rdfQ9#ItEJSCeokS9`_s6g?n%~aZ`
zg{%<VeQj&g@RW))pwgalWJL4nYzp|2aDNV0m7ke$JWRy&NUrk)&@Rvf@YrKX%g==4
z_1eK=9}yzr_12ICJ<$I0su%b{K*_3Sf+;r>3bk^Y78MhXP8H9CG>a2OKte=w^Yh{x
z$>rg&UqTFefZ3QsK1;gs4oXxINm&I1eP7HY;kn=buuvuIru4Tn1)uh^bM-N7PAHE8
z6t;88Ep9G_i%jZ!K+^Qv+A)!uWdnvX!4O|#**T*e;PUMT6L3YG;7@ZT&#1hI;?lCr
zszBP4`Ey|Bp}Uw8w;Th8jk&(EUZ7ORpifiq$KJk9q)aVxS$VnFn2lM{sDMPo<(P<C
zh}#}%KO<4=a%azUTx1U8t8c!B%ZH5^!c+TPt%bIx(Q$eZ&{4!@<V(<tppq!;zRaTu
z-JE9#%A+f>PQv~WowkPTtBT2Y=Rpa18ZQ>qnWXW^+%W6XW^2CFDUfj!JlqSPaH~$G
ztDlpfAXSvAFw!9>;Y@L!6JJKs4?=I=wx}(;M1{ETQMK8DiKCL)xzNOumkBOYO5&e0
zVX4$0{==LM7{IsVA%lj#HhVnm+H9118=`(++Mm&X^izwLjCcN9g&~{9_@!ux8NRAj
zdPl%CKmaAQjjVX)6OH?~Baz3sD9m(?ugo<-P#miCy{2*_$#K3UU4MZ!aG7wR{CXH$
z(mhF8rUnvp+Or?cBl{sCDp?<~pfatm@_4wl@3IqE7E)Ov^rhUNX}5?STMNF)HW7^^
z(yr6w=MBYg74>#SD`Sr{mF&G5jlFpD;@elP&38AaZzL7G7xT-cg*JbDFKeXV$s9nS
zvzV=PtGS=2w^S=%xr{u~J`-$qbJ+<3v+iC%?)_t<c9m@uMdq}GPekc;;M|HC=|!km
z21NyU<EC-)Y0To6)v?fegb<aDl&y@-Qy=>gr+mkzbT+%0(57tgBQ)(&b+PpbZ_P#8
z>XcuAmAtlkuPN(1^0z(rXs;bK_BfkwUv_`{<~#0XECY><K<uD{u&d2RL}7c_NI*!m
z-+YO_RC9oQBX_DA@a-<82C)>&9{0KH&Yc?Ig6L|#p34@<l;B=)-dlcgdMuH%K(Trt
zcrb_b{CwYGNcwAYdL9{=9)-Xns{<eUark>-AE$ql+(5ZiV_paipq)4F)?3Jcps_PA
zZ|M*HO{Ez6Ojg`#dNV=qOBDuwIu3Wry21K+A)6nCud<2#^yfn)P^Rmmq3SaFYxV&*
zilB%zFeOCw4f!?>EW|dRk|W&bcMp~6g0G+j>H>J17&7XM8$Wg=w|f1K{<PFhsvVLO
z6qe9h!rK?)auM)kTyJ<Kdc)$n$??fb*ci$TKG^7yAaconw<V@PwRl;>sL+8x+F2&J
zBkwv#RpXx7)y6au!R>_fa4wRNaZ3X-e?(rmM~Uev>{q)i6n3?X$>o#>Q|Q}}IkO!P
z%l2<doSB=$o{~LasI4~zZnW_U1U11gpwaR_u}i(4XJ)%B`PuaOIbE&yR<j8QlwH=b
zV!>-PLZKeWz0#H>%ol9(sZxyVjp3=voTsZs+<fl8vNwgccU(xTY^s&c_KpKZ9U~Xg
zW@CFkkH%ri&pQtXJ}1<dq>Y9b9+kH1W9bNm9B<V|5mF(_a~m!cg>()lcj~As>C~gr
zG`3HW8<AQrP3M*EkJCBBqtf<XcD1#vP$!+Yis&_D4qJjQ8#WX1o)<TP><J@E&+Cur
z(G5vlBNuOU0pOAFpA<N?k-R__4~2RZ-+Dq5UP|)fP#Mz062G(>Mv8J>IU7sgoT>3@
zCE)Zja+k;$oquVovdou{w>?&sUzt&|88q+wdrjDZTZs_m-+)_k=}4Qxb0eL0eyZic
zVF)^^9;mj;=DMM5<}FJ9stkOO{{Do_?11{riGJ2+m|=~U2PcyS@ORgiPKKIvRLGaW
zsq8fEW<a4FWjTaT;cPnFx^2P9`dQ!Y%qNtDkZGXwSfNfVRPDWyi<>l*4{dSSj}ij$
z7a^DJ%enIg^%la*`C(ex!orKsC7MKVsr#>+&F`<ENbD1qW8Ll;8h*rWxbox`&L&w-
znLLV?Q_bi+^0_wyz{RTmNUerJijcyxK2_Z+7&Y(s_9{c$RW*$z{jW=m#SS%e6MW}@
z^V)~+XBkr8EST9YnQ#y@mKVT%Xt+TFa3+2o{YZR-Ei1d)t}cHnO=(Q!Pe-I{BwS-x
znkP8#Y0}&J2rO;NNlhOL+6?UAF(}&%3>_~9oz}37U9XT+0ittR;W?Tw{%$7Jp=DX<
z1<L$T@jga;6OKm`>8LH443PX}%?#+dF^4etn$rgYyq{aR%JQf_F=Smijory$3WCQY
zV&Dq+M?!{nVRL1sb+W_$cx0It>N4$#&#)b<x?`su$)`GnJg~;v5tq>9OFZoD|1lIA
zrLowqSN^s%0>tPA9o)AxrMGn+Yar|@&27<Qk+bG;-WE;QuzWhBb4O-9KSCF=kqV^U
zwv<Fwz7XTxC@w*Q3fmg{g#WGIoQSy~c)GMY@32%&fZ=u$3>4a=<#a2h2I3a|VX7V&
z9OS<q=zP}iyS%}A($~`DJwF}nwB~GjXsME2tFN+J1#ETkyV?1mSM1xuOZQq1Ma|ok
zonM?@DPMmddfM|gl*JVsa@F(*>}=^Bk$fzjH3C9WUPtx(?OhqNpbWDQK3(ZqvtmWX
zG@vyfmG3SmULSW<<l28XpkBs4)2gM6QLro3vIx&Q!<+}G%AZ(4TRB4^GP!)Rr2ksL
z!*0AafWPe__=Wx54#!p7_I$YrHJiB;B`q#*{LfX@_f*}Oa71u3=fK7E<`6XJrKasX
zOtGShgX}exuJMVh(R;l&v-I{D>)A!JzN$y7P~9=^HY+ug*Ti>$&->se%k>k<$8enz
ztGU)TD|MIG!uPGut-OtTnYyjG^Az{IM!M5;pwXy<L59^i?L6ly{aD3(t^UJ0ZSix*
z-=K-h{O|0|VyiKTHmj9CVW<%u##I!&CNBxA>{iWdh45XR+sihMqP2XAHuH@}c^i$E
zcLO1V-VVzcnJn)TR%z^;R&#?o>9%;RZN2}~s0y~nNpHOD`0r+O5rnuz=&U#aYs><e
zcA1Wu=@hb)aTJFmakqQf9Ool$H%E<Ue_P7`c=$ht`j4TS{*528|I_@9)^N(U{{J&a
z-0Y{*9`<<M95w#6@&B>mf9(Gs`~Sy||MB0bYC1sC@xPn?z1kix*O9b`eI{=!-M@D9
zKd$|cd;jC!|G4!(9+l?#b~u9Fx0#VP#`z_*4de4mmV$s3=qvj(re_9bQ+WCuW%6JV
zY`<oTf8;YVk$G={Lp*OpTJUerZQk2wGhMno@TLF&(4=i&Q(O!A-D$4)bjUJb8gsi;
zu-g~861gw3_Awk+yJ5PW(p1#LEXtd%IN+E1HRV~`ZId|^+t%(C$~Q_Y74<UGO`;R@
zv-ws`+y9{9ROkFH!)Bw*XxQrNg8aksR<3Jqv#z14DXQ~hh8?r=WnIckuVx=sJOwLV
z7Px%`B%kJC`Dk2sK7zIl3NN`cuNfxs2sk%AXIQOua|x$**S_w6wm_}8=6|rmW*iU9
ztUGpaa(;&EJlRO<jvjb&Td7NKS*d3=K{cvC)$i4r_DvOw@weDM2#OjKzMFjD@~3#6
zvUT3yKY%R2jITRom6s=cy4fLav~f8GZG9dASWA_M*h_*>$RAV?5XoGFQ4DZv;nD`!
zAcxq6$dEoR?C{%k?vu=dXUh;)UGlEG?qWJgtL18V47s;;bz}%j?Y>;}6w(}=Wwu!t
zIJL_%_lqvnCWxtnG|`<0V$B=0ERNy2=D*h)Lhd@PG=pq=x&?Lzc@Z}|y}e%Yn4I{4
zBEhcK8W79@3e5g;J6u|!K2X6i9_U>@kH=EIX6d38#se8%SWC+p-Q>i5;g}C&Jnkb+
z#3W@nP+xxYLAxWFL?$Ok#y<oOdcO;fvH3lD&2f^hQlX>zbWEFFjR!^dl5^PlXw<z}
zdu=kl=77|0WwgGHt=n$rZKJ1ePjw3cl{)D@FJd~f?cFa}=-vju`@IgfaI$|(r6XbX
z>3sR|ItY#dq7pwgH+_SYoS}@=Lt%;yze~+(cfUzjwWq9zF!fW>mE1$Zk{Ekj_FK?Z
zVbAq0_667(SvY&vE)vcqJ2%JXM(@Eh{NG&Bz5VhNoPi_a^1Imco_}?lAb9v60NmF7
z&pbCPpZADdviTjx2iNaUn20BC#<MT%XdDR6UzPcCq@4s?w{X~D+@=LAv$HV2G8zX4
zGIl#2n<-S%g42Ik8Gtd&$h{moA`D%b419kA^Fqy^nXQXRc^;9!tp)WD^t(+xo2(#A
z<KRrWb67JqX;$PVo`Gvb6aZIj0-hbeQTZT;L{m(F@+?io6!zs+U2Ar4>`?5H*w1)#
zgmaKnI&@wme872dviLx6C-0_y@Af4?Z?#ST4fh%!^U{V$L>pHVCO(0jxzJ028w~#=
zuCg*^mrm}khbUBk{ebSRX@93>w{JJE3M?M<#2|75Nt&9a5q<p7^?+0e3~&Jpl7Q&n
z#RL)C4tP6d_>4@Gdvapj>Fi8^d-&V6BVNvDr*yVaiR6I#6)%^s`DK?|Z@4$963z=E
zcUcV!UlU6^w37+mkE@h4XP1k7xKXBVfw9u0lC96=?a%6$h55ob$8vwXbpy&oPYk$J
z*!cRN5HPNPEKFu~Q@#`}0+8~dF4Z6U#)H*&DvZ$UDv*I{<Q&D2vc69Xw?d0PuNw7X
z1K9QOq2GR5;yj7`_1iwsb&j;4sfdkQMWEN)Z9i$|>M{cS7R$aiIip&is_zYH`C-Np
zp2L6T3OcZ@6PdA}OoMt0A@;At(~w`NNnn24E&#p`-k;s!+Y*(61E_PKKOd<&{ixG~
zBYG6CBMftmS?5d)alSbHFgD~>FsFx4g*st%eXR2a$pvo&oyVB2Q{anAaX#7XMj)#0
z@bSiMzW2E*|HetQ(~+xv_*Ku5e%>0wEs@|SUKwY>cP{qbohUzRBhHVYfm!~5&pwtF
z@PVG&#KA6@Mo0(|DnMP6akhCN3xaRwPT|3B`;Kq=qAdL#@kb@rfrU(!@a=xzl^COx
z?<r-A=?sq^o`yr)@j54kC;7pFm2wno1hlCi>9*ja6euU%03<>7A&8B?tjyq`4`P~O
zRDpv3e5@&#UK}xm6OJQ4;Z(Kw78~AL0L{;O!((y0{S4u6FMuyv!p<C42&WM(pIAoX
z-YY&*Ud~?XdH2^DG_MaX=%}44N0HkgX^}=MZ-whu%z>=HxR=*1dcUW#ovJTEHVIj?
zmv9BRA^ed$=2e~)4BJ&UpldDtBs9c&1-LL<UD2}`2t?4C#-56A=KUE72&5Xk>COt+
zhGCd=ZNIkH`2bY#rr()6BL;`xrt7FRf1K2p*<xcYo4F!rHb?9e2jg%&=_n3`=Rp*o
z>w>TySl5?s?{EFu-K$iO;LX?&AZ*wB@Ok+XZIP-0YM7N>D0!#y@pwtG{rNIAH7SNa
z!{}v!;a_BlnSwm<Eh_wIZsEDXVu;03l<Pvi7wp5T5C@QK2%7l#{UMR{A!XNzD^;La
zm*f4F=3#*+$+K)mtu5hM)`K(m^E_Pa+$Iyg3)}0qz2&MZ@`7n8SIySTZf~4oxhwQj
z*n1f(6YgzEx4u|yVxuJwLv)Ty!xrk8wqR+gSL??HpI8JB&0U6bra5T5r*U_$))d?f
ziVm&8c{R{s?`c^YD8s@4IssdbvD-GrQPpEwmx$I+ci|RvkC)ehMmy}x|1P6(VX6bI
zbVpBnMB_-dGjv35QMt~sHQ>PTdQ2A;Os=&)Dk8z&4d+<dkhF4V6Cn<zUWdAQ*s_TN
z`4%aJV%p@=C<e~6+R(96(8a*GJQ)V(9B1SE1`Zgd?c!jou$upFDzdW;t=IAQL9o0+
z<5b8|^YggYyG22D2IKbwad-=EfD>ArQxt2ox4tCO4^RYm05L|+(U`xUTGnxFY#u1)
z6puQ9bIt!jD5-5&vlrfED;Jpr!Eq;SD=N7E%L5^oAsl`!q<nfG43_6Gc`>}H)a*^I
z<vVcXYDY`k{BSR-pgPvb1^$&iEi{478WphvfsT?;@|x>mdD>2PB~za`bEY{r0HrC`
z%wvq4beLz|%up;DS60CzqrOh8O6;0{C_h|aCx}rh%tUa2@T!6a(^94Sx4d<riX%0r
zc9L+{EE2X_EqUPpI2uKp^zfj8CoIZT3lZ>GJkM$6GPd!gHLXJHBL<Z`k-RnQxF7iq
zPs+4gLaC9yc&`Zb*WZ7IiDWvOL*~CuTxiTJZQ#xfZH*LOz@qJ6sQySH;QnS3d4Jv4
z>nMbj1dDeDc2b**9A+`W$12cgWOu6EoGp`}5ut-=eeW<cWMYf1;t26OysIm;OWy=&
z;{H_NS{R#?9mKn1qv)Za*bNSsE7yipkEcG&lVF#7glj_#Q-n1n7XhIJK&>f}$tJ&o
z-5cU9oQ83hQtVK^x!P?DDq_MS%11x^DJJ2x;oEi-I$@1SDmEyYE>SMD#4TTen)CD2
zHI(xgkAQdxQgpWXP3)7A@_ztmK$pKA4DOn~AAcy#+rj>W9Aye!_MF4nBy~imkz$ff
z(|DGsCQ4b?fmTpb!0ZEc--sx|*f@@sFgdfh?CuRj!nJqjZE>+K(~VqGsu&*23Z*%n
zQ1}pgHO?Ih!YM+#^SNWYpmhT|7olT0c4F1AQL{y1vnXpOip?<Ah7xM>pv!Vr4aFz$
zFMq5hqB+R%an8!d-+i57_7x`1_(12SR<JRkj)Dy{B3Kn&Mk4vuV}HHu=*YNR=C7y2
zKfzq5sk!vxrtzL#4&H4;h4sNa<h3(tDS$-g#R^F|fs(8ad<~cbb@p4G_GYJnqW70C
zzW?zOT?I+hh<8)FAi%;^IZDhW#a9n%(|_DC!L0rDmw(3y)vv$&hsqC>(ZiK&DF&z6
zFte7i3Q0Sj7o`T3GPxAFihp^eVgi+M%Sg&Cy`d;UsRzVd<0rkzmpYoSWPtuxIOm_-
zU>POZ9GJqAl2_->RZq%(t8B!iM>obF9g4eZ<1tz|mOH)8N;zH&o}J8T;>5<KkALB7
z_!Wb*nO9~i?CP>vugTKD6T^96D$Gk>os>{2&g<QZjnuq^KUp$Ezb#5;=y&#!%z%T+
zY}md?$?kWhvAcdx61&6im*Yg?I{KyJC;frM66}Kn`Mn9(L-8P7e@n=P<1EELF&2+H
z5C!6qcCyglpe-UB(4Z~bci{;U<$ue_7;DfekuQ^LcH&(GLKc016b8Z6>JSt{m-6>-
zlac|YOiq`W6^qB`D`Vk=Gjl<DhL+EZ(1m}9f;pA}fEFHsB91nuzMnu{bg@e~s5F#{
z$x5U4uoovqSA})(%F|b$&SZ0=GI!emjj`DEntv=VhjAJ@eUw(tBc~ySq<?gQs~z<1
z?D`mnLX}N?k>q8?4TNsZfyjs%plV1?P|*O}JSO+PGm;&=fjB=%w(Ma`@ka4CKotD(
zzSwoys2FPaJe7NghbLcVNB?B18jB*4wA>s!V0-k~tMeC|(Z`5m0;&o`t50mmnCd7d
z32$JfQ~ny;EPu{KAWRO*x__3omAE>rIN5vRjq0yaD);+9%Hq#=x94N;E$+uZvn@{x
z$57huz*=0wBsP9@VD5(>8I-R{9y`R1Ibn`mQamb&@lg>P<pLxI!%BRrf!++{byX_I
z=9YdGO=cAJU^2sla38?zmQ+CCBDp}@qI`oWE$q-GZ#qhs@$6zb)_*PMTH`lYd|?|m
z$=W1~v*>^;O}I)OZ+h)|rWxTb(MT$9-N@#xH(+Fpg?g%*53WMAwBCLH9)!Y`af~|V
z2`(O}^6bYyp&#McT;8~zYr?|NnnKlJfyGRg=bTXSB8|#w1Qk>Sp-oODzTWZkJk&}V
z7tG)kYwSY{izbevfPZOf0k6cAwQkdgk_&j^T)Dol)SAcvn)(*%CV~I!FaI+(ydd}p
zipq5AU@ZScm%D+vNV;>z|DqgdNq(*YCt-P`Nf_~JVhY8ErXSHl$bRQc6ms1}0WE`U
zP4cx(Lw3kv&4N@v$jjBOI1))ABs`WcC1O%E#1O70WC6+7FMotq%Mi#&PD|TqA`=@I
z7Y64%0vq!`oHLUi(=)iQO=7^~lLo&=oKif!rlTz@<M&?t)$Z0h?lUr$Xb+?jZQuQC
zMSBbi-Dz<>yu{qaw2{p{ltm(ilix5h3kZgB{{5VkoYHMmct#`8j#GdU(Yli|2QojY
zl$@2v$nmD9&VS9qGkr4-;IhD%KtO|T_z7es*^Xpt(Vr<`6oyW;2z;BbFmE~c6LFs{
zbr-A)bogT|k0ZOdawQH{;IOKb`F9c}Z{fcli`sVoD&&e9Zh}aP-e*y>J9qu9*GUp7
zq22(Y=Jy<=PG0KjsKb6X(Lwn2m;cfz2&u-SxL4~Z+kY2!wsq!vTM1ob;-%1A#_<HT
zG25jG1ZsS^syl#3Dqe;tDMzm&sUjs6l~l!r<5)9PZYx}cD2)vlcT;9@T8BU7kP4XG
zn~OA#InHEy``@*^%<U0aXjBX!lGn7fc@QpUffrn15`cjp!Gw7uf{TPLCwM)W{Kc{2
zq>LNW4u6Ud1XFtfNA-m(NDrae?c@qja0p;qsI<_POi?h2Cud-rfOJ<sqv$<Dun|0g
z&Bg5jTp_zIq2&FsW*cjT1B@)RuVMe$O4lxKW*Fl+N-xj-=uo1RAnOVFgUtfu-=A2o
z$FK1}{rn&jP#EgbVj?M^zeP*}PQF1_JtJ&8<9`^nK1zXCnP|yFt`ECR1>#y)1Nq``
zlz<Y?kV5yNP~plYM99nkr)!`j6*g}I!tA+&HcjJwpa6eR!bV0~8Ddf~FFq7C45xY3
zZ0Ik+7tl>&S{}PeY(G%d^PUOspJd99+2cSmi{Chhm(_bb5lkTD*P6zwX*NKUIBW=%
zgnzsqu$pw>(77^0TZPTh<Do{P*f?qF(MRKY=1|<G_=)JK6QMSM>}fg-Fs#rv?{Idz
zOK3qDsDi_*_zLER99MpNJiBJJ@Z9*A=XK8ibMjN`=Ur!A@Z6te*nbD1kcZed>K%Q(
zQDArP3w^Dq+P15hIfL$%obxxY-al6s*nieLxA=gAqpyKEMOSQ%x49r*iKN?l1>tEb
z{*_+pmBO7<H_LlODt$JETT|UHskiEFAgt8Ii5BJ4;;fh#gT{pgqSG1*YW20kiy|Z8
zSBCqE$$<a@5vgaGiKBqI7q-cXF<KP{%d44pn{hHE_uZ=(>S1zTtI#u8a3s3@<$s)l
zS*%{DoJo){QBo_TAz$^CLdM^k-6sI_L01gEDk09)4bkz810#@_TxjB(z;VU%DzI*=
zj4-^L!Sd3pM#H18-=)C6#n(8>YI4P28%k5blYwLs8OI47&{nl@<)mMk{2P^#e?!cC
zhyqI5MnPr=q|Qk58S-~74QTMM7JpVpr^vJUGgY-4`u|0AVNd9VfxfHb6D{%l#56b7
zr`D}+YEc{>r@UFs<mf*6AXIhIEjtuarDTG={2zti9k(<IQsYfDu)t<a$9fygOAIB5
z_@+a>1DhuB>sna5#6bV{e;zO=m1Lv~*x`R=(qELJiC|pNQh&E*BPC@cUw_1T{;9sh
z{Bv~@w%n2blJ?|n;J>`ViXcBetgZQt?@QUUQcgPl!6|bY9TvSSR?Ehnm8%3Ow#!v=
zSfoQIf7L3jK>O?LatLH~(&<<wj=)%^{dIQJ{>m;)%$_jNze%mhyzF>Po_TrWgq9nv
zrQYB77J87r)qe9IRd!>fQhyAC)4;NpVcPH__2v8Xz($|C>!(;JkrPXE`Z{^}*qt(q
z8h5j+`cty1G}kfpc5!wj;>PI5FvJnYj2L5ji<vobRLM0~!6si5FEuZHaSuzqcLPnh
zFa1+zzKCyEgMt(c)R93A%#i*<&qj>5V=fks$=?&NKQBvb+>_wjc7HUyEmr_*j4E<!
zWIXqZ4tlq7qgNfF5k-H3xf@fyt;ijDUEHyY=S&TFZhZIh*$X1{i<j@-OI+<OPGs|7
zflf#{)3$0P;`lR+c-aU5e-)aG8TUj{HJ|R4k66AgSI7FnHRtwj8CaH}(c*NVwYf~p
z$hFq`r6fr7zLECzpns$|nDZysRF%DQH|7|`9!FnAWR$ruaS&_fdNzzB8m2_XR!5St
z)h!Yp7m_CpDmdgET+1g>p>FkW3KP!Q$Xeb*Y^BiR#M_eOaVd$BSz-b!p+CB9l?|QL
z4wnH%7B*34c69l7^YVvOKI<K24M`Xrix89qq~JRIFLqvt34d~@IPVWqBGai!3K-}f
zUHXFHK~4_iR$}C0A3kOM7a8NutpDPS0Mq>Emp=%4GK@5uvVhx$j2>V7g%Kul`hw0i
zirP)F<iMd$47B|&jE;y3D+Lu?qb^_J%A^G?JVwGS<EL7Uly*<G8uv}UM6E_QFLkGr
zl<Z?>nJOiuyMG#?!9!=}_|&9G=X)hr6WKUv!f&EVHjVFepCbh|WSQBtgal4TU!rNr
zA`QT|D4W2=&+J%i9V9t%sHvx@qsM&FD$9GmM64ysjq{`B<S$f<3I7t%KVrop{EN%~
zb|SuNb7B0RuG*)oR&dp}TcE-JbVEkxji~w4#w9IisDFZk0{w4P#v_hfJUoyRQZ^u+
z#uB46q^v=s1vQT4mK#hq$j?8ExKIF%O`k80qJv)-#CPcHyXt~Z+S!wKb|BhWUdq~z
zKI$xzg7#IfVkqeDyUDMtrMaQ@JE`1Ocmpp;c%^B)OAr;5#9#4LH5j9So5-#~5@1Cb
zB6sq8N`K2^pN7=EjX32gY3`R9ZA}l?pE;_fLg-9A=LV}ANa2*U4{gD&JpYV!Z5n4@
z@-l2rH2+`!iT#ZQZ^^phwScdv(dgYP)?K<mh(&}8tu_&V!%8<S8ZEJ^N|%IF)~%H%
zo_odR+`yX2(vYR+X82K3vB8rUZborbAZEWm>wo@xzC)drlSa_j+!gjt#snV2lXJ}7
z((x!N^pvks95mOryru0Je{e#us2XUNd@@5avfg{<Cos>Daz6xf3|XZ8yHA?Nvw7fO
z@tI8i%oPP{o=IC#veF1zH^mG!y|h><Q$>We_UDUFxEEkG;&!Z-b4{H1+To58SyqfT
zcYjiLCb3l0nLAD6HBwB$t7O<3!;V*6&XYt~qh&ZXEou-xk5b{6Zo*uB6?A~;jxZ&5
zY{j#tVQowgYZ|$9N>`{kN>nu%5C%2$#Vj<j3``lk#0QxZsG)2OE;TT%nTp()DJ7|J
zjyo))wGM*RK3{|}N@=M$%?k|UrILl$3V)reCH6sr%|^^^m`$c^N3d@LgkP3jZ4BR(
zgu-Qm$qil_6QgZSgStk~xVgOo2xI^!g*Rau3)f-r>kPoSMiRusyV{bTQJFZ(q1%E^
za0HK_Crshm-UhyN35QU&w9up@K``4UMi61>Mxq#0yp?bq1C4Ej^r0GAH(sl<#ea!V
zB7iCdLpmWaWb6`TM+ism+PqD0+3_%D;_i*KQij7w_&GQ#P8gB%C+Rh89K%8SfUcZv
zXdkM54WU@+u&ThVO!OfmL{wu>WFqqD#rcj)8>Z$8WMcqkUNP_AR~f)CjRq#?CD9~T
zdY{J$Ct(x}gk;mW3~vc9A8&*ho`0)&IxOP1NvUfBO^;_`a7~PIV>xu2Q4Pwq!#+Q*
zWFnCLqz07k3tkjm%HlTE-7g<etKAxMBhV^6e(hGq<%g$<q*drNiL;JF_K3W1KG%Mj
z<iV4DdIJRW1?%%lw5cCtA7B2(l!fG<oEVkO{Ws^t$W1f@ar{2Ht+V~x7Jp7ih9+tr
z+*=^kiYT8ctDCGUOmLwDSSc6<4c%}~c%_J>6kRDPG-sx5rd$CK4GLNZTx7ZxLoxxr
z+A&y_h5tNZRmrtM)xjPgQsr1q5>hUxeP2cmR;5AG8(v76wLB>_m!_`eqEQ+IDI5>7
z(Q$$j0xaXOg0f{SQ8FG*VShEz5h2dCJsAfdRr(H2f)Wsw?y8eOvp8~KZelM9_=bx{
zw(cuL9W9L(18*RGHKVI&>#dN)*rn3(ZBvp$#FXYaBVE~0;ca)=3#eUt3A${wHDya`
zlJ@e_(Vn!WVuQ2^R1viv)`t=>0928+iiCkioJljoBqut8MVre1_<s~UdD1)T*E`BW
z-2YK^oLFtUt3G}oaDA^pPN=$gqg$}cZ_p{{Qs+4X=U~tk!iEWoan<Ho8_C=giycGc
z8zQ}C=}$u!&Ynl`hDP+)rQ>|Y>Ccy5>>@rsHo|Z?Q3W$<e1`^;1TV17xw=ir#rqeu
zcJV`kPhj`Wscgt}=6}Xy8K(<M(XCaFVRUmaBoLA%!oDBatgNxpT{v>)F7|d|tgy&I
zy-2k=(;sXa-z*dN9IZ4nrk{WgO+wQLD?iFyYr5mWB0EpsLyBYh<Z+KQUOV2_@Bj)&
zUH@PME6m+k>Yi+Og!&;<Hc<+t?ucGqs&5+`B1<}ew6R6Zet#tWBfr?OOBd{=OcSVB
z4H%?OlMHkk-Rg*Sudv8vdIdkRzq(32OH@a)nM|w6NtAB1Twerr)a8HtS?3M6&kM|O
z2s2#B)}2wOWNZ8O)t_FzIM-7UQKq$?Sfu_(5R1fqEPn}HpzQ|M{Lg>?)6L2sb|8My
za$Cnsg7^6wlz$=l`&V!O@cQMsvEtv$&V9=SO6aXm%ITAGTGA<&t3S4}y#~X){dI}0
zjpi`OE$SUM^&sJ}anj*T<G9Tn&*R{nOE$U6wDxZ?iiI{^0)x*jSC;%9_Eo}Aw!^Np
zU>yQHhhVH73B=5pVEiZM#FO3ONpDUKPD)K}k`7PYiGMSq%1Y|1qvJcO1M#=OWlNvh
z6F1VvZ4v2>6UUgEZV0qwU}TBXjHtLTZ_K$X2tsjB0;(FrUdJ5YM=}yxD)pk`%FJWW
ziGTg&e@5&DQcfT#dfwmu_~O|+Q8h363eAs6ORa`6=YO+;#VvYsa1uamO5wl7f5UBA
zYONME>VK$gpP+QY3Y(c`aArI6;4E~2L9gI$(Qt;*I#zQY(K+!c)5*_d>q@m4%XCP_
zdIJjDr=vAMd8b^9h^lunp#dYQx*$=fxT%DUNYN$x$Q4)=_DU*T=$t0cGe=MfuS&2Z
zKBmhxQz4<JlNM7X4HNN1h&BDZDiF-m=gTzv-+w>QUcAffg@JpdPTS`5l5N_&po!R-
zP7kWR_k4kAH{X!mzImx{{KfLjNYX1Brn0$A$wH24Y9~e17?CEteM<<eSg|mi*NCo)
z>}lanSr^Y<ygN}*QCwW4@|LJ}KbzmV_gySV2HO!tPVf$f>jYy9AEebJ$JqXbHN--D
zgnz2$9qpQ4ywfI9{%624Kl?fe-79s<FZhe9G`!&ZnOEQg>DPpx*?3XSMk++|%9ViH
zFC37moVqk!`W(`eHeRF>`pj-0i(Jl0T9^_a>$u+BqfeM!HIjN}IxEpaX*_JyskZeb
zeqZYPAab6kI$6@g*H4<lUni<3W!R{0h<|33X^XIH(5*u#-eO{w-@B&q7GusZA{qg#
z2U8Cx$`ZmjBHZQ_2n+O8C7#_k8J~2q>G36p;@x)OpINcgEKdrB?_8^=Hu_xEF*lKN
z4W`mF)h=2q{aLi2m3(1*DM5)ysIdMErR!B7-d-zBJt=Nb$~}5YRw4}1?%MENq<{6Y
zO{gsi(&3R1_iAt@jf}NflG-lR(VK>*q%toOu>!}4A`+SA->yFmP;*(v8`vOXJvgu4
zX1mfQ;AL3co8qLv;l4PPx{d83UcjREqeXuS3Z+aKTDm;yLQqKC#?A;TT937{V$N-g
zp#L(%1$7SQmK?2kz3bM4RLD#a%zvmaFWW^Lh-%c!j6#4x`Ku?hLdeu0f6VZTnEL*>
zPFhB;55m4Tuf+6KNJ_8b1oyjBh*bR~c5zqEae;d)4~(+ip$xj~Bub8sUv@829=!6|
zU9aRn6l4eCRPzdn+K53Zi|&qOu~$TX6lhOvL`oFI(D3u3>y4(rpByM6o_{EoG7`o+
zczYy~CgJWN%A6q9RBHZm3JK>gh&Pp5K$(bB4S1(qs(2N^|0*w!M$ti)1Cw!&Ge|k)
zfILIf$j3fL9DmZtf5!=mP9uw<V;nEMWrV$qB6ot`1OFCVA5Fl>0^2U2Z14n=OT`~d
zYsMw4n8nagri008Smftd)qg*_b`_IRm8BRt1{n5~P}MYE`6`{&cQ~gUi{4cgYf?d$
zlxQ}RU{qQOA8kIGAPcPoOU@HSA>*G7UV77bK_;-8|LRh+Wvs?A70H=4{tKo%Gs=<^
zMw}?jQ9*PHB-u-f=#3OhaLz?p&$0HN7vM$=;=0~JipUkM;MC4D`G39B(D~~U%ydM4
zx`$)SCh)xuR?(wWKrit1qzfhU6=+zlHlID@I(USA3dz*BSIzs4xa>-h58k32vNX_#
zFYCA(-O3Wg0EDO9kLBI&c0{e_2=|hkBXXu2m7B-LwMi?Po75sPT88SJsf5TB%PZM2
zRXYiki5<jECd~xS3V$A-Bml`hEa6~?Wb6F4DK$1p=xFT-rb9_1C_D@|Zcrfo%E8(c
zH{j-M5g5Q2ykj&@>eMNoW_Ihub5#|@4GcHZjERbh+%UnUrW^^b%A<FgpyDmzJew;F
zK%vhFv}J3iYFFY}nG$hwJiYt#<#*q|efRA0JCQFEQ4o@1Ykx|pVB$!9gZ;cx1btGl
zFd1by2oMqvRLp&yZJHW{SElcNc9cxOLZ&z7?ZnAG6Qj&g3~H)qHbDviRfE7IKK$r7
zi#4BPnh2}n)(y(Foh*GDg^<bMdRPSO*lZT)_ZMM+7lg!Xi@<`<ah@mw^mmjPl(1eK
zQSdUnC!2wWuz$feqA(AR#>>Vo!&@}Au5^Z*Aehgwd#|0G0PKD^L7(+UAL#;<!WaSQ
z`_m-?aO-5}^?Q1~k#3Dtl%U1!MmL2mfc^e387GwxTyw2yz)4OFq|QhklZaFeN>@ji
zNycGFGsEFcCq&K9#`<$sYbMT>>-(ycuaA{#y10rja({{%U^fD!-B&ClNPI;wG@iFv
zauTB%g|%2k<4Zs$AZxoYgvVHgCsTqDTD_mpmG1qmwPvE&9gUTAomQ@B6|7YPNDB~k
zq?!6Pp6Fw^CP=ViQHH+~ZU9}Fv>l$IuH(?y3e3f<5wi$rps2p9HR;_KO>Wv?_1+Vi
zHw0bjpnrlrxlf+lC&lOg!0wZ>#^{e!nVafmU=UA2GrVPeiv*dj39~|Xp=o%ZY1;3s
zmSe@Ls2zcEa4^nX)F{gt6flrSpukNWQhU%Yn{$1VN{d}ar1z4PP5dy~QB?SAr4Bht
z<S{BOYAISYAA><OGZzusdm$oCv9wcu3NAiRZhzu56N0J5YIpj5rcbkoM9fQF#F8WI
z&fu7ln=ww)Dr(jL1gN7+v)30LmCfF0BMRY*z#<P%@wa+q(j*X}i}0rs`jWNagmc#q
zyx<D4$S8T$_0E9>K;5v_#84w3T{A5+=N2}x8&Wk~%msy0a@4It9wBZ6_PAk6X$T_V
zPJa_SP^oITW6;<_G6ZBg>j+zl`pz{>R7MB#6tYq5+lVg?oQ^CB<{s<Li6xW}M$v*X
zC)M3f7*L!Hh67>V$zlnc!W;v~o)vk@LZFI1hqIcHPtc-7ogjgdi?VZQsPz0>((jc&
zkV_Kz(am|`gLJTGth&nBsScKv?Ga}UB!4U?)`arXadu7BK-iLJN)RzGDUpbdp0!gT
zpi_&gIzV}ijDL2*$+tl`zxdYm^`TR3zlcd0%!FLJs%Z=wl*wxdM>RD=ZXKn3yf&9X
zBx<MmiA6r#Rg0z8h}i5Wn~7IP32Wr~MIV7G{&#J5Xl0QP(_u7TqVfLn#rHp63V$*Y
zciWaiX)J>60Dan)GCO6F@@*g+NqnpdW>CwR`gg_;2u-sAU$^6|O3~c7Ff>t)aT4^5
z;8RI0p6e^-mR7yuY<8&zR3sG)*iCAMGH^wx`DAd7D0MTd=g}?V3IuXjWTx$5OYy>+
z;4<{yHrcTl6|H<ARGtfC(!6rw4}VC7<GpufZDSHACtJuChjVM9X#C&`YPNB-;>qdl
zv?j3RF7%JK(}yv4E(o6|i{Da^yxgOZd6YgSn9^W9LnL<v1tuj+nZt~e@~K!DHfNcF
z$yH+MG8E}W7>G0#F1xgmcDtYSw$>Vgc(!9|r!65*I%pZv6wW1+o>}yhC4WWVk|Q`Q
zo*+iwml5~DwzSla3f_VH1C-cm2iYzhs=KJsvw-+O0!s^r5PAr36s=VY2YMLot)FUd
z%_s(S`vWUpk{dNq+k(U>DZ>rYG|7HH#V9A62eTk4dg?}T>bm35L+Z2RD6I0rVZcts
z9WYl2LsYuP$@JX#b|n!7U4KVe=Nnw0SPGoO5xx8B+Y}^r>Pxd23;-s?zo5B?zj;Bh
zFoI7CmzY%m<=4>r$B{NGm`_j{rQ89X3yJ|#1%bpR_EYi<VhHm+hQv@OD83A(&1II+
z5WLNL<Qf^MQ&!<m=oPPiWGzOh0(j{TlVeB4&WT@=y#z`Ed0@jobAR>`8OoUGrvIRT
z%Nv|{W)|7=i8IC1bpMo#(9N92PPm8f=r54>ZjJoMVERu`Bm5M6!~`a;!@>n<Hwoqc
z`M0SD>qNL`pro#E7am@d9F<u8g&Ba%iFgK-J2!F?(0D`^Umz4_=%TA{;h7eC-r^ug
zPP5G^b=v8TF~!8ct$(2<NS^a7*5jFY#?q4*Iv@-JKh0jk-YL{@oAU<oKu+1su1+2v
zU4_<OfIlcv3PjeiCh6Li;OCNp?^Di33Zgi(ABr+3MxoQo1DaT+`62LAM!I+SqI`Z<
zgiFa$MPRHlW<A^Bos&YbguFC*xVL^|zNX@OOn-$o%sWfFIe&F;7I;7ERebB-yu*Lr
zVXP<r(+c4SsMe|;tth~f+T<jXlYunBEHb*~C@y#HVt%D<>wH<=a+N?MWqZHHE30?@
zBH8p~YMAh0VY;DXf1qDK5FEv2xOBEqL4V?IsaL&6<<Tm;xrH|P1S3pw0DyDq9i4Y8
zv|~m`Uvn<>2Y+HW0V)GcB+;T99E-$c-*x77e9K%!OV5l|s{W5J-nk2cJ&$zLCewHi
zqhOmQu&NwSTAtL;tCDE<$13-#xw72is~se^@6ukt^qb!xxT4hJ9%G^$E%5_ron|DE
zTImFw=!5CQHD;C>{-mgCP=xI8y~_;S<zDxf@aH$M`hQEXETUDFf%s+O%yfb|x;q_i
z+-#g)s@7y_qH&r5NR}H0`<HOiLAgI^P=dedr&S!Gd9BSXcsjX7Fnbs#a$aDigS=E>
zqHS?k0Or4F35C<!<}_#AZvIh}_401ezBAe7GIyWgW!52AH;9o-?thc~N!TWB<<0!z
zsN@E}|9{2|KW<s;eW^BsJh<Co_vq_qf@9W2A0#RFz(3Qamlb7j(>kiZrOH2%RL~E4
z3IJx4NcnS;j05-17RhEBH^2-Z&#|H3#Sxc%9I3y}LT7q$G>hX!bbiJKDNSsN1$2Pp
z5;ffbl=CwZ;qlpuu88ZI#dGg>oD6ij@#B;hdw;Y!(N~ze<2x~CXW=B&BcI#|Q!-Ao
zkNz|N4WG=u^%~#$y24p2BANvVej>>yzzuyCr2r?<^6Coa$fY1Wbd>bD$dp&O{$d%!
zLzFL;Nu5^S4oV<U`PceghQwQXQ~b?T#;xgM-ij)Yng*U1Tyy`cOlP(f=t#!lm}yI{
zqkj+XR0hMqd=4hzC)cKQ4V9~ww)s*D1)>hIHW7%r>EZNHXZ_c2L3NVOi=d8lDPEF5
zOmSb8Kt;X_&oLGBItAY-p@@=-DLE@$$;u++OOQ>zkuVcVtdGtj{wiZiFjl?oMwS_p
zuTb!DFk`+aXKM!D-Q3ckjoZVWXR~E6t$*xY82H%RkotlmLX6HuQ~s4WZO#Ty|KND|
z;4yc~{N#{FWc86(oEUdZiGg8o#m@<>BB`te0)Q2#RSl)42;K)J`t(vZ9_rc*3cGU1
zqh<IBTlVNQq7aK$z+%%$lMd#>>86OBB@`+6G?flyP_+{_bV3!1%nP|mK`VMITYr(J
z+i{BOCaI;QAy56_19lIP+^aD336RP%ahaJ?Edr`FnPiljmFWzHRe7odV!8qAm7|=%
zX(~|P?3X{f3uUx>0iByT47|*~G>spYQU;>R0ps*^=6C|Yb0R!uCd0v}h=Wf0C2zth
z6<YJYh}(D%^3r?dy#U6-b2$>8D}PYmi!-fkGD&BG;?o(nwyDy&K1aa-ZGBT0e+Qcx
z;Jq#zMXCjqX@W59;LNyDWbwBUdS8t8KO|^b?_Xa@@@%sp|FWS<<&>nu$p+K6arGnp
zyyu2fGO346BrxuC3R=P`3Gilo6U$`WCHw(xkV#<Q=J^IlOOh;D^<hW6bARQ_pvxG2
zzCwJ{`MO1&Cqgn9nXfjQ4O5vb*T`Uxa^;*>Kf>%d9*5W4n^*6jul2?weK>81E?S1z
zmLSZ^tWpYVVyq5biAu@**N&=4EM@O#0$<>wBvWhLMI-FF=qpNPyF(L*Ma)nhq&UCP
z!%~I*ma(M(tgm8?r%#(axqsbaUsCOE@*JnBZ)vHGgiYKd3MW|CQ^<&WD#Gkm+6vid
zbZin#ijt!j*B{c+MFJknbdxj>wbzWmgZrD=aec;S?$ykL|BoG8>LVZIm0ld0PWGf^
zJt<jFN><%UmSBjUT)hy)yAb?bdav$BMMSYIsZAaZw$vu)jvyHT{eK%jNaa03RNnJ5
zX3b!9>3oWM4+Y6qo|uN6BmOJ@`}dRZfBolY=VMR#>9NCN5T0^00hOn#&|J)pjOf$V
z`L%1uvx}oqbJ*%zbN<`R!F%iCXx!{{d-zBC_UBV-hkS9=($jJ0ptY=oCEmFfRo9)h
zTbci~dt?6J{)_hDd4K!c(P+?I_*X~wL^+~aaD8#)%qNbm|760a%^02x{MUhLt69z6
zxuaG_(>cQrV+uk_u)HlBab52@*7>P+PNc%CaFVorLK_=mZI6-V&O<QDsC7u8Ba|+W
zEpU{Ph<RZnB=$)|xR<KaEQ}H<y>T<bqpTiG!%G^Yht8b3#D9>x5|noSjvuHRp@=?N
zLaWTnSNY9pl_OBcL}yg4Q$DGBPpV$6svcUyrY)#+8FfXv-Uw7lSxojx*;^IE6~hGc
zO>;d9A_B#AsE5m~N<dB8jxlzgf2zP`+)qw}t`&F)U*wNak+d5vJo8o<Sse9IDj{qR
zewwc`*;<n5+<y&deI9`%G>z|ES+sGa>XB3xf^ICHR++>r{m!pv4#m~b8^sh@>3oB?
zFZ<P^q<3J5L{92`lLms^?8|r+r$B_Jhic1hwp^)cJcE(2x<StjCdyzqI+&|+;RH*@
z_RUz=<fmIJNfkws8PXO{H0oPX0tt^pu*l+&WgeO^eSci0XC!&BNlr_G33+YaGNcWG
zK;3FoBhLN7e@hc}?o-JayLo-^*WIJc@28*v&+l3JFgLfcHP|JshfdzFzx)>^B@q&H
z(|DPIP>3k+$o0vYY`Z|HC5ApoeI=l9%A;ZZR?{h^4!cIF%PE0d&jL?nx~P1JI~d_?
zD}DAyFMr$doY>isVpgEfHR6$FSmHjyXt_i215=-QA_+(P&Beko!~N4G7v*q;kL1+2
zcJy&sF>^FRa%Ss8Q)LgC{Ilt2Sj*Tf0k3WK8LrrI{l3GwP4^O_%2moxLX)kJmXp2j
zzDZm9)#in&1~ZQF^2I-7uGJHT2&=ND-09l+DSw%uhYJ-Y=-~qILip#&F&z7ZO?L%!
z#?2SpD{9k#zcjdG0$;N8G$_k0itRK*Nd;&T+HLAu*lB<uT!?PRs#zc9Hc?I>$my$W
z2I`M5XtasxW4@^l=4uBQ-D=e7ElGe(CIBkSN<ZYa32>JK?T=7WEn3}^Mi$|YHdZe)
zO@Cf|&~sgyx!F4tDNauKH>(9cEQ9Wyta)kssl+IEby6BM>)ZEVk-$Be5KHXG<fj&f
zsYSzkV>dEM3`vINX~N#>Sots`!~A5r9wBuS>~|c5J2AJKK+!!&|8O7u^D^|x8;n1&
zr;$nkmt0qW{Nuat-y0W{@%!W3=a+=^NPjYgU=Sz+hYig%pS597tue12_b&6n2HQ4C
zx^-Wb9CI@oy7t?B-hD|n^9W4uXY;_nk}a6)*J<X;-X&42@?FsKMME=_CGHzbP{Fu2
z1;`CtrN;KtDluA?DSA4$Y+(VAK>Z2UHR2i@6e+Y5v3aEj!7cgW`*&|CYZ}Y$9e;$4
zTKdJUJEXx^s&fGzx=c#4PG4EcizjS_dvvh7c{VSDp*<R>Tq|)U2|1jwG*k!VMd*BT
zgJncZ!(Ggz3KRa(s%hugno%s>q{j_)FQlaDZPFSEH(mpP%*FJ|>x)_!y^3?{I7!JM
zB@cmH5ipaODZ^ZRsxqLLX`F+Q1b;Z;2Ur{K)H!vN(0HvO3R2@(<H^Jb-N)Slu%_$9
zhv%OiYj*nX#ideiGT*Qr)Q)(gbw^^=fDe{~=O%)GRc#(*o{llMQiRpYNJW2do+uZV
zUesTgXj}`v1UpLBf*2|f=OE_F+^&aT23HC`53`{XO~ET53O$26l*G|Wnt!1BBXaH~
zX#BxdXwK(wYa%YO=>rQZ>>I74G&jx%7TvlGxdIn$;DH1}D~oY;6toB4+j^xWpt5I2
zQg1_SyeIw@ywb-5H)n)^h3Cd9ZuQ@N{$GJ_lg@x-wmoc&?ycPAT%en59pi7~o}`*2
z?JgQwNlu`vo$rYqNKM@uAb+Sdto7uU`{j{|9x>*y8swB)p}3#P*{I7;kZXQNjbm7v
zy1wNt2@`%9Gtwyon>rqF`Z52C|L!r+K3M38)^h@{t70NI;uE53X$kg6bFG3${)Ac&
z+xFP@&M|%N$PsExery|}V6@Q%ww&|I(q9!4HyfD=NH{~XYI3PgeSfQi<7b^43@E5h
zN*mv2tvnNT$nMc<jxMd!WWb^scRWd8q(qGQx9?xRz5MX%g^Z^pkx&}t^5vfd1u~_E
zc>D5?FTQ_X{UGn2{ZR2Be|Y`<H_u)-VPjrh{#iDbuz}*c;qdP2{qJAsI)eLZ;xSR=
z<;}uFV~E0S4nl@cihm$9Bq>HO-03tsapM@B(I$eN$Jc?n@w~va$!$-L<>}NRoB1<#
za@v4yD%+mpt@+8lG7~j=1rjggY`K>n1v*7Oi;@nHk>mKflc0&U(GiF*H1M$*1)gz>
zdTgXIxkPc#Huf|V^j$sErpg5)7a#78hCIUtMQnP-E=o@pjDL=|z;S(Ef5wYH2|!o<
zgb!O3C^_a?oU(h3i(^5KF>>1sZimk(q3Fr9_vcB|_)h!nd_o-j<T}@1QIMwc1Tezj
zqBN?^zmrLb@xDVz`MQ6W#ge=*PXVtoZsBonA>|#hyq+YMH)@sh&yRF!47y@PNf_+C
zjF+Jwr49@Z!GGT2>D7NmURJ%?G7b;o(4<}i)De7z%`a*oPbPK}EB~8)`z1$t!M%i1
zJb|5PrKCrOWDmC-ExLAE5V0_9Zz2cNj>4(rX(o!k;2s@d>IWDGk&NP^q$M206*&Jo
z3N~0{LC`)bKd@Rj5=3Mi4A!x39mF=!Sd=6o0?@XnaewBn35^g_t2f$8XXlldL?Gd*
z_R-giS%}Wd3uA?Mj)B}CBFCG;4~z}B4;F^uyku$XBZ5q@98w}k{oeDq;hp0qpedD%
zi!`K7F0|Z+A)tFUI<UhebHg{|p%N_F&IS9BE!mjZcJcC##40-Fqx2?;&}W<URM$0(
zT(fGjgMUMCOouy2&ArFc1e;NKp7>3~6_m(B8fHJ6tcH%ZiL%Diwiny>R8<L`PxA8V
z4Q)ls9u=duKp&=mg&Qf|2MIaBOg)xu0HSn&btxNzL+5G7dyc8$B1Bo!54eFCRo;CA
zQ=qR$zJZ=u<^C0lpO11ISRPswqtn7Bc76tGm471{4TQkA$)T_C-#9UKIU(*q&x7S*
z8li@nq5zv<SkPy{Zu_es<D}DK_WgH))bcqa32eZIs<9_uhQf`-rrklLGAP9UR+?QD
zOwbQpa*pOCSn9SC$xH=0f2Y+|u$;x;=wZeYV@yek*IPn{>Eq4`Kd)|B*Ec?yAqB>{
z6@TIJ+>ERx`u2d~oH^ng;7tzV2a)0$#=={Mrg!pH%8eXO^PKtI#Dfo{Cipi&&y<#^
zw2J1R7+(>_0hr@u6q7L#RV73#S#oBYCno@V>0rJT90t`m^*Fv=DEFXAZ65`qk|u?I
zmQ1e&YOgVa|F4*Rv?n!ltT_;-36wM}W`EQ|*T;|z$ZG9|#ikJCtexORf8*FEYyCo2
zTERq)PO+HJfpkDQAQ&q;q61lO-~E*!ph#x)w$|z1#~ZJFMw>GwE|gYJgVi7pnVxo8
z0dEREGL%xM$ESjue4w)(L<w@T{TI_xkcAZw-;|yg3@%dIm&O;u<PhI(a1xM4sefEj
zC3|Ak=uRVqQREx%;l(K`VmeB%p<dbdsr>xJu?;08@Sjf_WXGu6TS6Jot$euX|8fkf
zKnUXauS<za)uPPhA0u+pK6~*Fy|gj9tW-R9{UA3I8NT^g*~?GJ2O@cdTqrqY*rMKS
z7+wH66{x7Pkxqy@umM}iqY+OrOn-#gc~!GNO$J*h?z&moOG!w2>D^ma%4AY_Y1!Xj
ze)sZ+jdf$e4FhDdn^!(LG4H8zj_g&a{zToS=jQE7hJPGjV|TXnmY_drX~NMl6$ECS
zRh>$j2qgYigZei#ME%}7EwFPill9o~8U{!KP~k9Sb4+A}FQQJzLI(MXWq-_9V0?P#
zz|@vUui-Be!PBE=@frv?@Hts#n_DOmwInSmcnk```z0uqq5Ih(MN`PmCMN9q!sBfO
z6O~-W2`lPOm?xepH#DXc;qWc$G(Qi(##Mib4K*mcE~FWEqrAM?4wjw2EN+v-_r$5;
zoi<on2sw@iN#)SdAySs5M1QKZv7-~}cEZs$yI}II=V64B($8-fZ1U14x%h?{C`GTv
zJ`~pho<54(v&sm!x6heFw1@RgAGjm&Z(@{yScPV+a*|`mn)#IQH*-u>fWf@<LC-Wp
zg+s3BZ(dPyHUU9X1r!OnsZxxy%codWU|CDmuO&_P5Uin#F+6=>DSt`7TAJNmw?hA0
zHX-GX`1%hj1rDs)E6Vmxiqr2)O&R6oXv2Wt+=B3)n!uMjD+Lo5qHMhgH3ra7)o^dk
z9bnYkExrBRSS9A^+XH``fRU~1i}*`aFCOq(G@fE=I9;n2nz{iWLSh@H%I?=m*_d8O
zSmFtWsjK_yC9U=-^?x!uEY3Ze<Ecy<5URp9W#*}lFE|q1Qru&bt^z$SaXZct)_1Kk
z^s;68*Cvd(1gd$NTFGS5NLWp^Ylqt?Bpzcp4X_7Mis`Mt9lFs+>`Kc0XqIFi@eaUb
z0=VmDu7jg<RxPP>Cf-e498S3RXmS#$L3t!n)wulw7|7V#=YOKT2j}SBe4E>J4{wRj
zp!Nw4ELQK&mcVh0;?cbNT>MT#N1jBU3`DRWo%T=)V<euD49BR`9*aKTX`%Er1@g1g
zUT2Hk0iM&o$%c@uVUx=RFN+{)Ivrr&;wMPD*`2-=SE|z)Y~o7YpU~Oq3^%c&G#1qT
zFOEv!KXp1|Ie-2W4JE~YqLIY-Pc&2+{HM%tvcbgoPo+m%#edTHPWQgnZOJg5I^DMD
z0ChWCFrD(|Bm-mWbbCTDCK^F9KtBhJsjL$D22&Ce*caQ3%_7PooM*7`r)HSsDx>a?
z&CEetim0QraplCMCAnz)&&}1gc{mVT52&WhHzv_Ej(@*d#s=q{VIQdl=(g|x>2S7d
zt5=fe(Izk>6_P{u1L!R-^+?MWJSJ^Yf>5PiFn(bi=o($tFk>=P2v&R(Q#>uJB!B@0
zA*Cm;iYk*vsazkdGe2x)@ib4?wr?wy;XEbq<)Gy|K0~5ov#Dhqs9Gu@j-thnFPIc*
zc%5-7Tz?C6LXTHHbCw}$ua+vp;dxoSJJb)J)mu)UH2o`Dmw81mtA0sjqprc2z>*0j
zhs-lj;6u}oaNDzFN!>g}x+#we=E|cLsI2HUZcAHht0qp@p&L7Chi=k(8?dm3wmDX)
z0YvBg^7K0z_X9L{ijSoVvdXp;>B)5OzWihg+<$RLszIe#OD;f6Fc5686$siVCW9=%
zV3tcPrpl(W1ZreV53t9Up--?r$bn$Yd%!zO6Cpc-6awd^f91K+tU)`0{ESvVA+^26
z!U|xY#mt;wg9PMdXG-N~=<uKp1!)PDD(Z$WQgH%)z-PBK%##}zlL4jkxEbt?BDm2x
z6@Mfme}c(JC5P}6{ONV(Z*(@IY|$3^^%w<-LUTI)ZyX~dc;xxWl%>I1aLOliD5zdB
z1uG$m;7YP_J6#T&fymPN1*@N=W5<Ri=c@m~3!;b?r&rKWK&zRqc63PD4Whl1<h(gv
zMhtwVwk!J}Sha6qx8c0tnLwgs+fb2g{eR?2qQ%{`ZIr;~K!VW5sgudTvZn6Xitgp4
zeFP`!FgNm1Mwi1Pbf$c6wQU`%{dYoB$HDN=-+uqY8yf2M%QtVH!5!duHVDsW2xBnK
zj)%qDimfRP`ZNws(JLky)4{GA*LeGAk+Zg{M$#oLZJQTo`h0=8AE6&}xln(;iGOu>
zZtBVncNxfcTXnSC=(u=iUt5|g_k`f<c8Z0z&q8zJTBq-xy||R(^^Wtw%Z|P-ZdIX=
zO<>}qPe8(?h+84(=LTOd-Zz21zA$as>=9^GHUw>;XbcTvDuE^Kiro{Utw7g|q@5am
zTsVChsH%MSQb<+AWGDrY-!Bf3-+vx7hrQ7{LjI`P8w@uQ@{{=#Mab_A6+(Wm)#|-`
z-u>p~_#qJTHww`T&>r-nKh6|HDmz~lPLAUfZVK5Im>R@&*l-81Ol+)5Wp05PC31NE
zhES+GpkabOYt0x+3xC2#xTuD11y+-I3apc4=D`|0s!LqAPpUE6@O-zhsegl!nc$=2
z>$lNs4_E!lSk#eM>C6~WZER8D$tIaZ){+K(kF$*luWH>eOP$ynY!`K(*Xrrep)&PU
z`5=U%$t{)Et>2DxIgu)O43EW2pVFinisS}fLtN+YWJ~*4MM`V@-FTxU`00Xrx}YBB
zg6ec--t%6ol-(#DMU3r_1Aj=-{X5vyz@2V^;JW`U*ul9QSwFFVQk!l3Z$HaMH~!|r
z;1~J71@PN65BB1s$WjGz`<NKgQraltOVD$==#31WfHGuBm@B(BN-WVUv}@7X1b<h-
zTr!!i91QY?!SZTmfOTVP`L97-0v%IMoL1x(I4?4-T(GyNd*JCFcz?PFp6-ES_kiTf
zz;S=C=4GgWrt$Y11CX;%e_cO+B8}etR&SktN$Yx0k#*hK!MYyyo`2hY(Rq;mb2-*^
z+4$sh_!<Rvk{}!!fnYSc%mM|Xm561*aXm`T#j-)}ZR<PNStLT$QiS3fI-?9O76drT
z49FRE_*)tl#9Ua;ZGTL=602M{_CaSxiG#q4n#S=P3>mEdolA@mW)GdjRN%O_UNqpZ
z9nWK*!8K=0Uz=Quf*IO8Y-)d#7eK{eXb8@n3&M~5lU@ZT(lt+1N?hW3&JK+E!cIt1
zj@c>Av5TB5Y7PM_QHh-7WN<&52{!(+n6{PI#!Y^2i!Z&tG=D*<w}C#IJHVxLBS<rm
zu3&&Us-B=J(GK^v;Bm|XS}fy@9`^<BCE*?_o~(2m-_tp$loi!M5)5*f>!9F!rHhaz
z{T=G5f@1>rARZK}#EP~Ix1XE%JB;${RB1B<dX2f#@pVw-CLZaVI9dcNAE8T$%4m(L
zi6~RoK?c@$y?>sT=D?{yTotS@K<qH4K)2_nk9NL;A#=<dB0m9G8C<SQsXHc>eS7MA
z2I3y7%my7~#g9=M&jg+MHkOf}Q(LnY^vB4-<_VY$!nY)*jZ>(XXV1AIbIz}(HVTZZ
zj*jzhvwrMYH!#733f-VLNp;}0@m0#uWuV64+@hG!Uw>x~J?*IU@P;bFNQ$b`ZY~6V
zmsUU=ySnGgwUcf7l0K1b6vt5zT^^lT`iV|4PzAGuSV^Fq#*Z(s8C*nrcWs6~<yD#S
z3Zf3ESy3hvfft{ksmIt?%QCrS)$wOo*lMR809{A-CAm!@q<vP($kp?~wKLf|3ce!%
z;=Ov2V1KA5Xe?=mgLGflnjRF2Amny(J0Q<d502)n_+>8i9MRY9c=F^qDrm+ENIMo`
zU6u7S6@R4<ue?Wr`d$h^FP&VU5b9*D0?OUV{f=U;(`eM|RII$>vXsmcE=#tcVU@Dv
z_gC>(#?1YIr=FVPGWC!zfP&jJn@Y44?k2`S1%ISTpGfqTb}KIk3?sf@E*3$ixgo}z
zxtKI9PF%5uIT@D{A~DO0v%(k^UZr74iV6B4jykQslkKI7k|#aBa2}*XA<?*d8dFdc
zODFlpX;&EO6lF6^6pY*XB#@Lw<6tssq&Tps@@-9Cl=T?wp#y>7gfg|O)SB1EgbQpO
zNPi9gRQn;&=KiQt{s?qPuvi#MgknaJ3OG>W;6neJqnu%kYIsF$2zC455Zm<`N#TD6
zMx5&pxyM#UMM}CrP(BB)8uYNY>g&qG#Vp2SrycneWUO<e>MIq`EhC*pu5d>-ms=Su
z_&l)Tw4ScvZdV8lo(Z?)AbPh6d;l|Uq<>wMF?*J2|AFW(>7d*bH5uvj`-~~3>V_#Z
z364dIBQede9)n=0a^lTCW6I$v0&MQ|39$K84=9^Co`RJ7G)lhU8;C<XbEokK&VnN7
zL;<yV5~fTfBx6$Bx>7@GOOCSpDG0w}e`y0&6UMa@eAE<~<X(vR?U!vE0d=N1rGHsi
z0IQtb8%UJLh&|k3M8<Re45<f7YU?laXRV8)?oo~?@AN^H!JwWlLKML8^g$yFS^4`v
zj(=*Mj(`69<9|H=>AyD{Kl8tx{Nu^r{jFFN9pUyQ@y3&as|4eCUW6h;cvju-7skAK
z6$Z=2al6PU>6>(vHDL6rn2~;_xqo?j7;aPiAsw8hzsO&waBJ~h8nm?D{~j9=J;ReI
z-RS`who51}Wk!7)lo@T4EQ0q5;&2NQe`mbWJ<%CLk&uv0jRYIcn+12{cd9pWs$lT<
ze608K+|Q_RJC+OoOudmz3Wx=uz%~jGuog~3br2Le=Z2w45{w9(fX0L5YJWh1c|7Ru
zM(A#P3!(c*qP<E}nvyScR{5P*SN^;#f&0qx?vHQ8%-h>W(_E1ttiH}naXH6w>N3+T
zd!nD4q5TNR0!Hk-PO`iJQ4nX51WHP;-W}2_Ll@QerQAH>J77vwInm4|S7w5LSM}Vq
zL^;UG?I5n+|M|@xW_S1PDS!A#pQ39kS0w3TGt(wSEnUCeP@TLfEG4<RIy>qJ_cJfb
z9oU5b@o!?oArHU4Gr$xek&!!J1YvAar-#^y&MA;&P6BGYXgg_ODvQs&NqODoA#sqH
z99|R9Y$%Ba;LMfV<)h;x7!_7>dck!PoSRcI5yJT)T$ipWhWUaXvwxsi<s8+uXc=Y}
z1qQlzo49KdQymS%)bj(+*0{E&@$E81V-tb!bOC?TMlOjEQZgO|O;=nAD}=#c7`$?>
zAcfVMR~jj;eNqQ=(J=P4Wh^&&^U(Y2Lqrs8+X%Z5i<}Yzu!YSeY_3|ehuF<Dpj<H{
zH2o_EmS9iKC(0`T-G5v6B#&Uv6sZ2KV}_9=Lw5)?Y>x+{)Ao2M03*XmpRD_4c@nz+
z3;W1p=8@2G&KV<4S<vJ@Q8i}~K~C^%+P6KsUEsIrG0bXE4P&X{anrcO<HiAfBo28=
z1Jw#41Ie5TRI6cEp=2|$ZFKpIni34D9k~A&8O=5pxMf1CGk+FOYO(Y!L1q`ustN=~
z6>OS2h_skQNjTmVsen_YB2KBB{{DzlE=DRlRN2Q3n+m68$#JD?mBX=O!=`gPR;ZyT
zx&YMG&4&#lr}~Ntxai!HnHj3k7TqY6TH|8|^CTeuA3=7&Haeke5nPXd6*V-<M4INI
zlS`<<GPY*U=6{sTbyOj_JaO3yA5veTj9qAF{IQ%OQkV+}a>Z``Q{eiSxR&DVgD&sO
zWIzPG;D$|R3b3;ZP{PaR#?~p3G4I%-s1V&Nio%$fgL{-|Ho4m1h{yKHYXV2+lj$v0
zhRSLeZUTaxx>w5(6Nta!3}EGUcLfIw>68%Z0(-N{D1Rk5$%>bmt|SIm{LHk;W(4G2
zt35sjk(+2>5yoFZ30b|MRo7XBF$#PH{r1z=y-A^Q^cAOzDfmn~KsA{WTxc^GG3G7@
zyeKG0i)HUP9Kyvc@PaEs#?7RFAE%<4PMfM#T?aH=TNfUNV2J1?MDHa=FA=?W!C;i=
zy^K0)CW)v~qRnJ<6Lk>Lf~X;g9z-XE=q*YTCHQ&y-~YdN?mG9ZefPKbK5gB#?p=4^
zuNb1gz(tGiD9IY-2RR+<JS7r}v5T4=v<Z7*N<xlM-e*M;<J}t=RiM_G?IpL8&i5VU
zx}{G;KIq^oRxP3IX>5cSEY|s&BS}pHWv!m2D*7x`A^xUGmXxxOqiJk8+E%_|OAFfO
zBeK?)TivCzXM||Py1e^TXzmTP%Bs6~!1g)?{+XYrr6AH^Nu-3LnPoX51%=!X6}kX@
zSc*n;jTTWc8qoT;W<EB0$A?zun)FoXem#5AD>uujAy>UeYs+wx;ANNE<Fl)L<<HPU
z-@Yh&T_3>>6V9&92ktuBzTS8XcSarX7~@3E>mJtHD>9JIBtGVs9{9cOXOHigQTkIt
zYoxGJSeUZKB9!Dyd5FYrYxKq!Z#wzbvy1Rf#4+W$q@L>8uwD$r;g~zfT$8_D%=3w}
zVdVV&jdOwGQqcm!_RywuQ)uMlxbl$<>#%;ZhqYd{)}~-Ey`8Wyi}8pB)QD#O)Mod|
z+p<r;5*rt~qQ2@c?hrboPkY|fX~+_5L>ukBT4B~B;*1hGo_MhGVhZMNz^xc!iR9;M
zK-dLbeVKaO%-npv*#l1Xm88$Hn_P|!7n)+lx>^7173f_%Y;?HBgy|)E+qDTt30y=j
z8HjcfwD7*|{WUDXk)b<N-a5y)$@FGzmBtTFHD!rMKQM|hk5WkbS^JJq!*>^m33?Lj
zYB6G>-Js@`Ia8Jw+PIM&<sw#EBD7XD><AA^?@ynP>Dq%^pik!qkM*x!;b`ltD=|*?
z&#J=qorCPSgm+<veMO(lOg$`MvHa0rsgI09x=k!h4@yAZ*c9hiOZEzIy`p5*nQp2Q
z{XjmNW}8+PZfHtf;XV@@kKuFhoR}t5j8FOY2_VxK&nHe#tt^@{mv_WA_By>Cfx6I~
zyh)yZq2^20{Vi^JA`X;cyjEX?O1aIYdMGZ4O$#(h5XVxxY73H(+AMgdw}FJzdb>w|
zM-b6GFHU%`i1Pyci_qWnxWprwv3@G7xcg}GB*4=4=hmizTfTJg8x=GqYi5!{MN-vt
zIt(~L_Qdfl!7bH8wpTooJx|vXu|sHvQrain0C$|b`n=IMnEpV37eF2*<m_mfJvxA%
zm?Yn1_N}LxYg{OmVh_wWIr%8YB{McLo)yFTdVKtGA*-qZ*-V9Hv)9om=xqoGKht)+
z1GW6reXR#{_fyhu*`?-2F8Xw&AqUkU9x<PO^MD=g(|9GeW6sXw9R`cY5x1GbQ=jsB
zs*L#(ya*N{4>5Z4v}y_!3yf(&FF)WhS!dLdISF56$<U!nbQDDPfD%FHMcdp~cUm;<
zeiS1Cti;YNB`gX`njMEy_HHV{%>k`J?h<M8zmz0rPd1`b=fNcK2$7$=g%<+o5bf>r
z!ey@eBU7xkGvvtDv&lFWgc`%WpIJ0*VQ!cgunSuseaBLK4?s3`!_Qg#KHZ0L;ZxPe
zD$eCvZ$AdSzW~YF%$!8@;;&zbm<-4zC|sWQx3%eGBx$`P9wJVX@F+UghWcl08)$Y3
zC=CgSUDRak+vDG=vd{DEKPh~#yRy`^df@cU;lU0hOwV1|Pitw(3xPp%5p5+3)aojW
z>b-lJ#~eG?^3pK5)?Uu={i!LQuo81Z!!Hg^doe{#Y7R<cY4=5lzo#gvF_tWZtkVpR
z+P}$767d3SWa}V$`f(oI*v|=)>r=%<Q}9qc{mu5UE>xM6Gn*^TDa>giH>lFJGGHka
zG%8L7?W@C%Pko1tA+&U6^(gWnZ9sX`uV;@+JAcc!@+|%6J{~MH0mJgrR|H4MYp6Az
z!JRuNV|m41=B@-MqKepHY=oTQ8{aw(e>CF{mX{HMbeA1xgjS)2JySS!o=X!@V(t${
zNG{#N1qaDFsMZolA{5WEYmxtW^*VcZtET)dcT;=OP@fe--!+I{^&P%J1o?W+j`dM=
zDR*BV5oQ^s8Dz^0PWKY`mmmB5AmW^`#3;?)o`NOReo+?I=)GxYs3FWqa8N%+1;>?t
z#bCZaJBcH{M-=w^OCuk&0O~QnqZztC=nx~8Fev)oS1fU)$rr=?K{)Pld+lsvZ|{e^
z&w4#td1opJc<Nn!GCCU=yMPj&Y@GKrYf*Kw|JkI!-xr+cxZw(qj4&__?yE$-7B>ZG
zkKd|}*+?yV0weugY>hlJzsltm7LQ8>*=+3S0lQZ~Z<Ru-K^S}tacU(gNxByz!GR>4
zD(`-`r{o#pE6K6OOG&EhMMOnCDkr}aXdPE0OJ0HyrTO~7pS<f;gU>>jjKj2H3OB9^
zYDRQ!)IDGUeP4OL-B`g`F1~9c&R#>y*X3C*9>nwMKuwYu+Dp5*w<HJ2e5A>TJ|7(#
z1a==<%07Cm);>S|81kmU>i%V{8Xh7#)Y}N(T=T%>L8M*6OIUJPlw+83{_cME^JyCX
z+_75-PaZ9_=Jz{U9N~|Afh6Xz5ZSLAc}(58{mtnLQ?Yki^zF9#DJ`sYUUSnjxd-V=
zo-Pj1?(YakCnetRk=IKrr98^38yD(*h;TbEPa#FSi<-w}ebzv<oC!iSjw}$bzAUw2
z>nX~K(s55xgHKP^+T`WdF7Kc8w2kY%X&%l+WMw(ads}{MHH3tK-U9rT$nnhzQqyUB
zs?ox`SdW+Ltc&>CY%eWTguC3hKU10%nb<{dki1vXap!%`lxMS)y-a<4bsJ^PIQ3Rk
zxW##9uBSlkq>RQ+(OZbcarn{oy9|D}-<JeynKOQPlW?+vq2e0(-9-27{3>tYR>^J{
z0#?i%7aG4WQFbb#?7Y7j8Hu}x(Ir5wG|I(e17fxq<mWwFq9L6;$5ldWd<wS~+xk@A
zJ?kYH&EZo13h1P;(w!k>JJXtc<M-oTRBRJm43BC6<6glQP2cm4HfPRmrg&N1I7(|5
zJD2o&E0A7D%#uIWH&}_tqAx{b^sQJ1f~|Pi(>O{z!L*7z+@CgCaWm@%>9;9mu4xYo
zR!OePe5Hn!GU>4K5u4R_6DgzF@wG$2TaUk8ezTqjK?Vl^kr~8!t*(O^-OOXfNRX8=
z=xEXtJ~sb>lL)rx5?tHZ`tt{cht!fN=J1w0yqoIT51UJIy{AsO7+B)*3YVG{qTLG!
zRbzfUXeNppl8msRmHC|dNSu|2t;4QQue^Dh7|1Z>V;MIVq!2cvxH-A@{ie9C=2^!S
zj%tX6MDB55I#D(r)ZY{|0^cyBp_NoY?SM^GKWJFr)T14ra;~~zDVazg&*YVYfZ}q>
zROtQU0D5?L_%vx9@C=Ju3VzH+Y-3>kd7bGU(%XH0_O5eQi;Teo1#|w5Z$=`k^3~KW
zFcL1?J`|pPmN89JVqfgLeW(QC{lqP}hD}-RD>7@01{Zr{_|lid>t`d=4G(QMo#j@Z
z`OSB1NuvwIw5WyqwMl@us>m24XE(<A$<@NcVkO~$=DzH^IYy_9%p!A$y^klC{Y`K0
zbS1Ey^2_dOMF1tbbCM}s+jV}jI<N~SvsGZydn9ZG>up3qhiR3)(JR_-^-b!9fC5xR
zH5$RU=@{Sv)30A+<xIGXpRRe7S)WU9-&)RB>{Lo$($UXHsyQa5Wyg(;d&IsD9(zV7
zVSAB7xT)v;){7LZ9dPwv?D71-{p$ba>?M_z)pbSRF&S#cS|8(rYZkx+L=$d}OS&Df
z=Lzo{ZBG`@8`ec#KCx{#VTlTIb2C@OD?nD%tTBCx2d;)i1)1{(=^f9B$&yRnM{v7s
zm`Xf<y1=$tadfY!#U2}-F`O#JIZA2<`5uA3d&6RTeCsKr_H?^|5JI5sjn$KgCOvrn
zZQgwRw$9y8Ozl$$5{lvtGl9jskme97nM+7i=iR|>e5ZiKSVQ<)MHuCv&?>LH>RmfJ
zA8<T?bGz2@gu+78Xu&!8X26X{$RdB+Rw-fCDEs=ZM%sMiL{Ii$Rw?EH`RaZ@I~56_
z53+OD0IB>PxKhxPk2tQNFfh2=#!qR&Q_9~gKTm9g86oUQSC+!pUz-}Vb1hB%fZXBH
zq_CR`BH<4Y5toskp{3m#4jMHc$%^+Wq0%1I;-e8*Cw~id7P6?QPpXg@$QTi`oNRP!
zLCIdRRl@Hz$<|r%>U$R7x5<ItBea~YXNLZ&>^BP4JU?CALQK|pEG&#yvX57eZMrZm
zerZ`dyHk1DC)=)W&sn(e^F7^0OvQd-g&a+AMsdcyH*Esz$3L5W9wxMG+hc465|z3c
z(pokHjg42_Z&YAP{S^#5Q4{YoF8czQqeb22m@Gz|lA$AqaE>mn3#TXd;vzN9@hwdk
z1yftT@sOSqa3S1D`2r>tybNsFY6jXv0-kq2SoQ&d7~;lBzK3KF7}rKa!k1AM9FKkn
zn5l)j5w^_s5+I1w>LSk9I5Lp!>1UA{Zf4{}#m|DJh#S|}I^+1dRve?h52@`%{DLPu
zuG(OH0AZ@)a!mTH?7+v=Sq#o5PxnWAF)S7uDDIJg84*j3mc{!jrAN7K7jl~MOXlj$
zvYIq311h*@^Df7f@_lJFmBlhKRaFNPkODa(MR#U*&cJlTp$&Nj={^U)5JzwV3)ZxN
z)!|!AB^}HvdyOOxzuJ87;A8_<Tr=<d#D?cI(k3mFj3IgVD@Vs<c+QY@Zjao;nvcM6
zAUvE&AF+LSWO+eWJ7*1JkUhFLxn>k{gTw2EG{Ph02l7FIc^$h5Md=uag9vB!%h~QM
z!2rYk4=tkAy3=8}KUDp&7$`6EQ*3!0wu~`ML$%DSK+4^;MYybB)kZXs9-nz-wTx+d
zDzM}gvP4o|=<pk9Q&m<}4%cQ1$+5BDkPZsUhbZJ*HNdQvI<VgmKEN>_{juvHI?s(v
z*Shb`^CX^vQWW{x4s%ArEO<lBBot`VWMMFGj4aXoDKW>5cFlEdO1k%J@szhlI&*%g
z$A8pp->-KELTQzW^6~aD(unH1O_F>{F=4Tvxy9^P!&oPxo}zkly+kc79NN|BaA%{V
z0ipe95%=f0|B%vC-d-AtoU}!M1%9>8g}ah~;M+y^F&;0+d<;mdO>CqJwOkF%=fLmQ
zqM#1dV{n-qb(vnaOX)P5mLbDJLgsD%8Rr6qd@UzDTk1!Z{6n;0)7xq$Vqi}8AEi#1
zU%xNyx8TH1*=GzJH%gf4-{ergEE5RN%16K@;_lX<Ua9w|E4ro68xgsL8AP>2v&LED
z)`AK2Uu>9{JDEZZb-NYtYGnFpVr(HXUP;G#yVeW6($jF?@`;_q%g=Q)^*dIVz3Hd=
zJMV!Ay18Ewv&cyXJkvFKX;TBLJ;14qW%uIlATbwRpmdsY9-39F*ke-LHSNAB9C5|@
zJB<Be=F%)SPm}sk+h=w0GQTBb6-Glphg|}B;_ji`2<kq}Z={yAwk;h&G$f`DyFIZd
zMM@1Z?^p?p@`5Ch%RaX`;Zpg(e>TL|uha+8dxFti@4zK(@?kgz+6097t+dCmAOK)N
z5D#FWje|=CpaT5ieAc$GMmg;Og|Eq&=k|b%sJa~>-?i{{2dHx0a_<5)u3MkoKk{Fo
zvE4tQ%Uz)Mf5D6>mpvfQwUDy+$Knd9b}e&!2TI+%W|Ouoqrp5P0RV_luHS+DCfAo}
z*a{rjaRC4<-e3Iz{J-2M0{}c7{cZ0Cd3yZaWkNziz_rys39PUD{i7gJ8{dHp%-0|Z
z8{UPnhgaOySC#G`5CC8l#l8>ZzV4dNK9CW2HUwo5f<vE58%l#h?*mC#uC4#id<_5y
z{>%E->NTA1nhTr#uRw``lONGy0Kj$qH&hVCd;pZa4rFxzWCW5|;-CyeaA;9Fl~*V1
z0g&Wc)o`s!TmP?WcpZn9|L^hsy+qZ}fyzo90N}d*J3=N3eE27V*WuMr(yLIyhd?^i
zrz%`pRMX*~0KHcl;2mKgN>Lbi_kX_sp3BH-sNriI0N|Ve0HFTYKm$>VM?enc>)H6{
l{vrMs$k`tVu=n=zcl7fAvr_msuJ!a+$NejhWIMns=|9N?fs_CM

delta 37876
zcmZ6S1yJ5h)TnXywz#{yzqnJJ;_mM5Deh3*y|}x3ad&qs?q1-w-#`D{J2x}geKzOp
zCNoKPk0g7)QA>_dkrZVhp+19w!GVFPe~&|wfl&XRfDb_$=l%IF#l^AzD~GuM9R&yf
z*Z3z)&;<V{O|S<C{S(KLCQO23{G%b#6yHlo6omgf;$L;nzmj?t2!3!t{kx1d*#EO3
z{AFhsPa9KbMh{z?bDfQZwI+1nQa{g-(swUB@xsU5YBH_VeD-H!mTZ<l0~1bI5cwT-
z0AxJX2;l2}EgV2Bd@W$4u;y$Q5BI8lW>nj*;WNGE3#^;h!_s~oylp4$3JbuQ_>^7e
z<Bj!a4_G4V%h-Nx2A*Q<IqCDt6RGaA4^=hPildU*3?|2tNH?Jyht)F^D|8M_6vkAO
zDm;Xp`y1+J=xDw+JNRLpm6d5s91Z89Vd>Z$MN+qAmT$py?tG&l7^7dmV%~WTP_fB!
z4I*Sq-r_Ps4ecK=q!Ax%Zf<s#=9p%;bP#7?1;W23@Jvu6&>dZi^KmWnR}QPZp;?!c
zNAo6W2H0Li5SEvYhc$YND@Bj@Ea*%JM3&Wt5{H(?qak*gAj%A|W=(d<f+)R~<vFMO
z7uoJdV!}p>;<sb6M!a6=rE4a#mR>o&B!nu^&SqG^rSw~L;6s&{)NGGX^O0!IrWVns
z01JvLe_kGWW<~BY2UniWyr%o%FbO`zNWPux1mJcG4J~#LG>wSi=^YtR4C`qL@MEel
zlgG){Rr2z?5X9k2G=>%M7^NrHmOrEkni4MvvAsjtx|%h3)iiEIuoEPrENV@Xkoi{!
zp+*sQS+Y_Tq=h$_Sp){~pgx)oJ2~L#0TuLi+W!2dZrL+i<APvH@2CB*oJx^zDjz~N
zRFj{2BSu)trn5>9ykkpud5A?`zNdkH(;FP&&(e#o#w_N0;&gD(?T7TAw2;6fe@izx
zSi4kt;+$Z+$CGr%>M;L-_!BfPaFq$mHmnKLX1;RF_(VqI@k|9<j2oy~Z2c=#8%Xc3
z5NWye{3^cb|GDC;!8_-f)SQ8UW~~A_Q!#Z&3w%TptXi_D7e89B$uB_>j^9pf(p*sT
zit<<dIP9w?2PZ*=`%x2G<0js6Sa{uu>)$kI-kfc&{V4)ce7;S*OZ)vCFHZ@4C2jNF
z|B{mY<C@+3ajAPkp!3#>JM8@}@Cq;=7S54><(PtDKSf)UuhF8RA)hqXpgqAM$yt8?
zmW2vu0XLNu+RDUs;?|hNtX1S9dLnDjEIXxDSV=q(L*d_hvSkP!iTUMAATm5kK?PKI
zvEr*KK0>8^a*BP`uqktY5<X@ly*2ex<eD4=yh*=0>~GqAaf(k~lcIkrHAevg>1Prs
z+uoX;YsN6f<PpCg9!_Cj5@Sft$SpK5$^BWm*ByHWoON8#+gfm-1-EnK1wJo!mv%nn
zLi*Ag8_k4)xvaJme==;eGvf>-A=GF@Tp%<St(!%t4S*vp&Syi94|@7B|3&h8nn8v}
zT`~R($OuXbc_{#6`A6?rEmRYLTlVfxil*a_WjNX+#PfhIH;2<1eLyo{1@2za^kp1v
z94;ymV`D+E1SY27B)XB22Af9GT`{kuqXL72qhN=+ON8mUsi4^26mlr>F5VZ$tAm<$
zB{|MVJAr|nqR>Vvx1s{-?)5@HTG|qNK*s|WUJ6B{bY~bTua5NDprQbf5{)T{r2Aay
zy*P_}e><tzfE#jkVXRMVH_YmF#-JIq4O29D24`0SI*hQB67)q{9XTUUqDd=Cdo!3H
z>AlnWPIPpjTchY1)cc34+pXA0(wV2wP(oP)S){Z?mIY_6z6`d#xS<7+*(7SNWxj^@
z3->)=`Qt>U98yF6WI`FB=4%)M`6)oDS9p-L7LQDgyf5a0_CeejoNeJSZ0W~yH5|?w
zUg=1DRU|?i6@5x!h~rULJC<v!Gl?${!Yn1F#2F8Rjzd#^)g#UeA?hTlgJ<B&OrJC_
z!bhf1!iHdtGg5MXaB^pk+~%)usA0lt$A-;1xb6%c8bE}<GrbFtQzx-LC98q>+~d;@
zq71Zit1w7*zmd-NWKcza>ow_hF=}b<-MYM#{HjcM>d_t;a@fFwuSPL6ZUpHU9I}Nu
zV{e_Ejo;WKjKGHjN|}EY6H<mM|Dr*u%V?4|-&F0Xy7LU7qIjJ@0l@zv9j=l-T*R5+
z8z!Yq5&t}bvabSUkNwEjp?XZATzGrecH%16Yr-i?!G2xq$~KAiS$&vtc;zGt*`&Rc
znF%c5&arLeMZUUjKTTc&g~99)Nn~6(65C4Uz#rsYeW&Og9v(r+O_TGJ_gIDBQ8GM2
zZXG)<C83H;BQRal4IU#^K})E-BaFx_Mgqv6O_mRWEG~hk-$rGz?|zI{D7i&A7X)z`
zzp-2hY7&WKWmkBa1gT8N=vZB~$sS`&Q%HTsbPmPd*)K{ZRq>pJDp6kDlAmr9Pa#Lm
z(s_ISH2RomNn0W3<(&%4y4B?v$N)aVSjKhTN?6_`?oT=4&bqyZRgs}7=+UVI3Tf2E
zLYXT2X<9(?Qc`A2lz>4m0Vv_EF`}oG#wZ-5JLfiCzLaiWDkw^yHBr0Ex^KA2$<4ox
zEOa9{z=F9KQ~NX;Q|o~~q@m|aGZa=$c#a)^FcPz~<JV<OKSW^sob-1mjmbk?VA{r3
z`eQNlgI>W63H6Z;KM)}kPb2eMP|$&KtNO_&2#CNTHrHKFDP<>8hq=4JT8AkhWlC%F
zYHMw=;uj^lQ}#(V<Oz)B>T=VBmXG8>PbMr_!k;@lUwGGFdhdpdm@<=6Rl?y+-3bXC
zl$f+xMwCtWxxd2zy_%bf6}u36XgNPLoCWJG-o@VzYo=Y|h$wg+{W`OpLYE~Hcth5W
z1^U_@qU=??P}3*v)ChUN8M@txk^9&_TN8MX_pT_U!Z^`J!rk+FP|qV-nTe)<^M3to
zW1z%^`ib<(`O|$>&#sg`^6FZ})R6HbFWr%+vl=zUd`<J0lN&rd!-65UWG`aa<Xt>L
z*EjC4Y1*bG*G*8>UTyTzBt=T4(MN#Qcc3~?dUE8`!x8V;yh~{)>%mnN&GLA!Y<ivE
zVy*r`3%vPFB!Pa@mCLjo`kpe<C{uaueM^HgGg)=-%4J-U+?M|QY4&E6tOqo?HF!J~
zi1E(0wX=ucMqRRgv*#lxlZwKFE<0N&^g%-o3tx)P0+%x@>4D#PjA$2P(0XQ`5{NL#
z-VFM&+f(Z?Lk73*d$+jz;2OI-4=tT@QWpqYCGFJx<>{oQQztY@l;LtQgZfj_rlfMG
zWdbKBUh(_cTLra0WFm+jS^bN)vs6JmK`QUBgd4>#^zOaQ=X#KqMXhOm@M;@vga!#N
zNthzYWRVC~gvfCmKcokncm${kPk=@L-(9AAA?7%O-(@NkPQDY-@{Oqkwt+90$A=GU
zJw-Qqa3mX76mDsZsT=bQw%y^K-YjUu)K>i&Z1egj;qo)?^!x|b-L+Nv(FfS4gZ32}
z|LNZ2ojxpR*eT&gs}#<BB(%1XuZ8ebTZH3fBd;yK5EqjKy+i>H{hq<yq4b!i1={y-
z{g5M8K6}-8$i_HLLlrlMwG#zy=1(`+uWUImyB@{XQn&NP#CU4cF0q)F9M~9p{FQ3@
z(Zg#8Yin+Zye0%2($>LIcC>QFo}~LJzcu2&YrTwx6ExsFs%o>|zZt>iHhG%DK4w=!
zyY^r#3Kxp4bF~AUuiLZ{S`;rfIE3MkPn<VX*hCT9d`dd8mmS>k+l=kS=02jyGdFz3
z`f~>v+N}PL$E@)O@$zvV$E=%RYoEi_8I2*jxb0L1o{FYg!i;$bTR>lKu&@0rNRO$l
z6J|Snb#w>zB??=+0^RY}VrNZ$HE!ka^iusIkP#8R%900spAMuiweGT3T3<2ld0>m&
z($Zx^KdQzeY~@M12tygqxvsN~Ib@S-lrxE4-4~c19GStK?tXmsrS1r0%BNmT;fgoN
zR%5hds_HzJiTr-15v;@fXItmUk&#yTj*9sKI_~H=doBvTW{J8%BtZauj%*WQ5kJN^
zLF{P?P2>o;93Xa-8(qYo8F0NTTId-J_wucCcsZ9MDsDI@OayiI@WukjVn;zUFw&8+
z)AuATfy{_@EmT8lN-E01u}!y4g9@gf3*Wj_>XYZ!qphaG8S|ft2uhy6!-atPkzR*|
z7kGe)az4pTqW$tN7FLe>)JR-rs@#ZJVjjiRjCTjTYq1hVBCxGy`Gn@~PuYG-m4Gdg
zo@}H}tur=R>MRg`bkmwZ<j@ptcyUiUMztbuE)-{KJ?<W&NL*0A4USl_K$XiT)s~z(
zp>_FY4mtGUY=5#4#7~pq$bPsKP2Ez^<}Gcjke~ECPStE{lx%!4S-^OO@a<i5Ti?jJ
zh5=f&<V1GQLL%X-l^Yg$;}6(#d#t#sJcbUMazyh{eEU^qB{e_YyNKBg_X*C+m2!?&
z<CW(t{hPZ7K}8u@xFsk3<p3lwF!HZpVE^MY!NI}(^_dc+(Wro;u6?`4G-MHaA>tYI
zFu8+Ob7fI0$rupMCgIWI2$HU1V`S#X>(qpNv%A6(r3cg+O@TYf$~H3?LzGI}X7J-H
zsuKF9s(sVpjxfBzY}go1L*(SP$983#aY6$klNwt;Xn|#7YMO;A)l!%Vv#DrB!y*Q|
z9#LVk5h<^i86ChgwiaWNpT6suR*0VMuJ+k_%n%^dR8FSAU4Ty79c{!~i%R?qhl~Ak
zjJAT-P}9%%0qX0if-R{`oTyCpd1blbXx*DB2za-}9^b3R%nn+p+aPglB$%VC%-oeD
zr*|;7xzDzSmb>~isbfDQXTlnzAmF-RE+Wn{fG$rOe+j^wI*vGWk<erdIA^ECRDQOp
zEkf@_C-GKhmet&?G$lMT<<!8kDMOfj%s-XVJ4-EpX`^}`YIw>_+&X0aAZE(ijkU-v
zhbydp(oFr0%f9Tms&HblGuFZ-Hix|NwAFq&nxnc!;P-ijL?+;ivqj}IbRP-6jB*iq
zAQ?2NDJ}4c#3UOd#`FQL_#LsOXNfTz5hb$K7nja3D9TNZfT_7RiMvO>6{gI4MElEG
zXo=tqdS;O2$*J}dPj}lS4SJO0P%N@opH9PC@H?;k((d@FbxmsEAve+ouB|$`FN&6)
z_GUI_@V-m3m+=9{#Gm-X8g9=>2LmjIaLd}TRei3C_n-JK3|L*O)|`_T{-P?jGm$A^
z8!!E(?-2i<ozs)DU*r&AU{z56-?NjCK@a?t)=H)15)$c4f`XA^bGJ8B|IReHS=&kS
z=QW`NaROb6Ch{c_{_JZqz3&ToMm5kiJ|AjcBaiE=ROZ9S=nF=Wrg1VNer&kR`=b1E
zdlOr2#+QsfZ}h2<ZTfxK|M4m8^?S9o`dC*Nb)ni)l*8;oL#luIbBP(o^w^SBbq-Jk
zZTd_#sFPT<N!93-rZ=4ZWO4S>$H~V>Yw}%R;4S~BpBBGh&XnM!V6Zvef>k4am#zRV
z4u5ijE><#s76ZNhKHXAgGGmILMmq4!0Z_a;lk<-ca}nLdO0S5+SC;e3q*iyRt=?^Z
zY(2+JEir`UNq-%)|3lhqpE#2+djK4#)GL@%>5thToH4dT8h0x_IkL3IvOdgBlvk<6
zA~L>U?whoEu27lhlrOyfL@hGg48<0OP5+ihwY|t56{SS%ay+~C`C)Em5!w0><w6!|
z?PqMT6DU$JJ$zs41Y3{T@3dk<33IbItT}Q+XESCg`J^Lh-v;3~gmx>(11+#nzc=+d
zwvo=Xa69^(;(Nf$qwMhH0&nEW$`^KFFZbo^FQYL#?8^z8f~)$kg-&her0>S#Heq#(
z1$I^yOi;1}walgVxJi?DUQS1|bmE0vQJ%aSZr%4XGGd#{4Axujpfx)%1X5JTv0Yds
znGcvBcflzk!fv{f7J|P-J+1-WiUng+G%ZR}EoSO5C{(m}G^85khNuT;;~W%y+H?u)
z+zCGi=4sO7JwYUxMk?H_rJk}E6(a8%_tKkqD+8GTE!cP6&vs8&uDvS{u6q5Pg5Q5y
zx~C`k{?J0;dZY6xH;<O2YL3z!Y7pga3+4Fq=KaChd*h__-Wqkf0=Elb@6zoINO4n>
zSEOl0X4EB$1F)2hGw&EIB-w=V8c%Y6im-bY_gbhbuo37%fns7U`E5iVhRuh+-qRj)
zB@<D8o(PD?uAvEr#)kbcyr0h)HxK24%6cHENQqMfUvA%HDS`~8!D|WyM=x&K$b8ot
z3oA;S2-+0!bC(L`+k*wR=Ulxccc&Ealo8vP#Z`1i!X++II;6b@r30G!*K(Lzs4!|6
ztj+M${le1sy8IVhse&&Gd2dQRrm`U-sEvLw`wvvg(sNtwp-$4DO6Oy0{A3uI*x@=D
zUB~-SKk2|{3Uh3cJT7(@DHaJXo7ish_XyefoTq?Tieir*-mL_fk<Y6Nc<1%?g3AP^
zDVEV-EJ0RSuSUXW<~aXak=R~FvrN_Z9>Qro_vVZ^IVoa|2`n+6{yHKUq?xZ_z$wOl
z5uw1Kqsej^^X{s<(Lb@nJPeM`TT=o(vVp<3MWYCv2<^wI!Tl!y7c%C@BuiVgOIk=u
zB46I+I%|HK(JKH14TthGrFAmtx&MMwTN&*qdcqmKN92`9TmVO}M@s}fTG+@o9?Dzw
zo!BU@Xf%A5WQxe!P`!@GXSMiUl&#f^!Wa0Gv0Sz{kLi$yiVgOQ;&f9xv@{ZzCS_S`
zE4d*C0j)ulvyr1X+_i9=@8^}i+5Bf-h>(}I0KU2tDw_^~`)KM5k{t1eoMMEbUG}M$
z=``aDiV~+q*`0-W{1rEgpu?~vYS{GFHnPeeqv~n))sd&6(RN%JqDB6Yg{=&{xS(2e
zGrLWCwi0;I2A6X>=}nlsuTT|P+(SAN40enk#OjZ#wivvx#Crp91z~mwUkW42VMp&a
zN3kdJ{eC|J7UH1OY<U@0_k8)$E%=bV`NmpKUKF8A<8^z|^(2KHI`bU)2R<p1QeWdm
zEPV2u%<P<VZ=pFB(hIULEa|}n>`AgGb_?K4#rv_CM2%8X5L-t6@^1la1igX=$jVhY
zHI;pTsHlFqe~;qYtvP}%$I}unxRy@t#4iiV;Y7OtO38!bro3I+hiUHEG`57wdv2}+
zi<A(w?OU=b{DfW8(YCJ!iD&5*e6c0I_~rF%WYA$psyG^87Ft3$DoD(uI76w5iYa`u
zRwkhS{2Y;PSCr=V`+KX`7I8;;e?zpoH0)_Up_m%wyDtB$q?+O<iQI83=I1Jjof2>!
zu$ISopr&LAj_gZE4Q^ubYgWyt5iuPp0U~-72DlsoVskF^x_WiVTc##|J1a;qdhGya
ztOE;p%g<e;UM-Re^J4IV?3r>LoC+i5lMc*{?DBf|_eiQF1fE8!!};s+>I?k<{x|gF
zlDFfSq0b~8w_}ut74xOi8;vm>O)h+&#-~qb0r4~(3AloY?_T&f_E;mI8?LUVFPRP2
z8I%vdKyiG(sE0dB`vJNGcPZm7rpwrIfZt1#UXeQ~#k#g<>LB>_`D~WjYK>QPF)uH%
z)z3M|`$v<P#EOL>5@!8J*^<DvH0t@_ss@HqPoLPb2fPcuImKyl6i)n&(8OD8ybzYX
zHV{HtfE*+7gfJ%hjl6?uVpyshkq*AJf8pqLFn7rHCGgz*?w2?q3Qv_Sbo-bG|0fP2
z|AHm9ZBNzlqw;LWy(*t-dZ2l^3IlokN2)`xX^kh9>(+SvxBR9UmBsk_NoKo>sAn^Z
zN6NeU)cGJHF%EAD21<GwET_CG^ea(id!XB?i3$Psnd`IZ<x|<VDPH;y<>=k`EwRL!
zkUcTVFjW3AtB#(ZK|Lj*KVZKVc+`=VJg+GJ%>A+gmTj}c3MO4G<G~1T{wg#O%@BVx
z@EA%^b^qw^Hw=w$!knN$J()JnaIO5i&px|uJmobYS+Qp8et>C{7?rDM%-+vSeUtQ|
z;Mds4Uy~9R?hb^*0QENzzsUW+X2So3<?A<bVGaI8(T}`Xt^d_{hxmzq>t-G=@ZEnw
z`DTJ@aDSeEkoy}P+UFk>n?O9t{)4<)h!Ef((6B(N3;%-vC&)|izmVeW0!ad_t0gl&
z0of1}Cso7+2_qf)zl&an<8{<x$?53Z%FBHDaLK=$<Of03f&G*^aglr?p)}hSbNTrF
zJR^9>F`4lsZKnGG^8*V*V;Cwm@wlX}5UPgB`m*z(&F_@x{o3pTCnuBH3G!pNWW$C4
zC&nJS=~Q1A|IOq1{P_28qV9KK>zyQ3UU!VA8Pb}^{m;`p!XNB+>z*Y)mq`VtnB+Ww
zFf|S@>-BIweA4)oPlLPb{e<uJf#<%^4?ZBWKog&7a%%Dl(yss~NZmY3t=xSOSh80L
z%;(<_+dO9f-aCn9b|&AEByZ2R^pWb~?d!YIaiN@Ye(m8Sp>SW`l+*z<YlIMXnrfTJ
z92uC;Xtu8i%w0}qEz|P~_;7)KQg_`WB*f`W`VoM*9A{#$H_n=ONW09TU(ECB;rh7q
zBrWu?&f&L$Clb%cQQF<Er`jJ7!Uc4{P)-+@gOWGX(+mxjXU6DUIH?BI!~YI*&UEyN
zik{Dxjgt!#H)ia<^9VTLbup$I@37l=Z8P;!ySZt2VhLe!jh|yj?(=Lo=N87wV)N?|
z>3v0gdy3Ngs)iJjYIk`>yCXJda10su-Mh4xmkW`~<vQ+o#{7tmq2faH_GMG4LEHRE
zo^?o*@A2Xg`$?ty1e!vk9NV}k_{^fXYVX)M0m;RhP1u1qRvysZo;IxEp7P1EwX++n
z2OYBVdPAZf>)Y!U>u_aaZQwp#jOI0pxGO#NT(8l63w^MQkRuS_Mm{@!Ia`7;fxQJa
zS-m1@I|z{ID=hNYUHZH#*z0vSn@z6E>bu?QhwO;g{#|=lRV~)En=yTs_ygBqo_da{
zmRjF+ok;Ub@BsVQ-J4K0AGZklcY6Lssk#ob;!92O?I?|D(2Ld>SO?#X=1u=+6aTqV
zOP=B;W6znTj~*nt=aud5JttlKPB;J88F=PRC_e`iu$0B>N!`nb-QSOgq+wlJ-mw55
zt6KWtqe3-4(IOG{I$urJw7#e5&LF1EO{w?ZvZQ%1Eby>-S3nBc|A>G@-{w|evDPAx
zmM0@C&&+P&q-A0AWaQr)+`GR1wV^LiTdT_UaGKt?n7K2;eQi^{yIJXM+&ymqZwVog
zI(2X`XW|n7aniA}Q+;fC6UI>}G56Ml@1yu*!{g)6B)Xk%`-|ukKXc(@^R4u@EzaMS
zz5zXP3Lu5m*qN~WrQpo#c{#bo^u|Cyj_RfxTHnrH@Uo#Z=x}DV#9Qcwku3e8hjZHQ
zHk*RG--k3&KCLr;2l)if!TK^r1KejB=R-W^&Am(u%tr6|I<$QU&A=Nkg-2OBT%^4(
z%ytAY(Q|iP1w!9Q<BKp&eTZ*CIGAVlbAWLf0Oh8Q66c%5ujDur$EzTz;PIaqX@<q)
zNKA&T+?~<}Tbn%n<D?tCdxoQT+)jf1dv5mV=6=Se<It^rjk7t`1dmoQ?Z}+zozW8g
zO4fYLm&I{@RBS@{y)<DGMb$%bzEW)J3isbxr#xj}pb1yJ)=J<#CnvHhsirRN1U-Yj
z0P3#3jZw8H0n%oAZ#XeVfpI<4ejOgGm~O9mKcDW}BOf$%Is3JX0AJ&k#kY2uZs#SK
z*~+a>=y|*W=_MfbOA~CMnm+S*Z(t2>vh$LL93JXU@;wI?LwQ1d*GU$rWvGS6Vn<MS
zzkkor{jH&z6%t?45dy_p<7l7MvY9Fd$Z}q}0u4|x^VSg5NKPsm9BG^%=QbYLQMWkX
zqz)fWu2RL~d<>?<DD)TTw7Hd!uXe`DZE=cf_pk}QuxA-1evax&MADo2y#NZBQK!=1
z0?C^*r#F!ARmgu`Uphd-GdFR))F*nIBsg-pwK#VoXfFSxd8w)oGuOlu7gf&-JlDwg
z%1peHKvlcB=38IzHyse)Q7zU0g0(M!@@r1y-zr2~)}0JI83P;%(~&goeD6T_%w;D*
z%?$NKO{)Y{<_}G5O%#Lv@-*mXrZ6WQQ_*VrUcSxIRr~u-1ikxTrMX`-)&&;L-C4|;
zPUo`ZCpNF%@0Bj$D4W}DRJIO*jF@)P-s<{xwECP8xvb;dEG`}|N#@qj+NhBs%`BhV
z;8`;B*@^b-zk?x_eIklTfB!N^+qVq0_(~9cnRW6jsn5kQSux0VUMfXPJbt$Wx|Elt
zGFF{r5TW<3gSdk`LUb<HgAZd!CRjv9lKD-(e67|ACB)A>XKqWk0(~5)wRL^r=~8-|
z6gYZfzL@j1CQD~c6DXgPXmjNzPe{AhwslTt^S+-HcocUn%F}ur$Q3-_vVGXR?JAMi
zpz~673rUFM7|jd!qH=GZcTaO8n&wkYYzTaBVf($Ip!GIM68Erkpf#4Q)%s3zKS`o=
zF~&S^Il9;nQJxSHdC>$^*}8i1NQ6MH+jef4o{KKqroS|vHR)wRcr^>2^YFY{E#tTs
zW3)?Oj-hogbXaTM_dniYuF$<?d0D817IUSo^sr9gOG|f>rS|T;en+f)>9IpTQC9J8
zk6buuY{eOn_h<v7(dtZ6WXsxvk$!efstFT56&s0-spsx=+gkxj6{PKo+-)~0;TcoC
zf4`^~r^0{V>l`(qJhMEFrtGXD|C6h3zHF2yqsA8)%C+m}ozTQV!(JVTF?Pa!n=a}+
zKgM!f<_=Z6umGQIYR+sKT@;TqPjmQ%2e`pep*l>0>&A&`Pf&{C@nz@KZu$i*R?kuM
zvcE1;Q^ng^G`{>z3c?9}T*+mNlSjo_x}Pb@VMuf<Cmdz(77S&nt&Q`{z7WhT^gEX^
zGaO!hl8-o(%C+rQS1-}%R`xcJ2F<3+7fG%3uf{FF$3t6?V4D}Z4fCHvv@c|7@ZfxX
z$qHPB4&)X83Z4YTw#>oQCiT=OF!;>8g4HQpeh@{m$L9lN=%Dv@EwN=u>vAn@UmZ+{
zutS;-pDc*iL;m1uEZnmj+`NqPc9W-9=w7>&52Z`gY&5aiSvze);@PVrlf9j6MHtk~
zLQ_AQS*{!WLKq#|d~K;#GuO4%3~hgP#dy5w!Do8}CG^|fs$i_9Z+r3r>uVjtt<HlG
z>s<OFw7_q`{e(<2*ptJXIE~|?(K!?2CF?~>EsOrG<ye`fN1mkZF4UKe>638xHzHj^
zfwKlU-ElQ{ljzf*GKIp0uLUyp7L9GLvxSKcy2B4jeK@Ag+VXUgF^iWr906~32p<jP
zID!3NDGr8&zH4Qznt4x8T`!cnLvhP~L8$J8&Cv-4j1D&v#+b4FjdYCqvGUUv(&u3U
zS<4h9zSvT7976=5%U<jhj)*jG9|ov<BgPQwrDryP)VQdYfY~&cHqwSk-D73RK~LQ9
zSwa_Qq{5TGZz;-zbypvm;MRHttF+)%mTh~1;yTClAibIQ64~^W1^yo?WC{+xSM9#|
z=KOYmBAQa6nLUF={S|}g;x{<|vv%t8^2LKQ>*+iwfQB%Ud^N{qr~u#Z=O(&rt-NM^
zJWdp<AX_oqi^kSPl-C@{Q#|Rn@tzeL+9OtYo+Vi!QFK!qcjUEja5O>~d8$$2ZmCa%
zZhMaLqsk>*k;jwYyV0LO%UiTRd*Ge#rc?faO9K99p#ly<p1n+Fzxx=2h|tS<rl6k{
z7Pn|e+qu8QotHUo!506{t~7+WvhJ;N`Ifg}89z75*m#|1>sL4M8>KqQ()#Qm3cSSA
z8{ozSx%%mr1fv6?k=E0RO#L#T9HUIPv?k=YzJ7gDB$><bu=FaP>1!xCJD$HIr6M>2
zBv8l&e~|MgueBYVp@@^dP?-Vqo!TiL>u#ZL)_~EY?rX&;{_@Cl9VJgnvzMeuVrVlN
zR$YqS#kkdZ;kjB?>HT8vT-|L%`V}ai2H(%lm*i)LFu>QTExN)+?s~e@j~Ia;#voSu
zA~c`ID0uNenSdYd%gVWCyn=l7J-`jPCa>Fcn4XFgU6?;**J{*mBrU+)M!dOaQg<kN
zK<i*A*S=n1R39s%MRs9!;H~8I7wUR)-Pcj&3uYoCu*Q2VyAY`^#FgJ|wbdkZ{y6nh
z44Dnzuy%Fc)w~0F2UXb;snuqLbJVhIU+B^Py+j@X*~SdvHA^`Y?VBql_DBHx4o0op
zb~Cz6sZ_YS?}Y1>bSKvum5S#F>q}NB@ebkW<vc!@rUr6}|D7kU=)eNeSP~Wn<tf!m
zouwNuPjAEt!N}*6L>jvEK1i<<L?W2p`AgKIYE|P+QTT#>QrpU3AfG)`lI9!C*#$R{
zKxPj;&VjLzTOH*$wk7$>%~Ie#kq^z`lY%PiG;d{Sz(TwVsUQBL=$Kt}R^?%DSw-jp
z0_}NJ+fPa@kK7cz{$HC9mY*zKEA6z=&>dSz1TNU~ci-%WeY}f*c^IrD8;IfM&u&VZ
ztn~YXaostIzAxK~S*u6mWn^1#h_->M(cca>mcqOWo>aK@gF5B!FSG#;`?A+=7ACHs
z=(ZxOrpi3cQxz_;z>ZS84C&~-jUQ-MTIn$h?plFb#cju76(&{U0}&V*Y?42h<#XTQ
z2~si$$J$Wp_^}(Tl5Uu|_)|D07Oe8Lv@UfX>C?mH2aQ)hyfIS=v)}A_d2Y>q+IlCr
zwFg2gbb@X2pfc-mg-ii!m5W<R&BIGPx1sUf6%Q`c@#n8uN3@td2pa}!?fj+Rjyu=y
zfK5;==u$^G*66w9Y(t;nfYaA4-!n|?Y&1`ui7QJ(ycILuw|K6-RjpUke&zWQW^P^x
zqqe2aJicLV?pRDQsvIUhtT25Dq*`kbU-e!R%-F_sDU_IOGYy!x!p7roGonZGc~g#n
zUtrXlG?>Tpjla<}DWCh2*^Ks}cA)<X*xcm#ofl^^cdwRVJ8czhCD+ih{x^qIi0t;d
zVb{5seUZ(et(}_AhAjsLu9UJd>TB$98%3@Gr0AweC28jPN-%En#P#_YrC217*@?fm
zfEd0nSoLnqLIBext{<IL`r;TU(4tHXCHu$j3#gq94YikfkE?3t<iqn_XBR8{O|VuE
zznYztgbQEtQaIQ4!?XTsvEGhm2grCWY~^;2n2<}Ux1JH4A=7>vcW)E+uET5KB&Al<
z_=Ns&X1$WnDtrE}hym548R~a=RJewRB6cM1rm*O)2Y8Tj*d~qIukRSFazZ;erDTY2
zp&IMXi=AkuOtf92;_}toD(n)Wa(fum+xf~-hF~<T$|Lpa49pJuiM{u+qvvFm!8Zj$
z7Gnm42N#vWtF3m{XW-s>xG#$iwBxT&dX`w2M9(@h2bGK?-W3v(q}hyiGm;(Mt=^w+
zza+xM0X>fNS;!C<X{JQWerpvj!18{%z76hh&>3v;w7=tnuqBx;MQ=rDZ6R$l;sb0}
z6Gg2v63RSd38iwZ0Ds8{qlQ$*MKfh!X-{!#@z<?b!@2@O{vYsluX*dbQVfL!Y(ebt
zIo@fB?fSImeochgejGT)k+b&2pI*@J=*Z|UfzWP#1V+yF-e~XG-eP<L>(=X#1*r3s
zjOz<38!oM3@&$%qXo&<p_1$0CYL`T2uHTq{LMA~Dc-_i_c7)#gtpXRsf=1u^&kf5r
z;;3mdf;X&dnGj)~m={64U^0>_mp`Ksb8#Q=w>l_j^A^rE;$8YDtPZ>d;r?2!;-c}o
zfa({P60PNFGtbNZ?E$L^E7HEa&CxkWcPFl*t?clcqn0C3F&Vb<fxAib23~4_QP<x)
zRQRYsVb1#l>dX$)Um$Tq=2NNVV{(@#=rA`}74osfl7P3ClTI0nBALVHF;0n(zP1gr
zouh;<-L?M7Mad}oI46`+trJw<06Jj?VhsNhDO|oc($j*uqMcg#<|{N0j;n3BUc2V|
zGc%)9A?-rLN?EMrC5i;8;_O7gBx(}goTYYF7de+%ef&)zvaam?Xu$+1@V$Ylk9(D#
z=a0dDVyrGb5g%W|rgDDMd~WjsS;pP?>y37K+9V2B>6glj$fJ)s^o{&D2X}xJ^6i??
zX2a)^f};kdtKD4W!oeGhcwd(W^#ES;@Tmg5E}ej;spyZyvC21-vB~&b!%#vSnsjXi
zyB^FhqfNa0;T~OuS{I@l@5%g)6)_fPNiyGVSVn|%%JYkTn9lI*JY|A>&DXQOo|S7O
zv=N59mzXKXzPA)op7~XNafb%1?9xmJ!pc>J36HjRTb(QSQ5aFfIxgFdm+^S{(bX#P
zXIp6X)B~#Vquz{{Pw&P{EzWj9?IA3xIg(79IZkLsj_9}HJcJP!8a#;((rj%evY_u1
zXPSNl8bvFgqTl>kyB}E}W~G-O+aOL?*a|Nzvj!P)4DZ2_W^<PrOwj;T;XOYw!!vCw
z5&;7h_h<fZ37a*Dqc(5zWucT#sVgFm`LP+4rWpR#@bI~yMn+l{6cxG@^fJjZj?jcf
zDe_YyT9wLlY29{H*oikZyZrQ0SH&(EE4>S=T*2f=_N$}zL^*G2>a@It6ZaDan-$Ey
zr^R;Th`8UmkIJUdaKC^Mf}+fy^qai~7_mhOhWbAtMuo$zbImOwr@N5R3t~2iz8c)F
zIT7!UJ_K00+eou(XoqR&m@&ytlrqrqXnN9)P7}I@#&^WJ-FtMAp*0Xld&#zY32iCa
z&s#+%LX+g%Cmm@BJd6^+6$n?aVbbu5kZ;l+(-3(dJdRs1pJxEZGpQ&?*>SON4i`Aj
zdL^QUO!Q9|KP5*UH466$+_m1aq15vkLU}8#tP`=@&v4f;NI9}(3E~h{!XUNmxHfsF
z+a4_CJj8axnzTxZgSP2MudEA_l_gK|lg~ys18C;Y-HS;_v``E^f$`_$J|h0Pv@i|j
zd$f3pL6=-gdk!F>jnm>F#om6}iifmS7H&$zO!n>Xyt~E#yK~s>OzC=_JiGeaZ`<)!
zRG>LC8&^aiSTPt?IAy|D8B&)vfV$$qZyDOgp_^7Hyf$TV^pOBT+vsdz4543o3`4Un
zh&xdA0{VHGuG~n!f0?d~J3fUxPr{3<dEGl+%(JFv!w&e-SuvX(xD>f%^)}gJj%wAt
zfYOIn^C=01@6BneB?3aLwoCUmCO(i;je=_A99hI=2;p)N!<Y$jspZm&CjL4(S@gj-
zB_-E&Ab9(7#&<AK>9K3ABc07xamTT+#N~Ihn0T!-v;{{aRhHU0=%jbQBAefer;%!Q
zRG4}|#|Bs@Y7lFZ=2_h9TI{iLm0WDO;P}zcabeqKThCDmbisnl*UVLMJ5+Td%I^85
zN<mvJ;A!Dll()If2lf*2P5Yoi5IRxO61>2dtqYoIRfbbUtb7SjP-{5RHZy91_3b^m
zI3!Bg(}*}?BR~?*y|g6}GWDhFXDc-~<#m!8?*y)~1Z3`=c4F`)z9q7gg*vQ@z`X4F
zi*mc|PiGg_#Xd+5Lk3fxok7rQ{mrNQ-m+lSk@`EqifHZ47?YcbV~!Ab?7x9-3_MN5
z?N)C<vpDi>e&Iv)WaSeujP+!ff~&CYWT-rI9$X<cGB7t)ZPpCt+r)QCUw<_)`5x~}
zwF2Iw^GqcEHpQVPbqiJ+o}i0bUE5Iqmv+dw?x%ili<gz3Y{xE@k}Y!sFDnSb7f^PD
z&9G)!Ea3z^KOB3LCbGVAoRTgoBgj*6X*HxDhq(qbtW^w7sA!%@&8T{XjsJ+j7xOH(
zTmtd%;5yILh=Y?IFA{vL#X$;OvY)3@sRNqaM~2mwa&ft#HGN6YafA;D>JS&yI6Ww-
z7>_m4{J##}f`}KzQQrt>dwCCL@-8<jy>YaT+jY6w9XE31J;h9R0!AOTXbg-<ij$Cv
z(^W<~6~DSsos%S$ll=l`ENfrPR#^HwmwH#PcVgkH6Lu{$g9@^t<jcr{@+Rn28UbMu
zE6M?6M-VhT{I%tydG{u#+#lnlhtnI2+SgwCVT!Nqg0&$S7LjE%O^6cbjGA7tsYa+l
zc~@aH4?@Gpe;b8L_}2NUPblS?MyQG6w7D8f7c#UbD)O~f2%=}PMvET%Q520bbj8b%
z;1&W#5&VkJqmr_<p%_aOhD$Ccz`~Au&RJgMDXMVdjm0L%^?|LJ=QJDH5L$H_6A|G6
ziY}=jUxX^2bOVKfhv`>$0ew`SWZBZ}%t!`d#kZMUD#U<Q-?y@f$QJWD(XsRf>uekT
zRzz(|>xcG&HY#s4v(2oBesHYq6F9@GW?7Hvx}o@v(-^cw0cX$#;!syCkf$2-x!X2_
zn_pX*puC=q-aDMJJiL5mY?`(-kQ7G<huY2ZYC?~?F_6HbTf^PKJF1NoYpY9X0nz!|
z_P(~f>vxdDxpzn1pqcmCJl~4f8F9d{?`9?jDZbc#7ye+Um5BWIq%FUI$f)BM-K6mZ
z*?!((ErRfGHeVtY)_u+!062bDaYFKQ+$sL+H6^K(oe$UEpH_X#J0#aS<F8mid3t{x
z&}XbIf(^XXH#!T2!8b%c59ja+!n()<m)u9cF<@E`y`fn>-*m8;h5a=5;_*d<?!nSa
z<+|piz-nUriakB;Z^|LdkF}Gcfj$AF`BEA_%MC5*pL>ikis}O#jZvto4j?%lvtJ;?
z`r;r=UL^3F_%~vQqpbANGd0yPi6CbwwVMg5l%61=7XDdJdYNWj!(=T7xh=Qw2$57Q
z5HxxRUe~lIkT%4L*Sd2^rH7EvYdDt3a9e7+vxPJH!lNQgwKkaOACVFk3Gdb*#3$+v
zUoRg=T~?XhYij_*q7S=R`oozmPg{K=emK;@dn3Qn-<vc~Q~Wi#n_xRf>|ex2$6i0P
zLa8@wdrzCYkESGH!P4%_mppoWrc|ALsM5N}Qlq5B^}Z21tNc|(S$Y+|tR1c^Ct%e1
zYqKx%b+N{~`QYd(IS*HIH;}2nVe0~(_9y=ntBTI8PJ<y}ebtFbCz*s60aIW&hDmY>
zcgnp$xmlVvPqC@`8ATn8q{<Y9zW6X}IcX`Zj6LJ(dYQAiu7kf?j-zaFZuQLA_Nz4|
zY6qwG@;FvACu&fP6ICsR@s{)Kf!?4C^Nd@6G6yS#vYh*tX?jys>72EkiLqA=?nS?F
zv+<JdTn8OMFY6-I;gq1Gk6%rnCDVFIZ6I#byL?dSUN$OA$MP^+x3TG2=5v-L`J941
zSJhJcX(;3)ysd(4@@Ue3u>jTm;9l`-Nb%P}m2Zke0uZ)zI%y}iQns*e85XjkR-(IU
z^Np;i3Cf=8)LTs>kzxrGPkgloq)0udqvaK6BTjlifW}%WN!l5T>V1WUYu(@2IO|Fk
ze`YF&f*Wj#osz%vrI@FbMQK%ytPBmyBVxfaN@;YX;@LD<aQgw`z-M*It{Q$d+_Of?
zu#Wz}LTGm@@G5+bw<aE5@(6wvqr*Trn0u)SZOYTTwexgw0nf_(y3(JGlV#aA)7q@n
za%_NhYHjw&BJuErM51*0#)^6N(d6gy;#DV>uPOqXX-I9R({9%EY*GlPf~IEPLgAr2
z?GIz}d}j!!CJXIBu1snJN}(Gsh~LkDLTDzGddALr{Qgxn2(L2(PpvXpE%M3fS;SP8
zN&r6@Q~$b%LI3S6x4)lggH`35&!65D!>tD(q%0*bJ#{ElFQgOCxLhwJV!i|d%)BCg
zok39@EuS5k3*|%Ag3*iyVYLq_E2!$v4AE0GHA%#a$+t|zly^%$#K40Eq!$E{P=fci
zbL%I0JdLLmg{M|iui{8zh*8+cXxO|x|80ATn4_YciGb-hq`PS%EoKv{^_#@55SlcA
z-Q=xr9a)r5I=pn~Mh9Etx5l;OSUOi!5|D+D<7T0k<2}}Tn$dN@jLZFICd`$GGmw@e
zGBo+;oYn<j@b(ctl!H8W;(2{uQoRu_^w0dgKNxzZCUL>Bc#PNYNyDwIs;sAR^V^<~
z#e(HKTei<7U*{YGari@QYiny1UX8YZSEE3XK!|VcBxClXtFbQEndPg_QnBgk607Yp
zF{(jYcB)OQs)W+bx-(g$4jtWFn{T3Tud@J8w${SP>}}@qcIXqx#rGF5!T8E`w;C${
z_otS%XYwo3N}{K+XBrM(aZU8Fd-wD1Z(GiD#n>L6j(4X_ANF;otbxO4>G#(_?@4=!
zdS+jg0$FZkfyH*(Cl4F1izLC&iQ3AQMs=07yFK=+j_uW21u7xaKjfTLl4+AW)k5h8
zad)UtmTn=7nQoup&#LT23$P@MD-Uzm)D;fRJPux_KiK8Fq_8Yc6L*e%BS|&tChcSv
zSGr6-rU3q33cTi*S&lsgEA0m0!Y*=gqs!vs@#E0~t8(t_(Zsr_tHgH1tDQmfGSWDD
z!_1qS&-^7}6|=H?E&slo`*7JdW_6aMfXPa`uGdb6^J!PZxO(Ljek$$#XOlSIMUzE8
zQw+~TMrEAM#5`6b!-_>S1)i^CMeP=TQ}B^2puCnJ?XKN$jWvW1J5dEV{HKItCV2Vt
zTXPrpA-6@0<gV(Tf}3vB_#WwC!eqkr{)oqo37;oxHvU~cKaK+7M*P3>;6GmZk9Yp#
zo&R{_KmIGl+>?I%-=2Ip3MgJP*-=!nb|e2vr~lYyBpdkKaQLs`@Sni$KX#fSjJ*E&
z_}@wYcKzD}w$nmkFhR1}<X_qPA2<ESE&p-Lf86{Zw_3oO@bMTgw>vxIzzR7o?ZQqc
zdNISFt?e^C@hI5g@DwXCM=M~3wX(t!+yZ1G^FcC4)Sh@)=-|(No<+}=1`GvI&A~*B
zn49ON=VC(ojnsdhWNjOUpHFA64F_z7Zt`sfZ*u=S=N^aWmNil6s7EU2!ky5bx1Bc~
zrk~licOM9$qIJ_hUB)<m)$$j-SRam@?r?i6&suw4?9>X;fw{EXo#I5j2ifv#TLYcG
zclWVPtq!WrYzuuxGKkXY*qI8z?K1`Yy+|y=X3K}E#rU1>5Zn7eT0i1Y22uJTGSc0i
zr%$_(4lx!9UhKSm{dAfh{)F68WZ>=8avz}GS7b9;JXh3sw^4NOiD>K{EF>dP&uJsk
zc{37RkIF~-dLnph|77-1zVx)P1gwEn*qEJ<eCt@%-*0yb+uWUhqfCAL#$KvA!dVi2
zLVy3<50lC>7|VpT7A0ql(>uu~ONIh*X@lFRewS?uu~v($<yUakcOTQm*r-v@ttWP5
zZZ30H<q2)9BcE>Ppti%iv0z%8bW&NZGKtF`t={815$n*dY4#htcOI<E8u)bVyVioT
z6W}kn*T;vt+2!Z^Qo!QMUo5P!vHU%9Hv!RRu?0Cf&k(%eASviQyVHAtdA(@P2HTk`
z8=5oOf?0OVDPO7?Clm#DslV_GWMHnu1UJgY2y0OU3e37Oqe~4te}Cv;L6IYTPTCdk
zACZj#Ha1SuA*4ziy_vEZIADzzQ3TSX8|3;tvhI*KbA>Q@Wxgz0rSAiIAKR7f;eXFU
z`)2?w{B^vWLkKL5n?ycD8%*SN5Q-99J#nmm`VSf>Xo5I^(gGKGkCxr>VUuBMU+o*p
zl+-s5O793;Qk-#xp3tkJ-uFG6D#!|oJI)+qEZj>@UarlJzTIc!Js|6oSI5N%6cJbS
zrI5t)eo#%DFce-d{PtZ>sjG#@pSV2ch2M04c)kO{5<UdjZeWNJh_K}l_1V+;Z9N<I
z$arad!$h3ZQ;`tA*+fNu8?@cA)2LHIV0|=o88RuUzc})S7(Z#+68i|*LU3t$HL<V>
z@>uDpeV=x4&`Vfoy$6hMVPF$Do1@)AKm%kL69&&UB-m{e#gNkQcyVx^v-CAiZ}@h+
zd@s0D(CZ9-A_AmXmG1o>#sSPnc$eGe8vSYT8E7#)lknK|!%BIGL-4~j3WTL=zHnw~
zce+v5F;^9s0xLo`2I(%Y6ZrQ26{sjmpZ8epR{(9sY!EIX5#UQejHMXO<0i^pBD<x=
zoU@mf;DX$a=T`Dll+O?SjJo3o@OH4}h>ifD{7vXK$4~mb9SF)pMb5+YUYw6!!xTl}
zM+6}*x5#6&-WJk{=J->)VM@SKg{0)$%k~?@kV^mdh=K2@oU`GGI!&{lxFQg2;S^$T
zJSHcgqlA6L2I?qsZ~`}>Becm0px3V(*({kAzJEJ~q#FQfG^gUQ$i96+f>>Jcw@V&D
zKIzTq@w<O=IPH03&>GmqYd{VlcCa~l68~#~`@<Kw&_kr7Ht7~aJnXbf(aqIo1qZH{
zLpQs9vOCp!8q&?e+9Ntg2ImPqbf_1fahi;Td;O#d2k7!N<(C=L89w#Pd>|yAt{j7w
zgQ+oOWk1L^il2}pY%o}06b88B{nKY;bK)$)=HWfb_TrR{EvJPPi+bC04iF6}YCaP;
zea}o9_3W@LzCf-(gIL3}aQD|Hf}4T}_(Zx%H|nZ~CUGQkZ1$u07<{NU;u}JcF&pDM
z@330P9sp?2pMQHI${wMFL&<Jte^;&Ho2GG^*^P>OVR+{pMlVjO8w~D$6l$w>x)X$R
zA7IvZ@}j_HA_@@<Fv8H091)LPgx_0EUz0l;<k?|k;j*uH`e`XEgiDTs+F^##V@b1l
z4aR`#LFVJc%8SBo6EBeLgpMJTe-NY^f&I(!2k`8}*H77K&E15k{=;H)Hi3H-6fSfJ
z4Np4|%7Ss8SbK->sulkL>X8r~;aKxW%%`z>=V6K6&2bUm3l$%*{r2al(JR)#R!G9j
zYd2%yQ~7RA56af4VBtAZA!0aZ%&t+j4+YcC5|{tE&Tib7xSCn$;0LCk4Z)&PQN=i0
zpMh>%N7F)r5lYnJEHRjseepRvRc^N_s6mF@Vvj2g9=QDqgyJ8#=d_tHyl%MJkXUxc
zt#J8+$nVxCsgCntwFK<BgX__16dixstuohD%d?B?Uxxy@#sw7#z*yy+rN5uysknsu
z9drYN@E=QnpPPVHY{;>8Ju#nY=Wx_8EZ}J(mQyuZtqaOFWEpjgg&@3YPNSt?Amn_7
zd`U`wm-XwyLn{1Mkmm(W_p$&=u_^!ikyO%iF+ctc0NPV}%`oq`m)PR7XZ%xM;62}H
zf%(^v=edPntlrHTM#1aP@c+O~#N;Sz1-Z}vvfwsHbR)?synE4V`AXe>6y|6i46Irn
zg;NTRn8V1f-;bklTo14=!mQB^4dq)|u-}sY=n%4I>1y}6#ZBb2mX=@NO?FS6VmXoN
z4RAS{yKFd&c}WryyX*_<68T2TDZ!=be9-mGnC-n%)Z9Ue>*C0OMY96NG2ObTW;WN&
zK}jMtA@7lM;1x-91#*+l-P~Nc0MO4Y<{l!F-UWsXKvQhXa;s49@O_-G9IQnaiD32$
zd)uEayWt?um$yl3ibd>^s|G>`WMnmvEno-^m%|#7M3d*fi8is?UG^FWi$b}AOQ7dz
z&R<V0>$x<wh*xtv#vUR)NCk5y^Gz9zpxdtq^QhtKOn>UdfsRwJ<f-Xm1~_e~>O@jd
z=_@jgwb=B^imuH~A@cSHx@xvpmk_1x7}m_NKL55ERc~sMqrY2i%(bB(7+N+KAL2Ll
zjR^OUc#EL?+McAcrmaTezqRvq&n>9-nz(U68qfRAXMWQ>C-GX+25zIl12gdhyt~aw
z*c}=f``OGxyg1;^HT;pz6^M(Yv^LU^74oZF3$j@sYVNtt#AA*9nl$IuydJ#;?Kyy<
z5oA!0bE}P8wT>2)1^-1Oe0UK$?vDy_S@<g9?sR0il<tqSt}l%jn_;*B6<!+?T4K8~
zys4MP_e`F}AymXUWPe@8ntD{~u?R1EMvh0tH>8w-M(v#-UR6epCV)}r<S2j8+~JG5
z3(WVZ?(T?gBjaY?4`qRcu>^&|vpWu|UMec%u&5uEda&t9w0i{zoQjV~8K{xp5Irb8
z!KwWq?5NQxCZP%LO+aN!Sm!0#7Lta018K0xy5oFe@~eRbG20#YK}X1?bL@KgQH46i
zTB&um(`IBys5gdWfdH|r5xWh*ZQA^Q08&7$zXk{rSee;D=dS7dfs(u(tUt(JrqE@}
zIh;)rM|2n|2H7-?XNhQ{gmvv`1tA60J`nefhysj_<7f$kGmG=?-ay1$dw1Rz7wbIT
z$R(xn;W4jJlG6#f53yF`+#x5NBD6c7JGKi_H;{7?I+kN6S`8~TTLd<Li=t+t*bHN>
zD4`?|vMfi{kbeSyVJQ*SLH3VxR5m{Mb%fbh7&zktotIj`Mu$2wHjId1QFIxJ_*akZ
z^|GTQ+ubsIJstiD#yU;Sr587i_iS?TZX3$259%S$ok>d$BvLO{NXh|}q;=qDusKj>
zztv%HcIqg4fBEA3A1~2=RFHU$cr~>N0yJC|qr|(U`0PP!nmZ<_wZH!I@93fW^_Txp
z@qsdWxRNDB=QJy3)-qNuX~*-TRH0HTmm*j3mPg7bP}y!7Nq0+cC<;*O0WsJ1lV0RY
z?afy_K>roa`6oA6MoBaWhOngM)v<Hcld|6`>oMukjqyi^{H|Jmd5jj0<xX$2T#o00
zXD4%-IIwZ)qx%}3qH{L$$xOLjT~_NgSsHj^I1Ws?dC97i5=!}by<4%8niudV3ufrI
zMZpaH&OU+}uv3{1+ZPGh{jSt^*Y8Puci4WpohY0~zm)%^KagmGec&L!H{p6H?u6@a
zak;RcrFau#ajye^ks}^yCv*J`+9I+64cfAG7oHGNyo_vP4LT*_WpdR{yo-Rzq79JT
zAQ)O5f<Wj}{Qhl{GN6RX=@O%2@%VgYESzv=E=bPM{CN?&@P{avV;TTR;SmVpsAKB;
z3B*MgtAv9{L!p=~G-?ZbaZ+@ZTL-T^ef8-`Ha9ABw+&E#8H-)7`N!gX7>A+5M``BV
zbLvt^QWrSeLEp}<k8UUw*~Aw~UR2ybXx1Evl$ZgEhGYa4b+FB1a_=`I*})r#<AY?=
z9=6opDE<Yof<NBpyDsY$LkXXUa&PzW=F4pFpG=iwQN)v$8)FCC9xe9j{KaPUF=C&9
z$^y~i6Du-*raFpAz#C}k6u-tg%bznI2$P+%uBCM)&JHV1_MUj5`fHTRZ68Qk{Qd6s
zc<jCT{rEBK@-%UDrTq@H#U%`4<Dmm%KYY)id`@!TAuh}b@5m+jqY@t<C81F)K%y|L
z_@^3Z&A`2`Qsr3P(yyY*jI171W_S_q0~p<s5(r#>Bo|0q6mJlvi5)uSO?&AwmR(H8
zy5(4FY;(mHwsDiJ4YK$a9dM=zXQ|^&uT9T1B3vcvNyV)j*|_xv^o+hxPi6DLRfw9_
zyYJrvQ@ApYQN}#M$pclM{rD%eBOIH{8`pD9m>6nPC>ks<naT2;6G~pBURjKwgo+@v
z$*9DC*E=@PU9F^X!3a(<$3C<$Y2r8vn5Gu&m6)Q|ZE7gFfG5tC>-$Qqi5#G*Z=q}w
z_`m-0KV!oSf{!4mOs5X|@=tWS8>ovUJ7?@K%7B){=NfPlmN%M&5zi(jS8Qnd5lw{j
zcaB6M(@hl6G)UJZTiY~bgB<28NacgPSlx<$J(1)>!ejYT!X`ys4B>jhEg)(ALa4P2
zfsACdw4EkyV&me%;Fw3)#{7qK-lWI$4z6pHHsJ9|gFmC4Qarq-qctnz_g?(f?%F!8
zGj1%=8c03bzWdjT)))l3)8cY?iLr}mBO7}t^F#^<zoBFnU<~8@`#DKDrQ4?Ph(;iP
z9j5>zqIoB24y1lkDme>}k>gEIotuSc`eq!!Wq}_7g9h2~6YxsX9ZA)qpUGhqhEB8y
ze4DQ@Z#nl9cArgk7t9M}_+w0uBfYqCAr5BXu&9&yJF$|t@UO=rw%tDqxuAxNAmXC;
zY1C}aUH|HJ5=2U<H$bTQJqM|i7rHus>ad+nbP#_1<-arvLMrj7-K*u3?GroOI`X~E
zgsw61ROl<?c!JWH?UDxqB|e<h9l#?MPeT-xqi2z1k&=i?qT<4FtQiWo70yBw#)gx-
zDKj}O!=JKC1yt_MNgBuOXEMG0uUcN@_6RgIN(K<|Yns|T2p6-!3$8E-z`#a-Fks$@
z;38qo2|f=de{rlhN#n+_gW?^*&|bh%ec=kiLuhn6nF16X0_YYhEOaGO6jb8L8R#a!
z-PL1cy=MqEf+w)KxIKU?WY;N_yg$}-V=Zuil7;#;tUqh%+QiKp#(0k0%X2?E6euN#
zdcys|Y60%wpIENP*7#39KL`hZ6uNpen@AGqZxNG#gKu!Fo)Na4ag0(Qg}|#wwB#k%
zhgGHoaV@I>e{tALK!ImSq5Dv%aOM&s<i-EfHBgcYn>PVr_S`|6rtv;dfIrA#BO}cW
zF)5iBUy2%r)4XanbW6|znn_H{V>5~E2P%8sGvWJ_O!_ff9EfM}7w7PQvHFe&f&qm5
zS<`qm%{pijgAIX_kktcblXe_BS7vA{w>eroR8Qm^Cn-JpXk5=6^4k<Y5gm0R)B=z`
zO@{%x73$_4j&64eEeIV|aCp_eg0bO_D?dCQT{BvEZhXw+I_LkK{M7n+*HITd_h*^y
zzXMaqLu?!Mj=tVVu)FtvgT5A2ZQE6wIfL$%obxxY-al6w*w#C@c!z_duVHhFuGkuH
zbAi7SNw@V1!qZf|m0oI<!j)4u%X>sBeKv(#Q{6AAwd!pk%+$q!7Tu@Cw_=_T8YdQr
zPHQO0)z<<qvW#TEGTcv01_WS;NIk<$3<bP<VVRs5y;WhbyqbA`w;3Zta^Jmrp<X8A
zwQ@a!21l&hU(U&y#o~pEnFJ0KCAl&h@>O3cr2MVveF8uqG{xYj65>qV5Dm}RF#?In
znI?V-JFa+K1?Fv)VTN~au)Of9(eUW&cPa31@i~sNl3el6hSE^*q$3$e#(qKvq*cva
zIp|l$|3+o_-w-2zAEJPQwvmz90f{rxc!vCyOC1{g)WYoO6nQp(q$+nq|6fEGwuD|7
zXuCQ-(HzfDRC8l}Xx;jT7RBLlx;LvC9Ni}$grZKmWQRhkluWRe|D*7?<CZ2ts=SFh
z7U+y=UvGnXiLL}5-?XcDpwk3?T@!1U=;+`6&ja2`B{$N41+4JDGU+eM&_vKLNU6VD
z(~*+2kuTyr|5V>${<%61TkgnzNo(>p@L%3wMvxyL*3$gO*QM-PDaRfE;FP(H4vXFu
zi)G`^%2fgs+vO@bEYhKoziN?IApLcAIRvsi>9nsBM_??I{yMu!e`O~o-k#9Wze%;p
zyy$ogo_TqH<AjzQt%cs-_Z3=@zSVZ~A60Z?q(TgX)4;NpVOsDawdMQsz($+8>!(;J
zkrPW}`Z{^>*qt(y8h5j^`cpEiG}bY-c5!qh;>PIL(8UqPj2L5ji<vobRLV7G!6vPV
zr<xbOxQD6UyMQL#m;R|UU&OboPC;@8YR{ksW=NlZ(7O@i?U;*&V{&`q`R7Gxje8P&
z+m42}<qTkrQAI|LjOAX@L9aG0^r|5=BJWQycVmjT6`3QiiyL<FoT(1ajqhGQdqISL
z@$%h!iK)HCfovX3&<QDK+E#@`9Djx$FB<{iuR?P%<C-Wc=hMCN5zE)*>{vgz=GfjX
z9m@iLG+G=Ev^JKB8M)S4y_5ur-Z#>^9uyP@WB%ltDzjH^#vB9NWACeoj4~4@c4Ez3
z&xU?P-IR#f>PRBCx<%aMLh__e1&54-Yw;w?)vf-fFyV}isO3HQRtil{yevr^m*N<i
zDJHNIy3uX3Z0MkNxD3d%u!%CWqshOU7eAzb;#u!VYe?MSn1rA>AUW6JzgT%8Cdi%Q
zdw-A;nNCfTz(Dut(ib=na$*>_5+fJ;@G0uQNFR4b{TJT|FwB2``GcS)!$_kk3wGO(
z(c_DMFv37iUr@P5QM)PT9N5)~fx6#?(GgK$C82_I)a5f=8ML5;$4D4u{FJMa((WmL
zSL43Hm&n!V=7sKbl9YXnEK{k3bXOxZc<9U=pNbUec(3GYA{{3U_)SE~rtzJwbEKe#
zEHfLHkig04OEgVcqz?ENWfi#inH`I@gCr&nCG`|_^q4PNrFqYnh_ytqaelO%{DpEc
z;V%LG5i<_qFE0P>M10le!uUO1wNF=nt>CI{w?Kmb>4ucf8&UD6jZ0ckPz5^$`roLC
zN9?z_dmtsGtV24DC3<N{w+8hV)Yz9>t}|IDKmRP+g#u`7YQ8v%4z@1v?@;Tz%7RbQ
z*^_j3AktZ0$l8uJ>MW9iwpFiUDCp|D$y1in+)&${RBS7Jffpov(lp*Bhzg2-<F8n%
z8jMlEMP%0?2{0oJkvsW2CFQYALu%eeobr@3_w$Ulribg#992>wbf%tjgV_xva7xOD
zwqRABf5yBvjWaL#7#1g*|F8eV`o@B<WYzFmu&=1l=-o5cRl0$RMT85j77?FerW+=W
zmY7wgQ^FzZ(#jLhz2bCk*qX_I)No7B&G4fnV}l1TT#VwVK)n6_tn2Uj4pml83PE3U
zRoFW>ChRdhImcWr9gm_yPx&gvL34e}TiTBC2PXuLs)1_BCo?1^>%C`w0`&|j_d_s8
zmql8?`=n_+n+N_CpULEB&L~jhOv;LqmPXLJDQ2kYrO8T}EF#RcKVN)*!nFXc5tm~%
zoonL6*A7>d$Zo}Gb0uYG5>qvuxzjXWBgGWFN@iQ5+wqFic@ht6v<#=FMFqm=QOf+%
zMVPBrK?aEKa8qK%Ry=DO*2eTOr;$^qbcULvSXF}oVNgO}%t8~>z?8yE`yg`yHI$9P
zsRpJsQ=S_$r6eWJafM}n)YgHK+UJWfMlLO7r+JQHyi~IATA_2b#5zc@*oe6eqsgT0
z2-a<Y@XNBRjp3UTSGcS*xx!0*qPMMSP}S%e7q?dcfehfJ@Fq-S;W`X{odFovNP>8H
zS4+|}DieD-bXm{|_TUlpgejcc+rW1&;SkEE7MgS<2xi+v4<dAb-ADw3ikA|OW1z8(
zkUo?n>&9zYwm1+91W>79NGAk_j9r542;s<Go3{xrJ08Z2-@TD$%CH*=n}eg`gb^8k
zl3K&YF&v~1Xv*1!_Mytx5Q>#{s|w7@L?2Q@L^<|ECL)iXobR}_U}~&DHU?nk8T0ym
zl>rRXXkhZaBpT#@O6~JF*-7XH118xtF2h^G%f}lbhW9ES4zu`eT<V%Y)8knfT+>Fm
zu^hV1C<o=*VVfUkG7-prk^@Tj1y71DWpNqm?w60K)ou;B5NMSazjiBQ^25_a+$waM
zw6l&wwuroMKG$}b<i(SHS_1^*1?}@nw5T6sjW7RV%3Sh)PezQ&#{Qc#V&n#z0Xu%5
z+}7FpZ3`zPMH3|tt}T#CMHJ7Jl}%O!Cb&=n%oL1*hAucKyi!D5imsFtnln>2Q!W6A
zIt8f%E;3z;AsGN)?dYt^!hfEysN~up>R^ozsc<YO2?-ZezAqyNtJEOr4KJk3TAUQB
zOH<c!Q7H|7f)tJix6yHe5&~PsVF6`JU!q_<9Kvd#BSM^OeKHO{s_-2g1O*@}*;NOD
zW^v>|-NafF(1wdjwyrBg6)lYx18*RG^+s3T)>|Qou}Y=m+omLhh$+ouM!K@1!prWk
z6;PY@5_H*UYsi*VCGF*fqdiGW#X4yds3J-|EDt4rU;rp0YY_<@jX08KW|N#~4;C#d
z|MAIr@+5cEFL#uMxc{T7II&uGS2cbgaDA^pOsKkeqg&9+Z_p^`Qsp@V$6(ME!iov9
zaaHD7E6H3Fiw#3$8zQ-8=}$u!&Ynl`hDP+)rQ>|Y;m?;|>>@rs7Q%2iPz57ue1|%d
zI4`h&%(=Qv$i({>)ON8UK@(Vgb1LgH9l0@C#_5DobZb>(7|k3E34~;cu<i#ID{HJ&
z7ml2{i?v-CD=czQE>dOAbc0Rfn`L62qnT#<^b^pbNoe|@<wu!oO;;RPWXH*CNPaAz
zEbfuUYscFfUO?uk^B-*33UfD>nkU;Gp?t`Hlud*}sX3yT7wX%_g2<8zAZ;uWvmZ|X
z$S-!R(gkZNlLRUj0|u$lBm<pBw>o0oD=c!ET)}VbFRxOM62*~hB-3he5``Nr*C#<0
zb@`7!>$u_ed4UlQVT23WyffmIY;NDa`qRr7=XwYt%Cy!4i`0JvzDTUc@|VB`+HPQf
z&Hw!OKi#bSumkanrrSDR;=IpapbW|1zk2(J*DueF75iRx>{|v<LT-H$PM?I+l18yy
z`LT`VH5lgYuS+a#G>1-ZQSPv*1_`^3lL}`V$8F|#9y{k;(#ch%wSS9VEY#@|7<?|d
zvgGfut`fSk9X6!}>k!~M1Y_w)z-GpO1miz3C!XvMPik{&a8fF2lT>)(N}Lg8R#IIZ
z?cY%qh`)thw)CkyaU(6<7LnXIag3?yhCoXOMwST8h>H92#+<tXCluEtpsX>hb<F;K
zBqO1vQY|XZ%slp-_}5?lXT(+@WdxF<=l$)EFP^;<W%Ht~(EON`)M^-W{+ktlEN;=7
zgM$ESQwaYp{tcI9sij(!sH3uVg3<viY-Sq4neEJjv(SMJdIfijhBJ)Tv6}OU&Vf&v
zN`5A5SE|HVrb0628<5jJ?X3aAJH=W=l)Z}q4d_YL35hzyO$B5`iZ0n#u0W%(S3==J
z=QMercLb&IssKCM$8@=7G9>hWaMEOoq+lYR2(hG}mj!}x`h1yY|NR54#k<T}7`R62
zv~9jGS*FbknuwjL^q|Un&lebW^9||ko0s~=FP3LUl3LL)l+9^MCUQ(eJ1HW@h$P|d
zOG049Y74`8jp(Y#o))f@b@A-QyA$OV#mPk~Zi#aDv+<pKU&VrCupNPa=LGLyxK7Zw
z@IjhQa*X9)SVAncMks3DQLgF5JFOz+Hv^ja+1EknUa3=l!7ZxP@PglGK7j_()`ZP$
ze5ghvWg>a$N<i%w4)9bCU79X^cIinAFH#D9X0?w+Cg&t9OtFu3TyL(?CycHdNi8#-
z6>p)`A2#Y#TY3`Pmzq9*h@9uCOqSH}^^>CT*NNy!5jLtCq8Vk%BJApP>kx{!n3(0)
zu4%kQpELA`N&w5jRKtm)gwT%&w>de&0)179NB2#}CS7cJe90kuw;lL13zmAzlR)7+
z*Xpf}I#+d!O(a}{s`N~ii`GJa7A<HcUKl@0P$Cj4tUsY}y$aZW+iNAMC&>*;xJOIL
ziiaWET^gQ?q+ZquwI)F_JQCtw39h7)u{KH)+l4ZE)6kSu>P5m<;24odB2)a^^``+!
zF3WfW8$>Jz=jGdM7rF#{87B9pI4Q8ZFHWRxW4VYIFsc1W(O-f<DPx9~PLH|}B+|CA
zGJ^8fV{WW?=e9+E(0`fkf;u~MOZHYg-*xLjDx@X|M%0(5?II0CIqGG4A;6&g*^^o!
z+|<B-%<zgf_5FUGG>u#zgnchwiQy}kl%B;2u6L&psrrfU;;xwE0{2!P7-hRd5p>sy
zmmCehY+j@|cxAJ@UWtDwxE+K;%}XR|BL=0+yE~HkUJ?0!Q6N3F5h+pNL&N4p*BcFg
zKQT~5JdrPDB=mRi@<=>Q!qq{PIf1XK)cEBT5{_TsZz?r`G9ITI@J=~Z@hX7-Dl3mh
z(Ls>|gK>{DNI7JHJVVvU$2vyrf6~Z*#|er~Ba5M9951|Ogtd$!cY@Xf{}xLhO+d*4
z-7cVL@C1{8OZgv6YsM+87{$;~s)Na4SY+o{**`jW6@yWgrWiQ}DE1Uk)ihrDDxB4K
zIHnwv-c=TBl0lZFXf_gORGJANZN8cy3#~Xy&J#o-<DU(ldeeA8DzF;=>Qu97ti~}V
z$(c6(1;d>gWyuL64isjuAQ}ad=p{w;Mv5gk=cKHE=a_rX6L2F2ab2$<MdXTBaBAn7
z_}*#g{B;RxIwC*avt!E!@VyRJ(W8_@FYxuC3kCBPC|Ir*pDpCtd4zQeN!7Pk)%y*<
z?23~QzM>ei)X|3@Yrh)Z$`Zr?gs0q(=H2dgM5X2k_mYbva-<ujo5#krNi&(7R3b52
zhU%Puses57%PUzil{*QPi5<jECdmZO3Lc-t0m(Hi;b4e(>-@GURW^y~Xz2)sLqQ|R
zJPbE(kR$!d!Q2!#;Nol%D8T5vV>C{x)F~cjcIm`pRT;z$bT`t7iHeHcFu)|I90{({
zqjwpg+FQbLHdi(PxjrM1maUn}U5RI9QpCxB@bvD_m*0K=_T96~??kppL_tWBttp^_
zi6gZQ_VZE^^hv?QWaQz%K!`n1GWT`1Xlf8%nZEnkQ9J<?nckSU6DRvlj66qeP*Zuc
z2~q&48U!Bg!;g-$ShG2%fw0PN-Jn?8$<nux37HJ8he@!G&1!-Eeh~(EK}f8&2rT%2
z9LI?)K)0jVpk(W{5d|-^_hci`5H?sw6vn~ccv;_N_7?T6Go9fk2<CIF-fJf(0IMHP
z&}RM7N4mhE&_@9B{&a}|+&b8K{hnSgq+25uC1`QG(M@3sV7)&K#z{E@=Ui(VaF7!N
zsWVc?BqC9R!qpLGl5rT)$Z+`52~qNYvoZgi#hQt8<@&y=<m+Rmnoh3bi=4a$Sd9Q_
z_Z9O9VqXz-jpuEaoWy8GZY>tk_!5vY$l5Lp;W1Y3$&?_3R_`ZtrF(yCu9?VpM|~w#
zr<EyMIcpUI(hNi$X{LUSC;Aw!31Y06l;N+q8$cE&X@^Is^EfoN0`Fp$h?xa{G>}!_
zRhsnfizYX0uzKr>%o>8GbP&Ow%qLIglj7rlVDm{?W%NhN%uVGoP>3g?8Q!wIMT|`6
zgju1x&@{YHHSKp+)3IWe)Q-S7*cnGIYLw*+3K;Ms5a1>bi9M*7%{f0wg~cu-l6#5E
zCU%%?FUtM3l7}26{1}B6H5JW&nvX#tnwg6T^}P_0rkL9)I|V17CpU2#3BlB2u{&*_
z>C-I25%WS9G35xWGdO1CW|Y%3i(1t`0qW?~?Da`UWurIRh(h=xu*kww{HtD>FbPEH
zBK)a@zN9TU;oS8DFStT1G74UGy>r+CAa2-dU?>rgteK{na|xT+4JjLcF6M;7DH-Zk
zA&(HZ0c+ear8EQ)>`oIaP^oOVW02TFQUqi&>j+DV`pz{BR7MA~6tYt6+lVg?I~}(q
zsCz6sCz?<~7)1-loK$x^VL)*(7<PnlCyOO43hx*=_AJO#6ar=RIULo5`vf&glnD|j
zxhOk^h6>NWCHY?2134vskzd^$7rsabd&Z)xY&+GlWo2u`Q3J`A6H7vQ;W)d7Y9MUM
zGsTE_FDaIYhMu)kAfQu=vN}L`jf{VG!pXNmIKTMT_4T1sWxr^XGMEXObXCz9R49|r
z5RPhUhFm&I*?4VEgGj_q^AodtxT_XREfKNWPdXFNjsn)m^ours0+syl+HBCuA|IyR
zXuL$@{pE}Af4me#BJQ><g~C__%K`GVE#2%CMas8<tS9lYDi}d6+tj}^en4oN4fwhp
zM^%dE#)YAYa*TtZcLYr(xp=OxHn%kE6-Tp6HlQM@pu=vGE0lpNLdhqCYeb=&Svikx
z5m&&FyCOAh4@-)F7v2P?q1U#_hQ+98<^!SfTo{w)l@otJDje^<Dr*~qI62rtHaQ$y
z6ItU2SCF%fy%i5mZ>KqdC0C(;w4FYTxpP7IJX!pfg5>2Ig}g_pDZ!8i>k%TkGbk`9
zS;!nloRkm6Lbo~d6b!BsbC;n=E<#77sc_k)g|yrKq_(wxmJr0F9aA}N33<{^%aEpU
zESdDoqMa;B`j#BQVetSlYF|d&2V2roD=PQ~?hg=RtL<bvbExj3M#}=?0|_)O>_TWE
zz+SXeE$rxFq_=)5y)~m4#O)6(cu8*5L~IKZrKHSmkcLV2`zb~_={y((N#0X8ic`}a
zyB<=T9eZJal@$&hcFOO7u|nvg(m771=f<}yfhcG?${OF`0>xC|oE_1-FTYJeVyCt=
zi@^Y3K>P&NJ$&W`!NLeWDO_R}0hC=suOEBbtYAJtVU%JAbSx-3OcewYr`S))GKenB
z_vjKsnV|SIlr)!_Mnmv5%aLnjph{VVo6s{}ZDh@VN2nZl=?ar!NBPcaza(o3lmzm?
zf`8`dBT|$x&`tlKfXf>kcxDz^^NBOX({%rki_p!S#!k40c61A5y;~#yF{u6%ln6fs
zA2EQ5^RRFN+Dt<6fBtQ1!8#GH83?KC%Y}#6Bts=;e_;e5??gNU%A6ZH31~bbi!Trg
zGj!2^)VJ_V3oUPP5G1GB=8!sV^hTdzV&B%#62#AW6zl#>JY(re3>{zwfuBY%VeJ$u
zxXp2ccp#^2W>+T<kFG*%FR(u-PzqSqu_o!-l3;U5!uKghBLz{MSr0{-6Qj`S<ql2E
z()<wk=|;M@`=a~&tjI1ULluFs$~NoS#@;!9DdbDY3!{g7>o;a=DlW(LS7^g~XK6R5
z?#%-4M?H&g-J5s#_Z|9rvOld5et=@Fs?mxJEXhqyJUJOi6O1CGTaNs4*Dl6a+P03D
z)g@O6G*Y(qTdcBr<u8&&Kc<2S9~Pz?I`#*8`hnmmF2kj>g$lZfySZNV7L`XU?B*ta
z+Ta_EFvSi4j;VKa+^tZL86ADivCtoAy9rPkXdsCc-C$oN2K%mWUdOl0MYQzHScU5U
z_~M<rAlUOr7i}_)_s|QLSpu!f@ucZV{k$xRc7Lp5ubL~<Ek4^pqWdoG1q{FW4T395
zHSRG6%Fz@*fYfP50<M(~z==MXK3rpeW|{6!ii!qB$PVpYX0~1Kb$<yzzk%6bf@Tq|
ziVU=0CeBO;n4`JV;lj<v>7^=7mIfN95rCw*p|gJpCmn?QlLiI&n|_+b5t`Rp&4Ra+
zTLhzrVIb!PW;)0V6(-siHw9q)i{?-`ylqBv#_i^ZqNta5gZ7=lE|<CM1Rt}147s{M
zj9ha6mt;@EGHEMc=66RaH`x9gGyJ$^uJ?u74D#S^hux#Ep9zjx7j2Lv+{6BvF1;)(
zgPYb-^(|HWi6n!5&{F^~n?%YVlcXQGceZdg)3|}n@bMfA`du7x+Q*UlZ5BGyi=$Z_
zFQW4^PDp8DNi3iP9G9r+1|Xb&pAid>&sJnboX;$td%xpgpwo?qQ=072=0IOz?2hlm
z7@dWKP_KM)BMiwn&A$52{2RWR{pvM-^>u}#Rzx%l5d1_EPk;;hEJ^`RqUF^UjFD48
zxa%mXbCF4}aQ($HhL<Q_EE77dtQ{0UpyIFfw+xB5^rraCRLZUCV%&;<N{*Tao)=tm
z{i{r6wiM_{w!<;fmP|(<+^GzPf%iG6gr8iS!ZlQ^T3Y5y2^5Gr#L`3{s-}m-Lz(qo
zzXj1rIxd1b(y4e!05SP}RR9&)E<DFn(Cg%Uqktj`DyHD9bS5j4kWWE2_(rmskYjyx
z7V%dZRf4hVZ8x&akZgs2g2q9O`JRle8F+VdOMx~n4|kr8mcg*HcVXaTZ9}RHiU=_}
z7ERe#;<Pv$y#0gY;fu#yDf5#<7LnCgUU6XDF$D&O!4<zJ(2AtI76<@ZoE9~dm?HQd
zgy_>tS$`;NGbrrJA&-{fCoI{c!-zsmUIC3w2TeK{3#W@Ba+FYiq~Oz3IFLcvPFT<h
zMJQ4)<SGTt=&fu<nr_D_s+%O2lDa(ggAZ6eKyt4_*C#+K%fxABQnd)E)?|`VXjY~&
z6lUeA3W(_ftY?mL0H>)yeX}ipbQel#_X0XMaTs`+b!i$uETtQWG6#&))0yK50MCi=
z7?}(QpF9pa=$EX238$23&FdmA<2}d=@0HgA7z@wkNO-P5d@sIfWrIm76BHlLu(eH;
z&b2uTI%w;gy7)I(%mD9oSuav4piB{jVFyRXg(8c8h0yzAwErPN%X<I%N)l(A1^JhC
zRVt<=?M~L2zKyHz>E}HcoRV=pEFyt^pHq+$PKkjx<C|E2#^WyG2h>3(fqk228z3o3
zGGSGR9r4bUErTv&wD}70P3P+xbsh`JU}V19C^k%KuAC!-HOiH7T0Ml(u|E#4w>Pie
zKVPejNAhr55M4A4u`WTFm06(_=EPVXIun(G`L7+7kyuLK(FDH0NlAv*xQj+ubJ16n
z%2tOa5Q~_9p*%=%extjk4E-&AO95D4#Trka7I|{JMZcun-Q+zEQ{Pfj8ws13M-)!5
z&Zm$O_f&-0t)vyw(dgJDm=q;@FD^f%y^9z;rs*bO9%`)_fd|(&v*P-U&D^V*2mg;9
zTWTX8<fUF5noRa2WIYL4PeNARLYAP5o?N^T_`48){9Jmk?ngvKwk*j_9uBtTCg=7b
z=>Y8;KS=pKLR8-K7^7y;yL3K9xrdx&D{oB0&Jq90fB$|G{;&W1?0oDgJ3Urd48l|P
zCZO<i6`G6Lkr92mI=^=9cy@6#Y7Sd{YtFyT9K5$Kj>gSSw}(Gc+n-OV9P-6cOAp7L
zgVeHr;+A;lT9jRP)^26~Y4^tb-~NmC;CcJo(P+?I_*X~wcsZh3aD8#)%qNbme=?zI
zGln+<|8-#6YE*M~?x>m3aL%w{3_(Z<mbYXh&g(tLJU>;=i9~qiPLh^SXk$UF?LM;H
zaR_=DwGPR3gxuw^IgT<MG0$y;#6D>V*HTq~nuT5>B{yz*c$C(IVR%Vl^w618l^8Nt
zg3!+G_<_n1im1sFQe|Ge%5P4p9Dz6{I-_!#@=4Tt67^~o^-vo&Z9%5Xs4J57Mj%Sc
ze6ml%-YOfe7$%r+n(J8*5h$)hHC%300BTZpjIs0lQw1*LesUUgt-wq8AvZ!v(r&bW
z@XTAGXK~a=u7t2T*fd{dvbiMQxf_uBJOW8*8sE7xZ{tYiBdII|U06KLGKp8}onOx!
z@~fdWiYc&C`37%awyQ-+?Z6O;oaFl^1q8X+m+>l2fe1|x#g^M_x>D1420dYRgB}?S
zl)-ScGgrmJ38swYn=!A+PnT8_DvBh3Go&S+sMoim021zpV3EZx%RDq;YFs8~Byq4w
zOiO|Zd2QY@qz!>U-D*@Lj{U*ErGYy4iDZo3yx#fi?osCXDM-NcduBe&jcsfVb_wgD
zllSW{|3yJbgv8u5US=Q^B8oe5eKIE7E)Z&ot`8Dl2`HT6Xjs10bV{kirctVYa!TOV
zv%pi4E-D`4j*W1(l|K8Um+g2??CeM}E70c}@yIe;;y%J?zC->4Q=fSv348m^#lkVe
z{nI5E<#1&m$*FPe=;N}Y=4gcE%+iOZiXJlgvFT^Fma&-vUfb+5yJE-r`wqu8-Ajln
zXDLGoO_n}dPWHa~CN1e#n-{8o>dZLC%NKvhT&pJv5mrS_xzn}tQ!+pgCn^fi!wKGn
z@Xv!|IQ9vv?h5FPi!ZoWRHgx+G`L~{U$XPmDa$2_?KDD3IcO2uZR%QBX@DSHh;GNK
zSRchUQA{B4>8or6>W?p|w~6Uvys38PY6BPDYE<bh34lxn03ypuJ><220dSQAZI4h~
zEm~cZMi$|Y7FJI)4PJcEb6t9Kvvnp?J2~0ESt;;gH|XBUnisa8a*T3UCxt<?ynX)_
z3A+aaVrly^`Kg3qs?qS;*o{mOLlR+mnrv@%tb7=eVSX}QkB~YE_B#&3oi?``K+!cw
zf4GnSc@cW$6~-Uf(nu+PfJ@G+KmPIE_wS7hiunEU?ej}QdL*7gFbEWZ!-{4a&)P63
z*O+IIYnN%T!MaTnZrxWY$6SntuKjkOS6>p%JOb7G**x&CWE1B6bsD+ScZn6Nco)=s
zQPIpqiTlP9L@=&R0ek~zsj>aENQ|0gik{9TTbKbPP=A7XjX1}D23ZQNL~LH^PH;(n
z`2O8nikil>dk0~omVR;V4r%a}s$77FE)$Zh!&g?~;t5;f9vSTJJ)0N7&>oG`T`Msq
z33oVQX{ZXwi_rPx2Fr-1hO3wf6(;<nRn^Y1^+vIDksdeHwUCmcw@GOvTzCxtG8fY;
zuP$m`^eVnn$4N+k1_^lx+=_siw3#xSi%(Ss^fL8x5Rw1~{J_?RJ9SRgBs5-Yh>X-Y
z)_5{8LicfX0L<xn@!|Pr$C{nKdvU3Rn@k(FgVGT%w5~|33h=>n@Z3c3S5@XgX6YDn
zDMgsAj8yb{^F*1j^rZf}MCDr0609g`3u34|9D{gQ=2ks_{4#c>pm`V#rDzI10aoZ4
zT%jb6R>B0;kGOL$LE;atLUTTcTN81KO&_+f!oJZmN^|3UVA8G2kSlP}1|D!A)Up^?
zM?rhwy{%_T3@UqeB>6V9jrX*F1)ucsz|9#UVBxv3@>~6PpZ_bcZPFQ#jJAh`(Y=+s
zoD+1DrDObmZCsO7lBCr|B`b*ubhYt4(F3WdTLT!ChP9sDa=koK(IdtjR-K%3DHQiJ
z85?!_3GSNTQQ;Wormk;!OTvU-#*B2zz^0A|JN=lS;@>?6+6N6C(RxncbCpcwMtnk4
zE-k_S=v}Mekw2l-!@50|y>m>TD{_PylOM~5C>U*jG=VMWJhSwvLgHp6GXV)_NLEcQ
zRjF^ab8ObRL5G5>q_ojKOXV4_Lw1c;V{~brCIc4DxZ+6yBPH6HfBXLB+shBHUdZ;8
z#1l%rT)zC1AVH>77jIww@x}MgtMBC9vmYw%<PWdE|K{22CM?XW%RkHd5*AQ=Hyqxb
zz5o4x3!O)BUrsy*ioCp8c&H4KyUjt!@JSJbh9t!3g*%;Q2W}jrG1^3s^Y}VYH=Y-m
zHks|ousoeQq%(iUN=_TlO=Zh-yfr_$S7stcuR!8uj4k)lqd=v|XHin&F>)MVR}wTa
zH#!3Lg$h0vqrfw6QH_n%CzlBB*}|S?g1)PNN7_`eU}WOMwb77gSfGeiuh>QI$&AtQ
z7TB-P^UqlECjrQ+pYUai93{s*ic>bPadIs1F-C5i!R_!FITXE_*8V(c8sBNVoll5^
zpIqnqD{|6Q9soudTogu?`8%nE=<hp}kgxkkSuDs4;}q~J;}RbCCQ{zv%j-#ed81Z;
zIs5!bhsK~ORuqK6*2{Pq`cZ1YU>EEimR|ic?qyY*Eo1PY9h&58fH;Dmu=+&><VnR&
zeC2<$Z@c6u&$*XSiU+V0trYjjknG{6qgmHZ6QV5)%bW1Qw4!jzd76o!FSths82SN<
zK_sKNC};^gaRtV|j)D!=SP-<1$_}i5CXNIVDF=gftXl`M4Kx-dafkq<?P;93YeFN$
z(CUq{(%Et41rbR0RQu@b#VkbQ<%O}bcaDMFA0o$_!UM*J+s77$?!07b>pcQbupAO1
zNc`S&zu}$zCZH*m^oum4MJ_bmh9RJP);qAnAamU}<Dp_K*~$g`;4N97*mm}R@{ZUl
z8s($(CW+8yo77a-IgFgMYO;Yta7>3gaLv8@(gcf9c%0ZK;tERmA$7B#MOIx$+gMrS
zY1xY{dn&4g&L?^L^oF#ed5`i@TObe9U*Sed*Fi!~P*aa(3xFscpk2!PVApwC@t%EZ
zI0;eI^aCy+dX;xyz!d1~kuRWsXI8m>h5YBE+ya(|=Edl=u!x<Xfm&rxMgt-6Z8GR9
z{5K9vT~26spyk2xFpN;cOp$|4&@IR_ptt>15OLCJ@%H_9g4FUkA_;WBhRU%gTZY1o
z#iHFoq#`K9_Es8Q6im<#Tyl)&Bv|UQ63IvfGJmJlRj{1JzvyAa5o1h$Ns`xF!VS~M
zl@m6vZdlhhKA9mo#<>*X@!X88CEE62!#Q)rIl!A7*bgGbHH?L~3{CIkt8_QAJI!<E
za}y6fkecA%1T|AyqSPuHf1-Rv=m+2(FQb@j6H!(|v=Sv}rg3rtu$K<TOTl4Kg;S5?
z+l4X@npE~tz$$4_XlKcP)LNkO8Z-ER#oI?)QZvVz9buY4Nx@=9Ep&Z!*#NKBW>_o=
zLB`q%Ui3GPeX>?BWTg~L<meEK`5Z_GlmmjXpd&hv<<{L_aRQ2XMsI7L?tOdXmCtB%
zro@EO>S?eV+(V|PO;)fs1&s`))ami5;36MrYzJ0?JK6q=X(`Bm!iu|ZO3w>A7b)yZ
z;|pPMh;KJI2uPz;E-8~e(Q0(15yB|)jrZ{36a_KurPoleZ2MGpe%i4O#U$|0Ck@hL
z)a@;y49HeKT=aiA22mgccKp|+M5Jm_<noUZnQ5QBc!yTn7)@5nAG>~#8wn5Je68%|
zC)@`jeuTSFa>%fMM7`NCyZ~e>5K(14oe*_k0k)DyBc7t02&40=-u^TgES<RPVr4HS
zA?c-eZ&@yr3E`z_e}DPi%O5u8jR`jlkjZ9V`QXHRPo;BYuR`?`RhOQdw<{6;ae#&0
zS<_pB{G_=Fd&iU$m~mEhC~3lwxUB}&Z)k|>y?0um=U^m%>#^fC4B!GF!lBFNn8*k%
zqD;q32KN*5n6E(j^v+>ZTONIePb7?|N5$eb5OCmgu*^2IP{L}7Taxn_1cLWV5Gq6W
zvqOTWa66kAu<Hwtw-HQKa1{rvs5@bvSgPF6n39LXx2V$mJOCY6{Sq6hQ#M^lBko3d
zakCvvJAYY!TqlS2#G&DxHfUN1IgSTO#n90qQktcNtF*DA6UuhN-t~6D;9Ji_4<&`4
z-!53?r6xJ~hBi=&UX67qt^+)M<hN&$5pHjvBZp`W>l;4oj>Nu+UIN-GG-4H#96Q#`
zr+~kiW1;{I>ZK2IrWq<6az%ghih{EV2%0jWh{;WVm0+BmKKY^o%UY^>EorcaU=CgM
z;pqcQLHgCw?C!i3`fu5Qlso+EKd2Bm&}OeF+B->3zb`aploz879e#5Q%zJ9WzSL1E
z7`PB+^F^pIfQG7udu#5%M!nrq+s}<vV4l7`@ZkiMY@J`kEm6LBz;n@fimBpstx9O>
z0(=O6iEWrFx?cxnV|X25i6<DQuCA+>l-i@v%WSte_Gpf$GATf)65EuTrz*Z+PjE|d
zjY+x+bicIQaf~p(YZalFP1C<Np~odq&CBFUCX+_OYN}m3Tt*?W7{h6RHHcD7Z{2q2
zMjx>%Dc7S}l6u4|0D}qOuA8|I_RdkYB+i+CcsFr!IN{!-%1NLG<&j8L;r0)pAY*Bt
zi}oIjqj&Gy+@gDUOMC{gPjFx{dw;fs9mgmh&8yGF?<6$jN%+Y?1pCox52Y|h;t|Pk
zj5_VHsQFF{xvweUpPlylw#e<^Ijx(l3&|Wdce&tW5hP8g1KYRw36d^$r!U2o>U0Kw
zo48W<2XuBi!%eIxjRkf8hochsPo2(Kj{ihmN%5bkCo%pLbyWucDbt;-Gco>C>7G{c
zpESPHy`ObkGEApVw=FtA-Od(Fr@S%Az?eGSo)C<QdXRL`&jDj9D@4A*kc0&G#WrKJ
zh_DFf88rN<878sHDEnhEbC8xIs_1NgTsbjGNiHh?b91$99(Kgq1Bxm0jX^Yx<8PL+
z!7*o8M`{7GExbT7obB4`ljMEW3Cu{j<k0*8a*Inf(y|GUNtu)&RG}A)Ul<2EN0%kc
znA8-472m`ZPtz(1U_e1g>A|a{%A`;#=LhS^4_j$G&6Bm|+e&3PPYHZENcoO`&yeU?
zY-$+?Dwhg~qiFHt3noSCUT2&N*8-W)<5|y~Wr)(NrIK)XTo$hm)q`j8mV+lv|BB{i
zUeU*@UJ~i3YcM7-WrE2e^$Y~~(DWl*_AFUaGf$Cf%A<m@@~8zWEqZOYrKPo15vS|W
zjh(bYH%Yw>m{>#W94piSqH}zIdD@P~{Q$|G{9~zrtfDPNax&e!FF%<AbKH?CP$`y@
z3lI|&1RHb(g7%3?Aq&u%<<b^YX;WDOH8QFP=wr*!Cs-fcfuPKLuy>XwLUsfx1kOwU
z%5$SxgH{6fGiv>W)b<(^D`5L9X66J7B;a0lrj&k$1`n!Gkfu<nq;6<`k&+Xz0iVs%
zFitL9ObV2a<7Tio^5912l#qz~6I4D*IfO^>)9cJ{bT*=F(iYkE7zK%3bK3uJ9OFjt
z$nud%OM|)KkWc7PP`+XcRze)Xl|<uqy6iRsmZjqhR-2?_$BHG#s{g?YqKGD^XV6eU
ztC^~HbV%6@qOFr;yg6QfMhtwVmMi-rXti%)wc)(rnLwgs%TN(-{p3o##oe@QltAY|
zg3!XLlgYrcrmonE=H;Y(1PAKyZsenkCWl4nO!?eu-8xq5?}VoIgW=ELe*eQ8>gx5&
zH*cQ79pHF2FwbWQV=&G3hsoP&TT>YHX&juQRZP;SgH<=K@%GVwEN5+2jigFgS~f4v
z)cFE+KSDd^a-n{{iFI{us>%&_8Sr;oRkYivxOit>TN*0Ygy8FTiix(*LUZC;r|+J<
zxRm1cj`P9Gj=nCgRiTYdpyH!VK(a{@w?a_Q4O%Z=H-TDTn6_;62sA3|f)-HJhXyf~
zz>;>w<_XbKplL>bQcevU7Y<(rswyA76jBv28A<`<_lpDMw+GE(Z?uk(KWg>{!%c+z
zWIRO?@;gI?kl$;ydM}@Mzj--+2!#BNM6?352f65vGX;^###e=t<M@P|LV5*;25}xX
z+yTrJ8>?KIOJGI`A6~y96zUF0m>|zuGltT_NB9aS)zGbfz+w^)fn}1+I9Q@baf$Qx
zNi;?sp6?b`b<i^td~|&MHCpZAs$c1gD)K6s89l0vEh0SWB$LQmQpfLcv@zjTtt)1!
z5nF@pqU`fpy&XD~rk)BPgitiOrPR9h+mS9O5(SUpwRq`Mm{dcN+`wyy^ZcD`Y9EV8
zX^y`eZ=?i&KV48y7u3UCP@S&Kdfsc5(i^3{h_U^#11Y+H2a6iG(=8BO_kRT|ICmrK
zC$>*&wT=Jwv#fXHZ!Qe}kpC@!-==Y}6&G2SN|4*fz>t>GLJ41joYO^XWatDGAxq3$
z>9tX!iC&>zi^eAST{&|}Wx8_E$r}dCtC<1Xjj8#6zXov$v`;xPT9H}cyvVR}!QP(k
zfv0=m=^l8x2a4STl9pk|{k<BOp&XjV-*0q4#y;J;e*Z-3z5A`+I{lK`^`Ii{y0e3J
zJ?uUIw)>*<Aob^RwCl3|$>-1-Id&2!94djJG`hS63V16K%YyxS6r77`gIwFzcdoNY
zgsP-}2>CU1L>XKx2ym3?kR$5wS?U(VSXhp2Osf*BSU0voXL^Z)z>Av3@f&m*tpCm_
zMhLTqMq)~ET$?W{@Yjy#vCZI`Bc`uS&PBlpZSFSJzsU-qd@$4nN6rP|M}DMdfq`_*
z6BQDdSe~;TW4y2v5|`ucl*ZUa&J`7hfSIU&Ku$6;xS!1g8-H0$+R7{ACcn4EmtJ2Q
zpw!zyAI<IH(zy|YnMh|az!+6eP?Ttgdt2~2Mgc9B@kWjNg7=be4b`5kbQ#~%IjD3i
zs)Hox<S^$!&i6_uAr1OF)Kdk=1nxmRC{~FXZRu`5H}QAq<=3IoW(M>cW2NKkpvX;s
zJkmFDv<Oxjp-YL<XpO0fC{x!#2G(~ypO(hJp+KA!tS>;UFs4Aa=cbQ(zJo4vj2j|5
z0caVVu1ldiCZ&CQsyzd74^?D?cCun)6vi__W4?`P<mXh@Yz6%>a<F&;MuYGziDBd9
z>gCaMY{;DBtEr3v<Eo?K{M)P@JJtn%OfaBA7wAnw9e8ehl`?c0h;cZ!C?@pRnL}?o
zDm=WQk}#5_s<fI5f#0PW5XY{r`Eu=Ki@v09WDCWy7euE=XQqClLkv{HEFo4BD5vq`
z3oHf~(b`>`p-*vDX1s!^17cQ`iA3PZCur(1*4461PFZ#Q878*cX$3&n(RE3GZc_+p
zpM^3q^?Y#cOtg-I?+Ac+uU;e=>IoW4THzpF*R`Stg**tkmD~=<a@2#PIV*md3oS>~
zx*boREJp>^SOICrBCM;jcBbN=^x>2D$WY%)0qCWJ>k~qqtW-d`JGtLco9i?h^*R*`
zuQ)BmvxL)<O=wspFZumd{FO0(b3fpzr=qw_J=_;S!EKUFB~l7k6JwwPlB7>0@=Cjv
z=LCix-!B)7AXD5B{mq<AnkFZ%Xu}+gO97D><;789j0&&9uq4R@ePBnO*5Aq2QhCXf
z8ecdLlA(}jTs@5`sEMV6eB-n#jC6>y5heo0?R*kQQlqgm88uQISQPnxwgxZCY7F+!
zfIx6UncP(>&1+-81r`pZf`6*~5J+=>)FFQaIwY7ZbR|MDBS;18C^2xMea%tEFh(`J
zqB4ZKd~k^6`ivy;KLaDq`G;I%D<dK$RUjyy17{6#*jv@QvT*Sh<G$01d<rtwxl#F*
zYR@er9YwBiM>eNh87%mJJh0)kp043;R|pKAaku0kdbbID03&XsRg^J$mTCWi=q{<C
z+!GZU>Gb=IDW>v<DKZI;MT#Ra&1^je!BFYMn{~#N!BYg--02fw^QrDoHgY@#>F(1g
z`GPhOhjivn;}0AKMbL=?YV#mW8B0j|q_TCTy40E+MfZ~ventO((h965jB6+Os3|hZ
zy%6);FWWW(>P&M|voHZx8M!x*D31|)xWR~w=iCg52a0R!mbqE$;;4I+!^%5-5M|J*
zr;`u`Fg$&b$U+wW{*U9ITBqZm|Ni(N&wu*w&Bo9Cx08Q7`MbXrOQIuOp2XjHQgD`_
z9M6kTWC-u7`~AXym^ZJ&V7WMM7wIMal8&+lj9z6k(q@{Qr-$J-#SLlaEd3(?oZPL&
zS834Fa{qfQMDz?#qI9JPa2$SyA(!d(ZBVASO|l5SCy2u>MEsrcM%P4V2t`6dHZ>A#
zIBynQjo+!-#HoP6?fIDR<+-0x;C3t*{!F!zOmc_?Aiy?%3U{#PPD61J1Ucu1p-B>q
z2poXMgXC;LfqFdX?ndZtdkdlaN20Y#Lz<EnI;;DgXIK8bEMfPR-Mc@&5pUk!Hk#(L
z1Y!1dW{Ar<rc;+0X4w<{+zjnUKo(G9=XH|h1+aoRizHBzd-d+%UKzTmx-aF%3GIL?
zQRP50mt2{D0sdXpW78bvAP2VtyL$iUH+vY}-M6Qpkv@6XR<1~r#b%~Wh*~;-yP+z1
zlUqu1b#-=>5$@l-$ai27{>Q(G6^A_h`py7DfJ92}d=Z4PNtGUACpsrbk~s;e@S^Rc
zj;Sm@^CsnWnTNzcVzPTpK(nF58-OEMW|xnSk6=`Pn91n{*NJm(PRT?F=ZA1zI-?lI
z3v$eYe3f$)*P>;ZnG`7K-fd#8NmO-I3{%Swyj$bkn#Q-w5S2{?!qW--Ng27sLrB4R
z<TPC|C9DtzpD=jkTtNz}Ij<B_T5D1}b5Sw&wPq|=dGpZw>qA5oEZYdH5Q~fw1JH%d
z#BHvBO0tJo%`~7`F(WknD+ZQeOU);WD*)MB*CdZ%%@nBqtz(9fBtmxxG;EItqto_y
zC;%hFL7%MKW_b|0{tMg4W8Nd7<D4@_oYJ7le4=vBB7&UY&$MlOcDul~={1aMPz7VD
z;BnKq#N);eeIyQ9Ndr|1Ap^;raa5~rSD|EoGrny!`HPAY45=Kr{}&m}HYT`bK&vAb
z4{EXWEkR@#j;aa-M&)dpJBYNHcuCmb6e)*Oq&!Zknf`u{Q!Yj-8&uiG4T}n=WyyY}
zYZb$>qQj<RJ65QnCprPt)y0PmBByFaIb3vX$;=FuYm06a3a#-mf_V~<{f{6!U>Ti%
z(6tDz$G?gi8f794^U%R1RA3oPGiPH;=Gv=}T%I^>g%7E(P{uB_Gxk^x5h=V22y(@4
z{!`%kmpGT=+XqeFmq~{Rc)<mm%oJc}6`+Kt&4sN~B4gaKMP4DgR}_UYFbCHtQ*3gz
zz!CTDlhp){%qP=ZstA?UD%=DFJ9V#rmLUcZf5j2N%Ixk64j9rYA<_lbW|dJ&aFW$t
zX1Wp^T(L9LBAXGAcP;n$7+7v1fko(l1tDbhf>u>$5ymL+5%k+nOZO&;#?e<CE~el!
z?EuAOMsT6UV8obRU3FAc-PfL=OL~SzLI;Kz5C^2BrKDSW=uRaaL_ktX7%AycYA8WU
zYCtIoC8Qe>kP?uP4_@E3zSrMbYp=8J-urpZJ!jqj_SyGoBHQ68X1||WzU1+z<CKU&
zlm_%Tv)W1Al{ed@B{;*B7EL=71|2ls))f3M+RPr!;3oQXSJpsCfeeRvDM-1A@CK)_
zyWYI#vl7<Jogpb{tRRvcKK!AVtWH~<s%x06DM^fR(kOt%lXie|8z_X-^IRmurI~T(
z*+ra-RKj`AyW2D2cWsl?W{VHKQigqUb!%n`#P2wt=ZBeb&y{E<paWHCa=RS0xDP{J
z*j_Z(#?A%q8n)5j<x53|&xbVREY09a6qbhi+XT%#^qFtWV%x0Adb-Sc`k1P5*ds*S
z1+PJqF+sgdpQE@;B9(SL)LdVyOrx$F%XOqQw4Fe}Igu-tq<^l+L|?m@^OL9{sk0xI
zO$vv7QBSGY4i%{DMt7+%ySWPa)i_NyoU#@LzPCC%-ab7dU(!5qXO4cGokdx$ysNoW
zoum`uI01^!BWYP8|7xtEi&CZvIeG{etRn%^8Ry+@IZnOa>M&c<QekN++-037Q&Lbb
zQq0%*Q+5XIXqfwh#k(bj9GBfTMKvf~7jNa5=trMGR@{1T0DU);T9r(3r#!s(dey>M
zj%w&ZBcFk~2X15NjxHUxx_Zceas$>u^&%#gGe`lima9ch&z(4sPVdP=PPTn%pru`P
z;T8c=`%5L$3ER9vmllWSu>CszDa7pA?q0#yI;WiHig|*rBGcWK<|0JH@z+F9#D$)4
zgL(e7)=&piYP1bachEP5_;>5nVHxu)F@~76mo^}qkjshys!e|G#;v8uN89y+*=DVV
zEY5&2sJDQiJER?#eH;5mwQt#!xE5!JxF$qLu$5*LKf{gOzWjfs7ij!v=F<G}TrsIu
z6zHNqE{}Va^^pW!#QT*YS^>##mi5><&=X%(|B)Q?GPHuHfM5?3EVleb+Ut`#8*zH`
zkKAc8xV0>Sadq7DT64IIt<DFb8p5bSs=@+;OTEb(?F7E8qW6<bUi4aroB~SY@jOX7
zm1+pbQa>s#mTq0P90;B(-&Ceb`K^Rl)sAs_ZYr;1h24;uJvh{#DZt{26nPdZRBzn-
z#Z%4_VUDKc^QZv%E_A|-jTq60_OjzzkhrpV(ts2Q$jF#-KZ!-8X{S1CDQIonGd#$x
zF5fyR3g*o*z3MO!Q}qVp0UXPTxBVWsms@sMr5k)0(u=N>vIJ4wF)x@Q8o$SVN~F_p
z9FjAH6Wc2DEzwQCGkPK}C#&Z69=y9Ev7&|ZLO1d5q@O61E;LF)gi`Ap84-j<MAPz3
zDWvMp@dvrpW@v0x9%8psY~IP(r`Uv`_CqCA_{y-9&C+rj987V1rPNQB60LeqV9ENE
zR1hTN$2U&#`n>s;%1myZ(-by0rmFfI!W?Ra^Z6gLBd7ADbSZkm#r#!1c3j)!e^DhD
zhPI~e8b>{2cB&AnHwbj6esKPpI|S58MWn->pp_(s$1J2jEjcT0-h7*>*CRN$l;qr}
zQ#*Lwy;+tu@JJ7xO4h=U^d9w0e&xUyZgP2{aqiq%kuN{4FiIoFLi)D0ve<8IgUZ{_
zcu2|_64TQykbj*Zt~(%&v*>AqWyx|f9a`Dgaz4Zn4pGu}K*f?!=~f(Cpnn}5MP+O(
zy6#+-vJ)*Wj!msi9w?13GRi1^Hm71tq=-Z0ySf>Qs>TMth8Rv(Tl~Ts$co}I6{;x5
zC)BEC#M~dydumiak?Y2o?x|COPi|*3-aV99uze5}t?H*}#QWKyOA#5xlux3Xhh~4B
zGr?!ls{W~NKuk+W+kuxHWv0|4nu#EjQ|%0YHL%W!IbZgA_2C${9&N6QFeI9ajosTO
zpIr5k)MNabo`$wADy|!&dfdx2sf9(1^YYkszR<iS<SG$$VB$*1YG}2Le!ax-I7qvz
zIsW+@!_ty98F=4=yz6#wYm&;r2(&f?6^@`B*k=}udp92miFO;+ezEo)$QV#lp=2!*
zhjFyZbfzP;A=Jx`c8=uFq|{`X651xJFxrYP_jbOX2A?>fazPSgw+mV{2VtPbU*6cR
zk;}(&n0+s4*E*eSL^k5{{;u{4T|c(v2%MO>f5(a3tl{>T&z4dk-l&xcD0=I|7*y<9
z=6Ghh5iJ*mMDy8}2ri|~&Ic#(`$Rm4SMf>wR#xezx~llNZFy}|hkB#((oabmk$X$f
za`?>?#m#)8ulJj>n8NQfz1ScyCRWN_cN_7Cg7C@Q!W1JvXzcPcb?Hr{RCs3y3`$fp
zGqt_v;SevNkz;yQ?j&Q<<BeWbHyXyKjpYf&aII1Oni7&Ie51@CX4|ayE5JjdAlErb
zM>F#GPlKXXve%YUCP=PyqDI`fE5vCyx#{{HO@{aGUTW-`3G^aP_50TER;V=1y4ZL$
z76k0HAcosbFGa6QsP07;Z&<&Kco5yYEfMBe0<R;9{94#)lvy$HjOz#;8E~wU^W_Gm
z!f7PohINQA4*YsCi|s&#mtl2ukle3(-*g%sqS`iN6>orTFq687QowuP*;0((tT$#9
zWoKX-e)bV+oFvjI*_u0#|7#G3O-flkP-6<!v7-zkyg6K+Jq<9U&m@#-lZ8F=^iHd!
zE|adxJ&JM-_ID|r8c9TB_!e%@tUtZ#3-8&K7C&UZ5Th#67z!OT&`h#GJDr#1!TrbW
zI)v^7BtLFBh0`k^7^3rA7cIUR5|>0o|2+FBd49G($Cka1*8IKeUPr}O`71ej-(|mB
zaT{X$uGo^80E<WTh%f15Zw+el1Ju%BY#`rqCzOYr>JwzaL<n6@x}rd*le%stPAhCR
zn%<X(4}0mi=7<0Lqz@e#@%w@05a-8$RMb%DaI6p)L@gvHATdli|9dCdUHS`9RyuB&
zaSEz@m*&PIQ7WXoijBp77l_NcwtXP)86z}nr*C2BFlo|)O;|9i{WdRrcl??57iG`j
zrQ(e8qoFrU_)O?iuL_Vz+gWLBp&Ig+j7hUCtZ%%%oJ(MCM5%V#P~13s^x!t@Y)i|}
zz*2;DDWzk#&}8_{dg$E7G1bac(mUSzVc$ssRCt6lH<f@U%u>yfT4f?NB5rx-T^wyg
z(Jn7CFMgXtSUGc)C~7nC173z}pHa{JZCaxG+Vq;rMn-g<+07K4hUCN>KJHryo7tu>
zOc#367!>rpfuBXojYp4BCu2J8C8|{9O<Vm=i!bm(9*Ibqm|9E)5VNs7fejx&8^{vE
zx01dTM9*)TEP^p}zMWR6Bwcrv>01Z8+)C{)Tp9ozgljaD1*2}W!#FyuKWLPdO_GA)
z->WR5JN?ih!Cz&a#_f;D^`EJb&QAdS1CaFDhg%yre5lF3nDHoVja2asx<v|1?KVVX
z6Ps=F1%%V>tCUhjpELNfxh0`ZK-}Wx8b@4D=iNIzn^YHJpZXT=J@nLLfHv!dJQwju
zlS(_8!LLs`Ro`>MkTTteGFki7;-sGTvJws#WsstQH!`{dW5v3$+Z(9qi;KOA%6qPy
zk!U(rnr|NM&M0pkILk|CRykcBy=Yqf#7{^|d<1S)Z~Jw25nEX{m&C26-`+Bto_#Dj
z*%X5@j~;DiWu=`DoJAZu%T8;1^;f;}8+T49nCRmk<g@o6gK<|s3k_-&fS%1}D`qoh
zS&g9!VZ;tk>hl!|K1sw0_it)k^ZHgPdqK&{cx;E@e&r{&JO=xj_*vJg*^FC@)q~-B
z3asS)y|BimUITqfgDT#BvYx!!vUA}(1oVj1Mg#koFFGT2h#aNetC_~y4(sl}^-*4D
zo452R|E9h!DR4{@<POYi>Lu>7$Zo_*#Ze2QAsms>8r8P1;tSuLSf+N=FtMZFbU(f4
z^&KNlnl(4Q#!vUKy9T9xW>T4tP<lu`R3;Nv)OVYCzRcW~l|hHF$hhKHnlFRGoc^Xv
zw>m}ou7ntiI1qXoFS{tl@|3_YmQK(DKkdDVn|dx%08xtMRg%uCKa&>`&AwT=DjuVX
zRy=sd_X3OX-=)?KDEs0~Z*IuHQzKSLO0!h;PA1H;8YS4TO{^=k6FO|pn3lP^cSs9e
z7zklmLAb_xAs(~G)rzjaPhlpBUAg8bZ~OeSoiy88$F%zd*nMqYz<$6!PgG4FY3=;h
z1PSvS?YQIcZPoGUW$MFSt8)f{#*vIAv^JcsGpS~gg7lRZIe(>?O5gX)yp^A$ZrFoI
z`a0%ocdl33HoWy!{~$3>y=QVxOtqK(%08pQf37LeSZ-FWcidIbq6cAiWYii8w-~Ou
ztXr=SdYbhyyhki}mREAEOx^v?`DH!*dVSHy8!<ITiCoW<Gav1AMW0suupJ{OKS6T{
z+O$5aHPnAZS`*}3Y%7xD1>-#);pN@8NZa;C+m@|)b56KhbNZbC?^Rv181N)4lZw9k
z?7MK8?Pts~PBu3j_dHWopEZ%!)8P}}7p%E{Om%`E6l{3y#EH?bCB|T6>S=n|{@U$Z
zkAJ(G_ytyz`hHb`pnuw>#4HuVjOfvADNS*iZ!8$8MRsqYS9C`{_3+z8?~hWnPp1d(
zNKZeM>?lfBGY-HtLZy-f69@ec*v|dJGba@rTtP8%;w`!%3+%aT0u&IPf{U}CkMgaS
ze~2IV#W;Zbb12&$i)OSI8#15{zi1Ka=%yN=96!fV*4mj3)RrE2rC$I_Na@k1t7+{M
zV7LWU(|naoYfh)HZ)y!9WiS9!p3#|QlJP0_iR_3V85xSkg<DvRP2sq80F_ni-+zdV
zM=*~{zx8K+J8-M|+tcxyd$U7LY!AlmbywLv<NAN0*tRI39QXSQv#%#K#s*o($;J7v
zm#OHkF=*;ZaLzz*H`(7i#2KUY9yrQdrs}`)O#$xenkO^MWu`REuAAv34mh@u5wqbI
zN;k^3#q>V3EDQ*$(9d)@@`dMO5}Ub!(kq#|X3rtIulMfImiVhr5<LN)^cyYC?Aqw+
zQ)0rRH+!Kn5wtWjm|p9SH8P|L5meun98f+-uwOKytl?E#96HqH9*6D;*25#-W}|Vf
zlimu7gk<rzVDt=;I`8~>=(NY9Y_P^)x}wJL-P9JZ8IxOT+lfGXU2t`iM#AIC2nKt$
zb{C()YXpGP$1XLAwQcST1<-+9+6|YJZ(b}pg}LyEokqv!PpPpjz!bQhD%ie<JU7q{
zOAliR9@v$fRxt^tLtkWiVa;6?K6Vh2mXeo{D5!kC$<@K8-~Ef=b4sZ8N{WfLO7QEF
zb()Kd>C+h_YuV~r%hYrAke?zwriHtmB++5=Beo~aN9>bM1qRwT=$~}k_jv3HlPS6a
zoe=g+JInoax1@tAge}|4Oum7T{UjaKx8EiQk36J~bG>PG5P`mTING*;?X>4Gd7v))
zBsuT|@s265^VO|%KSTSwQE=sGNUDqUeK~fXL9bpW;X4JgIWPoC{^o@0H(H!+yufP8
zr{1xbmE|J(7s;vI5?(tO3FeAkLnL%=#vboPfIlE`a9!KXYo(WS7Qz8)E*v)gov1ex
zMd}TaLG1SOIamo~(l1Ghyax_iL4nF0^1J-%p;GEar25e1x$IWpl`6EE=9zYd9{?bL
zz`In527+h-w17Xl&=}S&@Rj^CMsEwObTwygffcUi`#&z*3x02b`K})Lw*NT2w*MqG
zZiChSO=iY${s6=NMJQj*m>++V=6-<1$PGi(9*lcgOoWmF09+WZ9Wb2j%JqHYO&1pk
z0I0zG=RE-bKV&g(J79?9RnmX8tS{mJ85z_7fVZuWkE5Htw}79k%m3`DeFw}8oW#uT
zfN!#25$%t5fBNPG09+aWe`o-J#Q;oI6$qMqEfB)@H;LK<n_(h>(PRMN%Kk>tul|F=
zyxawIUhTML7t9P23BV-ofuWfFf1S|1ODDAQkMolah!mq$2_%F6?<yqA>Qv2v0Kk>~
zy-EfqVGk^M#XopS1<tbpVXD@F5X>bP1jDosCc6sp>|cg5tNsmH?1MS~Ip42Hohk}h
u0N~30X63@<?*Cz(yMzLRF=zW=u75E9{YXgvIwd#E-2*Tyf&Lcw(*1w1chPnL

diff --git a/tutorial/udapi-tutorial-dz.pdf b/tutorial/udapi-tutorial-dz.pdf
index 278a5e937604452efdbb59a71d92a29ba44cd6fd..86d975b620b9e8ecaa95fab55efc7afbd9132701 100644
GIT binary patch
delta 27679
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
Iva^=?KbkZmCjbBd

delta 28321
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
V_-qo~d<Uc<4WVdgSkAMe{12vy>2Cl4


From d3aa3222031f8050af1edc7b9b434ed79e5f2b74 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 18 Oct 2025 17:03:54 +0200
Subject: [PATCH 1301/1374] Create python-publish.yml

---
 .github/workflows/python-publish.yml | 90 ++++++++++++++++++++++++++++
 1 file changed, 90 insertions(+)
 create mode 100644 .github/workflows/python-publish.yml

diff --git a/.github/workflows/python-publish.yml b/.github/workflows/python-publish.yml
new file mode 100644
index 00000000..5b0975b4
--- /dev/null
+++ b/.github/workflows/python-publish.yml
@@ -0,0 +1,90 @@
+# This workflow will upload a Python Package to PyPI when a release is created
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Build release distributions
+        run: |
+          # NOTE: put your own distribution build steps here.
+          python -m pip install build
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      # IMPORTANT: this permission is mandatory for trusted publishing
+      id-token: write
+
+    # Dedicated environments with protections for publishing are strongly recommended.
+    # For more information, see: https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#deployment-protection-rules
+    environment:
+      name: pypi
+      # OPTIONAL: uncomment and update to include your PyPI project URL in the deployment status:
+      url: https://pypi.org/p/udapi
+      #
+      # ALTERNATIVE: if your GitHub Release name is the PyPI project version string
+      # ALTERNATIVE: exactly, uncomment the following line instead:
+      # url: https://pypi.org/project/YOURPROJECT/${{ github.event.release.name }}
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+
+  testpypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      id-token: write
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/udapi
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+      - name: Publish release distributions to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

From 352c00e36a928a6a3d63564ee89b7791e561031a Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 18 Oct 2025 17:11:46 +0200
Subject: [PATCH 1302/1374] preparing release udapi 0.5.0

---
 CHANGES.txt | 8 +++++++-
 setup.cfg   | 2 +-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/CHANGES.txt b/CHANGES.txt
index 49dfd40e..3cc3d6db 100644
--- a/CHANGES.txt
+++ b/CHANGES.txt
@@ -2,7 +2,13 @@ Udapi Change Log
 ----------------
 See https://github.com/udapi/udapi-python/commits/master for details.
 
-0.4.0 2024-03-28
+0.5.0 2025-10-18
+ - added mwt.feats
+ - added root.prev_tree and root.next_tree
+ - .github/workflows/python-publish.yml
+ - edits by Dan Zeman in block.ud.*
+
+0.4.0 2025-03-28
  - support for CorefUD 1.3
  - edits by Dan Zeman in block.ud.*
  - requires Python 3.9+ (difficult to test older versions in Circle-CI)
diff --git a/setup.cfg b/setup.cfg
index 3ac1ebf2..e089eac2 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -1,6 +1,6 @@
 [metadata]
 name = udapi
-version = 0.4.0
+version = 0.5.0
 author = Martin Popel
 author_email = popel@ufal.mff.cuni.cz
 description = Python framework for processing Universal Dependencies data

From e7725484603d260f76d92e69e26d00667798f1a6 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 18 Oct 2025 17:15:30 +0200
Subject: [PATCH 1303/1374] test.pypi release removed

because it fails with
Error: Trusted publishing exchange failure:
---
 .github/workflows/python-publish.yml | 20 --------------------
 1 file changed, 20 deletions(-)

diff --git a/.github/workflows/python-publish.yml b/.github/workflows/python-publish.yml
index 5b0975b4..0285eddb 100644
--- a/.github/workflows/python-publish.yml
+++ b/.github/workflows/python-publish.yml
@@ -68,23 +68,3 @@ jobs:
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
           packages-dir: dist/
-
-  testpypi-publish:
-    runs-on: ubuntu-latest
-    needs:
-      - release-build
-    permissions:
-      id-token: write
-    environment:
-      name: testpypi
-      url: https://test.pypi.org/p/udapi
-    steps:
-      - name: Retrieve release distributions
-        uses: actions/download-artifact@v4
-        with:
-          name: release-dists
-          path: dist/
-      - name: Publish release distributions to TestPyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          packages-dir: dist/

From 8a92334ea1e5dcd7336c9b72413d75dab4abfb49 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 22 Oct 2025 17:16:13 +0200
Subject: [PATCH 1304/1374] Case-enhanced deprels in Slovak.

---
 udapi/block/ud/sk/fixedeprels.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/sk/fixedeprels.py b/udapi/block/ud/sk/fixedeprels.py
index 7208b6ef..7de53881 100644
--- a/udapi/block/ud/sk/fixedeprels.py
+++ b/udapi/block/ud/sk/fixedeprels.py
@@ -1,6 +1,5 @@
 """Block to fix case-enhanced dependency relations in Slovak."""
 from udapi.core.block import Block
-import logging
 import re
 
 class FixEdeprels(Block):
@@ -14,9 +13,11 @@ class FixEdeprels(Block):
         'a_hoci':          'hoci',
         'ako':             'ako', # remove morphological case
         'ako_na':          'ako',
+        'ako_z':           'ako',
         'akoby_z':         'z:gen',
         'akže':            'ak',
         'ani_keby':        'keby',
+        'ani_keď':         'keď',
         'až_keď':          'keď',
         'do':              'do:gen',
         'k':               'k:dat',

From 159c442e15a20dcff89f73b7561094cb3df34b9b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 23 Oct 2025 18:25:56 +0200
Subject: [PATCH 1305/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index db0dc600..29b643ab 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -218,6 +218,7 @@ class FixEdeprels(Block):
         'حَوَالَى_مِن':         'مِن:gen', # hawala min = from around X
         'حَولَ':              'حَولَ:gen', # ḥawla = about
         'حولما_إِذَا':        'إِذَا',
+        'حَولَ_مَا_إِذَا':        'إِذَا',
         'حِيَالَ':             'حِيَالَ:gen', # ḥiyāla = concerning
         'حَيثُ':              'حَيثُ', # remove morphological case; ḥayṯu = where (SCONJ, not ADV)
         'حِينَمَا':            'فِي_حِينِ', # during

From 65181b6a0c40704a7172c8122ef8bb1ced9d6d31 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 23 Oct 2025 19:13:16 +0200
Subject: [PATCH 1306/1374] Arabic edeprels.

---
 udapi/block/ud/ar/fixedeprels.py | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/udapi/block/ud/ar/fixedeprels.py b/udapi/block/ud/ar/fixedeprels.py
index 29b643ab..a4b359ff 100644
--- a/udapi/block/ud/ar/fixedeprels.py
+++ b/udapi/block/ud/ar/fixedeprels.py
@@ -24,6 +24,36 @@ class FixEdeprels(Block):
         'فَ':   []
     }
 
+    # Reduction and normalization of prepositions and conjunctions, including
+    # the derived and compound ones. The Latin transliterations are not really
+    # needed in the process. We include them here as documentation, but also
+    # to help the poor editor with rendering the lines. Ideally, each line
+    # should have left-to-right text at both the beginning and end.
+    substitution = [
+        {'target': ('min:gen', 'مِن:gen'),
+         'sources':
+             [('ibtida min', 'اِبتِدَاء_مِن')]
+        },
+        {'target': ('ʾiṯra:gen', 'إِثرَ:gen'), # ʾiṯra = right after
+         'sources':
+             [('ʾiṯra', 'إِثرَ')]
+        },
+        {'target': ('ʾaṯnāʾa:gen', 'أَثنَاءَ:gen'), # ʾaṯnāʾa = during
+         'sources':
+             [('ʾaṯnāʾa', 'أَثنَاءَ')]
+        },
+        {'target': ('ʾiḏ', 'إِذ'), # ʾiḏ = because
+         'sources':
+             [('ʾiḏ', 'إِذ'),
+              ('ʾiḏ ʾanna', 'إِذ_أَنَّ')]
+        },
+        {'target': ('ʾiḏā', 'إِذَا'), # ʾiḏā = if
+         'sources':
+             [('ʾiḏā', 'إِذَا'),
+              ('ʾiḏā', 'إِذًا')]
+        },
+    ]
+
     # Secondary prepositions sometimes have the lemma of the original part of
     # speech. We want the grammaticalized form instead. List even those that
     # will have the same lexical form, as we also want to check the morphological
@@ -481,6 +511,7 @@ class FixEdeprels(Block):
         'ما_دَام':           'مِمَّا',
         'مادامت':           'مِمَّا',
         'مَالَم':             'مَالَم', # mālam = unless
+        'مَا_إِذَا':          'إِذَا',
         'مِثلَ':              'مِثلَ', # remove morphological case; miṯla = like
         'مِثلَمَا':            'مِثلَ', # miṯla = like
         'مَعَ':               'مَعَ:gen', # maʿa = with

From 39f619c0c419272a8bc3c3d32fc4ed5e6e7a02ce Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 4 Nov 2025 23:28:39 +0100
Subject: [PATCH 1307/1374] Adjusted some calls of
 root.create_multiword_token() to changes initiated by #132.

---
 udapi/block/ud/addmwt.py    | 2 +-
 udapi/block/ud/id/fixgsd.py | 6 +++---
 udapi/block/ud/joinasmwt.py | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/udapi/block/ud/addmwt.py b/udapi/block/ud/addmwt.py
index 996f4dc9..e7eb3989 100644
--- a/udapi/block/ud/addmwt.py
+++ b/udapi/block/ud/addmwt.py
@@ -86,7 +86,7 @@ def process_node(self, node):
             mwt_words[mwt_words.index(node):mwt_words.index(node)+1] = nodes
             nodes = mwt_words
 
-        mwt = node.root.create_multiword_token(nodes, mwt_form, mwt_misc)
+        mwt = node.root.create_multiword_token(words=nodes, form=mwt_form, misc=mwt_misc)
         self.postprocess_mwt(mwt)
 
     def multiword_analysis(self, node):
diff --git a/udapi/block/ud/id/fixgsd.py b/udapi/block/ud/id/fixgsd.py
index d328212d..4ea23d06 100644
--- a/udapi/block/ud/id/fixgsd.py
+++ b/udapi/block/ud/id/fixgsd.py
@@ -242,7 +242,7 @@ def merge_reduplication(self, node):
                     hyph.remove()
                     node.remove()
                     first.misc['SpaceAfter'] = ''
-                    mwt = root.create_multiword_token([first, second], first.form + second.form, mwtmisc)
+                    mwt = root.create_multiword_token([first, second], form=first.form + second.form, misc=mwtmisc)
                 else:
                     first.form = first.form + '-' + node.form
                     if node.no_space_after:
@@ -288,7 +288,7 @@ def merge_reduplication(self, node):
                     prefix.remove()
                     hyph.remove()
                     stem.misc['SpaceAfter'] = ''
-                    mwt = root.create_multiword_token([stem, second], stem.form + second.form, mwtmisc)
+                    mwt = root.create_multiword_token([stem, second], form=stem.form + second.form, misc=mwtmisc)
                 else:
                     stem.form = prefix.form + '-' + stem.form
                     prefix.remove()
@@ -345,7 +345,7 @@ def fix_satu_satunya(self, node):
                         if mwt:
                             mwtmisc = mwt.misc.copy()
                             mwt.remove()
-                            mwt = root.create_multiword_token([satu0, nya], satu0.form + nya.form, mwtmisc)
+                            mwt = root.create_multiword_token([satu0, nya], form=satu0.form + nya.form, misc=mwtmisc)
                             satu0.misc['SpaceAfter'] = ''
                         root.text = root.compute_text()
         if node.multiword_token and node.no_space_after:
diff --git a/udapi/block/ud/joinasmwt.py b/udapi/block/ud/joinasmwt.py
index 8cedec68..be93bd3c 100644
--- a/udapi/block/ud/joinasmwt.py
+++ b/udapi/block/ud/joinasmwt.py
@@ -34,8 +34,8 @@ def should_join(self, node, next_node):
 
     def create_mwt(self, mwt_nodes):
         mwt_form = ''.join([n.form for n in mwt_nodes])
-        mwt = node.root.create_multiword_token(mwt_nodes, mwt_form)
-        if node.misc['SpaceAfter'] == 'No':
+        mwt = mwt_nodes[0].root.create_multiword_token(words=mwt_nodes, form=mwt_form)
+        if mwt_nodes[0].node.misc['SpaceAfter'] == 'No':
             mwt.misc['SpaceAfter'] = 'No'
         for mwt_node in mwt_nodes:
             del mwt_node.misc['SpaceAfter']

From 07e481683c5f8566dcbe1e73449733a7153e3796 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 5 Nov 2025 13:17:43 +0100
Subject: [PATCH 1308/1374] test both Python 3.9 and 3.13 in CircleCI

These are the oldest and newest versions (to be) supported.
---
 .circleci/config.yml | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 988f321d..ce25b22c 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -15,13 +15,16 @@ orbs:
 # See: https://circleci.com/docs/2.0/configuration-reference/#jobs
 jobs:
   build-and-test: # This is the name of the job, feel free to change it to better match what you're trying to do!
+    parameters:
+      python-version:
+        type: string
     # These next lines defines a Docker executors: https://circleci.com/docs/2.0/executor-types/
     # You can specify an image from Dockerhub or use one of the convenience images from CircleCI's Developer Hub
     # A list of available CircleCI Docker convenience images are available here: https://circleci.com/developer/images/image/cimg/python
     # The executor is the environment in which the steps below will be executed - below will use a python 3.10.2 container
     # Change the version below to your required version of python
     docker:
-      - image: cimg/python:3.9
+      - image: cimg/python:<< parameters.python-version >>
     # Checkout the code as the first step. This is a dedicated CircleCI step.
     # The python orb's install-packages step will install the dependencies from a Pipfile via Pipenv by default.
     # Here we're making sure we use just use the system-wide pip. By default it uses the project root's requirements.txt.
@@ -31,15 +34,12 @@ jobs:
       - checkout
       - python/install-packages:
           pkg-manager: pip
-          # app-dir: ~/project/package-directory/  # If you're requirements.txt isn't in the root directory.
-          # pip-dependency-file: test-requirements.txt  # if you have a different name for your requirements file, maybe one that combines your runtime and test requirements.
       - run:
           name: Install Udapi
           command: pip install ".[test]"
       - run: mkdir -p test-results
       - run:
           name: Run pytest tests
-          # This assumes pytest is installed via the install-package step above
           command: pytest --junitxml=test-results/junit.xml -o junit_family=legacy
       - store_test_results:
           path: test-results
@@ -54,7 +54,9 @@ jobs:
 # Invoke jobs via workflows
 # See: https://circleci.com/docs/2.0/configuration-reference/#workflows
 workflows:
-  sample: # This is the name of the workflow, feel free to change it to better match your workflow.
-    # Inside the workflow, you define the jobs you want to run.
+  test-matrix:
     jobs:
-      - build-and-test
+      - build-and-test:
+          matrix:
+            parameters:
+              python-version: ["3.9", "3.13"]

From 41ba4e302b33e20944e1bef2543a7e4f9b52fd72 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 5 Nov 2025 13:27:38 +0100
Subject: [PATCH 1309/1374] make udapy work in Python 3.13

The behavior of `exec` and `eval`
[has changed in Python 3.13](https://docs.python.org/3/whatsnew/3.13.html#defined-mutation-semantics-for-locals),
so now we need to provide explicit `namespace` for these calls.
---
 .circleci/config.yml | 2 +-
 udapi/core/run.py    | 9 +++++----
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index ce25b22c..9530d5c7 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -59,4 +59,4 @@ workflows:
       - build-and-test:
           matrix:
             parameters:
-              python-version: ["3.9", "3.13"]
+              python-version: ["3.9", "3.11", "3.13"]
diff --git a/udapi/core/run.py b/udapi/core/run.py
index 8ac63e1e..6453641c 100644
--- a/udapi/core/run.py
+++ b/udapi/core/run.py
@@ -99,9 +99,9 @@ def _import_blocks(block_names, block_args):
     :param block_args: A list of block arguments to be passed to block constructor.
     :return: A list of initialized objects.
     :rtype: list
-
     """
     blocks = []
+    namespace = {}  # Create a namespace dictionary to store imported classes
 
     for (block_id, block_name) in enumerate(block_names):
         # Importing module dynamically.
@@ -115,7 +115,7 @@ def _import_blocks(block_names, block_args):
         try:
             command = "from " + module + " import " + class_name + " as b" + str(block_id)
             logging.debug("Trying to run command: %s", command)
-            exec(command)  # pylint: disable=exec-used
+            exec(command, namespace)  # Pass namespace as globals
         except ModuleNotFoundError as err:
             package_name = ".".join(module.split(".")[:-1])
             package_blocks = _blocks_in_a_package(package_name)
@@ -130,10 +130,11 @@ def _import_blocks(block_names, block_args):
             raise
 
         # Run the imported module.
-        kwargs = block_args[block_id]  # pylint: disable=unused-variable
+        kwargs = block_args[block_id]
+        namespace['kwargs'] = kwargs  # Add kwargs to the namespace
         command = "b%s(**kwargs)" % block_id
         logging.debug("Trying to evaluate this: %s", command)
-        new_block_instance = eval(command)  # pylint: disable=eval-used
+        new_block_instance = eval(command, namespace)  # Pass namespace as globals
         args = ' '.join(f"{k}={v}" for k,v in kwargs.items())
         blocks.append((block_name, new_block_instance, args))
 

From e539295509e7044d6fa1877da5ee0ea8a5c6583e Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 5 Nov 2025 15:39:44 +0100
Subject: [PATCH 1310/1374] prepare udapi 0.5.1

---
 CHANGES.txt | 3 +++
 setup.cfg   | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/CHANGES.txt b/CHANGES.txt
index 3cc3d6db..98e26605 100644
--- a/CHANGES.txt
+++ b/CHANGES.txt
@@ -2,6 +2,9 @@ Udapi Change Log
 ----------------
 See https://github.com/udapi/udapi-python/commits/master for details.
 
+0.5.1 2025-11-05
+ - make udapy compatible with Python 3.13
+
 0.5.0 2025-10-18
  - added mwt.feats
  - added root.prev_tree and root.next_tree
diff --git a/setup.cfg b/setup.cfg
index e089eac2..fdbae292 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -1,6 +1,6 @@
 [metadata]
 name = udapi
-version = 0.5.0
+version = 0.5.1
 author = Martin Popel
 author_email = popel@ufal.mff.cuni.cz
 description = Python framework for processing Universal Dependencies data

From 702b47151750e27533de70a2208b240980605b1f Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 5 Nov 2025 17:34:39 +0100
Subject: [PATCH 1311/1374] Updated Old Czech tests.

---
 udapi/block/ud/cs/addmwt.py        | 12 ++++++++++++
 udapi/block/ud/cs/markfeatsbugs.py | 11 +++++++----
 udapi/block/ud/fixadvmodbyupos.py  | 12 +++++++++++-
 3 files changed, 30 insertions(+), 5 deletions(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 37c6d94e..38b8ae96 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -55,6 +55,18 @@
         'shape': 'subtree',
     }
 
+# Old Czech 'toliť' (special case with 3 subtokens; general -ť will be solved dynamically below).
+MWTS['toliť'] = {
+    'form':   'to li ť',
+    'lemma':  'ten li ť',
+    'upos':   'DET SCONJ PART',
+    'xpos':   '* J,------------- TT-------------',
+    'feats':  '* _ _',
+    'deprel': '* mark discourse',
+    'main':   0,
+    'shape':  'siblings'
+}
+
 
 
 class AddMwt(udapi.block.ud.addmwt.AddMwt):
diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index d353a127..0b9fc1b0 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -66,7 +66,7 @@ def process_node(self, node):
                     'Animacy': ['Anim', 'Inan'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'NameType': ['Giv', 'Sur', 'Geo', 'Nat'],
+                    'NameType': ['Giv', 'Sur', 'Geo', 'Nat', 'Com', 'Pro', 'Oth'],
                     'Foreign': ['Yes'],
                     'Abbr': ['Yes']})
             else:
@@ -74,7 +74,7 @@ def process_node(self, node):
                     'Gender': ['Masc', 'Fem', 'Neut'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
-                    'NameType': ['Giv', 'Sur', 'Geo', 'Nat'],
+                    'NameType': ['Giv', 'Sur', 'Geo', 'Nat', 'Com', 'Pro', 'Oth'],
                     'Foreign': ['Yes'],
                     'Abbr': ['Yes']})
         # ADJECTIVES ###########################################################
@@ -385,7 +385,9 @@ def process_node(self, node):
                 })
             # Relative possessive determiners 'jehož' and 'jejichž' behave similarly
             # to the personal possessive determiners but they do not have Person.
-            elif re.match(r'^(jeho|jejich|j[ií]ch)ž(e|to)?$', node.form.lower()):
+            # Normally determiners do not change j->n after prepositions but we
+            # have an example in Old Czech (štěpové zlatí, na nichžto větviech...)
+            elif re.match(r'^(jeho|jejich|[jn][ií]ch)ž(e|to)?$', node.form.lower()):
                 self.check_required_features(node, ['PronType', 'Poss', 'Number[psor]'])
                 self.check_allowed_features(node, {
                     'PronType': ['Rel'],
@@ -549,13 +551,14 @@ def process_node(self, node):
                 })
             else:
                 if node.feats['NumType'] == 'Sets':
-                    # 'jedny', 'dvoje', 'troje', 'čtvery'
+                    # 'jedny', 'dvoje', 'oboje', 'troje', 'čtvery'
                     # Number should perhaps be only Plur because the counted noun will be Plur.
                     # Gender is not annotated in PDT but there are different forms ('jedni' vs. 'jedny',
                     # and in Old Czech also 'dvoji' vs. 'dvoje'), so we should allow Gender (and Animacy).
                     self.check_required_features(node, ['NumType', 'NumForm', 'Number', 'Case'])
                     self.check_allowed_features(node, {
                         'NumType': ['Sets'],
+                        'PronType': ['Tot'], # for 'oboje'
                         'NumForm': ['Word'],
                         'Gender': ['Masc', 'Fem', 'Neut'],
                         'Animacy': ['Anim', 'Inan'],
diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index d6e51e1f..5a9fe7a0 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -69,6 +69,8 @@ def process_node(self, node):
                 node.deprel = 'nmod'
             elif node.upos == 'ADJ':
                 node.deprel = 'amod'
+            elif node.upos == 'NUM':
+                node.deprel = 'nummod'
             elif node.upos == 'ADV':
                 node.deprel = 'advmod'
             elif node.upos == 'AUX':
@@ -77,13 +79,21 @@ def process_node(self, node):
                 node.deprel = 'dep'
             elif node.upos == 'SCONJ':
                 node.deprel = 'mark'
+            elif node.upos == 'CCONJ':
+                node.deprel = 'cc'
             elif node.upos == 'X':
                 node.deprel = 'dep'
         elif node.udeprel == 'nummod':
-            if node.upos == 'PRON':
+            if node.upos == 'ADJ':
+                node.deprel = 'amod'
+            elif node.upos == 'PRON':
                 node.deprel = 'nmod'
             elif node.upos == 'DET':
                 node.deprel = 'det'
+            elif node.upos == 'ADP':
+                node.deprel = 'case'
         elif node.udeprel == 'punct':
             if node.upos != 'PUNCT':
                 node.deprel = 'dep'
+        elif node.udeprel == 'obl' and node.parent.upos in ['NOUN', 'PROPN', 'PRON'] and node.parent.udeprel in ['nsubj', 'obj', 'iobj', 'obl', 'vocative', 'dislocated', 'expl', 'nmod']:
+            node.deprel = 'nmod'

From b6533a05857510bb35bb85dc4707531e8e74190d Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 6 Nov 2025 15:49:12 +0100
Subject: [PATCH 1312/1374] Old Czech tests.

---
 udapi/block/ud/cs/addmwt.py        |  4 +++-
 udapi/block/ud/cs/markfeatsbugs.py | 36 ++++++++++++++++++++----------
 udapi/block/ud/fixadvmodbyupos.py  |  6 ++++-
 3 files changed, 32 insertions(+), 14 deletions(-)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 38b8ae96..967c5b1a 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -17,7 +17,9 @@
     'abychme': {'form': 'aby bychme', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=1|VerbForm=Fin'},
     'kdybychme': {'form': 'když bychme', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=1|VerbForm=Fin'},
     'abyste': {'form': 'aby byste', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=2|VerbForm=Fin'},
+    'abyšte': {'form': 'aby byšte', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=2|VerbForm=Fin'},
     'kdybyste': {'form': 'když byste', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=2|VerbForm=Fin'},
+    'kdybyšte': {'form': 'když byšte', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=2|VerbForm=Fin'},
     # Old Czech 'abyšta' == dual number; 2nd or 3rd person, the one example in data so far is 3rd.
     'abyšta': {'form': 'aby byšta', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Dual|Person=3|VerbForm=Fin'},
     'kdybyšta': {'form': 'když byšta', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Dual|Person=3|VerbForm=Fin'},
@@ -150,7 +152,7 @@ def multiword_analysis(self, node):
             # could be masculine or neuter. We pick Gender=Masc and Animacy=Anim
             # by default, unless the original token was annotated as Animacy=Inan
             # or Gender=Neut.
-            m = re.match(r"^(na|nade|o|pro|přěde|ski?rz[eě]|za)[nň](ž?)$", node.form.lower())
+            m = re.match(r"^(na|nade|o|po|pro|přěde|ski?rz[eě]|za)[nň](ž?)$", node.form.lower())
             if m:
                 node.misc['AddMwt'] = ''
                 # Remove vocalization from 'přěde' (přěd něj) but keep it in 'skrze'
diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 0b9fc1b0..bd55586e 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -91,7 +91,8 @@ def process_node(self, node):
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                         'NameType': ['Giv', 'Sur', 'Nat'], # for possessive adjectives derived from personal names
                         'Emph': ['Yes'],
-                        'Foreign': ['Yes']})
+                        'Foreign': ['Yes'],
+                        'Abbr': ['Yes']})
                 else:
                     self.check_required_features(node, ['Poss', 'Gender[psor]', 'Gender', 'Number', 'Case'])
                     self.check_allowed_features(node, {
@@ -102,7 +103,8 @@ def process_node(self, node):
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                         'NameType': ['Giv', 'Sur', 'Nat'], # for possessive adjectives derived from personal names
                         'Emph': ['Yes'],
-                        'Foreign': ['Yes']})
+                        'Foreign': ['Yes'],
+                        'Abbr': ['Yes']})
             elif node.feats['NumType'] == 'Ord' or node.feats['NumType'] == 'Mult': # ordinal numerals are a subtype of adjectives; same for some multiplicative numerals (dvojí, trojí)
                 if node.feats['Gender'] == 'Masc':
                     self.check_required_features(node, ['NumType', 'Gender', 'Animacy', 'Number', 'Case'])
@@ -114,7 +116,8 @@ def process_node(self, node):
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                         'Variant': ['Short'], # sedmer (Mult Short) duch tvój; pól čtverta (Ord Short) komára
                         'Emph': ['Yes'],
-                        'Foreign': ['Yes']})
+                        'Foreign': ['Yes'],
+                        'Abbr': ['Yes']})
                 else:
                     self.check_required_features(node, ['NumType', 'Gender', 'Number', 'Case'])
                     self.check_allowed_features(node, {
@@ -124,7 +127,8 @@ def process_node(self, node):
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
                         'Variant': ['Short'],
                         'Emph': ['Yes'],
-                        'Foreign': ['Yes']})
+                        'Foreign': ['Yes'],
+                        'Abbr': ['Yes']})
             elif node.feats['VerbForm'] == 'Part': # participles (except l-participles) are a subtype of adjectives
                 self.check_required_features(node, ['VerbForm', 'Voice'])
                 if node.feats['Voice'] == 'Act': # active participles have tense, passives don't but they have degree
@@ -143,7 +147,8 @@ def process_node(self, node):
                             'Polarity': ['Pos', 'Neg'],
                             'Variant': ['Short'],
                             'Emph': ['Yes'],
-                            'Foreign': ['Yes']})
+                            'Foreign': ['Yes'],
+                            'Abbr': ['Yes']})
                     else:
                         # Aspect is not required in general because it is omitted for participles of biaspectual verbs (e.g. 'analyzující').
                         self.check_required_features(node, ['VerbForm', 'Voice', 'Tense', 'Gender', 'Number', 'Case', 'Polarity'])
@@ -158,7 +163,8 @@ def process_node(self, node):
                             'Polarity': ['Pos', 'Neg'],
                             'Variant': ['Short'],
                             'Emph': ['Yes'],
-                            'Foreign': ['Yes']})
+                            'Foreign': ['Yes'],
+                            'Abbr': ['Yes']})
                 else:
                     if node.feats['Gender'] == 'Masc':
                         # Aspect is not required in general because it is omitted for participles of biaspectual verbs (e.g. 'analyzovaný').
@@ -175,7 +181,8 @@ def process_node(self, node):
                             'Degree': ['Pos', 'Cmp', 'Sup'],
                             'Variant': ['Short'],
                             'Emph': ['Yes'],
-                            'Foreign': ['Yes']})
+                            'Foreign': ['Yes'],
+                            'Abbr': ['Yes']})
                     else:
                         # Aspect is not required in general because it is omitted for participles of biaspectual verbs (e.g. 'analyzovaný').
                         self.check_required_features(node, ['VerbForm', 'Voice', 'Gender', 'Number', 'Case', 'Polarity', 'Degree'])
@@ -190,7 +197,8 @@ def process_node(self, node):
                             'Degree': ['Pos', 'Cmp', 'Sup'],
                             'Variant': ['Short'],
                             'Emph': ['Yes'],
-                            'Foreign': ['Yes']})
+                            'Foreign': ['Yes'],
+                            'Abbr': ['Yes']})
             else: # regular adjectives, including short forms
                 if node.feats['Gender'] == 'Masc':
                     self.check_required_features(node, ['Gender', 'Animacy', 'Number', 'Case', 'Degree', 'Polarity'])
@@ -203,7 +211,8 @@ def process_node(self, node):
                         'Polarity': ['Pos', 'Neg'],
                         'Variant': ['Short'],
                         'Emph': ['Yes'],
-                        'Foreign': ['Yes']})
+                        'Foreign': ['Yes'],
+                        'Abbr': ['Yes']})
                 else:
                     self.check_required_features(node, ['Gender', 'Number', 'Case', 'Degree', 'Polarity'])
                     self.check_allowed_features(node, {
@@ -214,7 +223,8 @@ def process_node(self, node):
                         'Polarity': ['Pos', 'Neg'],
                         'Variant': ['Short'],
                         'Emph': ['Yes'],
-                        'Foreign': ['Yes']})
+                        'Foreign': ['Yes'],
+                        'Abbr': ['Yes']})
         # PRONOUNS #############################################################
         elif node.upos == 'PRON':
             self.check_required_features(node, ['PronType'])
@@ -845,12 +855,14 @@ def process_node(self, node):
         # SUBORDINATING CONJUNCTIONS ###########################################
         elif node.upos == 'SCONJ':
             self.check_allowed_features(node, {
-                'Emph': ['Yes']
+                'Emph': ['Yes'],
+                'Abbr': ['Yes']
             })
         # COORDINATING CONJUNCTIONS ############################################
         elif node.upos == 'CCONJ':
             self.check_allowed_features(node, {
-                'Emph': ['Yes']
+                'Emph': ['Yes'],
+                'Abbr': ['Yes']
             })
         # PARTICLES ############################################################
         elif node.upos == 'PART':
diff --git a/udapi/block/ud/fixadvmodbyupos.py b/udapi/block/ud/fixadvmodbyupos.py
index 5a9fe7a0..a2e4439c 100644
--- a/udapi/block/ud/fixadvmodbyupos.py
+++ b/udapi/block/ud/fixadvmodbyupos.py
@@ -44,7 +44,9 @@ def process_node(self, node):
             if node.upos != 'AUX':
                 node.deprel = 'dep'
         elif node.udeprel == 'case':
-            if node.upos == 'DET':
+            if node.upos == 'ADJ':
+                node.deprel = 'amod'
+            elif node.upos == 'DET':
                 node.deprel = 'det'
             elif node.upos == 'PRON':
                 node.deprel = 'nmod'
@@ -64,6 +66,8 @@ def process_node(self, node):
                 node.deprel = 'det'
             elif node.upos == 'INTJ':
                 node.deprel = 'discourse'
+            elif node.upos == 'NOUN':
+                node.deprel = 'dep'
         elif node.udeprel == 'det':
             if node.upos == 'NOUN':
                 node.deprel = 'nmod'

From 5834bb56196f0a17108ebe1421b812cb108bda15 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Sat, 8 Nov 2025 15:30:25 +0100
Subject: [PATCH 1313/1374] Correct pluperfect detection

---
 udapi/block/msf/romance/romance.py | 22 +++-------------------
 1 file changed, 3 insertions(+), 19 deletions(-)

diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
index 81041e55..13e368eb 100644
--- a/udapi/block/msf/romance/romance.py
+++ b/udapi/block/msf/romance/romance.py
@@ -13,6 +13,7 @@ class Aspect(str, Enum):
     PERFPROG = 'PerfProg'
     PROG = 'Prog'
     PQP = 'Pqp'
+    PQPPROG = 'PqpProg'
 
 class Tense(str, Enum):
     FUT = 'Fut'
@@ -444,23 +445,6 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     polarity=polarity,
                     ords=phrase_ords)
                 return
-            
-            # Portuguese
-            # pretérito mais que perfeito composto (aux haver) -> PhraseTense=Past, PhraseAspect=Perf
-            if auxes[0].lemma == 'haver' and auxes[0].feats['Tense'] == 'Imp' and node.feats['VerbForm'] == 'Part':
-
-                self.write_node_info(head_node,
-                    tense=Tense.PAST.value,
-                    aspect=Aspect.PERF.value,
-                    number=auxes[0].feats['Number'],
-                    person=auxes[0].feats['Person'],
-                    mood=auxes[0].feats['Mood'],
-                    form='Fin',
-                    voice=head_node.feats['Voice'],
-                    expl=expl,
-                    polarity=polarity,
-                    ords=phrase_ords)
-                return
                 
             # Auxiliary 'estar' followed by a gerund 
             if node.feats['VerbForm'] == 'Ger':
@@ -531,7 +515,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                         tense=Tense.PAST.value
 
                 # Portuguese
-                # pretérito mais que perfeito composto (aux ter) -> PhraseTense=Past, PhraseAspect=Pqp
+                # pretérito mais que perfeito composto (aux ter/haver) -> PhraseTense=Past, PhraseAspect=Pqp
                 # subjonctive pretérito mais-que-perfeito composto (aux ter) -> PhraseTense=Past, PhraseAspect=Pqp, PhraseMood=Sub
 
                 # Spanish
@@ -682,7 +666,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                 # subjonctive Pretérito mais que perfeito composto -> PhraseTense=Past, PhraseAspect=ImpProg, PhraseMood=Sub
                 elif auxes[0].feats['Tense'] in ['Imp', 'Past']:
                     tense=Tense.PAST.value
-                    aspect=Aspect.IMPPROG.value
+                    aspect=Aspect.PQPPROG.value
 
                 # Futuro do presente composto -> PhraseTense=Fut, PhraseAspect=PerfProg
                 elif auxes[0].feats['Tense'] == 'Fut' and auxes[0].lemma == 'ter':

From 395cefc3b5c2ef6d41b750e5908fa4410e47782b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Nov 2025 16:42:43 +0100
Subject: [PATCH 1314/1374] Another attested form in 19th century: "abysi".

---
 udapi/block/ud/cs/addmwt.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 967c5b1a..a17e44e6 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -8,7 +8,9 @@
     'abych': {'form': 'aby bych', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Sing|Person=1|VerbForm=Fin'},
     'kdybych': {'form': 'když bych', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Sing|Person=1|VerbForm=Fin'},
     'abys': {'form': 'aby bys', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Sing|Person=2|VerbForm=Fin'},
+    'abysi': {'form': 'aby bys', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Sing|Person=2|VerbForm=Fin'},
     'kdybys': {'form': 'když bys', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Sing|Person=2|VerbForm=Fin'},
+    'kdybysi': {'form': 'když bys', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Sing|Person=2|VerbForm=Fin'},
     'aby': {'form': 'aby by', 'feats': '_ Aspect=Imp|Mood=Cnd|VerbForm=Fin'},
     'kdyby': {'form': 'když by', 'feats': '_ Aspect=Imp|Mood=Cnd|VerbForm=Fin'},
     'abychom': {'form': 'aby bychom', 'feats': '_ Aspect=Imp|Mood=Cnd|Number=Plur|Person=1|VerbForm=Fin'},

From d724abeec278feb084eff8a36bf959cd5c3fe936 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 9 Nov 2025 17:03:42 +0100
Subject: [PATCH 1315/1374] =?UTF-8?q?se=C4=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/addmwt.py | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index a17e44e6..7edaca2c 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -58,6 +58,18 @@
         'main': 1,
         'shape': 'subtree',
     }
+# In 19th century texts (Hičkok etalon), one instance of 'seč' was also split (and annotated as ADP + accusative!)
+# We must do it separately, as the preposition is vocalized.
+MWTS['seč'] = {
+    'form': 'se' + ' co',
+    'lemma': 's' + ' co',
+    'upos': 'ADP PRON',
+    'xpos': 'RV--4---------- PQ--4----------',
+    'feats': 'AdpType=Voc|Case=Acc Animacy=Inan|Case=Acc|PronType=Int,Rel',
+    'deprel': 'case *',
+    'main': 1,
+    'shape': 'subtree',
+}
 
 # Old Czech 'toliť' (special case with 3 subtokens; general -ť will be solved dynamically below).
 MWTS['toliť'] = {

From 99160467f23447a2083205beb778579ed7dc4093 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Nov 2025 15:44:51 +0100
Subject: [PATCH 1316/1374] Added a block to make morphology in Czech UD more
 consistent.

---
 udapi/block/ud/cs/fixmorpho.py | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 udapi/block/ud/cs/fixmorpho.py

diff --git a/udapi/block/ud/cs/fixmorpho.py b/udapi/block/ud/cs/fixmorpho.py
new file mode 100644
index 00000000..9d737e22
--- /dev/null
+++ b/udapi/block/ud/cs/fixmorpho.py
@@ -0,0 +1,21 @@
+"""
+A Czech-specific block to fix lemmas, UPOS and morphological features in UD.
+It should increase consistency across the Czech treebanks. It focuses on
+individual closed-class verbs (such as the auxiliary "být") or on entire classes
+of words (e.g. whether or not nouns should have the Polarity feature). It was
+created as part of the Hičkok project (while importing nineteenth-century Czech
+data) but it should be applicable on any other Czech treebank.
+"""
+import udapi.block.ud.fixmorpho
+import re
+
+class FixMorpho(udapi.block):
+
+    def process_node(self, node):
+        # In Czech UD, "být" is always tagged as AUX and never as VERB, regardless
+        # of the fact that it can participate in purely existential constructions
+        # where it no longer acts as a copula. Czech tagsets typically do not
+        # distinguish AUX from VERB, which means that converted data may have to
+        # be fixed.
+        if node.upos == 'VERB' and node.lemma == 'být':
+            node.upos = 'AUX'

From 85a7130af4b5ca4db235d2dc9c7ca1b64b92fbf1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Nov 2025 15:49:13 +0100
Subject: [PATCH 1317/1374] Bug fix.

---
 udapi/block/ud/cs/fixmorpho.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/fixmorpho.py b/udapi/block/ud/cs/fixmorpho.py
index 9d737e22..fcf6b0df 100644
--- a/udapi/block/ud/cs/fixmorpho.py
+++ b/udapi/block/ud/cs/fixmorpho.py
@@ -6,7 +6,7 @@
 created as part of the Hičkok project (while importing nineteenth-century Czech
 data) but it should be applicable on any other Czech treebank.
 """
-import udapi.block.ud.fixmorpho
+import udapi.block
 import re
 
 class FixMorpho(udapi.block):

From cd4b706cdfd752221c23e09be177891fe3620a02 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Nov 2025 16:51:57 +0100
Subject: [PATCH 1318/1374] Fix reflexive pronouns (particles) in Czech.

---
 udapi/block/ud/cs/fixmorpho.py | 30 ++++++++++++++++++++++++++++--
 1 file changed, 28 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/cs/fixmorpho.py b/udapi/block/ud/cs/fixmorpho.py
index fcf6b0df..da7e52f4 100644
--- a/udapi/block/ud/cs/fixmorpho.py
+++ b/udapi/block/ud/cs/fixmorpho.py
@@ -6,12 +6,38 @@
 created as part of the Hičkok project (while importing nineteenth-century Czech
 data) but it should be applicable on any other Czech treebank.
 """
-import udapi.block
+from udapi.core.block import Block
+import logging
 import re
 
-class FixMorpho(udapi.block):
+class FixMorpho(Block):
 
     def process_node(self, node):
+        # Do not touch words marked as Foreign or Typo. They may not behave the
+        # way we expect in Czech data.
+        if node.feats['Foreign'] == 'Yes' or node.feats['Typo'] == 'Yes':
+            return
+        # Nouns do not have polarity but the Prague-style tagsets may mark it.
+        if node.upos in ['NOUN', 'PROPN']:
+            if node.feats['Polarity'] == 'Pos':
+                node.feats['Polarity'] = ''
+            elif node.feats['Polarity'] == 'Neg':
+                logging.warn(f'To remove Polarity=Neg from the NOUN {node.form}, we may have to change its lemma ({node.lemma}).')
+        # In 19th century data, the grammaticalized usages of "se", "si" are
+        # tagged as PART (rather than a reflexive PRON, which is the standard).
+        # Even if it already was tagged PRON, some features may have to be added.
+        if node.upos in ['PRON', 'PART'] and node.form.lower() in ['se', 'si']:
+            node.lemma = 'se'
+            node.upos = 'PRON'
+            node.feats['PronType'] = 'Prs'
+            node.feats['Reflex'] = 'Yes'
+            if node.form.lower() == 'se':
+                # Occasionally "se" can be genitive: "z prudkého do se dorážení".
+                if not node.feats['Case'] == 'Gen':
+                    node.feats['Case'] = 'Acc'
+            else:
+                node.feats['Case'] = 'Dat'
+            node.feats['Variant'] = 'Short'
         # In Czech UD, "být" is always tagged as AUX and never as VERB, regardless
         # of the fact that it can participate in purely existential constructions
         # where it no longer acts as a copula. Czech tagsets typically do not

From 28177c513619878651963dd36f520fd029ad97f1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 11 Nov 2025 23:58:55 +0100
Subject: [PATCH 1319/1374] Various fixes.

---
 udapi/block/ud/cs/fixmorpho.py | 97 ++++++++++++++++++++++++++++++++++
 1 file changed, 97 insertions(+)

diff --git a/udapi/block/ud/cs/fixmorpho.py b/udapi/block/ud/cs/fixmorpho.py
index da7e52f4..cb8a7e9f 100644
--- a/udapi/block/ud/cs/fixmorpho.py
+++ b/udapi/block/ud/cs/fixmorpho.py
@@ -23,6 +23,24 @@ def process_node(self, node):
                 node.feats['Polarity'] = ''
             elif node.feats['Polarity'] == 'Neg':
                 logging.warn(f'To remove Polarity=Neg from the NOUN {node.form}, we may have to change its lemma ({node.lemma}).')
+        # Clitic forms of personal pronouns have Variant=Short if there is also a longer, full form.
+        if node.upos == 'PRON' and node.feats['PronType'] == 'Prs' and re.fullmatch(r'(mi|mě|ti|tě|si|se|ho|mu)', node.form.lower()):
+            node.feats['Variant'] = 'Short'
+        # Forms of "my" should be lemmatized as "já".
+        if node.upos == 'PRON' and node.lemma == 'my':
+            node.lemma = 'já'
+        # Forms of "vy" should be lemmatized as "ty".
+        if node.upos == 'PRON' and node.lemma == 'vy':
+            node.lemma = 'ty'
+        # Forms of "oni" should be lemmatized as "on" and cases that allow
+        # a preposition should have PrepCase.
+        if node.upos == 'PRON' and node.lemma in ['on', 'oni']:
+            node.lemma = 'on'
+            if node.feats['Case'] not in ['Nom', 'Voc']:
+                if node.form.lower().startswith('j'):
+                    node.feats['PrepCase'] = 'Npr'
+                elif re.match(r'[nň]', node.form.lower()):
+                    node.feats['PrepCase'] = 'Pre'
         # In 19th century data, the grammaticalized usages of "se", "si" are
         # tagged as PART (rather than a reflexive PRON, which is the standard).
         # Even if it already was tagged PRON, some features may have to be added.
@@ -38,6 +56,76 @@ def process_node(self, node):
             else:
                 node.feats['Case'] = 'Dat'
             node.feats['Variant'] = 'Short'
+        # As the genitive/accusative form of "on", "jeho" should have PrepCase.
+        if node.upos == 'PRON' and node.form.lower() == 'jeho':
+            node.feats['PrepCase'] = 'Npr'
+        # Possessive pronouns have Person, Gender[psor] and Number[psor].
+        if node.upos == 'DET' and node.feats['Poss'] == 'Yes':
+            if node.lemma == 'můj':
+                node.feats['Person'] = '1'
+                node.feats['Number[psor]'] = 'Sing'
+            elif node.lemma == 'tvůj':
+                node.feats['Person'] = '2'
+                node.feats['Number[psor]'] = 'Sing'
+            elif node.lemma == 'náš':
+                node.feats['Person'] = '1'
+                node.feats['Number[psor]'] = 'Plur'
+            elif node.lemma == 'váš':
+                node.feats['Person'] = '2'
+                node.feats['Number[psor]'] = 'Plur'
+            elif node.form.lower() == 'jeho':
+                node.feats['Person'] = '3'
+                node.feats['Number[psor]'] = 'Sing'
+                node.feats['Gender[psor]'] = 'Masc,Neut'
+            elif re.fullmatch(r'jich|jejich', node.form.lower()):
+                node.lemma = 'jeho'
+                node.feats['Person'] = '3'
+                node.feats['Number[psor]'] = 'Plur'
+        # Reflexive possessive pronoun should not forget the Reflex=Yes feature.
+        if node.upos == 'DET' and node.lemma == 'svůj':
+            node.feats['Reflex'] = 'Yes'
+        # Relative pronoun "jenž" should be PRON, not DET
+        # (it inflects for Gender but it can never be used as congruent attribute).
+        if node.upos in ['PRON', 'DET'] and node.lemma == 'jenž':
+            node.upos = 'PRON'
+            if node.form.lower().startswith('j'):
+                node.feats['PrepCase'] = 'Npr'
+            else:
+                node.feats['PrepCase'] = 'Pre'
+        # Pronoun "sám" is lemmatized to the long form, it is DET and PronType=Emp.
+        if node.upos in ['PRON', 'DET'] and node.lemma == 'sám':
+            node.lemma = 'samý'
+            node.upos = 'DET'
+            node.feats['PronType'] = 'Emp'
+            node.feats['Variant'] = 'Short' if re.fullmatch(r'(sám|sama|samo|sami|samy|samu)', node.form.lower()) else ''
+        # Pronominal cardinal numerals should be DET, not NUM.
+        if node.upos == 'NUM':
+            if re.fullmatch(r'(mnoho|málo|několik)', node.lemma):
+                node.upos = 'DET'
+                node.feats['PronType'] = 'Ind'
+                node.feats['NumForm'] = ''
+                node.feats['Polarity'] = '' ###!!! so we are losing the distinction mnoho/nemnoho?
+            elif re.fullmatch(r'(tolik)', node.lemma):
+                node.upos = 'DET'
+                node.feats['PronType'] = 'Dem'
+                node.feats['NumForm'] = ''
+                node.feats['Polarity'] = ''
+            elif re.fullmatch(r'(kolik)', node.lemma):
+                node.upos = 'DET'
+                node.feats['PronType'] = 'Int,Rel'
+                node.feats['NumForm'] = ''
+                node.feats['Polarity'] = ''
+        # Pronominal adverbs have PronType but most of them do not have Degree
+        # and Polarity.
+        if node.upos == 'ADV':
+            if re.fullmatch(r'(tady|tak|tam|teď|tehdy|tu)', node.lemma):
+                node.feats['PronType'] = 'Dem'
+                node.feats['Degree'] = ''
+                node.feats['Polarity'] = ''
+            elif re.fullmatch(r'(dokdy|jak|kam|kde|kdy|kudy|odkdy|odkud|proč)', node.lemma):
+                node.feats['PronType'] = 'Int,Rel'
+                node.feats['Degree'] = ''
+                node.feats['Polarity'] = ''
         # In Czech UD, "být" is always tagged as AUX and never as VERB, regardless
         # of the fact that it can participate in purely existential constructions
         # where it no longer acts as a copula. Czech tagsets typically do not
@@ -45,3 +133,12 @@ def process_node(self, node):
         # be fixed.
         if node.upos == 'VERB' and node.lemma == 'být':
             node.upos = 'AUX'
+        # Present forms of perfective verbs normally have Tense=Pres despite
+        # meaning future. However, a few imperfective verbs have a separate
+        # future form (distinct from present form), which gets Tense=Fut
+        # despite inflecting similarly to present forms.
+        if node.upos in ['VERB', 'AUX'] and node.feats['Mood'] == 'Ind' and node.feats['Tense'] == 'Pres' and node.feats['Aspect'] != 'Perf' and re.match(r'((bud|půjd|pojed|polez)(u|eš|e|eme?|ete|ou)|polet(ím|íš|í|íme|íte))', node.form.lower()):
+            node.feats['Tense'] = 'Fut'
+        # "jako" should be SCONJ but 19th century data have it as PART.
+        if node.upos == 'PART' and node.lemma == 'jako':
+            node.upos = 'SCONJ'

From 2e26921a8adfa24e6ae70b8a29526e0c2973c606 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 12 Nov 2025 18:55:38 +0100
Subject: [PATCH 1320/1374] Many rule-based fixes for Czech UD.

---
 udapi/block/ud/cs/fixmorpho.py | 343 ++++++++++++++++++++++++++++++---
 1 file changed, 315 insertions(+), 28 deletions(-)

diff --git a/udapi/block/ud/cs/fixmorpho.py b/udapi/block/ud/cs/fixmorpho.py
index cb8a7e9f..99a2e670 100644
--- a/udapi/block/ud/cs/fixmorpho.py
+++ b/udapi/block/ud/cs/fixmorpho.py
@@ -17,12 +17,41 @@ def process_node(self, node):
         # way we expect in Czech data.
         if node.feats['Foreign'] == 'Yes' or node.feats['Typo'] == 'Yes':
             return
+        #----------------------------------------------------------------------
+        # NOUNS, PROPER NOUNS, AND ADJECTIVES
+        #----------------------------------------------------------------------
         # Nouns do not have polarity but the Prague-style tagsets may mark it.
         if node.upos in ['NOUN', 'PROPN']:
             if node.feats['Polarity'] == 'Pos':
                 node.feats['Polarity'] = ''
             elif node.feats['Polarity'] == 'Neg':
                 logging.warn(f'To remove Polarity=Neg from the NOUN {node.form}, we may have to change its lemma ({node.lemma}).')
+        # For some nouns, there is disagreement in whether to tag and lemmatize
+        # them as proper nouns. We must be careful and not add too many to this
+        # rule, as many of them could be used as surnames and then they should
+        # be PROPN.
+        if node.upos == 'PROPN' and re.fullmatch(r'(bůh|duch|hospodin|město|milost|pán|panna)', node.lemma.lower()):
+            node.lemma = node.lemma.lower()
+            node.upos = 'NOUN'
+        # Lemmatization.
+        if node.upos == 'NOUN' and node.lemma == 'zem':
+            node.lemma = 'země'
+        if node.upos == 'ADJ':
+            # Adjectives should be lemmatized to lowercase even if they are part of
+            # a multiword name, e.g., "Malá" in "Malá Strana" should be lemmatized
+            # to "malý". Exception: Possessive adjectives derived from personal
+            # names, e.g., "Karlův".
+            if node.feats['Poss'] != 'Yes':
+                node.lemma = node.lemma.lower()
+            # Short forms of adjectives are rare in Modern Czech and uninflected
+            # (they are used as predicates), so they lack the Case feature. But
+            # they were inflected for Case in the past, so it is better to add
+            # Case=Nom for consistency.
+            if node.feats['Variant'] == 'Short' and node.feats['Case'] == '':
+                node.feats['Case'] = 'Nom'
+        #----------------------------------------------------------------------
+        # PRONOUNS AND DETERMINERS
+        #----------------------------------------------------------------------
         # Clitic forms of personal pronouns have Variant=Short if there is also a longer, full form.
         if node.upos == 'PRON' and node.feats['PronType'] == 'Prs' and re.fullmatch(r'(mi|mě|ti|tě|si|se|ho|mu)', node.form.lower()):
             node.feats['Variant'] = 'Short'
@@ -60,44 +89,181 @@ def process_node(self, node):
         if node.upos == 'PRON' and node.form.lower() == 'jeho':
             node.feats['PrepCase'] = 'Npr'
         # Possessive pronouns have Person, Gender[psor] and Number[psor].
+        # Although it is questionable, plural possessors are lemmatized to singular
+        # possessors in an analogy to personal pronouns: "my" --> "já", "náš" --> "můj".
+        # Some source corpora lack Person and [psor] features, others do not respect
+        # the lemmatization rule, so in the end we have to look at the forms; but
+        # there are potentially many variants, especially in old texts.
         if node.upos == 'DET' and node.feats['Poss'] == 'Yes':
-            if node.lemma == 'můj':
+            if node.form.lower().startswith('m'):
+                # můj muoj mój mého mému mém mým moje má mojí mé moji mou mí mých mými
                 node.feats['Person'] = '1'
                 node.feats['Number[psor]'] = 'Sing'
-            elif node.lemma == 'tvůj':
+            elif node.form.lower().startswith('t'):
+                # tvůj tvuoj tvój tvého tvému tvém tvým tvoje tvá tvojí tvé tvoji tvou tví tvých tvými
                 node.feats['Person'] = '2'
                 node.feats['Number[psor]'] = 'Sing'
-            elif node.lemma == 'náš':
+            elif node.form.lower().startswith('n'):
+                # náš našeho našemu našem naším naše naší naši našich našim našimi
+                node.lemma = 'můj'
                 node.feats['Person'] = '1'
                 node.feats['Number[psor]'] = 'Plur'
-            elif node.lemma == 'váš':
+            elif node.form.lower().startswith('v'):
+                # váš vašeho vašemu vašem vaším vaše vaší vaši vašich vašim vašimi
+                node.lemma = 'tvůj'
                 node.feats['Person'] = '2'
                 node.feats['Number[psor]'] = 'Plur'
             elif node.form.lower() == 'jeho':
                 node.feats['Person'] = '3'
                 node.feats['Number[psor]'] = 'Sing'
-                node.feats['Gender[psor]'] = 'Masc,Neut'
+                if not re.search(r'(Masc|Neut)', node.feats['Gender[psor]']):
+                    node.feats['Gender[psor]'] = 'Masc,Neut'
+            elif re.fullmatch(r'jehož', node.form.lower()):
+                node.lemma = 'jehož'
+                node.feats['PronType'] = 'Rel'
+                node.feats['Number[psor]'] = 'Sing'
+                if not re.search(r'(Masc|Neut)', node.feats['Gender[psor]']):
+                    node.feats['Gender[psor]'] = 'Masc,Neut'
+            elif node.form.lower() == 'její':
+                node.lemma = 'jeho'
+                node.feats['Person'] = '3'
+                node.feats['Number[psor]'] = 'Sing'
+                node.feats['Gender[psor]'] = 'Fem'
+            elif re.fullmatch(r'jejíž', node.form.lower()):
+                node.lemma = 'jehož'
+                node.feats['PronType'] = 'Rel'
+                node.feats['Number[psor]'] = 'Sing'
+                node.feats['Gender[psor]'] = 'Fem'
             elif re.fullmatch(r'jich|jejich', node.form.lower()):
                 node.lemma = 'jeho'
                 node.feats['Person'] = '3'
                 node.feats['Number[psor]'] = 'Plur'
+            elif re.fullmatch(r'jichž|jejichž', node.form.lower()):
+                node.lemma = 'jehož'
+                node.feats['PronType'] = 'Rel'
+                node.feats['Number[psor]'] = 'Plur'
         # Reflexive possessive pronoun should not forget the Reflex=Yes feature.
         if node.upos == 'DET' and node.lemma == 'svůj':
             node.feats['Reflex'] = 'Yes'
-        # Relative pronoun "jenž" should be PRON, not DET
-        # (it inflects for Gender but it can never be used as congruent attribute).
-        if node.upos in ['PRON', 'DET'] and node.lemma == 'jenž':
-            node.upos = 'PRON'
-            if node.form.lower().startswith('j'):
+        # Demonstrative, interrogative, relative, negative, total and indefinite
+        # pronouns (or determiners, because some of them get the DET tag).
+        if node.upos in ['PRON', 'DET']:
+            # Relative pronoun "jenž" should be PRON, not DET
+            # (it inflects for Gender but it can never be used as congruent attribute).
+            if node.lemma == 'jenž':
+                node.upos = 'PRON'
+                if node.form.lower().startswith('j'):
+                    node.feats['PrepCase'] = 'Npr'
+                else:
+                    node.feats['PrepCase'] = 'Pre'
+            # Relative pronoun "ješto" should be PRON, not DET (if it is not SCONJ, but that was excluded by a condition above)
+            # (it inflects for Gender but it can never be used as congruent attribute).
+            elif node.form.lower() == 'ješto':
+                node.lemma = 'jenžto'
+                node.upos = 'PRON'
                 node.feats['PrepCase'] = 'Npr'
-            else:
-                node.feats['PrepCase'] = 'Pre'
-        # Pronoun "sám" is lemmatized to the long form, it is DET and PronType=Emp.
-        if node.upos in ['PRON', 'DET'] and node.lemma == 'sám':
-            node.lemma = 'samý'
-            node.upos = 'DET'
-            node.feats['PronType'] = 'Emp'
-            node.feats['Variant'] = 'Short' if re.fullmatch(r'(sám|sama|samo|sami|samy|samu)', node.form.lower()) else ''
+            # Pronoun "kdo" is PRON (not DET).
+            elif node.lemma == 'kdo':
+                node.lemma = 'kdo'
+                node.upos = 'PRON'
+                if node.feats['PronType'] == '':
+                    node.feats['PronType'] = 'Int,Rel'
+                # Unlike "co", we annotate "kdo" as Animacy=Anim|Gender=Masc.
+                # However, we do not annotate Number ("kdo" can be the subject of a plural verb).
+                node.feats['Gender'] = 'Masc'
+                node.feats['Animacy'] = 'Anim'
+                node.feats['Number'] = ''
+            # Pronoun "někdo", "kdosi" is PRON (not DET).
+            elif re.fullmatch(r'(kdosi|někdo)', node.lemma):
+                node.upos = 'PRON'
+                node.feats['PronType'] = 'Ind'
+                # Unlike "co", we annotate "kdo" as Animacy=Anim|Gender=Masc.
+                # However, we do not annotate Number ("kdo" can be the subject of a plural verb).
+                node.feats['Gender'] = 'Masc'
+                node.feats['Animacy'] = 'Anim'
+                node.feats['Number'] = ''
+            # Pronoun "nikdo" is PRON (not DET).
+            elif node.lemma == 'nikdo':
+                node.lemma = 'nikdo'
+                node.upos = 'PRON'
+                node.feats['PronType'] = 'Neg'
+                # Unlike "co", we annotate "kdo" as Animacy=Anim|Gender=Masc.
+                # However, we do not annotate Number ("kdo" can be the subject of a plural verb).
+                node.feats['Gender'] = 'Masc'
+                node.feats['Animacy'] = 'Anim'
+                node.feats['Number'] = ''
+            # Pronoun "co" is PRON (not DET).
+            elif node.lemma == 'co':
+                node.lemma = 'co'
+                node.upos = 'PRON'
+                if node.feats['PronType'] == '':
+                    node.feats['PronType'] = 'Int,Rel'
+                # We do not annotate Gender and Number, although it could be argued
+                # to be Gender=Neut|Number=Sing.
+                node.feats['Gender'] = ''
+                node.feats['Animacy'] = ''
+                node.feats['Number'] = ''
+            # Pronoun "což" is PRON (not DET).
+            elif node.lemma == 'což':
+                node.lemma = 'což'
+                node.upos = 'PRON'
+                if node.feats['PronType'] == '':
+                    node.feats['PronType'] = 'Rel'
+                # We do not annotate Gender and Number, although it could be argued
+                # to be Gender=Neut|Number=Sing.
+                node.feats['Gender'] = ''
+                node.feats['Animacy'] = ''
+                node.feats['Number'] = ''
+            # Pronoun "něco" is PRON (not DET).
+            elif re.fullmatch(r'(cosi|něco)', node.lemma):
+                node.upos = 'PRON'
+                node.feats['PronType'] = 'Ind'
+                # We do not annotate Gender and Number, although it could be argued
+                # to be Gender=Neut|Number=Sing.
+                node.feats['Gender'] = ''
+                node.feats['Animacy'] = ''
+                node.feats['Number'] = ''
+            # Pronoun "nic" is PRON (not DET).
+            elif node.lemma == 'nic':
+                node.lemma = 'nic'
+                node.upos = 'PRON'
+                node.feats['PronType'] = 'Neg'
+                # We do not annotate Gender and Number, although it could be argued
+                # to be Gender=Neut|Number=Sing.
+                node.feats['Gender'] = ''
+                node.feats['Animacy'] = ''
+                node.feats['Number'] = ''
+            # Pronoun "týž" is DET and PronType=Dem.
+            elif re.fullmatch(r'(tentýž|týž)', node.lemma):
+                node.upos = 'DET'
+                node.feats['PronType'] = 'Dem'
+            # Pronoun "každý" is DET and PronType=Tot.
+            elif node.lemma == 'každý':
+                node.upos = 'DET'
+                node.feats['PronType'] = 'Tot'
+            # Pronoun "vše" is lemmatized to "všechen", it is DET and PronType=Tot.
+            elif node.form.lower() == 'vše':
+                node.lemma = 'všechen'
+                node.upos = 'DET'
+                node.feats['PronType'] = 'Tot'
+            elif node.lemma == 'všechen':
+                node.upos = 'DET'
+                node.feats['PronType'] = 'Tot'
+            # Pronoun "sám" is lemmatized to the long form, it is DET and PronType=Emp.
+            elif node.lemma in ['sám', 'samý']:
+                node.lemma = 'samý'
+                node.upos = 'DET'
+                node.feats['PronType'] = 'Emp'
+                node.feats['Variant'] = 'Short' if re.fullmatch(r'(sám|sama|samo|sami|samy|samu)', node.form.lower()) else ''
+        #----------------------------------------------------------------------
+        # PRONOMINAL NUMERALS AND ADVERBS
+        #----------------------------------------------------------------------
+        # The numeral "oba" should be NUM, not PRON or DET. But it should have PronType=Tot.
+        if node.upos in ['NUM', 'PRON', 'DET'] and node.lemma == 'oba':
+            node.upos = 'NUM'
+            node.feats['NumType'] = 'Card'
+            node.feats['NumForm'] = 'Word'
+            node.feats['PronType'] = 'Tot'
         # Pronominal cardinal numerals should be DET, not NUM.
         if node.upos == 'NUM':
             if re.fullmatch(r'(mnoho|málo|několik)', node.lemma):
@@ -112,20 +278,56 @@ def process_node(self, node):
                 node.feats['Polarity'] = ''
             elif re.fullmatch(r'(kolik)', node.lemma):
                 node.upos = 'DET'
-                node.feats['PronType'] = 'Int,Rel'
+                if node.feats['PronType'] == '':
+                    node.feats['PronType'] = 'Int,Rel'
                 node.feats['NumForm'] = ''
                 node.feats['Polarity'] = ''
+        if node.upos in ['ADV', 'NUM']:
+            if re.fullmatch(r'(mnoho|málo|několi)krát', node.lemma):
+                node.upos = 'ADV'
+                node.feats['NumType'] = 'Mult'
+                node.feats['PronType'] = 'Ind'
+            elif re.fullmatch(r'(tolikrát)', node.lemma):
+                node.upos = 'ADV'
+                node.feats['NumType'] = 'Mult'
+                node.feats['PronType'] = 'Dem'
+            elif re.fullmatch(r'(kolikrát)', node.lemma):
+                node.upos = 'ADV'
+                node.feats['NumType'] = 'Mult'
+                if node.feats['PronType'] == '':
+                    node.feats['PronType'] = 'Int,Rel'
         # Pronominal adverbs have PronType but most of them do not have Degree
         # and Polarity.
         if node.upos == 'ADV':
-            if re.fullmatch(r'(tady|tak|tam|teď|tehdy|tu)', node.lemma):
+            if re.fullmatch(r'(dosud|nyní|proto|sem|tady|tak|takto|tam|teď|tehdy|tenkrát|tu|zde)', node.lemma):
                 node.feats['PronType'] = 'Dem'
                 node.feats['Degree'] = ''
                 node.feats['Polarity'] = ''
-            elif re.fullmatch(r'(dokdy|jak|kam|kde|kdy|kudy|odkdy|odkud|proč)', node.lemma):
-                node.feats['PronType'] = 'Int,Rel'
+            elif re.fullmatch(r'(dokdy|dokud|jak|kam|kde|kdy|kterak|kudy|odkdy|odkud|proč)', node.lemma):
+                if node.feats['PronType'] == '':
+                    node.feats['PronType'] = 'Int,Rel'
+                node.feats['Degree'] = ''
+                node.feats['Polarity'] = ''
+            elif re.fullmatch(r'(kdežto)', node.lemma):
+                node.feats['PronType'] = 'Rel'
+                node.feats['Degree'] = ''
+                node.feats['Polarity'] = ''
+            elif re.fullmatch(r'(jaksi|kamsi|kdesi|kdysi|kudysi|nějak|někam|někde|někdy|někudy)', node.lemma):
+                node.feats['PronType'] = 'Ind'
+                node.feats['Degree'] = ''
+                node.feats['Polarity'] = ''
+            elif re.fullmatch(r'(nijak|nikam|nikde|nikdy|nikudy)', node.lemma):
+                node.feats['PronType'] = 'Neg'
                 node.feats['Degree'] = ''
                 node.feats['Polarity'] = ''
+            # Total pronominals can be negated ("nevždy"). Then they get Degree, too.
+            elif re.fullmatch(r'(všude|všudy|ve?ždy|ve?ždycky)', node.lemma):
+                node.feats['PronType'] = 'Tot'
+                node.feats['Degree'] = 'Pos'
+                node.feats['Polarity'] = 'Pos'
+        #----------------------------------------------------------------------
+        # VERBS AND AUXILIARIES
+        #----------------------------------------------------------------------
         # In Czech UD, "být" is always tagged as AUX and never as VERB, regardless
         # of the fact that it can participate in purely existential constructions
         # where it no longer acts as a copula. Czech tagsets typically do not
@@ -133,12 +335,97 @@ def process_node(self, node):
         # be fixed.
         if node.upos == 'VERB' and node.lemma == 'být':
             node.upos = 'AUX'
-        # Present forms of perfective verbs normally have Tense=Pres despite
-        # meaning future. However, a few imperfective verbs have a separate
-        # future form (distinct from present form), which gets Tense=Fut
-        # despite inflecting similarly to present forms.
-        if node.upos in ['VERB', 'AUX'] and node.feats['Mood'] == 'Ind' and node.feats['Tense'] == 'Pres' and node.feats['Aspect'] != 'Perf' and re.match(r'((bud|půjd|pojed|polez)(u|eš|e|eme?|ete|ou)|polet(ím|íš|í|íme|íte))', node.form.lower()):
-            node.feats['Tense'] = 'Fut'
+        if node.upos in ['ADV', 'VERB'] and re.fullmatch(r'(ne)?lze', node.form.lower()):
+            node.upos = 'ADV'
+            node.lemma = 'lze' # not 'nelze'
+            node.feats['VerbForm'] = ''
+            node.feats['Voice'] = ''
+            node.feats['Aspect'] = ''
+            node.feats['Mood'] = ''
+            node.feats['Tense'] = ''
+            node.feats['Person'] = ''
+            node.feats['Number'] = ''
+            node.feats['Degree'] = 'Pos'
+        if node.upos in ['VERB', 'AUX']:
+            # Most non-passive verb forms have Voice=Act, and infinitives should
+            # have it, too. Passive infinitives are always periphrastic.
+            # (This is not done in the PDT tagset, but we should add it.)
+            if node.feats['VerbForm'] == 'Inf':
+                node.feats['Voice'] = 'Act'
+            # Same for imperatives.
+            elif node.feats['Mood'] == 'Imp':
+                node.feats['Voice'] = 'Act'
+            # Some verbs lack the Aspect feature although they are not biaspectual.
+            if node.feats['Aspect'] == '':
+                if re.fullmatch(r'(cítit|čekat|činit|číst|dávat|dělat|dít|dívat|hledat|chodit|chtít|jít|kralovat|ležet|milovat|mít|mluvit|moci|mus[ei]t|mysl[ei]t|patřit|počínat|prosit|ptát|působit|sedět|snažit|vědět|vidět|vyprávět|zdát|znamenat|žít)', node.lemma):
+                    node.feats['Aspect'] = 'Imp'
+                elif re.fullmatch(r'(dát|dojít|dostat|nalézt|napadnout|nechat|obrátit|odpovědět|otevřít|počít|položit|pomoci|poslat|postavit|povědět|poznat|přijít|přinést|říci|učinit|udělat|ukázat|vrátit|vstát|vydat|vzít|začít|zeptat|zůstat)', node.lemma):
+                    node.feats['Aspect'] = 'Perf'
+                # We must look at word form to distinguish imperfective "stát" from perfective "stát se".
+                elif re.fullmatch(r'(stojí(me?|š|te)?|stál(a|o|i|y)?)', node.form.lower()):
+                    node.feats['Aspect'] = 'Imp'
+                elif re.fullmatch(r'(stan(u|eš|e|eme?|ete|ou)|stal(a|o|i|y)?)', node.form.lower()):
+                    node.feats['Aspect'] = 'Perf'
+            # Present forms of perfective verbs normally have Tense=Pres despite
+            # meaning future. However, a few imperfective verbs have a separate
+            # future form (distinct from present form), which gets Tense=Fut
+            # despite inflecting similarly to present forms.
+            if node.feats['Mood'] == 'Ind' and node.feats['Tense'] == 'Pres' and node.feats['Aspect'] != 'Perf' and re.match(r'((bud|půjd|pojed|polez|pones)(u|eš|e|eme?|ete|ou)|polet(ím|íš|í|íme|íte))', node.form.lower()):
+                node.feats['Tense'] = 'Fut'
+            # Passive participles (including the short forms) should be ADJ, not VERB.
+            # But they keep the verbal features of VerbForm, Voice, Aspect.
+            if node.feats['VerbForm'] == 'Part' and node.feats['Voice'] == 'Pass':
+                node.upos = 'ADJ'
+                # But now we need an adjectival lemma.
+                ###!!! Bohužel to občas zahodí normalizaci, kterou tam Martinův tým zavedl ručně, např. "rozhřita" mělo lemma "rozehřát", ale já teď místo "rozehřátý" vyrobím "rozhřitý".
+                ###!!! odepříno - odepříný místo odepřený
+                ###!!! dovolíno - dovolíný místo dovolený
+                ###!!! vyslyšána - vyslyšaný místo vyslyšený
+                ###!!! obmezený místo omezený, oslyšaný místo oslyšený
+                node.misc['LDeriv'] = node.lemma
+                node.lemma = re.sub(r'([nt])[auoiy]?$', r'\1ý', node.form.lower())
+                node.lemma = re.sub(r'áný$', r'aný', node.lemma) # ztroskotány --> ztroskotáný --> ztroskotaný; zachován, spořádán
+                if node.feats['Polarity'] == 'Neg':
+                    node.lemma = re.sub(r'^ne', '', node.lemma)
+                if node.feats['Case'] == '':
+                    node.feats['Case'] = 'Nom'
+                if node.feats['Degree'] == '':
+                    node.feats['Degree'] = 'Pos'
+                node.feats['Variant'] = 'Short'
+        #----------------------------------------------------------------------
+        # ADVERBS
+        #----------------------------------------------------------------------
+        # Words that indicate the speaker's attitude are tagged ADV in UD,
+        # although the Czech tagsets often treat them as particles.
+        if node.upos == 'PART' and re.fullmatch(r'(asi?|dokonce|jistě|hlavně|hned|možná|opravdu|skoro|skutečně|snad|třeba|určitě|vlastně|vůbec|zajisté|zase|zrovna|zřejmě|zvláště)', node.lemma):
+            node.upos = 'ADV'
+            node.feats['Degree'] = 'Pos'
+            node.feats['Polarity'] = 'Pos'
+        # Adverb "brzo" should be lemmatized as "brzy".
+        if node.upos == 'ADV' and node.form.lower() == 'brzo':
+            node.lemma = 'brzy'
+        if node.upos == 'ADV' and node.form.lower() == 'teprv':
+            node.lemma = 'teprve'
+        # All non-pronominal adverbs (and also some pronominal ones) should
+        # have Degree and Polarity. At least for now we also exclude adverbial
+        # numerals, e.g. "jednou" – "nejednou".
+        if node.upos == 'ADV' and node.feats['PronType'] == '' and node.feats['NumType'] == '':
+            if node.feats['Degree'] == '':
+                node.feats['Degree'] = 'Pos'
+            if node.feats['Polarity'] == '':
+                node.feats['Polarity'] = 'Pos'
+        #----------------------------------------------------------------------
+        # PREPOSITIONS
+        #----------------------------------------------------------------------
+        # Preposition "u" may combine with Case=Loc|Acc in old texts, and then
+        # it functions as a vocalized counterpart of "v". Nevertheless, we always
+        # lemmatize it as "u" and thus AdpType is Prep, not Voc.
+        if node.upos == 'ADP' and node.form.lower() == 'u':
+            node.lemma = 'u'
+            node.feats['AdpType'] = 'Prep'
+        #----------------------------------------------------------------------
+        # PARTICLES THAT SHOULD BE ADVERBS
+        #----------------------------------------------------------------------
         # "jako" should be SCONJ but 19th century data have it as PART.
         if node.upos == 'PART' and node.lemma == 'jako':
             node.upos = 'SCONJ'

From 61c757a3e3572226795054e1ffa01366afffb96a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 12 Nov 2025 22:19:06 +0100
Subject: [PATCH 1321/1374] =?UTF-8?q?=C4=8C=C3=A1stice.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/fixmorpho.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/ud/cs/fixmorpho.py b/udapi/block/ud/cs/fixmorpho.py
index 99a2e670..47bce211 100644
--- a/udapi/block/ud/cs/fixmorpho.py
+++ b/udapi/block/ud/cs/fixmorpho.py
@@ -370,7 +370,7 @@ def process_node(self, node):
             # meaning future. However, a few imperfective verbs have a separate
             # future form (distinct from present form), which gets Tense=Fut
             # despite inflecting similarly to present forms.
-            if node.feats['Mood'] == 'Ind' and node.feats['Tense'] == 'Pres' and node.feats['Aspect'] != 'Perf' and re.match(r'((bud|půjd|pojed|polez|pones)(u|eš|e|eme?|ete|ou)|polet(ím|íš|í|íme|íte))', node.form.lower()):
+            if node.feats['Mood'] == 'Ind' and node.feats['Tense'] == 'Pres' and node.feats['Aspect'] != 'Perf' and re.match(r'(ne)?((bud|půjd|pojed|polez|pones)(u|eš|e|eme?|ete|ou)|polet(ím|íš|í|íme|íte))', node.form.lower()):
                 node.feats['Tense'] = 'Fut'
             # Passive participles (including the short forms) should be ADJ, not VERB.
             # But they keep the verbal features of VerbForm, Voice, Aspect.
@@ -397,7 +397,7 @@ def process_node(self, node):
         #----------------------------------------------------------------------
         # Words that indicate the speaker's attitude are tagged ADV in UD,
         # although the Czech tagsets often treat them as particles.
-        if node.upos == 'PART' and re.fullmatch(r'(asi?|dokonce|jistě|hlavně|hned|možná|opravdu|skoro|skutečně|snad|třeba|určitě|vlastně|vůbec|zajisté|zase|zrovna|zřejmě|zvláště)', node.lemma):
+        if node.upos == 'PART' and re.fullmatch(r'(asi?|až|bezpochyby|bohdá|co|dokonce|jen|jistě|již|hlavně|hned|jednoduše|leda|možná|naopak|nejen|nejspíše?|opravdu|ovšem|patrně|právě|prej|prý|přece|především|rozhodně|skoro|skutečně|snad|spíše?|teda|tedy|třeba|určitě|věru|vlastně|vůbec|zajisté|zase|zrovna|zřejmě|zvlášť|zvláště)', node.lemma):
             node.upos = 'ADV'
             node.feats['Degree'] = 'Pos'
             node.feats['Polarity'] = 'Pos'

From 2dfb91537df8c71ff2884cd07057d6f5f28e02ba Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 13 Nov 2025 09:28:02 +0100
Subject: [PATCH 1322/1374] Czech conjunction/particle "ani" and pronoun "an".

---
 udapi/block/ud/cs/fixmorpho.py | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/fixmorpho.py b/udapi/block/ud/cs/fixmorpho.py
index 47bce211..df2140ea 100644
--- a/udapi/block/ud/cs/fixmorpho.py
+++ b/udapi/block/ud/cs/fixmorpho.py
@@ -162,6 +162,10 @@ def process_node(self, node):
                 node.lemma = 'jenžto'
                 node.upos = 'PRON'
                 node.feats['PrepCase'] = 'Npr'
+            # Relative pronoun "an" is PRON (not DET).
+            elif node.lemma == 'an':
+                node.upos = 'PRON'
+                node.feats['PronType'] = 'Rel'
             # Pronoun "kdo" is PRON (not DET).
             elif node.lemma == 'kdo':
                 node.lemma = 'kdo'
@@ -397,10 +401,11 @@ def process_node(self, node):
         #----------------------------------------------------------------------
         # Words that indicate the speaker's attitude are tagged ADV in UD,
         # although the Czech tagsets often treat them as particles.
-        if node.upos == 'PART' and re.fullmatch(r'(asi?|až|bezpochyby|bohdá|co|dokonce|jen|jistě|již|hlavně|hned|jednoduše|leda|možná|naopak|nejen|nejspíše?|opravdu|ovšem|patrně|právě|prej|prý|přece|především|rozhodně|skoro|skutečně|snad|spíše?|teda|tedy|třeba|určitě|věru|vlastně|vůbec|zajisté|zase|zrovna|zřejmě|zvlášť|zvláště)', node.lemma):
+        if node.upos == 'PART' and re.fullmatch(r'(ani|asi?|až|bezpochyby|bohdá|co|dokonce|jen|jistě|již|hlavně|hned|jednoduše|leda|možná|naopak|nejen|nejspíše?|opravdu|ovšem|patrně|právě|prej|prý|přece|především|rozhodně|skoro|skutečně|snad|spíše?|teda|tedy|třeba|určitě|věru|vlastně|vůbec|zajisté|zase|zrovna|zřejmě|zvlášť|zvláště)', node.lemma):
             node.upos = 'ADV'
             node.feats['Degree'] = 'Pos'
             node.feats['Polarity'] = 'Pos'
+            node.misc['CzechParticle'] = 'Yes'
         # Adverb "brzo" should be lemmatized as "brzy".
         if node.upos == 'ADV' and node.form.lower() == 'brzo':
             node.lemma = 'brzy'
@@ -424,6 +429,13 @@ def process_node(self, node):
             node.lemma = 'u'
             node.feats['AdpType'] = 'Prep'
         #----------------------------------------------------------------------
+        # CONJUNCTION
+        #----------------------------------------------------------------------
+        # As a conjunction (and not particle/adverb), "ani" is coordinating and
+        # not subordinating.
+        if node.upos == 'SCONJ' and node.lemma == 'ani':
+            node.upos = 'CCONJ'
+        #----------------------------------------------------------------------
         # PARTICLES THAT SHOULD BE ADVERBS
         #----------------------------------------------------------------------
         # "jako" should be SCONJ but 19th century data have it as PART.

From 9f6847f6151cee29e973e76072a69f086b44de8a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 13 Nov 2025 22:46:26 +0100
Subject: [PATCH 1323/1374] "nic" as adverb (= "nijak").

---
 udapi/block/ud/cs/fixmorpho.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/fixmorpho.py b/udapi/block/ud/cs/fixmorpho.py
index df2140ea..2813ecf9 100644
--- a/udapi/block/ud/cs/fixmorpho.py
+++ b/udapi/block/ud/cs/fixmorpho.py
@@ -320,7 +320,7 @@ def process_node(self, node):
                 node.feats['PronType'] = 'Ind'
                 node.feats['Degree'] = ''
                 node.feats['Polarity'] = ''
-            elif re.fullmatch(r'(nijak|nikam|nikde|nikdy|nikudy)', node.lemma):
+            elif re.fullmatch(r'(nic|nijak|nikam|nikde|nikdy|nikudy)', node.lemma):
                 node.feats['PronType'] = 'Neg'
                 node.feats['Degree'] = ''
                 node.feats['Polarity'] = ''

From 2e61d9c2b1d9b19b4cb62c9fff09962027d0edb1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Fri, 14 Nov 2025 14:11:11 +0100
Subject: [PATCH 1324/1374] More Czech fixes.

---
 udapi/block/ud/cs/fixmorpho.py | 60 +++++++++++++++++++++++++---------
 1 file changed, 44 insertions(+), 16 deletions(-)

diff --git a/udapi/block/ud/cs/fixmorpho.py b/udapi/block/ud/cs/fixmorpho.py
index 2813ecf9..7fcb0e12 100644
--- a/udapi/block/ud/cs/fixmorpho.py
+++ b/udapi/block/ud/cs/fixmorpho.py
@@ -30,7 +30,7 @@ def process_node(self, node):
         # them as proper nouns. We must be careful and not add too many to this
         # rule, as many of them could be used as surnames and then they should
         # be PROPN.
-        if node.upos == 'PROPN' and re.fullmatch(r'(bůh|duch|hospodin|město|milost|pán|panna)', node.lemma.lower()):
+        if node.upos == 'PROPN' and re.fullmatch(r'(bůh|duch|hospodin|město|milost|pan|pán|panna|stvořitel|trojice)', node.lemma.lower()):
             node.lemma = node.lemma.lower()
             node.upos = 'NOUN'
         # Lemmatization.
@@ -124,7 +124,7 @@ def process_node(self, node):
                 node.feats['Number[psor]'] = 'Sing'
                 if not re.search(r'(Masc|Neut)', node.feats['Gender[psor]']):
                     node.feats['Gender[psor]'] = 'Masc,Neut'
-            elif node.form.lower() == 'její':
+            elif re.fullmatch(r'(její|jejího|jejímu|jejím|jejích|jejími|jejíma)', node.form.lower()):
                 node.lemma = 'jeho'
                 node.feats['Person'] = '3'
                 node.feats['Number[psor]'] = 'Sing'
@@ -142,6 +142,14 @@ def process_node(self, node):
                 node.lemma = 'jehož'
                 node.feats['PronType'] = 'Rel'
                 node.feats['Number[psor]'] = 'Plur'
+            elif re.fullmatch(r'jichžto|jejichžto', node.form.lower()):
+                node.lemma = 'jehožto'
+                node.feats['PronType'] = 'Rel'
+                node.feats['Number[psor]'] = 'Plur'
+        elif node.lemma == 'čí':
+            node.feats['Poss'] = 'Yes'
+            if node.feats['PronType'] == '':
+                node.feats['PronType'] = 'Int,Rel'
         # Reflexive possessive pronoun should not forget the Reflex=Yes feature.
         if node.upos == 'DET' and node.lemma == 'svůj':
             node.feats['Reflex'] = 'Yes'
@@ -150,7 +158,7 @@ def process_node(self, node):
         if node.upos in ['PRON', 'DET']:
             # Relative pronoun "jenž" should be PRON, not DET
             # (it inflects for Gender but it can never be used as congruent attribute).
-            if node.lemma == 'jenž':
+            if re.fullmatch(r'(jenž|jenžto)', node.lemma):
                 node.upos = 'PRON'
                 if node.form.lower().startswith('j'):
                     node.feats['PrepCase'] = 'Npr'
@@ -158,7 +166,7 @@ def process_node(self, node):
                     node.feats['PrepCase'] = 'Pre'
             # Relative pronoun "ješto" should be PRON, not DET (if it is not SCONJ, but that was excluded by a condition above)
             # (it inflects for Gender but it can never be used as congruent attribute).
-            elif node.form.lower() == 'ješto':
+            elif node.form.lower() in ['ješto', 'ježto']:
                 node.lemma = 'jenžto'
                 node.upos = 'PRON'
                 node.feats['PrepCase'] = 'Npr'
@@ -177,6 +185,17 @@ def process_node(self, node):
                 node.feats['Gender'] = 'Masc'
                 node.feats['Animacy'] = 'Anim'
                 node.feats['Number'] = ''
+            # Pronoun "kdož" is PRON (not DET).
+            elif node.lemma == 'kdož':
+                node.lemma = 'kdož'
+                node.upos = 'PRON'
+                if node.feats['PronType'] == '':
+                    node.feats['PronType'] = 'Rel'
+                # Unlike "co", we annotate "kdo" as Animacy=Anim|Gender=Masc.
+                # However, we do not annotate Number ("kdo" can be the subject of a plural verb).
+                node.feats['Gender'] = 'Masc'
+                node.feats['Animacy'] = 'Anim'
+                node.feats['Number'] = ''
             # Pronoun "někdo", "kdosi" is PRON (not DET).
             elif re.fullmatch(r'(kdosi|někdo)', node.lemma):
                 node.upos = 'PRON'
@@ -208,8 +227,7 @@ def process_node(self, node):
                 node.feats['Animacy'] = ''
                 node.feats['Number'] = ''
             # Pronoun "což" is PRON (not DET).
-            elif node.lemma == 'což':
-                node.lemma = 'což'
+            elif node.lemma in ['což', 'cože']:
                 node.upos = 'PRON'
                 if node.feats['PronType'] == '':
                     node.feats['PronType'] = 'Rel'
@@ -219,7 +237,7 @@ def process_node(self, node):
                 node.feats['Animacy'] = ''
                 node.feats['Number'] = ''
             # Pronoun "něco" is PRON (not DET).
-            elif re.fullmatch(r'(cosi|něco)', node.lemma):
+            elif re.fullmatch(r'(cokoli|cosi|něco)', node.lemma):
                 node.upos = 'PRON'
                 node.feats['PronType'] = 'Ind'
                 # We do not annotate Gender and Number, although it could be argued
@@ -253,6 +271,10 @@ def process_node(self, node):
             elif node.lemma == 'všechen':
                 node.upos = 'DET'
                 node.feats['PronType'] = 'Tot'
+            elif re.fullmatch(r'(všecek|všecka|všecku|všecko|všickni)', node.form.lower()):
+                node.lemma = 'všechen'
+                node.upos = 'DET'
+                node.feats['PronType'] = 'Tot'
             # Pronoun "sám" is lemmatized to the long form, it is DET and PronType=Emp.
             elif node.lemma in ['sám', 'samý']:
                 node.lemma = 'samý'
@@ -275,7 +297,8 @@ def process_node(self, node):
                 node.feats['PronType'] = 'Ind'
                 node.feats['NumForm'] = ''
                 node.feats['Polarity'] = '' ###!!! so we are losing the distinction mnoho/nemnoho?
-            elif re.fullmatch(r'(tolik)', node.lemma):
+            elif re.fullmatch(r'(toliko?)', node.lemma):
+                node.lemma = 'tolik'
                 node.upos = 'DET'
                 node.feats['PronType'] = 'Dem'
                 node.feats['NumForm'] = ''
@@ -303,7 +326,7 @@ def process_node(self, node):
         # Pronominal adverbs have PronType but most of them do not have Degree
         # and Polarity.
         if node.upos == 'ADV':
-            if re.fullmatch(r'(dosud|nyní|proto|sem|tady|tak|takto|tam|teď|tehdy|tenkrát|tu|zde)', node.lemma):
+            if re.fullmatch(r'(dosud|dotud|nyní|odsud|odtud|proto|sem|tady|tak|takož|takto|tam|tamto|teď|tehdy|tenkrát|tu|tudy|zde)', node.lemma):
                 node.feats['PronType'] = 'Dem'
                 node.feats['Degree'] = ''
                 node.feats['Polarity'] = ''
@@ -316,7 +339,7 @@ def process_node(self, node):
                 node.feats['PronType'] = 'Rel'
                 node.feats['Degree'] = ''
                 node.feats['Polarity'] = ''
-            elif re.fullmatch(r'(jaksi|kamsi|kdesi|kdysi|kudysi|nějak|někam|někde|někdy|někudy)', node.lemma):
+            elif re.fullmatch(r'(jakkoli|jaksi|kamkoli|kamsi|kdekoli|kdesi|kdykoli|kdysi|kudykoli|kudysi|nějak|někam|někde|někdy|někudy)', node.lemma):
                 node.feats['PronType'] = 'Ind'
                 node.feats['Degree'] = ''
                 node.feats['Polarity'] = ''
@@ -325,7 +348,7 @@ def process_node(self, node):
                 node.feats['Degree'] = ''
                 node.feats['Polarity'] = ''
             # Total pronominals can be negated ("nevždy"). Then they get Degree, too.
-            elif re.fullmatch(r'(všude|všudy|ve?ždy|ve?ždycky)', node.lemma):
+            elif re.fullmatch(r'(odevšad|všude|všudy|ve?ždy|ve?ždycky)', node.lemma):
                 node.feats['PronType'] = 'Tot'
                 node.feats['Degree'] = 'Pos'
                 node.feats['Polarity'] = 'Pos'
@@ -337,7 +360,7 @@ def process_node(self, node):
         # where it no longer acts as a copula. Czech tagsets typically do not
         # distinguish AUX from VERB, which means that converted data may have to
         # be fixed.
-        if node.upos == 'VERB' and node.lemma == 'být':
+        if node.upos == 'VERB' and node.lemma in ['být', 'bývat', 'bývávat']:
             node.upos = 'AUX'
         if node.upos in ['ADV', 'VERB'] and re.fullmatch(r'(ne)?lze', node.form.lower()):
             node.upos = 'ADV'
@@ -429,15 +452,20 @@ def process_node(self, node):
             node.lemma = 'u'
             node.feats['AdpType'] = 'Prep'
         #----------------------------------------------------------------------
-        # CONJUNCTION
+        # CONJUNCTIONS
         #----------------------------------------------------------------------
         # As a conjunction (and not particle/adverb), "ani" is coordinating and
         # not subordinating.
         if node.upos == 'SCONJ' and node.lemma == 'ani':
             node.upos = 'CCONJ'
+        if node.upos == 'CCONJ' and node.lemma == 'nebť':
+            node.lemma = 'neboť'
         #----------------------------------------------------------------------
-        # PARTICLES THAT SHOULD BE ADVERBS
+        # PARTICLES (other than those already grabbed above)
         #----------------------------------------------------------------------
         # "jako" should be SCONJ but 19th century data have it as PART.
-        if node.upos == 'PART' and node.lemma == 'jako':
-            node.upos = 'SCONJ'
+        if node.upos == 'PART':
+            if node.lemma == 'jako':
+                node.upos = 'SCONJ'
+            elif node.lemma == 'ti':
+                node.lemma = 'ť'

From 21649d788a0163b3da263c8598c6ba91c08458c8 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Wed, 19 Nov 2025 17:49:23 +0100
Subject: [PATCH 1325/1374] Correct detection of anterior tenses

---
 udapi/block/msf/romance/romance.py | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
index 13e368eb..ea410655 100644
--- a/udapi/block/msf/romance/romance.py
+++ b/udapi/block/msf/romance/romance.py
@@ -7,6 +7,7 @@
           'potere', 'dovere', 'volere', 'sapere'] # Italian
 
 class Aspect(str, Enum):
+    ANT = 'Ant'
     IMP = 'Imp'
     IMPPROG = 'ImpProg'
     PERF = 'Perf'
@@ -523,10 +524,22 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
 
                 # Italian
                 # Trapassato prossimo -> PhraseTense=Past, PhraseAspect=Pqp
-                elif auxes[0].feats['Tense'] in ['Imp', 'Past']: # TODO prej neni v Past, jenom Imp
+                elif auxes[0].feats['Tense'] == 'Imp':
                     tense=Tense.PAST.value
                     aspect=Aspect.PQP.value
 
+                # Spanish
+                # pretérito anterior ante pretérito -> PhraseTense=Past, PhraseAspect=Ant
+
+                # Italian
+                # trapassato remoto -> PhraseTense=Past, PhraseAspect=Ant
+                
+                # French
+                # passé antérieur -> PhraseTense=Past, PhraseAspect=Ant
+                elif auxes[0].feats['Tense'] == 'Past':
+                    tense=Tense.PAST.value
+                    aspect = Aspect.ANT.value
+
                 self.write_node_info(head_node,
                     tense=tense,
                     number=auxes[0].feats['Number'],
@@ -709,4 +722,4 @@ def process_copulas(self, node, cop, expl, polarity, phrase_ords):
             if cop[0].lemma == 'ser':
                 node.misc['PhraseAspect'] = Aspect.PERF.value
             elif cop[0].lemma == 'estar':
-                node.misc['PhraseAspect'] = Aspect.IMP.value
+                node.misc['PhraseAspect'] = Aspect.IMP.value
\ No newline at end of file

From 180f6f13f1ada7f59efb66a8ef9d8d6d4a45c996 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Wed, 19 Nov 2025 22:13:30 +0100
Subject: [PATCH 1326/1374] =?UTF-8?q?Add=20detection=20of=20French=20g?=
 =?UTF-8?q?=C3=A9rondif?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/msf/romance/romance.py | 27 ++++++++++++++++++++++-----
 1 file changed, 22 insertions(+), 5 deletions(-)

diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
index ea410655..cde1cfc6 100644
--- a/udapi/block/msf/romance/romance.py
+++ b/udapi/block/msf/romance/romance.py
@@ -39,7 +39,7 @@ def process_node(self, node):
         cop = [x for x in node.children if x.udeprel == 'cop']
         
         # only expl or expl:pv, no expl:impers or expl:pass
-        refl = [x for x in node.children if x.lemma == 'se' and x.upos == 'PRON' and x.udeprel == 'expl' and x.deprel != 'expl:impers' and x.deprel != 'expl:pass']
+        refl = [x for x in node.children if (x.lemma == 'se' or x.lemma == 'soi') and x.upos == 'PRON' and x.udeprel == 'expl' and x.deprel != 'expl:impers' and x.deprel != 'expl:pass']
         
         if refl:
             expl='Pv'
@@ -265,6 +265,7 @@ def process_simple_verb_forms(self, node, expl, polarity, phrase_ords, head_node
 
         aspect = ''
         tense = node.feats['Tense']
+        form = node.feats['VerbForm']
 
         if node.feats['Mood'] == 'Ind':
             
@@ -336,13 +337,19 @@ def process_simple_verb_forms(self, node, expl, polarity, phrase_ords, head_node
             aspect=''
             tense=Tense.PRES.value
 
+        adp_en = [x for x in head_node.children if x.upos == 'ADP' and x.lemma == 'en' and x.udeprel == 'mark']
+        if node.feats['VerbForm'] == 'Part' and adp_en:
+            phrase_ords.append(adp_en[0].ord)
+            phrase_ords.sort()
+            form = 'Ger'
+
         
         self.write_node_info(head_node,
             person=node.feats['Person'],
             aspect=aspect,
             number=node.feats['Number'],
             mood=node.feats['Mood'],
-            form=node.feats['VerbForm'],
+            form=form,
             tense=tense,
             gender=head_node.feats['Gender'],
             voice=head_node.feats['Voice'],
@@ -499,13 +506,23 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                 # Futuro anteriore -> PhraseTense=Fut, PhraseAspect=Perf
                 aspect=Aspect.PERF.value
                 tense=auxes[0].feats['Tense']
+                form='Fin'
+
+                adp_en = [x for x in node.children if x.lemma == 'en' and x.upos == 'ADP' and x.udeprel == 'mark']
+                if auxes[0].feats['VerbForm'] == 'Part' and adp_en:
+                    tense=Tense.PAST.value
+                    aspect=''
+                    phrase_ords.append(adp_en[0].ord)
+                    phrase_ords.sort()
+                    form='Ger'
+
 
                 # Spanish
                 # Pretérito perfecto compuesto ante presente -> PhraseTense=Past, PhraseAspect=Perf
 
                 # Italian
                 # Passato prossimo (aux avere/essere) -> PhraseTense=Past, PhraseAspect=Perf
-                if auxes[0].feats['Tense'] == 'Pres':
+                elif auxes[0].feats['Tense'] == 'Pres':
 
                     # Portuguese
                     # pretérito perfeito composto (aux ter) -> PhraseTense=PastPres, PhraseAspect=Perf
@@ -533,7 +550,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
 
                 # Italian
                 # trapassato remoto -> PhraseTense=Past, PhraseAspect=Ant
-                
+
                 # French
                 # passé antérieur -> PhraseTense=Past, PhraseAspect=Ant
                 elif auxes[0].feats['Tense'] == 'Past':
@@ -546,7 +563,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     person=auxes[0].feats['Person'],
                     mood=auxes[0].feats['Mood'],
                     aspect=aspect,
-                    form='Fin',
+                    form=form,
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,

From b4a72dc4dd844f6ce965a03d501ac10fa02c4971 Mon Sep 17 00:00:00 2001
From: Nicholas Bollweg <nick.bollweg@gmail.com>
Date: Mon, 15 Dec 2025 09:28:31 -0500
Subject: [PATCH 1327/1374] Use console_scripts for CLI (#133)

* use console_scripts to build cross-platform scripts (`udapy`) at install time.

* keep `bin/udapy` for backward compatibility.
---
 .gitignore   |   4 +-
 bin/udapy    | 135 ++-----------------------------------------------
 setup.cfg    |   8 +--
 udapi/cli.py | 140 +++++++++++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 150 insertions(+), 137 deletions(-)
 create mode 100755 udapi/cli.py

diff --git a/.gitignore b/.gitignore
index a75e7c05..adc7bbbc 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,5 @@
+.cache
 .idea
+*.egg-info/
 *.pyc
-.cache
+dist/
diff --git a/bin/udapy b/bin/udapy
index 30cb2595..83c7a6f2 100755
--- a/bin/udapy
+++ b/bin/udapy
@@ -1,136 +1,7 @@
 #!/usr/bin/env python3
-import os
-import gc
+"""Thin wrapper for backward compatibility.  Calls udapi.cli.main()."""
 import sys
-import atexit
-import logging
-import argparse
+from udapi.cli import main
 
-from udapi.core.run import Run
-
-# Parse command line arguments.
-argparser = argparse.ArgumentParser(
-    formatter_class=argparse.RawTextHelpFormatter,
-    usage="udapy [optional_arguments] scenario",
-    epilog="See http://udapi.github.io",
-    description="udapy - Python interface to Udapi - API for Universal Dependencies\n\n"
-                "Examples of usage:\n"
-                "  udapy -s read.Sentences udpipe.En < in.txt > out.conllu\n"
-                "  udapy -T < sample.conllu | less -R\n"
-                "  udapy -HAM ud.MarkBugs < sample.conllu > bugs.html\n")
-argparser.add_argument(
-    "-q", "--quiet", action="store_true",
-    help="Warning, info and debug messages are suppressed. Only fatal errors are reported.")
-argparser.add_argument(
-    "-v", "--verbose", action="store_true",
-    help="Warning, info and debug messages are printed to the STDERR.")
-argparser.add_argument(
-    "-s", "--save", action="store_true",
-    help="Add write.Conllu to the end of the scenario")
-argparser.add_argument(
-    "-T", "--save_text_mode_trees", action="store_true",
-    help="Add write.TextModeTrees color=1 to the end of the scenario")
-argparser.add_argument(
-    "-H", "--save_html", action="store_true",
-    help="Add write.TextModeTreesHtml color=1 to the end of the scenario")
-argparser.add_argument(
-    "-A", "--save_all_attributes", action="store_true",
-    help="Add attributes=form,lemma,upos,xpos,feats,deprel,misc (to be used after -T and -H)")
-argparser.add_argument(
-    "-C", "--save_comments", action="store_true",
-    help="Add print_comments=1 (to be used after -T and -H)")
-argparser.add_argument(
-    "-M", "--marked_only", action="store_true",
-    help="Add marked_only=1 to the end of the scenario (to be used after -T and -H)")
-argparser.add_argument(
-    "-N", "--no_color", action="store_true",
-    help="Add color=0 to the end of the scenario, this overrides color=1 of -T and -H")
-argparser.add_argument(
-    "-X", "--extra", action="append",
-    help="Add a specified parameter (or a block name) to the end of the scenario\n"
-         "For example 'udapy -TNX attributes=form,misc -X layout=align < my.conllu'")
-argparser.add_argument(
-    "--gc", action="store_true",
-    help="By default, udapy disables Python garbage collection and at-exit cleanup\n"
-         "to speed up everything (especially reading CoNLL-U files). In edge cases,\n"
-         "when processing many files and running out of memory, you can disable this\n"
-         "optimization (i.e. enable garbage collection) with 'udapy --gc'.")
-argparser.add_argument(
-    'scenario', nargs=argparse.REMAINDER, help="A sequence of blocks and their parameters.")
-
-args = argparser.parse_args()
-
-# Set the level of logs according to parameters.
-if args.verbose:
-    level = logging.DEBUG
-elif args.quiet:
-    level = logging.CRITICAL
-else:
-    level = logging.INFO
-
-logging.basicConfig(format='%(asctime)-15s [%(levelname)7s] %(funcName)s - %(message)s',
-                    level=level)
-
-# Global flag to track if an unhandled exception occurred
-_unhandled_exception_occurred = False
-
-def _custom_excepthook(exc_type, exc_value, traceback):
-    global _unhandled_exception_occurred
-    _unhandled_exception_occurred = True
-
-    # Call the default excepthook to allow normal error reporting
-    sys.__excepthook__(exc_type, exc_value, traceback)
-
-# Override the default excepthook
-sys.excepthook = _custom_excepthook
-
-
-# Process and provide the scenario.
 if __name__ == "__main__":
-
-    # Disabling garbage collections makes the whole processing much faster.
-    # Similarly, we can save several seconds by partially disabling the at-exit Python cleanup
-    # (atexit hooks are called in reversed order of their registration,
-    # so flushing stdio buffers etc. will be still done before the os._exit(0) call).
-    # See https://instagram-engineering.com/dismissing-python-garbage-collection-at-instagram-4dca40b29172
-    # Is it safe to disable GC?
-    # OS will free the memory allocated by this process after it ends anyway.
-    # The udapy wrapper is aimed for one-time tasks, not a long-running server,
-    # so in a typical case a document is loaded and almost no memory is freed before the end.
-    # Udapi documents have a many cyclic references, so running GC is quite slow.
-    if not args.gc:
-        gc.disable()
-        # When an exception/error has happened, udapy should exit with a non-zero exit code,
-        # so that users can use `udapy ... || echo "Error detected"` (or Makefile reports errors).
-        # However, we cannot use `atexit.register(lambda: os._exit(1 if sys.exc_info()[0] else 0))`
-        # because the Python has already exited the exception-handling block
-        # (the exception/error has been already reported and sys.exc_info()[0] is None).
-        # We thus keep record whether _unhandled_exception_occurred.
-        atexit.register(lambda: os._exit(1 if _unhandled_exception_occurred else 0))
-        atexit.register(sys.stderr.flush)
-    if args.save:
-        args.scenario = args.scenario + ['write.Conllu']
-    if args.save_text_mode_trees:
-        args.scenario = args.scenario + ['write.TextModeTrees', 'color=1']
-    if args.save_html:
-        args.scenario = args.scenario + ['write.TextModeTreesHtml', 'color=1']
-    if args.save_all_attributes:
-        args.scenario = args.scenario + ['attributes=form,lemma,upos,xpos,feats,deprel,misc']
-    if args.save_comments:
-        args.scenario = args.scenario + ['print_comments=1']
-    if args.marked_only:
-        args.scenario = args.scenario + ['marked_only=1']
-    if args.no_color:
-        args.scenario = args.scenario + ['color=0']
-    if args.extra:
-        args.scenario += args.extra
-
-    runner = Run(args)
-    # udapy is often piped to head etc., e.g.
-    # `seq 1000 | udapy -s read.Sentences | head`
-    # Let's prevent Python from reporting (with distracting stacktrace)
-    # "BrokenPipeError: [Errno 32] Broken pipe"
-    try:
-        runner.execute()
-    except BrokenPipeError:
-        pass
+    sys.exit(main())
diff --git a/setup.cfg b/setup.cfg
index fdbae292..2cdfaaa9 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -16,14 +16,14 @@ classifiers =
 packages = find:
 python_requires = >=3.9
 include_package_data = True
-scripts =
-    bin/udapy
 install_requires =
     colorama
     termcolor
 
+[options.entry_points]
+console_scripts =
+    udapy = udapi:cli.main
+
 [options.extras_require]
 test =
     pytest
-
-
diff --git a/udapi/cli.py b/udapi/cli.py
new file mode 100755
index 00000000..de55f8cb
--- /dev/null
+++ b/udapi/cli.py
@@ -0,0 +1,140 @@
+#!/usr/bin/env python3
+import os
+import gc
+import sys
+import atexit
+import logging
+import argparse
+
+from udapi.core.run import Run
+
+# Parse command line arguments.
+argparser = argparse.ArgumentParser(
+    formatter_class=argparse.RawTextHelpFormatter,
+    usage="udapy [optional_arguments] scenario",
+    epilog="See http://udapi.github.io",
+    description="udapy - Python interface to Udapi - API for Universal Dependencies\n\n"
+                "Examples of usage:\n"
+                "  udapy -s read.Sentences udpipe.En < in.txt > out.conllu\n"
+                "  udapy -T < sample.conllu | less -R\n"
+                "  udapy -HAM ud.MarkBugs < sample.conllu > bugs.html\n")
+argparser.add_argument(
+    "-q", "--quiet", action="store_true",
+    help="Warning, info and debug messages are suppressed. Only fatal errors are reported.")
+argparser.add_argument(
+    "-v", "--verbose", action="store_true",
+    help="Warning, info and debug messages are printed to the STDERR.")
+argparser.add_argument(
+    "-s", "--save", action="store_true",
+    help="Add write.Conllu to the end of the scenario")
+argparser.add_argument(
+    "-T", "--save_text_mode_trees", action="store_true",
+    help="Add write.TextModeTrees color=1 to the end of the scenario")
+argparser.add_argument(
+    "-H", "--save_html", action="store_true",
+    help="Add write.TextModeTreesHtml color=1 to the end of the scenario")
+argparser.add_argument(
+    "-A", "--save_all_attributes", action="store_true",
+    help="Add attributes=form,lemma,upos,xpos,feats,deprel,misc (to be used after -T and -H)")
+argparser.add_argument(
+    "-C", "--save_comments", action="store_true",
+    help="Add print_comments=1 (to be used after -T and -H)")
+argparser.add_argument(
+    "-M", "--marked_only", action="store_true",
+    help="Add marked_only=1 to the end of the scenario (to be used after -T and -H)")
+argparser.add_argument(
+    "-N", "--no_color", action="store_true",
+    help="Add color=0 to the end of the scenario, this overrides color=1 of -T and -H")
+argparser.add_argument(
+    "-X", "--extra", action="append",
+    help="Add a specified parameter (or a block name) to the end of the scenario\n"
+         "For example 'udapy -TNX attributes=form,misc -X layout=align < my.conllu'")
+argparser.add_argument(
+    "--gc", action="store_true",
+    help="By default, udapy disables Python garbage collection and at-exit cleanup\n"
+         "to speed up everything (especially reading CoNLL-U files). In edge cases,\n"
+         "when processing many files and running out of memory, you can disable this\n"
+         "optimization (i.e. enable garbage collection) with 'udapy --gc'.")
+argparser.add_argument(
+    'scenario', nargs=argparse.REMAINDER, help="A sequence of blocks and their parameters.")
+
+
+# Process and provide the scenario.
+def main(argv=None):
+    args = argparser.parse_args(argv)
+
+    # Set the level of logs according to parameters.
+    if args.verbose:
+        level = logging.DEBUG
+    elif args.quiet:
+        level = logging.CRITICAL
+    else:
+        level = logging.INFO
+
+    logging.basicConfig(format='%(asctime)-15s [%(levelname)7s] %(funcName)s - %(message)s',
+                        level=level)
+
+    # Global flag to track if an unhandled exception occurred
+    _unhandled_exception_occurred = False
+
+    def _custom_excepthook(exc_type, exc_value, traceback):
+        global _unhandled_exception_occurred
+        _unhandled_exception_occurred = True
+
+        # Call the default excepthook to allow normal error reporting
+        sys.__excepthook__(exc_type, exc_value, traceback)
+
+    # Override the default excepthook
+    sys.excepthook = _custom_excepthook
+
+    # Disabling garbage collections makes the whole processing much faster.
+    # Similarly, we can save several seconds by partially disabling the at-exit Python cleanup
+    # (atexit hooks are called in reversed order of their registration,
+    # so flushing stdio buffers etc. will be still done before the os._exit(0) call).
+    # See https://instagram-engineering.com/dismissing-python-garbage-collection-at-instagram-4dca40b29172
+    # Is it safe to disable GC?
+    # OS will free the memory allocated by this process after it ends anyway.
+    # The udapy wrapper is aimed for one-time tasks, not a long-running server,
+    # so in a typical case a document is loaded and almost no memory is freed before the end.
+    # Udapi documents have a many cyclic references, so running GC is quite slow.
+    if not args.gc:
+        gc.disable()
+        # When an exception/error has happened, udapy should exit with a non-zero exit code,
+        # so that users can use `udapy ... || echo "Error detected"` (or Makefile reports errors).
+        # However, we cannot use `atexit.register(lambda: os._exit(1 if sys.exc_info()[0] else 0))`
+        # because the Python has already exited the exception-handling block
+        # (the exception/error has been already reported and sys.exc_info()[0] is None).
+        # We thus keep record whether _unhandled_exception_occurred.
+        atexit.register(lambda: os._exit(1 if _unhandled_exception_occurred else 0))
+        atexit.register(sys.stderr.flush)
+    if args.save:
+        args.scenario = args.scenario + ['write.Conllu']
+    if args.save_text_mode_trees:
+        args.scenario = args.scenario + ['write.TextModeTrees', 'color=1']
+    if args.save_html:
+        args.scenario = args.scenario + ['write.TextModeTreesHtml', 'color=1']
+    if args.save_all_attributes:
+        args.scenario = args.scenario + ['attributes=form,lemma,upos,xpos,feats,deprel,misc']
+    if args.save_comments:
+        args.scenario = args.scenario + ['print_comments=1']
+    if args.marked_only:
+        args.scenario = args.scenario + ['marked_only=1']
+    if args.no_color:
+        args.scenario = args.scenario + ['color=0']
+    if args.extra:
+        args.scenario += args.extra
+
+    runner = Run(args)
+    # udapy is often piped to head etc., e.g.
+    # `seq 1000 | udapy -s read.Sentences | head`
+    # Let's prevent Python from reporting (with distracting stacktrace)
+    # "BrokenPipeError: [Errno 32] Broken pipe"
+    try:
+        runner.execute()
+    except BrokenPipeError:
+        pass
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

From 242dbe6fc00c928543e0a5b71b88a0ebfb3d8318 Mon Sep 17 00:00:00 2001
From: Copilot <198982749+Copilot@users.noreply.github.com>
Date: Mon, 15 Dec 2025 16:47:02 +0100
Subject: [PATCH 1328/1374] Convert setup.cfg and setup.py to pyproject.toml
 (#135)

* Remove setup.cfg and setup.py files. Use pyproject.toml only.
* Use SPDX license identifier (`license = "GPL-3.0-or-later"`) to follow PEP 639
* add ufal.udpipe explicitly to optional dependencies
* bump version to 0.5.2
---
 README.md      |  2 +-
 pyproject.toml | 38 ++++++++++++++++++++++++++++++++++----
 setup.cfg      | 29 -----------------------------
 setup.py       |  4 ----
 4 files changed, 35 insertions(+), 38 deletions(-)
 delete mode 100644 setup.cfg
 delete mode 100644 setup.py

diff --git a/README.md b/README.md
index 0b41297f..9551b720 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@ Python framework for processing Universal Dependencies data
 [![Documentation Status](https://readthedocs.org/projects/udapi/badge/)](http://udapi.readthedocs.io)
 
 ## Requirements
-- You need Python 3.6 or higher.
+- You need Python 3.9 or higher.
 - If the [ufal.udpipe](https://pypi.python.org/pypi/ufal.udpipe/) parser is needed,
   make sure you have a C++11 compiler (e.g. [g++ 4.7 or newer](.travis.yml#L9))
   and install UDPipe with `pip3 install --user --upgrade ufal.udpipe`.
diff --git a/pyproject.toml b/pyproject.toml
index 374b58cb..18d5c717 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,36 @@
 [build-system]
-requires = [
-    "setuptools>=42",
-    "wheel"
-]
+requires = ["setuptools>=42", "wheel"]
 build-backend = "setuptools.build_meta"
+
+[project]
+name = "udapi"
+version = "0.5.2"
+description = "Python framework for processing Universal Dependencies data"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "GPL-3.0-or-later"
+authors = [
+    {name = "Martin Popel", email = "popel@ufal.mff.cuni.cz"}
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "colorama",
+    "termcolor",
+]
+
+[project.urls]
+Homepage = "https://github.com/udapi/udapi-python"
+
+[project.optional-dependencies]
+test = ["pytest"]
+udpipe = ["ufal.udpipe"]
+
+[project.scripts]
+udapy = "udapi.cli:main"
+
+[tool.setuptools]
+packages = {find = {}}
+include-package-data = true
diff --git a/setup.cfg b/setup.cfg
deleted file mode 100644
index 2cdfaaa9..00000000
--- a/setup.cfg
+++ /dev/null
@@ -1,29 +0,0 @@
-[metadata]
-name = udapi
-version = 0.5.1
-author = Martin Popel
-author_email = popel@ufal.mff.cuni.cz
-description = Python framework for processing Universal Dependencies data
-long_description = file: README.md
-long_description_content_type = text/markdown
-url = https://github.com/udapi/udapi-python
-classifiers =
-    Programming Language :: Python :: 3
-    License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
-    Operating System :: OS Independent
-
-[options]
-packages = find:
-python_requires = >=3.9
-include_package_data = True
-install_requires =
-    colorama
-    termcolor
-
-[options.entry_points]
-console_scripts =
-    udapy = udapi:cli.main
-
-[options.extras_require]
-test =
-    pytest
diff --git a/setup.py b/setup.py
deleted file mode 100644
index 7f1a1763..00000000
--- a/setup.py
+++ /dev/null
@@ -1,4 +0,0 @@
-from setuptools import setup
-
-if __name__ == "__main__":
-    setup()

From ecd5f88cc1b853039a33fab2d34bf4b9ae813118 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Mon, 15 Dec 2025 16:53:07 +0100
Subject: [PATCH 1329/1374] improve docstring for write.TextModeTrees

---
 udapi/block/write/textmodetrees.py | 74 +++++++++++++++---------------
 1 file changed, 38 insertions(+), 36 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index 885f797f..a4726e5f 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -23,7 +23,7 @@
 
 
 class TextModeTrees(BaseWriter):
-    """An ASCII pretty printer of dependency trees.
+    r"""An ASCII pretty printer of dependency trees.
 
     .. code-block:: bash
 
@@ -110,7 +110,7 @@ class TextModeTrees(BaseWriter):
          │   ╰─┶   boxer NOUN  acl:relcl
          ╰─╼       .     PUNCT punct
 
-    Some non-projective trees cannot be printed witout crossing edges.
+    Some non-projective trees cannot be printed without crossing edges.
     TextModeTrees uses a special "bridge" symbol ─╪─ to mark this::
 
       ─┮
@@ -123,17 +123,17 @@ class TextModeTrees(BaseWriter):
     (not file or pipe), each node attribute is printed in different color.
     If a given node's MISC contains any of `ToDo`, `Bug` or `Mark` attributes
     (or any other specified in the parameter `mark`), the node will be highlighted
-    (by reveresing the background and foreground colors).
+    (by reversing the background and foreground colors).
 
     This block's method `process_tree` can be called on any node (not only root),
     which is useful for printing subtrees using ``node.draw()``,
     which is internally implemented using this block.
 
     For use in LaTeX, you can insert the output of this block (without colors)
-    into \begin{verbatim}...\end{verbatim}, but you need to compile with pdflatex (xelatex not supported)
-    and you must add the following code into the preambule::
+    into ``\begin{verbatim}...\end{verbatim}``, but you need to compile with pdflatex (xelatex not supported)
+    and you must add the following code into the preamble::
 
-      \\usepackage{pmboxdraw}
+      \usepackage{pmboxdraw}
       \DeclareUnicodeCharacter{256D}{\textSFi}  %╭
       \DeclareUnicodeCharacter{2570}{\textSFii} %╰
 
@@ -149,36 +149,38 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         """Create new TextModeTrees block object.
 
         Args:
-        print_sent_id: Print ID of the tree (its root, aka "sent_id") above each tree?
-        print_sentence: Print plain-text detokenized sentence on a line above each tree?
-        add_empty_line: Print an empty line after each tree?
-        indent: Number of characters to indent node depth in the tree for better readability.
-        minimize_cross: Minimize crossings of edges in non-projective trees?
-                        Trees without crossings are subjectively more readable, but usually
-                        in practice also "deeper", that is with higher maximal line length.
-        color: Print the node attribute with ANSI terminal colors?
-               Default = 'auto' which means that color output only if the output filehandle
-               is interactive (console). Each attribute is assigned a color (the mapping is
-               tested on black background terminals and can be changed only in source code).
-               If you plan to pipe the output (e.g. to "less -R") and you want the colors,
-               you need to set explicitly color=1, see the example in Synopsis.
-        attributes: A comma-separated list of node attributes which should be printed. Possible
-                    values are ord, form, lemma, upos, xpos, feats, deprel, deps, misc.
-        print_undef_as: What should be printed instead of undefined attribute values (if any)?
-        print_doc_meta: Print `document.meta` metadata before each document?
-        print_comments: Print comments (other than sent_id and text)?
-        print_empty: Print empty nodes?
-        mark: a regex. If `re.search(mark + '=', str(node.misc))` the node is highlighted.
-            If `print_comments and re.search(r'^ %s = ' % mark, root.comment, re.M)`
-            the comment is highlighted.
-            Empty string means no highlighting. Default = 'ToDo|ToDoOrigText|Bug|Mark'.
-        marked_only: print only trees containing one or more marked nodes/comments. Default=False.
-        hints: use thick-marked segments (┡ and ┢) to distinguish whether a given node precedes
-            or follows its parent. Default=True. If False, plain ├ is used in both cases.
-        layout: 'classic' (default) shows word attributes immediately next to each node,
-            'compact' never print edges after (right to) words even in non-projectivities,
-            'align-words' as 'compact' but all first attributes (forms by default) are aligned,
-            'align' as 'align-words' but all attributes are aligned in columns.
+            print_sent_id: Print ID of the tree (its root, aka "sent_id") above each tree?
+            print_text: Print plain-text detokenized sentence on a line above each tree?
+            add_empty_line: Print an empty line after each tree?
+            indent: Number of characters to indent node depth in the tree for better readability.
+            minimize_cross: Minimize crossings of edges in non-projective trees?
+                Trees without crossings are subjectively more readable, but usually
+                in practice also "deeper", that is with higher maximal line length.
+            color: Print the node attribute with ANSI terminal colors?
+                Default = 'auto' which means that color output only if the output filehandle
+                is interactive (console). Each attribute is assigned a color (the mapping is
+                tested on black background terminals and can be changed only in source code).
+                If you plan to pipe the output (e.g. to "less -R") and you want the colors,
+                you need to set explicitly color=1, see the example in Synopsis.
+            attributes: A comma-separated list of node attributes which should be printed. Possible
+                values are ``ord``, ``form``, ``lemma``, ``upos``, ``xpos``, ``feats``, ``deprel``, ``deps``, ``misc``.
+            print_undef_as: What should be printed instead of undefined attribute values (if any)?
+            print_doc_meta: Print ``document.meta`` metadata before each document?
+            print_comments: Print comments (other than ``sent_id`` and ``text``)?
+            print_empty: Print empty nodes?
+            mark: A regex pattern. If ``re.search(mark + '=', str(node.misc))`` matches, the node is highlighted.
+                If ``print_comments`` and ``re.search(r'^ %s = ' % mark, root.comment, re.M)`` matches,
+                the comment is highlighted. Empty string means no highlighting.
+                Default = ``'(ToDo|ToDoOrigText|Bug|Mark)'``.
+            marked_only: Print only trees containing one or more marked nodes/comments. Default ``False``.
+            hints: Use thick-marked segments (┡ and ┢) to distinguish whether a given node precedes
+                or follows its parent. Default ``True``. If ``False``, plain ├ is used in both cases.
+            layout: Tree layout style:
+
+                - ``'classic'`` (default): shows word attributes immediately next to each node
+                - ``'compact'``: never print edges after (right to) words even in non-projectivities
+                - ``'align-words'``: like ``'compact'`` but all first attributes (forms by default) are aligned
+                - ``'align'``: like ``'align-words'`` but all attributes are aligned in columns
         """
         super().__init__(**kwargs)
         self.print_sent_id = print_sent_id

From 4ba6c1018b4c3061577dda7cac123df0e27b6772 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Wed, 17 Dec 2025 20:36:50 +0100
Subject: [PATCH 1330/1374] Add annotation for periphrasis with ir and aller

---
 udapi/block/msf/romance/romance.py | 81 ++++++++++++++++++++++++++++--
 1 file changed, 77 insertions(+), 4 deletions(-)

diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
index cde1cfc6..b3b1efc7 100644
--- a/udapi/block/msf/romance/romance.py
+++ b/udapi/block/msf/romance/romance.py
@@ -36,6 +36,9 @@ def __init__(self, neg=True, **kwargs):
 
     def process_node(self, node):
 
+        if node.misc['Phrase'] != '':
+            return
+
         cop = [x for x in node.children if x.udeprel == 'cop']
         
         # only expl or expl:pv, no expl:impers or expl:pass
@@ -117,6 +120,7 @@ def process_node(self, node):
                     phrase_ords = [node.ord] + [r.ord for r in refl]
                 phrase_ords.sort()
 
+                self.process_phrases_with_ir_aller(node, expl, polarity, phrase_ords, node)
                 self.process_simple_verb_forms(node, expl, polarity, phrase_ords, node)
 
 
@@ -147,6 +151,7 @@ def process_node(self, node):
                     phrase_ords.sort()
 
                     # TODO phrase-level features are currently determined based on the first passive auxiliary, but it can happen that there are more than one passive auxiliary
+                    self.process_phrases_with_ir_aller(auxes[0], expl, polarity, phrase_ords, node)
                     self.process_simple_verb_forms(auxes[0], expl, polarity, phrase_ords, node)
 
                 # head verb has passive auxiliary and also other auxiliaries
@@ -224,6 +229,7 @@ def process_modal_verbs(self, modals, modal_auxes, modal_neg):
                     polarity='Neg'
             else:
                 phrase_ords = [modals[0].ord]
+            self.process_phrases_with_ir_aller(modals[0], '', polarity, phrase_ords, modals[0])
             self.process_simple_verb_forms(modals[0], '', polarity, phrase_ords, modals[0]) 
 
         else:
@@ -238,6 +244,66 @@ def process_modal_verbs(self, modals, modal_auxes, modal_neg):
 
             self.process_periphrastic_verb_forms(modals[0], modal_auxes, '', polarity, phrase_ords, modals[0])
 
+    def process_phrases_with_ir_aller(self, node, expl, polarity, phrase_ords, head_node):
+        aspect = ''
+        tense = node.feats['Tense']
+
+        # phrase already annotated
+        if head_node.misc['Phrase'] != '':
+            return
+
+        xcomps = [x for x in node.children if x.udeprel == 'xcomp']
+        if node.lemma in ['ir', 'aller'] and node.upos == 'VERB' and xcomps:
+            node.misc['PhraseAux'] = 'Yes'
+
+            voice = node.feats['Voice']
+            auxes = [x for x in xcomps[0].children if x.udeprel == 'aux']
+            aux_pass = [x for x in auxes if x.deprel == 'aux:pass']
+            auxes_without_pass = [x for x in auxes if x.deprel != 'aux:pass']
+
+            if node.feats['Tense'] == 'Pres':
+                tense = 'Fut'
+                
+            elif node.feats['Tense'] == 'Imp':
+                tense = 'PastFut'
+                aspect = 'Imp'
+
+            elif node.feats['Tense'] == 'Fut':
+                tense = 'FutFut'
+            
+            elif node.feats['Tense'] == 'Past':
+                tense = 'PastFut'
+                aspect = 'Perf'
+
+            if auxes_without_pass:
+                if auxes[0].lemma == 'estar':
+                    aspect += 'Prog'
+                if auxes[0].lemma == 'haber':
+                    aspect += 'Perf'
+
+            adp_a = [x for x in xcomps[0].children if x.lemma == 'a' and x.upos == 'ADP' and x.udeprel == 'mark']
+            cop = [x for x in xcomps[0].children if x.udeprel == 'cop']
+            phrase_ords = [node.ord, xcomps[0].ord] + [x.ord for x in auxes] + [x.ord for x in cop]
+            if adp_a:
+                phrase_ords.append(adp_a[0].ord)
+
+            if aux_pass:
+                voice='Pass'
+
+            phrase_ords.sort()
+
+            self.write_node_info(xcomps[0],
+                                 tense = tense,
+                                 number = node.feats['Number'],
+                                 person = node.feats['Person'],
+                                 aspect = aspect,
+                                 mood = node.feats['Mood'],
+                                 form = 'Fin',
+                                 voice=voice,
+                                 expl = expl,
+                                 polarity = polarity,
+                                 ords=phrase_ords)
+            return
 
     def process_simple_verb_forms(self, node, expl, polarity, phrase_ords, head_node):
         """
@@ -251,6 +317,9 @@ def process_simple_verb_forms(self, node, expl, polarity, phrase_ords, head_node
             head_node (udapi.core.node.Node): The node that should receive the Phrase* attributes, i.e., the head of the phrase.
         """
 
+        if node.misc['PhraseAux'] != '':
+            return
+
         # Portuguese
         # presente -> PhraseTense=Pres, PhraseAspect=''
         # Futuro do presente -> PhraseTense=Fut, PhraseAspect=''
@@ -266,7 +335,7 @@ def process_simple_verb_forms(self, node, expl, polarity, phrase_ords, head_node
         aspect = ''
         tense = node.feats['Tense']
         form = node.feats['VerbForm']
-
+       
         if node.feats['Mood'] == 'Ind':
             
             # Portuguese
@@ -358,7 +427,6 @@ def process_simple_verb_forms(self, node, expl, polarity, phrase_ords, head_node
             ords=phrase_ords
         )
 
-
     def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_ords, head_node):
         """
         Annotate periphrastic verb forms with the Phrase* attributes.
@@ -372,6 +440,10 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
             head_node (udapi.core.node.Node): The node that should receive the Phrase* attributes, i.e., the head of the phrase.
         """
 
+        # phrase already annotated
+        if head_node.misc['Phrase'] != '':
+            return
+        
         if len(auxes)  == 1:
             # Cnd
             if auxes[0].feats['Mood'] == 'Cnd' and (node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'Ger'):
@@ -572,7 +644,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                 
             # auxiliary 'ir' followed by infinitive
             # TODO solve these verb forms for Spanish (VERB 'ir' + ADP 'a' + infinitive)
-            if auxes[0].lemma == 'ir' and node.feats['VerbForm'] == 'Inf':
+            if auxes[0].lemma in ['ir'] and node.feats['VerbForm'] == 'Inf':
 
                 tense=node.feats['Tense']
                 aspect=''
@@ -595,7 +667,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                 # Futuro perifrástico passado perf -> PhraseTense=PastFut, PhraseAspect=Perf
                 elif auxes[0].feats['Tense'] == 'Past':
                     tense=Tense.PASTFUT.value
-                    aspect=Aspect.PERF.value                
+                    aspect=Aspect.PERF.value           
 
                 self.write_node_info(head_node,
                     tense=tense,
@@ -732,6 +804,7 @@ def process_copulas(self, node, cop, expl, polarity, phrase_ords):
         """
 
         # classify the morphological features of the copula node and propagate them to the entire phrase (treating the copula as the content verb)
+        self.process_phrases_with_ir_aller(cop[0], expl, polarity, phrase_ords, node)
         self.process_simple_verb_forms(cop[0], expl, polarity, phrase_ords, node)
 
         # adjust PhraseAspect based on the lemma of the copula

From c321cfe944cb0168ad225d4d7e64d01b2323c04b Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Wed, 17 Dec 2025 21:05:39 +0100
Subject: [PATCH 1331/1374] Extend Romance block to support European Portuguese

---
 udapi/block/msf/romance/romance.py | 26 +++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
index b3b1efc7..dc030d23 100644
--- a/udapi/block/msf/romance/romance.py
+++ b/udapi/block/msf/romance/romance.py
@@ -253,7 +253,7 @@ def process_phrases_with_ir_aller(self, node, expl, polarity, phrase_ords, head_
             return
 
         xcomps = [x for x in node.children if x.udeprel == 'xcomp']
-        if node.lemma in ['ir', 'aller'] and node.upos == 'VERB' and xcomps:
+        if node.lemma in ['ir', 'aller', 'estar'] and node.upos == 'VERB' and xcomps:
             node.misc['PhraseAux'] = 'Yes'
 
             voice = node.feats['Voice']
@@ -261,7 +261,26 @@ def process_phrases_with_ir_aller(self, node, expl, polarity, phrase_ords, head_
             aux_pass = [x for x in auxes if x.deprel == 'aux:pass']
             auxes_without_pass = [x for x in auxes if x.deprel != 'aux:pass']
 
-            if node.feats['Tense'] == 'Pres':
+            # European Portuguese: estar + a + Inf
+            if node.lemma == 'estar':
+
+                if node.feats['Tense'] == 'Pres':
+                    tense = 'Pres'
+                    aspect = 'Prog'
+
+                elif node.feats['Tense'] == 'Imp':
+                    tense = 'Past'
+                    aspect = 'ImpProg'
+
+                elif node.feats['Tense'] == 'Past':
+                    tense = 'Past'
+                    aspect = 'PerfProg'
+
+                elif node.feats['Tense'] == 'Fut':
+                    tense = 'Fut'
+                    aspect = 'Prog'
+
+            elif node.feats['Tense'] == 'Pres':
                 tense = 'Fut'
                 
             elif node.feats['Tense'] == 'Imp':
@@ -275,13 +294,14 @@ def process_phrases_with_ir_aller(self, node, expl, polarity, phrase_ords, head_
                 tense = 'PastFut'
                 aspect = 'Perf'
 
+
             if auxes_without_pass:
                 if auxes[0].lemma == 'estar':
                     aspect += 'Prog'
                 if auxes[0].lemma == 'haber':
                     aspect += 'Perf'
 
-            adp_a = [x for x in xcomps[0].children if x.lemma == 'a' and x.upos == 'ADP' and x.udeprel == 'mark']
+            adp_a = [x for x in xcomps[0].children if x.lemma == 'a' and x.udeprel == 'mark']
             cop = [x for x in xcomps[0].children if x.udeprel == 'cop']
             phrase_ords = [node.ord, xcomps[0].ord] + [x.ord for x in auxes] + [x.ord for x in cop]
             if adp_a:

From 6c30a5b048b5baf8dc5e5e3cafc49acd1009e6fe Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Tue, 23 Dec 2025 01:19:05 +0100
Subject: [PATCH 1332/1374] update installation instructions in README

* suggest `pip install -e .` instead of editing the PYTHONPATH and PATH environment variables (which does not work nicely in Windows and/or VSCode)
* suggest venv instead of `--user`
* suggest `pip` instead of `pip3` (Python2 is not supported anyway)
* delete details about the C++11 compiler for ufal.udpipe
---
 README.md | 18 +++++++-----------
 1 file changed, 7 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 9551b720..36465c78 100644
--- a/README.md
+++ b/README.md
@@ -7,27 +7,23 @@ Python framework for processing Universal Dependencies data
 
 ## Requirements
 - You need Python 3.9 or higher.
-- If the [ufal.udpipe](https://pypi.python.org/pypi/ufal.udpipe/) parser is needed,
-  make sure you have a C++11 compiler (e.g. [g++ 4.7 or newer](.travis.yml#L9))
-  and install UDPipe with `pip3 install --user --upgrade ufal.udpipe`.
+- It is recommended to install Udapi in a Python virtual environment.
+- If you need the [ufal.udpipe](https://pypi.python.org/pypi/ufal.udpipe/) parser (to be used from Udapi)
+  install it (with `pip install --upgrade ufal.udpipe`).
 
 ## Install Udapi for developers
-Let's clone the git repo to `~/udapi-python/`, install dependencies
-and setup `$PATH` and `$PYTHONPATH` accordingly.
+Let's clone the git repo e.g. to `~/udapi-python/` and make an [editable installation](https://setuptools.pypa.io/en/latest/userguide/development_mode.html)
 ```bash
 cd
 git clone https://github.com/udapi/udapi-python.git
-pip3 install --user -r udapi-python/requirements.txt
-echo '## Use Udapi from ~/udapi-python/ ##'                >> ~/.bashrc
-echo 'export PATH="$HOME/udapi-python/bin:$PATH"'          >> ~/.bashrc
-echo 'export PYTHONPATH="$HOME/udapi-python/:$PYTHONPATH"' >> ~/.bashrc
-source ~/.bashrc # or open new bash
+cd udapi-python
+pip install -e .
 ```
 
 ## Install Udapi for users
 This is similar to the above, but installs Udapi from PyPI to the standard (user) Python paths.
 ```
-pip3 install --user --upgrade udapi
+pip install --upgrade udapi
 ```
 Try `udapy -h` to check it is installed correctly.
 If it fails, make sure your `PATH` includes the directory where `pip3` installed the `udapy` script.

From 0a6c3286fe622b4018427ddd5525e36d516e6f49 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Fri, 26 Dec 2025 15:37:22 +0100
Subject: [PATCH 1333/1374] Extend Romance block to support Romanian

---
 udapi/block/msf/romance/romance.py | 166 +++++++++++++++++++++++------
 1 file changed, 136 insertions(+), 30 deletions(-)

diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
index dc030d23..4caf9810 100644
--- a/udapi/block/msf/romance/romance.py
+++ b/udapi/block/msf/romance/romance.py
@@ -265,34 +265,34 @@ def process_phrases_with_ir_aller(self, node, expl, polarity, phrase_ords, head_
             if node.lemma == 'estar':
 
                 if node.feats['Tense'] == 'Pres':
-                    tense = 'Pres'
-                    aspect = 'Prog'
+                    tense=Tense.PRES.value
+                    aspect =Aspect.PROG.value
 
                 elif node.feats['Tense'] == 'Imp':
-                    tense = 'Past'
-                    aspect = 'ImpProg'
+                    tense=Tense.PAST.value
+                    aspect=Aspect.IMPPROG.value
 
                 elif node.feats['Tense'] == 'Past':
-                    tense = 'Past'
-                    aspect = 'PerfProg'
+                    tense=Tense.PAST.value
+                    aspect=Aspect.PERFPROG.value
 
                 elif node.feats['Tense'] == 'Fut':
-                    tense = 'Fut'
-                    aspect = 'Prog'
+                    tense=Tense.FUT.value
+                    aspect=Aspect.PROG.value
 
             elif node.feats['Tense'] == 'Pres':
-                tense = 'Fut'
+                tense=Tense.FUT.value
                 
             elif node.feats['Tense'] == 'Imp':
-                tense = 'PastFut'
-                aspect = 'Imp'
+                tense=Tense.PASTFUT.value
+                aspect=Aspect.IMP.value
 
             elif node.feats['Tense'] == 'Fut':
-                tense = 'FutFut'
+                tense=Tense.FUTFUT.value
             
             elif node.feats['Tense'] == 'Past':
-                tense = 'PastFut'
-                aspect = 'Perf'
+                tense=Tense.PASTFUT.value
+                aspect=Aspect.PERF.value
 
 
             if auxes_without_pass:
@@ -378,15 +378,30 @@ def process_simple_verb_forms(self, node, expl, polarity, phrase_ords, head_node
 
             # Italian
             # pass remoto -> PhraseTense=Past, PhraseAspect=Perf
-            if node.feats['Tense'] == 'Past':
+            elif node.feats['Tense'] == 'Past':
                 aspect=Aspect.PERF.value
 
             # Portuguese
             # pretérito mais que perfeito simples -> PhraseTense=Past, PhraseAspect=Pqp
-            if node.feats['Tense'] == 'Pqp':
+            elif node.feats['Tense'] == 'Pqp':
                 tense=Tense.PAST.value
                 aspect=Aspect.PQP.value
-                
+
+            else:
+                # viitorul popular/colocvial (intentional future) -> PhraseTense=Fut, PhraseAspect=''
+                o = [x for x in node.children if x.lemma == 'o' and x.upos == 'PART']
+                sa = [x for x in node.children if x.lemma == 'să' and x.upos == 'PART']
+
+
+                if o and sa:
+                    tense = Tense.FUT.value
+                    phrase_ords.append(o[0].ord)
+                    phrase_ords.append(sa[0].ord)
+
+                    phrase_ords.sort()
+
+                    
+                       
         # Portuguese
         # subjunctive presente -> PhraseTense=Pres, PhraseAspect=''
         # subjunctive futuro -> PhraseTense=Fut, PhraseAspect=''
@@ -464,7 +479,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
         if head_node.misc['Phrase'] != '':
             return
         
-        if len(auxes)  == 1:
+        if len(auxes) == 1:
             # Cnd
             if auxes[0].feats['Mood'] == 'Cnd' and (node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'Ger'):
 
@@ -599,6 +614,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                 aspect=Aspect.PERF.value
                 tense=auxes[0].feats['Tense']
                 form='Fin'
+                mood=auxes[0].feats['Mood']
 
                 adp_en = [x for x in node.children if x.lemma == 'en' and x.upos == 'ADP' and x.udeprel == 'mark']
                 if auxes[0].feats['VerbForm'] == 'Part' and adp_en:
@@ -609,6 +625,13 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     form='Ger'
 
 
+                # Romanian
+                # Perfect compus -> PhraseTense=Past, PhraseAspect=Perf
+                elif auxes[0].lemma == 'avea':
+                    tense = Tense.PAST.value
+                    aspect = Aspect.PERF.value
+                    form = 'Fin'
+
                 # Spanish
                 # Pretérito perfecto compuesto ante presente -> PhraseTense=Past, PhraseAspect=Perf
 
@@ -619,8 +642,12 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     # Portuguese
                     # pretérito perfeito composto (aux ter) -> PhraseTense=PastPres, PhraseAspect=Perf
                     # subjonctive pretérito perfeito composto (aux ter) -> PhraseTense=PastPres, PhraseAspect=Perf, PhraseMood=Sub
-                    if auxes[0].lemma == 'ter' or auxes[0].feats['Mood'] == 'Sub':
+                    if auxes[0].lemma in ['ter', 'fi'] or auxes[0].feats['Mood'] == 'Sub':
                         tense = Tense.PASTPRES.value
+
+                        # subjonctive mood not annotated in Romanian data
+                        if auxes[0].lemma == 'fi':
+                            mood='Sub'
                     else:
                         tense=Tense.PAST.value
 
@@ -653,7 +680,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     tense=tense,
                     number=auxes[0].feats['Number'],
                     person=auxes[0].feats['Person'],
-                    mood=auxes[0].feats['Mood'],
+                    mood=mood,
                     aspect=aspect,
                     form=form,
                     voice=head_node.feats['Voice'],
@@ -662,9 +689,8 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     ords=phrase_ords)
                 return
                 
-            # auxiliary 'ir' followed by infinitive
-            # TODO solve these verb forms for Spanish (VERB 'ir' + ADP 'a' + infinitive)
-            if auxes[0].lemma in ['ir'] and node.feats['VerbForm'] == 'Inf':
+            # auxiliary 'ir' or 'vrea' followed by infinitive
+            if auxes[0].lemma in ['ir', 'vrea'] and node.feats['VerbForm'] == 'Inf':
 
                 tense=node.feats['Tense']
                 aspect=''
@@ -687,7 +713,12 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                 # Futuro perifrástico passado perf -> PhraseTense=PastFut, PhraseAspect=Perf
                 elif auxes[0].feats['Tense'] == 'Past':
                     tense=Tense.PASTFUT.value
-                    aspect=Aspect.PERF.value           
+                    aspect=Aspect.PERF.value
+
+                # Viitorul standard/literar/simplu -> PhraseTense=Fut, PhraseAspect=''
+                if auxes[0].lemma == 'vrea':
+                    tense = Tense.FUT.value
+                    aspect = ''      
 
                 self.write_node_info(head_node,
                     tense=tense,
@@ -701,13 +732,90 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     polarity=polarity,
                     ords=phrase_ords)
                 
+                return
+            
+            # condițional-optativ prezent -> PhraseTense=Pres, PhraseAspect=''
+            if auxes[0].lemma == 'avea' and node.feats['VerbForm'] == 'Inf':
+                tense=Tense.PRES.value
+                aspect=''
+                self.write_node_info(head_node,
+                    tense=tense,
+                    aspect=aspect,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood='Cnd',
+                    form='Fin',
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    polarity=polarity,
+                    ords=phrase_ords)
+                
+                return
+            
+            # viitor popular/colloquial (obligative future) -> PhraseTense=Fut, PhraseAspect=''
+            # viitor popular (potential future - contracted form) -> PhraseTense=Fut, PhraseAspect=''
+            if node.feats['VerbForm'] == 'Fin':
+                sa = [x for x in node.children if x.lemma == 'să' and x.upos == 'PART']
+
+                if sa:
+                    phrase_ords.append(sa[0].ord)
+                    phrase_ords.sort()
+
+                tense=Tense.FUT.value
+                aspect=''
+
+                self.write_node_info(head_node,
+                    tense=tense,
+                    aspect=aspect,
+                    number=head_node.feats['Number'],
+                    person=head_node.feats['Person'],
+                    mood=head_node.feats['Mood'],
+                    form='Fin',
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    polarity=polarity,
+                    ords=phrase_ords)
+                
+                return       
                 
         elif len(auxes) == 2:
+            # Romanian
+            # viitor anterior -> PhraseTense=Fut, PhraseAsoect=Perf
+            if auxes[0].lemma == 'vrea' and auxes[1].lemma == 'fi' and node.feats['VerbForm'] == 'Part':
+
+                self.write_node_info(head_node,
+                    tense=Tense.PAST.value,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood=auxes[0].feats['Mood'],
+                    form='Fin',
+                    aspect=Aspect.PERF.value,
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    polarity=polarity,
+                    ords=phrase_ords)
+                
+                return
+                
+            # condițional-optativ perfect -> PhraseTense=Past    
+            if auxes[0].lemma == 'avea' and auxes[1].lemma == 'fi' and node.feats['VerbForm'] == 'Part':
+
+                self.write_node_info(head_node,
+                    tense=Tense.PAST.value,
+                    number=auxes[0].feats['Number'],
+                    person=auxes[0].feats['Person'],
+                    mood='Cnd',
+                    form='Fin',
+                    aspect='',
+                    voice=head_node.feats['Voice'],
+                    expl=expl,
+                    polarity=polarity,
+                    ords=phrase_ords)
+                
+                return
+
             # Portuguese
             # auxiliry 'ir' followed by auxiliary 'estar' in infinitive and a gerund
-
-            # TODO Spanish
-            # VERB 'ir' + ADP 'a' + AUX 'estar'.Inf + gerund
             if auxes[0].lemma == 'ir' and auxes[1].lemma == 'estar' and node.feats['VerbForm'] == 'Ger':
 
                 # Futuro perifrástico -> PhraseTense=Fut, PhraseAspect=Prog
@@ -765,9 +873,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     expl=expl,
                     polarity=polarity,
                     ords=phrase_ords)    
-                
-            
-                
+                        
             # Cnd (only ter/haber), Sub and Past,Pres,Fut tenses: 2 auxes - ter/haber + estar
             if auxes[0].lemma in AUXES_HAVE and auxes[1].lemma == 'estar' and node.feats['VerbForm'] == 'Ger':
 

From b80d87e7e997b50b05ac34ce421478a6d5ece610 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Sun, 28 Dec 2025 12:26:10 +0100
Subject: [PATCH 1334/1374] Rename Phrase to Peri

---
 udapi/block/msf/phrase.py          | 38 ++++++++++++--------
 udapi/block/msf/romance/romance.py | 57 +++++++++++++++++++++---------
 2 files changed, 64 insertions(+), 31 deletions(-)

diff --git a/udapi/block/msf/phrase.py b/udapi/block/msf/phrase.py
index 90ea5d2d..867ed826 100644
--- a/udapi/block/msf/phrase.py
+++ b/udapi/block/msf/phrase.py
@@ -17,19 +17,20 @@ def process_node(self, node):
         logging.fatal('process_node() not implemented.')
 
     dictionary = {
-		'person': 'PhrasePerson',
-		'number': 'PhraseNumber',
-		'mood': 'PhraseMood',
-		'tense': 'PhraseTense',
-		'voice': 'PhraseVoice',
-		'aspect':'PhraseAspect',
-		'form': 'PhraseForm',
-		'reflex': 'PhraseReflex',
-		'polarity': 'PhrasePolarity',
-		'gender':'PhraseGender',
-		'animacy':'PhraseAnimacy',
-		'ords':'Phrase',
-        'expl':'PhraseExpl',
+		'person': 'PeriPerson',
+		'number': 'PeriNumber',
+		'mood': 'PeriMood',
+		'tense': 'PeriTense',
+		'voice': 'PeriVoice',
+		'aspect':'PeriAspect',
+		'form': 'PeriForm',
+		'reflex': 'PeriReflex',
+		'polarity': 'PeriPolarity',
+		'gender':'PeriGender',
+		'animacy':'PeriAnimacy',
+		'ords':'Peri',
+        'expl':'PeriExpl',
+        'periphrasis':'Periphrasis',
 		}
     
     # a dictionary where the key is the lemma of a negative particle and the value is a list of the lemmas of their possible children that have a 'fixed' relation
@@ -70,7 +71,8 @@ def write_node_info(self, node,
 			gender = None,
 			animacy = None,
 			aspect = None,
-            expl=None):
+            expl=None,
+            periphrasis=None):
         arguments = locals()
         del arguments['self'] # delete self and node from arguments,
         del arguments['node'] # we want only grammatical categories 
@@ -136,4 +138,12 @@ def get_voice(self,node,refl):
         if self.is_expl_pass(refl):
             return 'Pass'
         return voice
+    
+    def get_periphrasis_bool(self,node):
+        auxes = [x for x in node.children if x.udeprel == 'aux']
+
+        if auxes:
+            return 'Yes'
+        else:
+            return 'No'
 
diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
index 4caf9810..9ff0c9ec 100644
--- a/udapi/block/msf/romance/romance.py
+++ b/udapi/block/msf/romance/romance.py
@@ -36,7 +36,7 @@ def __init__(self, neg=True, **kwargs):
 
     def process_node(self, node):
 
-        if node.misc['Phrase'] != '':
+        if node.misc['Peri'] != '':
             return
 
         cop = [x for x in node.children if x.udeprel == 'cop']
@@ -102,6 +102,7 @@ def process_node(self, node):
                         gender=node.feats['Gender'],
                         voice=node.feats['Voice'],
                         expl=expl,
+                        periphrasis=self.get_periphrasis_bool(node),
                         ords=[node.ord]
                     )
                 return
@@ -120,7 +121,7 @@ def process_node(self, node):
                     phrase_ords = [node.ord] + [r.ord for r in refl]
                 phrase_ords.sort()
 
-                self.process_phrases_with_ir_aller(node, expl, polarity, phrase_ords, node)
+                self.process_phrases_with_ir_aller_estar(node, expl, polarity, phrase_ords, node)
                 self.process_simple_verb_forms(node, expl, polarity, phrase_ords, node)
 
 
@@ -151,7 +152,7 @@ def process_node(self, node):
                     phrase_ords.sort()
 
                     # TODO phrase-level features are currently determined based on the first passive auxiliary, but it can happen that there are more than one passive auxiliary
-                    self.process_phrases_with_ir_aller(auxes[0], expl, polarity, phrase_ords, node)
+                    self.process_phrases_with_ir_aller_estar(auxes[0], expl, polarity, phrase_ords, node)
                     self.process_simple_verb_forms(auxes[0], expl, polarity, phrase_ords, node)
 
                 # head verb has passive auxiliary and also other auxiliaries
@@ -229,7 +230,7 @@ def process_modal_verbs(self, modals, modal_auxes, modal_neg):
                     polarity='Neg'
             else:
                 phrase_ords = [modals[0].ord]
-            self.process_phrases_with_ir_aller(modals[0], '', polarity, phrase_ords, modals[0])
+            self.process_phrases_with_ir_aller_estar(modals[0], '', polarity, phrase_ords, modals[0])
             self.process_simple_verb_forms(modals[0], '', polarity, phrase_ords, modals[0]) 
 
         else:
@@ -244,17 +245,17 @@ def process_modal_verbs(self, modals, modal_auxes, modal_neg):
 
             self.process_periphrastic_verb_forms(modals[0], modal_auxes, '', polarity, phrase_ords, modals[0])
 
-    def process_phrases_with_ir_aller(self, node, expl, polarity, phrase_ords, head_node):
+    def process_phrases_with_ir_aller_estar(self, node, expl, polarity, phrase_ords, head_node):
         aspect = ''
         tense = node.feats['Tense']
 
         # phrase already annotated
-        if head_node.misc['Phrase'] != '':
+        if head_node.misc['Peri'] != '':
             return
 
         xcomps = [x for x in node.children if x.udeprel == 'xcomp']
-        if node.lemma in ['ir', 'aller', 'estar'] and node.upos == 'VERB' and xcomps:
-            node.misc['PhraseAux'] = 'Yes'
+        if node.lemma in ['ir', 'aller', 'estar', 'ter'] and node.upos == 'VERB' and xcomps:
+            node.misc['PeriAux'] = 'Yes'
 
             voice = node.feats['Voice']
             auxes = [x for x in xcomps[0].children if x.udeprel == 'aux']
@@ -280,6 +281,11 @@ def process_phrases_with_ir_aller(self, node, expl, polarity, phrase_ords, head_
                     tense=Tense.FUT.value
                     aspect=Aspect.PROG.value
 
+            elif node.lemma == 'ter' and len(xcomps) > 1:
+                tense=Tense.PAST.value
+                aspect=Aspect.PROG.value
+                xcomps[0].misc['PeriAux'] = 'Yes'
+
             elif node.feats['Tense'] == 'Pres':
                 tense=Tense.FUT.value
                 
@@ -301,18 +307,20 @@ def process_phrases_with_ir_aller(self, node, expl, polarity, phrase_ords, head_
                 if auxes[0].lemma == 'haber':
                     aspect += 'Perf'
 
-            adp_a = [x for x in xcomps[0].children if x.lemma == 'a' and x.udeprel == 'mark']
+            
+
+            adp_a = [x for x in xcomps[-1].children if x.lemma == 'a' and x.udeprel == 'mark']
             cop = [x for x in xcomps[0].children if x.udeprel == 'cop']
-            phrase_ords = [node.ord, xcomps[0].ord] + [x.ord for x in auxes] + [x.ord for x in cop]
+            phrase_ords = [node.ord] + [x.ord for x in xcomps] + [x.ord for x in auxes] + [x.ord for x in cop]
             if adp_a:
-                phrase_ords.append(adp_a[0].ord)
+                phrase_ords += [x.ord for x in adp_a]
 
             if aux_pass:
                 voice='Pass'
 
             phrase_ords.sort()
 
-            self.write_node_info(xcomps[0],
+            self.write_node_info(xcomps[-1],
                                  tense = tense,
                                  number = node.feats['Number'],
                                  person = node.feats['Person'],
@@ -322,6 +330,7 @@ def process_phrases_with_ir_aller(self, node, expl, polarity, phrase_ords, head_
                                  voice=voice,
                                  expl = expl,
                                  polarity = polarity,
+                                 periphrasis='Yes',
                                  ords=phrase_ords)
             return
 
@@ -337,7 +346,7 @@ def process_simple_verb_forms(self, node, expl, polarity, phrase_ords, head_node
             head_node (udapi.core.node.Node): The node that should receive the Phrase* attributes, i.e., the head of the phrase.
         """
 
-        if node.misc['PhraseAux'] != '':
+        if node.misc['PeriAux'] != '':
             return
 
         # Portuguese
@@ -459,6 +468,7 @@ def process_simple_verb_forms(self, node, expl, polarity, phrase_ords, head_node
             voice=head_node.feats['Voice'],
             expl=expl,
             polarity=polarity,
+            periphrasis=self.get_periphrasis_bool(head_node),
             ords=phrase_ords
         )
 
@@ -476,7 +486,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
         """
 
         # phrase already annotated
-        if head_node.misc['Phrase'] != '':
+        if head_node.misc['Peri'] != '':
             return
         
         if len(auxes) == 1:
@@ -511,6 +521,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     expl=expl,
                     polarity=polarity,
                     voice=head_node.feats['Voice'],
+                    periphrasis='Yes',
                     ords=phrase_ords)
                 return
             
@@ -534,6 +545,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
+                    periphrasis='Yes',
                     ords=phrase_ords)      
                 return
             
@@ -558,6 +570,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
+                    periphrasis='Yes',
                     ords=phrase_ords)
                 return
                 
@@ -596,6 +609,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     aspect=aspect,
                     expl=expl,
                     polarity=polarity,
+                    periphrasis='Yes',
                     ords=phrase_ords)
                 
                 return
@@ -686,6 +700,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
+                    periphrasis='Yes',
                     ords=phrase_ords)
                 return
                 
@@ -730,6 +745,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
+                    periphrasis='Yes',
                     ords=phrase_ords)
                 
                 return
@@ -748,6 +764,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
+                    periphrasis='Yes',
                     ords=phrase_ords)
                 
                 return
@@ -774,6 +791,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
+                    periphrasis='Yes',
                     ords=phrase_ords)
                 
                 return       
@@ -793,6 +811,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
+                    periphrasis='Yes',
                     ords=phrase_ords)
                 
                 return
@@ -810,6 +829,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
+                    periphrasis='Yes',
                     ords=phrase_ords)
                 
                 return
@@ -847,6 +867,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
+                    periphrasis='Yes',
                     ords=phrase_ords)
 
             # auxiliriy 'ir' in present or future tense followed by auxiliary 'ter' in infinitive and a participle
@@ -872,6 +893,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
+                    periphrasis='Yes',
                     ords=phrase_ords)    
                         
             # Cnd (only ter/haber), Sub and Past,Pres,Fut tenses: 2 auxes - ter/haber + estar
@@ -910,6 +932,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
+                    periphrasis='Yes',
                     ords=phrase_ords,
                 )
                 return
@@ -930,12 +953,12 @@ def process_copulas(self, node, cop, expl, polarity, phrase_ords):
         """
 
         # classify the morphological features of the copula node and propagate them to the entire phrase (treating the copula as the content verb)
-        self.process_phrases_with_ir_aller(cop[0], expl, polarity, phrase_ords, node)
+        self.process_phrases_with_ir_aller_estar(cop[0], expl, polarity, phrase_ords, node)
         self.process_simple_verb_forms(cop[0], expl, polarity, phrase_ords, node)
 
         # adjust PhraseAspect based on the lemma of the copula
         if cop[0].feats['Tense'] in ['Pres', 'Fut']:
             if cop[0].lemma == 'ser':
-                node.misc['PhraseAspect'] = Aspect.PERF.value
+                node.misc['PeriAspect'] = Aspect.PERF.value
             elif cop[0].lemma == 'estar':
-                node.misc['PhraseAspect'] = Aspect.IMP.value
\ No newline at end of file
+                node.misc['PeriAspect'] = Aspect.IMP.value
\ No newline at end of file

From 44170a169b17035d2623c5e1adadbfdf38fa54bc Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Tue, 30 Dec 2025 15:46:18 +0100
Subject: [PATCH 1335/1374] Add get_expl_type for better naming accuracy

---
 udapi/block/msf/phrase.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/udapi/block/msf/phrase.py b/udapi/block/msf/phrase.py
index 867ed826..34d4bc40 100644
--- a/udapi/block/msf/phrase.py
+++ b/udapi/block/msf/phrase.py
@@ -127,6 +127,15 @@ def get_is_reflex(self,node,refl):
         if len(refl) == 0:
             return node.feats['Reflex']
         return 'Yes'
+    
+    def get_expl_type(self,node, refl):
+        if node.feats['Voice'] == 'Mid':
+            return 'Pv'
+        if not refl:
+            return ''
+        if refl[0].deprel == 'expl':
+            return 'Pv'
+        return refl[0].deprel.split(':')[1].capitalize()
 
     def is_expl_pass(self,refl):
         if len(refl) == 0:

From 5c80aa1e4e113c363b66f5df739eaadf6e3ad4b9 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Tue, 30 Dec 2025 15:49:09 +0100
Subject: [PATCH 1336/1374] Use PeriExpl instead of PeriRefl

---
 udapi/block/msf/slavic/conditional.py |  4 ++--
 udapi/block/msf/slavic/converb.py     |  2 +-
 udapi/block/msf/slavic/future.py      | 16 ++++++++--------
 udapi/block/msf/slavic/imperative.py  |  4 ++--
 udapi/block/msf/slavic/infinitive.py  |  8 ++++----
 udapi/block/msf/slavic/past.py        |  8 ++++----
 udapi/block/msf/slavic/present.py     |  8 ++++----
 7 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/udapi/block/msf/slavic/conditional.py b/udapi/block/msf/slavic/conditional.py
index 89eafd6c..c2a37941 100644
--- a/udapi/block/msf/slavic/conditional.py
+++ b/udapi/block/msf/slavic/conditional.py
@@ -44,7 +44,7 @@ def process_node(self, node):
 					mood='Cnd',
 					form='Fin',
 					aspect=node.feats['Aspect'],
-					reflex=self.get_is_reflex(node,refl),
+					expl=self.get_expl_type(node,refl),
 					polarity=self.get_polarity(phrase_nodes),
 					voice=self.get_voice(node, refl),
 					ords=phrase_ords,
@@ -78,7 +78,7 @@ def process_node(self, node):
 					form='Fin',
 					voice=self.get_voice(copVerb, refl),
 					polarity=self.get_polarity(phrase_nodes),
-					reflex=self.get_is_reflex(node, refl),
+					expl=self.get_expl_type(node, refl),
 					ords=phrase_ords,
 					gender=copVerb.feats['Gender'],
 					animacy=copVerb.feats['Animacy']
diff --git a/udapi/block/msf/slavic/converb.py b/udapi/block/msf/slavic/converb.py
index 6b725d56..8497c45e 100644
--- a/udapi/block/msf/slavic/converb.py
+++ b/udapi/block/msf/slavic/converb.py
@@ -27,7 +27,7 @@ def process_node(self, node):
 				tense=node.feats['Tense'],
 				aspect=node.feats['Aspect'],
 				polarity=self.get_polarity(phrase_nodes),
-				reflex=self.get_is_reflex(node,refl),
+				expl=self.get_expl_type(node,refl),
 				ords=phrase_ords,
 				gender=node.feats['Gender'],
 				animacy=node.feats['Animacy'],
diff --git a/udapi/block/msf/slavic/future.py b/udapi/block/msf/slavic/future.py
index 02452c36..696ab49e 100644
--- a/udapi/block/msf/slavic/future.py
+++ b/udapi/block/msf/slavic/future.py
@@ -34,7 +34,7 @@ def process_node(self, node):
 					aspect=node.feats['Aspect'], # srbstina ani chorvatstina vidy nema
 					form='Fin',
 					polarity=self.get_polarity(phrase_nodes),
-					reflex=self.get_is_reflex(node,refl),
+					expl=self.get_expl_type(node,refl),
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
 					ords=phrase_ords
@@ -54,7 +54,7 @@ def process_node(self, node):
 					aspect=node.feats['Aspect'], 
 					form='Fin',
 					polarity=self.get_polarity(phrase_nodes),
-					reflex=self.get_is_reflex(node,refl),
+					expl=self.get_expl_type(node,refl),
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
 					ords=phrase_ords
@@ -85,7 +85,7 @@ def process_node(self, node):
 				aspect=node.feats['Aspect'],
 				form='Fin',
 				polarity=self.get_polarity(phrase_nodes),
-				reflex=self.get_is_reflex(node,refl),
+				expl=self.get_expl_type(node,refl),
 				ords=phrase_ords
 				)
 			return
@@ -93,7 +93,7 @@ def process_node(self, node):
 		# future tense of perfect verbs
 		# Upper Sorbian forms the future tense in this way, however, the feats[Aspect] are not listed in the data
 		# in some languages ​​(e.g. in Russian) these verbs have the Tense Fut, in others (e.g. in Czech) they have the Tense Pres
-		"""if node.feats['Aspect'] == 'Perf' and (node.feats['Tense'] == 'Pres' or node.feats['Tense'] == 'Fut') and node.feats['VerbForm'] != 'Conv':
+		if node.feats['Aspect'] == 'Perf' and (node.feats['Tense'] == 'Pres' or node.feats['Tense'] == 'Fut') and node.feats['VerbForm'] != 'Conv':
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 			
 			phrase_nodes = [node] + refl
@@ -112,10 +112,10 @@ def process_node(self, node):
 				form='Fin',
 				aspect='Perf',
 				polarity=self.get_polarity(phrase_nodes),
-				reflex=self.get_is_reflex(node,refl),
+				expl=self.get_expl_type(node,refl),
 				ords=phrase_ords
 				)
-			return"""
+			return
 
 		
 		# future tense of imperfect verbs and passive voice
@@ -145,7 +145,7 @@ def process_node(self, node):
 					aspect=node.feats['Aspect'],
 					form='Fin',
 					polarity=self.get_polarity(phrase_nodes),
-					reflex=self.get_is_reflex(node,refl),
+					expl=self.get_expl_type(node,refl),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy']
@@ -166,7 +166,7 @@ def process_node(self, node):
 					aspect=node.feats['Aspect'],
 					form='Fin',
 					polarity=self.get_polarity(phrase_nodes),
-					reflex=self.get_is_reflex(node,refl),
+					expl=self.get_expl_type(node,refl),
 					ords=phrase_ords
 					)
 				return
diff --git a/udapi/block/msf/slavic/imperative.py b/udapi/block/msf/slavic/imperative.py
index d4fedd50..72efbba6 100644
--- a/udapi/block/msf/slavic/imperative.py
+++ b/udapi/block/msf/slavic/imperative.py
@@ -28,7 +28,7 @@ def process_node(self, node):
 				form='Fin',
 				voice='Act',
 				polarity=self.get_polarity(phrase_nodes),
-				reflex=self.get_is_reflex(node,refl),
+				expl=self.get_expl_type(node,refl),
 				ords=phrase_ords
 				)
 			return
@@ -80,7 +80,7 @@ def process_node(self, node):
 				mood='Imp',
 				form='Fin',
 				voice=self.get_voice(copVerb, refl),
-				reflex=self.get_is_reflex(node, refl),
+				expl=self.get_expl_type(node, refl),
 				polarity=self.get_polarity(phrase_nodes),
 				ords=phrase_ords
 				)
diff --git a/udapi/block/msf/slavic/infinitive.py b/udapi/block/msf/slavic/infinitive.py
index f39a2646..a5722e9f 100644
--- a/udapi/block/msf/slavic/infinitive.py
+++ b/udapi/block/msf/slavic/infinitive.py
@@ -27,7 +27,7 @@ def process_node(self,node):
 					voice=self.get_voice(node,refl),
 					form='Inf',
 					polarity=self.get_polarity(phrase_nodes),
-					reflex=self.get_is_reflex(node,refl),
+					expl=self.get_expl_type(node,refl),
 					ords=phrase_ords
 				)
 				return
@@ -50,7 +50,7 @@ def process_node(self,node):
 					voice='Pass',
 					form='Inf',
 					polarity=self.get_polarity(phrase_nodes),
-					reflex=self.get_is_reflex(node, refl),
+					expl=self.get_expl_type(node, refl),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
@@ -78,7 +78,7 @@ def process_node(self,node):
 				voice=self.get_voice(cop[0], refl),
 				form='Inf',
 				polarity=self.get_polarity(phrase_nodes),
-				reflex=self.get_is_reflex(node, refl),
+				expl=self.get_expl_type(node, refl),
 				ords=phrase_ords
 				)
 			
@@ -98,6 +98,6 @@ def process_node(self,node):
 					voice='Act',
 					form='Sup',
 					polarity=self.get_polarity(phrase_nodes),
-					reflex=self.get_is_reflex(node, refl),
+					expl=self.get_expl_type(node, refl),
 					ords=phrase_ords
 					)
diff --git a/udapi/block/msf/slavic/past.py b/udapi/block/msf/slavic/past.py
index 423bff45..9036024f 100644
--- a/udapi/block/msf/slavic/past.py
+++ b/udapi/block/msf/slavic/past.py
@@ -46,7 +46,7 @@ def process_node(self, node):
 						aspect=node.feats['Aspect'],
 						form=node.feats['VerbForm'],
 						polarity=self.get_polarity(phrase_nodes),
-						reflex=self.get_is_reflex(node,refl),
+						expl=self.get_expl_type(node,refl),
 						ords=phrase_ords,
 						gender=node.feats['Gender'],
 						animacy=node.feats['Animacy']
@@ -93,7 +93,7 @@ def process_node(self, node):
 						aspect=node.feats['Aspect'],
 						form='Fin',
 						polarity=self.get_polarity(phrase_nodes),
-						reflex=self.get_is_reflex(node,refl),
+						expl=self.get_expl_type(node,refl),
 						ords=phrase_ords,
 						gender=node.feats['Gender'],
 						animacy=node.feats['Animacy']
@@ -127,7 +127,7 @@ def process_node(self, node):
 					aspect=node.feats['Aspect'],
 					form=node.feats['VerbForm'],
 					polarity=self.get_polarity(phrase_nodes),
-					reflex=self.get_is_reflex(node,refl),
+					expl=self.get_expl_type(node,refl),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy']
@@ -199,7 +199,7 @@ def process_node(self, node):
 					mood='Ind',
 					voice=self.get_voice(cop[0], refl),
 					form='Fin',
-					reflex=self.get_is_reflex(node,refl),
+					expl=self.get_expl_type(node,refl),
 					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords,
 					gender=cop[0].feats['Gender'],
diff --git a/udapi/block/msf/slavic/present.py b/udapi/block/msf/slavic/present.py
index 9a743a9e..4cf31cb5 100644
--- a/udapi/block/msf/slavic/present.py
+++ b/udapi/block/msf/slavic/present.py
@@ -11,7 +11,7 @@ class Present(udapi.block.msf.phrase.Phrase):
 	def process_node(self,node):
 		# the condition VerbForm == 'Fin' ensures that there are no transgressives between the found verbs
 		# the aspect is not always given in Czech treebanks, so we can't rely on the fact that the imperfect aspect is specified 
-		if node.feats['Tense'] == 'Pres' and node.upos == 'VERB' and node.feats['VerbForm'] == 'Fin': #and node.feats['Aspect']=='Imp': 
+		if node.feats['Tense'] == 'Pres' and node.upos == 'VERB' and node.feats['VerbForm'] == 'Fin' and node.feats['Aspect'] !='Perf': 
 			
 			aux_forb = [x for x in node.children if x.upos == 'AUX' and (x.lemma == 'ќе' or x.lemma == 'ще' or x.feats['Mood'] == 'Cnd')] # forbidden auxiliaries for present tense (these auxiliaries are used for the future tense or the conditional mood)
 
@@ -34,7 +34,7 @@ def process_node(self,node):
 					voice=self.get_voice(node,refl),
 					form='Fin',
 					polarity=self.get_polarity(phrase_nodes),
-					reflex=self.get_is_reflex(node,refl),
+					expl=self.get_expl_type(node,refl),
 					ords=phrase_ords
 					)
 				return
@@ -91,7 +91,7 @@ def process_node(self,node):
 					number=node.feats['Number'],
 					form='Part',
 					voice=self.get_voice(node, refl),
-					reflex=self.get_is_reflex(node, refl),
+					expl=self.get_expl_type(node, refl),
 					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords
 				)
@@ -122,7 +122,7 @@ def process_node(self,node):
 					mood='Ind',
 					form='Fin',
 					voice=self.get_voice(copVerb, refl),
-					reflex=self.get_is_reflex(node, refl),
+					expl=self.get_expl_type(node, refl),
 					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords
 				)

From 46e759bd35824d37ccf387d78938985ef6f9c881 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Tue, 30 Dec 2025 16:13:03 +0100
Subject: [PATCH 1337/1374] Add detection of Periphrasis feature

---
 udapi/block/msf/slavic/conditional.py |  6 ++++--
 udapi/block/msf/slavic/converb.py     |  9 ++++++---
 udapi/block/msf/slavic/future.py      |  9 ++++++++-
 udapi/block/msf/slavic/imperative.py  |  5 ++++-
 udapi/block/msf/slavic/infinitive.py  |  6 +++++-
 udapi/block/msf/slavic/past.py        | 15 ++++++++++-----
 udapi/block/msf/slavic/present.py     |  6 +++++-
 7 files changed, 42 insertions(+), 14 deletions(-)

diff --git a/udapi/block/msf/slavic/conditional.py b/udapi/block/msf/slavic/conditional.py
index c2a37941..8b471269 100644
--- a/udapi/block/msf/slavic/conditional.py
+++ b/udapi/block/msf/slavic/conditional.py
@@ -49,7 +49,8 @@ def process_node(self, node):
 					voice=self.get_voice(node, refl),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
-					animacy=node.feats['Animacy']
+					animacy=node.feats['Animacy'],
+					periphrasis=self.get_periphrasis_bool(node)
 				)
 				return
 		
@@ -81,5 +82,6 @@ def process_node(self, node):
 					expl=self.get_expl_type(node, refl),
 					ords=phrase_ords,
 					gender=copVerb.feats['Gender'],
-					animacy=copVerb.feats['Animacy']
+					animacy=copVerb.feats['Animacy'],
+					periphrasis=self.get_periphrasis_bool(node)
 			)
\ No newline at end of file
diff --git a/udapi/block/msf/slavic/converb.py b/udapi/block/msf/slavic/converb.py
index 8497c45e..a83ffac1 100644
--- a/udapi/block/msf/slavic/converb.py
+++ b/udapi/block/msf/slavic/converb.py
@@ -31,7 +31,8 @@ def process_node(self, node):
 				ords=phrase_ords,
 				gender=node.feats['Gender'],
 				animacy=node.feats['Animacy'],
-				voice=self.get_voice(node, refl)
+				voice=self.get_voice(node, refl),
+				periphrasis=self.get_periphrasis_bool(node)
 				)
 
 		# passive voice
@@ -57,7 +58,8 @@ def process_node(self, node):
 					ords=phrase_ords,
 					gender=auxVerb.feats['Gender'],
 					animacy=auxVerb.feats['Animacy'],
-					voice='Pass'
+					voice='Pass',
+					periphrasis=self.get_periphrasis_bool(node)
 				)
 
 		# copulas
@@ -87,5 +89,6 @@ def process_node(self, node):
 					form='Conv',
 					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords,
-					voice=self.get_voice(copVerb, refl)
+					voice=self.get_voice(copVerb, refl),
+					periphrasis=self.get_periphrasis_bool(node)
 					)
diff --git a/udapi/block/msf/slavic/future.py b/udapi/block/msf/slavic/future.py
index 696ab49e..4a758563 100644
--- a/udapi/block/msf/slavic/future.py
+++ b/udapi/block/msf/slavic/future.py
@@ -37,6 +37,7 @@ def process_node(self, node):
 					expl=self.get_expl_type(node,refl),
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
+					periphrasis=self.get_periphrasis_bool(node),
 					ords=phrase_ords
 					)
 			else:
@@ -57,6 +58,7 @@ def process_node(self, node):
 					expl=self.get_expl_type(node,refl),
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
+					periphrasis=self.get_periphrasis_bool(node),
 					ords=phrase_ords
 					)
 				
@@ -86,6 +88,7 @@ def process_node(self, node):
 				form='Fin',
 				polarity=self.get_polarity(phrase_nodes),
 				expl=self.get_expl_type(node,refl),
+				periphrasis=self.get_periphrasis_bool(node),
 				ords=phrase_ords
 				)
 			return
@@ -113,6 +116,7 @@ def process_node(self, node):
 				aspect='Perf',
 				polarity=self.get_polarity(phrase_nodes),
 				expl=self.get_expl_type(node,refl),
+				periphrasis=self.get_periphrasis_bool(node),
 				ords=phrase_ords
 				)
 			return
@@ -148,7 +152,8 @@ def process_node(self, node):
 					expl=self.get_expl_type(node,refl),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
-					animacy=node.feats['Animacy']
+					animacy=node.feats['Animacy'],
+					periphrasis=self.get_periphrasis_bool(node)
 					)
 				return
 
@@ -167,6 +172,7 @@ def process_node(self, node):
 					form='Fin',
 					polarity=self.get_polarity(phrase_nodes),
 					expl=self.get_expl_type(node,refl),
+					periphrasis=self.get_periphrasis_bool(node),
 					ords=phrase_ords
 					)
 				return
@@ -195,6 +201,7 @@ def process_node(self, node):
 					form='Fin',
 					voice=self.get_voice(copVerb, refl),
 					polarity=self.get_polarity(phrase_nodes),
+					periphrasis=self.get_periphrasis_bool(node),
 					ords=phrase_ords
 				)
 
diff --git a/udapi/block/msf/slavic/imperative.py b/udapi/block/msf/slavic/imperative.py
index 72efbba6..ff3a6cf3 100644
--- a/udapi/block/msf/slavic/imperative.py
+++ b/udapi/block/msf/slavic/imperative.py
@@ -29,6 +29,7 @@ def process_node(self, node):
 				voice='Act',
 				polarity=self.get_polarity(phrase_nodes),
 				expl=self.get_expl_type(node,refl),
+				periphrasis=self.get_periphrasis_bool(node),
 				ords=phrase_ords
 				)
 			return
@@ -54,7 +55,8 @@ def process_node(self, node):
 					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
-					animacy=node.feats['Animacy']
+					animacy=node.feats['Animacy'],
+					periphrasis=self.get_periphrasis_bool(node)
 					)
 				return
 
@@ -82,5 +84,6 @@ def process_node(self, node):
 				voice=self.get_voice(copVerb, refl),
 				expl=self.get_expl_type(node, refl),
 				polarity=self.get_polarity(phrase_nodes),
+				periphrasis=self.get_periphrasis_bool(node),
 				ords=phrase_ords
 				)
diff --git a/udapi/block/msf/slavic/infinitive.py b/udapi/block/msf/slavic/infinitive.py
index a5722e9f..160536e3 100644
--- a/udapi/block/msf/slavic/infinitive.py
+++ b/udapi/block/msf/slavic/infinitive.py
@@ -28,6 +28,7 @@ def process_node(self,node):
 					form='Inf',
 					polarity=self.get_polarity(phrase_nodes),
 					expl=self.get_expl_type(node,refl),
+					periphrasis=self.get_periphrasis_bool(node),
 					ords=phrase_ords
 				)
 				return
@@ -54,7 +55,8 @@ def process_node(self,node):
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
-					number=node.feats['Number']
+					number=node.feats['Number'],
+					periphrasis=self.get_periphrasis_bool(node)
 					)
 				return
 					
@@ -79,6 +81,7 @@ def process_node(self,node):
 				form='Inf',
 				polarity=self.get_polarity(phrase_nodes),
 				expl=self.get_expl_type(node, refl),
+				periphrasis=self.get_periphrasis_bool(node),
 				ords=phrase_ords
 				)
 			
@@ -99,5 +102,6 @@ def process_node(self,node):
 					form='Sup',
 					polarity=self.get_polarity(phrase_nodes),
 					expl=self.get_expl_type(node, refl),
+					periphrasis=self.get_periphrasis_bool(node),
 					ords=phrase_ords
 					)
diff --git a/udapi/block/msf/slavic/past.py b/udapi/block/msf/slavic/past.py
index 9036024f..3465baef 100644
--- a/udapi/block/msf/slavic/past.py
+++ b/udapi/block/msf/slavic/past.py
@@ -49,7 +49,8 @@ def process_node(self, node):
 						expl=self.get_expl_type(node,refl),
 						ords=phrase_ords,
 						gender=node.feats['Gender'],
-						animacy=node.feats['Animacy']
+						animacy=node.feats['Animacy'],
+						periphrasis=self.get_periphrasis_bool(node)
 						)
 
 		# compound past tense
@@ -96,7 +97,8 @@ def process_node(self, node):
 						expl=self.get_expl_type(node,refl),
 						ords=phrase_ords,
 						gender=node.feats['Gender'],
-						animacy=node.feats['Animacy']
+						animacy=node.feats['Animacy'],
+						periphrasis=self.get_periphrasis_bool(node)
 						)
 				
 
@@ -130,7 +132,8 @@ def process_node(self, node):
 					expl=self.get_expl_type(node,refl),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
-					animacy=node.feats['Animacy']
+					animacy=node.feats['Animacy'],
+					periphrasis=self.get_periphrasis_bool(node)
 					)
 			
 				
@@ -166,7 +169,8 @@ def process_node(self, node):
 						polarity=self.get_polarity(phrase_nodes),
 						ords=phrase_ords,
 						gender=node.feats['Gender'],
-						animacy=node.feats['Animacy']
+						animacy=node.feats['Animacy'],
+						periphrasis=self.get_periphrasis_bool(node)
 						)
 				
 		else:
@@ -203,5 +207,6 @@ def process_node(self, node):
 					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords,
 					gender=cop[0].feats['Gender'],
-					animacy=cop[0].feats['Animacy']
+					animacy=cop[0].feats['Animacy'],
+					periphrasis=self.get_periphrasis_bool(node)
 					)
diff --git a/udapi/block/msf/slavic/present.py b/udapi/block/msf/slavic/present.py
index 4cf31cb5..3221d0e8 100644
--- a/udapi/block/msf/slavic/present.py
+++ b/udapi/block/msf/slavic/present.py
@@ -35,6 +35,7 @@ def process_node(self,node):
 					form='Fin',
 					polarity=self.get_polarity(phrase_nodes),
 					expl=self.get_expl_type(node,refl),
+					periphrasis=self.get_periphrasis_bool(node),
 					ords=phrase_ords
 					)
 				return
@@ -65,7 +66,8 @@ def process_node(self,node):
 					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
-					animacy=node.feats['Animacy']
+					animacy=node.feats['Animacy'],
+					periphrasis=self.get_periphrasis_bool(node)
 					)
 				return
 			
@@ -93,6 +95,7 @@ def process_node(self,node):
 					voice=self.get_voice(node, refl),
 					expl=self.get_expl_type(node, refl),
 					polarity=self.get_polarity(phrase_nodes),
+					periphrasis=self.get_periphrasis_bool(node),
 					ords=phrase_ords
 				)
 				return
@@ -124,5 +127,6 @@ def process_node(self,node):
 					voice=self.get_voice(copVerb, refl),
 					expl=self.get_expl_type(node, refl),
 					polarity=self.get_polarity(phrase_nodes),
+					periphrasis=self.get_periphrasis_bool(node),
 					ords=phrase_ords
 				)

From e28f953a52b0fee11e4049ad79317c53cec65188 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Tue, 30 Dec 2025 16:35:05 +0100
Subject: [PATCH 1338/1374] Fix detection of Polish past tense

---
 udapi/block/msf/slavic/past.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/msf/slavic/past.py b/udapi/block/msf/slavic/past.py
index 3465baef..e97357e3 100644
--- a/udapi/block/msf/slavic/past.py
+++ b/udapi/block/msf/slavic/past.py
@@ -54,8 +54,8 @@ def process_node(self, node):
 						)
 
 		# compound past tense
-		if (node.feats['VerbForm'] == 'Part' or node.feats['VerbForm'] == 'PartRes') and node.upos == 'VERB' and node.feats['Voice'] != 'Pass':
-			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] == 'Pres']
+		if (node.feats['VerbForm'] in ['Part', 'PartRes', 'Fin']) and node.upos == 'VERB' and node.feats['Voice'] != 'Pass':
+			aux = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] in ['Pres', '']]
 			aux_pqp = [x for x in node.children if x.udeprel == 'aux' and x.feats['Tense'] in past_tenses]
 			refl = [x for x in node.children if x.feats['Reflex'] == 'Yes' and x.udeprel == 'expl']
 

From 57bacc8b904edbeea7f2d420ba66aca51713a96f Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Tue, 13 Jan 2026 18:43:40 +0100
Subject: [PATCH 1339/1374] read.Conll2012 adjusted to read FantasyCoref

- a different number of columns
- "-" as an empty value instead of "_"
---
 udapi/block/read/conll2012.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/udapi/block/read/conll2012.py b/udapi/block/read/conll2012.py
index f4b73dc8..2abdf8a6 100644
--- a/udapi/block/read/conll2012.py
+++ b/udapi/block/read/conll2012.py
@@ -18,7 +18,7 @@
 class Conll2012(udapi.block.read.conllu.Conllu):
     """A reader of the Conll2012 files."""
 
-    def __init__(self, attributes='docname,_,ord,form,_,_,_,_,_,_,_,_,coref', **kwargs):
+    def __init__(self, attributes='docname,_,ord,form,_,_,_,_,_,_,_,_,coref', emptyval='_', **kwargs):
         """Create the Conll2012 reader object.
 
         Args:
@@ -29,10 +29,15 @@ def __init__(self, attributes='docname,_,ord,form,_,_,_,_,_,_,_,_,coref', **kwar
             word-order number/index (usualy called ID).
             For Corref-PT-SemEval, use attributes='ord,form,_,_,_,_,coref'.
             For Summ-it++v2, use attributes='ord,form,_,_,_,_,_,_,coref'.
+            For FantasyCoref, use attributes='docname,_,ord,form,_,_,_,_,_,_,_,coref'.
+        emptyval: a symbol that represents an empty value, especially in the coref column
+            (default='_' suitable for LitBank, Corref-PT-SemEval, and Summ-it++v2)
+            For FantasyCoref, use emptyval='-'.
         """
         super().__init__(**kwargs)
         self.node_attributes = attributes.split(',')
         self._docname = 'd'
+        self.emptyval = emptyval
 
     def parse_comment_line(self, line, root):
         if line.startswith("#end document"):
@@ -83,7 +88,7 @@ def parse_node_line(self, line, root, nodes):
                     logging.warning(f"Mismatch: expected {node.ord=}, but found {int(value) + 1} {line=}")
 
             elif attribute_name == 'coref':
-                if value and value != '_':
+                if value and value != self.emptyval:
                     # LitBank always separates chunks by a vertical bar, e.g. (13)|10)
                     # Summ-it++v2 does not, e.g. (13)10)
                     if '|' in value:

From 381a2d18a6c5d964bd17a80ba0238daab7706336 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 14 Jan 2026 17:38:10 +0100
Subject: [PATCH 1340/1374] allow `node.descendants(add_mwt=True)`

Add the `add_mwt` option to `node.descendants()`, `node.children()` etc.
The MWT objects do not have the same methods&properties as Node objects,
so one has to be careful when using the resulting list with a mixure of both,
but there are usecases when it is useful to have such a mixed list
(with MWTs preceding their words, similarly to the CoNLL-U format).
---
 udapi/core/node.py | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/udapi/core/node.py b/udapi/core/node.py
index b5b0ea06..c6a7a26a 100644
--- a/udapi/core/node.py
+++ b/udapi/core/node.py
@@ -1151,6 +1151,7 @@ class ListOfNodes(list):
     nodes = node.children
     nodes = node.children()
     nodes = node.children(add_self=True, following_only=True)
+    nodes = node.descendants(add_self=True, add_mwt=True)
     """
     __slots__ = ('origin',)
 
@@ -1164,16 +1165,28 @@ def __init__(self, iterable, origin):
         super().__init__(iterable)
         self.origin = origin
 
-    def __call__(self, add_self=False, following_only=False, preceding_only=False):
+    def __call__(self, add_self=False, following_only=False, preceding_only=False, add_mwt=False):
         """Returns a subset of nodes contained in this list as specified by the args."""
         if add_self:
             self.append(self.origin)
             self.sort()
+        result = self
         if preceding_only:
-            return [x for x in self if x._ord <= self.origin._ord]
+            result = [x for x in result if x._ord <= self.origin._ord]
         if following_only:
-            return [x for x in self if x._ord >= self.origin._ord]
-        return self
+            result = [x for x in result if x._ord >= self.origin._ord]
+        if add_mwt:
+            new = []
+            last_mwt_id = -1
+            for node in result:
+                mwt = node.multiword_token
+                if mwt:
+                    if node.ord > last_mwt_id:
+                        last_mwt_id = mwt.words[-1].ord
+                        new.append(mwt)
+                new.append(node)
+            result = new
+        return result
 
 
 def find_minimal_common_treelet(*args):

From fc44de73640782af3f78f391e278cb742d179f33 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 14 Jan 2026 17:54:08 +0100
Subject: [PATCH 1341/1374] add mwt.get_attrs(), mwt.is_empty(), mwt.is_leaf()

These three methods make the MWT objects more similar to Node,
which is useful when working with lists where both object types
are mixed, e.g. the result of `node.descendants(add_mwt=True)`.
---
 udapi/core/mwt.py | 72 ++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 71 insertions(+), 1 deletion(-)

diff --git a/udapi/core/mwt.py b/udapi/core/mwt.py
index 087b30a3..00ba935c 100644
--- a/udapi/core/mwt.py
+++ b/udapi/core/mwt.py
@@ -77,9 +77,79 @@ def is_mwt():
 
     @property
     def no_space_after(self):
-        """Boolean property as a shortcut for `node.misc["SpaceAfter"] == "No"`."""
+        """Boolean property as a shortcut for `mwt.misc["SpaceAfter"] == "No"`."""
         return self.misc["SpaceAfter"] == "No"
 
+    @staticmethod
+    def is_empty():
+        """Is this an Empty node?
+
+        Returns always False because multi-word tokens cannot be empty nodes.
+        """
+        return False
+
+    @staticmethod
+    def is_leaf():
+        """Is this a node/mwt without any children?
+
+        Returns always True because multi-word tokens cannot have children.
+        """
+        return True
+
+    def _get_attr(self, name):  # pylint: disable=too-many-return-statements
+        if name == 'form':
+            return self.form
+        if name == 'ord':
+            return self.ord_range
+        if name in ('edge', 'children', 'siblings', 'depth'):
+            return 0
+        if name == 'feats_split':
+            return str(self.feats).split('|')
+        if name == 'misc_split':
+            return str(self.misc).split('|')
+        if name.startswith('feats['):
+            return self.feats[name[6:-1]]
+        if name.startswith('misc['):
+            return self.misc[name[5:-1]]
+        return '<mwt>'
+
+    def get_attrs(self, attrs, undefs=None, stringify=True):
+        """Return multiple attributes or pseudo-attributes, possibly substituting empty ones.
+
+        MWTs do not have children nor parents nor prev/next nodes,
+        so the pseudo-attributes: p_xy, c_xy, l_xy and r_xy are irrelevant (and return nothing).
+        Other pseudo-attributes (e.g. dir) return always the string "<mwt>".
+        The only relevant pseudo-attributes are
+        feats_split and misc_split: a list of name=value formatted strings.
+        The `ord` attribute returns actually `mwt.ord_range`.
+
+        Args:
+        attrs: A list of attribute names, e.g. ``['form', 'ord', 'feats_split']``.
+        undefs: A value to be used instead of None for empty (undefined) values.
+        stringify: Apply `str()` on each value (except for None)
+        """
+        values = []
+        for name in attrs:
+            nodes = [self]
+            if name[1] == '_':
+                nodes, name = [], name[2:]
+            for node in (n for n in nodes if n is not None):
+                if name in {'feats_split', 'misc_split'}:
+                    values.extend(node._get_attr(name))
+                else:
+                    values.append(node._get_attr(name))
+
+        if undefs is not None:
+            values = [x if x is not None else undefs for x in values]
+        if stringify:
+            values = [str(x) if x is not None else None for x in values]
+        return values
+
+    @property
+    def _ord(self):
+        self.words.sort()
+        return self.words[0]._ord
+
 # TODO: node.remove() should check if the node is not part of any MWT
 # TODO: Document that editing words by mwt.words.append(node), del or remove(node) is not supported
 # TODO: Make mwt._words private and provide a setter

From 57b003c713cf26c2bc602c0ed7f5306a70f0deb5 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 14 Jan 2026 17:56:22 +0100
Subject: [PATCH 1342/1374] write.TextModeTrees print_mwt=1

The add print_mwt parameter to the block, so multi-word tokens
are shown (before their first word), similarly to empty nodes.
The default value is False for now.
---
 udapi/block/write/textmodetrees.py | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/udapi/block/write/textmodetrees.py b/udapi/block/write/textmodetrees.py
index a4726e5f..a8a7ab3d 100644
--- a/udapi/block/write/textmodetrees.py
+++ b/udapi/block/write/textmodetrees.py
@@ -144,7 +144,7 @@ class TextModeTrees(BaseWriter):
     def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, indent=1,
                  minimize_cross=True, color='auto', attributes='form,upos,deprel',
                  print_undef_as='_', print_doc_meta=True, print_comments=False, print_empty=True,
-                 mark='(ToDo|ToDoOrigText|Bug|Mark)', marked_only=False, hints=True,
+                 print_mwt=False, mark='(ToDo|ToDoOrigText|Bug|Mark)', marked_only=False, hints=True,
                  layout='classic', **kwargs):
         """Create new TextModeTrees block object.
 
@@ -167,7 +167,8 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
             print_undef_as: What should be printed instead of undefined attribute values (if any)?
             print_doc_meta: Print ``document.meta`` metadata before each document?
             print_comments: Print comments (other than ``sent_id`` and ``text``)?
-            print_empty: Print empty nodes?
+            print_empty: Print empty nodes? Default=True
+            print_mwt: Print multi-word tokens? Default=False
             mark: A regex pattern. If ``re.search(mark + '=', str(node.misc))`` matches, the node is highlighted.
                 If ``print_comments`` and ``re.search(r'^ %s = ' % mark, root.comment, re.M)`` matches,
                 the comment is highlighted. Empty string means no highlighting.
@@ -193,6 +194,7 @@ def __init__(self, print_sent_id=True, print_text=True, add_empty_line=True, ind
         self.print_doc_meta = print_doc_meta
         self.print_comments = print_comments
         self.print_empty = print_empty
+        self.print_mwt = print_mwt
         self.mark = mark
         self.marked_only = marked_only
         self.layout = layout
@@ -250,18 +252,18 @@ def should_print_tree(self, root, allnodes):
     def process_tree(self, root, force_print=False):
         """Print the tree to (possibly redirected) sys.stdout."""
         if self.print_empty:
-            if root.is_root():
+            if root.is_root() and not self.print_mwt:
                 allnodes = [root] + root.descendants_and_empty
             else:
-                allnodes = root.descendants(add_self=1)
+                allnodes = root.descendants(add_self=1, add_mwt=self.print_mwt)
                 empty = [e for e in root._root.empty_nodes if e > allnodes[0] and e < allnodes[-1]]
                 allnodes.extend(empty)
                 allnodes.sort()
         else:
-            allnodes = root.descendants(add_self=1)
+            allnodes = root.descendants(add_self=1, add_mwt=self.print_mwt)
         if not force_print and not self.should_print_tree(root, allnodes):
             return
-        self._index_of = {allnodes[i].ord: i for i in range(len(allnodes))}
+        self._index_of = {allnodes[i].ord_range if allnodes[i].is_mwt() else allnodes[i].ord: i for i in range(len(allnodes))}
         self.lines = [''] * len(allnodes)
         self.lengths = [0] * len(allnodes)
 
@@ -288,7 +290,7 @@ def process_tree(self, root, force_print=False):
                     if self.layout == 'classic':
                         self.add_node(idx, node)
                 else:
-                    if idx_node.parent is not node:
+                    if idx_node.is_mwt() or idx_node.parent is not node:
                         self._add(idx, self._vert[self._ends(idx, '─╭╰╪┡┢')])
                     else:
                         precedes_parent = idx < self._index_of[node.ord]
@@ -306,7 +308,7 @@ def process_tree(self, root, force_print=False):
 
         if self.layout == 'classic':
             for idx, node in enumerate(allnodes):
-                if node.is_empty():
+                if node.is_empty() or node.is_mwt():
                     self.add_node(idx, node)
         else:
             columns_attrs = [[a] for a in self.attrs] if self.layout == 'align' else [self.attrs]
@@ -365,7 +367,7 @@ def _add(self, idx, text):
 
     def add_node(self, idx, node):
         """Render a node with its attributes."""
-        if not node.is_root():
+        if node.is_mwt() or not node.is_root():
             values = node.get_attrs(self.attrs, undefs=self.print_undef_as)
             self.lengths[idx] += 1 + len(' '.join(values))
             marked = self.is_marked(node)

From 6fa47ab4b437c2ff125cdfa0a9d9ccfd113f62b3 Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Sat, 17 Jan 2026 11:29:51 +0100
Subject: [PATCH 1343/1374] FantasyCoref: parentheses inside a doc ID must be
 removed

---
 udapi/block/read/conll2012.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/udapi/block/read/conll2012.py b/udapi/block/read/conll2012.py
index 2abdf8a6..2adbd00f 100644
--- a/udapi/block/read/conll2012.py
+++ b/udapi/block/read/conll2012.py
@@ -45,7 +45,7 @@ def parse_comment_line(self, line, root):
         match = RE_BEGIN.match(line)
         if match:
             docname = match.group(1)
-            # LitBank uses e.g.
+            # LitBank and FantasyCoref use e.g.
             # #begin document (1023_bleak_house_brat); part 0
             if docname.startswith('(') and docname.endswith(');'):
                 docname = docname[1:-2]
@@ -56,6 +56,9 @@ def parse_comment_line(self, line, root):
             # Corref-PT-SemEval uses e.g.
             # #begin document D1_C30_Folha_07-08-2007_09h19.txt.xml
             docname = docname.replace('.txt', '').replace('.xml', '')
+            # FantasyCoref may use parentheses within the document ID e.g.
+            # #begin document (051_Fundevogel_(Bird-foundling)); part 000
+            docname = docname.replace('(', '').replace(')', '')
 
             root.newdoc = docname
             self._global_entity = 'eid-etype-head-other'
@@ -77,6 +80,8 @@ def parse_node_line(self, line, root, nodes):
         for (n_attribute, attribute_name) in enumerate(self.node_attributes):
             value = fields[n_attribute]
             if attribute_name == 'docname':
+                # FantasyCoref may use parentheses within the document ID
+                value = value.replace('(', '').replace(')', '')
                 if value != self._docname:
                     logging.warning(f"Document name mismatch {value} != {self._docname}")
 

From 839491ccd5ca797847522d592a3ffa88d712de53 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michal=20Nov=C3=A1k?= <michnov@users.noreply.github.com>
Date: Mon, 19 Jan 2026 21:24:01 +0100
Subject: [PATCH 1344/1374] A potential bug (#136)

- fixing the value of the `end` variable - the index of the text end
    - this should match with all the conditions where `end` is used
- discovered while aligning FantasyCoref with its original texts
- Martin checked that the update doesn't violate processing of LitBank, for which the block was originally designed for
---
 udapi/block/read/addtext.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/read/addtext.py b/udapi/block/read/addtext.py
index 040174be..4d0b7771 100644
--- a/udapi/block/read/addtext.py
+++ b/udapi/block/read/addtext.py
@@ -32,7 +32,7 @@ def process_document(self, document):
             self.finished = True
             return
         text = ''.join(self.filehandle.readlines())
-        i, end, was_newpar = 0, len(text), True
+        i, end, was_newpar = 0, len(text)-1, True
         while i <= end and text[i].isspace():
             i += 1
 

From 4f996fd3c9967b0717cba29fda23f35c45da23c4 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Wed, 21 Jan 2026 22:45:25 +0100
Subject: [PATCH 1345/1374] read.Text empty_line=keep

---
 udapi/block/read/text.py | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/udapi/block/read/text.py b/udapi/block/read/text.py
index 0213bdcb..161b6b6e 100644
--- a/udapi/block/read/text.py
+++ b/udapi/block/read/text.py
@@ -16,9 +16,17 @@ class Text(BaseReader):
         so that `udpipe.Base` keeps these characters in `SpacesAfter`.
         As most blocks do not expect whitespace other than a space to appear
         in the processed text, using this feature is at your own risk.
+    empty_line: how empty lines are handled. Default 'new_sentence' preserves
+        the current behaviour (empty lines mark sentence boundaries). Use
+        'keep' to read the entire file content into a single sentence (tree), including
+        empty lines. Use 'newpar' to behave like 'new_sentence' but also set
+        `root.newpar = True` on each sentence.
     """
-    def __init__(self, rstrip='\r\n ', **kwargs):
+    def __init__(self, rstrip='\r\n ', empty_line='new_sentence', **kwargs):
+        if empty_line not in {'new_sentence', 'keep', 'newpar'}:
+            raise ValueError("empty_line must be 'new_sentence', 'keep' or 'newpar'")
         self.rstrip = rstrip
+        self.empty_line = empty_line
         super().__init__(**kwargs)
 
     @staticmethod
@@ -32,6 +40,13 @@ def is_multizone_reader():
     def read_tree(self, document=None):
         if self.filehandle is None:
             return None
+        if self.empty_line == 'keep':
+            content = self.filehandle.read()
+            if content == '':
+                return None
+            root = Root()
+            root.text = content
+            return root
         lines = []
         line = None
         while True:
@@ -54,4 +69,6 @@ def read_tree(self, document=None):
 
         root = Root()
         root.text = " ".join(lines)
+        if self.empty_line == 'newpar':
+            root.newpar = True
         return root

From a8f968169265cd495601c7caecde76ba39b6fb38 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 22 Jan 2026 01:20:12 +0100
Subject: [PATCH 1346/1374] UDPipeOnline do not change LF to CRLF

prevent `SpacesAfter=\r\n\r\n` when there was an empty line
with just `\n\n`.
---
 udapi/tool/udpipeonline.py | 38 ++++++++++++++++++++++++++++++++++----
 1 file changed, 34 insertions(+), 4 deletions(-)

diff --git a/udapi/tool/udpipeonline.py b/udapi/tool/udpipeonline.py
index f0a835c9..ced96d56 100644
--- a/udapi/tool/udpipeonline.py
+++ b/udapi/tool/udpipeonline.py
@@ -8,6 +8,7 @@
 import os
 import sys
 import urllib.error
+import urllib.parse
 import urllib.request
 
 from udapi.block.read.conllu import Conllu as ConlluReader
@@ -62,6 +63,35 @@ def perform_request(self, params, method="process"):
 
         return response["result"]
 
+    def perform_request_urlencoded(self, params, method="process"):
+        """Perform a request using application/x-www-form-urlencoded to preserve LF newlines.
+
+        This avoids CRLF normalization done by the email MIME serializer, ensuring that
+        the content of the 'data' field retains Unix LF ("\n") exactly as provided.
+        """
+        request_data = urllib.parse.urlencode(params).encode("utf-8")
+        request_headers = {"Content-Type": "application/x-www-form-urlencoded; charset=utf-8"}
+
+        try:
+            with urllib.request.urlopen(urllib.request.Request(
+                url=f"{self.server}/{method}", headers=request_headers, data=request_data
+            )) as request:
+                response = json.loads(request.read())
+        except urllib.error.HTTPError as e:
+            print("An exception was raised during UDPipe '{}' REST request.\n"
+                  "The service returned the following error:\n"
+                  "  {}".format(method, e.fp.read().decode("utf-8")), file=sys.stderr)
+            raise
+        except json.JSONDecodeError as e:
+            print("Cannot parse the JSON response of UDPipe '{}' REST request.\n"
+                  "  {}".format(method, e.msg), file=sys.stderr)
+            raise
+
+        if "model" not in response or "result" not in response:
+            raise ValueError("Cannot parse the UDPipe '{}' REST request response.".format(method))
+
+        return response["result"]
+
     def tag_parse_tree(self, root, tag=True, parse=True):
         """Tag (+lemmatize, fill FEATS) and parse a tree (already tokenized)."""
         if not tag and not parse:
@@ -76,7 +106,7 @@ def tag_parse_tree(self, root, tag=True, parse=True):
             params["parser"] = ""
             attrs.append('deprel')
 
-        out_data = self.perform_request(params=params)
+        out_data = self.perform_request_urlencoded(params=params)
         conllu_reader = ConlluReader(empty_parent="ignore")
         conllu_reader.files.filehandle = io.StringIO(out_data)
         parsed_root = conllu_reader.read_tree()
@@ -108,7 +138,7 @@ def tokenize_tag_parse_tree(self, root, resegment=False, tag=True, parse=True, r
             params["parser"] = ""
         if ranges:
             params["tokenizer"] = "presegmented;ranges" if resegment else "ranges"
-        out_data = self.perform_request(params=params)
+        out_data = self.perform_request_urlencoded(params=params)
         conllu_reader = ConlluReader(empty_parent="ignore")
         conllu_reader.files.filehandle = io.StringIO(out_data)
         trees = conllu_reader.read_trees()
@@ -126,7 +156,7 @@ def tokenize_tag_parse_tree(self, root, resegment=False, tag=True, parse=True, r
     def segment_text(self, text):
         """Segment the provided text into sentences returned as a Python list."""
         params = {"model": self.model, "data": text, "tokenizer":"", "output": "plaintext=normalized_spaces"}
-        return self.perform_request(params=params).rstrip().split("\n")
+        return self.perform_request_urlencoded(params=params).rstrip().split("\n")
 
     def process_document(self, doc, tokenize=True, tag=True, parse=True, resegment=False, ranges=False):
         """Delete all existing bundles and substitute them with those parsed by UDPipe."""
@@ -152,7 +182,7 @@ def process_document(self, doc, tokenize=True, tag=True, parse=True, resegment=F
             params["input"] = "horizontal"
             params["data"] = "\n".join(" ".join([n.form for n in root.descendants]) for root in doc.trees) + "\n"
 
-        out_data = self.perform_request(params=params)
+        out_data = self.perform_request_urlencoded(params=params)
         conllu_reader = ConlluReader(empty_parent="ignore")
         conllu_reader.files.filehandle = io.StringIO(out_data)
         trees = conllu_reader.read_trees()

From 8839a1443b374810d38d57a0f1928347c5ca9cee Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 22 Jan 2026 01:23:01 +0100
Subject: [PATCH 1347/1374] read.AddBratAnn for French LitBank

adapted from MiniCiep, WIP
---
 udapi/block/read/addbratann.py | 219 +++++++++++++++++++++++++++++++++
 1 file changed, 219 insertions(+)
 create mode 100644 udapi/block/read/addbratann.py

diff --git a/udapi/block/read/addbratann.py b/udapi/block/read/addbratann.py
new file mode 100644
index 00000000..d801ee6a
--- /dev/null
+++ b/udapi/block/read/addbratann.py
@@ -0,0 +1,219 @@
+"""Add Brat coreference annotation from *.ann files.
+
+So far, tested on French LitBank data only.
+
+T12	HIST 362 366	qui
+T13	HIST 349 362	une aventure
+R1431	Coreference Arg1:T12 Arg2:T13
+
+"""
+
+from udapi.core.block import Block
+from udapi.core.files import Files
+import logging
+from bisect import bisect_left
+
+# cd fr-litbank/brat/coref
+# cat *.ann | grep '^T' | cut -f2 | cut -f1 -d " " | Sort
+#   33085 PER
+#    2518 FAC
+#    1886 TIME
+#    1046 LOC
+#    1046 GPE
+#     559 NO_PER
+#     508 VEH
+#     229 ORG
+#     115 METALEPSE
+#      85 HIST
+#      12 X
+#      12 TO_DISCUSS
+#       1 OTHER
+#       1 None
+
+class AddBratAnn(Block):
+
+    def __init__(self, files, offset=0, detect_bom=True, keep_mention_id=True, coref_attr="R", zone='', **kwargs):
+        """Args:
+        files: file names with the coreference annotations (*.ann)
+        offset: what number to substract from the chatacter indices in the ann files
+        detect_bom: if True and the current txt file starts with BOM (byte-order mark), add 1 to the offset
+        """
+        super().__init__(**kwargs)
+        self.zone = zone
+        self.files = Files(filenames=files)
+        self.offset = offset
+        self.detect_bom = detect_bom
+        self.keep_mention_id = keep_mention_id
+        self.coref_attr = coref_attr
+
+    def process_document(self, document):
+
+        # Read all the important info from the *.ann file.
+        mentions, attrs, split_ante, clusters = {}, [], [], []
+        ann_filehandle = self.files.next_filehandle()
+        offset = self.offset
+        if self.detect_bom:
+            txt_filename = self.files.filename.replace("ann", "txt")
+            with open(txt_filename, 'rb') as txt_fh:
+                raw_bytes = txt_fh.read(3)
+                if raw_bytes == b'\xef\xbb\xbf':
+                    offset += 1
+
+        for line in ann_filehandle:
+            line = line.rstrip()
+            if not "\t" in line:
+                logging.warning(f"Unexpected line without tabs: {line}")
+            elif line.startswith("T"):
+                # T13	HIST 349 362	une aventure
+                try:
+                    mention_id, type_and_range, form = line.split("\t")
+                    # Usually range are two numbers, but can be more, e.g. type_and_range="Abstract  605 653;654 703"
+                    # Let's take the first and last number only.´
+                    parts = type_and_range.split()
+                    ne_type, range_s, range_e = parts[0], parts[1], parts[-1]
+                    
+                    # If form ends with spaces, remove them and adjust range_e
+                    stripped_form = form.rstrip(" ")
+                    if form != stripped_form:
+                        num_spaces = len(form) - len(stripped_form)
+                        form = stripped_form
+                        range_e = int(range_e) - num_spaces
+                    
+                    mentions[mention_id] = [ne_type, int(range_s), int(range_e), form]
+                    if self.keep_mention_id:
+                        attrs.append(["mention_id", mention_id, mention_id])
+                except Exception as e:
+                    logging.warning(f"Unexpected mention line: {line}\n{e}")
+            elif line.startswith(self.coref_attr):
+                cor_attr, mention_ids = line.split("\t")
+                parts = mention_ids.split()
+                assert(parts[0] == "Coreference")
+                clusters.append([p.split(":")[1] for p in parts[1:]])
+            elif line.startswith("#"):
+                pass # Let's ignore annotators' comments
+            else:
+                logging.warning(f"Unexpected line in {self.files.filename}:\n{line}")
+
+        # Create entity objects for non-singletons.
+        entity_map = {}
+        for mention_ids in clusters:
+            #etype = mentions[mention_ids[0]][0]
+            etype, etype_index = None, 0
+            #for m_id in mention_ids[1:]:
+            for index, m_id in enumerate(mention_ids):
+                if mentions[m_id][0] == '_Unsorted_':
+                    pass
+                elif etype is None:
+                    etype, etype_index = mentions[m_id][0], index
+                elif etype != mentions[m_id][0]:
+                    logging.warning(f"Mention type mismatch {mention_ids[etype_index]}:{etype} != {m_id}:{mentions[m_id][0]}. Using the former.")
+            if etype is None:
+                etype = "other"
+            entity = document.create_coref_entity(etype=etype.lower())
+            for m_id in mention_ids:
+                if m_id in entity_map:
+                    logging.warning(f"Mention {m_id} already in Entity {entity_map[m_id].eid}, not adding to {entity.eid}")
+                else:
+                    entity_map[m_id] = entity
+
+        # Collect TokenRange (as pre-filled by UDPipe) for each token.
+        tokens, starts, ends = [], [], []
+        for tree in document.trees:
+            for token in tree.token_descendants:
+                tokens.append(token)
+                range_s, range_e = token.misc["TokenRange"].split(":")
+                starts.append(int(range_s))
+                ends.append(int(range_e))
+
+        # Create mention objects.
+        mention_map = {}
+        for mention_id, mention_values in mentions.items():
+
+            # Find Udapi tokens for each mention.
+            ne_type, range_s, range_e, form = mention_values
+            index_s = bisect_left(starts, range_s - offset)
+            if starts[index_s] != range_s - offset and index_s > 0:
+                index_s -= 1
+            index_e = bisect_left(ends, range_e - offset)
+            mtokens = tokens[index_s : index_e+1]
+            token_s, token_e = tokens[index_s], tokens[index_e]
+
+            # Solve cases when the character range crosses Udapi (UDPipe-predicted) token boundaries.
+            # If the start token is a multi-word token (MWT),
+            # we can still try to find the proper word within the MWT.
+            ok_s, ok_e = True, True
+            if starts[index_s] != range_s - offset:
+                ok_s = False
+                if token_s.is_mwt():
+                    mtokens.pop(0)
+                    first_form = form.split()[0]
+                    new_start = ends[index_s]
+                    for w in reversed(token_s.words):
+                        mtokens = [w] + mtokens
+                        new_start -= len(w.form)
+                        if w.form == first_form or new_start < range_s - offset:
+                            ok_s = True
+                            break
+
+            # similarly for the end token
+            if ends[index_e] != range_e - offset:
+                ok_e = False
+                if token_e.is_mwt():
+                    mtokens.pop()
+                    last_form = form.split()[-1]
+                    new_end = starts[index_e]
+                    for w in token_e.words:
+                        mtokens.append(w)
+                        new_end += len(w.form)
+                        if w.form == last_form or new_end > range_e - offset:
+                            ok_e = True
+                            break
+
+            if not ok_s or not ok_e:
+                logging.warning(f"Mention {mention_id} range {range_s}-{offset}:{range_e}-{offset} ({form})"
+                                f" crosses token boundaries: {token_s.misc} ({token_s.form}) "
+                                f".. {token_e.misc} ({token_e.form})")
+
+            # Project tokens (including MWTs) to words and check forms match.
+            words, udapi_form = [], ""
+            for token in mtokens:
+                words += token.words
+                udapi_form += token.form
+                if not token.no_space_after:
+                    udapi_form += " "
+            udapi_form = udapi_form.rstrip()
+            if form != udapi_form:
+                logging.warning(f"Mention {mention_id}: ann form '{form}' != Udapi form '{udapi_form}'")
+
+            # Make sure all words of the mention are in the same sentence.
+            root = words[0].root
+            mwords = [words[0]]
+            for word in words[1:]:
+                if word.root is root:
+                    mwords.append(word)
+                else:
+                    logging.warning(f"Cross-sentence mention. Word {word} not in {root}, thus omitting from the mention.")
+
+            # Create entities for singletons
+            if mention_id not in entity_map:
+                etype = 'other' if ne_type == "_Unsorted_" else ne_type.lower()
+                entity_map[mention_id] = document.create_coref_entity(etype=etype)
+
+            # Create the Udapi mention object
+            mention = entity_map[mention_id].create_mention(words=mwords)
+            mention_map[mention_id] = mention
+
+        # Fill-in the additional mention attributes.
+        for attr_name, mention_id, attr_value in attrs:
+            if mention_id in mention_map:
+                mention_map[mention_id].other[attr_name] = attr_value
+
+        # Fill-in split antecedents
+        for arg1, arg2 in split_ante:
+            if arg1 in entity_map and arg2 in entity_map:
+                if entity_map[arg1] in entity_map[arg2].split_ante:
+                    logging.warning(f"Repeated SplitAnte: {arg1=} ({entity_map[arg1].eid}) {arg2=} ({entity_map[arg2].eid})")
+                else:
+                    entity_map[arg2].split_ante.append(entity_map[arg1])
+            else:
+                logging.warning(f"{arg1} or {arg2} not indexed in entity_map")

From dd51913d1d678d67aa32c80fbd04a46f65a833a7 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 22 Jan 2026 08:59:04 +0100
Subject: [PATCH 1348/1374] read.AddBratAnn should keep the etype

normalization of etype should be done in another dataset-specific block
---
 udapi/block/read/addbratann.py | 34 +++++++++-------------------------
 1 file changed, 9 insertions(+), 25 deletions(-)

diff --git a/udapi/block/read/addbratann.py b/udapi/block/read/addbratann.py
index d801ee6a..ee1f7ee4 100644
--- a/udapi/block/read/addbratann.py
+++ b/udapi/block/read/addbratann.py
@@ -13,26 +13,12 @@
 import logging
 from bisect import bisect_left
 
-# cd fr-litbank/brat/coref
-# cat *.ann | grep '^T' | cut -f2 | cut -f1 -d " " | Sort
-#   33085 PER
-#    2518 FAC
-#    1886 TIME
-#    1046 LOC
-#    1046 GPE
-#     559 NO_PER
-#     508 VEH
-#     229 ORG
-#     115 METALEPSE
-#      85 HIST
-#      12 X
-#      12 TO_DISCUSS
-#       1 OTHER
-#       1 None
 
 class AddBratAnn(Block):
 
-    def __init__(self, files, offset=0, detect_bom=True, keep_mention_id=True, coref_attr="R", zone='', **kwargs):
+    def __init__(self, files,  zone='', offset=0, detect_bom=True, keep_mention_id=True,
+                 coref_attr="R", no_type_value='_Unsorted_',
+                 **kwargs):
         """Args:
         files: file names with the coreference annotations (*.ann)
         offset: what number to substract from the chatacter indices in the ann files
@@ -45,6 +31,7 @@ def __init__(self, files, offset=0, detect_bom=True, keep_mention_id=True, coref
         self.detect_bom = detect_bom
         self.keep_mention_id = keep_mention_id
         self.coref_attr = coref_attr
+        self.no_type_value = no_type_value
 
     def process_document(self, document):
 
@@ -71,14 +58,14 @@ def process_document(self, document):
                     # Let's take the first and last number only.´
                     parts = type_and_range.split()
                     ne_type, range_s, range_e = parts[0], parts[1], parts[-1]
-                    
+
                     # If form ends with spaces, remove them and adjust range_e
                     stripped_form = form.rstrip(" ")
                     if form != stripped_form:
                         num_spaces = len(form) - len(stripped_form)
                         form = stripped_form
                         range_e = int(range_e) - num_spaces
-                    
+
                     mentions[mention_id] = [ne_type, int(range_s), int(range_e), form]
                     if self.keep_mention_id:
                         attrs.append(["mention_id", mention_id, mention_id])
@@ -97,11 +84,9 @@ def process_document(self, document):
         # Create entity objects for non-singletons.
         entity_map = {}
         for mention_ids in clusters:
-            #etype = mentions[mention_ids[0]][0]
             etype, etype_index = None, 0
-            #for m_id in mention_ids[1:]:
             for index, m_id in enumerate(mention_ids):
-                if mentions[m_id][0] == '_Unsorted_':
+                if mentions[m_id][0] == self.no_type_value:
                     pass
                 elif etype is None:
                     etype, etype_index = mentions[m_id][0], index
@@ -109,7 +94,7 @@ def process_document(self, document):
                     logging.warning(f"Mention type mismatch {mention_ids[etype_index]}:{etype} != {m_id}:{mentions[m_id][0]}. Using the former.")
             if etype is None:
                 etype = "other"
-            entity = document.create_coref_entity(etype=etype.lower())
+            entity = document.create_coref_entity(etype=etype)
             for m_id in mention_ids:
                 if m_id in entity_map:
                     logging.warning(f"Mention {m_id} already in Entity {entity_map[m_id].eid}, not adding to {entity.eid}")
@@ -196,8 +181,7 @@ def process_document(self, document):
 
             # Create entities for singletons
             if mention_id not in entity_map:
-                etype = 'other' if ne_type == "_Unsorted_" else ne_type.lower()
-                entity_map[mention_id] = document.create_coref_entity(etype=etype)
+                entity_map[mention_id] = document.create_coref_entity(etype=ne_type)
 
             # Create the Udapi mention object
             mention = entity_map[mention_id].create_mention(words=mwords)

From 585832cff08b3d621913c715512dd9cfd45be10d Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 22 Jan 2026 10:45:47 +0100
Subject: [PATCH 1349/1374] AddBratAnn strip trailing spaces from mentions

those prevented correct offset matching
---
 udapi/block/read/addbratann.py | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/udapi/block/read/addbratann.py b/udapi/block/read/addbratann.py
index ee1f7ee4..d983f65d 100644
--- a/udapi/block/read/addbratann.py
+++ b/udapi/block/read/addbratann.py
@@ -13,6 +13,8 @@
 import logging
 from bisect import bisect_left
 
+def _m(range_s, range_e, offset):
+    return f"{range_s}-{offset}:{range_e}-{offset}" if offset else f"{range_s}:{range_e}"
 
 class AddBratAnn(Block):
 
@@ -47,7 +49,7 @@ def process_document(self, document):
                     offset += 1
 
         for line in ann_filehandle:
-            line = line.rstrip()
+            line = line.rstrip('\n')
             if not "\t" in line:
                 logging.warning(f"Unexpected line without tabs: {line}")
             elif line.startswith("T"):
@@ -57,16 +59,18 @@ def process_document(self, document):
                     # Usually range are two numbers, but can be more, e.g. type_and_range="Abstract  605 653;654 703"
                     # Let's take the first and last number only.´
                     parts = type_and_range.split()
-                    ne_type, range_s, range_e = parts[0], parts[1], parts[-1]
+                    ne_type, range_s, range_e = parts[0], int(parts[1]), int(parts[-1])
 
                     # If form ends with spaces, remove them and adjust range_e
                     stripped_form = form.rstrip(" ")
                     if form != stripped_form:
                         num_spaces = len(form) - len(stripped_form)
+                        logging.debug(f"Stripping {num_spaces} space{'s' if num_spaces>1 else ''} from {mention_id} '{form}' ({_m(range_s,range_e,offset)}->{range_e-num_spaces})")
                         form = stripped_form
-                        range_e = int(range_e) - num_spaces
+                        range_e = range_e - num_spaces
 
-                    mentions[mention_id] = [ne_type, int(range_s), int(range_e), form]
+
+                    mentions[mention_id] = [ne_type, range_s, range_e, form]
                     if self.keep_mention_id:
                         attrs.append(["mention_id", mention_id, mention_id])
                 except Exception as e:
@@ -155,7 +159,7 @@ def process_document(self, document):
                             break
 
             if not ok_s or not ok_e:
-                logging.warning(f"Mention {mention_id} range {range_s}-{offset}:{range_e}-{offset} ({form})"
+                logging.warning(f"Mention {mention_id} range {_m(range_s, range_e, offset)} ({form})"
                                 f" crosses token boundaries: {token_s.misc} ({token_s.form}) "
                                 f".. {token_e.misc} ({token_e.form})")
 

From bd2e61f5f0606a8124395d9938865323e8b10fe3 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 22 Jan 2026 12:12:30 +0100
Subject: [PATCH 1350/1374] FrLitBank actually uses linked-based coreference

so we need to use nx.connected_components(coref_graph),
which should not hurt even for Brat ann files using
cluster-based coreference (such as MiniCIEP+).
---
 udapi/block/read/addbratann.py | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/udapi/block/read/addbratann.py b/udapi/block/read/addbratann.py
index d983f65d..244529c7 100644
--- a/udapi/block/read/addbratann.py
+++ b/udapi/block/read/addbratann.py
@@ -12,6 +12,7 @@
 from udapi.core.files import Files
 import logging
 from bisect import bisect_left
+import networkx as nx
 
 def _m(range_s, range_e, offset):
     return f"{range_s}-{offset}:{range_e}-{offset}" if offset else f"{range_s}:{range_e}"
@@ -85,6 +86,25 @@ def process_document(self, document):
             else:
                 logging.warning(f"Unexpected line in {self.files.filename}:\n{line}")
 
+        # Some Brat ann files use link-based representation, e.g.
+        # R123	Coreference Arg1:T11 Arg2:T13
+        # R124	Coreference Arg1:T12 Arg2:T14
+        # R125	Coreference Arg1:T13 Arg2:T14
+        # This actually means that all four mentions T11, T12, T13 and T14 are in the same cluster (entity).
+        # However, clusters = [["T11", "T13"], ["T12", "T14"], ["T13", "T14"]]
+        # and we need to convert it to clusters = [["T11", "T12", "T13", "T14"]]
+        # Note that if creating entities for link, in their original order,
+        # R123 and R125 would result in creating two entities and when hitting R125
+        # we would need to merge them, i.e. delete one of them and move their mentions to the other.
+        # This is the solution of corefud.Link2Cluster, but here it seems easier to find connected components.
+        coref_graph = nx.Graph()
+        for mention_ids in clusters:
+            coref_graph.add_node(mention_ids[0])
+            for mention_id in mention_ids[1:]:
+                coref_graph.add_node(mention_id)
+                coref_graph.add_edge(mention_id, mention_ids[0])
+        clusters = [list(component) for component in nx.connected_components(coref_graph)]
+
         # Create entity objects for non-singletons.
         entity_map = {}
         for mention_ids in clusters:

From e6db7b3959396cbdac52d58bf37603785a8913b7 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Thu, 22 Jan 2026 14:07:54 +0100
Subject: [PATCH 1351/1374] AddBratAnn do not fail on trailing whitespace on
 R-lines

---
 udapi/block/read/addbratann.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/udapi/block/read/addbratann.py b/udapi/block/read/addbratann.py
index 244529c7..4f5fc877 100644
--- a/udapi/block/read/addbratann.py
+++ b/udapi/block/read/addbratann.py
@@ -77,9 +77,12 @@ def process_document(self, document):
                 except Exception as e:
                     logging.warning(f"Unexpected mention line: {line}\n{e}")
             elif line.startswith(self.coref_attr):
-                cor_attr, mention_ids = line.split("\t")
-                parts = mention_ids.split()
-                assert(parts[0] == "Coreference")
+                try:
+                    cor_attr, mention_ids = line.rstrip().split("\t")
+                    parts = mention_ids.split()
+                    assert(parts[0] == "Coreference")
+                except Exception as e:
+                    logging.warning(f"Unexpected coref line: '{line}'\n{e}")
                 clusters.append([p.split(":")[1] for p in parts[1:]])
             elif line.startswith("#"):
                 pass # Let's ignore annotators' comments

From bd89be0d60148dfb17717039b7fd484e4d8623dd Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 23 Jan 2026 18:33:15 +0100
Subject: [PATCH 1352/1374] bugfix in read.Conllu fix_cycles=1

plus fixing also HEAD index out of range
---
 udapi/block/read/conllu.py | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/udapi/block/read/conllu.py b/udapi/block/read/conllu.py
index 9151a216..e19cd676 100644
--- a/udapi/block/read/conllu.py
+++ b/udapi/block/read/conllu.py
@@ -27,7 +27,7 @@ def __init__(self, strict=False, empty_parent='warn', fix_cycles=False, **kwargs
         strict: raise an exception if errors found (default=False, i.e. a robust mode)
         empty_parent: What to do if HEAD is _? Default=warn: issue a warning and attach to the root
             or if strict=1 issue an exception. With `empty_parent=ignore` no warning is issued.
-        fix_cycles: fix cycles by attaching a node in the cycle to the root
+        fix_cycles: fix cycles by attaching a node in the cycle to the root; fix also HEAD index out of range
         """
         super().__init__(**kwargs)
         self.strict = strict
@@ -193,12 +193,15 @@ def read_tree_from_lines(self, lines):
             try:
                 parent = nodes[parents[node_ord]]
             except IndexError:
-                raise ValueError("Node %s HEAD is out of range (%d)" % (node, parents[node_ord]))
+                if self.fix_cycles:
+                    logging.warning(f"Ignoring out-of-range HEAD (attaching to the root instead): {node} HEAD={parents[node_ord]}")
+                    parent = root
+                else:
+                    raise ValueError("Node %s HEAD is out of range (%d)" % (node, parents[node_ord]))
             if node is parent:
                 if self.fix_cycles:
-                    logging.warning("Ignoring a cycle (attaching to the root instead):\n%s", node)
-                    node._parent = root
-                    root._children.append(node)
+                    logging.warning("Ignoring a self-cycle (attaching to the root instead):\n%s", node)
+                    parent = root
                 else:
                     raise ValueError(f"Detected a cycle: {node} attached to itself")
             elif node._children:

From e2096f0a75c9e4d1ff51612cd9125221f1855e92 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Sun, 25 Jan 2026 16:11:33 +0100
Subject: [PATCH 1353/1374] Rename phrase features

---
 udapi/block/msf/phrase.py             | 92 +++++++++++++++------------
 udapi/block/msf/romance/romance.py    | 41 ++++++------
 udapi/block/msf/slavic/conditional.py |  4 +-
 udapi/block/msf/slavic/converb.py     |  6 +-
 udapi/block/msf/slavic/future.py      | 14 ++--
 udapi/block/msf/slavic/imperative.py  |  6 +-
 udapi/block/msf/slavic/infinitive.py  |  8 +--
 udapi/block/msf/slavic/past.py        | 10 +--
 udapi/block/msf/slavic/present.py     |  8 +--
 9 files changed, 100 insertions(+), 89 deletions(-)

diff --git a/udapi/block/msf/phrase.py b/udapi/block/msf/phrase.py
index 34d4bc40..00efdada 100644
--- a/udapi/block/msf/phrase.py
+++ b/udapi/block/msf/phrase.py
@@ -10,53 +10,63 @@
 
 class Phrase(Block):
 
-    def process_node(self, node):
+    def __init__(self, feature_prefix='CG', **kwargs):
         """
-        Override this in a derived class!
+        Parameters:
+        feature_prefix (string) - The prefix of phrase features (e. g. 'CG', 'Phrase'), default is 'CG'
         """
-        logging.fatal('process_node() not implemented.')
+        super().__init__(**kwargs)
+        self.feature_prefix = feature_prefix
+
+        self.dictionary = {
+            'person': f'{feature_prefix}Person',
+            'number': f'{feature_prefix}Number',
+            'mood': f'{feature_prefix}Mood',
+            'tense': f'{feature_prefix}Tense',
+            'voice': f'{feature_prefix}Voice',
+            'aspect':f'{feature_prefix}Aspect',
+            'form': f'{feature_prefix}Form',
+            'reflex': f'{feature_prefix}Reflex',
+            'polarity': f'{feature_prefix}Polarity',
+            'gender': f'{feature_prefix}Gender',
+            'animacy': f'{feature_prefix}Animacy',
+            'ords': feature_prefix,
+            'expl': f'{feature_prefix}Expl',
+            'analytic': 'Analytic',
+            }
+        
+        # a dictionary where the key is the lemma of a negative particle and the value is a list of the lemmas of their possible children that have a 'fixed' relation
+        # we do not want to include these negative particles in the phrase; these are expressions like "never", etc.
+        self.negation_fixed = {
+            # Belarusian
+            'ні' : ['раз'],
+            'ня' : ['толькі'],
 
-    dictionary = {
-		'person': 'PeriPerson',
-		'number': 'PeriNumber',
-		'mood': 'PeriMood',
-		'tense': 'PeriTense',
-		'voice': 'PeriVoice',
-		'aspect':'PeriAspect',
-		'form': 'PeriForm',
-		'reflex': 'PeriReflex',
-		'polarity': 'PeriPolarity',
-		'gender':'PeriGender',
-		'animacy':'PeriAnimacy',
-		'ords':'Peri',
-        'expl':'PeriExpl',
-        'periphrasis':'Periphrasis',
-		}
-    
-    # a dictionary where the key is the lemma of a negative particle and the value is a list of the lemmas of their possible children that have a 'fixed' relation
-    # we do not want to include these negative particles in the phrase; these are expressions like "never", etc.
-    negation_fixed = {
-        # Belarusian
-        'ні' : ['раз'],
-        'ня' : ['толькі'],
+            # Upper Sorbian
+            'nic' : ['naposledku'],
+
+            # Polish
+            'nie' : ['mało'],
 
-        # Upper Sorbian
-        'nic' : ['naposledku'],
+            # Pomak
+            'néma' : ['kak'],
 
-        # Polish
-        'nie' : ['mało'],
+            # Slovenian
+            'ne' : ['le'],
 
-        # Pomak
-        'néma' : ['kak'],
+            # Russian and Old East Slavic
+            'не' : ['то', 'токмо'],
+            'ни' : ['в', 'раз', 'шатко'],
+            'нет' : ['нет']
+        }
 
-        # Slovenian
-        'ne' : ['le'],
+    def process_node(self, node):
+        """
+        Override this in a derived class!
+        """
+        logging.fatal('process_node() not implemented.')
 
-        # Russian and Old East Slavic
-        'не' : ['то', 'токмо'],
-        'ни' : ['в', 'раз', 'шатко'],
-        'нет' : ['нет']
-    }
+    
 
     def write_node_info(self, node,
 			tense = None,
@@ -72,7 +82,7 @@ def write_node_info(self, node,
 			animacy = None,
 			aspect = None,
             expl=None,
-            periphrasis=None):
+            analytic=None):
         arguments = locals()
         del arguments['self'] # delete self and node from arguments,
         del arguments['node'] # we want only grammatical categories 
@@ -148,7 +158,7 @@ def get_voice(self,node,refl):
             return 'Pass'
         return voice
     
-    def get_periphrasis_bool(self,node):
+    def get_analytic_bool(self,node):
         auxes = [x for x in node.children if x.udeprel == 'aux']
 
         if auxes:
diff --git a/udapi/block/msf/romance/romance.py b/udapi/block/msf/romance/romance.py
index 9ff0c9ec..ed05fa89 100644
--- a/udapi/block/msf/romance/romance.py
+++ b/udapi/block/msf/romance/romance.py
@@ -30,13 +30,14 @@ def __init__(self, neg=True, **kwargs):
         """
         Parameters:
         neg (bool) - If True, process negation and generate the PhrasePolarity=Neg attribute.
+        feature_prefix (string) - The prefix of phrase features (e. g. 'CG', 'Phrase'), default is 'CG'
         """
         super().__init__(**kwargs)
         self.neg = neg
 
     def process_node(self, node):
 
-        if node.misc['Peri'] != '':
+        if node.misc[self.feature_prefix] != '':
             return
 
         cop = [x for x in node.children if x.udeprel == 'cop']
@@ -102,7 +103,7 @@ def process_node(self, node):
                         gender=node.feats['Gender'],
                         voice=node.feats['Voice'],
                         expl=expl,
-                        periphrasis=self.get_periphrasis_bool(node),
+                        analytic=self.get_analytic_bool(node),
                         ords=[node.ord]
                     )
                 return
@@ -250,7 +251,7 @@ def process_phrases_with_ir_aller_estar(self, node, expl, polarity, phrase_ords,
         tense = node.feats['Tense']
 
         # phrase already annotated
-        if head_node.misc['Peri'] != '':
+        if head_node.misc[self.feature_prefix] != '':
             return
 
         xcomps = [x for x in node.children if x.udeprel == 'xcomp']
@@ -330,7 +331,7 @@ def process_phrases_with_ir_aller_estar(self, node, expl, polarity, phrase_ords,
                                  voice=voice,
                                  expl = expl,
                                  polarity = polarity,
-                                 periphrasis='Yes',
+                                 analytic='Yes',
                                  ords=phrase_ords)
             return
 
@@ -468,7 +469,7 @@ def process_simple_verb_forms(self, node, expl, polarity, phrase_ords, head_node
             voice=head_node.feats['Voice'],
             expl=expl,
             polarity=polarity,
-            periphrasis=self.get_periphrasis_bool(head_node),
+            analytic=self.get_analytic_bool(head_node),
             ords=phrase_ords
         )
 
@@ -486,7 +487,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
         """
 
         # phrase already annotated
-        if head_node.misc['Peri'] != '':
+        if head_node.misc[self.feature_prefix] != '':
             return
         
         if len(auxes) == 1:
@@ -521,7 +522,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     expl=expl,
                     polarity=polarity,
                     voice=head_node.feats['Voice'],
-                    periphrasis='Yes',
+                    analytic='Yes',
                     ords=phrase_ords)
                 return
             
@@ -545,7 +546,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
-                    periphrasis='Yes',
+                    analytic='Yes',
                     ords=phrase_ords)      
                 return
             
@@ -570,7 +571,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
-                    periphrasis='Yes',
+                    analytic='Yes',
                     ords=phrase_ords)
                 return
                 
@@ -609,7 +610,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     aspect=aspect,
                     expl=expl,
                     polarity=polarity,
-                    periphrasis='Yes',
+                    analytic='Yes',
                     ords=phrase_ords)
                 
                 return
@@ -656,7 +657,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     # Portuguese
                     # pretérito perfeito composto (aux ter) -> PhraseTense=PastPres, PhraseAspect=Perf
                     # subjonctive pretérito perfeito composto (aux ter) -> PhraseTense=PastPres, PhraseAspect=Perf, PhraseMood=Sub
-                    if auxes[0].lemma in ['ter', 'fi'] or auxes[0].feats['Mood'] == 'Sub':
+                    if auxes[0].lemma == 'fi' or auxes[0].feats['Mood'] == 'Sub':
                         tense = Tense.PASTPRES.value
 
                         # subjonctive mood not annotated in Romanian data
@@ -700,7 +701,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
-                    periphrasis='Yes',
+                    analytic='Yes',
                     ords=phrase_ords)
                 return
                 
@@ -745,7 +746,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
-                    periphrasis='Yes',
+                    analytic='Yes',
                     ords=phrase_ords)
                 
                 return
@@ -764,7 +765,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
-                    periphrasis='Yes',
+                    analytic='Yes',
                     ords=phrase_ords)
                 
                 return
@@ -791,7 +792,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
-                    periphrasis='Yes',
+                    analytic='Yes',
                     ords=phrase_ords)
                 
                 return       
@@ -811,7 +812,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
-                    periphrasis='Yes',
+                    analytic='Yes',
                     ords=phrase_ords)
                 
                 return
@@ -829,7 +830,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
-                    periphrasis='Yes',
+                    analytic='Yes',
                     ords=phrase_ords)
                 
                 return
@@ -867,7 +868,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
-                    periphrasis='Yes',
+                    analytic='Yes',
                     ords=phrase_ords)
 
             # auxiliriy 'ir' in present or future tense followed by auxiliary 'ter' in infinitive and a participle
@@ -893,7 +894,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
-                    periphrasis='Yes',
+                    analytic='Yes',
                     ords=phrase_ords)    
                         
             # Cnd (only ter/haber), Sub and Past,Pres,Fut tenses: 2 auxes - ter/haber + estar
@@ -932,7 +933,7 @@ def process_periphrastic_verb_forms(self, node, auxes, expl, polarity, phrase_or
                     voice=head_node.feats['Voice'],
                     expl=expl,
                     polarity=polarity,
-                    periphrasis='Yes',
+                    analytic='Yes',
                     ords=phrase_ords,
                 )
                 return
diff --git a/udapi/block/msf/slavic/conditional.py b/udapi/block/msf/slavic/conditional.py
index 8b471269..846296d3 100644
--- a/udapi/block/msf/slavic/conditional.py
+++ b/udapi/block/msf/slavic/conditional.py
@@ -50,7 +50,7 @@ def process_node(self, node):
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
-					periphrasis=self.get_periphrasis_bool(node)
+					analytic=self.get_analytic_bool(node)
 				)
 				return
 		
@@ -83,5 +83,5 @@ def process_node(self, node):
 					ords=phrase_ords,
 					gender=copVerb.feats['Gender'],
 					animacy=copVerb.feats['Animacy'],
-					periphrasis=self.get_periphrasis_bool(node)
+					analytic=self.get_analytic_bool(node)
 			)
\ No newline at end of file
diff --git a/udapi/block/msf/slavic/converb.py b/udapi/block/msf/slavic/converb.py
index a83ffac1..32714630 100644
--- a/udapi/block/msf/slavic/converb.py
+++ b/udapi/block/msf/slavic/converb.py
@@ -32,7 +32,7 @@ def process_node(self, node):
 				gender=node.feats['Gender'],
 				animacy=node.feats['Animacy'],
 				voice=self.get_voice(node, refl),
-				periphrasis=self.get_periphrasis_bool(node)
+				analytic=self.get_analytic_bool(node)
 				)
 
 		# passive voice
@@ -59,7 +59,7 @@ def process_node(self, node):
 					gender=auxVerb.feats['Gender'],
 					animacy=auxVerb.feats['Animacy'],
 					voice='Pass',
-					periphrasis=self.get_periphrasis_bool(node)
+					analytic=self.get_analytic_bool(node)
 				)
 
 		# copulas
@@ -90,5 +90,5 @@ def process_node(self, node):
 					polarity=self.get_polarity(phrase_nodes),
 					ords=phrase_ords,
 					voice=self.get_voice(copVerb, refl),
-					periphrasis=self.get_periphrasis_bool(node)
+					analytic=self.get_analytic_bool(node)
 					)
diff --git a/udapi/block/msf/slavic/future.py b/udapi/block/msf/slavic/future.py
index 4a758563..9cc17717 100644
--- a/udapi/block/msf/slavic/future.py
+++ b/udapi/block/msf/slavic/future.py
@@ -37,7 +37,7 @@ def process_node(self, node):
 					expl=self.get_expl_type(node,refl),
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
-					periphrasis=self.get_periphrasis_bool(node),
+					analytic=self.get_analytic_bool(node),
 					ords=phrase_ords
 					)
 			else:
@@ -58,7 +58,7 @@ def process_node(self, node):
 					expl=self.get_expl_type(node,refl),
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
-					periphrasis=self.get_periphrasis_bool(node),
+					analytic=self.get_analytic_bool(node),
 					ords=phrase_ords
 					)
 				
@@ -88,7 +88,7 @@ def process_node(self, node):
 				form='Fin',
 				polarity=self.get_polarity(phrase_nodes),
 				expl=self.get_expl_type(node,refl),
-				periphrasis=self.get_periphrasis_bool(node),
+				analytic=self.get_analytic_bool(node),
 				ords=phrase_ords
 				)
 			return
@@ -116,7 +116,7 @@ def process_node(self, node):
 				aspect='Perf',
 				polarity=self.get_polarity(phrase_nodes),
 				expl=self.get_expl_type(node,refl),
-				periphrasis=self.get_periphrasis_bool(node),
+				analytic=self.get_analytic_bool(node),
 				ords=phrase_ords
 				)
 			return
@@ -153,7 +153,7 @@ def process_node(self, node):
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
-					periphrasis=self.get_periphrasis_bool(node)
+					analytic=self.get_analytic_bool(node)
 					)
 				return
 
@@ -172,7 +172,7 @@ def process_node(self, node):
 					form='Fin',
 					polarity=self.get_polarity(phrase_nodes),
 					expl=self.get_expl_type(node,refl),
-					periphrasis=self.get_periphrasis_bool(node),
+					analytic=self.get_analytic_bool(node),
 					ords=phrase_ords
 					)
 				return
@@ -201,7 +201,7 @@ def process_node(self, node):
 					form='Fin',
 					voice=self.get_voice(copVerb, refl),
 					polarity=self.get_polarity(phrase_nodes),
-					periphrasis=self.get_periphrasis_bool(node),
+					analytic=self.get_analytic_bool(node),
 					ords=phrase_ords
 				)
 
diff --git a/udapi/block/msf/slavic/imperative.py b/udapi/block/msf/slavic/imperative.py
index ff3a6cf3..5a30d05e 100644
--- a/udapi/block/msf/slavic/imperative.py
+++ b/udapi/block/msf/slavic/imperative.py
@@ -29,7 +29,7 @@ def process_node(self, node):
 				voice='Act',
 				polarity=self.get_polarity(phrase_nodes),
 				expl=self.get_expl_type(node,refl),
-				periphrasis=self.get_periphrasis_bool(node),
+				analytic=self.get_analytic_bool(node),
 				ords=phrase_ords
 				)
 			return
@@ -56,7 +56,7 @@ def process_node(self, node):
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
-					periphrasis=self.get_periphrasis_bool(node)
+					analytic=self.get_analytic_bool(node)
 					)
 				return
 
@@ -84,6 +84,6 @@ def process_node(self, node):
 				voice=self.get_voice(copVerb, refl),
 				expl=self.get_expl_type(node, refl),
 				polarity=self.get_polarity(phrase_nodes),
-				periphrasis=self.get_periphrasis_bool(node),
+				analytic=self.get_analytic_bool(node),
 				ords=phrase_ords
 				)
diff --git a/udapi/block/msf/slavic/infinitive.py b/udapi/block/msf/slavic/infinitive.py
index 160536e3..83bc0766 100644
--- a/udapi/block/msf/slavic/infinitive.py
+++ b/udapi/block/msf/slavic/infinitive.py
@@ -28,7 +28,7 @@ def process_node(self,node):
 					form='Inf',
 					polarity=self.get_polarity(phrase_nodes),
 					expl=self.get_expl_type(node,refl),
-					periphrasis=self.get_periphrasis_bool(node),
+					analytic=self.get_analytic_bool(node),
 					ords=phrase_ords
 				)
 				return
@@ -56,7 +56,7 @@ def process_node(self,node):
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
 					number=node.feats['Number'],
-					periphrasis=self.get_periphrasis_bool(node)
+					analytic=self.get_analytic_bool(node)
 					)
 				return
 					
@@ -81,7 +81,7 @@ def process_node(self,node):
 				form='Inf',
 				polarity=self.get_polarity(phrase_nodes),
 				expl=self.get_expl_type(node, refl),
-				periphrasis=self.get_periphrasis_bool(node),
+				analytic=self.get_analytic_bool(node),
 				ords=phrase_ords
 				)
 			
@@ -102,6 +102,6 @@ def process_node(self,node):
 					form='Sup',
 					polarity=self.get_polarity(phrase_nodes),
 					expl=self.get_expl_type(node, refl),
-					periphrasis=self.get_periphrasis_bool(node),
+					analytic=self.get_analytic_bool(node),
 					ords=phrase_ords
 					)
diff --git a/udapi/block/msf/slavic/past.py b/udapi/block/msf/slavic/past.py
index e97357e3..130d972d 100644
--- a/udapi/block/msf/slavic/past.py
+++ b/udapi/block/msf/slavic/past.py
@@ -50,7 +50,7 @@ def process_node(self, node):
 						ords=phrase_ords,
 						gender=node.feats['Gender'],
 						animacy=node.feats['Animacy'],
-						periphrasis=self.get_periphrasis_bool(node)
+						analytic=self.get_analytic_bool(node)
 						)
 
 		# compound past tense
@@ -98,7 +98,7 @@ def process_node(self, node):
 						ords=phrase_ords,
 						gender=node.feats['Gender'],
 						animacy=node.feats['Animacy'],
-						periphrasis=self.get_periphrasis_bool(node)
+						analytic=self.get_analytic_bool(node)
 						)
 				
 
@@ -133,7 +133,7 @@ def process_node(self, node):
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
-					periphrasis=self.get_periphrasis_bool(node)
+					analytic=self.get_analytic_bool(node)
 					)
 			
 				
@@ -170,7 +170,7 @@ def process_node(self, node):
 						ords=phrase_ords,
 						gender=node.feats['Gender'],
 						animacy=node.feats['Animacy'],
-						periphrasis=self.get_periphrasis_bool(node)
+						analytic=self.get_analytic_bool(node)
 						)
 				
 		else:
@@ -208,5 +208,5 @@ def process_node(self, node):
 					ords=phrase_ords,
 					gender=cop[0].feats['Gender'],
 					animacy=cop[0].feats['Animacy'],
-					periphrasis=self.get_periphrasis_bool(node)
+					analytic=self.get_analytic_bool(node)
 					)
diff --git a/udapi/block/msf/slavic/present.py b/udapi/block/msf/slavic/present.py
index 3221d0e8..7521a08d 100644
--- a/udapi/block/msf/slavic/present.py
+++ b/udapi/block/msf/slavic/present.py
@@ -35,7 +35,7 @@ def process_node(self,node):
 					form='Fin',
 					polarity=self.get_polarity(phrase_nodes),
 					expl=self.get_expl_type(node,refl),
-					periphrasis=self.get_periphrasis_bool(node),
+					analytic=self.get_analytic_bool(node),
 					ords=phrase_ords
 					)
 				return
@@ -67,7 +67,7 @@ def process_node(self,node):
 					ords=phrase_ords,
 					gender=node.feats['Gender'],
 					animacy=node.feats['Animacy'],
-					periphrasis=self.get_periphrasis_bool(node)
+					analytic=self.get_analytic_bool(node)
 					)
 				return
 			
@@ -95,7 +95,7 @@ def process_node(self,node):
 					voice=self.get_voice(node, refl),
 					expl=self.get_expl_type(node, refl),
 					polarity=self.get_polarity(phrase_nodes),
-					periphrasis=self.get_periphrasis_bool(node),
+					analytic=self.get_analytic_bool(node),
 					ords=phrase_ords
 				)
 				return
@@ -127,6 +127,6 @@ def process_node(self,node):
 					voice=self.get_voice(copVerb, refl),
 					expl=self.get_expl_type(node, refl),
 					polarity=self.get_polarity(phrase_nodes),
-					periphrasis=self.get_periphrasis_bool(node),
+					analytic=self.get_analytic_bool(node),
 					ords=phrase_ords
 				)

From 1a4ec2d532c6232374a30c4208823751f6cd28da Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Tue, 27 Jan 2026 19:48:15 +0100
Subject: [PATCH 1354/1374] Comment out code that alters UPOS

---
 udapi/block/msf/slavic/preprocessor.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/udapi/block/msf/slavic/preprocessor.py b/udapi/block/msf/slavic/preprocessor.py
index 804a081f..0672812b 100644
--- a/udapi/block/msf/slavic/preprocessor.py
+++ b/udapi/block/msf/slavic/preprocessor.py
@@ -17,8 +17,8 @@ def process_node(self,node):
 				
 		# in some languages, participles are annotated with UPOS=VERB, while in others they are annotated with UPOS=ADJ
 		# we change the UPOS to ADJ when a participle expresses case
-		if node.upos == 'VERB' and node.feats['VerbForm'] == 'Part' and node.feats['Case'] != '':
-			node.upos = 'ADJ'
+		#if node.upos == 'VERB' and node.feats['VerbForm'] == 'Part' and node.feats['Case'] != '':
+		#	node.upos = 'ADJ'
 			
 		# in Polish, the conditional mood for auxiliary verbs is marked as deprel == 'aux:cnd' and not as in the last Slavic languages ​​feats['Mood'] == 'Cnd'
 		if node.deprel == 'aux:cnd':
@@ -54,8 +54,8 @@ def process_node(self,node):
 					node.feats['Number'] = subj[0].feats['Number']
 
 		# participles in passive are sometimes annotated as VERB, sometimes as ADJ
-		if node.upos == 'VERB' and node.feats['Voice'] == 'Pass':
-			node.upos = 'ADJ'
+		#if node.upos == 'VERB' and node.feats['Voice'] == 'Pass':
+		#	node.upos = 'ADJ'
 
 		# there are cases where the node has deprel=='expl:pv' or 'expl:pass' or 'expl:impers' and Reflex is not Yes (i.e. Macedonian treebank)
 		# we add the Reflex=Yes feature

From 002d6ba2568975dded94cb23ef39e946a4397de2 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Tue, 27 Jan 2026 19:50:17 +0100
Subject: [PATCH 1355/1374] Update default feature_prefix to 'CW'

---
 udapi/block/msf/phrase.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/udapi/block/msf/phrase.py b/udapi/block/msf/phrase.py
index 00efdada..cf5a8f81 100644
--- a/udapi/block/msf/phrase.py
+++ b/udapi/block/msf/phrase.py
@@ -10,10 +10,10 @@
 
 class Phrase(Block):
 
-    def __init__(self, feature_prefix='CG', **kwargs):
+    def __init__(self, feature_prefix='CW', **kwargs):
         """
         Parameters:
-        feature_prefix (string) - The prefix of phrase features (e. g. 'CG', 'Phrase'), default is 'CG'
+        feature_prefix (string) - The prefix of phrase features (e. g. 'CW', 'Phrase'), default is 'CG'
         """
         super().__init__(**kwargs)
         self.feature_prefix = feature_prefix

From 2a0012167a6271df09145b7909d8099ab71fa1b0 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Tue, 27 Jan 2026 19:53:20 +0100
Subject: [PATCH 1356/1374] Add Romance Preprocessor

---
 udapi/block/msf/romance/preprocessor.py | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 udapi/block/msf/romance/preprocessor.py

diff --git a/udapi/block/msf/romance/preprocessor.py b/udapi/block/msf/romance/preprocessor.py
new file mode 100644
index 00000000..4956371b
--- /dev/null
+++ b/udapi/block/msf/romance/preprocessor.py
@@ -0,0 +1,21 @@
+from phrase import Phrase
+from enum import Enum
+
+class Preprocessor(Phrase):
+
+
+    def process_node(self, node):
+
+        # In Porttinari treebank, the negative adverb não is not marked with feat Polarity=Neg
+        if node.lemma == 'não' and node.upos == 'ADV':
+            node.feats['Polarity'] = 'Neg'
+
+        if node.upos == 'ADV' and node.feats['PronType'] == 'Neg':
+            node.feats['PronType'] = ''
+            node.feats['Polarity'] = 'Neg'
+
+        # In Romanian RRT treebank, there is no annotation of the voice feature
+        # Automatically assign passive voice
+        pass_auxes = [x for x in node.children if x.deprel == 'aux:pass']
+        if pass_auxes:
+            node.feats['Voice'] = 'Pass'
\ No newline at end of file

From 836ce88222d085962a17a20a2a2fda0de90ce462 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Tue, 27 Jan 2026 20:26:03 +0100
Subject: [PATCH 1357/1374] Reparent Preprocessor class to Block

---
 udapi/block/msf/romance/preprocessor.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/udapi/block/msf/romance/preprocessor.py b/udapi/block/msf/romance/preprocessor.py
index 4956371b..ad7aec1e 100644
--- a/udapi/block/msf/romance/preprocessor.py
+++ b/udapi/block/msf/romance/preprocessor.py
@@ -1,7 +1,6 @@
-from phrase import Phrase
-from enum import Enum
+from udapi.core.block import Block
 
-class Preprocessor(Phrase):
+class Preprocessor(Block):
 
 
     def process_node(self, node):

From a4f90986d34d0fa29862c95bb15a3e0850a77662 Mon Sep 17 00:00:00 2001
From: lenka-krippnerova <14723289@cuni.cz>
Date: Tue, 17 Feb 2026 14:53:45 +0100
Subject: [PATCH 1358/1374] Correct person detection for Slavic conditional
 mood

---
 udapi/block/msf/slavic/conditional.py | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/udapi/block/msf/slavic/conditional.py b/udapi/block/msf/slavic/conditional.py
index 846296d3..9d15418f 100644
--- a/udapi/block/msf/slavic/conditional.py
+++ b/udapi/block/msf/slavic/conditional.py
@@ -30,12 +30,12 @@ def process_node(self, node):
 
 				phrase_ords = [x.ord for x in phrase_nodes]
 				phrase_ords.sort()
-			
-				auxVerb = aux_cnd[0]
 
 				person='3' # TODO there is a problem in russian etc. (same as in past tense)
-				if auxVerb.feats['Person'] != '':
-					person=auxVerb.feats['Person']
+
+				for aux_verb in aux:
+					if aux_verb.feats['Person'] != '':
+						person=aux_verb.feats['Person']
 				
 					
 				self.write_node_info(node,
@@ -69,11 +69,21 @@ def process_node(self, node):
 			phrase_nodes += neg
 
 			copVerb = cop[0]
+
+			person = '3'
+
+			for aux_verb in aux:
+					if aux_verb.feats['Person'] != '':
+						person=aux_verb.feats['Person']
+			for cop_verb in cop:
+				if cop_verb.feats['Person'] != '':
+						person=aux_verb.feats['Person']
+
 			phrase_ords = [x.ord for x in phrase_nodes]
 			phrase_ords.sort()
 			self.write_node_info(node,
 					aspect=copVerb.feats['Aspect'],
-					person=copVerb.feats['Person'],
+					person=person,
 					number=copVerb.feats['Number'],
 					mood='Cnd',
 					form='Fin',

From e33afd23e9994d22ea79ecb2d8793a05865fab32 Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Fri, 20 Feb 2026 17:19:38 +0100
Subject: [PATCH 1359/1374] UDPipe (and thus ufal.udpipe) doesn't need to be
 imported if online=1

---
 udapi/block/udpipe/base.py | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/udapi/block/udpipe/base.py b/udapi/block/udpipe/base.py
index 069fc9fb..9d053cb7 100644
--- a/udapi/block/udpipe/base.py
+++ b/udapi/block/udpipe/base.py
@@ -1,9 +1,15 @@
 """Block udpipe.Base for tagging and parsing using UDPipe."""
 from udapi.core.block import Block
-from udapi.tool.udpipe import UDPipe
 from udapi.tool.udpipeonline import UDPipeOnline
 from udapi.core.bundle import Bundle
 
+# Import UDPipe only if available (requires ufal.udpipe)
+try:
+    from udapi.tool.udpipe import UDPipe
+    UDPIPE_AVAILABLE = True
+except ImportError:
+    UDPIPE_AVAILABLE = False
+
 KNOWN_MODELS = {
     'af': 'models/udpipe/2.4/afrikaans-afribooms-ud-2.4-190531.udpipe',
     'af_afribooms': 'models/udpipe/2.4/afrikaans-afribooms-ud-2.4-190531.udpipe',
@@ -143,6 +149,8 @@ def tool(self):
         if self.online:
             self._tool = UDPipeOnline(model=self.model)
         else:
+            if not UDPIPE_AVAILABLE:
+                raise ImportError("UDPipe is not available. Install ufal.udpipe or use online=1")
             self._tool = UDPipe(model=self.model)
         return self._tool
 

From 5685cf64055effdc244f7689520c9baf7a99d9d5 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 3 Mar 2026 17:10:55 +0100
Subject: [PATCH 1360/1374] Emph with Czech nouns, pronominal ordinal and
 multiplicative numerals.

---
 udapi/block/ud/cs/markfeatsbugs.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index bd55586e..62dd9719 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -37,6 +37,7 @@ def process_node(self, node):
                     'Gender': ['Neut'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'Emph': ['Yes'],
                     'Foreign': ['Yes'],
                     'Abbr': ['Yes']
                 })
@@ -47,6 +48,7 @@ def process_node(self, node):
                     'Animacy': ['Anim', 'Inan'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'Emph': ['Yes'],
                     'Foreign': ['Yes'],
                     'Abbr': ['Yes']})
             else:
@@ -54,6 +56,7 @@ def process_node(self, node):
                     'Gender': ['Masc', 'Fem', 'Neut'],
                     'Number': ['Sing', 'Dual', 'Plur'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],
+                    'Emph': ['Yes'],
                     'Foreign': ['Yes'],
                     'Abbr': ['Yes']})
         # PROPER NOUNS #########################################################
@@ -531,6 +534,11 @@ def process_node(self, node):
             elif node.lemma == 'žádný':
                 # In Old Czech, this determiner also allows Variant=Short: žáden, žádna, žádnu, žádno, žádni, žádny.
                 self.check_adjective_like(node, ['PronType'], {'PronType': ['Neg'], 'Variant': ['Short']})
+            elif node.feats['NumType'] in ['Ord', 'Mult']: # pronominal numerals 'několikátý', 'několikerý', 'několiký' etc.
+                self.check_adjective_like(node, ['PronType', 'NumType'], {
+                    'PronType': ['Ind', 'Int', 'Rel', 'Dem'],
+                    'NumType': ['Ord', 'Mult']
+                })
             elif node.feats['NumType'] == 'Card': # pronominal quantifiers 'mnoho', 'málo', 'několik' etc.
                 if node.lemma == 'nejeden':
                     self.check_adjective_like(node, ['PronType', 'NumType'], {'PronType': ['Ind'], 'NumType': ['Card']})

From 88740a803fc7671bf040d0a2285559ade6a00db6 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 4 Mar 2026 18:27:35 +0100
Subject: [PATCH 1361/1374] =?UTF-8?q?"tv=C5=AFj=C5=BEto"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 62dd9719..5a18acf7 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -504,7 +504,7 @@ def process_node(self, node):
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
-            elif re.match(r'^(můj|tvůj|svůj)$', node.lemma):
+            elif re.match(r'^(můj|tvůj|svůj)(ž(e|to)?)$', node.lemma):
                 if node.feats['Reflex'] == 'Yes':
                     self.check_adjective_like(node, ['PronType', 'Poss', 'Reflex'], {
                         'PronType': ['Prs'],

From 89e110b6531b968ea4c4a737c530dee0727ccba1 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 4 Mar 2026 18:29:38 +0100
Subject: [PATCH 1362/1374] =?UTF-8?q?"tv=C5=AFj=C5=BEto"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 5a18acf7..42c2567d 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -504,7 +504,7 @@ def process_node(self, node):
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
-            elif re.match(r'^(můj|tvůj|svůj)(ž(e|to)?)$', node.lemma):
+            elif re.match(r'^(můj|tvůj|svůj)(ž(e|to)?)?$', node.lemma):
                 if node.feats['Reflex'] == 'Yes':
                     self.check_adjective_like(node, ['PronType', 'Poss', 'Reflex'], {
                         'PronType': ['Prs'],

From 7e1de7a44495c9758839186b5a85efb8d6cae06c Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Thu, 5 Mar 2026 10:47:42 +0100
Subject: [PATCH 1363/1374] =?UTF-8?q?Splitting=20"daj=C5=BEto".?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/addmwt.py | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 7edaca2c..2caa8f3c 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -158,6 +158,22 @@ def multiword_analysis(self, node):
                     'main':   0,
                     'shape':  'subtree',
                 }
+            # dajžto = dajž + to
+            if subtokens[1] == 'to':
+                if token_from_subtokens != node.form:
+                    logging.warning("Concatenation of MISC 'AddMwt=%s' does not yield the FORM '%s'." % (node.misc['AddMwt'], node.form))
+                    return None
+                node.misc['AddMwt'] = ''
+                return {
+                    'form':   subtokens[0] + ' ' + subtokens[1],
+                    'lemma':  '* ten',
+                    'upos':   '* DET',
+                    'xpos':   '* PDNS4----------',
+                    'feats':  '* Case=Acc|Gender=Neut|Number=Sing|PronType=Dem',
+                    'deprel': '* obj',
+                    'main':   0,
+                    'shape':  'subtree',
+                }
             # Contractions of prepositions and pronouns almost could be processed
             # regardless of AddMwt instructions by the annotator, but we still
             # require it to be on the safe side. For example, both 'přědeň' and

From ae8e4b1de7d6d0470e2e1856f3cc90c2e4a6dba0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 7 Mar 2026 16:30:55 +0100
Subject: [PATCH 1364/1374] =?UTF-8?q?"ob=C3=A9"=20PronType=3DTot?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 42c2567d..32b2f68e 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -599,7 +599,7 @@ def process_node(self, node):
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
-                elif re.match(r'^(dva|oba)$', node.lemma):
+                elif re.match(r'^(dva|oba|dvé|obé)$', node.lemma):
                     self.check_required_features(node, ['NumType', 'NumForm', 'Gender', 'Number', 'Case'])
                     if self.pdt20:
                         self.check_allowed_features(node, {

From 73ad92d1508a257140976588bce5461a0e3b8ed0 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sat, 7 Mar 2026 16:37:42 +0100
Subject: [PATCH 1365/1374] =?UTF-8?q?"dv=C3=A9",=20"ob=C3=A9"=20differentl?=
 =?UTF-8?q?y.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 udapi/block/ud/cs/markfeatsbugs.py | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 32b2f68e..5693cfe1 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -599,7 +599,7 @@ def process_node(self, node):
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                     })
-                elif re.match(r'^(dva|oba|dvé|obé)$', node.lemma):
+                elif re.match(r'^(dva|oba)$', node.lemma):
                     self.check_required_features(node, ['NumType', 'NumForm', 'Gender', 'Number', 'Case'])
                     if self.pdt20:
                         self.check_allowed_features(node, {
@@ -620,6 +620,16 @@ def process_node(self, node):
                             'Number': ['Dual', 'Plur'],
                             'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
                         })
+                elif re.match(r'^(dvé|obé)$', node.lemma):
+                    self.check_required_features(node, ['NumType', 'NumForm', 'Gender', 'Number', 'Case'])
+                    self.check_allowed_features(node, {
+                        'NumType': ['Card'],
+                        'PronType': ['Tot'], # for 'obé'
+                        'NumForm': ['Word'],
+                        'Gender': ['Neut'],
+                        'Number': ['Sing'], # when 'dvé' is subject, the verb is neuter singular
+                        'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins']
+                    })
                 elif node.lemma == 'půl':
                     self.check_required_features(node, ['NumType', 'NumForm'])
                     self.check_allowed_features(node, {

From dc6d24f285d1a9011c17aace180f4abb0b791663 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 8 Mar 2026 19:19:51 +0100
Subject: [PATCH 1366/1374] Ordinal Roman numeral.

---
 udapi/block/ud/cs/markfeatsbugs.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 5693cfe1..49dfd8e4 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -113,6 +113,7 @@ def process_node(self, node):
                     self.check_required_features(node, ['NumType', 'Gender', 'Animacy', 'Number', 'Case'])
                     self.check_allowed_features(node, {
                         'NumType': ['Ord', 'Mult'],
+                        'NumForm': ['Roman'], # NumForm is normally not used with ordinals except when a Roman numeral is clearly ordinal even without context ('XXXIIho')
                         'Gender': ['Masc', 'Fem', 'Neut'],
                         'Animacy': ['Anim', 'Inan'],
                         'Number': ['Sing', 'Dual', 'Plur'],

From 795021482ac6901db405cb8493b1936973c379ae Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 8 Mar 2026 19:24:17 +0100
Subject: [PATCH 1367/1374] Ordinal Roman numeral.

---
 udapi/block/ud/cs/markfeatsbugs.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 49dfd8e4..70053e32 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -126,6 +126,7 @@ def process_node(self, node):
                     self.check_required_features(node, ['NumType', 'Gender', 'Number', 'Case'])
                     self.check_allowed_features(node, {
                         'NumType': ['Ord', 'Mult'],
+                        'NumForm': ['Roman'], # NumForm is normally not used with ordinals except when a Roman numeral is clearly ordinal even without context ('XXXIIho')
                         'Gender': ['Masc', 'Fem', 'Neut'],
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Voc', 'Loc', 'Ins'],

From 7f04a555cf1041d3117b193f7679669d17c2523b Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Mon, 9 Mar 2026 14:04:16 +0100
Subject: [PATCH 1368/1374] "ledacos"

---
 udapi/block/ud/cs/markfeatsbugs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 70053e32..09bccbb1 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -296,7 +296,7 @@ def process_node(self, node):
                     'Animacy': ['Anim'],
                     'Case': ['Nom', 'Gen', 'Dat', 'Acc', 'Loc', 'Ins']
                 })
-            elif re.match(r'^(co(si?)?|což|což?koliv?|něco|lečco|lecco|nic|nicož)$', node.lemma):
+            elif re.match(r'^(co(si?)?|což|což?koliv?|něco|lečco|lecco|ledacos?|nic|nicož)$', node.lemma):
                 # Although these pronouns behave by default as neuter singular,
                 # no Gender and Number is annotated. However, quite unusually,
                 # there is Animacy=Inan without Gender.

From b18beb299599b1d00ef4fc21efbaed5dfba1d820 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Tue, 17 Mar 2026 09:01:46 +0100
Subject: [PATCH 1369/1374] =?UTF-8?q?Indicative=20can=20have=20-=C5=BE=20a?=
 =?UTF-8?q?s=20well.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

"On, učiniž sa králem, nepřítelem učiněn jest ne králem."
---
 udapi/block/ud/cs/markfeatsbugs.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/udapi/block/ud/cs/markfeatsbugs.py b/udapi/block/ud/cs/markfeatsbugs.py
index 09bccbb1..da9f5bda 100644
--- a/udapi/block/ud/cs/markfeatsbugs.py
+++ b/udapi/block/ud/cs/markfeatsbugs.py
@@ -741,7 +741,8 @@ def process_node(self, node):
                         'Person': ['1', '2', '3'],
                         'Number': ['Sing', 'Dual', 'Plur'],
                         'Polarity': ['Pos', 'Neg'],
-                        'Variant': ['Short', 'Long'] # distinguishes sigmatic (Long) and asigmatic (Short) aorist
+                        'Variant': ['Short', 'Long'], # distinguishes sigmatic (Long) and asigmatic (Short) aorist
+                        'Emph': ['Yes']
                     })
             elif node.feats['VerbForm'] == 'Part': # only l-participle; the others are ADJ, not VERB
                 if node.feats['Gender'] == 'Masc':

From 38dd1d9aa54859a80a1e73927e6f950edb1ebb47 Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Wed, 18 Mar 2026 09:23:57 +0100
Subject: [PATCH 1370/1374] Comment.

---
 udapi/block/ud/cs/addmwt.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/udapi/block/ud/cs/addmwt.py b/udapi/block/ud/cs/addmwt.py
index 2caa8f3c..a690c95b 100644
--- a/udapi/block/ud/cs/addmwt.py
+++ b/udapi/block/ud/cs/addmwt.py
@@ -59,6 +59,7 @@
         'shape': 'subtree',
     }
 # In 19th century texts (Hičkok etalon), one instance of 'seč' was also split (and annotated as ADP + accusative!)
+# A few additional instances were found in older texts, too (e.g. 16th century).
 # We must do it separately, as the preposition is vocalized.
 MWTS['seč'] = {
     'form': 'se' + ' co',

From 4b2cfcaf5e5958201a84522f54ad124047e08d47 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Fri, 17 Apr 2026 20:00:41 +0200
Subject: [PATCH 1371/1374] corefud.Stats: add options report_words_per_doc and
 report_entity_range

---
 udapi/block/corefud/stats.py | 86 ++++++++++++++++++++++++++++--------
 1 file changed, 67 insertions(+), 19 deletions(-)

diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
index 5368cabc..df316242 100644
--- a/udapi/block/corefud/stats.py
+++ b/udapi/block/corefud/stats.py
@@ -6,7 +6,8 @@ class Stats(Block):
 
     def __init__(self, m_len_max=5, e_len_max=5,
                  report_basics=False, report_mentions=True, report_entities=True,
-                 report_details=True, selected_upos='NOUN PRON PROPN DET ADJ VERB ADV NUM _',
+                 report_details=True, report_words_per_doc=False, report_entity_range=True,
+                 selected_upos='NOUN PRON PROPN DET ADJ VERB ADV NUM _',
                  exclude_singletons=False, exclude_nonsingletons=False, style='human',
                  per_doc=False, max_rows_per_page=50, docname='newdoc', docname_len=15,
                  **kwargs):
@@ -17,6 +18,8 @@ def __init__(self, m_len_max=5, e_len_max=5,
         self.report_mentions = report_mentions
         self.report_entities = report_entities
         self.report_details = report_details
+        self.report_words_per_doc = report_words_per_doc
+        self.report_entity_range = report_entity_range
         self.exclude_singletons = exclude_singletons
         self.exclude_nonsingletons = exclude_nonsingletons
         self.style = style
@@ -40,10 +43,17 @@ def __init__(self, m_len_max=5, e_len_max=5,
         self.longest_entity = 0
         self.m_words = 0
         self.selected_upos = None if selected_upos == 'all' else selected_upos.split()
+        self.entity_ranges = []
 
     def process_document(self, doc):
         self.total_nodes += len(list(doc.nodes))
         self.counter['documents'] += 1
+        node2docord, current_docord = {}, 0
+        if self.report_entity_range:
+            for node in doc.nodes_and_empty:
+                node2docord[node] = current_docord
+                current_docord += 1
+
         for entity in doc.coref_entities:
             len_mentions = len(entity.mentions)
             if len_mentions == 1:
@@ -52,6 +62,7 @@ def process_document(self, doc):
                 continue
             elif len_mentions > 1 and self.exclude_nonsingletons:
                 continue
+            self.entity_ranges.append(node2docord[entity.mentions[-1].head] - node2docord[entity.mentions[0].head])
             self.longest_entity = max(len_mentions, self.longest_entity)
             self.counter['c_total_len'] += len_mentions
             self.counter[f"c_len_{min(len_mentions, self.e_len_max)}"] += 1
@@ -83,11 +94,17 @@ def process_document(self, doc):
                     self.counter['m_nontreelet'] += 1 if heads > 1 else 0
 
         if self.report_basics:
+            doc_words = 0
             for tree in doc.trees:
-                self.counter['newdocs'] += 1 if tree.newdoc else 0
                 self.counter['sents'] += 1
                 self.counter['words'] += len(tree.descendants)
                 self.counter['empty'] += len(tree.empty_nodes)
+                if tree.newdoc:
+                    self.counter['newdocs'] += 1
+                    if doc_words > self.counter['max_words_per_doc']:
+                        self.counter['max_words_per_doc'] = doc_words
+                    doc_words = 0
+                doc_words += len(tree.descendants)
 
     def after_process_document(self, doc):
         if self.per_doc:
@@ -122,10 +139,13 @@ def process_end(self, skip=True, doc=None):
 
         columns =[ ]
         if self.report_basics:
-            columns += [('docs', f"{self.counter['newdocs']:7,}"),
+            columns += [('docs', f"{self.counter['newdocs']:6,}"),
                         ('sents', f"{self.counter['sents']:7,}"),
-                        ('words', f"{self.counter['words']:7,}"),
+                        ('words', f"{self.counter['words']:9,}"),
                         ('empty', f"{self.counter['empty']:7,}"),]
+            if self.report_words_per_doc:
+                columns += [('max_words/doc', f"{self.counter['max_words_per_doc']:7,}"),
+                            ('words/doc', f"{self.counter['words']/self.counter['newdocs']:7,.0f}"),]
         if self.report_entities:
             columns += [('entities', f"{self.entities:7,}"),
                         ('entities_per1k', f"{1000 * self.entities / total_nodes_nonzero:6.0f}"),
@@ -134,6 +154,10 @@ def process_end(self, skip=True, doc=None):
             for i in range(1, self.e_len_max + 1):
                 percent = 100 * self.counter[f"c_len_{i}"] / entities_nonzero
                 columns.append((f"c_len_{i}{'' if i < self.e_len_max else '+'}", f"{percent:5.1f}"))
+            if self.report_entity_range:
+                self.entity_ranges.sort()
+                percentile = self.entity_ranges[int(0.95 * (len(self.entity_ranges) - 1))]
+                columns += [('entity_range_95percentile', f"{percentile:6,}"),]
         if self.report_mentions:
             columns += [('mentions', f"{self.mentions:7,}"),
                         ('mentions_per1k', f"{1000 * self.mentions / total_nodes_nonzero:6.0f}"),
@@ -155,7 +179,7 @@ def process_end(self, skip=True, doc=None):
                 columns.append(('head_upos=' + upos, f"{100 * self.counter['m_head_upos_' + upos] / mentions_nonzero:5.1f}"))
 
         if self.style.startswith('tex'):
-            print(" & ".join(c[1] for c in columns), end=" \\\\\n")
+            print(" &".join(c[1] for c in columns), end=" \\\\\n")
         elif self.style == 'human':
             for c in columns:
                 print(f"{c[0]:>15} = {c[1].strip():>10}")
@@ -175,20 +199,39 @@ def print_header(self):
                 print(r'\title{Udapi coreference statistics}')
                 print(r'\begin{document}')
         print(r'\def\MC#1#2{\multicolumn{#1}{c}{#2}}')
-        lines = [r'\begin{mypage}\begin{tabular}{@{}l ',
+        lines = [r'\begin{mypage}'+"\n"+r'\begin{tabular}{@{}l ',
                  " " * self.docname_len,
                  ("document" if self.per_doc else "dataset ") + " " * (self.docname_len-8),
                  " " * self.docname_len]
         if self.report_basics:
+            #lines[0] += "rrrr "
+            #lines[1] += r'& \MC{4}{total number of}              '
+            #lines[2] += r'&        &         &         &         '
+            #lines[3] += r'&   docs &   sents &   words & empty n.'
+
+            #lines[0] += "rrrrr "
+            #lines[1] += r'& \MC{5}{number of}                             '
+            #lines[2] += r'& \MC{4}{total}                       & per doc '
+            #lines[3] += r'&  docs &  sents &    words & empty n.& words   '
             lines[0] += "rrrr "
-            lines[1] += r'& \MC{4}{total number of}              '
-            lines[2] += r'&        &         &         &         '
-            lines[3] += r'&   docs &   sents &   words & empty n.'
+            lines[1] += r'& \MC{4}{text size}                  '
+            lines[2] += r'& \MC{4}{total number of}            '
+            lines[3] += r'&  docs &  sents &    words &empty n.'
+            if self.report_words_per_doc:
+                lines[0] += "rr "
+                lines[1] += r'&        &        '
+                lines[2] += r'&\MC{2}{words/doc}'
+                lines[3] += r'&    max &    avg '
         if self.report_entities:
             lines[0] += "rrrr "
-            lines[1] += r'& \MC{4}{entities}                 '
-            lines[2] += r'&  total & per 1k & \MC{2}{length} '
-            lines[3] += r'&  count &  words &    max &  avg. '
+            lines[1] += r'& \MC{4}{entities}              '
+            lines[2] += r'&  total &per 1k &\MC{2}{length}'
+            lines[3] += r'&  count & words &   max &  avg '
+            if self.report_entity_range:
+                lines[0] += "r "
+                lines[1] += r'&       '
+                lines[2] += r'& range '
+                lines[3] += r'& p95   '
             if self.e_len_max:
                 for i in range(1, self.e_len_max + 1):
                     lines[0] += "r"
@@ -198,9 +241,9 @@ def print_header(self):
                 lines[1] += r'& \MC{' + str(self.e_len_max) + r'}{distribution of entity lengths}'
         if self.report_mentions:
             lines[0] += "rrrr "
-            lines[1] += r'& \MC{4}{mentions}                  '
-            lines[2] += r'&   total & per 1k & \MC{2}{length} '
-            lines[3] += r'&   count &  words &    max &  avg. '
+            lines[1] += r'& \MC{4}{mentions}              '
+            lines[2] += r'&  total &per 1k &\MC{2}{length}'
+            lines[3] += r'&  count & words &   max &  avg '
             if self.m_len_max:
                 for i in range(0, self.m_len_max + 1):
                     lines[0] += "r"
@@ -227,12 +270,17 @@ def print_header(self):
         lines[2] += r'\\'
         lines[3] += r'\\\midrule'
         if self.report_basics:
+            lines[1] += r'\cmidrule(lr){2-7}' if self.report_words_per_doc else r'\cmidrule(lr){2-5}'
+            lines[2] += r'\cmidrule(lr){2-5}'
             last_col += 4
-            lines[1] += r'\cmidrule(lr){2-5}'
+            if self.report_words_per_doc:
+                lines[2] += r'\cmidrule(lr){' + f"{last_col+1}-{last_col+2}" + '}'
+                last_col += 2
         if self.report_entities:
-            lines[1] += r'\cmidrule(lr){' + f"{last_col+1}-{last_col+4}" + '}'
+            _cols = 5 if self.report_entity_range else 5
+            lines[1] += r'\cmidrule(lr){' + f"{last_col+1}-{last_col+_cols}" + '}'
             lines[2] += r'\cmidrule(lr){' + f"{last_col+3}-{last_col+4}" + '}'
-            last_col += 4
+            last_col += _cols
             if self.e_len_max:
                 last_col += self.e_len_max
                 lines[1] += r'\cmidrule(lr){6-' + str(last_col) + '}'
@@ -251,6 +299,6 @@ def print_header(self):
     def print_footer(self, end_doc=True):
         if not self.style.startswith('tex-'):
             return
-        print(r'\bottomrule\end{tabular}\end{mypage}')
+        print(r'\bottomrule\end{tabular}'+"\n"+r'\end{mypage}')
         if self.style == 'tex-doc' and end_doc:
             print(r'\end{document}')

From efef2a4c7f9262ec2c8f63891c7273fdd98ae9fc Mon Sep 17 00:00:00 2001
From: Michal Novak <mnovak@ufal.mff.cuni.cz>
Date: Sat, 18 Apr 2026 00:03:36 +0200
Subject: [PATCH 1372/1374] bugfix: do not crash if no coref entity in the
 document

---
 udapi/block/corefud/stats.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
index df316242..8540f484 100644
--- a/udapi/block/corefud/stats.py
+++ b/udapi/block/corefud/stats.py
@@ -156,7 +156,7 @@ def process_end(self, skip=True, doc=None):
                 columns.append((f"c_len_{i}{'' if i < self.e_len_max else '+'}", f"{percent:5.1f}"))
             if self.report_entity_range:
                 self.entity_ranges.sort()
-                percentile = self.entity_ranges[int(0.95 * (len(self.entity_ranges) - 1))]
+                percentile = self.entity_ranges[int(0.95 * (len(self.entity_ranges) - 1))] if self.entity_ranges else 0
                 columns += [('entity_range_95percentile', f"{percentile:6,}"),]
         if self.report_mentions:
             columns += [('mentions', f"{self.mentions:7,}"),

From 5f25304fb57faa48021c13498426da50c6bc9d21 Mon Sep 17 00:00:00 2001
From: Martin Popel <popel@ufal.mff.cuni.cz>
Date: Sat, 18 Apr 2026 07:06:55 +0200
Subject: [PATCH 1373/1374] corefud.Stat updated

---
 udapi/block/corefud/stats.py | 29 +++++++++++++++--------------
 1 file changed, 15 insertions(+), 14 deletions(-)

diff --git a/udapi/block/corefud/stats.py b/udapi/block/corefud/stats.py
index 8540f484..527159e9 100644
--- a/udapi/block/corefud/stats.py
+++ b/udapi/block/corefud/stats.py
@@ -1,15 +1,17 @@
 from udapi.core.block import Block
 from collections import Counter
+import re
 
 class Stats(Block):
     """Block corefud.Stats prints various coreference-related statistics."""
 
     def __init__(self, m_len_max=5, e_len_max=5,
                  report_basics=False, report_mentions=True, report_entities=True,
-                 report_details=True, report_words_per_doc=False, report_entity_range=True,
+                 report_details=True, report_words_per_doc=False, report_entity_range=False,
                  selected_upos='NOUN PRON PROPN DET ADJ VERB ADV NUM _',
                  exclude_singletons=False, exclude_nonsingletons=False, style='human',
                  per_doc=False, max_rows_per_page=50, docname='newdoc', docname_len=15,
+                 highlight_docnames=None,
                  **kwargs):
         super().__init__(**kwargs)
         self.m_len_max = m_len_max
@@ -31,6 +33,7 @@ def __init__(self, m_len_max=5, e_len_max=5,
             raise ValueError(f'Unknown style {style}')
         self.docname = docname
         self.docname_len = docname_len
+        self.highlight_docnames = highlight_docnames
         self._header_printed = False
         self._lines_printed = None
 
@@ -62,7 +65,8 @@ def process_document(self, doc):
                 continue
             elif len_mentions > 1 and self.exclude_nonsingletons:
                 continue
-            self.entity_ranges.append(node2docord[entity.mentions[-1].head] - node2docord[entity.mentions[0].head])
+            if self.report_entity_range:
+                self.entity_ranges.append(node2docord[entity.mentions[-1].head] - node2docord[entity.mentions[0].head])
             self.longest_entity = max(len_mentions, self.longest_entity)
             self.counter['c_total_len'] += len_mentions
             self.counter[f"c_len_{min(len_mentions, self.e_len_max)}"] += 1
@@ -117,6 +121,7 @@ def after_process_document(self, doc):
             self.longest_mention = 0
             self.longest_entity = 0
             self.m_words = 0
+            self.entity_ranges = []
 
     def process_end(self, skip=True, doc=None):
         if not self._lines_printed:
@@ -128,6 +133,10 @@ def process_end(self, skip=True, doc=None):
                 return
             else:
                 docname = doc.meta['loaded_from'] if self.docname == 'filename' else doc[0].trees[0].newdoc
+                if self.style.startswith('tex'):
+                    if self.highlight_docnames and re.search(self.highlight_docnames, docname):
+                        docname = r"\NEW " + docname
+                    docname = docname.replace('_', r'\_')
                 print(f"{docname:{self.docname_len}}", end='&' if self.style.startswith('tex') else '\n')
         elif self.style.startswith('tex-'):
             print(f"{self.counter['documents']:4} documents &")
@@ -151,13 +160,13 @@ def process_end(self, skip=True, doc=None):
                         ('entities_per1k', f"{1000 * self.entities / total_nodes_nonzero:6.0f}"),
                         ('longest_entity', f"{self.longest_entity:6}"),
                         ('avg_entity', f"{self.counter['c_total_len'] / entities_nonzero:5.1f}")]
-            for i in range(1, self.e_len_max + 1):
-                percent = 100 * self.counter[f"c_len_{i}"] / entities_nonzero
-                columns.append((f"c_len_{i}{'' if i < self.e_len_max else '+'}", f"{percent:5.1f}"))
             if self.report_entity_range:
                 self.entity_ranges.sort()
                 percentile = self.entity_ranges[int(0.95 * (len(self.entity_ranges) - 1))] if self.entity_ranges else 0
                 columns += [('entity_range_95percentile', f"{percentile:6,}"),]
+            for i in range(1, self.e_len_max + 1):
+                percent = 100 * self.counter[f"c_len_{i}"] / entities_nonzero
+                columns.append((f"c_len_{i}{'' if i < self.e_len_max else '+'}", f"{percent:5.1f}"))
         if self.report_mentions:
             columns += [('mentions', f"{self.mentions:7,}"),
                         ('mentions_per1k', f"{1000 * self.mentions / total_nodes_nonzero:6.0f}"),
@@ -196,6 +205,7 @@ def print_header(self):
             if self._lines_printed is None:
                 print(r'\documentclass[multi=mypage]{standalone}')
                 print(r'\usepackage[utf8]{inputenc}\usepackage{booktabs}\usepackage{underscore}')
+                print(r'\usepackage[table]{xcolor}\newcommand{\NEW}{\rowcolor{gray!50}}')
                 print(r'\title{Udapi coreference statistics}')
                 print(r'\begin{document}')
         print(r'\def\MC#1#2{\multicolumn{#1}{c}{#2}}')
@@ -204,15 +214,6 @@ def print_header(self):
                  ("document" if self.per_doc else "dataset ") + " " * (self.docname_len-8),
                  " " * self.docname_len]
         if self.report_basics:
-            #lines[0] += "rrrr "
-            #lines[1] += r'& \MC{4}{total number of}              '
-            #lines[2] += r'&        &         &         &         '
-            #lines[3] += r'&   docs &   sents &   words & empty n.'
-
-            #lines[0] += "rrrrr "
-            #lines[1] += r'& \MC{5}{number of}                             '
-            #lines[2] += r'& \MC{4}{total}                       & per doc '
-            #lines[3] += r'&  docs &  sents &    words & empty n.& words   '
             lines[0] += "rrrr "
             lines[1] += r'& \MC{4}{text size}                  '
             lines[2] += r'& \MC{4}{total number of}            '

From 965284fa5fa436cb6d472e71846a89bc66292a1a Mon Sep 17 00:00:00 2001
From: Dan Zeman <zeman@ufal.mff.cuni.cz>
Date: Sun, 19 Apr 2026 22:17:43 +0200
Subject: [PATCH 1374/1374] Heuristics to solve double objects in Spanish and
 Catalan.

---
 udapi/block/ud/fixmultiobjects.py | 37 +++++++++++++++++++++++++++----
 1 file changed, 33 insertions(+), 4 deletions(-)

diff --git a/udapi/block/ud/fixmultiobjects.py b/udapi/block/ud/fixmultiobjects.py
index df7d5a44..485b85f0 100644
--- a/udapi/block/ud/fixmultiobjects.py
+++ b/udapi/block/ud/fixmultiobjects.py
@@ -11,8 +11,37 @@ class FixMultiObjects(Block):
 
     def process_node(self, node):
         objects = [x for x in node.children if x.udeprel == 'obj']
-        # For the moment, we take the dummiest approach possible: The first object survives and all others are forced to a different deprel.
         if len(objects) > 1:
-            objects = objects[1:]
-            for o in objects:
-                o.deprel = 'iobj'
+            subjects = [x for x in node.children if x.udeprel in ['nsubj', 'csubj']]
+            # Some heuristics that could work in AnCora:
+            # If all objects are after the verb, keep the one that is closest to the verb.
+            if objects[0].ord > node.ord:
+                objects = objects[1:]
+                for o in objects:
+                    o.deprel = 'obl:arg'
+                    o.deps[0]['deprel'] = 'obl:arg'
+            elif objects[-1].ord < node.ord:
+                objects = objects[:-1]
+                for o in objects:
+                    o.deprel = 'dislocated'
+                    o.deps[0]['deprel'] = 'dislocated'
+            # ho experimenta tot
+            elif objects[-1].lemma in ['tot', 'todo']:
+                objects[-1].parent = objects[0]
+                objects[-1].deprel = 'nmod'
+                objects[-1].deps[0]['parent'] = objects[0]
+                objects[-1].deps[0]['deprel'] = 'nmod'
+            # X se llama Y
+            elif node.lemma in ['llamar', 'considerar', 'decir', 'denunciar', 'causar', 'escribir', 'hacer', 'rubricar']:
+                objects[-1].deprel = 'xcomp'
+                objects[-1].deps[0]['deprel'] = 'xcomp'
+            elif len(subjects) == 0:
+                objects[0].deprel = 'nsubj'
+                objects[0].deps[0]['deprel'] = 'nsubj'
+            else:
+                objects[0].deprel = 'dislocated'
+                objects[0].deps[0]['deprel'] = 'dislocated'
+            # For the moment, we take the dummiest approach possible: The first object survives and all others are forced to a different deprel.
+            #objects = objects[1:]
+            #for o in objects:
+            #    o.deprel = 'iobj'