MCRadar

Workspace.MCRadar(self, radar_signal: StokvecVector = self.radar_signal, radar_error: StokvecVector = self.radar_error, atm_field: AtmField = self.atm_field, surf_field: SurfaceField = self.surf_field, scat_species: ArrayOfScatteringSpecies = self.scat_species, mc_antenna: MCAntenna = self.mc_antenna, ray_path_observer_agenda: Agenda = self.ray_path_observer_agenda, spectral_propmat_agenda: Agenda = self.spectral_propmat_agenda, frequency: Numeric, sensor_pos: Vector3, sensor_los: Vector2, mc_y_tx: Stokvec, range_bins: AscendingGrid, mc_seed: Index = 0, mc_max_iter: Index = 1000, mc_max_scatorder: Index = 1, k2: Numeric = 0.93, unit: String = 1) → None

Simulates active-radar returns using Monte Carlo antenna sampling.

This ARTS3-native implementation uses AtmField, SurfaceField, ArrayOfScatteringSpecies, and ray_path_observer_agenda. Range-bin edges are one-way geometric distances in metres. The outputs contain one Stokvec per range bin, and the error contains the component-wise standard error of the Monte Carlo mean. The implementation currently supports single scattering (mc_max_scatorder=1); the argument is retained so higher orders can be added without changing the interface.

Authors: Richard Larsson, OpenAI Codex

Parameters:

  • radar_signal (~pyarts3.arts.StokvecVector, optional) – Monte Carlo radar return with one Stokes vector per range bin. Defaults to self.radar_signal. [OUT]

  • radar_error (~pyarts3.arts.StokvecVector, optional) – Component-wise standard error of radar_signal for each range bin. Defaults to self.radar_error. [OUT]

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

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

  • mc_antenna (~pyarts3.arts.MCAntenna, optional) – Transmit and receive antenna pattern for Monte Carlo calculations. Defaults to self.mc_antenna. [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]

  • frequency (Numeric) – Radar frequency [Hz]. [IN]

  • sensor_pos (Vector3) – Sensor position [alt, lat, lon]. [IN]

  • sensor_los (Vector2) – Sensor boresight [zenith, azimuth]. [IN]

  • mc_y_tx (Stokvec) – Transmitted Stokes vector. [IN]

  • range_bins (AscendingGrid) – One-way range-bin edges [m]. [IN]

  • mc_seed (~pyarts3.arts.Index, optional) – Random seed. Defaults to 0 [IN]

  • mc_max_iter (~pyarts3.arts.Index, optional) – Number of sampled antenna rays. Defaults to 1000 [IN]

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

  • k2 (~pyarts3.arts.Numeric, optional) – Reference dielectric factor squared for Ze conversion. Defaults to 0.93 [IN]

  • unit (~pyarts3.arts.String, optional) – Output unit: ‘1’ or ‘Ze’. Defaults to "1" [IN]