Coupling support for GEOS-ESM

[zhaobin74]

PR checklist

• [X] Short (1 sentence) summary of your PR: This PR adds support for coupling CICE6/Icepack to NASA GMAO GEOS-ESM
• [X] Developer(s): @zhaobin74
• [X] Suggest PR reviewers from list in the column to the right. @eclare108213, @apcraig, @dabail10
• [ ] Please copy the PR test results link or provide a summary of testing completed below. Run base_suite with both base tag (main) and this PR and got bit-for-bit identical results
• How much do the PR code changes differ from the unmodified code?
  • [X] bit for bit
  • [ ] different at roundoff level
  • [ ] more substantial
• Does this PR create or have dependencies on CICE or any other models?
  • [ ] Yes
  • [X] No
• Does this PR add any new test cases?
  • [ ] Yes
  • [X] No
• Is the documentation being updated? ("Documentation" includes information on the wiki or in the .rst files from doc/source/, which are used to create the online technical docs at https://readthedocs.org/projects/cice-consortium-cice/.)
  • [ ] Yes
  • [X] No, does the documentation need to be updated at a later time?
    • [X] Yes
    • [ ] No
• [X] Please document the changes in detail, including why the changes are made. This will become part of the PR commit log.
  • Adds support for coupler provided surface flux and derivatives in BL99 and Mushy solver (necessary for coupling to GEOS-ESM atmosphere)
  • Adds additional bands of visible SW as input and outputs of resulting penetration flux (for GEOS-ESM)
  • When proper, use GEOSCOUPLED macro to isolate the relevant code specific to GEOS

Hi Consortium, I am putting this PR in draft mode for now to get feedbacks. I am happy to improve it with your help and suggestions.

[apcraig]

HI @zhaobin74. Thanks for putting these together. I've had a quick look and they look pretty reasonable. But I will go thru the modification in Icepack and CICE carefully and provide some feedback. We are in the process of updating several interfaces as part of a bgc upgrade, so depending on progress on that task, some revisions may be needed here for that too. But I don't think that will be a big problem, and we can work together to bring your changes into the code cleanly. More soon.

[zhaobin74]

HI @zhaobin74. Thanks for putting these together. I've had a quick look and they look pretty reasonable. But I will go thru the modification in Icepack and CICE carefully and provide some feedback. We are in the process of updating several interfaces as part of a bgc upgrade, so depending on progress on that task, some revisions may be needed here for that too. But I don't think that will be a big problem, and we can work together to bring your changes into the code cleanly. More soon.

Thanks, @apcraig. All sounds good. Look forward to working with you and others on this PR.

[apcraig]

Hi @zhaobin74, haven't forgotten about this. I'm trying to get an update to bgc into the code before we test/merge your modifications. This PR is high priority, sorry for the delays.

[zhaobin74]

Hi @zhaobin74, haven't forgotten about this. I'm trying to get an update to bgc into the code before we test/merge your modifications. This PR is high priority, sorry for the delays.

Hi @apcraig, just back from leave. No problem, we can deal with it later.