msiwrite

Write antenna or array analysis data to MSI planet file

Syntax

msiwrite(fname,dataslice1,dataslice2)

msiwrite(fname,dataslice1,dataslice2,optional)

msiwrite(object,frequency,fname)

msiwrite(object,frequency,fname,Name=Value)

Description

msiwrite(fname,dataslice1,dataslice2) writes the pattern and field strength data from structures dataSlice1 and dataSlice2 to a MSI planet file named fname. The default extension is .pln. You can also specify a .msi extension.

msiwrite(fname,dataslice1,dataslice2,optional) writes the pattern and field strength data from structures dataSlice1, dataSlice2, and optional to a MSI planet file named fname. The default extension is .pln. You can also specify a .msi extension.

msiwrite(object,frequency,fname) writes calculated pattern and field strength data of an antenna or array object at a specified frequency to an MSI planet file named fname. The default extension is .pln. You can also specify a .msi extension.

msiwrite(object,frequency,fname,Name=Value) uses additional options specified by one or more Name-Value Arguments to write the antenna or array pattern and field strength data to a MSI planet file.

Examples

Write and Read MSI Antenna Data File

Create a helix antenna and plot the elevation pattern at 2 GHz.

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

Write the elevation pattern of the helix antenna in an MSI Planet Antenna file.

msiwrite(h,2e9,"helix",Name="Helix Antenna Specifications")

The msiwrite function saves a file named helix.pln to the default MATLAB™ folder.

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

Read the MSI antenna data file created.

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'

Input Arguments

fname — Name of MSI planet file

string

Name of the MSI planet file, specified as a string. By default, msiwrite writes the MSI planet file in a .pln format. Alternatively you can specify .msi extension also.

Example: "sample_file.pln"

Example: "sample_file.msi"

Data Types: string

dataslice1 — Horizontal gain or field strength data

structure

Horizontal gain or field strength data, specified as a structure containing the following fields:

• PhysicalQuantity — Measured quantity in the MSI file: E-field, H-field, directivity, power, powerdB, or, gain.

• Magnitude — Magnitude values of the measured quantity.

• Units — Units of the measured quantity.

• Azimuth — Azimuth angles.

• Elevation — Elevation angles.

• Frequency — Frequency of operation.

• Slice — Type of data set variation: Azimuth, or Elevation.

Data Types: struct

dataslice2 — Vertical gain or field strength data

structure

Vertical gain or field strength data, specified as a structure containing the following fields:

• PhysicalQuantity — Measured quantity in the MSI file: E-field, H-field, directivity, power, powerdB, or, gain.

• Magnitude — Magnitude values of the measure quantity.

• Units — Units of the measured quantity.

• Azimuth — Azimuth angles.

• Elevation — Elevation angles.

• Frequency — Frequency of operation.

• Slice — Type of data set variation: Azimuth, or Elevation.

Data Types: struct

optional — Additional data

structure

Additional data, specified as a structure containing the following fields: Name, Make, Frequency, H_width, V_width, Front_to_back, Gain, Tilt, Polarization, Comment.

Data Types: struct

object — Antenna or array

antenna object | array object | custom 2-D mesh or geometry object | custom 2-D and 3-D antenna object | pcbStack object | planeWaveExcitation object | measuredAntenna object | installedAntenna object

Antenna or array to write the MSI data file, specified as one of the following options:

• Antenna object from the antenna catalog.

• Array object from the array catalog.

• Custom 2-D mesh or geometry object.

• Custom 2-D and 3-D antenna object.

• pcbStack object.

• planeWaveExcitation object.

• measuredAntenna object.

• installedAntenna object.

Example: yagiUda

frequency — Frequency of operation of antenna or array

positive scalar

Frequency of operation of antenna or array object, specified as a positive scalar in Hertz.

Example: 144e6

Data Types: double

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: Comment="horn antenna"

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: 'Comment','horn antenna'

Name — Title of file

string

Title of file in the first line, specified as a string.

Example: "Designed Helix Antenna in MATLAB"

Data Types: string

Comment — Comments about antenna or array data file

string

Comments about an antenna or array data file, specified as a string.

Example: "This antenna is for space simulations."

Data Types: string

Version History

Introduced in R2016a