los

見通し内 (LOS) の可視性ステータスの表示または計算

R2019b 以降

ページ内をすべて折りたたむ

構文

los(site1,site2)

los(site1,site2,Name,Value)

vis = los(site1,site2,Name,Value)

説明

例

los(site1,site2) は、サイト 1 からサイト 2 への見通し内 (LOS) の可視性を現在のサイトビューアーで表示します。プロットは、線上にある点の可視性を示すカラーコードで表示されます。

例

los(site1,site2,Name,Value) は、1 つ以上の名前と値のペアを使用してプロパティを設定します。たとえば、los(site1,site2,'ObstructedColor','red') は、可視性が妨げられていることを赤の LOS で表示します。

vis = los(site1,site2,Name,Value) は、LOS の可視性のステータスを返します。

例

すべて折りたたむ

送信機サイトから受信機サイトへの LOS

ライブスクリプトを開く

アンテナ高さが 30 m の送信機サイトを作成し、受信機サイトを地表面に作成します。

tx = txsite("Name","MathWorks Apple Hill",...
      	"Latitude",42.3001,"Longitude",-71.3504,"AntennaHeight",30);
rx = rxsite("Name","MathWorks Lakeside", ...
   	    "Latitude",42.3021,"Longitude",-71.3764);

2 つのサイト間の LOS をプロットします。

los(tx,rx)

送信機サイトから 2 つの受信機サイトへの LOS

ライブスクリプトを開く

アンテナ高さが 30 m の送信機サイトを作成し、アンテナをもつ 2 つの受信機サイトを地表面に作成します。

tx = txsite("Name","MathWorks Apple Hill",...
      	"Latitude",42.3001,"Longitude",-71.3504,"AntennaHeight",30);

names = ["Fenway Park","Bunker Hill Monument"];
lats = [42.3467,42.3763];
lons = [-71.0972,-71.0611];

受信機サイトの配列を作成します。

rxs = rxsite("Name", names,...
      "Latitude",lats,...
      "Longitude",lons);

受信機サイトへの LOS をプロットします。LOS の赤い部分は、可視性が妨げられていることを表します。

los(tx,rxs)

直交座標サイト間の LOS

ライブスクリプトを開く

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

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

部屋の天井隅付近に送信機サイトを作成し、テーブルの上に受信機サイトを作成します。直交座標を使用してメートル単位で位置を指定します。

tx = txsite("cartesian", ...
    "AntennaPosition",[-1.46; -1.42; 2.1]);
rx = rxsite("cartesian", ...
    "AntennaPosition",[0.3; 0.3; 0.85]);

送信機と受信機との間の LOS をプロットします。

los(rx,tx)

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

シカゴのサイト間での伝播光線のプロット

ライブスクリプトを開く

シカゴでレイトレーシングを実行し、comm.Ray オブジェクトにその光線を返します。次に、レイトレーシング解析を実行せずに光線を再度表示します。

シカゴの建物を指定してサイトビューアーを起動します。OpenStreetMap® ファイルの詳細については、[1] を参照してください。

viewer = siteviewer("Buildings","chicago.osm");

Site Viewer with buildings

ある建物の上に送信機サイト、別の建物の上に受信機サイトを作成します。関数 los を使用して、サイト間の見通し内パスを表示します。

tx = txsite("Latitude",41.8800, ...
    "Longitude",-87.6295, ...
    "TransmitterFrequency",2.5e9);
rx = rxsite("Latitude",41.881352, ...
    "Longitude",-87.629771, ...
    "AntennaHeight",30);
los(tx,rx)

Obstructed line-of-sight path from the transmitter site to the receiver site. The path is green from the transmitter to the building, and red from the building to the receiver.

レイトレーシング伝播モデルを作成します。MATLAB® は、RayTracing オブジェクトを使用してこのモデルを表現します。既定では、このモデルは SBR 法を使用し、最大 2 回の反射を伴う伝播パスを計算します。

pm = propagationModel("raytracing");

レイトレーシング解析を実行します。関数 raytrace は、comm.Ray オブジェクトを含む cell 配列を返します。

rays = raytrace(tx,rx,pm)

rays = 1×1 cell array
    {1×3 comm.Ray}

最初の ray オブジェクトのプロパティを表示します。

rays{1}(1)

ans = 
  Ray with properties:

      PathSpecification: 'Locations'
       CoordinateSystem: 'Geographic'
    TransmitterLocation: [3×1 double]
       ReceiverLocation: [3×1 double]
            LineOfSight: 0
           Interactions: [1×1 struct]
              Frequency: 2.5000e+09
         PathLossSource: 'Custom'
               PathLoss: 92.7740
             PhaseShift: 1.2933

   Read-only properties:
       PropagationDelay: 5.7088e-07
    PropagationDistance: 171.1462
       AngleOfDeparture: [2×1 double]
         AngleOfArrival: [2×1 double]
        NumInteractions: 1

サイトビューアーを閉じます。

close(viewer)

同じ建物、送信機サイト、受信機サイトを使用して、別のサイトビューアーを作成します。次に、伝播パスを表示します。または、rays{1}(2) のように、単一の ray オブジェクトを指定してパスを個別にプロットすることもできます。

siteviewer("Buildings","chicago.osm");
show(tx)
show(rx)
plot(rays{1},"Type","power", ...
    "TransmitterSite",tx,"ReceiverSite",rx)

Three propagation paths from the transmitter site to the receiver site

付録

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

入力引数

すべて折りたたむ

`site1` — ソースアンテナサイト
`txsite` オブジェクト | `rxsite` オブジェクト

ソースアンテナサイト。txsite オブジェクトまたは rxsite オブジェクトとして指定します。site1 は単一のサイトオブジェクトでなければなりません。

`site2` — ターゲットアンテナサイト
`txsite` オブジェクト | `rxsite` オブジェクト | `txsite` オブジェクトまたは `rxsite` オブジェクトのベクトル

ターゲットアンテナサイト。txsite オブジェクトまたは rxsite オブジェクトとして指定します。site2 には、単一のサイトオブジェクト、または複数のサイトオブジェクトからなるベクトルを使用できます。

名前と値の引数

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

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

例: 'ObstructedColor','blue'

`VisibleColor` — 可視性を確保できた場合のプロットの色
`'green'` (既定値) | RGB 3 成分 | 文字ベクトル | string スカラー

可視性を確保できた場合のプロットの色。次のいずれかとして指定します。

各要素が色の赤、緑、青の成分の強度を指定する RGB 3 成分。強度は [0,1] の範囲でなければなりません (例: [0.4 0.6 0.7])。
文字ベクトル ('red' や 'r' など)。
string スカラー ("red" や "r" など)。

よく使われる色の色名、およびそれらと等価な RGB 3 成分を次の表に示します。

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

`ObstructedColor` — 可視性が妨げられた場合のプロットの色
`'red'` (既定値) | RGB 3 成分 | 文字ベクトル | string スカラー

可視性が妨げられた場合のプロットの色。次のいずれかとして指定します。

各要素が色の赤、緑、青の成分の強度を指定する RGB 3 成分。強度は [0,1] の範囲でなければなりません (例: [0.4 0.6 0.7])。
文字ベクトル ('red' や 'r' など)。
string スカラー ("red" や "r" など)。

よく使われる色の色名、およびそれらと等価な RGB 3 成分を次の表に示します。

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

`Resolution` — 2 つのサイト間のサンプリング距離
`'auto'` (既定値) | 数値スカラー

見通し内の可視性の計算に使用されるサンプル位置の分解能。'auto'、またはメートル単位で表された数値スカラーとして指定します。Resolution は、球状の地球モデルを使用した大圏パス上にあるサンプル間の距離を定義します。Resolution が 'auto' である場合、この関数は、サイト間の距離に基づいて値を計算します。

`Map` — 可視化または表面データのマップ
`siteviewer` オブジェクト | `triangulation` オブジェクト | string スカラー | 文字ベクトル

可視化または表面データのマップ。siteviewer オブジェクト、triangulation オブジェクト、string スカラー、文字ベクトルのいずれかとして指定します。有効な既定値は、座標系に応じて異なります。

座標系	有効なマップ値	既定のマップ値
`"geographic"`	`siteviewer` オブジェクト ^a . 出力引数の指定がある関数が呼び出された場合の地形名。有効な地形名は、`"none"`、`"gmted2010"`、または `addCustomTerrain` を使用して追加したカスタム地形データの名前です。	現在の `siteviewer` オブジェクト。何も開いていない場合は新しい `siteviewer` オブジェクト。出力の指定がある関数が呼び出された場合の `"gmted2010"`。
`"cartesian"`	`"none"`. `siteviewer` オブジェクト。 glTF™ ファイルの名前。 STL ファイルの名前。 `triangulation` オブジェクト。	`"none"`.
^a Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks^®.

ほとんどの場合、この引数を siteviewer や "none" 以外の値として指定した場合は出力引数も指定しなければなりません。

データ型: char | string

出力引数

すべて折りたたむ

`vis` — LOS の可視性のステータス
`true` または `1` | `false` または `0` | n 行 `1` の logical 配列

LOS の可視性のステータス。logical の 1 (true) または 0 (false) として返されます。複数のターゲットサイトが存在する場合、この関数は、n 行 1 列の logical 配列を返します。

バージョン履歴

R2019b で導入

参考

distance | angle | link

los

構文

説明

例

送信機サイトから受信機サイトへの LOS

送信機サイトから 2 つの受信機サイトへの LOS

直交座標サイト間の LOS

シカゴのサイト間での伝播光線のプロット

入力引数

site1 — ソース アンテナ サイト txsite オブジェクト | rxsite オブジェクト

site2 — ターゲット アンテナ サイト txsite オブジェクト | rxsite オブジェクト | txsite オブジェクトまたは rxsite オブジェクトのベクトル

名前と値の引数

VisibleColor — 可視性を確保できた場合のプロットの色 'green' (既定値) | RGB 3 成分 | 文字ベクトル | string スカラー

ObstructedColor — 可視性が妨げられた場合のプロットの色 'red' (既定値) | RGB 3 成分 | 文字ベクトル | string スカラー

Resolution — 2 つのサイト間のサンプリング距離 'auto' (既定値) | 数値スカラー

Map — 可視化または表面データのマップ siteviewer オブジェクト | triangulation オブジェクト | string スカラー | 文字ベクトル

出力引数

vis — LOS の可視性のステータス true または 1 | false または 0 | n 行 1 の logical 配列

バージョン履歴

参考

`site1` — ソースアンテナサイト
`txsite` オブジェクト | `rxsite` オブジェクト

`site2` — ターゲットアンテナサイト
`txsite` オブジェクト | `rxsite` オブジェクト | `txsite` オブジェクトまたは `rxsite` オブジェクトのベクトル

`VisibleColor` — 可視性を確保できた場合のプロットの色
`'green'` (既定値) | RGB 3 成分 | 文字ベクトル | string スカラー

`ObstructedColor` — 可視性が妨げられた場合のプロットの色
`'red'` (既定値) | RGB 3 成分 | 文字ベクトル | string スカラー

`Resolution` — 2 つのサイト間のサンプリング距離
`'auto'` (既定値) | 数値スカラー

`Map` — 可視化または表面データのマップ
`siteviewer` オブジェクト | `triangulation` オブジェクト | string スカラー | 文字ベクトル

`vis` — LOS の可視性のステータス
`true` または `1` | `false` または `0` | n 行 `1` の logical 配列