surfaceFastem

Workspace.surfaceFastem(self: pyarts.arts._Workspace, surface_los: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Matrix]] = self.surface_los, surface_rmatrix: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Tensor4]] = self.surface_rmatrix, surface_emission: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Matrix]] = self.surface_emission, atmosphere_dim: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Index]] = self.atmosphere_dim, stokes_dim: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Index]] = self.stokes_dim, f_grid: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Vector]] = self.f_grid, rtp_pos: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Vector]] = self.rtp_pos, rtp_los: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Vector]] = self.rtp_los, surface_skin_t: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Numeric]] = self.surface_skin_t, salinity: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Numeric]] = 0.035, wind_speed: Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Numeric], wind_direction: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Numeric]] = 0, transmittance: Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Vector], fastem_version: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Index]] = 6, verbosity: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Verbosity]] = self.verbosity) None

Usage of FASTEM together with MC and DOIT.

The recommended way to use FASTEM is by iySurfaceFastem(), but that is not always possible, such as when using MC and DOIT. This is the case as those scattering methods use surface_rtprop_agenda, while iySurfaceFastem() fits with iy_surface_agenda. This WSM solves this by allowing FASTEM to be used inside surface_rtprop_agenda.

However, FASTEM is here used in an approximative way. For a correct usage of FASTEM, the atmospheric transmittance shall be calculated for the position and direction of concern, but this is not possible together with DOIT and MC. Instead, the transmittance is an input to the method, and must either be pre-calculated or set to a representative value.

See iySurfaceFastem(), for further details on the special input arguments.

Author(s): Patrick Eriksson

Parameters:
  • surface_los (Matrix, optional) – Downwelling radiation directions to consider in surface reflection. See surface_los, defaults to self.surface_los [OUT]

  • surface_rmatrix (Tensor4, optional) – The reflection coefficients for the directions given by. See surface_rmatrix, defaults to self.surface_rmatrix [OUT]

  • surface_emission (Matrix, optional) – The emission from the surface. See surface_emission, defaults to self.surface_emission [OUT]

  • atmosphere_dim (Index, optional) – The atmospheric dimensionality (1-3). See atmosphere_dim, defaults to self.atmosphere_dim [IN]

  • stokes_dim (Index, optional) – The dimensionality of the Stokes vector (1-4). See stokes_dim, defaults to self.stokes_dim [IN]

  • f_grid (Vector, optional) – The frequency grid for monochromatic pencil beam calculations. See f_grid, defaults to self.f_grid [IN]

  • rtp_pos (Vector, optional) – Position of a radiative transfer point. See rtp_pos, defaults to self.rtp_pos [IN]

  • rtp_los (Vector, optional) – Line-of-sight at a radiative transfer point. See rtp_los, defaults to self.rtp_los [IN]

  • surface_skin_t (Numeric, optional) – Surface skin temperature. See surface_skin_t, defaults to self.surface_skin_t [IN]

  • salinity (Numeric, optional) – Salinity, 0-1. That is, 3% is given as 0.03. Defaults to 0.035 [IN]

  • wind_speed (Numeric) – Wind speed. [IN]

  • wind_direction (Numeric, optional) – Wind direction. See futher above. Defaults to 0 [IN]

  • transmittance (Vector) – Transmittance along path of downwelling radiation. A vector with the same length as f_grid. [IN]

  • fastem_version (Index, optional) – The version of FASTEM to use. Defaults to 6 [IN]

  • verbosity (Verbosity) – ARTS verbosity. See verbosity, defaults to self.verbosity [IN]