eradiate.experiments.AtmosphereExperiment#

class eradiate.experiments.AtmosphereExperiment(measures=_Nothing.NOTHING, illumination=_Nothing.NOTHING, geometry='plane_parallel', atmosphere=_Nothing.NOTHING, surface=_Nothing.NOTHING, dem=None, integrator=_Nothing.NOTHING)[source]#

Bases: eradiate.experiments._core.EarthObservationExperiment

Simulate radiation in a one-dimensional scene. This experiment approximates a one-dimensional setup using a 3D geometry set up to reproduce the effect of invariances typical of 1D geometries. It supports the so-called plane parallel and spherical shell geometries.

Parameters

measures (list of Measure or list of dict or Measure or dict, default: MultiDistantMeasure()) – List of measure specifications. The passed list may contain dictionaries, which will be interpreted by measure_factory. Optionally, a single Measure or dictionary specification may be passed and will automatically be wrapped into a list.
illumination (DirectionalIllumination or ConstantIllumination or dict, default: DirectionalIllumination()) – Illumination specification. This parameter can be specified as a dictionary which will be interpreted by illumination_factory.
geometry (str or dict or AtmosphereGeometry, default: "plane_parallel") – Problem geometry.
atmosphere (Atmosphere or dict or None, default: HomogeneousAtmosphere()) – Atmosphere specification. If set to None, no atmosphere will be added. This parameter can be specified as a dictionary which will be interpreted by atmosphere_factory.
surface (BasicSurface or BSDF or dict, optional, default: BasicSurface(bsdf=LambertianBSDF())) – Surface specification. If set to None, no surface will be added. This parameter can be specified as a dictionary which will be interpreted by surface_factory and bsdf_factory.
dem (DEMSurface or dict, optional, default: None) – Digital elevation model (DEM) specification. If set to None, no DEM will be added. This parameter can be specified as a dictionary which will be interpreted by surface_factory
integrator (Integrator or dict, default: VolPathIntegrator()) – Monte Carlo integration algorithm specification. This parameter can be specified as a dictionary which will be interpreted by integrator_factory.

Fields

measures (list of Measure) – List of measure specifications.
illumination (DirectionalIllumination or ConstantIllumination) – Illumination specification.
geometry (PlaneParallelGeometry or SphericalShellGeometry) – Problem geometry.
atmosphere (Atmosphere or None) – Atmosphere specification.
surface (BasicSurface or None) – Surface specification.
dem (DEMSurface or None) – Digital elevation model (DEM) specification.

Notes

A post-initialisation step will constrain the measure setup if a distant measure is used and no target is defined:
- if an atmosphere is defined, the target will be set to [0, 0, TOA];
- if no atmosphere is defined, the target will be set to [0, 0, 0].
This experiment supports arbitrary measure positioning, except for MultiRadiancemeterMeasure, for which subsensor origins are required to be either all inside or all outside of the atmosphere. If an unsuitable configuration is detected, a ValueError will be raised during initialisation.

classmethod from_dict(d)#

Instantiate from a dictionary. The default implementation raises an exception.

Parameters: d (dict) – Dictionary to be converted to an Experiment.
Returns: Experiment

kernel_dict(ctx)[source]#

Return a dictionary suitable for kernel scene configuration.

Parameters: ctx (KernelDictContext) – A context data structure containing parameters relevant for kernel dictionary generation.
Returns: KernelDict – Kernel dictionary which can be loaded as a Mitsuba object.

kernel_dicts(measure)#

A generator which returns kernel dictionaries (and the associated context) relevant to a given measure.

Parameters

measure (Measure or int) – Measure for which kernel dictionaries are to be generated. Alternatively, the index in the self.measure list can be passed.

Yields

kernel_dict (KernelDict) – Generated kernel dictionary.
ctx (KernelDictContext) – Context used to generate kernel_dict.

pipeline(*measures)#

Request post-processing pipeline for a given measure.

Parameters: *measures (Measure or int) – One or several measures for which to get a post-processing pipeline. If integer values are passed, they are used to query the measure list.
Returns: pipelines (Pipeline or tuple of Pipeline) – If a single measure is passed, a single Pipeline instance is returned; if multiple measures are passed, a tuple of pipelines is returned.

postprocess(*measures, pipeline_kwargs=None)#

Post-process raw results stored in a measure’s results field. This requires a successful execution of process(). Post-processed results are stored in self.results.

Parameters

*measures (Measure or int) – One or several measures for which to perform post-processing. Alternatively, indexes in the measure array can be passed. If no value is passed, all measures are processed.
pipeline_kwargs (dict, optional) – A dictionary of pipeline keyword arguments forwarded to Pipeline.transform().

Raises

ValueError – If measure.results is None, i.e. if process() has not been successfully run.