도움말 센터 도움말 센터

clabel

등고선 플롯 고도(Elevation)에 레이블 지정

페이지 내 모두 축소

구문

clabel(C,h)

clabel(C,h,v)

clabel(C,h,'manual')

t = clabel(C,h,'manual')

clabel(C)

clabel(C,v)

clabel(C,'manual')

tl = clabel(___)

clabel(___,Name,Value)

설명

clabel(C,h)는 현재 등고선 플롯의 각 등고선에 기울어진 텍스트를 삽입하여 레이블로 지정합니다. 등고선은 레이블에 맞게 충분히 길어야 합니다. 그렇지 않으면 clabel은 레이블을 삽입하지 않습니다. 등고선 행렬 C가 없는 경우에는 C를 []로 바꾸십시오.

clabel(C,h,v)는 벡터 v로 지정된 등고선 레벨에 레이블을 지정합니다.

clabel(C,h,'manual')은 마우스로 선택한 위치에 레이블을 지정합니다. 마우스를 클릭하거나 스페이스바를 눌러 십자 기호의 중심과 가장 가까운 등고선에 레이블을 지정합니다. 커서가 Figure 창 내부에 있는 동안 Return 키를 눌러 레이블 지정을 종료합니다.

t = clabel(C,h,'manual')은 생성된 text 객체를 반환합니다.

clabel(C)는 등고선에 '+' 기호와 직립 텍스트를 레이블로 지정합니다.

clabel(C,v)는 벡터 v로 지정된 등고선 레벨에 직립 레이블을 추가합니다.

clabel(C,'manual')은 마우스로 선택한 위치에 직립 레이블을 추가합니다. 마우스를 클릭하거나 스페이스바를 눌러 십자 기호의 중심과 가장 가까운 등고선에 레이블을 지정합니다. 커서가 Figure 창 내부에 있는 동안 Return 키를 눌러 레이블 지정을 종료합니다.

tl = clabel(___)은 생성된 text 객체와 line 객체를 반환합니다. 위에 열거된 구문 중 contour 객체 h가 포함되지 않은 구문의 입력값 조합을 사용하십시오.

clabel(___,Name,Value)는 Name,Value 쌍의 인수를 하나 이상 사용하여 레이블 모양을 수정합니다. 위에 열거된 구문의 입력 인수 조합을 사용하십시오. 예를 들어, 'FontSize',14는 글꼴 크기를 14포인트로 설정합니다.

예제

등고선 플롯 레벨에 레이블 지정하기

라이브 스크립트 열기

등고선 플롯을 만들고 등고선 행렬 C와 contour 객체 h를 가져옵니다. 그런 다음 등고선 플롯에 레이블을 지정합니다.

[x,y,z] = peaks;
[C,h] = contour(x,y,z);   
clabel(C,h)

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

특정 등고선 레벨에 레이블 지정

라이브 스크립트 열기

등고선 레벨이 2 또는 6인 등고선에만 레이블을 지정합니다.

[x,y,z] = peaks;
[C,h] = contour(x,y,z);
v = [2,6];
clabel(C,h,v)

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

등고선 레이블 속성 설정하기

라이브 스크립트 열기

Name,Value 쌍의 인수를 사용하여 레이블의 글꼴 크기를 15포인트로 설정하고 색을 빨간색으로 설정합니다.

[x,y,z] = peaks;
[C,h] = contour(x,y,z);
clabel(C,h,'FontSize',15,'Color','red')

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

clabel 명령을 다시 실행하여 추가 속성을 설정합니다. 예를 들어, 글꼴 두께를 굵게 설정하고 색을 파란색으로 변경합니다.

clabel(C,h,'FontWeight','bold','Color','blue')

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

'default' 키워드를 사용하여 글꼴 크기를 다시 디폴트 크기로 설정합니다.

clabel(C,h,'FontSize','default')

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

등고선 플롯에 세로 방향 텍스트를 레이블로 지정

라이브 스크립트 열기

등고선 플롯을 만들고 등고선 행렬 C를 반환합니다. 그런 다음 등고선에 레이블을 지정합니다.

[x,y,z] = peaks;
C = contour(x,y,z);  
clabel(C)

Figure contains an axes object. The axes object contains 25 objects of type contour, line, text.

입력 인수

`C` — 등고선 행렬
2행 행렬

contour, contour3, contourf 함수 중 하나가 반환하는 등고선 행렬입니다. C는 등고선을 정의하는 데이터를 포함합니다. 등고선 행렬에 대한 자세한 내용은 ContourMatrix 항목을 참조하십시오.

참고

contour 객체 h를 clabel 함수에 전달할 경우 C를 []로 바꿀 수 있습니다. 예를 들어, clabel([],h)를 사용합니다.

`h` — contour 객체
contour 객체

contour, contour3, contourf 함수 중 하나가 반환하는 contour 객체입니다.

`v` — 등고선 레벨 값
벡터

등고선 레벨 값으로, 개별 값으로 구성된 행 벡터 또는 열 벡터로 지정됩니다.

예: [0 10 20]

이름-값 인수

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

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

예: clabel(C,h,'Color','red','FontSize',12)는 12포인트 크기의 빨간색 레이블을 지정합니다.

clabel은 LabelSpacing 속성 및 일부 text 속성을 지원합니다.

`LabelSpacing` — 레이블 사이의 간격
스칼라

레이블 사이의 간격으로, 스칼라 값으로 지정됩니다(단위: 포인트).

참고

clabel(C,h) 구문이나 clabel(C,h,v) 구문에만 이 옵션을 사용하십시오. 다른 구문에는 이 옵션을 사용할 수 없습니다.

예: clabel(C,h,'LabelSpacing',100)

`Color` — 텍스트 색
`[0 0 0]` (디폴트 값) | RGB 3색 | 16진수 색 코드 | `'r'` | `'g'` | `'b'` | ...

텍스트 색으로, RGB 3색, 16진수 색 코드, 색 이름 또는 짧은 이름으로 지정됩니다. 디폴트 값인 [0 0 0]은 검은색에 해당합니다.

사용자 지정 색의 경우에는 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"`

예: 'blue'

예: [0 0 1]

예: '#0000FF'

`EdgeColor` — 텍스트 상자 윤곽선의 색
`'none'` (디폴트 값) | RGB 3색 | 16진수 색 코드 | `'r'` | `'g'` | `'b'` | ...

텍스트 상자 윤곽선의 색으로, 'none', 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"`

예: clabel(C,h,'EdgeColor','k')

`BackgroundColor` — 배경색
`'none'` (디폴트 값) | RGB 3색 | 16진수 색 코드 | `'r'` | `'g'` | `'b'` | ...

텍스트 상자 배경색으로, 'none', 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"`

예: clabel(C,h,'BackgroundColor','g')

`FontSize` — 글꼴 크기
`10` (디폴트 값) | 0보다 큰 스칼라 값

글꼴 크기로, 0보다 큰 스칼라 값으로 지정됩니다. 기본적으로, 글꼴 크기의 단위는 포인트입니다. 1포인트는 1/72인치와 같습니다. 그러나 일부 구문에서는 FontUnits 속성을 사용하여 글꼴 단위를 변경할 수 있습니다.

예: clabel(C,h,'FontSize',15)

`FontName` — 글꼴 이름
지원되는 글꼴 이름 | `"FixedWidth"`

글꼴 이름으로, 지원되는 글꼴 이름 또는 "FixedWidth"로 지정됩니다. 텍스트를 정상적으로 표시하고 인쇄하려면 사용자의 시스템에서 지원하는 글꼴을 선택해야 합니다. 디폴트 글꼴은 운영 체제와 로캘에 따라 다릅니다.

모든 로캘에서 미려하게 표시되는 고정 너비 글꼴을 사용하려면 "FixedWidth"를 사용하십시오. 고정 너비 글꼴은 루트 FixedWidthFontName 속성에 따라 달라집니다. 루트 FixedWidthFontName 속성을 설정하면 새 글꼴을 사용하도록 디스플레이가 즉시 업데이트됩니다.

`FontAngle` — 문자 기울기
`'normal'` (디폴트 값) | `'italic'`

문자 기울기로, 'normal'이나 'italic'으로 지정됩니다.

모든 글꼴에 두 글꼴 스타일이 모두 있는 것은 아닙니다. 따라서 기울임꼴이 보통 글꼴과 같게 보일 수 있습니다.

`FontWeight` — 문자 두께
`'normal'` (디폴트 값) | `'bold'`

문자 두께로, 'normal' 또는 'bold'로 지정됩니다.

MATLAB은 FontWeight 속성을 사용하여 사용자의 시스템에서 사용 가능한 글꼴 중 하나를 선택합니다. 모든 글꼴에 굵은 두께가 있는 것은 아닙니다. 따라서 굵은 글꼴 두께를 지정해도 보통 글꼴 두께로 보일 수 있습니다.

`FontSmoothing` — 글꼴 다듬기
`'on'` (디폴트 값) | on/off 논리값

글꼴 다듬기로, 'on' 또는 'off'나 숫자형 값 또는 논리값 1(true) 또는 0(false)으로 지정됩니다. 값 'on'은 true와 동일하고 값 'off'는 false와 동일합니다. 따라서 이 속성의 값을 논리값으로 사용할 수 있습니다. 값은 matlab.lang.OnOffSwitchState 유형의 on/off 논리값으로 저장됩니다.

'on' — 글꼴 다듬기가 적용됩니다. 텍스트 문자의 들쑥날쑥한 모양을 줄여 텍스트를 더 읽기 쉽게 만듭니다.
'off' — 글꼴 다듬기가 적용되지 않습니다.

예: clabel(C,h,'FontSmoothing','on')

참고

FontSmoothing 이름-값 인수는 향후 릴리스에서 아무런 영향을 미치지 않습니다. 값에 관계없이 글꼴 다듬기가 활성화됩니다.

`FontUnits` — 글꼴 크기의 단위
`'points'` (디폴트 값) | `'inches'` | `'centimeters'` | `'characters'` | `'normalized'` | `'pixels'`

글꼴 크기의 단위로, 다음 표에 있는 값 중 하나로 지정됩니다.

`Units`	설명
`'points'`	포인트. 1포인트는 1/72인치와 같습니다.
`'inches'`	인치.
`'centimeters'`	센티미터.
`'characters'`	디폴트 시스템 글꼴의 문자 크기를 기반으로 합니다. 문자 너비 = 문자 `x`의 너비. 문자 높이 = 텍스트의 두 줄의 기준선 간 거리.
`'normalized'`	글꼴 크기를 좌표축 높이에 대한 비율로 해석합니다. 좌표축 크기를 조정하면 글꼴 크기가 그에 따라 수정됩니다. 예를 들어, `FontSize`가 `0.1`(정규화된 단위)이면 텍스트는 좌표축 높이의 1/10입니다.
`'pixels'`	픽셀. R2015b부터, 픽셀 단위의 거리는 Windows^®와 Macintosh 시스템에서 시스템 해상도와 무관하게 적용됩니다. 즉, 다음과 같습니다. Windows 시스템에서 1픽셀은 1/96인치입니다. Macintosh 시스템에서 1픽셀은 1/72인치입니다. Linux^® 시스템에서 픽셀 크기는 시스템 해상도에 의해 결정됩니다.

단일 함수 호출에서 글꼴 크기와 글꼴 단위를 모두 설정할 경우 좌표축이 지정된 글꼴 크기를 올바르게 해석하도록 FontUnits 속성을 먼저 설정해야 합니다.

참고

clabel(C,h) 구문과 clabel(C,h,v) 구문은 이 옵션을 지원하지 않습니다. 이 구문들은 디폴트 값인 points를 사용합니다.

예: clabel(C,'FontUnits','normalized')

`Rotation` — 텍스트 방향
`0` (디폴트 값) | 스칼라

텍스트 방향으로, 스칼라 값(단위: 도)으로 지정됩니다. 디폴트 회전값 0도는 텍스트를 가로 방향으로 놓습니다. 세로 방향 텍스트를 만들려면 이 속성을 90도나 -90도로 설정하십시오. 양의 값은 텍스트를 시계 반대 방향으로 회전시킵니다. 음의 값은 텍스트를 시계 방향으로 회전시킵니다.

참고

clabel(C,h) 구문과 clabel(C,h,v) 구문은 이 옵션을 지원하지 않습니다. 대신, 이 구문들은 각 등고선의 기울기 방향에 맞춰 기울어진 텍스트를 삽입합니다.

예: clabel(C,'Rotation',90)

`Interpreter` — 텍스트 문자의 해석 방식
`'tex'` (디폴트 값) | `'latex'` | `'none'`

텍스트 문자의 해석 방식으로, 다음 값 중 하나로 지정됩니다.

'tex' — TeX 마크업을 사용하여 텍스트를 표시합니다.
'latex' — LaTeX 마크업을 사용하여 텍스트를 표시합니다.
'none' — 리터럴 문자를 표시합니다.

레이블이 숫자형 텍스트이므로 이 속성의 효과는 글꼴 스타일과 두께의 미묘한 변화로 제한됩니다.

예: clabel(C,h,'Interpreter','latex')

`LineStyle` — 텍스트 상자 윤곽선의 선 스타일
`'-'` (디폴트 값) | `'--'` | `':'` | `'-.'` | `'none'`

텍스트 상자 윤곽선의 선 스타일로, 다음 표에 있는 선 스타일 중 하나로 지정됩니다.

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

예: clabel(C,h,'LineStyle','--')

`LineWidth` — 텍스트 상자 윤곽선의 너비
`0.5` (디폴트 값) | 스칼라

텍스트 상자 윤곽선의 너비로, 스칼라 값(단위: 포인트)으로 지정됩니다. 1포인트는 1/72인치와 같습니다.

예: clabel(C,h,'LineWidth',1)

`Margin` — 텍스트 상자 내에 있는 텍스트 주위의 여백
`3` (디폴트 값) | 스칼라

텍스트 상자 내에 있는 텍스트 주위의 여백으로, 스칼라 값(단위: 포인트)으로 지정됩니다.

MATLAB은 Extent 속성값과 Margin 속성값을 사용하여 텍스트 상자의 크기를 결정합니다.

예: clabel(C,h,'Margin',4)

출력 인수

`t` — text 객체
벡터

text 객체로, 벡터로 반환됩니다. text 객체의 String 속성은 표시되는 등고선 값을 포함합니다.

`tl` — text 및 line 객체
벡터

text 및 line 객체로, 벡터로 반환됩니다. text 객체의 String 속성은 표시되는 등고선 값을 포함합니다. line 객체는 '+' 기호에 대응합니다.

확장 기능

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

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

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

자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

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

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

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

자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

R2023b: `Color` 이름-값 인수를 설정하면 `Contour` 객체의 `LabelColor`도 설정됨

clabel 함수를 호출할 때 Color 이름-값 인수를 설정하면 Contour 객체의 LabelColor 속성이 지정된 색 값으로 업데이트됩니다.

R2022a: `FontSmoothing`은 향후 릴리스에서 아무런 영향을 미치지 않음

FontSmoothing 이름-값 인수는 향후 릴리스에서 아무런 영향을 미치지 않습니다. 인수 값에 관계없이 모든 등고선 레이블에 글꼴 다듬기가 활성화됩니다.

참고 항목

함수

contour | contourc | contourf | contour3

속성

Text 속성