orca.utils.coordutils

Coordinate utilities for OVRO-LWA observations.

Provides functions for coordinate transformations between celestial and local horizontal coordinate systems, visibility calculations accounting for horizon and mountain obstructions, and sky position utilities.

For image plane pixel coordinates, use FITS headers with astropy.WCS.

Attributes

`OVRO_LWA_LOCATION`
`CAS_A`
`CYG_A`
`TAU_A`
`TAU_BOO`
`MOUNTAIN_AZ_INC`

Functions

`sun_icrs`(→ astropy.coordinates.SkyCoord)
`is_visible`(→ bool)	Check if a source with coord is altitude_limit (default to 5 deg) above the horizon (and optionally the mountains)
`get_altaz_at_ovro`(→ astropy.coordinates.SkyCoord)	Get the AltAz coordinates at OVRO.
`zenith_coord_at_ovro`(→ astropy.coordinates.SkyCoord)	Get the zenith coordinates at OVRO.

Module Contents

orca.utils.coordutils.OVRO_LWA_LOCATION[source]

orca.utils.coordutils.CAS_A[source]

orca.utils.coordutils.CYG_A[source]

orca.utils.coordutils.TAU_A[source]

orca.utils.coordutils.TAU_BOO[source]

orca.utils.coordutils.MOUNTAIN_AZ_INC[source]

orca.utils.coordutils.sun_icrs(utc_time: datetime.datetime) → astropy.coordinates.SkyCoord[source]

orca.utils.coordutils.is_visible(coordinates: astropy.coordinates.SkyCoord | astropy.coordinates.ICRS, utc_time: datetime.datetime, altitude_limit: astropy.units.Quantity = 5 * u.degree, check_mountain: bool = True) → bool[source]

Check if a source with coord is altitude_limit (default to 5 deg) above the horizon (and optionally the mountains)

Parameters:

coordinates – coordinates of the object to check for visibility
utc_time – utc timestamp for the time of observation
altitude_limit – altitude limit above the horizon/mountain top
check_mountain – determines whether to take the altitude of the mountain into account

Returns: whether the coordinate is visible

orca.utils.coordutils.get_altaz_at_ovro(coordinates: astropy.coordinates.SkyCoord, utc_time: datetime.datetime) → astropy.coordinates.SkyCoord[source]

Get the AltAz coordinates at OVRO.

Parameters:

coordinates – coordinates.
utc_time – time of observation.

Returns: SkyCoord that is in AltAz.

orca.utils.coordutils.zenith_coord_at_ovro(utc_time: datetime.datetime) → astropy.coordinates.SkyCoord[source]

Get the zenith coordinates at OVRO.

Parameters:: utc_time – time of observation.

Returns: SkyCoord in ICRS.