eradiate.scenes.atmosphere.AbstractHeterogeneousAtmosphere#
- class eradiate.scenes.atmosphere.AbstractHeterogeneousAtmosphere(id='atmosphere', geometry='plane_parallel', *, scale=None, force_majorant=False)[source]#
Bases:
Atmosphere
,ABC
Abstract base class for heterogeneous atmospheres.
- Parameters:
id (
str
, optional, default:"atmosphere"
) – Identifier of the current scene element.geometry (
SceneGeometry
ordict
orstr
, optional, default:"plane_parallel"
) – Parameters defining the basic geometry of the scene. Note if the atmosphere is used in a simulation, the experiment has all control over the atmosphere’s geometry and is going to set it. Therefore, in such a case it is best to define the geometry at the experiment level. When the atmosphere is used standalone, care must be taken to ensure that the geometry is consistent with the vertical extent of the atmosphere.scale (
float
, optional) – If set, the extinction coefficient is scaled by the corresponding amount during computation.force_majorant (
bool
, optional) – If set to true, uses heterogeneous medium, which is compatible with all integrators except PiecewiseVolpathIntegrator. Otherwise, uses a piecewise medium which is compatible with PiecewiseVolPathIntegrator and other integrators. This setting only affects PlaneParallelGeometry, other geometries use heterogeneous mediums.
- Fields:
geometry (
SceneGeometry
) – Parameters defining the basic geometry of the scene.scale (
float
orNone
) – If set, the extinction coefficient is scaled by the corresponding amount during computation.force_majorant (
bool
) – If set to true, uses heterogeneous medium, which is compatible with all integrators except PiecewiseVolpathIntegrator.
- abstract eval_albedo(si, zgrid=None)[source]#
Evaluate albedo spectrum based on a spectral context. This method dispatches evaluation to specialized methods depending on the active mode.
- Parameters:
si (
SpectralIndex
) – Spectral index.zgrid (
ZGrid
, optional) – Altitude grid on which evaluation is performed. If unset, an instance-specific default is used (seezgrid
).
- Returns:
quantity
– Evaluated spectrum as an array with length equal to the number of layers.
- abstract eval_mfp(ctx)#
Compute a typical scattering mean free path. This rough estimate can be used e.g. to compute a distance guaranteeing that the medium can be considered optically thick.
- Parameters:
ctx (
KernelContext
) – A context data structure containing parameters relevant for kernel dictionary generation.- Returns:
mfp (
quantity
) – Mean free path estimate.
- eval_radprops(si, zgrid=None, optional_fields=False)[source]#
Evaluate the extinction coefficients and albedo profiles.
- Parameters:
si (
SpectralIndex
) – Spectral index.zgrid (
ZGrid
, optional) – Altitude grid on which evaluation is performed. If unset, an instance-specific default is used (seezgrid
).optional_fields (
bool
, optional, default:False
) – IfTrue
, also output the absorption and scattering coefficients, not required for scene setup but useful for analysis and debugging.
- Returns:
Dataset
– A dataset with the following variables:sigma_t
: extinction coefficient;albedo
: albedo;sigma_a
: absorption coefficient (optional);sigma_s
: scattering coefficient (optional).
and coordinates:
z
: altitude.
- abstract eval_sigma_a(si, zgrid=None)[source]#
Evaluate absorption coefficient given a spectral context.
- Parameters:
si (
SpectralIndex
) – Spectral index.zgrid (
ZGrid
, optional) – Altitude grid on which evaluation is performed. If unset, an instance-specific default is used (seezgrid
).
- Returns:
quantity
– Particle layer extinction coefficient.
- abstract eval_sigma_s(si, zgrid=None)[source]#
Evaluate scattering coefficient given a spectral context.
- Parameters:
si (
SpectralIndex
) – Spectral index.zgrid (
ZGrid
, optional) – Altitude grid on which evaluation is performed. If unset, an instance-specific default is used (seezgrid
).
- Returns:
quantity
– Particle layer scattering coefficient.
- abstract eval_sigma_t(si, zgrid=None)[source]#
Evaluate extinction coefficient given a spectral context.
- Parameters:
si (
SpectralIndex
) – Spectral index.zgrid (
ZGrid
, optional) – Altitude grid on which evaluation is performed. If unset, an instance-specific default is used (seezgrid
).
- Returns:
quantity
– Particle layer extinction coefficient.
- eval_transmittance(si, interaction='extinction')[source]#
Evaluate the atmosphere’s transmittance with respect to specific interaction.
- Parameters:
si (
SpectralIndex
) – Spectral index.interaction (
{"extinction", "absorption", "scattering"}
, optional, default:"extinction"
) – Interaction type.
- Returns:
quantity
– Total atmosphere transmittance.
- traverse(callback)#
Traverse this scene element and collect kernel dictionary template and parameter update map contributions.
- Parameters:
callback (
SceneTraversal
) – Callback data structure storing the collected data.
- property absorption_data#
- Returns:
AbsorptionDatabase
orNone
– If relevant, the molecular absorption database associated with this atmosphere.
- property medium_id#
- Returns:
str
– ID of the medium associated with the atmosphere in the Mitsuba scene tree.
- property objects#
Map of child objects associated with this scene element.
- Returns:
dict
– A dictionary mapping object names to a corresponding object to be inserted in the Eradiate scene graph.
- property params#
- Returns:
dict[str
,UpdateParameter
] orNone
– A dictionary mapping parameter paths, consisting of dot-separated strings, to a corresponding update protocol.
See also
- abstract property phase#
- Returns:
PhaseFunction
– Phase function associated with the atmosphere.
- property phase_id#
- Returns:
str
– ID of the phase function associated with the atmosphere in the Mitsuba scene tree.
- property shape#
- Returns:
Shape
– Shape associated with this atmosphere, based on the scene geometry.
- property shape_id#
- Returns:
str
– ID of the shape associated with the atmosphere in the Mitsuba scene tree.
- property template#
Kernel dictionary template contents associated with this scene element.
- Returns:
dict
– A flat dictionary mapping dot-separated strings describing the path of an item in the nested scene dictionary to values. Values may be objects which can be directly used by themitsuba.load_dict()
function, orInitParameter
instances which must be rendered.
See also