OpenMaXwell Reference Manual

Home  General  Menues  Dialogs  Movie Directives  Formula Interpreter  File Structures

Available directives

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

INCrease one of the following values

BOUndary    DOMain    EIGenvalue    EXCitation    EXPansion    FIEld    FREquency    GAMma    GRId    LEVel    MMP    PERiod    PHI(phase)    PLAne    SYMmetry    TIMe    VARiable    WAVelength

 

BOUndary

Arguments: n WHAt …

Meaning: Increase the radius or value of the boundary number n. Special cases: n=0 – do for all boundaries, n<0 – do for boundary numbers 1 up to -n. WHAt specifies what part of the boundary is to be increased:

 

DOMain

Arguments: n WHAt Re (Im)

Meaning: Increase the material properties of domain number n by the complex value with real part Re and imaginary part Im. When Im is missing, the imaginary increment is 0. Note that this directive should not be used when the material properties are defined by a formula. WHAt specifies what property is to be increased:

 

EIGenvalue

Argument: i

Meaning: Increase the eigenvalue number to be searched for by i.

 

EXCitation

Arguments: f

Meaning: Increase data of the number of the current excitation by f. This only makes sense for for scattering problems with multiple excitations. If the number of the excitation exceeds the number of defined excitations (see Expansion dialog), the current expansion is set equal to the maximum excitation number. If the number of the excitation is less then 1, the current expansion is set equal to 1.

 

EXPansion

Arguments: n WHAt f

Meaning: Increase data of the expansion number n by f. Special cases: n=0 – do for all expansions, n<0 – do for expansion numbers 1 up to -n. WHAt specifies what data of the expansion is to be increased:

 

FIEld

Arguments: FORmula WHAt i

Meaning: Increase the field formula number specified by WHAt by i. For details about the field formula numbers, see Field formula dialog. Note that the argument string FORmula is required. WHAt may be one of the following:

 

FREquency

Arguments: Real (Imaginary)

Meaning: Increase the current frequency by a complex number with the real part Real and the imaginary part Imaginary. If Imaginary is missing, it is set equal to zero.

 

GAMma

Arguments: Real (Imaginary)

Meaning: Increase the current  normalized propagation constant gamma or the  half length of the period in z direction by a complex number with the real part Real and the imaginary part Imaginary. If Imaginary is missing, it is set equal to zero. If the eigenvalue search is turned on and if the frequency is searched, the half length of the period in z direction is increased, otherwise gamma is increased.

 

GRId

Arguments: nx (ny nz)

Meaning: Increase the numbers of grid lines in x, y, z directions by nx, ny, nz. Any missing arguments are set to zero by default. Note that the grid point and the field in these points will be cleared.

 

LEVel

Argument: (n)

Meaning: Increase the level of the current plane of the grid by n. If n is missing, it is set equal to 1. Note that the current plane is the plane of the grid used for computing the derived field. When the resulting level number is out of range, a valid level number is obtained by subtracting multiples of the number of levels. For example: 10 levels are present, if the previous level was 9and n=13 the new level would be 22, which is out of range. By subtracting twice the number of levels, the new level number 2 is obtained.

 

MMP

Arguments: WHAt n

Meaning: The MMP parameter WHAt by n. Currently, WHAt can only be LASt, i.e. the Last column parameter in the MMP dialog.

 

PERiod

Arguments: What …

Meaning: Increase data of periodic problems. What specifies what is to be increased. What can be one of the following:

 

PHI

Argument: f

Meaning: Increase the phase (of time-harmonic fields) by f.

 

PLAne

Argument: n

Meaning: Increase the current plane of the grid by n. Note that the current plane is the plane of the grid used for computing the derived field. There are three planes. 1: xy, 2: xz, 3: yz.

 

SYMmetry

Arguments: ixy ixz iyz

Meaning: Increase the symmetry numbers with respect to the XY, XZ, and YZ planes by ixy ixz iyz respectively. Note that the symmetry numbers must be in the range 0…2. Therefore, the new symmetry number is set equal to modulo(iold+incr), where iold denotes the old symmetry number and incr is the corresponding increment ixy, ixz, or  iyz.

 

TIMe

Argument: f

Meaning: Increase the current time by f.

 

VARiable

Arguments: Value (Number)

Meaning: Increase the current movie variable with the index Number by Value. When Number is missing, it is set equal to 0. Note that the variable can have any meaning. It is defined and manipulated by the user only. Its main purpose is to output text to a graphics window. The movie variables are stored in an array. The current number of elements in this array is 1000, i.e., Number should be in the range 0…999. Note that 996-999 is usually used for MBPE.

 

WAVelength

Argument: f

Meaning: Increase the free space wavelength by f.

 

Responsible for this web page:  Ch. Hafner, Computational Optics Group, IEF, ETH, 8092 Zurich, Switzerland

Last update 27.10.2015