|
LSST Applications g070148d5b3+33e5256705,g0d53e28543+25c8b88941,g0da5cf3356+2dd1178308,g1081da9e2a+62d12e78cb,g17e5ecfddb+7e422d6136,g1c76d35bf8+ede3a706f7,g295839609d+225697d880,g2e2c1a68ba+cc1f6f037e,g2ffcdf413f+853cd4dcde,g38293774b4+62d12e78cb,g3b44f30a73+d953f1ac34,g48ccf36440+885b902d19,g4b2f1765b6+7dedbde6d2,g5320a0a9f6+0c5d6105b6,g56b687f8c9+ede3a706f7,g5c4744a4d9+ef6ac23297,g5ffd174ac0+0c5d6105b6,g6075d09f38+66af417445,g667d525e37+2ced63db88,g670421136f+2ced63db88,g71f27ac40c+2ced63db88,g774830318a+463cbe8d1f,g7876bc68e5+1d137996f1,g7985c39107+62d12e78cb,g7fdac2220c+0fd8241c05,g96f01af41f+368e6903a7,g9ca82378b8+2ced63db88,g9d27549199+ef6ac23297,gabe93b2c52+e3573e3735,gb065e2a02a+3dfbe639da,gbc3249ced9+0c5d6105b6,gbec6a3398f+0c5d6105b6,gc9534b9d65+35b9f25267,gd01420fc67+0c5d6105b6,geee7ff78d7+a14128c129,gf63283c776+ede3a706f7,gfed783d017+0c5d6105b6,w.2022.47
LSST Data Management Base Package
|
Native latitude of the reference point of a FITS-WCS projection. (double, read-only)
This attribute gives the latitude of the reference point of the FITS-WCS projection implemented by a WcsMap. The value is in radians in the "native spherical" coordinate system. This value is fixed for most projections, for instance it is PI/2 (90 degrees) for all zenithal projections. For some projections (e.g. the conics) the value is not fixed, but is specified by parameter one on the latitude axis.
FITS-WCS paper II introduces the concept of a "fiducial point" which is logical distinct from the projection reference point. It is easy to confuse the use of these two points. The fiducial point is the point which has celestial coordinates given by the CRVAL FITS keywords. The native spherical coordinates for this point default to the values of the NatLat and NatLon {NatLon" attributes, but these defaults
mey be over-ridden by values stored in the <tt>PVi_j</tt> keywords. Put
another way, the <tt>CRVAL</tt> keywords will by default give the celestial
coordinates of the projection reference point, but may refer to
some other point if alternative native longitude and latitude values
are provided through the <tt>PVi_j</tt> keywords.
@subsection WcsMap_NatLon NatLon
Native longitude of the reference point of a FITS-WCS projection. (double, read-only)
This attribute gives the longitude of the reference point of the
FITS-WCS projection implemented by a @ref WcsMap. The value is in
radians in the "native spherical" coordinate system, and will
usually be zero. See @ref WcsMap_NatLat "NatLat" for further information.
@subsection WcsMap_PVi_m PVi_m
FITS-WCS projection parameters. (double)
This attribute specifies the projection parameter values to be
used by a @ref WcsMap when implementing a FITS-WCS sky projection.
Each PV attribute name should include two integers, <tt>i</tt> and <tt>m</tt>,
separated by an underscore. The axis index is specified
by <tt>i</tt>, and should be in the range 1 to 99. The parameter number
is specified by <tt>m</tt>, and should be in the range 0 to 99. For
example, "PV2_1=45.0" would specify a value for projection
parameter 1 of axis 2 in a @ref WcsMap.
These projection parameters correspond exactly to the values
stored using the FITS-WCS keywords "PV1_1", "PV1_2", etc. This
means that projection parameters which correspond to angles must
be given in degrees (despite the fact that the angular
coordinates and other attributes used by a @ref WcsMap are in
radians).
The set of projection parameters used by a @ref WcsMap depends on the
type of projection, which is determined by its WcsType
parameter. Most projections either do not require projection
parameters, or use parameters 1 and 2 associated with the latitude
axis. You should consult the FITS-WCS paper for details.
Some projection parameters have default values (as defined in
the FITS-WCS paper) which apply if no explicit value is given.
You may omit setting a value for these "optional" parameters and the
default will apply. Some projection parameters, however, have no
default and a value must be explicitly supplied. This is most
conveniently
done using the "options" argument of astWcsMap (q.v.) when a @ref WcsMap
done using the OPTIONS argument of AST_WCSMAP (q.v.) when a @ref WcsMap
is first created. An error will result when a @ref WcsMap is used to
transform coordinates if any of its required projection
parameters has not been set and lacks a default value.
A "get" operation for a parameter which has not been assigned a value
will return the default value defined in the FITS-WCS paper, or
AST__BAD if the paper indicates that the parameter has no default.
A default value of zero is returned for parameters which are not
accessed by the projection.
Note, the FITS-WCS paper reserves parameters 1 and 2 on the longitude
axis to hold the native longitude and latitude of the fiducial
point of the projection, in degrees. The default values for these
parameters are determined by the projection type. The AST-specific
TPN projection does not use this convention - all projection
parameters for both axes are used to represent polynomical correction
terms, and the native longitude and latitude at the fiducial point may
not be changed from the default values of zero and 90 degrees.
<h3>Notes:</h3>
- If the projection parameter values given for a @ref WcsMap do not
satisfy all the required constraints (as defined in the FITS-WCS
paper), then an error will result when the @ref WcsMap is used to
transform coordinates.
@subsection WcsMap_PVMax PVMax(i)
Maximum number of FITS-WCS projection parameters. (int, read-only)
This attribute specifies the largest legal index for a PV projection
parameter attached to a specified axis of the @ref WcsMap (i.e. the
largest legal value for <tt>m</tt> when accessing the @ref WcsMap_PVi_m "PVi_m" attribute). The axis index is specified by i, and should be in the range 1 to 99. The value for each axis is determined by the projection type specified when the WcsMap is first created cannot subsequently be changed.
FITS-WCS projection axes. (int, read-only)
This attribute gives the indices of the longitude and latitude coordinates of the FITS-WCS projection within the coordinate space used by a WcsMap. These indices are defined when the WcsMap is first created and cannot subsequently be altered.
If lonlat is 1, the index of the longitude axis is returned. If lonlat is 2, the index of the latitude axis is returned.
FITS-WCS projection type. (int, read only)
This attribute specifies which type of FITS-WCS projection will be performed by a WcsMap. The value is specified when a WcsMap is first created and cannot subsequently be changed.
The values used are represented by enum class WcsType with names that match the (upper case) 3-character code used by the FITS-WCS CTYPEi keyword to identify the projection. For example WcsType::TAN is the tangent plane or gnomonic projection and WcsType::AIT is the Hammer-Aitoff projection. WcsType::TPN is an exception in that it is not part of the FITS-WCS standard (it represents a TAN projection with polynomial correction terms as defined in an early draft of the FITS-WCS paper).
1.9.5