trimesh

三角形メッシュ プロット

構文

trimesh(T,x,y)

trimesh(T,x,y,z)

trimesh(x,y,z,c)

trimesh(TO)

trimesh(___,Name,Value)

h = trimesh(___)

説明

trimesh(T,x,y) は、ベクトル x およびベクトル y の点と、三角形連結行列 T によって定義される 2 次元三角形メッシュをプロットします。

trimesh(T,x,y,z) は、3 次元三角形メッシュをプロットします。

また、trimesh(x,y,z,c) は、3 次元三角形メッシュのメッシュ エッジの色も指定します。

trimesh(TO) は、3 次元の triangulation オブジェクトまたは delaunayTriangulation オブジェクトによって定義されるメッシュをプロットします。

trimesh(___,Name,Value) は、1 つ以上の名前と値の引数を使用してオプションを指定します。たとえば trimesh(T,x,y,"LineWidth",2) は、エッジの幅を 2 ポイントに設定します。

h = trimesh(___) は、2 次元三角形メッシュの Line オブジェクトのベクトル、またはメッシュのプロットの作成に使用される patch オブジェクトを返します。プロットのプロパティについてクエリおよび変更を行うには、h を使用します。詳細については、Line のプロパティとPatch のプロパティを参照してください。

例

3 次元三角形メッシュ

3 次元の点の集合を作成します。関数 delaunay を使用して Delaunay 三角形分割の連結行列を計算し、メッシュをプロットします。

[x,y] = meshgrid(1:15,1:15);
z = peaks(15);
T = delaunay(x,y);
trimesh(T,x,y,z)

あるいは、triangulation オブジェクトを作成してメッシュをプロットできます。

TO = triangulation(T,x(:),y(:),z(:));
trimesh(TO)

入力引数

T — 三角形の連結性

行列

三角形の連結性。各行に三角形を定義する頂点がある 3 列の行列として指定します。

x — x 座標

列ベクトル

x 座標。列ベクトルとして指定します。

y — y 座標

列ベクトル

y 座標。列ベクトルとして指定します。

z — z 座標

列ベクトル

z 座標。列ベクトルとして指定します。

c — エッジの色

行列

エッジの色。z と同じサイズのカラーマップ インデックスの行列として指定します。詳細については、表面プロット データをカラーマップに関連付ける方法を参照してください。表面のカラーリングをさらに制御するには、名前と値の引数 "EdgeColor" と "FaceColor" を使用します。

TO — 三角形分割オブジェクト

triangulation オブジェクト | delaunayTriangulation オブジェクト

三角形分割オブジェクト。triangulationオブジェクトまたはdelaunayTriangulationオブジェクトとして指定します。

名前と値の引数

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

例: trimesh(TO,"LineStyle"="--")

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

例: trimesh(TO,"LineStyle","--")

ここには一部のプロパティのみを示します。完全な一覧については、Patch のプロパティを参照してください。

FaceColor — 面の色

[0.85 0.85 0.85] (既定値) | 色名 | RGB 3 成分 | "none"

面の色。色名、RGB 3 成分または "none" として指定します。

RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。次の表に、色の完全名および省略名のオプションと、等価の RGB 3 成分の値を示します。

完全名	省略名	RGB 3 成分
"yellow"	"y"	[1 1 0]
"magenta"	"m"	[1 0 1]
"cyan"	"c"	[0 1 1]
"red"	"r"	[1 0 0]
"green"	"g"	[0 1 0]
"blue"	"b"	[0 0 1]
"white"	"w"	[1 1 1]
"black"	"k"	[0 0 0]

FaceAlpha — 面の透明度

1 (既定値) | 範囲 [0,1] のスカラー

面の透明度。[0,1] の範囲のスカラーとして指定します。値 1 は不透明、値 0 は完全な透明を表します。0 と 1 の間の値は半透明です。

EdgeColor — エッジの色

[0 0 0] (既定値) | 色名 | RGB 3 成分 | "none"

エッジの色。色名、RGB 3 成分または "none" として指定します。既定の色は [0 0 0] で、これは黒色の境界に対応します。

RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。次の表に、色の完全名および省略名のオプションと、等価の RGB 3 成分の値を示します。

完全名	省略名	RGB 3 成分
"yellow"	"y"	[1 1 0]
"magenta"	"m"	[1 0 1]
"cyan"	"c"	[0 1 1]
"red"	"r"	[1 0 0]
"green"	"g"	[0 1 0]
"blue"	"b"	[0 0 1]
"white"	"w"	[1 1 1]
"black"	"k"	[0 0 0]

LineWidth — ライン幅

0.5 (既定値) | 正の値

ライン幅。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。ラインがマーカーをもつ場合、ライン幅はマーカー エッジにも影響します。

ライン幅をピクセルの幅より細くすることはできません。システムでライン幅をピクセルの幅より細い値に設定すると、ラインは 1 ピクセル幅で表示されます。

LineStyle — ライン スタイル

"-" (既定値) | "--" | ":" | "-." | "none"

ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。

ライン スタイル	説明	結果として得られる線
"-"	実線
"--"	破線
":"	点線
"-."	一点鎖線
"none"	ラインなし	ラインなし

ヒント

• 2 次元の triangulation オブジェクトまたは delaunayTriangulation オブジェクトによって定義されたメッシュをプロットするには、関数triplotを使用します。

拡張機能

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

trimesh 関数は GPU 配列入力をサポートしますが、次の使用上の注意および制限があります。

• この関数は GPU 配列を受け入れますが、GPU 上では実行されません。

詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

使用上の注意および制限:

• この関数は分散配列に対して演算を行いますが、クライアントの MATLAB^® で実行されます。

詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2006a より前に導入

参考

patch | delaunay | trisurf | delaunayTriangulation | triangulation | plot