simcal_model — SIMCAL model op

• 資料種類:無 → simmodel(僅由參數決定的運算子 —— 不接受影像或資料輸入)

• 呼叫: import fullseye as fs; fs.ledger.simcal_model(chain=None, knobs=None, scene=None, nuisance=None, noise=None, conditions=None, stochastic=None, label='model') -> 'dict'(要直接呼叫實作,import simcal; simcal.simcal_model(chain=None, knobs=None, scene=None, nuisance=None, noise=None, conditions=None, stochastic=None, label='model') -> 'dict';從台帳取用則 opssimcal.get("simcal_model"))

用法

建立 simmodel:參數為旋鈕(帶單位與範圍)的運算子正向鏈,以及雜訊模型。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

chain — list of steps {"op": name, "args": {...}}; op is any registered fullseye op (e.g. "thin_film_reflectance") or a built-in stage ("stage:gain_offset", "stage:scale", "stage:radial_cos4", "stage:radial_poly", "stage:gaussian_blur", "stage:as_image", "stage:mc_sample"). Step 0 receives scene as its first argument (or nothing when scene is None), each later step the previous output.

knobs — list of dicts {"name", "step" (index or op name), "arg", "lo", "hi", "unit", "scale" ("linear" | "log"), "init", "prior" ((mean, sd) or None), "role" ("gain" | "offset" | None), "fixed" (value or None)}. A knob is bound to one argument of one step; init defaults to the middle of the range (geometric middle on a log scale).

conditions — optional list of {step: {arg: value}} (one output image per

condition: exposures, wavelengths, illumination angles). nuisance — names of knobs that are fitted but not of interest; label names the model in reports. noise / stochastic — see the module docstring.

The model is run once at the initial knobs and refused (ValueError) when a step is unknown, a knob names an argument its op does not take, two knobs bind the same argument, a range is empty or a log range is not positive, or the output is not a finite 2-D array. With no arguments: a demo model (chart -> cos^4 vignetting -> gain/offset, EMVA noise) with synthetic observations attached, ready for simcal_fit.

詳細使用指南

• sim_to_real_calibration 族使用指南

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• poc_pocket_interreflection — py -3.11 examples/poc_pocket_interreflection.py

• poc_simcal_thin_film — py -3.11 examples/poc_simcal_thin_film.py

• simcal_checks_tour — py -3.11 examples/simcal_checks_tour.py

• simcal_tour — py -3.11 examples/simcal_tour.py

型別可銜接的下一個運算子(可接受 simmodel 作為輸入)

simcal_simulate · simcal_observe · simcal_screen · simcal_fit · simcal_validate

同類別(model)

simcal_simulate · simcal_observe


*Provenance: simcal.py — SIMCAL 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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