netdata#
- jinwu.core.datasets.netdata(source: LightcurveDataBase | PhaBase, background: LightcurveDataBase | PhaBase | None = None, *, ratio: float | None = None, use_exposure_weighted_ratio: bool = True, offset: float = 0.0) LightcurveDataBase[source]#
计算净光变曲线（源 - 背景）
这是核心的背景减除函数，支持 LightcurveData 和未来的 PhaData。 所有减法操作（包括 src - bkg）最终都调用此函数。
参数#
- sourceLightcurveData | OgipData
源光变曲线
- backgroundLightcurveData | OgipData | None
背景光变曲线
- ratiofloat, optional
源背景缩放比例（None 则自动计算）
- use_exposure_weighted_ratiobool, default=True
自动计算时是否使用 (区域面积×曝光时间) 比值
- offsetfloat, default=0.0
额外计数偏移（在计数空间减去）
返回#
- LightcurveData
净光变曲线（若无背景则返回源本身）
示例#
>>> net = netdata(src, bkg) # 自动计算 ratio >>> net = netdata(src, bkg, ratio=1.5) # 手动 ratio >>> net = src - bkg # 等效于 netdata(src, bkg)
说明#
算法流程： 1. 确定 ratio（自动或手动） 2. 对齐时间轴（若需要 rebin 背景） 3. 转换到计数空间（使用 bin_exposure） 4. 执行减法：net = src - ratio * bkg - offset 5. 误差传播：err² = src_err² + (ratio * bkg_err)² 6. 转回原始单位（rate/counts） 7. 零曝光 bin 标记为 NaN