@@ -267,7 +267,7 @@ \subsection{Synchronous Execution: DALI-sync}
267
267
A concrete DAL service specification will specify zero or more synchronous job
268
268
submission resources and whether they are mandatory or optional. It may mandate
269
269
a specific resource name to support simple client use, or it can allow the
270
- resource name to be described in the service capability metadata
270
+ resource name to be described in the service capability metadata
271
271
(Section~\ref {sec:vosi-capabilities }).
272
272
273
273
\subsection {DALI-examples }
@@ -289,7 +289,7 @@ \subsection{DALI-examples}
289
289
$$
290
290
291
291
DAL services may implement the /examples resource and include it in the
292
- capabilities described by the VOSI-capabilities resource
292
+ capabilities described by the VOSI-capabilities resource
293
293
(Section~\ref {sec:vosi-capabilities }); if they
294
294
do not, retrieving its URL must yield a 404 HTTP error code.
295
295
@@ -733,8 +733,8 @@ \subsection{Sexagesimal Coordinates}
733
733
(latitude) must fall within [-90,90], minutes must fall within [0,60), and seconds
734
734
must fall within [0,60). Valid values for \verb |xtype="hms" | are from 0:0:0 to 24:0:0.
735
735
Valid values for \verb |xtype="dms" | are from -90:0:0 to 90:0:0; an optional + sign at
736
- the start is allowed (e.g. +10:20:30) but not required. The upper bound on minutes
737
- and seconds is not part of the valid range; for example 12:34:60 is not allowed and must
736
+ the start is allowed (e.g. +10:20:30) but not required. The upper bound on minutes
737
+ and seconds is not part of the valid range; for example 12:34:60 is not allowed and must
738
738
be expressed as 12:35:00 instead.
739
739
740
740
\subsection {Point }
@@ -754,7 +754,7 @@ \subsection{Point}
754
754
755
755
Coordinate values are not limited to fall within a defined valid range; this is a change from
756
756
DALI 1.1 where equatorial coordinates were explicitly limited. Software may have
757
- to perform range reduction in some coordinate systems (for example, spherical coordinates) in
757
+ to perform range reduction in some coordinate systems (for example, spherical coordinates) in
758
758
order to correctly interpret or use the coordinate values. Coordinate values are more likely to
759
759
work as expected if they are expressed in the simplest form and do not require range reduction.
760
760
For example, in spherical coordinates, \verb |362.0 2.0 | is equivalent to \verb |2.0 2.0 |, but the
@@ -766,7 +766,7 @@ \subsection{Point}
766
766
\subsection {Circle }
767
767
Circle values serialised in VOTable or service parameters must have the following metadata in the
768
768
\xmlel {FIELD} element: \verb |datatype="double" | or \verb |datatype="float" |, \verb |arraysize="3" |,
769
- \verb |xtype="circle" |.
769
+ \verb |xtype="circle" |.
770
770
The values are ordered as a point followed by a radius. For example:
771
771
772
772
\begin {verbatim }
@@ -803,11 +803,11 @@ \subsection{Range}
803
803
\noindent
804
804
includes values from 10 to 11 (coordinate1) and from 20 to 21 (coordinate2).
805
805
806
- Valid coordinate value limits are specified by \verb |xtype="point" | above.
807
- This range form is used as part of the value of the POS parameter in
808
- \citep {2015ivoa.spec.1223D } and \citep {2017ivoa.spec.0517B } (see also "shape" below).
806
+ Valid coordinate value limits are specified by \verb |xtype="point" | above.
807
+ This range form is used as part of the value of the POS parameter in
808
+ \citep {2015ivoa.spec.1223D } and \citep {2017ivoa.spec.0517B } (see also "shape" below).
809
809
For example, a range can span the meridian (longitude 0): 359 1 -1 1 is interpreted
810
- as the small (2x2 degree) coordinate range from 359 across the meridian to 1 degree
810
+ as the small (2x2 degree) coordinate range from 359 across the meridian to 1 degree
811
811
longitude.
812
812
813
813
Range-valued service parameters may include additional metadata like minimum and
@@ -837,7 +837,7 @@ \subsection{Polygon}
837
837
10.0 10.0 10.2 10.0 10.2 10.2 10.0 10.2
838
838
\end {verbatim }
839
839
840
- Valid coordinate value limits are specified by \verb |xtype="point" | above.
840
+ Valid coordinate value limits are specified by \verb |xtype="point" | above.
841
841
Vertices must be ordered such that the polygon
842
842
winding direction is counter-clockwise (when viewed from the origin toward the
843
843
sky) as described in \citep {2007ivoa.spec.1030R }.
@@ -906,7 +906,7 @@ \subsection{Shape}
906
906
polygon 10.0 10.0 10.2 10.0 10.2 10.2 10.0 10.2
907
907
\end {verbatim }
908
908
909
- The interpretation and constraints on the coordinate values are as specified
909
+ The interpretation and constraints on the coordinate values are as specified
910
910
for the individual xtypes above.
911
911
912
912
The shape xtype provides a compatible description of the POS parameter in
@@ -948,40 +948,40 @@ \subsection{Shape}
948
948
more limited context.
949
949
950
950
\subsection {URI }
951
- URI values \citep {std:RFC3986 } serialised in VOTable or service parameters
952
- should have the following metadata in the \xmlel {FIELD} element: \verb |datatype="char" |,
953
- \verb |arraysize="*" |, \verb |xtype="uri" | (where arraysize may also be fixed length or
951
+ URI values \citep {std:RFC3986 } serialised in VOTable or service parameters
952
+ should have the following metadata in the \xmlel {FIELD} element: \verb |datatype="char" |,
953
+ \verb |arraysize="*" |, \verb |xtype="uri" | (where arraysize may also be fixed length or
954
954
variable length with limit).
955
955
956
956
\subsection {UUID }
957
- Universal Unique Identifier (UUID) values serialised in VOTable or service parameters
958
- should have the following metadata in the \xmlel {FIELD} element: \verb |datatype="char" |,
959
- \verb |arraysize="36" |, \verb |xtype="uuid" | (where arraysize may also be fixed length or
957
+ Universal Unique Identifier (UUID) values serialised in VOTable or service parameters
958
+ should have the following metadata in the \xmlel {FIELD} element: \verb |datatype="char" |,
959
+ \verb |arraysize="36" |, \verb |xtype="uuid" | (where arraysize may also be fixed length or
960
960
variable length with limit).
961
961
962
- UUID values \citep {std:RFC4122 } are serialised using the canonical ascii (hex)
962
+ UUID values \citep {std:RFC4122 } are serialised using the canonical ascii (hex)
963
963
representation, for example: e0b895ca-2ee4-4f0f-b595-cbd83be40b04.
964
964
965
965
\subsection {Unsupported Types }
966
966
967
967
Support for any specific \xmlel {xtype} in implementations (client or service) is specified in
968
968
the service standard document. However, support for a specific \xmlel {xtype} as input (params
969
- and uploaded content) should generally be considered optional. Implementations should
970
- be able to read and write the underlying data type without knowing the semantics added
971
- by the \xmlel {xtype}. In cases where understanding the meaning of an \xmlel {xtype} is required (for
972
- example, the POS param in SODA) and a service does not support the serialized value,
973
- the service should issue an error message that starts with the following text with the
969
+ and uploaded content) should generally be considered optional. Implementations should
970
+ be able to read and write the underlying data type without knowing the semantics added
971
+ by the \xmlel {xtype}. In cases where understanding the meaning of an \xmlel {xtype} is required (for
972
+ example, the POS param in SODA) and a service does not support the serialized value,
973
+ the service should issue an error message that starts with the following text with the
974
974
most specific \xmlel {xtype} noted:
975
975
\begin {verbatim }
976
976
unsupported-xtype: {xtype} [optional detail here]
977
977
\end {verbatim }
978
978
and may include additional detail where noted. For example, the value of the SODA POS parameter
979
- is a \verb |xtype="shape" |, but if the implementation does not support the "range" construct, it
979
+ is a \verb |xtype="shape" |, but if the implementation does not support the "range" construct, it
980
980
would respond (minimally) with:
981
981
\begin {verbatim }
982
982
unsupported-xtype: range
983
983
\end {verbatim }
984
- This behaviour will allow for new \xmlel {xtype}s to be introduced and for \verb |xtype="shape" |
984
+ This behaviour will allow for new \xmlel {xtype}s to be introduced and for \verb |xtype="shape" |
985
985
to be extended to include additional subtypes in the future.
986
986
987
987
\section {Parameters }
@@ -1084,7 +1084,7 @@ \subsubsection{RESPONSEFORMAT}
1084
1084
In some cases, the specification for a specific format may be parameterised
1085
1085
(e.g., the media type may include optional semi-colon and additional key-value
1086
1086
parameters). A DAL service must accept a RESPONSEFORMAT parameter indicating a
1087
- format that the service supports and should fail (Section~\ref {sec:response-error })
1087
+ format that the service supports and should fail (Section~\ref {sec:response-error })
1088
1088
where the RESPONSEFORMAT parameter specifies a format not supported by the service
1089
1089
implementation.
1090
1090
0 commit comments