contour

Отобразите контурную карту

Синтаксис

contour(pd)

contour(___,Name,Value)

Описание

contour(pd) создает заполненный контурный график на карте. Контуры окрашены в соответствии со значениями данных соответствующих местоположений.

пример

contour(___,Name,Value) создает заполненную контурную карту с дополнительными опциями, заданными аргументами пары "имя-значение".

Примеры

свернуть все

Карта емкости с использованием данных SINR

Этот пример использует:

Antenna Toolbox

Открыть Live Script

Определите имена и местоположения сайтов вокруг Бостона.

names = ["Fenway Park","Faneuil Hall","Bunker Hill Monument"];
lats = [42.3467,42.3598,42.3763];
lons = [-71.0972,-71.0545,-71.0611];

Создайте массив сайтов передатчика.

txs = txsite("Name",names,...
       "Latitude",lats,...
       "Longitude",lons, ...
       "TransmitterFrequency",2.5e9);
show(txs)

Создайте карту сигнал-помеха-плюс-шум-отношение (SINR), где источник сигнала для каждого местоположения выбран в качестве сайта передатчика с самым сильным сигналом.

sv1 = siteviewer("Name","SINR map");
sinr(txs,"MaxRange",5000)

Верните данные распространения SINR.

pd = sinr(txs,"MaxRange",5000);
[sinrDb,lats,lons] = getDataVariable(pd,"SINR");

Вычислите емкость с помощью теоремы Шеннона-Хартли.

bw = 1e6; % Bandwidth is 1 MHz
sinrRatio = 10.^(sinrDb./10); % Convert from dB to power ratio
capacity = bw*log2(1+sinrRatio)/1e6; % Unit: Mbps

Создайте новые данные распространения для карты емкости и отобразите контурный график.

pdCapacity = propagationData(lats,lons,"Capacity",capacity);
sv2 = siteviewer("Name","Capacity map");
legendTitle = "Capacity" + newline + "(Mbps)";
contour(pdCapacity,"LegendTitle",legendTitle);

Входные параметры

свернуть все

`pd` - Данные распространения
`propagationData` объект (по умолчанию)

Данные распространения, заданные как propagationData объект.

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: 'Type','power'

`'DataVariableName'` - Переменные данных на контурную карту
`DataVariableName` (по умолчанию) | символьный вектор | строковый скаляр

Переменная данных к контурной карте, заданная как разделенная разделенными запятой парами, состоящая из 'DataVariableName' и вектор символов или строковый скаляр, соответствующий имени переменной в таблице данных, используемой для создания объекта контейнера данных распространения pd.

Типы данных: char | string

`'Type'` - Тип значения для построения графика
`'custom'` (по умолчанию) | `'power'` | `'efield'` | `'sinr'` | `'pathloss'`

Тип значения для построения графика, заданный как разделенная разделенными запятой парами, состоящая из 'Type' и одно из значений в 'Type' столбец:

Напечатать	ColorLimits	LegendTitle
`'custom'`	`[min(Data) max(Data)]`	`''`
`'power'`	`[-120 -5]`	`'Power (dBm)'`
`'efield'`	`[20 135]`	`'E-field (dBuV/m)'`
`'sinr'`	`[-5 20]`	`'SINR (dB)'`
`'pathloss'`	`[45 160]`	`'Path loss (dB)'`

Значение по умолчанию для Levels является вектором с линейно распределенными значениями, ограниченной ColorLimits.

Типы данных: char | string

`'Levels'` - Уровни значений данных для построения графика
числовой вектор

Уровни значений данных для построения, заданные как разделенная разделенными запятой парами, состоящая из 'Levels' и числовой вектор. Каждый уровень отображается как другой цветной, заполненный контур на карте. Цвета выбираются с помощью Colors если задано, или другое Colormap и ColorLimits. Точки данных со значениями ниже минимального уровня не включаются в график.

Типы данных: double

`'Colors'` - Цвета точек данных
M -by-3 массив RGB | массив строк | массив ячеек из векторов символов

Цвета заполненных контуров, заданные как разделенная разделенными запятой парами, состоящая из 'Colors' и M-by-3 массив RGB (красный, синий, зеленый) или массив строк или массив ячеек из векторов символов. Цветам присваиваются элементарные значения в Levels для раскраски соответствующих точек. Цвета нельзя использовать с Colormap и ColorLimits.

Типы данных: double | char | string

`'Colormap'` - Карта цвета для точек раскраски
`'jet(256)'` (по умолчанию) | предопределенное имя палитры | M массива RGB -by-3

Палитра для точек раскраски, заданная как разделенная разделенными запятой парами, состоящая из 'Colormap' и предопределенное имя палитры или массив M -by-3 из триплетов RGB (красный, синий, зеленый), которые определяют M отдельных цветов. Colormap не может использоваться с Colors.

Типы данных: double | char | string

`'ColorLimits'` - Пределы цвета для цветовой карты
двухэлементный вектор

Пределы цвета для палитры, заданные как разделенная разделенными запятой парами, состоящая из 'ColorLimits' и двухэлементный вектор вида [min max]. Пределы цвета указывают значения уровня данных, которые сопоставлены с первым и последним цветами в палитре. ColorLimits не может использоваться с Colors.

Типы данных: double

`'Transparency'` - Прозрачность контурной карты
`0.4` (по умолчанию) | числовой скаляр в области значений [0,1]

Прозрачность контурного графика, заданная как числовой скаляр в область значений [0,1], где 0 полностью прозрачен и 1 полностью непрозрачен.

Типы данных: double

`'ShowLegend'` - Показать легенду цвета на карте
`true` (по умолчанию) | `false`

Показать легенду цвета на карте, заданную как разделенная разделенными запятой парами, состоящая из 'ShowLegend' и true или false.

Типы данных: logical

`'LegendTitle'` - Заголовок цветовой легенды
вектор символов | строковый скаляр

Заголовок цветовой легенды, заданная как разделенная запятой пара, состоящая из 'LegendTitle' и вектор символов или строковый скаляр.

Типы данных: string | char

`'Map'` - Карта для поверхностных данных
`siteviewer` объект

Карта для данных о поверхности, заданная как разделенная разделенными запятой парами, состоящая из 'Map' и a siteviewer объект.^[1] Значение по умолчанию является текущим средством просмотра сайтов или новым средством просмотра сайтов, если оно не открыто.

Типы данных: char | string

Введенный в R2020a

^[1] Выравнивание контуров и меток областей является представлением функции, предоставляемой поставщиками данных, и не подразумевает одобрения MathWorks^®.

Документация

contour

Синтаксис

Описание

Примеры

Карта емкости с использованием данных SINR

Входные параметры

`pd` - Данные распространения
`propagationData` объект (по умолчанию)

Аргументы в виде пар имя-значение

`'DataVariableName'` - Переменные данных на контурную карту
`DataVariableName` (по умолчанию) | символьный вектор | строковый скаляр

`'Type'` - Тип значения для построения графика
`'custom'` (по умолчанию) | `'power'` | `'efield'` | `'sinr'` | `'pathloss'`

`'Levels'` - Уровни значений данных для построения графика
числовой вектор

`'Colors'` - Цвета точек данных
M -by-3 массив RGB | массив строк | массив ячеек из векторов символов

`'Colormap'` - Карта цвета для точек раскраски
`'jet(256)'` (по умолчанию) | предопределенное имя палитры | M массива RGB -by-3

`'ColorLimits'` - Пределы цвета для цветовой карты
двухэлементный вектор

`'Transparency'` - Прозрачность контурной карты
`0.4` (по умолчанию) | числовой скаляр в области значений [0,1]

`'ShowLegend'` - Показать легенду цвета на карте
`true` (по умолчанию) | `false`

`'LegendTitle'` - Заголовок цветовой легенды
вектор символов | строковый скаляр

`'Map'` - Карта для поверхностных данных
`siteviewer` объект

Документация Communications Toolbox

Поддержка

Документация

contour

Синтаксис

Описание

Примеры

Карта емкости с использованием данных SINR

Входные параметры

pd - Данные распространения propagationData объект (по умолчанию)

Аргументы в виде пар имя-значение

'DataVariableName' - Переменные данных на контурную карту DataVariableName (по умолчанию) | символьный вектор | строковый скаляр

'Type' - Тип значения для построения графика 'custom' (по умолчанию) | 'power' | 'efield' | 'sinr' | 'pathloss'

'Levels' - Уровни значений данных для построения графика числовой вектор

'Colors' - Цвета точек данных M -by-3 массив RGB | массив строк | массив ячеек из векторов символов

'Colormap' - Карта цвета для точек раскраски 'jet(256)' (по умолчанию) | предопределенное имя палитры | M массива RGB -by-3

'ColorLimits' - Пределы цвета для цветовой карты двухэлементный вектор

'Transparency' - Прозрачность контурной карты 0.4 (по умолчанию) | числовой скаляр в области значений [0,1]

'ShowLegend' - Показать легенду цвета на карте true (по умолчанию) | false

'LegendTitle' - Заголовок цветовой легенды вектор символов | строковый скаляр

'Map' - Карта для поверхностных данных siteviewer объект

Документация Communications Toolbox

Поддержка

`pd` - Данные распространения
`propagationData` объект (по умолчанию)

`'DataVariableName'` - Переменные данных на контурную карту
`DataVariableName` (по умолчанию) | символьный вектор | строковый скаляр

`'Type'` - Тип значения для построения графика
`'custom'` (по умолчанию) | `'power'` | `'efield'` | `'sinr'` | `'pathloss'`

`'Levels'` - Уровни значений данных для построения графика
числовой вектор

`'Colors'` - Цвета точек данных
M -by-3 массив RGB | массив строк | массив ячеек из векторов символов

`'Colormap'` - Карта цвета для точек раскраски
`'jet(256)'` (по умолчанию) | предопределенное имя палитры | M массива RGB -by-3

`'ColorLimits'` - Пределы цвета для цветовой карты
двухэлементный вектор

`'Transparency'` - Прозрачность контурной карты
`0.4` (по умолчанию) | числовой скаляр в области значений [0,1]

`'ShowLegend'` - Показать легенду цвета на карте
`true` (по умолчанию) | `false`

`'LegendTitle'` - Заголовок цветовой легенды
вектор символов | строковый скаляр

`'Map'` - Карта для поверхностных данных
`siteviewer` объект