.p4d 最小フォーマット

警告：この記事はコマンドラインインターフェース（CLI）に関するものであり、最新バージョンのPIX4Dengine SDKに関するものではありません。PIX4Dengine
SDKへの移行を強くお勧めします。最新のドキュメントについては、 PIX4Dengine Server SDKの。

この記事では、p4dファイルのフォーマットと、PIX4Dmapperで自動的に読み取れる最小限のp4dファイルを作成する方法について説明します。最小限のp4dファイルは、コマンドラインオプションで作成できないプロジェクトや、pix4dmapper.exeが利用できない場合に役立ちます。.

p4dファイル形式
最小のp4dファイル
p4dファイルの最小例

p4dファイル形式

.p4dプロジェクトファイルには、画像、座標系、GCP（地上基準点）、処理オプションなど、プロジェクトに関する情報が含まれています。.p4dファイルはXML形式で、XSD（XMLスキーマドキュメント）ファイルによって正式に定義されています。XSDファイルは、インストールディレクトリの「resources/xsd/pix4d_*.xsd」にあります。

.p4dファイルは以下の構造になっています。

p4d 2.1 フォーマットの概要

<? xml version = "1.0" encoding = "UTF-8" ?>
< ピクス4Dマッパー >
  < ソフトウェア >
  <!--Contains info about the software (version, edition, ...) -->
  </ ソフトウェア >
  < オプション >
  <!--Contains info about the processing options -->
  </ イニシャル >
  </ 密集 >
  </ オルソ >
  </ 索引 >
  </ オプション >
  < 入力 >
  <!--Contains info about the project inputs (images, gcps, etc...)-->
  <!-- /!\ ORDER of inputs MATTERS -->
  </ カメラ >
  </ 座標系 >
  </ GCPS >
  </ 画像 >
  </ 処理領域 >
  </ インデックス領域 >
  </ rayCloudObjects >
  </ 入力 >
</ ピクス4Dマッパー >

最小のp4dファイル

最小p4dファイルとは、PIX4Dmapperで開くことができる最小限の情報セットを含むp4dファイルのことです。.

このファイルには少なくとも3枚の画像が含まれている必要があります。オプションとして、座標系、GCP（地上基準点）、処理領域などのその他の情報を含めることもできます。最小限のp4dファイルがPIX4Dmapperにインポートされると、不足している情報（カメラモデル、座標系、処理オプションなど）はソフトウェアによって自動的に補完されます。.

最小限のp4dファイルには、以下の情報を指定できます。

画像
画像の位置情報
カメラモデル
GCP
座標系
加工エリア
処理オプション

画像

p4dファイルには、常に最低3枚の画像が含まれている必要があります。.

画像の位置情報

画像の位置情報がEXIFデータに含まれている場合は、p4dファイルの読み込み時に自動的にそこから読み込まれます。そうでない場合は、p4dファイル内で画像の位置情報と、WGS84以外の座標系を指定することができます。.

カメラモデル

内部データベースに登録されているカメラ、またはEXIFからカメラモデルを読み取れるカメラを使用することをお勧めします。そのため、最小限のp4dファイルにはカメラモデルを書き込まないでください。カメラモデルがデータベースに登録されている場合は、そこから読み込まれます。そうでない場合は、EXIFから読み込まれます。.

GCP

プロジェクトにGCPが含まれる場合、最小限のp4dファイルには以下の内容が含まれている必要があります。

GCP（グローバル・コントロール・プラットフォーム）の一覧。.
画像、GCP（地上基準点）、および出力の座標系。.
画像マーク。.

座標系

座標系は以下のように定義する必要があります。

画像。.
GCP（一般基準政策）。.
出力。.

水平座標系と垂直座標系の両方を定義する必要があります。.

水平座標系

水平座標系は、WKT文字列を使用して定義されます。 http://spatialreference.org/

垂直座標系

以下の垂直システムがサポートされています。

MSL - egm96: 。
MSL - egm84: 。
MSL - egm2008: 。
楕円体上のジオイド高 - 高さ：。
任意（最小限のp4dに明示的に記述することは推奨されません）：。

加工エリア

処理領域は、WGS84座標系または出力座標系のいずれかで指定できます。.

処理オプション

処理オプションはテンプレートを使用してのみ設定する必要があります。最小限のp4dファイルを使用する場合、テンプレートは次のように設定できます。

タグを使用する使い方の
最小の p4d ファイルでテンプレートが定義されていない場合、デフォルトのテンプレートが読み込まれます。通常は 3D マップ テンプレートです。テンプレートは、UI で手動で変更することも、コマンドラインを使用して別のテンプレートを処理に適用することもできます。コマンドラインの詳細については、「コマンドラインの使用方法」を。

最小限のp4dファイル例

このセクションでは、プロジェクトの特性に応じて必要な最小限のp4dファイルの例をいくつか示します。.

例 1: 画像のみで構成され、EXIF に画像の位置情報が含まれている、または画像の位置情報が含まれていないプロジェクトの場合。
例2：画像のみで構成され、EXIFに画像の位置情報が含まれていないプロジェクトの場合。
例3：投影座標系で位置情報が与えられた画像のみで構成されるプロジェクトの場合。
例4：EXIFに画像位置情報があり、処理領域を持つ画像で構成されるプロジェクトの場合。
例 5: EXIF に画像の位置情報があり、画像マーク付きの GCP を持つ画像で構成されるプロジェクトの場合。
例 6: EXIF に画像の位置情報が含まれている画像で構成されるプロジェクトの場合、3D モデルの定義済みテンプレートを使用する必要があります。

例１

画像のみで構成され、EXIFに画像の位置情報が含まれている、または位置情報が含まれていないプロジェクトの場合。.

最小p4d含有量

画像一覧。.

プロジェクトの特徴

画像

はい、最低3枚の画像

このプロジェクトには画像リストが含まれています。少なくとも3枚の画像を指定する必要があります。.

画像の位置情報

ケース a) はい、EXIF では WGS84 です

ケースb）いいえ

2つのケースがあります。

ケース a) プロジェクトには、EXIF に保存されている WGS84 形式の画像位置情報があります。.

または

ケースb）プロジェクトには、EXIFにも外部ファイルにも画像の位置情報がありません。.

カメラモデル

データベース内
または
EXIFから

プロジェクトで使用されるカメラは、データベースに該当するカメラモデルが登録されているか、またはEXIF情報から読み込むことができます。.

GCP

いいえ

このプロジェクトにはGCP（地上基準点）がありません。.

出力座標系

ケース a) WGS84 - UTM

ケースb）任意

出力座標系は、画像の位置情報取得時の座標系と同じです。

ケースa）出力座標系はWGS84 UTMです。.

または

ケースb）出力座標系は任意です。.

加工エリア

いいえ

このプロジェクトには処理エリアがありません。.

処理オプション/テンプレート

デフォルト: 3Dマップ

プロジェクトはデフォルトのテンプレート、つまり 3Dマップ テンプレートを読み込みます。

例：

<?xml version= "1.0" encoding= "UTF-8" ?>
<pix4dmapper>
  <inputs>
  <images>
  <image path= "D:/guided_tour/images/IMG_4082.JPG/" />
  <image path= "D:/guided_tour/images/IMG_4083.JPG/" />
  <image path= "D:/guided_tour/images/IMG_4087.JPG/" />
  <image path= "D:/guided_tour/images/IMG_4088.JPG/" />
  </images>
  </inputs>
</pix4dmapper>

例２

画像のみで構成され、EXIFに画像の位置情報が含まれていないプロジェクトの場合。.

最小p4d含有量

GPS位置情報付き画像一覧。.

プロジェクトの特徴

画像

はい、最低3枚の画像

このプロジェクトには画像リストが含まれています。少なくとも3枚の画像を指定する必要があります。.

画像の位置情報

はい、WGS84

このプロジェクトには、EXIFには保存されないWGS84形式の画像位置情報が含まれています。.

カメラモデル

データベース内
または
EXIFから

プロジェクトで使用されるカメラは、データベースに該当するカメラモデルが登録されているか、またはEXIF情報から読み込むことができます。.

GCP

いいえ

このプロジェクトにはGCP（地上基準点）がありません。.

出力座標系

WGS84 - UTM

出力座標系はWGS84 UTMです。.

加工エリア

いいえ

このプロジェクトには処理エリアがありません。.

処理オプション/テンプレート

デフォルト: 3Dマップ

プロジェクトはデフォルトのテンプレート、つまり 3Dマップ テンプレートを読み込みます。

例：

<?xml version= "1.0" encoding= "UTF-8" ?>
<pix4dmapper>
  <inputs>
  <images>
  <image path= "D:/guided_tour/images/IMG_4082.JPG" >
  <gps lat= "46.3414965400039" lng= "8.02588605999496" alt= "914.066589355469" />
  </image>
  <image path= "D:/guided_tour/images/IMG_4083.JPG" >
  <gps lat= "46.3411381999907" lng= "8.02537270001017" alt= "914.736022949219" />
  </image>
  <image path= "D:/guided_tour/images/IMG_4087.JPG" >
  <gps lat= "46.3411327000576" lng= "8.02484090003983" alt= "914.903991699219" />
  </image>
  </images>
  </inputs>
</pix4dmapper>

例３

投影座標系で位置情報が付与された画像のみで構成されるプロジェクトの場合。.

最小p4d含有量

投影座標系における位置情報付き画像リスト。.
画像、GCP、出力座標系。.

プロジェクトの特徴

画像

はい、最低3枚の画像

このプロジェクトには画像リストが含まれています。少なくとも3枚の画像を指定する必要があります。.

画像の位置情報

はい、投影されたCS（X、Y、Z）

このプロジェクトでは、投影座標系で画像位置情報が提供されています。画像位置情報はEXIFには保存されません。.

カメラモデル

データベース内
または
EXIFから

プロジェクトで使用されるカメラは、データベースに該当するカメラモデルが登録されているか、またはEXIF情報から読み込むことができます。.

GCP

いいえ

このプロジェクトにはGCP（地上基準点）がありません。.

出力座標系

画像座標系と同じ

出力座標系は、画像の投影座標系と同じである。.

加工エリア

いいえ

このプロジェクトには処理エリアがありません。.

処理オプション/テンプレート

デフォルト: 3Dマップ

プロジェクトはデフォルトのテンプレート、つまり 3Dマップ テンプレートを読み込みます。

例：

<?xml version= "1.0" encoding= "UTF-8" ?>
<pix4dmapper>
  <inputs>
  <coordinateSystems>
  <southingWesting> 真実 </southingWesting>
  <output>
  <WKT>PROJCS[&quot;WGS84 / UTM zone 32N&quot;,GEOGCS[&quot;WGS  84 インチ、
 DATUM["WGS_1984",SPHEROID["WGS  84 ", 6378137 , 298.257223563 ,
 AUTHORITY["EPSG"," 7030 "]]、TOWGS84[ 0 , 0 , 0 , 0 , 0 , 0 , 0 ]、
 AUTHORITY["EPSG"," 6326 "]]、PRIMEM["Greenwich", 0 、
 権限["EPSG"," 8901 "]]、単位["degree",
 0.0174532925199433 、AUTHORITY["EPSG"," 9108 "]]、
 権限["EPSG"," 4326 "]]、投影法["Transverse_Mercator"]、
 PARAMETER["latitude_of_origin", 0 ]、PARAMETER["central_meridian", 9 ]、
 PARAMETER["scale_factor", 0.9996 ]、PARAMETER["false_easting", 500000 ]、
 パラメータ["false_northing", 0 ]、単位["Meter", 1 ]、
 権限["EPSG"," 32632 "]]
  <verticalDef model= "constShift" geoidHeight= "0" />
  </output>
  <gcp>
  <WKT>PROJCS[&quot;WGS84 / UTM zone 32N&quot;,GEOGCS[&quot;WGS  84 インチ、
 DATUM["WGS_1984",SPHEROID["WGS  84 ", 6378137 , 298.257223563 ,
 AUTHORITY["EPSG"," 7030 "]]、TOWGS84[ 0 , 0 , 0 , 0 , 0 , 0 , 0 ]、
 AUTHORITY["EPSG"," 6326 "]]、PRIMEM["Greenwich", 0 、
 権限["EPSG"," 8901 "]]、単位["degree",
 0.0174532925199433 、AUTHORITY["EPSG"," 9108 "]]、
 権限["EPSG"," 4326 "]]、投影法["Transverse_Mercator"]、
 PARAMETER["latitude_of_origin", 0 ]、PARAMETER["central_meridian", 9 ]、
 PARAMETER["scale_factor", 0.9996 ]、PARAMETER["false_easting", 500000 ]、
 パラメータ["false_northing", 0 ]、単位["Meter", 1 ]、
 権限["EPSG"," 32632 "]]
  <verticalDef model= "constShift" geoidHeight= "0" />
  </gcp>
  <image>
 <WKT>GEOGCS[&quot;WGS  84 ",DATUM["WGS_1984",SPHEROID["
  WGS  84 ", 6378137 , 298.257223563 ,AUTHORITY["EPSG"," 7030 "]],TOWGS84[ 0 , 0 , 0 , 0 , 0 , 0 , 0 ],
  AUTHORITY["EPSG"," 6326 "]],PRIMEM["Greenwich", 0 ,AUTHORITY["
  EPSG"," 8901 "]],UNIT["degree", 0.01745329251994328 ,AUTHORITY["
  EPSG"," 9122 "]],AUTHORITY["EPSG"," 4326 "]]
  <verticalDef model= "constShift" geoidHeight= "0" />
  </image>
  </coordinateSystems>
  <images>
  <image path= "D:/guided_tour/images/IMG_4082.JPG" >
  <xyz x= "425037.646559" y= "5132452.279486" z= "914.066589" />
  </image>
  <image path= "D:/guided_tour/images/IMG_4083.JPG" >
  <xyz x= "424997.651379" y= "5132412.949416" z= "914.736023" />
  </image>
  <image path= "D:/guided_tour/images/IMG_4087.JPG" >
  <xyz x= "424956.719418" y= "5132412.842123" z= "914.903992" />
  </image>
  </images>
  </inputs>
</pix4dmapper>

例4

EXIFに画像位置情報が含まれており、処理領域を持つ画像で構成されるプロジェクトの場合。.

最小p4d含有量

画像一覧。.
処理エリア。.

プロジェクトの特徴

画像

はい、最低3枚の画像

このプロジェクトには画像リストが含まれています。少なくとも3枚の画像を指定する必要があります。.

画像の位置情報

はい、EXIFではWGS84です

このプロジェクトでは、画像にWGS84形式の地理位置情報がEXIFに保存されています。.

カメラモデル

データベース内
または
EXIFから

プロジェクトで使用されるカメラは、データベースに該当するカメラモデルが登録されているか、またはEXIF情報から読み込むことができます。.

GCP

いいえ

このプロジェクトにはGCP（地上基準点）がありません。.

出力座標系

WGS84 - UTM

出力座標系はWGS84 UTMです。.

加工エリア

はい

このプロジェクトには処理エリアがあります。.

処理オプション/テンプレート

デフォルト: 3Dマップ

プロジェクトはデフォルトのテンプレート、つまり 3Dマップ テンプレートを読み込みます。

例：

<?xml version= "1.0" encoding= "UTF-8" ?>
<pix4dmapper>
  <inputs>
  <images>
  <image path= "D:/guided_tour/images/IMG_4082.JPG/" />
  <image path= "D:/guided_tour/images/IMG_4083.JPG/" />
  <image path= "D:/guided_tour/images/IMG_4087.JPG/" />
  <image path= "D:/guided_tour/images/IMG_4088.JPG/" />
  <image path= "D:/guided_tour/images/IMG_4089.JPG/" />
  </images>
  <processingArea>
  <geoCoord2D x= "424907.363521081" y= "5132487.476173564" />
  <geoCoord2D x= "424964.352052119" y= "5132555.503014828" />
  <geoCoord2D x= "425082.030328863" y= "5132522.777422256" />
  <geoCoord2D x= "425018.293691834" y= "5132409.561053967" />
  <geoCoord2D x= "424925.060836578" y= "5132449.395196952" />
  </processingArea>
  </inputs>
</pix4dmapper>

例5

EXIFに画像位置情報が含まれており、画像マーク付きのGCP（地上基準点）を持つ画像で構成されるプロジェクトの場合。.

最小p4d含有量

GPS位置情報とGCP（地上基準点）画像マークを含む画像リスト。.
GCP一覧。.
画像、GCP、出力座標系。.

プロジェクトの特徴

画像

はい、最低3枚の画像

このプロジェクトには画像リストが含まれています。少なくとも3枚の画像を指定する必要があります。.

画像の位置情報

はい、EXIFではWGS84です

このプロジェクトでは、画像にWGS84形式の地理位置情報がEXIFに保存されています。.

カメラモデル

データベース内
または
EXIFから

プロジェクトで使用されるカメラは、データベースに該当するカメラモデルが登録されているか、またはEXIF情報から読み込むことができます。.

GCP

はい

このプロジェクトにはGCP（地上基準点）があります。.

出力座標系

投影座標系、GCPと同じ

出力座標系は投影座標系です。これはGCPの座標系と同じです。

加工エリア

いいえ

このプロジェクトには処理エリアがありません。.

処理オプション/テンプレート

デフォルト: 3Dマップ

プロジェクトはデフォルトのテンプレート、つまり 3Dマップ テンプレートを読み込みます。

例：

<?xml version= "1.0" encoding= "UTF-8" ?>
<pix4dmapper>
  <inputs>
  <coordinateSystems>
  <southingWesting> 真実 </southingWesting>
  <output>
  <WKT>PROJCS["CH1903+ / LV95",GEOGCS["CH1903+",
 DATUM["CH1903+",SPHEROID["Bessel  1841 ", 6377397.155 , 299.1528128 ,
 AUTHORITY["EPSG"," 7004 "]]、TOWGS84[ 674.374 、 15.056 、 405.346 、 0 、 0 、 0 、 0 ]、
 AUTHORITY["EPSG"," 6150 "]]、PRIMEM["Greenwich", 0 、
 権限["EPSG"," 8901 "]]、単位["degree", 0.0174532925199433 、
 AUTHORITY["EPSG"," 9122 "]]、AUTHORITY["EPSG"," 4150 "]]、
 投影法["Hotine_Oblique_Mercator_Azimuth_Center"]、
 パラメータ["中心の緯度", 46.95240555555556 ],
 パラメータ["中心の経度", 7.439583333333333 ],
 PARAMETER["azimuth", 90 ]、PARAMETER["rectified_grid_angle", 90 ]、
 PARAMETER["scale_factor", 1 ]、PARAMETER["false_easting", 2600000 ]、
 PARAMETER["false_northing", 1200000 ],UNIT["metre", 1 ,
 権限["EPSG"," 9001 "]]、軸["Y",EAST]、
 AXIS["X",NORTH],AUTHORITY["EPSG"," 2056 "]]
  <verticalDef model= "constShift" geoidHeight= "0" />
  </output>
  <gcp>
  <WKT>PROJCS["CH1903+ / LV95",GEOGCS["CH1903+",
 DATUM["CH1903+",SPHEROID["Bessel  1841 ", 6377397.155 , 299.1528128 ,
 AUTHORITY["EPSG"," 7004 "]]、TOWGS84[ 674.374 、 15.056 、 405.346 、 0 、 0 、 0 、 0 ]、
 AUTHORITY["EPSG"," 6150 "]]、PRIMEM["Greenwich", 0 、
 権限["EPSG"," 8901 "]]、単位["degree", 0.0174532925199433 、
 AUTHORITY["EPSG"," 9122 "]]、AUTHORITY["EPSG"," 4150 "]]、
 投影法["Hotine_Oblique_Mercator_Azimuth_Center"]、
 パラメータ["中心の緯度", 46.95240555555556 ],
 パラメータ["中心の経度", 7.439583333333333 ],
 PARAMETER["azimuth", 90 ]、PARAMETER["rectified_grid_angle", 90 ]、
 PARAMETER["scale_factor", 1 ]、PARAMETER["false_easting", 2600000 ]、
 PARAMETER["false_northing", 1200000 ],UNIT["metre", 1 ,
 権限["EPSG"," 9001 "]]、軸["Y",EAST]、
 AXIS["X",NORTH],AUTHORITY["EPSG"," 2056 "]]
  <verticalDef model= "constShift" geoidHeight= "0" />
  </gcp>
  <image>
  <WKT>GEOGCS[&quot;WGS  84 ",DATUM["WGS_1984",SPHEROID["WGS  84 ",
 6378137 、 298.257223563 、AUTHORITY["EPSG"," 7030 "]]、TOWGS84[ 0 、 0 、 0 、 0 、 0 、 0 、 0 ]、
 AUTHORITY["EPSG"," 6326 "]],PRIMEM["Greenwich", 0 ,AUTHORITY["
 EPSG"," 8901 "]],UNIT["degree", 0.01745329251994328 ,
 権限["EPSG"," 9122 "]]、
 権限["EPSG"," 4326 "]]
  <verticalDef model= "constShift" geoidHeight= "0" />
  </image>
  </coordinateSystems>
  <gcps>
  <GCP label= "GCP34" x= "2645179.6829" y= "1132492.3415" z= "714.5561" id= "0" type= "3DGCP" />
  <GCP label= "GCP35" x= "2645181.2668" y= "1132427.7042" z= "710.6317" id= "1" type= "3DGCP" />
  <GCP label= "GCP36" x= "2645120.8904" y= "1132344.4249" z= "713.0474" id= "2" type= "3DGCP" />
  <GCP label= "GCP37" x= "2645104.4556" y= "1132422.4822" z= "713.2078" id= "3" type= "3DGCP" />
  </gcps>
  <images>
  <image path= "D:/guided_tour/images/IMG_4082.JPG" >
  <gps lat= "46.3414965400039" lng= "8.02588605999496" alt= "914.066589355469" />
  <imageGCP x= "2540.19431702924" y= "1427.43502245644" id= "1" />
  </image>
  <image path= "D:/guided_tour/images/IMG_4083.JPG" >
  <gps lat= "46.3411381999907" lng= "8.02537270001017" alt= "914.736022949219" />
  <imageGCP x= "2338.86753301507" y= "559.488567046065" id= "2" />
  </image>
  <image path= "D:/guided_tour/images/IMG_4087.JPG" >
  <gps lat= "46.3411327000576" lng= "8.02484090003983" alt= "914.903991699219" />
  </image>
  </images>
  </inputs>
</pix4dmapper>

例6

EXIFに画像位置情報が含まれている画像で構成されるプロジェクトの場合は、3Dモデルの事前定義済みテンプレートを使用する必要があります。.

最小p4d含有量

画像一覧。.
プロジェクトを初めて開いたときに読み込むテンプレート。.

プロジェクトの特徴

画像

はい、最低3枚の画像

このプロジェクトには画像リストが含まれています。少なくとも3枚の画像を指定する必要があります。.

画像の位置情報

はい、EXIFではWGS84です

このプロジェクトでは、画像にWGS84形式の地理位置情報がEXIFに保存されています。.

カメラモデル

データベース内
または
EXIFから

プロジェクトで使用されるカメラは、データベースに該当するカメラモデルが登録されているか、またはEXIF情報から読み込むことができます。.

GCP

いいえ

このプロジェクトにはGCP（地上基準点）がありません。.

出力座標系

WGS84 - UTM

出力座標系は、画像の位置情報と同じWGS84 UTMです。.

加工エリア

いいえ

このプロジェクトには処理エリアがありません。.

処理オプション/テンプレート

3Dモデル

このプロジェクトは、で指定されたテンプレートを読み込みます。 3D モデル この例では、

例：

<?xml version= "1.0" encoding= "UTF-8" ?>
<pix4dmapper>
  <options>
  <loadTemplate>3Dモデル</loadTemplate>
  </options>
  <inputs>
  <images>
  <image path= "D:/guided_tour/images/IMG_4082.JPG/" />
  <image path= "D:/guided_tour/images/IMG_4083.JPG/" />
  <image path= "D:/guided_tour/images/IMG_4087.JPG/" />
  <image path= "D:/guided_tour/images/IMG_4088.JPG/" />
  </images>
  </inputs>
</pix4dmapper>