iySurfaceLambertian

Workspace.iySurfaceLambertian(self: pyarts.arts._Workspace, iy: pyarts.arts.WorkspaceVariable | pyarts.arts.Matrix | None = self.iy, diy_dx: pyarts.arts.WorkspaceVariable | pyarts.arts.ArrayOfTensor3 | None = self.diy_dx, iy_transmittance: pyarts.arts.WorkspaceVariable | pyarts.arts.Tensor3 | None = self.iy_transmittance, iy_id: pyarts.arts.WorkspaceVariable | pyarts.arts.Index | None = self.iy_id, jacobian_do: pyarts.arts.WorkspaceVariable | pyarts.arts.Index | None = self.jacobian_do, suns_do: pyarts.arts.WorkspaceVariable | pyarts.arts.Index | None = self.suns_do, atmosphere_dim: pyarts.arts.WorkspaceVariable | pyarts.arts.Index | None = self.atmosphere_dim, nlte_field: pyarts.arts.WorkspaceVariable | pyarts.arts.EnergyLevelMap | None = self.nlte_field, cloudbox_on: pyarts.arts.WorkspaceVariable | pyarts.arts.Index | None = self.cloudbox_on, stokes_dim: pyarts.arts.WorkspaceVariable | pyarts.arts.Index | None = self.stokes_dim, f_grid: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.f_grid, lat_grid: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.lat_grid, lon_grid: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.lon_grid, z_surface: pyarts.arts.WorkspaceVariable | pyarts.arts.Matrix | None = self.z_surface, refellipsoid: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.refellipsoid, rtp_pos: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.rtp_pos, rtp_los: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.rtp_los, rte_pos2: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.rte_pos2, iy_unit: pyarts.arts.WorkspaceVariable | pyarts.arts.String | None = self.iy_unit, surface_scalar_reflectivity: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.surface_scalar_reflectivity, surface_props_data: pyarts.arts.WorkspaceVariable | pyarts.arts.Tensor3 | None = self.surface_props_data, surface_props_names: pyarts.arts.WorkspaceVariable | pyarts.arts.ArrayOfString | None = self.surface_props_names, dsurface_names: pyarts.arts.WorkspaceVariable | pyarts.arts.ArrayOfString | None = self.dsurface_names, jacobian_quantities: pyarts.arts.WorkspaceVariable | pyarts.arts.ArrayOfRetrievalQuantity | None = self.jacobian_quantities, iy_main_agenda: pyarts.arts.WorkspaceVariable | pyarts.arts.Agenda | None = self.iy_main_agenda, N_za: pyarts.arts.WorkspaceVariable | pyarts.arts.Index | None = 3, N_aa: pyarts.arts.WorkspaceVariable | pyarts.arts.Index | None = 1, verbosity: pyarts.arts.WorkspaceVariable | pyarts.arts.Verbosity | None = self.verbosity) None

This method calculates upwelling radiation for a lambertian surface.

These are due to the scattering of the downgoing diffuse radiation and emission from the surface. This method works only for 1D or 3D atmospheres. For the integration over the zenith angles a gaussian quadrature with N_za angles is used. For 1D atmospheres N_aa is ignored. For 3D atmospheres without clouds azimuthal dependency can be neglected. N_aa = 1 is sufficient. For 3D atmospheres with cloudbox on azimuthal dependency needs to be accounted. In that case the number of azimuth angles N_aa as a rule ofthumb should be set to 4*N_za. For the 1D case N_za downwelling streams and 3D case N_za*N_aa downwelling streams are calculated.

This method is designed to be part of iy_surface_agenda

Important this method calculates only the scattering of the diffuse downward radiation. No direct incoming radiation is considered

Jacobian is supported only for Skin temperature

Author(s): Manfred Brath

Parameters:
  • iy (Matrix, optional) – Monochromatic pencil beam radiance spectrum. See iy, defaults to self.iy [INOUT]

  • diy_dx (ArrayOfTensor3, optional) – Derivative of iy with respect to retrieval quantities. See diy_dx, defaults to self.diy_dx [INOUT]

  • iy_transmittance (Tensor3, optional) – Transmittance to be included in iy. See iy_transmittance, defaults to self.iy_transmittance [IN]

  • iy_id (Index, optional) – Identification number of iy. See iy_id, defaults to self.iy_id [IN]

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

  • suns_do (Index, optional) – Flag to activate the sun(s). See suns_do, defaults to self.suns_do [IN]

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

  • nlte_field (EnergyLevelMap, optional) – The field of NLTE temperatures and/or ratios. See nlte_field, defaults to self.nlte_field [IN]

  • cloudbox_on (Index, optional) – Flag to activate the cloud box. See cloudbox_on, defaults to self.cloudbox_on [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]

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

  • z_surface (Matrix, optional) – The surface altitude. See z_surface, defaults to self.z_surface [IN]

  • refellipsoid (Vector, optional) – Reference ellipsoid. See refellipsoid, defaults to self.refellipsoid [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]

  • rte_pos2 (Vector, optional) – A second geographical position to define the geometry for. See rte_pos2, defaults to self.rte_pos2 [IN]

  • iy_unit (String, optional) – Selection of output unit for radiative transfer methods. See iy_unit, defaults to self.iy_unit [IN]

  • surface_scalar_reflectivity (Vector, optional) – Surface reflectivity, assuming it can be described as a scalar value. See surface_scalar_reflectivity, defaults to self.surface_scalar_reflectivity [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_quantities (ArrayOfRetrievalQuantity, optional) – The retrieval quantities in the Jacobian matrix. See jacobian_quantities, defaults to self.jacobian_quantities [IN]

  • iy_main_agenda (Agenda, optional) – Calculation of a single monochromatic pencil beam spectrum. See iy_main_agenda, defaults to self.iy_main_agenda [IN]

  • N_za (Index, optional) – Number of zenith angles. Defaults to 3 [IN]

  • N_aa (Index, optional) – Number of azimuth angles. Defaults to 1 [IN]

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