Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

link

通信リンク ステータスの表示または計算

R2019b 以降

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

構文

link(rx,tx)
link(rx,tx,propmodel)
link(___,Name,Value)
status = link(___)

説明

例

link(rx,tx) は、受信機サイトと送信機サイトとの間の片方向のポイントツーポイント通信リンクを現在のサイト ビューアーで表示します。プロットは、リンクが成功したかどうかを示すカラー コードで表示されます。

link(rx,tx,propmodel) は、指定された伝播モデルに基づいて通信リンクを表示します。

link(___,Name,Value) は、Name,Value のペアで指定される追加オプションを使用して通信リンクを表示します。

status = link(___) は、通信リンクが成功したかどうかを true または false で返します。

例

すべて折りたたむ

ライブ スクリプトを開く

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

tx = txsite("Name","MathWorks", ...
        "Latitude",42.3001, ...
        "Longitude",-71.3503);

感度が dBm 単位で定義された受信機サイトを作成します。

 rx = rxsite("Name","Boston", ...
        "Latitude",42.3601, ...
        "Longitude",-71.0589, ...
        "ReceiverSensitivity",-90);

送信機と受信機との間の通信リンクをプロットします。

link(rx,tx)

ライブ スクリプトを開く

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]);

送信機と受信機との間の通信リンクをプロットします。

link(rx,tx)

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

入力引数

すべて折りたたむ

受信機サイト。rxsite オブジェクトとして指定します。配列入力を使用して複数のサイトを指定できます。

送信機サイト。txsite オブジェクトとして指定します。配列入力を使用して複数のサイトを指定できます。

パス損失の計算に使用する伝播モデル。次のオプションのいずれかとして指定します。

  • "freespace" — 自由空間伝播モデル

  • "rain" — 降雨伝播モデル

  • "gas" — ガス伝播モデル

  • "fog" — 霧伝播モデル

  • "close-in" — 近距離伝播モデル

  • "longley-rice" — Longley-Rice 伝播モデル

  • "tirem" — TIREM™ 伝播モデル

  • "raytracing" — Shooting and Bouncing Rays (SBR) 法を使用するレイ トレーシング伝播モデル。レイ トレーシング モデルを入力として指定した場合、この関数はフェーザの和を使用してマルチパス干渉を組み込みます。

  • 関数 propagationModel を使用して作成した伝播モデル

既定値は、入力サイトで使用される座標系によって異なります。

座標系伝播モデルの既定値
"geographic"

  • "longley-rice" (地形を使用する場合)。

  • "freespace" (地形を使用しない場合)。

"cartesian"

  • "freespace" (Map が none に設定されている場合)。

  • "raytracing" (Map が STL ファイル名または三角形分割オブジェクトに設定されている場合)。レイ トレーシング モデルは既定で Shooting and Bouncing Rays (SBR) 法を使用します。

"longley-rice" や "tirem" などの地形伝播モデルは、CoordinateSystem の値が "geographic" であるサイトでのみサポートされます。

名前と値のペアの引数 PropagationModel を使用して伝播モデルを指定することもできます。

名前と値の引数

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

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

例: "Type","power"

パス損失の計算に使用する伝播モデル。次のオプションのいずれかとして指定します。

  • "freespace" — 自由空間伝播モデル

  • "rain" — 降雨伝播モデル

  • "gas" — ガス伝播モデル

  • "fog" — 霧伝播モデル

  • "close-in" — 近距離伝播モデル

  • "longley-rice" — Longley-Rice 伝播モデル

  • "tirem" — TIREM 伝播モデル

  • "raytracing" — Shooting and Bouncing Rays (SBR) 法を使用するレイ トレーシング伝播モデル。レイ トレーシング モデルを入力として指定した場合、この関数はフェーザの和を使用してマルチパス干渉を組み込みます。

  • 関数 propagationModel を使用して作成した伝播モデル

既定値は、入力サイトで使用される座標系によって異なります。

座標系伝播モデルの既定値
"geographic"

  • "longley-rice" (地形を使用する場合)。

  • "freespace" (地形を使用しない場合)。

"cartesian"

  • "freespace" (Map が none に設定されている場合)。

  • "raytracing" (Map が STL ファイル名または三角形分割オブジェクトに設定されている場合)。レイ トレーシング モデルは既定で Shooting and Bouncing Rays (SBR) 法を使用します。

"longley-rice" や "tirem" などの地形伝播モデルは、CoordinateSystem の値が "geographic" であるサイトでのみサポートされます。

データ型: char | 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]

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

データ型: char | string | double

失敗したリンクの色。次のいずれかのオプションとして指定します。

  • 各要素が色の赤、緑、青の成分の強度を指定する RGB 3 成分。強度は [0,1] の範囲でなければなりません (例: [0.4 0.6 0.7])。

  • 文字ベクトル ("red" や "r" など)。

  • string スカラー ("red" や "r" など)。

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

色名短縮名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

データ型: char | string | double

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

座標系有効なマップ値既定のマップ値
"geographic"

  • siteviewer オブジェクト a .

  • 出力引数の指定がある関数が呼び出された場合の地形名。有効な地形名は、"none"、"gmted2010"、または addCustomTerrain を使用して追加したカスタム地形データの名前です。

  • 現在の siteviewer オブジェクト。何も開いていない場合は新しい siteviewer オブジェクト。

  • 出力の指定がある関数が呼び出された場合の "gmted2010"。

"cartesian"

  • "none".

  • siteviewer オブジェクト。

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

データ型: char | string

出力引数

すべて折りたたむ

通信リンクが成功したかどうか。M 行 N 列の配列として返されます。M は送信機サイトの数、N は受信機サイトの数です。

バージョン履歴

R2019b で導入

すべて展開する

参考

| | | |