redblackcoder commented on code in PR #10981:
URL: https://github.com/apache/iceberg/pull/10981#discussion_r1946979428


##########
format/spec.md:
##########
@@ -623,6 +649,8 @@ Notes:
 5. The `content_offset` and `content_size_in_bytes` fields are used to 
reference a specific blob for direct access to a deletion vector. For deletion 
vectors, these values are required and must exactly match the `offset` and 
`length` stored in the Puffin footer for the deletion vector blob.
 6. The following field ids are reserved on `data_file`: 141.
 
+For `geometry` and `geography` types, `lower_bounds` and `upper_bounds` are 
both points of the following coordinates X, Y, Z, and M (see [Appendix 
G](#appendix-g-geospatial-notes)) which are the lower / upper bound of all 
objects in the file. For the X values only, xmin may be greater than xmax, in 
which case an object in this bounding box may match if it contains an X such 
that `x >= xmin` OR`x <= xmax`. In geographic terminology, the concepts of 
`xmin`, `xmax`, `ymin`, and `ymax` are also known as `westernmost`, 
`easternmost`, `southernmost` and `northernmost`, respectively. For `geography` 
types, these points are further restricted to the canonical ranges of [-180 
180] for X and [-90 90] for Y.
+

Review Comment:
   Do `lower_bounds` and `upper_bounds` mean the bounding box for the 
geospatial data points in the file? Can it be expanded to explain that bounds 
are based on a bounding box and these values are corners of the bounding box. 
Maybe this can be added to the Appendix.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org
For additional commands, e-mail: issues-h...@iceberg.apache.org

Reply via email to