coverage

Отобразите или вычислите карту покрытия

Описание

пример

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

Примечание

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

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

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

пример

coverage(txs,rx,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);

Создайте сайт приемника в Фенуэй-парке с высотой антенны 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)

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

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

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

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

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

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

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

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

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

Приложение

[1] osm файл загружается с https://www.openstreetmap.org, который обеспечивает доступ к полученным толпой данным о карте во всем мире. Данные лицензируются под Открытыми Данными палата общин Открытая Лицензия Базы данных (ODbL), https://opendatacommons.org/licenses/odbl/.

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

свернуть все

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

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

Сайт приемника в виде rxsite объект.

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

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

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

Аргументы name-value

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

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

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

Когда типом является 'power', SignalStrengths описывается в блоках питания (dBm) сигнала в мобильном входе приемника. Когда типом является 'efield', SignalStrengths описывается в модулях силы электрического поля (dBμV/m) инцидента волны сигнала на антенне.

coverage функция не поддерживается для моделей трассировки лучей когда 'Type' 'efield'.

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

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

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

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

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

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

  • 'rain' — Лейтесь моделью распространения

  • 'gas' — Газовая модель распространения

  • 'fog' — Вуалируйте модель распространения

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

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

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

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

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

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

Модели распространения ландшафта, включая 'longley-rice' и 'tirem', только поддерживаются для сайтов с CoordinateSystem значение 'geographic'.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Цвета заполненных контуров на покрытии сопоставляют в виде разделенной запятой пары, состоящей из 'Colors' и одно из следующего:

  • M-by-3 массив триплетов RGB, элементы которых задают интенсивность красных, зеленых, и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; например, [0.4 0.6 0.7].

  • Массив строк, таких как ["red" "green" "blue"] или ["r" "g" "b"].

  • Массив ячеек из символьных векторов, такой как {'red','green','blue'} или {'r','g','b'}.

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

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

Эта таблица содержит названия цвета и эквивалентные триплеты RGB для некоторых простых цветов.

Название цветаКраткое названиеТриплет RGBВнешний вид
'red''r'[1 0 0]

Sample of the color red

'green''g'[0 1 0]

Sample of the color green

'blue''b'[0 0 1]

Sample of the color blue

'cyan' 'c'[0 1 1]

Sample of the color cyan

'magenta''m'[1 0 1]

Sample of the color magenta

'yellow''y'[1 1 0]

Sample of the color yellow

'black''k'[0 0 0]

Sample of the color black

'white''w'[1 1 1]

Sample of the color white

Типы данных: 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.

Типы данных: логический

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

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

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

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

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

свернуть все

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

Вопросы совместимости

развернуть все

Поведение изменяется в R2021b

Смотрите также

| | |

Введенный в R2019b

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