ARTS built-in documentation server

Workspace Method iyBeerLambertStandardClearsky

Description

Standard method for handling transmission measurements.

Designed to be part of iy_clearsky_agenda. That is, only valid
outside the cloudbox (no scattering or polarised absorption).

This method works exactly as iyEmissionStandardClearsky, but does
add any emission. In fact, the latter method with emission_agenda
set to return zero would give exactly the same result as this WSM.
For propagation paths above the surface, the result is the output
of iy_space_agenda times the (vector) transmission through the
atmosphere (i.e. standard Beer-Lambert). 

If the propagation paths intercepts with the surface, the surface
variables are used as for iyEmissionStandardClearsky, and 
surface_emission should probably be set to 0. Multiple-beams
will be followed if surface_los has length > 1.

iy_aux is not set.

Authors: Patrick Eriksson

Synopsis

iyBeerLambertStandardClearsky(

iy, iy_error, iy_error_type, iy_aux, diy_dx, iy_agenda_call1, iy_transmission, rte_pos, rte_los, jacobian_do, atmosphere_dim, p_grid, lat_grid, lon_grid, z_field, t_field, vmr_field, wind_u_field, wind_v_field, wind_w_field, r_geoid, z_surface, cloudbox_on, cloudbox_limits, stokes_dim, f_grid, abs_species, ppath_step_agenda, abs_scalar_gas_agenda, iy_clearsky_agenda, iy_space_agenda, surface_prop_agenda, iy_cloudbox_agenda, jacobian_quantities, jacobian_indices )

Variables

OUT	iy	(Matrix)	Monochromatic pencil beam radiance spectrum.
OUT	iy_error	(Matrix)	Estimation of calculation errors in iy.
OUT	iy_error_type	(Index)	Characteristics of error values in iy_error.
OUT	iy_aux	(Matrix)	Data auxilary to iy.
OUT	diy_dx	(ArrayOfTensor3)	Derivative of iy with respect to retrieval quantities.
IN	iy_error	(Matrix)	Estimation of calculation errors in iy.
IN	iy_error_type	(Index)	Characteristics of error values in iy_error.
IN	iy_aux	(Matrix)	Data auxilary to iy.
IN	diy_dx	(ArrayOfTensor3)	Derivative of iy with respect to retrieval quantities.
IN	iy_agenda_call1	(Index)	Flag to handle recursive calls of iy_clearsky_agenda The agenda iy_clearsky_agenda can be used recursively and this flag is used to tell the methods inside the agenda which is the primary call.
IN	iy_transmission	(Tensor3)	Transmission to be included in iy.
IN	rte_pos	(Vector)	A geographical position for radiative transfer calculations.
IN	rte_los	(Vector)	A line-of-sight for radiative transfer calculations.
IN	jacobian_do	(Index)	Flag to activate jacobian calculations.
IN	atmosphere_dim	(Index)	The atmospheric dimensionality (1-3).
IN	p_grid	(Vector)	The pressure grid.
IN	lat_grid	(Vector)	The latitude grid.
IN	lon_grid	(Vector)	The longitude grid.
IN	z_field	(Tensor3)	The field of geometrical altitudes.
IN	t_field	(Tensor3)	The field of atmospheric temperatures.
IN	vmr_field	(Tensor4)	VMR field.
IN	wind_u_field	(Tensor3)	Meridional (second horizontal wind) component field for 3D.
IN	wind_v_field	(Tensor3)	Horizontal 1D, 2D or 3D wind components.
IN	wind_w_field	(Tensor3)	Vertical wind component field.
IN	r_geoid	(Matrix)	Geoid radius.
IN	z_surface	(Matrix)	The surface altitude.
IN	cloudbox_on	(Index)	Flag to activate the cloud box.
IN	cloudbox_limits	(ArrayOfIndex)	The limits of the cloud box.
IN	stokes_dim	(Index)	The dimensionality of the Stokes vector (1-4).
IN	f_grid	(Vector)	The frequency grid for monochromatic pencil beam calculations.
IN	abs_species	(ArrayOfArrayOfSpeciesTag)	Tag groups for scalar gas absorption.
IN	ppath_step_agenda	(Agenda)	See agendas.cc.
IN	abs_scalar_gas_agenda	(Agenda)	See agendas.cc.
IN	iy_clearsky_agenda	(Agenda)	See agendas.cc.
IN	iy_space_agenda	(Agenda)	See agendas.cc.
IN	surface_prop_agenda	(Agenda)	See agendas.cc.
IN	iy_cloudbox_agenda	(Agenda)	See agendas.cc.
IN	jacobian_quantities	(ArrayOfRetrievalQuantity)	The retrieval quantities in the Jacobian matrix.
IN	jacobian_indices	(ArrayOfArrayOfIndex)	First and last column index in jacobian for each retrieval quantity.