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

MULtiply one of the following objects with some value

ALL    BOUndary    DOMain    EXPansion    FIEld    FREquency    FUNction    GAMma    VARiable    WAVelength

 

ALL

Argument: f

Meaning: Multiply all 2D and 3D data with the factor f or 1/f in the entire project is scaled with f. Data such as locations of boundary points, expansions, window and grid borders are multiplied by f whereas the frequency, periodic constants, and similar values are multiplied by 1/f. Note that some of the parameters in the movie directives might be scaled as well for obtaining a fully scaled project with scaling factor f. This must be done manually.

 

BOUndary

Arguments: n WHAt …

Meaning: Multiply the radius or value of the boundary number n by a given factor. 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 multiplied:

 

DOMain

Arguments: n WHAt Re (Im)

Meaning: Multiply the material properties of domain number n by the complex factor with real part Re and imaginary part Im. When Im is missing, the imaginary part 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 multiplied:

 

EXPansion

Arguments: n WHAt (m) f (phi)

Meaning: Multiply the angle or parameters of 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 part of the expansion is to be increased:

 

FIEld

Arguments: x y

Meaning: Multiply all field components of the current original field with the complex constant x+iy.

 

FREquency

Arguments: f (phi)

Meaning: Multiply the current frequency with the complex factor  f *exp(i*phi*Pi/180). When phi is missing, it is set equal to zero. Note that phi is an angle in the complex plane in degrees.

 

FUNction

Arguments: i x

Meaning: All of the current function values with argument number i with the constant x.

 

GAMma

Arguments: f (phi)

Meaning: Multiply the current propagation constant gamma or the  half length of the period in the z direction by the complex factor  f *exp(i*phi*Pi/180). When phi is missing, it is set equal to zero. Note that phi is an angle in the complex plane in degrees.  If the eigenvalue search is turned on and if the frequency is searched, the half length of the period in z direction is multiplied, otherwise gamma is multiplied.

 

VARiable

Arguments: Value (Number)

Meaning: Multiply the current movie variable with the index Number with the real factor 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 text output on a graphic 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

Arguments: f

Meaning: Multiply the current free space wavelength with the real  factor  f .

 

 

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

Last update 27.10.2015