Main Content

pathloss

無線波伝播のパス損失

R2019b 以降

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

構文

pl = pathloss(propmodel,rx,tx)
pl = pathloss(___,Name=Value)
[pl,info] = pathloss(___)

説明

例

pl = pathloss(propmodel,rx,tx) は、受信機サイトでの、送信機サイトからの無線波伝播のパス損失を返します。

pl = pathloss(___,Name=Value) は、名前と値の引数で指定される追加オプションを使用してパス損失を返します。

[pl,info] = pathloss(___) は、さらに、伝播パスに関する情報を返します。

例

すべて折りたたむ

ライブ スクリプトを開く

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

tx = txsite(Name="MathWorks Apple Hill", ...
    Latitude=42.3001,Longitude=-71.3504, ...
    TransmitterFrequency=2.5e9);

rx = rxsite(Name="Fenway Park", ...
    Latitude=42.3467,Longitude=-71.0972);

豪雨の伝播モデルを作成します。次に、この伝播モデルを使用して、受信機サイトにおけるパス損失を計算します。

pm = propagationModel("rain",RainRate=50);
pl = pathloss(pm,rx,tx)
pl = 127.3208

入力引数

すべて折りたたむ

伝播モデル。FreeSpace オブジェクト、Rain オブジェクト、Gas オブジェクト、Fog オブジェクト、CloseIn オブジェクト、LongleyRice オブジェクト、TIREM (Antenna Toolbox) オブジェクト、または RayTracing オブジェクトとして指定します。

関数 propagationModel を使用して、伝播モデルを作成します。

受信機サイト。rxsite オブジェクト、または rxsite オブジェクトの配列として指定します。

送信機サイト。txsite オブジェクトまたは txsite オブジェクトの配列として指定します。

名前と値の引数

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

例: pathloss(propmodel,rx,tx,Map="none")

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

例: pathloss(propmodel,rx,tx,"Map","none")

可視化または表面データのマップ。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

出力引数

すべて折りたたむ

パス損失。スカラーとして返されるか、各セルにデシベル単位のパス損失の行ベクトルが含まれる M 行 N 列の cell 配列として返されます。M は送信機サイトの数で、N は受信機サイトの数です。

この関数は、送信機の中心と受信機の中心を結ぶ、空間内の最短の伝搬パスに沿って、パス損失を計算します。

地形伝播モデルの場合、この関数は、送信機と受信機の間の大圏パス上のサンプル位置に基づいて作成される地形標高プロファイルを使用して、パス損失を計算します。Map が、指定された建物を含む siteviewer オブジェクトの場合、この関数は、建物の高さを含むように標高を調整します。

各伝播パスに対応する情報。M 行 N 列の構造体配列または cell 配列として返されます。

  • ほとんどの伝搬モデルの場合、info は構造体配列です。

  • レイ トレーシング伝搬モデルの場合、info は、各セルに構造体のベクトルが含まれる cell 配列です。

この構造体には次のフィールドがあります。

  • PropagationDistance — 伝播パスの合計長さ。double のスカラー (メートル単位) として返されます。

  • AngleOfDeparture — 送信機サイトからの信号の発射角。方位角と仰角 (度単位) の 2 行 1 列の double ベクトルとして返されます。

  • AngleOfArrival — 受信機サイトでの信号の到来角。方位角と仰角 (度単位) の 2 行 1 列の double ベクトルとして返されます。

  • NumReflections — 伝搬パスに沿った反射の数。非負の整数として返されます。このフィールドと値はレイ トレーシング伝播モデルにのみ適用されます。

  • NumDiffractions — 伝搬パスに沿った回折の数。0、1、または 2 として返されます。このフィールドと値はレイ トレーシング伝播モデルにのみ適用されます。

この構造体における角度の値は、CoordinateSystem によって異なります。

  • CoordinateSystem が "geographic" の場合、角度の値はアンテナのローカルの East-North-Up 座標系を使用して定義されます。方位角は東から測定されます。

  • CoordinateSystem が "cartesian" の場合、角度の値はグローバルの直交座標系を使用して定義されます。方位角は、グローバルの z 軸周りにグローバルの x 軸から測定されます。

仰角は、水平 (または xy) 面からアンテナの x 軸まで –90 ～ 90 の範囲で測定されます。

参照

[1] International Telecommunications Union Radiocommunication Sector. Effects of Building Materials and Structures on Radiowave Propagation Above About 100MHz. Recommendation P.2040. ITU-R, approved August 23, 2023. https://www.itu.int/rec/R-REC-P.2040/en.

[2] International Telecommunications Union Radiocommunication Sector. Electrical Characteristics of the Surface of the Earth. Recommendation P.527. ITU-R, approved September 27, 2021. https://www.itu.int/rec/R-REC-P.527/en.

バージョン履歴

R2019b で導入

すべて展開する

参考

|