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

Correct wave and spherical harmonics unit descriptions #273

Merged

Conversation

Hallberg-NOAA
Copy link
Member

@Hallberg-NOAA Hallberg-NOAA commented Dec 9, 2022

This PR includes a series of commits to correct the documentation of variable units, especially in the MOM_spherical_harmonics and MOM_wave_interface modules. It also includes the addition of conversion factors to the register_diag_field calls for the two "developmental" diagnostics dudt_Stokes and dvdt_Stokes whose documented units were corrected, and to the register_restart calls for Us_x_prev and Us_y_prev. This also required the addition of a unit_scale_type argument to waves_register_restarts. All answers are bitwise identical.

The commits in this PR include:

  • b819d9778 +Correct MOM_wave_interface unit descriptions
  • ea699efb0 Correct scattered unit description syntax
  • 2ca2d19f9 Unit descriptions in MOM_spherical_harmonics

@codecov
Copy link

codecov bot commented Dec 9, 2022

Codecov Report

Merging #273 (e7d020b) into dev/gfdl (674687c) will increase coverage by 1.30%.
The diff coverage is 11.11%.

@@             Coverage Diff              @@
##           dev/gfdl     #273      +/-   ##
============================================
+ Coverage     35.80%   37.10%   +1.30%     
============================================
  Files           260      263       +3     
  Lines         72436    73491    +1055     
  Branches      13681    13696      +15     
============================================
+ Hits          25937    27272    +1335     
+ Misses        41429    41191     -238     
+ Partials       5070     5028      -42     
Impacted Files Coverage Δ
src/core/MOM_open_boundary.F90 24.10% <ø> (ø)
...ameterizations/lateral/MOM_spherical_harmonics.F90 0.00% <0.00%> (ø)
...parameterizations/vertical/MOM_set_diffusivity.F90 53.30% <ø> (ø)
...c/parameterizations/vertical/MOM_vert_friction.F90 60.51% <ø> (ø)
src/user/Rossby_front_2d_initialization.F90 0.00% <ø> (ø)
src/user/user_change_diffusivity.F90 0.00% <ø> (ø)
src/user/MOM_wave_interface.F90 1.32% <10.00%> (+<0.01%) ⬆️
src/core/MOM.F90 51.38% <100.00%> (ø)
...ig_src/drivers/unit_tests/MOM_unit_test_driver.F90 92.00% <0.00%> (ø)
src/framework/MOM_unit_testing.F90 76.00% <0.00%> (ø)
... and 8 more

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

  Altered the unit descriptions in comments in the new MOM_spherical_harmonics
module to use standard syntax or to indicate the relationship between the units
of this input and output variables.  Only comments are changed, and all answers
are bitwise identical.
  Corrected the syntax of the unit descriptions of 6 internal variables
scattered around the code.  Only comments are changed, and all answers are
bitwise identical.
  Corrected the descriptions of 12 subroutine argument and internal variables in
MOM_wave_interface, including those of 4 arguments to Stokes_PGF, and those of 8
variables related to the Waves%ddt_Us_[xy] diagnostics, which are only enabled
with the STOKES_DDT flag that is labeled in the code as "developmental".  This
commit also includes the addition of the correct conversion arguments to the
register_diag_field calls for dudt_Stokes and dvdt_Stokes diagnostics, and
to the register_restart calls for Us_x_prev and Us_y_prev.  This also required
the addition of a unit_scale_type argument to waves_register_restarts.  All
solutions are bitwise identical, and the dimensional rescaling of two
diagnostics are corrected.
@Hallberg-NOAA Hallberg-NOAA force-pushed the spherical_harmonics_units branch from 9f7247a to b819d97 Compare December 13, 2022 11:19
Copy link

@breichl breichl left a comment

Choose a reason for hiding this comment

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

The changes to units in MOM_wave_interface look correct to me.

@marshallward
Copy link
Member

Gaea regression: https://gitlab.gfdl.noaa.gov/ogrp/MOM6/-/pipelines/17754 ✔️

@marshallward marshallward merged commit 46a6159 into NOAA-GFDL:dev/gfdl Dec 19, 2022
@Hallberg-NOAA Hallberg-NOAA deleted the spherical_harmonics_units branch February 2, 2023 13:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants