このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
geoplot
R2026a地理座標にラインをプロット
構文
説明
ベクトル データ
テーブル データ
追加オプション
geoplot( は、ax,___)ax で指定した座標軸にプロットを表示します。前述の任意の構文で、最初の引数として座標軸を指定します。
geoplot(___, は、1 つ以上の名前と値の引数を使用してチャート ラインのプロパティを指定します。このプロパティはプロットされるすべてのラインに適用されます。プロパティの一覧については、Line のプロパティ を参照してください。Name,Value)
h = geoplot(___)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) geolimits([33.5 42.2],[-93.0 -75.5])
ドイツのハイウェイに沿った複数の点の緯度と経度の座標を指定します。円形マーカーをもつ黒色の破線を使用して、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.6 38.8],[-97 -83])
geobasemap grayterrain
ボストンの複数の場所の地理座標および名前を指定します。
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"];
topographic ベースマップに、黒色の星印のマーカーを使用して位置をプロットします。範囲を調整してプロットをズームアウトします。
geoplot(lat,lon,"k*") geobasemap topographic geolimits([42.3456 42.3694],[-71.0977 -71.0489])
同じ位置に場所の名前を表示します。
text(lat,lon,n)
R2022b 以降
table のデータをプロットするには、table を関数 geoplot に渡してプロット対象の変数を指定すると便利です。
サイクロンのデータ [1] を含む MAT ファイルをワークスペースに読み込みます。データのサブセットを使用して table を作成します。table には緯度と経度の座標の各 table 変数 Latitude と Longitude が含まれています。
load cycloneTracks.mat
tbl = cycloneTracks(cycloneTracks.ID == 1320,:);緯度と経度の座標を地形ベースマップにプロットします。Line オブジェクトを h として返します。
h = geoplot(tbl,"Latitude","Longitude"); geobasemap topographic
Marker および Color プロパティを設定して、プロットのマーカー スタイルと色を変更します。
h.Marker = "."; h.Color = "m";
[1] この例では、日本の気象庁の RSMC Best Track Data を修正して使用しています。
入力引数
緯度座標 (度単位)。範囲 [–90, 90] の要素をもつベクトルとして指定します。
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" は円形マーカー付きの赤い破線です。
| ライン スタイル | 説明 | 結果として得られる線 |
|---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
| マーカー | 説明 | 結果のマーカー |
|---|---|---|
"o" | 円 |
|
"+" | プラス記号 |
|
"*" | アスタリスク |
|
"." | 点 |
|
"x" | 十字 |
|
"_" | 水平線 |
|
"|" | 垂直線 |
|
"square" | 正方形 |
|
"diamond" | 菱形 |
|
"^" | 上向き三角形 |
|
"v" | 下向き三角形 |
|
">" | 右向き三角形 |
|
"<" | 左向き三角形 |
|
"pentagram" | 星形五角形 |
|
"hexagram" | 星形六角形 |
|
| 色名 | 省略名 | 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] |
|
プロットするデータが含まれるソース table。table または timetable として指定します。
緯度座標を含む table 変数。table のインデックス方式の 1 つを使用して指定します。
| インデックス方式 | 例 |
|---|---|
変数名:
|
|
変数インデックス:
|
|
変数の型:
|
|
変数名に関係なく、プロットの軸ラベルは常に Latitude です。
変数には、single または double 型の数値データが含まれていなければなりません。データは、[–90, 90] の範囲内でなければなりません。
latvar と lonvar の両方が複数の変数を指定する場合、変数の数は同じでなければなりません。
例: geoplot(tbl,["lat1","lat2"],"lon") は、緯度座標用に lat1 および lat2 という名前の table 変数を指定します。
例: geoplot(tbl,2,"lon") は、緯度座標用に 2 番目の変数を指定します。
例: geoplot(tbl,vartype("numeric"),"lon") は、緯度座標用にすべての数値変数を指定します。
経度座標を含む table 変数。table のインデックス方式の 1 つを使用して指定します。
| インデックス方式 | 例 |
|---|---|
変数名:
|
|
変数インデックス:
|
|
変数の型:
|
|
変数名に関係なく、プロットの軸ラベルは常に Longitude です。
指定する変数には、single または double 型の数値データが含まれていなければなりません。
latvar と lonvar の両方が複数の変数を指定する場合、変数の数は同じでなければなりません。
例: 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" |
|
"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" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。
R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。
例: "blue"
例: [0 0 1]
例: "#0000FF"
ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。
| ライン スタイル | 説明 | 結果として得られる線 |
|---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
マーカー記号。次の表のマーカーのいずれかとして指定します。既定では、チャート ラインにマーカーはありません。マーカー記号を指定することで、ライン上の各データ点にマーカーが追加されます。
| マーカー | 説明 | 結果のマーカー |
|---|---|---|
"o" | 円 |
|
"+" | プラス記号 |
|
"*" | アスタリスク |
|
"." | 点 |
|
"x" | 十字 |
|
"_" | 水平線 |
|
"|" | 垂直線 |
|
"square" | 正方形 |
|
"diamond" | 菱形 |
|
"^" | 上向き三角形 |
|
"v" | 下向き三角形 |
|
">" | 右向き三角形 |
|
"<" | 左向き三角形 |
|
"pentagram" | 星形五角形 |
|
"hexagram" | 星形六角形 |
|
"none" | マーカーなし | 該当なし |
あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の 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" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。
R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。
出力引数
ヒント
geoglobe(Mapping Toolbox) およびgeoplot3(Mapping Toolbox) を使用して 3 次元地理データをプロットします。地理座標軸上でプロットする場合、関数
geoplotでは、座標は WGS84 座標参照系を基準とすると仮定します。別の座標参照系を基準とする座標を使用してプロットすると、座標がずれて表示される可能性があります。関数
geoplotは座標軸のColorOrderプロパティとLineStyleOrderプロパティに基づく色とライン スタイルを使用します。関数は最初のライン スタイルで色を順番に使用します。次に、以降のライン スタイルのそれぞれについて再び色を順番に使用します。直交座標軸を必要とするデータを地理座標軸またはマップ座標軸にプロットすることはサポートされていません。
座標軸に追加のデータをプロットするには、
hold onコマンドを使用します。
バージョン履歴
R2018b で導入関数 geoplot や geoscatter などを使用して地理座標軸にプロットする場合、MATLAB はベースマップをリセットしません。R2022a 以前のリリースでは、新規プロットを追加すると、ベースマップがリセットされます。
これにより、コマンド間で関数 hold を使用しなくても、ベースマップを指定した後にデータを可視化できます。たとえば、次のコードは streets ベースマップを使用するマップを作成します。その後、ベースマップ上にプロットを表示します。R2022b では、ベースマップはリセットされません。R2022a 以前のリリースでは、ベースマップは既定の streets-light にリセットされます。
lat = [35 -22 51 39 37 42 47 -33]; lon = [139 -43 0 116 23 -71 -122 18]; figure geobasemap streets geoplot(lat,lon,"m*")
この変更は、コマンド間で hold 状態を "on" に設定する既存のコードには影響しません。
新しいプロットの追加時にベースマップをリセットするには、プロットを作成する前に、関数 cla の cla reset 構文を使用します。たとえば、前述のコードを更新するには、geobasemap と geoplot の呼び出しの間に cla reset を使用します。
lat = [35 -22 51 39 37 42 47 -33]; lon = [139 -43 0 116 23 -71 -122 18]; figure geobasemap streets cla reset geoplot(lat,lon,"m*")
あるいは、関数 geobasemap を使用してベースマップを既定の streets-light に変更することができます。地理座標軸のベースマップを変更する方法の詳細については、地理座標軸とチャートのベースマップへのアクセスを参照してください。
参考
関数
geoscatter|geobubble|plot|geobasemap|geoplot(Mapping Toolbox)
プロパティ
- Line のプロパティ | GeographicAxes のプロパティ | MapAxes Properties (Mapping Toolbox)
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®.
