Position on primary meridian of offset coordinate system SkyRefP(axis)
If an integer axis index is included in the attribute name (e.g. "
SkyRefP(1)"
) then
the attribute value should be supplied as a single floating point axis value, in
radians, when setting a value for the attribute, and will be returned in the same form
when getting the value of the attribute. In this case the integer axis index should be
"
1"
or "
2"
(the values to use for longitude and latitude axes are given by the
LonAxis and LatAxis attributes).
If no axis index is included in the attribute name (e.g. "
SkyRefP"
) then the
attribute value should be supplied as a character string containing two formatted axis
values (an axis 1 value followed by a comma, followed by an axis 2 value). The same
form will be used when getting the value of the attribute.
If the position given by the SkyRef attribute defines the origin of the offset
coordinate system (that is, if the SkyRefIs attribute is set to "
origin"
), then there
will in general be two orientations which will put the supplied SkyRefP position on the
zero longitude meridian. The orientation which is actually used is the one which
gives the SkyRefP position a positive latitude in the offset coordinate system
(the other possible orientation would give the SkyRefP position a negative
latitude).
An error will be reported if an attempt is made to use a SkyRefP value which is co-incident with SkyRef or with the point diametrically opposite to SkyRef on the celestial sphere. The reporting of this error is deferred until the SkyRef and SkyRefP attribute values are used within a calculation.
If the System attribute of the SkyFrame is changed, any position given for SkyRefP is transformed into the new System.