link

Отобразите или вычислите состояние линии связи

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

Синтаксис

link(rx,tx)
link(rx,tx,propmodel)
link(___,Name,Value)
status = link(___)

Описание

пример

link(rx,tx) отображает одностороннюю линию связи "точка-точка" между сайтом приемника и ретранслятором в текущем Средстве просмотра Сайта. График является цветом, закодированным, чтобы идентифицировать состояние успеха ссылки.

link(rx,tx,propmodel) отображает линию связи на основе заданной модели распространения.

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

status = link(___) возвращает состояние успеха линии связи как true или false.

Примеры

свернуть все

Скрипт Open Live Script

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

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

Создайте сайт приемника с чувствительностью, заданной в dBm.

 rx = rxsite('Name','Boston', ...
        'Latitude',42.3601, ...
        'Longitude',-71.0589, ...
        'ReceiverSensitivity',-90);

Постройте линию связи между передатчиком и приемником.

link(rx,tx)

Скрипт Open Live Script

Импортируйте и просмотрите файл STL. Файл моделирует небольшой конференц-зал с одной таблицей и четырьмя стульями.

viewer = siteviewer('SceneModel','conferenceroom.stl');

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

tx = txsite('cartesian', ...
    'AntennaPosition',[-1.46; -1.42; 2.1]);
rx = rxsite('cartesian', ...
    'AntennaPosition',[0.3; 0.3; 0.85]);

Постройте линию связи между передатчиком и приемником.

link(rx,tx)

Панорамирование путем щелчка левой кнопкой, масштабируйте путем щелчка правой кнопкой или при помощи колесика прокрутки и вращайте визуализацию путем нажатия средней кнопки и перетаскивания или путем нажатия Ctrl и щелчка левой кнопкой и перетаскивания.

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

свернуть все

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

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

Модель Propagation в виде вектора символов, строки или модели распространения, созданной с propagationModel функция. Значение по умолчанию зависит от системы координат, используемой входными сайтами.

Система координатЗначение модели распространения по умолчанию
'geographic'

  • 'longley-rice' когда вы используете ландшафт.

  • 'freespace' когда вы не используете ландшафт.

'cartesian'

  • 'freespace' когда Map не установлен ни в один.

  • 'raytracing' когда Map установлен в имя файла STL или объекта триангуляции. Модель трассировки лучей по умолчанию использует стрельбу и возврат лучей (SBR) метод.

Можно также задать модель распространения при помощи 'PropagationModel' аргумент пары "имя-значение".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Вектор символов, такой как 'red' или 'r'.

  • Строковый скаляр, такой как "red" или "r".

Эта таблица содержит названия цвета и эквивалентные триплеты 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

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

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

  • Вектор символов, такой как 'red' или 'r'.

  • Строковый скаляр, такой как "red" или "r".

Эта таблица содержит названия цвета и эквивалентные триплеты 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

Сопоставьте для визуализации или поверхностных данных в виде siteviewer объект, triangulation объект, строковый скаляр или вектор символов. Допустимый и значения по умолчанию зависят от системы координат.

Система координатДопустимые значения картыЗначение карты по умолчанию
'geographic'

  • siteviewer объект[a].

  • Имя ландшафта, если функция вызвана с выходным аргументом. Допустимыми именами ландшафта является 'none', 'gmted2010', или имя пользовательских данных о ландшафте, добавленных с помощью addCustomTerrain.

  • Текущий siteviewer возразите или новый siteviewer возразите, не ли ни один открыт.

  • 'gmted2010', если функция вызвана с выходом.

'cartesian'

  • 'none'.

  • siteviewer объект.

  • Имя файла STL.

  • triangulation объект.

  • 'none'.

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

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

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

свернуть все

Состояние Success линий связи, возвращенных как M-by-N массивы. M является количеством ретрансляторов, и N является количеством сайтов приемника.

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

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

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

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

| | | |

Введенный в R2017b

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

Поддержка

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