geobubble

スタンドアロンの地理バブル チャート

• 

構文

geobubble(tbl,latvar,lonvar)

geobubble(lat,lon)

geobubble(lat,lon,sizedata)

geobubble(lat,lon,sizedata,colordata)

geobubble(___,Name=Value)

geobubble(parent,___)

gb = geobubble(___)

説明

テーブル データ

geobubble(tbl,latvar,lonvar) は、指定された緯度と経度の座標からスタンドアロンの地理バブル チャートを作成します。tbl 引数は、座標を含む table を示します。latvar 引数は、緯度を含む table 変数を示します。lonvar 引数は、経度を含む table 変数を示します。既定では、すべてのバブルのサイズと色は同じです。

ベクトル データ

geobubble(lat,lon) は、lat の緯度と lon の経度から地理バブル チャートを作成します。既定では、すべてのバブルのサイズと色は同じです。

geobubble(lat,lon,sizedata) は、sizedata の数値に応じてバブルの領域をスケーリングします。

geobubble(lat,lon,sizedata,colordata) は、colordata の categorical 値を使用してバブルの色を指定します。この関数は colordata の各カテゴリの色を選択し、さらに colordata のいずれかの要素が未定義の場合は追加の 1 色を選択します。この関数は標準 7 色の順序付きリストから色を選択します。データで 7 つを超えるカテゴリが指定されている場合、この関数は色を巡回的に繰り返します。

追加オプション

geobubble(___,Name=Value) は、名前と値の引数を使用して GeographicBubbleChart プロパティを指定します。プロパティは他のすべての入力引数の後に指定します。たとえば、SizeVariable プロパティと ColorVariable プロパティを使用すると、バブルのサイズと色を決定する table 変数を指定できます。プロパティの一覧については、GeographicBubbleChart のプロパティ を参照してください。

geobubble(parent,___) は、parent で指定された Figure、パネル、タブまたはタイル表示チャート レイアウトに地理バブル チャートを作成します。

gb = geobubble(___) は、GeographicBubbleChart オブジェクトを返します。チャートのプロパティを作成後に変更するには、gb を使用します。プロパティの一覧については、GeographicBubbleChart のプロパティを参照してください。

例

table からの地理バブル チャートの作成

津波に関するデータを table としてワークスペースに読み取ります。table 行は個別の津波の発生を示します。table 変数には、緯度、経度、原因、波の高さなどの津波に関するデータが含まれます。

tsunamis = readtable("tsunamis.xlsx");

津波の原因に応じてバブルを色分けする準備を行います。変数 Cause は、'Earthquake'、'Volcano'、'Earthquake and Landslide' などの各津波の原因の属性です。変数 Cause を、文字ベクトルの cell 配列から categorical ベクトルに変換します。

tsunamis.Cause = categorical(tsunamis.Cause);

table から地理バブル チャートを作成します。table 変数 Latitude および Longitude を使用して津波の位置を指定します。table 変数 MaxHeight に格納された波の高さを使用して、バブルのサイズを指定します。table 変数 Cause に格納されたカテゴリを使用して、バブルの色を指定します。table データから地理バブル チャートを作成し、SizeVariable 引数と ColorVariable 引数を指定すると、サイズと色の凡例に、関連付けられた table 変数の名前が表示されます。

geobubble(tsunamis,"Latitude","Longitude", ...
    SizeVariable="MaxHeight",ColorVariable="Cause")

バブルのサイズの指定

津波に関するデータを table としてワークスペースに読み取ります。table 行は個別の津波の発生を示します。table 変数には、緯度、経度、原因、波の高さなどの津波に関するデータが含まれます。

tsunamis = readtable("tsunamis.xlsx");

table から緯度、経度、および波の高さを抽出します。

lat = tsunamis.Latitude;
lon = tsunamis.Longitude;
sizedata = tsunamis.MaxHeight;

緯度、経度、および波の高さから地理バブル チャートを作成します。波の高さを使用してバブルのサイズを指定します。関数 geobubble は、sizedata を使用してバブルのサイズの相対分布を制御します。

geobubble(lat,lon,sizedata)

バブルの色の指定

津波に関するデータを table としてワークスペースに読み取ります。table 行は個別の津波の発生を示します。table 変数には、緯度、経度、原因、波の高さなどの津波に関するデータが含まれます。

tsunamis = readtable("tsunamis.xlsx");

table から緯度、経度、波の高さ、および原因を抽出します。

lat = tsunamis.Latitude;
lon = tsunamis.Longitude;
sizedata = tsunamis.MaxHeight; 
colordata = tsunamis.Cause;

変数 colordata は、次の 7 つの基準で津波を分類します。地震、地震と地滑り、噴火、噴火と地滑り、地滑り、気象上の原因、不明の原因。colordata を categorical ベクトルに変換します。

colordata = categorical(colordata); 

緯度、経度、波の高さ、および原因から地理バブル チャートを作成します。波の高さを使用してバブルのサイズを指定します。原因を使用してバブルの色を指定します。

geobubble(lat,lon,sizedata,colordata)

タイトルと凡例タイトルの追加

ベクトル データから地理バブル チャートを作成した場合、凡例にはタイトルがありません。地理バブル チャートのプロパティを指定して、凡例タイトルを追加します。

津波に関するデータを table としてワークスペースに読み取ります。table 行は個別の津波の発生を示します。table 変数には、緯度、経度、原因、波の高さなどの津波に関するデータが含まれます。

tsunamis = readtable("tsunamis.xlsx");

table から緯度、経度、波の高さ、および原因を抽出します。

lat = tsunamis.Latitude;
lon = tsunamis.Longitude;
sizedata = tsunamis.MaxHeight; 
colordata = tsunamis.Cause;

変数 colordata は、次の 7 つの基準で津波を分類します。地震、地震と地滑り、噴火、噴火と地滑り、地滑り、気象上の原因、不明の原因。colordata を categorical ベクトルに変換します。

colordata = categorical(colordata); 

データから地理バブル チャートを作成します。GeographicBubbleChart オブジェクトを gb として返します。

gb = geobubble(lat,lon,sizedata,colordata);

Title、SizeLegendTitle および ColorLegendTitle プロパティを設定することにより、タイトルと凡例タイトルを追加します。

gb.Title = "Tsunamis";
gb.SizeLegendTitle = "Max Height";
gb.ColorLegendTitle = "Cause";

入力引数

tbl — ソース table

table | timetable

ソース table。table または timetable として指定します。

関数 readtable を使用してデータを table としてインポートできます。また、関数 table を使用してワークスペース変数から table を作成するか、関数 timetable を使用してワークスペース変数から timetable を作成できます。

GeographicBubbleChart オブジェクトの SourceTable プロパティに、プロットされたデータを含む table が格納されます。

latvar — 緯度座標を含む table 変数

string スカラー | 文字ベクトル | パターン | 数値スカラー | logical ベクトル | vartype()

緯度座標を含む table 変数。次のインデックス方式のいずれかを使用して指定します。

インデックス方式	例
変数名: string スカラーまたは文字ベクトル。 pattern オブジェクト。pattern オブジェクトは 1 つの変数のみを参照しなければなりません。	"A" または 'A' — A という名前の変数 "Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。	3 — table の 3 番目の変数 [false false true] — 3 番目の変数
変数の型: 指定したタイプの table 変数を選択する vartype 添字。添字は 1 つの変数のみを参照しなければなりません。	vartype("double") — double 値を含んでいる変数

変数名に関係なく、プロットの軸ラベルは常に Latitude です。

指定する変数には、single または double 型の数値データが含まれていなければなりません。データは、[–90, 90] の範囲内でなければなりません。

例: geobubble(tbl,"lat1","lon") は、緯度座標用に lat1 という名前の table 変数を指定します。

例: geobubble(tbl,2,"lon") は、緯度座標用に 2 番目の変数を指定します。

例: geobubble(tbl,vartype("numeric"),"lon") は、緯度座標用に数値変数を指定します。

lonvar — 経度座標を含む table 変数

string スカラー | 文字ベクトル | パターン | 数値スカラー | logical ベクトル | vartype()

経度座標を含む table 変数。次のインデックス方式のいずれかを使用して指定します。

インデックス方式	例
変数名: string スカラーまたは文字ベクトル。 pattern オブジェクト。pattern オブジェクトは 1 つの変数のみを参照しなければなりません。	"A" または 'A' — A という名前の変数 "Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。	3 — table の 3 番目の変数 [false false true] — 3 番目の変数
変数の型: 指定したタイプの table 変数を選択する vartype 添字。添字は 1 つの変数のみを参照しなければなりません。	vartype("double") — double 値を含んでいる変数

変数名に関係なく、プロットの軸ラベルは常に Longitude です。

指定する変数には、single または double 型の数値データが含まれていなければなりません。

例: geobubble(tbl,"lat","lon1") は、経度座標用に lon1 という名前の table 変数を指定します。

例: geobubble(tbl,"lat",2) は、経度座標用に 2 番目の変数を指定します。

例: geobubble(tbl,"lat",vartype("numeric")) は、経度座標用に数値変数を指定します。

lat — 緯度座標 (度単位)

範囲 [–90, 90] の要素をもつベクトル

緯度座標 (度単位)。範囲 [–90, 90] の要素をもつベクトルとして指定します。このベクトルには NaN 値を含めることができます。

lat および lon のサイズは一致する必要があります。

例: [43.0327 38.8921 44.0435]

データ型: single | double

lon — 経度座標 (度単位)

ベクトル

経度座標 (度単位)。ベクトルとして指定します。このベクトルには NaN 値を含めることができます。

lon および lat のサイズは一致する必要があります。

例: [-107.5556 -77.0269 -72.5565]

データ型: single | double

sizedata — バブルの相対サイズ

スカラー | ベクトル | []

バブルの相対サイズ。スカラー、ベクトル、または空の配列 ([]) として指定します。ベクトル入力には NaN 値を含めることができます。

sizedata は、バブルのサイズの相対分布を制御します。既定では、geobubble は、sizedata 値の範囲全体でバブル領域の範囲を線形にマッピングします。

sizedata がベクトルの場合、sizedata、lat および lon のサイズは一致する必要があります。

例: [99 133 150]

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

colordata — バブルの色のカテゴリ

categorical スカラー | categorical ベクトル

バブルの色を決定するカテゴリ。categorical スカラーまたは categorical ベクトルとして指定します。通常、カテゴリはデータが分類されるビンです。

データ型: categorical

parent — 親コンテナー

Figure オブジェクト | Panel オブジェクト | Tab オブジェクト | TiledChartLayout オブジェクト | GridLayout オブジェクト

親コンテナー。Figure オブジェクト、Panel オブジェクト、Tab オブジェクト、TiledChartLayout オブジェクト、または GridLayout オブジェクトとして指定します。

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

例: geobubble(tbl,latvar,lonvar,SizeVariable="MaxHeight",ColorVariable="Cause") は、バブルのサイズのデータとバブルの色のデータを含む table 変数を指定します。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: geobubble(tbl,latvar,lonvar,"SizeVariable","MaxHeight","ColorVariable","Cause") は、バブルのサイズのデータとバブルの色のデータを含む table 変数を指定します。

メモ

名前と値の引数を使用して、この関数で作成された GeographicBubbleChart オブジェクトのプロパティの値を指定します。ここには一部のプロパティのみを示します。完全な一覧については、GeographicBubbleChart のプロパティ を参照してください。

Basemap — データがプロットされるマップ

'streets-light' | 'streets-dark' | 'streets' | 'satellite' | 'topographic' | ...

データがプロットされるマップ。表にリストされている値のいずれかとして指定します。6 つのベースマップは、Natural Earth を使用して作成されたタイル表示のデータ セットです。5 つのベースマップは、Esri^® によってホストされる高ズームレベルのマップです。

	'streets-light' (既定) 地理コンテキストを提供し、明るい背景にユーザー データを強調表示するように設計されたマップ。 Esri によりホストされています。		'streets-dark' 地理コンテキストを提供し、暗い背景にユーザー データを強調表示するように設計されたマップ。 Esri によりホストされています。
	'streets' 道路と輸送網を正確で見やすいスタイルで強調した汎用道路マップ。 Esri によりホストされています。		'satellite' 高解像度の衛星写真で構成される地球全体のベースマップ。 Esri によりホストされています。
	'topographic' 地形的な特徴を示すスタイルを備えた汎用マップ。 Esri によりホストされています。		'landcover' 衛星から得られた土地被覆データ、影付きの起伏および海底起伏を組み合わせたマップ。主題マップと参照マップには、明るくナチュラルなパレットが適しています。 Natural Earth を使用して作成されています。
	'colorterrain' 土地被覆パレットとブレンドされた影付き起伏マップ。高湿度の低地は緑、乾燥した低地は茶。 Natural Earth を使用して作成されています。		'grayterrain' グレー階調の地形マップ。影付きの起伏により、高山と、低地で検出された微小地形の両方が強調されます。 Natural Earth を使用して作成されています。
	'bluegreen' 2 トーンの陸海マップ。陸地部分は薄い緑、水域は薄い青。 Natural Earth を使用して作成されています。		'grayland' 2 トーンの陸海マップ。陸地部分はグレー、水域は白。 Natural Earth を使用して作成されています。
	'darkwater' 2 トーンの陸海マップ。陸地部分はライト グレー、水域はダーク グレー。このベースマップは MATLAB® と共にインストールされています。 Natural Earth を使用して作成されています。		'none' 空白の背景。緯度経度グリッド、目盛り、ラベルを使用してデータをプロットします。

'darkwater' 以外のすべてのベースマップで、インターネット アクセスが必要です。'darkwater' ベースマップは、MATLAB に含まれています。

インターネットへの安定したアクセスがない場合、アドオン エクスプローラーを使用して、Natural Earth を使用して作成されたベースマップをローカル システムにダウンロードできます。5 つの高ズームレベル マップはダウンロードできません。ローカル システムでのベースマップのダウンロードと、既定のベースマップの変更の詳細については、地理座標軸とチャートのベースマップへのアクセスを参照してください。

Esri によってホストされるベースマップは定期的に更新されます。そのため、可視化で表示される内容は時間が経過すると変わることがあります。

境界の配置と地域ラベルはデータ ベンダーが提供する機能による表現であり、MathWorks^® の承認を意味するものではありません。

データ型: char | string

MapLayout — マップのレイアウト

'normal' (既定値) | 'maximized'

はめ込みや装飾を含むマップのレイアウト。'normal' または 'maximized' として指定します。

値	説明	図
'normal'	マップは、OuterPosition プロパティの定義に従って、チャートの端からはめ込まれます。座標軸ラベル、目盛り、および目盛りラベルが表示されます。タイトルが指定されている場合、タイトルが表示されます。凡例が存在する場合、マップの右外側に表示されます。
'maximized'	マップが OuterPosition プロパティで定義された全空間を埋めます。座標軸ラベル、目盛り、および目盛りラベルは非表示になります。タイトルが指定されている場合でも、タイトルは非表示になります。GridVisible プロパティの値が 'on' の場合でも、グリッドは非表示になります。凡例が存在する場合、マップ内の右上隅に表示されます。

データ型: char | string

SizeVariable — バブルのサイズのデータを含む table 変数

table 変数インデックス

バブルのサイズのデータを含む table 変数。次のインデックス方式のいずれかを使用して指定します。

インデックス方式	例
変数名: string スカラーまたは文字ベクトル。 pattern オブジェクト。pattern オブジェクトは 1 つの変数のみを参照しなければなりません。	"A" または 'A' — A という名前の変数 "Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。	3 — table の 3 番目の変数 [false false true] — 3 番目の変数
変数の型: 指定したタイプの table 変数を選択する vartype 添字。添字は 1 つの変数のみを参照しなければなりません。	vartype("double") — double 値を含んでいる変数

指定する変数には、任意の数値型を含めることができます。SizeVariable プロパティを設定すると、MATLAB は SizeData プロパティを更新します。

ColorVariable — バブルの色のデータを含む table 変数

table 変数インデックス

バブルの色のデータを含む table 変数。次のインデックス方式のいずれかを使用して指定します。

インデックス方式	例
変数名: string スカラーまたは文字ベクトル。 pattern オブジェクト。pattern オブジェクトは 1 つの変数のみを参照しなければなりません。	"A" または 'A' — A という名前の変数 "Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。	3 — table の 3 番目の変数 [false false true] — 3 番目の変数
変数の型: 指定したタイプの table 変数を選択する vartype 添字。添字は 1 つの変数のみを参照しなければなりません。	vartype("double") — double 値を含んでいる変数

指定する変数には、categorical 値が含まれていなければなりません。ColorVariable プロパティを設定すると、MATLAB は ColorData プロパティを更新します。

出力引数

gb — 地理バブル チャート

GeographicBubbleChart オブジェクト

地理バブル チャート。GeographicBubbleChart オブジェクトとして返されます。geobubble 関数で作成された地理バブル チャートはスタンドアロンの可視化です。gb を使用して、地理バブル チャートの作成後にそのプロパティを設定します。

詳細

地理バブル チャート

"地理バブル チャート" は、データに地理コンテキストを提供するベースマップを含むマップ上にデータを表示します。最初に、このチャートはすべてのデータを含むマップの地理的範囲を設定します。このマップはライブなので、ベースマップをパンして他の地理的位置を表示できます。マップをズームインおよびズームアウトして、領域をより詳細に表示することもできます。パンおよびズームによりチャートでマップが更新されます。

スタンドアロンの可視化

スタンドアロンの可視化は、特定の目的のために設計され、他のチャートとは独立して機能するチャートです。スタンドアロンの可視化は、plot や surf といった他のチャートとは異なり、あらかじめ設定された axes オブジェクトが組み込まれていて、カスタマイズできる項目が限られています。また、スタンドアロンの可視化には以下の特徴があります。

• ライン、パッチ、表面といった他のグラフィックス要素と組み合わせることはできません。そのため、hold コマンドはサポートされていません。

• 関数 gca は、現在の座標軸としてチャート オブジェクトを返すことができます。

• 入力引数として axes オブジェクトを受け入れる多くの MATLAB 関数にチャート オブジェクトを渡すことができます。たとえば、関数 title にチャート オブジェクトを渡すことができます。

ヒント

• table から地理バブル チャート オブジェクトを作成する場合、そのデータ ヒントをカスタマイズできます。

  • データ ヒントに対して行を追加または削除するには、チャート上の任意の場所を右クリックし、[データ ヒントの変更] をポイントします。次に、変数を選択または選択解除します。

  • 複数の行を追加または削除するには、チャート上で右クリックして [データ ヒントの変更] をポイントし、[詳細] を選択します。次に、[>>] をクリックして変数を追加するか、[<<] をクリックして変数を削除します。

• プログラムにより地理バブル チャートにフォーカスを移すには、関数 axes を axes(gb) のように使用します。

• 地理座標軸上でプロットする場合、関数 geobubble では、座標は WGS84 座標参照系を基準とすると仮定します。別の座標参照系を基準とする座標を使用してプロットすると、座標がずれて表示される可能性があります。

代替機能

• 地理バブル チャートでは、バブルのライン幅の変更、バブルの透明度の変更、テキストとラインの注釈の追加などのカスタマイズはサポートされていません。より多くのカスタマイズをサポートする同様のチャートを作成するには、geoaxes および bubblechart 関数を使用して地理座標軸でバブル チャートを作成します。そのようなチャートの作成方法を示す例については、Combine Bubble Chart with Other Graphics in Geographic Axesを参照してください。

• map axes オブジェクト (Mapping Toolbox™) にバブル チャートを作成するには、関数 bubblechart を使用します。

バージョン履歴

R2017b で導入

参考

関数

• categorical | geobasemap | geoscatter | bubblechart | geoplot

プロパティ

• GeographicBubbleChart のプロパティ

トピック

• table 内のデータへのアクセス
• table データからのスタンドアロンの地理バブル チャートの作成
• スタンドアロンの地理バブル チャートでのバブルの制御