msiread

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

Описание

пример

msiread(fname) читает файл антенны планеты MSI в .pln, или .msi ' format ' .

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

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

пример

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

Примеры

свернуть все

Создайте спиральную антенну и постройте шаблон вертикального изменения на уровне 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'

Считайте горизонталь, вертикальные и дополнительные данные из файла данных антенны 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 в виде вектора символов. Файлами должен быть .pln или .msi формат.

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

свернуть все

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Введенный в R2016a

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