Simulation Setup
Video Tutorial
In this video tutorial, you will learn how to configure a Leda simulation file from scratch by adding structures, emitters, and detectors.
If the video cannot be played, try this: Alternate video link.
Main Interface
The main interface consists of the following modules:
- Progress Bar: Displays computation progress
- Toolbar: File operations such as open, save, run, and settings
- File Manager: Multiple open files are arranged in tabs
- Menu: Switch between configuration, information, and results
- Content Window: Set specific parameters and view simulation results
- Status Bar: Realtime error status and file location
Toolbar
The toolbar contains all the necessary functions for simulation (additional features such as opening a new window can be found in the top menu bar).
From left to right, the toolbar includes:
- Progress Bar: The number of green dots on the left indicates the number of detectors that have completed simulation, while the overall progress is shown on the right. If an error occurs, the progress bar turns orange.
- File Operations: New File, Open File, Save, Save As.
- Simulation Operations: Run Single, Run Sweep, Terminate Run.
- Manual (not yet supported), Light/Dark Mode Toggle, Settings.
Light/Dark Mode Toggle
The Light/Dark mode can follow the system setting or be manually toggled using the Light/Dark Toggle Button on the right side of the toolbar.
- For Windows, see Change colors in Windows for how to set system theme colors.
- For macOS, see Use a light or dark appearance on your Mac for how to set system theme colors.
Menu Bar
The top menu bar indicates shortcut keys for each function. Although the menu bar is used less frequently, it still contains some important features such as:
- Opening a new window, which can be used to compare results from two simulations.
- Scaling the interface to optimize display on screens of different sizes.
- macOS supports tabbed windows, while Windows can use software like Groupy for tab management of multiple windows.
File Management Bar
Multiple open files are arranged as tabs in the File Management Bar (Tab bar).
- New File: Click New in the toolbar, or click the Plus button in the File Management Bar.
- Create a new file on the right: For example, if files A and B are open and you want to insert C between A and B, right-click on A’s tab and click New to form the ACB tab order.
- Duplicate File: Right-click the tab of the file to be duplicated and click Duplicate.
- Close File: Click the
⨉button to the right of the file name. - Rename File: Right-click the tab and click Rename.
- Move Tab: Right-click the tab and click Move to Left or Move to Right.
After modifying a file, a small dot appears to the left of the file name, which disappears after saving. Different colors of the dot represent different unsaved states of the file:
- Gray: No simulation results, not yet saved.
- Green: Successful simulation results, not yet saved.
- Orange: Failed simulation results, not yet saved.
Sidebar
The left side of the interface is the sidebar. Clicking on a navigation item switches the content window to the corresponding section.
The sidebar is divided into three modules from top to bottom:
- Modeling: Structure, Emitter, Detector, Sweep.
- Information: Dataset, Logs.
- Results: Spectrum, Angular Distribution, Power Dissipation, Mode, Emission.
If the content window is not fully displayed due to limited screen size, you can collapse the sidebar by clicking the button in the lower-left corner.
Settings
Click the Settings button at the far right of the toolbar to open the settings window.
The following settings can be configured:
- Language: Supports English and Simplified Chinese. Not all terms have translations, so it is recommended to use English.
- Threads: Leda supports multi-threaded computation during sweeps. As modern computers generally have hyper-threading technology, setting it to half the available threads usually achieves optimal speed. Setting too many threads may actually reduce speed. If the computer lags during computation, further reduce the number of threads. The software needs to be restarted for thread settings to take effect.
- Log Size: Logs record the status and error information of each run. A new log entry is added for each run, and when the number of logs exceeds the set value, the earliest logs are automatically deleted.
- Tooltip: When enabled, hovering the mouse over a button or question mark icon displays a tooltip. If you are familiar with Leda operations, you can disable tooltips to reduce visual clutter.
- Save After Run: When enabled, files are automatically saved after each run.
Click Ok to apply the settings, or Cancel to discard changes.
Structure
Click Structure in the menu bar to enter the structure configuration, where the content window displays as follows.
Building the Structure
At the top are structure operation tools, we can add, insert, move up, move down, and delete layers.
Insert, Move Up, Move Down, and Delete are unavailable until a layer is selected. To select a layer, click on its name, after which a blue selection indicator appears on the left of the selected layer.
- Adding a Layer: Click
Addto add a layer at the bottom, orInsertto add a layer below the selected layer. - Sorting Layers: Besides using
Move UpandMove Downon a selected layer, you can also drag the⋮⋮symbol on the left to sort. ClickReverseto invert the order of the structure. - Deleting a Layer: Select a layer and click
Deleteto remove it, or click the⨉on the far right of the layer.
Layer Order
Whether your structure is top-emitting or bottom-emitting, the structure should be modeled with the light-emitting side facing upward. For example, in the bottom-emitting QLED structure, light is emitted from the substrate. Therefore, the first layer from top to bottom is air (the detector’s environment), followed by the substrate, and then other functional layers.
For a bottom-emitting structure like Substrate/ITO/PEDOT/QD/TPBi/Al, the substrate should be modeled facing up.
Correct order:
Incorrect order:
If the light-emitting surface is accidentally modeled facing down, click the Reverse button in the operation tools to invert the structure order.
In top-emitting structures, the substrate is often not the light-emitting surface, so it is modeled facing down.
The first and last layers in the model are semi-infinite in thickness, so their thickness cannot be set. Even if a thickness is set, it is treated as infinite; regardless of whether the transparent (Tran.) and incoherent (Inco.) properties are activated, they are treated as transparent and incoherent. These layers are generally set as air.
Layer Properties
- Name: Layers’ name must be unique.
- Thickness: Default unit is nm.
- Refractive Index options include:
- Constant: Set the real part n and imaginary part k of the refractive index.
- Constant Birefringence: Set the birefringence no ko and ne ke.
- File: Import refractive index files (supports birefringence). After import, click the magnifying glass icon
⚲to view the refractive index chart.
- Transparent (Tran.): If a layer is set to transparent, its imaginary refractive index is set to 0 during computation.
- Incoherent (Inco.): Incoherent means that light does not interfere when propagating within this layer. Generally, thicker materials can be considered incoherent, such as a 1 mm thick glass substrate. Incoherent layers require that their surroundings are also incoherent, meaning a incoherent layer cannot be inserted between two coherent layers.
- Emissive (Emis.): The emissive property needs to be activated for an emitting layer. When Emis. is activated, the layer is treated as transparent regardless of whether its Tran. property is activated.
Refractive Index Data Structure
If you want to import custom refractive indices, the data must adhere to the following format specifications:
- Columns are separated by spaces or tabs. Data copied from software like Excel or Origin is often already tab-separated.
- Comment lines start with
#and are not read as data. - Refractive index data files should have
.txtor.nkas file name suffixes.
Standard refractive index data format: Wavelength (nm); real part of refractive index n; imaginary part k
# wavelength n k300 0.2169982 2.982331310 0.2314807 3.092004320 0.2441945 3.198823330 0.2575465 3.305539340 0.2716037 3.412406350 0.2900822 3.54058Birefringence data format: Wavelength (nm); ordinary light (o-light) real part no; o-light imaginary part ko; extraordinary light (e-light) real part ne; e-light imaginary part ke. Birefringence data requires the optical axis to be perpendicular to the interface.
# wavelength no ko ne ke400.92 1.9556 2.37E-06 1.6434 0.00029767402.51 1.9529 1.96E-06 1.6423 0.00026604404.09 1.9502 1.63E-06 1.6413 0.00023776405.68 1.9477 1.36E-06 1.6403 0.00021248407.26 1.9452 1.14E-06 1.6393 0.00018988408.85 1.9427 9.59E-07 1.6383 0.00016968Emitter
Click Emitter in the menu bar to enter the emitter configuration, where the content window displays as follows.
Layers with the Emis. property activated in the Structure will appear in the Emitter window. Previously, we activated the Emis. property for the QD layer, designating it as an emitting layer, thus its name appears in the upper left corner.
By default, an emitting layer has one Emitter. If more Emitters are needed, click Add on the far right of the emitting layer. The interface shows two Emitters.
Spectrum
Spectrum types can be selected as:
Unit White, which has the same intensity or photon count across all bands (not true white light).File, import a spectrum file.
Spectrum files have .txt or .pl as file name suffixes, format: Wavelength (nm); Intensity or Photon Count.
560 0.007972869570 0.012127781580 0.014351212590 0.026358927600 0.063194636610 0.211850971620 0.62964852630 0.959306239640 0.488650053650 0.10278984660 0.025351333670 0.012790838Spectrum units: Whether Unit White or imported spectrum, the vertical axis unit can be intensity or photon count. The simulated spectrum’s unit matches the input spectrum’s unit. If the imported spectrum’s vertical axis unit is intensity, then the simulated output spectrum’s vertical axis unit is also considered intensity.
Dipole Orientation
Dipole orientations include:
- Isotropic, where dipoles oscillate in the x-y-z directions with equal weighting, meaning the same power is emitted in all directions. This is the choice for most emitting materials.
- Parallel, where the oscillation direction is parallel to the interface, forming a horizontal dipole.
- Perpendicular, where the oscillation direction is perpendicular to the interface, forming a vertical dipole.
Refer to: Dipole Approximation
Dipole Position
Range:
The position of the dipole within the emitting layer. A value close to 0 means the dipole is near the upper interface; a value close to 1 means it is near the lower interface.
Conversion Efficiency
Range:
Conversion efficiency unrelated to the radiation process, unaffected by the Purcell effect, such as the efficiency of electrical injection and the conversion of charges to excitons.
Refer to: Electrical and Non-Radiative Losses
Multiplication Factor
Range:
This factor amplifies the spectrum intensity by the corresponding multiple, typically used to adjust the relative intensity between multiple emitters.
Quantum Efficiency
Range:
Intrinsic quantum efficiency
Refer to: External Quantum Efficiency (EQE); Purcell Effect
Lifetime
Range:
Intrinsic lifetime of the dipole
Refer to: Purcell Effect
Detector
Leda includes three detectors:
- Spectrum: Provides Spectrum and Angular Distribution results.
- Power Dissipation: Provides Power Dissipation results.
- Mode: Provides Mode and Emission results.
Click Detector in the sidebar to enter the detector configuration. Click the switch on the right of the detector to activate it. Multiple detectors can be activated simultaneously.
Spectrum
Expand the Spectrum detector to display as follows.
Wavelength: Enter start value, end value, and step (nm).Angle Type:Single: Outputs spectrum at a single angle in Results.Integration: Outputs spectrum integrated over angles in Results.Sweep: Angle sweep, occupying one sweep channel (a blue circle ❶ appears next to Spectrum). Outputs spectra at multiple angles and angular distributions at different wavelengths in Results.
Angle:- When
Angle TypeisSingle, enter a single angle (deg). - When
Angle TypeisIntegrationorSweep, enter the starting value, end value, step (deg).
- When
Power Dissipation
Expand the Power Dissipation detector to display as follows.
Inplane Vector Type: Choose based on Power Dissipation.k inplaneu inplanen eff
Inplane Vector: Enter start value, end value, and step.Wavelength Type:Single: Single wavelength, occupying one sweep channel (a blue circle ❶ appears next to Power Dissipation).Sweep: Wavelength sweep, occupying two sweep channels (a blue circle ❷ appears next to Power Dissipation).
Wavelength:- When
Wavelength TypeisSingle, enter a single angle (nm). - When
Wavelength TypeisSweep, enter start value, end value, and step (nm).
- When
How to set inplane vector range
Start Value is generally set to 0.
End Value is determined based on the type of inplane vector, wavelength, and refractive index of the emitting layer.
When light propagates parallel to the interface in the emitting layer,
- Set the end value for
k inplaneto. - Set the end value for
u inplaneto. - Set the end value for
n effto.
Step can be adjusted based on the end value, for example, calculating 200 points, step=(end value-start value)/200.
Dispersion relation and spectrum type
When Wavelength Type is Sweep, the Emitter’s spectrum is considered. If only exploring the dispersion relation of the structure, set the Emitter’s Spectrum Type to Unit White.
Mode
Expand the Mode detector to display as follows.
Wavelength Type:Single: Single wavelength.Integration: Wavelength integration, simulation results are related to the Emitter’s spectrum.Sweep: Wavelength sweep, occupying one sweep channel (a blue circle ❶ appears next to Mode). Simulation results are unrelated to the Emitter’s spectrum.
Wavelength:- When
Wavelength TypeisSingle, enter a single wavelength (nm). - When
Wavelength TypeisIntegrationorSweep, enter start value, end value, and step (nm).
- When
Error Tolerance: Setting it to 5 is a low value, ensuring high simulation accuracy. If the simulation reportsThe result fails to converge in a finite in-plane wave vector, increase this value to allow results with larger errors. If set to 20 and the simulation still cannot solve, check if the settings meet the model’s conditions.
Mode detector error: the result fails to converge
Mode detector error: The result fails to converge in a finite in-plane wave vector.
Complete error:
The result fails to converge in a finite in-plane wave vector. Possible reasons: Dipole is placed too close to absorptive material or metal, or the refractive index of the emitting layer is too small. If there are no above problems, try to set larger Error Tolerance.Cause analysis: This is due to the Evanescent (SPP) Mode region being too strong for the software to guarantee convergence, so it stops running early to prevent outputting results with a large error.
Try the following solution:
- Increase the distance between the dipole and the metal layer (increase the thickness of the transport layer), and if the thickness of the transport layer is sweeped, check that the
Fromvalue is not too small. - Change the metal material (Al/Ag/Au, etc. metal).
- Increase the Error Tolerance of the Mode detector (i.e., tell Leda to allow results to be output with a larger error)
- Adjust the wavelength range of the detector (a limited attempt could be made, as realistically the wavelength range may be required to be fixed)