ПараметрЗначение
ИмяQUANTITY (документ спецификации BIND QUANTITY)
TAG ID0x066L
Codec ID0x00000660
Документ спецификации0x00000000/codecs/0x00000660/ (цель DECLARE 0660)
Раздел3 0011 (Value), смещение внутри раздела C = 6
KindValue · семейство: NUMERIC
TAG WORD0000 0110 0110 LLLL (000K KKKC CCCC LLLL)
Описание индексачисловой Value amount (целое, BINARY-FLOAT, десятичное число, дробь), Reference на единицу, нижняя и верхняя границы. Единицу и границы можно опустить (ABSENT 0x0000)
На стороне Hugovalue/numeric/quantity.md

Поля (документ спецификации)

Порядок FIELD внутри документа — это порядок полей Payload (документ спецификации Codec).

ПорядокПоле (BIND)FIELDШиринаПринимаемый формат (CODEC)ENUM
1amount#2запись0680 SIGNED-DECIMAL, 0610 SIGNED-INTEGER, 0620 UNSIGNED-INTEGER, 0630 BINARY-FLOAT, 0670 FRACTION, 0690 UNSIGNED-DECIMAL
2unit#3запись000F весь раздел 0 (шаблон, Reference), 020F весь раздел 1 (шаблон, Reference), 040F весь раздел 2 (шаблон, Reference), 0000 ABSENT (необязательное поле)
3lower#4запись0680 SIGNED-DECIMAL, 0000 ABSENT (необязательное поле), 0610 SIGNED-INTEGER, 0620 UNSIGNED-INTEGER, 0630 BINARY-FLOAT, 0670 FRACTION, 0690 UNSIGNED-DECIMAL
4upper#5запись0680 SIGNED-DECIMAL, 0000 ABSENT (необязательное поле), 0610 SIGNED-INTEGER, 0620 UNSIGNED-INTEGER, 0630 BINARY-FLOAT, 0670 FRACTION, 0690 UNSIGNED-DECIMAL

QUANTITY — Value, представляющий одну величину числом, единицей, нижней и верхней границами. Прямой код Value 0x066L, семейство NUMERIC. Каждая из четырёх частей — полная запись. Единица и границы — необязательные поля, поэтому при пропуске пишется ABSENT (0x0000).

Раскладка

TAG WORD          0000 0110 0110 LLLL      Codec 0x066L
[Length-расширяющий TAG] если всего 15 WORD и более
amount            запись числового Value (целое, BINARY-FLOAT, десятичное число, дробь)
unit              запись Reference (элемент-единица), без единицы 0x0000
lower             запись числового Value, при пропуске 0x0000 ABSENT
upper             запись числового Value, при пропуске 0x0000 ABSENT

Интерпретация и действительность

  • amount — одна полная запись числового Value. Принимаемых Codec шесть: SIGNED-INTEGER (0x061L), UNSIGNED-INTEGER (0x062L), BINARY-FLOAT (0x063L), FRACTION (0x067L), SIGNED-DECIMAL (0x068L), UNSIGNED-DECIMAL (0x069L). Список закрытый, шаблона нет. BOOL, COORDINATE-EARTH·COORDINATE-GEO, сам QUANTITY (вложение запрещено, глубина фиксирована) и прочие Value не принимаются. В amount нельзя ставить маркер места (0x0000 и т. п.).
  • Внутренние записи тоже следуют каноническим формам своих Codec (целое и coefficient — минимальной длины в WORD, BINARY-FLOAT — 1/2/4/8 WORD, FRACTION — по своим правилам). Если есть неканоническая внутренняя запись, весь QUANTITY — invalid.
  • Если amount·lower·upper — BINARY-FLOAT, значение должно быть конечным. NaN и ±Infinity — invalid (то же правило, что для широты и долготы в COORDINATE-EARTH).
  • Числовой формат следует исходной записи. Целое в исходнике кладётся в INTEGER, дробное десятичное — в DECIMAL, дробь — в FRACTION, значение IEEE 754 binary — в BINARY-FLOAT; кодировщик не нормализует, меняя формат. C и E в DECIMAL несут число разрядов исходной записи как есть: 1.20 = 120×10^-2, 1.2 = 12×10^-1. Это одно и то же число, но с разным числом значащих цифр, поэтому это разные Value. Верхнего предела числа разрядов целого и coefficient нет (минимальная длина в WORD, переменная длина).
  • unit — это ровно одна полная запись Reference либо 0x0000. Подойдёт любой Reference, указывающий на элемент-единицу (единица Викиданных — WIKIDATA-QID). 0x0000 означает отсутствие единицы (количество, доля, население и т. п.).
  • lower·upper — каждое либо запись одного из шести Codec, что и у amount, либо 0x0000 ABSENT. Из маркеров места принимается только пропуск ABSENT. Достаточно одной из двух границ. Codec у трёх чисел могут не совпадать.
  • lower ≤ amount ≤ upper сравнивается по числовому значению, а не по байтам или Codec. Числа разных типов тоже сравниваются как числа (например, SIGNED-INTEGER 652 и SIGNED-DECIMAL 651.5). FRACTION сравнивается как точное рациональное число. Симметричный диапазон (652 ± 1) тоже записывается двумя границами (651, 653). Асимметричные диапазоны всё равно требуют двух значений, поэтому формата, сводящего их к одному ±, нет.
  • Единица — часть значения. Её не отделяют через QUALIFIER и т. п. (без неё нельзя узнать, 652 — это км или м).
  • Запись amount, если её извлечь, сама по себе является самостоятельной записью Value. Если нужно число без единицы, используется эта запись, перекодировка не нужна.
  • Значение, пересчитанное в единицы SI, не хранится. Это производное значение, вычисляемое по единице и таблице пересчёта.
  • Курсор после чтения четырёх записей должен точно совпасть с концом Payload. Любая другая форма — invalid.
  • Документ спецификации geul.org описывает четыре поля-записи: amount (0610·0620·0630·0670·0680·0690), unit (000F·020F·040F·0000), lower·upper (0610·0620·0630·0670·0680·0690·0000) (документ спецификации Codec).

Длина

  • Общая длина — TAG 1 WORD + (Length-расширяющий TAG) + четыре записи. Запись целого — TAG 1 + Payload от 1 WORD, запись BINARY-FLOAT — 2·3·5·9 WORD, запись десятичного числа — TAG 1 + экспонента 2 + coefficient от 1 WORD, запись FRACTION — от 5 WORD.
  • Малое целое без единицы и границ — 6 WORD, малое десятичное число — 8 WORD. От 15 WORD используется расширенная длина (Запись и TAG WORD).

Пример

1.20 без единицы:

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·upper 0000.

Целое 42 без единицы:

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

Дробь 2/3 без единицы (две трети голосов присутствующих):

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

652 km, диапазон [651, 653] (km = Q828224):

066E 0011
0683 0000 0000 028C
0142 000C A340
0683 0000 0000 028B
0683 0000 0000 028D
  • Всего 17 WORD, поэтому LLLL=1110, расширяющий TAG 0011.

Соответствие Викиданным

  • datavalue quantity {"amount","unit","lowerBound","upperBound"} → amount·unit·lower·upper. Строки amount и границ (+1.20, включая экспоненциальную запись) переносятся в C и E с сохранением числа разрядов.
  • amount и границы в Викиданных — десятичные строки, поэтому даже в целом виде (+652) они переносятся как SIGNED-DECIMAL. Преобразование Викиданных не использует другие числовые Codec.
  • unit "1" — это отсутствие единицы (0x0000), http://www.wikidata.org/entity/Qn — WIKIDATA-QID. Прочие единицы, а также числа и границы неподходящего формата не преобразуются, исходный текст сохраняется как UTF8-TEXT.
  • Выборка Викиданных (около 42 тысяч quantity из начала дампа): без единицы 61%, с границами 13% (из них симметричные 93%), самый длинный amount — 31 символ.

Стандартное обоснование

  • Десятичная запись и сохранение числа разрядов: понятия coefficient·exponent·quantum десятичных чисел IEEE 754-2008 (SIGNED-DECIMAL в GEUL).
  • Модель величин Викиданных: Wikibase DataModel QuantityValue.

Связанные страницы

Исходный текст документа спецификации

Так выглядит документ спецификации 0x00000000/codecs/0x00000660/latest.geul, прочитанный командой geul show (16-ричные цифры в верхнем регистре).

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