supervisely 6.73.292__py3-none-any.whl → 6.73.294__py3-none-any.whl

supervisely/api/annotation_api.py

@@ -9,16 +9,21 @@ import json
 from collections import defaultdict
 from copy import deepcopy
 from typing import Any, Callable, Dict, List, Literal, NamedTuple, Optional, Union
+from uuid import uuid4
 
 from tqdm import tqdm
 
 from supervisely._utils import batched
 from supervisely.annotation.annotation import Annotation, AnnotationJsonFields
 from supervisely.annotation.label import Label, LabelJsonFields
+from supervisely.annotation.tag import Tag
+from supervisely.annotation.tag_meta import TagMeta, TagValueType
 from supervisely.api.module_api import ApiField, ModuleApi
 from supervisely.geometry.alpha_mask import AlphaMask
 from supervisely.geometry.constants import BITMAP
 from supervisely.project.project_meta import ProjectMeta
+from supervisely.project.project_type import _LABEL_GROUP_TAG_NAME
+from supervisely.sly_logger import logger
 
 
 class AnnotationInfo(NamedTuple):
@@ -1640,3 +1645,86 @@ class AnnotationApi(ModuleApi):
                 progress_cb(len(batch))
         ordered_results = [id_to_ann[image_id] for image_id in image_ids]
         return ordered_results
+
+    def append_labels_group(
+        self,
+        dataset_id: int,
+        image_ids: List[int],
+        labels: List[Label],
+        project_meta: Optional[ProjectMeta] = None,
+        group_name: Optional[str] = None,
+    ) -> None:
+        """
+        Append group of labels to corresponding multiview images.
+        This method will automatically add a tech tag to the labels to group them together.
+        Please note that grouped labels is supported only in images project with multiview setup.
+
+        :param dataset_id: Dataset ID in Supervisely.
+        :type dataset_id: int
+        :param image_ids: List of Images IDs in Supervisely.
+        :type image_ids: List[int]
+        :param labels: List of Labels in Supervisely.
+        :type labels: List[Label]
+        :param project_meta: Project meta. If not provided, will try to get it from the server.
+        :type project_meta: ProjectMeta, optional
+        :param group_name: Group name. Labels will be assigned by tag with this value.
+        :type group_name: str, optional
+        :return: :class:`None<None>`
+        :rtype: :class:`NoneType<NoneType>`
+        :raises ValueError: if number of images and labels are not the same
+
+        :Usage example:
+
+         .. code-block:: python
+
+            import supervisely as sly
+
+            os.environ['SERVER_ADDRESS'] = 'https://app.supervisely.com'
+            os.environ['API_TOKEN'] = 'Your Supervisely API Token'
+            api = sly.Api.from_env()
+
+            dataset_id = 123456
+            paths = ['path/to/audi_01.png', 'path/to/audi_02.png']
+            images_group_name = 'audi'
+
+            image_infos = api.image.upload_multiview_images(dataset_id, images_group_name, paths)
+
+            image_ids = [info.id for info in image_infos]
+            labels = [label1, label2]
+            labels_group_name = 'left_wheel'
+
+            # upload group of labels to corresponding multiview images
+            api.annotation.append_labels_group(image_ids, labels, labels_group_name)
+        """
+
+        if len(image_ids) != len(labels):
+            raise ValueError(
+                "Number of images and labels must be the same."
+                "If specific image does not have label, pass None instead."
+            )
+
+        if group_name is None:
+            group_name = str(uuid4().hex)
+
+        if project_meta is None:
+            logger.warning(
+                "Project meta is not provided. Will try to get it from the server. "
+                "It is recommended to provide project meta to avoid extra API requests."
+            )
+            dataset_info = self._api.dataset.get_info_by_id(dataset_id)
+            if dataset_info is None:
+                raise ValueError(f"Dataset with ID {dataset_id} not found")
+
+            project_id = dataset_info.project_id
+            project_meta = ProjectMeta.from_json(self._api.project.get_meta(project_id))
+
+        tag_meta = TagMeta(_LABEL_GROUP_TAG_NAME, TagValueType.ANY_STRING)
+        labels = [l.add_tag(Tag(tag_meta, group_name)) for l in labels if l is not None]
+
+        anns_json = self._api.annotation.download_json_batch(
+            dataset_id=dataset_id, image_ids=image_ids, force_metadata_for_links=False
+        )
+        anns = [Annotation.from_json(ann_json, project_meta) for ann_json in anns_json]
+        updated_anns = [ann.add_label(label) for ann, label in zip(anns, labels)]
+
+        self._api.annotation.upload_anns(image_ids, updated_anns)

supervisely/api/image_api.py

@@ -391,6 +391,7 @@ class ImageApi(RemoveableBulkModuleApi):
         project_id: Optional[int] = None,
         only_labelled: Optional[bool] = False,
         fields: Optional[List[str]] = None,
+        recursive: Optional[bool] = False,
     ) -> List[ImageInfo]:
         """
         List of Images in the given :class:`Dataset<supervisely.project.project.Dataset>`.
@@ -415,6 +416,8 @@ class ImageApi(RemoveableBulkModuleApi):
         :type only_labelled: bool, optional
         :param fields: List of fields to return. If None, returns all fields.
         :type fields: List[str], optional
+        :param recursive: If True, returns all images from dataset recursively (including images in nested datasets).
+        :type recursive: bool, optional
         :return: Objects with image information from Supervisely.
         :rtype: :class:`List[ImageInfo]<ImageInfo>`
         :Usage example:
@@ -474,6 +477,7 @@ class ImageApi(RemoveableBulkModuleApi):
             ApiField.SORT: sort,
             ApiField.SORT_ORDER: sort_order,
             ApiField.FORCE_METADATA_FOR_LINKS: force_metadata_for_links,
+            ApiField.RECURSIVE: recursive,
         }
         if only_labelled:
             data[ApiField.FILTERS] = [
@@ -4537,7 +4541,7 @@ class ImageApi(RemoveableBulkModuleApi):
                     loop = sly.utils.get_or_create_event_loop()
                     images = loop.run_until_complete(api.image.get_list_async(123456, per_page=600))
         """
-        
+
         method = "images.list"
         dataset_info = kwargs.get("dataset_info", None)
 

supervisely/api/project_api.py

@@ -52,6 +52,7 @@ from supervisely.project.project_settings import (
     ProjectSettingsJsonFields,
 )
 from supervisely.project.project_type import (
+    _LABEL_GROUP_TAG_NAME,
     _METADATA_SYSTEM_KEY,
     _METADATA_TIMESTAMP_KEY,
     _METADATA_VALIDATION_SCHEMA_KEY,
@@ -430,7 +431,9 @@ class ProjectApi(CloneableModuleApi, UpdateableModule, RemoveableModuleApi):
         """
 
         fields = [
-            x for x in self.info_sequence() if x not in (ApiField.ITEMS_COUNT, ApiField.SETTINGS, ApiField.CREATED_BY_ID)
+            x
+            for x in self.info_sequence()
+            if x not in (ApiField.ITEMS_COUNT, ApiField.SETTINGS, ApiField.CREATED_BY_ID)
         ]
 
         info = super().get_info_by_name(parent_id, name, fields)
@@ -1795,7 +1798,9 @@ class ProjectApi(CloneableModuleApi, UpdateableModule, RemoveableModuleApi):
         meta = meta.add_obj_classes(classes)
         self.update_meta(id, meta)
 
-    def _set_custom_grouping_settings(self, id: int, group_images: bool, tag_name: str, sync: bool):
+    def _set_custom_grouping_settings(
+        self, id: int, group_images: bool, tag_name: str, sync: bool, label_group_tag_name: str = None
+    ) -> None:
         """Sets the project settings for custom grouping.
 
         :param id: Project ID to set custom grouping settings.
@@ -1806,9 +1811,15 @@ class ProjectApi(CloneableModuleApi, UpdateableModule, RemoveableModuleApi):
         :type tag_name: str
         :param sync: if True images will have synchronized view and labeling
         :type sync: bool
+        :param label_group_tag_name: Name of the tag. Labels will be grouped by this tag
+        :type label_group_tag_name: str
+        :raises ValueError: if tag value type is not 'any_string'
+        :return: None
+        :rtype: :class:`NoneType`
         """
         meta = ProjectMeta.from_json(self.get_meta(id, with_settings=True))
         existing_tag_meta = meta.get_tag_meta(tag_name)
+        need_update = False
         if existing_tag_meta is not None:
             if existing_tag_meta.value_type != TagValueType.ANY_STRING:
                 raise ValueError(
@@ -1817,8 +1828,23 @@ class ProjectApi(CloneableModuleApi, UpdateableModule, RemoveableModuleApi):
                 )
         else:
             new_tag_meta = TagMeta(tag_name, TagValueType.ANY_STRING)
-            project_meta = meta.add_tag_meta(new_tag_meta)
-            self.update_meta(id, project_meta)
+            meta = meta.add_tag_meta(new_tag_meta)
+            need_update = True
+        if label_group_tag_name is not None:
+            label_group_tag_meta = meta.get_tag_meta(label_group_tag_name)
+            if label_group_tag_meta is not None:
+                if label_group_tag_meta.value_type != TagValueType.ANY_STRING:
+                    raise ValueError(
+                        f"Tag '{label_group_tag_name}' should have value type 'any_string', "
+                        f"but got '{label_group_tag_meta.value_type}' value type."
+                    )
+            else:
+                label_group_tag_meta = TagMeta(label_group_tag_name, TagValueType.ANY_STRING)
+                meta = meta.add_tag_meta(label_group_tag_meta)
+                need_update = True
+        if need_update:
+            self.update_meta(id, meta)
+
         self.images_grouping(id, enable=group_images, tag_name=tag_name, sync=sync)
 
     def set_multispectral_settings(self, project_id: int) -> None:
@@ -1885,6 +1911,7 @@ class ProjectApi(CloneableModuleApi, UpdateableModule, RemoveableModuleApi):
             group_images=True,
             tag_name=_MULTIVIEW_TAG_NAME,
             sync=False,
+            label_group_tag_name=_LABEL_GROUP_TAG_NAME,
         )
 
     def remove_permanently(

supervisely/project/project_type.py

@@ -14,6 +14,7 @@ class ProjectType(StrEnum):
 # Constants for multispectral and multiview projects.
 _MULTISPECTRAL_TAG_NAME = "multispectral"
 _MULTIVIEW_TAG_NAME = "multiview"
+_LABEL_GROUP_TAG_NAME = "@label-group-id"
 
 _METADATA_SYSTEM_KEY = "sly_system"
 _METADATA_VALIDATION_SCHEMA_KEY = "validation_schema"

{supervisely-6.73.292.dist-info → supervisely-6.73.294.dist-info}/METADATA

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

{supervisely-6.73.292.dist-info → supervisely-6.73.294.dist-info}/RECORD

@@ -21,14 +21,14 @@ supervisely/annotation/tag_meta_mapper.py,sha256=RWeTrxJ64syodyhXIRSH007bX6Hr3B4
 supervisely/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 supervisely/api/advanced_api.py,sha256=Nd5cCnHFWc3PSUrCtENxTGtDjS37_lCHXsgXvUI3Ti8,2054
 supervisely/api/agent_api.py,sha256=ShWAIlXcWXcyI9fqVuP5GZVCigCMJmjnvdGUfLspD6Y,8890
-supervisely/api/annotation_api.py,sha256=fVQJOg5SLcD_mRUmPaVsJIOVTGFhsabRXqve0LyUgrc,64743
+supervisely/api/annotation_api.py,sha256=kuk4qwojTJxYr2iqAKbW-QhWw_DFc4TsjA2Wc2MEaqw,68449
 supervisely/api/api.py,sha256=YBE6yi682H5dy3BBQtESmfC9hKZcbHyYRPNGLRldgSU,66014
 supervisely/api/app_api.py,sha256=RsbVej8WxWVn9cNo5s3Fqd1symsCdsfOaKVBKEUapRY,71927
 supervisely/api/dataset_api.py,sha256=GH7prDRJKyJlTv_7_Y-RkTwJN7ED4EkXNqqmi3iIdI4,41352
 supervisely/api/file_api.py,sha256=v2FsD3oljwNPqcDgEJRe8Bu5k0PYKzVhqmRb5QFaHAQ,83422
 supervisely/api/github_api.py,sha256=NIexNjEer9H5rf5sw2LEZd7C1WR-tK4t6IZzsgeAAwQ,623
 supervisely/api/image_annotation_tool_api.py,sha256=YcUo78jRDBJYvIjrd-Y6FJAasLta54nnxhyaGyanovA,5237
-supervisely/api/image_api.py,sha256=oi8luorbCaqMzd88_sjKeQQsX4eYOGJ8DVEbmSM44bw,192139
+supervisely/api/image_api.py,sha256=WIML_6N1qgOWBm3acexmGSWz4hAaSxlYmUtbytROaP8,192375
 supervisely/api/import_storage_api.py,sha256=BDCgmR0Hv6OoiRHLCVPKt3iDxSVlQp1WrnKhAK_Zl84,460
 supervisely/api/issues_api.py,sha256=BqDJXmNoTzwc3xe6_-mA7FDFC5QQ-ahGbXk_HmpkSeQ,17925
 supervisely/api/labeling_job_api.py,sha256=odnzZjp29yM16Gq-FYkv-OA4WFMNJCLFo4qSikW2A7c,56280
@@ -36,7 +36,7 @@ supervisely/api/module_api.py,sha256=x5C1KvTulm5yZ-s9Sa47T4u--QRG6ditj1GhcqocTeA
 supervisely/api/neural_network_api.py,sha256=ktPVRO4Jeulougio8F0mioJJHwRJcX250Djp1wBoQ9c,7620
 supervisely/api/object_class_api.py,sha256=-rQcKwhBw3iL9KNH9c1ROgoimgWM1ls6Wi_tb1R-MzY,7683
 supervisely/api/plugin_api.py,sha256=TlfrosdRuYG4NUxk92QiQoVaOdztFspPpygyVa3M3zk,5283
-supervisely/api/project_api.py,sha256=ZTRx7LXsPLjMuGq_PhugPgN-OsGMtTRxputH9EA9iZ0,78774
+supervisely/api/project_api.py,sha256=pBhZlSL3IA0FeBoK8eyhFDh8pnW_X8mbmit4cAJQUoo,79951
 supervisely/api/project_class_api.py,sha256=5cyjdGPPb2tpttu5WmYoOxUNiDxqiojschkhZumF0KM,1426
 supervisely/api/remote_storage_api.py,sha256=qTuPhPsstgEjRm1g-ZInddik8BNC_38YvBBPvgmim6U,17790
 supervisely/api/report_api.py,sha256=Om7CGulUbQ4BuJ16eDtz7luLe0JQNqab-LoLpUXu7YE,7123
@@ -1012,7 +1012,7 @@ supervisely/project/pointcloud_project.py,sha256=Kx1Vaes-krwG3BiRRtHRLQxb9G5m5bT
 supervisely/project/project.py,sha256=pDKRPZZCwW79wlfDi4JK9rOZisO2vWRfiOD_j7AId5k,202403
 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=_3RqW2CnDBKFOvSIrQT1RJQaiHirs34_jiQS8CkwCpo,530
+supervisely/project/project_type.py,sha256=EZDJFRi4MmC_5epYexBgML5WMZsWdEVk_CjqDQy5m3c,572
 supervisely/project/readme_template.md,sha256=rGmSLRVUSGjvorjpzl0sZ7YA4sKfDexl95NFtMISj3I,9128
 supervisely/project/upload.py,sha256=AjgHYgVZwUE25ygC5pqvFjdAladbyB8T78mlet5Qpho,3750
 supervisely/project/video_project.py,sha256=8fJeicVWNMbek24PmNRBtbnFhvXsnxPg5dpNrL5VNW4,63739
@@ -1071,9 +1071,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.292.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-supervisely-6.73.292.dist-info/METADATA,sha256=ZKWuHNkAWaRrj9VSUnHGAP1J0stiYcNzyl4VaKzkxI8,33573
-supervisely-6.73.292.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
-supervisely-6.73.292.dist-info/entry_points.txt,sha256=U96-5Hxrp2ApRjnCoUiUhWMqijqh8zLR03sEhWtAcms,102
-supervisely-6.73.292.dist-info/top_level.txt,sha256=kcFVwb7SXtfqZifrZaSE3owHExX4gcNYe7Q2uoby084,28
-supervisely-6.73.292.dist-info/RECORD,,
+supervisely-6.73.294.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+supervisely-6.73.294.dist-info/METADATA,sha256=tgjdB_FSwcOSyWj9_Mxkeije_FDbelZVyzWcy4vGTDo,33573
+supervisely-6.73.294.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
+supervisely-6.73.294.dist-info/entry_points.txt,sha256=U96-5Hxrp2ApRjnCoUiUhWMqijqh8zLR03sEhWtAcms,102
+supervisely-6.73.294.dist-info/top_level.txt,sha256=kcFVwb7SXtfqZifrZaSE3owHExX4gcNYe7Q2uoby084,28
+supervisely-6.73.294.dist-info/RECORD,,