ARTS built-in documentation server

Workspace Method MCRadar

Description

A radar 3D foward Monte Carlo radiative algorithm, that allows 
for 2D antenna patterns and arbitrary sensor positions.
Surface reflections are currently ignored.

The main output variable y and mc_error represent the
radar reflectivity integrated over the antenna function, and the
estimated error in this vector, respectively.

Unlike with yRadar, the range bins gives the boundaries of 
the range bins as either round-trip time or distance from radar.

The WSV mc_y_tx gives the polarization state of the 
transmitter.

The WSV mc_max_scatorder prescribes the maximum scattering 
order to consider, after which `photon'-tracing will be
terminated. A value of one calculates only single scattering.

The WSV mc_max_iter describes the maximum number of `photons'
used in the simulation (more photons means smaller mc_error).
The method will terminate once the max_iter criterium is met.
If negative values are given for these parameters then it is
ignored.

Here "1" and "Ze" are the allowed options for iy_unit_radar.
The value of mc_error follows the selection for iy_unit_radar
(both for in- and output. See yRadar for details of the units.

Authors: Ian S. Adams

Synopsis

MCRadar( y, mc_error, mc_antenna, f_grid, f_index, sensor_pos, sensor_los, stokes_dim, atmosphere_dim, ppath_lmax, ppath_step_agenda, ppath_lraytrace, propmat_clearsky_agenda, p_grid, lat_grid, lon_grid, z_field, refellipsoid, z_surface, t_field, vmr_field, cloudbox_on, cloudbox_limits, pnd_field, scat_data, mc_y_tx, range_bins, atmfields_checked, atmgeom_checked, scat_data_checked, cloudbox_checked, iy_unit_radar, mc_max_scatorder, mc_seed, mc_max_iter, ze_tref, k2, t_interp_order )

Variables

OUTy(Vector)The measurement vector.
OUTmc_error(Vector)Error in simulated y when using a Monte Carlo approach.
INmc_antenna(MCAntenna)Antenna pattern description for dedicated MC calculaions.
INf_grid(Vector)The frequency grid for monochromatic pencil beam calculations.
INf_index(Index)Frequency index.
INsensor_pos(Matrix)The sensor position for each measurement block.
INsensor_los(Matrix)The sensor line-of-sight (LOS) for each measurement block.
INstokes_dim(Index)The dimensionality of the Stokes vector (1-4).
INatmosphere_dim(Index)The atmospheric dimensionality (1-3).
INppath_lmax(Numeric)Maximum length between points describing propagation paths.
INppath_step_agenda(Agenda)Agenda calculating a propagation path step.
INppath_lraytrace(Numeric)Maximum length of ray tracing steps when determining propagation paths.
INpropmat_clearsky_agenda(Agenda)Agenda calculating the absorption coefficient matrices.
INp_grid(Vector)The pressure grid.
INlat_grid(Vector)The latitude grid.
INlon_grid(Vector)The longitude grid.
INz_field(Tensor3)The field of geometrical altitudes.
INrefellipsoid(Vector)Reference ellipsoid.
INz_surface(Matrix)The surface altitude.
INt_field(Tensor3)The field of atmospheric temperatures.
INvmr_field(Tensor4)VMR field.
INcloudbox_on(Index)Flag to activate the cloud box.
INcloudbox_limits(ArrayOfIndex)The limits of the cloud box.
INpnd_field(Tensor4)Particle number density field.
INscat_data(ArrayOfArrayOfSingleScatteringData)Array of single scattering data.
INmc_y_tx(Vector)Normalized Stokes vector for transmittance (e.g., radar).
INrange_bins(Vector)The range bins of an active instrument.
INatmfields_checked(Index)OK-flag for atmospheric grids and (physical) fields.
INatmgeom_checked(Index)OK-flag for the geometry of the model atmosphere.
INscat_data_checked(Index)OK-flag for scat_data.
INcloudbox_checked(Index)OK-flag for variables associated with the cloudbox.
INiy_unit_radar(String)Unit for radar simulations.
INmc_max_scatorder(Index)The maximum scattering order allowed for Monte Carlo radar calculations.
INmc_seed(Index)The integer seed for the random number generator used by Monte Carlo methods.
INmc_max_iter(Index)The maximum number of iterations allowed for Monte Carlo calculations.
GINze_tref(Numeric, Default: 273.15)Reference temperature for conversion to Ze.
GINk2(Numeric, Default: -1)Reference dielectric factor.
GINt_interp_order(Index, Default: 1)Interpolation order of temperature for scattering data (so far only applied in phase matrix, not in extinction and absorption.