В этом примере показано, как считать файл антенны 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) Срез: Секите плоскость измеренных данных. Этот самолет может быть 'Azimuth' или 'Elevation'.
Опциональная структура содержит все другие поля из файла, такие как: name, make, frequency, h_width, v_width, front_to_back, gain, tilt, polarization, comment. В файле также могут быть другие поля.
Данные о горизонтальном и вертикальном усилении в файле MSI Planet заданы как данные о потерях и соответствуют усилению, указанному в файле. Эти данные преобразуются в данные усиления. После чтения файла относительность к усилению удаляется в горизонтальной и вертикальной структурах.
Коэффициент 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');
Peaks и курсоры можно включить с помощью интерактивного графика или командной строки. Чтобы включить peaks, щелкните правой нажатие кнопки график. Нажмите на Measurements вкладка и затем проверяйте Peak Locations из контекстного меню. Чтобы контролировать количество пиков с помощью графика, щелкните правой нажатие кнопки по любому из пиковых треугольников и используйте Num Peaks из контекстного меню.
% The peaks can also be turned on using the command line.
P.Peaks = 3;
Чтобы включить диапазон углов, щелкните правой нажатие кнопки на графике. Нажмите на Measurements вкладка и затем проверяйте Angle Span контекстное меню. Чтобы включить диапазон углов между peaks 2 и 3, пользователь может использовать следующую функцию.
showSpan(P,'P2','P3',1);
Чтобы добавить курсор, дважды нажатие кнопки график в предполагаемом месте. Перемещение курсора осуществляется с помощью мыши. Курсор можно добавить на 36 степенях с помощью следующей функции
addCursor(P,36,1);
Включение метрики антенны отображает основные, задние и боковые лепестки на графике. Это также приводит текстовое поле с измерениями антенны: 1) Полустепень Beamwidth 2) First-Null Beamwidth 3) Front-to-Back ratio 4) Side-lobe level 5) Главное пиковое значение лепестка и соответствующий угол 6) Заднее пиковое значение лепестка и соответствующий угол.
Некоторые из этих измерений, такие как Полустепень и отношение Front-to-Back, доступны в файлах MSI Planet. Эти результаты можно сравнить и проверить между файлами и графиком.
P = polarpattern(Vertical.Elevation, Vertical.Magnitude);
P.AntennaMetrics = 1; % Turning on antenna metrics on the plot
Вызовите msiwrite функция, чтобы взять 3 структуры output из msiread выполнять функцию и записывать данные в формате файла MSI Planet.
msiwrite('Test_file_demo_write.pln',Horizontal,Vertical,Optional);Первые три входов для msiwrite функция обязательна. Это имя файла, горизонтальная структура данных и вертикальная структура данных. Пользователь может также предоставить дополнительную структуру в качестве 4-го аргумента. Структуры горизонтальных и вертикальных данных должны содержать 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');