msiread

Считайте файл антенны планеты MSI

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

Синтаксис

msiread(fname)
[horizontal] = msiread(fname)
[horizontal,vertical] = msiread(fname)
[horizontal,vertical,optional] = msiread(fname)

Описание

пример

msiread(fname) читает файл антенны планеты MSI в .pln или форматы .msi.

[horizontal] = msiread(fname) читает файл и возвращает структуру, содержащую горизонтальные данные об усилении.

[horizontal,vertical] = msiread(fname) читает файл и возвращает структуры, содержащие горизонтальные и вертикальные данные об усилении.

пример

[horizontal,vertical,optional] = msiread(fname) читает файл и возвращает структуры, содержащие горизонтальные данные об усилении, вертикальные данные об усилении и все дополнительные данные в файле.

Примеры

свернуть все

Скрипт Open Live Script

Создайте спиральную антенну и постройте шаблон повышения на уровне 2 ГГц.

h = helix;
patternElevation(h,2e9,[0 45 90],'Elevation',0:1:360);

Запишите шаблон повышения спиральной антенны в файле Антенны Планеты MSI.

msiwrite(h,2e9,'helix','Name','Helix Antenna Specifications')

Функция msiwrite сохраняет файл с именем helix.pln в папку MATLAB™ по умолчанию.

NAME Helix Antenna Specifications
FREQUENCY 2000.0
GAIN 8.74 dBi
HORIZONTAL 360
0.00 13.56
1.00 13.48
2.00 13.39
3.00 13.30
4.00 13.22
5.00 13.13

Считайте созданный файл данных антенны MSI.

msiread helix.pln
ans = struct with fields:
    PhysicalQuantity: 'Gain'
           Magnitude: [360x1 double]
               Units: 'dBi'
             Azimuth: [360x1 double]
           Elevation: 0
           Frequency: 2.0000e+09
               Slice: 'Elevation'
Скрипт Open Live Script

Считайте горизонталь, вертикальные и дополнительные данные из файла данных антенны Test_file_demo.pln.

[Horizontal,Vertical,Optional] = msiread('Test_file_demo.pln')
Horizontal = struct with fields:
    PhysicalQuantity: 'Gain'
           Magnitude: [360x1 double]
               Units: 'dBd'
             Azimuth: [360x1 double]
           Elevation: 0
           Frequency: 659000000
               Slice: 'Elevation'


Vertical = struct with fields:
    PhysicalQuantity: 'Gain'
           Magnitude: [360x1 double]
               Units: 'dBd'
             Azimuth: 0
           Elevation: [360x1 double]
           Frequency: 659000000
               Slice: 'Azimuth'


Optional = struct with fields:
             name: 'Sample.pln'
             make: 'Sample 4DR-16-2HW'
        frequency: 659000000
          h_width: 180
          v_width: 7.3000
    front_to_back: 34
             gain: [1x1 struct]
             tilt: 'MECHANICAL'
     polarization: 'POL_H'
          comment: 'Ch-45 0 deg dt'
     scaling_mode: 'AUTOMATIC'

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

свернуть все

Имя файла MSI, заданного как вектор символов. Файлы должны быть формат .msi или .pln.

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

свернуть все

Горизонтальные данные об усилении, возвращенные как структура, содержащая следующие поля:

  • PhysicalQuantity — Количество задано в файле MSI, возвращенном как одно из значений: 'E-field', 'H-field', 'directivity', 'power', 'powerdB' или 'Gain'.

  • Magnitude — Значения значения количества задали в файле MSI, возвращенном как вектор действительных чисел размера N–by–1, где N является тем же размером как углы phi и theta.

  • Модули Модули количества заданы в файле MSI, возвращенном как одно из значений: 'dBi', 'dB', 'V/m', 'watts' или 'dBd'.

  • Azimuth — Углы азимута заданы в файле MSI, возвращенном как скаляр или вектор в градусах.

  • Elevation — Углы повышения заданы в файле MSI, возвращенном как скаляр или вектор в градусах.

  • Frequency — Частота задана в файле MSI, возвращенном как скаляр или вектор в Герц.

  • Срез Тип изменения набора данных, возвращенного как текст. Изменениями является 'Azimuth' или 'Elevation'.

Вертикальные данные об усилении, возвращенные как структура, содержащая следующие поля:

  • PhysicalQuantity — Количество задано в файле MSI, возвращенном как одно из значений: 'E-field', 'H-field', 'directivity', 'power', 'powerdB' или 'Gain'.

  • Magnitude — Значения значения количества задали в файле MSI, возвращенном как вектор действительных чисел размера N–by–1, где N является тем же размером как углы phi и theta.

  • Модули Модули количества заданы в файле MSI, возвращенном как одно из значений: 'dBi', 'dB', 'V/m', 'watts' или 'dBd'.

  • Azimuth — Углы азимута заданы в файле MSI, возвращенном как скаляр или вектор в градусах.

  • Elevation — Углы повышения заданы в файле MSI, возвращенном как скаляр или вектор в градусах.

  • Frequency — Частота задана в файле MSI, возвращенном как скаляр или вектор в Герц.

  • Срез Тип изменения набора данных, возвращенного как текст. Изменениями является Azimuth или Elevation.

Дополнительные данные, возвращенные как структура, содержащая (но не ограниченный): Name, Make, Frequency, H_width, V_width, Front_to_back, Gain, Tilt, Polarization, Comment.

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

Темы

Введенный в R2016a

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