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
3DD 3DM BASis(PET) BITmap BMP(file) BOUndary DIRectives DOMain EXPansion FIEld FLF(field-formula) FLT(field-transform) FUNction GRF(grid-formula) GRT(grid-transform) INTegral MMP OBJect OGL(openGL) PALette PARameter PFD PROject VARiable WINdow
Argument(s): Name (n m i k)
Meaning: Read 3D dipole expansions from the file Name and set their object numbers to m. The parameter i specifies the type of the dipole (0 for electric dipoles with 3 parameters, 1 for magnetic dipoles with 3 parameters, 2 for both electric and magnetic dipoles with 6 parameters). The parameter k specifies the color number for all 3D dipoles. Note: the current expansions are overwritten when n is missing. Otherwise, the expansions contained in the file will be appended after the expansion number n. Default values: n=-1, m=0, i=0, k=1.
The files you read in here are ASCII text files to be created by some external software. They have the following structure (no header!):
first line: N, i.e., number N of 3D dipoles
following N lines: i x y z, i.e., domain number and Cartesian coordinates of the dipole.
Special values of Names:
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument(s): Name (n k)
Meaning: Read 3D matching points from the file Name and store them as rectangular 3D objects. In addition to this, a dummy 2D boundary is created because each 3D object must be based on a 2D boundary. The parameter k specifies the grid color number for all 3D rectangles and of the dummy 2D boundary. Note: the current 3D objects are overwritten when n is missing. Otherwise, the objects contained in the file will be appended after the object number n. Default values: n=-1, k=1.
The files you read in here are ASCII text files to be created by some external software. They have the following structure (no header!):
first line: I, i.e., number of identifiers for the 3D matching points. Note that each 3D matching point is between two domains with two different numbers i1 and i2. These numbers must correspond to domains that are defined in the project that reads the 3DM file, i.e., 0<=i1<=nBnd, 0<=i2<=nBnd, where nBnd is the number of defined domains. Note that the orientation of the 3D matching points is crucial for the computation of domain numbers for field point (plotting routines). Thus, the pairs (i2 i1) and (i1 i2) should obtain different identifiers. Example: assume that there are three domains 1, 2, 3 with 3D matching points betweeen 1 and 2 as well as between 2 and 3, but not between 2 and 3. Then you need 2 identifiers if all 3D matching points have a normal pointing into the domain with the higher number. If you also have 3D matching points with opposite orientation, additional identifiers are needed when the automatic computation of the domain numbers of field points is used
following I lines: i1 i2, i.e., domain numbers on the two sides of all matching points with the corresponding identifier. For the example mentioned above, you have: first identifier: 1 2, second identifier: 2 3. If some of the 3D matching points betwenn the domains 1 and 2 have opposite orientation, you need a third identifier (2 1) for them. Note that a 2D boundary (a circle, very far away) with weight 1 and domain numbers i1, i2 is created for each identifier. This boundary is referred to by the 3D objects (rectangles) created for the 3D matching points.
following line: N, i.e., number 3D matching points.
following N lines: i x y z xn yn zn, i.e., identifier and Cartesian coordinates of 3D matching points and of the normal vectors in these points. The norm of the normal vector (xn, yn, zn) should be equal to the area occupied by the 3D matching point. This area is important for the weighting of the equations imposed in the 3D matching point. Since pure 3D matching points do not exist in OpenMaXwell, a rectangular 3D object is created for each 3D matching point.
Special values of Names:
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the basis functions from the file Name. Note: if the current problem is of the eigenvalue type, the basis will be used for the Eigenvalue Extrapolation Technique EET. Otherwise, it is used for the Parameter Estimation Technique PET. Special values of Names:
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the bitmap information from the file Name and paste it to the current graphics window. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the boundaries from the file Name. Note: the current boundaries are overwritten when n is missing. Otherwise, the boundaries contained in the file will be appended after the boundary number n. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the directives from the file Name. Note: the current directives are overwritten. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the domains from the file Name. Note: the current domains are overwritten. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name (n)
Meaning: Read the expansions from the file Name. Note: the current expansions are overwritten when n is missing. Otherwise, the expansions contained in the file will be appended after the expansion number n. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Arguments: Name (WHAt)
Meaning: Read the original field or the representation data from the file Name. Note: the current field is overwritten. When WHAt is missing, the representation data and the field values are read. When WHAt is REPresentation, only the representation data is read. When WHAt is VALue, only the field values are read. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the field definition formula from the file Name. Note: the current formula are overwritten. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the field transformation formula from the file Name. Note: FLT files are created by the MaX-1 software. OpenMaXwell will only read the PFD information contained in these files. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Arguments: Name (WHAt n m i k)
Meaning: Read the function values or the representation data from the file Name. Note: the current functions are overwritten. When WHAt is missing, the representation data and the function values are read. When WHAt is REPresentation, only the representation data is read. When WHAt is VALue, only the function values are read. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
The additional arguments n m i k specify offset numbers for the rows and columns in the function array and the numbers of rows and columns. If n is set, the first n rows of the function array remain unchanged and the rows n+1, n+2, … are used to store the columns 1, 2, … in the function file, i.e., n is the row offset number. Similarly, m is the column offset number. The default offset numbers are 0. When i an k are set, the function array is assumed to have i rows and k columns. This is important when a function file without header is read, for example, one written by another code.
Argument: Name
Meaning: Read the grid definition formula from the file Name. Note: the current formula are overwritten. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the grid transformation formula from the file Name. Note: current formula are overwritten. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the integral data from the file Name. Note: current data is overwritten. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Arguments: Name (What)
Meaning: Read the MMP data from the file Name. Note: current data is overwritten. What can be one of the following:
All: Read all data (header + rectangular + triangular matrix)
Header: Read the header only, ignore matrix data.
Rectangular: Read the header and the rectangular matrix
Triangular: Read the header and the triangular matrix
When What is missing, only the header is read.
Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the 3D object data from the file Name. Note: current data is overwritten when n is missing. Otherwise, the objects contained in the file will be appended after the object number n. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the OpenGL window data from the file Name. Note: current data is overwritten. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the palette data from the file Name. Note: current data is overwritten. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the expansion parameters from the file Name. Note: the current expansion parameters are overwritten. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the PFD data from the file Name. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Argument: Name
Meaning: Read the project data from the file Name. Note: All associated data files (same file name but different file extension) will also be read. All current data is overwritten. Special Names:
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Arguments: n Name l
Meaning: Read the movie variable number n from the file Name. Start reading on line l of the file. Note that several movie variables may be read by this command. For example, when n is 2-5, the variables 2, 3, 4, and 5 will be read.
Argument: Name
Meaning: Read window data from the file Name. Note: the current data of the current graphic window are overwritten. Special Names:
*: use the name of the current project and append the file extension
+: increase the number of the current filename by one
-: decrease the number of the current filename by one
/: use the current filename
0: set the number of the current filename equal to 0
Responsible for this web page: Ch. Hafner, Computational Optics Group, IEF, ETH, 8092 Zurich, Switzerland
Last update
02.02.2017