plot

サイト ビューアーで RF 伝播データを表示

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

構文

plot(pd)
plot(___,Name=Value)

説明

plot(pd) は、指定された伝播データ オブジェクトからのデータを現在のサイト ビューアーで表示します。この関数は、対応する値に応じて色付けされる円形マーカーとして各データ点を表示します。

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

例

例

すべて折りたたむ

ライブ スクリプトを開く

Manhattan のベースマップおよび建物ファイルを使用してサイト ビューアーを起動します。OpenStreetMap® ファイルの詳細については、[1] を参照してください。

viewer = siteviewer("Basemap","streets_dark",...
        "Buildings","manhattan.osm");

建物の上に送信機サイトを表示します。

tx = txsite("Latitude",40.7107,...
        "Longitude",-74.0114,...
        "AntennaHeight",80);
show(tx)

近くの道に沿って受信機サイトを作成します。

latitude = [linspace(40.7088, 40.71416, 50), ...
        linspace(40.71416, 40.715505, 25), ...
        linspace(40.715505, 40.7133, 25), ...
        linspace(40.7133, 40.7143, 25)]';
longitude = [linspace(-74.0108, -74.00627, 50), ...
        linspace(-74.00627 ,-74.0092, 25), ...
        linspace(-74.0092, -74.0110, 25), ...
        linspace(-74.0110, -74.0132, 25)]';
rxs = rxsite("Latitude", latitude, "Longitude", longitude);

各受信機の位置での信号強度を計算します。

signalStrength = sigstrength(rxs, tx)';

計算された信号強度データを保持する propagationData オブジェクトを作成します。

tbl = table(latitude, longitude, signalStrength);
pd = propagationData(tbl);

信号強度データを色付きの点としてマップ上にプロットします。

legendTitle = "Signal" + newline + "Strength" + newline + "(dB)";
plot(pd, "LegendTitle", legendTitle, "Colormap", parula);

付録

[1] OpenStreetMap ファイルは、クラウドソーシングによる世界中の地図データへのアクセスを提供する https://www.openstreetmap.org からダウンロードされたものです。このデータは Open Data Commons Open Database License (ODbL) https://opendatacommons.org/licenses/odbl/ によりライセンスされています。

入力引数

すべて折りたたむ

伝播データ。propagationData オブジェクトとして指定します。

名前と値の引数

すべて折りたたむ

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

例: plot(pd,Type="power") はタイプを "power" として指定します。

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

例: plot(pd,"Type","power") はタイプを "power" として指定します。

プロットするデータ変数。文字ベクトルまたは string スカラーとして指定します。データ変数は、propagationData オブジェクトの作成に使用される table の変数名に対応していなければなりません。既定値は、propagationData オブジェクトの DataVariableName プロパティに対応します。

データ型: char | string

プロットする値のタイプ。"custom"、"power"、"efield"、"sinr"、または "pathloss" として指定します。次の表に、各タイプの既定の色の範囲と凡例のタイトルを示します。

種類色の範囲凡例のタイトル
"custom"[min(Data) max(Data)]''
"power"[-120 -5]電力 (dBm)
"efield"[20 135]電界 (dBuV/m)
"sinr"[-5 20]SINR (dB)
"pathloss"[45 160]パス損失 (dB)

データ型: char | string

プロットするデータ値のレベル。数値ベクトルとして指定します。この関数は、この引数を使用して伝播データをビン化します。この関数は、プロット時、Colors 引数が指定されている場合はこの引数を使用してビンの色を選択し、そうでない場合は Colormap 引数および ColorLimits 引数を使用してビンの色を選択します。この関数は、最小レベルより小さい値をもつデータ点を表示しません。

データ型: double

データ点の色。RGB 3 成分から成る M 行 3 列の配列、string スカラーの配列、または文字ベクトルの cell 配列として指定します。この関数は、Levels 引数で指定された対応する値に色を割り当てます。

Colors 引数を Colormap 引数または ColorLimits 引数と組み合わせることはできません。

データ型: double | char | string

点を色付けするためのカラーマップ。事前定義されたカラーマップ名として指定するか、M 個の色を定義する RGB 3 成分から成る M 行 3 列の配列として指定します。

Colormap 引数を Colors 引数と一緒に使用することはできません。

データ型: double | char | string

カラーマップの色の範囲。[min max] 形式の 2 要素ベクトルとして指定します。色の範囲は、カラーマップの最初と最後の色にマッピングされるデータ レベル値を示します。

ColorLimits 引数を Colors 引数と一緒に使用することはできません。

データ型: double

マップにプロットされるデータ マーカーのサイズ。正の数値スカラー (ピクセル単位) として指定します。

データ型: double

マップへの色の凡例の表示。true または false として指定します。

データ型: logical

色の凡例のタイトル。文字ベクトルまたは string スカラーとして指定します。

データ型: string | char

表面データのマップ。siteviewer オブジェクトとして指定します。 1 既定値は現在のサイト ビューアーであり、何も開かれていない場合は新しいサイト ビューアーです。

データ型: char | string

バージョン履歴

R2020a で導入

参考

関数

オブジェクト

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