ICAR

A simplified atmospheric model designed primarily for climate downscaling, atmospheric sensitivity tests, and hopefully educational uses.
https://github.com/NCAR/icar

Category: Sustainable Development
Sub Category: Education

Keywords

climate downscaling icar netcdf precipitation regional-climate-model

Keywords from Contributors

coarrays

Last synced: about 10 hours ago
JSON representation

Repository metadata

The Intermediate Complexity Atmospheric Research model (ICAR)

README.md

The Intermediate Complexity Atmospheric Research Model (ICAR)

main
develop
Documentation Status

ICAR is a simplified atmospheric model designed primarily for climate downscaling, atmospheric sensitivity tests, and hopefully educational uses. ICAR combines an analytical solution for flow over mountains (linear mountain wave theory) with the large scale flow for a driving model to predict the high resolution wind field. It then advects and heat and moisture through the domain while computing cloud microphysical effects. ICAR has includes a land surface model as well for land atmosphere interactions; ICAR can simulate open water fluxes, PBL mixing, surface radiation, and even parameterized convection.

In ICAR 2.0 (currently early alpha), ICAR supports parallelization across hundreds of computing nodes (the basic physics have been shown to scale up to nearly 100,000 processors) using coarray fortran. This version of the code has a significant overhaul of the original code base, and as a result not all functionality has been restored yet.

Documentation is (slowly) being built on readthedocs and doxygen based documentation can be built now by running "make doc", and is available through github-pages.

Requirements

To run the model 3D time-varying atmospheric data are required, though an ideal test case can be generated for simple simulations as well. See "Running the Model" below. There are some sample python scripts to help make input forcing files, but the WRF pre-processing system can also be used. Low-resolution WRF output files can be used directly, various reanalysis and GCM output files can be used with minimal pre-processing (just get all the variables in the same netcdf file.) In addition, a high-resolution netCDF topography file is required. This will define the grid that ICAR will run on. Finally and ICAR options file is used to specify various parameters for the model. A sample options file is provided in the run/ directory.

To run ICAR on more than one compute node requires a fortran compiler that supports the use of coarrays. This includes ifort >= ~18, gfortran >= ~6.3 (with opencoarrays), and cray's fortran compiler. Note that ifort has often been extremely slow, cray's implementation is excellent but ICAR is not well tested with it, gfortran works very well, but some combinations of gfortran and opencoarrays may not work.

Developing

If you plan to make any major additions to ICAR, please get in touch, for minor changes feel free to just submit a pull request. The current workflow is to make changes and pull requests to the develop branch.

For an outline of the basic code structure see the ICAR code overview

For reference working with the model code and git, see the ICAR and Git workflow.

Reference

Gutmann, E. D., I. Barstad, M. P. Clark, J. R. Arnold, and R. M. Rasmussen (2016), The Intermediate Complexity Atmospheric Research Model, J. Hydrometeor, doi:10.1175/JHM-D-15-0155.1.


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 8 days ago

Total Commits: 1,528
Total Committers: 33
Avg Commits per committer: 46.303
Development Distribution Score (DDS): 0.168

Commits in past year: 5
Committers in past year: 1
Avg Commits per committer in past year: 5.0
Development Distribution Score (DDS) in past year: 0.0

Name Email Commits
Ethan Gutmann g****n@u****u 1271
Soren Rasmussen s****n@g****m 78
Bert Kruyt b****t@e****h 54
Bert Kruyt b****t@p****m 30
Trude Eidhammer t****e@u****u 20
Dylan Reynolds d****s@s****h 18
Johannes Horak j****k@t****g 8
Patrik Bohlinger p****3@u****o 6
Tom Enzminger e****r@c****u 5
Trude Eidhammer t****e@y****) 4
Damian Rouson d****n@s****g 3
Tom Enzminger e****r@c****u 3
Dylan Reynolds d****d@d****h 3
Dylan Reynolds 4****s 2
Patrik Bohlinger p****r@g****e 2
Tom Enzminger e****r@c****u 2
Tom Enzminger e****r@c****u 2
Dylan Reynolds d****d@d****h 2
Bert s****g@p****m 1
Bert Kruyt b****t@c****u 1
Bert Kuyrt b****t@d****h 1
Dylan Reynolds d****d@d****h 1
Ethan Gutmann g****n@p****l 1
Haerer Stefan s****e@l****r 1
Joshua Hacker j****r@j****u 1
Trude Eidhammer t****e@c****) 1
Trude Eidhammer t****e@c****) 1
Trude Eidhammer t****e@y****) 1
luciascaff l****f@u****a 1
krasouli k****i@u****a 1
and 3 more...

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 43
Total pull requests: 153
Average time to close issues: 12 months
Average time to close pull requests: 13 days
Total issue authors: 11
Total pull request authors: 15
Average comments per issue: 1.74
Average comments per pull request: 0.56
Merged pull request: 135
Bot issues: 0
Bot pull requests: 0

Past year issues: 3
Past year pull requests: 5
Past year average time to close issues: N/A
Past year average time to close pull requests: 3 months
Past year issue authors: 1
Past year pull request authors: 1
Past year average comments per issue: 0.67
Past year average comments per pull request: 0.4
Past year merged pull request: 1
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/NCAR/icar

Top Issue Authors

  • gutmann (16)
  • wwwliye (10)
  • ghost (4)
  • scrasmussen (4)
  • bertjebertjek (3)
  • liuppei (1)
  • wundersooner (1)
  • wrzesien (1)
  • johanneshorak (1)
  • zxh163404 (1)
  • sebastian-mutz (1)

Top Pull Request Authors

  • gutmann (61)
  • scrasmussen (47)
  • bertjebertjek (13)
  • johanneshorak (9)
  • d-reynolds (6)
  • trudeeidhammer (6)
  • DevPB (3)
  • rachel-mccrary (1)
  • then6702 (1)
  • joshphacker (1)
  • shaerer (1)
  • dustinswales (1)
  • luciascaff (1)
  • krasouli (1)
  • julievano (1)

Top Issue Labels

  • enhancement (2)
  • bug (2)
  • help wanted (1)

Top Pull Request Labels

Score: 7.985143931198619