ARTS built-in documentation server
Workspace Method iyTransmissionStandard
Description
Standard method for handling (direct) transmission measurements. Designed to be part of iy_main_agenda. Treatment of the cloudbox is incorporated (that is, no need to define iy_cloudbox_agenda). In short, the propagation path is followed until the surface or space is reached. At this point iy_transmitter_agenda is called and the radiative transfer calculations start. That is, the result of the method (iy) is the output of iy_transmitter_agenda multiplied with th transmission from the sensor to either the surface or space. The following auxiliary data can be obtained: "Pressure": The pressure along the propagation path. Size: [1,1,1,np]. "Temperature": The temperature along the propagation path. Size: [1,1,1,np]. "VMR, species X": VMR of the species with index X (zero based). For example, adding the string "VMR, species 0" extracts the VMR of the first species. Size: [1,1,1,np]. "Absorption, summed": The total absorption matrix along the path. Size: [nf,ns,ns,np]. "Absorption, species X": The absorption matrix along the path for an individual species (X works as for VMR). Size: [nf,ns,ns,np]. "Particle extinction, summed": The total particle extinction matrix along the path. Size: [nf,ns,ns,np]. "PND, type X": The particle number density for particle type X (ie. corresponds to book X in pnd_field). Size: [1,1,1,np]. "Mass content, X": The particle content for mass category X. This corresponds to column X in particle_masses (zero- based indexing). Size: [1,1,1,np]. * "Radiative background": Index value flagging the radiative background. The following coding is used: 0=space, 1=surface and 2=cloudbox. Size: [nf,1,1,1]. "iy": The radiance at each point along the path. Size: [nf,ns,1,np]. "Transmission": The transmission matrix from the surface or space, to each propagation path point. The matrix is valid for the photon direction. Size: [nf,ns,ns,np]. * "Optical depth": The scalar optical depth between the observation point and the end of the primary propagation path (ie. the optical depth to the surface or space.). Calculated in a pure scalar manner, and not dependent on direction. Size: [nf,1,1,1]. * "Faraday rotation": Total rotation [deg] along the path, for each frequency. Size: [nf,1,1,1]. * "Faraday speed": The rotation per length unit [deg/m], at each path point and each frequency. Size: [nf,1,1,np]. where nf: Number of frequencies. ns: Number of Stokes elements. np: Number of propagation path points. The auxiliary data are returned in iy_aux with quantities selected by iy_aux_vars. Most variables require that the method is called directly or by iyCalc. For calculations using yCalc, the selection is restricted to the variables marked with *.
Authors: Patrick Eriksson
Synopsis
Variables
OUT | iy | (Matrix) | Monochromatic pencil beam radiance spectrum. |
OUT | iy_aux | (ArrayOfTensor4) | Data auxiliary to iy. |
OUT | ppath | (Ppath) | The propagation path for one line-of-sight. |
OUT | diy_dx | (ArrayOfTensor3) | Derivative of iy with respect to retrieval quantities. |
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 | z_field | (Tensor3) | The field of geometrical altitudes. |
IN | t_field | (Tensor3) | The field of atmospheric temperatures. |
IN | vmr_field | (Tensor4) | VMR field. |
IN | abs_species | (ArrayOfArrayOfSpeciesTag) | Tag groups for scalar 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 | cloudbox_on | (Index) | Flag to activate the cloud box. |
IN | cloudbox_limits | (ArrayOfIndex) | The limits of the cloud box. |
IN | pnd_field | (Tensor4) | Particle number density field. |
IN | use_mean_scat_data | (Index) | Flag to use same scattering properties for all frequencies. |
IN | scat_data_array | (ArrayOfSingleScatteringData) | Raw data of single scattering data. |
IN | particle_masses | (Matrix) | The mass of individual particles (or bulks). |
IN | iy_aux_vars | (ArrayOfString) | Selection of quantities for iy_aux and when applicable also y_aux. |
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. |
IN | ppath_agenda | (Agenda) | See agendas.cc. |
IN | propmat_clearsky_agenda | (Agenda) | See agendas.cc. |
IN | iy_transmitter_agenda | (Agenda) | See agendas.cc. |
IN | iy_agenda_call1 | (Index) | Flag to handle recursive calls of iy_main_agenda The agenda iy_main_agenda can be used recursively and this flag is used to tell the methods inside the agenda which is the primary call. |
IN | iy_transmission | (Tensor3) | Transmission to be included in iy. |
IN | rte_pos | (Vector) | A geographical position for starting radiative transfer calculations. |
IN | rte_los | (Vector) | A line-of-sight for (complete) radiative transfer calculations. |
IN | rte_pos2 | (Vector) | A second geographical position to define the geometry for radiative transfer calculations. |
IN | rte_alonglos_v | (Numeric) | Velocity along the line-of-sight to consider for a RT calculation. |
IN | ppath_lraytrace | (Numeric) | Maximum length of ray tracing steps when determining propagation paths. |