class eradiate.experiments.EarthObservationExperiment(measures=_Nothing.NOTHING, integrator=_Nothing.NOTHING, results=_Nothing.NOTHING, default_spectral_set=AUTO, extra_objects=_Nothing.NOTHING, illumination=_Nothing.NOTHING)[source]#

Bases: Experiment, ABC

Abstract based class for experiments illuminated by a distant directional emitter.

  • 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.

  • integrator (Integrator or dict, default: PathIntegrator()) – Monte Carlo integration algorithm specification. This parameter can be specified as a dictionary which will be interpreted by integrator_factory.

  • default_spectral_set (BinSet or WavelengthSet or AUTO, default: AUTO) – Default spectral set. This attribute is used to set the default value for spectral_set.If the value is AUTO, the default spectral set is selected based on the active mode. Otherwise, the value must be a BinSet or WavelengthSet instance.

  • extra_objects (dict, default: {}) – Dictionary of extra objects to be added to the scene. The keys of this dictionary are used to identify the objects in the kernel dictionary.

  • illumination (DirectionalIllumination or dict, default: DirectionalIllumination()) – Illumination specification. This parameter can be specified as a dictionary which will be interpreted by illumination_factory.

  • measures (list of Measure) – List of measure specifications.

  • default_spectral_set (BinSet or WavelengthSet) – Default spectral set.

  • extra_objects (dict) – Dictionary of extra objects to be added to the scene.

  • illumination (DirectionalIllumination) – Illumination specification.


Clear previous experiment results and reset internal state.


Generate kernel dictionary and initialise Mitsuba scene.


Return the post-processing pipeline for a given measure.


measure (Measure) – Measure for which the pipeline is to be generated.




Post-process raw results and store them in results.

process(spp=0, seed_state=None)[source]#

Run simulation and collect raw results.

  • spp (int, optional) – Sample count. If set to 0, the value set in the original scene definition takes precedence.

  • seed_state (SeedState, optional) – Seed state used to generate seeds to initialize Mitsuba’s RNG at every iteration of the parametric loop. If unset, Eradiate’s root seed state is used.


Generate spectral indices for a given measure.


measure_index (int) – Measure index for which spectral indices are generated.


SpectralIndex – Spectral index.

property context_init#

Return a single context used for scene initialization.

property contexts#

Return a list of contexts used for processing.

property integrator#

Integrator used to solve the radiative transfer equation.



property results#

Post-processed simulation results.


dict[str, Dataset] – Dictionary mapping measure IDs to xarray datasets.

property scene#

Return a scene object used for kernel dictionary template and parameter table generation.