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

DELete one of the following objects

BOUndary    COLor    CONnection    DOMain    EXPansion    FUNction    INHibit    OBJect    P2D    P3D    PFD    WINdow

BOUndary

Argument(s): n (m)

Meaning: Delete the boundary number n. If m is specified, all boundaries from number n up to m are deleted. Note that n must be in the range 1…nB=number of boundaries.  If n<1, n=1 is set, if n>nB, n=nB is set. The same holds for m.

You may also input special strings (with a – sign inside) instead of n. Special strings of the following forms may be used: -123 (same as n=1, m=123), 123- (same as n=123, m=nB), 123-456 (same as n=123, m=456). Note that no blanks are admitted in these strings.

COLor

Argument: n (C)

Meaning: Delete all boundaries and expansions with color number n. Special cases: n=0 – do for all colors, n<0 – do for color numbers 1 up to -n. Note: as at least one boundary and one expansion must be present,  the program will not allow the last boundary and expansion to be deleted. When the character C is present, it specifies whether only Boundaries or Expansions shall be deleted.

CONnection

Argument: n

Meaning: Delete all boundaries and expansions with connection flag n. Special cases: n=0 – do for all connections, n<0 – do for connection number 1 up to -n. Note: as at least one boundary and one expansion must be present, the program will not allow the last boundary and expansion to be deleted.

DOMain

Argument: n

Meaning: Delete all boundaries and expansions of domain number n. Special cases: n=0 – do for all domains, n<0 – do for domain numbers 1 up to -n. Note: as at least one boundary and expansion must be present, the program will not allow the last boundary and expansion to be deleted.

EXPansion

Argument(s): n (m)

Alternative Arguments: DEPendent f

Meaning: Delete the expansion number n. If m is specified, all expansions from number n up to m are deleted. Note that n must be in the range 1…nE=number of expansions.  If n<1, n=1 is set, if n>nE, n=nE is set. The same holds for m.

You may also input special strings (with a – sign inside) instead of n. Special strings of the following forms may be used: -123 (same as n=1, m=123), 123- (same as n=123, m=nE), 123-456 (same as n=123, m=456). Note that no blanks are admitted in these strings.

When the string DEPendent followed by a real number f is present instead of the integer numbers n and m. The real argument f denotes the maximum dependence factor (see Expansion dialog). The dependence factor is the distance of a multipole from its nearest neighbor (used for one and the same domain) divided by the distance of the multipole from the boundary (of the domain of the multipole). OpenMaXwell will check if dependent multipoles are present. It will delete dependent multipoles starting with the multipole with the smallest dependence factor. Multipoles with dependence factors bigger than f and the excitation will not be deleted.

FUNction

Arguments: ARG n

Meaning: Delete the function argument n, i.e., the column number n of the function array. The character string ARG indicates what part of the function array shall be deleted. Currently, this must be the string ARG.

INHibit

Argument: N

Meaning: Delete the inhibit string number N from the list of "inhibit directives". When N is zero, the list is cleared, i.e., none of the 3D matching points is inhibited. See ADD INHibit for more details.

OBJect

Argument(s): n (m)

Meaning: Delete the 3D object number n. If m is specified, all 3D objects from number n up to m are deleted. Note that n must be in the range 1…nO=number of 3D objects.  If n<1, n=1 is set, if n>nO, n=nO is set. The same holds for m.

P2D

Argument: n

Meaning: Delete the 2D particle number n.

P3D

Argument: n

Meaning: Delete the 3D particle number n.

PFD

Arguments: WHAt n

Meaning: Delete the PFD (Predefined Finite Difference solver) component specified by WHAt. WHAt may be SENsor or SOUrce and n the number of the sensor or source to be deleted.

WINdow

Argument: n

Meaning: Delete the graphic window number n. Note: at least one graphic window must be present.

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