UncertainSkyCoords.jl 🌌

Support for SkyCoords.jl coordinates in Uncertain.jl. Includes uncertainty types specific to sky coordinates (circles and ellipses on the celestial sphere) and related functions.

Overview

Uncertainty Types 📍

• UCircle(radius): Circular uncertainty regions with angular radius on the celestial sphere
• UEllipseAAFlat: Axis-aligned elliptical uncertainty regions for locally-flat sky approximations
  • Create with UEllipseAAFlat(; ulon, ulat, lat) or UEllipseAAFlat(; uloncoslat, ulat)
  • Great approximation for small sky regions, but be careful near poles or for large regions
• UEllipseAAFlatExtended: Elliptical uncertainty with additional uniform expansion

Key Functions 🔧

• separation(a, b): Angular separation between coordinates (SkyCoords function overloaded for uncertain coordinates)
• uarea(uncertainty): Calculate the area of uncertainty regions on the celestial sphere
• uboundary(coord, uncertainty): Generate boundary points for visualization
• separation_over_unc(a, b): Ratio of separation to combined uncertainty
• separation_minus_unc(a, b): Separation minus uncertainty (negative indicates overlap)
• is_separation_within_unc(a, b, unc): Test if coordinates are within uncertainty of each other

Plotting Support 📊

Integration with Makie.jl:

• scatter(), lines(), and other plots work seamlessly with uncertain coordinates
• poly() plots visualize uncertainty region shapes

Additional Integrations ⚡

• FlexiJoins: Efficient spatial joins within uncertainty regions: innerjoin((coords_a, coords_b), by_uncertainty(identity))
• SkyCoords functions: Full support for separation(), lon(), lat(), lonlat(), spherical(), cartesian(), vec()

Check docstrings for more details on current functionality.

---

⚠️ Note: The interface may have minor breaking changes in the future; they will have corresponding version bumps.

🔗 Examples: See the astroplots.jl repo for usage examples.