spectral_radMonteCarlo

Workspace.spectral_radMonteCarlo(self, spectral_rad: StokvecVector = self.spectral_rad, spectral_rad_jac: StokvecMatrix = self.spectral_rad_jac, ray_path: ArrayOfPropagationPathPoint = self.ray_path, freq_grid: AscendingGrid = self.freq_grid, jac_targets: JacobianTargets = self.jac_targets, obs_pos: Vector3 = self.obs_pos, obs_los: Vector2 = self.obs_los, atm_field: AtmField = self.atm_field, surf_field: SurfaceField = self.surf_field, subsurf_field: SubsurfaceField = self.subsurf_field, scat_species: ArrayOfScatteringSpecies = self.scat_species, ray_path_observer_agenda: Agenda = self.ray_path_observer_agenda, spectral_propmat_agenda: Agenda = self.spectral_propmat_agenda, spectral_rad_space_agenda: Agenda = self.spectral_rad_space_agenda, spectral_rad_surface_agenda: Agenda = self.spectral_rad_surface_agenda, mc_seed: Index = 0, mc_min_iter: Index = 100, mc_max_iter: Index = 10000, mc_max_scatorder: Index = 20, mc_std_err: Numeric = 0, mc_max_time: Numeric = 0) → 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 (~pyarts3.arts.StokvecVector, optional) – A spectral radiance vector. Defaults to self.spectral_rad. [OUT]

  • spectral_rad_jac (~pyarts3.arts.StokvecMatrix, optional) – Jacobian of spectral_rad with respect to jac_targets. Defaults to self.spectral_rad_jac. [OUT]

  • ray_path (~pyarts3.arts.ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. Defaults to self.ray_path. [OUT]

  • freq_grid (~pyarts3.arts.AscendingGrid, optional) – A frequency grid. Unit: Hz. Defaults to self.freq_grid. [IN]

  • jac_targets (~pyarts3.arts.JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. Defaults to self.jac_targets. [IN]

  • obs_pos (~pyarts3.arts.Vector3, optional) – The position of an observer of spectral radiance. Defaults to self.obs_pos. [IN]

  • obs_los (~pyarts3.arts.Vector2, optional) – The line-of-sight of the observer of spectral radiance. Defaults to self.obs_los. [IN]

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

  • surf_field (~pyarts3.arts.SurfaceField, optional) – The surface field. Defaults to self.surf_field. [IN]

  • subsurf_field (~pyarts3.arts.SubsurfaceField, optional) – The sub-surface field. Defaults to self.subsurf_field. [IN]

  • scat_species (~pyarts3.arts.ArrayOfScatteringSpecies, optional) – The scattering species. Defaults to self.scat_species. [IN]

  • ray_path_observer_agenda (~pyarts3.arts.Agenda, optional) – Gets the propagation path as it is observed. Defaults to self.ray_path_observer_agenda. [IN]

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

  • spectral_rad_space_agenda (~pyarts3.arts.Agenda, optional) – Gets spectral radiance as seen of space. Defaults to self.spectral_rad_space_agenda. [IN]

  • spectral_rad_surface_agenda (~pyarts3.arts.Agenda, optional) – Computes spectral radiance as seen of the surface. Defaults to self.spectral_rad_surface_agenda. [IN]

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

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

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

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

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

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