deepdoctection 0.37.3__tar.gz → 0.39__tar.gz

{deepdoctection-0.37.3 → deepdoctection-0.39}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: deepdoctection
-Version: 0.37.3
+Version: 0.39
 Summary: Repository for Document AI
 Home-page: https://github.com/deepdoctection/deepdoctection
 Author: Dr. Janis Meyer
@@ -17,7 +17,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: catalogue==2.0.10
-Requires-Dist: huggingface_hub<0.26,>=0.12.0
+Requires-Dist: huggingface_hub>=0.26.0
 Requires-Dist: importlib-metadata>=5.0.0
 Requires-Dist: jsonlines==3.1.0
 Requires-Dist: lazy-imports==0.3.1
@@ -36,7 +36,7 @@ Requires-Dist: tabulate>=0.7.7
 Requires-Dist: tqdm==4.64.0
 Provides-Extra: tf
 Requires-Dist: catalogue==2.0.10; extra == "tf"
-Requires-Dist: huggingface_hub<0.26,>=0.12.0; extra == "tf"
+Requires-Dist: huggingface_hub>=0.26.0; extra == "tf"
 Requires-Dist: importlib-metadata>=5.0.0; extra == "tf"
 Requires-Dist: jsonlines==3.1.0; extra == "tf"
 Requires-Dist: lazy-imports==0.3.1; extra == "tf"
@@ -68,7 +68,7 @@ Requires-Dist: distance==0.1.3; extra == "tf"
 Requires-Dist: lxml>=4.9.1; extra == "tf"
 Provides-Extra: pt
 Requires-Dist: catalogue==2.0.10; extra == "pt"
-Requires-Dist: huggingface_hub<0.26,>=0.12.0; extra == "pt"
+Requires-Dist: huggingface_hub>=0.26.0; extra == "pt"
 Requires-Dist: importlib-metadata>=5.0.0; extra == "pt"
 Requires-Dist: jsonlines==3.1.0; extra == "pt"
 Requires-Dist: lazy-imports==0.3.1; extra == "pt"
@@ -127,6 +127,16 @@ Requires-Dist: types-urllib3>=1.26.25.14; extra == "dev"
 Provides-Extra: test
 Requires-Dist: pytest==8.0.2; extra == "test"
 Requires-Dist: pytest-cov; extra == "test"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 
 <p align="center">

{deepdoctection-0.37.3 → deepdoctection-0.39}/deepdoctection/__init__.py

@@ -6,6 +6,7 @@ Init file for deepdoctection package. This file is used to import all submodules
 """
 
 import importlib.util
+import os
 
 # Before doing anything else, check if the .env file exists and load it
 if importlib.util.find_spec("dotenv") is not None:
@@ -24,7 +25,7 @@ from .utils.logger import LoggingRecord, logger
 
 # pylint: enable=wrong-import-position
 
-__version__ = "0.37.3"
+__version__ = "0.39"
 
 _IMPORT_STRUCTURE = {
     "analyzer": ["config_sanity_checks", "get_dd_analyzer", "ServiceFactory"],
@@ -423,6 +424,9 @@ _IMPORT_STRUCTURE = {
 env_info = collect_env_info()
 logger.debug(LoggingRecord(msg=env_info))
 auto_select_pdf_render_framework()
+os.environ["DPI"] = "300"
+os.environ["IMAGE_WIDTH"] = ""
+os.environ["IMAGE_HEIGHT"] = ""
 
 # Direct imports for type-checking
 if TYPE_CHECKING:

{deepdoctection-0.37.3 → deepdoctection-0.39}/deepdoctection/analyzer/_config.py

@@ -91,7 +91,8 @@ cfg.SEGMENTATION.PUBTABLES_SUB_ITEM_NAMES = [CellType.ROW_NUMBER, CellType.COLUM
 cfg.SEGMENTATION.CELL_NAMES = [CellType.HEADER, CellType.BODY, LayoutType.CELL]
 cfg.SEGMENTATION.ITEM_NAMES = [LayoutType.ROW, LayoutType.COLUMN]
 cfg.SEGMENTATION.SUB_ITEM_NAMES = [CellType.ROW_NUMBER, CellType.COLUMN_NUMBER]
-
+cfg.SEGMENTATION.PUBTABLES_ITEM_HEADER_CELL_NAMES = [CellType.COLUMN_HEADER, CellType.ROW_HEADER]
+cfg.SEGMENTATION.PUBTABLES_ITEM_HEADER_THRESHOLDS = [0.6, 0.0001]
 cfg.SEGMENTATION.STRETCH_RULE = "equal"
 
 cfg.USE_TABLE_REFINEMENT = True

{deepdoctection-0.37.3 → deepdoctection-0.39}/deepdoctection/analyzer/dd.py

@@ -32,7 +32,6 @@ from ..extern.pt.ptutils import get_torch_device
 from ..extern.tp.tfutils import disable_tp_layer_logging, get_tf_device
 from ..pipe.doctectionpipe import DoctectionPipe
 from ..utils.env_info import ENV_VARS_TRUE
-from ..utils.error import DependencyError
 from ..utils.file_utils import tensorpack_available
 from ..utils.fs import get_configs_dir_path, get_package_path, maybe_copy_config_to_cache
 from ..utils.logger import LoggingRecord, logger
@@ -118,13 +117,15 @@ def get_dd_analyzer(
     :return: A DoctectionPipe instance with given configs
     """
     config_overwrite = [] if config_overwrite is None else config_overwrite
-    lib = "TF" if os.environ.get("DD_USE_TF", "0") in ENV_VARS_TRUE else "PT"
-    if lib == "TF":
+    if os.environ.get("DD_USE_TF", "0") in ENV_VARS_TRUE:
+        lib = "TF"
         device = get_tf_device()
-    elif lib == "PT":
+    elif os.environ.get("DD_USE_TORCH", "0") in ENV_VARS_TRUE:
+        lib = "PT"
         device = get_torch_device()
     else:
-        raise DependencyError("At least one of the env variables DD_USE_TF or DD_USE_TORCH must be set.")
+        lib = None
+        device = None
     dd_one_config_path = maybe_copy_config_to_cache(
         get_package_path(), get_configs_dir_path() / "dd", _DD_ONE, reset_config_file
     )

{deepdoctection-0.37.3 → deepdoctection-0.39}/deepdoctection/analyzer/factory.py

@@ -48,10 +48,11 @@ from ..pipe.segment import PubtablesSegmentationService, TableSegmentationServic
 from ..pipe.sub_layout import DetectResultGenerator, SubImageLayoutService
 from ..pipe.text import TextExtractionService
 from ..pipe.transform import SimpleTransformService
+from ..utils.error import DependencyError
 from ..utils.file_utils import detectron2_available
 from ..utils.fs import get_configs_dir_path
 from ..utils.metacfg import AttrDict
-from ..utils.settings import LayoutType, Relationships
+from ..utils.settings import CellType, LayoutType, Relationships
 from ..utils.transform import PadTransform
 
 with try_import() as image_guard:
@@ -62,8 +63,6 @@ __all__ = [
     "ServiceFactory",
 ]
 
-# from ._config import cfg
-
 
 class ServiceFactory:
     """
@@ -94,6 +93,8 @@ class ServiceFactory:
         :param config: configuration object
         :param mode: either `LAYOUT`,`CELL` or `ITEM`
         """
+        if config.LIB is None:
+            raise DependencyError("At least one of the env variables DD_USE_TF or DD_USE_TORCH must be set.")
         weights = (
             getattr(config.TF, mode).WEIGHTS
             if config.LIB == "TF"
@@ -264,14 +265,17 @@ class ServiceFactory:
         :param mode: either `LAYOUT`,`CELL` or `ITEM`
         :return: `SubImageLayoutService` instance
         """
-        exclude_category_ids = []
+        exclude_category_names = []
         padder = None
         if mode == "ITEM":
             if detector.__class__.__name__ in ("HFDetrDerivedDetector",):
-                exclude_category_ids.extend([1, 3, 4, 5, 6])
+                exclude_category_names.extend(
+                    [LayoutType.TABLE, CellType.COLUMN_HEADER, CellType.PROJECTED_ROW_HEADER, CellType.SPANNING]
+                )
                 padder = ServiceFactory.build_padder(config, mode)
         detect_result_generator = DetectResultGenerator(
-            categories=detector.categories.categories, exclude_category_ids=exclude_category_ids
+            categories_name_as_key=detector.categories.get_categories(as_dict=True, name_as_key=True),
+            exclude_category_names=exclude_category_names,
         )
         return SubImageLayoutService(
             sub_image_detector=detector,
@@ -307,6 +311,8 @@ class ServiceFactory:
                 config_overwrite=[f"LANGUAGES={config.LANGUAGE}"] if config.LANGUAGE is not None else None,
             )
         if config.OCR.USE_DOCTR:
+            if config.LIB is None:
+                raise DependencyError("At least one of the env variables DD_USE_TF or DD_USE_TORCH must be set.")
             weights = (
                 config.OCR.WEIGHTS.DOCTR_RECOGNITION.TF
                 if config.LIB == "TF"
@@ -350,6 +356,8 @@ class ServiceFactory:
         :param config: configuration object
         :return: DoctrTextlineDetector
         """
+        if config.LIB is None:
+            raise DependencyError("At least one of the env variables DD_USE_TF or DD_USE_TORCH must be set.")
         weights = config.OCR.WEIGHTS.DOCTR_WORD.TF if config.LIB == "TF" else config.OCR.WEIGHTS.DOCTR_WORD.PT
         weights_path = ModelDownloadManager.maybe_download_weights_and_configs(weights)
         profile = ModelCatalog.get_profile(weights)
@@ -399,6 +407,8 @@ class ServiceFactory:
                 spanning_cell_names=config.SEGMENTATION.PUBTABLES_SPANNING_CELL_NAMES,
                 item_names=config.SEGMENTATION.PUBTABLES_ITEM_NAMES,
                 sub_item_names=config.SEGMENTATION.PUBTABLES_SUB_ITEM_NAMES,
+                item_header_cell_names=config.SEGMENTATION.PUBTABLES_ITEM_HEADER_CELL_NAMES,
+                item_header_thresholds=config.SEGMENTATION.PUBTABLES_ITEM_HEADER_THRESHOLDS,
                 stretch_rule=config.SEGMENTATION.STRETCH_RULE,
             )
 

{deepdoctection-0.37.3 → deepdoctection-0.39}/deepdoctection/configs/conf_dd_one.yaml

@@ -1,104 +1,145 @@
-USE_ROTATOR: False
-USE_LAYOUT: True
-USE_TABLE_SEGMENTATION: True
-TF:
-  LAYOUT:
-    WEIGHTS: layout/model-800000_inf_only.data-00000-of-00001
-    FILTER:
+DEVICE: null
+LANGUAGE: null
+LAYOUT_LINK:
+  CHILD_CATEGORIES: []
+  PARENTAL_CATEGORIES: []
+LAYOUT_NMS_PAIRS:
+  COMBINATIONS: null
+  PRIORITY: null
+  THRESHOLDS: null
+LIB: null
+OCR:
+  CONFIG:
+    TESSERACT: dd/conf_tesseract.yaml
+  USE_DOCTR: false
+  USE_TESSERACT: true
+  USE_TEXTRACT: false
+  WEIGHTS:
+    DOCTR_RECOGNITION:
+      PT: doctr/crnn_vgg16_bn/pt/crnn_vgg16_bn-9762b0b0.pt
+      TF: doctr/crnn_vgg16_bn/tf/crnn_vgg16_bn-76b7f2c6.zip
+    DOCTR_WORD:
+      PT: doctr/db_resnet50/pt/db_resnet50-ac60cadc.pt
+      TF: doctr/db_resnet50/tf/db_resnet50-adcafc63.zip
+PDF_MINER:
+  X_TOLERANCE: 3
+  Y_TOLERANCE: 3
+PT:
   CELL:
-    WEIGHTS: cell/model-1800000_inf_only.data-00000-of-00001
-    FILTER:
+    FILTER: null
+    WEIGHTS: cell/d2_model_1849999_cell_inf_only.pt
+    WEIGHTS_TS: cell/d2_model_1849999_cell_inf_only.ts
   ITEM:
-    WEIGHTS: item/model-1620000_inf_only.data-00000-of-00001
-    FILTER:
-PT:
-  LAYOUT:
-    WEIGHTS: layout/d2_model_0829999_layout_inf_only.pt
-    WEIGHTS_TS: layout/d2_model_0829999_layout_inf_only.ts
-    FILTER:
+    FILTER: null
     PAD:
-      TOP: 60
-      RIGHT: 60
       BOTTOM: 60
       LEFT: 60
-  ITEM:
+      RIGHT: 60
+      TOP: 60
     WEIGHTS: item/d2_model_1639999_item_inf_only.pt
     WEIGHTS_TS: item/d2_model_1639999_item_inf_only.ts
-    FILTER:
+  LAYOUT:
+    FILTER: null
     PAD:
-      TOP: 60
-      RIGHT: 60
       BOTTOM: 60
       LEFT: 60
-  CELL:
-    WEIGHTS: cell/d2_model_1849999_cell_inf_only.pt
-    WEIGHTS_TS: cell/d2_model_1849999_cell_inf_only.ts
-    FILTER:
-LAYOUT_NMS_PAIRS:
-  COMBINATIONS:
-  THRESHOLDS:
-  PRIORITY:
+      RIGHT: 60
+      TOP: 60
+    WEIGHTS: layout/d2_model_0829999_layout_inf_only.pt
+    WEIGHTS_TS: layout/d2_model_0829999_layout_inf_only.ts
 SEGMENTATION:
   ASSIGNMENT_RULE: ioa
-  THRESHOLD_ROWS: 0.4
-  THRESHOLD_COLS: 0.4
-  FULL_TABLE_TILING: True
-  REMOVE_IOU_THRESHOLD_ROWS: 0.001
-  REMOVE_IOU_THRESHOLD_COLS: 0.001
   CELL_CATEGORY_ID: 12
-  STRETCH_RULE: equal
-USE_TABLE_REFINEMENT: True
-USE_PDF_MINER: False
-PDF_MINER:
-  X_TOLERANCE: 3
-  Y_TOLERANCE: 3
-USE_OCR: True
-OCR:
-  USE_TESSERACT: True
-  USE_DOCTR: False
-  USE_TEXTRACT: False
-  CONFIG:
-    TESSERACT: dd/conf_tesseract.yaml
-  WEIGHTS:
-    DOCTR_WORD:
-      TF: doctr/db_resnet50/tf/db_resnet50-adcafc63.zip
-      PT: doctr/db_resnet50/pt/db_resnet50-ac60cadc.pt
-    DOCTR_RECOGNITION:
-      TF: doctr/crnn_vgg16_bn/tf/crnn_vgg16_bn-76b7f2c6.zip
-      PT: doctr/crnn_vgg16_bn/pt/crnn_vgg16_bn-9762b0b0.pt
-WORD_MATCHING:
-  PARENTAL_CATEGORIES:
-    - text
-    - title
-    - list
-    - cell
+  CELL_NAMES:
+  - header
+  - body
+  - cell
+  FULL_TABLE_TILING: true
+  ITEM_NAMES:
+  - row
+  - column
+  PUBTABLES_CELL_NAMES:
+  - spanning
+  - row_header
+  - column_header
+  - projected_row_header
+  - cell
+  PUBTABLES_ITEM_NAMES:
+  - row
+  - column
+  PUBTABLES_SPANNING_CELL_NAMES:
+  - spanning
+  - row_header
+  - column_header
+  - projected_row_header
+  PUBTABLES_SUB_ITEM_NAMES:
+  - row_number
+  - column_number
+  PUBTABLES_ITEM_HEADER_CELL_NAMES:
     - column_header
-    - projected_row_header
-    - spanning
     - row_header
-  RULE: ioa
-  THRESHOLD: 0.6
-  MAX_PARENT_ONLY: True
+  PUBTABLES_ITEM_HEADER_THRESHOLDS:
+    - 0.6
+    - 0.0001
+  REMOVE_IOU_THRESHOLD_COLS: 0.001
+  REMOVE_IOU_THRESHOLD_ROWS: 0.001
+  STRETCH_RULE: equal
+  SUB_ITEM_NAMES:
+  - row_number
+  - column_number
+  TABLE_NAME: table
+  THRESHOLD_COLS: 0.4
+  THRESHOLD_ROWS: 0.4
+TEXT_CONTAINER: word
 TEXT_ORDERING:
-  TEXT_BLOCK_CATEGORIES:
-    - title
-    - text
-    - list
-    - cell
-    - column_header
-    - projected_row_header
-    - spanning
-    - row_header
-  FLOATING_TEXT_BLOCK_CATEGORIES:
-    - title
-    - text
-    - list
-  INCLUDE_RESIDUAL_TEXT_CONTAINER: False
-  STARTING_POINT_TOLERANCE: 0.005
   BROKEN_LINE_TOLERANCE: 0.003
+  FLOATING_TEXT_BLOCK_CATEGORIES:
+  - text
+  - title
+  - figure
+  - list
   HEIGHT_TOLERANCE: 2.0
+  INCLUDE_RESIDUAL_TEXT_CONTAINER: false
   PARAGRAPH_BREAK: 0.035
-  USE_LAYOUT_LINK: False
-  LAYOUT_LINK:
-    PARENTAL_CATEGORIES:
-    CHILD_CATEGORIES:
+  STARTING_POINT_TOLERANCE: 0.005
+  TEXT_BLOCK_CATEGORIES:
+  - text
+  - title
+  - list
+  - cell
+  - figure
+  - column_header
+  - projected_row_header
+  - spanning
+  - row_header
+TF:
+  CELL:
+    FILTER: null
+    WEIGHTS: cell/model-1800000_inf_only.data-00000-of-00001
+  ITEM:
+    FILTER: null
+    WEIGHTS: item/model-1620000_inf_only.data-00000-of-00001
+  LAYOUT:
+    FILTER: null
+    WEIGHTS: layout/model-800000_inf_only.data-00000-of-00001
+USE_LAYOUT: true
+USE_LAYOUT_LINK: false
+USE_LAYOUT_NMS: false
+USE_OCR: true
+USE_PDF_MINER: false
+USE_ROTATOR: false
+USE_TABLE_REFINEMENT: true
+USE_TABLE_SEGMENTATION: true
+WORD_MATCHING:
+  MAX_PARENT_ONLY: true
+  PARENTAL_CATEGORIES:
+  - text
+  - title
+  - list
+  - cell
+  - column_header
+  - projected_row_header
+  - spanning
+  - row_header
+  RULE: ioa
+  THRESHOLD: 0.6

{deepdoctection-0.37.3 → deepdoctection-0.39}/deepdoctection/datapoint/box.py

@@ -491,10 +491,8 @@ def global_to_local_coords(global_box: BoundingBox, embedding_box: BoundingBox)
 
 def merge_boxes(*boxes: BoundingBox) -> BoundingBox:
     """
-    Generating the smallest box containing an arbitrary tuple/list of boxes. This function is only implemented for boxes
-    with absolute coords = "True".
-
-    :param boxes: An arbitrary tuple/list of bounding boxes `BoundingBox` all having absolute_coords="True".
+    Generating the smallest box containing an arbitrary tuple/list of boxes.
+    :param boxes: An arbitrary tuple/list of bounding boxes `BoundingBox`.
     """
     absolute_coords = boxes[0].absolute_coords
     assert all(box.absolute_coords == absolute_coords for box in boxes), "all boxes must have same absolute_coords"

{deepdoctection-0.37.3 → deepdoctection-0.39}/deepdoctection/datapoint/convert.py

@@ -154,7 +154,9 @@ def convert_pdf_bytes_to_np_array(pdf_bytes: bytes, dpi: Optional[int] = None) -
     return np_array.astype(uint8)
 
 
-def convert_pdf_bytes_to_np_array_v2(pdf_bytes: bytes, dpi: Optional[int] = 200) -> PixelValues:
+def convert_pdf_bytes_to_np_array_v2(
+    pdf_bytes: bytes, dpi: Optional[int] = None, width: Optional[int] = None, height: Optional[int] = None
+) -> PixelValues:
     """
     Converts a pdf passed as bytes into a numpy array. We use poppler or pdfmium to convert the pdf to an image.
     If both is available you can steer the selection of the render engine with environment variables:
@@ -165,17 +167,21 @@ def convert_pdf_bytes_to_np_array_v2(pdf_bytes: bytes, dpi: Optional[int] = 200)
     :param pdf_bytes: A pdf as bytes object. A byte representation can from a pdf file can be generated e.g. with
                       `utils.fs.load_bytes_from_pdf_file`
     :param dpi: The dpi value of the resulting output image. For high resolution set dpi=300.
+    :param width: The width of the resulting output image. This option does only work when using Poppler as
+    PDF renderer
+    :param height: The height of the resulting output image. This option does only work when using Poppler as
+    PDF renderer
     :return: Image as numpy array.
     """
 
-    with BytesIO(pdf_bytes) as pdf_file:
-        pdf = PdfReader(pdf_file).pages[0]
-    shape = pdf.mediabox  # pylint: disable=E1101
-    height = shape[3] - shape[1]
-    width = shape[2] - shape[0]
-
     if dpi is None:
-        return pdf_to_np_array(pdf_bytes, size=(int(width), int(height)))
+        if width is None or height is None:
+            with BytesIO(pdf_bytes) as pdf_file:
+                pdf = PdfReader(pdf_file).pages[0]
+            shape = pdf.mediabox  # pylint: disable=E1101
+            height = shape[3] - shape[1]
+            width = shape[2] - shape[0]
+        return pdf_to_np_array(pdf_bytes, size=(int(width), int(height)))  # type: ignore
     return pdf_to_np_array(pdf_bytes, dpi=dpi)
 
 

{deepdoctection-0.37.3 → deepdoctection-0.39}/deepdoctection/datapoint/image.py

@@ -153,7 +153,7 @@ class Image:
             self.set_width_height(self._image.shape[1], self._image.shape[0])
             self._self_embedding()
         elif isinstance(image, bytes):
-            self._image = convert_pdf_bytes_to_np_array_v2(image, dpi=environ.get("DPI", 300))  # type: ignore
+            self._image = convert_pdf_bytes_to_np_array_v2(image, dpi=int(environ["DPI"]))
             self.set_width_height(self._image.shape[1], self._image.shape[0])
             self._self_embedding()
         else:
@@ -428,7 +428,7 @@ class Image:
         A list of attributes to suspend from as_dict creation.
         """
 
-        return ["_image", "_annotation_ids", "_category_name"]
+        return ["_annotation_ids", "_category_name"]
 
     def define_annotation_id(self, annotation: Annotation) -> str:
         """
@@ -572,24 +572,31 @@ class Image:
         ann = self.get_annotation(annotation_ids=annotation_id)[0]
         if ann.image is None:
             raise ImageError("When adding sub images to ImageAnnotation then ImageAnnotation.image must not be None")
-        assert ann.bounding_box is not None
-        box = ann.bounding_box.to_list("xyxy")
+        box = ann.get_bounding_box(self.image_id).to_list("xyxy")
         proposals = self.get_annotation(category_names)
         points = np.array([prop.get_bounding_box(self.image_id).center for prop in proposals])
+        if not points.size:
+            return
         ann_ids = np.array([prop.annotation_id for prop in proposals])
         indices = np.where(
             (box[0] < points[:, 0]) & (box[1] < points[:, 1]) & (box[2] > points[:, 0]) & (box[3] > points[:, 1])
         )[0]
         selected_ids = ann_ids[indices]
         sub_images = self.get_annotation(annotation_ids=selected_ids.tolist())
+        ann_box = ann.get_bounding_box(self.image_id)
+        if not ann_box.absolute_coords:
+            ann_box = ann_box.transform(self.width, self.height, absolute_coords=True)
         for sub_image in sub_images:
             if sub_image.image is None:
                 raise ImageError(
                     "When setting an embedding to ImageAnnotation then ImageAnnotation.image must not be None"
                 )
+            sub_image_box = sub_image.get_bounding_box(self.image_id)
+            if not sub_image_box.absolute_coords:
+                sub_image_box = sub_image_box.transform(self.width, self.height, absolute_coords=True)
             sub_image.image.set_embedding(
                 annotation_id,
-                global_to_local_coords(sub_image.get_bounding_box(self.image_id), ann.get_bounding_box(self.image_id)),
+                global_to_local_coords(sub_image_box, ann_box),
             )
             ann.image.dump(sub_image)