pyradtran.config.SimulationDefaults

class pyradtran.config.SimulationDefaults(rte_solver: str = 'twostr', mol_abs_param: str = 'lowtran per_nm', source: str = 'solar', wavelength_nm: ~typing.List[int | float] = <factory>, integrate_wavelength: bool = False, output_columns: ~typing.List[str] = <factory>, output_altitudes_km: ~typing.List[float] = <factory>, albedo_value: float | None = None, surface_temperature_k: float | None = None, ozone_du: float | None = 300.0, h2o_mm: float | None = 2.0, h2o_source: str = 'fixed', clouds: ~pyradtran.config.CloudParameters = <factory>, viewing_geometry: str = 'nadir', sza: float | None = None, parameter_overrides: ~typing.Dict[str, ~typing.Any] = <factory>)

Bases: object

Core simulation parameters passed to uvspec.

Values set here act as defaults and can be overridden per-run via parameter_overrides or the YAML config cascade.

Parameters:

• rte_solver (str, default "twostr") – Radiative-transfer equation solver ("twostr", "disort", "fdisort1", "rodents", …).

• mol_abs_param (str, default "lowtran per_nm") – Molecular absorption parameterisation.

• source ({“solar”, “thermal”}, default "solar") – Radiation source.

• wavelength_nm (list of float, default [400, 3600]) – Two-element [min, max] wavelength range (nm).

• integrate_wavelength (bool, default False) – If True, output_process integrate is appended.

• output_columns (list of str) – Column names for output_user.

• output_altitudes_km (list of float) – Altitude levels for zout.

• albedo_value (float, optional) – Surface albedo (0–1).

• surface_temperature_k (float, optional) – Surface temperature (K) for thermal simulations.

• ozone_du (float, optional) – Total ozone column (DU).

• h2o_mm (float, optional) – Precipitable water (mm).

• h2o_source ({“fixed”, “radiosonde”}, default "fixed") – Water-vapour source strategy.

• clouds (CloudParameters) – Nested cloud settings.

• viewing_geometry (str, default "nadir") – Viewing geometry shortcut.

• sza (float, optional) – Solar zenith angle (°). Calculated from time/location when None.

• parameter_overrides (dict) – Raw key: value pairs appended verbatim to the uvspec input file, providing an escape hatch for any libRadtran option not covered by the typed fields above.

Raises:

ValueError – On invalid wavelength_nm length, unknown source, or out-of-range albedo_value.

__init__(rte_solver: str = 'twostr', mol_abs_param: str = 'lowtran per_nm', source: str = 'solar', wavelength_nm: ~typing.List[int | float] = <factory>, integrate_wavelength: bool = False, output_columns: ~typing.List[str] = <factory>, output_altitudes_km: ~typing.List[float] = <factory>, albedo_value: float | None = None, surface_temperature_k: float | None = None, ozone_du: float | None = 300.0, h2o_mm: float | None = 2.0, h2o_source: str = 'fixed', clouds: ~pyradtran.config.CloudParameters = <factory>, viewing_geometry: str = 'nadir', sza: float | None = None, parameter_overrides: ~typing.Dict[str, ~typing.Any] = <factory>) → None

__init__([rte_solver, mol_abs_param, ...])
albedo_value
h2o_mm
h2o_source
integrate_wavelength
mol_abs_param
ozone_du
rte_solver
source
surface_temperature_k
sza
viewing_geometry
wavelength_nm
output_columns
output_altitudes_km
clouds
parameter_overrides

albedo_value: float | None = None

clouds: CloudParameters

h2o_mm: float | None = 2.0

h2o_source: str = 'fixed'

integrate_wavelength: bool = False

mol_abs_param: str = 'lowtran per_nm'

output_altitudes_km: List[float]

output_columns: List[str]

ozone_du: float | None = 300.0

parameter_overrides: Dict[str, Any]

rte_solver: str = 'twostr'

source: str = 'solar'

surface_temperature_k: float | None = None

sza: float | None = None

viewing_geometry: str = 'nadir'

wavelength_nm: List[int | float]