Microphysics
ClimateMachine.Microphysics
— ModuleOne-moment bulk microphysics scheme, which includes:
- terminal velocity of precipitation
- condensation and evaporation of cloud liquid water and deposition and sublimation of cloud ice (relaxation to equilibrium)
- autoconversion of cloud liquid water into rain and of cloud ice into snow
- accretion due to collisions between categories of condensed species
- evaporation and sublimation of hydrometeors
- melting of snow into rain
Methods
ClimateMachine.Microphysics.v0_rai
— Functionv0_rai(param_set, ρ)
param_set
- abstract set with earth parametersρ
air density
Returns the proportionality coefficient in terminal velocity(r/r0).
ClimateMachine.Microphysics.n0_sno
— Functionn0_sno(snow_param_set, q_sno, ρ)
snow_param_set
- abstract set with snow parametersq_sno
- snow specific humidityρ
- air density
Returns the intercept parameter of the assumed Marshall-Palmer distribution of snow particles.
ClimateMachine.Microphysics.τ_relax
— Functionτ_relax(liquid_param_set)
τ_relax(ice_param_set)
liquid_param_set
- abstract set with cloud liquid water parametersice_param_set
- abstract set with cloud ice parameters
Returns the relaxation timescale for condensation and evaporation of cloud liquid water or the relaxation timescale for sublimation and deposition of cloud ice.
ClimateMachine.Microphysics.lambda
— Functionlambda(q, ρ, n0, m0, me, r0, χm, Δm)
q
- specific humidity of rain, ice or snowρ
- air densityn0
- size distribution parameterm0
,me
,χm
,Δm
,r0
- mass(radius) parameters
Returns the rate parameter of the assumed size distribution of particles (rain drops, ice crystals, snow crystals).
ClimateMachine.Microphysics.unpack_params
— Functionunpack_params(param_set, microphysics_param_set, ρ, q_)
param_set
- abstract set with earth parametersmicrophysics_param_set
- abstract set with microphysics parametersq_
- specific humidityρ
- air density
Utility function that unpacks microphysics parameters.
ClimateMachine.Microphysics.G_func
— FunctionG_func(param_set, T, Liquid())
G_func(param_set, T, Ice())
param_set
- abstract set with earth parametersT
- air temperatureLiquid()
,Ice()
- liquid or ice phase to dispatch over.
Utility function combining thermal conductivity and vapor diffusivity effects.
ClimateMachine.Microphysics.terminal_velocity
— Functionterminal_velocity(param_set, precip_param_set, ρ, q_)
param_set
- abstract set with earth parametersprecip_param_set
- abstract set with rain or snow parametersρ
- air densityq_
- rain or snow specific humidity
Returns the mass weighted average terminal velocity assuming a Marshall-Palmer (1948) distribution of rain drops and snow crystals.
ClimateMachine.Microphysics.conv_q_vap_to_q_liq_ice
— Functionconv_q_vap_to_q_liq_ice(liquid_param_set::ALPS, q_sat, q)
conv_q_vap_to_q_liq_ice(ice_param_set::AIPS, q_sat, q)
liquid_param_set
- abstract set with cloud water parametersice_param_set
- abstract set with cloud ice parametersq_sat
- PhasePartition at equilibriumq
- current PhasePartition
Returns the cloud water tendency due to condensation and evaporation or cloud ice tendency due to sublimation and vapor deposition. The tendency is obtained assuming a relaxation to equilibrium with a constant timescale.
ClimateMachine.Microphysics.conv_q_liq_to_q_rai
— Functionconv_q_liq_to_q_rai(rain_param_set, q_liq)
rain_param_set
- abstract set with rain microphysics parametersq_liq
- liquid water specific humidity
Returns the q_rai tendency due to collisions between cloud droplets (autoconversion), parametrized following Kessler (1995).
ClimateMachine.Microphysics.conv_q_ice_to_q_sno
— Functionconv_q_ice_to_q_sno(param_set, ice_param_set, q, ρ, T)
param_set
- abstract set with earth parametersice_param_set
- abstract set with ice microphysics parametersq
- phase partitionρ
- air densityT
- air temperature
Returns the q_sno tendency due to autoconversion from ice. Parameterized following Harrington et al. (1996) and Kaul et al. (2015).
ClimateMachine.Microphysics.accretion
— Functionaccretion(param_set, cloud_param_set, precip_param_set, q_clo, q_pre, ρ)
param_set
- abstract set with earth parameterscloud_param_set
- abstract set with cloud water or cloud ice parametersprecip_param_set
- abstract set with rain or snow parametersq_clo
- cloud water or cloud ice specific humidityq_pre
- rain water or snow specific humidityρ
- rain water or snow specific humidity
Returns the sink of cloud water (liquid or ice) due to collisions with precipitating water (rain or snow).
ClimateMachine.Microphysics.accretion_rain_sink
— Functionaccretion_rain_sink(param_set, ice_param_set, rain_param_set,
q_ice, q_rai, ρ)
param_set
- abstract set with earth parametersice_param_set
- abstract set with cloud ice parametersrain_param_set
- abstract set with rain parametersq_ice
- cloud ice specific humidityq_rai
- rain water specific humidityρ
- air density
Returns the sink of rain water (partial source of snow) due to collisions with cloud ice.
ClimateMachine.Microphysics.accretion_snow_rain
— Functionaccretion_snow_rain(param_set, i_param_set, j_param_set, q_i, q_j, ρ)
i
- snow for temperatures below freezing or rain for temperatures above freezingj
- rain for temperatures below freezing or rain for temperatures above freezingparam_set
- abstract set with earth parametersi_param_set
,j_param_set
- abstract set with snow or rain microphysics parametersq_
- specific humidity of snow or rainρ
- air density
Returns the accretion rate between rain and snow. Collisions between rain and snow result in snow at temperatures below freezing and in rain at temperatures above freezing.
ClimateMachine.Microphysics.evaporation_sublimation
— Functionevaporation_sublimation(param_set, rain_param_set, q, q_rai, ρ, T)
evaporation_sublimation(param_set, snow_param_set, q, q_sno, ρ, T)
param_set
- abstract set with earth parametersrain_param_set
- abstract set with rain microphysics parameterssnow_param_set
- abstract set with snow microphysics parametersq
- phase partitionq_rai
- rain specific humidityq_sno
- snow specific humidityρ
- air densityT
- air temperature
Returns the tendency due to rain evaporation or snow sublimation.
ClimateMachine.Microphysics.snow_melt
— Functionsnow_melt(param_set, snow_param_set, q_sno, ρ, T)
param_set
- abstract set with earth parameterssnow_param_set
- abstract set with snow microphysics parametersq_sno
- snow water specific humidityρ
- air densityT
- air temperature
Returns the tendency due to snow melt.