Reference est un enregistrement qui désigne une cible. La cible peut être une entité, un concept, un document ou un autre Edge. On désigne par un ID, non par un nom.

Disposition

TAG WORD          000K KKKC CCCC LLLL      sections 0~2 (0x000L~0x05FL)
[TAG d'extension de Length]
[IMPORT ID]       pour EXTERNAL-POINTER (1/2/4 WORD)
[Issuer]          pour EXTERNAL-ISSUER (2/4/16 WORD)
[ID de document]  pour EXTERNAL-ISSUER (4 WORD)
ID de cible       tout le reste
  • LLLL est le nombre total de WORD, TAG WORD compris, moins 1 (enregistrement et TAG WORD).
  • Reference occupe les sections 0~2 (w < 0x0600), soit 96 places. Section 0, entités : 0x000L~0x01FL ; section 1, EXTERNAL : 0x020L~0x03FL ; section 2, divers : 0x040L~0x05FL.
  • Les Codec s’écrivent selon la table de codes (tableau ci-dessous). Dans le système 5Q, un seul code porte à la fois le système d’identification et la quantification. La quantification de REFERENCE-ISSUER est fixée par le document de l’Issuer.
  • L’ID de cible est un entier non signé big-endian, écrit sur la largeur la plus courte. La largeur est ce qui reste de Length une fois retirés les champs précédents.
  • L’ID de cible 0 s’écrit en 1 WORD 0x0000. Dans les autres cas, on ne place pas de WORD 0x0000 devant.
  • Si la valeur entière est égale, c’est le même ID. La largeur ne fait pas partie de l’ID.
  • Tous les Codec utilisent la largeur la plus courte. Un Codec ne fixe pas la largeur de l’ID de cible.
  • ISSUER-POINTER, DOC-POINTER et CODEC-POINTER ne suivent pas cette disposition. Ils n’ont pas d’ID de cible ; ils ne comportent que l’Issuer (avec l’ID de document, le Codec ID et l’ID de version).
  • REFERENCE-ISSUER ne suit pas non plus cette disposition. Il comprend le TAG, l’Issuer, le numéro de Codec sur 2 WORD, et le Payload. Le Payload est fixé par le document de Codec publié par l’Issuer.

Codec

TAG IDNomClassificationCible
0x000L~0x002Lmarqueur d’emplacementmarqueur d’emplacementNe désigne aucune cible. On n’emploie que le marqueur de 1 WORD : 0x0000 ABSENT (non renseigné), 0x0010 UNKNOWN-VALUE (inconnu), 0x0020 NO-VALUE (aucune valeur)
0x005L~0x009LLOCALdéclarationID émis par ce document
0x00AL~0x00ELGEULdéclarationEntité émise par geul.org
0x00FL~0x013LGEUL-SIDXdéclarationIdentifiant aligné sur le sens, dont les bits portent du sens
0x014L~0x018LWIKIDATA-QIDdéclarationÉlément Wikidata. Entier après Q
0x019L~0x01DLWIKIDATA-PIDdéclarationPropriété Wikidata. Entier après P
0x020L~0x02ELEXTERNAL-POINTER-1/2/4WORDdésignationLOCAL ID d’un document importé par IMPORT
0x02FL~0x03DLEXTERNAL-ISSUER-2/4/16WORDdésignation-déclarationLOCAL ID d’un document publié par un Issuer
0x040LISSUER-POINTERdésignation-déclarationL’Issuer lui-même
0x041LDOC-POINTERdésignation-déclarationUne version d’un document publié par un Issuer
0x042LCODEC-POINTERdésignation-déclarationUne version d’un Codec publié par un Issuer
0x05DL~0x05FLREFERENCE-ISSUER-2/4/16WORDformat d’IssuerDéfini par l’Issuer. La classification et la place de l’ID de cible sont fixées par le document de l’Issuer
  • Reserved : 0x003L~0x004L, 0x01EL~0x01FL (section 0), 0x03EL~0x03FL (section 1), 0x043L~0x05CL (section 2, places pour de nouveaux systèmes d’identification).
  • Le numéro de système se lit à partir de l’offset dans la section C. En section 0, si 5 <= C < 30, c’est le système C / 5 (1~5) ; en section 1, si C < 30, c’est le système 6 + C / 5 (6~11).
SystèmeNomIdentifiedGenericFree-choiceUniversalVariable
1LOCAL0x005L0x006L0x007L0x008L0x009L
2GEUL0x00AL0x00BL0x00CL0x00DL0x00EL
3GEUL-SIDX0x00FL0x010L0x011L0x012L0x013L
4WIKIDATA-QID0x014L0x015L0x016L0x017L0x018L
5WIKIDATA-PID0x019L0x01AL0x01BL0x01CL0x01DL
6EXTERNAL-POINTER-1WORD0x020L0x021L0x022L0x023L0x024L
7EXTERNAL-POINTER-2WORD0x025L0x026L0x027L0x028L0x029L
8EXTERNAL-POINTER-4WORD0x02AL0x02BL0x02CL0x02DL0x02EL
9EXTERNAL-ISSUER-2WORD0x02FL0x030L0x031L0x032L0x033L
10EXTERNAL-ISSUER-4WORD0x034L0x035L0x036L0x037L0x038L
11EXTERNAL-ISSUER-16WORD0x039L0x03AL0x03BL0x03CL0x03DL
  • La déclaration identifie directement la cible par un ID fixé par l’entité qui l’attribue.
  • La désignation désigne un LOCAL d’un document importé par IMPORT ID. La largeur de l’IMPORT ID est fixée par le système : si système − 6 vaut 0, 1, 2, c’est 1, 2, 4 WORD.
  • La désignation-déclaration désigne un autre document et une cible qu’il contient en un seul enregistrement, sans IMPORT. La largeur de l’Issuer d’EXTERNAL-ISSUER est, si système − 9 vaut 0, 1, 2, de 2, 4, 16 WORD.
  • 0x020L~0x03DL (section 1, systèmes 6~11) désignent un LOCAL d’un autre document. Les autres systèmes de déclaration identifient directement la cible (LOCAL de ce document, ID émis). Les pointeurs (section 2, 0x040L~0x042L) désignent l’Issuer, le document ou le Codec eux-mêmes. REFERENCE-ISSUER est en dehors de cette distinction.
  • 0x000L~0x002L sont des codes attribués aux marqueurs d’emplacement et ne servent pas de Reference désignant une cible. Les WORD 0x0000, 0x0010 et 0x0020 (L 0, 1 WORD) sont des marqueurs d’emplacement (0x0000 ABSENT, 0x0010 UNKNOWN-VALUE, 0x0020 NO-VALUE). Un marqueur n’est valide qu’à la place d’un champ d’enregistrement dont la cible CODEC est exactement ce WORD. Les jokers et les champs sans CODEC ne l’acceptent pas, et il est invalid à la place d’un enregistrement HEAD ou BODY et à la place d’un Edge Id. Une forme de TAG avec Payload (L ≥ 1) pour C 0~2 est Reserved.
  • Seuls les codes directs fournis par geul.org et les publications sont sous CC0. On ne place pas en code direct un système d’identification qui n’est pas sous CC0 (WordNet, etc.). La licence d’un format d’Issuer est fixée par cet Issuer.

TAG courants

EnregistrementWORD
LOCAL 10051 0001
LOCAL 655360052 0001 0000
Wikidata Q5 (humain)0141 0005
Wikidata Q6912830142 000A 8C53
Wikidata P31 (instance of)0191 001F
marqueur d’emplacement ABSENT / UNKNOWN-VALUE / NO-VALUE0000 / 0010 / 0020

LOCAL

LOCAL est un ID émis par ce document.

  • Il est unique. Dans un document, un LOCAL ID ne désigne qu’une seule cible.
  • 0 n’est pas attribué. Les ID de cible sont attribués à partir de 1.
  • On recommande d’attribuer en incrémentant (auto increment). La grandeur de l’ID n’a pas de sens.
  • Il désigne la même cible d’une version à l’autre. Un ID supprimé n’est pas réutilisé (révision du document).
  • Pour le désigner depuis l’extérieur du document, le document doit avoir un DOC-ID.
  • Que deux LOCAL ID soient différents ne signifie pas que ce sont des cibles différentes dans la réalité. S’ils sont identiques, on les relie par SAME-NODE ; s’ils sont différents, par DIFFERENT-NODE.

Edge Id

Tout Edge place une Reference LOCAL en premier élément de son Payload. Ce LOCAL ID est l’Edge Id.

  • On peut lire l’Edge Id sans connaître le livre de codes.
  • Le LOCAL à la place de l’Edge Id est une déclaration ; le LOCAL à une autre place de l’Edge est une mention.
  • Pour déclarer un Edge Id, on n’emploie que le LOCAL Identified (0x005L).
  • On désigne un autre Edge par son Edge Id. Un Edge de ce document se désigne par LOCAL, un Edge d’un autre document par une Reference de désignation.

Désigner un autre document

QuoiComment
L’Issuer lui-mêmeISSUER-POINTER (Issuer)
Une version de documentDOC-POINTER (Issuer, ID de document 4 WORD, ID de version 2 WORD). La version 0 est la plus récente
Une version de CodecCODEC-POINTER (Issuer, Codec ID 2 WORD, ID de version 2 WORD). La version 0 est la plus récente
Une cible dans un document publié (la plus récente)EXTERNAL-ISSUER-* (Issuer, ID de document, LOCAL ID)
Une cible dans un document importé (édition fixée)On attribue un IMPORT ID par le Meta IMPORT-DOC et l’on utilise EXTERNAL-POINTER-* (IMPORT ID, LOCAL ID)
  • Un document lui-même, de l’intérieur comme de l’extérieur, ne se désigne que par un DOC-POINTER. Il se désigne lui-même par le DOC-POINTER de son propre DOC-ID. Un document de Codec fait exception : il se désigne par CODEC-POINTER (son DOC-ID est aussi un CODEC-POINTER).
  • EXTERNAL-ISSUER suit la version la plus récente. Pour fixer l’édition, on utilise IMPORT.
  • L’Issuer s’écrit sur la plus courte largeur où la valeur tient (2/4/16 WORD), et l’on choisit le Codec de cette largeur. C’est identique pour EXTERNAL-ISSUER et REFERENCE-ISSUER.
  • L’ID de document 0 de chaque Issuer est réservé au document d’index des termes définis par cet Issuer (outils, rôles, etc.). Le document d’index est recommandé pour tout Issuer et n’est pas obligatoire (Issuer et publication).

Exemple : LOCAL 7 dans le document 0x0000000000000002 de l’Issuer 0x00000002

02F7 0000 0002 0000 0000 0000 0002 0007

Quantifier

C % 5NomSensExemple
0IdentifiedUne entité identifiéeElon Musk, la Corée du Sud
1GenericÉnoncé général sur toute une espèce. Admet des exceptionsLes soldats obéissent aux ordres
2Free-choiceN’importe quelle cible satisfaisant la conditionN’importe quel soldat
3UniversalToutes les cibles dans la portéeTous les soldats
4VariableVariable de discourscette personne, cette femme
  • La quantification ne se lit que dans le système 5Q (systèmes 1~11). Avec l’offset dans la section C, la quantification est C % 5 en section 0 si 5 <= C < 30, et en section 1 si C < 30. Une section compte 32 places ; si l’on divisait par 5 la place de Codec sur 9 bits (w >> 4), la section 1 serait décalée. Les marqueurs (section 0, C < 3) et la section 2 (pointeurs, REFERENCE-ISSUER) n’ont pas de quantification. Le marqueur 0x0010 UNKNOWN-VALUE n’est pas Generic. La quantification de REFERENCE-ISSUER est fixée par le document de Codec publié par l’Issuer.
  • Generic, contrairement à Universal, ne signifie pas que l’énoncé s’applique sans exception à chaque cible individuelle. Une expression définitoire comme qu'est-ce qu'un soldat peut s’écrire en Generic. Si une définition stricte de concept ou de classification est nécessaire, on la concrétise par une relation distincte.
  • La portée de la quantification et sa négation sont fixées non par Reference mais par l’Edge qui l’emploie.
  • Variable est une cible de discours dont on connaît l’espèce mais qui n’est pas encore identifiée.
    • Une variable nommée s’obtient en attachant Variable à un LOCAL. Le même LOCAL ID est la même variable. On relie l’espèce par un Edge.
    • Une variable anonyme s’obtient en attachant Variable à un Codec de déclaration qui désigne l’espèce (GEUL, WIKIDATA-*) (par exemple « président » de Wikidata + Variable). On ne suit pas la coréférence et on ne peut pas la désigner de nouveau. Deux variables anonymes ne sont pas considérées comme la même variable.
    • Quand la cible est confirmée plus tard, on relie la variable à cette cible par SAME-NODE. Toutes les expressions qui désignent la même variable sont alors interprétées ensemble comme cette cible.
    • Que deux variables soient différentes ne signifie pas que leurs cibles réelles sont différentes. S’ils sont identiques, on les relie par SAME-NODE ; s’ils sont différents, par DIFFERENT-NODE.
    • Le Variable des Codec de désignation externe (EXTERNAL-POINTER-, EXTERNAL-ISSUER-) est une variable LOCAL du document désigné.
    • Exemple : dans le président a prononcé un discours, si la personne n’est pas déterminée, on emploie Variable « président ». Pour le mentionner de nouveau, on place un LOCAL Variable et l’on relie l’espèce « président » par un Edge. Si l’on confirme plus tard qu’il s’agit d’Obama, on relie cette variable à Obama Identified par SAME-NODE. Toutes les expressions qui désignent la même variable sont alors interprétées ensemble comme Obama.
  • Exemple : employer Q5 (humain) de Wikidata en Generic donne 0151 0005 (« l’être humain est … »).

REFERENCE-ISSUER

REFERENCE-ISSUER est un format de Reference défini par l’Issuer. Il occupe les trois dernières places de la zone Reference. Sa disposition est la même que celle de ISSUER de Value et d’Edge (enregistrement et TAG WORD).

Disposition

TAG WORD          0000 0101 11WW LLLL      Codec 0x05DL / 0x05EL / 0x05FL (WW = largeur de l'Issuer : 01 2, 10 4, 11 16 WORD)
[TAG d'extension de Length]
Issuer            2/4/16 WORD (la largeur est fixée par le Codec)
Numéro de Codec   2 WORD. Défini par l'Issuer
Payload           Fixé par le document de Codec publié par l'Issuer
CodecNomLargeur de l’Issuer
0x05DLREFERENCE-ISSUER-2WORD2 WORD
0x05ELREFERENCE-ISSUER-4WORD4 WORD
0x05FLREFERENCE-ISSUER-16WORD16 WORD

Interprétation et validité

  • GEUL ne connaît que la frontière du Payload, donnée par Length. On n’interprète pas le Payload sans le livre de codes.
  • Le sens du numéro de Codec et la quantification sont fixés par l’Issuer. Ce qui est désigné est aussi fixé par le document de Codec publié par l’Issuer.
  • Les règles communes des Reference ne s’appliquent pas : largeur minimale de l’ID de cible, notation en 1 WORD de l’ID de cible 0, Quantifier, lecture de la quantification et du système selon l’offset dans la section, classification en déclaration ou désignation, cible désignée.
  • Le numéro de Codec sur 2 WORD est le même que pour ISSUER de Value et d’Edge. S’il manque de numéros, on se fait émettre un Issuer supplémentaire.
  • Un décodeur qui ne connaît pas le format lit jusqu’au Kind, à Length, à l’Issuer et au numéro de Codec, puis saute selon Length.
  • La licence d’un format d’Issuer est fixée par cet Issuer (Issuer et publication).

Pages liées