pyradtran.clouds.CloudLayer#

class pyradtran.clouds.CloudLayer(z_bottom_km: float, z_top_km: float, lwc_g_m3: float = 0.0, iwc_g_m3: float = 0.0, r_eff_um: float = 10.0, cloud_fraction: float = 1.0)[source]#

Bases: object

A single cloud layer with vertical extent and microphysical properties.

CloudLayer is a validated data container. It is not written to disk directly — pass a list of layers to CloudFileWriter instead.

Parameters:
  • z_bottom_km (float) – Bottom altitude of the layer in km above sea level.

  • z_top_km (float) – Top altitude of the layer in km above sea level. Must be greater than z_bottom_km.

  • lwc_g_m3 (float, default 0.0) – Liquid water content in g m⁻³.

  • iwc_g_m3 (float, default 0.0) – Ice water content in g m⁻³.

  • r_eff_um (float, default 10.0) – Effective droplet / crystal radius in µm.

  • cloud_fraction (float, default 1.0) – Cloud fraction (0–1).

Raises:

ValueError – If z_bottom_km >= z_top_km, water content is negative, effective radius is non-positive, or cloud fraction is outside [0, 1].

Examples

>>> layer = CloudLayer(z_bottom_km=1.0, z_top_km=2.0, lwc_g_m3=0.3)
>>> layer.r_eff_um
10.0

See also

CloudGenerator.from_simple_parameters

Build layers from basic numbers.

CloudGenerator.from_era5_dataset

Build layers from ERA5 reanalysis.

__init__(z_bottom_km: float, z_top_km: float, lwc_g_m3: float = 0.0, iwc_g_m3: float = 0.0, r_eff_um: float = 10.0, cloud_fraction: float = 1.0) None#
cloud_fraction: float = 1.0#
iwc_g_m3: float = 0.0#
lwc_g_m3: float = 0.0#
r_eff_um: float = 10.0#
z_bottom_km: float#
z_top_km: float#