メインコンテンツ

pcshowpair

2 つの点群の違いの可視化

説明

pcshowpair(ptCloudA,ptCloudB) は、2 つの入力点群間の違いを示す可視化を作成します。違いは、マゼンタの点群 A と緑の点群 B をブレンドして表示されます。

pcshowpair(ptCloudA,ptCloudB,Name=Value) は、前の構文にある引数の任意の組み合わせに加えて、名前と値の引数を 1 つ以上使用してオプションを指定します。たとえば、pchowpair(ptCloudA,ptCloudB,BackgroundColor="yellow") は、Figure の背景色を黄色に設定します。

ax = pcshowpair(___) は、前述の構文のいずれかを使用して、違いを可視化するためのプロット軸を返します。

すべて折りたたむ

家庭内の環境で Kinect デバイスを使用してキャプチャされた 2 つの点群を読み込みます。

load("livingRoom");

pc1 = livingRoomData{1};
pc2 = livingRoomData{2};

点群の視点をプロットして設定します。

figure
pcshowpair(pc1,pc2,VerticalAxis="Y",VerticalAxisDir="Down")
title("Difference Between Two Point Clouds")
xlabel("X(m)")
ylabel("Y(m)")
zlabel("Z(m)")

Figure contains an axes object. The axes object with title Difference Between Two Point Clouds, xlabel X(m), ylabel Y(m) contains 2 objects of type scatter.

入力引数

すべて折りたたむ

点群 A。pointCloud オブジェクトとして指定します。この関数は、マゼンタの階調を使用して ptCloudA を表し、点群に色情報が含まれていない場合は純粋なマゼンタを使用します。

点群 B。pointCloud オブジェクトとして指定します。この関数は、緑の階調を使用して ptCloudB を表し、点群に色情報が含まれていない場合は純粋な緑を使用します。

名前と値の引数

すべて折りたたむ

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: pchowpair(ptCloudA,ptCloudB,BackgroundColor="yellow") は、Figure の背景色を黄色に設定します。

点マーカーのおおよその直径。正のスカラーとして指定します。単位はポイントです。マーカー サイズが 6 より大きいと、レンダリング パフォーマンスが低下する可能性があります。

背景色。RGB 3 成分または 16 進数カラー コードとして指定するか、色の完全名または省略名を文字ベクトルとして指定します。

縦軸。"X""Y"、または "Z" として指定します。Figure に対する操作は、保存した Figure を再読み込みする際、縦軸が z 軸にリセットされます。

縦軸の方向。"Up" または "Down" として指定します。Figure に対する操作は、保存した Figure を再読み込みする際、方向が上方向にリセットされます。

3 次元ビューのカメラ射影。次のいずれかの値として指定します。

  • "perspective" — 表示するボリュームをピラミッド (底面と平行に頂点が切り取られたピラミッド) の錐台として投影します。カメラから離れているオブジェクトは小さく表示されます。短縮法によって距離が表されるため、3 次元オブジェクトの奥行きを認識できるようになります。この投影タイプは、実際のオブジェクトの現実的なビューを表示する場合に役立ちます。透視投影では、オブジェクトの相対的な寸法は保持されません。代わりに、遠くのライン セグメントが、同じ長さの近くのライン セグメントよりも小さく表示されます。データ内で平行な線が、シーン内で平行に表示されない場合があります。

  • "orthographic" — この投影タイプは、ビューアーから特定の点までの距離に関して、グラフィックス オブジェクトの正確な相対寸法を維持します。カメラからの相対距離は、オブジェクトのサイズに影響しません。データ内で平行な線は、画面上で平行に表示されます。この投影タイプは、オブジェクトの実際のサイズとオブジェクトの間の角度を維持することが重要な場合に役立ちます。

点群を可視化する平面。"XY""YX""XZ""ZX""YZ""ZY" として指定します。ViewPlane は、カメラからの視線を、選択した平面の中央に配置し、プロットの中心に向かうように設定します。

カラーマップの点群プロパティ。"auto""X""Y""Z""Intensity""Color""Row""Column" として指定します。関数 pcshow は、ColorSource の値を使用して、点群のレンダリング用にカラーマップを割り当てます。値には次のプロパティを使用します。

  • "X" — 入力点群の Location プロパティの x 座標。

  • "Y" — 入力点群の Location プロパティの y 座標。

  • "Z" — 入力点群の Location プロパティの z 座標。

  • "Intensity" — 入力点群の Intensity プロパティ。

  • "Color" — 入力点群の Color プロパティ。

  • "Row" — オーガナイズド点群の行の値を使用。

  • "Column" — オーガナイズド点群の列の値を使用。

ColorSource"auto" に設定すると、入力点群オブジェクトで使用可能なプロパティ値に応じて、関数が次のようにカラーマップを設定します。

利用可能な点群プロパティ色のソース
Location のみ Z 値を現在のカラーマップのカラー値にマッピングします。
Location および Intensity Z 値を現在のカラーマップのカラー値にマッピングします。
Location および Color カラー値を現在のカラーマップにマッピングします。
LocationIntensity および Color カラー値を現在のカラーマップにマッピングします。

座標軸の可視性の状態。"on" または "off" として指定するか、数値または logical の 0 (false) または 1 (true) として指定します。"on" の値は true と等価であり、"off"false と等価です。したがって、このプロパティの値を logical 値として使用できます。この値は、matlab.lang.OnOffSwitchState 型の on/off の logical 値として格納されます。

  • "on" — 座標軸とその子を表示します。

  • "off" — 座標軸を削除せずに非表示にします。ただし、非表示の axes オブジェクトのプロパティにアクセスすることはできます。(ラインなどの子オブジェクトは可視のままになります。)

可視化を表示する座標軸。Axes オブジェクトとして指定します。Axes オブジェクトを作成するには、関数 axes を使用します。新しい Figure に可視化を表示するには、"Parent" を未指定のままにします。

出力引数

すべて折りたたむ

プロットの座標軸。axes グラフィックス オブジェクトとして返されます。座標が NaN または Inf である点は表示されません。

点群ビューアの既定の回転中心を、軸の中心で回転または点で回転するように設定できます。Computer Vision Toolbox の基本設定で既定の動作を設定します。

詳細

すべて折りたたむ

バージョン履歴

R2015b で導入

すべて展開する