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) は、table tbl から地理バブル チャートを作成します。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^® の承認を意味するものではありません。

例: gb = geobubble(1:10,1:10,'Basemap','bluegreen')

例: gb.Basemap = 'bluegreen'

データ型: char | string

MapLayout — マップのレイアウト

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

マップのレイアウト (はめ込みと装飾を含む)。次のいずれかとして指定します。

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

例: gb = geobubble(__,'MapLayout','maximized')

例: gb.MapLayout = 'maximized'

データ型: 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 オブジェクトとして返されます。地理バブル チャートはスタンドアロンの可視化です。gb を使用して、地理バブル チャートの作成後にプロパティを設定します。

詳細

地理バブル チャート

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

スタンドアロンの可視化

スタンドアロンの可視化は、他のチャートから独立して機能する特別な目的のために設計されたチャートです。plot および surf のような他のチャートとは異なり、スタンドアロンの可視化には事前構成済みの axes オブジェクトが組み込まれています。一部のカスタマイズは使用できません。スタンドアロンの可視化には次のような特徴もあります。

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

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

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

ヒント

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

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

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

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

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

代替機能

• 地理バブル チャートでは、バブルのライン幅の変更、バブルの透明度の変更、テキストとラインの注釈の追加などのカスタマイズはサポートされていません。より多くのカスタマイズをサポートする同様のチャートを作成するには、関数 geoaxes を使用して geographic axes オブジェクトを作成します。次に、関数 bubblechart を使用して geographic axes オブジェクトにバブル チャートを作成します。

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

バージョン履歴

R2017b で導入

参考

関数

• geobasemap | geoscatter | bubblechart | geoplot

プロパティ

• GeographicBubbleChart のプロパティ

トピック

• table 内のデータへのアクセス
• table データからの地理バブル チャートの作成
• 地理バブル チャートのプロパティの使用
• 地理座標軸とチャートの展開
• 地理座標軸とチャートのベースマップへのアクセス
• 地理バブル チャートの概要