pyprocessors-coreference 1.6.22__tar.gz → 1.6.26__tar.gz

{pyprocessors_coreference-1.6.22 → pyprocessors_coreference-1.6.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pyprocessors-coreference
-Version: 1.6.22
+Version: 1.6.26
 Summary: Processor grouping the mentions of the same entity
 Project-URL: Homepage, https://bitbucket.org/kairntech/pyprocessors_coreference
 Author-email: Olivier Terrier <olivier.terrier@kairntech.com>
@@ -77,6 +77,7 @@ Sur chaque annotation d'un label regroupé, il écrit dans `properties` :
 | `entity_group` | l'identifiant du groupe dans le document : `g1`, `g2`… dans l'ordre de première apparition |
 | `canonical_form` | la forme la plus longue du groupe, sans civilité : c'est elle qu'on cherche dans la base de connaissances |
 | `mention_type` | `name` (les périphrases et les pronoms, `nominal` et `pronoun`, viendront avec les paliers 2 et 3) |
+| `family` | la famille du label, par le nom d'un label (`location` pour `afplocation`, `person_family` pour les personnes) : `entityfishing_candidates` peut mapper ce label pour toute la famille |
 | `entity_group_candidates` | seulement sur un nom partiel ambigu : les groupes auxquels il peut appartenir |
 
 Les autres propriétés de l'annotation sont gardées, et traiter deux fois un document
@@ -118,7 +119,7 @@ document = Document(
 | Paramètre | Défaut | Description |
 |-----------|--------|-------------|
 | `labels` | vide | Labels des mentions à regrouper. Vide : tous les labels. |
-| `label_families` | vide | Familles de labels regroupés comme un seul, chaque label associé à sa famille, les labels de même famille regroupés : un autre label (`loc_org` → `organization`) ou un nom libre (`loc_org` → `1`, `organization` → `1`). Un label non déclaré rejoint la famille du label le plus court qui termine son nom. |
+| `label_families` | vide | Familles de labels regroupés comme un seul, chaque label associé à sa famille, les labels de même famille regroupés : un autre label (`loc_org` → `organization`), dont le nom est écrit dans la propriété `family` des mentions. Un label non déclaré rejoint la famille du label le plus court qui termine son nom. |
 | `person_family` | `person` | Famille des noms de personne : ses labels forment un seul groupe, et la règle du nom partiel s'y applique. Un label d'un autre nom la rejoint par `label_families` (`PER` → `person`). |
 | `honorifics` | `M.`, `Mme`, `Dr`, `Mr`… | Civilités ignorées en tête d'un nom de personne. Paramètre avancé. |
 

{pyprocessors_coreference-1.6.22 → pyprocessors_coreference-1.6.26}/README.md

@@ -47,6 +47,7 @@ Sur chaque annotation d'un label regroupé, il écrit dans `properties` :
 | `entity_group` | l'identifiant du groupe dans le document : `g1`, `g2`… dans l'ordre de première apparition |
 | `canonical_form` | la forme la plus longue du groupe, sans civilité : c'est elle qu'on cherche dans la base de connaissances |
 | `mention_type` | `name` (les périphrases et les pronoms, `nominal` et `pronoun`, viendront avec les paliers 2 et 3) |
+| `family` | la famille du label, par le nom d'un label (`location` pour `afplocation`, `person_family` pour les personnes) : `entityfishing_candidates` peut mapper ce label pour toute la famille |
 | `entity_group_candidates` | seulement sur un nom partiel ambigu : les groupes auxquels il peut appartenir |
 
 Les autres propriétés de l'annotation sont gardées, et traiter deux fois un document
@@ -88,7 +89,7 @@ document = Document(
 | Paramètre | Défaut | Description |
 |-----------|--------|-------------|
 | `labels` | vide | Labels des mentions à regrouper. Vide : tous les labels. |
-| `label_families` | vide | Familles de labels regroupés comme un seul, chaque label associé à sa famille, les labels de même famille regroupés : un autre label (`loc_org` → `organization`) ou un nom libre (`loc_org` → `1`, `organization` → `1`). Un label non déclaré rejoint la famille du label le plus court qui termine son nom. |
+| `label_families` | vide | Familles de labels regroupés comme un seul, chaque label associé à sa famille, les labels de même famille regroupés : un autre label (`loc_org` → `organization`), dont le nom est écrit dans la propriété `family` des mentions. Un label non déclaré rejoint la famille du label le plus court qui termine son nom. |
 | `person_family` | `person` | Famille des noms de personne : ses labels forment un seul groupe, et la règle du nom partiel s'y applique. Un label d'un autre nom la rejoint par `label_families` (`PER` → `person`). |
 | `honorifics` | `M.`, `Mme`, `Dr`, `Mr`… | Civilités ignorées en tête d'un nom de personne. Paramètre avancé. |
 

{pyprocessors_coreference-1.6.22 → pyprocessors_coreference-1.6.26}/docs/adr/0001-linking-candidats-entityfishing-decision-jev.md

@@ -29,7 +29,7 @@ date: 2026-09-24
 - `properties.entity_group` : l'identifiant du groupe dans le document ;
 - `properties.canonical_form` : la forme la plus longue du groupe, qui sert au term lookup.
 
-Les règles s'appliquent toujours entre mentions de même label NER :
+Les règles s'appliquent toujours entre mentions de même famille de labels (voir plus bas) :
 - **même surface normalisée → même groupe** ;
 - **PERSON seulement : un nom partiel rejoint un nom complet vu dans le document** (« Macron » rejoint « Emmanuel Macron ») ;
 - **un nom partiel ambigu n'est pas fusionné de force** : avec Emmanuel et Brigitte Macron dans le même texte, « Macron » garde ses deux groupes possibles.
@@ -43,7 +43,12 @@ Il était prévu de l'extraire. **Le palier 1 a finalement réécrit la règle**
 
 ## Ce que le palier 1 fait, et ses limites connues
 
-**Une décision prise en l'écrivant : les labels de personne forment une seule famille.** Dans le pipeline AFP, le NER (`person`) et le lexique AFP (`afpperson`) annotent le **même span**. Grouper strictement par label mettait chaque personne dans deux groupes. Le paramètre `person_labels` désigne ces labels ; s'il est vide, ce sont ceux dont le nom contient « person ». Les autres labels restent groupés par label exact : `location`/`afplocation` et `organization`/`afporganization` ont sans doute le même doublon, et la question reste ouverte.
+**Une décision prise en l'écrivant : on groupe par famille de labels, pas par label exact.** Dans le pipeline AFP, le NER et le lexique AFP annotent le **même span** avec deux labels : `person`/`afpperson`, `location`/`afplocation`, `organization`/`afporganization`. Grouper strictement par label mettait chaque entité dans deux groupes. D'où trois règles :
+- **suffixe** : un label dont le nom finit par un autre label connu est de sa famille (`afplocation` avec `location`) ;
+- **déclaration** : le paramètre `label_families` associe un label à sa famille, un autre label (`loc_org` → `organization`) ; les labels associés à la même valeur forment une famille. C'est un dictionnaire plutôt qu'une liste de lignes, pour que Sherpa propose les labels connus en clé comme en valeur. La famille est donc toujours le nom d'un label : la coreference l'écrit dans la propriété `family` de chaque mention groupée, et `entityfishing_candidates` peut mapper ce label pour toute la famille ;
+- **personnes** : le paramètre `person_family` (par défaut `person`) désigne la famille des noms de personne, la seule où s'appliquent le nom partiel et le retrait des civilités. `person` et `afpperson` y entrent par suffixe, `PER` par `label_families` (`PER` → `person`).
+
+Un premier jet avait un paramètre `person_labels` (vide : les labels dont le nom contient « person »), et groupait les autres labels par label exact. `label_families` le rendait redondant : il a été remplacé par `person_family`.
 
 **Ce qu'est une « fin de nom ».** Le nom partiel rejoint le nom complet si ses mots sont **exactement les derniers mots** du nom complet. La comparaison se fait mot à mot, après normalisation (casse, espaces, apostrophes, civilités), jamais sur une partie de mot :
 

{pyprocessors_coreference-1.6.22 → pyprocessors_coreference-1.6.26}/docs/sherpa/coreference.en.md

@@ -36,6 +36,7 @@ The processor neither creates nor removes annotations. It adds **properties** to
 | `entity_group` | the group identifier, the same for all the mentions of an entity in the document, numbered in order of appearance | `g1` |
 | `canonical_form` | the longest form of the group, without title: the most words, then the most characters | `Emmanuel Macron` |
 | `mention_type` | the type of mention, always `name` | `name` |
+| `family` | the family of the label, by the name of a label: the one the linking step may map for the whole family | `location` for `afplocation` |
 | `entity_group_candidates` | only for an ambiguous partial name: the groups it could belong to | `["g1", "g2"]` |
 
 Properties the annotation already carried are kept. Processing the same document twice gives the same result.
@@ -47,7 +48,7 @@ Properties the annotation already carried are kept. Processing the same document
 | Parameter | Default | Effect |
 |---|---|---|
 | **Labels** (`labels`) | — (all labels) | Labels of the mentions to group. Annotations of other labels get no property. Empty, all annotations are grouped. |
-| **Label Families** (`label_families`) | — | Families of labels grouped as one, each label mapped to its family, the labels mapped to the same family grouped together: another label (`loc_org` → `organization`) or any name (`loc_org` → `1`, `organization` → `1`).<br/> A label not declared here belongs to the family of the shortest label that ends its name (afplocation with location). |
+| **Label Families** (`label_families`) | — | Families of labels grouped as one, each label mapped to its family, the labels mapped to the same family grouped together: another label (`loc_org` → `organization`), whose name is written in the `family` property of the mentions.<br/> A label not declared here belongs to the family of the shortest label that ends its name (afplocation with location). |
 | **Person Family** (`person_family`) *(advanced)* | `person` | Family of person names: its labels form a single group (`person` and `afpperson`), and only these names benefit from the partial-name rule ("Macron" joins "Emmanuel Macron"). A label of another name joins it through **Label Families** (`PER` → `person`). |
 | **Honorifics** (`honorifics`) *(advanced)* | `["M.", "MM.", "Mme", "Mmes", "Mlle", "Mlles", "Me", "Dr", "Dr.", "Pr", "Pr.", "Mr", "Mr.", "Mrs", …` | Titles ignored in front of a person name, regardless of case. They are not part of the canonical form either. |
 
@@ -96,9 +97,9 @@ Output annotations:
 
 | Annotated text | Label | Score | Properties |
 |---|---|---|---|
-| Emmanuel Macron | `person` | 1.00 | `canonical_form`: Emmanuel Macron<br>`entity_group`: g1<br>`mention_type`: name |
-| M. Macron | `person` | 1.00 | `canonical_form`: Emmanuel Macron<br>`entity_group`: g1<br>`mention_type`: name |
-| Emmanuel | `person` | 1.00 | `canonical_form`: Emmanuel<br>`entity_group`: g2<br>`mention_type`: name |
+| Emmanuel Macron | `person` | 1.00 | `canonical_form`: Emmanuel Macron<br>`entity_group`: g1<br>`family`: person<br>`mention_type`: name |
+| M. Macron | `person` | 1.00 | `canonical_form`: Emmanuel Macron<br>`entity_group`: g1<br>`family`: person<br>`mention_type`: name |
+| Emmanuel | `person` | 1.00 | `canonical_form`: Emmanuel<br>`entity_group`: g2<br>`family`: person<br>`mention_type`: name |
 
 <!-- /generated:example:partial-name -->
 
@@ -126,9 +127,9 @@ Output annotations:
 
 | Annotated text | Label | Score | Properties |
 |---|---|---|---|
-| Emmanuel Macron | `person` | 1.00 | `canonical_form`: Emmanuel Macron<br>`entity_group`: g1<br>`mention_type`: name |
-| Brigitte Macron | `person` | 1.00 | `canonical_form`: Brigitte Macron<br>`entity_group`: g2<br>`mention_type`: name |
-| Macron | `person` | 1.00 | `canonical_form`: Macron<br>`entity_group`: g3<br>`entity_group_candidates`: ["g1", "g2"]<br>`mention_type`: name |
+| Emmanuel Macron | `person` | 1.00 | `canonical_form`: Emmanuel Macron<br>`entity_group`: g1<br>`family`: person<br>`mention_type`: name |
+| Brigitte Macron | `person` | 1.00 | `canonical_form`: Brigitte Macron<br>`entity_group`: g2<br>`family`: person<br>`mention_type`: name |
+| Macron | `person` | 1.00 | `canonical_form`: Macron<br>`entity_group`: g3<br>`entity_group_candidates`: ["g1", "g2"]<br>`family`: person<br>`mention_type`: name |
 
 <!-- /generated:example:ambiguous -->
 
@@ -157,10 +158,10 @@ Output annotations:
 
 | Annotated text | Label | Score | Properties |
 |---|---|---|---|
-| Airbus Defence and Space | `organisation` | 1.00 | `canonical_form`: Airbus Defence and Space<br>`entity_group`: g1<br>`mention_type`: name |
-| AIRBUS | `organisation` | 1.00 | `canonical_form`: AIRBUS<br>`entity_group`: g2<br>`mention_type`: name |
-| George Washington | `person` | 1.00 | `canonical_form`: George Washington<br>`entity_group`: g3<br>`mention_type`: name |
-| Washington | `lieu` | 1.00 | `canonical_form`: Washington<br>`entity_group`: g4<br>`mention_type`: name |
+| Airbus Defence and Space | `organisation` | 1.00 | `canonical_form`: Airbus Defence and Space<br>`entity_group`: g1<br>`family`: organisation<br>`mention_type`: name |
+| AIRBUS | `organisation` | 1.00 | `canonical_form`: AIRBUS<br>`entity_group`: g2<br>`family`: organisation<br>`mention_type`: name |
+| George Washington | `person` | 1.00 | `canonical_form`: George Washington<br>`entity_group`: g3<br>`family`: person<br>`mention_type`: name |
+| Washington | `lieu` | 1.00 | `canonical_form`: Washington<br>`entity_group`: g4<br>`family`: lieu<br>`mention_type`: name |
 
 <!-- /generated:example:other-labels -->
 
@@ -188,9 +189,9 @@ Output annotations:
 
 | Annotated text | Label | Score | Properties |
 |---|---|---|---|
-| PSG *(#1)* | `loc_org` | 1.00 | `canonical_form`: PSG<br>`entity_group`: g1<br>`mention_type`: name |
-| Parc des Princes | `location` | 1.00 | `canonical_form`: Parc des Princes<br>`entity_group`: g2<br>`mention_type`: name |
-| PSG *(#2)* | `organization` | 1.00 | `canonical_form`: PSG<br>`entity_group`: g1<br>`mention_type`: name |
+| PSG *(#1)* | `loc_org` | 1.00 | `canonical_form`: PSG<br>`entity_group`: g1<br>`family`: organization<br>`mention_type`: name |
+| Parc des Princes | `location` | 1.00 | `canonical_form`: Parc des Princes<br>`entity_group`: g2<br>`family`: location<br>`mention_type`: name |
+| PSG *(#2)* | `organization` | 1.00 | `canonical_form`: PSG<br>`entity_group`: g1<br>`family`: organization<br>`mention_type`: name |
 
 <!-- /generated:example:label-families -->
 
@@ -217,7 +218,7 @@ Output annotations:
 
 | Annotated text | Label | Score | Properties |
 |---|---|---|---|
-| Emmanuel Macron | `person` | 1.00 | `canonical_form`: Emmanuel Macron<br>`entity_group`: g1<br>`mention_type`: name |
+| Emmanuel Macron | `person` | 1.00 | `canonical_form`: Emmanuel Macron<br>`entity_group`: g1<br>`family`: person<br>`mention_type`: name |
 | Washington | `lieu` | 1.00 | — |
 
 <!-- /generated:example:labels -->
@@ -245,8 +246,8 @@ Output annotations:
 
 | Annotated text | Label | Score | Properties |
 |---|---|---|---|
-| Emmanuel Macron | `PER` | 1.00 | `canonical_form`: Emmanuel Macron<br>`entity_group`: g1<br>`mention_type`: name |
-| Macron | `PER` | 1.00 | `canonical_form`: Emmanuel Macron<br>`entity_group`: g1<br>`mention_type`: name |
+| Emmanuel Macron | `PER` | 1.00 | `canonical_form`: Emmanuel Macron<br>`entity_group`: g1<br>`family`: person<br>`mention_type`: name |
+| Macron | `PER` | 1.00 | `canonical_form`: Emmanuel Macron<br>`entity_group`: g1<br>`family`: person<br>`mention_type`: name |
 
 <!-- /generated:example:person-family -->
 

{pyprocessors_coreference-1.6.22 → pyprocessors_coreference-1.6.26}/docs/sherpa/coreference.fr.md

@@ -36,6 +36,7 @@ Le processeur ne crée ni ne supprime d'annotation. Il ajoute des **propriétés
 | `entity_group` | l'identifiant du groupe, le même pour toutes les mentions d'une entité dans le document, numéroté dans l'ordre d'apparition | `g1` |
 | `canonical_form` | la forme la plus longue du groupe, sans civilité : le plus de mots, puis le plus de caractères | `Emmanuel Macron` |
 | `mention_type` | le type de mention, toujours `name` | `name` |
+| `family` | la famille du label, par le nom d'un label : celui que l'étape de linking peut mapper pour toute la famille | `location` pour `afplocation` |
 | `entity_group_candidates` | seulement pour un nom partiel ambigu : les groupes auxquels il pourrait appartenir | `["g1", "g2"]` |
 
 Les propriétés que l'annotation portait déjà sont conservées. Traiter deux fois le même document donne le même résultat.
@@ -47,7 +48,7 @@ Les propriétés que l'annotation portait déjà sont conservées. Traiter deux
 | Paramètre | Valeur par défaut | Effet |
 |---|---|---|
 | **Labels** (`labels`) | — (tous les labels) | Labels des mentions à regrouper. Les annotations des autres labels ne reçoivent aucune propriété. Vide, toutes les annotations sont regroupées. |
-| **Label Families** (`label_families`) | — | Familles de labels regroupés comme un seul, chaque label associé à sa famille, les labels de même famille regroupés : un autre label (`loc_org` → `organization`) ou un nom libre (`loc_org` → `1`, `organization` → `1`). Un label non déclaré ici rejoint la famille du label le plus court qui termine son nom (`afplocation` avec `location`). |
+| **Label Families** (`label_families`) | — | Familles de labels regroupés comme un seul, chaque label associé à sa famille, les labels de même famille regroupés : un autre label (`loc_org` → `organization`), dont le nom est écrit dans la propriété `family` des mentions. Un label non déclaré ici rejoint la famille du label le plus court qui termine son nom (`afplocation` avec `location`). |
 | **Person Family** (`person_family`) *(avancé)* | `person` | Famille des noms de personne : ses labels forment un seul groupe (`person` et `afpperson`), et seuls ces noms bénéficient de la règle du nom partiel (« Macron » rejoint « Emmanuel Macron »). Un label d'un autre nom la rejoint par **Label Families** (`PER` → `person`). |
 | **Honorifics** (`honorifics`) *(avancé)* | `["M.", "MM.", "Mme", "Mmes", "Mlle", "Mlles", "Me", "Dr", "Dr.", "Pr", "Pr.", "Mr", "Mr.", "Mrs", …` | Civilités ignorées devant un nom de personne, sans tenir compte des majuscules. Elles ne figurent pas non plus dans la forme canonique. |
 
@@ -96,9 +97,9 @@ Annotations en sortie :
 
 | Texte annoté | Label | Score | Propriétés |
 |---|---|---|---|
-| Emmanuel Macron | `person` | 1,00 | `canonical_form` : Emmanuel Macron<br>`entity_group` : g1<br>`mention_type` : name |
-| M. Macron | `person` | 1,00 | `canonical_form` : Emmanuel Macron<br>`entity_group` : g1<br>`mention_type` : name |
-| Emmanuel | `person` | 1,00 | `canonical_form` : Emmanuel<br>`entity_group` : g2<br>`mention_type` : name |
+| Emmanuel Macron | `person` | 1,00 | `canonical_form` : Emmanuel Macron<br>`entity_group` : g1<br>`family` : person<br>`mention_type` : name |
+| M. Macron | `person` | 1,00 | `canonical_form` : Emmanuel Macron<br>`entity_group` : g1<br>`family` : person<br>`mention_type` : name |
+| Emmanuel | `person` | 1,00 | `canonical_form` : Emmanuel<br>`entity_group` : g2<br>`family` : person<br>`mention_type` : name |
 
 <!-- /generated:example:partial-name -->
 
@@ -126,9 +127,9 @@ Annotations en sortie :
 
 | Texte annoté | Label | Score | Propriétés |
 |---|---|---|---|
-| Emmanuel Macron | `person` | 1,00 | `canonical_form` : Emmanuel Macron<br>`entity_group` : g1<br>`mention_type` : name |
-| Brigitte Macron | `person` | 1,00 | `canonical_form` : Brigitte Macron<br>`entity_group` : g2<br>`mention_type` : name |
-| Macron | `person` | 1,00 | `canonical_form` : Macron<br>`entity_group` : g3<br>`entity_group_candidates` : ["g1", "g2"]<br>`mention_type` : name |
+| Emmanuel Macron | `person` | 1,00 | `canonical_form` : Emmanuel Macron<br>`entity_group` : g1<br>`family` : person<br>`mention_type` : name |
+| Brigitte Macron | `person` | 1,00 | `canonical_form` : Brigitte Macron<br>`entity_group` : g2<br>`family` : person<br>`mention_type` : name |
+| Macron | `person` | 1,00 | `canonical_form` : Macron<br>`entity_group` : g3<br>`entity_group_candidates` : ["g1", "g2"]<br>`family` : person<br>`mention_type` : name |
 
 <!-- /generated:example:ambiguous -->
 
@@ -157,10 +158,10 @@ Annotations en sortie :
 
 | Texte annoté | Label | Score | Propriétés |
 |---|---|---|---|
-| Airbus Defence and Space | `organisation` | 1,00 | `canonical_form` : Airbus Defence and Space<br>`entity_group` : g1<br>`mention_type` : name |
-| AIRBUS | `organisation` | 1,00 | `canonical_form` : AIRBUS<br>`entity_group` : g2<br>`mention_type` : name |
-| George Washington | `person` | 1,00 | `canonical_form` : George Washington<br>`entity_group` : g3<br>`mention_type` : name |
-| Washington | `lieu` | 1,00 | `canonical_form` : Washington<br>`entity_group` : g4<br>`mention_type` : name |
+| Airbus Defence and Space | `organisation` | 1,00 | `canonical_form` : Airbus Defence and Space<br>`entity_group` : g1<br>`family` : organisation<br>`mention_type` : name |
+| AIRBUS | `organisation` | 1,00 | `canonical_form` : AIRBUS<br>`entity_group` : g2<br>`family` : organisation<br>`mention_type` : name |
+| George Washington | `person` | 1,00 | `canonical_form` : George Washington<br>`entity_group` : g3<br>`family` : person<br>`mention_type` : name |
+| Washington | `lieu` | 1,00 | `canonical_form` : Washington<br>`entity_group` : g4<br>`family` : lieu<br>`mention_type` : name |
 
 <!-- /generated:example:other-labels -->
 
@@ -188,9 +189,9 @@ Annotations en sortie :
 
 | Texte annoté | Label | Score | Propriétés |
 |---|---|---|---|
-| PSG *(n°1)* | `loc_org` | 1,00 | `canonical_form` : PSG<br>`entity_group` : g1<br>`mention_type` : name |
-| Parc des Princes | `location` | 1,00 | `canonical_form` : Parc des Princes<br>`entity_group` : g2<br>`mention_type` : name |
-| PSG *(n°2)* | `organization` | 1,00 | `canonical_form` : PSG<br>`entity_group` : g1<br>`mention_type` : name |
+| PSG *(n°1)* | `loc_org` | 1,00 | `canonical_form` : PSG<br>`entity_group` : g1<br>`family` : organization<br>`mention_type` : name |
+| Parc des Princes | `location` | 1,00 | `canonical_form` : Parc des Princes<br>`entity_group` : g2<br>`family` : location<br>`mention_type` : name |
+| PSG *(n°2)* | `organization` | 1,00 | `canonical_form` : PSG<br>`entity_group` : g1<br>`family` : organization<br>`mention_type` : name |
 
 <!-- /generated:example:label-families -->
 
@@ -217,7 +218,7 @@ Annotations en sortie :
 
 | Texte annoté | Label | Score | Propriétés |
 |---|---|---|---|
-| Emmanuel Macron | `person` | 1,00 | `canonical_form` : Emmanuel Macron<br>`entity_group` : g1<br>`mention_type` : name |
+| Emmanuel Macron | `person` | 1,00 | `canonical_form` : Emmanuel Macron<br>`entity_group` : g1<br>`family` : person<br>`mention_type` : name |
 | Washington | `lieu` | 1,00 | — |
 
 <!-- /generated:example:labels -->
@@ -245,8 +246,8 @@ Annotations en sortie :
 
 | Texte annoté | Label | Score | Propriétés |
 |---|---|---|---|
-| Emmanuel Macron | `PER` | 1,00 | `canonical_form` : Emmanuel Macron<br>`entity_group` : g1<br>`mention_type` : name |
-| Macron | `PER` | 1,00 | `canonical_form` : Emmanuel Macron<br>`entity_group` : g1<br>`mention_type` : name |
+| Emmanuel Macron | `PER` | 1,00 | `canonical_form` : Emmanuel Macron<br>`entity_group` : g1<br>`family` : person<br>`mention_type` : name |
+| Macron | `PER` | 1,00 | `canonical_form` : Emmanuel Macron<br>`entity_group` : g1<br>`family` : person<br>`mention_type` : name |
 
 <!-- /generated:example:person-family -->
 

{pyprocessors_coreference-1.6.22 → pyprocessors_coreference-1.6.26}/src/pyprocessors_coreference/__init__.py

@@ -1,3 +1,3 @@
 """Processor grouping the mentions of the same entity"""
 
-__version__ = "1.6.22"
+__version__ = "1.6.26"

{pyprocessors_coreference-1.6.22 → pyprocessors_coreference-1.6.26}/src/pyprocessors_coreference/coreference.py

@@ -15,6 +15,9 @@ DEFAULT_HONORIFICS = ["M.", "MM.", "Mme", "Mmes", "Mlle", "Mlles", "Me", "Dr", "
 ENTITY_GROUP = "entity_group"
 CANONICAL_FORM = "canonical_form"
 MENTION_TYPE = "mention_type"
+# The label family, by name (location for afplocation, person_family for the person labels):
+# the linking step may map a family instead of each of its labels.
+FAMILY = "family"
 # Only on an ambiguous partial name: the groups it may belong to.
 ENTITY_GROUP_CANDIDATES = "entity_group_candidates"
 
@@ -39,16 +42,16 @@ class CoreferenceParameters(ProcessorParameters):
     label_families: dict[str, str] | None = Field(
         None,
         description="""Families of labels grouped as one: each label is mapped to its family, and the labels mapped to the same family
-        are grouped together. The family is another label (loc_org → organization) or any name (loc_org → 1, organization → 1).<br/>
+        are grouped together. The family is another label (loc_org → organization), whose name the linking step may map.<br/>
         A label not declared here belongs to the family of the shortest label that ends its name (afplocation with location).""",
-        json_schema_extra={"extra": "key:label"},
+        json_schema_extra={"extra": "key:label,val:label"},
     )
     person_family: str = Field(
         "person",
         description="""Family of person names: its labels are grouped together (person and afpperson mentions),
         and a partial name ("Macron") joins the full name it ends ("Emmanuel Macron").<br/>
         A label of another name joins it through Label Families (PER → person).""",
-        json_schema_extra={"extra": "advanced"},
+        json_schema_extra={"extra": "label,advanced"},
     )
     honorifics: list[str] = Field(
         DEFAULT_HONORIFICS,
@@ -142,6 +145,7 @@ def group_document(document: Document, params: CoreferenceParameters, honorifics
             properties[ENTITY_GROUP] = group_id[r]
             properties[CANONICAL_FORM] = canonical[r]
             properties[MENTION_TYPE] = "name"
+            properties[FAMILY] = params.person_family.strip().casefold() if r[0] == PERSON_FAMILY else r[0]
             if key in ambiguous:
                 properties[ENTITY_GROUP_CANDIDATES] = sorted((group_id[c] for c in ambiguous[key]), key=lambda g: int(g[1:]))
             else: