empyrean.transform_coordinates

transform_coordinates(coordinates, target, frame=None, origin=None)[source]

Transform coordinates to a different representation, frame, or origin.

Parameters:

  • coordinates (CartesianCoordinates | KeplerianCoordinates | CometaryCoordinates | SphericalCoordinates) – Input coordinates (quivr table). Angles must be in degrees.

  • target (type[CartesianCoordinates] | type[KeplerianCoordinates] | type[CometaryCoordinates] | type[SphericalCoordinates] | str) – Target coordinate class (e.g. CartesianCoordinates) or a representation name ("cartesian" / "keplerian" / "cometary" / "spherical").

  • frame (Frame | str | None) – Target frame. None keeps the current frame.

  • origin (Origin | str | None) – Target origin. None keeps the current origin.

Return type:

CartesianCoordinates | KeplerianCoordinates | CometaryCoordinates | SphericalCoordinates

Returns:

CartesianCoordinates | KeplerianCoordinates | CometaryCoordinates | SphericalCoordinates – Transformed coordinates with covariance propagated (if present).

Examples

>>> cart = transform_coordinates(cometary_coords, CartesianCoordinates)
>>> kep = transform_coordinates(cart, KeplerianCoordinates, frame=Frame.ICRF)