Cintoo Connect CLI(コマンドラインインターフェース)



この記事では、Cintoo Connect CLI(コマンドラインインターフェース)のリリースによって利用できるようになった新しい可能性について説明します。これは、グラフィカルインターフェースを持たず、高いカスタマイズ性を備えたバージョンです。このツールは、Cintoo Connectの従来のインターフェースに慣れていないユーザー向けに、その代わりとして特定のインポート/エクスポート作業を自動化するために使用できます。 

環境とパラメーターを設定すると、繰り返し実行するインポート/エクスポート作業が簡単かつスムーズになります。さらに、組織固有の手順やデータ標準の実装も実現可能になります。


注: 実行可能なCLIファイルをインストールフォルダー内に含めるには、Cintoo Connectのバージョンが2.13を超えている必要があります。Cintoo Connectの最新バージョンは、次のリンクからダウンロードしてください。


目次


権限

Cintoo Connect CLIを使用するには、ユーザーの役割に次の権限が含まれている必要があります。

  • リアリティデータをアップロードまたは削除権限(スキャンのインポート用)
  • リアリティデータをエクスポートまたはダウンロード権限(スキャンのエクスポート用)

ヘルプ

コマンドラインでこれらのコマンドとともにCintoo Connect CLIを使用する手順の詳細については、ヘルプを使用して確認できます。

./cintooconnect-cli.exe --help
./cintooconnect-cli.exe [IMPORT-TYPE] --help

ユースケース

  • スキャンを一括インポートするPythonスクリプトを作成します。スクリプトの例(コメント付き)。
  • スキャンを一括エクスポートするPythonスクリプトを作成します。
  • 組織固有のワークフローを作成します。


次のことが可能です。

  • プロジェクト内のインポート先パスを指定する
  • エクスポート対象の特定のワークゾーンを指定する
  • イベント駆動型スクリプトを作成する(例:スキャンがフォルダーに配置されたときに、Cintooへ自動的にインポートする)

インポートコマンド一覧

import-static --token=$token --tenant=$tenant --accountId=$accout_Id --projectId=$project_Id --workzoneId=$workzone_Id --file-ref=$file_ref
import-static --cintoo-uri=$job_uri --file-ref=$file_ref

地上型スキャンデータをインポートするためのコマンド。 トークンおよびIDの取得手順は、 

API呼び出しガイド セクションに記載されています。


import-mobile --cintoo-uri=$job_uri --file-ref $local_file_path --device "$device_name" --position-sampling $position_sampling

スキャン経路なしでモバイルスキャンデータをインポートするためのコマンド。

$device_name には、次の値を指定できます:

  • GeoSLAM Zeb Structured
  • Leica BLK2GO
  • NavVis Ivion


import-mobile --cintoo-uri=$job_uri --file-ref $local_file_path --device "$device_name" --scanning-path $scanning_path --position-sampling $position_sampling

スキャン経路ありでモバイルスキャンデータをインポートするためのコマンド。

$device_name には、次の値を指定できます:

  • NavVis VLX and M6
  • GeoSLAM Zeb series
  • Viametris Backpack Mobile Scanner
  • Emesent Hovermap
  • Generic E57/LAS/LAZ


import-drone --cintoo-uri=$job_uri --file-ref $local_file_path --distance $distance_float

ドローンスキャンデータをインポートするためのコマンド。


import-360-images --cintoo-uri=$job_uri --tenant=$tenant --accountId=$accout_Id --projectId=$project_Id --workzoneId=$workzone_Id --file-ref=$file_ref

360°画像データをインポートするためのコマンド。


注: 付随するCSVファイルは、画像と同じフォルダーに保存する必要があります。


エクスポートコマンド一覧

export scans --cintoo-uri=$job_uri  --type structured  --format E57/RCP--destination-folder PATH  --destination-name TEXT

構造化スキャンデータをエクスポートするためのコマンド。 
サポートされている形式はE57、RCPです。 


export scans --cintoo-uri=$job_uri  --type unified  --format E57/POD/RCS/RCP  --decimation-spacing FLOAT RANGE  --destination-folder PATH  --destination-name TEXT

統合スキャンデータをエクスポートするためのコマンド。

サポートされている形式は E57、POD、RCS、RCPです。



API呼び出しガイド

  • トークンの取得
トークンは、Cintooへの認証時に取得されます。 
取得方法については、 APIドキュメント をご覧ください。 
こちらで、 トークンの使用に関するベストプラクティスを確認できます。 

  • アカウントIDの取得

次のAPI呼び出しを使用してすべてのアカウントを一覧表示し、その結果を解析してアカウントIDを取得してください。


  • プロジェクトIDの取得

既存のプロジェクトがある場合は、次のAPI呼び出しを使用してすべてのプロジェクトを一覧表示し、続いてこのAPI呼び出し で解析してプロジェクトIDを取得してください。

プロジェクトを新規作成する場合は、次のAPI呼び出しを使用して新しいプロジェクトを作成し、その結果を解析してIDを取得してください。


  • ワークゾーンIDの取得

既存のワークゾーンがある場合は、次のAPI呼び出しを使用してワークゾーンの一覧を取得してください。その一覧から、必要なワークゾーンIDを取得します。

ワークゾーンを新規作成する場合は、次のAPI呼び出しを使用して新しいワークゾーンを作成し、そのIDを取得してください。


ヒントと制限事項

  • データは、ローカルストレージとクラウドのBLOBストレージの両方からインポートできるため、ローカルのファイルパスとクラウドのURLのどちらも使用できます。 
    クラウドデータ(AWS、Azureなど)にアクセスするには、リンクに署名を含める必要があり、E57形式のファイルのみが受け付けられます。
    パスの例:
C:\data\Scans\Mobile\Scan
https://myaccount.blob.core.windows.net/mycontainer/myblob.txt?sv=2021-08-06&st=2024-02-28T10%3A00%3A00Z&se=2024-02-29T10%3A00%3A00Z&sr=b&sp=r&sig=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx%3D
  • サブスクリプションのスキャンおよび360°画像の容量にご注意ください。Cintoo Connect CLIによるインポートにも、標準の手順と同じ制限が適用されます。 
    スキャン/360°画像の容量を超えることはできません。
  • コア数を増やしてインポート/エクスポートをより高速に実行するには(PCの性能が許す場合)、2(デフォルト)より大きい任意の整数を指定した次のパラメーターを追加します。
    --nb-threads INTEGER RANGE

  • 任意のジョブのログの保存先を指定するには、次のコマンドを追加します。
    --log-path FILE



この記事は役に立ちましたか?

それは素晴らしい!

フィードバックありがとうございます

お役に立てず申し訳ございません!

フィードバックありがとうございます

この記事に改善できることがあれば教えてください。

少なくとも一つの理由を選択してください
CAPTCHA認証が必要です。

フィードバックを送信しました

記事の改善におけるご協力ありがとうございます。