Intelligent Media Management:点群の圧縮

圧縮情報

• プロジェクト名: test-project

• 点群ファイルの OSS URI: oss://test-bucket/test-object.pcd

• 圧縮アルゴリズム: Octree

• 出力ファイルの OSS URI: oss://test-bucket/test-target-object

圧縮アルゴリズムの概要

Octree は、主に 3D データの圧縮と表現に使用される一般的な圧縮アルゴリズムです。3D 空間を一連の同じサイズの立方体に分割します。各立方体は 8 つのサブ立方体に分割され、さらに小さなサブ立方体に分割できます。

有効なデータを含むノードのみを保存することで、Octree メソッドはストレージスペースを大幅に削減できます。点群データや体積データなどの 3D データの圧縮と表現によく使用されます。適切な分割およびマージ戦略を選択することで、データの精度を維持しながら、ストレージと伝送のオーバーヘッドを削減できます。

リクエストの例

{
    "ProjectName": "test-project",
    "SourceURI": "oss://test-bucket/test-object.pcd",
    "UserData": "{\"ID\":\"testuid\",\"Name\": \"test-user\",\"Avatar\": \"http://test.com/testuid\"}",
    "TargetURI": "oss://test-bucket/test-target-object",
    "PointCloudFileFormat": "pcd",
    "CompressMethod": "octree",
    "PointCloudFields": "[\"xyz\"]",
    "OctreeOption": "{\"PointResolution\": 0.001, \"OctreeResolution\": 0.01, \"DoVoxelGridDownDownSampling\": false, \"LibraryName\": \"pcl\"}",
    "KdtreeOption": "{\"CompressionLevel\": 8, \"QuantizationBits\": 10, \"LibraryName\": \"draco\"}"
}

レスポンスの例

{
    "TaskId": "PointCloudCompress-091d9b4a-8726-47bf-b699-d24c7daff63c",
    "RequestId": "8B0EEA2E-35FE-500F-BCDB-E2E7CA11DF7A",
    "EventId": "180-1S7Q8gHbVXJf2lekgesKvlNM1VR"
}

サンプルコード

次のサンプルコードは、Python SDK を使用して点群を圧縮する方法を示しています。

# -*- coding: utf-8 -*-
# このファイルは自動生成されます。編集しないでください。ありがとうございます。
import os
import sys

from typing import List

from alibabacloud_imm20200930.client import Client as imm20200930Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_imm20200930 import models as imm_20200930_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient


class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client(
        access_key_id: str,
        access_key_secret: str,
    ) -> imm20200930Client:
        """
        AccessKey ID と AccessKey Secret を使用してクライアントを初期化します。
        @param access_key_id:
        @param access_key_secret:
        @return: クライアント
        @throws Exception
        """
        config = open_api_models.Config(
            access_key_id=access_key_id,
            access_key_secret=access_key_secret
        )
        # IMM のエンドポイントを指定します。
        config.endpoint = f'imm.cn-beijing.aliyuncs.com'
        return imm20200930Client(config)

    @staticmethod
    def main(
        args: List[str],
    ) -> None:
        # Alibaba Cloud アカウントの AccessKey は、すべての API 操作を呼び出す権限を持っています。Resource Access Management (RAM) ユーザーを使用して API 操作を呼び出すか、日常の O&M を実行することをお勧めします。
        # プロジェクトコードに AccessKey ID と AccessKey Secret を保存しないことを強くお勧めします。これにより、AccessKey が漏洩し、アカウント内のすべてのリソースのセキュリティが脅かされる可能性があります。
        # この例では、API 操作を呼び出すときに ID 検証のために環境変数から AccessKey を取得する方法を示します。
        imm_access_key_id = os.getenv("AccessKeyId")
        imm_access_key_secret = os.getenv("AccessKeySecret")
        client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
        octree_option = imm_20200930_models.OctreeOption(
            point_resolution=0.001,
            octree_resolution=0.01,
            do_voxel_grid_down_down_sampling=False,
            library_name='pcl'
        )
        create_compress_point_cloud_task_request = imm_20200930_models.CreateCompressPointCloudTaskRequest(
            source_uri='oss://test-bucket/test-object.pcd',
            target_uri='oss://test-bucket/test-target-object',
            point_cloud_file_format='pcd',
            compress_method='octree',
            point_cloud_fields=[
                '[\"xyz\"]'
            ],
            project_name='test-project',
            octree_option=octree_option
        )
        runtime = util_models.RuntimeOptions()
        try:
            # コードをコピーして実行する場合は、API 操作の戻り値を出力します。
            client.create_compress_point_cloud_task_with_options(create_compress_point_cloud_task_request, runtime)
        except Exception as error:
            # エラーが発生した場合は、エラーメッセージを出力します。
            UtilClient.assert_as_string(error.message)

    @staticmethod
    async def main_async(
        args: List[str],
    ) -> None:
        # Alibaba Cloud アカウントの AccessKey は、すべての API 操作を呼び出す権限を持っています。Resource Access Management (RAM) ユーザーを使用して API 操作を呼び出すか、日常の O&M を実行することをお勧めします。
        # プロジェクトコードに AccessKey ID と AccessKey Secret を保存しないことを強くお勧めします。これにより、AccessKey が漏洩し、アカウント内のすべてのリソースのセキュリティが脅かされる可能性があります。
        # この例では、API 操作を呼び出すときに ID 検証のために環境変数から AccessKey を取得する方法を示します。
        imm_access_key_id = os.getenv("AccessKeyId")
        imm_access_key_secret = os.getenv("AccessKeySecret")
        client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
        octree_option = imm_20200930_models.OctreeOption(
            point_resolution=0.001,
            octree_resolution=0.01,
            do_voxel_grid_down_down_sampling=False,
            library_name='pcl'
        )
        create_compress_point_cloud_task_request = imm_20200930_models.CreateCompressPointCloudTaskRequest(
            source_uri='oss://test-bucket/test-object.pcd',
            target_uri='oss://test-bucket/test-target-object',
            point_cloud_file_format='pcd',
            compress_method='octree',
            point_cloud_fields=[
                '[\"xyz\"]'
            ],
            project_name='test-project',
            octree_option=octree_option
        )
        runtime = util_models.RuntimeOptions()
        try:
            # コードをコピーして実行する場合は、API 操作の戻り値を出力します。
            await client.create_compress_point_cloud_task_with_options_async(create_compress_point_cloud_task_request, runtime)
        except Exception as error:
            # エラーが発生した場合は、エラーメッセージを出力します。
            UtilClient.assert_as_string(error.message)


if __name__ == '__main__':
    Sample.main(sys.argv[1:])