modeoverlap

Returns the overlap between the respective mode profiles (modes) of two FEEM calculations, if given two FEEM solver result structs. The command result is a matrix where each row corresponds to a mode in the struct with the highest polynomial order or highest number of elements, and each column corresponds to a mode in the other struct. Suppose the polynomial order and number of elements are identical in both FEEM calculations. In that case, each row corresponds to a mode in the first struct, whereas each column corresponds to the second struct. Note that the FEEM simulation regions must have the same orientation.

Returns the overlap between all modes found in a FEEM calculation and the Fourier-transformed (frequency-domain) field of a DGTD calculation for all frequencies, if given two structs containing a FEEM solver result and a DGTD frequency monitor result, respectively. The command result is a matrix where each row corresponds to a mode in the FEEM struct and each column corresponds to a frequency in the DGTD struct, independent of the order of the input. Note that the FEEM simulation region and the DGTD frequency monitor must have the same orientation apart from the sign.

To construct the input structs, the FEEM solver results of rawFeemFields, rawFeemMesh, and modeproperties are required for a FEEM/FEEM mode overlap. To calculate a FEEM/DGTD mode overlap the frequency monitor results rawDgtdFields and rawDgtdMesh are required in addition. Furthermore, the FEEM simulation region orientation needs to be specified as a vector. The same applies to the DGTD monitor orientation, if in use.

Example

The following example shows how to construct the input structs:

rawFeemFields = getresult("FEEM","rawFeemFields");
rawFeemMesh = getresult("FEEM","rawFeemMesh");
modeproperties = getresult("FEEM","modeproperties");

feem_struct = {
"E": rawFeemFields.E,
"H": rawFeemFields.H,
"order": rawFeemMesh.order,
"connectivity": rawFeemMesh.connectivity,
"vertices": rawFeemMesh.vertices,
"normal vector": [0,0,1],
"DoFt": rawFeemFields.DoFt,
"DoFz": rawFeemFields.DoFz,
"kz": modeproperties.kz
};

dgtd_struct = {
    "E": rawDgtdFields.E,
    "H": rawDgtdFields.H,
    "order": rawDgtdMesh.order,
    "connectivity": rawDgtdMesh.connectivity,
    "vertices": rawDgtdMesh.vertices,
    "normalvector": [0,0,1]
    };

Using the two structs from above, one can calculate the overlap between the FEEM mode profiles and the frequency-domain DGTD fields:

?modeoverlap(feem_struct, dgtd_struct);
?modeoverlap(feem_struct, dgtd_struct, false);

DGTD Raw Fields/Mesh Data

For a given DGTD calculation the 2D frequency monitor now records the raw Fourier-transformed i.e., frequency domain fields rawDgtdFields as well as the raw mesh data rawDgtdMesh.

FEEM Raw Fields/Mesh Data

For a given FEEM calculation raw i.e., unprocessed mode data rawFeemFields as well as the raw mesh data rawDgtdMesh is now recorded

See Also

modeexpansion , struct, FEEM solver - Simulation object, DGTD solver - Simulation object