Add examples

[hboisgon]

Issue addressed

Fixes #54 , #96

Explanation

Add a couple of examples to the documentation:

• general part, see README.rst
• Build 1d model notebook
• Build 2d model notebook
• build 1d2d model notebook
• update 1d model with 2d model and 1d2d links notebook
• update 1d model with structures
• update 'refine' grid of 2d model notebook
• update default boundaries with timeseries notebook
• plot model mesh

Checklist

• Updated tests or added new tests
• Branch is up to date with main
• Tests & pre-commit hooks pass
• Updated documentation if needed
• Updated changelog.rst if needed

[hboisgon]

I changed some settings in setup_rivers_from_dem, basically the buffer is more needed to read the rivers data than the dem grid (I found that when trying to build a model in Africa). But seems that maybe the tests fail because of it. @xldeltares, does the error look familiar? If it's really due to this change we can also cancel and open an issue to update later.

[xldeltares]

TODO:

• merge main into branch
• check the plot example
• clean all my notebook results for recommit
• update change log
• update the version v0.1.2 (next release) in the installation guide; add a line points to installation guide that contains anaconda/mamba install
• remove mesh folder from the examples ipynotebook
• check why the example piave fails
• there is also changes in the mesh_utils.
• After merging, reopen an issue with remaining examples todos
• update hydromt 0.9.0

[sonarcloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
0.0% Duplication