IBM Release 1.93 PDAs & Smartphones User Manual


 
LIST Stores a list of field values as ASCII floating point numbers, suitable
for reading into a spreadsheet or a plotting program such as
GNUPLOT. The row-column arrangement of a 3-dimensional list
file depends on the value of orientation. Coordinate axes are always
taken in cyclic order, with the leftmost position in the first line
corresponding to the minimum of all coordinates; in a 2-D list in XY
orientation (perpendicular to Z), columns correspond to the x
coordinate and rows to the y coordinate. In YZ orientation, y goes
across columns and z goes down rows, and in ZX orientation, z
goes across columns and x down rows. (ZY is the same as YZ, and
XZ is the same as ZX--cyclic order is always preserved.) In a three-
dimensional list, the perpendicular variable is most slowly varying.
For example, in XY orientation, a 3-D list file with M planes (Z) N
rows (Y) and P columns (X) would have list N rows for the first
plane, another N for the second plane, and so on. The file format is
as follows, with integer indices i, j, and k corresponding to
coordinates x, y, and z.
Parameters: variable file orientation xlo xhi ylo yhi zlo zhi phase indexn
kmin kmax jmin jmax imin imax
lambda indexN dz dy dx
coordinates arrangement
(real, imag) (real, imag) (real, imag)....
(real, imag) (real, imag) (real, imag)....
...
(real, imag) (real, imag) (real, imag)....
The value of coordinates can be polar or rectangular, and arrangement
can be normal or FFT.
MODEFILE A variation on the LIST command, for producing 2-D list files of E
x
,
E
y
, and E
z
The appropriate file name additions are supplied
automatically.
Parameters: file orientation xlo xhi ylo yhi zlo zhi phase indexn
MODEMATCH Computes the far-field pattern of the simulated fields, taken from
the given plane, and compares it with the analytically computed
pupil function requested. It returns the normalized overlap integral
of the two across the (u, v) plane. This is a complicated way of
saying that MODEMATCH returns the coupling efficiency from the
simulated plane to a receiver whose sensitivity pattern matches the
given pupil function, e.g. a fibre. Known pupil functions at present
are GAUSSIAN, AIRY, FLATTOP, and BESSJ0. The refractive index
is taken to be the real part of the index at the centre of the given
plane, as in the FARFIELD order.
25