[postgis-tickets] [SCM] PostGIS branch master updated. 3.1.0alpha1-35-g10f91f0

[git at osgeo.org]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "PostGIS".

The branch, master has been updated
       via  10f91f070e04ffa7866560b682694b584de54b4e (commit)
       via  139613cdbaab7d72633925b2f8d848d58644829d (commit)
       via  a975224659e694cd22970b3fe3f8b1add919be58 (commit)
      from  2f7b95e6b7e783c1ed9260c217c0d237ea3bd9a6 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 10f91f070e04ffa7866560b682694b584de54b4e
Author: Regina Obe <lr at pcorp.us>
Date:   Wed Mar 4 21:06:41 2020 -0500

    Add example for ST_BandPath, and correct notice, just returns null,not error for in db

diff --git a/doc/reference_raster.xml b/doc/reference_raster.xml
index ac9a4ac..69e37a2 100644
--- a/doc/reference_raster.xml
+++ b/doc/reference_raster.xml
@@ -4011,15 +4011,15 @@ select st_bandisnodata(rast, 2) from dummy_rast where rid = 1; -- Expected false
 			<refsection>
 				<title>Description</title>
 
-				<para>Returns system file path to a band.  Throws an error if called with an in db band.</para>
+				<para>Returns system file path to a band.  Returns null for in db raster bands.</para>
 				</refsection>
 
 				<refsection>
 					<title>Examples</title>
 
-					<programlisting><!-- TODO: -->
-					</programlisting>
-
+					<programlisting>SELECT rid, ST_BandPath(rast,1) AS file_path
+FROM dem
+LIMIT 1;</programlisting>
 			</refsection>
 
 			<refsection>

commit 139613cdbaab7d72633925b2f8d848d58644829d
Merge: a975224 2f7b95e
Author: Regina Obe <lr at pcorp.us>
Date:   Wed Mar 4 20:42:00 2020 -0500

    Merge branch 'master' of https://git.osgeo.org/gitea/postgis/postgis


commit a975224659e694cd22970b3fe3f8b1add919be58
Author: Regina Obe <lr at pcorp.us>
Date:   Fri Feb 21 22:53:56 2020 -0500

    Explain more what ST_Transform axis aligned does

diff --git a/doc/reference_raster.xml b/doc/reference_raster.xml
index 7cf5587..b04f6cf 100644
--- a/doc/reference_raster.xml
+++ b/doc/reference_raster.xml
@@ -6942,9 +6942,13 @@ SELECT rid, (meta).* FROM bar
 					ST_Transform is often confused with ST_SetSRID(). ST_Transform actually changes the coordinates of a raster (and resamples the pixel values) from one spatial reference system to another, while ST_SetSRID() simply changes the SRID identifier of the raster.
 				</para>
 
-				<para>
-					Unlike the other variants, Variant 3 requires a reference raster as <varname>alignto</varname>. The transformed raster will be transformed to the spatial reference system (SRID) of the reference raster and be aligned (ST_SameAlignment = TRUE) to the reference raster.
-				</para>
+				<note>
+					<para>
+						If you are transforming more than one tile, such as a table of coverage rasters you should use the <code>ST_Transform(rast,alignto)</code> (Variant 3)
+						to ensure the tiles will all have same alignment (needed by many operations such as ST_Union) and minimize on gaps between tiles.
+					</para>
+					<para>Unlike the other variants, Variant 3 requires a reference raster as <varname>alignto</varname>. The transformed raster will be transformed to the spatial reference system (SRID) of the reference raster and be aligned (ST_SameAlignment = TRUE) to the reference raster.</para>
+				</note>
 
 				<note>
 					<para>
@@ -6952,8 +6956,9 @@ SELECT rid, (meta).* FROM bar
 					</para>
 				</note>
 
-				<para>Availability: 2.0.0  Requires GDAL 1.6.1+</para>
 				<para>Enhanced: 2.1.0 Addition of ST_Transform(rast, alignto) variant</para>
+				<para>Availability: 2.0.0  Requires GDAL 1.6.1+</para>
+				
 			</refsection>
 
 			<refsection>

-----------------------------------------------------------------------

Summary of changes:
 doc/reference_raster.xml | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)


hooks/post-receive
-- 
PostGIS