link

Отобразите коммуникационную ссылку на карте

Описание

пример

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

link(rx,tx,propmodel) строит график ссылки связи на основе заданной модели распространения.

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

status = link(___) возвращает статус успеха коммуникационной ссылки следующим true или false.

Примеры

свернуть все

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

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

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

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

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

link(rx,tx)

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

свернуть все

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

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

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

Система координатЗначение модели распространения по умолчанию
'geographic'
  • 'longley-rice' когда вы используете местность.

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

'cartesian'
  • 'freespace' когда Map имеет значение none.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Цвет успешных ссылок, заданный как разделенная разделенными запятой парами, состоящая из 'SuccessColor и триплет RGB или вектора символов. Для получения дополнительной информации смотрите ColorSpec (Color Specification).

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

Цвет неудачных ссылок, заданный как разделенная разделенными запятой парами, состоящая из 'FailColor и триплет RGB или вектора символов. Для получения дополнительной информации смотрите ColorSpec (Color Specification).

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

Карта для визуализации или данных о поверхности, заданная как разделенная разделенными запятой парами, состоящая из 'Map и одно из следующих в зависимости от системы координат:

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

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

  • текущий siteviewer или новый siteviewer, если они не открыты.

  • 'gmted2010' при вызове с выходом.

'cartesian''none', объект триангуляции или имя STL- файла.'none'

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

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

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

свернуть все

Успешное состояние каналов связи, возвращаемое как M -by N arrays. M - количество сайтов передатчика, а N - количество сайтов приемника.

Введенный в R2019b