|
19 | 19 | History <changelog_link> |
20 | 20 | LICENSE.rst |
21 | 21 |
|
22 | | ----------- |
23 | | - |
24 | | -SuperAnnotate Python SDK documentation |
25 | | -================================================================== |
26 | | - |
27 | | -SuperAnnotate Python SDK allows access to the platform without web browser: |
28 | | - |
29 | | -.. code-block:: python |
30 | | -
|
31 | | - from superannotate import SAClient |
32 | | -
|
33 | | -
|
34 | | - sa_client = SAClient() |
35 | | -
|
36 | | - project = 'Dogs' |
37 | | -
|
38 | | - sa_client.create_project( |
39 | | - project_name=project, |
40 | | - project_description='Test project generated via SDK', |
41 | | - project_type='Vector' |
42 | | - ) |
43 | | -
|
44 | | - sa_client.create_annotation_class( |
45 | | - project=project, |
46 | | - name='dog', |
47 | | - color='#F9E0FA', |
48 | | - class_type='tag' |
49 | | - ) |
50 | | -
|
51 | | - sa_client.attach_items( |
52 | | - project=project, |
53 | | - attachments=[ |
54 | | - { |
55 | | - 'url': 'https://drive.google.com/uc?export=download&id=1ipOrZNSTlPUkI_hnrW9aUD5yULqqq5Vl', |
56 | | - 'name': 'dog.jpeg' |
57 | | - } |
58 | | - ] |
59 | | - ) |
60 | | -
|
61 | | - sa_client.upload_annotations( |
62 | | - project=project, |
63 | | - annotations=[ |
64 | | - { |
65 | | - 'metadata': {'name': 'dog.jpeg'}, |
66 | | - 'instances': [ |
67 | | - {'type': 'tag', 'className': 'dog'} |
68 | | - ] |
69 | | - } |
70 | | - ] |
71 | | - ) |
72 | | -
|
73 | | - sa_client.get_annotations(project=project, items=['dog.jpeg']) |
74 | | -
|
75 | | ----------- |
76 | | - |
77 | | -Installation |
78 | | -____________ |
79 | | - |
80 | | - |
81 | | -SDK is available on PyPI: |
82 | | - |
83 | | -.. code-block:: bash |
84 | | -
|
85 | | - pip install superannotate |
86 | | -
|
87 | | -
|
88 | | -The package officially supports Python 3.7+ and was tested under Linux and |
89 | | -Windows (`Anaconda <https://www.anaconda.com/products/individual#windows>`_) platforms. |
90 | | - |
91 | | ----------- |
92 | | - |
93 | | -Supported Features |
94 | | -__________________ |
95 | | - |
96 | | -- Search projects |
97 | | -- Create/delete a project |
98 | | -- Upload images to a project from a local or AWS S3 folder |
99 | | -- Upload videos to a project from a local folder |
100 | | -- Upload annotations/pre-annotations to a project from local or AWS S3 folder |
101 | | -- Set the annotation status of the images being uploaded |
102 | | -- Export annotations from a project to a local or AWS S3 folder |
103 | | -- Share and unshare a project with a team contributor |
104 | | -- Invite a team contributor |
105 | | -- Search images in a project |
106 | | -- Download a single image |
107 | | -- Copy/move image between projects |
108 | | -- Get image bytes (e.g., for numpy array creation) |
109 | | -- Set image annotation status |
110 | | -- Download image annotations/pre-annotations |
111 | | -- Create/download project annotation classes |
112 | | -- Add annotations to images on platform |
113 | | -- Convert annotation format from/to COCO |
114 | | -- Add annotations to local SuperAnnotate format JSONs |
115 | | -- CLI commands for simple tasks |
116 | | -- Aggregate class/attribute distribution as histogram |
117 | | - |
118 | | ----------- |
119 | | - |
120 | | -License |
121 | | -_______ |
122 | | - |
123 | | -This SDK is distributed under the :ref:`MIT License <ref_license>`. |
124 | | - |
125 | | ----------- |
126 | | - |
127 | | -Questions and Issues |
128 | | -____________________ |
129 | | - |
130 | | -For questions and issues please use issue tracker on |
131 | | -`GitHub <https://github.com/superannotateai/superannotate-python-sdk>`_. |
| 22 | +.. include:: ../../README.rst |
0 commit comments