ARTS built-in documentation server

Workspace Method iySurfaceFlatReflectivityDirect

Description

This method calculates the specular reflection at a flat 
surface of the direct radiation with a predefined reflectivity matrix.

This method is designed to be part of iy_surface_agenda

Important this method calculates only the scattering of the direct
(sun) radiation. No diffuse incoming radiation is considered

This method has no jacobian capability

Authors: Manfred Brath

Synopsis

iySurfaceFlatReflectivityDirect(

iy, rtp_pos, rtp_los, stokes_dim, f_grid, atmosphere_dim, p_grid, lat_grid, lon_grid, z_field, t_field, nlte_field, vmr_field, abs_species, wind_u_field, wind_v_field, wind_w_field, mag_u_field, mag_v_field, mag_w_field, z_surface, surface_reflectivity, refellipsoid, pnd_field, dpnd_field_dx, scat_species, scat_data, ppath_lmax, ppath_lraytrace, ppath_inside_cloudbox_do, cloudbox_on, cloudbox_limits, suns_do, gas_scattering_do, jacobian_do, jacobian_quantities, suns, rte_alonglos_v, iy_unit, propmat_clearsky_agenda, water_p_eq_agenda, gas_scattering_agenda, ppath_step_agenda )

Variables

OUT+IN	iy	(Matrix)	Monochromatic pencil beam radiance spectrum.
IN	rtp_pos	(Vector)	Position of a radiative transfer point.
IN	rtp_los	(Vector)	Line-of-sight at a radiative transfer point.
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	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	nlte_field	(EnergyLevelMap)	The field of NLTE temperatures and/or ratios.
IN	vmr_field	(Tensor4)	VMR field.
IN	abs_species	(ArrayOfArrayOfSpeciesTag)	Tag groups for gas absorption.
IN	wind_u_field	(Tensor3)	Zonal component of the wind field.
IN	wind_v_field	(Tensor3)	Meridional component of the magnetic field.
IN	wind_w_field	(Tensor3)	Vertical wind component field.
IN	mag_u_field	(Tensor3)	Zonal component of the magnetic field.
IN	mag_v_field	(Tensor3)	Meridional component of the magnetic field.
IN	mag_w_field	(Tensor3)	Vertical component of the magnetic field.
IN	z_surface	(Matrix)	The surface altitude.
IN	surface_reflectivity	(Tensor3)	Surface reflectivity, for a given position and angle.
IN	refellipsoid	(Vector)	Reference ellipsoid.
IN	pnd_field	(Tensor4)	Particle number density field.
IN	dpnd_field_dx	(ArrayOfTensor4)	Partial derivatives of pnd_field.
IN	scat_species	(ArrayOfString)	Array of Strings defining the scattering species to consider.
IN	scat_data	(ArrayOfArrayOfSingleScatteringData)	Array of single scattering data.
IN	ppath_lmax	(Numeric)	Maximum length between points describing propagation paths.
IN	ppath_lraytrace	(Numeric)	Maximum length of ray tracing steps when determining propagation paths.
IN	ppath_inside_cloudbox_do	(Index)	Flag to perform ray tracing inside the cloudbox.
IN	cloudbox_on	(Index)	Flag to activate the cloud box.
IN	cloudbox_limits	(ArrayOfIndex)	The limits of the cloud box.
IN	suns_do	(Index)	Flag to activate the sun(s).
IN	gas_scattering_do	(Index)	Flag to activate gas scattering.
IN	jacobian_do	(Index)	Flag to activate (clear-sky) Jacobian calculations.
IN	jacobian_quantities	(ArrayOfRetrievalQuantity)	The retrieval quantities in the Jacobian matrix.
IN	suns	(ArrayOfSun)	Array of Sun.
IN	rte_alonglos_v	(Numeric)	Velocity along the line-of-sight to consider for a RT calculation.
IN	iy_unit	(String)	Selection of output unit for radiative transfer methods.
IN	propmat_clearsky_agenda	(Agenda)	Agenda calculating the absorption coefficient matrices.
IN	water_p_eq_agenda	(Agenda)	Agenda to calculate the saturation pressure of water.
IN	gas_scattering_agenda	(Agenda)	Agenda calculating gas scattering extinction and phase matrix.
IN	ppath_step_agenda	(Agenda)	Agenda calculating a propagation path step.