streamobs.background package#
Background generation for stellar stream analysis.
This subpackage provides two complementary pipelines:
Full injection (
BackgroundCatalogInjector): runs a known catalog of true stars or galaxies through the completeStreamInjectorpipeline.Light generation (
LightBackgroundGenerator): samples from precomputed binned color–magnitude distributions stored byBackgroundStorage, giving fast per-pixel background realizations without re-running the full injection.
The top-level Background class wraps both modes and lets users
generate stars-only, galaxies-only, or combined backgrounds.
Typical usage — light method with default bundled resources:
from streamobs.surveys import Survey
from streamobs.background import Background
survey = Survey.load('lsst', release='yr5')
bg = Background(survey, source_type='both', method='light')
catalog = bg.generate(phi1_limits=(-20, 20), phi2_limits=(-2, 2), gc_frame=frame)