ARTS built-in documentation server

Workspace Method iyEmissionStandard

Description

Standard method for radiative transfer calculations with emission.

Designed to be part of iy_main_agenda. That is, only valid
outside the cloudbox (no scattering). Assumes local thermodynamic
equilibrium for emission. The basic calculation strategy is to take
the average of the absorption and the emission source function at
the end points of each step of the propagation path. For details
see the user guide.

The internal radiance unit is determined by your definition of
blackbody radiation inside the atmospheric and surface source
terms. Set iy_unit to "1" if you want this to also be the unit
for output radiances. If you want another output unit, you need to
make sure that the internal unit is [W/m2/Hz/sr] (ie. the frequency
version of the Planck function). The possible choices for iy_unit
are:
 "1"             : No conversion.
 "RJBT"          : Conversion to Rayleigh-Jean brightness
                     temperature.
 "PlanckBT"      : Conversion to Planck brightness temperature.
 "W/(m^2 m sr)"  : Conversion to [W/(m^2 m sr)] (radiance per
                     wavelength unit).
 "W/(m^2 m-1 sr)": Conversion to [W/(m^2 m-1 sr)] (radiance per
                     wavenumber unit).

Please note that there is no way for ARTS to strictly check the
internal unit. In principle, the unit can differ between the
elements. The user must makes sure that any unit conversion is
applied correctly, and in accordance with the calibration of the
instrument of concern. Expressions applied and considerations for
the unit conversion of radiances are discussed in Sec. 5.7 of the
ARTS-2 article.

The following auxiliary data can be obtained:
  "Pressure": The pressure along the propagation path.
     Size: [1,1,1,np].
  "Temperature": The temperature along the propagation path.
     Size: [1,1,1,np].
  "VMR, species X": VMR of the species with index X (zero based).
     For example, adding the string "VMR, species 0" extracts the
     VMR of the first species. Size: [1,1,1,np].
  "Absorption, summed": The total absorption matrix along the
     path. Size: [nf,ns,ns,np].
  "Absorption, species X": The absorption matrix along the path
     for an individual species (X works as for VMR).
     Size: [nf,ns,ns,np].
* "Radiative background": Index value flagging the radiative
     background. The following coding is used: 0=space, 1=surface
     and 2=cloudbox. Size: [nf,1,1,1].
  "iy": The radiance at each point along the path (iy_unit is.
     considered). Size: [nf,ns,1,np].
  "Transmission": The transmission matrix from the surface, space
     or cloudbox, to each propagation path point. The matrix is
     valid for the photon direction. Size: [nf,ns,ns,np].
* "Optical depth": The scalar optical depth between the
     observation point and the end of the primary propagation path
     (ie. the optical depth to the surface or space.). Calculated
     in a pure scalar manner, and not dependent on direction.
     Size: [nf,1,1,1].
where
  nf: Number of frequencies.
  ns: Number of Stokes elements.
  np: Number of propagation path points.

The auxiliary data are returned in iy_aux with quantities
selected by iy_aux_vars. Most variables require that the method
is called directly or by iyCalc. For calculations using yCalc,
the selection is restricted to the variables marked with *.

In addition, these choices are accepted but no calculations are
done:
  "PND, type X": Size: [0,0,0,0].
  "Mass content, X": Size: [0,0,0,0].
See e.g. iyTransmissionStandard for a definition of these
variables. To fill these elements of iy_aux (after calling
this WSM), use iy_auxFillParticleVariables.

Authors: Patrick Eriksson

Synopsis

iyEmissionStandard( iy, iy_aux, ppath, diy_dx, stokes_dim, f_grid, atmosphere_dim, p_grid, z_field, t_field, vmr_field, abs_species, wind_u_field, wind_v_field, wind_w_field, mag_u_field, mag_v_field, mag_w_field, cloudbox_on, iy_unit, iy_aux_vars, jacobian_do, jacobian_quantities, jacobian_indices, ppath_agenda, blackbody_radiation_agenda, propmat_clearsky_agenda, iy_main_agenda, iy_space_agenda, iy_surface_agenda, iy_cloudbox_agenda, iy_agenda_call1, iy_transmission, rte_pos, rte_los, rte_pos2, rte_alonglos_v, ppath_lraytrace )

Variables

OUTiy(Matrix)Monochromatic pencil beam radiance spectrum.
OUTiy_aux(ArrayOfTensor4)Data auxiliary to iy.
OUTppath(Ppath)The propagation path for one line-of-sight.
OUTdiy_dx(ArrayOfTensor3)Derivative of iy with respect to retrieval quantities.
INstokes_dim(Index)The dimensionality of the Stokes vector (1-4).
INf_grid(Vector)The frequency grid for monochromatic pencil beam calculations.
INatmosphere_dim(Index)The atmospheric dimensionality (1-3).
INp_grid(Vector)The pressure grid.
INz_field(Tensor3)The field of geometrical altitudes.
INt_field(Tensor3)The field of atmospheric temperatures.
INvmr_field(Tensor4)VMR field.
INabs_species(ArrayOfArrayOfSpeciesTag)Tag groups for scalar gas absorption.
INwind_u_field(Tensor3)Zonal component of the wind field.
INwind_v_field(Tensor3)Meridional component of the magnetic field.
INwind_w_field(Tensor3)Vertical wind component field.
INmag_u_field(Tensor3)Zonal component of the magnetic field.
INmag_v_field(Tensor3)Meridional component of the magnetic field.
INmag_w_field(Tensor3)Vertical component of the magnetic field.
INcloudbox_on(Index)Flag to activate the cloud box.
INiy_unit(String)Selection of output unit for some radiative transfer methods.
INiy_aux_vars(ArrayOfString)Selection of quantities for iy_aux and when applicable also y_aux.
INjacobian_do(Index)Flag to activate jacobian calculations.
INjacobian_quantities(ArrayOfRetrievalQuantity)The retrieval quantities in the Jacobian matrix.
INjacobian_indices(ArrayOfArrayOfIndex)First and last column index in jacobian for each retrieval quantity.
INppath_agenda(Agenda)See agendas.cc.
INblackbody_radiation_agenda(Agenda)See agendas.cc.
INpropmat_clearsky_agenda(Agenda)See agendas.cc.
INiy_main_agenda(Agenda)See agendas.cc.
INiy_space_agenda(Agenda)See agendas.cc.
INiy_surface_agenda(Agenda)See agendas.cc.
INiy_cloudbox_agenda(Agenda)See agendas.cc.
INiy_agenda_call1(Index)Flag to handle recursive calls of iy_main_agenda The agenda iy_main_agenda can be used recursively and this flag is used to tell the methods inside the agenda which is the primary call.
INiy_transmission(Tensor3)Transmission to be included in iy.
INrte_pos(Vector)A geographical position for starting radiative transfer calculations.
INrte_los(Vector)A line-of-sight for (complete) radiative transfer calculations.
INrte_pos2(Vector)A second geographical position to define the geometry for radiative transfer calculations.
INrte_alonglos_v(Numeric)Velocity along the line-of-sight to consider for a RT calculation.
INppath_lraytrace(Numeric)Maximum length of ray tracing steps when determining propagation paths.