Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Documentation for CESM2 release

Abierto
#12 15 comentarios 0 reacciones 2 asignados Ver en GitHub

@gunterl ya está trabajando en esto.

Desde el 7/5/2018.

Evaluación

Este issue todavía no se ha evaluado.

Descripción

documentation

This issue documents things needed for the cism-in-cesm documentation for the cesm2 release.

  • Rewrite chapter 1 (introduction) - Gunter (with help from Bill L, Bill S)

  • Chapter 2 (quick start) - Bill S

    • Rewrite overview
    • For the most part, point to CESM quick start and/or cime documentation
    • Keep modifying namelist settings, rewrite as needed
    • Keep modifying source code... talk about modifying in-source vs. SourceMods, and the two different places for SourceMods to go
    • Point out specific things useful for LIWG
      • One-way vs. two-way coupling
  • New chapter on developing and modifying CISM

    • Add a section on directory structure (taken from current chapter 4) - Bill S
    • Move the "simulating the Greenland ice sheet" section from the current chapter 4 to there - Gunter
  • Add a section on grids (rewritten from the section in the current chapter 4) - Bill S (with help from others)

    • Point to wiki page on new CISM grid. Update 2018-05-31: Maybe move that wiki page into the user's guide... in that case, maybe make grids its own chapter.
    • Note need for glacier region to be consistent in CLM: need to have virtual columns and melt_replaced_by_ice in the CISM domain
  • Chapter 3 (TG compsets) - Bill S

  • Chapter 4 (the dynamic ice sheet model) - Gunter

    • May cut the description of the dynamic ice sheet model (4.1) entirely, just pointing to the full CISM documentation
    • However, we want to keep the "coupling to CLM" section, but move this to a separate chapter (see below)
    • Also keep description of different directories, but move to quick start guide (Bill S)
    • Keep some description of time steps - Gunter
  • Chapter 5 (ice sheets in the community land model, and coupling) - Bill L with help from Bill S

    • Rework what's there, and/or point to CLM documentation
    • Include remapping between CISM and CLM - Bill L
    • Add other fields sent from CISM - Bill S / Bill L
  • Chapter 6 (FAQ) - cut this for now; can add things back in later as needed (note that they'll need documentation for the new code)

    • But see below: move some of this into a new chapter on output
  • New chapter on controlling output from cism and clm

    • Add a section on input/output (rewritten from the section in the current chapter 4) - Bill S
    • Move the old 6.7 and 6.8 here
  • Chapter 7 (acknowledgements) - Bill L

  • Chapter 8 (references) - Gunter and Bill L


Other things we want to mention somewhere:

  • Need to set restart=0 when doing a hybrid run where you have changed cisminputfile to point to a restart file from a standalone case, or a case with different physics (Laura Muntjewerf's issue August, 2018)
Lenguaje dominante
Fortran
Estrellas
4
Forks
18
Merge medio
1 d 20 h
PR fusionados (30 d)
2

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de ESCOMP/CISM-wrapper

Todos los issues de ESCOMP/CISM-wrapper

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.