@@ -70,17 +70,18 @@ The coordinate values and frame specification can now be provided using
7070positional and keyword arguments. First we show positional arguments for
7171RA and Dec::
7272
73- >>> SkyCoord(10, 20, unit="deg") # No frame (no transform to other frames)
74- <SkyCoord (NoFrame ): ra=10.0 deg, dec=20.0 deg>
73+ >>> SkyCoord(10, 20, unit="deg") # Defaults to ICRS
74+ <SkyCoord (ICRS ): ra=10.0 deg, dec=20.0 deg>
7575
7676 >>> SkyCoord([1, 2, 3], [-30, 45, 8], "icrs", unit="deg")
7777 <SkyCoord (ICRS): (ra, dec) in deg
7878 [(1.0, -30.0), (2.0, 45.0), (3.0, 8.0)]>
7979
80- Notice that the first example above does not specify a frame. This object
81- can be used for displaying the coordinates in different formats but cannot
82- be used in transformations, matching catalogs, nor in computing coordinate
83- separations.
80+ Notice that the first example above does not explicitly give a frame. In
81+ this case, the default is taken to be the ICRS system (approximately
82+ correct for "J2000" equatorial coordinates). It is always better to
83+ explicitly specify the frame when it is known to be ICRS, however, as
84+ anyone reading the code will be better able to understand the intent.
8485
8586String inputs in common formats are acceptable, and the frame can be supplied
8687as either a class type like `~astropy.coordinates.FK4 ` or the lower-case
@@ -199,7 +200,7 @@ to astropy are `~astropy.coordinates.ICRS`, `~astropy.coordinates.FK5`,
199200`~astropy.coordinates.Galactic `, and `~astropy.coordinates.AltAz `.
200201The string aliases are simply lower-case versions of the class name.
201202
202- If the frame is not supplied then you will see a special ``NoFrame ``
203+ If the frame is not supplied then you will see a special ``ICRS ``
203204identifer. This indicates that the frame is unspecified and operations
204205that require comparing coordinates (even within that object) are not allowed.
205206
@@ -468,23 +469,23 @@ supplying the corresponding components for that representation::
468469
469470 >>> c = SkyCoord(x=1, y=2, z=3, unit='kpc', representation='cartesian')
470471 >>> c
471- <SkyCoord (NoFrame ): x=1.0 kpc, y=2.0 kpc, z=3.0 kpc>
472+ <SkyCoord (ICRS ): x=1.0 kpc, y=2.0 kpc, z=3.0 kpc>
472473 >>> c.x, c.y, c.z
473474 (<Quantity 1.0 kpc>, <Quantity 2.0 kpc>, <Quantity 3.0 kpc>)
474475
475476Other variations include::
476477
477478 >>> SkyCoord(1, 2*u.deg, 3, representation='cylindrical')
478- <SkyCoord (NoFrame ): rho=1.0 , phi=2.0 deg, z=3.0 >
479+ <SkyCoord (ICRS ): rho=1.0 , phi=2.0 deg, z=3.0 >
479480
480481 >>> SkyCoord(rho=1*u.km, phi=2*u.deg, z=3*u.m, representation='cylindrical')
481- <SkyCoord (NoFrame ): rho=1.0 km, phi=2.0 deg, z=3.0 m>
482+ <SkyCoord (ICRS ): rho=1.0 km, phi=2.0 deg, z=3.0 m>
482483
483484 >>> SkyCoord(rho=1, phi=2, z=3, unit=(u.km, u.deg, u.m), representation='cylindrical')
484- <SkyCoord (NoFrame ): rho=1.0 km, phi=2.0 deg, z=3.0 m>
485+ <SkyCoord (ICRS ): rho=1.0 km, phi=2.0 deg, z=3.0 m>
485486
486487 >>> SkyCoord(1, 2, 3, unit=(None, u.deg, None), representation='cylindrical')
487- <SkyCoord (NoFrame ): rho=1.0 , phi=2.0 deg, z=3.0 >
488+ <SkyCoord (ICRS ): rho=1.0 , phi=2.0 deg, z=3.0 >
488489
489490In general terms, the allowed syntax is as follows::
490491
@@ -628,11 +629,11 @@ in 3d space.
628629
629630 >>> c = SkyCoord(x=1, y=2, z=3, unit='kpc', representation='cartesian')
630631 >>> c
631- <SkyCoord (NoFrame ): x=1.0 kpc, y=2.0 kpc, z=3.0 kpc>
632+ <SkyCoord (ICRS ): x=1.0 kpc, y=2.0 kpc, z=3.0 kpc>
632633
633634 >>> c.representation = 'cylindrical'
634635 >>> c
635- <SkyCoord (NoFrame ): rho=2.236067... kpc, phi=63.434948... deg, z=3.0 kpc>
636+ <SkyCoord (ICRS ): rho=2.236067... kpc, phi=63.434948... deg, z=3.0 kpc>
636637 >>> c.phi.to(u.deg)
637638 <Angle 63.434948... deg>
638639 >>> c.x # doctest: +SKIP
@@ -641,11 +642,11 @@ in 3d space.
641642
642643 >>> c.representation = 'spherical'
643644 >>> c
644- <SkyCoord (NoFrame ): ra=63.434948... deg, dec=53.300774... deg, distance=3.741657... kpc>
645+ <SkyCoord (ICRS ): ra=63.434948... deg, dec=53.300774... deg, distance=3.741657... kpc>
645646
646647 >>> c.representation = 'unitspherical'
647648 >>> c
648- <SkyCoord (NoFrame ): ra=63.434948... deg, dec=53.300774... deg>
649+ <SkyCoord (ICRS ): ra=63.434948... deg, dec=53.300774... deg>
649650
650651You can also use any representation class to set the representation::
651652
0 commit comments