Main Content

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

datacursormode

데이터 커서 모드 활성화

설명

데이터팁은 개별 데이터 점에 대한 정보를 표시하는 작은 텍스트 상자입니다. R2018b 이전 릴리스에서는 datacursormode 함수를 사용하여 데이터팁을 만들고 편집합니다. datacursormode를 사용하여 data cursor manager 객체를 만들어서 데이터팁의 모양과 동작을 제어합니다.

R2018b부터는 대신 내장된 상호 작용을 사용하여 데이터팁을 만들고 편집할 수 있습니다. 내장된 상호 작용을 사용할 때는 모드를 활성화할 필요가 없으며, 상호 작용 모드보다 반응 속도가 빠릅니다. 내장된 상호 작용에 대한 자세한 내용은 차트 상호 작용 제어하기 항목을 참조하십시오.

데이터팁은 선 차트, 막대 차트, 히스토그램 차트, 곡면 차트 등 대부분의 차트에서 지원됩니다. 데이터팁이 지원되는 차트에는 대개 좌표축 도구 모음에 데이터팁 아이콘 이 표시됩니다.

생성

설명

datacursormode on은 현재 Figure에 있는 차트에 대해 데이터 커서 모드를 켭니다. 데이터 커서 모드를 켠 상태에서 데이터 점을 클릭하여 데이터팁을 만듭니다. 데이터팁을 여러 개 만들려면 Shift 키를 누른 상태에서 여러 데이터 점을 클릭하십시오.

datacursormode off는 데이터 커서 모드를 끕니다. 이 명령은 기존 데이터팁을 제거하지 않습니다. 일부 내장된 상호 작용은 모드에 관계없이 기본적으로 활성화되어 있습니다. 내장된 데이터팁 상호 작용을 비활성화하려면 disableDefaultInteractivity 함수를 사용하십시오.

datacursormode는 데이터 커서 모드를 'on''off' 간에 전환합니다. 이 구문은 datacursormode toggle과 동일합니다.

datacursormode(fig,___)는 지정된 Figure에 있는 차트에 대해 데이터 커서 모드를 설정합니다. 추가 인수를 'on', 'off' 또는 'toggle'로 지정하십시오. 예를 들어, datacursormode(fig,'on')을 사용합니다.

예제

dcm = datacursormode는 현재 Figure에 대해 data cursor manager 객체를 만듭니다. 이 구문은 데이터 커서 모드, 데이터팁 디스플레이 스타일 및 데이터팁 텍스트 형식을 제어할 때 유용합니다.

dcm = datacursormode(fig)는 지정된 Figure에 대해 data cursor manager 객체를 만듭니다.

입력 인수

모두 확장

대상 Figure로, Figure 객체로 지정됩니다.

속성

모두 확장

가장 가까운 데이터 점에 표시할지 여부로, 다음 값 중 하나로 지정됩니다.

  • 'on' – 가장 가까운 데이터 점에 데이터팁을 표시합니다. 가장 가까운 데이터 점은 차트의 유형에 따라 달라집니다. 예를 들어, 선 차트에서 가장 가까운 점은 지정된 위치로부터 가장 작은 유클리드 거리를 갖습니다.

  • 'off' – (클릭한 위치가 데이터 점들 사이에 있더라도) 클릭한 위치에 데이터팁을 표시합니다.

데이터팁 디스플레이 스타일로, 다음 값 중 하나로 지정됩니다.

  • 'datatip' – 데이터팁을 데이터 값에 연결된 작은 텍스트 상자로 표시합니다. 데이터팁을 여러 개 만들려면 Shift 키를 누른 상태에서 여러 데이터 점을 선택하십시오. 데이터 커서 모드를 꺼도 기존 데이터팁은 차트에 남아 있습니다.

  • 'window' – 데이터팁을 Figure 내의 이동 가능한 창 안에 표시합니다. 디스플레이 스타일이 'window'이면 한 번에 하나의 데이터팁만 표시할 수 있습니다. 데이터 커서 모드를 끄면 창이 닫힙니다.

텍스트 인터프리터로, 다음 값 중 하나로 지정됩니다.

  • 'tex' — TeX 마크업의 서브셋을 사용하여 문자를 해석합니다.

  • 'latex' — LaTeX 마크업을 사용하여 문자를 해석합니다.

  • 'none' — 리터럴 문자를 표시합니다.

TeX 마크업

기본적으로 MATLAB®은 TeX 마크업의 서브셋을 지원합니다. TeX 마크업을 사용하여 위 첨자와 아래 첨자를 추가하고, 글꼴 유형과 색을 수정하며, 텍스트에 특수 문자를 포함시킬 수 있습니다.

수정자는 텍스트의 끝까지 적용됩니다. 단, 위 첨자와 아래 첨자는 바로 다음에 오는 문자나 중괄호 안에 있는 문자만 수정합니다. 인터프리터를 'tex'으로 설정한 경우 지원되는 수정자는 다음과 같습니다.

수정자설명
^{ }위 첨자'text^{superscript}'
_{ }아래 첨자'text_{subscript}'
\bf굵은 글꼴'\bf text'
\it기울임꼴'\it text'
\sl오블리크 글꼴(일반적으로 기울임꼴과 같음)'\sl text'
\rm보통 글꼴'\rm text'
\fontname{specifier}글꼴 이름 — specifier를 글꼴 이름으로 바꿉니다. 이 수정자는 다른 수정자와 함께 사용할 수 있습니다.'\fontname{Courier} text'
\fontsize{specifier}글꼴 크기 — specifier를 숫자형 스칼라 값으로 바꿉니다(단위: 포인트).'\fontsize{15} text'
\color{specifier}글꼴 색 — specifierred, green, yellow, magenta, blue, black, white, gray, darkGreen, orange, lightBlue 색 중 하나로 바꿉니다.'\color{magenta} text'
\color[rgb]{specifier}사용자 지정 글꼴 색 — specifier를 요소를 3개 가진 RGB 3색으로 바꿉니다.'\color[rgb]{0,0.5,0.5} text'

다음 표에는 'tex' 인터프리터에 사용할 수 있는 특수 문자가 나열되어 있습니다.

문자 시퀀스기호문자 시퀀스기호문자 시퀀스기호

\alpha

α

\upsilon

υ

\sim

~

\angle

\phi

\leq

\ast

*

\chi

χ

\infty

\beta

β

\psi

ψ

\clubsuit

\gamma

γ

\omega

ω

\diamondsuit

\delta

δ

\Gamma

Γ

\heartsuit

\epsilon

ϵ

\Delta

Δ

\spadesuit

\zeta

ζ

\Theta

Θ

\leftrightarrow

\eta

η

\Lambda

Λ

\leftarrow

\theta

θ

\Xi

Ξ

\Leftarrow

\vartheta

ϑ

\Pi

Π

\uparrow

\iota

ι

\Sigma

Σ

\rightarrow

\kappa

κ

\Upsilon

ϒ

\Rightarrow

\lambda

λ

\Phi

Φ

\downarrow

\mu

µ

\Psi

Ψ

\circ

º

\nu

ν

\Omega

Ω

\pm

±

\xi

ξ

\forall

\geq

\pi

π

\exists

\propto

\rho

ρ

\ni

\partial

\sigma

σ

\cong

\bullet

\varsigma

ς

\approx

\div

÷

\tau

τ

\Re

\neq

\equiv

\oplus

\aleph

\Im

\cup

\wp

\otimes

\subseteq

\oslash

\cap

\in

\supseteq

\supset

\lceil

\subset

\int

\cdot

·

\o

ο

\rfloor

\neg

¬

\nabla

\lfloor

\times

x

\ldots

...

\perp

\surd

\prime

´

\wedge

\varpi

ϖ

\0

\rceil

\rangle

\mid

|

\vee

\langle

\copyright

©

LaTeX 마크업

LaTeX 마크업을 사용하려면 인터프리터를 'latex'으로 설정하십시오. 텍스트는 달러 기호로 감쌉니다. 예를 들어, 인라인 모드의 경우 '$\int_1^{20} x^2 dx$', 디스플레이 모드의 경우 '$$\int_1^{20} x^2 dx$$'와 같이 사용하십시오.

표시되는 텍스트에 디폴트 LaTeX 글꼴 스타일이 사용됩니다. 글꼴 스타일을 변경하려면 LaTeX 마크업을 사용하십시오.

LaTeX 인터프리터와 함께 사용할 수 있는 최대 텍스트 크기는 1,200자입니다. 여러 라인으로 된 텍스트의 경우에는 라인당 약 10자씩 줄어듭니다.

LaTeX 시스템에 대한 자세한 내용은 The LaTeX Project 웹 사이트(https://www.latex-project.org/)를 참조하십시오.

데이터 커서 모드로, 'off' 또는 'on'으로 지정됩니다.

데이터팁 텍스트의 형식을 지정하는 콜백 함수로, 함수 핸들로 지정됩니다.

이 속성을 사용하여 데이터팁 내용의 형식을 지정할 수 있습니다. MATLAB은 다음 두 개의 인수를 콜백 함수에 전달합니다.

  • empty — 빈 인수. 함수에서 이 인수를 물결표 문자(~)로 바꿔서 이 인수가 사용되지 않음을 나타낼 수 있습니다.

  • info – 데이터팁에 대한 정보를 포함하는 구조체. info 인수에는 두 개의 필드 TargetPosition이 있습니다. Target 필드는 DataTipTemplate 속성을 갖는 객체를 포함합니다. Position 필드는 데이터팁의 좌표를 포함합니다.

함수는 MATLAB 경로에 있거나 현재 폴더 내에 있어야 합니다. 또는 데이터팁 상황별 메뉴에서 업데이트 함수 > 파일에서 선택을 선택하여 MATLAB 경로에 있지 않은 함수를 선택할 수도 있습니다.

콜백에 대한 자세한 내용은 콜백 정의 항목을 참조하십시오.

이 속성은 읽기 전용입니다.

데이터팁이 나타나는 Figure 객체.

객체 함수

getCursorInfo

info = getCursorInfo(dcm)은 Figure에 있는 각 데이터팁의 대상 객체와 좌표를 반환합니다. info는 다음 필드를 갖는 구조체로 구성된 벡터입니다.

  • TargetDataTipTemplate 속성을 갖는 객체(예: Line, Histogram, Surface, FunctionLine 등).

  • Position – 데이터팁의 좌표. 좌표는 좌표축 유형에 따라 다르게 해석됩니다. 예를 들어, 카테시안 좌표축의 좌표는 데이터와 동일한 단위를 갖는 x, y, z입니다.

  • DataIndex(Line 객체만 해당) – 플로팅된 데이터의 인덱스. 예를 들어, 카테시안 좌표축 세트에 플로팅된 2차원 객체의 데이터는 XData 속성과 YData 속성에 포함되어 있습니다.

예제

모두 축소

데이터를 플로팅하고, DataCursorManager 객체를 만들고, 데이터 커서 모드를 활성화합니다. DisplayStyle 속성을 'window'로 설정하여 이동 가능한 창 안에 데이터팁 내용을 표시합니다. 그런 다음 데이터 점을 클릭하여 데이터팁을 만듭니다. 데이터팁 창의 제목 표시줄을 클릭하고 끌어서 창을 이동할 수 있습니다.

x = linspace(0,5,30);
y = exp(x);
scatter(x,y)
dcm = datacursormode;
dcm.Enable = 'on';
dcm.DisplayStyle = 'window';

Scatter plot with one selected point. A window in the lower-right corner displays the coordinates of the selected point.

DataCursorMode 객체의 UpdateFcn 속성을 설정하여 데이터팁 텍스트를 사용자 지정합니다.

먼저 데이터팁 정보를 받아서 사용자 지정 텍스트를 반환하는 콜백 함수를 정의합니다. UpdateFcn 속성은 콜백 함수의 첫 번째 인수를 사용하지 않으므로 첫 번째 인수를 ~로 바꿉니다. 사용자 지정 텍스트를 문자형 배열로 반환합니다. 여기서는 문자형 배열이 순서가 지정된 좌표 쌍을 포함합니다. 함수를 displayCoordinates.m이라는 프로그램 파일로 저장합니다.

function txt = displayCoordinates(~,info)
    x = info.Position(1);
    y = info.Position(2);
    txt = ['(' num2str(x) ', ' num2str(y) ')'];
end

데이터를 플로팅하고, 커서 모드를 활성화하고, UpdateFcn 속성을 콜백 함수로 설정합니다. 그런 다음 데이터 점을 클릭하여 데이터팁을 만듭니다.

x = 1:10;
y = x.^2;
scatter(x,y)

dcm = datacursormode;
dcm.Enable = 'on';
dcm.UpdateFcn = @displayCoordinates;

Scatter plot with one data tip. The text in the data tip is an ordered pair.

  • 대개 데이터팁에는 선택한 데이터 점의 좌표가 표시됩니다. 그러나 일부 유형의 차트에서는 데이터팁에 특화된 정보가 표시됩니다. 예를 들어, histogram 함수를 사용하여 만든 히스토그램은 관측값 개수와 Bin 경계값을 항목별로 나눈 데이터팁을 표시합니다.

  • 데이터팁을 프로그래밍 방식으로 만들고 사용자 지정하려면 datatip 함수와 dataTipTextRow 함수를 사용하십시오. 자세한 내용은 사용자 지정 데이터팁 생성하기 항목을 참조하십시오.

R2006a 이전에 개발됨