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) считывает файл и возвращает структуры, содержащие данные о горизонтальном усилении, данные о вертикальном усилении и все дополнительные данные в файле.

Примеры

свернуть все

Открыть Live Script

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

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

Figure contains an object of type uicontainer.

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

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'
Открыть 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, заданное как вектор символов. Файлы должны быть .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, возвращаемая в виде скаляра или вектора на Hertz.

  • 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, возвращаемая в виде скаляра или вектора на Hertz.

  • Slice - Тип изменения набора данных, возвращенный как текст. Ниже перечислены изменения Azimuth или Elevation.

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

См. также

Темы

Введенный в R2016a

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

Поддержка

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