This is an automated email from the ASF dual-hosted git repository. jiayu pushed a commit to branch docs/individual-function-pages in repository https://gitbox.apache.org/repos/asf/sedona.git
commit d9e0991619c6ecdb556778fe08a33351665f269d Author: Jia Yu <[email protected]> AuthorDate: Wed Feb 25 15:30:26 2026 -0800 Merge geography and raster category indexes into combined pages; flatten nav - Create Geography-Functions.md combining 2 geography category indexes - Create Raster-Functions.md combining 12 raster category indexes - Remove 'Geometry type:' and 'Geography type:' nav nesting levels - Replace 12 raster category nav entries with single 'Raster Functions' - Remove 14 old category index.md files - Fix 9 cross-references across 4 files - Update merge script to handle all three function types --- docs/api/sql/Map-Algebra-Operators/index.md | 47 ----- docs/api/sql/Pixel-Functions/index.md | 31 ---- docs/api/sql/Raster-Accessors/index.md | 42 ----- docs/api/sql/Raster-Aggregate-Functions/index.md | 26 --- docs/api/sql/Raster-Band-Accessors/index.md | 34 ---- docs/api/sql/Raster-Constructors/index.md | 31 ---- docs/api/sql/Raster-Functions.md | 197 +++++++++++++++++++++ docs/api/sql/Raster-Geometry-Functions/index.md | 28 --- docs/api/sql/Raster-Map-Algebra-Operators/index.md | 28 --- docs/api/sql/Raster-Operators/index.md | 43 ----- docs/api/sql/Raster-Output/index.md | 28 --- docs/api/sql/Raster-Predicates/index.md | 28 --- docs/api/sql/Raster-Tiles/index.md | 27 --- docs/api/sql/Raster-loader.md | 4 +- docs/api/sql/Raster-map-algebra.md | 4 +- .../sql/geography/Geography-Constructors/index.md | 32 ---- docs/api/sql/geography/Geography-Functions.md | 43 +++++ .../api/sql/geography/Geography-Functions/index.md | 27 --- docs/setup/release-notes.md | 2 +- docs/tutorial/raster.md | 8 +- mkdocs.yml | 20 +-- 21 files changed, 252 insertions(+), 478 deletions(-) diff --git a/docs/api/sql/Map-Algebra-Operators/index.md b/docs/api/sql/Map-Algebra-Operators/index.md deleted file mode 100644 index fb7c79f7fa..0000000000 --- a/docs/api/sql/Map-Algebra-Operators/index.md +++ /dev/null @@ -1,47 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - -# Map Algebra Operators - -These functions perform per-pixel mathematical operations on raster band arrays. - -| Function | Description | Since | -| :--- | :--- | :--- | -| [RS_Add](RS_Add.md) | Add two spectral bands in a Geotiff image | v1.1.0 | -| [RS_Array](RS_Array.md) | Create an array that is filled by the given value | v1.1.0 | -| [RS_BitwiseAND](RS_BitwiseAND.md) | Find Bitwise AND between two bands of Geotiff image | v1.1.0 | -| [RS_BitwiseOR](RS_BitwiseOR.md) | Find Bitwise OR between two bands of Geotiff image | v1.1.0 | -| [RS_CountValue](RS_CountValue.md) | Returns count of a particular value from a spectral band in a raster image | v1.1.0 | -| [RS_Divide](RS_Divide.md) | Divide band1 with band2 from a geotiff image | v1.1.0 | -| [RS_FetchRegion](RS_FetchRegion.md) | Fetch a subset of region from given Geotiff image based on minimumX, minimumY, maximumX and maximumY index as well original height and width of image | v1.1.0 | -| [RS_GreaterThan](RS_GreaterThan.md) | Mask all the values with 1 which are greater than a particular target value | v1.1.0 | -| [RS_GreaterThanEqual](RS_GreaterThanEqual.md) | Mask all the values with 1 which are greater than equal to a particular target value | v1.1.0 | -| [RS_LessThan](RS_LessThan.md) | Mask all the values with 1 which are less than a particular target value | v1.1.0 | -| [RS_LessThanEqual](RS_LessThanEqual.md) | Mask all the values with 1 which are less than equal to a particular target value | v1.1.0 | -| [RS_LogicalDifference](RS_LogicalDifference.md) | Return value from band 1 if a value in band1 and band2 are different, else return 0 | v1.1.0 | -| [RS_LogicalOver](RS_LogicalOver.md) | Return value from band1 if it's not equal to 0, else return band2 value | v1.1.0 | -| [RS_Mean](RS_Mean.md) | Returns Mean value for a spectral band in a Geotiff image | v1.1.0 | -| [RS_Mode](RS_Mode.md) | Returns Mode from a spectral band in a Geotiff image in form of an array | v1.1.0 | -| [RS_Modulo](RS_Modulo.md) | Find modulo of pixels with respect to a particular value | v1.1.0 | -| [RS_Multiply](RS_Multiply.md) | Multiply two spectral bands in a Geotiff image | v1.1.0 | -| [RS_MultiplyFactor](RS_MultiplyFactor.md) | Multiply a factor to a spectral band in a geotiff image | v1.1.0 | -| [RS_Normalize](RS_Normalize.md) | Normalize the value in the array to [0, 255]. Uniform arrays are set to 0 after normalization. | v1.1.0 | -| [RS_NormalizedDifference](RS_NormalizedDifference.md) | Returns Normalized Difference between two bands(band2 and band1) in a Geotiff image(example: NDVI, NDBI) | v1.1.0 | -| [RS_SquareRoot](RS_SquareRoot.md) | Find Square root of band values in a geotiff image | v1.1.0 | -| [RS_Subtract](RS_Subtract.md) | Subtract two spectral bands in a Geotiff image(band2 - band1) | v1.1.0 | diff --git a/docs/api/sql/Pixel-Functions/index.md b/docs/api/sql/Pixel-Functions/index.md deleted file mode 100644 index 9506df6d0f..0000000000 --- a/docs/api/sql/Pixel-Functions/index.md +++ /dev/null @@ -1,31 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - -# Pixel Functions - -These functions work with individual pixel geometry representations. - -| Function | Description | Since | -| :--- | :--- | :--- | -| [RS_PixelAsCentroid](RS_PixelAsCentroid.md) | Returns the centroid (point geometry) of the specified pixel's area. The pixel coordinates specified are 1-indexed. If `colX` and `rowY` are out of bounds for the raster, they are interpolated assu... | v1.5.0 | -| [RS_PixelAsCentroids](RS_PixelAsCentroids.md) | Returns a list of the centroid point geometry, the pixel value and its raster X and Y coordinates for each pixel in the raster at the specified band. Each centroid represents the geometric center o... | v1.5.1 | -| [RS_PixelAsPoint](RS_PixelAsPoint.md) | Returns a point geometry of the specified pixel's upper-left corner. The pixel coordinates specified are 1-indexed. | v1.5.0 | -| [RS_PixelAsPoints](RS_PixelAsPoints.md) | Returns a list of the pixel's upper-left corner point geometry, the pixel value and its raster X and Y coordinates for each pixel in the raster at the specified band. | v1.5.1 | -| [RS_PixelAsPolygon](RS_PixelAsPolygon.md) | Returns a polygon geometry that bounds the specified pixel. The pixel coordinates specified are 1-indexed. If `colX` and `rowY` are out of bounds for the raster, they are interpolated assuming the ... | v1.5.0 | -| [RS_PixelAsPolygons](RS_PixelAsPolygons.md) | Returns a list of the polygon geometry, the pixel value and its raster X and Y coordinates for each pixel in the raster at the specified band. | v1.5.1 | diff --git a/docs/api/sql/Raster-Accessors/index.md b/docs/api/sql/Raster-Accessors/index.md deleted file mode 100644 index 7aec25210e..0000000000 --- a/docs/api/sql/Raster-Accessors/index.md +++ /dev/null @@ -1,42 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - -# Raster Accessors - -These functions extract metadata and properties from raster objects. - -| Function | Description | Since | -| :--- | :--- | :--- | -| [RS_GeoReference](RS_GeoReference.md) | Returns the georeference metadata of raster as a string in GDAL or ESRI format. Default is GDAL if not specified. | v1.5.0 | -| [RS_GeoTransform](RS_GeoTransform.md) | Returns a struct of parameters that represent the GeoTransformation of the raster. The struct has the following schema: | v1.5.1 | -| [RS_Height](RS_Height.md) | Returns the height of the raster. | v1.5.0 | -| [RS_RasterToWorldCoord](RS_RasterToWorldCoord.md) | Returns the upper left X and Y coordinates of the given row and column of the given raster geometric units of the geo-referenced raster as a Point geometry. If any out of bounds values are given, t... | v1.5.1 | -| [RS_RasterToWorldCoordX](RS_RasterToWorldCoordX.md) | Returns the upper left X coordinate of the given row and column of the given raster geometric units of the geo-referenced raster. If any out of bounds values are given, the X coordinate of the assu... | v1.5.0 | -| [RS_RasterToWorldCoordY](RS_RasterToWorldCoordY.md) | Returns the upper left Y coordinate of the given row and column of the given raster geometric units of the geo-referenced raster. If any out of bounds values are given, the Y coordinate of the assu... | v1.5.0 | -| [RS_Rotation](RS_Rotation.md) | Returns the uniform rotation of the raster in radian. | v1.5.1 | -| [RS_ScaleX](RS_ScaleX.md) | Returns the pixel width of the raster in CRS units. | v1.5.0 | -| [RS_ScaleY](RS_ScaleY.md) | Returns the pixel height of the raster in CRS units. | v1.5.0 | -| [RS_SkewX](RS_SkewX.md) | Returns the X skew or rotation parameter. | v1.5.0 | -| [RS_SkewY](RS_SkewY.md) | Returns the Y skew or rotation parameter. | v1.5.0 | -| [RS_UpperLeftX](RS_UpperLeftX.md) | Returns the X coordinate of the upper-left corner of the raster. | v1.5.0 | -| [RS_UpperLeftY](RS_UpperLeftY.md) | Returns the Y coordinate of the upper-left corner of the raster. | v1.5.0 | -| [RS_Width](RS_Width.md) | Returns the width of the raster. | v1.5.0 | -| [RS_WorldToRasterCoord](RS_WorldToRasterCoord.md) | Returns the grid coordinate of the given world coordinates as a Point. | v1.5.0 | -| [RS_WorldToRasterCoordX](RS_WorldToRasterCoordX.md) | Returns the X coordinate of the grid coordinate of the given world coordinates as an integer. | v1.5.0 | -| [RS_WorldToRasterCoordY](RS_WorldToRasterCoordY.md) | Returns the Y coordinate of the grid coordinate of the given world coordinates as an integer. | v1.5.0 | diff --git a/docs/api/sql/Raster-Aggregate-Functions/index.md b/docs/api/sql/Raster-Aggregate-Functions/index.md deleted file mode 100644 index 545a333640..0000000000 --- a/docs/api/sql/Raster-Aggregate-Functions/index.md +++ /dev/null @@ -1,26 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - -# Raster Aggregate Functions - -These functions perform aggregate operations on groups of rasters. - -| Function | Description | Since | -| :--- | :--- | :--- | -| [RS_Union_Aggr](RS_Union_Aggr.md) | This function combines multiple rasters into a single multiband raster by stacking the bands of each input raster sequentially. The function arranges the bands in the output raster according to the... | v1.5.1 | diff --git a/docs/api/sql/Raster-Band-Accessors/index.md b/docs/api/sql/Raster-Band-Accessors/index.md deleted file mode 100644 index 856ed10177..0000000000 --- a/docs/api/sql/Raster-Band-Accessors/index.md +++ /dev/null @@ -1,34 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - -# Raster Band Accessors - -These functions access band-level properties and statistics of raster objects. - -| Function | Description | Since | -| :--- | :--- | :--- | -| [RS_Band](RS_Band.md) | Returns a new raster consisting 1 or more bands of an existing raster. It can build new rasters from existing ones, export only selected bands from a multiband raster, or rearrange the order of ban... | v1.5.0 | -| [RS_BandIsNoData](RS_BandIsNoData.md) | Returns true if the band is filled with only nodata values. Band 1 is assumed if not specified. | v1.5.0 | -| [RS_BandNoDataValue](RS_BandNoDataValue.md) | Returns the no data value of the given band of the given raster. If no band is given, band 1 is assumed. The band parameter is 1-indexed. If there is no data value associated with the given band, R... | v1.5.0 | -| [RS_BandPixelType](RS_BandPixelType.md) | Returns the datatype of each pixel in the given band of the given raster in string format. The band parameter is 1-indexed. If no band is specified, band 1 is assumed. | v1.5.0 | -| [RS_Count](RS_Count.md) | Returns the number of pixels in a given band. If band is not specified then it defaults to `1`. | v1.5.0 | -| [RS_SummaryStats](RS_SummaryStats.md) | Returns summary statistic for a particular band based on the `statType` parameter. The function defaults to band index of `1` when `band` is not specified and excludes noDataValue if `excludeNoData... | v1.6.0 | -| [RS_SummaryStatsAll](RS_SummaryStatsAll.md) | Returns summary stats struct consisting of count, sum, mean, stddev, min, max for a given band in raster. If band is not specified then it defaults to `1`. | v1.5.0 | -| [RS_ZonalStats](RS_ZonalStats.md) | This returns a statistic value specified by `statType` over the region of interest defined by `zone`. It computes the statistic from the pixel values within the ROI geometry and returns the result.... | v1.5.1 | -| [RS_ZonalStatsAll](RS_ZonalStatsAll.md) | Returns a struct of statistic values, where each statistic is computed over a region defined by the `zone` geometry. The struct has the following schema: | v1.5.1 | diff --git a/docs/api/sql/Raster-Constructors/index.md b/docs/api/sql/Raster-Constructors/index.md deleted file mode 100644 index a573809f1a..0000000000 --- a/docs/api/sql/Raster-Constructors/index.md +++ /dev/null @@ -1,31 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - -# Raster Constructors - -These functions create raster objects from various file formats or from scratch. - -| Function | Description | Since | -| :--- | :--- | :--- | -| [RS_FromArcInfoAsciiGrid](RS_FromArcInfoAsciiGrid.md) | Returns a raster geometry from an Arc Info Ascii Grid file. | v1.4.0 | -| [RS_FromGeoTiff](RS_FromGeoTiff.md) | Returns a raster geometry from a GeoTiff file. | v1.4.0 | -| [RS_FromNetCDF](RS_FromNetCDF.md) | Returns a raster geometry representing the given record variable short name from a NetCDF file. This API reads the array data of the record variable *in memory* along with all its dimensions Since ... | v1.5.1 | -| [RS_MakeEmptyRaster](RS_MakeEmptyRaster.md) | Returns an empty raster geometry. Every band in the raster is initialized to `0.0`. | v1.5.0 | -| [RS_MakeRaster](RS_MakeRaster.md) | Creates a raster from the given array of pixel values. The width, height, geo-reference information, and the CRS will be taken from the given reference raster. The data type of the resulting raster... | v1.6.0 | -| [RS_NetCDFInfo](RS_NetCDFInfo.md) | Returns a string containing names of the variables in a given netCDF file along with its dimensions. | | diff --git a/docs/api/sql/Raster-Functions.md b/docs/api/sql/Raster-Functions.md new file mode 100644 index 0000000000..b2c26ec07a --- /dev/null +++ b/docs/api/sql/Raster-Functions.md @@ -0,0 +1,197 @@ +<!-- + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + --> + +# Raster Functions + +## Raster Constructors + +These functions create raster objects from various file formats or from scratch. + +| Function | Description | Since | +| :--- | :--- | :--- | +| [RS_FromArcInfoAsciiGrid](Raster-Constructors/RS_FromArcInfoAsciiGrid.md) | Returns a raster geometry from an Arc Info Ascii Grid file. | v1.4.0 | +| [RS_FromGeoTiff](Raster-Constructors/RS_FromGeoTiff.md) | Returns a raster geometry from a GeoTiff file. | v1.4.0 | +| [RS_FromNetCDF](Raster-Constructors/RS_FromNetCDF.md) | Returns a raster geometry representing the given record variable short name from a NetCDF file. This API reads the array data of the record variable *in memory* along with all its dimensions Since ... | v1.5.1 | +| [RS_MakeEmptyRaster](Raster-Constructors/RS_MakeEmptyRaster.md) | Returns an empty raster geometry. Every band in the raster is initialized to `0.0`. | v1.5.0 | +| [RS_MakeRaster](Raster-Constructors/RS_MakeRaster.md) | Creates a raster from the given array of pixel values. The width, height, geo-reference information, and the CRS will be taken from the given reference raster. The data type of the resulting raster... | v1.6.0 | +| [RS_NetCDFInfo](Raster-Constructors/RS_NetCDFInfo.md) | Returns a string containing names of the variables in a given netCDF file along with its dimensions. | | + +## Pixel Functions + +These functions work with individual pixel geometry representations. + +| Function | Description | Since | +| :--- | :--- | :--- | +| [RS_PixelAsCentroid](Pixel-Functions/RS_PixelAsCentroid.md) | Returns the centroid (point geometry) of the specified pixel's area. The pixel coordinates specified are 1-indexed. If `colX` and `rowY` are out of bounds for the raster, they are interpolated assu... | v1.5.0 | +| [RS_PixelAsCentroids](Pixel-Functions/RS_PixelAsCentroids.md) | Returns a list of the centroid point geometry, the pixel value and its raster X and Y coordinates for each pixel in the raster at the specified band. Each centroid represents the geometric center o... | v1.5.1 | +| [RS_PixelAsPoint](Pixel-Functions/RS_PixelAsPoint.md) | Returns a point geometry of the specified pixel's upper-left corner. The pixel coordinates specified are 1-indexed. | v1.5.0 | +| [RS_PixelAsPoints](Pixel-Functions/RS_PixelAsPoints.md) | Returns a list of the pixel's upper-left corner point geometry, the pixel value and its raster X and Y coordinates for each pixel in the raster at the specified band. | v1.5.1 | +| [RS_PixelAsPolygon](Pixel-Functions/RS_PixelAsPolygon.md) | Returns a polygon geometry that bounds the specified pixel. The pixel coordinates specified are 1-indexed. If `colX` and `rowY` are out of bounds for the raster, they are interpolated assuming the ... | v1.5.0 | +| [RS_PixelAsPolygons](Pixel-Functions/RS_PixelAsPolygons.md) | Returns a list of the polygon geometry, the pixel value and its raster X and Y coordinates for each pixel in the raster at the specified band. | v1.5.1 | + +## Raster Geometry Functions + +These functions extract geometry representations from rasters. + +| Function | Description | Since | +| :--- | :--- | :--- | +| [RS_ConvexHull](Raster-Geometry-Functions/RS_ConvexHull.md) | Return the convex hull geometry of the raster including the NoDataBandValue band pixels. For regular shaped and non-skewed rasters, this gives more or less the same result as RS_Envelope and hence ... | v1.5.0 | +| [RS_Envelope](Raster-Geometry-Functions/RS_Envelope.md) | Returns the envelope of the raster as a Geometry. | v1.4.0 | +| [RS_MinConvexHull](Raster-Geometry-Functions/RS_MinConvexHull.md) | Returns the min convex hull geometry of the raster **excluding** the NoDataBandValue band pixels, in the given band. If no band is specified, all the bands are considered when creating the min conv... | v1.5.0 | + +## Raster Accessors + +These functions extract metadata and properties from raster objects. + +| Function | Description | Since | +| :--- | :--- | :--- | +| [RS_GeoReference](Raster-Accessors/RS_GeoReference.md) | Returns the georeference metadata of raster as a string in GDAL or ESRI format. Default is GDAL if not specified. | v1.5.0 | +| [RS_GeoTransform](Raster-Accessors/RS_GeoTransform.md) | Returns a struct of parameters that represent the GeoTransformation of the raster. The struct has the following schema: | v1.5.1 | +| [RS_Height](Raster-Accessors/RS_Height.md) | Returns the height of the raster. | v1.5.0 | +| [RS_RasterToWorldCoord](Raster-Accessors/RS_RasterToWorldCoord.md) | Returns the upper left X and Y coordinates of the given row and column of the given raster geometric units of the geo-referenced raster as a Point geometry. If any out of bounds values are given, t... | v1.5.1 | +| [RS_RasterToWorldCoordX](Raster-Accessors/RS_RasterToWorldCoordX.md) | Returns the upper left X coordinate of the given row and column of the given raster geometric units of the geo-referenced raster. If any out of bounds values are given, the X coordinate of the assu... | v1.5.0 | +| [RS_RasterToWorldCoordY](Raster-Accessors/RS_RasterToWorldCoordY.md) | Returns the upper left Y coordinate of the given row and column of the given raster geometric units of the geo-referenced raster. If any out of bounds values are given, the Y coordinate of the assu... | v1.5.0 | +| [RS_Rotation](Raster-Accessors/RS_Rotation.md) | Returns the uniform rotation of the raster in radian. | v1.5.1 | +| [RS_ScaleX](Raster-Accessors/RS_ScaleX.md) | Returns the pixel width of the raster in CRS units. | v1.5.0 | +| [RS_ScaleY](Raster-Accessors/RS_ScaleY.md) | Returns the pixel height of the raster in CRS units. | v1.5.0 | +| [RS_SkewX](Raster-Accessors/RS_SkewX.md) | Returns the X skew or rotation parameter. | v1.5.0 | +| [RS_SkewY](Raster-Accessors/RS_SkewY.md) | Returns the Y skew or rotation parameter. | v1.5.0 | +| [RS_UpperLeftX](Raster-Accessors/RS_UpperLeftX.md) | Returns the X coordinate of the upper-left corner of the raster. | v1.5.0 | +| [RS_UpperLeftY](Raster-Accessors/RS_UpperLeftY.md) | Returns the Y coordinate of the upper-left corner of the raster. | v1.5.0 | +| [RS_Width](Raster-Accessors/RS_Width.md) | Returns the width of the raster. | v1.5.0 | +| [RS_WorldToRasterCoord](Raster-Accessors/RS_WorldToRasterCoord.md) | Returns the grid coordinate of the given world coordinates as a Point. | v1.5.0 | +| [RS_WorldToRasterCoordX](Raster-Accessors/RS_WorldToRasterCoordX.md) | Returns the X coordinate of the grid coordinate of the given world coordinates as an integer. | v1.5.0 | +| [RS_WorldToRasterCoordY](Raster-Accessors/RS_WorldToRasterCoordY.md) | Returns the Y coordinate of the grid coordinate of the given world coordinates as an integer. | v1.5.0 | + +## Raster Band Accessors + +These functions access band-level properties and statistics of raster objects. + +| Function | Description | Since | +| :--- | :--- | :--- | +| [RS_Band](Raster-Band-Accessors/RS_Band.md) | Returns a new raster consisting 1 or more bands of an existing raster. It can build new rasters from existing ones, export only selected bands from a multiband raster, or rearrange the order of ban... | v1.5.0 | +| [RS_BandIsNoData](Raster-Band-Accessors/RS_BandIsNoData.md) | Returns true if the band is filled with only nodata values. Band 1 is assumed if not specified. | v1.5.0 | +| [RS_BandNoDataValue](Raster-Band-Accessors/RS_BandNoDataValue.md) | Returns the no data value of the given band of the given raster. If no band is given, band 1 is assumed. The band parameter is 1-indexed. If there is no data value associated with the given band, R... | v1.5.0 | +| [RS_BandPixelType](Raster-Band-Accessors/RS_BandPixelType.md) | Returns the datatype of each pixel in the given band of the given raster in string format. The band parameter is 1-indexed. If no band is specified, band 1 is assumed. | v1.5.0 | +| [RS_Count](Raster-Band-Accessors/RS_Count.md) | Returns the number of pixels in a given band. If band is not specified then it defaults to `1`. | v1.5.0 | +| [RS_SummaryStats](Raster-Band-Accessors/RS_SummaryStats.md) | Returns summary statistic for a particular band based on the `statType` parameter. The function defaults to band index of `1` when `band` is not specified and excludes noDataValue if `excludeNoData... | v1.6.0 | +| [RS_SummaryStatsAll](Raster-Band-Accessors/RS_SummaryStatsAll.md) | Returns summary stats struct consisting of count, sum, mean, stddev, min, max for a given band in raster. If band is not specified then it defaults to `1`. | v1.5.0 | +| [RS_ZonalStats](Raster-Band-Accessors/RS_ZonalStats.md) | This returns a statistic value specified by `statType` over the region of interest defined by `zone`. It computes the statistic from the pixel values within the ROI geometry and returns the result.... | v1.5.1 | +| [RS_ZonalStatsAll](Raster-Band-Accessors/RS_ZonalStatsAll.md) | Returns a struct of statistic values, where each statistic is computed over a region defined by the `zone` geometry. The struct has the following schema: | v1.5.1 | + +## Raster Predicates + +These functions test spatial relationships involving raster objects. + +| Function | Description | Since | +| :--- | :--- | :--- | +| [RS_Contains](Raster-Predicates/RS_Contains.md) | Returns true if the geometry or raster on the left side contains the geometry or raster on the right side. The convex hull of the raster is considered in the test. | v1.5.0 | +| [RS_Intersects](Raster-Predicates/RS_Intersects.md) | Returns true if raster or geometry on the left side intersects with the raster or geometry on the right side. The convex hull of the raster is considered in the test. | v1.5.0 | +| [RS_Within](Raster-Predicates/RS_Within.md) | Returns true if the geometry or raster on the left side is within the geometry or raster on the right side. The convex hull of the raster is considered in the test. | v1.5.0 | + +## Raster Operators + +These functions perform operations on raster objects. + +| Function | Description | Since | +| :--- | :--- | :--- | +| [RS_AddBand](Raster-Operators/RS_AddBand.md) | Adds a new band to a raster `toRaster` at a specified index `toRasterIndex`. The new band's values are copied from `fromRaster` at a specified band index `fromBand`. If no `toRasterIndex` is provid... | v1.5.0 | +| [RS_Clip](Raster-Operators/RS_Clip.md) | Returns a raster that is clipped by the given geometry. | v1.5.1 | +| [RS_Interpolate](Raster-Operators/RS_Interpolate.md) | This function performs interpolation on a raster using the Inverse Distance Weighted (IDW) method. This method estimates cell values by averaging the values of sample data points in the vicinity of... | v1.6.0 | +| [RS_MetaData](Raster-Operators/RS_MetaData.md) | Returns the metadata of the raster as a struct. The struct has the following schema: | v1.4.1 | +| [RS_NormalizeAll](Raster-Operators/RS_NormalizeAll.md) | Normalizes values in all bands of a raster between a given normalization range. The function maintains the data type of the raster values by ensuring that the normalized values are cast back to the... | v1.6.0 | +| [RS_NumBands](Raster-Operators/RS_NumBands.md) | Returns the number of the bands in the raster. | v1.4.0 | +| [RS_ReprojectMatch](Raster-Operators/RS_ReprojectMatch.md) | Reproject a raster to match the geo-reference, CRS, and envelope of a reference raster. The output raster always have the same extent and resolution as the reference raster. For pixels not covered ... | v1.6.0 | +| [RS_Resample](Raster-Operators/RS_Resample.md) | Resamples a raster using a given resampling algorithm and new dimensions (width and height), a new grid corner to pivot the raster at (gridX and gridY) and a set of georeferencing attributes (scale... | v1.5.0 | +| [RS_SetBandNoDataValue](Raster-Operators/RS_SetBandNoDataValue.md) | This sets the no data value for a specified band in the raster. If the band index is not provided, band 1 is assumed by default. Passing a `null` value for `noDataValue` will remove the no data val... | v1.5.0 | +| [RS_SetGeoReference](Raster-Operators/RS_SetGeoReference.md) | Sets the Georeference information of an object in a single call. Accepts inputs in `GDAL` and `ESRI` format. Default format is `GDAL`. If all 6 parameters are not provided then will return null. | v1.5.0 | +| [RS_SetPixelType](Raster-Operators/RS_SetPixelType.md) | Returns a modified raster with the desired pixel data type. | v1.6.0 | +| [RS_SetSRID](Raster-Operators/RS_SetSRID.md) | Sets the spatial reference system identifier (SRID) of the raster geometry. | v1.4.1 | +| [RS_SetValue](Raster-Operators/RS_SetValue.md) | Returns a raster by replacing the value of pixel specified by `colX` and `rowY`. | v1.5.0 | +| [RS_SetValues](Raster-Operators/RS_SetValues.md) | Returns a raster by replacing the values of pixels in a specified rectangular region. The top left corner of the region is defined by the `colX` and `rowY` coordinates. The `width` and `height` par... | v1.5.0 | +| [RS_SRID](Raster-Operators/RS_SRID.md) | Returns the spatial reference system identifier (SRID) of the raster geometry. | v1.4.1 | +| [RS_Union](Raster-Operators/RS_Union.md) | Returns a combined multi-band raster from 2 or more input Rasters. The order of bands in the resultant raster will be in the order of the input rasters. For example if `RS_Union` is called on two 2... | v1.6.0 | +| [RS_Value](Raster-Operators/RS_Value.md) | Returns the value at the given point in the raster. If no band number is specified it defaults to 1. | v1.4.0 | +| [RS_Values](Raster-Operators/RS_Values.md) | Returns the values at the given points or grid coordinates in the raster. If no band number is specified it defaults to 1. | v1.4.0 | + +## Raster Tiles + +These functions split rasters into tiles. + +| Function | Description | Since | +| :--- | :--- | :--- | +| [RS_Tile](Raster-Tiles/RS_Tile.md) | Returns an array of rasters resulting from the split of the input raster based upon the desired dimensions of the output rasters. | v1.5.1 | +| [RS_TileExplode](Raster-Tiles/RS_TileExplode.md) | Generates records containing raster tiles resulting from the split of the input raster based upon the desired dimensions of the output rasters. | v1.5.0 | + +## Raster Map Algebra Operators + +These functions convert between raster bands and arrays for map algebra operations. + +| Function | Description | Since | +| :--- | :--- | :--- | +| [RS_AddBandFromArray](Raster-Map-Algebra-Operators/RS_AddBandFromArray.md) | Add a band to a raster from an array of doubles. | v1.5.0 | +| [RS_BandAsArray](Raster-Map-Algebra-Operators/RS_BandAsArray.md) | Extract a band from a raster as an array of doubles. | v1.4.1 | +| [RS_MapAlgebra](Raster-Map-Algebra-Operators/RS_MapAlgebra.md) | Apply a map algebra script on a raster. | v1.5.0 | + +## Map Algebra Operators + +These functions perform per-pixel mathematical operations on raster band arrays. + +| Function | Description | Since | +| :--- | :--- | :--- | +| [RS_Add](Map-Algebra-Operators/RS_Add.md) | Add two spectral bands in a Geotiff image | v1.1.0 | +| [RS_Array](Map-Algebra-Operators/RS_Array.md) | Create an array that is filled by the given value | v1.1.0 | +| [RS_BitwiseAND](Map-Algebra-Operators/RS_BitwiseAND.md) | Find Bitwise AND between two bands of Geotiff image | v1.1.0 | +| [RS_BitwiseOR](Map-Algebra-Operators/RS_BitwiseOR.md) | Find Bitwise OR between two bands of Geotiff image | v1.1.0 | +| [RS_CountValue](Map-Algebra-Operators/RS_CountValue.md) | Returns count of a particular value from a spectral band in a raster image | v1.1.0 | +| [RS_Divide](Map-Algebra-Operators/RS_Divide.md) | Divide band1 with band2 from a geotiff image | v1.1.0 | +| [RS_FetchRegion](Map-Algebra-Operators/RS_FetchRegion.md) | Fetch a subset of region from given Geotiff image based on minimumX, minimumY, maximumX and maximumY index as well original height and width of image | v1.1.0 | +| [RS_GreaterThan](Map-Algebra-Operators/RS_GreaterThan.md) | Mask all the values with 1 which are greater than a particular target value | v1.1.0 | +| [RS_GreaterThanEqual](Map-Algebra-Operators/RS_GreaterThanEqual.md) | Mask all the values with 1 which are greater than equal to a particular target value | v1.1.0 | +| [RS_LessThan](Map-Algebra-Operators/RS_LessThan.md) | Mask all the values with 1 which are less than a particular target value | v1.1.0 | +| [RS_LessThanEqual](Map-Algebra-Operators/RS_LessThanEqual.md) | Mask all the values with 1 which are less than equal to a particular target value | v1.1.0 | +| [RS_LogicalDifference](Map-Algebra-Operators/RS_LogicalDifference.md) | Return value from band 1 if a value in band1 and band2 are different, else return 0 | v1.1.0 | +| [RS_LogicalOver](Map-Algebra-Operators/RS_LogicalOver.md) | Return value from band1 if it's not equal to 0, else return band2 value | v1.1.0 | +| [RS_Mean](Map-Algebra-Operators/RS_Mean.md) | Returns Mean value for a spectral band in a Geotiff image | v1.1.0 | +| [RS_Mode](Map-Algebra-Operators/RS_Mode.md) | Returns Mode from a spectral band in a Geotiff image in form of an array | v1.1.0 | +| [RS_Modulo](Map-Algebra-Operators/RS_Modulo.md) | Find modulo of pixels with respect to a particular value | v1.1.0 | +| [RS_Multiply](Map-Algebra-Operators/RS_Multiply.md) | Multiply two spectral bands in a Geotiff image | v1.1.0 | +| [RS_MultiplyFactor](Map-Algebra-Operators/RS_MultiplyFactor.md) | Multiply a factor to a spectral band in a geotiff image | v1.1.0 | +| [RS_Normalize](Map-Algebra-Operators/RS_Normalize.md) | Normalize the value in the array to [0, 255]. Uniform arrays are set to 0 after normalization. | v1.1.0 | +| [RS_NormalizedDifference](Map-Algebra-Operators/RS_NormalizedDifference.md) | Returns Normalized Difference between two bands(band2 and band1) in a Geotiff image(example: NDVI, NDBI) | v1.1.0 | +| [RS_SquareRoot](Map-Algebra-Operators/RS_SquareRoot.md) | Find Square root of band values in a geotiff image | v1.1.0 | +| [RS_Subtract](Map-Algebra-Operators/RS_Subtract.md) | Subtract two spectral bands in a Geotiff image(band2 - band1) | v1.1.0 | + +## Raster Aggregate Functions + +These functions perform aggregate operations on groups of rasters. + +| Function | Description | Since | +| :--- | :--- | :--- | +| [RS_Union_Aggr](Raster-Aggregate-Functions/RS_Union_Aggr.md) | This function combines multiple rasters into a single multiband raster by stacking the bands of each input raster sequentially. The function arranges the bands in the output raster according to the... | v1.5.1 | + +## Raster Output + +These functions convert raster data to various output formats for visualization. + +| Function | Description | Since | +| :--- | :--- | :--- | +| [RS_AsBase64](Raster-Output/RS_AsBase64.md) | Returns a base64 encoded string of the given raster. If the datatype is integral then this function internally takes the first 4 bands as RGBA, and converts them to the PNG format, finally produces... | v1.5.0 | +| [RS_AsImage](Raster-Output/RS_AsImage.md) | Returns a HTML that when rendered using an HTML viewer or via a Jupyter Notebook, displays the raster as a square image of side length `imageWidth`. Optionally, an imageWidth parameter can be passe... | v1.5.0 | +| [RS_AsMatrix](Raster-Output/RS_AsMatrix.md) | Returns a string, that when printed, outputs the raster band as a pretty printed 2D matrix. All the values of the raster are cast to double for the string. RS_AsMatrix allows specifying the number ... | | diff --git a/docs/api/sql/Raster-Geometry-Functions/index.md b/docs/api/sql/Raster-Geometry-Functions/index.md deleted file mode 100644 index 53782792f9..0000000000 --- a/docs/api/sql/Raster-Geometry-Functions/index.md +++ /dev/null @@ -1,28 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - -# Raster Geometry Functions - -These functions extract geometry representations from rasters. - -| Function | Description | Since | -| :--- | :--- | :--- | -| [RS_ConvexHull](RS_ConvexHull.md) | Return the convex hull geometry of the raster including the NoDataBandValue band pixels. For regular shaped and non-skewed rasters, this gives more or less the same result as RS_Envelope and hence ... | v1.5.0 | -| [RS_Envelope](RS_Envelope.md) | Returns the envelope of the raster as a Geometry. | v1.4.0 | -| [RS_MinConvexHull](RS_MinConvexHull.md) | Returns the min convex hull geometry of the raster **excluding** the NoDataBandValue band pixels, in the given band. If no band is specified, all the bands are considered when creating the min conv... | v1.5.0 | diff --git a/docs/api/sql/Raster-Map-Algebra-Operators/index.md b/docs/api/sql/Raster-Map-Algebra-Operators/index.md deleted file mode 100644 index 252f2c70e7..0000000000 --- a/docs/api/sql/Raster-Map-Algebra-Operators/index.md +++ /dev/null @@ -1,28 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - -# Raster Map Algebra Operators - -These functions convert between raster bands and arrays for map algebra operations. - -| Function | Description | Since | -| :--- | :--- | :--- | -| [RS_AddBandFromArray](RS_AddBandFromArray.md) | Add a band to a raster from an array of doubles. | v1.5.0 | -| [RS_BandAsArray](RS_BandAsArray.md) | Extract a band from a raster as an array of doubles. | v1.4.1 | -| [RS_MapAlgebra](RS_MapAlgebra.md) | Apply a map algebra script on a raster. | v1.5.0 | diff --git a/docs/api/sql/Raster-Operators/index.md b/docs/api/sql/Raster-Operators/index.md deleted file mode 100644 index a3bfa3bbac..0000000000 --- a/docs/api/sql/Raster-Operators/index.md +++ /dev/null @@ -1,43 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - -# Raster Operators - -These functions perform operations on raster objects. - -| Function | Description | Since | -| :--- | :--- | :--- | -| [RS_AddBand](RS_AddBand.md) | Adds a new band to a raster `toRaster` at a specified index `toRasterIndex`. The new band's values are copied from `fromRaster` at a specified band index `fromBand`. If no `toRasterIndex` is provid... | v1.5.0 | -| [RS_Clip](RS_Clip.md) | Returns a raster that is clipped by the given geometry. | v1.5.1 | -| [RS_Interpolate](RS_Interpolate.md) | This function performs interpolation on a raster using the Inverse Distance Weighted (IDW) method. This method estimates cell values by averaging the values of sample data points in the vicinity of... | v1.6.0 | -| [RS_MetaData](RS_MetaData.md) | Returns the metadata of the raster as a struct. The struct has the following schema: | v1.4.1 | -| [RS_NormalizeAll](RS_NormalizeAll.md) | Normalizes values in all bands of a raster between a given normalization range. The function maintains the data type of the raster values by ensuring that the normalized values are cast back to the... | v1.6.0 | -| [RS_NumBands](RS_NumBands.md) | Returns the number of the bands in the raster. | v1.4.0 | -| [RS_ReprojectMatch](RS_ReprojectMatch.md) | Reproject a raster to match the geo-reference, CRS, and envelope of a reference raster. The output raster always have the same extent and resolution as the reference raster. For pixels not covered ... | v1.6.0 | -| [RS_Resample](RS_Resample.md) | Resamples a raster using a given resampling algorithm and new dimensions (width and height), a new grid corner to pivot the raster at (gridX and gridY) and a set of georeferencing attributes (scale... | v1.5.0 | -| [RS_SetBandNoDataValue](RS_SetBandNoDataValue.md) | This sets the no data value for a specified band in the raster. If the band index is not provided, band 1 is assumed by default. Passing a `null` value for `noDataValue` will remove the no data val... | v1.5.0 | -| [RS_SetGeoReference](RS_SetGeoReference.md) | Sets the Georeference information of an object in a single call. Accepts inputs in `GDAL` and `ESRI` format. Default format is `GDAL`. If all 6 parameters are not provided then will return null. | v1.5.0 | -| [RS_SetPixelType](RS_SetPixelType.md) | Returns a modified raster with the desired pixel data type. | v1.6.0 | -| [RS_SetSRID](RS_SetSRID.md) | Sets the spatial reference system identifier (SRID) of the raster geometry. | v1.4.1 | -| [RS_SetValue](RS_SetValue.md) | Returns a raster by replacing the value of pixel specified by `colX` and `rowY`. | v1.5.0 | -| [RS_SetValues](RS_SetValues.md) | Returns a raster by replacing the values of pixels in a specified rectangular region. The top left corner of the region is defined by the `colX` and `rowY` coordinates. The `width` and `height` par... | v1.5.0 | -| [RS_SRID](RS_SRID.md) | Returns the spatial reference system identifier (SRID) of the raster geometry. | v1.4.1 | -| [RS_Union](RS_Union.md) | Returns a combined multi-band raster from 2 or more input Rasters. The order of bands in the resultant raster will be in the order of the input rasters. For example if `RS_Union` is called on two 2... | v1.6.0 | -| [RS_Value](RS_Value.md) | Returns the value at the given point in the raster. If no band number is specified it defaults to 1. | v1.4.0 | -| [RS_Values](RS_Values.md) | Returns the values at the given points or grid coordinates in the raster. If no band number is specified it defaults to 1. | v1.4.0 | diff --git a/docs/api/sql/Raster-Output/index.md b/docs/api/sql/Raster-Output/index.md deleted file mode 100644 index 725acfa293..0000000000 --- a/docs/api/sql/Raster-Output/index.md +++ /dev/null @@ -1,28 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - -# Raster Output - -These functions convert raster data to various output formats for visualization. - -| Function | Description | Since | -| :--- | :--- | :--- | -| [RS_AsBase64](RS_AsBase64.md) | Returns a base64 encoded string of the given raster. If the datatype is integral then this function internally takes the first 4 bands as RGBA, and converts them to the PNG format, finally produces... | v1.5.0 | -| [RS_AsImage](RS_AsImage.md) | Returns a HTML that when rendered using an HTML viewer or via a Jupyter Notebook, displays the raster as a square image of side length `imageWidth`. Optionally, an imageWidth parameter can be passe... | v1.5.0 | -| [RS_AsMatrix](RS_AsMatrix.md) | Returns a string, that when printed, outputs the raster band as a pretty printed 2D matrix. All the values of the raster are cast to double for the string. RS_AsMatrix allows specifying the number ... | | diff --git a/docs/api/sql/Raster-Predicates/index.md b/docs/api/sql/Raster-Predicates/index.md deleted file mode 100644 index d43dce8a96..0000000000 --- a/docs/api/sql/Raster-Predicates/index.md +++ /dev/null @@ -1,28 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - -# Raster Predicates - -These functions test spatial relationships involving raster objects. - -| Function | Description | Since | -| :--- | :--- | :--- | -| [RS_Contains](RS_Contains.md) | Returns true if the geometry or raster on the left side contains the geometry or raster on the right side. The convex hull of the raster is considered in the test. | v1.5.0 | -| [RS_Intersects](RS_Intersects.md) | Returns true if raster or geometry on the left side intersects with the raster or geometry on the right side. The convex hull of the raster is considered in the test. | v1.5.0 | -| [RS_Within](RS_Within.md) | Returns true if the geometry or raster on the left side is within the geometry or raster on the right side. The convex hull of the raster is considered in the test. | v1.5.0 | diff --git a/docs/api/sql/Raster-Tiles/index.md b/docs/api/sql/Raster-Tiles/index.md deleted file mode 100644 index 1fbf333284..0000000000 --- a/docs/api/sql/Raster-Tiles/index.md +++ /dev/null @@ -1,27 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - -# Raster Tiles - -These functions split rasters into tiles. - -| Function | Description | Since | -| :--- | :--- | :--- | -| [RS_Tile](RS_Tile.md) | Returns an array of rasters resulting from the split of the input raster based upon the desired dimensions of the output rasters. | v1.5.1 | -| [RS_TileExplode](RS_TileExplode.md) | Generates records containing raster tiles resulting from the split of the input raster based upon the desired dimensions of the output rasters. | v1.5.0 | diff --git a/docs/api/sql/Raster-loader.md b/docs/api/sql/Raster-loader.md index e769ab8a2f..b062471b6d 100644 --- a/docs/api/sql/Raster-loader.md +++ b/docs/api/sql/Raster-loader.md @@ -91,7 +91,7 @@ One difference from other file source loaders is that when the loaded path ends The raster loader of Sedona leverages Spark built-in binary data source and works with several RS constructors to produce Raster type. Each raster is a row in the resulting DataFrame and stored in a `Raster` format. !!!tip - After loading rasters, you can quickly visualize them in a Jupyter notebook using `SedonaUtils.display_image(df)`. It automatically detects raster columns and renders them as images. See [Raster visualizer docs](Raster-Output/index.md) for details. + After loading rasters, you can quickly visualize them in a Jupyter notebook using `SedonaUtils.display_image(df)`. It automatically detects raster columns and renders them as images. See [Raster visualizer docs](Raster-Functions.md#raster-output) for details. By default, these functions uses lon/lat order since `v1.5.0`. Before, it used lat/lon order. @@ -111,4 +111,4 @@ Use one of the following raster constructors to create a Raster DataFrame: - [RS_FromGeoTiff](Raster-Constructors/RS_FromGeoTiff.md) - Create raster from GeoTiff files - [RS_MakeEmptyRaster](Raster-Constructors/RS_MakeEmptyRaster.md) - Create an empty raster geometry -See the full list of [Raster Constructors](Raster-Constructors/index.md) for more options. +See the full list of [Raster Constructors](Raster-Functions.md#raster-constructors) for more options. diff --git a/docs/api/sql/Raster-map-algebra.md b/docs/api/sql/Raster-map-algebra.md index 05d2099d79..b150ca4b9e 100644 --- a/docs/api/sql/Raster-map-algebra.md +++ b/docs/api/sql/Raster-map-algebra.md @@ -22,7 +22,7 @@ Map algebra is a way to perform raster calculations using mathematical expressions. The expression can be a simple arithmetic operation or a complex combination of multiple operations. The expression can be applied to a single raster band or multiple raster bands. The result of the expression is a new raster. !!!tip - To visually inspect the result of a map algebra operation in a Jupyter notebook, use `SedonaUtils.display_image(df)`. It automatically detects raster columns and renders them as images. See [Raster Output docs](Raster-Output/index.md) for details. + To visually inspect the result of a map algebra operation in a Jupyter notebook, use `SedonaUtils.display_image(df)`. It automatically detects raster columns and renders them as images. See [Raster Output docs](Raster-Functions.md#raster-output) for details. Apache Sedona provides two ways to perform map algebra operations: @@ -142,4 +142,4 @@ FROM raster_table) t ### Further Reading * [Jiffle language summary](https://github.com/geosolutions-it/jai-ext/wiki/Jiffle---language-summary) -* [Raster operators](Raster-Operators/index.md) +* [Raster operators](Raster-Functions.md#raster-operators) diff --git a/docs/api/sql/geography/Geography-Constructors/index.md b/docs/api/sql/geography/Geography-Constructors/index.md deleted file mode 100644 index dc00b671af..0000000000 --- a/docs/api/sql/geography/Geography-Constructors/index.md +++ /dev/null @@ -1,32 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - -# Geography Constructors - -These functions create geography objects from various formats. - -| Function | Description | Since | -| :--- | :--- | :--- | -| [ST_GeogFromEWKB](ST_GeogFromEWKB.md) | Construct a Geography from EWKB Binary. This function is an alias of [ST_GeogFromWKB](ST_GeogFromWKB.md). | v1.8.0 | -| [ST_GeogFromEWKT](ST_GeogFromEWKT.md) | Construct a Geography from OGC Extended WKT. | v1.8.0 | -| [ST_GeogFromGeoHash](ST_GeogFromGeoHash.md) | Create Geography from geohash string and optional precision | v1.8.0 | -| [ST_GeogFromWKB](ST_GeogFromWKB.md) | Construct a Geography from WKB Binary. | v1.8.0 | -| [ST_GeogFromWKT](ST_GeogFromWKT.md) | Construct a Geography from WKT. If SRID is not set, it defaults to 0 (unknown). | v1.8.0 | -| [ST_GeogToGeometry](ST_GeogToGeometry.md) | This function constructs a planar Geometry object from a Geography. While Sedona makes every effort to preserve the original spatial object, the conversion is not always exact because Geography and... | v1.8.0 | -| [ST_GeomToGeography](ST_GeomToGeography.md) | This function constructs a Geography object from a planar Geometry. This function is intended for geometries defined in a Geographic Coordinate Reference System (CRS), most commonly WGS84 (EPSG:432... | v1.8.0 | diff --git a/docs/api/sql/geography/Geography-Functions.md b/docs/api/sql/geography/Geography-Functions.md new file mode 100644 index 0000000000..5f55bc6e1f --- /dev/null +++ b/docs/api/sql/geography/Geography-Functions.md @@ -0,0 +1,43 @@ +<!-- + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + --> + +# Geography Functions + +## Geography Constructors + +These functions create geography objects from various formats. + +| Function | Description | Since | +| :--- | :--- | :--- | +| [ST_GeogFromEWKB](Geography-Constructors/ST_GeogFromEWKB.md) | Construct a Geography from EWKB Binary. This function is an alias of [ST_GeogFromWKB](Geography-Constructors/ST_GeogFromWKB.md). | v1.8.0 | +| [ST_GeogFromEWKT](Geography-Constructors/ST_GeogFromEWKT.md) | Construct a Geography from OGC Extended WKT. | v1.8.0 | +| [ST_GeogFromGeoHash](Geography-Constructors/ST_GeogFromGeoHash.md) | Create Geography from geohash string and optional precision | v1.8.0 | +| [ST_GeogFromWKB](Geography-Constructors/ST_GeogFromWKB.md) | Construct a Geography from WKB Binary. | v1.8.0 | +| [ST_GeogFromWKT](Geography-Constructors/ST_GeogFromWKT.md) | Construct a Geography from WKT. If SRID is not set, it defaults to 0 (unknown). | v1.8.0 | +| [ST_GeogToGeometry](Geography-Constructors/ST_GeogToGeometry.md) | This function constructs a planar Geometry object from a Geography. While Sedona makes every effort to preserve the original spatial object, the conversion is not always exact because Geography and... | v1.8.0 | +| [ST_GeomToGeography](Geography-Constructors/ST_GeomToGeography.md) | This function constructs a Geography object from a planar Geometry. This function is intended for geometries defined in a Geographic Coordinate Reference System (CRS), most commonly WGS84 (EPSG:432... | v1.8.0 | + +## Geography Functions + +These functions operate on geography type objects. + +| Function | Description | Since | +| :--- | :--- | :--- | +| [ST_AsEWKT](Geography-Functions/ST_AsEWKT.md) | Return the Extended Well-Known Text representation of a geography. EWKT is an extended version of WKT which includes the SRID of the geography. The format originated in PostGIS but is supported by ... | v1.8.0 | +| [ST_Envelope](Geography-Functions/ST_Envelope.md) | This function returns the bounding box (envelope) of A. It's important to note that the bounding box is calculated using a cylindrical topology, not a spherical one. If the envelope crosses the ant... | v1.8.0 | diff --git a/docs/api/sql/geography/Geography-Functions/index.md b/docs/api/sql/geography/Geography-Functions/index.md deleted file mode 100644 index 107dcf5261..0000000000 --- a/docs/api/sql/geography/Geography-Functions/index.md +++ /dev/null @@ -1,27 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - -# Geography Functions - -These functions operate on geography type objects. - -| Function | Description | Since | -| :--- | :--- | :--- | -| [ST_AsEWKT](ST_AsEWKT.md) | Return the Extended Well-Known Text representation of a geography. EWKT is an extended version of WKT which includes the SRID of the geography. The format originated in PostGIS but is supported by ... | v1.8.0 | -| [ST_Envelope](ST_Envelope.md) | This function returns the bounding box (envelope) of A. It's important to note that the bounding box is calculated using a cylindrical topology, not a spherical one. If the envelope crosses the ant... | v1.8.0 | diff --git a/docs/setup/release-notes.md b/docs/setup/release-notes.md index 5aad84ded8..b17107a761 100644 --- a/docs/setup/release-notes.md +++ b/docs/setup/release-notes.md @@ -1556,7 +1556,7 @@ Sedona 1.4.1 is compiled against Spark 3.3 / Spark 3.4 / Flink 1.12, Java 8. ### Highlights -* [X] **Sedona Spark** More raster functions and bridge RasterUDT and Map Algebra operators. See [Raster based operators](../api/sql/Raster-Operators/index.md) and [Raster to Map Algebra operators](../api/sql/Raster-Map-Algebra-Operators/index.md). +* [X] **Sedona Spark** More raster functions and bridge RasterUDT and Map Algebra operators. See [Raster based operators](../api/sql/Raster-Functions.md#raster-operators) and [Raster to Map Algebra operators](../api/sql/Raster-Functions.md#raster-map-algebra-operators). * [X] **Sedona Spark & Flink** Added geodesic / geography functions: * ST_DistanceSphere * ST_DistanceSpheroid diff --git a/docs/tutorial/raster.md b/docs/tutorial/raster.md index e95fb37d8d..79f392c2f0 100644 --- a/docs/tutorial/raster.md +++ b/docs/tutorial/raster.md @@ -301,7 +301,7 @@ World files are used to georeference and geolocate images by establishing an ima Since `v1.5.0` there have been many additions to manipulate raster data, we will show you a few example queries. !!!note - Read [SedonaSQL Raster operators](../api/sql/Raster-Operators/index.md) to learn how you can use Sedona for raster manipulation. + Read [SedonaSQL Raster operators](../api/sql/Raster-Functions.md#raster-operators) to learn how you can use Sedona for raster manipulation. ### Coordinate translation @@ -446,7 +446,7 @@ SELECT r.rast, g.geom FROM rasterDf r, geomDf g WHERE RS_Interest(r.rast, g.geom !!!note These range and join queries will filter rasters using the provided geometric boundary and the spatial boundary of the raster. - Sedona offers more raster predicates to do spatial range queries and spatial join queries. Please refer to [raster predicates docs](../api/sql/Raster-Predicates/index.md). + Sedona offers more raster predicates to do spatial range queries and spatial join queries. Please refer to [raster predicates docs](../api/sql/Raster-Functions.md#raster-predicates). ## Visualize raster images @@ -481,7 +481,7 @@ The output looks like this: SedonaUtils.display_image(rasterDf) ``` - See [Display raster in Jupyter](../api/sql/Raster-Output/index.md) for details. + See [Display raster in Jupyter](../api/sql/Raster-Functions.md#raster-output) for details. ### 2-D Matrix @@ -499,7 +499,7 @@ Output will be as follows: | 3 4 5 6| ``` -Please refer to [Raster visualizer docs](../api/sql/Raster-Output/index.md) to learn how to make the most of the visualizing APIs. +Please refer to [Raster visualizer docs](../api/sql/Raster-Functions.md#raster-output) to learn how to make the most of the visualizing APIs. ## Save to permanent storage diff --git a/mkdocs.yml b/mkdocs.yml index 6e631b7701..cbc5573b94 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -72,11 +72,8 @@ nav: - SQL: - Quick start: api/sql/Overview.md - Vector data: - - Geometry type: - - Geometry Functions: api/sql/Geometry-Functions.md - - Geography type: - - Geography Constructors: api/sql/geography/Geography-Constructors/index.md - - Geography Functions: api/sql/geography/Geography-Functions/index.md + - Geometry Functions: api/sql/Geometry-Functions.md + - Geography Functions: api/sql/geography/Geography-Functions.md - DataFrame Style functions: api/sql/DataFrameAPI.md - Query optimization: api/sql/Optimizer.md - CRS Transformation: api/sql/CRS-Transformation.md @@ -88,18 +85,7 @@ nav: - SedonaKepler: api/sql/Visualization-SedonaKepler.md - Raster data: - Raster loader: api/sql/Raster-loader.md - - Raster Constructors: api/sql/Raster-Constructors/index.md - - Pixel Functions: api/sql/Pixel-Functions/index.md - - Raster Geometry Functions: api/sql/Raster-Geometry-Functions/index.md - - Raster Accessors: api/sql/Raster-Accessors/index.md - - Raster Band Accessors: api/sql/Raster-Band-Accessors/index.md - - Raster Predicates: api/sql/Raster-Predicates/index.md - - Raster Operators: api/sql/Raster-Operators/index.md - - Raster Tiles: api/sql/Raster-Tiles/index.md - - Raster Map Algebra Operators: api/sql/Raster-Map-Algebra-Operators/index.md - - Map Algebra Operators: api/sql/Map-Algebra-Operators/index.md - - Raster Aggregate Functions: api/sql/Raster-Aggregate-Functions/index.md - - Raster Output: api/sql/Raster-Output/index.md + - Raster Functions: api/sql/Raster-Functions.md - Raster writer: api/sql/Raster-writer.md - Raster map algebra: api/sql/Raster-map-algebra.md - Raster affine transformation: api/sql/Raster-affine-transformation.md
