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 toself.iy
[INOUT]diy_dx (ArrayOfTensor3, optional) – Derivative of
iy
with respect to retrieval quantities. Seediy_dx
, defaults toself.diy_dx
[INOUT]iy_transmittance (Tensor3, optional) – Transmittance to be included in
iy
. Seeiy_transmittance
, defaults toself.iy_transmittance
[IN]iy_id (Index, optional) – Identification number of
iy
. Seeiy_id
, defaults toself.iy_id
[IN]jacobian_do (Index, optional) – Flag to activate (clear-sky) Jacobian calculations. See
jacobian_do
, defaults toself.jacobian_do
[IN]suns_do (Index, optional) – Flag to activate the sun(s). See
suns_do
, defaults toself.suns_do
[IN]atmosphere_dim (Index, optional) – The atmospheric dimensionality (1-3). See
atmosphere_dim
, defaults toself.atmosphere_dim
[IN]nlte_field (EnergyLevelMap, optional) – The field of NLTE temperatures and/or ratios. See
nlte_field
, defaults toself.nlte_field
[IN]cloudbox_on (Index, optional) – Flag to activate the cloud box. See
cloudbox_on
, defaults toself.cloudbox_on
[IN]stokes_dim (Index, optional) – The dimensionality of the Stokes vector (1-4). See
stokes_dim
, defaults toself.stokes_dim
[IN]f_grid (Vector, optional) – The frequency grid for monochromatic pencil beam calculations. See
f_grid
, defaults toself.f_grid
[IN]lat_grid (Vector, optional) – The latitude grid. See
lat_grid
, defaults toself.lat_grid
[IN]lon_grid (Vector, optional) – The longitude grid. See
lon_grid
, defaults toself.lon_grid
[IN]z_surface (Matrix, optional) – The surface altitude. See
z_surface
, defaults toself.z_surface
[IN]refellipsoid (Vector, optional) – Reference ellipsoid. See
refellipsoid
, defaults toself.refellipsoid
[IN]rtp_pos (Vector, optional) – Position of a radiative transfer point. See
rtp_pos
, defaults toself.rtp_pos
[IN]rtp_los (Vector, optional) – Line-of-sight at a radiative transfer point. See
rtp_los
, defaults toself.rtp_los
[IN]rte_pos2 (Vector, optional) – A second geographical position to define the geometry for. See
rte_pos2
, defaults toself.rte_pos2
[IN]iy_unit (String, optional) – Selection of output unit for radiative transfer methods. See
iy_unit
, defaults toself.iy_unit
[IN]surface_scalar_reflectivity (Vector, optional) – Surface reflectivity, assuming it can be described as a scalar value. See
surface_scalar_reflectivity
, defaults toself.surface_scalar_reflectivity
[IN]surface_props_data (Tensor3, optional) – Various surface properties. See
surface_props_data
, defaults toself.surface_props_data
[IN]surface_props_names (ArrayOfString, optional) – Name on surface properties found in
surface_props_data
. Seesurface_props_names
, defaults toself.surface_props_names
[IN]dsurface_names (ArrayOfString, optional) – Name of surface retrieval quantities. See
dsurface_names
, defaults toself.dsurface_names
[IN]jacobian_quantities (ArrayOfRetrievalQuantity, optional) – The retrieval quantities in the Jacobian matrix. See
jacobian_quantities
, defaults toself.jacobian_quantities
[IN]iy_main_agenda (Agenda, optional) – Calculation of a single monochromatic pencil beam spectrum. See
iy_main_agenda
, defaults toself.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 toself.verbosity
[IN]