ARTS built-in documentation server

Workspace Method iySurfaceLambertian

Description

This method calculates upwelling radiation for a lambertian surface
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

Authors: Manfred Brath

Synopsis

iySurfaceLambertian( iy, diy_dx, iy_transmittance, iy_id, jacobian_do, stars_do, atmosphere_dim, nlte_field, cloudbox_on, stokes_dim, f_grid, lat_grid, lon_grid, z_surface, refellipsoid, rtp_pos, rtp_los, rte_pos2, iy_unit, surface_scalar_reflectivity, surface_props_data, surface_props_names, dsurface_names, jacobian_quantities, iy_main_agenda, N_za, N_aa )

Variables

OUT+INiy(Matrix)Monochromatic pencil beam radiance spectrum.
OUT+INdiy_dx(ArrayOfTensor3)Derivative of iy with respect to retrieval quantities.
INiy_transmittance(Tensor3)Transmittance to be included in iy.
INiy_id(Index)Identification number of iy.
INjacobian_do(Index)Flag to activate (clear-sky) Jacobian calculations.
INstars_do(Index)Flag to activate the star(s).
INatmosphere_dim(Index)The atmospheric dimensionality (1-3).
INnlte_field(EnergyLevelMap)The field of NLTE temperatures and/or ratios.
INcloudbox_on(Index)Flag to activate the cloud box.
INstokes_dim(Index)The dimensionality of the Stokes vector (1-4).
INf_grid(Vector)The frequency grid for monochromatic pencil beam calculations.
INlat_grid(Vector)The latitude grid.
INlon_grid(Vector)The longitude grid.
INz_surface(Matrix)The surface altitude.
INrefellipsoid(Vector)Reference ellipsoid.
INrtp_pos(Vector)Position of a radiative transfer point.
INrtp_los(Vector)Line-of-sight at a radiative transfer point.
INrte_pos2(Vector)A second geographical position to define the geometry for radiative transfer calculations.
INiy_unit(String)Selection of output unit for radiative transfer methods.
INsurface_scalar_reflectivity(Vector)Surface reflectivity, assuming it can be described as a scalar value.
INsurface_props_data(Tensor3)Various surface properties.
INsurface_props_names(ArrayOfString)Name on surface properties found in surface_props_data.
INdsurface_names(ArrayOfString)Name of surface retrieval quantities.
INjacobian_quantities(ArrayOfRetrievalQuantity)The retrieval quantities in the Jacobian matrix.
INiy_main_agenda(Agenda)Agenda calculating the single monochromatic pencil beam spectrum.
GINN_za(Index, Default: 3)Number of zenith angles.
GINN_aa(Index, Default: 1)Number of azimuth angles