prepare_background_for_fakeit

jinwu.spectrum.prepare_background_for_fakeit(src_pha: str | Path, bkg_pha: str | Path, out_path: str | Path | None = None, *, ratio: str = 'bkg_over_src', sci_notation: bool = True) → Path

基于源/背景 PHA 的 BACKSCAL 比值，生成供 fakeit 使用的背景文件。

Create a background PHA for fakeit. The ratio parameter controls how the new BACKSCAL is computed:

• "bkg_over_src" (default): BACKSCAL := BACKSCAL_bkg / BACKSCAL_src

• "src_over_bkg": BACKSCAL := BACKSCAL_src / BACKSCAL_bkg

行为 | Behavior - 读取源文件与背景文件的 BACKSCAL；若为列（Type II），取第一行或广播更新。 - 在背景文件的拷贝上，仅更新 BACKSCAL，其余关键字/数据保持不变（附加 HISTORY）。 - 输出文件名默认在原背景文件名后追加 “_for_fakeit”，保留原始扩展名（.pha/.pi/.fits/.fit 等），并与原文件位于同一目录。

参数 | Params - src_pha: 源 PHA 路径（Path 或 str）。 - bkg_pha: 背景 PHA 路径（Path 或 str）。 - out_path: 可选输出路径（Path 或 str）；不提供时自动拼接后缀。 - ratio: "bkg_over_src" 或 "src_over_bkg"。

返回 | Returns - 新背景文件的路径（Path）。