synth op• 資料種類:無 → images(僅由參數決定的運算子 —— 不接受影像或資料輸入)
• 呼叫: import fullseye as fs; fs.ledger.synth_frame_series(shape=(128, 128), n_frames=8, dither_px=1.5, fwhm_px=3.2, fwhm_jitter=0.0, n_cosmic=0, seed=0, **starfield_kw)(要直接呼叫實作,import astrostack; astrostack.synth_frame_series(shape=(128, 128), n_frames=8, dither_px=1.5, fwhm_px=3.2, fwhm_jitter=0.0, n_cosmic=0, seed=0, **starfield_kw);從台帳取用則 opsastrostack.get("synth_frame_series"))
• 經台帳呼叫的回傳值: fullseye.ledger.synth_frame_series(...) 只回傳宣告的 out 型別 images 的值(底層函式還會回傳輔助資訊)。需要被捨棄的部分時,請用 fullseye.ledger.synth_frame_series.raw(...),或直接呼叫 astrostack.synth_frame_series。
• 底層回傳: (frames, truth) -> images
把同一星場重拍 n_frames 次,各自帶不同雜訊與不同抖動。
星的座標、通量在所有幀中相同(固定 field_seed 來重現星的抽取，只改變每次觀測的 seed 與 shift_row / shift_col)，所以對位、疊加、drizzle 的正確答案 1 組就夠。給定 *fwhm_jitter* 時 FWHM 會逐幀擾動 —— 這就是 lucky imaging 的「視相度擾動」條件，保持 0 的話 lucky_select 就沒有挑選的理由了。
抖動是以 dither_px 為半徑的確定性螺旋(將第 i 幀放在 dither_px * (i / (n-1)) 的半徑、黃金角的方向上)。因為不是亂數，改變幀數時排列也保持穩定，圖可以重現。
Returns (frames, truth)：
• frames —— 長度 n_frames 的 list，各元素為 (H, W) float64。就是 images 詞彙本身，所以可以直接傳給疊加 op。
• truth —— 在 synth_starfield 的 truth 上，加上 shifts (N, 2) (各幀的 (dr, dc))與 fwhms (N,)。rows / cols 為抖動前(第 0 幀的位置)。
Raises ValueError：除 synth_starfield 的條件外，*n_frames* 小於 1、*dither_px* 為負、*fwhm_jitter* 為負時。
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• 演算法的正典(作者、年份)與用途見上面的族使用指南。
• astro_stacking — py -3.11 examples/astro_stacking.py
• poc_astro_photometry — py -3.11 examples/poc_astro_photometry.py
images 作為輸入)lucky_select · sigma_clip_stack · drizzle_resample · cosmic_ray_reject_stack · align_frames
synth)*Provenance: astrostack.py — ASTROSTACK 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.