ARTS built-in documentation server

Workspace Method sensor_responseAntenna

Description

Includes response of the antenna.

The function returns the sensor response matrix after the antenna
characteristics have been included.

The function handles "multi-beam" cases where the polarisation
coordinate system is the same for all beams.

See antenna_dim, antenna_dlos and antenna_response for
details on how to specify the antenna response.

The text below refers to mblock_dlos_grid despite it is not an
input to the method. The method instead uses sensor_response_dlos_grid
but the values in this WSV are likely coming from mblock_dlos_grid.

One dimensional antenna patterns are handled as other response
functions. That is, both antenna response and radiances are treated
as piece-wise linear functions, and the pencil beam calculations must
cover the full sensor response (i.e. mblock_dlos_grid must be
sufficiently broad).

There exist different options for two dimensional (2D) antenna patterns,
see below (if 2D, the GIN *option_2d* must be set, the default results
in an error). A normalisation is always applied for 2D antennas (i.e.
*sensor-norm* is ignored).

"interp_response"For this option, each direction defined by mblock_dlos_grid is
considered to represent the same size in terms of solid beam angle,
and the antenna pattern is interpolated to these directions. There is
no check on how well mblock_dlos_grid covers the antenna response.
The response is treated to be zero outside the ranges of its  anular
grids

"gridded_dlos"This option is more similar to the 1D case. The radiances are treated
as a bi-linear function, but the antenna response is treated as step-
wise constant function (in contrast to 1D). For this option
mblock_dlos_grid must match a combination of zenith and azimuth
grids, and this for a particular order. If the zenith and azimuth
grids have 3 and 2 values, respectively, the order shall be:
  [(za1,aa1); (za2,aa1); (za3,aa1); (za1,aa2); (za2,aa2); (za3,aa2) ]
Both these grids must be strictly increasing and as for 1D must cover
the antenna response completely.

Authors: Patrick Eriksson, Mattias Ekstrom

Synopsis

sensor_responseAntenna( sensor_response, sensor_response_f, sensor_response_pol, sensor_response_dlos, sensor_response_dlos_grid, sensor_response_f_grid, sensor_response_pol_grid, atmosphere_dim, antenna_dim, antenna_dlos, antenna_response, sensor_norm, option_2d )

Variables

OUT+INsensor_response(Sparse)The matrix modelling the total sensor response.
OUT+INsensor_response_f(Vector)The frequencies associated with the output of sensor_response.
OUT+INsensor_response_pol(ArrayOfIndex)The polarisation states associated with the output of sensor_response.
OUT+INsensor_response_dlos(Matrix)The relative zenith and azimuth angles associated with the output of sensor_response.
OUT+INsensor_response_dlos_grid(Matrix)The zenith and azimuth angles associated with sensor_response.
INsensor_response_f_grid(Vector)The frequency grid associated with sensor_response.
INsensor_response_pol_grid(ArrayOfIndex)The "polarisation grid" associated with sensor_response.
INatmosphere_dim(Index)The atmospheric dimensionality (1-3).
INantenna_dim(Index)The dimensionality of the antenna pattern (1-2).
INantenna_dlos(Matrix)The relative line-of-sight of each antenna pattern.
INantenna_response(GriddedField4)The antenna pattern/response.
INsensor_norm(Index)Flag if sensor response should be normalised or not (0 or 1).
GINoption_2d(String, Default: "-")Calculation option for 2D antenna cases. See above for details.