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
入力引数
propmodel
— 伝播モデル
伝播モデル オブジェクト
伝播モデル。FreeSpace
オブジェクト、Rain
オブジェクト、Gas
オブジェクト、Fog
オブジェクト、CloseIn
オブジェクト、LongleyRice
オブジェクト、TIREM
(Antenna Toolbox) オブジェクト、または RayTracing
オブジェクトとして指定します。
関数 propagationModel
を使用して、伝播モデルを作成します。
rx
— 受信機サイト
rxsite
オブジェクト | rxsite
オブジェクトの配列
受信機サイト。rxsite
オブジェクト、または rxsite
オブジェクトの配列として指定します。
tx
— 送信機サイト
txsite
オブジェクト | txsite
オブジェクトの配列
送信機サイト。txsite
オブジェクトまたは txsite
オブジェクトの配列として指定します。
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN
として指定します。ここで、Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
例: pathloss(propmodel,rx,tx,Map="none")
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name
を引用符で囲みます。
例: pathloss(propmodel,rx,tx,"Map","none")
Map
— 可視化または表面データのマップ
siteviewer
オブジェクト | triangulation
オブジェクト | string スカラー | 文字ベクトル
可視化または表面データのマップ。siteviewer
オブジェクト、triangulation
オブジェクト、string スカラー、文字ベクトルのいずれかとして指定します。有効な既定値は、座標系に応じて異なります。
座標系 | 有効なマップ値 | 既定のマップ値 |
---|---|---|
"geographic" |
|
|
"cartesian" |
|
|
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
出力引数
pl
— パス損失
スカラー | M 行 N 列の cell 配列
パス損失。スカラーとして返されるか、各セルにデシベル単位のパス損失の行ベクトルが含まれる M 行 N 列の cell 配列として返されます。M は送信機サイトの数で、N は受信機サイトの数です。
この関数は、送信機の中心と受信機の中心を結ぶ、空間内の最短の伝搬パスに沿って、パス損失を計算します。
地形伝播モデルの場合、この関数は、送信機と受信機の間の大圏パス上のサンプル位置に基づいて作成される地形標高プロファイルを使用して、パス損失を計算します。Map
が、指定された建物を含む siteviewer
オブジェクトの場合、この関数は、建物の高さを含むように標高を調整します。
info
— 各伝播パスに対応する情報
M 行 N 列の構造体配列 | M 行 N 列の cell 配列
各伝播パスに対応する情報。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 で導入R2024a: レイ トレーシング関数による更新された ITU 勧告を使用した材料のモデル化
R2024a: レイ トレーシング伝播パスに沿った回折数の取得
propmodel
を RayTracing
オブジェクトとして指定した場合、info
は、伝搬パスに沿った回折数を NumDiffractions
フィールドに格納します。
R2023a: レイ トレーシング モデルはパス損失に基づいてパスを破棄する
レイ トレーシング伝播モデルは、パス損失しきい値に基づいて伝播パスを破棄します。既定では、入力引数 propmodel
を RayTracing
オブジェクトとして指定したときに、伝播モデルは最も強いパスより 40 dB を超えて弱いパスを破棄します。
その結果、関数 pathloss
は、R2023a では以前のリリースとは異なる値を返す可能性があります。相対パス損失しきい値に基づいて伝播パスが破棄されることを回避するには、レイ トレーシング オブジェクトの MaxRelativePathLoss
プロパティを Inf
に設定します。
R2022b: SBR 法を使用したレイ トレーシング モデルは正確な幾何学的精度でパスを検出
Shooting and Bounce Rays (SBR) 法を使用して伝播パスを検出するレイ トレーシング モデルは、単精度浮動小数点の計算を使用して、各パスの幾何学的精度が正確になるように結果を修正します。以前のリリースでは、パスの幾何学的精度が近似的でした。
その結果、関数 pathloss
への入力としてレイ トレーシング モデルを使用する際、関数は以前のリリースとは異なる結果を返す可能性があります。
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)