Main Content

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(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: [21x26 double]
     Vertices: [546x3 double]

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

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

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

  • 데이터를 행이 아닌 열로 분석하려면 전치된 인수와 함께 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 이전에 개발됨