optics{ light_propagation{ } }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • items: \(\mathrm{maximum\;1}\)

specifying options related to the light field propagating through the device.

Dependencies

Maintained Keywords

The keywords below are available in at least one of currently published releases and are planned to be included also in the next release.

min_wavelength

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{real\;number}\)

  • values: [10.0, 1e6]

  • unit: \(\mathrm{nm}\)

max_wavelength

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{real\;number}\)

  • values: [10.0, 1e6]

  • unit: \(\mathrm{nm}\)

min_energy

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{real\;number}\)

  • values: [1e-6, 100.0]

  • unit: \(\mathrm{eV}\)

Low-energy boundary of the energy grid for propagating photons.

max_energy

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{real\;number}\)

  • values: [1e-6, 100.0]

  • unit: \(\mathrm{eV}\)

High-energy boundary of the energy grid for propagating photons.

energy_resolution

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{real\;number}\)

  • values: [1e-6, ...)

  • unit: \(\mathrm{eV}\)

  • default: 1e-2

Spacing between subsequent energy grid points.

use_local_absorption{ }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • items: \(\mathrm{maximum\;1}\)

If this group is present, the global absorption spectrum is used within local absorption framework in non-contact regions. Zero absorption coefficient, perfect optical transparency, is assigned in contact regions which impose boundary conditions on the Poisson equation (see contacts{ }).

Note

In the future, this feature is planned to use imported position-dependent optical absorption spectra.

use_computed_absorption{ }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • items: \(\mathrm{maximum\;1}\)

If this group is present, then the spatially-resolved absorption coefficient from semiclassical_spectra{ } is used for calculating the optical field.

Note

Broadening is not included.

Dependencies

output_global_spectra{ }

  • usage: \(\mathrm{\textcolor{WildStrawberry}{required\;within\;the\;group}}\)

  • items: \(\mathrm{exactly\;1}\)

This group is used to output optical spectra which entered the calculation of the light propagation through the device.

output_global_spectra{ reflectivity }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: no

If set to yes, then the reflectivity spectrum is outputted.

output_global_spectra{ absorption_coeff }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: no

If set to yes, then the absorption spectrum is outputted.

output_global_spectra{ decadic_absorption_coeff }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: no

If set to yes, then the absorption spectrum in decadic units is outputted.

output_global_spectra{ refractive_index }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: no

If set to yes, then the refractive index spectrum is outputted.

output_global_spectra{ spectra_over_energy }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: yes

If set to yes then the selected spectra are outputted over photon energy.

output_global_spectra{ spectra_over_frequency }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: no

If set to yes then the selected spectra are outputted over photon frequency.

output_global_spectra{ spectra_over_wavenumber }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: no

If set to yes then the selected spectra are outputted over photon wavenumber.

output_global_spectra{ spectra_over_wavelength }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: no

If set to yes then the selected spectra are outputted over photon wavelength.

output_light{ }

  • usage: \(\mathrm{\textcolor{WildStrawberry}{required\;within\;the\;group}}\)

  • items: \(\mathrm{exactly\;1}\)

output_light{ illumination }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: yes

If set to yes, then the illumination spectrum is outputted.

output_light{ total_absorption }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: yes

If set to yes, then the total_absorption is outputted, i.e. the fraction of absorbed photons in the device relative to the number of incident photons for each wavelength.

output_light{ total_transmission }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: yes

If set to yes, then the total_transmission is outputted, i.e. the fraction of absorbed photons in the device relative to the number of incident photons for each wavelength, i.e. the fraction of transmitted photons through the device relative to the number of incident photons for each wavelength.

output_light{ lightflux }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: yes

If set to yes, then the light flux \(I(x,E)\) of the light propagating through the device

output_light{ spectra_over_energy }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: yes

If set to yes then the selected spectra are outputted over photon energy.

output_light{ spectra_over_frequency }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: no

If set to yes then the selected spectra are outputted over photon frequency.

output_light{ spectra_over_wavenumber }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: no

If set to yes then the selected spectra are outputted over photon wavenumber.

output_light{ spectra_over_wavelength }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: no

If set to yes then the selected spectra are outputted over photon wavelength.

output_light{ photon_spectra }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: yes

If set to yes, then spectrum of photon number is outputted with one of the following units \(1/cm^2/s/eV\), \(1/cm^2/s/nm\), \(1/cm^2/s/THz\), or \(1/cm^2/s/cm^{-1}\).

output_light{ power_spectra }

  • usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)

  • type: \(\mathrm{choice}\)

  • choices: yes; no

  • default: no

If set to yes, then photon power spectrum is outputted with units \(W/cm^2\).