В этом примере показано, как считывать антенный файл MSI Planet (.MSI или .PLN). Файл MSI можно прочитать с помощью msiread и визуализировать данные с помощью polarpattern функция. Можно также записать данные обратно в формат MSI Planet с помощью msiwrite функция.
Чтение файла .pln
[Horizontal,Vertical,Optional] = msiread('Test_file_demo.pln');Модуль чтения файлов MSI Planet возвращает 3 структуры. Горизонтальные и вертикальные структуры содержат 7 полей: 1) PhysicalQuantity: Описывает характер данных в файле. Обычно файлы MSI Planet содержат данные об усилении антенны. 2) Величина: коэффициент усиления 3) Единицы: Единицы измерения данных 4) Азимут: Азимутальный угол (углы) в градусах, при которых измерялись данные. 5) Отметка: угол (углы) возвышения в градусах, при которых измерялись данные. 6) Частота: Частота работы в Герце. 7) Срез: секущая плоскость измеренных данных. Этой плоскостью может быть «Азимут» или «Отметка».
Дополнительная структура содержит все другие поля файла, такие как имя, марка, частота, h_width, v_width, front_to_back, усиление, наклон, поляризация, комментарий. В файле также могут быть другие поля.
Горизонтальные и вертикальные данные усиления в файле планеты MSI задаются как данные потерь и относятся к коэффициенту усиления, указанному в файле. Эти данные преобразуются в данные усиления. После чтения файла относительность к выигрышу удаляется в горизонтальной и вертикальной структурах.
Отношение front_to_back в файле MSI Planet вычисляется либо по данным горизонтального усиления, либо по данным вертикального усиления. Результаты могут отражать одну из этих возможностей: 1) Отношение между пиковым значением и значением в противоположном полушарии (180 градусов от угла пикового значения). 2) Отношение между пиковым значением и наихудшим значением в 60-градусном секторе ((пиковый угол + 180) +/- 30 градусов). 2) Отношение между пиковым значением и наихудшим значением в 40-градусном секторе ((пиковый угол + 180) +/- 20 градусов).
Визуализация данных вертикального усиления на интерактивном 2D полярном графике. Щелкните правой кнопкой мыши в окне рисунка для взаимодействия с графиком.
P = polarpattern(Vertical.Elevation, Vertical.Magnitude); P.TitleTop = 'MSI Planet file data'; createLabels(P,'az=0#deg');

Пики и курсоры можно включить с помощью интерактивного графика или командной строки. Для включения пиков щелкните правой кнопкой мыши на графике. Нажмите кнопку Measurements tab, а затем проверьте Peak Locations в контекстном меню. Для управления количеством пиков с помощью графика щелкните правой кнопкой мыши на любом треугольнике пиков и выберите в контекстном меню пункт «Значения пиков».

% The peaks can also be turned on using the command line.
P.Peaks = 3;
Чтобы включить угловой диапазон, щелкните правой кнопкой мыши на графике. Нажмите на Measurements tab, а затем проверьте Angle Span контекстное меню. Для включения диапазона углов между пиками 2 и 3 пользователь может использовать следующую функцию.
showSpan(P,'P2','P3',1);

Чтобы добавить курсор, дважды щелкните на графике в нужном месте. Курсор можно переместить с помощью мыши. Курсор можно добавить под углом 36 градусов с помощью следующей функции
addCursor(P,36,1);

Включение метрики антенны отображает основной, задний и боковые лепестки на графике. В нем также содержится текстовое поле с измерениями антенны: 1) Ширина луча с половинной мощностью 2) Первая нулевая ширина луча 3) Отношение спереди к спине 4) Уровень боковых лепестков 5) Пиковое значение основного лепестка и соответствующий угол 6) Пиковое значение заднего лепестка и соответствующий угол.
В файлах MSI Planet доступны некоторые из этих измерений, такие как ширина луча половинной мощности и отношение «спереди-назад». Эти результаты можно сравнить и проверить между файлами и графиком.
P = polarpattern(Vertical.Elevation, Vertical.Magnitude);
P.AntennaMetrics = 1; % Turning on antenna metrics on the plot
Позвоните в msiwrite чтобы взять 3 структуры вывода из msiread и запишите данные в формате MSI Planet.
msiwrite('Test_file_demo_write.pln',Horizontal,Vertical,Optional);Первые три входа в msiwrite функции являются обязательными. Это имя файла, горизонтальная структура данных и вертикальная структура данных. Пользователь также может предоставить дополнительную структуру в качестве четвертого аргумента. Горизонтальные и вертикальные структуры данных должны содержать 7 полей, описанных выше.
Данные усиления делаются относительно значения усиления и преобразуются в потери дБ, когда они записываются в файл.
msiwrite функциональные возможности также могут принимать антенну или объект решетки в качестве входного сигнала. Другими входами являются частота, имя файла и две пары «имя-значение»: «имя» и «комментарий». С помощью этой функции можно сначала спроектировать антенну. Затем можно ввести антенный объект вместе с требуемой частотой и именем файла в формат MSI Planet.
h = helix; % Creating helix in default configuration msiwrite(h,2e9,'test_helix','Name','Test_Antenna','Comment', ... 'Designed Helix Antenna in MATLAB');