Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

coordinate limits more flexible to allow for other coordinate systems #32

Merged
merged 5 commits into from
Nov 22, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 18 additions & 15 deletions DALI.tex
Original file line number Diff line number Diff line change
Expand Up @@ -747,26 +747,28 @@ \subsection{Point}
12.3 45.6
\end{verbatim}

In spherical coordinates, all longitude values must fall within [0,360] and all
latitude values within [-90,90].
Coordinate values are not limited to fall within a defined valid range; this is a change from
DALI 1.1 where equatorial coordinates were explicitly limited. Software may have
to perform range reduction in some coordinate systems (for example, spherical coordinates) in
order to correctly interpret or use the coordinate values. Coordinate values are more likely to
work as expected if they are expressed in the simplest form and do not require range reduction.
For example, in spherical coordinates, \verb|362.0 2.0| is equivalent to \verb|2.0 2.0|, but the
latter form is more likely to work as intended in all cases.

There is no general purpose definition of minimum and/or maximum point values, but
specific services may define something that is applicable in a more limited context.

\subsection{Circle}
Circle values serialised in VOTable or service parameters must have the following metadata in the
\xmlel{FIELD} element: \verb|datatype="double"| or \verb|datatype="float"|, \verb|arraysize="3"|,
\verb|xtype="circle"|. For circles
in a spherical coordinate system, the values are ordered as: longitude latitude
radius; longitude values must fall within [0,360], latitude values
within [-90,90], and radius values in (0,180]. For example:
\verb|xtype="circle"|.
The values are ordered as a point followed by a radius. For example:

\begin{verbatim}
12.3 45.6 0.5
\end{verbatim}

In spherical coordinates, all longitude values must fall within [0,360] and all
latitude values within [-90,90].
Valid coordinate value limits are specified by \verb|xtype="point"| above.

Circle-valued service parameters may include additional metadata like minimum and
or maximum value. These are specified using a custom interpretation of the
Expand Down Expand Up @@ -795,11 +797,12 @@ \subsection{Range}

includes values from 10 to 11 (coordinate1) and from 20 to 21 (coordinate2).

In spherical coordinates, coordinates are longitude followed by latitude; longitude values must
fall within [0,360] and all latitude values within [-90,90]. This range form is used as part of
the value of the POS parameter in \citep{2015ivoa.spec.1223D} and \citep{2017ivoa.spec.0517B}
(see also "shape" below). A range can span the meridian (longitude 0): 359 1 -1 1 is interpreted
as the small (2x2 degree) coordinate range from 359 across the meridian to 1 degree longitude.
Valid coordinate value limits are specified by \verb|xtype="point"| above.
This range form is used as part of the value of the POS parameter in
\citep{2015ivoa.spec.1223D} and \citep{2017ivoa.spec.0517B} (see also "shape" below).
For example, a range can span the meridian (longitude 0): 359 1 -1 1 is interpreted
as the small (2x2 degree) coordinate range from 359 across the meridian to 1 degree
longitude.

Range-valued service parameters may include additional metadata like minimum and
or maximum value. These are specified using a custom interpretation of the
Expand Down Expand Up @@ -828,8 +831,8 @@ \subsection{Polygon}
10.0 10.0 10.2 10.0 10.2 10.2 10.0 10.2
\end{verbatim}

In spherical coordinates, all longitude values must fall within [0,360] and all
latitude values within [-90,90]. Vertices must be ordered such that the polygon
Valid coordinate value limits are specified by \verb|xtype="point"| above.
Vertices must be ordered such that the polygon
winding direction is counter-clockwise (when viewed from the origin toward the
sky) as described in \citep{2007ivoa.spec.1030R}.

Expand Down