SphericalCoordinatesBase

class astropy.coordinates.coordsystems.SphericalCoordinatesBase(*args, **kwargs)

Bases: object

Abstract superclass for all coordinate classes representing points in three dimensions.

Notes

Subclasses must implement __init__, and define the latangle and lonangle properties. They may also override the equinox property, or leave it unaltered to indicate the coordinates are equinoxless.

_initialize_latlon is provided to implement typical initialization features, and should be called from a subclass’ __init__. See the classes in astropy.coordinates.builtin_systems for examples of this.

Attributes Summary

y
lonangle	The longitudinal/azimuthal angle for these coordinates as an Angle object.
equinox	The equinox of this system, or None to indicate no equinox specified.
distance	The radial distance for this coordinate object as an Distance object.
cartesian
latangle	The latitudinal/elevation angle for these coordinates as an Angle object.
x
z

Methods Summary

separation(other)	Computes on-sky separation between this coordinate and another.
is_transformable_to(tosys)	Determines if this coordinate can be transformed to a particular system.
separation_3d(other)	Computes three dimensional separation between this coordinate and another.
transform_to(tosys)	Transform this coordinate to a new system.

Attributes Documentation

y

lonangle

The longitudinal/azimuthal angle for these coordinates as an Angle object.

Note

This should be overridden in subclasses as a read-only property that just returns an attribute a way to abstract the exact choice of names for the coordinates. E.g., ICRSCoordinates implements this by doing return self.dec.

equinox

The equinox of this system, or None to indicate no equinox specified.

distance

The radial distance for this coordinate object as an Distance object.

If set as a tuple, the tuple will be passed into the Distance constructor.

Alternatively, this may be None, indicating an unknown/not given distance. Where necessary, this object will be interpreted as angles on the unit sphere.

cartesian

latangle

The latitudinal/elevation angle for these coordinates as an Angle object.

Note

This should be overridden in subclasses as a read-only property that just returns an attribute a way to abstract the exact choice of names for the coordiantes. E.g., ICRSCoordinates implements this by doing return self.ra.

x

z

Methods Documentation

separation(other)

Computes on-sky separation between this coordinate and another.

See the AngularSeparation docstring for further details on the actual calculation.

Parameters :

other : SphericalCoordinatesBase

The coordinate system to get the separation to.

Returns :

sep : AngularSeparation

The on-sky separation between this and the other coordinate.

is_transformable_to(tosys)

Determines if this coordinate can be transformed to a particular system.

Parameters :

tosys : class

The system to transform this coordinate into.

Returns :

transformable : bool or str

True if this can be trasnformed to tosys, False if not. The string ‘same’ if tosys is the same system as this object (i.e. no transformation is needed).

separation_3d(other)

Computes three dimensional separation between this coordinate and another.

Parameters :

other : SphericalCoordinatesBase

The coordinate system to get the distance to.

Returns :

sep : Distance

The real-space distance between these two coordinates.

Raises :

ValueError :

If this or the other coordinate do not have distances.

transform_to(tosys)

Transform this coordinate to a new system.

Parameters :

tosys : class

The system to transform this coordinate into.

Returns :

transcoord :

A new object with this coordinate represented in the tosys system.

Raises :

ValueError :

If there is no possible transformation route.