signal op• 数据种类:signal → signal
• 调用: import fullseye as fs; fs.ledger.quantize(x, bits=8, mode='round', dither=None, seed=0)(要直接调用实现,import dsp; dsp.quantize(x, bits=8, mode='round', dither=None, seed=0);从台账取用则 ops1d.get("quantize"))
给出误差模型的标量量化器(可选抖动)。
> 以下的详细说明为原文 —— 摘要与标题已翻译。
*bits* sets the number of levels L = 2**bits over the signal's own min..max range. *mode* is "round" (mid-tread, unbiased) or "truncate" (floor, the convention PIL's posterize and most fixed-point casts use).
The two differ by more than a rounding convention. With step Delta = range/(L-1) both have error variance Delta**2/12, but truncation also carries a mean of -Delta/2, so its mean square error is
truncate: Delta**2/12 + (Delta/2)**2 = Delta**2/3
round: Delta**2/12
— a factor of 4. Anything that measures a level (not just displays it) must round.
*dither* adds noise before quantising so the error stops being a function of the signal: "tpdf" (triangular, the audio standard — two uniform draws summed, so the error's variance no longer depends on the sample value) or "rpdf" (one uniform draw). Dither raises the total error power but removes the correlation that makes quantisation audible as distortion rather than as hiss. seed fixes the draw so the op stays deterministic.
Applicability. (1) The range is taken from *this* signal, so two signals quantised separately do not share a scale. (2) bits=1 with no dither is a comparator, not a quantiser — the error model does not apply. (3) The error model assumes the signal moves by more than a step between samples; on a flat stretch the error is a constant offset, not noise.
• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。
• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。
• 算法的正典(作者、年份)与用途见上面的族使用指南。
• poc_cold_chain_excursion — py -3.11 examples/poc_cold_chain_excursion.py
signal 作为输入)create_funct_1d_array · create_funct_1d_pairs · smooth_funct_1d_gauss · smooth_funct_1d_mean · derivate_funct_1d · integrate_funct_1d · zero_crossings_funct_1d · local_min_max_funct_1d
signal)lowpass · highpass · bandpass · envelope · rms · local_std · companding_mu_law · resample
*Provenance: dsp.py — ONED 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.