simcal_model — SIMCAL model op

• Datenarten: keine → simmodel (ein Operator, der allein durch seine Argumente bestimmt ist — er nimmt kein Bild und keine Daten entgegen)

• Aufruf: 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' (die Implementierung direkt: import simcal; simcal.simcal_model(chain=None, knobs=None, scene=None, nuisance=None, noise=None, conditions=None, stochastic=None, label='model') -> 'dict'; aus dem Register: opssimcal.get("simcal_model"))

Verwendung

Baut ein simmodel: eine Vorwärtskette von Ops, deren Argumente Regler mit Einheiten und Bereichen sind, samt Rauschmodell.

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

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.

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie sim_to_real_calibration

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• 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

Typkompatible Folge-Operatoren (nehmen simmodel als Eingabe)

simcal_simulate · simcal_observe · simcal_screen · simcal_fit · simcal_validate

Gleiche Kategorie (model)

simcal_simulate · simcal_observe


*Provenance: simcal.py — SIMCAL Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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