angle

サイト間の角度

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

構文

[az,el] = angle(site1,site2)
[az,el] = angle(site1,site2,path)
[az,el] = angle(___,Name=Value)

説明

[az,el] = angle(site1,site2) は、指定されたサイト間の方位角と仰角を計算します。

例

[az,el] = angle(site1,site2,path) は、指定されたパス タイプ (ユークリッド パスまたは大圏パス) を使用して角度を計算します。

例

[az,el] = angle(___,Name=Value) は、名前と値の引数を使用してオプションを指定します。

例

すべて折りたたむ

ライブ スクリプトを開く

送信機サイトと受信機サイトを作成します。地理座標を使用して位置を指定します。 

tx = txsite(Name="MathWorks", ...
    Latitude=42.3001, ...
    Longitude=-71.3504);
rx = rxsite(Name="Fenway Park", ...
    Latitude=42.3467, ...
    Longitude=-71.0972);

サイト間の方位角と仰角を計算します。既定では、この関数はサイト間のユークリッド パスを使用します。 

[az,el] = angle(tx,rx)
az = 14.0142

el = -0.2805

地理サイトの場合、この関数は、東から反時計回りに測定した度単位の角度を方位角として返します。北から時計回りに測定されるように方位角を変換します。 

azFromEast = az; % degrees counterclockwise from east
azFromNorth = -azFromEast + 90 % degrees clockwise from north
azFromNorth = 75.9858
ライブ スクリプトを開く

送信機サイトと受信機サイトを作成します。地理座標を使用して位置を指定します。 

tx = txsite(Name="MathWorks", ...
    Latitude=42.3001, ...
    Longitude=-71.3504);
rx = rxsite(Name="Fenway Park", ...
    Latitude=42.3467, ...
    Longitude=-71.0972);

大圏パスを使用してサイト間の方位角と仰角を計算します。 

[az,el] = angle(tx,rx,"greatcircle")
az = 14.0635

el = 0

入力引数

すべて折りたたむ

送信機サイトまたは受信機サイト。txsite または rxsite オブジェクトとして指定します。複数のサイトを指定するには、配列入力を使用します。

測定パス タイプ。次のいずれかとして指定します。

  • "euclidean" — サイトのアンテナの中心位置を結ぶ、空間内の最短パスを使用します。このオプションは、直交サイトと地理サイトの両方で既定です。

  • "greatcircle" — サイトの地理的位置を結ぶ球状の地球表面上の最短パスを使用します。このオプションを使用するには、サイトの CoordinateSystem プロパティが "geographic" である必要があります。

データ型: char

名前と値の引数

すべて折りたたむ

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

例: [az,el] = angle(site1,site2,"Map","myfile.stl") はマップを STL ファイルとして指定します。

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

例: [az,el] = angle(site1,site2,Map="myfile.stl") はマップを STL ファイルとして指定します。

可視化または表面データのマップ。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 列の配列として返されます。ここで、M は site1 内のサイトの数で、N は site2 内のサイトの数です。

地理サイトの場合、方位角は東から反時計回りに測定されます。直交座標の場合、方位角は、グローバルの z 軸周りにグローバルの x 軸から測定されます。角度の範囲は [–180, 180] 度です。

サイト間の仰角 (度単位)。M 行 N 列の配列として返されます。ここで、M は site2 内のサイトの数で、N は site1 内のサイトの数です。

仰角は水平面 (または xy 平面) から測定されます。角度の範囲は [–90, 90] 度です。

パス タイプを "greatcircle" として指定すると、仰角は 0 になります。

バージョン履歴

R2019b で導入

参考

関数

オブジェクト