ADQL V2.0 P"> Recommended Edits to ADQL V2.0 PR: Geometric Function SemanticsThis document provides suggested edits that addresses Ray Plante's RFC Comment that called for more explicit enumeration of the types and meanings associated with geometrical functions. (VOQL chair Editing: VOQL Chair has added the late comments from Ray at the end of this page, rather than at the -already closed- RFC pages to avoid confusion): In general, the aim of these suggestions is provide a crisp definition of each function at the beginning of the section. In many of the function descriptions currently, the type and meaning are given by example, which is not a good practice and can lead to ambiguities. In contrast, unambiguous statements up front will make the document a better reference for implementers, particularly when "looking up" a specific function. Note that bold within the suggested text below indicate new or changed words.
2.4.2. AREAChange the first sentence to:This function computes the area, in square degrees, of the region given by the function's only argument.Prepend the 2nd paragraph with the line: The argument can be represented with one of the region functions, BOX, CIRCLE, POLYGON, or REGION. 2.4.3 BOXChange 2nd sentence toA box is a special case of Polygon, defined purely for convenience, and it corresponds in meaning to the STC-S "Box" subphrase [4].The second paragraph sufficiently describes the arguments. 2.4.4 CENTROIDChange the first paragraph to:This function computes the centroid of the region given by the function's only argument and returns a POINT (See 2.4.11).Prepend the 2nd paragraph with the line: The argument can be represented with one of the region functions, BOX, CIRCLE, POLYGON, or REGION. 2.4.5. CIRCLEChange the first paragraph's first sentence to:This function expresses a circular region on the sky (a cone in space) and corresponds in meaning to the "Circle" STC-S subphrase [4].The rest of paragraph sufficiently describes the arguments. 2.4.6 CONTAINSThe return type is given in the 2nd paragraph after the first example, and arguments are defined in the last paragraph after the examples. It would be better to put a crisper definition up front. Append to the first paragraph:The first argument is a point or region value representing the contained geometry, and the second argument is a region value representing the containing region. The function returns 1 (meaning true) if the contained geometry is entirely within the boundary of the containing region and 0 (meaning false) otherwise. When the first argument is a point, it is considered inside the containing region if it lies on the containing region's border.Using the following text, move the contents of the last paragraph to a new paragraph after the first one: Either argument can be given by the appropriate functions (the region functions--BOX, CIRCLE, POLYGON, or REGION--for the second argument, and the region functions or POINT for the first argument) or by a single column name or alias. When a column name or alias is provided, the value in the column or alias must be interpreted the appropriate value type. Since the two argument geometries may be expressed in different coordinate systems, the function is responsible for converting one (or both). If either argument cannot be converted to the proper geometry in a usable coordinate system, the function should throw an error message (as defined by the service making use of ADQL).Drop the last paragraph. 2.4.7 COORD1This function returns the first coordinate value, in degrees, of a position given by the first argument. The argument may be given using the POINT function (See 2.4.12) or a column reference. 2.4.8 COORD2This function returns the second coordinate value, in degrees, of a position given by the first argument. The argument may be given using the POINT function (See 2.4.12) or a column reference. 2.4.9 COORDSYSThis function returns the coordinate system string value from *the geometry given by the first argument. The argument value may be given as a geometry data type function (POINT, BOX, CIRCLE, POLYGON, or REGION) or as a column reference that can be interpreted as a geometry. 2.4.10 DISTANCEThis is sufficiently described.2.4.11 INTERSECTSsee suggestions for CONTAINS.2.4.12 POINTThis is sufficiently explicit.2.4.13 POLYGONInsert the following into the second paragraph as the second sentence:This function corresponds in meaning to the "Polygon" STC-S sub-phrase [4].The explanation of the arguments is sufficient. 2.4.14 REGIONThis is sufficiently described. VOQL chair Editing: VOQL Chair has added the late comments from Ray at this page, rather than at the -already closed- RFC pages to avoid confusion:Late comments by RayPlante - 21 Oct 2008(Moved from RFC page) I recognize that these comments come after the official RFC, so I don't expect them to be answered by the authors. I hope some benefit could be gotten from at least the simpler items.Section 1
This document provides the general semantics for the language elements; where these semantics are ambiguous, the specification of the service or application using ADQL should clarify how the elements should be applied. Section 2.1.2
Section 2.2
The query should be interpreted much like an SQL92 query: where ADQL and SQL92 keywords are identical, the ADQL keywords and their operands should be interpreted in the same way as defined in SQL92. Section 2.4
|
ADQL V2.0 P"> Recommended Edits to ADQL V2.0 PR: Geometric Function SemanticsThis document provides suggested edits that addresses Ray Plante's RFC Comment that called for more explicit enumeration of the types and meanings associated with geometrical functions. (VOQL chair Editing: VOQL Chair has added the late comments from Ray at the end of this page, rather than at the -already closed- RFC pages to avoid confusion): In general, the aim of these suggestions is provide a crisp definition of each function at the beginning of the section. In many of the function descriptions currently, the type and meaning are given by example, which is not a good practice and can lead to ambiguities. In contrast, unambiguous statements up front will make the document a better reference for implementers, particularly when "looking up" a specific function. Note that bold within the suggested text below indicate new or changed words. | ||||||||
Added: | ||||||||
> > |
| |||||||
2.4.2. AREAChange the first sentence to:This function computes the area, in square degrees, of the region given by the function's only argument.Prepend the 2nd paragraph with the line: The argument can be represented with one of the region functions, BOX, CIRCLE, POLYGON, or REGION. 2.4.3 BOXChange 2nd sentence toA box is a special case of Polygon, defined purely for convenience, and it corresponds in meaning to the STC-S "Box" subphrase [4].The second paragraph sufficiently describes the arguments. 2.4.4 CENTROIDChange the first paragraph to:This function computes the centroid of the region given by the function's only argument and returns a POINT (See 2.4.11).Prepend the 2nd paragraph with the line: The argument can be represented with one of the region functions, BOX, CIRCLE, POLYGON, or REGION. 2.4.5. CIRCLEChange the first paragraph's first sentence to: | ||||||||
Changed: | ||||||||
< < | This function expresses a circular region on the sky (a cone in space) *and corresponds in meaning to the "Circle" STC-S subphrase [4]. | |||||||
> > | This function expresses a circular region on the sky (a cone in space) and corresponds in meaning to the "Circle" STC-S subphrase [4]. | |||||||
Changed: | ||||||||
< < | The reset of paragraph sufficiently describes the arguments. | |||||||
> > | The rest of paragraph sufficiently describes the arguments. | |||||||
2.4.6 CONTAINSThe return type is given in the 2nd paragraph after the first example, and arguments are defined in the last paragraph after the examples. It would be better to put a crisper definition up front. Append to the first paragraph:The first argument is a point or region value representing the contained geometry, and the second argument is a region value representing the containing region. The function returns 1 (meaning true) if the contained geometry is entirely within the boundary of the containing region and 0 (meaning false) otherwise. When the first argument is a point, it is considered inside the containing region if it lies on the containing region's border.Using the following text, move the contents of the last paragraph to a new paragraph after the first one: Either argument can be given by the appropriate functions (the region functions--BOX, CIRCLE, POLYGON, or REGION--for the second argument, and the region functions or POINT for the first argument) or by a single column name or alias. When a column name or alias is provided, the value in the column or alias must be interpreted the appropriate value type. Since the two argument geometries may be expressed in different coordinate systems, the function is responsible for converting one (or both). If either argument cannot be converted to the proper geometry in a usable coordinate system, the function should throw an error message (as defined by the service making use of ADQL).Drop the last paragraph. 2.4.7 COORD1This function returns the first coordinate value, in degrees, of a position given by the first argument. The argument may be given using the POINT function (See 2.4.12) or a column reference. 2.4.8 COORD2This function returns the second coordinate value, in degrees, of a position given by the first argument. The argument may be given using the POINT function (See 2.4.12) or a column reference. 2.4.9 COORDSYSThis function returns the coordinate system string value from *the geometry given by the first argument. The argument value may be given as a geometry data type function (POINT, BOX, CIRCLE, POLYGON, or REGION) or as a column reference that can be interpreted as a geometry. 2.4.10 DISTANCEThis is sufficiently described.2.4.11 INTERSECTSsee suggestions for CONTAINS.2.4.12 POINTThis is sufficiently explicit.2.4.13 POLYGONInsert the following into the second paragraph as the second sentence:This function corresponds in meaning to the "Polygon" STC-S sub-phrase [4].The explanation of the arguments is sufficient. 2.4.14 REGIONThis is sufficiently described. VOQL chair Editing: VOQL Chair has added the late comments from Ray at this page, rather than at the -already closed- RFC pages to avoid confusion: | ||||||||
Changed: | ||||||||
< < |
| |||||||
> > | Late comments by RayPlante - 21 Oct 2008 | |||||||
Added: | ||||||||
> > | (Moved from RFC page) | |||||||
I recognize that these comments come after the official RFC, so I don't expect them to be answered by the authors. I hope some benefit could be gotten from at least the simpler items.
Section 1
This document provides the general semantics for the language elements; where these semantics are ambiguous, the specification of the service or application using ADQL should clarify how the elements should be applied. Section 2.1.2
Section 2.2
The query should be interpreted much like an SQL92 query: where ADQL and SQL92 keywords are identical, the ADQL keywords and their operands should be interpreted in the same way as defined in SQL92. Section 2.4
<--
|
ADQL V2.0 P"> Recommended Edits to ADQL V2.0 PR: Geometric Function SemanticsThis document provides suggested edits that addresses Ray Plante's RFC Comment that called for more explicit enumeration of the types and meanings associated with geometrical functions. (VOQL chair Editing: VOQL Chair has added the late comments from Ray at the end of this page, rather than at the -already closed- RFC pages to avoid confusion): In general, the aim of these suggestions is provide a crisp definition of each function at the beginning of the section. In many of the function descriptions currently, the type and meaning are given by example, which is not a good practice and can lead to ambiguities. In contrast, unambiguous statements up front will make the document a better reference for implementers, particularly when "looking up" a specific function. Note that bold within the suggested text below indicate new or changed words.2.4.2. AREAChange the first sentence to:This function computes the area, in square degrees, of the region given by the function's only argument.Prepend the 2nd paragraph with the line: The argument can be represented with one of the region functions, BOX, CIRCLE, POLYGON, or REGION. 2.4.3 BOXChange 2nd sentence toA box is a special case of Polygon, defined purely for convenience, and it corresponds in meaning to the STC-S "Box" subphrase [4].The second paragraph sufficiently describes the arguments. 2.4.4 CENTROIDChange the first paragraph to:This function computes the centroid of the region given by the function's only argument and returns a POINT (See 2.4.11).Prepend the 2nd paragraph with the line: The argument can be represented with one of the region functions, BOX, CIRCLE, POLYGON, or REGION. 2.4.5. CIRCLEChange the first paragraph's first sentence to:This function expresses a circular region on the sky (a cone in space) *and corresponds in meaning to the "Circle" STC-S subphrase [4].The reset of paragraph sufficiently describes the arguments. 2.4.6 CONTAINSThe return type is given in the 2nd paragraph after the first example, and arguments are defined in the last paragraph after the examples. It would be better to put a crisper definition up front. Append to the first paragraph:The first argument is a point or region value representing the contained geometry, and the second argument is a region value representing the containing region. The function returns 1 (meaning true) if the contained geometry is entirely within the boundary of the containing region and 0 (meaning false) otherwise. When the first argument is a point, it is considered inside the containing region if it lies on the containing region's border.Using the following text, move the contents of the last paragraph to a new paragraph after the first one: Either argument can be given by the appropriate functions (the region functions--BOX, CIRCLE, POLYGON, or REGION--for the second argument, and the region functions or POINT for the first argument) or by a single column name or alias. When a column name or alias is provided, the value in the column or alias must be interpreted the appropriate value type. Since the two argument geometries may be expressed in different coordinate systems, the function is responsible for converting one (or both). If either argument cannot be converted to the proper geometry in a usable coordinate system, the function should throw an error message (as defined by the service making use of ADQL).Drop the last paragraph. 2.4.7 COORD1 | ||||||||
Changed: | ||||||||
< < | This function returns the first coordinate value, in degrees, of a position given by the first argument. The argument may be given using the POINT function (See 2.4.12) or a column reference. | |||||||
> > | This function returns the first coordinate value, in degrees, of a position given by the first argument. The argument may be given using the POINT function (See 2.4.12) or a column reference. | |||||||
2.4.8 COORD2 | ||||||||
Changed: | ||||||||
< < | This function returns the second coordinate value, in degrees, of a position given by the first argument. The argument may be given using the POINT function (See 2.4.12) or a column reference. | |||||||
> > | This function returns the second coordinate value, in degrees, of a position given by the first argument. The argument may be given using the POINT function (See 2.4.12) or a column reference. | |||||||
Added: | ||||||||
> > |
2.4.9 COORDSYSThis function returns the coordinate system string value from *the geometry given by the first argument. The argument value may be given as a geometry data type function (POINT, BOX, CIRCLE, POLYGON, or REGION) or as a column reference that can be interpreted as a geometry. 2.4.10 DISTANCEThis is sufficiently described.2.4.11 INTERSECTSsee suggestions for CONTAINS. | |||||||
2.4.12 POINTThis is sufficiently explicit.2.4.13 POLYGONInsert the following into the second paragraph as the second sentence:This function corresponds in meaning to the "Polygon" STC-S sub-phrase [4].The explanation of the arguments is sufficient. 2.4.14 REGIONThis is sufficiently described. VOQL chair Editing: VOQL Chair has added the late comments from Ray at this page, rather than at the -already closed- RFC pages to avoid confusion:
Section 1
This document provides the general semantics for the language elements; where these semantics are ambiguous, the specification of the service or application using ADQL should clarify how the elements should be applied. Section 2.1.2
Section 2.2
The query should be interpreted much like an SQL92 query: where ADQL and SQL92 keywords are identical, the ADQL keywords and their operands should be interpreted in the same way as defined in SQL92. Section 2.4
<--
|
ADQL V2.0 P"> Recommended Edits to ADQL V2.0 PR: Geometric Function SemanticsThis document provides suggested edits that addresses Ray Plante's RFC Comment that called for more explicit enumeration of the types and meanings associated with geometrical functions. | ||||||||
Added: | ||||||||
> > | (VOQL chair Editing: VOQL Chair has added the late comments from Ray at the end of this page, rather than at the -already closed- RFC pages to avoid confusion): | |||||||
In general, the aim of these suggestions is provide a crisp definition of each function at the beginning of the section. In many of the function descriptions currently, the type and meaning are given by example, which is not a good practice and can lead to ambiguities. In contrast, unambiguous statements up front will make the document a better reference for implementers, particularly when "looking up" a specific function.
Note that bold within the suggested text below indicate new or changed words.
2.4.2. AREAChange the first sentence to:This function computes the area, in square degrees, of the region given by the function's only argument.Prepend the 2nd paragraph with the line: The argument can be represented with one of the region functions, BOX, CIRCLE, POLYGON, or REGION. 2.4.3 BOXChange 2nd sentence toA box is a special case of Polygon, defined purely for convenience, and it corresponds in meaning to the STC-S "Box" subphrase [4].The second paragraph sufficiently describes the arguments. 2.4.4 CENTROIDChange the first paragraph to:This function computes the centroid of the region given by the function's only argument and returns a POINT (See 2.4.11).Prepend the 2nd paragraph with the line: The argument can be represented with one of the region functions, BOX, CIRCLE, POLYGON, or REGION. 2.4.5. CIRCLEChange the first paragraph's first sentence to:This function expresses a circular region on the sky (a cone in space) *and corresponds in meaning to the "Circle" STC-S subphrase [4].The reset of paragraph sufficiently describes the arguments. 2.4.6 CONTAINSThe return type is given in the 2nd paragraph after the first example, and arguments are defined in the last paragraph after the examples. It would be better to put a crisper definition up front. Append to the first paragraph:The first argument is a point or region value representing the contained geometry, and the second argument is a region value representing the containing region. The function returns 1 (meaning true) if the contained geometry is entirely within the boundary of the containing region and 0 (meaning false) otherwise. When the first argument is a point, it is considered inside the containing region if it lies on the containing region's border.Using the following text, move the contents of the last paragraph to a new paragraph after the first one: Either argument can be given by the appropriate functions (the region functions--BOX, CIRCLE, POLYGON, or REGION--for the second argument, and the region functions or POINT for the first argument) or by a single column name or alias. When a column name or alias is provided, the value in the column or alias must be interpreted the appropriate value type. Since the two argument geometries may be expressed in different coordinate systems, the function is responsible for converting one (or both). If either argument cannot be converted to the proper geometry in a usable coordinate system, the function should throw an error message (as defined by the service making use of ADQL).Drop the last paragraph. 2.4.7 COORD1This function returns the first coordinate value, in degrees, of a position given by the first argument. The argument may be given using the POINT function (See 2.4.12) or a column reference. 2.4.8 COORD2This function returns the second coordinate value, in degrees, of a position given by the first argument. The argument may be given using the POINT function (See 2.4.12) or a column reference. 2.4.12 POINTThis is sufficiently explicit.2.4.13 POLYGONInsert the following into the second paragraph as the second sentence:This function corresponds in meaning to the "Polygon" STC-S sub-phrase [4].The explanation of the arguments is sufficient. 2.4.14 REGIONThis is sufficiently described. | ||||||||
Added: | ||||||||
> > |
VOQL chair Editing: VOQL Chair has added the late comments from Ray at this page, rather than at the -already closed- RFC pages to avoid confusion:
Section 1
This document provides the general semantics for the language elements; where these semantics are ambiguous, the specification of the service or application using ADQL should clarify how the elements should be applied. Section 2.1.2
Section 2.2
The query should be interpreted much like an SQL92 query: where ADQL and SQL92 keywords are identical, the ADQL keywords and their operands should be interpreted in the same way as defined in SQL92. Section 2.4
| |||||||
<--
|
ADQL V2.0 P"> Recommended Edits to ADQL V2.0 PR: Geometric Function SemanticsThis document provides suggested edits that addresses Ray Plante's RFC Comment that called for more explicit enumeration of the types and meanings associated with geometrical functions. In general, the aim of these suggestions is provide a crisp definition of each function at the beginning of the section. In many of the function descriptions currently, the type and meaning are given by example, which is not a good practice and can lead to ambiguities. In contrast, unambiguous statements up front will make the document a better reference for implementers, particularly when "looking up" a specific function. Note that bold within the suggested text below indicate new or changed words.2.4.2. AREAChange the first sentence to:This function computes the area, in square degrees, of the region given by the function's only argument.Prepend the 2nd paragraph with the line: The argument can be represented with one of the region functions, BOX, CIRCLE, POLYGON, or REGION. 2.4.3 BOXChange 2nd sentence toA box is a special case of Polygon, defined purely for convenience, and it corresponds in meaning to the STC-S "Box" subphrase [4].The second paragraph sufficiently describes the arguments. 2.4.4 CENTROIDChange the first paragraph to:This function computes the centroid of the region given by the function's only argument and returns a POINT (See 2.4.11).Prepend the 2nd paragraph with the line: The argument can be represented with one of the region functions, BOX, CIRCLE, POLYGON, or REGION. 2.4.5. CIRCLEChange the first paragraph's first sentence to:This function expresses a circular region on the sky (a cone in space) *and corresponds in meaning to the "Circle" STC-S subphrase [4].The reset of paragraph sufficiently describes the arguments. 2.4.6 CONTAINSThe return type is given in the 2nd paragraph after the first example, and arguments are defined in the last paragraph after the examples. It would be better to put a crisper definition up front. Append to the first paragraph:The first argument is a point or region value representing the contained geometry, and the second argument is a region value representing the containing region. The function returns 1 (meaning true) if the contained geometry is entirely within the boundary of the containing region and 0 (meaning false) otherwise. When the first argument is a point, it is considered inside the containing region if it lies on the containing region's border.Using the following text, move the contents of the last paragraph to a new paragraph after the first one: Either argument can be given by the appropriate functions (the region functions--BOX, CIRCLE, POLYGON, or REGION--for the second argument, and the region functions or POINT for the first argument) or by a single column name or alias. When a column name or alias is provided, the value in the column or alias must be interpreted the appropriate value type. Since the two argument geometries may be expressed in different coordinate systems, the function is responsible for converting one (or both). If either argument cannot be converted to the proper geometry in a usable coordinate system, the function should throw an error message (as defined by the service making use of ADQL).Drop the last paragraph. 2.4.7 COORD1This function returns the first coordinate value, in degrees, of a position given by the first argument. The argument may be given using the POINT function (See 2.4.12) or a column reference. 2.4.8 COORD2This function returns the second coordinate value, in degrees, of a position given by the first argument. The argument may be given using the POINT function (See 2.4.12) or a column reference. 2.4.12 POINTThis is sufficiently explicit.2.4.13 POLYGONInsert the following into the second paragraph as the second sentence:This function corresponds in meaning to the "Polygon" STC-S sub-phrase [4].The explanation of the arguments is sufficient. 2.4.14 REGIONThis is sufficiently described.<--
|