supervisely 6.73.344__py3-none-any.whl → 6.73.346__py3-none-any.whl

supervisely/convert/image/sly/fast_sly_image_converter.py

@@ -1,21 +1,23 @@
 import os
+from pathlib import Path
 
+import supervisely.convert.image.sly.sly_image_helper as helper
 from supervisely import (
     Annotation,
     Api,
-    ProjectMeta,
     Label,
+    Project,
+    ProjectMeta,
     Rectangle,
     batched,
     is_development,
     logger,
 )
-from supervisely.convert.image.sly.sly_image_converter import SLYImageConverter
-import supervisely.convert.image.sly.sly_image_helper as helper
 from supervisely.convert.image.image_converter import ImageConverter
-from supervisely.io.fs import get_file_ext
-from supervisely.io.json import load_json_file
 from supervisely.convert.image.image_helper import validate_image_bounds
+from supervisely.convert.image.sly.sly_image_converter import SLYImageConverter
+from supervisely.io.fs import dir_empty, dir_exists, get_file_ext
+from supervisely.io.json import load_json_file
 
 
 class FastSlyImageConverter(SLYImageConverter, ImageConverter):
@@ -29,7 +31,11 @@ class FastSlyImageConverter(SLYImageConverter, ImageConverter):
         detected_ann_cnt = 0
         self._items = []
         meta = ProjectMeta()
+
         for root, _, files in os.walk(self._input_data):
+            if Path(root).name == Project.blob_dir_name:
+                logger.debug("FastSlyImageConverter: Detected blob directory. Skipping...")
+                return False
             for file in files:
                 full_path = os.path.join(root, file)
                 ext = get_file_ext(full_path)

supervisely/convert/image/sly/sly_image_converter.py

@@ -291,8 +291,19 @@ class SLYImageConverter(ImageConverter):
             self.upload_project(api, dataset_id, batch_size, log_progress)
         elif self.blob_project:
             dataset_info = api.dataset.get_info_by_id(dataset_id, raise_error=True)
+            project_dirs = [d for d in find_project_dirs(self._input_data)]
+            if len(project_dirs) == 0:
+                raise RuntimeError(
+                    "Failed to find Supervisely project with blobs in the input data"
+                )
+            project_dir = project_dirs[0]
+            if len(project_dirs) > 1:
+                logger.info(
+                    "Found multiple possible Supervisely projects with blobs in the input data. "
+                    f"Only the first one will be uploaded: {project_dir}"
+                )
             upload_project_fs(
-                dir=self._input_data,
+                dir=project_dir,
                 api=api,
                 workspace_id=dataset_info.workspace_id,
                 log_progress=log_progress,

supervisely/convert/volume/__init__.py

@@ -3,5 +3,5 @@ from supervisely.convert.volume.sly.sly_volume_converter import SLYVolumeConvert
 from supervisely.convert.volume.dicom.dicom_converter import DICOMConverter
 from supervisely.convert.volume.nii.nii_volume_converter import NiiConverter
 from supervisely.convert.volume.nii.nii_planes_volume_converter import (
-    NiiPlaneStructuredConverter,
+    NiiPlaneStructuredConverter, NiiPlaneStructuredAnnotationConverter
 )

supervisely/convert/volume/nii/nii_planes_volume_converter.py

@@ -2,16 +2,17 @@ import os
 from collections import defaultdict
 from pathlib import Path
 
-from supervisely import ProjectMeta, logger
+from supervisely import ProjectMeta, logger, Api
 from supervisely.annotation.obj_class import ObjClass
 from supervisely.convert.volume.nii import nii_volume_helper as helper
 from supervisely.convert.volume.nii.nii_volume_converter import NiiConverter
 from supervisely.convert.volume.volume_converter import VolumeConverter
 from supervisely.geometry.mask_3d import Mask3D
-from supervisely.io.fs import get_file_ext, get_file_name
+from supervisely.io.fs import get_file_ext, get_file_name, list_files_recursively
 from supervisely.volume.volume import is_nifti_file
 from supervisely.volume_annotation.volume_annotation import VolumeAnnotation
 from supervisely.volume_annotation.volume_object import VolumeObject
+from supervisely._utils import batched, is_development
 
 
 class NiiPlaneStructuredConverter(NiiConverter, VolumeConverter):
@@ -58,6 +59,7 @@ class NiiPlaneStructuredConverter(NiiConverter, VolumeConverter):
         def __init__(self, *args, **kwargs):
             super().__init__(*args, **kwargs)
             self._is_semantic = False
+            self.volume_meta = None
 
         @property
         def is_semantic(self) -> bool:
@@ -67,6 +69,12 @@ class NiiPlaneStructuredConverter(NiiConverter, VolumeConverter):
         def is_semantic(self, value: bool):
             self._is_semantic = value
 
+        def create_empty_annotation(self):
+            return VolumeAnnotation(self.volume_meta)
+        
+    def __str__(self):
+        return "nii_custom"
+
     def validate_format(self) -> bool:
         # create Items
         converted_dir_name = "converted"
@@ -87,8 +95,7 @@ class NiiPlaneStructuredConverter(NiiConverter, VolumeConverter):
                     prefix = full_name.split("_")[0]
                     if prefix not in helper.PlanePrefix.values():
                         continue
-                    name = full_name.split("_")[1]
-                    if name in helper.LABEL_NAME or name[:-1] in helper.LABEL_NAME:
+                    if any(label_name in full_name for label_name in helper.LABEL_NAME):
                         ann_dict[prefix].append(path)
                     else:
                         volumes_dict[prefix].append(path)
@@ -114,7 +121,7 @@ class NiiPlaneStructuredConverter(NiiConverter, VolumeConverter):
                 for path in paths:
                     item = self.Item(item_path=path)
                     possible_ann_paths = []
-                    for ann_path in ann_dict.get(prefix):
+                    for ann_path in ann_dict.get(prefix, []):
                         if Path(ann_path).parent == Path(path).parent:
                             possible_ann_paths.append(ann_path)
                     item.ann_data = possible_ann_paths
@@ -160,3 +167,178 @@ class NiiPlaneStructuredConverter(NiiConverter, VolumeConverter):
         except Exception as e:
             logger.warning(f"Failed to convert {item.path} to Supervisely format: {e}")
             return item.create_empty_annotation()
+
+
+class NiiPlaneStructuredAnnotationConverter(NiiConverter, VolumeConverter):
+    """
+    Upload NIfTI Annotations
+    """
+
+    class Item(VolumeConverter.BaseItem):
+        def __init__(self, *args, **kwargs):
+            super().__init__(*args, **kwargs)
+            self._is_semantic = False
+            self.volume_meta = None
+
+        @property
+        def is_semantic(self) -> bool:
+            return self._is_semantic
+
+        @is_semantic.setter
+        def is_semantic(self, value: bool):
+            self._is_semantic = value
+
+        def create_empty_annotation(self):
+            return VolumeAnnotation(self.volume_meta)
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self._json_map = None
+
+    def __str__(self):
+        return "nii_custom_ann"
+
+    def validate_format(self) -> bool:
+        try:
+            from nibabel import load, filebasedimages
+        except ImportError:
+            raise ImportError(
+                "No module named nibabel. Please make sure that module is installed from pip and try again."
+            )
+        cls_color_map = None
+
+        has_volumes = lambda x: helper.VOLUME_NAME in x
+        if list_files_recursively(self._input_data, filter_fn=has_volumes):
+            return False
+
+        txts = list_files_recursively(self._input_data, [".txt"], None, True)
+        cls_color_map = next(iter(txts), None)
+        if cls_color_map is not None:
+            cls_color_map = helper.read_cls_color_map(cls_color_map)
+
+        jsons = list_files_recursively(self._input_data, [".json"], None, True)
+        json_map = next(iter(jsons), None)
+        if json_map is not None:
+            self._json_map = helper.read_json_map(json_map)
+
+        is_ann = lambda x: any(label_name in x for label_name in helper.LABEL_NAME)
+        for root, _, files in os.walk(self._input_data):
+            for file in files:
+                path = os.path.join(root, file)
+                if is_ann(file):
+                    prefix = get_file_name(path).split("_")[0]
+                    if prefix not in helper.PlanePrefix.values():
+                        continue
+                    try:
+                        nii = load(path)
+                    except filebasedimages.ImageFileError:
+                        continue
+                    item = self.Item(item_path=None, ann_data=path)
+                    item.set_shape(nii.shape)
+                    if cls_color_map is not None:
+                        item.custom_data["cls_color_map"] = cls_color_map
+                    self._items.append(item)
+
+        obj_classes = None
+        if cls_color_map is not None:
+            obj_classes = [ObjClass(name, Mask3D, color) for name, color in cls_color_map.values()]
+
+        self._meta = ProjectMeta(obj_classes=obj_classes)
+        return len(self._items) > 0
+
+    def to_supervisely(
+        self,
+        item: VolumeConverter.Item,
+        meta: ProjectMeta = None,
+        renamed_classes: dict = None,
+        renamed_tags: dict = None,
+    ) -> VolumeAnnotation:
+        """Convert to Supervisely format."""
+        import re
+        try:
+            objs = []
+            spatial_figures = []
+            ann_path = item.ann_data
+            ann_idx = 0
+            match = re.search(r"_(\d+)(?:\.[^.]+)+$", ann_path)
+            if match:
+                ann_idx = int(match.group(1))
+            for mask, pixel_id in helper.get_annotation_from_nii(ann_path):
+                class_id = pixel_id if item.is_semantic else ann_idx
+                class_name = f"Segment_{class_id}"
+                color = None
+                if item.custom_data.get("cls_color_map") is not None:
+                    class_info = item.custom_data["cls_color_map"].get(class_id)
+                    if class_info is not None:
+                        class_name, color = class_info
+                class_name = renamed_classes.get(class_name, class_name)
+                obj_class = meta.get_obj_class(class_name)
+                if obj_class is None:
+                    obj_class = ObjClass(class_name, Mask3D, color)
+                    meta = meta.add_obj_class(obj_class)
+                    self._meta_changed = True
+                    self._meta = meta
+                obj = VolumeObject(obj_class, mask_3d=mask)
+                spatial_figures.append(obj.figure)
+                objs.append(obj)
+            return VolumeAnnotation(item.volume_meta, objects=objs, spatial_figures=spatial_figures)
+        except Exception as e:
+            logger.warning(f"Failed to convert {item.ann_data} to Supervisely format: {e}")
+            return item.create_empty_annotation()
+
+    def upload_dataset(
+        self, api: Api, dataset_id: int, batch_size: int = 50, log_progress=True
+    ) -> None:
+        meta, renamed_classes, _ = self.merge_metas_with_conflicts(api, dataset_id)
+
+        matcher = helper.AnnotationMatcher(self._items, dataset_id)
+        if self._json_map is not None:
+            try:
+                matched_dict = matcher.match_from_json(api, self._json_map)
+            except Exception as e:
+                logger.error(f"Failed to match annotations from a json map: {e}")
+                matched_dict = {}
+        else:
+            matcher.get_volumes(api)
+            matched_dict = matcher.match_items()
+            if len(matched_dict) != len(self._items):
+                extra = {
+                    "items count": len(self._items),
+                    "matched count": len(matched_dict),
+                    "unmatched count": len(self._items) - len(matched_dict),
+                }
+                logger.warning(
+                    "Not all items were matched with volumes. Some items may be skipped.",
+                    extra=extra,
+                )
+        if len(matched_dict) == 0:
+            raise RuntimeError(
+                "No items were matched with volumes. Please check the input data and try again."
+            )
+
+        if log_progress:
+            progress, progress_cb = self.get_progress(
+                len(matched_dict), "Uploading volumes annotations..."
+            )
+        else:
+            progress_cb = None
+
+        for item, volume in matched_dict.items():
+            item.volume_meta = volume.meta
+            ann = self.to_supervisely(item, meta, renamed_classes, None)
+            if self._meta_changed:
+                meta, renamed_classes, _ = self.merge_metas_with_conflicts(api, dataset_id)
+                self._meta_changed = False
+            api.volume.annotation.append(volume.id, ann, volume_info=volume)
+            progress_cb(1) if log_progress else None
+
+        res_ds_info = api.dataset.get_info_by_id(dataset_id)
+        if res_ds_info.items_count == 0:
+            logger.info("Resulting dataset is empty. Removing it.")
+            api.dataset.remove(dataset_id)
+
+
+        if log_progress:
+            if is_development():
+                progress.close()
+            logger.info(f"Successfully uploaded {len(matched_dict)} annotations.")

supervisely/convert/volume/nii/nii_volume_converter.py

@@ -207,7 +207,7 @@ class NiiConverter(VolumeConverter):
 
                     if self._meta_changed:
                         meta, renamed_classes, _ = self.merge_metas_with_conflicts(api, dataset_id)
-
+                        self._meta_changed = False
                     api.volume.annotation.append(info.id, ann)
 
             if log_progress:

supervisely/convert/volume/nii/nii_volume_helper.py

@@ -3,7 +3,10 @@ from typing import Generator
 
 import nrrd
 import numpy as np
+from pathlib import Path
+from collections import defaultdict, namedtuple
 
+from supervisely import Api
 from supervisely.collection.str_enum import StrEnum
 from supervisely.geometry.mask_3d import Mask3D
 from supervisely.io.fs import ensure_base_path, get_file_ext, get_file_name
@@ -69,6 +72,20 @@ def read_cls_color_map(path: str) -> dict:
         return None
     return cls_color_map
 
+def read_json_map(path: str) -> dict:
+    import json
+
+    """Read JSON map from file."""
+    if not os.path.exists(path):
+        return None
+    try:
+        with open(path, "r") as file:
+            json_map = json.load(file)
+    except Exception as e:
+        logger.warning(f"Failed to read JSON map from {path}: {e}")
+        return None
+    return json_map
+
 
 def nifti_to_nrrd(nii_file_path: str, converted_dir: str) -> str:
     """Convert NIfTI 3D volume file to NRRD 3D volume file."""
@@ -97,3 +114,193 @@ def get_annotation_from_nii(path: str) -> Generator[Mask3D, None, None]:
             continue
         mask = Mask3D(data == class_id)
         yield mask, class_id
+
+class AnnotationMatcher:
+    def __init__(self, items, dataset_id):
+        self._items = items
+        self._ds_id = dataset_id
+        self._ann_paths = defaultdict(list)
+
+        self._item_by_filename = {}
+        self._item_by_path = {}
+
+        for item in items:
+            path = Path(item.ann_data)
+            dataset_name = path.parts[-2]
+            filename = path.name
+
+            self._ann_paths[dataset_name].append(filename)
+            self._item_by_filename[filename] = item
+            self._item_by_path[(dataset_name, filename)] = item
+
+        self._project_wide = False
+        self._volumes = None
+
+    def get_volumes(self, api: Api):
+        dataset_info = api.dataset.get_info_by_id(self._ds_id)
+        datasets = {dataset_info.name: dataset_info}
+        project_id = dataset_info.project_id
+        if dataset_info.items_count > 0 and len(self._ann_paths.keys()) == 1:
+            self._project_wide = False
+        else:
+            datasets = {dsinfo.name: dsinfo for dsinfo in api.dataset.get_list(project_id, recursive=True)}
+            self._project_wide = True
+
+        volumes = defaultdict(lambda: {})
+        ds_filter = lambda ds_name: ds_name in self._ann_paths if self._project_wide else True
+        for ds_name, ds_info in datasets.items():
+            if ds_filter(ds_name):
+                volumes[ds_name].update(
+                    {info.name: info for info in api.volume.get_list(ds_info.id)}
+                )
+
+        if len(volumes) == 0:
+            err_msg = "Failed to retrieve volumes from the project. Perhaps the input data structure is incorrect."
+            raise RuntimeError(err_msg)
+
+        self._volumes = volumes
+
+    def match_items(self):
+        """Match annotation files with corresponding volumes using regex-based matching."""
+        import re
+
+        def extract_prefix(ann_file):
+            import re
+            pattern = r'^(?P<prefix>cor|sag|axl).*?(?:' + "|".join(LABEL_NAME) + r')'
+            m = re.match(pattern, ann_file, re.IGNORECASE)
+            if m:
+                return m.group("prefix").lower()
+            return None
+
+        def is_volume_match(volume_name, prefix):
+            pattern = r'^' + re.escape(prefix) + r'.*?anatomic'
+            return re.match(pattern, volume_name, re.IGNORECASE) is not None
+
+        def find_best_volume_match(prefix, available_volumes):
+            candidates = {name: volume for name, volume in available_volumes.items() if is_volume_match(name, prefix)}
+            if not candidates:
+                return None, None
+
+            # Prefer an exact candidate
+            ann_name_no_ext = ann_file.split(".")[0]
+            exact_candidate = re.sub(r'(' + '|'.join(LABEL_NAME) + r')', 'anatomic', ann_name_no_ext, flags=re.IGNORECASE)
+            for name in candidates:
+                if re.fullmatch(re.escape(exact_candidate), name, re.IGNORECASE):
+                    return name, candidates[name]
+
+            # Otherwise, choose the candidate with the shortest name
+            best_match = sorted(candidates.keys(), key=len)[0]
+            return best_match, candidates[best_match]
+
+        item_to_volume = {}
+
+        def process_annotation_file(ann_file, dataset_name, volumes):
+            prefix = extract_prefix(ann_file)
+            if prefix is None:
+                logger.warning(f"Failed to extract prefix from annotation file {ann_file}. Skipping.")
+                return
+
+            matched_name, matched_volume = find_best_volume_match(prefix, volumes)
+            if not matched_volume:
+                logger.warning(f"No matching volume found for annotation with prefix '{prefix}' in dataset {dataset_name}.")
+                return
+
+            # Retrieve the correct item based on matching mode.
+            item = (
+                self._item_by_path.get((dataset_name, ann_file))
+                if self._project_wide
+                else self._item_by_filename.get(ann_file)
+            )
+            if not item:
+                logger.warning(f"Item not found for annotation file {ann_file} in {'dataset ' + dataset_name if self._project_wide else 'single dataset mode'}.")
+                return
+
+            item_to_volume[item] = matched_volume
+            ann_file = ann_file.split(".")[0]
+            ann_supposed_match = re.sub(r'(' + '|'.join(LABEL_NAME) + r')', 'anatomic', ann_file, flags=re.IGNORECASE)
+            if matched_name.lower() != ann_supposed_match:
+                logger.debug(f"Fuzzy matched {ann_file} to volume {matched_name} using prefix '{prefix}'.")
+
+        # Perform matching
+        for dataset_name, volumes in self._volumes.items():
+            ann_files = self._ann_paths.get(dataset_name, []) if self._project_wide else list(self._ann_paths.values())[0]
+            for ann_file in ann_files:
+                process_annotation_file(ann_file, dataset_name, volumes)
+
+        # Mark volumes having only one matching item as semantic and validate shape.
+        volume_to_items = defaultdict(list)
+        for item, volume in item_to_volume.items():
+            volume_to_items[volume.id].append(item)
+        
+        for volume_id, items in volume_to_items.items():
+            if len(items) == 1:
+                items[0].is_semantic = True
+
+        items_to_remove = []
+        for item, volume in item_to_volume.items():
+            volume_shape = tuple(volume.file_meta["sizes"])
+            if item.shape != volume_shape:
+                logger.warning(f"Volume shape mismatch: {item.shape} != {volume_shape}")
+                # items_to_remove.append(item)
+        for item in items_to_remove:
+            del item_to_volume[item]
+
+        return item_to_volume
+
+    def match_from_json(self, api: Api, json_map: dict):
+        """
+        Match annotation files with corresponding volumes based on a JSON map.
+
+        Example json structure:
+        {
+            "cor_inference_1.nii": 123,
+            "sag_mask_2.nii": 456
+        }
+        Where key is the annotation file name and value is the volume ID.
+
+        For project-wide matching, the key should include dataset name:
+        {
+            "dataset1/cor_inference_1.nii": 123,
+            "dataset2/sag_mask_2.nii": 456
+        }
+        """
+        item_to_volume = {}
+
+        for ann_path, volume_id in json_map.items():
+            # Check if it's a project-wide path (contains dataset name)
+            path_parts = Path(ann_path)
+            if len(path_parts.parts) > 1:
+                # Project-wide format: "dataset_name/filename.nii"
+                dataset_name = path_parts.parts[-2]
+                ann_name = path_parts.name
+                item = self._item_by_path.get((dataset_name, ann_name))
+            else:
+                # Single dataset format: "filename.nii"
+                ann_name = path_parts.name
+                item = self._item_by_filename.get(ann_name)
+
+            if item:
+                volume = api.volume.get_info_by_id(volume_id)
+                if volume:
+                    item_to_volume[item] = volume
+
+                    # Validate shape
+                    volume_shape = tuple(volume.file_meta["sizes"])
+                    if item.shape != volume_shape:
+                        logger.warning(
+                            f"Volume shape mismatch: {item.shape} != {volume_shape} for {ann_path}. Using anyway."
+                        )
+                else:
+                    logger.warning(f"Volume {volume_id} not found for {ann_path}.")
+            else:
+                logger.warning(f"Item not found for annotation file {ann_path}.")
+
+        # Set semantic flag for volumes with only one associated item
+        volume_to_items = defaultdict(list)
+        for item, volume in item_to_volume.items():
+            volume_to_items[volume.id].append(item)
+        for volume_id, items in volume_to_items.items():
+            if len(items) == 1:
+                items[0].is_semantic = True
+
+        return item_to_volume

supervisely/project/data_version.py

@@ -17,7 +17,9 @@ from supervisely.io.fs import remove_dir, silent_remove
 
 
 class VersionInfo(NamedTuple):
-    """ """
+    """
+    Object with image parameters from Supervisely that describes the version of the project.
+    """
 
     id: int
     project_id: int
@@ -34,6 +36,10 @@ class VersionInfo(NamedTuple):
 
 
 class DataVersion(ModuleApiBase):
+    """
+    Class for managing project versions.
+    This class provides methods for creating, restoring, and managing project versions.
+    """
 
     def __init__(self, api):
         """

supervisely/project/project.py

@@ -579,21 +579,24 @@ class Dataset(KeyObject):
         Consistency checks. Every item must have an annotation, and the correspondence must be one to one.
         If not - it generate exception error.
         """
-        if not dir_exists(self.item_dir):
+        blob_offset_paths = list_files(
+            self.directory, filter_fn=lambda x: x.endswith(OFFSETS_PKL_SUFFIX)
+        )
+        has_blob_offsets = len(blob_offset_paths) > 0
+
+        if not dir_exists(self.item_dir) and not has_blob_offsets:
             raise FileNotFoundError("Item directory not found: {!r}".format(self.item_dir))
         if not dir_exists(self.ann_dir):
             raise FileNotFoundError("Annotation directory not found: {!r}".format(self.ann_dir))
 
         raw_ann_paths = list_files(self.ann_dir, [ANN_EXT])
-        img_paths = list_files(self.item_dir, filter_fn=self._has_valid_ext)
-
         raw_ann_names = set(os.path.basename(path) for path in raw_ann_paths)
-        img_names = [os.path.basename(path) for path in img_paths]
 
-        blob_offset_paths = list_files(
-            self.directory, filter_fn=lambda x: x.endswith(OFFSETS_PKL_SUFFIX)
-        )
-        has_blob_offsets = len(blob_offset_paths) > 0
+        if dir_exists(self.item_dir):
+            img_paths = list_files(self.item_dir, filter_fn=self._has_valid_ext)
+            img_names = [os.path.basename(path) for path in img_paths]
+        else:
+            img_names = []
 
         # If we have blob offset files, add the image names from those
         if has_blob_offsets:
@@ -2061,6 +2064,84 @@ class Dataset(KeyObject):
             progress_cb=progress_cb,
         )
 
+    def get_blob_img_bytes(self, image_name: str) -> bytes:
+        """
+        Get image bytes from blob file.
+
+        :param image_name: Image name with extension.
+        :type image_name: :class:`str`
+        :return: Bytes of the image.
+        :rtype: :class:`bytes`
+
+        :Usage example:
+
+         .. code-block:: python
+
+            import supervisely as sly
+            dataset_path = "/path/to/project/lemons_annotated/ds1"
+            dataset = sly.Dataset(dataset_path, sly.OpenMode.READ)
+            image_name = "IMG_0748.jpeg"
+
+            img_bytes = dataset.get_blob_img_bytes(image_name)
+        """
+
+        if self.project_dir is None:
+            raise RuntimeError("Project directory is not set. Cannot get blob image bytes.")
+
+        blob_image_info = None
+
+        for offset in self.blob_offsets:
+            for batch in BlobImageInfo.load_from_pickle_generator(offset):
+                for file in batch:
+                    if file.name == image_name:
+                        blob_image_info = file
+                        blob_file_name = removesuffix(Path(offset).name, OFFSETS_PKL_SUFFIX)
+                        break
+        if blob_image_info is None:
+            logger.debug(
+                f"Image '{image_name}' not found in blob offsets. "
+                f"Make sure that the image is stored in the blob file."
+            )
+            return None
+
+        blob_file_path = os.path.join(self.project_dir, self.blob_dir_name, blob_file_name + ".tar")
+        if file_exists(blob_file_path):
+            with open(blob_file_path, "rb") as f:
+                f.seek(blob_image_info.offset_start)
+                img_bytes = f.read(blob_image_info.offset_end - blob_image_info.offset_start)
+        else:
+            logger.debug(
+                f"Blob file '{blob_file_path}' not found. "
+                f"Make sure that the blob file exists in the specified directory."
+            )
+            img_bytes = None
+        return img_bytes
+
+    def get_blob_img_np(self, image_name: str) -> np.ndarray:
+        """
+        Get image as numpy array from blob file.
+
+        :param image_name: Image name with extension.
+        :type image_name: :class:`str`
+        :return: Numpy array of the image.
+        :rtype: :class:`numpy.ndarray`
+
+        :Usage example:
+
+         .. code-block:: python
+
+            import supervisely as sly
+            dataset_path = "/path/to/project/lemons_annotated/ds1"
+            dataset = sly.Dataset(dataset_path, sly.OpenMode.READ)
+            image_name = "IMG_0748.jpeg"
+
+            img_np = dataset.get_blob_img_np(image_name)
+        """
+        img_bytes = self.get_blob_img_bytes(image_name)
+        if img_bytes is None:
+            return None
+        return sly_image.read_bytes(img_bytes)
+
 
 class Project:
     """

{supervisely-6.73.344.dist-info → supervisely-6.73.346.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: supervisely
-Version: 6.73.344
+Version: 6.73.346
 Summary: Supervisely Python SDK.
 Home-page: https://github.com/supervisely/supervisely
 Author: Supervisely

{supervisely-6.73.344.dist-info → supervisely-6.73.346.dist-info}/RECORD

@@ -606,8 +606,8 @@ supervisely/convert/image/pdf/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5N
 supervisely/convert/image/pdf/pdf_converter.py,sha256=LKvVng9jPp0cSIjYEjKLOb48wtdOdB7LXS2gjmOdZhE,2442
 supervisely/convert/image/pdf/pdf_helper.py,sha256=IDwLEvsVy8lu-KC1lXvSRkZZ9BCC6ylebnNEtLQU5L4,1288
 supervisely/convert/image/sly/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-supervisely/convert/image/sly/fast_sly_image_converter.py,sha256=pZmQzhx9FrHwgVnJgqp-37Cn3zAnPww6MLa1grL6aWM,5429
-supervisely/convert/image/sly/sly_image_converter.py,sha256=wsdQt53w_QDxdcLCmPs7-lRt9rEvsIX97NpSVi-5MUE,13821
+supervisely/convert/image/sly/fast_sly_image_converter.py,sha256=wtiM-Dl4xivT60-79pj8XMdHQc2kPMi7DqGcEngiWRg,5669
+supervisely/convert/image/sly/sly_image_converter.py,sha256=_sTiPTeNwZ1qWdtecmusanzvApHN7TskB7slgI3mibs,14370
 supervisely/convert/image/sly/sly_image_helper.py,sha256=5Ri8fKb5dzh5b3v8AJ5u8xVFOQfAtoWqZ7HktPsCjTI,7373
 supervisely/convert/image/yolo/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 supervisely/convert/image/yolo/yolo_converter.py,sha256=Wn5dR05y4SEPONcaxWr9ofnbvbf-SbRZN0fkksk5Dps,11391
@@ -658,15 +658,15 @@ supervisely/convert/video/mot/mot_converter.py,sha256=wXbv-9Psc2uVnhzHuOt5VnRIvS
 supervisely/convert/video/sly/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 supervisely/convert/video/sly/sly_video_converter.py,sha256=S2qif7JFxqIi9VN_ez_iBtoJXpG9W6Ky2k5Er3-DtUo,4418
 supervisely/convert/video/sly/sly_video_helper.py,sha256=D8PgoXpi0y3z-VEqvBLDf_gSUQ2hTL3irrfJyGhaV0Y,6758
-supervisely/convert/volume/__init__.py,sha256=RpSYjufciJT6AdhI9Oqp70b3XoFTtSkxFNexoqeOPW4,353
+supervisely/convert/volume/__init__.py,sha256=NaACs000WT2iy_g63TiZZ6IlgCjyDXx6i2OHsGpCYOs,391
 supervisely/convert/volume/volume_converter.py,sha256=3jpt2Yn_G4FSP_vHFsJHQfYNQpT7q6ar_sRyr_xrPnA,5335
 supervisely/convert/volume/dicom/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 supervisely/convert/volume/dicom/dicom_converter.py,sha256=Hw4RxU_qvllk6M26udZE6G-m1RWR8-VVPcEPwFlqrVg,3354
 supervisely/convert/volume/dicom/dicom_helper.py,sha256=OrKlyt1hA5BOXKhE1LF1WxBIv3b6t96xRras4OSAuNM,2891
 supervisely/convert/volume/nii/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-supervisely/convert/volume/nii/nii_planes_volume_converter.py,sha256=9TtN_AgCQgv16Olip6inFanCA5JlEEJ7JQf-0XjIw_Q,7091
-supervisely/convert/volume/nii/nii_volume_converter.py,sha256=IZ6DJeLLbLAW-kifOJ_9ddV3h7gL3AswM2TTbXB9Os0,8476
-supervisely/convert/volume/nii/nii_volume_helper.py,sha256=RvYab6Z530Qw-qTAsZ3WM8WZKqhijia9OC-g4_zOSEs,3142
+supervisely/convert/volume/nii/nii_planes_volume_converter.py,sha256=TrV7Mkczt8w2WpJizmOZwqeG9zlcLy-8p4D22B9nYyo,14344
+supervisely/convert/volume/nii/nii_volume_converter.py,sha256=n8HWRvwXUzugTQt4PKpbSacsuC4EQxoYHAWXcXC5KE8,8526
+supervisely/convert/volume/nii/nii_volume_helper.py,sha256=8cS1LCvDcgGuinBARTmbOm-lLQmJ___3gyemt26W_-Y,11572
 supervisely/convert/volume/sly/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 supervisely/convert/volume/sly/sly_volume_converter.py,sha256=XmSuxnRqxchG87b244f3h0UHvOt6IkajMquL1drWlCM,5595
 supervisely/convert/volume/sly/sly_volume_helper.py,sha256=gUY0GW3zDMlO2y-zQQG36uoXMrKkKz4-ErM1CDxFCxE,5620
@@ -1016,11 +1016,11 @@ supervisely/pointcloud_annotation/pointcloud_tag_collection.py,sha256=j_TAN23GkT
 supervisely/pointcloud_episodes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 supervisely/pointcloud_episodes/pointcloud_episodes.py,sha256=cRXdtw7bMsbsdVQjxfWxFSESrO-LGiqqsZyyExl2Mbg,3430
 supervisely/project/__init__.py,sha256=hlzdj9Pgy53Q3qdP8LMtGTChvZHQuuShdtui2eRUQeE,2601
-supervisely/project/data_version.py,sha256=6vOz5ovBeCIiMAKUG7lGQ5IXvQnU1GbcnrWxdOvaVlo,19311
+supervisely/project/data_version.py,sha256=P5Lui6i64pYeJWmAdGJDv8GRXxjfpSSZ8zT_MxIrynE,19553
 supervisely/project/download.py,sha256=4QOEQZnolmOpEO6Wl6DIc73BwIYr9m-6anbarrU6VwQ,24902
 supervisely/project/pointcloud_episode_project.py,sha256=yiWdNBQiI6f1O9sr1pg8JHW6O-w3XUB1rikJNn3Oung,41866
 supervisely/project/pointcloud_project.py,sha256=Kx1Vaes-krwG3BiRRtHRLQxb9G5m5bTHPN9IzRqmNWo,49399
-supervisely/project/project.py,sha256=UFElUMvFxknLwSTly-9tF85NAYneavolpOGIGZtpSmo,230359
+supervisely/project/project.py,sha256=OunVB11sVQSOvkqkjsEEkX1nq9OUXOXpHTdcLDjOFe0,233256
 supervisely/project/project_meta.py,sha256=26s8IiHC5Pg8B1AQi6_CrsWteioJP2in00cRNe8QlW0,51423
 supervisely/project/project_settings.py,sha256=NLThzU_DCynOK6hkHhVdFyezwprn9UqlnrLDe_3qhkY,9347
 supervisely/project/project_type.py,sha256=7mQ7zg6r7Bm2oFn5aR8n_PeLqMmOaPZd6ph7Z8ZISTw,608
@@ -1082,9 +1082,9 @@ supervisely/worker_proto/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 supervisely/worker_proto/worker_api_pb2.py,sha256=VQfi5JRBHs2pFCK1snec3JECgGnua3Xjqw_-b3aFxuM,59142
 supervisely/worker_proto/worker_api_pb2_grpc.py,sha256=3BwQXOaP9qpdi0Dt9EKG--Lm8KGN0C5AgmUfRv77_Jk,28940
 supervisely_lib/__init__.py,sha256=7-3QnN8Zf0wj8NCr2oJmqoQWMKKPKTECvjH9pd2S5vY,159
-supervisely-6.73.344.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-supervisely-6.73.344.dist-info/METADATA,sha256=jYLJlhCcUufKznUrKoqqqzibJr920dezFFVBpx308LA,33596
-supervisely-6.73.344.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
-supervisely-6.73.344.dist-info/entry_points.txt,sha256=U96-5Hxrp2ApRjnCoUiUhWMqijqh8zLR03sEhWtAcms,102
-supervisely-6.73.344.dist-info/top_level.txt,sha256=kcFVwb7SXtfqZifrZaSE3owHExX4gcNYe7Q2uoby084,28
-supervisely-6.73.344.dist-info/RECORD,,
+supervisely-6.73.346.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+supervisely-6.73.346.dist-info/METADATA,sha256=yUMHQ-WdsvhuLAX9ZHWWh3fgUDTlkNR36oZaRpzRHf8,33596
+supervisely-6.73.346.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
+supervisely-6.73.346.dist-info/entry_points.txt,sha256=U96-5Hxrp2ApRjnCoUiUhWMqijqh8zLR03sEhWtAcms,102
+supervisely-6.73.346.dist-info/top_level.txt,sha256=kcFVwb7SXtfqZifrZaSE3owHExX4gcNYe7Q2uoby084,28
+supervisely-6.73.346.dist-info/RECORD,,