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



This article describes new opportunities that became available with release of Cintoo Connect CLI (command line interface) - a version without a graphical interface but with strong customization capabilities. This tool could be used to automate certain import/export tasks replacing classical interface of Cintoo Connect for users not familiar with it. 

Once environment and parameters are set up, repetitive import/export tasks become simple and seamless. Moreover, implementation of specific internal procedures and data standards become real.


Note: Cintoo Connect version must be greater than 2.13 to have executable CLI file inside installation folder. Use the following link to download the latest version of Cintoo Connect.


目次


権限

To use Cintoo Connect CLI users' roles must include:

  • リアリティデータのアップロードまたは削除 の権限がスキャンインポートに必要です。
  • リアリティデータのエクスポートまたはダウンロード の権限が スキャンエクスポート に必要です。

ヘルプ

Use Help to discover more information about the process of using Cintoo Connect CLI with these commands in command line.

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

ユースケース

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


With possibilities to:

  • プロジェクト内でインポートパスをルーティングする
  • エクスポート用に特定の作業ゾーンを対象にする
  • イベント駆動型スクリプトを作成する(例:スキャンがフォルダに配置されると、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 と M6
  • GeoSLAM Zebシリーズ
  • Viametris Backpack Mobile Scanner
  • Emesent Hovermap
  • 一般的な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 は画像と同じフォルダに保存する必要があります。


List of Export Commands

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

Command to export structured scan data
Supported formats 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

Command to export unified scan data.

Supported formats E57,POD, RCS, RCP.



API コールガイダンス

  • トークンを取得
トークンはCintooの認証時に取得されます。 
詳しい方法は APIドキュメント をご覧ください。 
こちらに ベストプラクティス があります トークン使用 のための。 

  • アカウントIDを取得

次の APIコール を使用してすべてのアカウントをリストし、アカウントID を取得してください。


  • プロジェクトIDを取得

既存のプロジェクトがある場合は、次の APIコール を使用してすべてのプロジェクトをリストし、次の APIコール を使用してプロジェクトIDを取得します。

プロジェクトを作成する場合は、次の APIコール を使用して新しいプロジェクトを作成し、そのIDを取得してください。


  • 作業ゾーンIDを取得

既存の作業ゾーンがある場合は、このAPIコール を使用して作業ゾーンのリストを取得してください。 リストから必要な作業ゾーンIDを取得します。

作業ゾーンを作成する場合は、次の APIコール を使用して新しい作業ゾーンを作成し、そのIDを取得してください。


ヒントと制限

  • データはローカルストレージとクラウドブロブストレージの両方からインポートできるため、ローカルファイルパスとクラウド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画像の容量を超えてはなりません。
  • Add the following parameter with any integer higher than 2 (default) to increase the number of cores to execute import/export faster (if PC capacity allows).
    --nb-threads INTEGER RANGE

  • To specify a place where logs are saved for any job add the following command.
    --log-path FILE



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

それは素晴らしい!

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

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

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

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

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

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

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