주요 콘텐츠

waterfall

  • Waterfall plot

설명

waterfall(X,Y,Z)y 차원을 따라 부분 커튼이 있는 메시 플롯인 폭포 플롯을 생성합니다. 결과적으로 "폭포" 효과가 나타납니다. 이 함수는 행렬 Z의 값을 XY로 정의된 x-y 평면의 그리드 위 높이로 플로팅합니다. 가장자리 색은 Z로 지정되는 높이에 따라 변합니다.

예제

waterfall(X,Y,Z,C)는 가장자리의 색을 추가로 지정합니다.

예제

waterfall(Z)는 폭포 플롯을 만들고, Z에 있는 요소의 열 인덱스와 행 인덱스를 x 좌표와 y 좌표로 사용합니다.

waterfall(Z,C)는 가장자리의 색을 추가로 지정합니다.

waterfall(___,Name=Value)는 하나 이상의 이름-값 인수를 사용하여 폭포 플롯의 속성을 설정합니다. 예를 들어, 플롯 간선의 색과 두께를 지정할 수 있습니다. 속성 목록은 Patch 속성을 참조하십시오. (R2024b 이후)

waterfall(ax,___)는 현재 좌표축 대신 ax로 지정된 좌표축에 플로팅됩니다. 좌표축을 첫 번째 입력 인수로 지정합니다. 이 인수는 이전 입력 구문 중 하나와 함께 사용할 수 있습니다.

p = waterfall(___)은 patch 객체를 반환합니다. 폭포 플롯을 생성한 후 수정하려면 p를 사용하십시오. 속성 목록은 Patch 속성을 참조하십시오.

예제

예제

모두 축소

동일한 크기의 행렬을 3개 만듭니다. 그런 다음, 이들 행렬을 폭포 플롯으로 플로팅합니다. 메시 플롯은 높이와 색에 모두 Z를 사용합니다.

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

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

4번째 행렬 입력값 C를 포함시켜서 폭포 플롯에 대한 색을 지정합니다. 폭포 플롯은 높이에는 Z, 색에는 C를 사용합니다. 그래프에 컬러바를 추가하여 C의 데이터 값이 컬러맵의 색에 대응되는 방식을 표시합니다.

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

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

폭포 플롯을 생성합니다. 추가적인 수정을 허용하려면 patch 객체를 변수 p에 할당하십시오.

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

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

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';

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

입력 인수를 전치하여 y 차원이 아닌 x 차원을 따라 부분 커튼을 표시합니다.

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

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

입력 인수

모두 축소

x 좌표로, Z와 크기가 동일한 행렬 또는 길이가 n인 벡터로 지정됩니다(여기서 Zm×n 행렬임). XY에 대한 값을 지정하지 않으면 waterfall은 벡터 (1:n)(1:m)을 사용합니다.

patch 객체의 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인 벡터로 지정됩니다(여기서 Zm×n 행렬임). XY에 대한 값을 지정하지 않으면 waterfall은 벡터 (1:n)(1:m)을 사용합니다.

patch 객체의 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에는 적어도 두 개의 행과 두 개의 열이 있어야 합니다.

Z는 각각의 x-y 좌표에서 폭포 플롯의 높이를 지정합니다. 색을 지정하지 않으면 Z가 플롯 가장자리 색도 지정합니다.

patch 객체의 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 행렬로 지정되며, 여기서 Zm×n입니다. 폭포 플롯에 있는 각각의 그리드 점의 경우, C는 컬러맵의 색을 나타냅니다. patch 객체의 CDataMapping 속성은 C의 값이 컬러맵의 색에 대응되는 방식을 제어합니다.

patch 객체의 CData 속성은 색 배열을 저장합니다. 플롯 색 지정을 추가로 제어하려면 FaceColor 속성과 EdgeColor 속성을 사용하십시오.

대상 좌표축으로, Axes 객체로 지정됩니다. 좌표축을 지정하지 않을 경우 waterfall은 현재 좌표축에 플로팅됩니다.

이름-값 인수

모두 축소

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

예: waterfall(peaks,LineStyle="--")은 파선을 사용하여 폭포 플롯을 만듭니다.

참고

여기에 나와 있는 속성은 일부에 불과합니다. 전체 목록을 보려면 Patch 속성 항목을 참조하십시오.

모서리 색으로, 이 표에 있는 값 중 하나로 지정됩니다. 디폴트 모서리 색은 값이 [0 0 0]인 검은색입니다. 여러 다각형에서 모서리를 공유하는 경우 첫 번째로 그린 다각형이 표시되는 모서리 색을 좌우합니다.

설명결과

RGB 3색, 16진수 색 코드 또는 색 이름

모든 모서리에 단일 색. 자세한 내용은 다음 표를 참조하십시오.

Rectangular patch with red edges

'flat'

각 모서리에 서로 다른 색. 꼭짓점 색을 사용하여 꼭짓점을 따르는 모서리 색을 설정합니다. 맨 먼저 CData 또는 FaceVertexCData를 꼭짓점 하나에 색이 하나 있는 배열로 지정해야 합니다. 모서리 색은 꼭짓점을 지정한 순서에 따라 다릅니다.

Rectangular patch with a medium green upper-right vertex, a medium green top edge, a yellow upper-left vertex, a yellow left edge, a dark blue lower-left vertex, a dark blue lower edge, a light blue lower-right vertex, and a light blue right edge

'interp'

보간한 모서리 색. 맨 먼저 CData 또는 FaceVertexCData를 꼭짓점 하나에 색이 하나 있는 배열로 지정해야 합니다. 두 개의 경계 꼭짓점의 값을 선형 보간하여 모서리 색을 결정합니다.

Rectangular patch with interpolated edge colors. The top two vertices are medium green and yellow, respectively. The bottom two vertices are dark blue and light blue, respectively. The color of each edge is a gradient of the colors at the bounding vertices.

'none'모서리가 표시되지 않습니다.

모서리가 표시되지 않습니다.

RGB 3색과 16진수 색 코드는 사용자 지정 색을 지정할 때 유용합니다.

  • RGB 3색은 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색의 농도를 지정합니다. 농도의 범위는 [0,1]이어야 합니다(예: [0.4 0.6 0.7]).

  • 16진수 색 코드는 문자형 벡터 또는 string형 스칼라로, 해시 기호(#)로 시작하고 그 뒤에 3자리 또는 6자리의 16진수 숫자(0에서 F 사이일 수 있음)가 옵니다. 이 값은 대/소문자를 구분하지 않습니다. 따라서 색 코드 "#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

다음 표에는 라이트 테마와 다크 테마에서 플롯의 디폴트 색 팔레트가 나열되어 있습니다.

팔레트팔레트 색

"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진수 색 코드를 가져옵니다.

선 스타일로, 다음 표에 나열된 옵션 중 하나로 지정됩니다.

선 스타일설명결과 선
"-"실선

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픽셀 너비로 표시됩니다.

  • 데이터를 행이 아닌 열로 분석하려면 전치된 인수와 함께 waterfall을 호출하십시오.

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

  • patch 객체 대신 메시의 surface 객체를 만들려면 meshz 함수를 사용하십시오. 폭포 플롯과 유사한 플롯을 만들려면 곡면의 MeshStyle 속성을 'Row'로 설정하십시오.

알고리즘

  • 좌표축의 XLim, YLimZLim 속성은 x축, y축 및 z축 제한을 저장합니다. 이러한 제한은 X, YZ 입력 인수의 범위를 기반으로 합니다.

  • 좌표축의 CLim 속성은 C의 범위에서 색의 분포를 결정합니다. 자세한 내용은 컬러맵 제한 제어하기 항목을 참조하십시오.

확장 기능

모두 확장

버전 내역

R2006a 이전에 개발됨

모두 확장