datatip
データ ヒントを作成
説明
データ ヒントは、個々のデータ点に関する情報を表示する小さなテキスト ボックスです。既定では、データ ヒントには、チャート作成時に指定された、各データ点に対応するデータが含まれます。
作成
ライン プロットや散布図などのチャート内でデータ点をクリックすることにより、データ ヒントを対話的に作成します。データ ヒントは、関数 datatip を使用して作成することもできます。
構文
説明
datatip( は、ライン プロットや散布図など、指定したチャートの最初にプロットされたデータ点にデータ ヒントを作成します。target)
datatip(___,Name,Value) は、1 つ以上の名前と値のペアの引数を使用してプロパティを指定します。名前と値のペアは他のすべての引数の後で指定します。
dt = datatip(___) は DataTip オブジェクトを返します。前述の構文の、任意の入力引数を組み合わせて指定できます。この構文は、データ ヒントのプロパティを制御する場合に便利です。
入力引数
プロパティ
データ ヒント
プロット データのインデックス。正の整数として指定します。
たとえば、直交座標軸のセット上の 2 次元オブジェクトのプロット データは、XData プロパティと YData プロパティに含まれています。データ ヒントの DataIndex を指定すると、MATLAB® は、XData および YData にインデックスを付けることにより、データ ヒントをチャート上に配置します。
このプロパティを使用してデータを作成するときは、x、y、z の各引数を指定しないでください。
例: datatip(chart,'DataIndex',3) は、3 番目のプロット データ点にデータ ヒントを作成します。
最も近いデータ点での表示。次のいずれかの値として指定します。
'on'– 最も近いデータ点にデータ ヒントを表示します。最も近いデータ点は、チャートのタイプによって異なります。たとえば、線グラフでは、最も近い点は指定された位置からのユークリッド距離が最も小さいものです。'off'– データ点の間であっても、チャート上の最も近い指定場所にデータ ヒントを表示します。
DataIndex からのオフセット。スカラーとして指定します。このプロパティは、SnapToDataVertex を 'off' に、InterpolationFactor を 0 ～ 1 のスカラーに設定することにより、Line オブジェクト上の隣接するデータ点の間にデータ ヒントを作成するために使用します。
たとえば、ライン上の隣接するデータ点の中間にデータ ヒントを作成するには、InterpolationFactor を 0.5 と指定します。
x = 1:4; y = 2.*x; p = plot(x,y,'-*'); dt = datatip(p,'DataIndex',2, ... 'Location','southeast', ... 'SnapToDataVertex','off', ... 'InterpolationFactor',0.5);
InterpolationFactor は、あらゆるタイプのオブジェクトのデータ ヒントでサポートされているわけではありません。
データ点を基準とした位置。以下のいずれかの値として指定します。
| 値 | 説明 | 外観 |
|---|---|---|
'northeast' | データ点の右上隅 |
|
'northwest' | データ点の左上隅 |
|
'southeast' | データ点の右下隅 |
|
'southwest' | データ点の左下隅 |
|
例: dt.Location = 'southwest';
Location プロパティ値の選択モード。次のいずれかの値として指定します。
'auto'– 関数datatipが位置を自動的に選択します。'manual'–Locationプロパティを設定すると、LocationModeプロパティは自動的に'manual'に変更されます。
この プロパティ は読み取り専用です。
データ ヒントの内容。cell 配列として指定します。既定では、データ ヒントの内容は、2 次元のデータ ヒントの場合は 2 行 1 列の cell 配列、3 次元のデータ ヒントの場合は 3 行 1 列の cell 配列です。
データ ヒントの内容に行を追加するには、dataTipTextRow を使用します。
フォント
FontName プロパティの選択モード。次の値のいずれかとして指定します。
'auto'– データ ヒントを含むチャートに関連付けられているDataTipTemplateオブジェクトのFontNameプロパティと同じ値を使用します。'manual'–FontNameプロパティを設定すると、FontNameModeプロパティは自動的に'manual'に変更されます。
フォント サイズ。ポイント単位のゼロより大きいスカラー値として指定します。1 ポイントは 1/72 インチです。
フォント サイズの選択モード。次の値のいずれかとして指定します。
'auto'– データ ヒントを含むチャートに関連付けられているDataTipTemplateオブジェクトのFontSizeプロパティと同じ値を使用します。'manual'–FontSizeプロパティを設定すると、FontSizeModeプロパティは自動的に'manual'に変更されます。
FontAngle プロパティの選択モード。次の値のいずれかとして指定します。
'auto'– データ ヒントを含むチャートに関連付けられているDataTipTemplateオブジェクトのFontAngleプロパティと同じ値を使用します。'manual'–FontAngleプロパティを設定すると、FontAngleModeプロパティは自動的に'manual'に変更されます。
テキスト インタープリター。次の値のいずれかとして指定します。
'tex'— TeX マークアップのサブセットを使用して文字を解釈します。'latex'— LaTeX マークアップを使用して文字を解釈します。'none'— リテラル文字を表示します。
TeX マークアップ
MATLAB では、既定で TeX マークアップのサブセットをサポートしています。TeX マークアップを使用して、上付き文字や下付き文字の追加、フォントのタイプや色の変更、テキストへの特殊文字の挿入を行うことができます。
修飾子の効果はテキストの末尾まで適用されます。上付き文字と下付き文字は例外であり、次の 1 文字または中かっこで囲まれた文字にのみ適用されます。インタープリターを "tex" に設定した場合にサポートされる修飾子は次のとおりです。
| 修飾子 | 説明 | 例 |
|---|---|---|
^{ } | 上付き文字 | "text^{superscript}" |
_{ } | 下付き文字 | "text_{subscript}" |
\bf | 太字フォント | "\bf text" |
\it | イタリック フォント | "\it text" |
\sl | 斜体フォント (通常はイタリック フォントと同じ) | "\sl text" |
\rm | 標準フォント | "\rm text" |
\fontname{ | フォント名 — | "\fontname{Courier} text" |
\fontsize{ | フォント サイズ — | "\fontsize{15} text" |
\color{ | フォントの色 — red、green、yellow、magenta、blue、black、white、gray、darkGreen、orange、lightBlue の色のいずれかに置き換えます。 | "\color{magenta} text" |
\color[rgb]{specifier} | フォントのカスタムの色 — | "\color[rgb]{0,0.5,0.5} text" |
次の表に、"tex" インタープリターでサポートされる特殊文字を示します。
| 文字列 | 記号 | 文字列 | 記号 | 文字列 | 記号 |
|---|---|---|---|---|---|
| α |
| υ |
| ~ |
| ∠ |
| ϕ |
| ≤ |
|
|
| χ |
| ∞ |
| β |
| ψ |
| ♣ |
| γ |
| ω |
| ♦ |
| δ |
| Γ |
| ♥ |
| ϵ |
| Δ |
| ♠ |
| ζ |
| Θ |
| ↔ |
| η |
| Λ |
| ← |
| θ |
| Ξ |
| ⇐ |
| ϑ |
| Π |
| ↑ |
| ι |
| Σ |
| → |
| κ |
| ϒ |
| ⇒ |
| λ |
| Φ |
| ↓ |
| µ |
| Ψ |
| º |
| ν |
| Ω |
| ± |
| ξ |
| ∀ |
| ≥ |
| π |
| ∃ |
| ∝ |
| ρ |
| ∍ |
| ∂ |
| σ |
| ≅ |
| • |
| ς |
| ≈ |
| ÷ |
| τ |
| ℜ |
| ≠ |
| ≡ |
| ⊕ |
| ℵ |
| ℑ |
| ∪ |
| ℘ |
| ⊗ |
| ⊆ |
| ∅ |
| ∩ |
| ∈ |
| ⊇ |
| ⊃ |
| ⌈ |
| ⊂ |
| ∫ |
| · |
| ο |
| ⌋ |
| ¬ |
| ∇ |
| ⌊ |
| x |
| ... |
| ⊥ |
| √ |
| ´ |
| ∧ |
| ϖ |
| ∅ |
| ⌉ |
| 〉 |
| | |
| ∨ |
| 〈 |
| © |
LaTeX マークアップ
LaTeX マークアップを使用するには、インタープリターを "latex" に設定します。インライン モードでは、マークアップを 1 つのドル記号 ($) で囲みます。表示モードでは、マークアップを 2 つのドル記号 ($$) で囲みます。
| LaTeX モード | 例 | 結果 |
|---|---|---|
| インライン |
"$\int_1^{20} x^2 dx$" |
|
| 表示 |
"$$\int_1^{20} x^2 dx$$" |
|
テキストは LaTeX の既定のフォント スタイルで表示され、FontName、FontWeight、FontAngle のプロパティは無視されます。フォント スタイルを変更するには、LaTeX マークアップを使用します。
LaTeX インタープリターで使用できるテキストの最大サイズは 1200 文字です。複数行のテキストの場合は、さらに 1 行につき 10 文字ほど文字数が少なくなります。
MATLAB では、大半の標準の LaTeX 数式モード コマンドがサポートされています。詳細については、サポートされる LaTeX コマンドを参照してください。TeX および LaTeX の使用例については、チャートのテキスト内のギリシャ文字と特殊文字を参照してください。
Interpreter プロパティの選択モード。次の値のいずれかとして指定します。
'auto'— データ ヒントを含むチャートに関連付けられているDataTipTemplateオブジェクトのInterpreterプロパティと同じ値を使用します。'manual'—Interpreterプロパティを設定すると、InterpreterModeプロパティは自動的に'manual'に変更されます。
直交座標データ
x 軸上の位置。データと同じ単位を使用するスカラーとして指定します。
y 軸上の位置。データと同じ単位を使用するスカラーとして指定します。
z 軸上の位置。データと同じ単位を使用するスカラーとして指定します。
極座標データ
半径。データと同じ単位を使用するスカラーとして指定します。
このプロパティは極座標プロット上のデータ ヒントにのみ適用されます。
角度。度単位のスカラーとして指定します。
このプロパティは極座標プロット上のデータ ヒントにのみ適用されます。
地理座標データ
緯度。度単位のスカラーとして指定します。
このプロパティは地理プロット上のデータ ヒントにのみ適用されます。
経度。度単位のスカラーとして指定します。
このプロパティは地理プロット上のデータ ヒントにのみ適用されます。
対話機能
コンテキスト メニュー。データ ヒントのオプションを提供する ContextMenu オブジェクトとして指定します。このプロパティは設定できません。
コールバック
コールバック実行制御
親/子
親。DataTipTemplate プロパティをもつオブジェクトとして指定します。データ ヒント テンプレートをもつオブジェクトの例には、Line、Histogram、Surface、FunctionLine などのオブジェクトが含まれます。データ ヒントを別のオブジェクトに移動するには、このプロパティを設定します。
識別子
この プロパティ は読み取り専用です。
グラフィックス オブジェクトのタイプ。'datatip' として返されます。このプロパティは、プロット階層内にある特定タイプのすべてのオブジェクトを検出するために使用します。たとえば、findobj を使用してタイプを検索する場合などです。
例
サンプル ファイル patients.xls を使用して table を作成します。次に、変数 Systolic、Diastolic、および Weight をバブル チャートにプロットします。次に、データ ヒントを追加します。
tbl = readtable("patients.xls"); b = bubblechart(tbl,"Systolic","Diastolic","Weight"); dt = datatip(b);
データを散布図にプロットしてから、sz を、マーカーのサイズを指定するベクトルとして定義します。Scatter オブジェクトを返します。
次に、x 座標と y 座標を指定して、特定のデータ点にデータ ヒントを作成します。
x = linspace(1,10,10); y = x.^2; sz = x; sc = scatter(x,y,sz); dt = datatip(sc,7,49);
棒グラフにデータをプロットして Bar オブジェクトを返します。次に、名前と値のペアの引数 DataIndex を指定して、7 番目のバーにデータ ヒントを作成します。
x = 1900:10:2000;
y = [75 91 105 123.5 131 120 107 96 82 73 70];
b = bar(x,y);
dt = datatip(b,'DataIndex',7);
散布図にデータをプロットして Scatter オブジェクトを返します。x = 3 および y = 0 をおおよその座標として指定して、(3,0) の近くのデータ点にデータ ヒントを作成します。おおよその座標を使用してデータ ヒントを作成すると、データ ヒントは最も近いデータ点に表示されます。
x = linspace(0,2*pi,20);
y = sin(x);
sc = scatter(x,y);
grid on;
dt = datatip(sc,3,0);
データをプロットして Line オブジェクトを返します。プロットされたデータ点ごとにマーカーを表示します。次に、データ ヒントの x 座標と y 座標を指定し、名前と値のペアの引数 SnapToDataVertex を 'off' と指定して、2 つのデータ点の間にデータ ヒントを作成します。
x = linspace(1,10,10); y = 2.*x; p = plot(x,y,'-*'); dt = datatip(p,3.5,7,'SnapToDataVertex','off');
