mc_sequential_mean — CONVERGE montecarlo op

• Data kinds: कोई नहीं → table (केवल arguments से तय होने वाला op — यह कोई image या data input नहीं लेता)

• Call: import fullseye as fs; fs.ledger.mc_sequential_mean(sampler='pi', tol=0.01, rel_tol=0.0, confidence=0.95, batch=4096, max_samples=4000000, seed=0, on_fail='raise') -> 'dict' (implementation को सीधे call करना हो तो import converge; converge.mc_sequential_mean(sampler='pi', tol=0.01, rel_tol=0.0, confidence=0.95, batch=4096, max_samples=4000000, seed=0, on_fail='raise') -> 'dict', registry से लेना हो तो opsconverge.get("mc_sequential_mean"))

उपयोग

Sequential Monte Carlo mean: confidence interval tolerance से संकरा होने तक samples जोड़ता है।

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

sampler(rng, n) returns n i.i.d. samples (a 1-D array) — or the built-in "pi" (4 * [u^2 + v^2 <= 1], mean pi). Batch b is drawn from default_rng((seed, b)), so the result is reproducible and does not depend on how many batches came before.

Stops at the first batch boundary, from the second batch on, where the half-width z * s / sqrt(n) <= tol + rel_tol * |mean| (z from confidence; s the running sample standard deviation). This is the fixed-width sequential interval of Chow & Robbins 1965; never stopping inside the first two batches guards against an early, accidentally small variance (raise batch to guard more) — the actual coverage is checked by the gates, not assumed.

Returns mean, se, ci (lower, upper), half_width, n_samples (used), converged and history (n, mean, se per batch). Refusal: max_samples reached first raises NotConvergedError (on_fail="record" returns the record with mean = None and the running values under last_mean / last_se).

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

• convergent_computation 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 करते हैं)

• (अभी कुछ नहीं)

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

—

इसी category के (montecarlo)

mc_photon_slab

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

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