ARTS built-in documentation server

Workspace Method yCalc

Description

Calculation of complete measurement vectors (y).

The method performs radiative transfer calculations from a sensor
perspective. Radiative transfer calculations are performed for
monochromatic pencil beams, following iy_clearsky_agenda and
associated agendas. Obtained radiances are weighted together by
sensor_response, to include the characteristics of the sensor.
The measurement vector obtained can contain anything from a single
frequency value to a series of measurement scans (each consisting
of a series of spectra), all depending on the settings. Spectra
and jacobians are calculated in parallel.

The unit of output radiances and jacobians follow y_unit. The
conversion is applied on monochromatic pencil beam values. That
is, before any sensor responses have been included.
The frequency, polarisation etc. for each measurement value is
given by y_f, y_pol etc. No unit conversion is applied for
y_aux.

Authors: Patrick Eriksson

Synopsis

yCalc(

y, y_f, y_pol, y_pos, y_los, y_error, y_aux, jacobian, basics_checked, atmosphere_dim, p_grid, lat_grid, lon_grid, t_field, z_field, vmr_field, cloudbox_on, cloudbox_checked, stokes_dim, f_grid, sensor_pos, sensor_los, mblock_za_grid, mblock_aa_grid, antenna_dim, sensor_response, sensor_response_f, sensor_response_pol, sensor_response_za, sensor_response_aa, iy_clearsky_agenda, y_unit, jacobian_agenda, jacobian_do, jacobian_quantities, jacobian_indices )

Variables

OUT	y	(Vector)	The measurement vector.
OUT	y_f	(Vector)	The frequencies associated with y.
OUT	y_pol	(ArrayOfIndex)	The polarisation states associated with y.
OUT	y_pos	(Matrix)	The sensor positions associated with y.
OUT	y_los	(Matrix)	The line-of-sights associated with y.
OUT	y_error	(Vector)	Estimate of calculation errors in y.
OUT	y_aux	(Vector)	Data auxilary to y A general variable to provide data auxilary to y.
OUT	jacobian	(Matrix)	The Jacobian matrix.
IN	basics_checked	(Index)	OK-flag for basic variables and grids.
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	t_field	(Tensor3)	The field of atmospheric temperatures.
IN	z_field	(Tensor3)	The field of geometrical altitudes.
IN	vmr_field	(Tensor4)	VMR field.
IN	cloudbox_on	(Index)	Flag to activate the cloud box.
IN	cloudbox_checked	(Index)	OK-flag for variables associated with the cloudbox.
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	sensor_pos	(Matrix)	The sensor position for each measurement block.
IN	sensor_los	(Matrix)	The sensor line-of-sight (LOS) for each measurement block.
IN	mblock_za_grid	(Vector)	The zenith angle grid for each measurement block.
IN	mblock_aa_grid	(Vector)	The azimuthal angle grid for each measurement block.
IN	antenna_dim	(Index)	The dimensionality of the antenna pattern (1-2).
IN	sensor_response	(Sparse)	The matrix modelling the total sensor response.
IN	sensor_response_f	(Vector)	The frequencies associated with the output of sensor_response.
IN	sensor_response_pol	(ArrayOfIndex)	The polarisation states associated with the output of sensor_response.
IN	sensor_response_za	(Vector)	The relative zenith angles associated with the output of sensor_response.
IN	sensor_response_aa	(Vector)	The relative azimuth angles associated with the output of sensor_response.
IN	iy_clearsky_agenda	(Agenda)	See agendas.cc.
IN	y_unit	(String)	Unit for spectral values returned by radiative transfer methods.
IN	jacobian_agenda	(Agenda)	See agendas.cc.
IN	jacobian_do	(Index)	Flag to activate jacobian calculations.
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.