varmodel_score — SPC variation op

• 데이터 종류: image2d × table → table

• 호출: import fullseye as fs; fs.ledger.varmodel_score(image, model, mask=None, align='check')(구현을 직접 호출하려면 import varmodel; varmodel.varmodel_score(image, model, mask=None, align='check'), 원장에서 가져오려면 opsspc.get("varmodel_score"))

사용법

한 장을 varmodel_fit 모델에 대조: σ 단위 z 맵·대역 밖 맵·영역별 설명 (table).

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

z = (image - center) / spread on valid pixels (0 elsewhere); a pixel is out of band when |z| > k. Out-of-band pixels are grouped into 8-connected regions; each region reports area, peak_z (signed, the largest |z|), mean_abs_z, polarity (bright / dark / mixed), centroid (row, col), bbox (r0, c0, r1, c1, exclusive end) and peak_pos; regions are sorted by |peak_z| (rounded to 1e-9, ties by label order). Also returns z, exceed, valid (scored pixels, image grid), n_exceed, n_valid, k, far, expected_false = far * n_valid and count_pvalue = P(Binomial(n_valid, far) >= n_exceed) — that p-value assumes independent pixels and is optimistic for spatially correlated noise (reported, not used to decide).

Alignment: the image's translation against the model centre is measured as in varmodel_alignment and returned as offset. align="check" REFUSES an image displaced by more than the model's max_misalign_px; align="translate" registers it to the model by a Fourier shift, computes z in model coordinates and maps z / exceed back onto the image grid by the rounded offset (the wrapped border is invalid), so the maps line up with masks drawn on the original image. mask is on the image grid.

Raises ValueError when image is empty / not 2-D / non-finite, its shape differs from the model, model lacks the fitted keys, mask has the wrong shape, align is unknown, or the image is misaligned (check) / displaced by more than a quarter of the image (translate).

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• poc_good_sample_variation_model — py -3.11 examples/poc_good_sample_variation_model.py

• poc_patch_anomaly — py -3.11 examples/poc_patch_anomaly.py

타입이 이어지는 다음 연산자(table 를 입력으로 받는 것)

msa_anova_table · msa_gauge_rr · msa_bias_linearity · msa_attribute_agreement · gum_standard_uncertainty · gum_propagate · gum_expanded · gum_monte_carlo

같은 카테고리(variation)

varmodel_alignment · varmodel_band_k · varmodel_fit · varmodel_calibrate


*Provenance: varmodel.py — SPC 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.