openearth / xbeach-docs

XBeach documentation

XBeach documentation

This repository holds the latest built of the XBeach documentation.

The web version of the documentation can be found at: http://xbeach.readthedocs.io/

Contribute

We adopted a continous integration workflow using forked pull requests for contributions to the XBeach documentation. This means that you will need to fork the openearth/xbeach-docs repository to contribute:

1. At http://github.com/openearth/xbeach-docs, create a fork in a personal Github account (upper right corner).
2. Through your favorite Git client (e.g. TortoiseGit), create a local clone of the personal fork (http://github.com/<youraccount>/xbeach-docs).

You can reuse the personal fork and local clone for any future contribitions. To submit and review contributions to the XBeach documentation you need the following steps:

1. Commit your contributions to the XBeach documentation to your local clone.
2. Push your commits from your local clone to the personal fork.
3. At http://github.com/<youraccount>/xbeach-docs (personal fork), submit a pull request.
4. Your contributions will be offered to the original OpenEarth repository and tested for validity through CircleCI. The status of the tests are displayed on the pull request page:
   • If all tests pass, you may preview the resulting documentation:
     • Click the Details link behind the CircleCI status indicator.
     • Go to the Artifacts tab.
     • Navigate to html/index.html.
     • Note that equations are currently not rendered in CircleCI.
   • If one or more tests fail, please review the failed tests:
     • Click the Details link behind the CircleCI status indicator.
     • Go to the Test Summary tab to review the failed tests.
     • Solve the errors in your local clone and repeat from step 1. until all tests pass.
5. If all tests passed, your contribution will be considered for merging with the XBeach documentation. You might receive additional requests through Github conversations.

xbeach-docs's Issues

What is the meanings of the parameter "thet" in the output variables of Xbeach? The manual shows that "thet" is the wave angles with units of rad.,but the values of "thet" are always bigger then 3.1415 in my simulations.

What is the meanings of the parameter "thet" in the output variables of Xbeach? The manual shows that "thet" is the wave angles with units of rad.,but the values of "thet" are always bigger then 3.1415 in my simulations.
I tried many times and failed to know the real meanings of "thet".
Please help me anyone?

An Inconsistency in Sandy input files

Hi,

Could anyone double check in the folder: xbeach-docs/docs/tutorials/sandy/files/Model/?

1. nx, ny (nx = 836 ny = 100) in params.txt do not match with the size of x.grd, ygrid, and bed.dep which is 503 x837.

2. LOCLIST.txt contains three X,Y coordinates which are outside of the domain (see my plot attached)

Thanks

setup_xbveg_2D.m does not generate .nc file

Hi! I am trying to follow the tutorial for the "Modeling wave attenuation by vegetation (2D)". The model setup seems fine, but it does not generate a .nc file, thus I cannot run plot_waveheight.m because I do not have the file 'xboutput.nc'. Can you help me with this issue? Thank you!