ARTS built-in documentation server

Workspace Method DisortCalcWithARTSSurface

Description

Interface to the DISORT scattering solver (by Stamnes et al.).

THIS VERSION INCLUDES DIRECT SOURCE!
DEVELOPMENT VERSION!
As DisortCalc but uses surface_rtprop_agenda.

The Lambertian surface reflection is set by surface_rtprop_agenda.
If the GIN inc_angle is inside of the range [0,90], the reflection is
set according to the result of surface_rtprop_agenda for this incidence
angle. Otherwise (default) is to call surface_rtprop_agenda for
multiple angles, to estimate the hemispheric mean value.

Authors: Claudia Emde, Jana Mendrok, Manfred Brath

Synopsis

DisortCalcWithARTSSurface(

cloudbox_field, optical_depth, atmfields_checked, atmgeom_checked, scat_data_checked, cloudbox_checked, cloudbox_on, cloudbox_limits, propmat_clearsky_agenda, surface_rtprop_agenda, gas_scattering_agenda, atmosphere_dim, pnd_field, t_field, z_field, vmr_field, p_grid, lat_true, lon_true, refellipsoid, scat_data, stars, f_grid, za_grid, aa_grid, stokes_dim, z_surface, gas_scattering_do, stars_do, nstreams, Npfct, quiet, emission, intensity_correction, inc_angle )

Variables

OUT	cloudbox_field	(Tensor7)	The spectral radiance field inside the cloudbx.
OUT	optical_depth	(Matrix)	optical depth This vector holds optical depth in frequency and layer.
IN	atmfields_checked	(Index)	OK-flag for atmospheric grids and (physical) fields.
IN	atmgeom_checked	(Index)	OK-flag for the geometry of the model atmosphere.
IN	scat_data_checked	(Index)	OK-flag for scat_data.
IN	cloudbox_checked	(Index)	OK-flag for variables associated with the cloudbox.
IN	cloudbox_on	(Index)	Flag to activate the cloud box.
IN	cloudbox_limits	(ArrayOfIndex)	The limits of the cloud box.
IN	propmat_clearsky_agenda	(Agenda)	Agenda calculating the absorption coefficient matrices.
IN	surface_rtprop_agenda	(Agenda)	Agenda providing radiative properties of the surface.
IN	gas_scattering_agenda	(Agenda)	Agenda calculating gas scattering extinction and phase matrix.
IN	atmosphere_dim	(Index)	The atmospheric dimensionality (1-3).
IN	pnd_field	(Tensor4)	Particle number density field.
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	p_grid	(Vector)	The pressure grid.
IN	lat_true	(Vector)	Latitudinal geolocation for 1D and 2D data.
IN	lon_true	(Vector)	Longitudinal geolocation for 1D and 2D data.
IN	refellipsoid	(Vector)	Reference ellipsoid.
IN	scat_data	(ArrayOfArrayOfSingleScatteringData)	Array of single scattering data.
IN	stars	(ArrayOfStar)	Array of Star.
IN	f_grid	(Vector)	The frequency grid for monochromatic pencil beam calculations.
IN	za_grid	(Vector)	Zenith angle grid.
IN	aa_grid	(Vector)	Azimuthal angle grid.
IN	stokes_dim	(Index)	The dimensionality of the Stokes vector (1-4).
IN	z_surface	(Matrix)	The surface altitude.
IN	gas_scattering_do	(Index)	Flag to activate gas scattering.
IN	stars_do	(Index)	Flag to activate the star(s).
GIN	nstreams	(Index, Default: 8)	Number of polar angle directions (streams) in DISORT solution (must be an even number).
GIN	Npfct	(Index, Default: 181)	Number of angular grid points to calculate bulk phase function on (and derive Legendre polynomials from). If <0, the finest za_grid from scat_data will be used.
GIN	quiet	(Index, Default: 0)	Silence C Disort warnings.
GIN	emission	(Index, Default: 1)	Enables blackbody emission. Set to zero, if no Emission e. g. like in visible regime for earth is needed
GIN	intensity_correction	(Index, Default: 1)	Enables intensity correction. Importantant for low number of streams. Set to zero, if problems encounter or using a high number of streams (>30)
GIN	inc_angle	(Numeric, Default: -1)	Incidence angle, see above.