E3SM Tutorial FAQ

[forsyth2]

I'm listing some reminders and FAQ from the E3SM Tutorial at NERSC on 2024-05-09 below. If you were a tutorial attendee, feel free to add your own questions on this discussion thread! I'll update this FAQ if more questions come in.

Demo: https://github.com/E3SM-Project/zppy/blob/add-tutorial-materials/tutorial_materials/zppy_demo.md
Problem set: https://github.com/E3SM-Project/zppy/blob/add-tutorial-materials/tutorial_materials/zppy_problem_set.md

Reminders

• Set account and reservation appropriately in your own cfg.
• Make sure to replace any path with my username in it with one that uses your own username.

FAQ

• I don't have enough nodes to run -- I only have 2 nodes available. What do I do?
  • Set nodes = 2 under [default] in your version of the demo's cfg. You'll want to remove nodes = 8 in the [ilamb] task so 2 doesn't get overridden with 8. You'll also want to sets nodes = 2 under [climo]. Why? Take a look at Debugging Problem 2 in the problem set.
• I'm seeing Could not determine URL from www. Did I do something wrong?
  • Probably not. It's possible you've set the www to be a path that zppy can't automatically link to a web server. (To see how zppy handles this, take a look at print_url in the utils file). That doesn't necessarily mean your output didn't generate. If you cd into your www directory, there may very well be plots there you just don't have the ability to see visually. You could copy those files to somewhere connected to a web server (like your local host) to see the output.
• How can I copy your cfg?
  • You can do any of these:
    • Run wget https://raw.githubusercontent.com/E3SM-Project/zppy/add-tutorial-materials/tutorial_materials/extendedOutput.v3.LR.historical_0101.cfg (which is the raw file for the cfg on GitHub)
    • Simply copy the text yourself from https://github.com/E3SM-Project/zppy/blob/add-tutorial-materials/tutorial_materials/extendedOutput.v3.LR.historical_0101.cfg
    • Run git clone the repo and git checkout the add-tutorial-materials branch