ADApt ADD BLOw CLEar CONvert COPy DELete DRAw END EXChange EXIt GENerate GET GOTo IF> IF< IF= INCrease ITEterate LABel LOOp MMP MOVe MULtiply PROcess REAd REFlect REName ROTate RUN SET SORt SUBtract WRIte
Argument(s): Command (…)
Meaning: Run the DOS command Command (…).
Example: “run dos del xxx.yyy” deletes the file xxx.yyy.
Argument(s): WHAt (…)
Meaning: Run the MBPE routine for a quick evaluation of frequency- or wavelength-dependent values v(x), where x may be the frequency or the wavelength. WHAt (…) may be one of the following:
ADAptive ix ir (ii kx kr ki File n): Adaptive MBPE for complex functions, stored in the function array or computed using movie commands with % signs as the first character. The x values are stored in the column number ix, the real parts of v in the column number ir, and the imaginary parts of v in the column number ii. If ii is missing, it is set equal to ir. If kx kr ki are present and bigger than 0, the MBPE approximation is stored in the columns kx kr ki of the function array. Otherwise, it is stored in the function File. When File is missing, the function file name is set to MBPE.FUN.
Notes:
When you set ix ir ii kx kr ki to 0 0 0 0 0 0, movie commands with % signs as the first character are used to compute the (complex) function v to be analyzed using MBPE. You then do not to compute and store v in the function array before you run MBPE. You then need to associate three movie variables with x (instead of ix), Real(v) (instead of ir), and Imag(v) (instead of ii). For doing this, use the command "SET MBPe VARiables v1 v2 v3", where v1, v2, v3 are the numbers of the movie variables you want to use. Example: After the commands "SET MBPe VARiables 91 92 93" and "RUN MBPe ADAptive 0 0 0 0 0 0 mbpe005.fun" typical set of % commands might be: "% SET WAVelength v91", "% MMP SOLve", "% SET VARiable 92 PARameter 1 1 REAl", "% SET VARiable 92 PARameter 1 1 REAl". In this case, 1) the wavelength corresponds to x and is represented by v91, 2) the real part of the first parameter of the first expansion corresponds to Real(v) and is represented by v92, and 3) the imaginary part of the first parameter of the first expansion corresponds to Imag(v) and is represented by v93.
When the MBPE approximation is stored in a file, you may use a finer discretization of the frequency or wavelength interval by desining the number n of output points. This feature is mainly used for testing purposes!
COMpute: Adaptive MBPE approximation from values v(x) obtained by executing the movie commands with % signs in the first character.
FUNction ix ir (ii kx kr ki File n ...): Adaptive MBPE for complex functions, stored in the function array. The x values are stored in the column number ix, the real parts of v in the column number ir, and the imaginary parts of v in the column number ii. If ii is missing, it is set equal to ir. If kx kr ki are present and bigger than 0, the MBPE approximation is stored in the columns kx kr ki of the function array. Otherwise, it is stored in the function File. When File is missing, the function file name is set to MBPE.FUN. When the MBPE approximation is stored in a file, you may use a finer discretization of the frequency or wavelength interval by desining the number n of output points.
If n equals the number of points (rows) in the function array, you may specify the following additional arguments: nseg nover error. Then, the interval xmin<x<xmax is divided into nseg segments and MBPE is evaluated separately for each segment. In order to obtain smooth transitions between the segments you may specify overlapping segements by defining nover >0. Note that nover should be smaller then half of the segment size. You may specify an error flag error. If it is present, MBPE is refined until the relative error is estimated below error in percent or until one of the MBPE stopping criteria is met.
If n differs from the number of points (rows) in the function array, you may specify the following additional arguments: xmin xmax xminout xmaxout. MBPE with a single segment, i.e., the interval xmin...xmax will be performed. The MBPE approximation may then be evaluated for an interval xminout...xmaxout that may be different from the interval xmin...xmax used for the analysis.
FIEld ix iy n k: Perform a 2nd order MBPE minimum search using data stored in complex field array cFld. n may be 5 or 9 for 5 point and 9 point estimations respectively. Use the field component k. k may be 1 (Ex), 2 (Ey), 3 (Ez), 4 (Hx), 5 (Hy), 6 (Hz). ix iy defines the position in the cFld array. This feature is for testing purposes of advanced complex eigenvalue analysis.
Argument(s): Program (Option)
Meaning: Execute the Program with the command line Option.
Example: “run pro c:\yyy\XXX.EXE” executes XXX.EXE, provided that it is present in the subdirectory c:\yyy.
Responsible for this web page: Ch. Hafner, Computational Optics Group, IEF, ETH, 8092 Zurich, Switzerland
Last update
27.10.2015