Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: correct description of box2001 test #510

Merged
merged 1 commit into from
Aug 26, 2020

Conversation

phil-blain
Copy link
Member

PR checklist

  • Short (1 sentence) summary of your PR:
    doc: correct description of box2001 test

  • Developer(s):
    P Blain.

  • Suggest PR reviewers from list in the column to the right.

  • Please copy the PR test results link or provide a summary of testing completed below.
    no tests; doc fix.

  • How much do the PR code changes differ from the unmodified code?

    • bit for bit
    • different at roundoff level
    • more substantial
  • Does this PR create or have dependencies on Icepack or any other models?

    • Yes
    • No
  • Does this PR add any new test cases?

    • Yes
    • 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/. A test build of the technical docs will be performed as part of the PR testing.)

    • Yes
    • No, does the documentation need to be updated at a later time?
      • Yes
      • No
  • Please provide any additional information or relevant details below:

    The documentation states that this test case sets 'coriolis' to zero,
    but 'configuration/scripts/options/set_nml.box2001' sets 'coriolis' to 'constant'.
    Fix the documentation to be in line with the code.

Copy link
Contributor

@JFLemieux73 JFLemieux73 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@phil-blain please add the units...i.e., f=1.46e-4 s^{-1}.

The documentation states that this test case sets 'coriolis' to zero,
but 'configuration/scripts/options/set_nml.box2001' sets 'coriolis' to 'constant'.
Fix the documentation to be in line with the code.

While at it, add the correct unit for the Coriolis parameter (in both places
where it appears in the documentation).

Closes CICE-Consortium#509

Reported-by: Jean-François Lemieux <jean-francois.lemieux@canada.ca>
@phil-blain
Copy link
Member Author

@JFLemieux73 good idea. I've added it and also in the Case settings section.

@apcraig
Copy link
Contributor

apcraig commented Aug 25, 2020

In preparation for the next release, I will merge this tomorrow morning unless any other concerns are expressed before then. Thanks.

Copy link
Contributor

@eclare108213 eclare108213 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmmm. I thought that the box test in the paper (Hunke 2001) used Coriolis=0. Am I not remembering that correctly? The idea was that this test would replicate the one in that paper, to the extent possible. In that case, it would be better to change the test rather than changing the documentation of the test. Opinions about this are welcome.

@JFLemieux73
Copy link
Contributor

In Hunke 2001 it is written: For these simulations the Coriolis parameter is taken to be constant...
In the table: f Coriolis parameter 1.46 x 10-4 s-1

We could set f to 0 as long as it is consistent with the doc. I think the 3 islands are not there either (am I right?). We could just say this test case is inspired by the test case in Hunke 2001.

@eclare108213
Copy link
Contributor

Interesting. Thanks for checking! Then let's keep it as the constant value. You're right, the islands aren't there, but they aren't the important part of the test - that's getting the forcing the same. So I think this is fine. Thank you!

@apcraig apcraig merged commit 40533df into CICE-Consortium:master Aug 26, 2020
@phil-blain phil-blain deleted the fix-box2001-doc branch September 24, 2020 20:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants