ARTS built-in documentation server

Workspace Method cloudboxSetAutomatically

Description

Sets the cloud box to encompass the cloud given by the entries
in ``particle_field``.

This WSM handles one Tensor4 type ``particle_field`` at a time. It can
be used to determine the cloudbox from particle_bulkprop_field

The function must be called before executing any WSM that applies
cloudbox_limits.

The function iterates over all 3D fields in ``particle_field`` (which
might correspond to different particle bulk properties as in
particle_bulkprop_field). Each field is searched for the first
and last pressure index, where the value is unequal to zero. This
index is then copied to cloudbox_limits.
If ``particle_field`` is empty, the cloudbox is switched off
(cloudbox_on = 0).

Additionaly the lower cloudbox_limit is altered by ``cloudbox_margin``.
The margin is given as a height difference in meters and transformed
into a pressure (via isothermal barometric height formula). This
alteration is to ensure covering photons that leave the cloud, but
reenter through a limb path.
If ``cloudbox_margin`` is set to -1 (default), the cloudbox will extend
to the surface. Hence, the lower cloudbox_limit is set to 0 (index
of first pressure level).
``cloudbox_margin`` will be applied on each call of the WSM.

Works only for atmosphere_dim == 1.

Authors: Jana Mendrok, Daniel Kreyling

Synopsis

cloudboxSetAutomatically( cloudbox_on, cloudbox_limits, atmosphere_dim, p_grid, lat_grid, lon_grid, particle_field, cloudbox_margin )

Variables

OUTcloudbox_on(Index)Flag to activate the cloud box.
OUTcloudbox_limits(ArrayOfIndex)The limits of the cloud box.
INatmosphere_dim(Index)The atmospheric dimensionality (1-3).
INp_grid(Vector)The pressure grid.
INlat_grid(Vector)The latitude grid.
INlon_grid(Vector)The longitude grid.
GINparticle_field(Tensor4)A collection of particle property fields (e.g. particle_bulkprop_field).
GINcloudbox_margin(Numeric, Default: -1)Minimum distance [m] between lowest 'cloudy' level and cloudbox lower limit. If set to ``-1`` (default), the cloudbox lower limit is fixed to 0, i.e., corresponds to the lowest atmospheric level (or the surface).