Main Content

geoscatter

  • Scatter chart in geographic coordinates

説明

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

geoscatter(lat,lon,A) は、A を使用して、各マーカーの面積 (ポイントの 2 乗) を指定します。すべてのマーカーを同じサイズで描画するには、A をスカラーとして指定します。マーカーをさまざまなサイズで描画するには、Alat および 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

入力引数

すべて折りたたむ

緯度座標 (度単位)。[-90 90] の範囲内の有限の実数値ベクトルとして指定します。ベクトルは埋め込まれた NaN を含むことができます。latlon と同じサイズでなければなりません。

例: [43.0327 38.8921 44.0435]

データ型: single | double

経度座標 (度単位)。有限の実数値ベクトルとして指定します。ベクトルは埋め込まれた NaN を含むことができます。lonlat と同じサイズでなければなりません。

例: [-107.5556 -77.0269 -72.5565]

データ型: single | double

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

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

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

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

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

例: 50

例: [36 25 25 17 46]

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

  • 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]

Sample of the color red

'green''g'[0 1 0]

Sample of the color green

'blue''b'[0 0 1]

Sample of the color blue

'cyan' 'c'[0 1 1]

Sample of the color cyan

'magenta''m'[1 0 1]

Sample of the color magenta

'yellow''y'[1 1 0]

Sample of the color yellow

'black''k'[0 0 0]

Sample of the color black

'white''w'[1 1 1]

Sample of the color white

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

例: 'green'

例: 'g'

例: [0 1 0]

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

マーカー説明結果のマーカー
'o'

Sample of circle marker

'+'プラス記号

Sample of plus sign marker

'*'アスタリスク

Sample of asterisk marker

'.'

Sample of point marker

'x'十字

Sample of cross marker

'_'水平線

Sample of horizontal line marker

'|'垂直線

Sample of vertical line marker

's'正方形

Sample of square marker

'd'菱形

Sample of diamond line marker

'^'上向き三角形

Sample of upward-pointing triangle marker

'v'下向き三角形

Sample of downward-pointing triangle marker

'>'右向き三角形

Sample of right-pointing triangle marker

'<'左向き三角形

Sample of left-pointing triangle marker

'p'星形五角形

Sample of pentagram marker

'h'星形六角形

Sample of hexagram marker

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

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

名前と値の引数

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

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

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

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

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

マーカー説明結果のマーカー
'o'

Sample of circle marker

'+'プラス記号

Sample of plus sign marker

'*'アスタリスク

Sample of asterisk marker

'.'

Sample of point marker

'x'十字

Sample of cross marker

'_'水平線

Sample of horizontal line marker

'|'垂直線

Sample of vertical line marker

's'正方形

Sample of square marker

'd'菱形

Sample of diamond line marker

'^'上向き三角形

Sample of upward-pointing triangle marker

'v'下向き三角形

Sample of downward-pointing triangle marker

'>'右向き三角形

Sample of right-pointing triangle marker

'<'左向き三角形

Sample of left-pointing triangle marker

'p'星形五角形

Sample of pentagram marker

'h'星形六角形

Sample of hexagram marker

'none'マーカーなし該当なし

マーカーの輪郭の色。'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'

Sample of the color red

'green''g'[0 1 0]'#00FF00'

Sample of the color green

'blue''b'[0 0 1]'#0000FF'

Sample of the color blue

'cyan' 'c'[0 1 1]'#00FFFF'

Sample of the color cyan

'magenta''m'[1 0 1]'#FF00FF'

Sample of the color magenta

'yellow''y'[1 1 0]'#FFFF00'

Sample of the color yellow

'black''k'[0 0 0]'#000000'

Sample of the color black

'white''w'[1 1 1]'#FFFFFF'

Sample of the color white

'none'該当なし該当なし該当なし色なし

MATLAB® の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]'#0072BD'

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]'#D95319'

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]'#EDB120'

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]'#7E2F8E'

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]'#77AC30'

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]'#4DBEEE'

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]'#A2142F'

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

例: [0.5 0.5 0.5]

例: 'blue'

例: '#D2F9A7'

マーカーの塗りつぶし色。'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'

Sample of the color red

'green''g'[0 1 0]'#00FF00'

Sample of the color green

'blue''b'[0 0 1]'#0000FF'

Sample of the color blue

'cyan' 'c'[0 1 1]'#00FFFF'

Sample of the color cyan

'magenta''m'[1 0 1]'#FF00FF'

Sample of the color magenta

'yellow''y'[1 1 0]'#FFFF00'

Sample of the color yellow

'black''k'[0 0 0]'#000000'

Sample of the color black

'white''w'[1 1 1]'#FFFFFF'

Sample of the color white

'none'該当なし該当なし該当なし色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]'#0072BD'

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]'#D95319'

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]'#EDB120'

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]'#7E2F8E'

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]'#77AC30'

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]'#4DBEEE'

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]'#A2142F'

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

例: [0.3 0.2 0.1]

例: 'green'

例: '#D2F9A7'

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

例: 0.75

出力引数

すべて折りたたむ

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

ヒント

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

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

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

バージョン履歴

R2018b で導入

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