Skip to content

Add tutorial for SCHISM model for lake ontario.#2660

Open
fluidnumericsJoe wants to merge 3 commits into
mainfrom
docs/ux-schism-model-lakeontario-tutorial
Open

Add tutorial for SCHISM model for lake ontario.#2660
fluidnumericsJoe wants to merge 3 commits into
mainfrom
docs/ux-schism-model-lakeontario-tutorial

Conversation

@fluidnumericsJoe

Copy link
Copy Markdown
Contributor

Description

This is a minimum working example that illustrates primarily how to do 2D (lateral) particle advection with SCHISM model output. It walks through handling issues with uxarray, which assumes that the input grid is in units of degrees for latitude and longitude.

The SCHISM output provided here uses x,y in cartesian coordinates in units of meters. Since uxarray automatically wraps longitude to be between [0,360] we have to overwrite the node_lon values stored in the uxgrid object.

We show how to rename the SCHISM velocity field components, lateral node coordinate, and vertical grid names to match what Parcels expects to see. Note that we intentionally create a ficticious vertical grid in this example; Parcels currently does not support the LSC2 vertical grid that is used in SCHISM and this is documented clearly in the tutorial.

Checklist

  • This PR targets the correct branch (main for normal development, v3-support for v3 support)

AI Disclosure

  • This PR contains AI-generated content.
    • I have tested any AI-generated content in my PR.
    • I take responsibility for any AI-generated content in my PR.
    • Describe how you used it (e.g., by pasting your prompt): Claude code was used to copy edit the SCHISM tutorial to ensure we maintain similar tone and structure with other tutorials in the parcels documentation.

This is a minimum working example that illustrates primarily how to do
2D (lateral) particle advection with SCHISM model output. It walks
through handling issues with uxarray, which assumes that the input grid
is in units of degrees for latitude and longitude.

The SCHISM output provided here uses x,y in cartesian coordinates in
units of meters. Since uxarray automatically wraps longitude to be
between [0,360] we have to overwrite the `node_lon` values stored in the
uxgrid object.

We show how to rename the SCHISM velocity field components, lateral node
coordinate, and vertical grid names to match what Parcels expects to
see. Note that we intentionally create a ficticious vertical grid in
this example; Parcels currently does not support the LSC2 vertical grid
that is used in SCHISM and this is documented clearly in the tutorial.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Backlog

Development

Successfully merging this pull request may close these issues.

1 participant