siteviewer

サイトビューアーの作成

R2019b 以降

説明

送信機サイトや受信機サイト、RF 伝播の可視化を表示するには、siteviewer オブジェクトを使用します。サイトビューアーには、既定では地球の 3 次元ビューが表示されます。地球でサイトを表示する場合は地理座標が基準になります。カスタム地形、高ズームレベルやカスタムのベースマップ、および建物を使用して地球をカスタマイズできます。

また、Standard Tessellation Language (STL) ファイルまたは triangulation オブジェクトで表現された 3 次元モデルをインポートして表示することもできます。3 次元モデルでサイトを表示する場合は直交座標が基準になります。

サイトビューアーには、WebGL™ のためのハードウェアグラフィックスサポートが必要です。

作成

構文

viewer = siteviewer

viewer = siteviewer(Name,Value)

説明

例

viewer = siteviewer は、サイトビューアーを作成します。

例

viewer = siteviewer(Name,Value) は、名前と値の引数を使用してサイトビューアーのプロパティを指定します。たとえば、3 次元モデルファイルをインポートして表示するには、名前と値の引数 SceneModel を使用します。

プロパティ

すべて展開する

サイトビューアー

`Name` — マップビューアーウィンドウに表示するキャプション
`'Site Viewer'` (既定値) | 文字ベクトル | string スカラー

マップビューアーウィンドウに表示するキャプション。文字ベクトルまたは string スカラーとして指定します。

データ型: char | string

`Position` — マップビューアーウィンドウのピクセル単位のサイズと位置
4 要素の整数値ベクトル

マップビューアーウィンドウのピクセル単位のサイズと位置。[left bottom width height] の形式で 4 要素の整数値ベクトルとして指定します。既定値は画面の解像度により異なり、ウィンドウは幅 800 ピクセル、高さ 600 ピクセルで画面の中央に配置されます。

データ型: double

`CoordinateSystem` — 座標参照系
`'geographic'` (既定値) | `'cartesian'`

このプロパティは読み取り専用です。

座標参照系。'geographic' または 'cartesian' として指定します。CoordinateSystem の値はサイトビューアーの作成方法に応じて異なります。

既定の設定では、CoordinateSystem の値は 'geographic' で、WGS84 基準楕円体が可視化に使用されます。
SceneModel 引数を指定してサイトビューアーを作成する場合は、CoordinateSystem の値は 'cartesian' になり、直交座標が座標に使用されます。

CoordinateSystem が 'geographic' の場合、マップを右クリックして [Show Location] を選択すると、その位置の経度と緯度の座標を表示できます。位置を削除するには、右クリックして [Remove Location] を選択します。

データ型: char | string

地理座標系

`Basemap` — サイトの可視化に使用するマップ画像
`'satellite'` (既定値) | `'openstreetmap'` | `'streets'` | `'streets-light'` | `'streets-dark'` | `'topographic'` | ...

サイトの可視化に使用するマップ画像。次の表のいずれかのベースマップの名前、または関数 addCustomBasemap を使用して定義されたカスタムベースマップとして指定します。

	`'satellite'` (既定) 高解像度の衛星写真で構成される地球全体のベースマップ。 Esri^® によりホストされています。		`'openstreetmap'` OpenStreetMap^® が提供する市街地図。
	`'streets'` 道路と輸送網を正確で見やすいスタイルで強調した汎用道路マップ。 Esri によりホストされています。		`'streets-light'` 地理コンテキストを提供し、明るい背景にユーザーデータを強調表示するように設計されたマップ。 Esri によりホストされています。
	`'streets-dark'` 地理コンテキストを提供し、暗い背景にユーザーデータを強調表示するように設計されたマップ。 Esri によりホストされています。		`'topographic'` 地形的な特徴を示すスタイルを備えた汎用マップ。 Esri によりホストされています。
	`'landcover'` 衛星からの地表データと陰影起伏および海底起伏を組み合わせたマップ。自然な淡色のパレットが主題図や一般図の作成に適しています。 Natural Earth を使用して作成されています。		`'colorterrain'` 地表パレットとブレンドされた陰影起伏マップ。湿度の高い低地は緑色、乾燥した低地は茶色で表示されます。 Natural Earth を使用して作成されています。
	`'grayterrain'` グレーの濃淡による地形マップ。陰影起伏表示で高い山と低地にある微細な地形の両方が強調されます。 Natural Earth を使用して作成されています。		`'bluegreen'` 陸地部分が薄い緑で水域が薄い青の 2 色の陸海マップ。 Natural Earth を使用して作成されています。
	`'grayland'` 陸地部分がグレーで水域が白の 2 色の陸海マップ。 Natural Earth を使用して作成されています。		`'darkwater'` 陸地部分が薄いグレーで水域が濃いグレーの 2 色の陸海マップ。このベースマップは MATLAB^® と共にインストールされています。 Natural Earth を使用して作成されています。

Esri によってホストされるベースマップは定期的に更新されます。そのため、可視化で表示される内容は時間が経過すると変わることがあります。

境界と領域ラベルの配置はデータベンダーが提供する特徴を示すものであり、MathWorks^® の承認を意味するものではありません。

このプロパティは CoordinateSystem が 'geographic' である場合にのみ適用されます。

データ型: char | string

`Terrain` — サイト可視化と地形計算実行のためのデータ
`'gmted2010'` (既定値) | `'none'` | 文字ベクトル | スカラー

サイト可視化と地形計算実行のためのデータ。addCustomTerrain を使用して前に追加した文字ベクトルまたはスカラー、または以下のいずれかのオプションとして指定します。

'none' — すべての場所の地形標高が 0。
'gmted2010' — USGS GMTED2010 地形データ。このオプションには、インターネット接続が必要です。

このプロパティは CoordinateSystem が 'geographic' である場合にのみ適用されます。

このプロパティはサイトビューアーの作成後は読み取り専用になります。

制限については、制限を参照してください。

データ型: char | string

`Buildings` — 建物データとして使用する OpenStreetMap (.osm) ファイルの名前
string スカラー | 文字ベクトル

建物データとして使用する OpenStreetMap (.osm) ファイルの名前。string スカラーまたは文字ベクトルとして指定します。ファイルは現在のディレクトリ、または MATLAB パス上のディレクトリになければなりません。ファイルへの絶対パスまたは相対パスを使用して、データを指定することもできます。既定の設定では、この値は空です。

このプロパティは CoordinateSystem が 'geographic' である場合にのみ適用されます。

このプロパティはサイトビューアーの作成後は読み取り専用になります。

制限については、制限を参照してください。

データ型: char | string

直交座標系

`SceneModel` — 3 次元モデルファイルの名前または三角形分割
文字ベクトル | string スカラー | `triangulation` オブジェクト

3 次元モデルファイルの名前または三角形分割。string スカラー、文字ベクトル、または triangulation オブジェクトとして指定します。

SceneModel が 3 次元モデルファイルの名前の場合、拡張子 .stl の STL ファイルを指定する必要があります。SceneModel の形式はファイルの場所によって異なります。

ファイルが現在のフォルダーまたは MATLAB パス上のフォルダーにある場合、'myFile.stl' のようにファイルの名前を指定します。
ファイルが現在のフォルダーまたは MATLAB パス上のフォルダーにない場合、'C:\myfolder\myFile.stl' や 'dataDir\myFile.stl' のように絶対パス名または相対パス名を指定します。

このプロパティは CoordinateSystem が 'cartesian' である場合にのみ適用されます。

このプロパティはサイトビューアーの作成後は読み取り専用になります。

データ型: char | string

`Transparency` — モデルの透明度
範囲 `[0,1]` のスカラー

モデルの透明度。範囲 [0,1] のスカラーとして指定します。ここで、0 は透明、1 は不透明です。既定の設定は、ShowEdges が 1 (true) の場合は 0.1 で、それ以外の場合は 1 です。

このプロパティは CoordinateSystem が 'cartesian' である場合にのみ適用されます。

データ型: double

`ShowOrigin` — 原点を表示するオプション
`true` または `1` (既定値) | `false` または `0`

モデルの原点を表示するオプション。数値または logical の 1 (true) または 0 (false) として指定します。x 軸は赤、y 軸は緑、z 軸は青で表示されます。シーンの z 軸が上方向になります。

このプロパティは CoordinateSystem が 'cartesian' である場合にのみ適用されます。

データ型: logical

`ShowEdges` — モデルのエッジを表示するオプション
`true` または `1` (既定値) | `false` または `0`

モデルのエッジを黒い線で表示するオプション。数値または logical の 1 (true) または 0 (false) として指定します。サイトビューアーでは、エッジを法線の差が 2 度を超える 2 つの隣接する小平面と定義しています。

このプロパティは CoordinateSystem が 'cartesian' である場合にのみ適用されます。

このプロパティはサイトビューアーの作成後は読み取り専用になります。

データ型: logical

オブジェクト関数

`clearMap`	プロットのクリア
`close`	サイトビューアーを閉じる

例

すべて折りたたむ

既定のサイトビューアーマップディスプレイ

ライブスクリプトを開く

既定のサイトビューアーを作成します。

viewer = siteviewer;

パンするには左クリックしてドラッグします。ズームするには右クリックしてドラッグするかスクロールホイールを使用します。表示を回転させるには、中央ボタンをクリックしてドラッグするか、"Ctrl" を押しながら左クリックしてドラッグします。右クリックして [Show location] を選択すると、その位置の座標が表示されます。

この例では、ニュー・イングランドを含む地域に移動し、ケープ・コッド付近の場所の座標を表示します。

選択した位置に灰色のマーカーが表示されます。その位置を右クリックして [Remove Location] を選択し、マーカーを削除します。

3 次元モデルのサイトビューアー

ライブスクリプトを開く

STL ファイルをインポートして表示します。このファイルはテーブル 1 台と椅子が 4 脚ある小さい会議室をモデル化したものです。

viewer = siteviewer("SceneModel","conferenceroom.stl");

パンするには左クリックします。ズームするには右クリックまたはスクロールホイールを使用します。表示を回転させるには、中央ボタンをクリックしてドラッグするか、"Ctrl" を押しながら左クリックしてドラッグします。

サイトビューアーでの送信機サイトの表示

ライブスクリプトを開く

streets ベースマップを使用してサイトビューアーを起動します。

viewer = siteviewer("Basemap","streets");

このマップ上に送信機サイトを表示します。

tx = txsite;
show(tx)

カバレッジマップの比較

ライブスクリプトを開く

2 つのサイトビューアーウィンドウを起動します。一方のサイトビューアーウィンドウでは地形モデルを使用し、もう一方のウィンドウでは地形モデルを使用しません。

viewer1 = siteviewer("Terrain","gmted2010","Name","Site Viewer (Using Terrain)");
viewer2 = siteviewer("Terrain","none","Name","Site Viewer (No Terrain)");

送信機サイトを作成します。

tx = txsite;

各ウィンドウ上にカバレッジマップを生成します。地形のあるマップは、既定で Longley-Rice 伝播モデルを使用します。

coverage(tx,"Map",viewer1)

地形のないマップは、既定で自由空間モデルを使用します。

coverage(tx,"Map",viewer2)

建物のあるサイトビューアー

ライブスクリプトを開く

Manhattan のベースマップおよび建物ファイルを使用してサイトビューアーを起動します。osm ファイルの詳細については、[1] を参照してください。

viewer = siteviewer("Basemap","openstreetmap",...
       "Buildings","manhattan.osm");

建物の上に送信機サイトを表示します。

tx = txsite("Latitude",40.7107,...
       "Longitude",-74.0114,...
       "AntennaHeight",50);
show(tx)

付録

[1] osm ファイルは、クラウドソーシングによる世界中の地図データへのアクセスを提供する https://www.openstreetmap.org からダウンロードされたものです。このデータは Open Data Commons Open Database License (ODbL) https://opendatacommons.org/licenses/odbl/ によりライセンスされています。

カスタムベースマップの追加と削除

ライブスクリプトを開く

OpenTopoMap® ベースマップ上の位置を表示するカスタムベースマップを追加します。その後、siteviewer からカスタムベースマップを削除します。

以下を行うためにシミュレーション変数を初期化します。

カスタムベースマップを指定するために使用する名前を定義します。
マップデータを提供する Web サイトを指定します。URL の最初の文字は、データを取得するために使用するサーバーを示します。負荷分散のために、プロバイダーには使用可能な 3 つのサーバー a、b、c があります。
マップデータのプロバイダーのクレジットを示すためにマップ上に表示する属性を作成します。Web マッププロバイダーが、属性に関する特定の要件を定義している場合があります。
カスタムマップの表示名を定義します。

name = 'opentopomap';
url = 'a.tile.opentopomap.org';
copyright = char(uint8(169));
attribution = copyright + "OpenStreetMap contributors";
displayName = 'Open Topo Map';

addCustomBasemap を使用してカスタムベースマップを読み込んでから、カスタムベースマップを読み込む siteviewer オブジェクトを作成します。

addCustomBasemap(name,url,'Attribution',attribution','DisplayName',displayName)
viewer = siteviewer('Basemap',name);

カスタムベースマップを siteviewer に追加すると、今後 siteviewer を呼び出すときにカスタムベースマップを使用できます。'Open Topo Map' アイコンが [Imagery] タブ内に表示されることに注意してください。

siteviewer;

removeCustomBasemap を使用して、今後呼び出される siteviewer からカスタムベースマップを削除します。'Open Topo Map' アイコンが [Imagery] タブ内に表示されなくなったことに注意してください。

removeCustomBasemap(name)
siteviewer;

制限

地形

既定の地形にアクセスするには、インターネット接続が必要です。インターネット接続が存在しない場合、サイトビューアーはプロパティ Terrain に 'none' を自動的に使用します。
addCustomTerrain で使用するカスタム DTED 地形ファイルは、USGS EarthExplorer などを使用して MATLAB 外から取得しなければなりません。
カスタム地形を使用する場合、解析は地形領域に制限されます。たとえば、送信機サイトまたは受信機サイトを領域外に表示しようとすると、エラーが発生します。

建物

https://www.openstreetmap.org から取得した OpenStreetMap ファイルは、クラウドソーシングによる地図データであり、建物データの完全性と正確性は地図上の位置によって異なる場合があります。
https://www.openstreetmap.org からデータをダウンロードする場合、期待される建物の特徴をすべて確実に取得できるように、必要な領域よりも広いエクスポート領域を選択します。選択したエクスポート領域の端にある建物の特徴が失われる場合があります。
建物の形状と特徴は、3 次元の建物に関する OpenStreetMap の推奨事項に従って、ファイルから解釈されます。

MATLAB Online

MATLAB Online™ では、URL を更新すると、サイトビューアーウィンドウは開いたままですが可視化は消えます。

詳細

すべて展開する

サイトビューアーのナビゲーション

サイトビューアーは、マウスを使用して対話的に操作できます。

パンするには、左クリックしてドラッグします。
ズームするには、スクロールするか右クリックしてドラッグします。
傾けて回転させるには、Ctrl を押しながらドラッグするか、中央ボタンをクリックしてドラッグします。

CoordinateSystem が 'geographic' の場合、ツールバーの [Restore View] を選択して既定のビューに戻すことができます。

次元ピッカー

CoordinateSystem が 'geographic' の場合、ツールバーの [Dimension Picker] を使用して 3 つのビューオプションのいずれかを選択できます。

[3-D View] — 平滑化された地球。これは既定のビューです。
[2-D View] — メルカトル図法の平面マップ。
[Columbus View] — 傾斜と回転をサポートするメルカトル図法の平面マップ。

一部の操作は [2-D View] と [Columbus View] ではサポートされません。

バージョン履歴

R2019b で導入

参考

siteviewer

説明

作成

構文

説明

プロパティ

サイト ビューアー

Name — マップ ビューアー ウィンドウに表示するキャプション 'Site Viewer' (既定値) | 文字ベクトル | string スカラー

Position — マップ ビューアー ウィンドウのピクセル単位のサイズと位置 4 要素の整数値ベクトル

CoordinateSystem — 座標参照系 'geographic' (既定値) | 'cartesian'

地理座標系

Basemap — サイトの可視化に使用するマップ画像 'satellite' (既定値) | 'openstreetmap' | 'streets' | 'streets-light' | 'streets-dark' | 'topographic' | ...

Terrain — サイト可視化と地形計算実行のためのデータ 'gmted2010' (既定値) | 'none' | 文字ベクトル | スカラー

Buildings — 建物データとして使用する OpenStreetMap (.osm) ファイルの名前 string スカラー | 文字ベクトル

直交座標系

SceneModel — 3 次元モデル ファイルの名前または三角形分割 文字ベクトル | string スカラー | triangulation オブジェクト

Transparency — モデルの透明度 範囲 [0,1] のスカラー

ShowOrigin — 原点を表示するオプション true または 1 (既定値) | false または 0

ShowEdges — モデルのエッジを表示するオプション true または 1 (既定値) | false または 0

オブジェクト関数

例

既定のサイト ビューアー マップ ディスプレイ

3 次元モデルのサイト ビューアー

サイト ビューアーでの送信機サイトの表示

カバレッジ マップの比較

建物のあるサイト ビューアー

カスタム ベースマップの追加と削除

制限

詳細

サイト ビューアーのナビゲーション

次元ピッカー

バージョン履歴

参考

関数

オブジェクト

トピック

サイトビューアー

`Name` — マップビューアーウィンドウに表示するキャプション
`'Site Viewer'` (既定値) | 文字ベクトル | string スカラー

`Position` — マップビューアーウィンドウのピクセル単位のサイズと位置
4 要素の整数値ベクトル

`CoordinateSystem` — 座標参照系
`'geographic'` (既定値) | `'cartesian'`

`Basemap` — サイトの可視化に使用するマップ画像
`'satellite'` (既定値) | `'openstreetmap'` | `'streets'` | `'streets-light'` | `'streets-dark'` | `'topographic'` | ...

`Terrain` — サイト可視化と地形計算実行のためのデータ
`'gmted2010'` (既定値) | `'none'` | 文字ベクトル | スカラー

`Buildings` — 建物データとして使用する OpenStreetMap (.osm) ファイルの名前
string スカラー | 文字ベクトル

`SceneModel` — 3 次元モデルファイルの名前または三角形分割
文字ベクトル | string スカラー | `triangulation` オブジェクト

`Transparency` — モデルの透明度
範囲 `[0,1]` のスカラー

`ShowOrigin` — 原点を表示するオプション
`true` または `1` (既定値) | `false` または `0`

`ShowEdges` — モデルのエッジを表示するオプション
`true` または `1` (既定値) | `false` または `0`

既定のサイトビューアーマップディスプレイ

3 次元モデルのサイトビューアー

サイトビューアーでの送信機サイトの表示

カバレッジマップの比較

建物のあるサイトビューアー

カスタムベースマップの追加と削除

サイトビューアーのナビゲーション