Feat/add some papers

docs/src/ptf-catalog/sources/index.md

@@ -21,9 +21,11 @@ Each page describes the source, scope, inputs, outputs, status, and limitations
 | [Jabro (1992), United States.](./jabro1992.md) | USA | 1 |
 | [Li et al. (2007), Fengqiu County, North China Plain, China.](./li2007.md) | Fengqiu County soils in the North China Plain, China | 1 |
 | [Mayr and Jarvis (1999) modified Brooks-Corey water-retention parameter PTFs.](./mayr1999.md) | England and Wales | 1 |
+| [Oosterveld and Chang (1980), soil-moisture retention from texture and depth.](./oosterveld1980.md) | Southern Alberta, Canada | 5 |
 | [Pidgeon (1972), available-water regressions for ferrallitic soils in Uganda.](./pidgeon1972.md) | Non-alluvial ferrallitic soils in Uganda, predominantly kaolinitic and possibly illitic | 17 |
 | [Puckett et al. (1985), Alabama Lower Coastal Plain Ultisols.](./puckett1985.md) | Lower Coastal Plain of Alabama, USA | 1 |
 | [Rawls et al. (1982), water-retention regressions for soils across the USA.](./rawls1982.md) | Agricultural soils from 32 states of the USA | 3 |
+| [Saxton and Rawls (2006), soil water characteristics from texture and organic matter.](./saxton2006.md) | United States | 7 |
 | [Tiwary et al. (2014), hydraulic PTFs for two major soil regions of India.](./tiwary2014.md) | Indo-Gangetic Plains and black soil region of India | 2 |
 | [Varallyai et al. (1982), water-retention parameter regressions for Hungarian soils.](./varallyai1982.md) | Hungary, mainly the Hungarian Plain | 4 |
 | [Vereecken et al. soil-moisture retention regressions for Belgian soils.](./vereecken1989.md) | Belgian territory north of the river axis Samber and Meuse | 2 |

docs/src/ptf-catalog/sources/oosterveld1980.md

@@ -0,0 +1,167 @@
+---
+# @generated by ptfkit-codegen; DO NOT EDIT.
+
+title: PTF source oosterveld1980
+nav-title: oosterveld1980
+---
+
+# Oosterveld and Chang (1980), soil-moisture retention from texture and depth.
+
+## Source
+
+Oosterveld, M., & Chang, C. (1980). Empirical relations between laboratory determinations of soil texture and moisture retention. Canadian Agricultural Engineering, 22, 149-151.
+
+## Scope
+
+**Territory:** Southern Alberta, Canada
+
+**Dataset:** 1,137 pressure-plate analyses on 298 soil samples from the Lethbridge Research Station laboratory; the field-capacity tension regression used 134 samples.
+
+## Functions
+
+### `calc_ptf_oosterveld1980_field_capacity_tension`
+
+Estimate field-capacity tension from clay content.
+
+**Status:** `implemented`
+
+**Prediction target:** Tension at which pressure-plate moisture content equals field capacity determined by the cylinder method.
+
+**Models:** $h(\theta)$ — Field-capacity tension point estimate
+
+#### Inputs
+
+| Name | Unit | Domain | Description |
+| --- | --- | --- | --- |
+| `clay` | % mass | 2 <= value <= 72 | Clay content in percent by weight; the field-capacity tension experiment covered 2% to 72% clay. |
+
+#### Outputs
+
+| Name | Unit | Domain | Description |
+| --- | --- | --- | --- |
+| `field_capacity_tension` | kPa | value > 0 | Predicted tension corresponding to cylinder-method field capacity. |
+
+!!! note
+
+    Equation 1 reports r = 0.67 and n = 134.
+
+### `calc_ptf_oosterveld1980_retention`
+
+Estimate gravimetric soil-moisture content from texture, depth, and tension.
+
+**Status:** `implemented`
+
+**Prediction target:** Gravimetric soil-moisture content at a specified tension.
+
+**Models:** $h(\theta)$ — Empirical power-law moisture-retention relation
+
+#### Inputs
+
+| Name | Unit | Domain | Description |
+| --- | --- | --- | --- |
+| `clay` | % mass | — | Clay content in percent by weight. |
+| `sand` | % mass | — | Sand content in percent by weight. |
+| `mean_depth` | cm | 8 <= value <= 180 | Mean depth of the soil sample. |
+| `tension` | kPa | 10 <= value <= 1500 | Soil-moisture tension. |
+
+#### Outputs
+
+| Name | Unit | Domain | Description |
+| --- | --- | --- | --- |
+| `moisture_content` | % mass | — | Predicted soil-moisture content in percent by weight. |
+
+!!! note
+
+    Equation 2 reports r = 0.96 and n = 1,137.
+
+!!! warning
+
+    The paper reports slight inaccuracy at very high clay content and high tension.
+
+### `calc_ptf_oosterveld1980_field_capacity`
+
+Estimate gravimetric soil-moisture content at field capacity.
+
+**Status:** `implemented`
+
+**Prediction target:** Gravimetric soil-moisture content at field capacity.
+
+**Models:** $h(\theta)$ — Field-capacity point estimate derived from Equations 1 and 2
+
+#### Inputs
+
+| Name | Unit | Domain | Description |
+| --- | --- | --- | --- |
+| `clay` | % mass | 2 <= value <= 72 | Clay content in percent by weight; the field-capacity tension experiment covered 2% to 72% clay. |
+| `sand` | % mass | — | Sand content in percent by weight. |
+| `mean_depth` | cm | 8 <= value <= 180 | Mean depth of the soil sample. |
+
+#### Outputs
+
+| Name | Unit | Domain | Description |
+| --- | --- | --- | --- |
+| `field_capacity_moisture` | % mass | — | Predicted soil-moisture content at field capacity in percent by weight. |
+
+!!! note
+
+    Equation 3 is obtained by substituting the Equation 1 field-capacity tension into Equation 2.
+
+### `calc_ptf_oosterveld1980_wilting_point`
+
+Estimate gravimetric soil-moisture content at the 1500 kPa wilting point.
+
+**Status:** `implemented`
+
+**Prediction target:** Gravimetric soil-moisture content at 1500 kPa.
+
+**Models:** $h(\theta)$ — Wilting-point estimate at 1500 kPa
+
+#### Inputs
+
+| Name | Unit | Domain | Description |
+| --- | --- | --- | --- |
+| `clay` | % mass | — | Clay content in percent by weight. |
+| `sand` | % mass | — | Sand content in percent by weight. |
+| `mean_depth` | cm | 8 <= value <= 180 | Mean depth of the soil sample. |
+
+#### Outputs
+
+| Name | Unit | Domain | Description |
+| --- | --- | --- | --- |
+| `wilting_point_moisture` | % mass | — | Predicted soil-moisture content at 1500 kPa in percent by weight. |
+
+!!! note
+
+    Equation 4 reports r = 0.96 and n = 298.
+
+!!! note
+
+    The paper takes moisture content at 1500 kPa as the wilting point.
+
+### `calc_ptf_oosterveld1980_available_water`
+
+Estimate available gravimetric soil moisture between field capacity and wilting point.
+
+**Status:** `implemented`
+
+**Prediction target:** Difference between gravimetric moisture content at field capacity and at the 1500 kPa wilting point.
+
+**Models:** $h(\theta)$ — Available-moisture point estimate from Equations 3 and 4
+
+#### Inputs
+
+| Name | Unit | Domain | Description |
+| --- | --- | --- | --- |
+| `clay` | % mass | 2 <= value <= 72 | Clay content in percent by weight; the field-capacity tension experiment covered 2% to 72% clay. |
+| `sand` | % mass | — | Sand content in percent by weight. |
+| `mean_depth` | cm | 8 <= value <= 180 | Mean depth of the soil sample. |
+
+#### Outputs
+
+| Name | Unit | Domain | Description |
+| --- | --- | --- | --- |
+| `available_moisture` | % mass | — | Predicted field-capacity moisture minus predicted wilting-point moisture, in percentage points by weight. |
+
+!!! note
+
+    The paper defines available soil water by subtracting Equation 4 from Equation 3.