docs: Add comprehensive documentation for routing and water balance models #33
+2,325
−0
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…odels Add detailed technical documentation for EF5's hydrological models: - docs/ROUTING_MODELS.md: Documents Linear Reservoir and Kinematic Wave routing models including algorithms, parameters, and equations - docs/WATER_BALANCE_MODELS.md: Documents SAC-SMA, CREST, HyMOD, and Hydrophobic water balance models with conceptual diagrams, parameter tables, and implementation details Both documents include: - Conceptual structure diagrams - Complete parameter reference tables - Algorithm descriptions with pseudocode - Key equations and their derivations - Comparison tables between model variants - Configuration examples - References to source literature
Add comprehensive proposal document for parallelizing EF5's water balance and routing models for GPU execution: Key contents: - Analysis of current algorithm data dependencies - Wavefront parallelism strategy for kinematic wave routing - Topological level assignment algorithm - Structure of Arrays (SoA) data layout for GPU efficiency - CUDA kernel implementation examples - Optimization strategies (level coalescing, atomic handling) - Alternative algorithms (tree contraction, domain decomposition) - Implementation roadmap with time estimates - Performance projections (10-30x speedup expected) The proposal identifies that water balance is embarrassingly parallel while routing requires wavefront/level-based parallelism due to upstream-to-downstream dependencies in the flow network.
Add comprehensive analysis comparing implicit and explicit kinematic wave solvers and their GPU implementation strategies: Key contents: - Analysis of current semi-implicit scheme (local implicit, global explicit) - Fully implicit formulation with sparse Jacobian matrix structure - GPU implementation options: - cuSPARSE triangular solve (exploits tree structure) - Algebraic Multigrid (AmgX) for better parallelism - Iterative Jacobi/Gauss-Seidel approaches - Trade-off analysis: stability, timestep, accuracy, computational cost - Hybrid approach: semi-implicit hillslopes + implicit channels - Diffusive wave extension for backwater effects - Performance projections and library recommendations - Implementation roadmap with three phases Conclusion: Semi-implicit (current approach) is better for flash flood forecasting; fully implicit advantageous only when timesteps can be 4-6x larger (daily routing, stiff systems).
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Add detailed technical documentation for EF5's hydrological models:
docs/ROUTING_MODELS.md: Documents Linear Reservoir and Kinematic Wave
routing models including algorithms, parameters, and equations
docs/WATER_BALANCE_MODELS.md: Documents SAC-SMA, CREST, HyMOD, and
Hydrophobic water balance models with conceptual diagrams, parameter
tables, and implementation details
Both documents include: