optics{ light_propagation{ } }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
items: \(\mathrm{maximum\;1}\)
specifying options related to the light field propagating through the device.
- Dependencies
optics{ global_illumination{ } } is specified in the input file.
Exactly one of the following must be defined: min_wavelength, min_energy within this group.
Exactly one of the following must be defined: max_wavelength, max_energy within this group.
Maximum one of use_local_absorption{ } and use_computed_absorption{ } can be defined within this group.
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¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
type: \(\mathrm{real\;number}\)
values:
[10.0, 1e6]
unit: \(\mathrm{nm}\)
max_wavelength¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
type: \(\mathrm{real\;number}\)
values:
[10.0, 1e6]
unit: \(\mathrm{nm}\)
min_energy¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
type: \(\mathrm{real\;number}\)
values:
[1e-6, 100.0]
unit: \(\mathrm{eV}\)
Low-energy boundary of the energy grid for propagating photons.
max_energy¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
type: \(\mathrm{real\;number}\)
values:
[1e-6, 100.0]
unit: \(\mathrm{eV}\)
High-energy boundary of the energy grid for propagating photons.
energy_resolution¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
type: \(\mathrm{real\;number}\)
values:
[1e-6, ...)
unit: \(\mathrm{eV}\)
default:
1e-2
Spacing between subsequent energy grid points.
use_local_absorption{ }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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{ }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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.
- Dependencies
energy_grid{ } must be defined.
optics{ semiclassical_spectra{ } } must be defined.
output_local_spectra{ } must be defined.
energy_resolution is not specified in the input file.
optics{ global_absorption_coeff{ } } is not specified in the input file.
optics{ global_refractive_index{ } } is not specified in the input file.
output_global_spectra{ }¶
using: \(\mathrm{\textcolor{WildStrawberry}{required\;within\;the\;scope}}\)
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 }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
type: \(\mathrm{choice}\)
choices:
yes
;no
default:
no
If set to yes
, then the reflectivity spectrum is outputted.
output_global_spectra{ absorption_coeff }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
type: \(\mathrm{choice}\)
choices:
yes
;no
default:
no
If set to yes
, then the absorption spectrum is outputted.
output_global_spectra{ decadic_absorption_coeff }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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 }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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 }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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 }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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 }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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 }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
type: \(\mathrm{choice}\)
choices:
yes
;no
default:
no
If set to yes
then the selected spectra are outputted over photon wavelength.
output_light{ }¶
using: \(\mathrm{\textcolor{WildStrawberry}{required\;within\;the\;scope}}\)
items: \(\mathrm{exactly\;1}\)
output_light{ illumination }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
type: \(\mathrm{choice}\)
choices:
yes
;no
default:
yes
If set to yes
, then the illumination spectrum is outputted.
output_light{ total_absorption }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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 }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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 }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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 }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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 }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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 }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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 }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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 }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
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 }¶
using: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;scope}}\)
type: \(\mathrm{choice}\)
choices:
yes
;no
default:
no
If set to yes
, then photon power spectrum is outputted with units \(W/cm^2\).