Styxis
Company
Knowledge

정수 결측 표식과 물리값 해독을 열별로 승인하기

전역 mask_and_scale 선택 하나로 서로 다른 변수의 표현 계약을 결정하지 않는다.

한 옵션이 바꾸는 서로 다른 의미

정수 표식 보존과 실수 관측의 scale 해독을 열별 계약으로 분리해야 한 열의 dtype을 지키면서 다른 열의 물리 단위를 잃는 선택을 피할 수 있다. 결측을 NaN으로 표현하는 정책도 가능하다. 먼저 어떤 표현을 약속했는지 정해야 정상 해독을 손상으로 부르거나 단위 손실을 정상화하지 않는다. 변수별로 승인한 표식 표현을 실제 해독 결과와 연결한 표는 Truthound의 비교 입력이 될 수 있다. [1, 2, 3]

변경 채택과 구별한 정책 질문

Xarray #11089는 missing_value가 있는 정수 열이 mask_and_scale에 따라 float·NaN으로 바뀌고 전체 해제는 다른 열의 scale도 끈다는 정책 질문이다. 후속 유지관리자는 현재 동작이 잘못인지 불명확하다며 기존 정책을 유지하고 종료했다. 유지관리자의 종료 설명은 기존 해독이 명백히 잘못됐다는 결론을 지지하지 않는다. 이 글은 결측 표현을 바꾸는 기능 출시나 parser 수정을 보고하지 않는다. [1]

변수별 해독 계약표

관측 담당자는 변수별 원시 dtype·표식·scale·offset·해독 정책을 기록한다. 각 변수의 요구 표현과 실제 해독 표현을 대조하고 전체 해제 전에 물리값 검사를 함께 수행한다. 어떤 표식과 dtype을 유지할지 변수별로 먼저 정한다. 물리값 scale 검사를 위한 원시값과 메타데이터도 별도로 보존한다. [1, 3]

-128을 유지하는 합성 정책

설명용 정수 관측 계약은 int8의 -128을 결측 표식으로 유지한다고 정한다. 기대 표현 sentinel:-128은 승인 정책에서 가져오며 NaN으로 바뀐 표현은 이 정책과 다르다. 실제 표현이 sentinel:-128이면 이 정책을 통과한다. NaN이면 다르므로 별도 승인 전 사용을 보류한다. NaN을 허용하는 다른 계약에는 이 반례를 그대로 적용하지 않는다. [1, 3]

표식 비교가 물리값 검증은 아니다

Truthound Python SDK 3.3.2의 ColumnPairValidator는 운영자가 변수별로 정규화한 actual_missing_representation과 approved_missing_representation을 비교한다. 원시 정수와 실제 해독 결과를 외부에서 수집해야 한다. 표식 일치는 scale·offset 계산의 정확성을 입증하지 않는다. Core는 정규화한 정책 문자열을 비교하며 CF 규약의 유일한 정답이나 parser 동작을 결정하지 않는다. [1, 2, 3]

명시 변환을 선택할 때의 책임

변수별 해독 설정 또는 원시 읽기 후 명시 변환을 검토하되 정수 표식과 실수 물리값을 모두 시험한다. 업무가 정수 표식을 NaN으로 바꾸도록 이미 승인했다면 그 변화는 이 계약의 위반이 아니다. [1, 3]

적용 조건

변수별 원시 dtype·표식·scale·offset과 승인 해독 정책을 함께 보존한다.

대안

변수별 해독 또는 원시 읽기 후 명시 변환을 시험한다.

한계

  • 표식 표현 일치는 물리값 scale·offset의 정확성이나 CF 정책의 유일성을 입증하지 않는다.

근거

사건 확인일
대상 확인일
수정일