Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

meshz

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

説明

meshz(X,Y,Z)は、メッシュ プロットとその周囲のカーテンを作成します。メッシュ プロットとは、色付きの実線のエッジと、色なしの面をもつ 3 次元表面です。この関数は行列Zの値を、XYで定義される 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を色に使用します。"カラーマップ"を使用して色を指定します。カラーマップは、単一の数値を使用してスペクトル上の色を表します。カラーマップを使用する場合、CZと同じサイズです。カラー バーをグラフに追加して、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 =表面(meshz)属性:EdgeColor:“flat' LineStyle: '-' FaceColor: [1 1 1] FaceLighting: 'none' FaceAlpha: 1 XData: [25x25 double] YData: [25x25 double] ZData: [25x25 double] CData: [25x25 double] Show all properties

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

s.EdgeColor ='b';

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

入力引数

すべて折りたたむ

x 座標。Zと同じサイズの行列、または長さがnのベクトル ([m,n] = size(Z)) として指定します。XYの値を指定しない場合、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)

データ型:single|double|int8|int16|int32|int64|uint8|uint16|uint32|uint64|categorical

y 座標。Zと同じサイズの行列、または長さmのベクトルとして指定します。ここで、[m,n] = size(Z)です。XYの値を指定しない場合、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)

データ型:single|double|int8|int16|int32|int64|uint8|uint16|uint32|uint64|categorical

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

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

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

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

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

データ型:single|double|int8|int16|int32|int64|uint8|uint16|uint32|uint64|categorical

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

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

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

名前と値の引数

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

オプションのName,Valueの引数ペアをコンマ区切りで指定します。Nameは引数名で、Valueは対応する値です。Nameは引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueNのように、複数の名前と値のペアの引数を任意の順序で指定できます。

メモ

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

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

エッジのラインの色。次のいずれかの値として指定します。既定の色は[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'

Sample of the color red

'green' 'g' [0 1 0] '#00FF00'

Sample of the color green

'blue' 'b' [0 0 1] '#0000FF'

Sample of the color blue

'cyan' 'c' [0 1 1] '#00FFFF'

Sample of the color cyan

'magenta' 'm' [1 0 1] '#FF00FF'

Sample of the color magenta

'yellow' 'y' [1 1 0] '#FFFF00'

Sample of the color yellow

'black' 'k' [0 0 0] '#000000'

Sample of the color black

'white' 'w' [1 1 1] '#FFFFFF'

Sample of the color white

MATLAB®の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分 16 進数カラー コード 外観
[0 0.4470 0.7410] '#0072BD'

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980] '#D95319'

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250] '#EDB120'

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560] '#7E2F8E'

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880] '#77AC30'

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330] '#4DBEEE'

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840] '#A2142F'

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

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

説明
'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 進数カラー コードを示します。

色名 省略名 RGB 3 成分 16 進数カラー コード 外観
'red' 'r' [1 0 0] '#FF0000'

Sample of the color red

'green' 'g' [0 1 0] '#00FF00'

Sample of the color green

'blue' 'b' [0 0 1] '#0000FF'

Sample of the color blue

'cyan' 'c' [0 1 1] '#00FFFF'

Sample of the color cyan

'magenta' 'm' [1 0 1] '#FF00FF'

Sample of the color magenta

'yellow' 'y' [1 1 0] '#FFFF00'

Sample of the color yellow

'black' 'k' [0 0 0] '#000000'

Sample of the color black

'white' 'w' [1 1 1] '#FFFFFF'

Sample of the color white

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分 16 進数カラー コード 外観
[0 0.4470 0.7410] '#0072BD'

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980] '#D95319'

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250] '#EDB120'

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560] '#7E2F8E'

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880] '#77AC30'

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330] '#4DBEEE'

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840] '#A2142F'

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

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

  • 範囲[0,1]のスカラー — すべてのエッジに一様な透明度を使用します。値1は完全に不透明で、値0は完全に透明です。01の間の値は半透明です。このオプションはAlphaDataプロパティの透明度値を使用しません。

  • 'flat'AlphaDataプロパティの値に基づいてエッジごとに異なる透明度を使用します。まずAlphaDataプロパティをZDataプロパティと同じサイズの行列として指定しなければなりません。エッジ全体の透明度は、最初の頂点の透明度値によって決まります。EdgeColorプロパティも、'flat'に設定しなければなりません。

  • 'interp'AlphaDataプロパティの値に基づいて、エッジごとに内挿した透明度を使用します。まずAlphaDataプロパティをZDataプロパティと同じサイズの行列として指定しなければなりません。頂点の値を内挿することにより、各エッジに一様でない透明度が使用されます。EdgeColorプロパティも、'interp'に設定しなければなりません。

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

ライン スタイル 説明 結果として得られる線
'-' 実線

Sample of solid line

'--' 破線

Sample of dashed line

':' 点線

Sample of dotted line

'-.' 一点鎖線

Sample of dash-dotted line, with alternating dashes and dots

'none' ラインなし ラインなし

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

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

拡張機能

バージョン履歴

R2006a より前に導入