ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

contour3

構文

contour3(Z)
contour3(Z,n)
contour3(Z,v)
contour3(X,Y,Z)
contour3(X,Y,Z,n)
contour3(X,Y,Z,v)
contour3(...,LineSpec)
contour3(...,Name,Value)
contour3(ax,...)
[C,h] = contour3(...)

説明

関数 contour3 は、四角形グリッド上に定義された表面の 3 次元等高線図を作成します。

contour3(Z) は、行列 Z の等高線図を 3 次元表示で描画します。ここで Z は、xy 平面を底面とする高さとして解釈されます。Z は、最低 2 個の異なる値を含む、少なくとも 2 行 2 列の行列でなければなりません。x の値は Z の列インデックスに対応し、y の値は Z の行インデックスに対応します。等高線レベルは自動的に選択されます。

contour3(Z,n) は、等高線レベルを n として行列 Z の等高線図を 3 次元表示で描画します。

contour3(Z,v) は、行列 Z の等高線図を、ベクトル v で指定された値の等高線を使用して描画します。等高線のレベル数は、length(v) に等しくなります。ベクトル v を指定すると、LevelListMode プロパティが manual に設定されます。単一の等高線を特定の値で表示するには、両方の要素が希望する等高線レベルと等しい 2 要素ベクトルとして v を定義します。たとえば、レベル k の等高線を 1 本だけ描画するには、contour3(Z,[k k]) を使用します。

contour3(X,Y,Z)contour3(X,Y,Z,n)contour3(X,Y,Z,v) は、XY から xy の値を特定して Z の等高線図を描画します。

  • XY がベクトルの場合、length(X)size(Z,2) と等しく、length(Y)size(Z,1) と等しくなければなりません。ベクトルは厳密に増加するか厳密に減少するかのどちらかでなければならず、繰り返しの値を含めることはできません。

  • XY が行列の場合、これらのサイズが Z のサイズと等しくなければなりません。通常は、列が厳密に増加するか厳密に減少して行が均一 (または行が厳密に増加するか厳密に減少して列が均一) になるように XY を設定します。

X または Y が等間隔ではない場合、contour3 は、等間隔の等高線グリッドを使って等高線を計算した後、データを X または Y に変換します。

contour3(...,LineSpec) は、LineSpec によって指定されるラインのタイプと色を使用して等高線を描画します。contour3 はマーカー記号を無視します。

contour3(...,Name,Value) は、1 つ以上のプロパティの名前と値のペアを使用して等高線のプロパティを指定します。Name はプロパティ名で、単一引用符 ('') で囲まなければなりません。Value は対応する値です。たとえば 'LineWidth',2 は等高線の幅を 2 に設定します。プロパティの名前と値の一覧については、Contour のプロパティ を参照してください。

contour3(ax,...) は、現在の座標軸 (gca) ではなく ax によって指定される座標軸にプロットします。

[C,h] = contour3(...) は、等高線を定義するデータが格納された等高線行列 C と contour オブジェクト h を返します。関数 clabel は、等高線行列を使用して等高線にラベルを付けます。

すべて折りたたむ

3 次元等高線図の作成

関数 meshgrid を使用して、行列 X および Y をセットアップします。行列 Z の 30 本の等高線をプロットします。

x = -2:0.25:2;
[X,Y] = meshgrid(x);
Z = X.*exp(-X.^2-Y.^2);
contour3(X,Y,Z,30)

詳細

すべて折りたたむ

ヒント

LineSpec を指定しない場合、関数 colormapcaxis が色を制御します。

等高線にラベルを付けるには、clabel を使用します。

contour3(...) の動作は contour(...) と同様ですが、等高線が対応する z の値に基づいて描画される点が異なります。

参考

MATLAB 関数

プロパティ

この情報は役に立ちましたか?