Changes between Version 5 and Version 6 of rfc59.1_utilities_as_a_library

Timestamp:

Jan 13, 2016, 7:15:51 AM (8 years ago)

Author:

Even Rouault

Comment:

Mention GDALBuildVRT()

rfc59.1_utilities_as_a_library

@@ -662 +662 @@
 }}}
 
+{{{
+def BuildVRTOptions(options = [],
+                    resolution = None,
+                    outputBounds = None,
+                    xRes = None, yRes = None,
+                    targetAlignedPixels = None,
+                    separate = None,
+                    bandList = None,
+                    addAlpha = None,
+                    resampleAlg = None,
+                    outputSRS = None,
+                    allowProjectionDifference = None,
+                    srcNodata = None,
+                    VRTNodata = None,
+                    hideNodata = None,
+                    callback = None, callback_data = None):
+    """ Create a BuildVRTOptions() object that can be passed to gdal.BuildVRT()
+        Keyword arguments are :
+          options --- can be be an array of strings, a string or let empty and filled from other keywords..
+          resolution --- 'highest', 'lowest', 'average', 'user'.
+          outputBounds --- output bounds as (minX, minY, maxX, maxY) in target SRS.
+          xRes, yRes --- output resolution in target SRS.
+          targetAlignedPixels --- whether to force output bounds to be multiple of output resolution.
+          separate --- whether each source file goes into a separate stacked band in the VRT band.
+          bandList --- array of band numbers (index start at 1).
+          addAlpha --- whether to add an alpha mask band to the VRT when the source raster have none.
+          resampleAlg --- resampling mode.
+          outputSRS --- assigned output SRS.
+          allowProjectionDifference --- whether to accept input datasets have not the same projection. Note: they will *not* be reprojected.
+          srcNodata --- source nodata value(s).
+          VRTNodata --- nodata values at the VRT band level.
+          hideNodata --- whether to make the VRT band not report the NoData value.
+          callback --- callback method.
+          callback_data --- user data for callback.
+    """
+
+def BuildVRT(destName, srcDSOrSrcDSTab, **kwargs):
+    """ Build a VRT from a list of datasets.
+        Arguments are :
+          destName --- Output dataset name
+          srcDSOrSrcDSTab --- an array of Dataset objects or filenames, or a Dataset object or a filename
+        Keyword arguments are :
+          options --- return of gdal.InfoOptions(), string or array of strings
+          other keywords arguments of gdal.BuildVRTOptions()
+        If options is provided as a gdal.BuildVRTOptions() object, other keywords are ignored. """
+}}}
+
 == Utilities ==
 
@@ -687 +734 @@
 
 gdal.Rasterize method is tested in [http://svn.osgeo.org/gdal/trunk/autotest/utilities/test_gdal_rasterize_lib.py test_gdal_rasterize_lib.py].
+
+gdal.BuildVRT method is tested in [http://svn.osgeo.org/gdal/trunk/autotest/utilities/test_gdalbuildvrt_lib.py test_gdalbuildvrt_lib.py].
 
 == Compatibility Issues ==