SphericalRepresentation

class astropy.coordinates.SphericalRepresentation(lon, lat, distance, copy=True)

Bases: astropy.coordinates.BaseRepresentation

Representation of points in 3D spherical coordinates.

Parameters:

lon, lat : Quantity

The longitude and latitude of the point(s), in angular units. The latitude should be between -90 and 90 degrees, and the longitude will be wrapped to an angle between 0 and 360 degrees. These can also be instances of Angle, Longitude, or Latitude.

distance : Quantity

The distance to the point(s). If the distance is a length, it is passed to the Distance class, otherwise it is passed to the Quantity class.

copy : bool, optional

If True arrays will be copied rather than referenced.

Attributes Summary

attr_classes
distance	The distance from the origin to the point(s).
lat	The latitude of the point(s).
lon	The longitude of the point(s).
recommended_units

Methods Summary

from_cartesian(cart)	Converts 3D rectangular cartesian coordinates to spherical polar coordinates.
norm()	Vector norm.
represent_as(other_class)
to_cartesian()	Converts spherical polar coordinates to 3D rectangular cartesian coordinates.

Attributes Documentation

attr_classes = OrderedDict([(u'lon', <class 'astropy.coordinates.angles.Longitude'>), (u'lat', <class 'astropy.coordinates.angles.Latitude'>), (u'distance', <class 'astropy.units.quantity.Quantity'>)])

distance

The distance from the origin to the point(s).

lat

The latitude of the point(s).

lon

The longitude of the point(s).

recommended_units = {u'lat': Unit("deg"), u'lon': Unit("deg")}

Methods Documentation

classmethod from_cartesian(cart)

Converts 3D rectangular cartesian coordinates to spherical polar coordinates.

norm()

Vector norm.

The norm is the standard Frobenius norm, i.e., the square root of the sum of the squares of all components with non-angular units. For spherical coordinates, this is just the absolute value of the distance.

Returns:

norm : astropy.units.Quantity

Vector norm, with the same shape as the representation.

represent_as(other_class)

to_cartesian()

Converts spherical polar coordinates to 3D rectangular cartesian coordinates.