Merge pull request #635 from superannotateai/develop

Develop

Author: VaghinakDev

CHANGELOG.rst

@@ -6,6 +6,18 @@ History
 
 All release highlights of this project will be documented in this file.
 
+4.4.15 - August 20, 2023
+_______________________
+
+**Added**
+
+    - New project type support `CustomEditor`.
+
+**Updated**
+
+    - ``SAClient.get_item_by_id()`` Fixed.
+    - ``SAClient.consensus()`` Deprecation.
+
 4.4.13 - June 04, 2023
 _______________________
 

docs/source/api_reference/helpers.rst

@@ -22,10 +22,3 @@ ________________________
 .. _ref_aggregate_annotations_as_df:
 .. automethod:: superannotate.SAClient.validate_annotations
 .. automethod:: superannotate.SAClient.aggregate_annotations_as_df
-
-----------
-
-Utility functions
---------------------------------
-
-.. autofunction:: superannotate.SAClient.consensus

docs/source/userguide/quickstart.rst

@@ -25,13 +25,6 @@ It can be installed on Ubuntu with:
 
    sudo apt-get install ffmpeg
 
-To use the :py:obj:`consensus` function on Windows and Mac platforms, you might also need to install the shapely package
-beforehand. The package works well only under the Anaconda distribution with:
-
-.. code-block:: bash
-
-   conda install shapely
-
 ----------
 
 

docs/source/userguide/utilities.rst

@@ -126,64 +126,3 @@ Example of created DataFrame:
 
 Each row represents annotation information. One full annotation with multiple
 attribute groups can be grouped under :code:`instanceId` field.
-
-
-Working with DICOM files
-------------------------
-
-JPEG images with names :file:`<dicom_file_name>_<frame_num>.jpg` will be created
-in :file:`<path_to_output_dir>`. Those JPEG images can be uploaded to
-SuperAnnotate platform using the regular:
-
-.. code-block:: python
-
-   sa.upload_images_from_folder_to_project(project, "<path_to_output_dir>")
-
-Some DICOM files can have image frames that are compressed. To load them, `GDCM :
-Grassroots DICOM library <http://gdcm.sourceforge.net/wiki/index.php/Main_Page>`_ needs to be installed:
-
-.. code-block:: bash
-
-   # using conda
-   conda install -c conda-forge gdcm
-
-   # or on Ubuntu with versions above 19.04
-   sudo apt install python3-gdcm
-
-Computing consensus scores for instances between several projects
------------------------------------------------------------------
-
-
-Consensus is a tool to compare the quallity of the annotations of the same image that is present in several projects.
-To compute the consensus scores:
-
-.. code-block:: python
-
-   res_df = sa.consensus([project_names], "<path_to_export_folder>", [image_list], "<annotation_type>")
-
-Here pandas DataFrame with following columns is returned: creatorEmail, imageName, instanceId, className, area, attribute, projectName, score
-
-.. image:: images/consensus_dataframe.png
-
-Besides the pandas DataFrame there is an option to get the following plots by setting the show_plots flag to True:
-
-* Box plot of consensus scores for each annotators
-* Box plot of consensus scores for each project
-* Scatter plots of consensus score vs instance area for each project
-
-.. code-block:: python
-
-   sa.consensus([project_names], "<path_to_export_folder>", [image_list], "<annotation_type>", show_plots=True)
-
-To the left of each box plot the original score points of that annotator is depicted, the box plots are colored by annotator.
-
-.. image:: images/consensus_annotators_box.png
-
-Analogically the box plots of consensus scores for each project are colored according to project name.
-
-.. image:: images/consensus_projects_box.png
-
-Scatter plot of consensus score vs instance area is separated by projects. Hovering on a point reveals its annotator and image name.
-The points are colored according to class name. Each annotator is represented with separate symbol.
-
-.. image:: images/consensus_scatter.png

requirements.txt

@@ -9,7 +9,7 @@ pandas~=1.3
 ffmpeg-python~=0.2
 pillow~=9.5
 aiofiles==23.1.0
-requests==2.30.0
+requests==2.31.0
 tqdm==4.64.0
 fire==0.4.0
 mixpanel==4.8.3

src/superannotate/__init__.py

@@ -2,7 +2,8 @@
 import os
 import sys
 
-__version__ = "4.4.13"
+
+__version__ = "4.4.14"
 
 sys.path.append(os.path.split(os.path.realpath(__file__))[0])
 

src/superannotate/lib/app/interface/sdk_interface.py

@@ -72,7 +72,7 @@
 PROJECT_STATUS = Literal["NotStarted", "InProgress", "Completed", "OnHold"]
 
 PROJECT_TYPE = Literal[
-    "Vector", "Pixel", "Video", "Document", "Tiled", "Other", "PointCloud"
+    "Vector", "Pixel", "Video", "Document", "Tiled", "Other", "PointCloud", "CustomEditor"
 ]
 
 CLASS_TYPE = Literal["object", "tag"]
@@ -156,8 +156,8 @@ def get_folder_by_id(self, project_id: int, folder_id: int):
         response = self.controller.get_folder_by_id(
             folder_id=folder_id, project_id=project_id
         )
-
-        return FolderSerializer(response).serialize(
+        response.raise_for_status()
+        return FolderSerializer(response.data).serialize(
             exclude={"completedCount", "is_root"}
         )
 
@@ -173,12 +173,13 @@ def get_item_by_id(self, project_id: int, item_id: int):
         :return: item metadata
         :rtype: dict
         """
-
+        project_response = self.controller.get_project_by_id(project_id=project_id)
+        project_response.raise_for_status()
         response = self.controller.get_item_by_id(
-            item_id=item_id, project_id=project_id
+            item_id=item_id, project=project_response.data
         )
 
-        return ItemSerializer(response).serialize(exclude={"url", "meta"})
+        return ItemSerializer(response.data).serialize(exclude={"url", "meta"})
 
     def get_team_metadata(self):
         """Returns team metadata
@@ -1513,10 +1514,6 @@ def download_export(
         to_s3_bucket=None,
     ):
         """Download prepared export.
-
-        WARNING: Starting from version 1.9.0 :ref:`download_export <ref_download_export>` additionally
-        requires :py:obj:`project` as first argument.
-
         :param project: project name
         :type project: str
         :param export: export name

src/superannotate/lib/core/__init__.py

@@ -153,6 +153,36 @@ def setup_logging(level=DEFAULT_LOGGING_LEVEL, file_path=LOG_FILE_LOCATION):
 
 INVALID_JSON_MESSAGE = "Invalid json"
 
+PROJECT_SETTINGS_VALID_ATTRIBUTES = [
+    "Brightness",
+    "Fill",
+    "Contrast",
+    "ShowLabels",
+    "ShowComments",
+    "Image",
+    "Lines",
+    "AnnotatorFinish",
+    "PointSize",
+    "FontSize",
+    "WorkflowEnable",
+    "ClassChange",
+    "ShowEntropy",
+    "UploadImages",
+    "DeleteImages",
+    "Download",
+    "RunPredictions",
+    "RunSegmentations",
+    "ImageQuality",
+    "ImageAutoAssignCount",
+    "FrameMode",
+    "FrameRate",
+    "JumpBackward",
+    "JumpForward",
+    "UploadFileType",
+    "Tokenization",
+    "ImageAutoAssignEnable",
+]
+
 __alL__ = (
     FolderStatus,
     ProjectStatus,

src/superannotate/lib/core/enums.py

@@ -93,6 +93,9 @@ class ProjectType(BaseTitledEnum):
     TILED = "Tiled", 5
     OTHER = "Other", 6
     POINT_CLOUD = "PointCloud", 7
+    CUSTOM_EDITOR = "CustomEditor", 8
+    UNSUPPORTED_TYPE_1 = "UnsupportedType", 9
+    UNSUPPORTED_TYPE_2 = "UnsupportedType", 10
 
     @classproperty
     def images(self):

src/superannotate/lib/core/repositories.py

@@ -36,11 +36,13 @@ def __init__(
         secret_key: str,
         session_token: str,
         bucket: str,
+        region: str,
     ):
         self._session = boto3.Session(
             aws_access_key_id=access_key,
             aws_secret_access_key=secret_key,
             aws_session_token=session_token,
+            region_name=region,
         )
 
         self._resource = self._session.resource("s3")