spectral_radMonteCarlo

Workspace.spectral_radMonteCarlo(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, obs_pos: pyarts3.arts.Vector3 | None = None, obs_los: pyarts3.arts.Vector2 | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, scat_species: pyarts3.arts.ArrayOfScatteringSpecies | None = None, ray_path_observer_agenda: pyarts3.arts.Agenda | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_space_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_surface_agenda: pyarts3.arts.Agenda | None = None, mc_seed: pyarts3.arts.Index | None = None, mc_min_iter: pyarts3.arts.Index | None = None, mc_max_iter: pyarts3.arts.Index | None = None, mc_max_scatorder: pyarts3.arts.Index | None = None, mc_std_err: pyarts3.arts.Numeric | None = None, mc_max_time: pyarts3.arts.Numeric | None = None) → None

Computes pencil-beam spectral radiance with passive Monte Carlo.

This is the observer-level interface used by spectral_rad_observer_agenda and therefore by measurement_vecFromSensor(). Frequency, polarization, and antenna weighting are owned by measurement_sensor, so this method deliberately uses a pencil beam internally. One Monte Carlo calculation is performed for every frequency in freq_grid.

Atmospheric, surface, and subsurface Jacobians use common-random-number forward perturbations in model-state space. Sensor frequency and geometry Jacobians are added by the predefined observer agenda. Spectroscopic targets are perturbed inside the propagation-matrix call using the returned propagation and NLTE source derivatives, without modifying global catalogue state.

Author: OpenAI Codex

Parameters:

  • spectral_rad (StokvecVector, optional) – A spectral radiance vector. See spectral_rad, defaults to self.spectral_rad [OUT]

  • spectral_rad_jac (StokvecMatrix, optional) – Jacobian of spectral_rad with respect to jac_targets. See spectral_rad_jac, defaults to self.spectral_rad_jac [OUT]

  • ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See ray_path, defaults to self.ray_path [OUT]

  • freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See freq_grid, defaults to self.freq_grid [IN]

  • jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See jac_targets, defaults to self.jac_targets [IN]

  • obs_pos (Vector3, optional) – The position of an observer of spectral radiance. See obs_pos, defaults to self.obs_pos [IN]

  • obs_los (Vector2, optional) – The line-of-sight of the observer of spectral radiance. See obs_los, defaults to self.obs_los [IN]

  • atm_field (AtmField, optional) – An atmospheric field in ARTS, this is the main atmospheric data structure in ARTS. See atm_field, defaults to self.atm_field [IN]

  • surf_field (SurfaceField, optional) – The surface field. See surf_field, defaults to self.surf_field [IN]

  • subsurf_field (SubsurfaceField, optional) – The sub-surface field. See subsurf_field, defaults to self.subsurf_field [IN]

  • scat_species (ArrayOfScatteringSpecies, optional) – The scattering species. See scat_species, defaults to self.scat_species [IN]

  • ray_path_observer_agenda (Agenda, optional) – Gets the propagation path as it is observed. See ray_path_observer_agenda, defaults to self.ray_path_observer_agenda [IN]

  • spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See spectral_propmat_agenda, defaults to self.spectral_propmat_agenda [IN]

  • spectral_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space. See spectral_rad_space_agenda, defaults to self.spectral_rad_space_agenda [IN]

  • spectral_rad_surface_agenda (Agenda, optional) – Computes spectral radiance as seen of the surface. See spectral_rad_surface_agenda, defaults to self.spectral_rad_surface_agenda [IN]

  • mc_seed (Index, optional) – Base random seed; the frequency index is added to it. Defaults to 0 [IN]

  • mc_min_iter (Index, optional) – Minimum histories per frequency. Defaults to 100 [IN]

  • mc_max_iter (Index, optional) – Maximum histories per frequency. Defaults to 10000 [IN]

  • mc_max_scatorder (Index, optional) – Maximum scattering order. Defaults to 20 [IN]

  • mc_std_err (Numeric, optional) – Absolute standard-error threshold; zero disables it. Defaults to 0 [IN]

  • mc_max_time (Numeric, optional) – Wall-clock limit per frequency [s]; zero disables it. Defaults to 0 [IN]