simcal_observe — SIMCAL model op

• Datenarten: simmodel × images → simmodel

• Aufruf: import fullseye as fs; fs.ledger.simcal_observe(model=None, images=None, roi=None, align=False, exposure=None, max_shift=8, split='train') -> 'dict' (die Implementierung direkt: import simcal; simcal.simcal_observe(model=None, images=None, roi=None, align=False, exposure=None, max_shift=8, split='train') -> 'dict'; aus dem Register: opssimcal.get("simcal_observe"))

Verwendung

Hängt gemessene Bilder an ein simmodel an: Ausrichtung, Region of Interest und Belichtungsnormierung.

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

images — one 2-D array per condition (shape = what the model outputs). align=True registers each image to the simulation at the initial knobs by phase correlation (filters_freq.phase_correlation_fft, integer pixels), shifts it back and masks the wrapped border; a shift larger than max_shift is refused. roi = boolean mask or (row0, row1, col0, col1). exposure = a factor per image to divide by (the noise variance is divided by its square) — refused when the model has a free gain knob: the two scale the same signal. split labels the data train / holdout / locked (the TRAIN / OBSERVED / LOCKED discipline of robust.py). Returns a new simmodel with observed filled (the input is not modified), including data_range.

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_screen · simcal_fit · simcal_validate

Gleiche Kategorie (model)

simcal_model · simcal_simulate


*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.