xline

상수 x 값을 갖는 세로선

구문

xline(x)

xline(x,LineSpec)

xline(x,LineSpec,labels)

xline(___,Name,Value)

xline(ax,___)

xl = xline(___)

설명

xline(x)는 현재 좌표축의 하나 이상의 x 좌표에서 세로선을 만듭니다. 예를 들어, xline(2)는 x=2에 선을 만듭니다.

xline(x,LineSpec)은 선 스타일, 선 색 또는 둘 모두를 지정합니다. 예를 들어, xline([12 20 33],'--b')는 3개의 파란색 파선을 만듭니다.

xline(x,LineSpec,labels)는 선에 레이블을 추가합니다.

xline(___,Name,Value)는 하나 이상의 이름-값 쌍의 인수를 사용하여 상수 선 속성을 지정합니다. 속성 목록은 ConstantLine 속성를 참조하십시오. 다른 모든 입력 인수 다음에 이름-값 쌍을 지정합니다.

xline(ax,___)는 현재 좌표축 대신 지정된 좌표축에 선을 만듭니다.

xl = xline(___)은 ConstantLine 객체를 반환하거나 ConstantLine 객체로 구성된 배열을 반환합니다. 선을 만든 후 xl을 사용하여 속성을 수정하거나 쿼리합니다.

예제

세로선 만들기

x = 3에 세로선을 만듭니다.

xline(3);

레이블 추가하기

레이블이 있는 선을 만들려면 선 스타일도 지정해야 합니다. 디폴트 선 스타일은 실선 '-'입니다.

x = linspace(0,6,100);
y = exp(x);
plot(x,y)
xline(4.5,'-',{'Acceptable','Limit'});

레이블이 있는 여러 선 만들기

정규분포된 난수로 구성된 벡터를 만들고 히스토그램에 표시합니다. 그런 다음, 평균값, 평균값보다 1표준편차 작은 값, 평균값보다 1표준편차 큰 값에 레이블 있는 3개의 세로선을 만듭니다.

data = 5 * randn(1,500) + 20;
histogram(data,'FaceAlpha',0.1,'EdgeAlpha',0.1);
m = mean(data);
s = std(data);
xline([m-s m m+s],'-',{'-1 Standard Dev.','Average','+1 Standard Dev.'})

선 스타일 지정과 색 지정하기

x = 5에 빨간색 파선을 만듭니다.

xline(5,'--r');

범례를 추가하고 레이블 정렬 지정하기

범례를 위해 레이블과 표시 이름이 모두 있는 세로 일점 쇄선을 만듭니다.

y = [3187 2693 1771 1826 1958 3222 1645];
barh(y,'DisplayName','Daily Sales')
xl = xline(2328,'-.','Average','DisplayName','Average Sales');

레이블의 가로 및 세로 정렬을 조정한 다음 범례를 표시합니다.

xl.LabelVerticalAlignment = 'middle';
xl.LabelHorizontalAlignment = 'center';
legend('show');

여러 좌표축에 선 추가하기

tiledlayout 함수를 호출하여 2×1 타일 형식 차트 레이아웃을 만듭니다. nexttile 함수를 호출하여 axes 객체 ax1과 ax2를 만듭니다. 그런 다음, 각 좌표축에 플로팅합니다. xline 함수에 좌표축을 전달하여 각 플롯에 점선으로 된 세로선과 레이블을 추가합니다.

tiledlayout(2,1)
ax1 =nexttile;
x = linspace(0,10,200);
y1 = cos(x); 
plot(ax1,x,y1)

ax2 = nexttile;
y2 = sin(x); 
plot(ax2,x,y2)

xline(ax1,pi/2,':','cos(\pi/2)=0');
xline(ax2,pi,':','sin(\pi)=0');

입력 인수

x — x 좌표

스칼라 | 벡터

x 좌표로, 숫자형, categorical형, datetime형 또는 duration형 값을 포함하는 스칼라 또는 벡터로 지정됩니다. x의 데이터형은 x축의 데이터형과 일치해야 합니다.

예: xline(10)은 x=10에 선을 표시합니다.

예: xline([13 20 33])은 x=13, x=20, x=33에 선을 표시합니다.

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

LineSpec — 선 스타일과 색

문자형 벡터 | string형 스칼라

선 스타일과 색으로, 문자와 기호를 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다. 문자와 기호는 어떤 순서로든 표시할 수 있습니다. 선 스타일, 선 색 또는 둘 다 지정할 수 있습니다. 'o'와 같은 마커 기호는 무시됩니다.

예: '--g'는 녹색 파선입니다.

선 스타일	설명	결과 선
"-"	실선
"--"	파선
":"	점선
"-."	일점 쇄선

색 이름	짧은 이름	모양
'red'	'r'
'green'	'g'
'blue'	'b'
'cyan'	'c'
'magenta'	'm'
'yellow'	'y'
'black'	'k'
'white'	'w'

ax — 대상 좌표축

Axes 객체

대상 좌표축으로, Axes 객체로 지정됩니다. xline을 현재 좌표축 이외의 좌표축에 플로팅하려면 이 인수를 사용하십시오.

labels — 선 레이블

'' (디폴트 값) | 문자형 벡터 | string형 스칼라 | 문자형 벡터로 구성된 셀형 배열 | string형 배열

선 레이블로, 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다.

선 하나에 대한 레이블 생성

한 줄로 된 텍스트를 표시하려면 문자형 벡터 또는 string형 스칼라를 지정합니다. 여러 줄로 된 텍스트를 표시하려면 문자형 벡터로 구성된 셀형 배열 또는 string형 배열을 지정하십시오.

표시 방법	labels를 지정하는 방법	예
한 줄로 된 텍스트	문자형 벡터 또는 string형 스칼라를 지정합니다.	xline(12,'-','Sample')
여러 줄로 된 텍스트	문자형 벡터로 구성된 셀형 배열 또는 string형 배열을 지정합니다. 배열의 각 요소가 별도의 줄에 있는 텍스트가 됩니다.	xline(12,'-',{'Sample','x=12'})

여러 선에 대한 레이블 생성

모든 선 옆에 동일한 레이블을 표시하려면 문자형 벡터 또는 string형 스칼라를 지정합니다. 각 선마다 서로 다른 레이블을 표시하려면 문자형 벡터로 구성된 셀형 배열 또는 string형 배열을 지정합니다.

표시 방법	labels를 지정하는 방법	예
하나의 공유 텍스트 레이블	문자형 벡터 또는 string형 스칼라를 지정합니다.	xline([13 20 33],'-','Sample')
각 선마다 다른 레이블	문자형 벡터로 구성된 셀형 배열 또는 string형 배열을 지정합니다. 배열의 각 요소는 서로 다른 선의 레이블이 됩니다. labels 배열의 요소 개수는 x의 길이와 일치해야 합니다.	label = {'Sample 1','Sample 2','Sample 3'}; xline([13 20 33],'-',label)
여러 개의 레이블 중 일부가 여러 줄로 된 레이블	문자형 벡터로 구성된 셀형 배열 또는 string형 배열을 만듭니다. 텍스트에 새 줄 문자('\n')를 삽입하려면 sprintf 함수를 사용합니다.	label = {'Sample 1',sprintf('Sample 2\nx=20'),'Sample 3'}; xline([13 20 33],'-',label)

이름-값 인수

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

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: xline(5,'LabelVerticalAlignment','middle')은 레이블의 세로 정렬을 'middle'로 지정합니다.

참고

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

Color — 선 색

[0.15 0.15 0.15] (디폴트 값) | RGB 3색 | 16진수 색 코드 | 'r' | 'g' | 'b' | ...

선 색으로, RGB 3색, 16진수 색 코드, 색 이름 또는 짧은 이름으로 지정됩니다.

사용자 지정 색의 경우에는 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"
"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"
"none"	해당 없음	해당 없음	해당 없음	색 없음

다음은 MATLAB^®이 여러 유형의 플롯에서 사용하는 디폴트 색의 RGB 3색과 16진수 색 코드입니다.

RGB 3색	16진수 색 코드	모양
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

예: 'g'

예: [0.6 0.2 0.5]

예: '#D2F9A7'

LineWidth — 선 너비

0.5 (디폴트 값) | 양의 값

선 너비로, 양의 값으로 지정됩니다(단위: 포인트).

DisplayName — 범례 레이블

'' (디폴트 값) | 문자형 벡터 | string형 스칼라

범례 레이블로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 범례는 legend 명령을 호출할 때까지 표시되지 않습니다. 텍스트를 지정하지 않으면 legend는 'dataN' 형식을 사용하여 레이블을 설정합니다.

LabelHorizontalAlignment — 레이블의 가로 정렬

'right' (디폴트 값) | 'left' | 'center'

선을 기준으로 한 레이블의 가로 정렬로, 다음 표의 옵션 중 하나로 지정됩니다.

옵션	설명	예
'right'	선의 오른쪽입니다.
'left'	선의 왼쪽입니다.
'center'	선의 가운데입니다. 레이블이 선을 잘라냅니다.

LabelVerticalAlignment — 레이블의 세로 정렬

'top' (디폴트 값) | 'middle' | 'bottom'

선을 기준으로 한 레이블의 세로 정렬로, 다음 표의 옵션 중 하나로 지정됩니다.

옵션	설명	예
'top'	선의 위쪽
'middle'	선의 중간
'bottom'	선의 아래쪽

LabelOrientation — 레이블 방향

'aligned' (디폴트 값) | 'horizontal'

레이블 방향으로, 'aligned' 또는 'horizontal'로 지정됩니다. 예가 표에 나와 있습니다.

방향	설명	예
'aligned'	레이블의 방향이 선과 동일합니다.
'horizontal'	선 방향에 관계없이 레이블이 가로 방향입니다.

알고리즘

좌표축의 3차원 보기에서는 y축 제한의 중간점에 있는 x-y 평면에 상수 선이 나타납니다. 좌표축이 회전하면 상수 선도 함께 회전합니다.

버전 내역

R2018b에 개발됨

참고 항목

함수

• yline | xregion | yregion

속성

• ConstantLine 속성