Atmosphere components of the CliMA software stack.
ClimaAtmos.jl is the atmosphere components of the CliMA software stack. We strive for a user interface that makes ClimaAtmos.jl as friendly and intuitive to use as possible, allowing users to focus on the science.
Condensed water path from a global simulation using diagnostic EDMF and 0M microphysics, initialized with ERA5 on 8-31-25 00Z. Output every 30 minutes; ran for ~4 days.
Recommended Julia: Stable release v1.11.6
ClimaAtmos.jl is a registered Julia package. To install
julia> using Pkg
julia> Pkg.add("ClimaAtmos")Alternatively, download the ClimaAtmos
source with:
$ git clone https://github.com/CliMA/ClimaAtmos.jl.git
Now change into the ClimaAtmos.jl directory with
$ cd ClimaAtmos.jl
To use ClimaAtmos, you need to instantiate all dependencies with:
$ julia --project
julia> ]
(ClimaAtmos) pkg> instantiate
Currently, the simulations are stored in the test folder. Run all the test cases with the following commands.
First, launch Julia from the ClimaAtmos.jl/ directory with the project active:
$ julia --project
Then, in the Julia REPL, switch to the package manager by pressing ] and run the tests:
(ClimaAtmos) pkg> test
Or run from the command line:
$ julia --project -e 'using Pkg; Pkg.test()'
If you run into issues when running the test suite this way, please open an issue.
If you're interested in contributing to the development of ClimaAtmos we want your help no matter how big or small a contribution you make! It's always great to have new people look at the code with fresh eyes: you will see errors that other developers have missed.
Let us know by opening an issue if you'd like to work on a new feature.
Here is the rule of thumb coding style and unicode usage restrictions.
For more information, check out our contributor's guide.