이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

legend

좌표축에 범례 추가

구문

legend

legend(label1,...,labelN)

legend(labels)

legend(subset,___)

legend(target,___)

legend(___,'Location',lcn)

legend(___,'Orientation',ornt)

legend(___,Name,Value)

legend(bkgd)

lgd = legend(___)

legend(vsbl)

legend('off')

설명

legend는 플로팅된 각 데이터 계열에 대한 설명 레이블을 포함한 범례를 만듭니다. 레이블의 경우 범례는 데이터 계열의 DisplayName 속성에 있는 텍스트를 사용합니다. DisplayName 속성이 비어 있는 경우 범례는 'dataN' 형식의 레이블을 사용합니다. 범례는 좌표축에 데이터 계열을 추가하거나 삭제할 때 자동으로 업데이트됩니다. 이 명령은 gca가 반환한 현재 좌표축 또는 차트에 대한 범례를 만듭니다. 현재 좌표축이 비어 있으면 범례도 비워집니다. 좌표축이 없으면 이 명령이 좌표축을 만듭니다.

legend(label1,...,labelN)은 범례 레이블을 설정합니다. 레이블을 문자형 벡터 또는 string형으로 구성된 목록으로 지정합니다(예: legend('Jan','Feb','Mar')).

legend(labels)는 문자형 벡터로 구성된 셀형 배열, string형 배열 또는 문자형 행렬을 사용하여 레이블을 설정합니다(예: legend({'Jan','Feb','Mar'})).

legend(subset,___)은 subset에 나열된 데이터 계열의 범례에 있는 항목만 포함합니다. subset을 그래픽스 객체로 구성된 벡터로 지정하십시오. subset은 레이블 지정 전에 지정할 수도 있고, 혹은 다른 입력 인수 없이도 지정할 수 있습니다.

legend(target,___)은 현재 좌표축 또는 차트 대신 target으로 지정된 좌표축 또는 차트를 사용합니다. target을 첫 번째 입력 인수로 지정하십시오.

legend(___,'Location',lcn)은 범례 위치를 설정합니다. 예를 들어, 'Location','northeast'는 좌표축의 오른쪽 상단에 범례를 배치합니다. 다른 입력 인수 다음에 위치를 지정하십시오.

legend(___,'Orientation',ornt)에서 ornt가 'horizontal'인 경우, 범례 항목을 나란히 표시합니다. ornt의 디폴트 값은 'vertical'이며, 이 경우 범례 항목이 세로로 표시됩니다.

legend(___,Name,Value)는 하나 이상의 이름-값 쌍의 인수를 사용하여 legend 속성을 설정합니다.

legend(bkgd)에서 bkgd이 'boxoff'인 경우, 범례의 배경과 윤곽선을 제거합니다. bkgd의 디폴트 값은 'boxon'이며, 이 경우 범례의 배경과 윤곽선을 표시합니다.

lgd = legend(___)는 Legend 객체를 반환합니다. lgd를 사용하면 범례가 생성된 후에 범례의 속성을 쿼리하고 설정할 수 있습니다. 속성 목록은 Legend 속성를 참조하십시오.

legend(vsbl)은 범례의 가시성을 제어하며, 여기서 vsbl은 'hide', 'show' 또는 'toggle'입니다.

legend('off')는 범례를 삭제합니다.

예제

현재 좌표축에 범례 추가하기

두 개의 선을 플로팅하고 현재 좌표축에 범례를 추가합니다. 범례 레이블을 legend 함수에 대한 입력 인수로 지정하십시오.

x = linspace(0,pi);
y1 = cos(x);
plot(x,y1)

hold on 
y2 = cos(2*x);
plot(x,y2)

legend('cos(x)','cos(2x)')

좌표축에서 데이터 계열을 추가하거나 삭제하면 범례도 같이 업데이트됩니다. 생성 시 DisplayName 속성을 이름-값 쌍으로 설정하여 새 데이터 계열에 대한 레이블을 제어합니다. 레이블을 지정하지 않으면 범례에는 'dataN' 형식의 레이블이 사용됩니다.

참고: 좌표축에 데이터 계열이 추가되거나 제거될 때 범례가 자동으로 업데이트되지 않도록 하려면 범례의 AutoUpdate 속성을 'off'로 설정하십시오.

y3 = cos(3*x);
plot(x,y3,'DisplayName','cos(3x)')
hold off

범례를 삭제합니다.

legend('off')

특정 좌표축에 범례 추가하기

R2019b부터는 tiledlayout 함수와 nexttile 함수를 사용하여 플롯을 타일 형식 배열로 표시할 수 있습니다. tiledlayout 함수를 호출하여 2×1 타일 형식 차트 레이아웃을 만듭니다. nexttile 함수를 호출하여 axes 객체 ax1과 ax2를 만듭니다. 각 좌표축에서 난수 데이터를 플로팅합니다. ax1을 legend의 첫 번째 입력 인수로 지정하여 상부 플롯에 범례를 추가합니다.

tiledlayout(2,1)
y1 = rand(3);
ax1 = nexttile; 
plot(y1)

y2 = rand(5);
ax2 = nexttile; 
plot(y2)

legend(ax1,{'Line 1','Line 2','Line 3'})

플로팅 명령 중에 범례 레이블 지정하기

두 개의 선을 플로팅합니다. DisplayName 속성을 원하는 텍스트로 설정하여 플로팅 명령 중에 범례 레이블을 지정합니다. 그런 다음, 범례를 추가합니다.

x = linspace(0,pi);
y1 = cos(x);
plot(x,y1,'DisplayName','cos(x)')

hold on 
y2 = cos(2*x);
plot(x,y2,'DisplayName','cos(2x)')
hold off

legend

범례 위치와 열 개수

네 개의 선을 플로팅합니다. 좌표축의 북서 영역에 범례를 만듭니다. NumColumns 속성을 사용하여 범례 열의 개수를 지정합니다.

x = linspace(0,pi);
y1 = cos(x);
plot(x,y1)

hold on
y2 = cos(2*x);
plot(x,y2)

y3 = cos(3*x);
plot(x,y3)

y4 = cos(4*x);
plot(x,y4)
hold off

legend({'cos(x)','cos(2x)','cos(3x)','cos(4x)'},'Location','northwest','NumColumns',2)

기본적으로 범례는 각 열을 따라 위쪽에서 아래쪽으로 항목을 정렬합니다. 이렇게 하는 대신 항목을 각 행을 따라 왼쪽에서 오른쪽으로 정렬하려면 Orientation 속성을 'horizontal'로 설정하십시오.

타일 형식 차트 레이아웃에 공유 범례 표시하기

둘 이상의 플롯에서 범례를 공유하려면 레이아웃의 별도의 타일에 범례를 표시하면 됩니다.

타일 형식 차트 레이아웃에 세 개의 플롯을 만듭니다.

tiledlayout(2,2);
nexttile
plot(rand(5))
nexttile
plot(rand(5))
nexttile
plot(rand(5))

공유 범례를 추가하고 네 번째 타일로 이동합니다.

lgd = legend;
lgd.Layout.Tile = 4;

그래픽스 객체의 일부만 범례에 포함시키기

플로팅된 그래픽스 객체의 일부만 범례에 포함시키고자 한다면 그러한 그래픽스 객체를 지정해야 합니다.

세 개의 선을 플로팅하고 생성된 Line 객체를 반환합니다. 선 중에서 두 개만 포함하는 범례를 만듭니다. 첫 번째 입력 인수를 포함할 Line 객체의 벡터로 지정해 보십시오.

x = linspace(0,pi);
y1 = cos(x);
p1 = plot(x,y1);

hold on
y2 = cos(2*x);
p2 = plot(x,y2);

y3 = cos(3*x);
p3 = plot(x,y3);
hold off

legend([p1 p3],{'First','Third'})

범례에 제목 추가하기

두 개의 선을 플로팅하고 범례를 생성합니다. 그런 다음 범례에 제목을 추가합니다.

x = linspace(0,pi);
y1 = cos(x);
plot(x,y1)

hold on
y2 = cos(2*x);
plot(x,y2)
hold off

lgd = legend('cos(x)','cos(2x)');
title(lgd,'My Legend Title')

범례 배경 제거하기

두 개의 선을 플로팅하고 좌표축의 왼쪽 아래 코너에 범례를 만듭니다. 그런 다음, 범례의 배경과 윤곽선을 제거합니다.

x = linspace(0,pi);
y1 = cos(x);
plot(x,y1)

hold on
y2 = cos(2*x);
plot(x,y2)
hold off

legend({'cos(x)','cos(2x)'},'Location','southwest')
legend('boxoff')

범례의 외양 수정하기

Legend 속성을 설정하여 범례 모양을 수정합니다. legend 명령에서 이름-값 쌍을 사용하여 범례를 만들 경우 속성을 설정할 수 있습니다. Legend 객체를 사용하여 범례를 만든 후에 속성을 설정할 수도 있습니다.

난수 데이터의 네 개의 선을 플로팅합니다. 범례를 만들고 변수 lgd에 Legend 객체를 할당합니다. 이름-값 쌍을 사용하여 FontSize 속성과 TextColor 속성을 설정합니다.

rdm = rand(4);
plot(rdm)

lgd = legend({'Line 1','Line 2','Line 3','Line 4'},'FontSize',12,'TextColor','blue')

lgd = 
  Legend (Line 1, Line 2, Line 3, Line 4) with properties:

         String: {'Line 1'  'Line 2'  'Line 3'  'Line 4'}
       Location: 'northeast'
    Orientation: 'vertical'
       FontSize: 12
       Position: [0.7088 0.7034 0.1778 0.1957]
          Units: 'normalized'

  Show all properties

범례를 만든 후 lgd를 참조하여 범례를 수정합니다. 객체.속성 이름 표기법을 사용하여 NumColumns 속성을 설정합니다.

lgd.NumColumns = 2;

입력 인수

label1,...,labelN — 레이블(개별 인수)

문자형 벡터 | string형

레이블로, 문자형 벡터나 string형으로 구성된 개별 인수로 지정됩니다. 레이블에 특수 문자나 그리스 문자를 포함시키려면 TeX 마크업을 사용하십시오. 옵션 테이블을 보려면 Interpreter 속성을 참조하십시오.

예: legend('Sin Function','Cos Function')

예: legend("Sin Function","Cos Function")

예: legend('\gamma','\sigma')

'Location'이나 'off'와 같은 키워드를 레이블로 지정하려면 문자형 벡터로 구성된 셀형 배열, string형 배열 또는 문자형 배열을 사용하십시오.

labels — 레이블(배열)

문자형 벡터로 구성된 셀형 배열 | string형 배열 | categorical형 배열

레이블로, 문자형 벡터로 구성된 셀형 배열, string형 배열 또는 categorical형 배열로 지정됩니다. 레이블에 특수 문자나 그리스 문자를 포함시키려면 TeX 마크업을 사용하십시오. 옵션 테이블을 보려면 Interpreter 속성을 참조하십시오.

예: legend({'Sin Function','Cos Function'})

예: legend(["Sin Function","Cos Function"])

예: legend({'\gamma','\sigma'})

예: legend(categorical({'Alabama','New York'}))

subset — 범례에 포함시킬 데이터 계열

그래픽스 객체의 벡터

범례에 포함시킬 데이터 계열로, 그래픽스 객체로 구성된 벡터로 지정됩니다.

target — 범례의 대상

Axes 객체 | PolarAxes 객체 | GeographicAxes 객체 | 그래픽스 객체

범례의 대상으로, Axes 객체, PolarAxes 객체, GeographicAxes 객체 또는 LegendVisible 속성을 가진 그래픽스 객체(예: GeographicBubbleChart 객체)로 지정됩니다. 대상을 지정하지 않는 경우 legend 함수는 gca 명령으로 반환된 좌표축 또는 차트를 사용합니다.

일부 차트의 경우 위치를 비롯한 범례 모양을 수정하거나 Legend 객체를 출력 인수로 반환할 수 없습니다.

lcn — 범례 위치

'north' | 'south' | 'east' | 'west' | 'northeast' | ...

좌표축을 기준으로 한 범례 위치로, 다음 표에 나열된 위치 값 중 하나로 지정됩니다.

값	설명
'north'	좌표축의 내부 맨 위
'south'	좌표축의 내부 맨 아래
'east'	좌표축의 내부 오른쪽
'west'	좌표축의 내부 왼쪽
'northeast'	좌표축의 내부 오른쪽 위(2차원 축의 경우 디폴트 값)
'northwest'	좌표축의 내부 왼쪽 위
'southeast'	좌표축의 내부 오른쪽 아래
'southwest'	좌표축의 내부 왼쪽 아래
'northoutside'	좌표축의 외부 위
'southoutside'	좌표축의 외부 아래
'eastoutside'	좌표축의 오른쪽
'westoutside'	좌표축의 왼쪽
'northeastoutside'	좌표축의 외부 오른쪽 위 코너(3차원 축의 경우 디폴트 값)
'northwestoutside'	좌표축의 외부 왼쪽 위 코너
'southeastoutside'	좌표축의 외부 오른쪽 아래 코너
'southwestoutside'	좌표축의 외부 왼쪽 아래 코너
'best'	범례를 만드는 시점에 플롯 데이터와의 충돌이 가장 적은 좌표축 내부. 플롯 데이터가 변경되는 경우 위치를 'best'로 재설정해야 할 수 있습니다.
'bestoutside'	좌표축의 외부 오른쪽 위 코너(범례의 방향이 세로인 곳) 또는 좌표축 아래(범례의 방향이 가로인 곳)
'layout'	타일 형식 차트 레이아웃의 타일. 범례를 다른 타일로 이동하려면 범례의 Layout 속성을 설정하십시오.
'none'	Position 속성에 의해 결정됩니다. 사용자 지정 위치에 범례를 표시하려면 Position 속성을 사용하십시오.

예: legend('Location','northeastoutside')

ornt — 방향

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

방향으로, 다음 값 중 하나로 지정됩니다.

• 'vertical' — 범례 항목을 세로로 쌓습니다.

• 'horizontal' — 범례 항목을 나란히 나열합니다.

예: legend('Orientation','horizontal')

bkgd — 범례 상자 표시 여부

'boxon' (디폴트 값) | 'boxoff'

범례 상자 표시 여부로, 다음 값 중 하나로 지정됩니다.

• 'boxon' — 범례의 배경과 윤곽선을 표시합니다.

• 'boxoff' — 범례의 배경과 윤곽선을 표시하지 않습니다.

예: legend('boxoff')

vsbl — 범례 가시성

'hide' | 'show' | 'toggle'

범례 가시성으로, 다음 값 중 하나로 지정됩니다.

• 'hide' — 범례를 숨깁니다.

• 'Show' — 범례를 표시하거나 범례가 없는 경우 범례를 만듭니다.

• 'toggle' — 범례의 가시성을 전환합니다.

예: legend('hide')

이름-값 쌍의 인수

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

예: legend({'A','B'},'TextColor','blue','FontSize',12)는 12포인트 크기의 파란색 글꼴로 범례를 만듭니다.

참고

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

'TextColor' — 텍스트 색

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

예: [0 0 1]

예: 'blue'

예: '#0000FF'

'FontSize' — 글꼴 크기

0보다 큰 스칼라 값

글꼴 크기로, 0보다 큰 스칼라 값으로 지정됩니다(단위: 포인트). 디폴트 글꼴 크기는 운영 체제와 로캘에 따라 다릅니다.

좌표축 글꼴 크기를 변경하면 MATLAB은 자동으로 컬러바 글꼴 크기를 좌표축 글꼴 크기의 90%로 설정합니다. 컬러바 글꼴 크기를 수동으로 설정하는 경우에는 좌표축 글꼴 크기를 변경해도 컬러바 글꼴에 영향을 미치지 않습니다.

'NumColumns' — 열 개수

1 (디폴트 값) | 양의 정수

열 개수로, 양의 정수로 지정됩니다. 지정된 개수의 열을 채울 충분한 범례 항목이 없을 경우, 열이 적게 표시될 수 있습니다.

범례 항목을 각 열을 따라 순서대로 표시할지 아니면 각 행을 따라 순서대로 표시할지는 Orientation 속성을 사용하십시오.

예: lgd.NumColumns = 3

출력 인수

lgd — Legend 객체

Legend 객체

Legend 객체. lgd를 사용하면 범례가 생성된 후에 범례의 속성을 보거나 수정할 수 있습니다.

plot(rand(3))
lgd = legend('line1','line2','line3');
lgd.FontSize = 12;
lgd.FontWeight = 'bold';

팁

• 범례에 20개가 넘는 객체의 레이블을 표시하려면 각 객체에 대한 레이블을 지정하십시오. 그러지 않으면 legend는 그래프의 처음 20개 객체에 대해서만 레이블을 표시합니다.

알고리즘

• legend 함수를 다시 호출해도 위치나 방향과 같은 legend 속성은 재설정되지 않습니다. 범례가 존재하는 경우 legend 함수는 기존 범례를 업데이트합니다. Axes 객체는 범례를 하나만 가질 수 있습니다.

• 범례는 좌표축에서 그래픽스 객체의 가시성을 반영합니다. Visible 속성이 'off'로 설정된 그래픽스 객체는 범례에서 회색 항목으로 나타납니다.

호환성 관련 고려 사항

legend는 속성이 존재하는 경우 인수를 속성 이름으로 해석합니다.

R2018b에서 동작이 변경됨

R2018b부터 legend 함수에 범례 속성의 이름과 일치하는 인수를 전달하면 이 함수는 인수를 이름-값 쌍의 이름으로 해석합니다. 이전 릴리스에서는 첫 번째 인수가 셀형 배열인 경우에만 legend 함수가 이름-값 쌍을 인식했습니다.

이번 변경을 통해 대부분의 경우 이름-값 쌍을 사용할 때 첫 번째 인수를 셀형 배열로 지정할 필요가 없어졌습니다. 그러나 범례에서 범례 속성의 이름과 일치하는 레이블(예: Position, NumColumns)을 사용하려면 반드시 셀형 배열에 모든 레이블을 지정해야 합니다. 그러지 않으면 legend 함수는 인수를 레이블이 아닌 이름-값 쌍으로 해석합니다.

설명	권장 코드
범례에서 범례 속성의 이름과 일치하는 레이블(예: 'NumColumns')을 사용하려면 셀형 배열에 모든 레이블을 지정해야 합니다. 'NumColumns'를 셀형 배열 외부에 지정하면 legend 함수는 이것을 이름-값 쌍으로 해석합니다.	legend({'Label1','NumColumns','Label3','Label4'},'NumColumns',2)
범례 속성의 이름과 일치하는 레이블이 없으면 레이블을 지정할 때 셀형 배열을 사용할 필요가 없습니다.	legend('Label1','Label2','Label2')

legend는 좌표축이 없는 경우 새로 좌표축을 생성합니다.

R2017b에서 동작이 변경됨

R2017b부터는 좌표축이 없으면 legend 함수가 좌표축을 만듭니다.

데이터를 추가하거나 제거하면 범례가 자동으로 업데이트됩니다.

R2017a에서 동작이 변경됨

R2017a부터는 좌표축에 데이터 계열을 추가하거나 제거하면 범례가 자동으로 업데이트됩니다. 범례가 자동으로 업데이트되지 않도록 하려면 범례의 AutoUpdate 속성을 'off'로 설정하십시오.

lgd = legend;
lgd.AutoUpdate = 'off';

여러 개의 출력값을 반환하는 것은 권장되지 않습니다.

R2014b부터 권장되지 않음

아래의 구문을 사용하여 여러 개의 출력값을 반환하는 것은 더 이상 권장되지 않습니다.

[lgd,icons,plots,txt] = legend(__)

이 구문은 R2014b 이상의 릴리스에 도입된 일부 기능을 지원하지 않는 범례를 만듭니다. 예를 들어, 범례에 제목을 추가하거나 범례 열의 개수를 지정할 수 없습니다. 또한, 좌표축에 데이터 계열을 추가하거나 제거할 때 범례가 자동으로 업데이트되지 않습니다.

대신 Legend 객체를 반환하고 Legend 속성을 설정하십시오.

lgd = legend(__)

참고 항목

함수

• hold | plot | text | title | xlabel | ylabel

속성

• Legend 속성

도움말 항목

• 그래프에 범례 추가하기

R2006a 이전에 개발됨

×

예제 열기

이 예제의 수정된 버전이 있습니다. 사용자가 편집한 내용을 반영하여 이 예제를 여시겠습니까?

아니요, 수정된 버전을 덮어씁니다. 예