ItemValor
NomeQUANTITY (BIND QUANTITY do documento de especificação)
TAG ID0x066L
Codec ID0x00000660
Documento de especificação0x00000000/codecs/0x00000660/ (alvo do DECLARE 0660)
Seção3 0011 (Value), deslocamento C na seção = 6
KindValue · família: NUMERIC
TAG WORD0000 0110 0110 LLLL (000K KKKC CCCC LLLL)
Descrição no índiceamount como Value numérico (inteiro, BINARY-FLOAT, decimal, fração), Reference da unidade, limites inferior e superior. Unidade e limites podem ser omitidos (ABSENT 0x0000)
Lado Hugovalue/numeric/quantity.md

Campos (documento de especificação)

A ordem dos FIELD no documento é a ordem dos campos do Payload (documento de especificação do Codec).

OrdemCampo (BIND)FIELDLarguraFormato recebido (CODEC)ENUM
1amount#2registro0680 SIGNED-DECIMAL, 0610 SIGNED-INTEGER, 0620 UNSIGNED-INTEGER, 0630 BINARY-FLOAT, 0670 FRACTION, 0690 UNSIGNED-DECIMAL
2unit#3registro000F toda a seção 0 (curinga, Reference), 020F toda a seção 1 (curinga, Reference), 040F toda a seção 2 (curinga, Reference), 0000 ABSENT (campo opcional)
3lower#4registro0680 SIGNED-DECIMAL, 0000 ABSENT (campo opcional), 0610 SIGNED-INTEGER, 0620 UNSIGNED-INTEGER, 0630 BINARY-FLOAT, 0670 FRACTION, 0690 UNSIGNED-DECIMAL
4upper#5registro0680 SIGNED-DECIMAL, 0000 ABSENT (campo opcional), 0610 SIGNED-INTEGER, 0620 UNSIGNED-INTEGER, 0630 BINARY-FLOAT, 0670 FRACTION, 0690 UNSIGNED-DECIMAL

QUANTITY é o Value que representa uma quantidade por número, unidade e limites inferior e superior. É o direct code de Value 0x066L, família NUMERIC. Cada uma das quatro partes é um registro completo. Unidade e limites são campos opcionais, e quando omitidos usa-se ABSENT (0x0000).

Layout

TAG WORD          0000 0110 0110 LLLL      Codec 0x066L
[TAG de extensão de Length] quando o total é de 15 WORD ou mais
amount            registro de Value numérico (inteiro, BINARY-FLOAT, decimal, fração)
unit              registro Reference (item de unidade); 0x0000 se não há unidade
lower             registro de Value numérico; se omitido, 0x0000 ABSENT
upper             registro de Value numérico; se omitido, 0x0000 ABSENT

Interpretação e validade

  • amount é exatamente um registro completo de Value numérico. Os Codec aceitos são seis: SIGNED-INTEGER (0x061L), UNSIGNED-INTEGER (0x062L), BINARY-FLOAT (0x063L), FRACTION (0x067L), SIGNED-DECIMAL (0x068L) e UNSIGNED-DECIMAL (0x069L). A lista é fechada e não é um curinga. BOOL, COORDINATE-EARTH e COORDINATE-GEO, o próprio QUANTITY (aninhamento proibido, profundidade fixa) e os demais Value não são aceitos. Em amount não se pode usar marcador de posição (0x0000 etc.).
  • Os registros internos também seguem a forma canônica de cada Codec (inteiro e coefficient com o mínimo de WORD, BINARY-FLOAT com 1/2/4/8 WORD, FRACTION com as suas regras). Se houver um registro interno não canônico, QUANTITY inteiro é invalid.
  • Se amount, lower ou upper é BINARY-FLOAT, deve ser um valor finito. NaN e ±Infinity são invalid (mesma regra de latitude e longitude de COORDINATE-EARTH).
  • O formato do número segue a notação original. Um original inteiro vai em INTEGER, um original decimal em DECIMAL, um original fracionário em FRACTION e um valor binário IEEE 754 em BINARY-FLOAT, e o codificador não normaliza trocando de formato. C e E de DECIMAL guardam os dígitos da notação original: 1.20 = 120×10^-2, 1.2 = 12×10^-1. Os dois valores são o mesmo número, mas têm algarismos significativos diferentes, portanto são Value diferentes. Não há limite superior para os dígitos de inteiro e coefficient (mínimo de WORD, comprimento variável).
  • unit é exatamente um registro Reference completo ou 0x0000. Pode-se usar qualquer Reference que aponte um item de unidade (a unidade do Wikidata é WIKIDATA-QID). 0x0000 significa sem unidade (contagem, razão, população etc.).
  • lower e upper são, cada um, um registro de um dos mesmos seis Codec de amount ou 0x0000 ABSENT. O marcador de posição só admite a omissão ABSENT. Basta que um dos dois exista. Os Codec dos três números não precisam ser iguais.
  • lower ≤ amount ≤ upper é comparado por valor numérico, não por bytes nem por Codec. Mesmo com tipos diferentes comparam-se como números (ex.: SIGNED-INTEGER 652 e SIGNED-DECIMAL 651.5). FRACTION é comparada como racional exato. Um intervalo simétrico (652 ± 1) também se escreve com limites inferior e superior (651, 653). Como há intervalos assimétricos e de qualquer modo são necessários dois valores, não se define um formato reduzido a um único ±.
  • A unidade faz parte do valor. Não se separa a unidade em QUALIFIER etc. (se separada, não se saberia se 652 é km ou m).
  • Ao extrair o registro amount, ele é por si só um registro de Value independente. Se for preciso o número sem a unidade, usa-se esse registro sem recodificar.
  • Não se guarda o valor convertido para unidades SI. É um valor derivado que se calcula a partir da unidade e da tabela de conversão.
  • O cursor que leu os quatro registros deve coincidir exatamente com o fim do Payload. Qualquer outra forma é invalid.
  • O documento de especificação do geul.org descreve quatro campos de registro: amount (0610, 0620, 0630, 0670, 0680, 0690), unit (000F, 020F, 040F, 0000) e lower e upper (0610, 0620, 0630, 0670, 0680, 0690, 0000) (documento de especificação do Codec).

Comprimento

  • O total é 1 WORD de TAG + (TAG de extensão de Length) + os quatro registros. Um registro inteiro tem 1 WORD de TAG + 1 WORD ou mais de Payload; um registro BINARY-FLOAT tem 2, 3, 5 ou 9 WORD; um registro decimal tem 1 WORD de TAG + 2 de expoente + 1 ou mais de coefficient; um registro FRACTION tem 5 WORD ou mais.
  • Um inteiro pequeno sem unidade nem limites tem 6 WORD e um decimal pequeno tem 8 WORD. A partir de 15 WORD usa-se o comprimento estendido (Registro e TAG WORD).

Exemplo

1.20 sem unidade:

0667 0683 FFFF FFFE 0078 0000 0000 0000
  • TAG 0667 (Codec 0x066L, 8 WORD), amount 0683 FFFF FFFE 0078 (E = -2, C = 120), unit, lower e upper 0000.

Inteiro 42 sem unidade:

0665 0611 002A 0000 0000 0000
  • TAG 0665 (6 WORD), amount 0611 002A (SIGNED-INTEGER 42), unit, lower e upper 0000.

Fração 2/3 sem unidade (dois terços dos direitos de voto presentes):

0668 0674 0611 0002 0621 0003 0000 0000 0000
  • TAG 0668 (9 WORD), amount 0674 0611 0002 0621 0003 (FRACTION 2/3), unit, lower e upper 0000.

652 km, intervalo [651, 653] (km = Q828224):

066E 0011
0683 0000 0000 028C
0142 000C A340
0683 0000 0000 028B
0683 0000 0000 028D
  • O total é de 17 WORD, então LLLL=1110 e o TAG de extensão é 0011.

Correspondência com o Wikidata

  • O datavalue quantity {"amount","unit","lowerBound","upperBound"} → amount, unit, lower, upper. As cadeias de amount e dos limites (+1.20, inclusive notação exponencial) são transportadas para C e E com os mesmos dígitos.
  • Como amount e os limites do Wikidata são cadeias decimais, mesmo os de aparência inteira (+652) são transportados como SIGNED-DECIMAL. A conversão do Wikidata não usa outros Codec numéricos.
  • A unit "1" é sem unidade (0x0000), e http://www.wikidata.org/entity/Qn é WIKIDATA-QID. Outras unidades e números ou limites de formato inadequado não são convertidos e o texto original é preservado em UTF8-TEXT.
  • Amostra do Wikidata (cerca de 42 mil quantity no início do dump): 61% sem unidade, 13% com limites (93% deles simétricos), o amount mais longo com 31 caracteres.

Base normativa

  • Notação decimal e preservação de dígitos: os conceitos de coefficient, exponent e quantum do decimal do IEEE 754-2008 (SIGNED-DECIMAL do GEUL).
  • Modelo de quantidade do Wikidata: QuantityValue do Wikibase DataModel.

Páginas relacionadas

Texto original do documento de especificação

É o documento de especificação 0x00000000/codecs/0x00000660/latest.geul lido com geul show (hexadecimal em maiúsculas).

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000066000000000
BODY
#1 DECLARE 0x0660
#2 FIELD #1 record
#3 FIELD #1 record
#4 FIELD #1 record
#5 FIELD #1 record
#6 BIND #1 "QUANTITY"
#7 BIND #2 "amount"
#8 BIND #3 "unit"
#9 BIND #4 "lower"
#10 BIND #5 "upper"
#11 CODEC #2 0x0680
#12 CODEC #3 0x000F
#33 CODEC #3 0x020F
#34 CODEC #3 0x040F
#13 CODEC #3 0x0000
#14 CODEC #4 0x0680
#15 CODEC #4 0x0000
#16 CODEC #5 0x0680
#17 CODEC #5 0x0000
#18 CODEC #2 0x0610
#19 CODEC #2 0x0620
#20 CODEC #2 0x0630
#21 CODEC #2 0x0670
#22 CODEC #2 0x0690
#23 CODEC #4 0x0610
#24 CODEC #4 0x0620
#25 CODEC #4 0x0630
#26 CODEC #4 0x0670
#27 CODEC #4 0x0690
#28 CODEC #5 0x0610
#29 CODEC #5 0x0620
#30 CODEC #5 0x0630
#31 CODEC #5 0x0670
#32 CODEC #5 0x0690