tutorial: soil informed overland flow

.gitignore

@@ -135,3 +135,8 @@ docs
 
 
 **/*.quarto_ipynb
+
+# Notebook run artifacts (soil_hydrology downloads and renders into its own dir)
+content/tutorials/soil_hydrology/grassdata/
+content/tutorials/soil_hydrology/secref.zip
+content/tutorials/soil_hydrology/*.png

content/tutorials/soil_hydrology/references.bib

@@ -0,0 +1,102 @@
+@article{schaap_rosetta_2001,
+	title = {rosetta: a computer program for estimating soil hydraulic parameters with hierarchical pedotransfer functions},
+	volume = {251},
+	issn = {0022-1694},
+	shorttitle = {rosetta},
+	doi = {10.1016/S0022-1694(01)00466-8},
+	number = {3},
+	journal = {Journal of Hydrology},
+	author = {Schaap, Marcel G. and Leij, Feike J. and van Genuchten, Martinus Th.},
+	month = oct,
+	year = {2001},
+	pages = {163--176},
+}
+
+@article{zhang_weighted_2017,
+	title = {Weighted recalibration of the {Rosetta} pedotransfer model with improved estimates of hydraulic parameter distributions and summary statistics ({Rosetta3})},
+	volume = {547},
+	issn = {00221694},
+	doi = {10.1016/j.jhydrol.2017.01.004},
+	journal = {Journal of Hydrology},
+	author = {Zhang, Yonggen and Schaap, Marcel G.},
+	month = apr,
+	year = {2017},
+	pages = {39--53},
+}
+
+@incollection{mitasova_path_2004,
+	title = {Path sampling method for modeling overland water flow, sediment transport, and short term terrain evolution in {Open} {Source} {GIS}},
+	volume = {55},
+	isbn = {978-0-444-51840-8},
+	doi = {10.1016/S0167-5648(04)80159-X},
+	booktitle = {Developments in {Water} {Science}},
+	publisher = {Elsevier},
+	author = {Mitasova, Helena and Thaxton, Chris and Hofierka, Jaroslav and McLaughlin, Richard and Moore, Amber and Mitas, Lubos},
+	year = {2004},
+	pages = {1479--1490},
+}
+
+@article{mitas_distributed_1998,
+	title = {Distributed soil erosion simulation for effective erosion prevention},
+	volume = {34},
+	issn = {0043-1397},
+	doi = {10.1029/97WR03347},
+	number = {3},
+	journal = {Water Resources Research},
+	author = {Mitas, Lubos and Mitasova, Helena},
+	month = mar,
+	year = {1998},
+	pages = {505--516},
+}
+
+@article{vangenuchten_closed_1980,
+	title = {A closed-form equation for predicting the hydraulic conductivity of unsaturated soils},
+	volume = {44},
+	doi = {10.2136/sssaj1980.03615995004400050002x},
+	number = {5},
+	journal = {Soil Science Society of America Journal},
+	author = {van Genuchten, Martinus Th.},
+	year = {1980},
+	pages = {892--898},
+}
+
+@misc{beaudette_rosetta_api,
+	title = {{ROSETTA} {Model} {API}},
+	author = {Beaudette, Dylan and Reid, Richard and Skaggs, Todd},
+	year = {2026},
+	howpublished = {Algorithms for Quantitative Pedology},
+	url = {https://ncss-tech.github.io/AQP/soilDB/ROSETTA-API.html},
+	note = {Accessed 2026-09-30},
+}
+
+@book{soilsurveystaff_manual_2017,
+	title = {Soil {Survey} {Manual}},
+	series = {USDA Handbook 18},
+	publisher = {United States Department of Agriculture, Natural Resources Conservation Service},
+	author = {{Soil Science Division Staff}},
+	year = {2017},
+	note = {Saturated hydraulic conductivity classes, chapter 3},
+}
+
+@misc{ssurgo,
+	title = {Soil {Survey} {Geographic} {Database} ({SSURGO})},
+	author = {{Soil Survey Staff, Natural Resources Conservation Service, United States Department of Agriculture}},
+	url = {https://www.nrcs.usda.gov/resources/data-and-reports/soil-survey-geographic-database-ssurgo},
+	note = {Accessed 2026-09-30},
+}
+
+@misc{white_nrcs_simwe,
+	title = {{SIMWE} {Soils} {Project}},
+	author = {White, Corey T. and Petrasova, Anna and Mitasova, Helena},
+	howpublished = {NC State University Center for Geospatial Analytics},
+	url = {https://ncsu-geoforall-lab.github.io/NRCS_SIMWE/},
+	note = {USDA NRCS cooperative agreement, adapting SIMWE for Dynamic Soil Survey data. Accessed 2026-10-01},
+}
+
+@dataset{petrasova_secref_2026,
+	title = {{GRASS} sample dataset for {SIMWE} model, {NC} {State} {University} {Sediment} and {Erosion} {Control} {Research} and {Education} {Facility}, {North} {Carolina}, {USA}},
+	author = {Petrasova, Anna},
+	year = {2026},
+	publisher = {Zenodo},
+	doi = {10.5281/zenodo.23017720},
+}