pattern

アンテナ放射パターンのサイト ビューアーでの表示

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

構文

pattern(tx)
pattern(tx,frequency)
pattern(rx,frequency)
pattern(___,Name=Value)

説明

pattern(tx) は、指定された送信機サイトの 3 次元アンテナ放射パターンを現在のサイト ビューアーで表示します。既定では、この関数は送信機サイトの TransmitterFrequency プロパティに格納されている周波数を使用してパターンを計算します。特定の方向のアンテナ ゲイン (dBi) によってパターンの色が決定されます。

例

pattern(tx,frequency) は、指定された周波数における指定された送信機サイトの 3 次元放射パターンを表示します。

pattern(rx,frequency) は、指定された周波数における指定された受信機サイトの 3 次元放射パターンを表示します。

pattern(___,Name=Value) は、名前と値の引数で指定される追加オプションを使用して 3 次元放射パターンを表示します。

例

すべて折りたたむ

ライブ スクリプトを開く

単一の送信機サイトの放射パターンを定義して可視化します。

tx = txsite;
pattern(tx)

Transmitter site and radiation pattern displayed over satellite imagery

ライブ スクリプトを開く

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

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

素子の間隔が 0.05 メートルである 3 素子等間隔直線アレイ (ULA) を使用する送信機サイトを作成します。直交座標を使用してメートル単位で位置を指定します。

cfgArray = arrayConfig("Size",[3 1],"ElementSpacing",0.05);
tx = txsite("cartesian", ...
    "AntennaPosition",[0; 0; 2.1], ...
    "Antenna",cfgArray);

アンテナ パターンを表示します。パターン プロットのサイズを 0.4 メートルとして指定します。

pattern(tx,"Transparency",0.6,"Size",0.4)

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

送信機の AntennaAngle プロパティを更新してアンテナを傾けます。更新されたパターンを表示します。

tx.AntennaAngle = [0 90];
pattern(tx,"Transparency",0.6,"Size",0.4)

入力引数

すべて折りたたむ

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

受信機サイト。rxsite オブジェクトとして指定します。

放射パターンを計算する周波数。正のスカラーとして指定します。

名前と値の引数

すべて折りたたむ

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

例: pattern(tx,Size=2) は、パターン プロットのサイズを指定します。

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

例: pattern(tx,'Size',2) は、パターン プロットのサイズを指定します。

パターン プロットのサイズ (メートル単位)。数値スカラーとして指定します。パターン プロットのサイズは、アンテナの位置とプロット上でゲインが最も高い位置との間の距離です。

既定値は、siteviewer オブジェクトの CoordinateSystem プロパティの値によって異なります。CoordinateSystem が 'geographic' である場合、既定のサイズは 50 メートルです。CoordinateSystem が 'cartesian' である場合、既定のサイズはシーンのモデル サイズの約 1/6 です。

データ型: double

パターン プロットの透明度。範囲 [0, 1] のスカラーとして指定します。ここで、0 の場合は完全に透明になり、1 は完全に不透明になります。

データ型: double

パターン プロット用のカラーマップ。カラーマップ名として指定するか、M 個の個別の色を定義する RGB 3 成分から成る M 行 3 列の配列として指定します。

送信機または受信機のサイトをクリックすると、ゲイン値からカラーマップへのマッピングを示すカラー バーを表示できます。

次の表はカラーマップ名の一覧です。

カラーマップ名カラー スケール

parula

Colorbar showing the colors of the parula colormap. The colormap starts at dark blue and transitions to lighter blue, green, orange and yellow. The transitions between colors are more perceptually uniform than in most other colormaps.

turbo

Colorbar showing the colors of the turbo colormap. The colormap starts at dark blue and transitions to lighter blue, bright green, orange, yellow, and dark red. This colormap is similar to jet, but the transitions between colors are more perceptually uniform than in jet.

hsv

Colorbar showing the colors of the hsv colormap. The colormap starts at red and transitions to yellow, bright green, cyan, dark blue, magenta, and bright orange.

hot

Colorbar showing the colors of the hot colormap. The colormap starts at dark red and transitions to bright red, orange, yellow, and white.

cool

Colorbar showing the colors of the cool colormap. The colormap starts at cyan and transitions to light blue, light purple, and magenta.

spring

Colorbar showing the colors of the spring colormap. The colormap starts at magenta and transitions to pink, light orange, and yellow.

summer

Colorbar showing the colors of the summer colormap. The colormap starts at medium green and transitions to yellow.

autumn

Colorbar showing the colors of the autumn colormap. The colormap starts at bright orange and transitions to yellow.

winter

Colorbar showing the colors of the winter colormap. The colormap starts at dark blue and transitions to bright green.

gray

Colorbar showing the gray colormap. The colormap starts at black and transitions to white.

bone

Colorbar showing the bone colormap. This colormap has colors that are approximately gray with a slight blue color tint. The colormap starts at dark gray and transitions to white.

copper

Colorbar showing the copper colormap. This colormap starts at black and transitions to a medium orange, similar to the color of copper.

pink

Colorbar showing the pink colormap. This colormap starts at dark red and transitions to dark pink, tan, and white.

sky (R2023a 以降)

Colorbar showing the sky colormap. This colormap starts at a very light shade of blue and transitions to a darker shade of blue.

abyss (R2023b 以降)

Colorbar showing the abyss colormap. This colormap starts at a very dark shade of blue and transitions to a lighter shade of blue.

nebula (R2025a 以降)

Colorbar showing the nebula colormap. This colormap starts at a medium shade of blue and transitions to a bright shade of red.

jet

Colorbar showing the colors of the jet colormap. The colormap starts at dark blue and transitions to light blue, bright green, orange, yellow, and dark red.

lines

Colorbar showing the colors of the lines colormap. The colormap contains a repeating pattern of colors: dark blue, dark orange, dark yellow, dark purple, medium green, light blue, and dark red.

colorcube

Colorbar showing the colors of the colorcube colormap. The colormap is a course sampling of the RGB colorspace.

prism

Colorbar showing the colors of the prism colormap. The colormap contains a repeating pattern of colors: red, orange, yellow, green, blue, and purple.

flag

Colorbar showing the colors of the flag colormap. The colormap contains a repeating pattern of colors: red, white, blue, and black.

white

Colorbar showing the white colormap, which is entirely white.

データ型: double

3 次元マップの解像度。"low"、"medium"、または "high" として指定します。解像度によって、見た目の品質、およびパターンをプロットするのに必要な時間が制御されます。"low" の値は、最も高速で最も粗いパターンに対応します。

データ型: double

表面データを可視化するためのマップ。siteviewer オブジェクトとして指定します。 1

データ型: char | string

バージョン履歴

R2019b で導入

参考

関数

1 Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks®.