コンテンツへスキップ
英語
  • 検索フィールドが空欄のため、候補は表示されません。.

コマンドラインの使い方 - PIX4Dengine SDK

この記事では、PIX4Dengine SDKを使用してプロジェクトを作成および処理する際に利用できるコマンドラインオプションについて説明します。.

警告: この記事はコマンドラインインターフェース(CLI)に関するものであり、最新バージョンのPIX4Dengine SDKに関するものではありません。PIX4Dengine
SDKへの移行を強くお勧めします。最新のドキュメントについては、 PIX4Dengine Server SDKの
注: と組み合わせて使用​​する必要があります PIX4Dengine 、LinuxおよびWindows環境において

コマンドラインを使用してプロジェクトを作成および処理することは可能です。すべてのオプションを変更できるわけではありません。多くの場合、コマンドラインでは変更できないオプションを変更するために .p4d ファイルを作成できます。.p4d 最小フォーマット

コマンドラインを使用するには、PIX4Dmapperがインストールされているフォルダにアクセスし、次のコマンドを実行します。

pix4dmapper.exe -h

commandline.jpg

これにより、使用可能なオプションとコマンドの一覧が表示されるヘルプが表示されます。.

コマンドラインの構文は次のとおりです。

pix4dmapper [オプション] [プロジェクトファイル]

以下のコマンドラインオプションが利用可能です。

重要:
プロジェクトを処理する際、 .p4d に保存され .p4d 、処理に使用されます。



一般オプション

名前
説明
-h [ --help ]
コマンドラインのヘルプを表示して終了します。.
-v [ --version ]
印刷版を表示して終了します。.
-c [ --cmdline ]
コマンドラインモード(ユーザーインターフェースは開きません)。
何も指定しない場合は --run オプションが使用されます。--initial、--dense、--ortho、--new オプションと併用することもできます。
--close-gui
処理後にGUIを閉じます。--
runオプションと併用する場合のみ有効です。
コマンドラインモードで使用した場合、このオプションは無視されます。
--cam-param-project
データベースに異なるパラメータが設定されている場合でも、プロジェクトファイルからカメラパラメータを使用してください。.
--cam-param-db
プロジェクトファイルに異なるパラメータが記述されている場合でも、データベースからカメラパラメータを使用します。.
--disable-user-cam-db
ユーザーカメラデータベースを無効にします。内蔵データベースのみが使用されます。.
--メール引数
Pix4Dアカウントのメールアドレスでログインしてください。--
passwordオプションと併用する場合のみ有効です。
--パスワード引数
Pix4Dアカウントのパスワードでログインしてください。このオプションは
--emailオプションと併用する場合のみ有効です。
--ログアウト
ソフトウェアからログアウトしてください。.
例:

プロジェクトを開く

ピクス4Dマッパー<project_file>

pix4dmapper D:\mining\quarry.p4d

ソフトウェアのヘルプを印刷する

pix4dmapper -h

pix4dmapper -h

ソフトウェアのバージョンを印刷する

pix4dmapper -v

pix4dmapper -v

、コマンドラインモードで.p4d処理オプションで定義された処理手順を実行します。 ユーザーインターフェースを開かずに

pix4dmapper -c -r<project_file>

pix4dmapper -c -r D:\mining\quarry.p4d

.p4d処理オプションで定義された処理手順を実行し、処理前にユーザーインターフェースを開き、処理後に閉じます。

pix4dmapper -r --close-gui<project_file>

pix4dmapper -r --close-gui D:\mining\quarry.p4d

プロジェクトの.p4dファイルからカメラパラメータを使用しますユーザーインターフェースを開かずに、

pix4dmapper -c --cam-param-project -i<project_file>

pix4dmapper -c --cam-param-project -i D:\mining\quarry.p4d

内部カメラモデルデータベースのカメラパラメータを使用して初期処理を実行します。ユーザーインターフェースを開かずに、

pix4dmapper -c --cam-param-db -i<project_file>

pix4dmapper -c --cam-param-db -i D:\mining\quarry.p4d

例 --disable-user-cam-db

pix4dmapper -c --disable-user-cam-db -i<project_file>

pix4dmapper -c --disable-user-cam-db -i D:\mining\quarry.p4d

ユーザーインターフェースを開かずにソフトウェアにログインします。

pix4dmapper -c --email<email> - パスワード<password>

pix4dmapper -c --email j.doe@pix4d.com --password jpwd

ソフトウェアにログインし、ユーザーインターフェースを開かずにプロジェクトを実行します。

pix4dmapper -c --email<email> - パスワード<password>-r<project_file>

pix4dmapper -c --email j.doe@pix4d.com --password jpwd -r D:\mining\quarry.p4d

ユーザーインターフェースを開かずに、ソフトウェアからログアウトしてください。

pix4dmapper --logout

pix4dmapper --logout


新規プロジェクトの作成

名前
説明
-n [ --new ]
新しいプロジェクトを作成します。.
--image-dir 引数
イメージディレクトリ。--
new および --cmdline オプションと組み合わせてのみ使用できます。
--位置情報フォーマット引数
位置情報ファイル形式。以下 できる
選択済み:
  • 3drobotics: 「3D Robotics」のフライトログ。.
  • pix4d-lat-long: Pix4D のファイル形式「緯度 - 経度 - 高度」用。.
  • pix4d-long-lat: Pix4D のファイル形式「経度 - 緯度 - 高度」用。.
  • pix4d-xy: Pix4Dの「X - Y - Z」ファイル形式用。.
  • pix4d-yx: Pix4Dの「Y - X - Z」ファイル形式用。.
--new および --cmdline オプションと併用する場合のみ使用できます。.
--位置情報ファイル引数
位置情報ファイル。. これは位置情報ファイルへのパスです。.
--new および --cmdline オプションと併用する場合のみ使用できます。.
--ジオタグなしを無視
EXIFデータに画像位置情報がない画像はプロジェクトに追加しません。.
--cam-bands 引数
指定されたカメラバンドを使用してください。. これは、カンマで区切られたカメラバンドのリストです。.
バンド名にスペースが含まれている場合は、リストを引用符で囲む必要があります。例:「Red edge, Green, Blue」。.
--split-image-dir 引数
分割された複数ページの画像を保存する --new オプションと併用する場合のみ使用できます。.
--cs-guessを無効にする
プロジェクトの出力座標系を推測しようとしないでください。GUIモードでプロジェクトを開くと、ユーザーに座標系の入力が求められます。.
例:

ユーザーインターフェースを開かずに、EXIFデータに画像位置情報を含む新しいプロジェクトを作成する

pix4dmapper -c -n --image-dir<image_directory><project_file>

pix4dmapper -c -n --image-dir D:\mining\Images D:\mining\quarry.p4d

新しいプロジェクトを作成する、ユーザーインターフェースを開かずに

pix4dmapper -c -n --image-dir<image_directory><project_file>

pix4dmapper -c -n --image-dir D:\mining\Images D:\mining\quarry.p4d

ファイルから画像位置情報を含む新しいプロジェクトを作成するユーザーインターフェースを開かずに、

pix4dmapper -c -n --image-dir<image_directory> --位置情報フォーマット<geolocation_file_format>--位置情報ファイル<geolocation_file><project_file>

pix4dmapper -c -n --image-dir D:\mining\Images --geolocation-format pix4d-lat-long --geolocation-file D:\mining\Inputs\imagePositionsLatLongAlt.csv D:\mining\quarry.p4d


プロジェクト処理

名前
説明
-r [ --run ]
プロジェクトを実行します。他のオプションが指定されていない場合は、プロジェクトの処理オプションで定義されているすべてのステップを実行します。.
-i [ --initial ]
ステップ1を実行します。初期処理。.
-d [ --dense ]
ステップ2「点群とメッシュ」を実行します。
ステップ1「初期処理」が完了している場合、または--initialオプションと併用する場合にのみ使用できます。
-o [ --ortho ]
ステップ3を実行します。DSM、オルソモザイク、インデックス。
ステップ1「初期処理」が完了している場合、または--initialオプションと併用する場合にのみ使用できます。
また、--denseオプションと併用したり、ステップ2「点群とメッシュ」が完了した後に使用することもできます。
--テンプレート引数
処理オプションテンプレートを使用して処理オプションを初期化します。--new、--run、--initial、--dense、--ortho オプションと併用できます。.

次のいずれかになります。
--template-list オプションを使用すると、定義済みのテンプレートの一覧が表示されます。.
カスタムテンプレートファイル(.tmplファイル)へのパス。カスタムテンプレートファイルは、ユーザーインターフェースを使用するか、手動で作成することで生成できます。 処理オプションテンプレート(.tmpl)ファイルの作成方法.
--テンプレートリスト
定義済みのテンプレート一覧を表示します。.
例:

ユーザーインターフェースを開かずに、処理オプションで定義されたすべての処理ステップを実行します。

pix4dmapper -c -r<project_file>

pix4dmapper -c -r D:\mining\quarry.p4d

ステップ1:初期処理を実行します(ユーザーインターフェースは開きません)。

pix4dmapper -c -i<project_file>

pix4dmapper -c -i D:\mining\quarry.p4d

点群とメッシュを取得します。ユーザーインターフェースを開かずに、

pix4dmapper -c -d<project_file>

pix4dmapper -c -d D:\mining\quarry.p4d

DSM、オルソモザイク、インデックスを実行します。ユーザーインターフェースを開かずに、

pix4dmapper -c -o<project_file>

pix4dmapper -c -o D:\mining\quarry.p4d

新しいプロジェクトを作成します。画像の位置情報はEXIFデータから読み込まれます。

pix4dmapper -c -n --image-dir<image_directory> --テンプレート 3Dマップ<project_file>

pix4dmapper -c -n --image-dir D:\mining\Images --template 3d-maps D:\mining\quarry.p4d

ユーザーインターフェースを開かずに、.tmplテンプレートファイルを使用して処理オプションを初期化し、新しいプロジェクトを作成します。画像の位置情報はEXIFデータから読み込まれます。.

pix4dmapper -c -n --image-dir<image_directory> - テンプレート<template_file><project_file>

pix4dmapper -c -n --image-dir D:\mining\Images --template D:\mining\dsm_with_contours.tmpl D:\mining\quarry.p4d

定義済みのテンプレート一覧を表示する

pix4dmapper --template-list

pix4dmapper --template-list

リソースオプション

名前
説明
--max-cpus 引数
処理に使用するCPUスレッドの最大数。.
は、1から現在のデバイスで使用可能な最大CPUスレッド数までの整数です。.
--run、--initial、--dense、--ortho オプションと併用する場合のみ使用できます。.
--use-cuda 引数

CUDA対応GPUをすべて有効/無効にします。<arg>次のいずれかになります。

  • はい
  • いいえ
--run、--initial、--dense、--ortho オプションと併用する場合のみ使用できます。.
例:

処理オプションで定義された処理ステップを、最大16個のCPUスレッドを使用して、ユーザーインターフェースを開かずに実行する。

pix4dmapper -c -r --max-cpus 16<project_file>

pix4dmapper -c -r --max-cpus 16 D:\mining\quarry.p4d

ステップ1を実行します。初期処理は、 最大16個のCPUスレッドを使用して行いますユーザーインターフェースを開かずに、

pix4dmapper -c -i --max-cpus 16<project_file>

pix4dmapper -c -i --max-cpus D:\mining\quarry.p4d

処理オプションで定義された処理ステップを、すべてのCUDA対応GPUを有効にして、ユーザーインターフェイスを開かずに実行する。

pix4dmapper -c -r --use-cuda yes<project_file>

pix4dmapper -c -r --use-cuda yes D:\mining\quarry.p4d

出力ストリーム

PIX4Dmapper は、2 つの異なるストリームを出力します。標準出力 ( 「情報」「UI」、「処理付けされたメッセージを含む 「エラー」「警告) です。これらのラベルの詳細については、 メニューの「表示」>「ログ出力」を参照して

標準エラー出力(stderr)は常に出力されます。標準出力(stdout)メッセージの出力は、PIX4Dmapperがコマンドラインモード(-cオプションを使用)で実行されているかどうかによって異なります。-- stdout および --no-stdout 使用すると、この動作を変更できます。

コマンドライン引数
標準出力
標準エラー
pix4dmapper.exe
静けさ
冗長な
pix4dmapper.exe --stdout
冗長な
冗長な
pix4dmapper.exe -c
冗長な
冗長な
pix4dmapper -c --no-stdout
静けさ
冗長な