SurfaceFlatScalarReflectivity

Workspace.SurfaceFlatScalarReflectivity(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, dsurface_rmatrix_dx: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.ArrayOfTensor4]] = self.dsurface_rmatrix_dx, surface_emission: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Matrix]] = self.surface_emission, dsurface_emission_dx: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.ArrayOfMatrix]] = self.dsurface_emission_dx, stokes_dim: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Index]] = self.stokes_dim, atmosphere_dim: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Index]] = self.atmosphere_dim, lat_grid: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Vector]] = self.lat_grid, lon_grid: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Vector]] = self.lon_grid, 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, specular_los: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Vector]] = self.specular_los, surface_props_data: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Tensor3]] = self.surface_props_data, surface_props_names: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.ArrayOfString]] = self.surface_props_names, dsurface_names: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.ArrayOfString]] = self.dsurface_names, jacobian_do: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Index]] = self.jacobian_do, f_reflectivities: Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Vector], verbosity: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Verbosity]] = self.verbosity) None

Piecewise linear scalar surface reflectivity.

This method is similar to surfaceFlatScalarReflectivity() but the reflectivities are specified differently and Jacobian calculations are supported. See SurfaceFastem() for general remarks about methods of SurfaceSomething type.

The method works with scalar reflectivies, i.e. it is assumed that the reflection at vertical and horizontal polarisation is identical. The scalar reflectivity is given at a number of frequencies, specified by the GIN f_reflectivities. The reflectivity at the first frequency is denoted as “Scalar reflectivity 0” etc. Between the frequencies in f_reflectivities, the reflectivity is treated to vary linearly. The reflectivity is assumed to be constant outside of f_reflectivities, and the end points in f_reflectivities can be both inside and outside of the range of f_grid. Setting f_reflectivities to have a single value, implies that the reflectivity is constant over f_grid.

For this method, surface_props_data must contain these data:

“Skin temperature” “Scalar reflectivity 0” “Scalar reflectivity 1” … “Scalar reflectivity N”

where N is the length of f_reflectivities-1.

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]

  • dsurface_rmatrix_dx (ArrayOfTensor4, optional) – The derivative of surface_rmatrix with respect to quantities. See dsurface_rmatrix_dx, defaults to self.dsurface_rmatrix_dx [INOUT]

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

  • dsurface_emission_dx (ArrayOfMatrix, optional) – The derivative of surface_emission with respect to quantities. See dsurface_emission_dx, defaults to self.dsurface_emission_dx [INOUT]

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

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

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

  • lon_grid (Vector, optional) – The longitude grid. See lon_grid, defaults to self.lon_grid [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]

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

  • surface_props_data (Tensor3, optional) – Various surface properties. See surface_props_data, defaults to self.surface_props_data [IN]

  • surface_props_names (ArrayOfString, optional) – Name on surface properties found in surface_props_data. See surface_props_names, defaults to self.surface_props_names [IN]

  • dsurface_names (ArrayOfString, optional) – Name of surface retrieval quantities. See dsurface_names, defaults to self.dsurface_names [IN]

  • jacobian_do (Index, optional) – Flag to activate (clear-sky) Jacobian calculations. See jacobian_do, defaults to self.jacobian_do [IN]

  • f_reflectivities (Vector) – Frequency retrieval grid, see above. [IN]

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