Main Content

geoplot

地理座標にラインをプロット

  • Plot line in geographic coordinates

説明

ベクトル データ

geoplot(lat,lon) は地理座標にラインをプロットします。lat を使用して緯度座標 (度単位) を指定し、lon を使用して経度座標 (度単位) を指定します。現在の座標軸が地理座標軸でもマップ座標軸でもない場合、または現在の座標軸がない場合は、関数は新しい地理座標軸にラインをプロットします。

geoplot(lat,lon,LineSpec) は、指定されたライン スタイル、マーカー、シンボル、および色を使用してプロットを作成します。

geoplot(lat1,lon1,...,latN,lonN) は、同じ座標軸に複数のラインを使用して、緯度と経度の座標のペアをプロットします。

geoplot(lat1,lon1,LineSpec1,...,latN,lonN,LineSpecN) は、各ラインのライン スタイル、マーカー記号および色を指定します。LineSpec を一部のラインに対して指定し、その他に対しては省略することができます。たとえば、geoplot(lat1,lon1,"o",lat2,lon2) は、最初のラインに対してマーカーを指定しますが、2 番目のラインに対しては指定しません。

テーブル データ

geoplot(tbl,latvar,lonvar) は、table tbl の変数 latvar および lonvar をプロットします。1 つのデータ セットをプロットするには、latvarlonvar にそれぞれ 1 つの変数を指定します。複数のデータ セットをプロットするには、latvarlonvar、またはその両方に複数の変数を指定します。両方の引数に複数の変数を指定する場合は、同数の変数を指定しなければなりません。(R2022b 以降)

追加オプション

geoplot(ax,___) は、ax で指定した座標軸にプロットを表示します。前述の任意の構文で、最初の引数として座標軸を指定します。

geoplot(___,Name,Value) は、1 つ以上の名前と値の引数を使用してチャート ラインのプロパティを指定します。このプロパティはプロットされるすべてのラインに適用されます。プロパティの一覧については、Line のプロパティ を参照してください。

h = geoplot(___) は chart line オブジェクトの列ベクトルを返します。各オブジェクトはプロットされる 1 つのラインに対応します。プロットのプロパティを作成後に変更するには、h を使用します。プロパティの一覧については、Line のプロパティ を参照してください。

メモ

Mapping Toolbox™ は、MATLAB® 関数 geoplot の機能を拡張します。これにより、サポートされている任意の地理または投影座標参照系 (CRS) の座標を使用して点、ライン、多角形を表示できるようになります。geoplot (Mapping Toolbox) ページについては、geoplot (Mapping Toolbox) を参照してください。

すべて折りたたむ

隣接する米国の境界の座標を含む MAT ファイルを読み込みます。MAT ファイル内の変数 uslat および uslon では、それぞれ緯度と経度の座標を度単位で指定します。地形ベースマップに座標を表示します。

load usapolygon.mat
geoplot(uslat,uslon)
geobasemap topographic

隣接する米国の各州の座標を含む MAT ファイルを読み込みます。インディアナ州、テネシー州、およびウェスト バージニア州の座標を抽出します。

load usastates.mat

lat1 = usastates(12).Lat;
lon1 = usastates(12).Lon;

lat2 = usastates(40).Lat;
lon2 = usastates(40).Lon;

lat3 = usastates(46).Lat;
lon3 = usastates(46).Lon;

3 つのラインを使用して州の輪郭を表示します。

geoplot(lat1,lon1,lat2,lon2,lat3,lon3)

Figure contains an axes object with type geoaxes. The geoaxes object contains 3 objects of type line.

ドイツのハイウェイに沿った複数の点の緯度と経度の座標を指定します。円形マーカーをもつ黒色の破線を使用して、streets ベースマップにラインとして点を表示します。

lat = [48.915 48.907 48.901 48.893 48.887 48.881 48.875 48.869 48.865];
lon = [10.192 10.188 10.182 10.171 10.166 10.165 10.167 10.173 10.184];

geoplot(lat,lon,"k--o")
geobasemap streets

ミシシッピ川に沿った複数の点の緯度と経度の座標を指定します。

lat = [32.30 33.92 35.17 36.98 37.69 38.34];
lon = [-91.05 -91.18 -90.09 -89.11 -89.52 -90.37];

データからライン プロットを作成します。LineSpec オプションを使用して四角形のマーカーをもつ緑色の破線を指定します。名前と値の引数を使用してラインの幅、マーカー サイズおよびマーカーの色を指定します。

geoplot(lat,lon,"--gs","LineWidth",2, ...
    "MarkerSize",10,"MarkerEdgeColor","b", ...
    "MarkerFaceColor",[0.5 0.5 0.5])

プロットの緯度と経度の範囲を調整して、ズームアウトします。その後、ベースマップを地形ベースマップに変更します。

geolimits([31.60 38.91],[-95.61 -84.27])
geobasemap grayterrain

Figure contains an axes object. The axes object contains an object of type line.

ボストンの複数の場所の地理座標および名前を指定します。

lat = [42.3501 42.3598 42.3626 42.3668 42.3557];
lon = [-71.0870 -71.0662 -71.0789 -71.0801 -71.0662];
n = [" BACK BAY"," BEACON HILL"," BROAD CANAL"," EAST CAMBRIDGE"," FLAGSTAFF HILL"];

streets ベースマップに、黒色の星印のマーカーを使用して位置をプロットします。範囲を調整してプロットをズームアウトします。

geoplot(lat,lon,"k*")
geobasemap streets
geolimits([42.3456 42.3694],[-71.0930 -71.0536])

同じ位置に場所の名前を表示します。

text(lat,lon,n)

R2022b 以降

table のデータをプロットするには、table を関数 geoplot に渡してプロット対象の変数を指定すると便利です。

サイクロンのデータを含む MAT ファイルをワークスペースに読み込みます。データのサブセットを使用して table を作成します。table には緯度と経度の座標の各 table 変数 LatitudeLongitude が含まれています。

load cycloneTracks
tbl = cycloneTracks(cycloneTracks.ID == 1320,:);

緯度と経度の座標を地形ベースマップにプロットします。Line オブジェクトを h として返します。

h = geoplot(tbl,"Latitude","Longitude");
geobasemap topographic

Marker および Color プロパティを設定して、プロットのマーカー スタイルと色を変更します。

h.Marker = ".";
h.Color = "m";

入力引数

すべて折りたたむ

緯度座標 (度単位)。ベクトルとして指定します。

NaN 値を使用してラインの途中で間を空けます。たとえば、次のコードは最初の 2 つの要素をプロットし、3 番目の要素をスキップし、最後の 2 つの要素を使用して別のラインをプロットします。

geoplot([10 20 NaN 30 40],[10 20 NaN 30 40])

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

例: [43.0327 38.8921 44.0435]

データ型: single | double

経度座標 (度単位)。ベクトルとして指定します。

NaN 値を使用してラインの途中で間を空けます。たとえば、次のコードは最初の 2 つの要素をプロットし、3 番目の要素をスキップし、最後の 2 つの要素を使用して別のラインをプロットします。

geoplot([10 20 NaN 30 40],[10 20 NaN 30 40])

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

例: [-107.5556 -77.0269 -72.5565]

データ型: single | double

ライン スタイル、マーカー、および色。記号を含む string スカラーまたは文字ベクトルとして指定します。記号の順番は任意です。3 つの特性 (ライン スタイル、マーカーおよび色) をすべて指定する必要はありません。たとえば、ライン スタイルを省略してマーカーを指定する場合、プロットはラインなしでマーカーのみを表示します。

例: "--or" は円形マーカー付きの赤い破線です。

ライン スタイル説明結果として得られる線
"-"実線

Sample of solid line

"--"破線

Sample of dashed line

":"点線

Sample of dotted line

"-."一点鎖線

Sample of dash-dotted line, with alternating dashes and dots

マーカー説明結果のマーカー
"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

"square"正方形

Sample of square marker

"diamond"菱形

Sample of diamond 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

"pentagram"星形五角形

Sample of pentagram marker

"hexagram"星形六角形

Sample of hexagram marker

色名省略名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

プロットするデータが含まれるソース table。table または timetable として指定します。

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

インデックス方式

変数名:

  • string、文字ベクトル、または cell 配列。

  • pattern オブジェクト。

  • "A" または 'A'A という名前の変数

  • ["A","B"] または {'A','B'}A および B という名前の 2 つの変数

  • "Var"+digitsPattern(1)"Var" の後に数字 1 桁が続く名前の変数

変数インデックス:

  • table 内の変数の位置を参照するインデックス番号。

  • 数値のベクトル。

  • logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。

  • 3 — table の 3 番目の変数

  • [2 3] — table の 2 番目と 3 番目の変数

  • [false false true] — 3 番目の変数

変数の型:

  • 指定した型の変数を選択する vartype 添字。

  • vartype("categorical") — categorical 値を含んでいるすべての変数

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

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

latvarlonvar の両方が複数の変数を指定する場合、変数の数は同じでなければなりません。

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

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

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

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

インデックス方式

変数名:

  • string、文字ベクトル、または cell 配列。

  • pattern オブジェクト。

  • "A" または 'A'A という名前の変数

  • ["A","B"] または {'A','B'}A および B という名前の 2 つの変数

  • "Var"+digitsPattern(1)"Var" の後に数字 1 桁が続く名前の変数

変数インデックス:

  • table 内の変数の位置を参照するインデックス番号。

  • 数値のベクトル。

  • logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。

  • 3 — table の 3 番目の変数

  • [2 3] — table の 2 番目と 3 番目の変数

  • [false false true] — 3 番目の変数

変数の型:

  • 指定した型の変数を選択する vartype 添字。

  • vartype("categorical") — categorical 値を含んでいるすべての変数

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

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

latvarlonvar の両方が複数の変数を指定する場合、変数の数は同じでなければなりません。

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

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

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

ターゲットの座標軸。GeographicAxes オブジェクト 1 または MapAxes (Mapping Toolbox) オブジェクトとして指定します。この引数を指定しなかった場合、関数 geoplot は、現在の座標軸が geographic axes オブジェクトまたは map axes オブジェクトであれば、現在の座標軸にプロットします。

名前と値の引数

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

例: geoplot(lat,lon,LineWidth=2) は、2 ポイントのライン幅のラインをプロットします。

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

例: geoplot(lat,lon,"LineWidth",2) は、2 ポイントのライン幅のラインをプロットします。

メモ

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

プロパティの設定はプロットのすべてのラインに適用されます。個別のラインのプロパティを設定するには、出力引数 h を指定してラインのハンドルを取得します。次に、ドット表記を使用して個別ラインのプロパティを設定します。

ラインの色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。

カスタム色を使用する場合は、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

例: "blue"

例: [0 0 1]

例: "#0000FF"

ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。

ライン スタイル説明結果として得られる線
"-"実線

Sample of solid line

"--"破線

Sample of dashed line

":"点線

Sample of dotted line

"-."一点鎖線

Sample of dash-dotted line, with alternating dashes and dots

"none"ラインなしラインなし

ライン幅。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。ラインがマーカーをもつ場合、ライン幅はマーカー エッジにも影響します。

ライン幅をピクセルの幅より細くすることはできません。システムでライン幅をピクセルの幅より細い値に設定すると、ラインは 1 ピクセル幅で表示されます。

マーカー記号。次の表のマーカーのいずれかとして指定します。既定では、チャート ラインにマーカーはありません。マーカー記号を指定することで、ライン上の各データ点にマーカーが追加されます。

マーカー説明結果のマーカー
"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

"square"正方形

Sample of square marker

"diamond"菱形

Sample of diamond 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

"pentagram"星形五角形

Sample of pentagram marker

"hexagram"星形六角形

Sample of hexagram marker

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

マーカーの塗りつぶし色。"auto"、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。"auto" オプションは親座標軸の Color プロパティと同じ色を使用します。"auto" を指定し、座標軸のプロット ボックスが非表示の場合、マーカーの塗りつぶし色は Figure の色です。

カスタム色を使用する場合は、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

マーカー サイズ。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。

出力引数

すべて折りたたむ

地理プロット。Line オブジェクトの列ベクトルとして返されます。各オブジェクトはプロットされる 1 つのラインに対応します。h を使用して、オブジェクトの作成後にオブジェクトのプロパティを変更します。

ヒント

  • geoglobe (Mapping Toolbox) および geoplot3 (Mapping Toolbox) を使用して 3 次元地理データをプロットします。

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

  • 関数 geoplot は座標軸の ColorOrder プロパティと LineStyleOrder プロパティに基づく色とライン スタイルを使用します。関数は最初のライン スタイルで色を順番に使用します。次に、以降のライン スタイルのそれぞれについて再び色を順番に使用します。

  • 直交座標軸を必要とするデータを地理座標軸またはマップ座標軸にプロットすることはサポートされていません。

  • 座標軸に追加のデータをプロットするには、hold on コマンドを使用します。

バージョン履歴

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®.