find_visible_stars

luvcam.visibility_checker.find_visible_stars(tle_lines: Sequence[str], obs_time: str | datetime | Date, *, sun_avoid_deg: float = 90.0, limb_avoid_deg: float = 10.0) → List[Dict[str, float]]

Return all stars that satisfy Sun‑avoidance and limb‑clearance.

Parameters

tle_lines

(name, L1, L2) TLE triple.

obs_time

Observation epoch (string, datetime, or ephem.Date).

sun_avoid_deg

Minimum Sun–star separation angle (deg).

limb_avoid_deg

Minimum altitude of star above local horizon (deg).

star_names

Iterable of star names (PyEphem catalogue) to consider.

Returns

list of dict

Each dict has {"name", "magnitude", "sun_sep_deg", "limb_clearance_deg"}, sorted by increasing magnitude (brightest first). Empty list if no star meets the constraints.