AstrometryInfo

class sofia_redux.scan.info.astrometry.AstrometryInfo[source]

Bases: InfoBase

Initialize the astrometry information.

The astrometry contains information on the overall astronomical state of an observation such as the equatorial, apparent and horizontal coordinates of the observed source, the location and time of the observation, if the observation is non-sidereal or ground based, and the pointing corrections. Additionally, it contains precession objects for the conversion of apparent coordinates to a defined epoch.

Methods Summary

apply_scan(scan)

Apply parameters taken from a scan to the astrometry.

calculate_apparent()

Calculate the apparent equatorial coordinates.

calculate_equatorial()

Calculate equatorial coordinates from current horizontal coordinates.

calculate_horizontal()

Calculate horizontal coordinates from apparent equatorial coordinates.

calculate_precessions(equinox)

Given an equinox, update the epoch and apparent epoch.

get_native_coordinates()

The native coordinates of the scan astrometry.

get_position_reference([system])

Return position reference in the defined coordinate frame.

precess(epoch[, scan])

Precess equatorial to a new epoch.

set_mjd(mjd)

Set the Modified Julian Date and apply any configuration options.

Methods Documentation

apply_scan(scan)[source]

Apply parameters taken from a scan to the astrometry.

A check is performed to see if the configuration specifies that the source is ‘moving’ and if so, sets the information to reflect this is a non-sidereal observation.

Parameters:
scansofia_redux.scan.scan.scan.Scan

The scan to apply.

Returns:
None
calculate_apparent()[source]

Calculate the apparent equatorial coordinates.

Returns:
None
calculate_equatorial()[source]

Calculate equatorial coordinates from current horizontal coordinates.

Returns:
None
calculate_horizontal()[source]

Calculate horizontal coordinates from apparent equatorial coordinates.

The apparent equatorial coordinates will be calculated from the equatorial coordinates if not available.

Returns:
None
calculate_precessions(equinox)[source]

Given an equinox, update the epoch and apparent epoch.

Parameters:
equinoxint or float or str or Epoch
Returns:
get_native_coordinates()[source]

The native coordinates of the scan astrometry.

The native coordinates returned in this case are horizontal.

Returns:
coordinatesSkyCoord

The native coordinates.

get_position_reference(system=None)[source]

Return position reference in the defined coordinate frame.

By default, the equatorial coordinates are returned, but many other frame systems may be specified. All astropy coordinate frames may be used but may raise conversion errors depending on the type. If an error is encountered during conversion, or the frame system is unavailable, equatorial coordinates will be returned.

Parameters:
systemstr

Name of the coordinate frame. Available values are: {‘horizontal’, ‘native’, ‘focalplane’} and all Astropy frame type names.

Returns:
coordinatesSphericalCoordinates

Coordinates of the specified type.

precess(epoch, scan=None)[source]

Precess equatorial to a new epoch.

Parameters:
epochBaseCoordinateFrame or int or float or str.
scanScan, optional

If provided, precess all integration data.

Returns:
None
set_mjd(mjd)[source]

Set the Modified Julian Date and apply any configuration options.

Parameters:
mjdfloat
Returns:
None