dtlpy 1.104.14__py3-none-any.whl → 1.106.5__py3-none-any.whl

dtlpy/__init__.py

@@ -176,11 +176,6 @@ try:
 except Exception:
     logger.debug("Failed to check SDK! Continue without")
 
-try:
-    check_sdk.resolve_platform_settings(client_api=client_api, settings=settings)
-except Exception:
-    pass
-
 verbose = client_api.verbose
 login = client_api.login
 logout = client_api.logout
@@ -195,7 +190,6 @@ info = client_api.info
 cache_state = client_api.cache_state
 attributes_mode = client_api.attributes_mode
 sdk_cache = client_api.sdk_cache
-platform_settings = client_api.platform_settings
 
 
 def get_secret(secret):
@@ -329,8 +323,6 @@ INSTANCE_CATALOG_HIGHMEM_XS = InstanceCatalog.HIGHMEM_XS
 INSTANCE_CATALOG_HIGHMEM_S = InstanceCatalog.HIGHMEM_S
 INSTANCE_CATALOG_HIGHMEM_M = InstanceCatalog.HIGHMEM_M
 INSTANCE_CATALOG_HIGHMEM_L = InstanceCatalog.HIGHMEM_L
-INSTANCE_CATALOG_GPU_K80_S = InstanceCatalog.GPU_K80_S
-INSTANCE_CATALOG_GPU_K80_M = InstanceCatalog.GPU_K80_M
 INSTANCE_CATALOG_GPU_T4_S = InstanceCatalog.GPU_T4_S
 INSTANCE_CATALOG_GPU_T4_M = InstanceCatalog.GPU_T4_M
 

dtlpy/__version__.py

@@ -1 +1 @@
-version = '1.104.14'
+version = '1.106.5'

dtlpy/entities/annotation.py

@@ -1634,6 +1634,17 @@ class Annotation(entities.BaseEntity):
 
         return _json
 
+    def task_scores(self, task_id: str, page_offset: int = None, page_size: int = None):
+        """
+        Get the scores of the annotation in a specific task.
+        :param task_id: The ID of the task.
+        :param page_offset: The page offset.
+        :param page_size: The page size.
+        :return: page of scores
+        """
+        return self.annotations.task_scores(annotation_id=self.id ,task_id=task_id, page_offset=page_offset, page_size=page_size)
+        
+
 
 @attr.s
 class FrameAnnotation(entities.BaseEntity):

dtlpy/entities/annotation_definitions/box.py

@@ -1,9 +1,6 @@
-import copy
-
 import numpy as np
 from . import BaseAnnotationDefinition
 from .polygon import Polygon
-import warnings
 
 
 class Box(BaseAnnotationDefinition):
@@ -45,72 +42,21 @@ class Box(BaseAnnotationDefinition):
         self.bottom_left = [left, bottom]
         self.bottom_right = [right, bottom]
         self.label = label
-        self._four_points = self._rotate_around_point() if self.is_rotated else [self.top_left,
-                                                                                 self.bottom_left,
-                                                                                 self.bottom_right,
-                                                                                 self.top_right]
-
-    @property
-    def is_rotated(self):
-        return self.angle is not None and self.angle != 0
 
     @property
     def x(self):
-        if self._box_points_setting():
-            return [x_point[0] for x_point in self._four_points]
         return [self.left, self.right]
 
     @property
     def y(self):
-        if self._box_points_setting():
-            return [y_point[1] for y_point in self._four_points]
         return [self.top, self.bottom]
 
     @property
     def geo(self):
-        if self._box_points_setting():
-            res = self._four_points
-        else:
-            res = [
-                [self.left, self.top],
-                [self.right, self.bottom]
-            ]
-        return res
-
-    def _box_points_setting(self):
-        res = False
-        if self._annotation and self._annotation.item:
-            item = self._annotation.item
-            project_id = item.project_id if item.project_id else item.project.id
-            settings_dict = item._client_api.platform_settings.settings.get('4ptBox', None)
-            if settings_dict is not None:
-                if project_id in settings_dict:
-                    res = settings_dict.get(project_id, None)
-                elif '*' in settings_dict:
-                    res = settings_dict.get('*', None)
-        return res
-
-    def _rotate_points(self, points):
-        angle = np.radians(self.angle)
-        rotation_matrix = np.asarray([[np.cos(angle), -np.sin(angle)],
-                                      [np.sin(angle), np.cos(angle)]])
-        pts2 = np.asarray([rotation_matrix.dot(pt)[:2] for pt in points])
-        return pts2
-
-    def _translate(self, points, translate_x, translate_y=None):
-        translation_matrix = np.asarray([[1, 0, translate_x],
-                                         [0, 1, translate_y],
-                                         [0, 0, 1]])
-        pts2 = np.asarray([translation_matrix.dot(list(pt) + [1])[:2] for pt in points])
-        return pts2
-
-    def _rotate_around_point(self):
-        points = copy.deepcopy(self.four_points)
-        center = [((self.left + self.right) / 2), ((self.top + self.bottom) / 2)]
-        centerized = self._translate(points, -center[0], -center[1])
-        rotated = self._rotate_points(centerized)
-        moved = self._translate(rotated, center[0], center[1])
-        return moved
+        return [
+            [self.left, self.top],
+            [self.right, self.bottom]
+        ]
 
     @property
     def four_points(self):
@@ -140,10 +86,7 @@ class Box(BaseAnnotationDefinition):
             thickness = 2
 
         # draw annotation
-        if self.is_rotated:
-            points = self._rotate_around_point()
-        else:
-            points = self.four_points
+        points = self.four_points
 
         # create image to draw on
         if alpha != 1:

dtlpy/entities/compute.py

@@ -20,6 +20,7 @@ class ComputeStatus(str, Enum):
     READY = "ready"
     INITIALIZING = "initializing"
     PAUSE = "pause"
+    FAILED = "failed"
 
 
 class Toleration:

dtlpy/entities/dataset.py

@@ -516,6 +516,23 @@ class Dataset(entities.BaseEntity):
         return self.datasets.update(dataset=self,
                                     system_metadata=system_metadata)
 
+    def unlock(self):
+        """
+        Unlock dataset
+
+        **Prerequisites**: You must be an *owner* or *developer* to use this method.
+
+        :return: Dataset object
+        :rtype: dtlpy.entities.dataset.Dataset
+
+        **Example**:
+
+        .. code-block:: python
+
+            dataset = dataset.unlock()
+        """
+        return self.datasets.unlock(dataset=self)
+
     def set_readonly(self, state: bool):
         """
         Set dataset readonly mode
@@ -607,7 +624,8 @@ class Dataset(entities.BaseEntity):
                              export_png_files=False,
                              filter_output_annotations=False,
                              alpha=1,
-                             export_version=ExportVersion.V1
+                             export_version=ExportVersion.V1,
+                             dataset_lock=False
                              ):
         """
         Download dataset by filters.
@@ -621,6 +639,7 @@ class Dataset(entities.BaseEntity):
         :param list(dtlpy.entities.annotation.ViewAnnotationOptions) annotation_options: download annotations options: list(dl.ViewAnnotationOptions)
         :param dtlpy.entities.filters.Filters annotation_filters: Filters entity to filter annotations for download
         :param bool overwrite: optional - default = False
+        :param bool dataset_lock: optional - default = False
         :param int thickness: optional - line thickness, if -1 annotation will be filled, default =1
         :param bool with_text: optional - add text to annotations, default = False
         :param str remote_path: DEPRECATED and ignored
@@ -642,7 +661,8 @@ class Dataset(entities.BaseEntity):
                                          overwrite=False,
                                          thickness=1,
                                          with_text=False,
-                                         alpha=1
+                                         alpha=1,
+                                         dataset_lock=False
                                          )
         """
 
@@ -660,7 +680,8 @@ class Dataset(entities.BaseEntity):
             export_png_files=export_png_files,
             filter_output_annotations=filter_output_annotations,
             alpha=alpha,
-            export_version=export_version
+            export_version=export_version,
+            dataset_lock=dataset_lock            
         )
 
     def export(self,
@@ -671,7 +692,8 @@ class Dataset(entities.BaseEntity):
                include_feature_vectors: bool = False,
                include_annotations: bool = False,
                export_type: ExportType = ExportType.JSON,
-               timeout: int = 0):
+               timeout: int = 0,
+               dataset_lock: bool = False):
         """
         Export dataset items and annotations.
 
@@ -685,6 +707,7 @@ class Dataset(entities.BaseEntity):
         :param dtlpy.entities.filters.Filters feature_vector_filters: Filters entity
         :param bool include_feature_vectors: Include item feature vectors in the export
         :param bool include_annotations: Include item annotations in the export
+        :param bool dataset_lock: Make dataset readonly during the export
         :param entities.ExportType export_type: Type of export ('json' or 'zip')
         :param int timeout: Maximum time in seconds to wait for the export to complete
         :return: Exported item
@@ -708,7 +731,8 @@ class Dataset(entities.BaseEntity):
                                     include_feature_vectors=include_feature_vectors,
                                     include_annotations=include_annotations,
                                     export_type=export_type,
-                                    timeout=timeout)
+                                    timeout=timeout,
+                                   dataset_lock=dataset_lock)
 
     def upload_annotations(self,
                            local_path,
@@ -942,7 +966,8 @@ class Dataset(entities.BaseEntity):
             with_text=False,
             without_relative_path=None,
             alpha=1,
-            export_version=ExportVersion.V1
+            export_version=ExportVersion.V1,
+            dataset_lock=False
     ):
         """
         Download dataset by filters.
@@ -957,6 +982,7 @@ class Dataset(entities.BaseEntity):
         :param list annotation_options: type of download annotations: list(dl.ViewAnnotationOptions)
         :param dtlpy.entities.filters.Filters annotation_filters: Filters entity to filter annotations for download
         :param bool overwrite: optional - default = False to overwrite the existing files
+        :param bool dataset_lock: optional - default = False to make dataset readonly during the download
         :param bool to_items_folder: Create 'items' folder and download items to it
         :param int thickness: optional - line thickness, if -1 annotation will be filled, default =1
         :param bool with_text: optional - add text to annotations, default = False
@@ -974,7 +1000,8 @@ class Dataset(entities.BaseEntity):
                              overwrite=False,
                              thickness=1,
                              with_text=False,
-                             alpha=1
+                             alpha=1,
+                             dataset_lock=False,                             
                              )
         """
         return self.items.download(filters=filters,
@@ -988,7 +1015,8 @@ class Dataset(entities.BaseEntity):
                                    with_text=with_text,
                                    without_relative_path=without_relative_path,
                                    alpha=alpha,
-                                   export_version=export_version)
+                                   export_version=export_version,
+                                   dataset_lock=dataset_lock)
 
     def download_folder(
             self,
@@ -1004,7 +1032,8 @@ class Dataset(entities.BaseEntity):
             with_text=False,
             without_relative_path=None,
             alpha=1,
-            export_version=ExportVersion.V1
+            export_version=ExportVersion.V1,
+            dataset_lock=False
     ):
         """
         Download dataset folder.
@@ -1019,6 +1048,7 @@ class Dataset(entities.BaseEntity):
         :param list annotation_options: type of download annotations: list(dl.ViewAnnotationOptions)
         :param dtlpy.entities.filters.Filters annotation_filters: Filters entity to filter annotations for download
         :param bool overwrite: optional - default = False to overwrite the existing files
+        :param bool dataset_lock: optional - default = False to make the dataset readonly during the download
         :param bool to_items_folder: Create 'items' folder and download items to it
         :param int thickness: optional - line thickness, if -1 annotation will be filled, default =1
         :param bool with_text: optional - add text to annotations, default = False
@@ -1038,7 +1068,8 @@ class Dataset(entities.BaseEntity):
                              thickness=1,
                              with_text=False,
                              alpha=1,
-                             save_locally=True
+                             save_locally=True,
+                             dataset_lock=False
                              )
         """
         filters = self.datasets._bulid_folder_filter(folder_path=folder_path, filters=filters)
@@ -1053,7 +1084,8 @@ class Dataset(entities.BaseEntity):
                                    with_text=with_text,
                                    without_relative_path=without_relative_path,
                                    alpha=alpha,
-                                   export_version=export_version)
+                                   export_version=export_version,
+                                   dataset_lock=dataset_lock)
 
     def delete_labels(self, label_names):
         """

dtlpy/entities/item.py

@@ -453,7 +453,8 @@ class Item(entities.BaseEntity):
             with_text=False,
             annotation_filters=None,
             alpha=1,
-            export_version=ExportVersion.V1
+            export_version=ExportVersion.V1,
+            dataset_lock=False
     ):
         """
         Download dataset by filters.
@@ -467,6 +468,7 @@ class Item(entities.BaseEntity):
         :param list annotation_options: download annotations options:  list(dl.ViewAnnotationOptions)
         :param dtlpy.entities.filters.Filters annotation_filters: Filters entity to filter annotations for download
         :param bool overwrite: optional - default = False
+        :param bool dataset_lock: optional - default = False
         :param bool to_items_folder: Create 'items' folder and download items to it
         :param int thickness: optional - line thickness, if -1 annotation will be filled, default =1
         :param bool with_text: optional - add text to annotations, default = False
@@ -485,7 +487,8 @@ class Item(entities.BaseEntity):
                          thickness=1,
                          with_text=False,
                          alpha=1,
-                         save_locally=True
+                         save_locally=True,
+                         dataset_lock=False
                          )
         """
         # if dir - concatenate local path and item name
@@ -519,7 +522,8 @@ class Item(entities.BaseEntity):
                                    alpha=alpha,
                                    with_text=with_text,
                                    export_version=export_version,
-                                   filters=filters)
+                                   filters=filters,
+                                   dataset_lock=dataset_lock)
 
     def delete(self):
         """
@@ -824,6 +828,15 @@ class Item(entities.BaseEntity):
         filters.add(field='metadata.system.collections', values=None)
         filters.add(field='datasetId', values=self._dataset.id)
         return self._dataset.items.list(filters=filters)
+    
+    def task_scores(self, task_id: str, page_offset: int = None, page_size: int = None):
+        """
+        Get the scores of the item in a specific task.
+        :param task_id: The ID of the task.
+        :return: page of scores
+        """
+        return self.items.task_scores(item_id=self.id, task_id=task_id, page_offset=page_offset, page_size=page_size)
+
 
 class ModalityTypeEnum(str, Enum):
     """

dtlpy/entities/ontology.py

@@ -766,7 +766,7 @@ class Ontology(entities.BaseEntity):
         # TODO: Add support for import from ontology entity in the Future
         if not self._use_attributes_2:
             raise ValueError("This method is only supported for attributes 2 mode!")
-        new_ontology = self.from_json(_json=ontology_json, client_api=self._client_api, recipe=self.recipe)
+        new_ontology = self.from_json(_json=ontology_json, client_api=self._client_api)
 
         # Update 'labels' and 'attributes'
         self.labels = new_ontology.labels
@@ -794,6 +794,9 @@ class Ontology(entities.BaseEntity):
                     attribute_range=attribute_range
                 )
 
+        # Get remote updated 'attributes'
+        self.metadata["attributes"] = self.ontologies.get(ontology_id=self.id).attributes
+
         # Update 'instance map' and 'color map'
         self._instance_map = new_ontology.instance_map
         self._color_map = new_ontology.color_map

dtlpy/entities/prompt_item.py

@@ -447,3 +447,12 @@ class PromptItem:
                 # update the annotation with the new text
                 annotation.annotation_definition.text = existing_prompt_element['value']
                 self._item.annotations.update(annotation)
+
+    def update(self):
+        """
+        Update the prompt item in the platform. 
+        """
+        if self._item is not None:
+            self._item._Item__update_item_binary(_json=self.to_json())
+        else:
+            raise ValueError('Cannot update PromptItem without an item.')

dtlpy/entities/service.py

@@ -89,10 +89,6 @@ class InstanceCatalog(str, Enum):
          - highmem pod with medium size
        * - HIGHMEM_L
          - highmem pod with large size
-       * - GPU_K80_S
-         - GPU NVIDIA K80 pod with small size
-       * - GPU_K80_M
-         - GPU NVIDIA K80 pod with medium size
        * - GPU_T4_S
          - GPU NVIDIA T4 pod with regular memory
        * - GPU_T4_M
@@ -106,8 +102,6 @@ class InstanceCatalog(str, Enum):
     HIGHMEM_S = "highmem-s"
     HIGHMEM_M = "highmem-m"
     HIGHMEM_L = "highmem-l"
-    GPU_K80_S = "gpu-k80-s"
-    GPU_K80_M = "gpu-k80-m"
     GPU_T4_S = "gpu-t4"
     GPU_T4_M = "gpu-t4-m"
 

dtlpy/new_instance.py

@@ -104,7 +104,6 @@ class Dtlpy:
         self.cache_state = self.client_api.cache_state
         self.attributes_mode = self.client_api.attributes_mode
         self.sdk_cache = self.client_api.sdk_cache
-        self.platform_settings = self.client_api.platform_settings
 
     def __del__(self):
         for name, pool in self.client_api._thread_pools.items():
@@ -243,8 +242,6 @@ class Dtlpy:
         HIGHMEM_S = 'highmem-s'
         HIGHMEM_M = 'highmem-m'
         HIGHMEM_L = 'highmem-l'
-        GPU_K80_S = "gpu-k80-s"
-        GPU_K80_M = "gpu-k80-m"
         GPU_T4_S = "gpu-t4-s"
         GPU_T4_M = "gpu-t4-m"
 

dtlpy/repositories/annotations.py

@@ -885,6 +885,32 @@ class Annotations:
         """
         return entities.AnnotationCollection(item=self.item)
 
+    def task_scores(self, annotation_id: str, task_id: str, page_offset: int = 0, page_size: int = 100):
+        """
+        Get annotation scores in a task
+
+        **Prerequisites**: You must be able to read the task
+
+        :param str annotation_id: The id of the annotation
+        :param str task_id: The id of the task
+        :param int page_offset: starting page
+        :param int page_size: size of page
+        :return: json response
+        :rtype: dict
+        """
+        if annotation_id is None:
+            raise exceptions.PlatformException('400', 'annotation_id must be provided')
+        if task_id is None:
+            raise exceptions.PlatformException('400', 'task_id must be provided')
+
+        success, response = self._client_api.gen_request(req_type='get',
+                                                         path='/scores/tasks/{}/annotations/{}?page={}&pageSize={}'
+                                                         .format(task_id, annotation_id, page_offset, page_size))
+        if success:
+            return response.json()
+        else:
+            raise exceptions.PlatformException(response)
+
     ##################
     # async function #
     ##################

dtlpy/repositories/computes.py

@@ -8,6 +8,7 @@ from typing import List, Optional, Dict
 from ..entities import ComputeCluster, ComputeContext, ComputeType, Project
 from ..entities.integration import IntegrationType
 
+
 class Computes:
 
     def __init__(self, client_api: ApiClient):
@@ -44,7 +45,8 @@ class Computes:
             type: entities.ComputeType = entities.ComputeType.KUBERNETES,
             is_global: Optional[bool] = False,
             features: Optional[Dict] = None,
-            wait=True
+            wait=True,
+            status: entities.ComputeStatus = None
     ):
         """
         Create a new compute
@@ -57,6 +59,7 @@ class Computes:
         :param is_global: Is global
         :param features: Features
         :param wait: Wait for compute creation
+        :param status: Compute status
         :return: Compute
         """
 
@@ -67,7 +70,8 @@ class Computes:
             'global': is_global,
             'features': features,
             'shared_contexts': [sc.to_json() for sc in shared_contexts],
-            'cluster': cluster.to_json()
+            'cluster': cluster.to_json(),
+            'status': status
         }
 
         # request
@@ -86,7 +90,7 @@ class Computes:
         )
 
         if wait:
-            command_id = compute.metadata.get('system', {}).get('commands', {}).get('create', {})
+            command_id = compute.metadata.get('system', {}).get('commands', {}).get('create', None)
             if command_id is not None:
                 command = self.commands.get(command_id=command_id, url='api/v1/commands/faas/{}'.format(command_id))
                 command.wait()
@@ -200,7 +204,8 @@ class Computes:
             ComputeContext([], org_id, project_id),
             [],
             cluster,
-            ComputeType.KUBERNETES)
+            ComputeType.KUBERNETES,
+            status=config['config'].get('status', None))
         return compute
 
     def create_from_config_file(self, config_file_path, org_id, project_name: Optional[str] = None):
@@ -215,6 +220,7 @@ class Computes:
         compute = self.setup_compute_cluster(config, integration, org_id, project)
         return compute
 
+
 class ServiceDrivers:
 
     def __init__(self, client_api: ApiClient):

dtlpy/repositories/datasets.py

@@ -127,8 +127,8 @@ class Datasets:
         return dataset_id
 
     @staticmethod
-    def _build_payload(filters, include_feature_vectors, include_annotations, export_type, annotation_filters,
-                       feature_vector_filters):
+    def _build_payload(filters, include_feature_vectors, include_annotations,
+                       export_type, annotation_filters, feature_vector_filters, dataset_lock):
         valid_list = [e.value for e in entities.ExportType]
         valid_types = ', '.join(valid_list)
         if export_type not in ['json', 'zip']:
@@ -157,6 +157,8 @@ class Datasets:
         if annotation_filters is not None:
             payload['annotationsQuery'] = annotation_filters.prepare()['filter']
             payload['annotations']['filter'] = True
+        if dataset_lock:
+            payload['datasetLock'] = dataset_lock
 
         return payload
 
@@ -471,6 +473,32 @@ class Datasets:
             return dataset
         else:
             raise exceptions.PlatformException(response)
+        
+    @_api_reference.add(path='/datasets/{id}/unlock', method='patch')
+    def unlock(self, dataset: entities.Dataset ) -> entities.Dataset:
+        """
+        Unlock dataset.
+
+        **Prerequisites**: You must be an *owner* or *developer* to use this method.
+
+        :param dtlpy.entities.dataset.Dataset dataset: dataset object
+        :return: Dataset object
+        :rtype: dtlpy.entities.dataset.Dataset
+
+        **Example**:
+
+        .. code-block:: python
+
+            dataset = project.datasets.unlock(dataset='dataset_entity')
+        """
+        url_path = '/datasets/{}/unlock'.format(dataset.id)
+
+        success, response = self._client_api.gen_request(req_type='patch', path=url_path)
+        if success:
+            logger.info('Dataset was unlocked successfully')
+            return dataset
+        else:
+            raise exceptions.PlatformException(response)
 
     @_api_reference.add(path='/datasets/{id}/directoryTree', method='get')
     def directory_tree(self,
@@ -602,7 +630,8 @@ class Datasets:
                include_feature_vectors: bool = False,
                include_annotations: bool = False,
                export_type: entities.ExportType = entities.ExportType.JSON,
-               timeout: int = 0):
+               timeout: int = 0,
+               dataset_lock: bool = False):
         """
         Export dataset items and annotations.
 
@@ -619,6 +648,7 @@ class Datasets:
         :param dtlpy.entities.filters.Filters feature_vector_filters: Filters entity to filter feature vectors for export
         :param bool include_feature_vectors: Include item feature vectors in the export
         :param bool include_annotations: Include item annotations in the export
+        :param bool dataset_lock: Make dataset readonly during the export
         :param entities.ExportType export_type: Type of export ('json' or 'zip')
         :param int timeout: Maximum time in seconds to wait for the export to complete
         :return: Exported item
@@ -632,11 +662,12 @@ class Datasets:
                                                   filters=filters,
                                                   include_feature_vectors=True,
                                                   include_annotations=True,
-                                                  export_type=dl.ExportType.JSON)
+                                                  export_type=dl.ExportType.JSON,
+                                                  dataset_lock=True)
         """
         dataset_id = self._resolve_dataset_id(dataset, dataset_name, dataset_id)
-        payload = self._build_payload(filters, include_feature_vectors, include_annotations, export_type,
-                                      annotation_filters, feature_vector_filters)
+        payload = self._build_payload(filters, include_feature_vectors, include_annotations,
+                                       export_type, annotation_filters, feature_vector_filters, dataset_lock)
 
         success, response = self._client_api.gen_request(req_type='post', path=f'/datasets/{dataset_id}/export',
                                                          json_req=payload)
@@ -900,7 +931,8 @@ class Datasets:
                              export_png_files: bool = False,
                              filter_output_annotations: bool = False,
                              alpha: float = None,
-                             export_version=entities.ExportVersion.V1
+                             export_version=entities.ExportVersion.V1,
+                             dataset_lock: bool = False                    
                              ) -> str:
         """
         Download dataset's annotations by filters.
@@ -917,6 +949,7 @@ class Datasets:
         :param list annotation_options: type of download annotations: list(dl.ViewAnnotationOptions)
         :param dtlpy.entities.filters.Filters annotation_filters: Filters entity to filter annotations for download
         :param bool overwrite: optional - default = False to overwrite the existing files
+        :param bool dataset_loc: optional - default = False to make the dataset readonly
         :param int thickness: optional - line thickness, if -1 annotation will be filled, default =1
         :param bool with_text: optional - add text to annotations, default = False
         :param str remote_path: DEPRECATED and ignored
@@ -926,6 +959,7 @@ class Datasets:
         :param float alpha: opacity value [0 1], default 1
         :param str export_version:  exported items will have original extension in filename, `V1` - no original extension in filenames
         :return: local_path of the directory where all the downloaded item
+        :param bool dataset_lock: optional - default = False
         :rtype: str
 
         **Example**:
@@ -938,7 +972,8 @@ class Datasets:
                                                  overwrite=False,
                                                  thickness=1,
                                                  with_text=False,
-                                                 alpha=1
+                                                 alpha=1,
+                                                 dataset_lock=False                                                    
                                                  )
         """
         if annotation_options is None:
@@ -998,7 +1033,8 @@ class Datasets:
                                         include_annotations_in_output=include_annotations_in_output,
                                         export_png_files=export_png_files,
                                         filter_output_annotations=filter_output_annotations,
-                                        export_version=export_version
+                                        export_version=export_version,
+                                        dataset_lock=dataset_lock                                        
                                         )
         if annotation_options:
             pages = dataset.items.list(filters=filters)