Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

msiwrite

Write data in MSI planet antenna file format

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

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.plnto 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 vectorBy 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 single quotes (' '). You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'Comment', 'horn antenna'

collapse all

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

Introduced in R2016a

Was this topic helpful?