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

Version 1.0: North Atlantic Update - Tides, Curved Boundaries, Config, and More!😀🤯🥳 #193

Draft
wants to merge 99 commits into
base: main
Choose a base branch
from

Conversation

manishvenu
Copy link

@manishvenu manishvenu commented Oct 11, 2024

Authors: @ashjbarnes, @manishvenu

Description:

Ashley and I worked together to add a few features to RM6. While we get the changes ready to merge with the main COSIMA branch, please check out this draft with a list of the changes below.

Major Features:

  • Accepting curved boundary supergrids and bathymetry
  • Implement Boundary Tides from OSU's TPXO using GFDL NWA25 Code
  • Import experiment configuration from a light config JSON
  • Major bathymetry fixes for land-sea mask
  • Moving experiment specific changes to MOM_override (All OBC, Tides, and other minor changes) and out of MOM_input
  • New GLORYS downloader (that can account for curved boundaries)
  • Additional tests (tides specific)
  • Changing function names to verb beginnings (initial_condition -> setup_initial_condition)
  • Add properties (i.e. more functional object variables) and dataset plotting

Minor Features:

  • Ability to code without greek letters
  • Removed unintentional machine-specific code
  • Increased print statements

Breaking Changes (for backwards compatibility):

  • Functions changed names, so it's not compatible with older code. All that needs to be updated is the function name itself in previous code (like the demos).

Documentation Changes (TBD):

  • Update README and Docs

Co-authored-by: @ashjbarnes

this PR closes #184 , #168 , and also #55 in a roundabout way since user now specifies which boundaries they want, and the MOM inputs are adjusted accordingly.

Before merging, need to resolve the following:

  • Include a curved boundary / tide example alongside the existing Tassie example
  • Resolve the tidal regridding issue here

ashjbarnes and others added 30 commits August 28, 2024 14:00
Changes to make compatible with CESM
having mask table and layout no longer required
Replace minimum layers with min depth
…nt num

After talking with Ashley, the find_MOM6_orientation will likely be removed
The function names for rectangular and sinmple boundaries were changed because the tides are a kind of boundary function, the old names now give a warning and call the correct function. GFDL had rough horizontal subsetting for the tpxo dataset (probably for efficiency?), implemented in setup_tides_rectangular_boundaries.
Collapsed the *_tidal_dims functions into the encode_tides function in segment, and add citing documentation to the docstrings for now.
Copy link

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@manishvenu manishvenu changed the title Version 1.0: North Atlantic Update - Tides, Curved Boundaries, Config, and More\]\]\ Version 1.0: North Atlantic Update - Tides, Curved Boundaries, Config, and More!😀🤯🥳 Oct 11, 2024
tests/test_angled_grids.py Outdated Show resolved Hide resolved
@navidcy
Copy link
Contributor

navidcy commented Oct 11, 2024

Hi @manishvenu

T H A N K S !

This is a huge PR. Is there any chance we break it into a few smaller ones? Otherwise reviewing will be hard.

Btw,
> Functions changed to verb starts!
what does "verb starts" mean?
(got it!)

@@ -129,7 +129,7 @@ def test_quadrilateral_areas(lat, lon, true_area):
],
)
def test_rectangular_hgrid(lat, lon):
assert isinstance(rectangular_hgrid(lat, lon), xr.Dataset)
assert isinstance(generate_rectangular_hgrid(lat, lon), xr.Dataset)
Copy link
Contributor

Choose a reason for hiding this comment

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

The args are reversed in the test compared to the method definition

https://github.com/CROCODILE-CESM/regional-mom6/blob/cd987f590d9346ebcb232413ee78fd3e34b86c78/regional_mom6/regional_mom6.py#L487

Probably doesn't matter for this test, but it might create confusion to users/developers.

@ashjbarnes
Copy link
Collaborator

Hi @manishvenu

T H A N K S !

This is a huge PR. Is there any chance we break it into a few smaller ones? Otherwise reviewing will be hard.

Btw, > Functions changed to verb starts! what does "verb starts" mean? (got it!)

Yes it's a huge PR! We did have this broken down into smaller PRs on the CROCODILE fork, which we reviewed and merged one by one over the last couple of months. Unfortunately these PRs might not be useful for us to break up this big one any more, because we did need to do a lot of merging given that @manishvenu and I were working in parallel on several changes.

It's still in draft state for now while we polish it (build on the properties for each input which is WIP, add more comments, remove commented out code, review the demos etc) but thought it could be good to get the ball rolling on the review.

Is there a way you suggest that we break up the PR? Since we did a huge overhaul of the entire codebase, it's kind of hard to separate some of the changes!

manishvenu and others added 4 commits October 14, 2024 14:29
…up_run_directory (#20)

* Package type changes for CRR

* Black Formatting

* Change MOM Param

* Change MOM_param to Work

* black

* Remvoe premade_run_dir_arg

* Remove init

* Black

* Update MOM_param_test

* Clean
* include DataReader class

* within __getattr__ read data files

* bug

* update demo with plots

* typo
@ashjbarnes
Copy link
Collaborator

BTW this PR closes #184 , #168 , and also #55 in a roundabout way since user now specifies which boundaries they want, and the MOM inputs are adjusted accordingly.

@navidcy
Copy link
Contributor

navidcy commented Oct 14, 2024

BTW this PR closes #184 , #168 , and also #55 in a roundabout way since user now specifies which boundaries they want, and the MOM inputs are adjusted accordingly.

the closes #XYZ either needs to be in the first comment of the PR or we need to manually link the issues with the PR

@navidcy
Copy link
Contributor

navidcy commented Oct 14, 2024

Yes it's a huge PR! We did have this broken down into smaller PRs on the CROCODILE fork, which we reviewed and merged one by one over the last couple of months. Unfortunately these PRs might not be useful for us to break up this big one any more, because we did need to do a lot of merging given that @manishvenu and I were working in parallel on several changes.

It's still in draft state for now while we polish it (build on the properties for each input which is WIP, add more comments, remove commented out code, review the demos etc) but thought it could be good to get the ball rolling on the review.

OK, when is ready to review we can talk again? Huge PRs are harder to review though and take longer...

Is there a way you suggest that we break up the PR?

Each of the major features mentioned in the first comment sounds like could be a PR? Just a suggestion..

@navidcy navidcy added the enhancement New feature or request label Oct 14, 2024
@navidcy
Copy link
Contributor

navidcy commented Oct 14, 2024

Ability to code without greek letters

haha, sorry if I introduced this difficulty to devs

… + tests (#30)

* Package type changes for CRR

* Black Formatting

* Change MOM Param

* Change MOM_param to Work

* black

* Revert back to reg

* Add tide boundary flexibility

* Update Config to only vars

* Update Write and Read Config for computer independence

* Update Read/Write Config for Computer Independenc

* Fix Change MOM Param Issues

* Fix bug in __getattr__ and comment out matplotlib dependencies in demo

* Package type changes for CRR

* Black Formatting

* Add Boundaries to Init part 1

* black formatting

* Changing Boundary Def to __init__ pt 2

* Minor Bugs

* Make Direction Dir a one-time calculation because keys() doesn't gaurentee order

* Rearrange handling boundaries in __init__ to a boundary array and segments dict in the boundary functions ocean_state and tides

* Clean

* Improve commenting on setuop_ocean_state_boundaries

* Fix bug in declaring number of OBC segments

* Minor Big in override

* Add boundaries to config
Copy link
Collaborator

@angus-g angus-g left a comment

Choose a reason for hiding this comment

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

Haven't looked the whole way through (only got to the end of the param file manipulation). Lots of style-related stuff, but the functionality is exciting!

Comment on lines +68 to +71
except:
raise ValueError(
"Invalid Input. Tidal constituent {} is not supported.".format(tc)
)
Copy link
Collaborator

Choose a reason for hiding this comment

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

There'll be a few of these, but catch only the exception you're looking for here. I guess in this case it's a KeyError?

Comment on lines +64 to +73
list_of_ints = []
for tc in tidal_constituents:
try:
list_of_ints.append(tidal_constituents_tpxo_dict[tc])
except:
raise ValueError(
"Invalid Input. Tidal constituent {} is not supported.".format(tc)
)

return list_of_ints
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
list_of_ints = []
for tc in tidal_constituents:
try:
list_of_ints.append(tidal_constituents_tpxo_dict[tc])
except:
raise ValueError(
"Invalid Input. Tidal constituent {} is not supported.".format(tc)
)
return list_of_ints
try:
constituent_indices = [constituent_map[tc] for tc in tidal_constituents]
except KeyError as e:
raise ValueError(f"Invalid tidal constituent: {e.args[0]}")
return constituent_indices

Comment on lines +107 to +112
try:
expt.longitude_extent = tuple(config_dict["longitude_extent"])
expt.latitude_extent = tuple(config_dict["latitude_extent"])
except:
expt.longitude_extent = None
expt.latitude_extent = None
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
try:
expt.longitude_extent = tuple(config_dict["longitude_extent"])
expt.latitude_extent = tuple(config_dict["latitude_extent"])
except:
expt.longitude_extent = None
expt.latitude_extent = None
try:
expt.longitude_extent = tuple(config_dict["longitude_extent"])
expt.latitude_extent = tuple(config_dict["latitude_extent"])
except KeyError:
expt.longitude_extent = None
expt.latitude_extent = None

Check that extents are correct length?

Comment on lines +113 to +122
try:
expt.date_range = config_dict["date_range"]
expt.date_range[0] = dt.datetime.strptime(
expt.date_range[0], "%Y-%m-%d %H:%M:%S"
)
expt.date_range[1] = dt.datetime.strptime(
expt.date_range[1], "%Y-%m-%d %H:%M:%S"
)
except:
expt.date_range = None
Copy link
Collaborator

Choose a reason for hiding this comment

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

Maybe KeyError for the path where expt.date_range = None, but if you handle IndexError separately you can warn/error on the incorrect range input.

Comment on lines +124 to +127
if mom_input_folder is None:
mom_input_folder = Path(os.path.join("mom_run", "from_config"))
if mom_run_folder is None:
mom_run_folder = Path(os.path.join("mom_input", "from_config"))
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
if mom_input_folder is None:
mom_input_folder = Path(os.path.join("mom_run", "from_config"))
if mom_run_folder is None:
mom_run_folder = Path(os.path.join("mom_input", "from_config"))
if mom_input_folder is None:
mom_input_folder = Path("mom_run" / "from_config")
if mom_run_folder is None:
mom_run_folder = Path("mom_input" / "from_config")

or just e.g. "mom_input/from_config"

Comment on lines +2402 to +2409
if seg == "south":
index_str = '"J=0,I=0:N'
elif seg == "north":
index_str = '"J=N,I=N:0'
elif seg == "west":
index_str = '"I=0,J=N:0'
elif seg == "east":
index_str = '"I=N,J=0:N'
Copy link
Collaborator

Choose a reason for hiding this comment

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

Would be a little cleaner as a dictionary

Comment on lines +2419 to +2434
key_DATA = key_start + "_DATA"
file_num_obc = str(
self.find_MOM6_rectangular_orientation(seg)
) # 1,2,3,4 for rectangular boundaries, BUT if we have less than 4 segments we use the index to specific the number, but keep filenames as if we had four boundaries
MOM_override_dict[key_DATA][
"value"
] = f'"U=file:forcing_obc_segment_00{file_num_obc}.nc(u),V=file:forcing_obc_segment_00{file_num_obc}.nc(v),SSH=file:forcing_obc_segment_00{file_num_obc}.nc(eta),TEMP=file:forcing_obc_segment_00{file_num_obc}.nc(temp),SALT=file:forcing_obc_segment_00{file_num_obc}.nc(salt)'
if with_tides:
MOM_override_dict[key_DATA]["value"] = (
MOM_override_dict[key_DATA]["value"]
+ f',Uamp=file:tu_segment_00{file_num_obc}.nc(uamp),Uphase=file:tu_segment_00{file_num_obc}.nc(uphase),Vamp=file:tu_segment_00{file_num_obc}.nc(vamp),Vphase=file:tu_segment_00{file_num_obc}.nc(vphase),SSHamp=file:tz_segment_00{file_num_obc}.nc(zamp),SSHphase=file:tz_segment_00{file_num_obc}.nc(zphase)"'
)
else:
MOM_override_dict[key_DATA]["value"] = (
MOM_override_dict[key_DATA]["value"] + '"'
)
Copy link
Collaborator

Choose a reason for hiding this comment

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

Would be a bit clearer to build up the value string outside of the dictionary, then only set it at the end.

Should also split the really long lines, i.e.

obc_string = (
    f",Uamp=file:tu_segment_00{file_num_obc}.nc(uamp),"
    f"Uphase=file:tu_segment_00{file_num_obc}.nc(uphase),"
    f"Vamp=file:tu_segment_00{file_num_obc}.nc(vamp),"
    f"Vphase=file:tu_segment_00{file_num_obc}.nc(vphase),"
    f"SSHamp=file:tz_segment_00{file_num_obc}.nc(zamp),"
    f"SSHphase=file:tz_segment_00{file_num_obc}.nc(zphase)"'
)

Comment on lines +2457 to +2462
str(self.date_range[0].year)
+ ", "
+ str(self.date_range[0].month)
+ ", "
+ str(self.date_range[0].day)
)
Copy link
Collaborator

Choose a reason for hiding this comment

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

strptime this too?

Comment on lines +2464 to +2466
for key in MOM_override_dict.keys():
if type(MOM_override_dict[key]) == dict:
MOM_override_dict[key]["override"] = True
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
for key in MOM_override_dict.keys():
if type(MOM_override_dict[key]) == dict:
MOM_override_dict[key]["override"] = True
for key, val in MOM_override_dict.items():
if isinstance(val, dict):
MOM_override_dict[key]["override"] = True

@@ -1754,6 +2504,198 @@ def setup_run_directory(
0,
]
nml.write(self.mom_run_dir / "input.nml", force=True)
return

def change_MOM_parameter(
Copy link
Collaborator

Choose a reason for hiding this comment

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

I think this MOM parameter file stuff could get lifted out to a separate file?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Need to override MOM6 min depth based on value set in setup_bathymetry function
4 participants