# EME solver - Simulation object

=tab title list==============================================

=tab1 content start==============================================

- ALGORITHM: The type of mesh algorithm used ("finite-difference" is currently the only available option).
- BACKGROUND INDEX: The refractive index of the surrounding, background medium in the simulation region.
- SOLVER TYPE: Can choose either a 2D or 3D solver.
- FREQUENCY/WAVELENGTH: The frequency or wavelength to calculate results for.

=tab1 content end==============================================

=tab2 content start==============================================

### Cell geometry

Includes settings for the y and z geometry of the simulation region. Also includes the following settings:

- X MIN: Minimum x position of solver region. First cell group starts from this position.
- ENERGY CONSERVATION: None, passive, or conserve energy.
- NUMBER OF CELL GROUPS: Sets the number of cells in the solver region.
- NUMBER OF MODES FOR ALL CELL GROUPS: Sets number of modes to solve for in all cells.
- ALLOW CUSTOM EIGENSOLVER SETTINGS: Allows you to set a different number of modes to solve for different cell groups in the CELL GROUP DEFINITION table. In addition, users can set other mode solving properties such as the guess effective index, bent waveguide properties ... etc by clicking on the "Custom settings for cell group" button below the table
- ENERGY CONSERVATION: Allows you to select the type of energy conservation to use in the propagation stage of an EME calculation. The choices are:
- None: no energy conservation is applied.
- Make passive: force the total power out of the device to be less than or equal to the total power into the device. This is the default setting and is suitable in most cases.
- Conserve energy: force the total power out of the device to be equal to the total power into the device. This is often necessary for periodic devices like Bragg gratings.
- CELL GROUP DEFINITION: Allows you to set the span of each cell group, the number of cells in each cell group, the subcell method to use (none or CVCS), and number of modes to solve for in each cell. Displays the cell range of the group, and start and stop positions of the cell group.
- DISPLAY CELLS: Displays cell boundaries in the CAD.
- CLEAR SETTINGS FOR CELL GROUP: Clears the custom settings for the selected cell group.
- CUSTOM SETTINGS FOR CELL GROUP: Allows you to make custom settings for the selected cell group (please refer FDE settings).

Other quantities such as y, y span, z and z span are the same as FDE to define the cell cross sections.

### Periodicity

- NUMBER OF PERIODIC GROUPS: Number of regions of the structure that are periodic.
- PERIODIC GROUP DEFINITION: Defines the cell regions that have periodicity and the number of periods in each region.The "start cell group" and the "end cell group" are the sequential numbers in the "cell group definition".
- CELL GROUP SEQUENCE: Displays the current setup and periodicity. For example [1,(2)^10,3] indicates that there are three cell groups and the second cell group is repeated ten times.

Note: Cell group periodicity and EME profile monitors EME field profile monitors should not be used with the Cell group periodicity feature. EME profile monitors will not correctly reconstruct the field profile when Cell group periodicity is used. |

=tab2 content end==============================================

=tab3 content start==============================================

Since the propagation axis in the EME solver is in the x-direction, the mesh settings only apply in the y and/or z directions depending on the solver type (2D XY, 2D XZ, or 3D). This is the same as FDE settings.

### Mesh definition

The default uniform mesh in can be defined by setting the 'Number of mesh cells', or by setting a target mesh size using 'Maximum mesh step'.

### Maximum mesh step settings

- DY, DZ: Target mesh size when using 'Maximum mesh step' mesh definition

### Mesh grading

- GRADING FACTOR: Determines the maximum rate at which the mesh can be modified. For example, if dx(i+1) = a*dx(i), then 1/(GRADING FACTOR) <= a <= GRADING FACTOR. The grading factor should be between 1 and 2. The default setting is sqrt(2).

### Minimum mesh step settings

- MIN MESH STEP: sets the minimum mesh step for the entire solver region including the mesh override regions.

### Actual number of mesh cells used

Displays the number of mesh cells in each direction.

### Number of mesh cells without override regions

Displays the number of mesh cells in each direction if no mesh override regions are used.

=tab3 content end==============================================

=tab4 content start==============================================

The boundary conditions that are supported by FDTD/MODE Solutions are listed below.

Perfectly matched layer (PML)1 boundaries absorb electromagnetic waves incident upon them. They essentially model open (or reflectionless) boundaries. In FDTD and varFDTD simulation regions, the user can directly specify all the parameters that control their absorption properties including the number of layers. To facilitate the selection of PML parameters, a number of profiles (or predefined sets of parameters) are available under the boundary conditions tab. In most simulation scenarios, the user only needs to choose one of the predefined profiles and fine tune the number of layers. PML boundaries perform best when the surrounding structures extend completely through the boundary condition region. This will be the default behavior of structures whether or not they were drawn to end inside or outside the PML region.

1 J. P. Berenger, Perfectly Matched Layer (PML) for Computational Electromagnetics. Morgan & Claypool Publishers, 2007.

Metal boundary conditions are used to specify boundaries that behave as a Perfect Electric Conductor (PEC). The component of the electric field parallel to a metal (PEC) boundary is zero; the component of the magnetic field H perpendicular to a metal (PEC) boundary is also zero. Metal boundaries are perfectly reflecting, allowing no energy to escape the simulation volume along that boundary. In the FDE solver, metal BC is the default setting.

Perfect Magnetic Conductor (PMC) boundary conditions are the magnetic equivalent of the metal (PEC) boundaries. The component of the magnetic field H parallel to a PMC boundary is zero; the component of the electric field perpendicular to a PMC boundary is also zero.

Periodic BC should be used when both the structures and EM fields are periodic. Periodic boundary conditions can be used in one or more directions (i.e. only in the x direction) to simulate a structure which is periodic in one direction but not necessarily other directions.

Bloch BC should be used when the structures and the EM fields are periodic, but a phase shift exists between each period. Bloch boundary conditions are used in FDTD and propagator simulations predominantly for the following two simulations:

- Launching a plane wave at an angle to a periodic structure – in this situation, accurate reflection and transmission data can be measured at a single frequency point for a given simulation.
- Calculating the bandstructure of a periodic object – in this situation, a broadband pulse is injected via a dipole source into a periodic structure.

Note: if you choose BFAST plane wave source, the Bloch BCs will be automatically overridden and use its built_in boundary conditions.

Symmetric/anti-symmetric boundary conditions are used when the user is interested in a problem that exhibits one or more planes of symmetry; both the structure and source must be symmetric. Symmetric boundaries are mirrors for the electric field, and anti-mirrors for the magnetic field. On the other hand, antisymmetric boundaries are anti-mirrors for the electric field, and mirrors for the magnetic field. Careful consideration must be given to whether symmetric or anti-symmetric boundary conditions are required, given the vector symmetry of the desired solution. For meaningful results, the sources used must have the same symmetry as the boundary conditions. Further information about symmetric and anti-symmetric boundary conditions can be found in Choosing between symmetric and anti-symmetric BCs.

- ALLOW SYMMETRY ON ALL BOUNDARIES: Allows symmetric boundary conditions with periodic structures (this option is not available in the boundary condition tab of mode sources and mode expansion monitors).

=tab4 content end==============================================

=tab5 content start==============================================

### Mesh Refinement:

Mesh refinement can give sub-cell accuracy for a simulation. See the Mesh refinement options page for more information.

### FIT MATERIALS WITH MULTI-COEFFICIENT MODEL

(For sampled material data) When MODE solves for modes, it uses material data that is obtained from a linear interpolation from the closest data points. This means that when a frequency sweep is run, the material data used can be discontinuous in time. This is especially problematic for properties such as dispersion which depends on a second derivative of the refractive index as a function of wavelength.

If you check this option, you can choose to fit two types of materials with a multi-coefficient model. Here are the options that are available when the checkbox is checked:

- Fit sampled materials: By default this is checked. Sampled material data will be fit with a smooth multi-coefficient material model.
- Fit analytic materials: Check this option to fit a multi-coefficient model to the analytic material data. The only reason to fit analytic models with a multi-coefficient model is to compare MODE results with FDTD. FDTD simulations must fit a multi-coefficient model to the analytic data in order to run simulations, but the multi-coefficient model may not be able to fit the analytic model perfectly.
- Wavelength min/max or center/span: Set bandwidth over which to apply the fit.

=tab5 content end==============================================

=tab6 content start==============================================

Note: This tab includes options which should only be changed if you are quite familiar with the meshing algorithm and techniques used. |

### Mesh settings

- FORCE SYMMETRIC X, Y, Z MESH: Will force a symmetric mesh about the y or z axis. When this option is enabled, the meshing algorithm ONLY considers objects in the positive half of the simulation region. The mesh in the negative half is simply a copy of the positive half mesh. All physical structures and mesh override regions in the negative half will not be considered by the meshing algorithm. This option also forces a mesh point at the center of the simulation region. Forcing a symmetric mesh ensures that the mesh does not change when going from a simulation with symmetry to a simulation without symmetry.

### PML settings

- PML KAPPA: The normalized imaginary electric and magnetic conductivity used in the PML boundaries.
- PML SIGMA: The maximum normalized electric and magnetic conductivity used in the PML boundaries.
- PML LAYERS: The number of cells which are used for PML boundary conditions. Increasing this number will reduce the back-reflection arising from the PML boundaries but will also increase time and memory requirements for simulations.Defaults to a setting of 12.
- PML POLYNOMIAL: The polynomial power which determines how rapidly the electric and magnetic conductivity increases as radiation propagates at normal incidence into the PML. The default setting of 3 denotes a cubic increase of electric and magnetic conductivity with increasing depth into the PML.
- SET DEFAULTS: This button resets the parameters of the advanced settings tab to the default settings.

### EME settings

- CONVERGENCE TOLERANCE: The convergence tolerance used for the calculations - the default value corresponds to 1e-12 but can be increased by the user to speed convergence or decreased to improve accuracy
- MAX STORED MODES: Maximum number of modes for each cell in the EME setup.
- TOLERANCE 1: This setting is used when solving for the S matrix at each interface. The interface S matrices are calculated from a linear system of equations that attempt to match the tangential E and H field components and the solution of these equations requires a matrix inversion. When there are modes on one side of the boundary that are not well matched by any modes on the other side of the boundary, the solution to the linear system of equations can result in S matrix coefficients that are much larger than 1 and do not conserve energy. This tolerance setting is used to eliminate coupling completely to modes that cannot be expanded on the other side of the boundary. Using values close to zero will result in smaller field discontinuities but can lead to large energy conservation violations that cannot be corrected without perturbing the entire S matrix. Using values close to 1 will make energy conservation work much better but can increase field discontinuities. For periodic structures where precise energy conservation is important, this value should typically be between 0.5 and 1. This setting affects the calculation of all interface S matrices, regardless of the choice of the "energy conservation" setting.
- TOLERANCE 2: This settings is used to determine the maximum correction that will be made to a lossy interface S matrix to make it conserve energy. Ideally, all possible incident source conditions on an interface will result in perfect energy conservation. If the energy conservations settings is set to "conserve energy" then source conditions which result in loss are corrected to perfectly conserve energy. However, source conditions that result in a total transmitted and reflected power that is smaller than "tolerance 2" will be ignored which helps to avoid over correcting the original S matrix. For periodic structures where precise energy conservation is important, this setting should be quite small - typically 1e-5 or smaller - to ensure that no incorrect losses can occur. This setting will only be used when the "energy conservation" setting is set to "conserve energy".
- TOLERANCE 3: This setting is used for certain internal matrix calculations when trying to correct the interface S matrices to conserve energy or to be passive. It should be kept as small as possible, however, in some cases numerical errors can result if it is too small. In general, this setting should not have as much impact on the results as tolerance 1 and tolerance 2. This setting will only be used when the "energy conservation" setting is set to "conserve energy" or "make passive".
- CORRECT BACKWARD PROPAGATING MODES: When this is checked all modes will have imag(neff) ≥ -gain_max , however some modes may have negative real(neff) correspondent to a negative phase velocity. The value of gain_max should be zero when the waveguide is made from materials with no gain, however, we typically use a finite value for two reasons: firstly, there can be small numerical errors such that a mode with imag(neff) = 0 may be calculated to have a numerically small, negative value such as -1e-15, and secondly, the waveguide itself may be composed of some materials that, intentionally, have gain – in other words they have imag(n) < 0 where n is the material refractive index. The value of gain_max is given by gain_max = “maximum tolerated gain” + material_gain_max, where “maximum tolerated gain” is specified below and material_gain_max is the maximum value of |imag(n)| for any material in the waveguide that has gain. If no material in the waveguide has gain, then material_gain_max = 0.
- CORRECT BACKWARD PROPAGATING MODES WHEN PML IS PRESENT: By default, the detection and correction of backward propagating modes, as described above, is not performed when any of the FDE solver boundaries are PML. When PML boundaries are used, you must check this box to apply the correction of backward propagating modes. However, we do not generally recommend checking this box because PML itself can create small amounts of gain in some modes which is typically an indication that the PML is too close to the guiding structure and not that the backward propagating mode has been accidentally selected. In addition, evanescent modes with negative phase velocities are rarely found when PML is used.
- MAXIMUM TOLERATED GAIN: This quantity is used to calculate gain_max, as described above. Since this is typically used for avoiding accidental sign reversal due to small numerical errors, this value is typically very small and the default is 1e-12.
- ADD MATERIAL GAIN TO MAXIMUM TOLERATED GAIN: When this is checked, the material gain (if any gain materials are present) will be included in the calculation of gain_max, as described above. When this is unchecked, gain_max will be equal to “maximum tolerated gain”.

See EME error diagnostics for more information on the tolerance parameters.

=tab6 content end==============================================

=tab7 content start==============================================

- COEFFICIENTS: the modal expansion coefficients for each mode as a function of cells or x.
- GLOBAL ERRORS: the source-independent global errors as a function of cells or x, see EME error diagnostics.
- INTERNAL S-MATRIX: the S matrix of the device from the first cell interface to the last cell interface. Note that this does not depend on the ports or port modes, eg. if n modes are used in the first cell and m modes are used in the last cell, the internal S matrix will have dimensions [n+m, n+m].
- LOCAL ERRORS :the source-dependent local errors as a function of cells or x, see EME error diagnostics.
- USER S-MATRIX: the S matrix of the whole device including only the modes that have been selected in the Ports.

=tab7 content end==============================================

=all tab contents end==============================================