optics{ light_propagation{ } }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
items: \(\mathrm{maximum\;1}\)
specifying options related to the light field propagating through the device.
Important
The following general conditions must be satisfied when defining optics{ light_propagation{ } }
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 not planned to change in the nearest future.
min_wavelength¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{real\;number}\)
values: \([10.0, 10^{6}]\)
unit: \(\mathrm{nm}\)
max_wavelength¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{real\;number}\)
values: \([10.0, 10^{6}]\)
unit: \(\mathrm{nm}\)
min_energy¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{real\;number}\)
values: \([10^{-6}, 100.0]\)
unit: \(\mathrm{eV}\)
Low-energy boundary of the energy grid for propagating photons.
max_energy¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{real\;number}\)
values: \([10^{-6}, 100.0]\)
unit: \(\mathrm{eV}\)
High-energy boundary of the energy grid for propagating photons.
energy_resolution¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{real\;number}\)
values: \([10^{-6}, \ldots)\)
unit: \(\mathrm{eV}\)
default: \(10^{-2}\)
Spacing between subsequent energy grid points.
use_local_absorption{ }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
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{ }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
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.
Important
The following general conditions must be satisfied when defining use_computed_absorption{ }
energy_grid{ } is specified in the input file.
optics{ semiclassical_spectra{ } } is specified in the input file.
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{ }¶
\(\mathrm{\textcolor{WildStrawberry}{required}}\)
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 }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{no}\)
If set to yes, then the reflectivity spectrum is outputted.
output_global_spectra{ absorption_coeff }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{no}\)
If set to yes, then the absorption spectrum is outputted.
output_global_spectra{ decadic_absorption_coeff }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{no}\)
If set to yes, then the absorption spectrum in decadic units is outputted.
output_global_spectra{ refractive_index }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{no}\)
If set to yes, then the refractive index spectrum is outputted.
output_global_spectra{ spectra_over_energy }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{yes}\)
If set to yes then the selected spectra are outputted over photon energy.
output_global_spectra{ spectra_over_frequency }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{no}\)
If set to yes then the selected spectra are outputted over photon frequency.
output_global_spectra{ spectra_over_wavenumber }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{no}\)
If set to yes then the selected spectra are outputted over photon wavenumber.
output_global_spectra{ spectra_over_wavelength }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{no}\)
If set to yes then the selected spectra are outputted over photon wavelength.
output_light{ }¶
\(\mathrm{\textcolor{WildStrawberry}{required}}\)
items: \(\mathrm{exactly\;1}\)
output_light{ illumination }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{yes}\)
If set to yes, then the illumination spectrum is outputted.
output_light{ total_absorption }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{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 }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{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 }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{yes}\)
If set to yes, then the light flux \(I(x,E)\) of the light propagating through the device
output_light{ spectra_over_energy }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{yes}\)
If set to yes then the selected spectra are outputted over photon energy.
output_light{ spectra_over_frequency }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{no}\)
If set to yes then the selected spectra are outputted over photon frequency.
output_light{ spectra_over_wavenumber }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{no}\)
If set to yes then the selected spectra are outputted over photon wavenumber.
output_light{ spectra_over_wavelength }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{no}\)
If set to yes then the selected spectra are outputted over photon wavelength.
output_light{ photon_spectra }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{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 }¶
\(\mathrm{\textcolor{Aquamarine}{optional}}\)
type: \(\mathrm{choice}\)
values: \(\mathrm{yes\;/\;no}\)
default: \(\mathrm{no}\)
If set to yes, then photon power spectrum is outputted with units \(W/cm^2\).