ItemValue
NameQUALIFIER (specification document BIND QUALIFIER)
TAG ID0x0ABL
Codec ID0x00000AB0
Specification document0x00000000/codecs/0x00000AB0/ (DECLARE target 0AB0)
Section5 0101 (Edge statement), offset within section C = 11
KindEdge · family: statement, group: proposition
TAG WORD0000 1010 1011 LLLL (000K KKKC CCCC LLLL)
Index descriptionOne condition qualifying another Edge’s proposition. Property, Target (Edge Id), Value (a value or an UNKNOWN-VALUE / NO-VALUE marker). It is part of the proposition
Hugo sideedge/qualifier.md

Fields (specification document)

The order of FIELDs in the document is the order of the Payload fields (Codec specification document). The Edge Id of an Edge is not declared as a FIELD.

OrderField (BIND)FIELDWidthAccepted form (CODEC)ENUM
1property#2recordAny record (excluding slot markers)
2target#3record0050 LOCAL
3value#4record000F all of section 0 (wildcard, Reference), 020F all of section 1 (wildcard, Reference), 040F all of section 2 (wildcard, Reference), 060F all of section 3 (wildcard, Value), 080F all of section 4 (wildcard, Value), 0010 UNKNOWN-VALUE, 0020 NO-VALUE

QUALIFIER is a statement Edge that attaches one condition qualifying the proposition held by another Edge (mainly a TRIPLE). Codec 0x0ABL.

It corresponds to one Wikidata qualifier (snak): one property and one value.

Layout

TAG WORD          0000 1010 1011 LLLL
[Length extension TAG]
Edge Id           LOCAL Reference record
Property          Reference record (WIKIDATA-PID, etc.)
Target            LOCAL Reference record (Edge Id of the Edge being qualified)
Value             Reference or Value record, or slot marker 0x0010 UNKNOWN-VALUE / 0x0020 NO-VALUE
  • The order of components is the same as TRIPLE (Property ↔ Predicate, Target ↔ Subject, Value ↔ Object). A decoder reads along the same path. The roles are set by the Codec.

Interpretation and validity

  • Property and Target are each exactly one complete Reference record, and Target is a LOCAL Reference. The geul.org specification document places CODEC LOCAL (0050) on Target. Value is exactly one complete Reference or Value record, or one WORD of slot marker 0x0010 (UNKNOWN-VALUE) or 0x0020 (NO-VALUE). The specification document places CODEC 000F, 020F, 040F (any Reference), 060F, 080F (any Value), 0010, 0020 on Value. ABSENT (0x0000) is not accepted. Property and Target do not accept slot markers. The cursor after reading Value must coincide with the end of the Edge.
  • Target is an Edge Id within the same document. A QUALIFIER is placed in the same document as the Edge it qualifies.
  • If Target is the HEAD SOURCE (the origin of the whole document), the QUALIFIER is also placed in HEAD, after that SOURCE. Every other QUALIFIER is placed in BODY. A QUALIFIER in BODY whose Target is the HEAD SOURCE is invalid.
  • Target may be an Edge other than a TRIPLE. A QUALIFIER attached to a SOURCE qualifies the act of citation (access date, location within the origin, etc.). The meaning of a SOURCE is also the collection of all QUALIFIERs that point to it.
  • A QUALIFIER is part of the proposition. It is not a separate claim about the proposition; it qualifies the conditions under which the proposition holds. The meaning of the target TRIPLE is the collection of all QUALIFIERs that point to it.
    • The provenance of a proposition is written as SOURCE. Properties of the origin node (title, author, etc.) are written as a TRIPLE whose Subject is the origin.
  • There may be several QUALIFIERs with the same Property on the same Target. The order of QUALIFIERs with the same Target is their order in the document (an exception where Edge order carries meaning).

Unknown and none

When the Value of a QUALIFIER is a slot marker, the meaning of that qualification changes. Take end time (P582) as an example.

Attached to the target TRIPLEMeaningIs the proposition still valid now
QUALIFIER P582 #n EDTF("1974")It ended in 1974No
QUALIFIER P582 #n UNKNOWNIt ended. It is not known when (Wikidata somevalue)No
QUALIFIER P582 #n NONEIt is asserted that it has not ended (Wikidata novalue)Yes
no P582 QUALIFIERIt is not known whether it ended (open world)Unknown
  • Dropping the somevalue and novalue of a Wikidata qualifier broadens the proposition. A border TRIPLE whose end-time somevalue is dropped reads as “a border that is still valid”. So they are carried over as markers.
  • UNKNOWN-VALUEs are not regarded as the same value. The comparison result is undetermined.

Examples (non-normative)

Q42 P69 (educated at) Q691283 (St John’s College), 1971-1974.

TRIPLE     #9   P69   Q42  Q691283  rank 0
QUALIFIER  #10  P580  #9   EDTF "1971"
QUALIFIER  #11  P582  #9   EDTF "1974"
  • #10: TAG 1 + Edge Id 2 + Property 2 + Target 2 + Value 3 = 10 WORDs. Value is the EDTF "1971".
0AB9 0051 000A 0191 0244 0051 0009 06E2 3139 3731

The border (P47) between Q30 (United States) and Q34266 (Russian Empire), with an unknown end time. Edge Ids 2060 and 3160.

0AA9 0051 080C 0191 002F 0141 001E 0141 85DA 0000      #2060 TRIPLE P47 Q30 Q34266 normal
0AB7 0051 0C58 0191 0246 0051 080C 0010                #3160 QUALIFIER P582 #2060 UNKNOWN
  • 0AB7 = 000 0101 01011 0111 (section 5): Edge, Codec 0x0ABL, 8 WORDs. TAG 1 + Edge Id 2 + Property P582 (0191 0246) 2 + Target #2060 (0051 080C) 2 + marker 1.

A period is attached to the NO-VALUE TRIPLE #3161 for Q30’s central bank (P1304). It was absent only in 1811-1816.

0AA8 0051 0C59 0191 0518 0141 001E 0020 0000           #3161 TRIPLE P1304 Q30 NONE normal
0AB9 0051 0C5A 0191 0244 0051 0C59 06E2 3138 3131      #3162 QUALIFIER P580 #3161 EDTF("1811")
0AB9 0051 0C5B 0191 0246 0051 0C59 06E2 3138 3136      #3163 QUALIFIER P582 #3161 EDTF("1816")

Related pages

Specification document source

This is the specification document 0x00000000/codecs/0x00000AB0/latest.geul as read with geul show (hexadecimal in uppercase).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000AB000000000
BODY
#1 DECLARE 0x0AB0
#2 FIELD #1 record
#3 FIELD #1 record
#4 FIELD #1 record
#5 BIND #1 "QUALIFIER"
#6 BIND #2 "property"
#7 BIND #3 "target"
#8 BIND #4 "value"
#9 CODEC #3 0x0050
#10 CODEC #4 0x000F
#14 CODEC #4 0x020F
#15 CODEC #4 0x040F
#11 CODEC #4 0x060F
#16 CODEC #4 0x080F
#12 CODEC #4 0x0010
#13 CODEC #4 0x0020