coverage

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

свернуть все на странице

Синтаксис

coverage(txs)
coverage(txs,propmodel)
coverage(txs,rxs)
coverage(txs,rxs,propmodel)
coverage(___,Name,Value,___)
pd = coverage(txs,___)

Описание

пример

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. Никакой график не отображен и никакое графическое, только пары "имя-значение" проигнорированы.

Примеры

свернуть все

Скрипт Open Live Script

Создайте ретранслятор в главном офисе MathWorks.

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

Покажите карту покрытия.

coverage(tx)

Скрипт Open Live Script

Создайте ретранслятор в главном офисе 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')

Скрипт Open Live Script

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

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

Скрипт Open Live Script

Задайте антенну Яги-Uda, спроектированную для частоты передатчика 4,5 ГГц. Наклоните антенну к прямому излучению в XY-плоскости (i.e., географический азимут).

fq = 4.5e9;
y = design(yagiUda,fq);
y.Tilt = 90;
y.TiltAxis = 'y';

Создайте ретранслятор с этой направленной антенной.

tx = txsite('Name','MathWorks',...
        'Latitude', 42.3001, ...
        'Longitude', -71.3503, ...
        'Antenna', y, ...
        'AntennaHeight', 60, ...
        'TransmitterFrequency', fq, ...
        'TransmitterPower', 10);

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

coverage(tx,'rain','SignalStrengths',-90)

Скрипт Open 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);

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

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

Скрипт Open Live Script

Средство просмотра Стартовой площадки с помощью созданий в Чикаго. Для получения дополнительной информации о 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-image-method","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 должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

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

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

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

Типы данных: 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-image-method' - модель распространения трассировки лучей, использующая метод изображений.

Моделью распространения по умолчанию является 'longley-rice' когда ландшафт включен и 'freespace' когда ландшафт отключен. Если 'raytracing-image-method' задан, значение 'MaxNumReflections' свойство должно быть меньшим, чем 1.

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

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

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

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

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

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

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

свернуть все

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

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

| | |

Темы

Введенный в R2017b

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

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

Поддержка

Для просмотра документации необходимо авторизоваться на сайте