added option to buffer bbox_list obtained from AreaSplitters

Author: AleksMat

sentinelhub/areas.py

@@ -75,16 +75,28 @@ def _make_split(self):
         """
         raise NotImplementedError
 
-    def get_bbox_list(self, crs=None):
+    def get_bbox_list(self, crs=None, buffer=None, reduce_bbox_sizes=None):
         """Returns a list of bounding boxes that are the result of the split
 
         :param crs: Coordinate reference system in which the bounding boxes should be returned. If None the CRS will
                     be the default CRS of the splitter.
         :type crs: CRS or None
+        :param buffer: A percentage of each BBox size increase. This will cause neighbouring bounding boxes to overlap.
+        :type buffer: float or None
+        :param reduce_bbox_sizes: If `True` it will reduce the sizes of bounding boxes so that they will tightly
+            fit the given geometry in `shape_list`. This overrides the same parameter from constructor
+        :type reduce_bbox_sizes: bool
         :return: List of bounding boxes
         :rtype: list(BBox)
         """
-        bbox_list = self._reduce_sizes(self.bbox_list) if self.reduce_bbox_sizes else self.bbox_list
+        bbox_list = self.bbox_list
+        if buffer:
+            bbox_list = [bbox.buffer(buffer) for bbox in bbox_list]
+
+        if reduce_bbox_sizes is None:
+            reduce_bbox_sizes = self.reduce_bbox_sizes
+        if reduce_bbox_sizes:
+            bbox_list = self._reduce_sizes(bbox_list)
 
         if crs:
             return [bbox.transform(crs) for bbox in bbox_list]

sentinelhub/geometry.py

@@ -243,7 +243,7 @@ def buffer(self, buffer):
         """ Changes both BBox dimensions (width and height) by a percentage of size of each dimension. If number is
         negative, the size will decrease. Returns a new instance of BBox object.
 
-        :param buffer: A percentage
+        :param buffer: A percentage of BBox size change
         :type buffer: float
         :return: A new bounding box of buffered size
         :rtype: BBox

tests/test_areas.py

@@ -46,7 +46,7 @@ def test_return_type(self):
         for test_case in self.test_cases:
             with self.subTest(msg='Test case {}'.format(test_case.name)):
                 return_lists = [
-                    (test_case.splitter.get_bbox_list(), BBox),
+                    (test_case.splitter.get_bbox_list(buffer=0.2), BBox),
                     (test_case.splitter.get_info_list(), dict),
                     (test_case.splitter.get_geometry_list(), (shapely.geometry.Polygon, shapely.geometry.MultiPolygon))
                 ]