surfaceTelsem

Workspace.surfaceTelsem(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, lat_grid: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Vector]] = self.lat_grid, lat_true: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Vector]] = self.lat_true, lon_true: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Vector]] = self.lon_true, 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, specular_los: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Vector]] = self.specular_los, surface_skin_t: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Numeric]] = self.surface_skin_t, atlas: Union[pyarts.arts.WorkspaceVariable, pyarts.arts.TelsemAtlas], r_min: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Numeric]] = 0, r_max: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Numeric]] = 1, d_max: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Numeric]] = -1.0, verbosity: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Verbosity]] = self.verbosity) → None

Compute surface emissivities using the TELSEM 2 model.

This method uses second version of the TELSEM model for calculating land surface emissivities (F. Aires et al, “A Tool to Estimate Land‐Surface Emissivities at Microwave frequencies (TELSEM) for use in numerical weather prediction” Quarterly Journal of the Royal Meteorological Society, vol. 137, (656), pp. 690-699, 2011.) This methods computes land surface emissivities for a given pencil beam using a given TELSEM2 atlas.

The input must satisfy the following conditions, otherwise an error is thrown:

  • The input frequencies (f_grid) must be within the range [5 GHz, 900 GHz]

  • The skin temperature (surface_skin_t) must be within the range [180 K, 360 K]

A TELSEM atlas contains only suface emissivities for locations that are classified as land. By default this WSM will throw an error if the pencil beam hits the surface at a position that is not contained in the given atlas.

The above behavior can be avoided by setting d_max to a positive value. This enables nearest neighbor interpolation, which assigns the emissivities of the nearest found cell in the atlas to the given position. In this case, an error is only thrown if the distance of the found neighbor is higher than the provided value of d_max.

You can limit the final reflectivity applied by setting r_min and r_max.

To extract a land-sea mask from a given telsem atlas see the WSM telsemSurfaceTypeLandSea().

Author(s): Simon Pfreundschuh

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]

  • lat_grid (Vector, optional) – The latitude grid. See lat_grid, defaults to self.lat_grid [IN]

  • lat_true (Vector, optional) – Latitudinal geolocation for 1D and 2D data. See lat_true, defaults to self.lat_true [IN]

  • lon_true (Vector, optional) – Longitudinal geolocation for 1D and 2D data. See lon_true, defaults to self.lon_true [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]

  • specular_los (Vector, optional) – The specular direction (for reflection by a flat surface). See specular_los, defaults to self.specular_los [IN]

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

  • atlas (TelsemAtlas) – The Telsem atlas to use for the emissivity calculation. [IN]

  • r_min (Numeric, optional) – Minimum allowed value for reflectivity to apply. Defaults to 0 [IN]

  • r_max (Numeric, optional) – Maximum allowed value for reflectivity to apply. Defaults to 1 [IN]

  • d_max (Numeric, optional) – Maximum allowed distance in meters for nearest neighbor interpolation in meters. Set to a negative value or zero to disable interpolation. Defaults to -1.0 [IN]

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