t2d2-sdk 2.3.2__tar.gz → 2.3.4__tar.gz

t2d2_sdk-2.3.4/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: t2d2-sdk
+Version: 2.3.4
+Summary: T2D2 SDK
+Author-email: Badri Hiriyur <badri@t2d2.ai>
+Project-URL: Homepage, https://t2d2.ai
+Project-URL: Issues, https://github.com/t2d2-ai/t2d2-sdk/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: boto3
+Requires-Dist: requests
+Requires-Dist: sentry_sdk
+Dynamic: license-file
+
+# T2D2 SDK
+
+A Python SDK for seamless integration with the T2D2 platform.
+
+Easily manage projects, assets, and AI-powered inspections for structural health monitoring.
+
+## Description
+
+**T2D2 SDK** is a Python wrapper for the T2D2 API, enabling seamless integration with T2D2 projects and related assets for structural inspection data management.
+
+- Manage projects, images, annotations, drawings, videos, reports, and more
+- Upload, download, and organize assets
+- Run AI inference and summarize inspection data
+- Integrate with T2D2's web platform
+
+## Documentation
+
+Full documentation is available at: [https://t2d2-ai.github.io/t2d2-sdk/](https://t2d2-ai.github.io/t2d2-sdk/)
+
+## Table of Contents
+- [Features](#features)
+- [Installation](#installation)
+- [Quickstart](#quickstart)
+- [Usage](#usage)
+- [Contributing](#contributing)
+- [License](#license)
+- [Support](#support)
+
+## Features
+
+- **Authentication**: API key or email/password
+- **Project Management**: Set, get, and summarize projects
+- **Asset Management**: Upload/download images, drawings, videos, 3D models, and reports
+- **Annotations**: Add, retrieve, and manage annotation classes and annotations
+- **Regions & Tags**: Organize assets by regions and tags
+- **AI Integration**: Run AI inference on images using project models
+- **Summarization**: Summarize images and annotation conditions
+- **Notifications**: Send notifications to users or Slack
+
+## Installation
+
+Install the latest version from PyPI:
+
+```bash
+pip install --upgrade t2d2-sdk
+```
+
+## Quickstart
+
+1. **Sign up for a T2D2 account:** [Register here](https://app.t2d2.ai/auth/register)
+2. **Get your API key** from the T2D2 web app
+3. **Initialize the client:**
+
+```python
+from t2d2_sdk import T2D2
+
+credentials = {'api_key': '<YOUR_API_KEY>'}
+t2d2 = T2D2(credentials)
+```
+
+## Usage
+
+### Set Project
+```python
+t2d2.set_project('<PROJECT_ID>')
+project_info = t2d2.get_project_info()
+print(project_info)
+```
+
+### Upload Images
+```python
+image_paths = ['./images/img1.jpg', './images/img2.jpg']
+response = t2d2.upload_images(image_paths)
+print(response)
+```
+
+### Get Images
+```python
+images = t2d2.get_images()
+for img in images:
+    print(img['filename'], img['id'])
+```
+
+### Add Annotation Class
+```python
+result = t2d2.add_annotation_class('Crack', color='#FF0000', materials=['Concrete'])
+print(result)
+```
+
+### Add Annotations to an Image
+```python
+annotations = [
+    {
+        'annotation_class_id': 'class_id',
+        'coordinates': [[100, 100], [200, 100], [200, 200], [100, 200]],
+        'attributes': {'severity': 'high'}
+    }
+]
+result = t2d2.add_annotations('image_id', annotations)
+print(result)
+```
+
+### Run AI Inference
+```python
+result = t2d2.run_ai_inferencer(
+    image_ids=['image_id1', 'image_id2'],
+    model_id='model_id',
+    confidence_threshold=0.6
+)
+print(result)
+```
+
+For more advanced usage, see the [full documentation](https://t2d2-ai.github.io/t2d2-sdk/).
+
+## Contributing
+
+Contributions are welcome! Please contact <bhiriyur@t2d2.ai> for more information.
+
+## License
+
+See the LICENSE file for details.
+
+## Support
+
+- Documentation: [https://t2d2-ai.github.io/t2d2-sdk/](https://t2d2-ai.github.io/t2d2-sdk/)
+- Email: <bhiriyur@t2d2.ai>
+- T2D2 Web: [https://t2d2.ai](https://t2d2.ai)

t2d2_sdk-2.3.4/README.md

@@ -0,0 +1,127 @@
+# T2D2 SDK
+
+A Python SDK for seamless integration with the T2D2 platform.
+
+Easily manage projects, assets, and AI-powered inspections for structural health monitoring.
+
+## Description
+
+**T2D2 SDK** is a Python wrapper for the T2D2 API, enabling seamless integration with T2D2 projects and related assets for structural inspection data management.
+
+- Manage projects, images, annotations, drawings, videos, reports, and more
+- Upload, download, and organize assets
+- Run AI inference and summarize inspection data
+- Integrate with T2D2's web platform
+
+## Documentation
+
+Full documentation is available at: [https://t2d2-ai.github.io/t2d2-sdk/](https://t2d2-ai.github.io/t2d2-sdk/)
+
+## Table of Contents
+- [Features](#features)
+- [Installation](#installation)
+- [Quickstart](#quickstart)
+- [Usage](#usage)
+- [Contributing](#contributing)
+- [License](#license)
+- [Support](#support)
+
+## Features
+
+- **Authentication**: API key or email/password
+- **Project Management**: Set, get, and summarize projects
+- **Asset Management**: Upload/download images, drawings, videos, 3D models, and reports
+- **Annotations**: Add, retrieve, and manage annotation classes and annotations
+- **Regions & Tags**: Organize assets by regions and tags
+- **AI Integration**: Run AI inference on images using project models
+- **Summarization**: Summarize images and annotation conditions
+- **Notifications**: Send notifications to users or Slack
+
+## Installation
+
+Install the latest version from PyPI:
+
+```bash
+pip install --upgrade t2d2-sdk
+```
+
+## Quickstart
+
+1. **Sign up for a T2D2 account:** [Register here](https://app.t2d2.ai/auth/register)
+2. **Get your API key** from the T2D2 web app
+3. **Initialize the client:**
+
+```python
+from t2d2_sdk import T2D2
+
+credentials = {'api_key': '<YOUR_API_KEY>'}
+t2d2 = T2D2(credentials)
+```
+
+## Usage
+
+### Set Project
+```python
+t2d2.set_project('<PROJECT_ID>')
+project_info = t2d2.get_project_info()
+print(project_info)
+```
+
+### Upload Images
+```python
+image_paths = ['./images/img1.jpg', './images/img2.jpg']
+response = t2d2.upload_images(image_paths)
+print(response)
+```
+
+### Get Images
+```python
+images = t2d2.get_images()
+for img in images:
+    print(img['filename'], img['id'])
+```
+
+### Add Annotation Class
+```python
+result = t2d2.add_annotation_class('Crack', color='#FF0000', materials=['Concrete'])
+print(result)
+```
+
+### Add Annotations to an Image
+```python
+annotations = [
+    {
+        'annotation_class_id': 'class_id',
+        'coordinates': [[100, 100], [200, 100], [200, 200], [100, 200]],
+        'attributes': {'severity': 'high'}
+    }
+]
+result = t2d2.add_annotations('image_id', annotations)
+print(result)
+```
+
+### Run AI Inference
+```python
+result = t2d2.run_ai_inferencer(
+    image_ids=['image_id1', 'image_id2'],
+    model_id='model_id',
+    confidence_threshold=0.6
+)
+print(result)
+```
+
+For more advanced usage, see the [full documentation](https://t2d2-ai.github.io/t2d2-sdk/).
+
+## Contributing
+
+Contributions are welcome! Please contact <bhiriyur@t2d2.ai> for more information.
+
+## License
+
+See the LICENSE file for details.
+
+## Support
+
+- Documentation: [https://t2d2-ai.github.io/t2d2-sdk/](https://t2d2-ai.github.io/t2d2-sdk/)
+- Email: <bhiriyur@t2d2.ai>
+- T2D2 Web: [https://t2d2.ai](https://t2d2.ai)

{t2d2_sdk-2.3.2 → t2d2_sdk-2.3.4}/src/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '2.3.2'
-__version_tuple__ = version_tuple = (2, 3, 2)
+__version__ = version = '2.3.4'
+__version_tuple__ = version_tuple = (2, 3, 4)

t2d2_sdk-2.3.4/src/t2d2_sdk.egg-info/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: t2d2-sdk
+Version: 2.3.4
+Summary: T2D2 SDK
+Author-email: Badri Hiriyur <badri@t2d2.ai>
+Project-URL: Homepage, https://t2d2.ai
+Project-URL: Issues, https://github.com/t2d2-ai/t2d2-sdk/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: boto3
+Requires-Dist: requests
+Requires-Dist: sentry_sdk
+Dynamic: license-file
+
+# T2D2 SDK
+
+A Python SDK for seamless integration with the T2D2 platform.
+
+Easily manage projects, assets, and AI-powered inspections for structural health monitoring.
+
+## Description
+
+**T2D2 SDK** is a Python wrapper for the T2D2 API, enabling seamless integration with T2D2 projects and related assets for structural inspection data management.
+
+- Manage projects, images, annotations, drawings, videos, reports, and more
+- Upload, download, and organize assets
+- Run AI inference and summarize inspection data
+- Integrate with T2D2's web platform
+
+## Documentation
+
+Full documentation is available at: [https://t2d2-ai.github.io/t2d2-sdk/](https://t2d2-ai.github.io/t2d2-sdk/)
+
+## Table of Contents
+- [Features](#features)
+- [Installation](#installation)
+- [Quickstart](#quickstart)
+- [Usage](#usage)
+- [Contributing](#contributing)
+- [License](#license)
+- [Support](#support)
+
+## Features
+
+- **Authentication**: API key or email/password
+- **Project Management**: Set, get, and summarize projects
+- **Asset Management**: Upload/download images, drawings, videos, 3D models, and reports
+- **Annotations**: Add, retrieve, and manage annotation classes and annotations
+- **Regions & Tags**: Organize assets by regions and tags
+- **AI Integration**: Run AI inference on images using project models
+- **Summarization**: Summarize images and annotation conditions
+- **Notifications**: Send notifications to users or Slack
+
+## Installation
+
+Install the latest version from PyPI:
+
+```bash
+pip install --upgrade t2d2-sdk
+```
+
+## Quickstart
+
+1. **Sign up for a T2D2 account:** [Register here](https://app.t2d2.ai/auth/register)
+2. **Get your API key** from the T2D2 web app
+3. **Initialize the client:**
+
+```python
+from t2d2_sdk import T2D2
+
+credentials = {'api_key': '<YOUR_API_KEY>'}
+t2d2 = T2D2(credentials)
+```
+
+## Usage
+
+### Set Project
+```python
+t2d2.set_project('<PROJECT_ID>')
+project_info = t2d2.get_project_info()
+print(project_info)
+```
+
+### Upload Images
+```python
+image_paths = ['./images/img1.jpg', './images/img2.jpg']
+response = t2d2.upload_images(image_paths)
+print(response)
+```
+
+### Get Images
+```python
+images = t2d2.get_images()
+for img in images:
+    print(img['filename'], img['id'])
+```
+
+### Add Annotation Class
+```python
+result = t2d2.add_annotation_class('Crack', color='#FF0000', materials=['Concrete'])
+print(result)
+```
+
+### Add Annotations to an Image
+```python
+annotations = [
+    {
+        'annotation_class_id': 'class_id',
+        'coordinates': [[100, 100], [200, 100], [200, 200], [100, 200]],
+        'attributes': {'severity': 'high'}
+    }
+]
+result = t2d2.add_annotations('image_id', annotations)
+print(result)
+```
+
+### Run AI Inference
+```python
+result = t2d2.run_ai_inferencer(
+    image_ids=['image_id1', 'image_id2'],
+    model_id='model_id',
+    confidence_threshold=0.6
+)
+print(result)
+```
+
+For more advanced usage, see the [full documentation](https://t2d2-ai.github.io/t2d2-sdk/).
+
+## Contributing
+
+Contributions are welcome! Please contact <bhiriyur@t2d2.ai> for more information.
+
+## License
+
+See the LICENSE file for details.
+
+## Support
+
+- Documentation: [https://t2d2-ai.github.io/t2d2-sdk/](https://t2d2-ai.github.io/t2d2-sdk/)
+- Email: <bhiriyur@t2d2.ai>
+- T2D2 Web: [https://t2d2.ai](https://t2d2.ai)

{t2d2_sdk-2.3.2 → t2d2_sdk-2.3.4}/src/t2d2_sdk.py

@@ -2461,4 +2461,134 @@ class T2D2(object):
 
 
         url = "notifications/slack"
-        return self.request(url, RequestType.POST, data=payload)
+        return self.request(url, RequestType.POST, data=payload)
+    
+
+    ################################################################################################
+    # AI Models
+    ################################################################################################
+
+    def get_ai_models(self):
+        """
+        Retrieve all AI models available in the current project.
+        
+        This method fetches all AI models associated with the current project from the T2D2 API.
+        It returns a list of dictionaries containing details about each AI model.
+        
+        :return: A list of dictionaries, each containing AI model details
+        :rtype: list of dict
+        
+        :raises ValueError: If no project is currently set
+        :raises ConnectionError: If there is a problem connecting to the T2D2 API
+        
+        :example:
+        
+        >>> models = client.get_ai_models()
+        >>> print(models)
+        """
+        if not self.project:
+            raise ValueError("Project not set")
+        
+        url = f"{self.project['id']}/ai-models"
+        return self.request(url, RequestType.GET)
+    
+    def get_ai_model_by_id(self, model_id):
+        """
+        Retrieve details of a specific AI model by its ID.
+        
+        This method fetches detailed information about a specific AI model from the T2D2 API.
+        It returns a dictionary containing all the information available for the specified AI model.
+        
+        :param model_id: The ID of the AI model to retrieve
+        :type model_id: str
+        
+        :return: A dictionary containing AI model details
+        :rtype: dict
+        
+        """
+
+        if not self.project:
+            raise ValueError("Project not set")
+        
+        url = f"{self.project['id']}/ai-models/{model_id}"
+        return self.request(url, RequestType.GET)
+    
+    def run_ai_inferencer(self, image_ids, model_id, confidence_threshold=0.5, 
+                         replace_annotations=False, sliding_window=False, 
+                         whole_image=True, batch_size=1):
+        """
+        Run AI inference on specified images using a selected model.
+        
+        This method initiates an AI inference process on a set of images using the specified
+        model. It constructs the payload with model details and user parameters, then sends
+        the request to start the inference process.
+        
+        :param image_ids: List of image IDs to run inference on
+        :type image_ids: list of int
+        
+        :param model_id: ID of the AI model to use for inference
+        :type model_id: int
+        
+        :param confidence_threshold: Minimum confidence score for detections (0.0 to 1.0)
+        :type confidence_threshold: float
+        :default confidence_threshold: 0.5
+        
+        :param replace_annotations: Whether to replace existing annotations
+        :type replace_annotations: bool
+        :default replace_annotations: False
+        
+        :param sliding_window: Whether to use sliding window approach for inference
+        :type sliding_window: bool
+        :default sliding_window: False
+        
+        :param whole_image: Whether to process the whole image at once
+        :type whole_image: bool
+        :default whole_image: True
+        
+        :param batch_size: Number of images to process in each batch
+        :type batch_size: int
+        :default batch_size: 1
+        
+        :return: Response from the API containing the inference job details
+        :rtype: dict
+        
+        :raises ValueError: If no project is set or if required parameters are invalid
+        
+        :example:
+        
+        >>> image_ids = [000000, 000000, 000000]
+        >>> result = client.run_ai_inferencer(
+        ...     image_ids=image_ids,
+        ...     model_id=1,
+        ...     confidence_threshold=0.6
+        ... )
+        >>> print(result)
+        """
+        if not self.project:
+            raise ValueError("Project not set")
+            
+        # Get model details
+        model_details = self.get_ai_model_by_id(model_id)
+        if not model_details["success"]:
+            raise ValueError(f"Failed to get model details: {model_details.get('message', 'Unknown error')}")
+            
+        model_data = model_details["data"]
+        
+        # Construct payload
+        payload = {
+            "confidence_threshold": confidence_threshold,
+            "replace_annotations": replace_annotations,
+            "whole_image": whole_image,
+            "batch_size": batch_size,
+            "ai_model": model_id,
+            "description": model_data["description"],
+            "image_ids": image_ids,
+            "labels": model_data["labels"],
+            "sliding_window": sliding_window
+        }
+        
+        # Make request to start inference
+        url = f"{self.project['id']}/tools/6/start"
+        return self.request(url, RequestType.POST, data=payload)
+
+    

t2d2_sdk-2.3.2/PKG-INFO

@@ -1,67 +0,0 @@
-Metadata-Version: 2.4
-Name: t2d2-sdk
-Version: 2.3.2
-Summary: T2D2 SDK
-Author-email: Badri Hiriyur <badri@t2d2.ai>
-Project-URL: Homepage, https://t2d2.ai
-Project-URL: Issues, https://github.com/t2d2-ai/t2d2-sdk/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: BSD License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: boto3
-Requires-Dist: requests
-Requires-Dist: sentry_sdk
-Dynamic: license-file
-
-## Description
-
-T2D2 SDK python wrapper to API to interface with T2D2 projects and related assets.
-
-## Table of Contents
-
-- [Description](#description)
-- [Table of Contents](#table-of-contents)
-- [Installation](#installation)
-- [Usage](#usage)
-- [Contributing](#contributing)
-- [License](#license)
-
-## Installation
-
-This SDK is published to PyPI and the latest version can be installed as follows:
-`pip install --upgrade t2d2-sdk`
-
-## Usage
-
-These instructions assume that you have an account at T2D2 (<https://t2d2.ai>). If you do not have an account, you can sign up here: (<https://app.t2d2.ai/auth/register>). Subscription pricing details may be found here: (<https://t2d2.ai/pricing>).
-
-Once you have an account created, you can either use your email/password or an API KEY to instantiate the T2D2 client.
-
-```python
-from t2d2_sdk import T2D2
-
-credentials = {'email': "my@email.com", 'password': "<MYPASSWORD>"}
-credentials = {'api_key': "<MY_API_KEY>"}
-
-t2d2 = T2D2(credentials)
-```
-
-With this client, you can interface with the app and get access to most of the features of the web interface. More documentation coming soon at <https://docs.t2d2.ai>.
-
-```python
-t2d2.set_project(PROJECT_ID)
-project = t2d2.get_project()
-data = t2d2.get_images()
-...
-```
-
-## Contributing
-
-Please contact <bhiriyur@t2d2.ai> for further information on contributing to this project.
-
-## License
-
-Information about the project's license.

t2d2_sdk-2.3.2/README.md

@@ -1,49 +0,0 @@
-## Description
-
-T2D2 SDK python wrapper to API to interface with T2D2 projects and related assets.
-
-## Table of Contents
-
-- [Description](#description)
-- [Table of Contents](#table-of-contents)
-- [Installation](#installation)
-- [Usage](#usage)
-- [Contributing](#contributing)
-- [License](#license)
-
-## Installation
-
-This SDK is published to PyPI and the latest version can be installed as follows:
-`pip install --upgrade t2d2-sdk`
-
-## Usage
-
-These instructions assume that you have an account at T2D2 (<https://t2d2.ai>). If you do not have an account, you can sign up here: (<https://app.t2d2.ai/auth/register>). Subscription pricing details may be found here: (<https://t2d2.ai/pricing>).
-
-Once you have an account created, you can either use your email/password or an API KEY to instantiate the T2D2 client.
-
-```python
-from t2d2_sdk import T2D2
-
-credentials = {'email': "my@email.com", 'password': "<MYPASSWORD>"}
-credentials = {'api_key': "<MY_API_KEY>"}
-
-t2d2 = T2D2(credentials)
-```
-
-With this client, you can interface with the app and get access to most of the features of the web interface. More documentation coming soon at <https://docs.t2d2.ai>.
-
-```python
-t2d2.set_project(PROJECT_ID)
-project = t2d2.get_project()
-data = t2d2.get_images()
-...
-```
-
-## Contributing
-
-Please contact <bhiriyur@t2d2.ai> for further information on contributing to this project.
-
-## License
-
-Information about the project's license.

t2d2_sdk-2.3.2/src/t2d2_sdk.egg-info/PKG-INFO

@@ -1,67 +0,0 @@
-Metadata-Version: 2.4
-Name: t2d2-sdk
-Version: 2.3.2
-Summary: T2D2 SDK
-Author-email: Badri Hiriyur <badri@t2d2.ai>
-Project-URL: Homepage, https://t2d2.ai
-Project-URL: Issues, https://github.com/t2d2-ai/t2d2-sdk/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: BSD License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: boto3
-Requires-Dist: requests
-Requires-Dist: sentry_sdk
-Dynamic: license-file
-
-## Description
-
-T2D2 SDK python wrapper to API to interface with T2D2 projects and related assets.
-
-## Table of Contents
-
-- [Description](#description)
-- [Table of Contents](#table-of-contents)
-- [Installation](#installation)
-- [Usage](#usage)
-- [Contributing](#contributing)
-- [License](#license)
-
-## Installation
-
-This SDK is published to PyPI and the latest version can be installed as follows:
-`pip install --upgrade t2d2-sdk`
-
-## Usage
-
-These instructions assume that you have an account at T2D2 (<https://t2d2.ai>). If you do not have an account, you can sign up here: (<https://app.t2d2.ai/auth/register>). Subscription pricing details may be found here: (<https://t2d2.ai/pricing>).
-
-Once you have an account created, you can either use your email/password or an API KEY to instantiate the T2D2 client.
-
-```python
-from t2d2_sdk import T2D2
-
-credentials = {'email': "my@email.com", 'password': "<MYPASSWORD>"}
-credentials = {'api_key': "<MY_API_KEY>"}
-
-t2d2 = T2D2(credentials)
-```
-
-With this client, you can interface with the app and get access to most of the features of the web interface. More documentation coming soon at <https://docs.t2d2.ai>.
-
-```python
-t2d2.set_project(PROJECT_ID)
-project = t2d2.get_project()
-data = t2d2.get_images()
-...
-```
-
-## Contributing
-
-Please contact <bhiriyur@t2d2.ai> for further information on contributing to this project.
-
-## License
-
-Information about the project's license.