GEUL (General Encoding Unified Language) ist eine künstliche Sprache und ein Binärformat, mit denen Menschen und KI eindeutig Informationen austauschen.

Diese Dokumente definieren die Grammatik von GEUL v1. Die aktuelle Fassung ist ein Entwurf vor der Veröffentlichung und kann sich ändern. Die Spezifikation wird unter CC0 1.0 veröffentlicht.

Auf einen Blick

  • Alle Daten sind eine Folge von 16-Bit-Wörtern (WORD). Sie werden in Big-Endian geschrieben.
  • Die Einheit der Daten ist der Record. Ein Record beginnt mit genau einem TAG WORD, und dieses TAG WORD gibt Art und Länge des Records an.
  • Es gibt vier Arten von Records (Kind).
KindAufgabeBeispiel
Referenceverweist auf einen GegenstandWikidata Q42, #7 in diesem Dokument
Valueenthält den Wert selbstDatum, Menge, Text mit Sprachangabe
Edgeverbindet andere Records zu einer Aussage„Q42 ist ein Mensch“, „Der englische Name von Q42 ist Douglas Adams“
Metasagt etwas über das DokumentSpezifikationsfassung, Dokument-ID, Autor, Signatur
  • Die Records stehen in einem Dokument. Ein Dokument gliedert sich wie HTML in HEAD (Meta sowie die Herkunft SOURCE des gesamten Dokuments und deren QUALIFIER) und BODY (Reference, Value, Edge).
  • Ein Dokument wird von einem Issuer (Herausgeber) herausgegeben und für jede Version durch einen Inhaltshash festgelegt. Eine veröffentlichte Version wird nicht geändert.

Entwurfsprinzipien

  1. Überspringen ohne Codebook. Art und Länge eines Records stehen in den 16 Bit des TAG WORD. Auch ein Decoder, der die Deutungsvorschrift (das Codebook) nicht kennt, kann Records zählen und überspringen.
  2. Nicht Tatsachen, sondern Aussagen werden gespeichert. Ein Dokument hält mit Meta und Beleg-Edges fest, von wem, wann und woraus eine Aussage stammt.
  3. Identifiziert wird mit Reference. Man verweist mit einer ID, nicht mit einem Namen. Der Name wird per Edge angehängt.
  4. Veröffentlichtes wird nicht geändert. Korrekturen erscheinen als neue Version. Eine ID innerhalb eines Dokuments bezeichnet über Versionen hinweg denselben Gegenstand.
  5. Platz lassen. Der größte Teil des Bitraums bleibt der Zukunft vorbehalten. Direkte Codes lassen sich nicht zurücknehmen, deshalb werden nur Fälle zugewiesen, deren Häufigkeit bestätigt ist.

Untergeordnete Dokumente

Wer zum ersten Mal liest, folgt der Tabelle von oben nach unten.

DokumentInhalt
Aufbau des RecordsTAG-WORD-Layout, Length, Codec, Erweiterungs-TAG
Issuer und VeröffentlichungIssuer-Stufen, 2-WORD-Zuweisungstabelle, Offenlegung, Signatur, Prüfschlüssel
Veröffentlichungsadresse und VersionslisteID-Notation, Veröffentlichungsadresse, Formatangabe, Issuer-Liste, Versionsliste, Vertrauensebenen
Codec-SpezifikationsdokumentCodebooks, geschrieben mit DECLARE, FIELD, ENUM und CODEC
Allgemeines DokumentDOC, HEAD, BODY, END, Dokument-ID, Inhaltshash, Version und Revision
Code-Indexalle 227 zugewiesenen Plätze, Codec-Tabellen nach Kind und Familie
Abschnittslayout16 Abschnitte und Platzbelegung, zugewiesene und Reserved-Bereiche
Slot-MarkerABSENT, UNKNOWN-VALUE, NO-VALUE, Akzeptanzregeln
ReferenceIdentifikation von Gegenständen, LOCAL, externe Verweise, Quantifier, Slot-Marker
ValueWertfamilien, direkte Codes, Text, Menge, Datum
MetaStruktur, Definition, Herkunft, Abstammung, Verifikation, Richtlinie, IMPORT
EdgeFamilien Aussage, Beleg, Ausführung und TOULMIN; TRIPLE, QUALIFIER, LABEL
TOULMINFamilie aus Beurteilungs- und Ausführungsgraph, Layouts von NODE, LINK und SOURCE
Beispiel: Wikidata-Eintragein Dokument Wort für Wort lesen

Was man ohne Codebook wissen kann

InformationOhne CodebookGrundlage
KindbekanntAbschnitt des TAG WORD, Bereich w >> 9 (Reference 0–2, Value 3 und 4, Edge 5–13, Meta 14 und 15)
Gesamtlänge des Records, Position des nächsten RecordsbekanntLength des TAG WORD
Codec-NummerbekanntTAG WORD (beim Issuer-Format Issuer und Codec-Nummer des Erweiterungs-TAG)
Familie, Klasseteilweise bekanntNur die Familie der direkten Edge-Codes ist an den Bits erkennbar. Direkte Value-Codes, die Familie im Issuer-Format und die Meta-Klasse sind an den Bits nicht erkennbar. Beim Issuer-Format sind Issuer und Codec-Nummer bekannt. Die Meta-Verifikationsklasse erkennt man an C >= 5 (w >= 0x1E50) in Abschnitt 15
Edge Id einer EdgebekanntDie erste Komponente einer Edge (Abschnitte 5–13) ist immer eine LOCAL Reference
Slot-Marker (nicht angegeben, unbekannt, nicht vorhanden)bekanntWORD-Wert 0x0000, 0x0010, 0x0020 (Reference, C < 3, L 0). Slot-Marker
Quantifierbekanntüber den Offset C im Abschnitt: in Abschnitt 0 bei 5 <= C < 30, in Abschnitt 1 bei C < 30 ist es C % 5
TAG-Länge je Codec, Beginn des PayloadunbekanntCodebook
Deutung des Payload, Rolle der Edge-KomponentenunbekanntCodebook
  • Ein Decoder ohne Codebook kann Records überspringen und nach Kind und Codec zählen, aber der Graphstruktur nicht folgen.
  • Jeder Decoder muss die Meta-Klassen Struktur, Definition und IMPORT verarbeiten. Diese Codecs gehören zum GEUL-Kern-Codebook, und der Decoder kennt sie über eine eingebaute Nummerntabelle (Meta).

Codebooks werden als GEUL-Dokumente veröffentlicht (Codec-Spezifikationsdokument). Der Decoder muss deshalb nur das benötigte Spezifikationsdokument beziehen und lesen.

Bereichsstruktur

Die oberen Bits des TAG WORD teilen die Bereiche ein.

PrefixBereichAnteilDefinition
1ferne Zukunft50 %Reserved (ferne Zukunft). Wird nicht verwendet
01Zukunft25 %Reserved (nahe Zukunft). Wird nicht verwendet
001Standard12,5 %offiziell übernommene und betriebene Grammatik
000frei/Vorschlag12,5 %aktuelle Grammatik. Wird sie übernommen, bleibt das Layout unverändert und nur das Prefix wechselt zu 001

Die aktuelle Grammatik liegt vollständig im Bereich 000. Alle TAG WORD dieser Spezifikation beginnen mit 000.

  • Ein v1-Decoder weist TAG WORD ab, deren Prefix nicht 000 ist. Die anderen Bereiche legt eine spätere Fassung fest.
  • Der Bereich 000 ist ein Vorschlagsraum. Derzeit gelten weder Registrierung noch Schutz.