이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

stairs

계단 그래프

구문

stairs(Y)

stairs(X,Y)

stairs(___,LineSpec)

stairs(___,Name,Value)

stairs(ax,___)

h = stairs(___)

[xb,yb] = stairs(___)

설명

stairs(Y)는 Y의 요소에 대한 계단 그래프를 그립니다.

• Y가 벡터이면 stairs는 선을 하나 그립니다.

• Y가 행렬이면 stairs는 행렬 열 당 선을 하나 그립니다.

stairs(X,Y)는 X에서 지정한 위치에서 Y의 요소를 플로팅합니다. 입력 인수 X와 Y는 동일한 크기의 벡터 또는 행렬이어야 합니다. 또한, X는 행 벡터이거나 열 벡터일 수 있으며 Y는 length(X)개의 행을 갖는 행렬이어야 합니다.

stairs(___,LineSpec)은 선 스타일, 마커 기호, 색을 지정합니다. 예를 들어, ':*r'은 별표 마커와 함께 빨간색 점선을 지정합니다. 위에 열거된 구문에 나와 있는 입력 인수를 조합하여 이 옵션과 함께 사용하십시오.

stairs(___,Name,Value)는 하나 이상의 이름-값 쌍 인수를 사용하여 계단 차트를 수정합니다. 예를 들어, 'Marker','o','MarkerSize',8은 8포인트 크기의 원 마커를 지정합니다.

stairs(ax,___)는 현재 좌표축(gca) 대신 ax로 지정된 좌표축에 플로팅됩니다. 옵션 ax는 위에 열거된 구문의 입력 인수 조합보다 먼저 나올 수 있습니다.

h = stairs(___)는 하나 이상의 Stair 객체를 반환합니다. h를 사용하여 특정 Stair 객체가 만들어진 후 이 객체의 속성을 변경합니다.

[xb,yb] = stairs(___)는 플롯을 만들지 않지만, plot(xb,yb)가 계단 그래프를 플로팅할 수 있는 같은 크기의 행렬 xb와 행렬 yb를 반환합니다.

예제

단일 데이터 계열 플로팅하기

0과 사이의 40개의 균등 간격 값에서 계산된 사인의 계단 플롯을 만듭니다.

X = linspace(0,4*pi,40);
Y = sin(X);

figure
stairs(Y)

Y의 길이에 따라 x축 스케일이 자동으로 결정되고 생성됩니다.

여러 데이터 계열 플로팅하기

0과 사이의 50개의 균등 간격 값에서 계산된 코사인 2개의 계단 플롯을 만듭니다.

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];

figure
stairs(Y)

Y의 행 개수에 따라 x축 스케일이 자동으로 결정되고 생성됩니다.

지정된 x 값에서 단일 데이터 계열을 플로팅하기

0과 사이의 균등 간격 값에서 계산된 사인파의 계단 플롯을 만듭니다. 플롯에 대한 x 값들의 집합을 지정합니다.

X = linspace(0,4*pi,40);
Y = sin(X);

figure
stairs(X,Y)

Y의 요소는 X의 대응하는 요소에 대해 플로팅됩니다.

지정된 x 값에서 여러 데이터 계열을 플로팅하기

0과 사이의 균등 간격 값에서 계산된 코사인파 2개의 계단 플롯을 만듭니다. 플롯에 대한 x 값들의 집합을 지정합니다.

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];

figure
stairs(X,Y)

첫 번째 벡터 입력값 X에 따라 두 데이터 계열 모두에 대한 x축 위치가 결정됩니다.

고유한 x 값들의 집합에서 여러 데이터 계열을 플로팅하기

다른 값에서 계산된 사인파 2개의 계단 플롯을 만듭니다. 각 데이터 계열을 플로팅할 고유한 x 값들의 집합을 지정합니다.

x1 = linspace(0,2*pi)';
x2 = linspace(0,pi)';
X = [x1,x2];
Y = [sin(5*x1),exp(x2).*sin(5*x2)];

figure
stairs(X,Y)

X의 각 열이 Y의 대응하는 열에 대해 플로팅됩니다.

선 스타일, 마커 기호, 색 지정하기

계단 플롯을 만들고 선 스타일을 일점 쇄선으로, 마커 기호를 원으로, 색을 빨간색으로 설정합니다.

X = linspace(0,4*pi,20);
Y = sin(X);

figure
stairs(Y, '-.or')

추가 스타일 옵션 지정하기

계단 플롯을 만들고 Name,Value 쌍 인수를 사용하여 선 너비를 2로, 마커 기호를 다이아몬드로, 마커 면 색을 녹청색으로 각각 설정합니다.

X = linspace(0,4*pi,20);
Y = sin(X);

figure
stairs(Y,'LineWidth',2,'Marker','d','MarkerFaceColor','c')

계단 플롯의 좌표축 지정하기

2개의 서브플롯이 있는 Figure를 만들고 2개의 axes 핸들 s(1)과 s(2)를 반환합니다. 좌표축 핸들을 참조하여 각 서브플롯에 계단 플롯을 만듭니다.

figure
s(1) = subplot(2,1,1);
s(2) = subplot(2,1,2);  

X = linspace(0,2*pi);
Y1 = 5*sin(X);
Y2 = sin(5*X);
stairs(s(1),X,Y1)
stairs(s(2),X,Y2)

계단 플롯 생성 후 수정하기

2개의 데이터 계열로 구성된 계단 플롯을 만들고 두 개의 stair 객체를 반환합니다.

X = linspace(0,1,30)';
Y = [cos(10*X), exp(X).*sin(10*X)];
h = stairs(X,Y);

첫 번째 데이터 계열에 작은 원 마커를 사용합니다. 두 번째 계열에 자홍색으로 채워진 원을 사용합니다. R2014b부터는 점 표기법을 사용하여 속성을 설정할 수 있습니다. 이전 릴리스를 사용 중인 경우에는 set 함수를 대신 사용하십시오.

h(1).Marker = 'o';
h(1).MarkerSize = 4;
h(2).Marker = 'o';
h(2).MarkerFaceColor = 'm';

plot 함수를 사용하여 계단 플롯 만들기

0과 사이의 50개의 균등 간격 값에서 두 개의 코사인 함수를 계산하고 plot을 사용하여 계단 플롯을 만듭니다.

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];
[xb,yb] = stairs(X,Y);

stairs는 같은 크기의 행렬 2개, xb와 yb를 반환하지만, 플롯은 반환하지 않습니다.

plot을 사용하여 xb와 yb 행렬로 계단 플롯을 만듭니다.

figure
plot(xb,yb)

입력 인수

Y — y 값

벡터 또는 행렬

y 값으로, 벡터나 행렬로 지정됩니다. Y가 벡터이면 stairs은 계단 객체 하나를 만듭니다. Y가 행렬이면 stairs는 행렬 열 당 선을 하나씩 그리고 각 열에 대한 개별 계단 객체를 만듭니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

X — x 값

벡터 또는 행렬

x 값으로, 벡터나 행렬로 지정됩니다. Y가 벡터인 경우 X는 동일한 크기의 벡터여야 합니다. Y가 행렬인 경우 X는 동일한 크기의 행렬이거나, Y의 행 개수와 길이가 같은 벡터여야 합니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

LineSpec — 선 스타일, 마커 기호 및 색

문자형 벡터 | string형

선 스타일, 마커 기호, 색으로, 문자형 벡터 또는 string형으로 지정됩니다. 선 스타일, 마커 기호, 색 옵션에 대한 자세한 내용은 LineSpec을 참조하십시오.

예: ':*r'

ax — Axes 객체

Axes 객체

Axes 객체. 좌표축을 지정하지 않을 경우 stairs는 현재 좌표축에 플로팅됩니다.

이름-값 쌍의 인수

선택적으로 Name,Value 인수가 쉼표로 구분되어 지정됩니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. Name은 따옴표 안에 표시해야 합니다. Name1,Value1,...,NameN,ValueN과 같이 여러 개의 이름-값 쌍의 인수를 어떤 순서로든 지정할 수 있습니다.

예: 'Marker','s','MarkerFaceColor','red'는 빨간색 사각 마커와 함께 계단 그래프를 플로팅합니다.

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

'LineStyle' — 선 스타일

'-' (디폴트 값) | '--' | ':' | '-.' | 'none'

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

선 스타일	설명	결과 선
'-'	실선
'--'	파선
':'	점선
'-.'	일점 쇄선
'none'	선 없음	선 없음

'LineWidth' — 선 너비

0.5 (디폴트 값) | 양의 값

선 너비로, 양의 값으로 지정됩니다(단위: 포인트). 선에 마커가 있는 경우 선 너비는 마커 가장자리에도 영향을 미칩니다.

예: 0.75

'Color' — 선 색

[0 0.4470 0.7410] (디폴트 값) | RGB 3색 | 'r' | 'g' | 'b' | ...

선 색으로, RGB 3색이나 표에 나열된 색 옵션 중 하나로 지정됩니다.

사용자 지정 색의 경우에는 RGB 3색을 지정하십시오. RGB 3색은 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색의 농도를 지정합니다. 농도의 범위는 [0,1]이어야 합니다(예: [0.4 0.6 0.7]). 몇몇의 흔한 색은 이름으로 지정할 수도 있습니다. 다음 표에는 색의 긴 이름과 짧은 이름 옵션, 그리고 각각에 대응하는 RGB 3색 값이 나열되어 있습니다.

옵션	설명	대응하는 RGB 3색
'red' 또는 'r'	빨간색	[1 0 0]
'green' 또는 'g'	녹색	[0 1 0]
'blue' 또는 'b'	파란색	[0 0 1]
'yellow' 또는 'y'	노란색	[1 1 0]
'magenta' 또는 'm'	자홍색	[1 0 1]
'cyan' 또는 'c'	녹청색	[0 1 1]
'white' 또는 'w'	흰색	[1 1 1]
'black' 또는 'k'	검은색	[0 0 0]
'none'	색 없음	해당 없음

예: 'blue'

예: [0 0 1]

'Marker' — 마커 기호

'none' (디폴트 값) | 'o' | '+' | '*' | '.' | ...

마커 기호로, 다음 표에 나열된 값 중 하나로 지정됩니다. 기본적으로 객체는 마커를 표시하지 않습니다. 마커 기호를 지정하면 각 데이터 점이나 꼭짓점에 마커가 추가됩니다.

값	설명
'o'	원
'+'	플러스 기호
'*'	별표
'.'	점
'x'	십자
'square' 또는 's'	정사각형
'diamond' 또는 'd'	다이아몬드
'^'	위쪽 방향 삼각형
'v'	아래쪽 방향 삼각형
'>'	오른쪽 방향 삼각형
'<'	왼쪽 방향 삼각형
'pentagram' 또는 'p'	오각별(펜타그램)
'hexagram' 또는 'h'	육각별(헥사그램)
'none'	마커 없음

'MarkerSize' — 마커 크기

6 (디폴트 값) | 양의 값

마커 크기로, 양의 값으로 지정됩니다(단위: 포인트).

예: 10

'MarkerEdgeColor' — 마커 윤곽선 색

'auto' (디폴트 값) | RGB 3색 | 'r' | 'g' | 'b' | ...

마커 윤곽선 색으로, 'auto', RGB 3색 또는 표에 나열된 색 옵션 중 하나로 지정됩니다. 디폴트 값인 'auto'는 Color 속성과 동일한 색을 사용합니다.

사용자 지정 색의 경우에는 RGB 3색을 지정하십시오. RGB 3색은 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색의 농도를 지정합니다. 농도의 범위는 [0,1]이어야 합니다(예: [0.4 0.6 0.7]). 몇몇의 흔한 색은 이름으로 지정할 수도 있습니다. 다음 표에는 색의 긴 이름과 짧은 이름 옵션, 그리고 각각에 대응하는 RGB 3색 값이 나열되어 있습니다.

옵션	설명	대응하는 RGB 3색
'red' 또는 'r'	빨간색	[1 0 0]
'green' 또는 'g'	녹색	[0 1 0]
'blue' 또는 'b'	파란색	[0 0 1]
'yellow' 또는 'y'	노란색	[1 1 0]
'magenta' 또는 'm'	자홍색	[1 0 1]
'cyan' 또는 'c'	녹청색	[0 1 1]
'white' 또는 'w'	흰색	[1 1 1]
'black' 또는 'k'	검은색	[0 0 0]
'none'	색 없음	해당 없음

예: [0.5 0.5 0.5]

예: 'blue'

'MarkerFaceColor' — 마커 채우기 색

'none' (디폴트 값) | 'auto' | RGB 3색 | 'r' | 'g' | 'b' | ...

마커 채우기 색으로, 'auto', RGB 3색 또는 표에 나열된 색 옵션 중 하나로 지정됩니다. 'auto' 값은 좌표축의 Color 속성과 동일한 색을 사용합니다.

사용자 지정 색의 경우에는 RGB 3색을 지정하십시오. RGB 3색은 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색의 농도를 지정합니다. 농도의 범위는 [0,1]이어야 합니다(예: [0.4 0.6 0.7]). 몇몇의 흔한 색은 이름으로 지정할 수도 있습니다. 다음 표에는 색의 긴 이름과 짧은 이름 옵션, 그리고 각각에 대응하는 RGB 3색 값이 나열되어 있습니다.

옵션	설명	대응하는 RGB 3색
'red' 또는 'r'	빨간색	[1 0 0]
'green' 또는 'g'	녹색	[0 1 0]
'blue' 또는 'b'	파란색	[0 0 1]
'yellow' 또는 'y'	노란색	[1 1 0]
'magenta' 또는 'm'	자홍색	[1 0 1]
'cyan' 또는 'c'	녹청색	[0 1 1]
'white' 또는 'w'	흰색	[1 1 1]
'black' 또는 'k'	검은색	[0 0 0]
'none'	색 없음	해당 없음

예: [0.3 0.2 0.1]

예: 'green'

출력 인수

h — Stair 객체

Stair 객체

Stair 객체. 이는 고유 식별자로, 특정 Stair 객체가 생성된 후에 그 객체의 속성을 쿼리하고 수정하는 데 사용할 수 있습니다.

xb — plot에서 사용할 x 값

벡터 또는 행렬

plot에서 사용할 x 값으로, 벡터나 행렬로 반환됩니다. xb는 plot(xb,yb)가 계단 그래프를 만들 수 있도록 하는 적당한 값을 포함합니다.

yb — plot에서 사용할 y 값

벡터 또는 행렬

plot에서 사용할 y 값으로, 벡터나 행렬로 반환됩니다. yb는 plot(xb,yb)가 계단 그래프를 만들 수 있도록 하는 적당한 값을 포함합니다.

확장 기능

GPU 배열

Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 이 함수는 GPU 배열을 받지만 GPU에서 실행되지는 않습니다.

자세한 내용은 Run MATLAB Functions on a GPU (Parallel Computing Toolbox) 항목을 참조하십시오.

분산 배열

Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 이 함수는 분산 배열에 대해 연산을 수행하지만 클라이언트 측의 MATLAB^®에서 실행됩니다.

자세한 내용은 Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox) 항목을 참조하십시오.

참고 항목

함수

• LineSpec | bar | histogram | stem

속성

• Stair Properties

도움말 항목

• 날짜와 기간 플로팅하기
• categorical형 데이터 플로팅하기

R2006a 이전에 개발됨