geoscatter

地理座標の散布図

• 

×

構文

geoscatter(lat,lon)

geoscatter(lat,lon,A)

geoscatter(lat,lon,A,C)

geoscatter(___,M)

geoscatter(___,'filled')

geoscatter(___,Name,Value)

geoscatter(gx,___)

s = geoscatter(___)

説明

geoscatter(lat,lon) は、ベクトル lat および lon で指定された緯度経度位置 (度単位) で、地理座標軸に色付きの円を表示します。lat と lon は同じサイズでなければなりません。

geoscatter(lat,lon,A) は、A を使用して、各マーカーの面積 (ポイントの 2 乗) を指定します。すべてのマーカーを同じサイズで描画するには、A をスカラーとして指定します。マーカーをさまざまなサイズで描画するには、A を lat および lon と同じ長さのベクトルとして指定します。A を設定しない場合、geoscatter は既定のサイズを使用します。

geoscatter(lat,lon,A,C) は、C を使用して各マーカーの色を指定します。

geoscatter(___,M) は、散布図を作成します。ここで、M は使用するマーカーを指定します。既定では、geoscatter はマーカーとして円を使用します。

geoscatter(___,'filled') は、マーカーを塗りつぶします。

geoscatter(___,Name,Value) は、1 つ以上の Name,Value ペア引数を使用して、散布図のプロパティを指定します。このプロパティの設定はすべての散布図に適用されます。

geoscatter(gx,___) は、現在の座標軸の代わりに、gx で指定される地理座標軸にプロットします。

s = geoscatter(___) は、Scatter オブジェクトを返します。オブジェクトを作成した後でそのプロパティを変更するには、S を使用します。

例

地理的散布図を作成してマーカーの色、サイズ、形状を制御

緯度データと経度データを設定します。

lon = (-170:10:170);
lat = 50 * cosd(3*lon);

各マーカーの面積を制御するデータを定義します。

A = 101 + 100*(sind(2*lon));

各マーカーの色を制御するデータを定義します。

C = cosd(4*lon);

データを地理的散布図にプロットし、マーカーのサイズのデータと色のデータを指定します。マーカーを既定の円ではなく三角形に指定します。

geoscatter(lat,lon,A,C,'^')

ベースマップを指定した地理的散布図の作成

緯度データと経度データを設定します。

lon = (-170:10:170);
lat = 50 * cosd(3*lon);

各マーカーの面積を制御するデータを定義します。

A = 101 + 100*(sind(2*lon));

各マーカーの色を制御するデータを定義します。

C = cosd(4*lon);

1 組の地理座標軸に散布図を作成し、マーカー サイズのデータと色のデータを指定します。この例では、マーカーは既定の円ではなく三角形として指定されます。

geoscatter(lat,lon,A,C,'^')

地理的散布図のベースマップを変更します。

geobasemap colorterrain

入力引数

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

A — 平方ポイント単位のマーカーのサイズ

36 (既定値) | スカラー | ベクトル | []

平方ポイント単位のマーカーのサイズ。次のいずれかの形式で指定します。

• スカラー — 一様なマーカー サイズ。たとえば、A = 100 はすべてのマーカーを 100 平方ポイントの大きさで作成します。

• ベクトル — データ点ごとに異なるマーカー サイズ。ベクトルは lat および lon と同じ長さでなければなりません。

• 空の大かっこ [] — 36 平方ポイントの既定のマーカー サイズ。色の入力引数を指定する場合に既定のマーカー サイズを使用するには、このオプションを使用します (geoscatter(lat,lon,[],c) など)。

scatter オブジェクトの SizeData プロパティはマーカー サイズを保存します。

例: 50

例: [36 25 25 17 46]

C — マーカーの色

RGB 3 成分 | RGB 3 成分から成る 3 列の行列 | ベクトル | 'r' | 'g' | 'b' | ...

マーカーの色。次のいずれかの形式で指定します。

• RGB 3 成分または色名 — すべてのマーカーを同じ色でプロットします。

• RGB 3 成分から成る 3 列の行列 — マーカーごとに異なる色を使用します。行列の各行で対応するマーカーの色の RGB 3 成分を指定します。行数は lat および lon の長さと等しくなければなりません。

• ベクトル — マーカーごとに異なる色を使用し、C の値を現在のカラーマップに線形にマッピングします。C の長さは lat および lon の長さと等しくなければなりません。座標軸のカラーマップを変更するには関数 colormap を使用します。

RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、色の完全名および省略名のオプションと、等価の RGB 3 成分の値を示します。

色名	省略名	RGB 3 成分	外観
'red'	'r'	[1 0 0]
'green'	'g'	[0 1 0]
'blue'	'b'	[0 0 1]
'cyan'	'c'	[0 1 1]
'magenta'	'm'	[1 0 1]
'yellow'	'y'	[1 1 0]
'black'	'k'	[0 0 0]
'white'	'w'	[1 1 1]

マーカーの色を指定する場合、geoscatter は Scatter オブジェクトの MarkerFaceColor プロパティを 'flat' に設定し、マーカーの色を CData プロパティに保存します。

例: 'green'

例: 'g'

例: [0 1 0]

M — マーカー記号

'o' (既定値) | '+' | '*' | '.' | 'x' | ...

マーカー記号。次の値のいずれかとして指定します。

マーカー	説明	結果のマーカー
'o'	円
'+'	プラス記号
'*'	アスタリスク
'.'	点
'x'	十字
'_'	水平線
'|'	垂直線
's'	正方形
'd'	菱形
'^'	上向き三角形
'v'	下向き三角形
'>'	右向き三角形
'<'	左向き三角形
'p'	星形五角形
'h'	星形六角形

'filled' — マーカーの内部を塗りつぶすオプション

'filled'

マーカーの内部を塗りつぶすオプション。'filled' として指定します。このオプションは、たとえば 'o' や 'square' などの面があるマーカーに使用します。

gx — 親 geographic axes オブジェクト

GeographicAxes オブジェクト

親 geographic axes オブジェクト。GeographicAxes オブジェクトとして指定します。 ¹ プロパティを設定することで GeographicAxes オブジェクトの外観と動作を変更できます。プロパティの一覧については、GeographicAxes のプロパティ を参照してください。

名前と値の引数

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

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

例: geoscatter(lat,lon,'filled','MarkerFaceAlpha',.5) は、塗りつぶされた半透明のマーカーを作成します。

ここでは、scatter オブジェクトのプロパティの一部だけを紹介しています。完全な一覧については、Scatter のプロパティ を参照してください。

Marker — マーカー タイプ

'o' (既定値) | '+' | '*' | '.' | 'x' | ...

マーカー記号。次のオプションのいずれかとして指定します。

マーカー	説明	結果のマーカー
'o'	円
'+'	プラス記号
'*'	アスタリスク
'.'	点
'x'	十字
'_'	水平線
'|'	垂直線
's'	正方形
'd'	菱形
'^'	上向き三角形
'v'	下向き三角形
'>'	右向き三角形
'<'	左向き三角形
'p'	星形五角形
'h'	星形六角形
'none'	マーカーなし	該当なし

MarkerEdgeColor — マーカーの輪郭の色

'flat' (既定値) | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

マーカーの輪郭の色。'flat'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。既定値の 'flat' を指定すると、CData プロパティからの色が使用されます。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。

• RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

• 16 進数カラー コードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。これらの値では大文字小文字は区別されません。したがって、カラー コード '#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.5 0.5 0.5]

例: 'blue'

例: '#D2F9A7'

MarkerFaceColor — マーカーの塗りつぶし色

'none' (既定値) | 'flat' | 'auto' | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

マーカーの塗りつぶし色。'flat'、'auto'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。'flat' オプションは CData 値を使用します。'auto' オプションは座標軸の Color プロパティと同じ色を使用します。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。

• RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

• 16 進数カラー コードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。これらの値では大文字小文字は区別されません。したがって、カラー コード '#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.3 0.2 0.1]

例: 'green'

例: '#D2F9A7'

LineWidth — マーカー エッジの幅

0.5 (既定値) | 正の値

マーカー エッジの幅。ポイント単位の正の値として指定します。

例: 0.75

出力引数

s — 地理的散布図

Scatter オブジェクト

地理的散布図。Scatter オブジェクトとして返されます。地理的散布図の作成後にプロパティにアクセスして変更するには、s を使用します。

ヒント

• scatter オブジェクトを含む地理座標軸をカスタマイズするには、gx = s.Parent でオブジェクトの親を取得し、プロパティを編集します。プロパティの一覧については、GeographicAxes のプロパティ を参照してください。

• Mapping Toolbox™ をお持ちの場合、関数 addCustomBasemap を使用して独自のベースマップを指定できます。

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

バージョン履歴

R2018b で導入

参考

関数

• geoaxes | geoplot | scatter | geolimits | geobubble | geobasemap

プロパティ

• Scatter のプロパティ | GeographicAxes のプロパティ

---

¹ Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks^®.

×

例を開く

この例の変更されたバージョンがあります。編集された方の例を開きますか?

いいえ、変更されたバージョンを上書きします。 はい