From 64a58b0b51def7a74d5c0a29aa5cc43ab74ca3a2 Mon Sep 17 00:00:00 2001 From: Patrick Dowler Date: Wed, 8 Nov 2023 13:47:14 -0800 Subject: [PATCH 1/5] coordinate limits more flexible to allow for other coordinate systems circle, range, and polygon refer to point so this is specified in a single place --- DALI.tex | 23 ++++++++++++----------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/DALI.tex b/DALI.tex index 45444a9..9eebbb0 100644 --- a/DALI.tex +++ b/DALI.tex @@ -747,8 +747,9 @@ \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]. +All coordinate values must fall within the minimal range of values appropriate for the +coordnate system in use. For example, equatorial coordinate limits are [0,360) for longitude +and [-90,90] for latitude; other coordinate systems may define different limits. 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. @@ -765,8 +766,7 @@ \subsection{Circle} 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 @@ -795,11 +795,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 @@ -828,8 +829,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}. From 350d327cdc9b2792f183e0273c7ec5f05477c70b Mon Sep 17 00:00:00 2001 From: Patrick Dowler Date: Wed, 8 Nov 2023 14:44:27 -0800 Subject: [PATCH 2/5] typo fix --- DALI.tex | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/DALI.tex b/DALI.tex index 9eebbb0..4e29004 100644 --- a/DALI.tex +++ b/DALI.tex @@ -748,7 +748,7 @@ \subsection{Point} \end{verbatim} All coordinate values must fall within the minimal range of values appropriate for the -coordnate system in use. For example, equatorial coordinate limits are [0,360) for longitude +coordinate system in use. For example, equatorial coordinate limits are [0,360) for longitude and [-90,90] for latitude; other coordinate systems may define different limits. There is no general purpose definition of minimum and/or maximum point values, but From 6783a4f163bbbf2cd1225966d299e623a20a6737 Mon Sep 17 00:00:00 2001 From: Patrick Dowler Date: Thu, 9 Nov 2023 15:50:26 -0800 Subject: [PATCH 3/5] remove coordinate value limits --- DALI.tex | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/DALI.tex b/DALI.tex index 4e29004..a47f0c9 100644 --- a/DALI.tex +++ b/DALI.tex @@ -747,9 +747,13 @@ \subsection{Point} 12.3 45.6 \end{verbatim} -All coordinate values must fall within the minimal range of values appropriate for the -coordinate system in use. For example, equatorial coordinate limits are [0,360) for longitude -and [-90,90] for latitude; other coordinate systems may define different limits. +Coordinate values are not limited to fall within a defined valid range; this is a change from +the previous version 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. @@ -757,10 +761,8 @@ \subsection{Point} \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 From 199e96bdcb19c29946732e0013a6b0aa311a2f16 Mon Sep 17 00:00:00 2001 From: Mark Taylor Date: Tue, 14 Nov 2023 13:10:15 +0000 Subject: [PATCH 4/5] Fix formatting typo --- DALI.tex | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/DALI.tex b/DALI.tex index a47f0c9..8f1d62a 100644 --- a/DALI.tex +++ b/DALI.tex @@ -752,7 +752,7 @@ \subsection{Point} 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 +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 From ee0994f55017d7092883381036f63ddb3babc9aa Mon Sep 17 00:00:00 2001 From: Mark Taylor Date: Tue, 14 Nov 2023 13:10:44 +0000 Subject: [PATCH 5/5] Refer to previous version by number Replace the text "the previous version" with "DALI 1.1" so that this text does not need to be updated in future document versions. --- DALI.tex | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/DALI.tex b/DALI.tex index 8f1d62a..555fa2d 100644 --- a/DALI.tex +++ b/DALI.tex @@ -748,7 +748,7 @@ \subsection{Point} \end{verbatim} Coordinate values are not limited to fall within a defined valid range; this is a change from -the previous version where equatorial coordinates were explicitly limited. Software may have +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.