| Параметр | Значение |
|---|---|
| Имя | QUANTITY (документ спецификации BIND QUANTITY) |
| TAG ID | 0x066L |
| Codec ID | 0x00000660 |
| Документ спецификации | 0x00000000/codecs/0x00000660/ (цель DECLARE 0660) |
| Раздел | 3 0011 (Value), смещение внутри раздела C = 6 |
| Kind | Value · семейство: NUMERIC |
| TAG WORD | 0000 0110 0110 LLLL (000K KKKC CCCC LLLL) |
| Описание индекса | числовой Value amount (целое, BINARY-FLOAT, десятичное число, дробь), Reference на единицу, нижняя и верхняя границы. Единицу и границы можно опустить (ABSENT 0x0000) |
| На стороне Hugo | value/numeric/quantity.md |
Поля (документ спецификации)
Порядок FIELD внутри документа — это порядок полей Payload (документ спецификации Codec).
| Порядок | Поле (BIND) | FIELD | Ширина | Принимаемый формат (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | amount | #2 | запись | 0680 SIGNED-DECIMAL, 0610 SIGNED-INTEGER, 0620 UNSIGNED-INTEGER, 0630 BINARY-FLOAT, 0670 FRACTION, 0690 UNSIGNED-DECIMAL | |
| 2 | unit | #3 | запись | 000F весь раздел 0 (шаблон, Reference), 020F весь раздел 1 (шаблон, Reference), 040F весь раздел 2 (шаблон, Reference), 0000 ABSENT (необязательное поле) | |
| 3 | lower | #4 | запись | 0680 SIGNED-DECIMAL, 0000 ABSENT (необязательное поле), 0610 SIGNED-INTEGER, 0620 UNSIGNED-INTEGER, 0630 BINARY-FLOAT, 0670 FRACTION, 0690 UNSIGNED-DECIMAL | |
| 4 | upper | #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, либо
0x0000ABSENT. Из маркеров места принимается только пропуск ABSENT. Достаточно одной из двух границ. Codec у трёх чисел могут не совпадать. - lower ≤ amount ≤ upper сравнивается по числовому значению, а не по байтам или Codec. Числа разных типов тоже сравниваются как числа (например, SIGNED-INTEGER
652и SIGNED-DECIMAL651.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(Codec0x066L, 8 WORD), amount0683 FFFF FFFE 0078(E = -2, C = 120), unit·lower·upper0000.
Целое 42 без единицы:
0665 0611 002A 0000 0000 0000
- TAG
0665(6 WORD), amount0611 002A(SIGNED-INTEGER 42), unit·lower·upper0000.
Дробь 2/3 без единицы (две трети голосов присутствующих):
0668 0674 0611 0002 0621 0003 0000 0000 0000
- TAG
0668(9 WORD), amount0674 0611 0002 0621 0003(FRACTION 2/3), unit·lower·upper0000.
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, расширяющий TAG0011.
Соответствие Викиданным
- 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