simcal_observe — SIMCAL model op

• Data kinds: simmodel × images → simmodel

• Call: import fullseye as fs; fs.ledger.simcal_observe(model=None, images=None, roi=None, align=False, exposure=None, max_shift=8, split='train') -> 'dict' (implementation को सीधे call करना हो तो import simcal; simcal.simcal_observe(model=None, images=None, roi=None, align=False, exposure=None, max_shift=8, split='train') -> 'dict', registry से लेना हो तो opssimcal.get("simcal_observe"))

उपयोग

मापी गई images को simmodel से जोड़ता है: alignment, region of interest और exposure normalisation।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

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.

उपयोग की विस्तृत guide

• sim_to_real_calibration family guide

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• 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

वे अगले ops जिनसे type जुड़ता है (simmodel को input के रूप में लेते हैं)

simcal_simulate · simcal_screen · simcal_fit · simcal_validate

इसी category के (model)

simcal_model · simcal_simulate

*Provenance: simcal.py — SIMCAL operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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