meshz

カーテン付きのメッシュ表面プロット

ページ内をすべて折りたたむ

構文

meshz(X,Y,Z)

meshz(X,Y,Z,C)

meshz(Z)

meshz(Z,C)

meshz(___,Name,Value)

meshz(ax,___)

s = meshz(___)

説明

meshz(X,Y,Z) は、メッシュプロットとその周囲のカーテンを作成します。メッシュプロットとは、色付きの実線のエッジと、色なしの面をもつ 3 次元表面です。この関数は行列 Z の値を、X と Y で定義される x-y 平面のグリッドの上の高さとしてプロットします。エッジの色は、Z で指定された高さに従って異なります。

例

meshz(X,Y,Z,C) は、さらにエッジの色を指定します。

例

meshz(Z) はカーテン付きのメッシュプロットを作成し、Z の要素の列インデックスと行インデックスを x 座標および y 座標として使用します。

meshz(Z,C) はエッジの色を指定します。

meshz(___,Name,Value) は、1 つ以上の名前と値のペアの引数を使用して、meshz プロットの追加オプションを指定します。オプションは他のすべての入力引数の後に指定します。プロパティの一覧については、Surface のプロパティを参照してください。

meshz(ax,___) は、現在の座標軸ではなく、ax で指定される座標軸にプロットします。座標軸を最初の入力引数として指定します。

s = meshz(___) は chart surface オブジェクトを返します。メッシュプロットを作成した後で変更を加えるには、s を使用します。プロパティの一覧については、Surface のプロパティを参照してください。

例

すべて折りたたむ

メッシュプロットの周囲のカーテンの表示

ライブスクリプトを開く

同じサイズの 3 つの行列を作成します。次にそれらを、カーテン付きのメッシュプロットとしてプロットします。メッシュプロットでは、Z を高さと色の両方に使用します。

[X,Y] = meshgrid(-3:.125:3);
Z = peaks(X,Y);
meshz(X,Y,Z)

Figure contains an axes object. The axes object contains an object of type surface.

カーテン付きのメッシュプロットに対するカラーマップの色の指定

ライブスクリプトを開く

4 番目の行列入力 C を含めて、メッシュプロットと周囲のカーテンの色を指定します。このメッシュプロットでは、Z を高さに、C を色に使用します。"カラーマップ" を使用して色を指定します。カラーマップは、単一の数値を使用してスペクトル上の色を表します。カラーマップを使用する場合、C は Z と同じサイズです。カラーバーをグラフに追加して、C のデータ値がカラーマップの色にどのように対応するかを示します。

[X,Y] = meshgrid(-3:.125:3);
Z = peaks(X,Y);
C = gradient(Z);
meshz(X,Y,Z,C)
colorbar

Figure contains an axes object. The axes object contains an object of type surface.

カーテン付きのメッシュプロットの外観の変更

ライブスクリプトを開く

周囲にカーテンをもつメッシュプロットを作成します。その後の変更を可能にするには、surface オブジェクトを変数 s に代入します。

[X,Y] = meshgrid(-5:.5:5);
Z = Y.*sin(X) - X.*cos(Y);
s = meshz(X,Y,Z)

Figure contains an axes object. The axes object contains an object of type surface.

s = 
  Surface (meshz) with properties:

       EdgeColor: 'flat'
       LineStyle: '-'
       FaceColor: [1 1 1]
    FaceLighting: 'none'
       FaceAlpha: 1
           XData: [25×25 double]
           YData: [25×25 double]
           ZData: [25×25 double]
           CData: [25×25 double]

  Show all properties

メッシュプロットの作成後に、そのプロパティへのアクセスおよび変更を行うには、s を使用します。たとえば、メッシュプロットのエッジと周囲のカーテンの色を変更するには、EdgeColor プロパティを設定します。

s.EdgeColor = 'b';

Figure contains an axes object. The axes object contains an object of type surface.

入力引数

すべて折りたたむ

`X` — x 座標
行列 | ベクトル

x 座標。Z と同じサイズの行列、または長さが n のベクトル ([m,n] = size(Z)) として指定します。X と Y の値を指定しない場合、meshz はベクトル (1:n) とベクトル (1:m) を使用します。

X が行列である場合、その値は 1 つの次元に沿って厳密に増加するか減少しなければならず、その他の次元に沿って一定でなければなりません。変化する次元は、Y で変化する次元と反対のものでなければなりません。行列 X と行列 Y を作成するには、関数 meshgrid を使用できます。

X がベクトルである場合、その値は厳密に増加するか減少しなければなりません。

surface オブジェクトの XData プロパティには x 座標が保存されます。

例: X = 1:10

例: X = [1 2 3; 1 2 3; 1 2 3]

例: [X,Y] = meshgrid(-5:0.5:5)

`Y` — y 座標
行列 | ベクトル

y 座標。Z と同じサイズの行列、または長さ m のベクトルとして指定します。ここで、[m,n] = size(Z) です。X と Y の値を指定しない場合、meshz はベクトル (1:n) とベクトル (1:m) を使用します。

Y が行列である場合、その値は 1 つの次元に沿って厳密に増加するか減少しなければならず、その他の次元に沿って一定でなければなりません。変化する次元は、X で変化する次元と反対のものでなければなりません。行列 X と行列 Y を作成するには、関数 meshgrid を使用できます。

Y がベクトルである場合、その値は厳密に増加するか減少しなければなりません。

surface オブジェクトの YData プロパティには y 座標が保存されます。

例: Y = 1:10

例: Y = [1 1 1; 2 2 2; 3 3 3]

例: [X,Y] = meshgrid(-5:0.5:5)

`Z` — z 座標
行列

z 座標。行列として指定します。Z は少なくとも 2 行 2 列でなければなりません。

Z は、各 x-y 座標におけるメッシュプロットの高さを指定します。色を指定しない場合、Z はメッシュエッジの色も指定します。

surface オブジェクトの ZData プロパティには z 座標が保存されます。

例: Z = [1 2 3; 4 5 6]

例: Z = sin(x) + cos(y)

`C` — 色配列
行列

色配列。m 行 n 列のカラーマップインデックスの行列として指定します。ここで、Z は m 行 n 列です。メッシュ表面の各グリッド点について、C はカラーマップ内の色を示します。surface オブジェクトの CDataMapping プロパティは、C の値がカラーマップの色にどのように対応するかを制御します。

surface オブジェクトの CData プロパティには色配列が保存されます。表面のカラーリングをさらに制御するには、FaceColor プロパティと EdgeColor プロパティを使用します。

`ax` — プロット対象の座標軸
axes オブジェクト

プロット対象の座標軸。axes オブジェクトとして指定します。座標軸を指定しない場合、meshz は現在の座標軸にプロットします。

名前と値の引数

すべて折りたたむ

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

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

例: meshz(X,Y,Z,'EdgeColor','red') は赤のラインを使用してメッシュを作成します。

メモ

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

`MeshStyle` — 表示するエッジ
`'both'` (既定値) | `'row'` | `'column'`

表示するエッジ。'both'、'row'、'column' のいずれかとして指定します。

`EdgeColor` — エッジのラインの色
`'none'` | `'flat'` | `'interp'` | RGB 3 成分 | 16 進数カラーコード | `'r'` | `'g'` | `'b'` | ...

エッジのラインの色。次のいずれかの値として指定します。既定の色は [0 0 0] で、これは黒色のエッジに対応します。

値	説明
`'none'`	エッジを描画しません。
`'flat'`	`CData` プロパティの値に基づいてエッジごとに異なる色を使用します。まず、`CData` プロパティを `ZData` と同じサイズの行列として指定しなければなりません。各面の最初の頂点 (正の x 方向と y 方向) のカラー値が、隣接するエッジの色を決定します。この値は `EdgeAlpha` プロパティが `'interp'` に設定されている場合は使用できません。
`'interp'`	`CData` プロパティの値に基づいて、エッジごとに内挿によるカラーリングを使用します。まず、`CData` プロパティを `ZData` と同じサイズの行列として指定しなければなりません。頂点でのカラー値を線形内挿することにより、各エッジの端から端に向かって色が変化します。この値は `EdgeAlpha` プロパティが `'flat'` に設定されている場合は使用できません。
RGB 3 成分、16 進数カラーコード、色名	指定した色をすべてのエッジに使用します。このオプションは `CData` プロパティのカラー値を使用しません。

RGB 3 成分および 16 進数カラーコードは、カスタム色を指定するのに役立ちます。

RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。
16 進数カラーコードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。この値は大文字と小文字を区別しません。したがって、カラーコード "#FF8800"、"#ff8800"、"#F80"、および "#f80" は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラーコードを示します。

色名	省略名	RGB 3 成分	16 進数カラーコード
`"red"`	`"r"`	`[1 0 0]`	`"#FF0000"`
`"green"`	`"g"`	`[0 1 0]`	`"#00FF00"`
`"blue"`	`"b"`	`[0 0 1]`	`"#0000FF"`
`"cyan"`	`"c"`	`[0 1 1]`	`"#00FFFF"`
`"magenta"`	`"m"`	`[1 0 1]`	`"#FF00FF"`
`"yellow"`	`"y"`	`[1 1 0]`	`"#FFFF00"`
`"black"`	`"k"`	`[0 0 0]`	`"#000000"`
`"white"`	`"w"`	`[1 1 1]`	`"#FFFFFF"`

次の表に、ライトテーマとダークテーマでのプロットの既定のカラーパレットを示します。

パレットパレットの色

パレット	パレットの色
`"gem"` — ライトテーマの既定値 R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。
`"glow"` — ダークテーマの既定値

"gem" — ライトテーマの既定値

R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。

Sample of the "gem" color palette

"glow" — ダークテーマの既定値

Sample of the "glow" color palette

orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラーコードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラーコードに変換します。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。

R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラーコードを取得します。

`FaceColor` — 面の色
`'flat'` (既定値) | `'interp'` | `'none'` | `'texturemap'` | RGB 3 成分 | 16 進数カラーコード | `'r'` | `'g'` | `'b'` | ...

面の色。次の表のいずれかの値として指定します。

値	説明
`'flat'`	`CData` プロパティの値に基づいて面ごとに異なる色を使用します。まず、`CData` プロパティを `ZData` と同じサイズの行列として指定しなければなりません。各面の最初の頂点 (正の x 方向と y 方向) のカラー値が、面全体の色を決定します。この値は `FaceAlpha` プロパティが `'interp'` に設定されている場合は使用できません。
`'interp'`	`CData` プロパティの値に基づいて、面ごとに内挿によるカラーリングを使用します。まず、`CData` プロパティを `ZData` と同じサイズの行列として指定しなければなりません。頂点のカラー値を内挿することにより、各面の端から端へと色が変化します。この値は `FaceAlpha` プロパティが `'flat'` に設定されている場合は使用できません。
RGB 3 成分、16 進数カラーコード、色名	指定した色をすべての面で使用します。このオプションは `CData` プロパティのカラー値を使用しません。
`'texturemap'`	`CData` のカラーデータを表面に適合するように変換します。
`'none'`	面を描画しません。

RGB 3 成分および 16 進数カラーコードは、カスタム色を指定するのに役立ちます。

RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。
16 進数カラーコードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。この値は大文字と小文字を区別しません。したがって、カラーコード "#FF8800"、"#ff8800"、"#F80"、および "#f80" は等価です。

色名	省略名	RGB 3 成分	16 進数カラーコード
`"red"`	`"r"`	`[1 0 0]`	`"#FF0000"`
`"green"`	`"g"`	`[0 1 0]`	`"#00FF00"`
`"blue"`	`"b"`	`[0 0 1]`	`"#0000FF"`
`"cyan"`	`"c"`	`[0 1 1]`	`"#00FFFF"`
`"magenta"`	`"m"`	`[1 0 1]`	`"#FF00FF"`
`"yellow"`	`"y"`	`[1 1 0]`	`"#FFFF00"`
`"black"`	`"k"`	`[0 0 0]`	`"#000000"`
`"white"`	`"w"`	`[1 1 1]`	`"#FFFFFF"`

次の表に、ライトテーマとダークテーマでのプロットの既定のカラーパレットを示します。

パレットパレットの色

パレット	パレットの色
`"gem"` — ライトテーマの既定値 R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。
`"glow"` — ダークテーマの既定値

"gem" — ライトテーマの既定値

R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。

Sample of the "gem" color palette

"glow" — ダークテーマの既定値

Sample of the "glow" color palette

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。

R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラーコードを取得します。

`EdgeAlpha` — エッジの透明度
1 (既定値) | `[0,1]` の範囲のスカラー値 | `'flat'` | `'interp'`

エッジの透明度。次の値のいずれかとして指定します。

範囲 [0,1] のスカラー — すべてのエッジに一様な透明度を使用します。値 1 は完全に不透明で、値 0 は完全に透明です。0 と 1 の間の値は半透明です。このオプションは AlphaData プロパティの透明度値を使用しません。
'flat' — AlphaData プロパティの値に基づいてエッジごとに異なる透明度を使用します。まず AlphaData プロパティを ZData プロパティと同じサイズの行列として指定しなければなりません。エッジ全体の透明度は、最初の頂点の透明度値によって決まります。EdgeColor プロパティも、'flat' に設定しなければなりません。
'interp' — AlphaData プロパティの値に基づいて、エッジごとに内挿した透明度を使用します。まず AlphaData プロパティを ZData プロパティと同じサイズの行列として指定しなければなりません。頂点の値を内挿することにより、各エッジに一様でない透明度が使用されます。EdgeColor プロパティも、'interp' に設定しなければなりません。

`LineStyle` — ラインスタイル
`"-"` (既定値) | `"--"` | `":"` | `"-."` | `"none"`

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

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

`LineWidth` — ライン幅
`0.5` (既定値) | 正の値

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

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

拡張機能

すべて展開する

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

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

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

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

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

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

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

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

バージョン履歴

R2006a より前に導入

参考

関数

mesh | waterfall | meshc | meshgrid | imagesc | view | shading | pcolor | colormap

プロパティ

Surface のプロパティ | Contour のプロパティ

meshz

構文

説明

例

メッシュ プロットの周囲のカーテンの表示

カーテン付きのメッシュ プロットに対するカラーマップの色の指定

カーテン付きのメッシュ プロットの外観の変更

入力引数

X — x 座標 行列 | ベクトル

Y — y 座標 行列 | ベクトル

Z — z 座標 行列

C — 色配列 行列

ax — プロット対象の座標軸 axes オブジェクト

名前と値の引数

MeshStyle — 表示するエッジ 'both' (既定値) | 'row' | 'column'

EdgeColor — エッジのラインの色 'none' | 'flat' | 'interp' | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

FaceColor — 面の色 'flat' (既定値) | 'interp' | 'none' | 'texturemap' | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

EdgeAlpha — エッジの透明度 1 (既定値) | [0,1] の範囲のスカラー値 | 'flat' | 'interp'

LineStyle — ライン スタイル "-" (既定値) | "--" | ":" | "-." | "none"

LineWidth — ライン幅 0.5 (既定値) | 正の値

拡張機能

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

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

バージョン履歴

参考

関数

プロパティ

トピック

メッシュプロットの周囲のカーテンの表示

カーテン付きのメッシュプロットに対するカラーマップの色の指定

カーテン付きのメッシュプロットの外観の変更

`X` — x 座標
行列 | ベクトル

`Y` — y 座標
行列 | ベクトル

`Z` — z 座標
行列

`C` — 色配列
行列

`ax` — プロット対象の座標軸
axes オブジェクト

`MeshStyle` — 表示するエッジ
`'both'` (既定値) | `'row'` | `'column'`

`EdgeColor` — エッジのラインの色
`'none'` | `'flat'` | `'interp'` | RGB 3 成分 | 16 進数カラーコード | `'r'` | `'g'` | `'b'` | ...

`FaceColor` — 面の色
`'flat'` (既定値) | `'interp'` | `'none'` | `'texturemap'` | RGB 3 成分 | 16 進数カラーコード | `'r'` | `'g'` | `'b'` | ...

`EdgeAlpha` — エッジの透明度
1 (既定値) | `[0,1]` の範囲のスカラー値 | `'flat'` | `'interp'`

`LineStyle` — ラインスタイル
`"-"` (既定値) | `"--"` | `":"` | `"-."` | `"none"`

`LineWidth` — ライン幅
`0.5` (既定値) | 正の値

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

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