coverage

Отобразите карту покрытия

Описание

пример

coverage(txs) отображает карту покрытия для сайта передатчика. Каждый цветной контур карты определяет область, где соответствующий уровень сигнала передается в мобильный приемник.

Примечание

Эта функция поддерживает только антенные сайты с CoordinateSystem значение свойства установлено в 'geographic'.

coverage(txs,propmodel) отображает карту покрытия на основе указанной модели распространения. Модель распространения по умолчанию 'longley-rice' когда местность используется и 'freespace' когда рельеф местности не используется.

coverage(txs,rxs) отображает карту покрытия на основе свойств сайта приемника.

пример

coverage(txs,rxs,propmodel) отображает карту покрытия на основе свойств сайта приемника и заданной модели распространения.

пример

coverage(___,Name,Value,___) отображает карту покрытия с помощью дополнительных опций, заданных Name,Value пар.

pd = coverage(txs,___) возвращает вычисленные данные покрытия в объекте данных распространения, pd. График не отображается, и любые графические пары "имя-значение" игнорируются.

Примеры

свернуть все

Создайте сайт передатчика в штаб-квартире MathWorks.

tx = txsite('Name','MathWorks', ...
        'Latitude', 42.3001, ...
        'Longitude', -71.3503);

Показать карту покрытия.

coverage(tx)

Создайте сайт передатчика в штаб-квартире MathWorks.

tx = txsite('Name','MathWorks', ...
        'Latitude', 42.3001, ...
        'Longitude', -71.3503);

Создайте приемник площадку в Fenway Park с высотой антенны 1,2 м и потерей системы 10 дБ.

rx = rxsite('Name','Fenway Park', ...
       'Latitude',42.3467, ...
       'Longitude',-71.0972,'AntennaHeight',1.2,'SystemLoss',10);

Вычислите площадь покрытия передатчика с помощью модели близкого распространения.

coverage(tx,rx,'PropagationModel','closein')

Задайте сильные и слабые сильные стороны сигнала с соответствующими цветами.

strongSignal = -75;
strongSignalColor = "green";
weakSignal = -90;
weakSignalColor = "cyan";

Создайте сайт передатчика и отобразите карту покрытия.

tx = txsite('Name','MathWorks','Latitude', 42.3001,'Longitude', -71.3503);
coverage(tx,'SignalStrengths',[strongSignal,weakSignal], ...
       'Colors', [strongSignalColor,weakSignalColor])

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

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);

Отобразите комбинированную карту покрытия для нескольких сильных сторон сигнала, используя модель близкого распространения.

coverage(txs,'close-in','SignalStrengths',-100:5:-60)

Запустите Средство Просмотра, используя создания в Чикаго. Для получения дополнительной информации о файле osm см. [1].

viewer = siteviewer("Buildings","chicago.osm");

Создать площадку передатчика на создании.

tx = txsite('Latitude',41.8800, ...
   'Longitude',-87.6295, ...
   'TransmitterFrequency',2.5e9);
show(tx)

Карта покрытия с использованием модели распространения Лонгли-Риса

Создайте карту покрытия города с помощью модели распространения Лонгли-Райса.

coverage(tx,"SignalStrengths",-100:-5,"MaxRange",250,"Resolution",1)

Модели Лонгли-Райса на крышах распространяются вдоль вертикальных срезов и препятствий, как правило, доминируют в области покрытия.

Карта покрытия с использованием модели распространения трассировки лучей и метода изображения

Создайте карту покрытия города с помощью модели распространения трассировки лучей. По умолчанию модель распространения трассировки лучей использует метод изображения, и область покрытия включает пути распространения линии визирования и одиночного отражения.

coverage(tx,"raytracing","SignalStrengths",-100:-5, ...
    "MaxRange",250,"Resolution",2)

Эта карта покрытия показывает новые области, которые находятся в обслуживании из-за отраженных путей распространения.

Карта покрытия с использованием модели распространения трассировки лучей и метода SBR

Создайте карту покрытия города с помощью модели распространения трассировки лучей. Укажите метод трассировки лучей как стрелковые и прыгающие лучи (SBR). Метод SBR обычно быстрее, чем способ изображения. Увеличьте максимальное количество отражений пути до 2.

pm = propagationModel("raytracing","Method","sbr", ...
    "MaxNumReflections",2);
coverage(tx,pm,"SignalStrengths",-100:-5, ...
    "MaxRange",250,"Resolution",2)

Эта карта покрытия показывает новые области, которые находятся в обслуживании из-за дополнительных отраженных путей распространения.

Приложение

[1] Файл osm загружается из https://www.openstreetmap.org, что обеспечивает доступ к данным карты, полученной из толпы, по всему миру. Данные лицензированы под лицензией Open Data Commons Open Database License (ODbL), https://opendatacommons.org/licenses/odbl/.

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

свернуть все

Площадка передатчика, заданная как txsite объект. Используйте входы массива, чтобы задать несколько сайтов.

Эта функция поддерживает графическое изображение сайтов антенн только при CoordinateSystem для свойства задано значение 'geographic'.

Сайт приемника, заданный как rxsite объект. Используйте входы массива, чтобы задать несколько сайтов.

Эта функция поддерживает графическое изображение сайтов антенн только при CoordinateSystem для свойства задано значение 'geographic'.

Модель распространения, заданная как вектор символов или строка. Можно также использовать пара "имя-значение" 'PropagationModel' чтобы задать этот параметр. Вы также можете использовать propagationModel функция для определения этого входа. Модель распространения по умолчанию 'longley-rice' при включении и 'freespace' местности при отключении рельефа.

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

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

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

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

Тип вычисляемой мощности сигнала, заданный как разделенная разделенными запятой парами, состоящая из 'Type' и 'power' или 'efield'.

Когда тип 'power', SignalStrengths выражается в силовых модулях (дБм) сигнала на входе мобильного приемника. Когда тип 'efield', SignalStrengths выражается в единицах напряженности электрического поля (дБмкВ/м) падающей на антенну сигнальной волны.

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

Сильные стороны сигнала для отображения на карте покрытия, заданной как разделенная разделенными запятой парами, состоящая из 'SignalStrengths' и числовой вектор.

Каждая сила использует разный цветной заполненный контур на карте. Значение по умолчанию -100 дБм, если 'Type' Пара "имя-значение" 'power' и 40 дБмкВ/м при 'Type' является 'efield'.

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

Модель распространения для вычисления потерь пути, заданная как разделенная разделенными запятой парами, состоящая из 'PropagationModel' и одно из следующих:

  • 'freespace' - Модель распространения свободного пространства

  • 'rain' - Модель распространения дождя

  • 'gas' - Модель распространения газа

  • 'fog' - Модель распространения тумана

  • 'close-in' - Близкая модель распространения

  • 'longley-rice' - модель распространения Лонгли-Райса

  • 'tirem' - модель распространения Tirem

  • 'raytracing' - Модель распространения трассировки лучей, которая использует метод изображения

  • Модель распространения, созданная с propagationModel функция

Модель распространения по умолчанию 'longley-rice' при включении и 'freespace' местности при отключении рельефа.

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

Максимальная область значений карты покрытия от каждого сайта передатчика, заданный как положительный числовой скаляр в метрах, представляющий большое расстояние круга. MaxRange определяет необходимую область на карте для построения графика. Значение по умолчанию автоматически вычисляется на основе типа модели распространения.

Тип модели распространенияMaxRange
Атмосферный или эмпирическийОбласть значений минимального значения в SignalStrengths.
Ландшафт30 км или расстояние до самого дальнего создания.
Трассировка лучей500 м

Для получения дополнительной информации о типах моделей распространения смотрите Выбор модели распространения.

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

Разрешение карты покрытия, заданное как разделенная разделенными запятой парами, состоящая из 'Resolution' и числовой скаляр в метрах.

Разрешение 'auto' вычисляет максимальное значение, масштабированное до 'MaxRange'. Уменьшение разрешения увеличивает качество карты покрытия и время, необходимое для ее создания.

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

Усиление приемника, заданный как разделенная разделенными запятой парами, состоящая из 'ReceiverGain' и числовой скаляр в дБ. Значение усиления приемника включает в себя усиление антенны мобильного приемника и потери системы.

Сила принимаемого сигнала вычисляется усилением приемника при 'Type' является 'power'.

Если аргумент сайта приемника rx передается на покрытие, значение по умолчанию является максимальным усилением антенны приемника с вычитаемыми потерями системы. В противном случае значение по умолчанию является 2.1.

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

Высота антенны мобильного приемника над повышением земли, заданная как разделенная разделенными запятой парами, состоящая из 'ReceiverAntennaHeight' и числовой скаляр в метрах.

Если аргумент сайта приемника rx передается в покрытие, значение по умолчанию является AntennaHeight приемника. В противном случае значение по умолчанию является 1.

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

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

Цветам присваиваются поэлементные 'SignalStrengths' значения для окраски соответствующих заполненных контуров.

'Colors' не может использоваться с 'ColorLimits' или 'ColorMap'.

Для получения дополнительной информации смотрите ColorSpec (Color Specification).

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

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

Пределы цвета указывают значения уровня сигнала, которые сопоставлены с первым и последним цветами на палитре.

Значение по умолчанию [-120 -5] если 'Type' Пара "имя-значение" 'power' и [20 135] если 'Type' является 'efields'.

'ColorLimits' не может использоваться с 'Color'.

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

Палитра заполняет контуры на карте покрытия, задается как разделенная разделенными запятой парами, состоящая из 'ColorMap' и предопределенную палитру или M массив -by-3 из триплетов RGB, где M определяет отдельные цвета.

'ColorMap' не может использоваться с 'Colors'.

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

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

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

Прозрачность карты покрытия, заданная как разделенная разделенными запятой парами, состоящая из 'Transparency' и числовой скаляр в области значений 0 на 1. 0 прозрачен и 1 непрозрачен.

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

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

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

Выходные аргументы

свернуть все

Данные о покрытии, возвращенные как propagationData объект, состоящий из Latitude и Longitude и переменной уровня сигнала, соответствующей типу графика. Имя propagationData является "Coverage Data".

Введенный в R2019b

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