Apply an FHWA inlet-capacity limit to a proposed conduit flow.
Uses the submerged equation above its FHWA threshold, unsubmerged equation at/below 0.95*y_full, and a secant transition between. Form-1 root status is not propagated and no separate finite/geometry validation or nonnegative clamp is performed. No pointer is retained.
- Parameters
-
| [in] | q0 | Positive proposed per-barrel flow in ft3/s. |
| [in] | y | Positive upstream head above the inlet invert in ft. |
| [in] | xs | Borrowed valid per-barrel geometry with positive full depth/area and valid Form-1 width evaluations. |
| [in] | slope | Dimensionless conduit slope; correction is -7*slope for codes 5/37/46, otherwise 0.5*slope. |
| [in] | code | FHWA inlet code 1..57; invalid codes return q0 with controls=false. |
| [in,out] | dqdh | Existing flow/head derivative in ft2/s; replaced only when inlet capacity is strictly below q0. |
| [out] | controls | Always reset to false; set true only if the computed inlet capacity is strictly below q0. |
- Returns
- The computed inlet capacity when smaller than q0; otherwise q0.