| MATLAB Function Reference | |
Syntax
waterfall(Z)
waterfall(X,Y,Z)
waterfall(...,C)
h = waterfall(...)
Description
waterfall函式會畫出一個和 meshz 函式相似的網狀圖形，但它並不會產生矩陣裡欄所代表的線條，而產生了一種“瀑布”效果。
waterfall(Z)
會用 x = 1:size(Z,1) 和 y = 1:size(Z,1) 來建立一個瀑布圖。參數 Z 決定了圖形的顏色，因此顯現的顏色會與曲面的高度成比例相關。
waterfall(X,Y,Z)
會利用 X, Y, 和 Z 所指定的值來建立一個瀑布圖。Z 也決定了圖形的顏色，所以顯現的顏色會與曲面的高度成比例相關。若 X 和 Y 為向量，則 X 會對應至 Z 中的欄，而 Y 會對應至 Z 中的列。其中 length(x) = n, length(y) = m，且 [m,n] = size(Z)。X 和 Y 是用以定義圖形 x 和 y 座標的向量或矩陣。Z 則是定義圖形 z 座標的矩陣（即一平面上的高度）。若省略參數 C，則圖形的顏色會與 Z 成比例相關。
waterfall(...,C)
利用經內插法計算得到的顏色值以取得色彩對照表的顏色。在做顏色取得的內插計算時，會取決於 C 的範圍，其必須與 Z 具有相同的大小。 MATLAB 會對 C 執行一個線性內插法，以得到目前色彩對照表的顏色。
h = waterfall(...)
會回傳用以繪出瀑布圖之貼片圖形物件（patch graphics object）的握把（handle）。
Remarks
對欄導向的資料分析（column-oriented data analysis）而言，可使用 waterfall(Z') 或 waterfall(X',Y',Z')。
Examples
[X,Y,Z] = peaks(30);waterfall(X,Y,Z)
Algorithm
X, Y, 和 Z 的範圍，或圖軸性質 Llim, YLim, 和 ZLim 的現有設定，會決定圖軸的範圍（也可以用 axis 指令來設定）。C 的範圍，或圖軸性質 Clim的現有設定，決定了取得色彩對應表中顏色時，使用內插法計算時的上下界。(亦可用 caxis 指令來設定）。
貼片圖形物件的 CData 性質指定了貼片邊上每點的顏色，因而決定了線條的顏色。
瀑布圖雖然看起來像一個網狀曲面，但它是一個貼片圖形物件（patch graphics object）。因此，若要建立一個相似於 waterfall 函式所產生的立體曲面圖，可使用 meshz 函式，並將曲面的 MeshStyle 性質設為 'Row'。有關參數曲面（parametric surfaces）以及相關顏色性質的討論，請見 surf函式的使用。
See Also
axes, axis, caxis, meshz, ribbon, surf
| | warning | wavplay | |