waterfall
ウォーターフォール プロット
構文
説明
waterfall( はウォータフォール プロットを作成し、Z)Z の要素の列インデックスと行インデックスを x 座標および y 座標として使用します。
waterfall(___, は、1 つ以上の名前と値の引数を使用してウォータフォール プロットのプロパティを設定します。たとえば、プロットのエッジの色と太さを指定できます。プロパティの一覧については、Patch のプロパティ を参照してください。 (R2024b 以降)Name=Value)
waterfall( は、現在の座標軸ではなく、ax,___)ax で指定される座標軸にプロットします。座標軸を最初の入力引数として指定します。この引数は、前述の任意の入力構文で使用できます。
p = waterfall(___) は、patch オブジェクトを返します。ウォータフォール プロットを作成した後で変更を加えるには、p を使用します。プロパティの一覧については、Patch のプロパティ を参照してください。
例
同じサイズの 3 つの行列を作成します。次に、それらをウォータフォール プロットとしてプロットします。メッシュ プロットでは、Z を高さと色の両方に使用します。
[X,Y] = meshgrid(-3:.125:3); Z = peaks(X,Y); waterfall(X,Y,Z)
4 番目の行列入力 C を使用して、ウォータフォール プロットの色を指定します。ウォータフォール プロットでは、高さに Z、色に C が使用されます。カラー バーをグラフに追加して、C のデータ値がカラーマップの色にどのように対応するかを示します。
[X,Y] = meshgrid(-3:.125:3); Z = peaks(X,Y); C = gradient(Z); waterfall(X,Y,Z,C) colorbar
ウォータフォール プロットを作成します。その後の変更を可能にするには、patch オブジェクトを変数 p に代入します。
[X,Y] = meshgrid(-5:.5:5); Z = Y.*sin(X) - X.*cos(Y); p = waterfall(X,Y,Z)
p =
Patch with properties:
FaceColor: [1 1 1]
FaceAlpha: 1
EdgeColor: 'flat'
LineStyle: '-'
Faces: [21×26 double]
Vertices: [546×3 double]
Show all properties
ウォータフォール プロットの作成後に、そのプロパティへのアクセスおよび変更を行うには、p を使用します。たとえば、プロットのエッジの色を変更するには、EdgeColor プロパティを設定します。
p.EdgeColor = 'b';
入力引数を転置することにより、部分的なカーテンを (y 次元ではなく) x 次元に沿って表示します。
[X,Y] = meshgrid(-3:.125:3); Z = peaks(X,Y); waterfall(X',Y',Z')
入力引数
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
例: waterfall(peaks,LineStyle="--") は、破線を使用してウォータフォール プロットを作成します。
メモ
ここには一部のプロパティのみを示します。完全な一覧については、Patch のプロパティ を参照してください。
エッジの色。次の表のいずれかの値として指定します。エッジの既定色は黒で、[0 0 0] の値で指定されます。複数の多角形で共有されるエッジの場合、その表示色は最初に描画された多角形によって決まります。
| 値 | 説明 | 結果 |
|---|---|---|
RGB 3 成分、16 進数カラー コード、色名 | すべてのエッジに 1 つの色を使用します。詳細については、次の表を参照してください。 |
|
'flat' | エッジごとに異なる色を使用します。エッジの色を設定するには、その前の頂点の色を指定します。まず、頂点ごとに 1 つの色を含む配列として |
|
'interp' | 内挿されたエッジの色。まず、頂点ごとに 1 つの色を含む配列として |
|
'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" |
|
"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" |
|
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
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 進数カラー コードを取得します。
ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。
| ライン スタイル | 説明 | 結果として得られる線 |
|---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
ヒント
データを行ではなく列として解析するには、転置した引数を使用して
waterfallを呼び出します。[X,Y] = meshgrid(-3:.125:3); Z = peaks(X,Y); waterfall(X',Y',Z')
patch オブジェクトではなく mesh surface オブジェクトを作成するには、関数
meshzを使用します。ウォータフォール プロットに似たプロットを作成するには、表面のMeshStyleプロパティを'Row'に設定します。
アルゴリズム
座標軸の
XLim、YLim、およびZLimの各プロパティは、x 軸、y 軸、および z 軸の範囲を格納します。これらの範囲は、入力引数X、Y、およびZの範囲に基づきます。座標軸の
CLimプロパティは、Cの範囲への色の分布を決定します。詳細については、カラーマップの範囲の制御を参照してください。
