항목값
이름QUANTITY (규격 문서 BIND QUANTITY)
TAG ID0x066L
코덱 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·10진수·분수), 단위 Reference, 하한·상한. 단위·경계는 생략 가능(ABSENT 0x0000)
Hugo 쪽value/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·10진수·분수)
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로 담고, 인코더가 형식을 바꾸어 정규화하지 않는다. DECIMAL의 C와 E는 원래 표기의 자릿수를 그대로 담는다: 1.20 = 120×10^-2, 1.2 = 12×10^-1. 두 값은 같은 수지만 유효숫자가 다르므로 다른 Value다. 정수와 coefficient 자릿수에 상한은 없다(최소 WORD, 가변 길이).
  • unit은 완전한 Reference 레코드 정확히 하나이거나 0x0000이다. 단위 항목을 가리키는 어떤 Reference든 쓸 수 있다(위키데이터 단위는 WIKIDATA-QID). 0x0000은 무단위(개수, 비율, 인구 등)다.
  • lower·upper는 각각 amount와 같은 여섯 Codec 중 하나의 레코드이거나 0x0000 ABSENT다. 자리 표지는 ABSENT 생략만 받는다. 둘 중 하나만 있어도 된다. 세 수의 Codec이 같을 필요는 없다.
  • lower ≤ amount ≤ upper는 바이트나 Codec이 아니라 수치 값으로 비교한다. 타입이 달라도 수로 비교한다(예: SIGNED-INTEGER 652와 SIGNED-DECIMAL 651.5). FRACTION은 정확한 유리수로 비교한다. 대칭 범위(652 ± 1)도 하한·상한 둘로 쓴다(651, 653). 비대칭 범위가 있어 어차피 두 값이 필요하므로 ± 하나로 줄이는 형식은 두지 않는다.
  • 단위는 값의 일부다. 단위를 QUALIFIER 등으로 떼어 내지 않는다(떼면 652가 km인지 m인지 알 수 없다).
  • 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, 10진수 레코드는 TAG 1 + 지수 2 + coefficient 1 WORD 이상, FRACTION 레코드는 5 WORD 이상이다.
  • 무단위·경계 없는 작은 정수는 6 WORD, 작은 10진수는 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(출석 의결권의 3분의 2):

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.

위키데이터 대응

  • quantity datavalue {"amount","unit","lowerBound","upperBound"} → amount·unit·lower·upper. amount와 경계 문자열(+1.20, 지수 표기 포함)은 자릿수 그대로 C와 E로 옮긴다.
  • 위키데이터의 amount·경계는 10진 문자열이므로 정수 모양(+652)이어도 SIGNED-DECIMAL로 옮긴다. 위키데이터 변환은 다른 수치 Codec을 쓰지 않는다.
  • unit "1"은 무단위(0x0000), http://www.wikidata.org/entity/Qn은 WIKIDATA-QID다. 그 밖의 단위, 형식이 맞지 않는 수·경계는 변환하지 않고 원문을 UTF8-TEXT로 보존한다.
  • 위키데이터 표본(덤프 앞부분 quantity 약 4.2만 건): 무단위 61%, 경계 있음 13%(그중 대칭 93%), 가장 긴 amount 31자.

표준 근거

  • 10진 표기와 자릿수 보존: IEEE 754-2008 decimal의 coefficient·exponent·quantum 개념(GEUL SIGNED-DECIMAL).
  • 위키데이터 수량 모델: 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