ARTS built-in documentation server
Workspace Method cloudbox_checkedCalc
Description
Checks consistency and validity of the cloudbox governing variables. The following WSVs are treated: cloudbox_on, cloudbox_limits, pnd_field, scat_data, scat_species, abs_species, particle_masses particle_bulkprop_field, particle_bulkprop_names and wind_u/v/w_field. If any of these variables is changed, then this method shall be called again (no automatic check that this is fulfilled!). The main checks are if the cloudbox limits are OK with respect to the atmospheric dimensionality and the limits of the atmosphere, and that the scattering element variables pnd_field and scat_data match in size. Further checks on scat_data are performed in scat_data_checkedCalc scat_species and particle_masses must either be empty or have a size that matches the other data. If non-empty, some check of these variables are performed. If any test fails, there is an error. Otherwise, cloudbox_checked is set to 1.
Authors: Patrick Eriksson, Jana Mendrok
Synopsis
| cloudbox_checkedCalc( | cloudbox_checked, atmfields_checked, atmosphere_dim, p_grid, lat_grid, lon_grid, z_field, z_surface, wind_u_field, wind_v_field, wind_w_field, cloudbox_on, cloudbox_limits, pnd_field, dpnd_field_dx, jacobian_quantities, scat_data, scat_species, particle_masses, abs_species, negative_pnd_ok ) |
Variables
| OUT | cloudbox_checked | (Index) | OK-flag for variables associated with the cloudbox. |
| IN | atmfields_checked | (Index) | OK-flag for atmospheric grids and (physical) fields. |
| 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 | z_surface | (Matrix) | The surface altitude. |
| 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 | 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 | dpnd_field_dx | (ArrayOfTensor4) | Partial derivatives of pnd_field. |
| IN | jacobian_quantities | (ArrayOfRetrievalQuantity) | The retrieval quantities in the Jacobian matrix. |
| IN | scat_data | (ArrayOfArrayOfSingleScatteringData) | Array of single scattering data. |
| IN | scat_species | (ArrayOfString) | Array of Strings defining the scattering species to consider. |
| IN | particle_masses | (Matrix) | The mass of individual particles (or bulks). |
| IN | abs_species | (ArrayOfArrayOfSpeciesTag) | Tag groups for gas absorption. |
| GIN | negative_pnd_ok | (Index, Default: 0) | Flag whether to accept pnd_field < 0. |