このページは機械翻訳を使用して翻訳されました。元の英語を参照するには、ここをクリックします。
axesm
axesmベースのマップを作成する
説明
axesm 関数は、plotm や geoshow などの関数を使用してベクトルとラスター地理データの両方を投影できる axesm ベースのマップ (以前はマップ軸と呼ばれていました) を作成します。axesm ベースのマップに固有のプロパティは、axesm を使用して作成時に割り当てることができ、既存の axesm ベースのマップの場合は、getm および setm を使用して照会および変更できます。標準の get メソッドと set メソッドを使用して、axesm ベースのマップの標準の MATLAB® 軸プロパティを照会および制御します。
axesm ベースのマップは、一部のプロパティの異なるデフォルト設定を持つ標準の MATLAB 軸と、投影パラメーターやその他のデータを格納するための MATLAB構造です。デフォルト設定の主な違いは次のとおりです。
軸プロパティ
XGrid、YGrid、XTick、YTickは'off'に設定されています。holdモードは'on'です。
地図投影構造には、特別な標準軸設定に加えて、axesm ベースのマップのプロパティが格納され、Mapping Toolbox™ 関数が軸または開かれた FIG ファイルを axesm ベースのマップとして認識できるようになります。axesm ベースのマップ プロパティの説明については、axesm-Based Map Properties を参照してください。
入力引数のない axesm は、axesm ベースのマップのプロパティを設定するために使用できる axesmui グラフィカル ユーザー インターフェイスを開始します。これについては、axesmui リファレンス ページに詳細が記載されています。
axesm( は Name,Value)axesm ベースのマップを作成し、名前と値のペアを使用してプロパティを設定し、外観を変更します。複数の名前と値のペアを指定できます。各プロパティ名を引用符で囲みます。たとえば、'FontSize',14 はマップ テキストのフォント サイズを設定します。プロパティは任意の順序で指定できますが、MapProjection プロパティは含める必要があります。プロパティの完全な一覧については、axesm-Based Map Properties を参照してください。
axesm( は、使用する地図投影を指定します。projid,Name,Value)projid は、maps 関数によって表示される最後の列のエントリの 1 つと一致する必要があります。これらは Summary and Guide to Projections にもリストされています。
例
選択した緯度範囲で、メルカトル投影の axesm ベースのマップを作成します。
axesm('MapProjection','mercator','MapLatLimit',[-70 80])
呼び出しで明示的に指定されていないすべてのプロパティは、固定または計算されたデフォルトに設定されます。ファイル mercator.m は投影関数を定義しているので、その関数を使用しても同じ結果を得ることができます。
axesm('mercator','MapLatLimit',[-70 80])
各投影関数には、すべてのプロパティのデフォルト値が含まれています。後続のプロパティ名とプロパティ値のペアはすべてオーバーライドとして扱われます。
上記のいずれの例でも、指定されたマップに表示されるデータはメルカトル投影です。規定の範囲外のデータは表示されません。
get 関数と set 関数を使用して標準軸プロパティにアクセスして操作するのと同様に、getm 関数と setm 関数を使用して axesm ベースのマップのプロパティにアクセスして操作することができます。
axesm 関数は、axesm ベースのマップを 作成 する場合にのみ使用してください。setm 関数を使用して、既存の axesm ベースのマップを 変更 します。
マップ データを含まない axesm ベースのマップを作成します。MapProjection ID 値は小文字で指定することに注意してください。
axesm('MapProjection','miller','Frame','on')
この時点で、マップのカスタマイズを開始できます。たとえば、地図の境界線となるフレームのラインを太くしたい場合があります。まず、フレームの現在のラインの幅を識別する必要があります。これは、gca として識別される現在の軸を照会することによって行います。
getm(gca,'FLineWidth')ans = 2
ここで、ラインの幅を 4 ポイントにリセットします。軸のデフォルトの fontunits 値は points です。fontunits を points、normalized、inches、centimeters、または pixels に設定できます。
setm(gca,'FLineWidth',4)
setm を使用すると、任意の数のプロパティを同時に設定できます。続けて、ラインの幅を狭め、投影を等距離円筒形に変更し、変更を確認します。
setm(gca,'FLineWidth',3,'Grid','on','MapProjection','robinson')
getm(gca,'FLineWidth')ans = 3
getm(gca,'MapProjection')ans = 'robinson'
現在の設定でマップ プロパティのセット全体を検査します。プロパティのリストには、axesm ベースのマップに特有のプロパティと、すべての MATLAB® 軸に適用される一般的なプロパティの両方が含まれていることに注意してください。
getm(gca)
ans = struct with fields:
mapprojection: 'robinson'
zone: []
angleunits: 'degrees'
aspect: 'normal'
falsenorthing: 0
falseeasting: 0
fixedorient: []
geoid: [1 0]
maplatlimit: [-90 90]
maplonlimit: [-180 180]
mapparallels: 38
nparallels: 0
origin: [0 0 0]
scalefactor: 1
trimlat: [-90 90]
trimlon: [-180 180]
frame: 'on'
ffill: 100
fedgecolor: 'default'
ffacecolor: 'none'
flatlimit: [-90 90]
flinewidth: 3
flonlimit: [-180 180]
grid: 'on'
galtitude: Inf
gcolor: 'default'
glinestyle: ':'
glinewidth: 0.5000
mlineexception: []
mlinefill: 100
mlinelimit: []
mlinelocation: 30
mlinevisible: 'on'
plineexception: []
plinefill: 100
plinelimit: []
plinelocation: 15
plinevisible: 'on'
fontangle: 'normal'
fontcolor: 'default'
fontname: 'Helvetica'
fontsize: 10
fontunits: 'points'
fontweight: 'normal'
labelformat: 'compass'
labelrotation: 'off'
labelunits: 'degrees'
meridianlabel: 'off'
mlabellocation: 30
mlabelparallel: 90
mlabelround: 0
parallellabel: 'off'
plabellocation: 15
plabelmeridian: -180
plabelround: 0
同様に、プロパティのセット、その列挙値、およびデフォルトを表示するには、setm 関数を単独で使用します。
setm(gca)
AngleUnits [ {degrees} | radians ]
Aspect [ {normal} | transverse ]
FalseEasting
FalseNorthing
FixedOrient FixedOrient is a read-only property
Geoid
MapLatLimit
MapLonLimit
MapParallels
MapProjection
NParallels NParallels is a read-only property
Origin
ScaleFactor
TrimLat TrimLat is a read-only property
TrimLon TrimLon is a read-only property
Zone
Frame [ on | {off} ]
FEdgeColor
FFaceColor
FFill
FLatLimit
FLineWidth
FLonLimit
Grid [ on | {off} ]
GAltitude
GColor
GLineStyle [ - | -- | -. | {:} ]
GLineWidth
MLineException
MLineFill
MLineLimit
MLineLocation
MLineVisible [ {on} | off ]
PLineException
PLineFill
PLineLimit
PLineLocation
PLineVisible [ {on} | off ]
FontAngle [ {normal} | italic | oblique ]
FontColor
FontName
FontSize
FontUnits [ inches | centimeters | normalized | {points} | pixels ]
FontWeight [ {normal} | bold ]
LabelFormat [ {compass} | signed | none ]
LabelRotation [ on | {off} ]
LabelUnits [ {degrees} | radians ]
MeridianLabel [ on | {off} ]
MLabelLocation
MLabelParallel
MLabelRound
ParallelLabel [ on | {off} ]
PLabelLocation
PLabelMeridian
PLabelRound
すべてのプロパティの選択とデフォルトではありませんが、多くのプロパティの選択とデフォルトを個別に表示することもできます。
setm(gca,'FontUnits')FontUnits [ inches | centimeters | normalized | {points} | pixels ]
setm(gca,'MapProjection')An axes's "MapProjection" property does not have a fixed set of property values.
setm(gca,'Frame')Frame [ on | {off} ]
setm(gca,'FixedOrient')FixedOrient FixedOrient is a read-only property
同様に、getm は任意の軸プロパティの現在の値を表示します。
getm(gca,'FontUnits')ans = 'points'
getm(gca,'MapProjection')ans = 'robinson'
getm(gca,'Frame')ans = 'on'
getm(gca,'FixedOrient')ans =
[]
特定の地図投影に適用されるプロパティを識別するには、その投影の参照ページを参照してください。
入力引数
名前と値の引数
ヒント
一般に、
axesmベースのマップを含む保存済みの図を再度開いた後は、そのマップの投影プロパティを変更しないでください。axesmを使用してaxesmベースのマップを作成し、軸を右クリックすると、コンテキスト メニューが表示されます。メニューが必要ない場合、またはアプリケーションの操作を妨げる場合は、軸の'ButtonDownFcn'プロパティをリセットして無効にすることができます。ax = axesm('mercator'); % Right-clicking brings up context menu. set(ax,'ButtonDownFcn',[]) % Context menu has been disabled.
デフォルトでは、
axesmは軸の境界の外側にある目盛りやラベルをクリップしません。これらのオブジェクトの'Clipping'プロパティを設定してクリッピングを有効にします。objects = [handlem('grid'); handlem('mlabel'); handlem('plabel')]; set(objects,'Clipping','on');
バージョン履歴
R2006a より前に導入
