Exponenta Banner
exponenta event banner

msiread

Чтение файла антенны планеты MSI

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

Синтаксис

msiread (имя файла)
[horizontal] = msiread (имя файла)
[горизонтальный, вертикальный] = msiread (имя файла)
[горизонтальный, вертикальный, необязательный] = msiread (fname)

Описание

пример

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

[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);

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'
Открыть сценарий в реальном времени

Считывайте горизонтальные, вертикальные и необязательные данные из файла данных антенны 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

Документация по панели инструментов антенны

Поддержка