MCRadar

Workspace.MCRadar(self, radar_signal: pyarts3.arts.StokvecVector | None = None, radar_error: pyarts3.arts.StokvecVector | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, scat_species: pyarts3.arts.ArrayOfScatteringSpecies | None = None, mc_antenna: pyarts3.arts.MCAntenna | None = None, ray_path_observer_agenda: pyarts3.arts.Agenda | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, frequency: pyarts3.arts.Numeric | None = None, sensor_pos: pyarts3.arts.Vector3 | None = None, sensor_los: pyarts3.arts.Vector2 | None = None, mc_y_tx: pyarts3.arts.Stokvec | None = None, range_bins: pyarts3.arts.AscendingGrid | None = None, mc_seed: pyarts3.arts.Index | None = None, mc_max_iter: pyarts3.arts.Index | None = None, mc_max_scatorder: pyarts3.arts.Index | None = None, k2: pyarts3.arts.Numeric | None = None, unit: pyarts3.arts.String | None = None) → 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 (StokvecVector, optional) – Monte Carlo radar return with one Stokes vector per range bin. See radar_signal, defaults to self.radar_signal [OUT]

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

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

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

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

  • 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 (Index, optional) – Random seed. Defaults to 0 [IN]

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

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

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

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