msiwrite

Write data in MSI planet antenna file format

collapse all in page

Syntax

msiwrite(fname,dataslice1,dataslice2)
msiwrite(fname,dataslice1,dataslice2,optional)
msiwrite(objname,frequency,fname)
msiwrite(objname,frequency,fname,Name,Value)

Description

msiwrite(fname,dataslice1,dataslice2) writes the data from structures dataSlice1 and dataSlice2 to an MSI planet antenna file called fname.

msiwrite(fname,dataslice1,dataslice2,optional) writes the data from structures dataSlice1, dataSlice2, and optional to an MSI planet antenna file called fname.

msiwrite(objname,frequency,fname) writes calculated data of an antenna or array object at a specified frequency to an MSI planet antenna file called fname.

example

msiwrite(objname,frequency,fname,Name,Value) uses additional options specified by one or more Name,Value pair arguments.

Examples

collapse all

Open Live Script

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

collapse all

Name of MSI file, specified as a character vector. By default, msiwrite writes the MSI planet antenna file that has a .pln format.

Horizontal or vertical gain 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.

Horizontal or vertical gain 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.

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

Antenna or array object, specified as an antenna or array handle.

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

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'Comment', 'horn antenna'

Title of file in the first line, specified as the comma-separated pair consisting of 'Name' and a character vector.

Example: 'Name', 'Designed Helix Antenna in MATLAB'

Data Types: char

Comments about an antenna or array data file, specified as the comma-separated pair consisting of 'Comment' and a character array.

Example: 'Comment', 'This antenna is for space simulations.'

Data Types: char

See Also

Topics

Introduced in R2016a

Antenna Toolbox Documentation

Support