Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

CloudMicrophysics.jl

Provides a library of cloud microphysics and aerosol parameterizations for the CliMA Earth System Model.
https://github.com/clima/cloudmicrophysics.jl

Category: Atmosphere
Sub Category: Atmospheric Chemistry and Aerosol

Keywords from Contributors

climate data-assimilation land-surface-model land climate-change atmospheric-sciences smoluchowski particle-simulation particle-in-cell condensation

Last synced: about 22 hours ago
JSON representation

Repository metadata

A library of cloud microphysics parameterizations

README.md

CloudMicrophysics.jl

CloudMicrophysics.jl provides a library of cloud microphysics and aerosol parameterizations for the CliMA Earth System Model. It implements bulk microphysics schemes for cloud formation, precipitation, and aerosol processes, designed for high-performance climate simulations.
Documentation click here ➡️ dev
Docs Build docs build
GHA CI gha ci
Code Coverage codecov
Downloads Downloads

Quick Start

Installation

using Pkg
Pkg.add("CloudMicrophysics")
Pkg.add("ClimaParams")

Basic Usage

import CloudMicrophysics as CM
import CloudMicrophysics.Microphysics1M as CM1
import CloudMicrophysics.Parameters as CMP

# Create microphysics parameters
rain = CMP.Rain(Float64)
vel = CMP.Blk1MVelType(Float64).rain

# Compute rain terminal velocity
ρ = 1.2      # air density [kg/m³]
q_rai = 1e-3 # rain specific content [kg/kg]
v_term = CM1.terminal_velocity(rain, vel, ρ, q_rai)

Running tests locally

# Load additional packages needed for tests
julia --project=test

# Enter Package Manager and develop locally
julia>]
pkg> dev .
pkg> instantiate

# Run the tests
julia> include("test/runtests.jl")

Key Features

🌧️ Bulk Microphysics Schemes

  • 0-moment scheme: Simple precipitation removal
  • 1-moment scheme: Marshall-Palmer distributions for rain and snow
  • 2-moment scheme: Seifert & Beheng (2006) with mass and number concentration
  • P3 scheme: Predicted particle properties for ice

🧊 Ice Nucleation

💨 Aerosol Processes

  • Aerosol activation: Abdul-Razzak & Ghan (2000) parameterization
  • Aerosol nucleation: H₂SO₄ and organic nucleation pathways
  • Aerosol model: Modal distributions with κ-Köhler theory

⚡ High Performance

  • Type-stable and GPU-compatible (CUDA.jl, AMDGPU.jl)
  • AD-compatible (ForwardDiff.jl) for differentiable physics
  • Optimized for minimal allocations

Documentation

Integration with Climate Models

CloudMicrophysics.jl is used throughout the CliMA ecosystem:

Getting Help

For questions, check the documentation or open an issue on GitHub.

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 3 days ago

Total Commits: 467
Total Committers: 38
Avg Commits per committer: 12.289
Development Distribution Score (DDS): 0.582

Commits in past year: 136
Committers in past year: 16
Avg Commits per committer in past year: 8.5
Development Distribution Score (DDS) in past year: 0.654

Name Email Commits
Anna Jaruga a****a@c****u 195
amylu00 a****3@c****u 59
Haakon Ludvig Langeland Ervik 4****e 49
Charles Kawczynski k****s@g****m 27
nefrathenrici n****i@g****m 23
Tapio Schneider t****o@c****u 14
Sajjad Azimi a****i@c****u 13
Anastasia Popova a****a@c****u 11
Caterina Croci c****c@g****m 9
Gabriele Bozzola g****a@c****u 7
sriharshakandala s****s@g****m 6
Olivia Alcabes o****s@r****m 4
Gregory L. Wagner g****r@g****m 4
Mikhail Mints m****s@L****n 3
CompatHelper Julia c****y@j****g 3
Olivia Alcabes 5****s 3
Emily de Jong 6****h 3
Julia Sloan j****n@c****u 3
Kaitlyn Alphonse k****e@e****m 3
Rowan Orlijan-Rhyne r****1@s****u 3
Sylwester Arabas s****s@a****l 2
apoorva-thanvantri a****i@g****m 2
dependabot[bot] 4****] 2
Jake Bolewski j****i@g****m 2
Agnieszka Makulska a****a@s****l 2
Valeria Barra 3****a 2
Rowan Orlijan-Rhyne r****n@R****e 2
ray-chew c****w@c****u 1
Caterina Croci c****i@C****l 1
Kaitlyn Alphonse k****e@e****l 1
and 8 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 5 days ago

Total issues: 151
Total pull requests: 709
Average time to close issues: 3 months
Average time to close pull requests: 12 days
Total issue authors: 17
Total pull request authors: 31
Average comments per issue: 1.19
Average comments per pull request: 2.02
Merged pull request: 477
Bot issues: 1
Bot pull requests: 68

Past year issues: 16
Past year pull requests: 147
Past year average time to close issues: 11 days
Past year average time to close pull requests: 4 days
Past year issue authors: 4
Past year pull request authors: 13
Past year average comments per issue: 0.31
Past year average comments per pull request: 1.35
Past year merged pull request: 96
Past year bot issues: 1
Past year bot pull requests: 16

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/clima/cloudmicrophysics.jl

Top Issue Authors

  • trontrytel (93)
  • haakon-e (19)
  • amylu00 (12)
  • nefrathenrici (7)
  • sriharshakandala (3)
  • rorlija1 (3)
  • charleskawczynski (3)
  • claresinger (2)
  • oalcabes (1)
  • AllThingsDynamical (1)
  • valeriabarra (1)
  • github-actions[bot] (1)
  • simonbyrne (1)
  • edejong-caltech (1)
  • JuliaTagBot (1)

Top Pull Request Authors

  • trontrytel (245)
  • amylu00 (118)
  • haakon-e (71)
  • github-actions[bot] (36)
  • dependabot[bot] (32)
  • nefrathenrici (31)
  • rorlija1 (28)
  • anastasia-popova (25)
  • crocicc (19)
  • oalcabes (19)
  • sajjadazimi (16)
  • Sbozzolo (13)
  • charleskawczynski (11)
  • edejong-caltech (8)
  • sriharshakandala (6)

Top Issue Labels

  • P3 (23)
  • enhancement (20)
  • Ice :snowman: (20)
  • Parcel (13)
  • Aerosol :circus_tent: (12)
  • SDI (12)
  • GPU (11)
  • documentation (10)
  • tests (8)
  • parameters :bricks: (7)
  • Aerosol Activation :bulb: (6)
  • :heavy_multiplication_x: on_hold (5)
  • Terminal velocity (4)
  • refactor :star2: (4)
  • packages 🍱 (4)
  • good first issue (2)
  • bug (2)
  • tagbot-manual (1)
  • ci (1)
  • bikeshedding :bike: :house: (1)
  • question (1)
  • Approved :four_leaf_clover: (1)
  • Radiation :sun_with_face: (1)

Top Pull Request Labels

  • Approved :four_leaf_clover: (110)
  • P3 (74)
  • Ice :snowman: (50)
  • needs review (41)
  • packages 🍱 (40)
  • dependencies (35)
  • Parcel (32)
  • documentation (31)
  • ci (28)
  • parameters :bricks: (26)
  • enhancement (25)
  • tests (19)
  • GPU (14)
  • Aerosol Activation :bulb: (13)
  • bikeshedding :bike: :house: (12)
  • Terminal velocity (11)
  • github_actions (10)
  • refactor :star2: (8)
  • bugfix (6)
  • Aerosol :circus_tent: (6)
  • work-in-progress (6)
  • NonEq 💧🧊 (5)
  • :heavy_multiplication_x: on_hold (3)
  • Radiation :sun_with_face: (2)
  • CI tests & docs (2)
  • Dependencies 🍱 (1)
  • Launch Buildkite (1)
  • :heavy_multiplication_x: On_hold (1)

Dependencies

.github/workflows/CodeCov.yml actions
  • actions/checkout v2.2.0 composite
  • codecov/codecov-action v1.0.7 composite
  • julia-actions/setup-julia latest composite
.github/workflows/CompatHelper.yml actions
.github/workflows/DocCleanup.yml actions
  • actions/checkout v2 composite
.github/workflows/JuliaFormatter.yml actions
  • actions/checkout v2.2.0 composite
  • dorny/paths-filter v2.9.1 composite
  • julia-actions/setup-julia latest composite
  • styfle/cancel-workflow-action 0.4.0 composite
.github/workflows/TagBot.yml actions
  • JuliaRegistries/TagBot v1 composite
.github/workflows/ci.yml actions
  • actions/cache v1 composite
  • actions/checkout v2 composite
  • codecov/codecov-action v1 composite
  • julia-actions/julia-buildpkg v1 composite
  • julia-actions/julia-processcoverage v1 composite
  • julia-actions/julia-runtest v1 composite
  • julia-actions/setup-julia v1 composite
.github/workflows/docs.yml actions
  • actions/checkout v2 composite
  • julia-actions/setup-julia latest composite

Score: 8.044305406990638